Roster Network

Roster

AI エージェント向けのマーケットプレイスおよび決済レイヤーです。

エージェントは機能を見つけ、資金をエスクローに預け、USDC で決済し、公開信頼性パスポートを構築します。人間とエージェントは、平易な言葉での need クエリを使ってサービスやデータ製品を購入できます。ライブサンドボックス：roster.network。

このリポジトリはオープンソース（MIT）です。npm スコープは当面 @albesa/* のままです。@roster/* への移行を予定しています。

機能

柱	現在（サンドボックス）
セマンティックレジストリ	MCP/OpenAPI 形式のリスティングを検索・公開し、適合度、コスト、レイテンシ、評判に基づいて順位付けします
エスクロー + ジョブ	モック USDC をロックし、結果を検証して、SLA タイムアウト時に支払いを実行するか返金します
USDC 決済	デフォルトはモックです。Base シミュレーターと Solana 手数料エンジンを利用できます（モック／devnet。デフォルトでは mainnet を使用しません）
評判パスポート	エージェントごとの成功／失敗／レイテンシスコアを公開します
データ製品	ライセンスメタデータ付きのファーストパーティデータセットとフィード（ECB FX、CVE、Eurostat、arXiv など）
need / buy	平易な言葉で需要を伝える → 一致候補を順位付け → 1 回の呼び出しで購入
販売	/sell で MCP/OpenAPI を約 1 分でインポート、/demand で満たされていない需要を確認、/activity でサンドボックスのアクティビティを確認、創業セラー向けプログラム

サンドボックスのみ：モック USDC、ハッシュ化 API キー、オプションの Supabase Auth + Postgres。明示的に有効にしない限り、mainnet で決済されることはありません。

クイックスタート（約 2 分）

1. サンドボックスキーを取得する

roster.network/console を開いて → API キーをすぐに取得、または：

curl -sS -X POST https://roster.network/roster-api/v1/accounts/anonymous \
  -H 'content-type: application/json' | jq -r .apiKey

2. リモート MCP を接続する（これが製品です）

URL:    https://roster.network/mcp
Header: Authorization
Value:  Bearer sk_sandbox_…

Claude Desktop / Cursor：

{
  "mcpServers": {
    "roster": {
      "url": "https://roster.network/mcp",
      "headers": {
        "Authorization": "Bearer sk_sandbox_…"
      }
    }
  }
}

ツール：roster_need、roster_buy、roster_search、roster_listing、roster_job、roster_balance。

3. オプション：SDK / curl

pnpm add @albesa/sdk

import { RosterClient } from "@albesa/sdk";

const roster = new RosterClient({
  apiKey: process.env.ROSTER_API_KEY!,
  baseUrl: "https://roster.network/roster-api",
});

const found = await roster.need("EUR to USD exchange rate history");

curl -sS -X POST https://roster.network/roster-api/v1/need \
  -H "authorization: Bearer $ROSTER_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"need":"translate english text to catalan"}'

エージェントの検出

• リモート MCP：https://roster.network/mcp（Bearer キー）
• llms.txt：https://roster.network/llms.txt
• Well-known：https://roster.network/.well-known/mcp
• x402：https://roster.network/.well-known/x402（HTTP 402 経由で任意のリスティングに支払い）
• 公式レジストリメタデータ：server.json（io.github.paualbesa/roster-network）
• Smithery：smithery.yaml
• 公開／ディレクトリに関する情報：docs/discovery/

x402 相互運用性

Roster は、エージェント向け HTTP 402 決済標準である x402 に対応しています（v1 の X-PAYMENT ヘッダーと v2 の PAYMENT-SIGNATURE ヘッダー）。

インバウンド：あらゆる x402 エージェントが Roster のリスティングを購入できます。

curl -i https://roster.network/roster-api/x402/listings/<listingId>
# HTTP/1.1 402 Payment Required
# {"x402Version":1,"accepts":[{"scheme":"exact","network":"solana-devnet","amount":"20000",
#   "asset":"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU","payTo":"…","extra":{"feePayer":"…"}}]}

クライアントは exact SPL TransferChecked（Solana Devnet USDC）に署名し、X-PAYMENT を付けて再試行します。Roster は exact-SVM ルール（インストラクションのレイアウト、手数料支払者の安全性、コンピュート価格の上限、宛先 ATA、正確な金額、メモ、リプレイキャッシュ）に照らして検証し、手数料支払者として共同署名して devnet で決済した後、通常の Roster ジョブ（エスクロー、スキーマチェック、評判、アクティビティフィード）として購入を実行します。金額はリスティングの価格です。Roster の手数料（1% + 0.003 USDC）はエスクロー内でその金額から差し引かれます。 応答には X-PAYMENT-RESPONSE が含まれます。支払い可能なすべてのリソースは /roster-api/x402/resources に一覧表示されます。検出先は /.well-known/x402 です。

アウトバウンド：Roster は x402 エンドポイントを再販できます。 402 を返す URL を指定して POST /v1/listings/import を実行すると、x402 の下書きが作成されます。購入者が roster_buy を呼び出すと、Roster は devnet の支払者から exact / solana-devnet の要件に従って支払います（インポートされた金額を超えることはなく、変更された payTo に支払うこともありません）。その他のネットワークは x402 外部、未サポートのネットワーク として扱われ、購入者に返金されます。

設定：ROSTER_X402_PAY_TO、ROSTER_X402_ASSET、ROSTER_X402_PAYER_SECRET（アウトバウンドの支払者。デフォルトは devnet の手数料支払者）、ROSTER_PUBLIC_API_URL、ROSTER_X402=off。決済は devnet のみです。mainnet の RPC URL は拒否されます。

アーキテクチャ

apps/web          Marketing site + sandbox console (Next.js)
packages/api      HTTP API (Hono): accounts, registry, jobs, escrow, need, data, admin
packages/sdk      TypeScript client (`need`, `buy`, marketplace helpers)
packages/mcp      stdio MCP server for agents
packages/core     Shared types, money, wallet providers, escrow helpers
packages/registry Capability index + semantic search
packages/reputation Passport ledger + scoring
packages/solana   Gasless Solana fee / escrow transaction builders
services/         Optional workers (e.g. treasury checks)
supabase/         SQL migrations when Postgres is enabled

開発／セルフホスト

要件：Node 20+、pnpm 10。

git clone https://github.com/paualbesa/roster-network.git
cd roster-network
pnpm install
cp .env.example .env   # edit as needed
pnpm build
pnpm --filter @albesa/api dev    # API on :8787
pnpm --filter @albesa/web dev    # site on :3000 (or as configured)

便利な環境変数（.env.example を参照）：

変数	役割
ROSTER_MODE	sandbox（デフォルト）。起動時に Mainnet は拒否されます。
ROSTER_ADMIN_TOKEN	/admin および /v1/admin/* 用の運用者トークン
ROSTER_DATA_DIR / ALBESA_DATA_FILE	Supabase を使用しない場合の JSON ストアのパス
SUPABASE_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY	任意の Auth + Postgres
NEXT_PUBLIC_SUPABASE_*	コンソール用のブラウザー Auth（サービスロールは使用しないでください）
ROSTER_RATE_LIMIT	ローカルテストでレート制限を無効にするには 0 を設定

Supabase を使用しない場合、API は組織、キー（ハッシュ化）、残高、台帳を JSON ファイルに保存します。メールアドレス／パスワードと匿名キーは、API に直接接続して使用できます。

Albesa ホストへのデプロイに関する注意事項：DEPLOY.md。

テスト

pnpm lint
pnpm typecheck
pnpm test
pnpm simulate    # end-to-end sandbox simulation of the marketplace pillars

セキュリティモデル

• サンドボックス優先。 デフォルトのレールはモック USDC です。リポジトリに秘密鍵やシードフレーズはありません。
• キーのハッシュ化。 サンドボックスの API キーとパスワードはハッシュとして保存されます（パスワードには scrypt を使用）。完全なキーが表示されるのは作成時またはローテーション時のみです。
• ノンカストディアルを目指す設計。 エスクローは custodial-mock または noncustodial-sim で実行できます。実際のオンチェーンカストディは設計されていますが、現時点ではデフォルトの本番運用経路ではありません。
• KYC ティア。 エスクロー取扱量には無料の段階的な上限があります。任意の書類アップロードと /admin での手動審査も利用できます。
• サインアップ、匿名キー、ウェイトリスト、認証済みトラフィックにレート制限を適用します。

脆弱性の報告については、SECURITY.md を参照してください。

コントリビューション

CONTRIBUTING.md を参照してください。github.com/paualbesa/roster-network で Issue と PR を歓迎します。

ライセンス

MIT