# TWZRD Agent Intelligence

TWZRD is the trust + receipt layer that autonomous agents call BEFORE and AFTER
paying. BEFORE: a free preflight ReadinessCard (https://intel.twzrd.xyz/v1/intel/preflight)
tells an agent whether a counterparty/resource is safe to spend on (can_spend,
decision, caveats, and a trust_score that is a marketplace-quality heuristic --
see trust_score_basis -- not a cross-facilitator corpus reputation score). AFTER:
a paid trust call returns the full corpus reputation plus a portable V5 receipt
anchored to the settlement transaction. It is a discovery + trust surface for
x402 agents on Solana, not another way to pay.

## Paid (x402, USDC on Solana mainnet)
- GET https://intel.twzrd.xyz/v1/intel/trust/{pubkey}  -> 0.05 USDC. Live trust intel + portable V5 receipt. Proven on mainnet.

## Free (no payment, no auth)
- GET  https://intel.twzrd.xyz/v1/receipts/example   (no-wallet SAMPLE signed receipt -> verify offline before you spend; see "Zero-wallet demo" below)
- POST https://intel.twzrd.xyz/v1/intel/preflight   (the one-command demo; BEFORE-path ReadinessCard)
- GET  https://intel.twzrd.xyz/v1/intel/score_wallet_for_intel?wallet=...
- GET  https://intel.twzrd.xyz/v1/intel/get_top_intel_agents?limit=10
- GET  https://intel.twzrd.xyz/v1/intel/solana_market_visibility_map
- GET  https://intel.twzrd.xyz/v1/intel/solana_market_orderbook_depth?ticker=...
- GET  https://intel.twzrd.xyz/v1/intel/solana_market_shape?ticker=...
- GET  https://intel.twzrd.xyz/v1/intel/solana_market_onchain_trades_summary
- POST https://intel.twzrd.xyz/v1/receipts/verify   (recompute + check a portable V5 receipt leaf)
- GET  https://intel.twzrd.xyz/.well-known/x402      (machine-readable service descriptor)
- GET  https://intel.twzrd.xyz/openapi.json          (OpenAPI 3.1 with x402 annotations)
- GET  https://intel.twzrd.xyz/health

## Zero-wallet demo (free, no payment — proves offline verification before you spend)
curl -s https://intel.twzrd.xyz/v1/receipts/example | python3 -c 'import sys,json;json.dump(json.load(sys.stdin)["twzrd_receipt"],open("receipt.json","w"))'
npx twzrd-receipt-verifier@latest receipt.json    # -> VALID (TWZRD-authored, untampered)

## One-command demo (free)
curl -s -X POST https://intel.twzrd.xyz/v1/intel/preflight \
  -H 'content-type: application/json' \
  -d '{"resource_name":"Jupiter Quote Preview","price_usdc":0.01}'

## Receipt (portable + signed)
The V5 receipt is a PORTABLE keccak256 leaf (tamper-evidence) PLUS an Ed25519
signature over the leaf bytes (authenticity). Verify it offline: recompute the
keccak leaf from the preimage AND check the signature against the published
TWZRD receipt-signing public key (key_id twzrd-receipt-ed25519-v1, base58
9V6Pn19kiUA5Rn6JpQfNduanvGt2aXGwsarosNfa2Ldf, ed25519) -- also exposed at /.well-known/x402 and
/openapi.json. Unsigned or wrong-key receipts are rejected. The settlement_tx
anchor stays independently checkable on-chain for ground truth.

## Verify offline (standalone tool, trusts no TWZRD code)
A stranger can verify a V5 receipt with only the published key + audited crypto libs:
  pip install twzrd-receipt-verifier   # then: twzrd-verify-receipt receipt.json --pubkey 9V6Pn19kiUA5Rn6JpQfNduanvGt2aXGwsarosNfa2Ldf
  npx twzrd-receipt-verifier receipt.json --pubkey 9V6Pn19kiUA5Rn6JpQfNduanvGt2aXGwsarosNfa2Ldf

## Live mainnet proof
First external autonomous x402 payment (0.05 USDC):
tx 3aXGtvmNvFhSSDXF8D4DBDntXFczraUABg75MdWtCgchdYAApRwC7KxdGxbCmewYcA6ZNzw6FvdAHcoevMUG44Sc
https://solscan.io/tx/3aXGtvmNvFhSSDXF8D4DBDntXFczraUABg75MdWtCgchdYAApRwC7KxdGxbCmewYcA6ZNzw6FvdAHcoevMUG44Sc

Live at https://intel.twzrd.xyz