{"criteria_id":"payer-preflight/v1","criteria_revision":"1.0.0","family":"payer-preflight/v1","family_note":"Family payer-preflight/v1; per the M-29 brief the family id is this build's criteria id (recorded as an interpretation in the build REGISTRY). The family was opened by M-26 (criteria failure-translation/v1).","op":"check","ops_not_offered":[],"corpus":{"id":"facilitator-fit-corpus/v1","sha256":"b954898dd234cd7ece4ec23f494dfa1ad9d1804fdfc43055f7ec32bfa1d46af7"},"corpus_pin_definition":"The corpus pin is the SHA-256 of the corpus's canonical serialization (the corpus object excluding its sha256 field), computed and verifiable by the published harness (harness.mjs). Expected outputs inside corpus cases are derived from the criteria text by an independent implementation in gen-corpus.mjs (never the engine's code path), and each case labels its provenance (constructed from on-disk fleet/facilitator records vs synthetic).","price":{"usdc_units_per_call":10000,"label":"$0.01","basis":"per challenge"},"free_tier":{"per_day":100,"min_interval_ms":5000,"on_exhaustion":"402"},"input_contract":{"body":"One JSON request body: { network, scheme, facilitator_url, payTo? (seller wallet, for the credit leg), x402Version?, caller? (free pre-check only) }.","caps":{"body_bytes":262144},"over_cap":"A request body over 262,144 bytes is a free pre-gate refusal naming the cap.","validation":"The challenge shape and the facilitator URL are validated FREE, before any payment: network and scheme must be present non-empty strings; the facilitator URL must parse, use http/https, and carry no credentials. A malformed challenge fails free and never consumes a payment. The facilitator reads run only after payment verification."},"target_safety":"Facilitator-URL policy (A1's target-URL safety policy, payability/v1, applied exactly to every runtime read this worker performs): the submitted facilitator URL must use http or https; must carry no embedded credentials (no userinfo); and is fetched once per read with a 5-second timeout, a response-body cap of 65,536 bytes, and redirects NOT followed (a redirect response is graded as received). Malformed URLs and policy violations are free refusals before any payment. An unreachable facilitator, a timeout, a non-200 status, or an over-cap body is a paid outcome graded as observed (FACILITATOR-UNREACHABLE with the reason factor printed), never an error. The /supported read targets the facilitator URL with any trailing slash removed and /supported appended, unless the submitted path already ends /supported. The PayAI free-credits read targets the facilitator origin (the submitted URL with any trailing /supported and trailing slash removed) plus /free-credits?payTo=<payTo>, plus &network=<canonical CAIP-2 network> when the challenge network canonicalises to a CAIP-2 form.","facilitator_fetch":{"timeout_ms":5000,"body_cap_bytes":65536,"redirects":"not followed","method":"GET","auth":"none"},"field_rule":"Supported extraction (the x402 /supported shape: kinds, extensions, signers): a kind matches the challenge when its scheme equals the challenge scheme and its canonical network equals the challenge's canonical network (alias table: solana -> solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp; solana-devnet -> solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1; base -> eip155:8453; base-sepolia -> eip155:84532; ethereum -> eip155:1; sepolia -> eip155:11155111; any other string canonicalises to itself). Signers: a signer key matches when its canonical form equals the challenge's canonical network, or it is a family wildcard (<family>:*) with the same family, or it is *; the report prints presence and count only, never an address. Testnet-only: the facilitator host is x402.org (the testnet-only tutorial facilitator), or the response lists at least one kind and every listed kind's network is a testnet network (lowercase form contains testnet / sepolia / devnet / goerli / holesky / mumbai / amoy / fuji, or the canonical form is one of the published testnet CAIP-2 forms (Solana devnet, eip155:84532 Base Sepolia, eip155:11155111 Sepolia)). Guarantee fields: the engine scans the /supported object's top level, then each kind in order, for the published keys refundable, refundPolicy, guarantee, guarantees, flow, sponsorPolicy, ceiling, escrow, disputeWindow, sponsorsGas; the first published value of each key is reported verbatim; when none is published the map is empty and the absence is the report — a guarantee field is never filled in or inferred.","credit_rule":"Credit-state leg: exactly one per-wallet credit lookup is established on the record — PayAI publishes a public free-credits lookup (GET /free-credits?payTo=..., states available / low / exhausted; PayAI pricing docs, verified 2026-11-03). The leg rides this op when the named facilitator's host is facilitator.payai.network. Parse: a JSON object whose state (or status, or credit_state) field, lowercased, is one of available / low / exhausted, or a plain-text body equal to one of those states; any other shape grades UNPARSEABLE; a failed, non-200, or over-cap read grades UNREACHABLE; PayAI named but no seller wallet submitted grades NO-WALLET (applicable, not read). For every non-PayAI facilitator the credit state is NOT-PUBLISHED and no credit read is performed: CDP quota state and paid-credit balances are unpublished per-wallet and stay gated. A credit state is never estimated or inferred.","state_rule":"Fit states, decided in this exact order (first match wins): (1) FACILITATOR-UNREACHABLE — the /supported fetch failed or timed out, the response status is not 200, or the response body exceeded the 65,536-byte cap. (2) RESPONSE-UNPARSEABLE — the response is not a JSON object, or its kinds field is present but not an array. (3) DOES-NOT-SERVE — no listed kind matches the challenge's scheme + canonical network. (4) TESTNET-ONLY — a kind matches and the endpoint is testnet-only. (5) SERVES-KIND — a kind matches and the endpoint is not testnet-only; signer presence, guarantee fields, and the credit state are printed as factors and never change the state.","states":["SERVES-KIND","TESTNET-ONLY","DOES-NOT-SERVE","RESPONSE-UNPARSEABLE","FACILITATOR-UNREACHABLE"],"network_aliases":{"solana":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","solana-devnet":"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1","base":"eip155:8453","base-sepolia":"eip155:84532","ethereum":"eip155:1","sepolia":"eip155:11155111"},"testnet_tokens":["testnet","sepolia","devnet","goerli","holesky","mumbai","amoy","fuji"],"testnet_caip_forms":["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1","eip155:84532","eip155:11155111"],"known_testnet_only_hosts":["x402.org"],"payai_host":"facilitator.payai.network","guarantee_keys":["refundable","refundPolicy","guarantee","guarantees","flow","sponsorPolicy","ceiling","escrow","disputeWindow","sponsorsGas"],"guarantee_absence_line":"No guarantee-relevant fields are published in this facilitator's /supported response; the absence is the report — no guarantee field has been filled in or inferred.","verdict_grammar":{"line":"FACILITATOR FIT CHECK — state: <STATE> — <check-end UTC>","vocabulary":"The line carries exactly one of the five published states. There is no composite score, grade, or band anywhere in this op."},"free_precheck":"The free pre-check (POST /precheck) validates the submitted challenge's shape and the facilitator URL against the published URL policy and returns assessability ONLY: the common signed fields, which challenge fields are present, the facilitator host, whether the PayAI credit leg applies, and the disclosure/honesty/retention lines. It does NOT read the facilitator and returns no fit state and no factor result. Free allowance: 100 per day per caller wallet, minimum interval 5,000 ms, 402 on exhaustion.","custody":{"construction":"In-memory processing within a single request lifetime; the facilitator responses persist nowhere, on any path including errors and timeouts. No hash of a facilitator response appears anywhere.","ledger_closed_fields":["payer wallet","timestamp/day","price (USDC units) with the CAD fair-market-value block (rate, rate date, basis, cad_pending, refund)","payment tx id + Solana fee (lamports)","criteria version","verdict line","fit state","serves_kind flag","testnet_only flag","credit state","house flag"],"ledger_note":"The ledger list above is closed: adding a field is a criteria/handling version change. The ledger NEVER carries the facilitator URL, any host path, the seller wallet, any signer address, any guarantee value, any /supported fragment, or any credit-response fragment.","errors":"Error handling is closed-form: static strings plus numeric facts only (lengths against caps, rule ids). No error path interpolates any part of a facilitator response."},"forbidden":"Forbidden in every surface of this op (report, pre-check, errors, ledger, metrics): any composite score or grade; any guarantee field or credit state the facilitator did not itself publish; any signer address; any claim that a payment is guaranteed to settle.","boundary_statement":"Boundaries: vs A1 Challenge Payability Verdict (payability/v1) — A1 grades a seller endpoint's 402 challenge field by field; this op grades the facilitator the challenge names (whether it serves the kind, is testnet-only, publishes signers and guarantee fields, and, for PayAI, the seller's free-credit state). Different artefact, different read. Vs C2 Failure Translator (same family, failure-translation/v1) — C2 translates the artefacts of a call that already failed; this op runs before paying and probes nothing beyond the facilitator's published endpoints. Vs C4 Funding & Gas Readiness (same family) — C4 grades the payer's wallet against the challenge; this op grades the facilitator.","disclosure_sentence":"Submitting a facilitator URL to any third party, this service included, discloses that you are checking that facilitator; the facilitator responses are processed in memory only and never stored, but the check does not undo the disclosure.","honesty_line":"The report grades the facilitator's /supported response (and, for PayAI, its free-credits lookup) exactly as served at check time; a facilitator can change what it publishes between checks, and a SERVES-KIND report states that the kind was listed at that moment — it is not a guarantee that a payment will settle.","retention":"Facilitator responses are processed in memory only and are never stored — not in KV, not in logs, not in the payments ledger, not in metrics, and not in error records. No /supported body, credit response, fragment of one, or hash of one is recorded anywhere. Reports carry the fit state, the printed factors, the guarantee fields exactly as published, and the credit state only. The payments ledger records only the closed field list published in the criteria. Because nothing is kept, a paid retry re-submits the challenge.","payment_includes":"$0.01 per challenge facilitator fit check. The payment includes: one facilitator fit check for the challenge you submit (its network, its scheme, and the seller's facilitator URL where the challenge or tooling names it) — this service reads that facilitator's public /supported endpoint (a designed-purpose endpoint) and, where the named facilitator is PayAI, its public per-wallet free-credits lookup for the seller wallet you name — and returns one signed report giving the fit state (SERVES-KIND, TESTNET-ONLY, DOES-NOT-SERVE, RESPONSE-UNPARSEABLE, or FACILITATOR-UNREACHABLE), whether the facilitator serves this kind, whether the endpoint is testnet-only, whether signer addresses are present for the network (presence and count only — addresses are not printed), the guarantee-relevant fields exactly as published (most facilitators publish none, and the absence is the report — a guarantee field is never filled in or inferred), and the seller's credit state where a per-wallet lookup is published (PayAI free credits: available / low / exhausted; CDP quota state and paid-credit balances are unpublished per-wallet and are reported NOT-PUBLISHED, never estimated). Every factor is printed; no composite score is computed. An unparseable or unreachable facilitator response is graded as observed, never guessed. A free pre-check validates the submitted challenge's shape and the facilitator URL against the published URL policy before any payment; it performs no facilitator read and returns no fit result. The facilitator responses are processed in memory only and are never stored; the payments ledger records only the payer, the time, the price, the fit state, the serves-kind and testnet-only flags, the credit state, and the verdict line.","kill_line":"Kill line (M-29 / C3, under the operator's 2026-11-03 build-bank-hold doctrine): build, bank, and hold; judged at the fleet's periodic reviews. There is NO demand kill line for this item. Day-0 = first outside paid settle (accounting only; house proofs never count). Tripwires, all stop-and-review: (1) refunds >5% in any 30-day window; (2) free use >10x paid use; (3) a wrong fit state from undisclosed stale or partial data (the error enters the corpus first as a regression case, corrected rules publish as a new criteria version, the corpus re-passes at 100% before serving resumes; issued reports are never amended); (4) honesty fence: any guarantee field or credit state published that the facilitator did not itself publish; (5) custody: any surface retaining a facilitator response or a fragment of one; (6) any facilitator read outside the published URL policy.","never":"This op never follows a redirect; never sends credentials; never stores a facilitator response; never computes a composite score; never prints a signer address; never estimates a credit state or fills in a guarantee field.","service":"facilitator-fit","version":"1.0.0","endpoints":{"criteria":"GET /criteria (free)","precheck":"POST /precheck (free, challenge-shape + URL-policy validation + assessability only: no facilitator read, no fit result)","check":"POST /check (paid, $0.01 per challenge: signed facilitator fit report)","metrics":"GET /metrics","not_offered":"Any other POST path answers NOT COVERED — this worker serves op check only."}}