Skip to main content
Glama
deenesjakoruzh
bparlan

seeder-402

by bparlan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

seeder-402

x402 を介して Base 上の USDC 向けに、購入者が提供する Hypercore/Hyperdrive キーをレプリケートする HTTP/MCP サービス。

Wait, 校正が必要です。正しくは「レプリケート」「MCP」でなく「レプリケート」「MCP」です。もう一度、正確な翻訳を出力します。

seeder-402

x402 を介して Base 上の USDC 向けに、購入者が提供する Hypercor/Hyperdrive キーをレプリケートする HTTP/MCP サービス。

概概要

seeder-402 は、Base ネットワーク上で購入者が提供する Hypercore/Hyperdrive キーへのアクセスを販売する、常時稼働のレプリケーションサービスを実装します。このシステムは、パブリッシャーが最大 50MB のバンドルを 7 日間ホストできるようにすると同時に、24 時間のディスカバリーキーを維持し、リースベースのアクセス制御をサポートします。

Related MCP server: x402-discovery

アーキテクチャ

2 つのプロセス、1 つの VPS、1 つのデータベース:

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

  • api (Node 22+): x402 ミドルウェア、MCP 有料ツール、リース JWT/HMAC、クォータ、OpenAPI

  • blind-peer (Holepunch CLI): DHT、Coresore、レプリケーション (支払いロジックなし)

  • SQLite: リース、支払い、キャップ (v1 のみ)

システムステータス

現在のマイルストーン

M1 — マネースタブ (アクテイブ)

  • 実装済み: 未払いリクエスト → 402 Base Sepolia USDC

  • 実装済み: Faciitato の検証+決済 → 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

マイルストーンの進捗、将Plan、完項目

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 ごとに正確に 1 つのマイルストーンを実装する

  2. SPEC.md の要件に厳密に従う

  3. 各変更後に PLAYBOOK.md のテストを実行する

  4. ロードマップの承認なしに割り当てられたマイルストーンを超えて進めない

  5. 現在のアーキテクチャを維持する (マicroservices なし、コア DHT ロジックの再実装なし)

ラセンス

アーキテクチャとドキュメントは Apache 2.0 に基づきます。実装 (作成時) はプロジェクのラセンスに従います。

このリポジトリは p2rimitive コレクテイブによって保守されており、厳格なマイルストーンベースの開発規律に従っています。

プロジェク設設定

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