Skip to main content
Glama
deenesjakoruzh
bparlan

seeder-402

by bparlan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

seeder-402

Ein HTTP/MCP-Dienst für die Replikation vom Käufer bereitgestellter Hypercore/Hyperdrive-Schlüssel für USDC auf Base über x402.

Übersicht

seeder-402 implementiert einen permanent verfügbaren Replikationsdienst, der Zugriff auf vom Käufer bereitgestellte Hypercore/Hyperdrive-Schlüssel im Base-Netzwerk verkauft. Das System ermöglicht es Publishern, bis zu 50 MB große Bundles für 7 Tage zu hosten, unterhält 24-Stunden-Discovery-Schlüssel und unterstützt lease-basierte Zugriffskontrolle.

Related MCP server: x402-discovery

Architektur

Zwei Prozesse, eine VPS, eine Datenbank:

[Agent] --HTTP 402 / MCP--> [api] --IPC/CLI--> [blind-peer]
|
[SQLite]

  • api (Node 22+): x402-Middleware, kostenpflichtige MCP-Tools, Lease-JWT/HMAC, Kontingente, OpenAPI

  • blind-peer (Holepunch-CLI): DHT, Corestore, Replikation (keine Zahlungslogik)

  • SQLite: Leases, Zahlungen, Beschränkungen (nur v1)

Systemstatus

Aktueller Meilenstein

M1 — Money-Stub (aktiv)

  • Implementiert: Unbezahlte Anfragen → 402 Base Sepolia USDC

  • Implementiert: Facilitator-Verifizierung und -Abrechnung → 200 { ok: true }

  • Status: Geldinfrastruktur bereit, blind-peer ausstehend

Roadmap

Siehe docs/ROADMAP.md für die vollständige Meilensteinverfolgung. Aktueller Fokus: M7 (Mainnet) für die Produktionsreife.

Schnellstart

Voraussetzungen

# System dependencies
Node 22+
npm (or bun)
blind-peer-cli or blind-peering-cli
better-sqlite3 (npm)

Umgebungseinrichtung

# Configure environment (never commit)
export NETWORK=eip155:84532           # Base Sepolia
export PAY_TO=0x...                   # Payment recipient
export FACILITATOR_URL=https://x402.org/facilitator
export LEASE_SECRET=...              # JWT secret
export PEER_KEY=...                  # Blind-peer key
export STORE_PATH=/var/lib/seeder-402/corestore
export DB_PATH=/var/lib/seeder-402/leases.db
export MAX_KEYS=200
export MAX_BYTES_PER_KEY=52428800
export MAX_BODY_BYTES=52428800
export PRICE_SEED_USD=0.10
export PRICE_PIN_USD=0.20
export PRICE_HOUSE_USD=0.50
export PRICE_STATUS_USD=0.01

Ausführen

# Start blind-peer for DHT
blind-peer -s $STORE_PATH

# Start API
node dist/index.js
# or
bun tsx src/index.ts

Tests

# Test unpaid request (should return 402)
curl -i https://HOST/v1/status?key=00..

# Test paid request (Sepolia)
Use @x402/fetch or CDP Payments MCP with test USDC

Dokumentation

Dokument

Zweck

FRAMEWORK.md

Architekturmuster, Modulorganisation, Erweiterungsrichtlinien

SPEC.md

Systemspezifikation, öffentliche APIs, Datenmodelle

ROADMAP.md

Meilensteinfortschritt, zukünftige Pläne, abgeschlossene Punkte

PLAYBOOK.md

Betriebsabläufe, Bereitstellung, häufige Aufgaben

DATA.md

Datenbankschema, Konfiguration, Datenflussmuster

Projektstruktur

seeder-402/
├── AGENTS.md              # Agent entry point, build/test commands, conventions
├── README.md               # This file
├── docs/                   # Canonical documentation
│   ├── FRAMEWORK.md
│   ├── SPEC.md
│   ├── ROADMAP.md
│   ├── PLAYBOOK.md
│   ├── DATA.md
│   └── context/            # Background and architectural context
├── milestones/             # Active and archived milestones
│   └── archive/            # Archived milestone artifacts
└── .omp/                   # OhMyPi configuration
    └── config.yml          # Canonical project configuration

OhMyPi Workflow

omp
"Implement M1 only per ROADMAP.md and SPEC.md. Do not start M2."
After each M: run PLAYBOOK tests; commit; stop.

Hinweis: Dieses Repository befindet sich derzeit auf M1 (nur Money-Stub). Implementierungen über M1 hinaus müssen auf den Roadmap-Fortschritt und Umsatzsignale warten.

Mitwirken

Folgen Sie dem OhMyPi-Workflow:

  1. Setzen Sie in jedem PR genau einen Meilenstein um

  2. Halten Sie sich strikt an die Anforderungen in SPEC.md

  3. Führen Sie nach jeder Änderung die Tests aus PLAYBOOK.md aus

  4. Gehen Sie ohne Roadmap-Freigabe nicht über den zugewiesenen Meilenstein hinaus

  5. Behalten Sie die aktuelle Architektur bei (keine Microservices, keine Neuimplementierung der zentralen DHT-Logik)

Lizenz

Architektur und Dokumentation unter Apache 2.0. Die Implementierung (sobald erstellt) folgt der Projektlizenz.

Dieses Repository wird vom p2primitive-Kollektiv gepflegt und folgt einer strikten, meilensteinbasierten Entwicklungsdisziplin.

Projektkonfiguration

project_id: seeder-402
project_slug: seeder-402
mode: application  # framework: library, application: runnable service

mechanical_tooling:
  environment_manager: Node.js + npm (nodeenv)
  fast_linter_formatter: Prettier + ESLint (auto-fixable)
  pre_commit_framework: Husky
  type_checker: TypeScript

milestones:
  current: M1
  target: M7

requirements:
  node_version: "22.0.0"
  base_network: eip155:8453  # Mainnet (production)
  base_testnet: eip155:84532  # Base Sepolia (testing)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • x402-discovery

    rplryan
    A
    license
    Not graded
    quality
    D
    maintenance
    Discovers and queries x402-payable APIs at runtime — enables autonomous agents to find, evaluate, and pay for services via USDC micropayments on Base without API keys or subscriptions.
    MIT

  • axiom

    Itr3k
    A
    license
    Not graded
    quality
    F
    maintenance
    Enables autonomous agents to discover, quote, and purchase paid APIs on Base by describing capabilities in natural language, with automatic provider ranking, validation, and direct non-custodial x402 payments.
    MIT

  • x402-rpc-gateway

    ffboers
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables agents to sell or access Ethereum JSON-RPC requests over x402 with per-call USDC payments on Base, no accounts or API keys, including per-method pricing, policy enforcement, and privacy protections.
    1
    MIT