DDG Agent Services

mcp-name: com.daedalusdevelopmentgroup/ddg-agent-services-mcp

DDG エージェント向け有料サービスのローンチパック

このディレクトリには、Hermes/DDG を他の AI エージェント向けの有料サービスとして提供するための、機械可読なローンチ成果物とローカルの足場が含まれています。

現在のローンチ対象

1. 1 セントのトランザクションスモークテスト（/v1/tx-smoke-test）— DDG の有料 HTTP トランザクションを完了できることを他の AI エージェントが確認するための、レシートのみを返す $0.01 の有料リクエストです。
2. ウェブサイト監査（/v1/site-audit）— 読み取り専用です。ローンチ時の決済テスト価格は $0.75 です。
3. モデルルーター／基本会話（/v1/model/chat-completions、/v1/model/agent-run）— 明示的なモデルエイリアスを使用する、DDG 運用のモデルルーティングへの有料アクセスです。基本的なチャット、分析、コード／ヘルプのプロンプト、および範囲を限定したエージェントタスクに対応しています。
4. オペレーター確認付き OAuth／モデル成果物の実行（service_id=provider_model_artifact_order、/v1/order-intake 経由）— 利用規約で許可される場合に限り、DDG 運用のアカウント／プロバイダー経由でモデル作業を行います。生のトークン、アカウント、シートの転売は行いません。
5. リードパック（/v1/lead-pack）— 有料のローカルビジネスインテリジェンスです。ローンチ価格は $5 です。
6. ブラウザー証跡（/v1/browser-proof）— 有料のスクリーンショット／QA 証跡です。ローンチ価格は $2 です。
7. アウトリーチ概要（/v1/outreach-brief）— 有料の下書きのみを提供します。人間の承認なしに送信することはありません。ローンチ価格は $1.50 です。
8. Ethereum プライベート RPC クエリ（/v1/ethereum/rpc）— 同期ゲート、公平利用のリースタイマー、エージェントごとのリクエスト上限、最大バッチサイズ、上流の最大同時実行数上限を備えた、メソッド許可リスト方式の読み取り専用 Reth プロキシを実装済みです。実行同期とヘルスチェックが完了するまで、一般向けセルフサービスは利用できません。
9. ローカルモデル無料枠プール（/v1/micro-model-swarm-preview、/v1/model/agent-run、/v1/ollama-models）— 設定済みの正常な各ローカルランタイムバックエンドで、同時生成枠を 1 つ提供する、稼働中の無料／ベストエフォート型 Ollama ローカルルートです。設定済みの 8GB-VRAM バックエンドでは、既定で最大 2 枠に制限されます。既定値は、エージェントごとのリース期間が 24 時間、リースごとのリクエスト数が 100 件、swarm 生成タイムアウトが 60 秒、ローカルの agent-run タイムアウトが 120 秒です。名称付きの有料リース経路は引き続き計画中です。
10. エージェント成果物／レシートコンソール（/v1/orders/{order_id}、/v1/orders/{order_id}/artifact）— /v1/order-intake から返される、エージェントごとのステータス／成果物 URL を提供します。レシート／証跡のハッシュを秘匿化して公開し、納品予定物を表示しますが、生の決済情報は公開しません。
11. チェックアウト適合性プロファイル／プローブ（/.well-known/ddg-agent-checkout-conformance.json、scripts/agent_checkout_conformance_probe.py）— 購入側エージェントやパートナーサービスが、ID ゲート、402 チャレンジ、フェイルクローズ方式の偽の決済処理、冪等性、受け付け済み注文へのリンク、成果物のアクセス制御を検証できます。
12. MPP 有効化ガイド（/.well-known/ddg-mpp-activation-guide.md）— オペレーター／購入者向けに、アカウント作成、Stripe/Tempo/mppx のテスト設定、必要な DDG シークレット、稼働ゲート、公開文面の切り替えチェックリスト、ロールバック手順を説明します。

1 セントのトランザクションスモークテスト

POST /v1/tx-smoke-test は、少額の有料リクエスト用エンドポイントです。他の AI エージェントの CI／スモークテスト向けに設計されています。通常の 402 チャレンジを受け取り、x402 または直接暗号資産決済で 1 セントを支払うと、受領レシートのみを含む JSON レスポンスが返されます。MPP が表示されるのは、ライブのプロバイダー／通貨設定、再試行、受領の各条件を満たした後に限られます。決済の検証／精算そのものを除き、取り消せない外部操作は実行しません。

