Skip to content

Add ERC20 token and Starknet agent projects#21

Open
Chibey-max wants to merge 3 commits into
BlockheaderWeb3-Community:mainfrom
Chibey-max:add-erc20-token
Open

Add ERC20 token and Starknet agent projects#21
Chibey-max wants to merge 3 commits into
BlockheaderWeb3-Community:mainfrom
Chibey-max:add-erc20-token

Conversation

@Chibey-max
Copy link
Copy Markdown

Summary

This PR adds three bootcamp project folders:

  • erc_token/: Cairo ERC20-style restricted token contract with transfer limits, owner-only admin controls, allowance management, deployment script, and Starknet Foundry tests.
  • starknet-agentic/: Starknet agentic tooling project used as the MCP/tooling layer for agent workflows.
  • transfer-agent/: TypeScript autonomous transfer agent that uses starknet-agentic MCP tools to fetch balances, validate transfer rules, optionally transfer STRK, run a second action, and log execution receipts.

ERC20 Token

  • Implements RestrictedToken in Cairo.
  • Includes ERC20-style functions: metadata, balances, transfer, approval, allowance, and transfer_from.
  • Adds restricted functionality:
    • owner-only transfer limit updates
    • owner-only admin burn
    • user allowance revoke
    • transfer limit enforcement
  • Includes tests for constructor setup, transfers, allowances, owner-only controls, revoke, transfer limits, and admin burn.
  • Adds Sepolia deployment helper script.

Transfer Agent

  • Fetches Starknet wallet balance.
  • Validates balance > MIN_BALANCE_TO_TRANSFER.
  • Runs transfer in dry-run or execute mode.
  • Performs a second MCP action with get_balances or call_contract.
  • Logs execution receipts as JSONL.
  • Alerts when balance is below ALERT_BALANCE_THRESHOLD.
  • Includes .env.example, README, TypeScript source, and workflow docs.

Safety

Excluded local/private/generated files:

  • transfer-agent/.env
  • transfer-agent/node_modules/
  • transfer-agent/transfer-agent-log.jsonl
  • generated Cairo build/cache files

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant