{"openapi":"3.1.0","info":{"title":"Brickken x402 Agentic API","version":"1.0.0","description":"Discoverable x402 facade endpoints for preparing Brickken ERC-8004, agent-token and ERC-8226 RAMS transactions.","x-guidance":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"servers":[{"url":"https://api.brickken.com"}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"x402Payment":{"type":"apiKey","in":"header","name":"Payment-Signature","description":"Base64-encoded x402 payment payload."}}},"paths":{"/x402/agent/register":{"post":{"operationId":"prepareAgentRegister","summary":"Prepare ERC-8004 agent registration","description":"Prepare an unsigned ERC-8004 agent registration transaction. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","name","description","image","services"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"name":{"type":"string"},"description":{"type":"string"},"image":{"type":"string","format":"uri"},"services":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["name","endpoint"],"properties":{"name":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"version":{"type":"string"}}}},"metadata":{"type":"object","additionalProperties":true},"aiModelName":{"type":"string"},"aiModelProvider":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"documentation":{"type":"string","format":"uri"},"sourceCode":{"type":"string","format":"uri"},"license":{"type":"string"},"agentType":{"type":"string"},"supportedTrust":{"type":"array","items":{"type":"string"}},"x402Support":{"type":"boolean"},"active":{"type":"boolean"},"registrations":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.490000000000000000"}}}},"/x402/agent/set-uri":{"post":{"operationId":"prepareAgentSetUri","summary":"Prepare ERC-8004 agent URI update","description":"Prepare an unsigned transaction that publishes the final ERC-8004 agent URI and profile metadata. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentUuid":{"type":"string","description":"Stored tokenized agent UUID returned by agentRegister."},"agentId":{"type":"string","description":"On-chain ERC-8004 agent ID."},"name":{"type":"string"},"description":{"type":"string"},"image":{"type":"string","format":"uri"},"services":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["name","endpoint"],"properties":{"name":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"version":{"type":"string"}}}},"metadata":{"type":"object","additionalProperties":true},"aiModelName":{"type":"string"},"aiModelProvider":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"documentation":{"type":"string","format":"uri"},"sourceCode":{"type":"string","format":"uri"},"license":{"type":"string"},"agentType":{"type":"string"},"supportedTrust":{"type":"array","items":{"type":"string"}},"x402Support":{"type":"boolean"},"active":{"type":"boolean"},"registrations":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.240000000000000000"}}}},"/x402/agent/set-metadata":{"post":{"operationId":"prepareAgentSetMetadata","summary":"Prepare ERC-8004 metadata update","description":"Prepare an unsigned transaction that writes one ERC-8004 agent metadata key/value pair. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentUuid":{"type":"string","description":"Stored tokenized agent UUID returned by agentRegister."},"agentId":{"type":"string","description":"On-chain ERC-8004 agent ID."},"metadataKey":{"type":"string"},"metadataValue":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"metadataEncoding":{"type":"string","enum":["string","json","hex"]},"aiModelName":{"type":"string"},"aiModelProvider":{"type":"string"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.240000000000000000"}}}},"/x402/agent/set-wallet":{"post":{"operationId":"prepareAgentSetWallet","summary":"Prepare ERC-8004 agent wallet update","description":"Prepare an unsigned transaction that sets the operational wallet for an ERC-8004 agent. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","newWallet","deadline","signature"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentUuid":{"type":"string","description":"Stored tokenized agent UUID returned by agentRegister."},"agentId":{"type":"string","description":"On-chain ERC-8004 agent ID."},"newWallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"New operational agent wallet address."},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Signature deadline."},"signature":{"type":"string","description":"Agent wallet authorization signature."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.490000000000000000"}}}},"/x402/agent/transfer-ownership":{"post":{"operationId":"prepareAgentTransferOwnership","summary":"Prepare ERC-8004 identity ownership transfer","description":"Prepare an ERC-721 ownership transfer from Brickken custody to the requested wallet. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","newOwner"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentUuid":{"type":"string","description":"Stored tokenized agent UUID returned by agentRegister."},"agentId":{"type":"string","description":"On-chain ERC-8004 agent ID."},"newOwner":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will receive the ERC-8004 identity NFT."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.490000000000000000"}}}},"/x402/agent/feedback/give":{"post":{"operationId":"prepareAgentGiveFeedback","summary":"Prepare ERC-8004 feedback","description":"Prepare an unsigned ERC-8004 reputation feedback transaction. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","value","valueDecimals"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentUuid":{"type":"string","description":"Stored tokenized agent UUID returned by agentRegister."},"agentId":{"type":"string","description":"On-chain ERC-8004 agent ID."},"value":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Feedback value."},"valueDecimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Feedback value decimals."},"tag1":{"type":"string"},"tag2":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"feedbackURI":{"type":"string"},"feedbackHash":{"type":"string"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.120000000000000000"}}}},"/x402/agent/feedback/revoke":{"post":{"operationId":"prepareAgentRevokeFeedback","summary":"Prepare ERC-8004 feedback revocation","description":"Prepare an unsigned transaction that revokes an ERC-8004 feedback entry. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","agentId","feedbackIndex"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentId":{"type":"string"},"feedbackIndex":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Feedback index to revoke."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.120000000000000000"}}}},"/x402/agent/feedback/respond":{"post":{"operationId":"prepareAgentAppendFeedbackResponse","summary":"Prepare ERC-8004 feedback response","description":"Prepare an unsigned transaction that appends a response to an ERC-8004 feedback thread. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","agentId","clientAddress","feedbackIndex","responseURI"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentId":{"type":"string"},"clientAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Original feedback client address."},"feedbackIndex":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Feedback index to respond to."},"responseURI":{"type":"string"},"responseHash":{"type":"string"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.240000000000000000"}}}},"/x402/token/create":{"post":{"operationId":"prepareAgentCreateToken","summary":"Prepare agent ERC-20 deployment","description":"Prepare an unsigned transaction that deploys an ERC-20 token controlled by an agent wallet. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","name","symbol","agentWallet"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"name":{"type":"string"},"symbol":{"type":"string","pattern":"^[A-Z0-9]{2,11}$","examples":["BKNAGENT"]},"agentWallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that owns and mints the agent token."},"premint":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Human-readable premint amount."},"decimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Token decimals. Defaults to 18 when omitted."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"4.990000000000000000"}}}},"/x402/token/mint":{"post":{"operationId":"prepareAgentMintToken","summary":"Prepare agent token mint","description":"Prepare an unsigned transaction that mints an agent ERC-20 token. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","tokenAddress","to","amount"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent ERC-20 token contract address."},"amount":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Human-readable token amount."},"decimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Token decimals. Defaults to 18 when omitted."},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Recipient wallet address."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.050000000000000000"}}}},"/x402/token/burn":{"post":{"operationId":"prepareAgentBurnToken","summary":"Prepare agent token burn","description":"Prepare an unsigned transaction that burns an agent ERC-20 token. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","tokenAddress","from","amount"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent ERC-20 token contract address."},"amount":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Human-readable token amount."},"decimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Token decimals. Defaults to 18 when omitted."},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet address to burn from."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000000000000000"}}}},"/x402/token/transfer":{"post":{"operationId":"prepareAgentTransferToken","summary":"Prepare agent token transfer","description":"Prepare an unsigned transaction that transfers an agent ERC-20 token. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","tokenAddress","to","amount"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent ERC-20 token contract address."},"amount":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Human-readable token amount."},"decimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Token decimals. Defaults to 18 when omitted."},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Recipient wallet address."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000000000000000"}}}},"/x402/token/transfer-from":{"post":{"operationId":"prepareAgentTransferFromToken","summary":"Prepare agent token transferFrom","description":"Prepare an unsigned transaction that transfers an agent ERC-20 token through allowance. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","tokenAddress","from","to","amount"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent ERC-20 token contract address."},"amount":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Human-readable token amount."},"decimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Token decimals. Defaults to 18 when omitted."},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Source wallet address."},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Recipient wallet address."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000000000000000"}}}},"/x402/token/approve":{"post":{"operationId":"prepareAgentApproveToken","summary":"Prepare agent token allowance","description":"Prepare an unsigned transaction that approves an ERC-20 allowance for an agent token. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","tokenAddress","spenderAddress","amount"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required signer wallet for client-signed and client-broadcast execution."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent ERC-20 token contract address."},"amount":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Human-readable token amount."},"decimals":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Token decimals. Defaults to 18 when omitted."},"spenderAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Spender wallet address."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.010000000000000000"}}}},"/x402/racs/propose-claim":{"post":{"operationId":"prepareRacsProposeClaim","summary":"Prepare racsProposeClaim","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","signer","signature","deadline","claim"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/validate-claim":{"post":{"operationId":"prepareRacsValidateClaim","summary":"Prepare racsValidateClaim","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","signer","signature","deadline","assetId","claimType","version"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/activate-claim":{"post":{"operationId":"prepareRacsActivateClaim","summary":"Prepare racsActivateClaim","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","signer","signature","deadline","assetId","claimType","version"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/suspend-claim":{"post":{"operationId":"prepareRacsSuspendClaim","summary":"Prepare racsSuspendClaim","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","signer","signature","deadline","assetId","claimType","version"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/revoke-claim":{"post":{"operationId":"prepareRacsRevokeClaim","summary":"Prepare racsRevokeClaim","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","signer","signature","deadline","assetId","claimType","version"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/register-asset":{"post":{"operationId":"prepareRacsRegisterAsset","summary":"Prepare racsRegisterAsset","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","contractAddr","subAssetId","assetChainId"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/remove-asset":{"post":{"operationId":"prepareRacsRemoveAsset","summary":"Prepare racsRemoveAsset","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","assetId"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/grant-claim-role":{"post":{"operationId":"prepareRacsGrantClaimRole","summary":"Prepare racsGrantClaimRole","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","assetId","claimType","kind","who"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/revoke-claim-role":{"post":{"operationId":"prepareRacsRevokeClaimRole","summary":"Prepare racsRevokeClaimRole","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","assetId","claimType","kind","who"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/racs/set-registry":{"post":{"operationId":"prepareRacsSetRegistry","summary":"Prepare racsSetRegistry","description":"Prepare an ERC-8320 RACS operation with contract simulation before persistence. The method is fixed by this facade endpoint; do not include a method field. Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","anchor","registry","approved"],"properties":{"chainId":{"type":"string","default":"8453","examples":["8453"],"description":"Target operation chain ID."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"Discovery defaults to client-signed so the payable prepare step can be invoked and priced directly. Use 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."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction sender."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Expected live signer nonce."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"signer":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EIP-712 signer for claim lifecycle operations."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"EIP-712 signature deadline."},"claimRegistryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional RACS registry override."},"anchor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Per-asset RegistryAnchor address."},"registry":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Registry address."},"assetId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"RACS asset identifier."},"contractAddr":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Referenced asset contract."},"who":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Role recipient."},"claimType":{"type":"integer","minimum":0,"maximum":7},"kind":{"type":"integer","minimum":0,"maximum":2},"version":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Claim version."},"subAssetId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Sub-asset identifier."},"assetChainId":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Chain holding the referenced asset."},"approved":{"type":"boolean"},"claim":{"type":"object"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"Unsigned transaction payload. Sign it only for client-signed or client-broadcast execution.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/grant-mandate":{"post":{"operationId":"prepareRamsGrantMandate","summary":"Prepare ERC-8226 RAMS mandate grant","description":"Grant a compliance-gated, time-bounded and value-capped mandate from a principal to an agent. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","agent","principal","validUntil","identityRef","asset","maxTransactionValue","maxCumulativeValue","actions"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentMandateAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate contract override."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Optional principal EIP-712 signature. deadline is required when present."},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Signature deadline as Unix seconds."},"agent":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent wallet receiving delegated authority."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal wallet granting the mandate and signing EIP-712 payloads."},"validFrom":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional Unix start timestamp; defaults to 0."},"validUntil":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Unix expiry timestamp; must be in the future."},"complianceProvider":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"ComplianceProvider used to validate the principal."},"identityRef":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Principal identity reference in the selected compliance provider."},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Asset governed by this mandate."},"maxTransactionValue":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Per-execution cap in raw base units. The aliases \"max\" and \"unlimited\" are accepted."},"maxCumulativeValue":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Lifetime cumulative cap in raw base units. The aliases \"max\" and \"unlimited\" are accepted."},"metadata":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Optional mandate metadata hash."},"actions":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Allowed bytes32 action or 4-byte selector."},{"type":"string","pattern":"^0x[a-fA-F0-9]{8}$","description":"Allowed bytes32 action or 4-byte selector."}],"description":"Allowed bytes32 action or 4-byte selector."},"description":"Allowed actions. Four-byte selectors are right-padded to bytes32."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/revoke-mandate":{"post":{"operationId":"prepareRamsRevokeMandate","summary":"Prepare ERC-8226 RAMS mandate revocation","description":"Revoke an existing mandate directly as its principal/operator or through a principal EIP-712 signature. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","agent","principal","asset"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentMandateAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate contract override."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Optional principal EIP-712 signature. deadline is required when present."},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Signature deadline as Unix seconds."},"agent":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent whose mandate is revoked."},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Asset selecting the mandate."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal that granted the mandate."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/extend-mandate":{"post":{"operationId":"prepareRamsExtendMandate","summary":"Prepare ERC-8226 RAMS mandate extension","description":"Extend the expiry of an active mandate without resetting cumulative usage. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","agent","principal","asset","newValidUntil"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentMandateAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate contract override."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Optional principal EIP-712 signature. deadline is required when present."},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Signature deadline as Unix seconds."},"agent":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent whose mandate is extended."},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Asset selecting the mandate."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal that granted the mandate."},"newValidUntil":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"New Unix expiry timestamp, greater than the current expiry."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/set-operator":{"post":{"operationId":"prepareRamsSetOperator","summary":"Prepare ERC-8226 RAMS operator approval","description":"Approve or remove an operator that may directly revoke and extend a principal mandate. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","principal","operator","approved"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentMandateAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate contract override."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Optional principal EIP-712 signature. deadline is required when present."},"deadline":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Signature deadline as Unix seconds."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal approving the operator and signing EIP-712 payloads."},"operator":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Operator wallet to approve or remove."},"approved":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/execute":{"post":{"operationId":"prepareRamsExecute","summary":"Prepare ERC-8226 RAMS agent execution","description":"Execute an allowed action through the principal-bound AgentExecutor. The transaction must be signed by the agent. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"target":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Raw mode target contract."},"data":{"type":"string","pattern":"^0x[a-fA-F0-9]{8,}$","description":"Raw inner calldata."},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transfer-helper asset contract."},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transfer-helper source wallet."},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transfer-helper recipient wallet."},"amount":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Transfer-helper amount in raw base units."},"executorAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentExecutor contract override."}},"oneOf":[{"required":["target","data"]},{"required":["asset","from","to","amount"]}]}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/set-executor-action":{"post":{"operationId":"prepareRamsSetExecutorAction","summary":"Prepare ERC-8226 RAMS executor ActionSpec registration","description":"Register or update the ActionSpec for a function selector (supported, hasAmount, amountIndex). The transaction must be signed by the executor owner. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","supported","hasAmount"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"selector":{"type":"string","pattern":"^0x[a-fA-F0-9]{8}$","description":"Function selector to configure."},"action":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Alternative left-aligned selector bytes32."},"supported":{"type":"boolean"},"hasAmount":{"type":"boolean"},"amountIndex":{"type":"integer","minimum":0,"maximum":255},"label":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":2000},"requiredAsset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional asset restriction used by offer discovery."},"executorAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentExecutor contract override."}},"oneOf":[{"required":["selector"]},{"required":["action"]}]}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/create-executor":{"post":{"operationId":"prepareRamsCreateExecutor","summary":"Resolve or prepare a principal-bound RAMS executor","description":"Return the existing executor for the configured RAMS registry, or prepare an idempotent factory creation transaction signed by the principal. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","principal"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal bound immutably to the executor."},"owner":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Executor owner. The investor flow requires this to match principal."},"rams":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate registry override. agentMandateAddress is accepted as an alias."},"executorFactoryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentExecutorFactory override."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/grant-recorder-role":{"post":{"operationId":"prepareRamsGrantRecorderRole","summary":"Prepare RECORDER_ROLE grant for the factory-resolved executor","description":"Resolve the principal executor through AgentExecutorFactory and prepare an idempotent direct role grant by the live RECORDER_ROLE admin. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","principal"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal whose executor receives RECORDER_ROLE."},"rams":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate registry override. agentMandateAddress is accepted as an alias."},"executorFactoryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentExecutorFactory override."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/freeze-agent":{"post":{"operationId":"prepareRamsFreezeAgent","summary":"Prepare ERC-8226 RAMS agent freeze","description":"Freeze an agent. The transaction must be signed by an ENFORCER_ROLE holder. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","agent"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentMandateAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate contract override."},"agent":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent wallet to freeze."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/unfreeze-agent":{"post":{"operationId":"prepareRamsUnfreezeAgent","summary":"Prepare ERC-8226 RAMS agent unfreeze","description":"Unfreeze an agent. The transaction must be signed by an ENFORCER_ROLE holder. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","agent"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"agentMandateAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional AgentMandate contract override."},"agent":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Agent wallet to unfreeze."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/grant-principal":{"post":{"operationId":"prepareRamsGrantPrincipal","summary":"Prepare ERC-8226 RAMS principal compliance grant","description":"Grant a principal compliance record. The transaction must be signed by the ComplianceProvider owner. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","principal","identityRef"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal receiving the compliance record."},"identityRef":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Non-zero compliance identity reference."},"expiresAt":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional Unix expiry; 0 means no expiry."},"complianceProviderAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional ComplianceProvider contract override."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}},"/x402/rams/revoke-principal":{"post":{"operationId":"prepareRamsRevokePrincipal","summary":"Prepare ERC-8226 RAMS principal compliance revocation","description":"Revoke an active principal compliance record. The transaction must be signed by the ComplianceProvider owner. The method is fixed by this facade endpoint; do not include a method field. RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","x-execution-mode-default":"client-signed","x-execution-modes":["client-signed","client-broadcast"],"security":[{"x402Payment":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["chainId","signerAddress","principal","reason"],"properties":{"chainId":{"type":"string","default":"11155111","examples":["11155111"],"description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"],"default":"client-signed","description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role."},"signerAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Wallet that will sign the prepared transaction."},"gasLimit":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"Optional explicit gas limit."},"nonce":{"type":"number","description":"Optional explicit nonce when managing nonces manually."},"ownerEmail":{"type":"string","format":"email","description":"Optional owner attribution email."},"email":{"type":"string","format":"email","description":"Alias for ownerEmail where supported."},"principal":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Principal whose compliance record is revoked."},"reason":{"oneOf":[{"type":"string","enum":["COMPLIANT","KYC_EXPIRED","AML_FLAG","NOT_ACCREDITED","NOT_QUALIFIED","JURISDICTION_BLOCKED","IDENTITY_NOT_FOUND","ATTESTATION_REVOKED","OTHER"]},{"type":"integer","minimum":0,"maximum":8}]},"complianceProviderAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional ComplianceProvider contract override."}}}}}},"responses":{"200":{"description":"Prepared transaction payload for the selected execution mode.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"transactions":{"description":"RAMS defaults to client-signed execution and also supports client-broadcast. Sign with the wallet that holds the required on-chain role.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]},"txId":{"type":"string","description":"Preparation identifier required by POST /send-transactions."},"executionMode":{"type":"string","enum":["client-signed","client-broadcast"]},"x402Requirements":{"type":"array","items":{"type":"object","additionalProperties":true}},"info":{"type":"object","additionalProperties":true,"properties":{"contractAddress":{"type":"string"},"mode":{"type":"string","enum":["direct","principal-signature","brickken-relayed"]},"eip712Nonce":{"type":"string"}}}}}}}},"402":{"description":"x402 payment required.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment request.","schema":{"type":"string"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005000000000000000"}}}}},"x-discovery":{"ownershipProofs":[]}}