Ethereum/Reth プライバシーノードの方針

/v1/ethereum/rpc ルートは、アカウント不要の購入者側 Ethereum 読み取り用です。DDG が Reth ノード／プロキシを運用するため、購入者のエージェントは Infura／Alchemy／ベンダーのアカウントを必要とせず、エッジでは引き続き AI エージェントの識別が必要です。プロキシは読み取り専用で、メソッドは許可リストで制限されています。admin、miner、personal、制限のない debug／trace、および eth_sendRawTransaction はデフォルトでブロックされます。無料ベータのラッパーには、次の機能が含まれるようになりました。

• 同期準備ゲート：DDG_ETH_RPC_REQUIRE_SYNCED=1 の場合、eth_syncing=false かつ最新ブロックがゼロではなく最新になるまで、503 reth_rpc_syncing を返します。
• 公平利用タイマー：デフォルトでは DDG_ETH_RPC_FREE_MAX_CONCURRENT_USERS=4、DDG_ETH_RPC_FREE_LEASE_SECONDS=600、DDG_ETH_RPC_FREE_MAX_REQUESTS_PER_LEASE=30 です。
• ノード過負荷ガード：DDG_ETH_RPC_MAX_CONCURRENT=2、DDG_ETH_RPC_MAX_BATCH=10、タイムアウトとレスポンスバイト数に上限を設定します。

一般公開のセルフサービスは、Reth の実行同期、コンセンサスの非オプティミスティック状態、および決済エッジ経由での DDG_RETH_RPC_URL の健全性確認が完了するまで待つ必要があります。

プロトコルの方針

• x402：ステーブルコインネイティブなエージェントと Bazaar 形式の検出に対応した、稼働中の HTTP 402 決済フローです。正規の PAYMENT-REQUIRED の accepts[] では、Base、Polygon、Arbitrum One、World Chain、および Solana mainnet の USDC を提示します。x402scan／CDP との互換性のため、Base mainnet の USDC を先頭にしています。
• 直接暗号資産決済：検証機能が対応する資産は自動検証し、それ以外は手動／運用者確認に切り替える、稼働中の受取アドレス決済経路です。公開対象のファミリーは EVM／ステーブルコイン、BTC、BCH、LTC、DOGE、SOL、TRX、XRP、XLM、ALGO、DOT、ZEC、XMR です。DDG が管理するアドレスと、検証／手動確認のポリシーが整うまで、ADA／Cardano は意図的に提示していません。
• MPP：コードと署名者キーの準備はできていますが、実際の MPP／Tempo 通貨または Stripe SPT プロファイル／環境変数が設定され、ready:true が成功し、少額決済が決済完了となり、冪等性のある再実行が成功し、偽トークンが確実に拒否され、漏えいスキャンがクリーンな状態を維持するまでは、一般公開で稼働中とは謳いません。

AI 専用の販売方針

• 一般公開のセルフサービスおよび有料ルートは、AI エージェント専用です。
• 安定したエージェント識別ヘッダー（X-Agent-Id / X-DDG-Agent-Id / X-DDG-User）がない人間のトラフィックは、403 agent_only で拒否されます。
• 生のモデルサブスクリプション／アカウントではなく、DDG がパッケージ化した推論と、制限付きの成果物を販売します。

モデルルーターのモデルエイリアス

提示するエイリアス：auto、mini、ministal、x、y、z、 agent-small、agent-standard、agent-pro、agent-max、 budget、starter、および DDG のコアエイリアス glm-4.5-air、glm-4.5、glm-4.6、glm-4.7、glm-5、 glm-5-turbo、glm-5.1、glm-5.2、gpt-5.3-codex-spark、gpt-5.3-codex、 gpt-5.4、gpt-5.5、claude-haiku-4.5、claude-sonnet-4.6、 claude-opus-4.8。

高度な機能を使わない呼び出し元向けに、x_router.agent_profile のヒントにも対応しています： low／budget／standard／pro／premium。

調査に基づく訂正：

• Z.AI のドキュメントには GLM-4.5-Air が記載されていますが、公式の GLM-4.6-Air のページや料金表は見つかりませんでした。
• Anthropic のドキュメントには Claude Opus 4.8、Sonnet 4.6、Haiku 4.5 が記載されていますが、現行のドキュメントでは公式の Sonnet 4.7 は見つかりませんでした。
• Claude Pro／Max のサブスクリプションアクセスを購入者に提供してはいけません。Claude のエイリアスは、API を利用する DDG アプリケーションの出力専用です。
• GPT-5.3 Codex Spark／Codex の名称と一般向け API の提供状況は、広く販売する前に確認する必要があります。OpenAI Codex のドキュメントでは、提供開始時点で Spark はリサーチプレビュー／Pro 限定と説明されています。

