Token economics

The token economics commands deploy and manage x402-capable agentic ERC-20 tokens on Base. Each is prepare-only by default (free); add --execute to also send and pay the x402 charge. The recommended brickken-relayed mode (--execution-mode brickken-relayed) lets Brickken’s relayer sign and broadcast; the default client-signed mode signs locally with --signer-address. Each high-level command maps to a backend agentic method. Field-level semantics for every method are documented under Agentic Methods with x402.

Command	Backend method
`brickken create-token`	`agentCreateToken`
`brickken mint`	`agentMintToken`
`brickken burn`	`agentBurnToken`
`brickken transfer`	`agentTransferToken`
`brickken transfer-from`	`agentTransferFromToken`
`brickken approve`	`agentApproveToken`

Shared options

Every command accepts these:

Flag	Description
`--chain <chain>`	Chain identifier (`8453` Base mainnet, `84532` Base Sepolia)
`--execution-mode <mode>`	`client-signed` (default) or `brickken-relayed` (recommended)
`--signer-address <address>`	Signer wallet address. Required only for `client-signed`.
`--gas-limit <value>`	Optional explicit gas limit (client-signed)
`--owner-email <email>` / `--email <email>`	Optional tokenizer owner email
`--decimals <value>`	Token decimals (defaults to `18`)
`-f, --file <path>`	JSON/YAML input file (merged with CLI flags)
`--execute`	Send and pay the x402 charge (otherwise prepare-only)

create-token

Deploy a new agentic ERC-20 token.

Flag	Type	Required	Description
`--name <name>`	string	Yes	Token name
`--symbol <symbol>`	string	Yes	Token ticker (2–11 uppercase alphanumeric)
`--token-symbol <symbol>`	string	No	Alias for `--symbol`
`--agent-wallet <address>`	string	Yes	Wallet that owns/mints the token
`--premint <amount>`	string	No	Human-readable amount minted to `agentWallet` (defaults to `0`)

brickken create-token \
  --chain "$CHAIN" \
  --signer-address "$WALLET" \
  --name "Research Agent Token" \
  --symbol RAGT \
  --agent-wallet "$WALLET" \
  --premint 1000 \
  --decimals 18 \
  --execute \
  --json | tee create-token-output.json

export TOKEN_ADDRESS="$(jq -r '.tokenAddress' create-token-output.json)"

The examples below use --signer-address / --agent-wallet for client-signed mode. In brickken-relayed mode you omit both — Brickken’s relayer becomes the token owner. When create-token --execute succeeds, the CLI waits for the deployment receipt and adds tokenAddress to the JSON output; set --rpc-url, BRICKKEN_RPC_URL, or BKN_RPC_URL for the target chain. Do not continue into mint or burn unless tokenAddress is present.

mint

Mint additional tokens. --signer-address must be the configured agentWallet.

Flag	Type	Required	Description
`--token-address <address>`	string	Yes	Deployed ERC-20 token address
`--to <address>`	string	Yes	Recipient wallet
`--recipient-address <address>`	string	No	Alias for `--to`
`--amount <amount>`	string	Yes	Human-readable amount to mint

brickken mint \
  --chain "$CHAIN" \
  --signer-address "$WALLET" \
  --token-address "$TOKEN_ADDRESS" \
  --to 0xRecipientWallet \
  --amount 100 \
  --decimals 18 \
  --execute \
  --json

burn

Burn tokens. --signer-address must be the configured agentWallet.

Flag	Type	Required	Description
`--token-address <address>`	string	Yes	Deployed ERC-20 token address
`--from <address>`	string	Yes	Wallet address to burn from
`--amount <amount>`	string	Yes	Human-readable amount to burn

brickken burn \
  --chain "$CHAIN" \
  --signer-address "$WALLET" \
  --token-address "$TOKEN_ADDRESS" \
  --from 0xHolderWallet \
  --amount 25 \
  --decimals 18 \
  --execute \
  --json

transfer

Transfer tokens from the signer’s wallet.

Flag	Type	Required	Description
`--token-address <address>`	string	Yes	Deployed ERC-20 token address
`--to <address>`	string	Yes	Recipient wallet
`--recipient-address <address>`	string	No	Alias for `--to`
`--amount <amount>`	string	Yes	Human-readable amount to transfer

brickken transfer \
  --chain "$CHAIN" \
  --signer-address "$WALLET" \
  --token-address "$TOKEN_ADDRESS" \
  --to 0xRecipientWallet \
  --amount 10 \
  --decimals 18 \
  --execute \
  --json

transfer-from

Transfer tokens through an allowance. --signer-address is the approved spender.

Flag	Type	Required	Description
`--token-address <address>`	string	Yes	Deployed ERC-20 token address
`--from <address>`	string	Yes	Source (token holder) wallet
`--to <address>`	string	Yes	Recipient wallet
`--recipient-address <address>`	string	No	Alias for `--to`
`--amount <amount>`	string	Yes	Human-readable amount to transfer

brickken transfer-from \
  --chain "$CHAIN" \
  --signer-address 0xApprovedSpenderWallet \
  --token-address "$TOKEN_ADDRESS" \
  --from 0xTokenHolderWallet \
  --to 0xRecipientWallet \
  --amount 5 \
  --decimals 18 \
  --execute \
  --json

approve

Approve a spender allowance.

Flag	Type	Required	Description
`--token-address <address>`	string	Yes	Deployed ERC-20 token address
`--spender-address <address>`	string	Yes	Spender wallet receiving the allowance
`--spender <address>`	string	No	Alias for `--spender-address`
`--amount <amount>`	string	Yes	Human-readable allowance amount

brickken approve \
  --chain "$CHAIN" \
  --signer-address "$WALLET" \
  --token-address "$TOKEN_ADDRESS" \
  --spender-address 0xSpenderWallet \
  --amount 50 \
  --decimals 18 \
  --execute \
  --json

Getting Started

Commands

Guides

Shared options

create-token

mint

burn

transfer

transfer-from

approve

​Shared options

​create-token

​mint

​burn

​transfer

​transfer-from

​approve

Shared options

create-token

mint

burn

transfer

transfer-from

approve