Skip to main content
POST
Prepare agent ERC-20 deployment
Prepares unsigned transactions for deploying an agent-owned ERC-20 token. This facade maps to agentCreateToken.

Authentication

Omit x-api-key. Prepare is free; the x402 payment is charged on POST /send-transactions, where the API returns 402 Payment Required. Sign the x402 payment locally and retry with X-PAYMENT. In brickken-relayed mode (recommended) Brickken’s relayer signs and broadcasts; in client-signed mode you sign the prepared transaction first.

Key Fields

Response

Returns prepared unsigned transactions and txId. Submit it to POST /send-transactions: in brickken-relayed mode send { txId, transactions } and pay via x402 (Brickken signs and broadcasts); in client-signed mode sign the transaction locally and send { txId, signedTransactions }. If executed, use the deployment receipt to recover the deployed tokenAddress. In brickken-relayed mode, omit agentWallet — Brickken’s relayer becomes the token owner.

Authorizations

X-Payment
string
header
required

Base64-encoded x402 payment payload. Supported for x402-eligible agentic methods on /x402/... facades, /prepare-transactions, and eligible /send-transactions retries.

Body

application/json
chainId
string
default:8453
required

Target operation chain ID. Use 8453 on Base mainnet or 84532 on Base Sepolia.

Examples:

"8453"

"84532"

name
string
required
symbol
string
required
Pattern: ^[A-Z0-9]{2,11}$
agentWallet
string
required

Wallet that owns and mints the agent token.

Pattern: ^0x[a-fA-F0-9]{40}$
executionMode
enum<string>
default:client-signed

Execution mode. Use brickken-relayed to let Brickken's relayer sign, pay gas, and broadcast (omit signerAddress). Use client-signed to sign the prepared transaction yourself.

Available options:
brickken-relayed,
client-signed
signerAddress
string

Wallet that signs the prepared blockchain transaction. Required only in client-signed mode; omit in brickken-relayed mode.

Pattern: ^0x[a-fA-F0-9]{40}$
gasLimit

Optional explicit gas limit.

nonce
number

Optional explicit nonce when managing nonces manually.

privateRpcUrl
string

Optional private RPC URL override.

ownerEmail
string<email>

Optional owner attribution email.

email
string<email>

Alias for ownerEmail where supported.

premint

Human-readable premint amount.

decimals

Token decimals. Defaults to 18 when omitted.

Response

Prepared unsigned transaction payload.

transactions
object
txId
string
info
object