Skip to main content
Glama
deenesjakoruzh
bparlan

seeder-402

by bparlan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

seeder-402

HTTP/MCP-сервис для репликации ключей Hypercore/Hyperdrive, предоставленных покупателем, для USDC на Base через x402.

Обзор

seeder-402 реализует постоянно работающий сервис репликации, который продаёт доступ к ключам Hypercore/Hyperdrive, предоставленным покупателем, в сети Base. Система позволяет издателям размещать пакеты объёмом до 50 МБ на 7 дней, сохраняя 24-часовые ключи обнаружения и поддерживая контроль доступа на основе аренды.

Related MCP server: x402-discovery

Архитектура

Два процесса, один VPS, одна база данных:

[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

  • Реализовано: verify+settle фасилитатора → 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 и следует строгой дисциплине поэтапной разработки.

Конфигурация проекта

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