モデルルーターのコンプライアンス方針

生の API キー、認証トークン、アカウントシートを販売してはいけません。OpenAI／GLM／Claude アカウントの無制限な再販として宣伝してはいけません。より安全なパッケージ方法は次のとおりです。

エージェントは、予算、領収記録、不正利用対策、モデルティアのルーティングを備えた、DDG 運用の推論／エージェントタスク出力を購入します。

ローカル推論／無料枠のステータス — 2026-06-14

設定済みのローカルランタイムバックエンドが正常に動作している場合、現在の実装では無料のローカルモデル枠を最大2つ公開できます。

• 本番環境の目標：ヘルスチェック結果に基づく8GB VRAMのローカルランタイム枠を2つ用意し、決済エッジ経由でのみ公開します。
• OLLAMA_API_URLSには、デプロイ環境の環境変数に非公開の生成エンドポイントを列挙してください。バックエンドの生URLは公開しないでください。
• /v1/ollama-modelsは、生のLAN URLを公開せずにlocal_free_seats.configured_free_seat_cap、healthy_local_seat_count、リース上限を返します。
• デフォルト値は意図的に使いやすく、かつ上限が設定されています。エージェントごとのリースは24時間（86400秒）、リースごとのリクエスト数は100件、スウォーム生成のタイムアウトは60秒、ローカルの/v1/model/agent-runのタイムアウトは120秒です。同じ安定したエージェントIDであれば、24時間のリース期限後に無料枠を再利用できます。
• /v1/micro-model-swarm-previewおよび/v1/model/agent-run配下のローカルOllamaルートでは、バックエンドごとにブロッキングしないシートロックを使用するため、1つのバックエンドが使用中でも、設定済みの別の正常なバックエンドはブロックされません。
• オンラインのバックエンドが1つだけの場合、カタログとリースプールは1枠に縮小します。正常なバックエンドがない場合、生成は制御された利用不可／ビジー応答を返します。
• ローカルランタイムの生エンドポイントは、決済エッジの背後で非公開のままにします。公開リクエストによって、モデルのプルや任意のモデルダウンロードが開始されることはありません。

ホスト／IP／GPUの運用インベントリは、エージェントが参照する起動ドキュメントではなく、非公開の運用メモにのみ記載してください。

ファイル

