WalletGuard — wallet AML risk
walletguard_scoreWalletGuard (x402-paid, $0.10): deterministic wallet AML/compliance risk scorer. From caller-provided context (sanctions, exposures, labels, fund sources) returns a 0-100 risk score, level, and evidence-backed findings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payer | No | Optional wallet/account identifier; stored only as a hash | |
| apiKey | No | Free-tier / plan API key (hp_free_… or a pass key). Forwarded as X-API-Key so paid tools serve from your monthly quota with NO x402 wallet. Get a free key (250 calls/mo) at https://hermesplant.com/pricing. | |
| labels | No | Address labels, e.g. exchange:binance, contract:..., sanctions:... | |
| wallet | Yes | Wallet address | |
| channel | No | Discovery channel or source tag | |
| campaign | No | Campaign tag for downstream telemetry | |
| xPayment | No | Raw X-PAYMENT proof from an x402-compatible wallet/client | |
| actorType | No | Caller type for analytics: agent, human, synthetic, system, or unknown | |
| exposures | No | Signals e.g. mixer:tornado, sanctions:ofac | |
| synthetic | No | Mark this paid retry as an internal test/probe for analytics exclusion | |
| transfers | No | Optional transfer summaries (direction, value, counterparty, tags) | |
| sanctionsHits | No | Sanctions / OFAC / blacklist hit identifiers | |
| fundingSources | No | Optional fund-source breakdown (source, share 0-1, verified) | |
| paymentSignature | No | x402 payment proof to forward as PAYMENT-SIGNATURE and X-PAYMENT on retry | |
| paymentIdentifier | No | Optional x402 payment identifier for idempotency/retry correlation |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the upstream storefront call returned a 2xx response | |
| httpStatus | Yes | Upstream HTTP status code | |
| paymentRequired | No | True when the response is an x402 HTTP 402 payment challenge |