Diff governance execution API

Compare the structured actions in a caller-supplied DAO proposal with the caller-supplied execution calls. Targets, selectors, decoded parameters, and native value are compared. execution_match is exact, partial, mismatch, or indeterminate. risk_level is low, medium, high, or critical. The proposal description is not treated as the approved action list. No chain is queried, and approval or execution is not inferred from chain state.

The Diff governance execution operation is part of the Governance Execution Diff API on BRAINIAC.software. Compare the structured actions in a caller-supplied DAO proposal with the caller-supplied execution calls. Targets, selectors, decoded parameters, and native value are compared. execution_match is exact, partial, mismatch, or indeterminate. risk_level is low, medium, high, or critical. The proposal description is not treated as the approved action list. No chain is queried, and approval or execution is not inferred from chain state. It is exposed as POST /api/v1/crypto-governance/governance-execution-diff and priced at $0.05 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied proposal actions, execution calls, logs, and ABI fragments processed locally Limitations: Proposal approval and transaction execution are not read from a chain. The proposal description is not compared. Only structured actions are compared. Calldata is decoded with the caller ABI, or with the standard ERC-20 transfer, transferFrom, approve, and increaseAllowance selectors when no ABI is supplied. Action order is compared only when orderSensitive is true. Event logs become calls only through fieldMapping. No governance event format is assumed. execution-risk-score applies transfer and transferFrom to the supplied balances. It is not an EVM simulation. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Score governance execution drift. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.05 USDC
/api/v1/crypto-governance/governance-execution-diff

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/crypto-governance/governance-execution-diff" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "proposal": {
    "id": "42",
    "description": "Send 1 USDC to the grants wallet."
  },
  "chainId": 8453,
  "orderSensitive": false,
  "approvedActions": [
    {
      "target": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "signature": "transfer(address,uint256)",
      "calldata": "0xa9059cbb000000000000000000000000111111111111111111111111111111111111111100000000000000000000000000000000000000000000000000000000000f4240",
      "value": "0",
      "recipient": "0x1111111111111111111111111111111111111111",
      "amount": "1000000"
    },
    {
      "target": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "signature": "approve(address,uint256)",
      "calldata": "0x095ea7b300000000000000000000000033333333333333333333333333333333333333330000000000000000000000000000000000000000000000000000000000000005",
      "value": "0",
      "spender": "0x3333333333333333333333333333333333333333",
      "amount": "5"
    }
  ],
  "execution": {
    "transactionHash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "calls": [
      {
        "target": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "calldata": "0xa9059cbb000000000000000000000000222222222222222222222222222222222222222200000000000000000000000000000000000000000000000000000000000f4240",
        "value": "0"
      },
      {
        "target": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "calldata": "0xa9059cbb00000000000000000000000044444444444444444444444444444444444444440000000000000000000000000000000000000000000000000000000000000001",
        "value": "0"
      }
    ]
  },
  "abi": [
    {
      "type": "function",
      "name": "transfer",
      "stateMutability": "nonpayable",
      "inputs": [
        {
          "name": "to",
          "type": "address"
        },
        {
          "name": "amount",
          "type": "uint256"
        }
      ],
      "outputs": [
        {
          "type": "bool"
        }
      ]
    },
    {
      "type": "function",
      "name": "approve",
      "stateMutability": "nonpayable",
      "inputs": [
        {
          "name": "spender",
          "type": "address"
        },
        {
          "name": "amount",
          "type": "uint256"
        }
      ],
      "outputs": [
        {
          "type": "bool"
        }
      ]
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Governance Execution Diff APIFull docsHow it works