Path402 — Tokenised Web Content for AI Agents

path402

AI エージェントを自律的な経済主体に変えます。$402 ネットワークノードを運用しましょう。

このパッケージには、以下が含まれています。

• MCP サーバー — Claude、GPT など向けの AI エージェントツール
• path402d デーモン — トークンをインデックス化し、コンテンツを配信し、報酬を獲得します

---

クイックスタート

インストール

npm install -g path402

path402d デーモンの実行

path402d start

これにより、次の処理を行う $402 ネットワークノードが起動します。

• インデックス化 — BSV ブロックチェーンを読み込み、すべての $402 トークンを追跡します
• 検証 — コンテンツを配信する前にトークンの所有権を確認します
• 配信 — 検証済みのトークン保有者にコンテンツを届けます
• 獲得 — PoW20 を通じて $402 の報酬を受け取ります

path402d CLI コマンド

path402d start           # Start the daemon
path402d status          # Check if running
path402d stop            # Stop the daemon
path402d config          # Show configuration
path402d mine            # Start PoW20 mining (experimental)
path402d --help          # Full help

path402d を実行する理由

PoW は運用者を公の場に引き出します。大規模なノードは隠れられません。

PoW20 の目的は、単に作業に報酬を与えることではありません。運用者を可視化することです。

• 計算コスト → 資本投資 → 規模の拡大
• 規模の拡大 → 物理的な存在 → 規制当局からの可視化
• 大規模なノードは身元を明らかにする必要があります

説明責任のない地下の BitTorrent クライアントを使って、匿名でプロパガンダを流通させる者はいなくなります。

---

MCP サーバー（AI エージェント向け）

npx path402

Claude Desktop との統合

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "path402": {
      "command": "npx",
      "args": ["path402"],
      "env": {
        "PATH402_API_URL": "https://path402.com",
        "PATH402_DEFAULT_BUDGET": "10000"
      }
    }
  }
}

最初の会話

You: "Discover what's available at $example.com"

Claude: [Uses path402_discover to probe the $address]
        Found 3 nested tokens:
        - $example.com/$blog (500 sats, 0 supply)
        - $example.com/$api (1000 sats, 0 supply)
        - $example.com/$premium (2500 sats, 0 supply)

You: "Evaluate if $example.com/$blog is worth acquiring"

Claude: [Uses path402_evaluate and path402_economics]
        ROI Analysis:
        - Current price: 500 sats
        - Breakeven: 1 serve at current rates
        - Projected ROI: 340% over 30 days
        Recommendation: ACQUIRE (high confidence)

You: "Acquire 10 tokens"

Claude: [Uses path402_acquire]
        Acquired 10 $example.com/$blog tokens
        Total cost: 5,000 sats
        New balance: 10 tokens

---

$402 プロトコル

$402 とは？

$402 は URL パスをトークン化された市場に変えます。$ を先頭に付けたパスは、すべて経済的なオブジェクトになります。

$example.com              → Site-level token
$example.com/$api         → API access token
$example.com/$api/$premium → Premium tier token

各トークンには、以下が備わっています。

• 価格カーブ（デフォルトでは上昇型ボンディングカーブ）
• 供給量カウンター（取得のたびに増加します）
• 保有者レジストリ（誰が何を所有しているか）
• 収益分配（発行者とファシリテーターの分配比率）

上昇型ボンディングカーブ

価格は投機ではなく、残りのトレジャリーによって決まります。

price = base_price / √(treasury_remaining + 1)

トレジャリー	価格	販売済み割合
500M	10 sats	0%
100M	22 sats	80%
10M	71 sats	98%
1M	224 sats	99.8%
1K	7,072 sats	99.9998%

重要なポイント：早期購入者は常により良い価格で購入できます。これにより、発見や早期導入への自然なインセンティブが生まれます。

自己資金で運営するエージェント

エージェントは経済的に自立できます。

1. 現在の価格でトークンを取得します
2. 他のエージェントやユーザーにコンテンツを配信します
3. 配信から収益を得ます
4. 利益をさらに多くのトークンに再投資します

上昇型ボンディングカーブにより、早期取得者は配信を通じてプラスの ROI を達成できることが数学的に保証されます。

---

ツールの完全なリファレンス

発見と評価

ツール	説明
path402_discover	$address を調査し、価格、供給量、収益モデル、ネストされたパスを確認します
path402_batch_discover	1 回の呼び出しで複数の $address を発見します
path402_evaluate	購入前に ROI の実現可能性を評価します
path402_economics	損益分岐点、予測、シナリオを含む詳細な財務分析を行います
path402_price_schedule	供給量の各水準に応じた価格の変化を確認します

