{"slug":"api-sandbox-brickken-com-x402-agent-set-wallet-1fbb4c","title":"Prepare ERC-8004 agent wallet update","host":"api.sandbox.brickken.com","method":"POST","resource":"https://api.sandbox.brickken.com/x402/agent/set-wallet","category":"code","description":"Prepare ERC-8004 agent wallet update. Prepare an unsigned transaction that sets the operational wallet for an ERC-8004 agent.","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1435,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:84532"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"chainId":"84532","deadline":"example","executionMode":"client-signed","newWallet":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","signature":"example","signerAddress":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":true,"properties":{"agentId":{"description":"On-chain ERC-8004 agent ID.","type":"string"},"agentUuid":{"description":"Stored tokenized agent UUID returned by agentRegister.","type":"string"},"chainId":{"default":"84532","description":"Target operation chain ID. This environment allows: 11155111, 84532, 80002.","examples":["84532","11155111","80002"],"type":"string"},"deadline":{"description":"Signature deadline.","oneOf":[{"type":"string"},{"type":"number"}]},"email":{"description":"Alias for ownerEmail where supported.","format":"email","type":"string"},"executionMode":{"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use brickken-relayed explicitly for Brickken signing and broadcasting, or client-broadcast to sign and broadcast locally. Client-controlled modes charge half at prepare and half at send; client-broadcast confirmation requires both txId and txHash.","enum":["client-signed","client-broadcast","brickken-relayed"],"type":"string"},"gasLimit":{"description":"Optional explicit gas limit.","oneOf":[{"type":"string"},{"type":"number"}]},"newWallet":{"description":"New operational agent wallet address.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"nonce":{"description":"Optional explicit nonce when managing nonces manually.","type":"number"},"ownerEmail":{"description":"Optional owner attribution email.","format":"email","type":"string"},"signature":{"description":"Agent wallet authorization signature.","type":"string"},"signerAddress":{"description":"Required signer wallet for client-signed and client-broadcast execution.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["chainId","executionMode","newWallet","deadline","signature"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":1435,"error":null}],"description_full":"Prepare ERC-8004 agent wallet update. Prepare an unsigned transaction that sets the operational wallet for an ERC-8004 agent.","last_updated":"2026-09-03T10:37:11.022Z","schemes":["exact"]}