submit_contribution_claims
Read-onlyIdempotent
PoECX bridge: report settlements from your OWN rails (not TWZRD's paid
routes) for cross-check against TWZRD's independently-ingested x402
corpus, by on-chain signature.
A claim whose tx_signature, payer/merchant, and amount all match what
TWZRD's own ingest independently observed is materially stronger evidence
than either a bare self-report or the anonymous corpus alone — the
signature is real and on-chain, and a mismatch can't be forged to pass.
Unmatched claims are returned too, with a reason, never silently dropped.
This is a preview, not an unlock: `claimable` is always false. It exists
to let a real counterparty with its own settlement volume start feeding
PoECX before any on-chain payout path exists — see the PoECX plan.
Capped at 25 claims per call (discovery convenience, not bulk export);
extras are dropped, never silently ignored — see `capped`/`claims_requested`.
Within that cap, only the first claim per (chain, tx_signature,
transfer_index) is checked. Omitted transfer_index is the first leg
(dedup key 0). Later copies of the same leg appear in `unverified`
with reason_code `duplicate_claim` and `duplicate_of` pointing to the
zero-based first input index. Two legs of one tx count twice. This
deduplicates one preview report, not claims across separate calls.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| claims | Yes | Self-reported settlements to cross-check. Each item: {"tx_signature": str, "chain": "solana"|"base", "amount_usdc": float (optional), "transfer_index": int (optional, Solana transfer_index / Base log_index; omitted is first leg)}. Any other chain value is rejected before it ever reaches a query. | |
| wallet | Yes | The wallet these settlement claims are being reported for. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Plain-language caveat on what this report does and doesn't prove. | |
| as_of | No | ISO timestamp this report was built. Two reports of the same claims that differ only in tier after a backfill are distinguishable by as_of + classification_version. | |
| capped | No | True if claims_requested exceeded max_per_call and extras were dropped. | |
| wallet | No | The wallet the claims were submitted for. | |
| verified | No | Per-claim detail for verified claims, each carrying observed_x402_confidence and observed_facilitator_id. | |
| claimable | No | Always false today — this is a preview, not an on-chain payout unlock. | |
| unverified | No | Per-claim detail for unverified claims, each with a reason. | |
| max_per_call | No | Hard cap on claims per call. | |
| score_version | No | Report contract version, e.g. "poecx_bridge_v0". | |
| verified_usdc | No | Sum of observed USDC for verified claims across all tiers, including excluded. Use verified_usdc_x402_high for allowlist-attributed Base volume. | |
| claims_verified | No | Unique chain/transaction/leg claims whose wallet and amount matched TWZRD's independently-observed corpus. | |
| claims_requested | No | Number of claims in the original request, before any cap. | |
| claims_submitted | No | Number of claims actually processed (after cap). | |
| corpus_available | No | False when DSN/query failed so claims were not corpus-checked. Distinct from a genuine miss. | |
| attestation_class | No | "CORPUS_CROSS_CHECKED" when the corpus was observed; "CORPUS_UNAVAILABLE" when lookup could not run (not a miss). Not TWZRD-attested settlement. | |
| claims_duplicates | No | Repeated chain/transaction/leg claims within the capped input; included in claims_unverified and excluded from value totals. | |
| claims_unverified | No | Claims not found, with a mismatched wallet or amount, or duplicated within this report. | |
| classification_version | No | Base cluster-pin / KNOWN_CLUSTERS snapshot id. Moves when corpus reclassify changes high/unknown/excluded meaning; distinct from score_version. | |
| verified_usdc_x402_high | No | Sum of observed USDC for verified claims whose observed_x402_confidence is high (allowlist attribution, not protocol confirmation). Excluded/unknown/untiered are omitted. | |
| verified_usdc_by_confidence | No | Verified USDC split by evidence tier: "high" = relayer funding-cluster is on TWZRD's x402 operator allowlist (attribution, not protocol-level confirmation); "unknown" = observed on-chain transfer TWZRD could not confirm as x402; "excluded" = TWZRD affirmatively classified the settlement as not x402; "untiered" = chain ingest has no confidence tier (Solana). |