# ChainVerdict
> Evidence-backed checks an autonomous agent runs BEFORE it moves money or trusts a counterparty.
> Profile a recipient address, verify a token is canonical, confirm a payment settled,
> validate an IBAN/VAT/BIC/LEI/ISIN, or check a domain's email/TLS posture — in one call, with no account.
>
> Every paid response carries a machine-readable _evidence object: checksPerformed, dataSources, freshness
> (with explicit stale-data risk), an ordinal assurance level, limitations, and whether human approval is recommended.
> Assurance is ordinal, never numeric: a number would imply a calibration that has not been performed.
> Responses carry an Ed25519 signature in an x-signature header over canonical JSON + '|' + x-signed-at;
> the public key is base64 SPKI at /.well-known/signing-key.json, which states the exact recipe. This is not
> the compact-JWS form the other services use, so verify these programmatically rather than at /verify.
> Methodology is public and free to read: https://chainverdict.xyz/v1/methodology
>
> Honest scope: these are informational signals for decision support. They are NOT regulated financial, legal or
> compliance advice, and the absence of a negative signal is never a guarantee of safety.
>
> Billing is per call in USDC on Base (x402) — no API keys, no signup, no subscription.

## Paid endpoints (x402, USDC on Base)
- GET https://chainverdict.xyz/v1/token/verdict/{address} — token safety verdict on Base, $0.01
- GET https://chainverdict.xyz/v1/wallet/dossier/{address} — wallet profile, $0.01
- GET https://chainverdict.xyz/v1/data/gas — live Base gas oracle (base fee, priority fees, congestion), $0.002
- GET https://chainverdict.xyz/v1/data/block — latest Base block info & utilization, $0.001
- GET https://chainverdict.xyz/v1/data/supply/{token} — token supply & burn distribution on Base, $0.003
- GET https://chainverdict.xyz/v1/data/activity/{token} — recent transfer count/volume/unique wallets, $0.005
- GET https://chainverdict.xyz/v1/data/portfolio/{address} — ETH + canonical token balances, $0.004
- GET https://chainverdict.xyz/v1/security/email/{domain} — SPF/DMARC/DKIM email-spoofing posture, $0.01
- GET https://chainverdict.xyz/v1/security/tls/{domain} — live TLS certificate validity/expiry check, $0.01
- GET https://chainverdict.xyz/v1/security/typosquat/{domain} — brand look-alike/homoglyph structural check, $0.005
- POST https://chainverdict.xyz/v1/batch/validate — batch-validate up to 500 IBAN/VAT/BIC/LEI/ISIN items, $0.10
- GET https://chainverdict.xyz/v1/verify/payment/{txhash} — on-chain ERC-20 settlement verification on Base, $0.02
- GET https://chainverdict.xyz/v1/verify/token/{addressOrSymbol} — canonical token verification on Base, $0.005
- GET https://chainverdict.xyz/v1/validate/lei/{lei} — ISO 17442 LEI validation, $0.002
- GET https://chainverdict.xyz/v1/validate/isin/{isin} — ISO 6166 ISIN validation, $0.001
- GET https://chainverdict.xyz/v1/validate/iban/{iban} — IBAN mod-97 validation, $0.001
- GET https://chainverdict.xyz/v1/validate/vat/{vat} — EU VAT format+checksum validation, $0.001
- GET https://chainverdict.xyz/v1/validate/bic/{bic} — BIC/SWIFT validation, $0.001
- POST https://chainverdict.xyz/v1/doc/html-to-markdown — HTML to Markdown, $0.002
- POST https://chainverdict.xyz/v1/doc/diff — structured text diff, $0.002

## Machine-readable
- Methodology (free): https://chainverdict.xyz/v1/methodology
- OpenAPI: https://chainverdict.xyz/openapi.json
- x402 discovery: https://chainverdict.xyz/.well-known/x402.json
- Response signing key (Ed25519, all /v1/* responses signed): https://chainverdict.xyz/.well-known/signing-key.json
- Independent quality attestation (Ed25519-signed, refreshed daily by x402pulse): https://pulse.chainverdict.xyz/v1/attestations/latest?url=https://chainverdict.xyz/v1/data/block