get_poec_score
Free preview: PoEC v0 (Proof of Economic Contribution) for a payer wallet,
computed from the same observed x402 snapshot score_wallet_for_intel returns.
poec_score = log10(1 + observed USDC sent) x success_quality x diversity
x wash_cleanliness, behind hard floors (>=5 paid calls, >=3 distinct
counterparties, wash_factor >= 0.5, not single-counterparty, wash_flag
clean). Any failed floor, or an unobservable corpus, scores 0.0 with
floors_passed=false - the floors fail closed, never open. wash_factor is a
cleanliness multiplier (1.0 = clean) and is never inverted.
Honesty contract: `claimable` is ALWAYS false. Volume here is
corpus-observed, not a payout unlock. `success_quality` comes from the
payer join onto signed `receipt_settlement_leaves` (0211); if that join
is unobservable, `success_rate` stays in evidence_gaps and the score
reads 0.0. What this surface already shows honestly is the floor filter
(eligible_v0) and every component the score is built from. Self-reported
settlements go through submit_contribution_claims.
Base (EVM) 0x wallets are scored from the relayer-attributed x402_base_daily
rollup (90d) with the same shape, but no wash/sybil graph exists for Base
payers yet, so their wash_flag reads "unknown" (never "clean"), the wash
floor stays closed, and poec_score stays 0.0 regardless of real volume.
A wallet the corpus could not observe at all returns `error` set; on that
path any real observed Base volume is attached under `base_observed`.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"wallet": "<wallet>"
},
"name": "get_poec_score"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wallet | Yes | Payer wallet (Solana base58 or Base 0x) to score for Proof of Economic Contribution. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | ISO timestamp the snapshot was scored at. | |
| error | No | Present only when the wallet could not be observed at all (e.g. not a valid Solana pubkey, upstream unavailable) -- distinguishes 'not scoreable' from a genuinely inactive wallet, both of which otherwise read as poec_score 0.0. | |
| wallet | No | The scored payer wallet. | |
| claimable | No | Always false: volume is corpus-observed, not facilitator-attested or joined to a settlement leaf. | |
| wash_flag | No | "clean" | "single_counterparty" | "unknown", from the intel snapshot. | |
| components | No | observed_volume, success_quality, diversity, hop_multiplier, wash_cleanliness, solana_boost. | |
| paid_calls | No | Observed x402 paid calls sent. | |
| poec_score | No | log10(1 + observed USDC sent) x success_quality x diversity x wash_cleanliness; 0.0 when any floor fails. | |
| eligible_v0 | No | Floors passed and observed volume > 0. A floor filter, not an unlock. | |
| success_rate | No | Signed receipt_settlement_leaves for this payer / observed paid_calls, capped at 1.0. None = join unobservable; 0.0 = join ran, zero attested leaves. Never implies claimable. | |
| base_observed | No | Present only for a Base (EVM) wallet TWZRD has independently observed paid calls from: real paid_calls/total_usdc/distinct_counterparties (90d, high-confidence, x402_base_daily). Informational only -- no wash/sybil evaluation exists for Base payers yet, so poec_score and floors_passed are unaffected by this field. | |
| evidence_gaps | No | Inputs with no live source. Empty plus success_rate 0.0 means the 0211 join ran and this wallet has no signed settlement leaf — not a missing join. | |
| floors_passed | No | All hard floors held: >=5 paid calls, >=3 distinct counterparties, wash_factor >= 0.5, not single-counterparty, wash_flag clean, corpus observable. | |
| score_version | No | PoEC contract version, e.g. "poec_v0". | |
| source_intel_score | No | intel_score of the underlying snapshot. | |
| source_effective_score | No | effective_score of the underlying snapshot. | |
| distinct_counterparties | No | Distinct counterparties observed. |