Skip to content

feat: add MainStreet action provider (onchain-verifiable reputation check)#1279

Open
philpof102-svg wants to merge 1 commit into
coinbase:mainfrom
philpof102-svg:add-mainstreet-action-provider
Open

feat: add MainStreet action provider (onchain-verifiable reputation check)#1279
philpof102-svg wants to merge 1 commit into
coinbase:mainfrom
philpof102-svg:add-mainstreet-action-provider

Conversation

@philpof102-svg
Copy link
Copy Markdown

What

Adds a MainStreet action provider — a pre-payment reputation check for Base counterparties.

check_reputation(address) returns a SAFE / CAUTION / BLOCK verdict + 0–100 score for any Base wallet, agent, or token, so an agent can refuse to pay a BLOCK-rated or unscored counterparty before it transacts (e.g. before an x402 settlement). Pairs naturally with the existing x402 and erc8004 providers.

MainStreet is an onchain reputation oracle on Base: each verdict is an EIP-712-signed attestation, verifiable onchain against the MainStreetVerifier contract (0x7397adb9713934c36d22aa54b4dbbcd70263592b) — the signal is checkable, not "trust us". Free read API (100 checks/day/IP), fully open source.

Implementation

  • Read-only HTTP API provider, same shape as defillama / messari (no wallet/config required; network-agnostic).
  • Safe default: an unknown / unscored address maps to CAUTION, never auto-"OK" — a reputation gate must not green-light a no-history wallet.
  • Includes: provider + zod schema + index.ts + provider README, registration in action-providers/index.ts, an entry in the package README, unit tests (mock fetch, covering SAFE / BLOCK / unknown / HTTP error / network error / supportsNetwork), and a changeset.

Links

  • npm: @raskhaaa/mainstreet-oracle · repo: github.com/philpof102-svg/mainstreet
  • Hosted MCP: claude mcp add --transport http mainstreet https://avisradar-production.up.railway.app/mcp

@cb-heimdall
Copy link
Copy Markdown

🟡 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 1
Sum 2

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Jun 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants