tx - Brickken Documentation

brickken tx exposes the raw API V2 transaction flow. Use it when you want full control over the payload, need to call a specific backend method directly, or want to inspect the unsigned transaction before broadcasting.

Subcommand	Purpose
`brickken tx prepare`	Prepare a raw transaction payload (optionally `--execute`)
`brickken tx sign`	Sign a prepared transaction locally
`brickken tx send`	Send signed transaction payloads
`brickken tx status`	Look up a broadcast transaction by hash

tx prepare

Prepare a raw transaction for any method — preparing is free. With --execute, the CLI also sends to /send-transactions and pays the x402 charge. The recommended --execution-mode brickken-relayed lets Brickken’s relayer sign and broadcast (omit --signer-address); the default client-signed mode signs locally with the configured private key first.

Flag	Type	Required	Description
`--method <method>`	string	Yes	Brickken transaction method
`--chain <chain>`	string	No	Chain identifier (`8453` Base, `84532` Base Sepolia)
`--execution-mode <mode>`	string	No	`client-signed` (default) or `brickken-relayed` (recommended)
`--signer-address <address>`	string	No	Signer wallet address (required for `client-signed`)
`-f, --file <path>`	string	No	JSON/YAML input file (merged with CLI flags)
`--execute`	flag	No	Send and pay the x402 charge (otherwise prepare-only)

Supported agentic token methods include agentCreateToken, agentMintToken, agentBurnToken, agentTransferToken, agentTransferFromToken, agentApproveToken (and the agentApprove alias, normalized to agentApproveToken). Agent identity and reputation methods (agentRegister, agentSetURI, agentSetMetadata, agentSetWallet, agentTransferOwnership, agentGiveFeedback, agentRevokeFeedback, agentAppendFeedbackResponse) and other API V2 methods are also accepted. You can also set executionMode directly in the --file body. See Agentic Methods with x402 for each method’s fields. One-shot execution from a file:

brickken tx prepare \
  --method agentCreateToken \
  --file token.json \
  --execute \
  --json

Prepare-only (inspect before signing):

brickken tx prepare \
  --method agentRegister \
  --file agent-register.json \
  --json | tee prepared.json

Prefer --file for nested JSON, long text, or values assembled by shell scripts. A file avoids the quoting pitfalls of inline JSON. The file’s keys use the backend field names (e.g. chainId, signerAddress, metadataValue).

Example metadata file:

{
  "chainId": "84532",
  "executionMode": "brickken-relayed",
  "agentUuid": "00000000-0000-0000-0000-000000000000",
  "metadataKey": "capabilities",
  "metadataValue": "{\"tasks\":[\"research\",\"summarization\"]}",
  "metadataEncoding": "json"
}

tx sign

Sign a prepared transaction locally with the configured private key. This step applies to client-signed execution only; in brickken-relayed mode Brickken signs the operation, so you skip signing and send the prepared transactions directly.

Flag	Type	Required	Description
`-f, --file <path>`	string	No	File containing the prepared transaction

brickken tx sign --file prepared.json --json | tee signed.json

tx send

Send signed transactions. --tx-id and --signed-tx are repeatable for batched sends.

Flag	Type	Required	Description
`--tx-id <value>`	string	Yes¹	Prepared transaction ID (repeatable)
`--signed-tx <value>`	string	Yes¹	Signed transaction hex (repeatable)
`-f, --file <path>`	string	No	File containing `txId` / `signedTransactions`

¹ Supply via flags or a --file.

brickken tx send \
  --tx-id "$(jq -r '.prepared.txId' prepared.json)" \
  --signed-tx "$(jq -r '.signedTransaction' signed.json)" \
  --json

x402 send batches must contain only x402-eligible prepared transactions, and all transactions in a batch must be on the same chain.

tx status

Look up a broadcast transaction by its on-chain hash. Either --hash or --tx-hash is required.

Flag	Type	Required	Description
`--hash <hash>`	string	Yes¹	Actual blockchain transaction hash
`--tx-hash <hash>`	string	Yes¹	Alias for `--hash`

¹ Provide one of the two.

brickken tx status --hash 0xBlockchainTxHash --json

This maps to GET /get-transaction-status.

Manual three-step flow

When you want full control over each step:

brickken tx prepare --method agentRegister --file agent-register.json --json
brickken tx sign --file prepared.json --json
brickken tx send --tx-id 0xPreparedTxId --signed-tx 0xSignedRawTx --json

Getting Started

Commands

Guides

tx

tx prepare

tx sign

tx send

tx status

Manual three-step flow

​tx prepare

​tx sign

​tx send

​tx status

​Manual three-step flow

tx prepare

tx sign

tx send

tx status

Manual three-step flow