{"schema":"scry_error_contract_v1","posture":"machine_readable_degraded_responses","contract":"Errors and degraded paid responses avoid raw payment headers, secrets, and policy recommendations.","common_shapes":{"invalid_wallet":{"http_status":400,"body":{"error":"invalid_solana_address","message":"Address is not a valid Solana wallet address.","hint":"Use a base58 Solana address, usually 32-44 characters.","fixable_by":"Validate the address before retrying, then call the same endpoint again."},"retryable":false},"invalid_mint":{"http_status":400,"body":{"error":"invalid_solana_mint","message":"Mint is not a valid Solana token mint address.","hint":"Use a base58 Solana mint address, usually 32-44 characters.","fixable_by":"Validate the mint before retrying, then call the mint-risk endpoint again."},"retryable":false},"payment_required":{"http_status":402,"body":{"error":"X-PAYMENT header is required"},"retryable":true,"hint":"Read the 402 payment requirements, sign an x402 exact USDC payment, and retry with X-PAYMENT.","fixable_by":"Use an x402 client such as `npx awal@2.8.2 x402 pay` or another compatible agent wallet.","note":"Payment requirements are provided by the x402 protocol response, not duplicated in this public contract."},"unsupported_entity":{"http_status":200,"body":{"supported":false,"unsupported_reason":"KNOWN_ROUTER | CEX_ENTITY | KNOWN_SERVICE | KNOWN_PROGRAM","risk":"UNKNOWN","coverage":{"warnings":["unsupported_entity"]}},"retryable":false,"hint":"This address is classified as infrastructure, exchange, router, service, or program-like context before wallet-cohort classification.","fixable_by":"Use this response as exclusion evidence in wallet-cohort workflows, or query a different wallet."},"coverage_unavailable":{"http_status":200,"body":{"supported":true,"coverage":{"coverage_status":"unavailable","confidence":"UNKNOWN","missing_fields":["activity","balance","identity"]}},"retryable":false,"hint":"The wallet is syntactically valid, but Scry does not currently have enough indexed evidence for a deep response.","fixable_by":"Treat as low-confidence input, or request a separate enrichment workflow before relying on it."},"upstream_helius_unavailable":{"http_status":200,"body":{"supported":true,"degraded":true,"degradation_reason":"upstream_helius_unavailable","risk":"UNKNOWN","confidence":"UNKNOWN","confidence_score":0,"coverage":{"checked_sources":[],"unchecked_sources":["helius_rpc"],"warnings":["helius_rpc_missing","no_data_sources_available"]}},"retryable":true,"retry_after_seconds":300,"hint":"Helius-backed data sources were unavailable, so Scry withheld a risk verdict instead of returning a confident but unsupported answer.","fixable_by":"Retry after retry_after_seconds, or use this response only as low-confidence unavailable-state evidence."},"beta_endpoint_degraded":{"http_status":200,"body":{"supported":true,"beta":true,"degraded":true,"degraded_until":null,"risk":"UNKNOWN","confidence":"UNKNOWN","coverage":{"warnings":["beta_endpoint_degraded"],"missing_fields":["holder_concentration","creator_context","liquidity_context"]}},"retryable":true,"retry_after_seconds":300,"hint":"The beta endpoint is reachable but cannot currently provide its normal evidence fields.","fixable_by":"Retry later or escalate to a caller-owned Helius workflow if the policy requires fresh mint evidence now."},"upstream_rate_limited":{"http_status":503,"body":{"error":"upstream_unavailable","retry_after_seconds":60},"retryable":true,"hint":"Upstream data source was temporarily unavailable or rate-limited.","fixable_by":"Retry after retry_after_seconds, or use cached/stale evidence only if caller policy allows it."},"settlement_failed":{"http_status":402,"body":{"error":"payment_settlement_failed","reason":"network_or_facilitator_error"},"retryable":true,"hint":"The request reached the payment layer, but settlement did not complete.","fixable_by":"Check payment wallet balance/network/facilitator status, then retry the same request.","note":"The live response may include a public transaction id. Raw payment headers are never exposed."}},"caveat":"Evidence layer only. Not financial advice or a trading recommendation."}