Skip to main content
Glama
deenesjakoruzh
bparlan

seeder-402

by bparlan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

seeder-402

x402를 통해 Base에서 USDC로 구매자가 공급한 Hypercore/Hyperdrive 키를 복제하기 위한 HTTP/MCP 서비스입니다.

개요

seeder-402는 Base 네트워크에서 구매자가 공급한 Hypercore/Hyperdrive 키에 대한 접근 권한을 판매하는 상시 가동 복제 서비스를 구현합니다. 이 시스템은 퍼블리셔가 최대 50MB 번들을 7일 동안 호스팅할 수 있게 하면서, 24시간 디스커버리 키를 유지하고 임대 기반 접근 제어를 지원합니다.

Related MCP server: x402-discovery

아키텍처

프로세스 2개, VPS 1개, 데이터베이스 1개:

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

  • api (Node 22+): x402 미들웨어, MCP 유료 도구, 임대 JWT/HMAC, 할당량, OpenAPI

  • blind-peer (Holepunch CLI): DHT, Corestore, 복제(결제 로직 없음)

  • SQLite: 임대, 결제, 상한(v1 전용)

시스템 상태

현재 마일스톤

M1 — 머니 스텁 (활성)

  • 구현됨: 미결제 요청 → 402 Base Sepolia USDC

  • 구현됨: 퍼실리테이터 검증+정산 → 200 { ok: true }

  • 상태: 결제 인프라 준비 완료, blind-peer 대기 중

로드맵

전체 마일스톤 추적은 docs/ROADMAP.md를 참조하세요. 현재 초점: 프로덕션 준비를 위한 M7 (mainnet).

빠른 시작

전제 조건

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

환경 설정

# 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

실행

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

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

테스트

# 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

문서

문서

용도

FRAMEWORK.md

아키텍처 패턴, 모듈 구성, 확장 지침

SPEC.md

시스템 사양, 공개 API, 데이터 모델

ROADMAP.md

마일스톤 진행 상황, 향후 계획, 완료 항목

PLAYBOOK.md

운영 절차, 배포, 일반 작업

DATA.md

데이터베이스 스키마, 구성, 데이터 흐름 패턴

프로젝트 구조

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 워크플로

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

참고: 이 저장소는 현재 M1(머니 스텁 전용) 상태입니다. M1 이후의 구현은 로드맵 진행 및 수익 신호가 있을 때까지 기다려야 합니다.

기여

OhMyPi 워크플로를 따르세요:

  1. PR당 정확히 하나의 마일스톤을 구현합니다.

  2. SPEC.md 요구 사항을 엄격히 준수합니다.

  3. 각 변경 후 PLAYBOOK.md 테스트를 실행합니다.

  4. 로드맵 승인 없이 지정된 마일스톤을 넘어 진행하지 않습니다.

  5. 현재 아키텍처를 유지합니다(마이크로서비스 없음, 핵심 DHT 로직 재구현 없음).

라이선스

아키텍처와 문서는 Apache 2.0에 따릅니다. 구현(생성 시)은 프로젝트 라이선스를 따릅니다.

이 저장소는 p2primitive collective가 유지 관리하며 엄격한 마일스톤 기반 개발 규율을 따릅니다.

프로젝트 구성

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