twzrd.xyz

TWZRD is pre-spend trust for the x402 SERVICE you are about to buy (seller + resource), not a payer-graph explorer. PRIMARY WORKFLOW (use these first): (1) evaluate_x402_resource(resource_url) when you have a URL — fetches 402, extracts seller, preflight; if you need to discover what is callable, use HTTP GET /v1/intel/resources (resource join SOT: listed|live_402 discovery claims separate from settlement trust) — not a new MCP tool; (2) get_merchant_card(wallet) — route on next_action.decision (refuse | insufficient_evidence | no_negative_signal); wash_flagged=true refuses; null means never evaluated (NOT clean); (3) get_readiness_card_tool(seller_wallet|resource) — free decision allow|warn|block + reason_codes + recommended_action + maximum_recommended_spend_usdc (advisory, not legal advice); (4) verify_receipt — offline check of a signed V6 receipt after paid trust. (5) twzrd_watch_add — re-check seller after recheck_after_unix (when watch lane enabled). On block / recommended_action=do_not_pay: do not pay. On warn: respect cap. On allow: proceed only under agent policy. Discovery: prefer HTTP GET /v1/intel/resources (callable catalog + settlement join; stays off the MCP tool list so tool count remains 24). Optional ingested-listing overlay: get_x402_directory. Paid portable proof: GET /v1/intel/trust/{pubkey}?seller_wallet=<payTo> ($0.05 USDC). New here? twzrd_demo_gate runs a zero-setup, no-spend proof of this gate (block path aborts, no wallet, no USDC). get_top_intel_agents is secondary corpus research (who is paying), not the default start path. Streamable-http: Accept application/json, text/event-stream is optimal; plain application/json / */* / missing Accept are accepted (server normalizes). MACHINE RE-CALL: paid receipts carry twzrd_receipt.preimage.{recheck_after_unix, staleness_days, score_decay_model}; re-call trust when due. score_decay_model is 'step:<=7d=1.0,<=30d=0.8,<=90d=0.5,>90d=0.25'. Payer holds USDC for paid calls; gas is sponsored. PUSH RE-CALL (watch lane): after preflight or paid trust, register a watch with twzrd_watch_add(payer_wallet, seller_wallet, webhook_url?) - TWZRD re-checks the seller when recheck_after_unix elapses and POSTs to your webhook when the score/decision materially changes. Poll-only agents omit webhook_url and check twzrd_watch_list(payer_wallet). twzrd_watch_remove(watch_id, payer_wallet) deactivates.