path402_discover

// Input
{
  address: "$example.com/$api"
}

// Output
{
  address: "$example.com/$api",
  exists: true,
  pricing: {
    model: "alice_bond",
    base_price_sats: 1000,
    current_price_sats: 45,
    treasury_remaining: 499500000
  },
  supply: {
    total: 500000,
    max: null
  },
  revenue_split: {
    issuer_bps: 8000,
    facilitator_bps: 2000
  },
  nested: [
    "$example.com/$api/$premium",
    "$example.com/$api/$enterprise"
  ],
  content_type: "application/json",
  description: "API access credits"
}

path402_evaluate

// Input
{
  address: "$example.com/$api",
  amount: 100,
  budget_sats: 10000
}

// Output
{
  recommendation: "ACQUIRE",
  confidence: 0.85,
  analysis: {
    total_cost_sats: 4500,
    within_budget: true,
    avg_price_per_token: 45,
    breakeven_serves: 5,
    projected_roi_30d: 0.34,
    risk_level: "low"
  },
  reasoning: "Early position in growing market. Favorable price curve."
}

取得とウォレット

ツール	説明
path402_acquire	トークンを購入し、アクセス制限付きコンテンツを受け取ります
path402_set_budget	エージェントの支出パラメーターを設定します
path402_wallet	残高、保有資産、純財務状況を確認します
path402_transfer	トークンを別のアドレスに送金します
path402_history	取引履歴を確認します

path402_acquire

// Input
{
  address: "$example.com/$api",
  amount: 100
}

// Output
{
  success: true,
  acquired: 100,
  total_cost_sats: 4500,
  avg_price: 45,
  new_balance: 100,
  content: {
    type: "api_key",
    value: "sk_live_xxx...",
    expires: null
  },
  txId: "bsv_abc123..."
}

path402_wallet

// Output
{
  balance_sats: 45000,
  holdings: [
    {
      address: "$example.com/$api",
      balance: 100,
      avg_cost: 45,
      current_value: 4800,
      unrealized_pnl: 300
    }
  ],
  total_value_sats: 49800,
  total_cost_sats: 49500,
  net_pnl_sats: 300,
  serving_revenue_sats: 1200
}

配信と収益

ツール	説明
path402_serve	コンテンツを配信して収益を得ます
path402_servable	エージェントが配信できるすべてのコンテンツを一覧表示します
path402_register	新しい $address を発行者として登録します

path402_serve

// Input
{
  address: "$example.com/$api",
  requester: "agent_xyz",
  amount: 1
}

// Output
{
  served: true,
  tokens_consumed: 1,
  revenue_earned_sats: 40,
  remaining_balance: 99,
  content_delivered: true
}

path402_servable

// Output
{
  servable: [
    {
      address: "$example.com/$api",
      balance: 99,
      serves_remaining: 99,
      revenue_per_serve: 40,
      total_potential_revenue: 3960
    }
  ],
  total_serves_available: 99,
  total_potential_revenue_sats: 3960
}

x402 ファシリテーターツール

ツール	説明
x402_verify	サポートされている任意のチェーンからの支払い証明を検証します
x402_settle	ファシリテーター経由でクロスチェーン決済を行います
x402_inscription	BSV インスクリプション証明を取得または作成します

x402_verify

// Input
{
  payment_proof: "0xabc123...",
  network: "base",
  expected_amount: 1000,
  expected_recipient: "0x..."
}

// Output
{
  valid: true,
  network: "base",
  amount_sats: 1000,
  recipient: "0x...",
  sender: "0x...",
  txId: "0x...",
  timestamp: "2026-02-02T10:00:00Z",
  facilitator: "path402.com"
}

---

設定

環境変数

変数	デフォルト	説明
PATH402_API_URL	https://path402.com	API エンドポイント
PATH402_DEFAULT_BUDGET	10000	デフォルトの予算（sats）
PATH402_WALLET_KEY	-	ウォレット署名キー（支払い用）
PATH402_AUTO_ACQUIRE	false	推奨時に自動取得します
PATH402_MAX_SINGLE_SPEND	5000	1回の取得あたりの最大 sats 数
PATH402_LOG_LEVEL	info	ログの詳細度

高度な設定

