Audit bridge partial failure API

Compare caller-supplied source and destination records for a cross-chain bridge. Operations are matched only by message identifier, or by the log field named in fieldMapping. Amounts are scaled with the supplied decimals, fee, and optional conversion rate. consistency_status is consistent, inconsistent, incomplete, or indeterminate. risk_level is low, medium, high, or critical. A missing record is incomplete evidence, not proof that the bridge failed. No chain is queried, and no transaction is treated as final.

The Audit bridge partial failure operation is part of the Bridge Partial Failure Audit API on BRAINIAC.software. Compare caller-supplied source and destination records for a cross-chain bridge. Operations are matched only by message identifier, or by the log field named in fieldMapping. Amounts are scaled with the supplied decimals, fee, and optional conversion rate. consistency_status is consistent, inconsistent, incomplete, or indeterminate. risk_level is low, medium, high, or critical. A missing record is incomplete evidence, not proof that the bridge failed. No chain is queried, and no transaction is treated as final. It is exposed as POST /api/v1/crypto-operations/bridge-partial-failure-audit 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 bridge operations, transaction receipts, event logs, and field mappings processed locally Limitations: Only the records in the request are compared. Chain state and transaction finality are not checked. A missing source or destination record does not prove that a bridge transfer failed. Event logs are not decoded unless fieldMapping names the message identifier and the other fields to read. Token addresses on different chains are not treated as the same asset. Amounts are compared with the supplied decimals, fee, and conversion rate. No exchange rate is fetched. bridge-leg-consistency scores the supplied legs only. The recovery index is the hardest message, not an average. 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 bridge leg consistency. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.05 USDC
/api/v1/crypto-operations/bridge-partial-failure-audit

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/crypto-operations/bridge-partial-failure-audit" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "source": {
    "chainId": 1,
    "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "transactions": [
      {
        "hash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
        "receipt": {
          "status": "success",
          "logs": [
            {
              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
              "data": "0x"
            }
          ]
        }
      }
    ],
    "operations": [
      {
        "messageId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "nonce": "7",
        "recipient": "0x1111111111111111111111111111111111111111",
        "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "amount": "1000000",
        "decimals": 6,
        "status": "completed",
        "transactionHash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
      },
      {
        "messageId": "0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
        "amount": "500000",
        "decimals": 6,
        "status": "sent"
      }
    ]
  },
  "destination": {
    "chainId": 8453,
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "transactions": [
      {
        "hash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
        "receipt": {
          "status": "success"
        }
      },
      {
        "hash": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "receipt": {
          "status": "success"
        }
      },
      {
        "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
        "receipt": {
          "status": "success"
        }
      }
    ],
    "operations": [
      {
        "messageId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "nonce": "7",
        "recipient": "0x2222222222222222222222222222222222222222",
        "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": "900000",
        "decimals": 6,
        "status": "completed",
        "transactionHash": "0xdddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
      },
      {
        "messageId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "nonce": "7",
        "recipient": "0x2222222222222222222222222222222222222222",
        "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": "900000",
        "decimals": 6,
        "status": "completed",
        "transactionHash": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
      },
      {
        "messageId": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "token": "0x4444444444444444444444444444444444444444",
        "amount": "1",
        "decimals": 6,
        "status": "completed",
        "transactionHash": "0x1111111111111111111111111111111111111111111111111111111111111111"
      }
    ]
  },
  "fee": {
    "amount": "0",
    "decimals": 6
  },
  "expectedStatus": "settled"
}
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

Bridge Partial Failure Audit APIFull docsHow it works