• pricing.json — 価格カタログの正規ドラフトです。
• agent-catalog.json — .well-known AI エージェントカタログです。検出 URL、稼働中のルート、手動レビューの提供内容、必須ヘッダー、安全性に関する方針をまとめています。
• quickstart.md — 403／402／冪等性／決済の動作を含む、エージェントクライアント向けの簡潔なオンボーディング／チェックリストです。注文受付で推奨する最初のパッケージと例も記載しています。
• sales-launch-pack-2026-06-08.md — 最初に販売するサービス、コピー、例、現在の注意事項を含む、顧客向けのベータ版ローンチパッケージシートです。
• reth-ethereum-agent-rpc-analysis-2026-06-08.md — エージェント向けブロックチェーンインテリジェンス／RPC 製品として計画中の Reth／Ethereum ノードアクセスに関する意思決定メモです。
• openapi.agent-services.json — MPP スタイルの決済メタデータを含む OpenAPI 3.1 の検出定義です。
• agent-checkout-conformance-profile.json — /.well-known/ddg-agent-checkout-conformance.json で公開される、403／402／注文コンソール／冪等性の機械可読な適合性プロファイルです。
• mpp-tempo-stripe-account-activation-guide-2026-06.md — /.well-known/ddg-mpp-activation-guide.md で公開される、MPP／Tempo／Stripe のアカウント、環境変数、スモークテスト、稼働開始、ロールバックの手順ガイドです。
• llms.txt — エージェントが読み取れるサービスカタログです。
• edge/payment_edge_scaffold.py — プラグイン可能な検証アダプターを備えた決済エッジです。本番環境ではプロバイダー連携の検証を使用します。モックトークンは開発専用であり、systemd の本番環境設定では無効のままにする必要があります。
• scripts/operator_queue_digest.py — キューに入った有料エージェント注文向けの安全なオペレーターダイジェスト生成ツールです。Telegram 用の Markdown を書き出しますが、自動で送信や履行は行いません。
• scripts/agent_checkout_conformance_probe.py — デフォルトでは支出を伴わないチェックアウト検証ツールです。開発用モックまたは実際の決済認証情報を使うと、受け付けられた注文リンク、成果物／ステータスへのアクセス制御、冪等性の動作を検証します。
• edge/agent_runners.py — 環境変数で有効化された Kimi／Claude の運用成果物ルート向けの、サンドボックスを考慮したサブプロセスラッパーです。
• mcp/README.md と mcp/ddg-agent-swarm-mcp-design.md — サービス検出、見積もり、有料モデル実行、注文受付、セキュリティサービスカタログへのアクセス、1 セントのトランザクションスモークテストを必要とする AI エージェントの群れ向けの、MCP クイックスタート／設計資料です。
• edge/mpp_verifier_sidecar.mjs — mppx/server を使用する販売側の MPP 検証サイドカーです。実際の決済には、受取人、通貨、Tempo サーバーの署名アカウントが必要です。
• edge/x402_verifier_sidecar.py — Python エッジの汎用決済ペイロードを、ファシリテーターへの paymentPayload／paymentRequirements 呼び出しに変換する x402 検証／決済アダプターです。
• edge/direct_crypto_verifier_sidecar.py — BTC／LTC／DOGE／BCH／ZEC、EVM ネイティブ送金、Ethereum／Base／Polygon 上の USDC に対応する、パブリックチェーン直接暗号資産検証サイドカーです。未対応のチェーンは手動確認に切り替え、処理を拒否します。
• payment-provider-and-waf-runbook-2026-06-05.md — MPP／x402 検証 URL、直接暗号資産／手動のフォールバック、Cloudflare 1010 の無料代替手段に関する設定手順です。
• deploy/two-host-local-ai-production-runbook.md — 2 つの無料ローカル AI シート、リースポリシー、ランタイムのステータス、同期後の検証に関する非公開デプロイチェックリストです。
• direct_crypto_addresses.public.json／direct_crypto_addresses.env — EVM／ステーブルコイン、BTC、BCH、LTC、DOGE、SOL、TRX、XRP、XLM、ALGO、DOT、ZEC、XMR 向けの、公開用直接暗号資産受取マニフェストです。
• audit/preservation_snapshot.md — ローンチに向けた編集前に取得したブランチ／ステータスのスナップショットです。

ローカルのスキャフォールドのスモークテスト

python3 sales_artifacts/agent_payments/edge/payment_edge_scaffold.py --port <local-edge-port>

curl -i http://LOCAL_EDGE/llms.txt
curl -i -X POST http://LOCAL_EDGE/v1/model/chat-completions \
  -H 'content-type: application/json' \
  -H 'X-Agent-Id: demo-agent-id' \
  -d '{"model":"glm-5-turbo","messages":[{"role":"user","content":"hello"}]}'

curl -i -X POST http://LOCAL_EDGE/v1/model/chat-completions \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: demo-1' \
  -H 'Authorization: Payment mock-valid' \
  -H 'X-Agent-Id: demo-agent-id' \
  -d '{"model":"glm-4.5-air","messages":[{"role":"user","content":"hello"}],"x_router":{"policy":"cheap","max_charge_usd":0.25}}'

支払い検証モード

スキャフォールドでは、自動支払い検証と手動の暗号資産による代替手段がサポートされるようになりました。

• mock（開発用）：モックトークンモードが有効な場合に限り、モックヘッダーを受け付けます。
• provider（本番対応）：支払い請求の検証を外部の検証エンドポイントに委任します。

次のように設定します：DDG_PAYMENT_VERIFICATION_MODE={mock|provider|disabled}。 未設定の場合、PAYMENT_EDGE_ALLOW_MOCK_TOKENS=1 ならモードは mock、それ以外の場合は provider が既定値になります。

プロバイダー検証エンドポイント：

• DDG_PAYMENT_MPP_VERIFY_URL（または MPP_VERIFY_URL）
• DDG_PAYMENT_X402_VERIFY_URL（または X402_VERIFY_URL）
• DDG_PAYMENT_X402_SETTLE_URL（任意。検証後に x402 の決済確定を呼び出します）
• DDG_PAYMENT_DIRECT_CRYPTO_VERIFY_URL（任意。暗号資産による直接支払いの自動証明検証エンドポイント。未設定の場合、暗号資産による直接支払いは手動確認のベータ版のままです）

サイドカーのスモークテスト用スタック：

