Pulse402 Oracle

Pulse402 Oracle

エージェント向けに、読み取り専用のBase市場価格、Polymarketの板・履歴、サンプリングしたトークンリスクの証拠を提供します。正規のサービスは https://pulse402-oracle.onrender.com です。フィードには元の観測タイムスタンプと10秒の取得TTLが保持され、期限切れのデータは配信前に更新されます。プロバイダーの障害は決済前に報告されます。

フィード	取得データ	USDC/呼び出し
/v1/pulse/base-liquidity	対応プールで観測された流動性、実際のプール残高、ウォームアップ後に測定した残高変化、および固定ブロックでの$100/$1,000/$10,000 USDC見積もり	0.001
/v1/pulse/polymarket-velocity	実際のCLOBの板の厚さ／中間価格と、価格履歴に基づく5分間の確率変動。取引所と取得それぞれの時刻を個別に表示	0.001
/v1/pulse/threat-intel	開示されたトークンサンプルに対するGoPlusの評価、証拠ハッシュ、範囲を限定したテキストチェック	0.001
/v1/pulse/arb-routes	1つの検証済みBaseブロックにおける、異なるプールを使った金額別の往復見積もりとグロススプレッド	0.001

見積もりは、署名を伴わない公開コントラクトの読み取りです。実行時の総ガス代、送金税、MEV、約定の成功、純利益は確認されていません。未対応のプールや不足している証拠は明示されます。表示される価格変動からクジラの動向を特定することはできません。テキストサニタイザーは明示されたパターンを検出するものであり、インジェクションを完全に防止する保証はありません。spenderリストが空でも、安全が確認されたことにはなりません。

支払い

BaseとSolanaでは、x402 v2のUSDC定額支払いを使用します。未払いのリクエストには、現在のサーバー要件を含むHTTP 402が返されます。x402対応のクライアントを使用してください。このサーバーが顧客の秘密鍵を必要とすることはありません。

• Baseの受取先：0x80E0Ae84679b7f11bE171DaADd492FBECf628cd6
• Solanaの受取先：9wuMysgXwNhtQeqJgGByAiMYc4EjzZ5wUSmnjrrt3ffh
• Solana USDC ATA：DD3A7jaXFeHcif9eYj6Vhomuxypat5Yxi8ow6wxz27yL。USDCのスポンサー付き送金を行う前に存在している必要があります。見積もりだけでは、アカウントの準備ができていることを証明できません。
• 空のJSONオブジェクトを指定してPOST /v1/pass/prepayを実行すると、6,000クレジットを5 USDCで購入できます。有効期間は7日間です。クレジットは決済の確認後にのみ有効になります。
• 購入したトークンはX-Pulse-Sessionで送信し、配信ごとに一意のIdempotency-Keyを指定してください。同じキーで同一の引数を再試行すると、クレジットを追加消費せずに応答を取得できます。
• リクエストごとの支払い結果を取得し直すには、元の署名済み認可と同一のリクエストを使用してください。応答でcharged: "unknown"と示された場合、支払いを再度署名してはいけません。

HTTP、サニタイザー、プリペイ、MCPの各ルートでは、認証から受領書／配信の確定まで、1つの検証済みライフサイクルを共有します。購入者の認証、操作の確保、検証、有効かつ上限付きの結果の取得、準備状態の永続化、決済の1回限りの送信、受領書／配信の確定の順に処理されます。決済が不確定な場合は照合のために保持され、自動で再送信されることはありません。保持された購入済みデータは、認可の期限切れ後も取得できます。

永続ディスク上でPULSE_PAYMENTS_DB=/app/state/payments.sqlite3を設定してください。SQLiteはWAL、完全同期、オーナーフェンス付きの操作遷移を使用します。承認済みのRenderディスクは/app/stateにマウントされます。一時ストレージは、購入済みクレジットの保持や再デプロイ後の復旧には適していません。

エージェントの検出

/openapi.json、/llms.txt、/skill.md、/.well-known/x402.json、/.well-known/mcp.json、/.well-known/agent-card.json および MCP の検出機能は公開されています。POST /mcp は JSON-RPC による検出と、4 つの有料ツールを受け付けます。リモート MCP コネクターがトランスポートを提供しますが、ツールの使用には x402 対応の決済クライアントまたは購入済みセッションヘッダーが引き続き必要です。

無料の /v1/preview/* ルートでは、カバレッジ件数と観測の健全性を確認できますが、価格設定された市場レコードは公開されません。/health はプロセスの健全性とフィードの鮮度を区別し、/version はデプロイされたリビジョンを公開します。

Cloudflare Worker は、すべてのルートを正規のバックエンドに一度プロキシします。独自の決済エンジン、無料のツール利用枠、合成フィード、セッション発行権限はありません。認証済みの公式 Wrangler CLI を使用して、Worker を個別に公開してください。Render へのデプロイでは Cloudflare は更新されません。

検証

python -m pytest tests -q と node --test tests/worker.test.mjs を実行してください。テストでは、分離されたデータベース、決定論的な未資金供給の暗号フィクスチャー、モックされたトランスポートを使用します。外部への決済は行いません。フィードエンジンは、購入者の鍵やトランザクションを使わずに、署名のない公開プロバイダーの検証もサポートしています。