Skip to content

Add Vouch402 plugin (x402-metered on-chain risk scores + EAS attestations) - #152

Open
Eras256 wants to merge 2 commits into
base:masterfrom
Eras256:add-vouch402-plugin
Open

Add Vouch402 plugin (x402-metered on-chain risk scores + EAS attestations)#152
Eras256 wants to merge 2 commits into
base:masterfrom
Eras256:add-vouch402-plugin

Conversation

@Eras256

@Eras256 Eras256 commented Aug 13, 2026

Copy link
Copy Markdown

What

Adds skills/base-mcp/plugins/vouch402.md, a plugin for Vouch402: an x402-paid HTTP API that returns an on-chain risk score for a Base address and records an EAS attestation of what was delivered on every successful paid response. integration: http-api; the only Base MCP call in the flow is send_calls for the USDC payment.

Also appends two genuinely new tags, risk-scoring and attestations, to the shared vocabulary in plugin-spec.md (no existing tag covers either capability): the only other change in this diff, per Contribution Scope.

Verification

Every example in the plugin file (the 402 payment-requirements body, the /v1/metrics shape, the dispute signature message) was checked against the live, currently-running service directly before opening this PR, not written from memory. Self-reviewed against the Authoring Checklist; the plugin-review skill isn't available in the environment this was authored in, so this is a manual self-review, not a tool-validated one.

Disclosure

This plugin file, and the Vouch402 service it documents, were built with substantial AI assistance (Claude Code) working alongside the human author throughout. Noting this since it plausibly matters here.

@cb-heimdall

cb-heimdall commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

Eras256 added a commit to Vouch402/Vouchx402 that referenced this pull request Aug 13, 2026
Recorded the checklist re-verification against real current
plugin-spec.md and plugins/vouch402.md, the CONTRIBUTING.md staleness
finding (checked against real, active external-PR history before
proceeding rather than treating the written policy as automatically
current), and the PR itself: base/skills#152

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ions)

http-api plugin for Vouch402 (https://vouch402.fly.dev): risk-gated
via x402, records an EAS attestation on every successful paid
response. Every example in the file (402 body, /v1/metrics shape,
dispute signature message) was checked against the live service
directly before this PR, not written from memory.

Also appends risk-scoring and attestations to the shared tag
vocabulary in plugin-spec.md, since neither existing tag covers
this capability.
@Eras256
Eras256 force-pushed the add-vouch402-plugin branch from 5e687c0 to 456cc76 Compare August 14, 2026 21:21
The plugin spec was frozen at the Vouch402 repo's pre-jurisdiction-
blocklist state (this branch's only commit predates that feature by two
days). Production now hard-enforces jurisdictionAttestation: true on
every paid retry -- verified live against vouch402.fly.dev -- and this
spec never mentioned it, so anyone following it as written would pay
real USDC on-chain and then hit an unexplained 403 with no recourse.

Adds the field to the retry header example, a new 403 response case,
orchestration steps 6-7, and a Jurisdiction restrictions entry under
Risks & Warnings. Bumps this doc's own version 0.1.0 -> 0.2.0. Content
verified against the real Vouch402 source and a live production request
before being written here, not just copied from memory.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Eras256 added a commit to Vouch402/Vouchx402 that referenced this pull request Aug 30, 2026
Eras256/Vouchx402 is private (a deliberate, unrelated decision for
another grant process this week), so every link in the pitch deck
pointing at it 404s for a real anonymous visitor -- including a Batches
004 reviewer. Found while verifying the tokenized-equities slide's own
new link, then audited the rest of the deck rather than fixing just the
one that prompted it.

- pitch-tokenized-equities.tsx: the GitHub contract-list link -> 3
  Basescan links (AAPLc, TSLAc, NVDAc, the same tickers already named in
  the body text), moved into the "shipped" block where they semantically
  belong; the attestation link stays alone in "prototype".
- pitch-cover.tsx: "Docs" -> /docs (the site's own public page, already
  serving today's synced TECHNICAL_SPEC.md content, confirmed live
  before pointing at it). "GitHub" removed, no replacement -- there's no
  clean public equivalent for "see the full source", and pointing it at
  something indirect would mislabel what it links to.
- pitch-ecosystem.tsx: the plugin link -> Eras256/skills (public fork,
  confirmed), the exact branch/file backing base/skills#152 -- more
  appropriate there anyway, it's literally what a Base maintainer would
  review.
- pitch-links.tsx: "GitHub" removed, same reasoning as cover.tsx.
  "Contact via GitHub" -> a real Telegram link (https://t.me/Vaiosx),
  the actual contact channel, not an indirect stand-in.

Removed the now-orphaned "github" translation keys from pitch.cover.links
and pitch.links in en.json/es.json (no replacement, not renamed).

Verified all 7 final target URLs return 200 live -- not just that the
href looks right -- before committing: 3 Basescan token pages, the
Sepolia attestation, /docs, the Eras256/skills file, and the Telegram
link. `npx tsc --noEmit` clean, full `npm run build` compiles all 8
pages with no errors.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants