Prepare ERC-8226 RAMS agent execution

Prepare ERC-8226 RAMS agent execution. Execute an allowed action through the principal-bound AgentExecutor. The transaction must be signed by the agent.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://api.sandbox.brickken.com/x402/rams/execute

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "chainId": "84532",
    "data": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "executionMode": "client-signed",
    "signerAddress": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "target": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": true,
          "oneOf": [
            {
              "required": [
                "target",
                "data"
              ]
            },
            {
              "required": [
                "asset",
                "from",
                "to",
                "amount"
              ]
            }
          ],
          "properties": {
            "amount": {
              "description": "Transfer-helper amount in raw base units.",
              "oneOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                }
              ]
            },
            "asset": {
              "description": "Transfer-helper asset contract.",
              "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"
            },
            "data": {
              "description": "Raw inner calldata.",
              "pattern": "^0x[a-fA-F0-9]{8,}$",
              "type": "string"
            },
            "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"
              ],
              "type": "string"
            },
            "executorAddress": {
              "description": "Optional AgentExecutor contract override.",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "type": "string"
            },
            "from": {
              "description": "Transfer-helper source wallet.",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "type": "string"
            },
            "gasLimit": {
              "description": "Optional explicit gas limit.",
              "oneOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                }
              ]
            },
            "nonce": {
              "description": "Optional explicit nonce when managing nonces manually.",
              "type": "number"
            },
            "ownerEmail": {
              "description": "Optional owner attribution email.",
              "format": "email",
              "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"
            },
            "target": {
              "description": "Raw mode target contract.",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "type": "string"
            },
            "to": {
              "description": "Transfer-helper recipient wallet.",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "type": "string"
            }
          },
          "required": [
            "chainId",
            "executionMode",
            "signerAddress"
          ],
          "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"
}

This page as JSON