# Resource access and pricing

Wallet Overview and Website Risk Check are free within usage limits. Other available reports require an individual Base USDC payment; see https://quantumsshield.com/resources for current prices. Paid preview endpoints no longer provide free results. Public report inputs must not contain secrets.

API domain: https://quantumsshield.com
OpenAPI: https://quantumsshield.com/openapi.json
Discovery: https://quantumsshield.com/.well-known/x402
Paid endpoints: POST /api/resources/{resource-id}

The service prepares the report before requesting a payment signature. Provider failures before a quote do not charge the buyer. Pending settlement is not success: recover the same order instead of signing another payment. Only verified resources are exposed in discovery.

# Quantum Shield resource APIs

Updated 26 October 2026. X-Pay is excluded at the owner's request. No settlement provider is selected, no payment signatures are accepted, and no transactions are initiated.

## Availability

The catalogue contains 15 resource definitions. Thirteen have limited, free preview implementations. Transaction simulation and QR extraction remain unavailable until the required providers/isolated decoder are implemented and validated. A preview is not a full security audit or a production availability guarantee.

- Website risk: hostname reputation and URL patterns.
- Website deep: bounded static public HTML/script review; no browser execution.
- Wallet overview: native balance, account nonce and code type.
- Token check: self-reported ERC-20 metadata.
- Approval check: one explicit owner/token/spender ERC-20 allowance, not all approvals.
- Multichain summary: five separate native account snapshots, partial failures disclosed.
- Transfer history: first Blockscout page of transactions and token transfers on Base/Ethereum.
- Destination labels: explorer public tags, unverified ownership. No inferred exchange identity.
- Wallet compare: same-block account snapshots, not relationship tracing.
- Contract privileges: owner() and two EIP-1967 storage slots, not a complete role audit.
- Quantum Readiness: account-state evidence with an actionable preparation checklist. Public-key exposure remains unknown; no quantum-protection claim.
- Evidence report: account snapshot and optional contract metadata, each with its own block evidence.
- Snapshot change: caller-provided prior state compared with current account state, no background monitoring or authenticated history.

## Endpoints

GET /api/resources lists descriptions, proposed prices, input schemas, availability and preview paths.
GET /api/resources/openapi.json documents runnable previews. GET /openapi.json includes the existing workspace API and preview paths.
POST /api/resource-preview/{id} accepts JSON and returns {resource, mode: "free_preview", charged: false, report}.
POST /api/resources/{id} is reserved for paid access and currently returns 503 payments_not_configured (or resource_not_available). It does not return a payable 402 challenge.

Example:

```sh
curl https://quantumsshield.com/api/resource-preview/wallet-overview \
  -H 'Content-Type: application/json' \
  --data '{"chain":"base","address":"0x0000000000000000000000000000000000000001"}'
```

Preview limits: 20 requests/hour per hashed IP across resource previews. Existing website scan quotas also apply. Provider errors are reported, not converted into clean results. No private keys, seed phrases, cookies or signed payments belong in inputs. Public address queries go to RPC/explorer providers; hostname checks go to PhishDestroy and deep-scan public content may be reviewed by Workers AI. Do not submit URLs containing secrets. Cloudflare/provider infrastructure may retain request metadata.

## Settlement configuration

Owner-provided Base receiving address: 0x26a829DaE4942A40857023021bada0969f02d2db.
This is a public recipient, not proof of ownership or a payer. Never generate a receiving address on the owner's behalf. Direct transfers do not purchase a report.

Planned network: Base, eip155:8453. Planned asset: USDC, 6 decimals, contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. Prices in the catalogue are proposed future per-request prices; Quantum Readiness is $0.12. Provider costs and coverage must be validated before paid launch.

Payments are hard-disabled in code. Environment flags alone cannot enable them. X-Pay is selected for Base. Its dedicated credential is stored as a Cloudflare server secret. The adapter is implemented and unit-tested but is not yet connected to paid routes. Before enabling charging, implement and test:
1. Trusted server-built x402 v2 requirements and PAYMENT-REQUIRED transport.
2. Compatible signed authorization verification, bound to exact network, asset, amount, recipient and order/resource.
3. Durable nonce/order deduplication, atomic execution locks, timeout reconciliation and result retrieval.
4. Settlement receipt validation including successful execution and expected transfer, not merely HTTP 200.
5. No new charge on retries; provider failures, pending settlements and refunds require explicit policies.
6. Bounded agent budgets and approved recipient/resource allowlists. No private keys in source or logs.
7. An explicitly approved real purchase and receipt/result verification before enabling paid discovery.

## x402scan registration

/.well-known/x402 intentionally returns an empty resources list while payments are disabled. Planned or unconfigured endpoints must not be submitted as live paid resources. OpenAPI publishes free preview operations without x-payment-info. A resource being listed is separate from a transaction being indexed; listing alone neither executes payments nor guarantees transaction visibility.

After a selected settlement integration passes end-to-end tests: expose valid HTTP 402 challenges, nonempty accepts, atomic amounts, Bazaar input schemas and documented prices; update paid OpenAPI operations and discovery; register at https://www.x402scan.com/resources/register; verify facilitator/settlement indexing and the resource listing separately.

References: https://github.com/Merit-Systems/x402scan/blob/main/docs/DISCOVERY.md and https://github.com/x402-foundation/x402 .

## Verification commands

`node scripts/check-resources.mjs` checks public metadata and payment-disabled responses. It cannot sign, spend, or generate volume. Existing automated tests mock upstream data and do not establish real-world risk-detection accuracy. No automatic transaction script is included until payment architecture and spending authorization are confirmed.