# direct crypto
python sales_artifacts/agent_payments/edge/direct_crypto_verifier_sidecar.py --host <local-host> --port <direct-crypto-port>

# x402 public/testnet adapter
set -a; . sales_artifacts/agent_payments/direct_crypto_addresses.env; set +a
X402_PAY_TO="$DDG_CRYPTO_EVM_ADDRESS" \
X402_NETWORK=base-sepolia \
X402_ASSET=USDC \
python sales_artifacts/agent_payments/edge/x402_verifier_sidecar.py --host <local-host> --port <x402-port>

# MPP; real settlement additionally needs MPP_TEMPO_PRIVATE_KEY and MPP_SECRET_KEY
cd sales_artifacts/agent_payments
MPP_RECIPIENT_ADDRESS="$DDG_CRYPTO_EVM_ADDRESS" \
MPP_CURRENCY=0x20c0000000000000000000000000000000000000 \
MPP_CHARGE_AMOUNT=0.01 \
node edge/mpp_verifier_sidecar.mjs

エッジを3つすべてに対して実行します。

DDG_PAYMENT_VERIFICATION_MODE=provider \
DDG_PAYMENT_DIRECT_CRYPTO_VERIFY_URL=http://LOCAL_DIRECT_CRYPTO/verify \
DDG_PAYMENT_X402_VERIFY_URL=http://LOCAL_X402/verify \
DDG_PAYMENT_X402_SETTLE_URL=http://LOCAL_X402/settle \
DDG_PAYMENT_MPP_VERIFY_URL=http://LOCAL_MPP/verify \
DDG_REQUIRE_AGENT_ID=1 \
python sales_artifacts/agent_payments/edge/payment_edge_scaffold.py --port <local-edge-port>

制御された失敗の動作を確認済みです：ヘルスチェックは200を返し、エージェントIDがない場合は 403 agent_only を返します。未払い、偽のMPP、偽のx402、偽の暗号資産による直接支払いのリクエストは、503 payment_verification_unavailable ではなく、アプリケーション層で 402 payment_required を返します。

任意の認証ヘッダー：

• DDG_PAYMENT_MPP_VERIFY_TOKEN / DDG_PAYMENT_X402_VERIFY_TOKEN

検証エンドポイントが返すJSONに期待されるフィールド：

• valid: true（または ok: true）
• 任意の receipt、payer、amount_usd

本番モードが有効でも検証URLが設定されていない場合、有料ルートは 503 payment_verification_unavailable を返します。

暗号資産による直接支払いの自動証明と手動の代替手段

Coinbase/CDP x402 は当面見送ります。初期ベータ版では、設定済みの直接支払いアドレスを402レスポンス本文で公開できます。

DDG_CRYPTO_EVM_ADDRESS=0x...
DDG_CRYPTO_BTC_ADDRESS=bc1...
DDG_CRYPTO_BCH_ADDRESS=bitcoincash:...
DDG_CRYPTO_LTC_ADDRESS=ltc1...
DDG_CRYPTO_DOGE_ADDRESS=D...
DDG_CRYPTO_SOL_ADDRESS=...
DDG_CRYPTO_TRX_ADDRESS=T...
DDG_CRYPTO_XRP_ADDRESS=r...
DDG_CRYPTO_XLM_ADDRESS=G...
DDG_CRYPTO_ALGO_ADDRESS=...
DDG_CRYPTO_DOT_ADDRESS=1...
DDG_CRYPTO_XMR_ADDRESS=...
DDG_CRYPTO_ZEC_ADDRESS=...

EVMでは、対応するEVMネットワーク全体で、ETH互換アセットと主要なEVMステーブルコイン（USDC、USDT、DAI、PYUSD、FRAX、FDUSD、GUSD、LUSD、USDP、TUSD、EURC）を扱います。SOL/TRX/XLM/ALGOの項目は、それらのアドレスが設定されている場合に、各チェーン固有のステーブルコインのバリエーションを扱います。

DDG_PAYMENT_DIRECT_CRYPTO_VERIFY_URL が設定されている場合、エージェントは自動証明ヘッダーを付けて有料リクエストを再試行できます。

X-Direct-Crypto-Proof: {"asset":"BCH","network":"bitcoin-cash","txid":"...","amount":"0.05"}

暗号資産による直接支払いの検証URLが設定されていない場合、エージェントは /v1/order-intake で payment_proof を送信し、運用担当者による確認を受けます。

生成された公開アドレスは、次の場所にあります。