{"slug":"api-sandbox-brickken-com-x402-rams-grant-mandate-39936c","title":"Prepare ERC-8226 RAMS mandate grant","host":"api.sandbox.brickken.com","method":"POST","resource":"https://api.sandbox.brickken.com/x402/rams/grant-mandate","category":"code","description":"Prepare ERC-8226 RAMS mandate grant. Grant a compliance-gated, time-bounded and value-capped mandate from a principal to an agent.","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1224,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:84532"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"actions":["0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],"agent":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","asset":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","chainId":"84532","executionMode":"client-signed","identityRef":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","maxCumulativeValue":"example","maxTransactionValue":"example","principal":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","signerAddress":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","validUntil":"example"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":true,"properties":{"actions":{"description":"Allowed actions. Four-byte selectors are right-padded to bytes32.","items":{"description":"Allowed bytes32 action or 4-byte selector.","oneOf":[{"description":"Allowed bytes32 action or 4-byte selector.","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},{"description":"Allowed bytes32 action or 4-byte selector.","pattern":"^0x[a-fA-F0-9]{8}$","type":"string"}]},"minItems":1,"type":"array"},"agent":{"description":"Agent wallet receiving delegated authority.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"agentMandateAddress":{"description":"Optional AgentMandate contract override.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"asset":{"description":"Asset governed by this mandate.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"chainId":{"default":"84532","description":"RAMS is deployed on Base Sepolia (chain ID 84532) and Ethereum Sepolia (chain ID 11155111). Pass chainId explicitly to target the other one.","examples":["84532"],"type":"string"},"complianceProvider":{"description":"ComplianceProvider used to validate the principal.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"deadline":{"description":"Signature deadline as Unix seconds.","oneOf":[{"type":"string"},{"type":"number"}]},"email":{"description":"Alias for ownerEmail where supported.","format":"email","type":"string"},"executionMode":{"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. Mandate lifecycle operations may additionally use brickken-relayed execution with a principal EIP-712 signature and deadline.","enum":["client-signed","client-broadcast","brickken-relayed"],"type":"string"},"gasLimit":{"description":"Optional explicit gas limit.","oneOf":[{"type":"string"},{"type":"number"}]},"identityRef":{"description":"Principal identity reference in the selected compliance provider.","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"maxCumulativeValue":{"description":"Lifetime cumulative cap in raw base units. The aliases \"max\" and \"unlimited\" are accepted.","oneOf":[{"type":"string"},{"type":"number"}]},"maxTransactionValue":{"description":"Per-execution cap in raw base units. The aliases \"max\" and \"unlimited\" are accepted.","oneOf":[{"type":"string"},{"type":"number"}]},"metadata":{"description":"Optional mandate metadata hash.","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"nonce":{"description":"Optional explicit nonce when managing nonces manually.","type":"number"},"ownerEmail":{"description":"Optional owner attribution email.","format":"email","type":"string"},"principal":{"description":"Principal wallet granting the mandate and signing EIP-712 payloads.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"signature":{"description":"Optional principal EIP-712 signature. deadline is required when present.","pattern":"^0x[a-fA-F0-9]+$","type":"string"},"signerAddress":{"description":"Wallet that will sign the prepared transaction. Omit only for brickken-relayed lifecycle calls carrying a principal EIP-712 signature.","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"validFrom":{"description":"Optional Unix start timestamp; defaults to 0.","oneOf":[{"type":"string"},{"type":"number"}]},"validUntil":{"description":"Unix expiry timestamp; must be in the future.","oneOf":[{"type":"string"},{"type":"number"}]}},"required":["chainId","executionMode","agent","principal","validUntil","identityRef","asset","maxTransactionValue","maxCumulativeValue","actions"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":1224,"error":null}],"description_full":"Prepare ERC-8226 RAMS mandate grant. Grant a compliance-gated, time-bounded and value-capped mandate from a principal to an agent.","last_updated":"2026-09-03T10:31:35.079Z","schemes":["exact"]}