← Back to Skills Marketplace
twzrd-sol

TWZRD Trust

by twzrd-xyz · GitHub ↗ · v1.1.1 · MIT-0
cross-platform ✓ Security Clean
49
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install twzrd-trust
Description
Check any Solana wallet or x402 seller BEFORE paying it. Free preflight returns a ReadinessCard (allow / warn / block + trust score + caveats) from a 50k+-pa...
README (SKILL.md)

TWZRD Trust - check the counterparty before the money moves

TWZRD is the independent scorer on the real Solana x402 payer graph. It observes cross-facilitator x402 payment behavior and scores it. Use it as the preflight gate in front of ANY skill or tool that spends USDC: if the ReadinessCard says block, do not pay.

No API key. No signup. Free tier needs nothing but curl.

The one rule

Before signing or sending any x402 payment to a seller you have not paid before:

curl -s -X POST https://intel.twzrd.xyz/v1/intel/preflight \
  -H 'content-type: application/json' \
  -d '{"resource_name": "\x3Cservice name>",
       "seller_wallet": "\x3Cseller pubkey you are about to pay>",
       "price_usdc": 0.05,
       "agent_intent": "\x3Cwhy you are paying>",
       "queried_pubkey": "\x3Cyour wallet, optional>"}'

Read readiness_card.decision:

  • block -> abort. Do not sign or send the payment.
  • warn -> proceed with caution (low corpus signal, not confirmed bad).
  • allow -> proceed normally.

Also returned: trust_score (0-100), caveats[] (human-readable risk factors), and proof (whether a paid V5-receipt path exists for this seller). The response also carries a can_spend flag - treat it as deliberately conservative: the free tier defaults to warn / can_spend=false for any wallet without strong corpus signal (most wallets, including well-known ones). Gate on decision=block, not on can_spend. Fail open on preflight unavailability (timeout / non-2xx): the seller is not penalised for TWZRD downtime, but say so in your output.

Free discovery tools (HTTP, no auth)

Call What it answers
GET /v1/intel/score_wallet_for_intel?wallet=\x3Cpubkey> 0-100 intel score for one wallet
GET /v1/intel/get_top_intel_agents?limit=10&min_paid_calls=2&max_days_since_last=14 who is actively paying on Solana x402 (denoised leaderboard)
GET /v1/intel/get_counterparties?wallet=\x3Cpubkey>&limit=10 top merchants a wallet pays
GET /v1/intel/get_facilitator_footprint?wallet=\x3Cpubkey> which x402 facilitators a payer settled through
GET /v1/intel/compare_wallets?wallet_a=...&wallet_b=... side-by-side intel for two wallets
POST /v1/intel/score_wallets_batch body {"wallets":[...]} score up to 25 wallets in one call
seller-side reputation returned as the provider_reputation block inside the preflight response above (also the MCP tool get_provider_reputation) - there is no standalone HTTP GET route

Base URL for everything: https://intel.twzrd.xyz

Paid trust call (x402, 0.05 USDC on Solana mainnet)

GET https://intel.twzrd.xyz/v1/intel/trust/{pubkey}?seller_wallet=\x3Cseller you are about to pay>

Standard x402 flow: first request returns 402 with payment requirements; sign and retry with the payment header (any x402 payer skill or @wzrd_sol/sdk handles this). Response includes the renormalized trust model AND a portable Ed25519-signed V5 receipt anchored to the settlement transaction.

Pass the seller counterparty on every paid call (?seller_wallet= here, ?merchant= on the market intel routes). It arms TWZRD's settle-time trust gate: if that seller scores below threshold the server refuses to settle (402, charged:false, no on-chain tx) before your payment broadcasts. The scored {pubkey} subject itself is never gated.

Verify any V5 receipt offline (trusts no TWZRD code)

npx twzrd-receipt-verifier receipt.json --pubkey \x3Cpublished signing key>
# or: pip install twzrd-receipt-verifier

The signing key is published at https://intel.twzrd.xyz/.well-known/x402 and inside /openapi.json. A receipt that fails signature verification is not a TWZRD receipt.

Optional: native MCP (streamable HTTP)

The same intel is exposed as an MCP server - 17 tools, MCP 2025-03-26 over streamable HTTP, no local install. The install fact is the URL:

https://intel.twzrd.xyz/mcp   (transport: streamable-http)

Add it through your MCP client's server config. OpenClaw builds that expose an mcp command can use:

openclaw mcp add twzrd --url https://intel.twzrd.xyz/mcp --transport streamable-http

If your build has no mcp command, use the HTTP calls above directly, or bridge via mcporter.

Honest framing (read before quoting numbers)

Corpus totals are ECOSYSTEM payment behaviors TWZRD observes and scores - not calls or revenue to TWZRD. Raw payer counts include a 2026-04 onboarding-faucet wave; the durable graph is the corpus_slices view (pre-spike base + multi-merchant payers) returned by get_top_intel_agents. Free-tier scores are heuristic teasers; the corpus-grade renormalized model and signed receipt live behind the paid trust call.

External-traction claims use the verified 9iXAtu $0.05 framing only - no overclaims. Paid surface is 0.05 USDC x402 (Solana mainnet).

More

  • Machine-readable service descriptor: https://intel.twzrd.xyz/.well-known/x402
  • Full agent orientation: https://intel.twzrd.xyz/llms.txt
  • OpenAPI 3.1 with x402 annotations: https://intel.twzrd.xyz/openapi.json
Usage Guidance
Install only if you are comfortable with a third-party trust service receiving seller/payment context. Before use, confirm what wallet addresses and payment details will be sent, and avoid including your own wallet address unless it is necessary for the check.
Capability Tags
cryptofinancial-authorityrequires-walletcan-make-purchasescan-sign-transactionsrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The described capability, checking seller or wallet trust before a payment, coherently explains why seller wallet, service, price, and intent would be sent to a trust-scoring endpoint.
Instruction Scope
The trigger phrases are broad enough that an agent could invoke the skill for generic payment-safety language, so users should expect the agent to confirm before sending payment-context details.
Install Mechanism
No risky installer, package execution, background worker, or persistence mechanism was identified from the supplied scan context.
Credentials
The network payload may include wallet addresses and transaction intent, which are sensitive context even if they are purpose-aligned for trust scoring.
Persistence & Privilege
No artifact-backed evidence shows credential use, wallet signing authority, privilege escalation, local profile access, or durable local persistence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install twzrd-trust
  3. After installation, invoke the skill by name or use /twzrd-trust
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
P0 fix: shell-mangled 0.05 framing (9iXAtu /usr/bin/zsh.05 from tmux double-quoted relay) corrected to clean 9iXAtu $0.05 only. 50k+-payer corpus, ClawRouter compose, onBeforeSettle gate, queried_pubkey. All public surfaces now guarded by test.
v1.1.0
ClawHub track3 + 9iXAtu 0.05 framing. abort on block, 50k+-payer corpus, ClawRouter compose.
Metadata
Slug twzrd-trust
Version 1.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is TWZRD Trust?

Check any Solana wallet or x402 seller BEFORE paying it. Free preflight returns a ReadinessCard (allow / warn / block + trust score + caveats) from a 50k+-pa... It is an AI Agent Skill for Claude Code / OpenClaw, with 49 downloads so far.

How do I install TWZRD Trust?

Run "/install twzrd-trust" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is TWZRD Trust free?

Yes, TWZRD Trust is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does TWZRD Trust support?

TWZRD Trust is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created TWZRD Trust?

It is built and maintained by twzrd-xyz (@twzrd-sol); the current version is v1.1.1.

💬 Comments