Skip to main content
Glama
deenesjakoruzh
bparlan

seeder-402

by bparlan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

seeder-402

Un servicio HTTP/MCP para replicar claves Hypercore/Hyperdrive suministradas por el comprador para USDC en Base a través de x402.

Resumen

seeder-402 implementa un servicio de replicación siempre activo que vende acceso a claves Hypercore/Hyperdrive suministradas por el comprador en la red Base. El sistema permite a los publicadores alojar paquetes de hasta 50 MB durante 7 días, manteniendo claves de descubrimiento de 24 horas y ofreciendo control de acceso basado en arrendamientos.

Related MCP server: x402-discovery

Arquitectura

Dos procesos, un VPS, una base de datos:

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

  • api (Node 22+): middleware x402, herramientas de pago MCP, JWT/HMAC de arrendamiento, cuotas, OpenAPI

  • blind-peer (CLI de Holepunch): DHT, Corestore, replicación (sin lógica de pagos)

  • SQLite: arrendamientos, pagos, límites (solo v1)

Estado del sistema

Hito actual

M1 — stub de dinero (activo)

  • Implementado: solicitudes no pagadas → 402 Base Sepolia USDC

  • Implementado: verificación + liquidación del facilitador → 200 { ok: true }

  • Estado: infraestructura monetaria lista, blind-peer pendiente

Hoja de ruta

Consulta docs/ROADMAP.md para el seguimiento completo de hitos. El enfoque actual: M7 (mainnet) para preparación de producción.

Inicio rápido

Requisitos previos

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

Configuración del entorno

# 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

Ejecutar

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

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

Pruebas

# 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

Documentación

Documento

Propósito

FRAMEWORK.md

Patrones de arquitectura, organización de módulos, pautas de extensión

SPEC.md

Especificación del sistema, API públicas, modelos de datos

ROADMAP.md

Progreso de hitos, planes futuros, elementos completados

PLAYBOOK.md

Procedimientos operativos, despliegue, tareas comunes

DATA.md

Esquema de base de datos, configuración, patrones de flujo de datos

Estructura del proyecto

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

Flujo de trabajo OhMyPi

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

Nota: Este repositorio se encuentra actualmente en M1 (solo stub de dinero). La implementación más allá de M1 debe esperar el avance de la hoja de ruta y las señales de ingresos.

Contribución

Sigue el flujo de trabajo de OhMyPi:

  1. Implementa exactamente un hito por PR

  2. Adhiérete estrictamente a los requisitos de SPEC.md

  3. Ejecuta las pruebas de PLAYBOOK.md después de cada cambio

  4. No avances más allá del hito asignado sin aprobación de la hoja de ruta

  5. Mantén la arquitectura actual (sin microservicios, sin reimplementación de la lógica central de DHT)

Licencia

Arquitectura y documentación bajo Apache 2.0. La implementación (cuando se cree) seguirá la licencia del proyecto.

Este repositorio es mantenido por el colectivo p2primitive y sigue una estricta disciplina de desarrollo basada en hitos.

Configuración del proyecto

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