{
  "mcpServers": {
    "path402": {
      "command": "npx",
      "args": ["path402"],
      "env": {
        "PATH402_API_URL": "https://path402.com",
        "PATH402_DEFAULT_BUDGET": "50000",
        "PATH402_AUTO_ACQUIRE": "true",
        "PATH402_MAX_SINGLE_SPEND": "10000",
        "PATH402_WALLET_KEY": "your-wallet-key",
        "PATH402_LOG_LEVEL": "debug"
      }
    }
  }
}

---

ユースケース

1. コンテンツ探索エージェント

エージェントが $402 名前空間を探索し、価値のあるコンテンツを見つけます：

1. path402_batch_discover(["$news.com", "$research.org", "$data.io"])
2. path402_evaluate() on promising finds
3. path402_acquire() undervalued tokens
4. path402_serve() to users who request content

2. API ゲートウェイエージェント

エージェントがチームの API アクセスを管理します：

1. path402_acquire("$api.service.com", 1000)
2. path402_wallet() to track usage
3. path402_serve() when team members need API calls
4. path402_acquire() more when balance runs low

3. リサーチエージェント

エージェントが有料記事の情報を収集します：

1. path402_discover() research databases
2. path402_economics() to evaluate cost/benefit
3. path402_acquire() access to valuable sources
4. Compile research using acquired content

4. 収益を生み出すエージェント

自身の費用を賄うエージェント：

1. path402_acquire() tokens at low prices
2. path402_servable() to list inventory
3. path402_serve() to other agents
4. path402_wallet() to track profits
5. Reinvest profits into more tokens

---

サポート対象ネットワーク

ネットワーク	ステータス	資産
BSV	メイン	BSV、BSV-20 トークン
Base	サポート対象	USDC、ETH
Solana	サポート対象	USDC、SOL
Ethereum	サポート対象	USDC、ETH、USDT

BSV は決済レイヤーです。他のチェーンからの支払いは検証され、永続的な証明として BSV にインスクリプションされます。

---

API リファレンス

PATH402.com エンドポイント

$PATH402 トークン（PATH402 独自のトークン）

エンドポイント	メソッド	説明
/api/token/stats	GET	$PATH402 の統計情報と価格
/api/token/buy	POST	$PATH402 トークンを取得
/api/token/holding	GET	ユーザーの $PATH402 保有状況

マルチテナントマーケットプレイス（任意の $address）

エンドポイント	メソッド	説明
/api/tokens	GET	登録済みのすべてのトークンを一覧表示
/api/tokens	POST	新しい $address を登録
/api/tokens/[address]	GET	トークンの詳細と価格スケジュール
/api/tokens/[address]	POST	トークンを取得
/api/tokens/holdings	GET	ユーザーの保有状況（すべてのトークン）
/api/tokens/transfer	POST	トークンを送金
/api/tokens/history	GET	取引履歴

x402 ファシリテーター（支払い検証）

エンドポイント	メソッド	説明
/.well-known/x402.json	GET	ディスカバリードキュメント
/api/x402/verify	POST	支払いを検証
/api/x402/settle	POST	支払いを決済
/api/x402/inscription	GET/POST	インスクリプションを管理
/api/x402/stats	GET	ファシリテーターの統計情報

---

開発

ローカルでの実行

git clone https://github.com/b0ase/path402
cd path402
npm install
npm run dev

テスト

npm test
npm run test:integration

ビルド

npm run build

---

ロードマップ

v1.0.0（現在）

• ✅ 10 個のコアツール
• ✅ 右肩上がりのボンディングカーブ価格設定
• ✅ 予算管理
• ✅ 取得と提供のシミュレーション

v1.1.0（開発中）

• 🔲 path402.com 用のライブ HTTP クライアント
• 🔲 x402 ファシリテーターツール（検証、決済、インスクリプション）
• 🔲 実際の支払い連携

v1.2.0（予定）

• 🔲 送金と履歴のツール
• 🔲 マルチエージェント連携
• 🔲 永続ストレージ

v1.3.0（予定）

• 🔲 クリエイターツール（登録）
• 🔲 高度な分析
• 🔲 エージェントマーケットプレイスとの連携

---

貢献

貢献を歓迎します！Contributing Guide をお読みください。

# Fork the repo
git checkout -b feature/your-feature
# Make changes
npm test
git commit -m "Add your feature"
git push origin feature/your-feature
# Open a PR

---

ライセンス

Open BSV License version 4

---

リンク

• ウェブサイト：path402.com
• ホワイトペーパー：path402.com/whitepaper
• 取引所：path402.com/exchange
• ドキュメント：path402.com/docs
• GitHub：github.com/b0ase/path402

---

Support

• Issues: GitHub Issues
• Email: [email protected]
• Twitter: @b0ase