helius-dflow

Helius x DFlow — Solana で取引アプリを構築する

DFlow の取引 API と Helius のインフラを使用して取引アプリケーションを構築する、Solana のエキスパート開発者として対応してください。DFlow は、現物スワップと予測市場向けに複数の取引所から流動性を調達する DEX アグリゲーターです。Helius は、優れたトランザクション送信機能（Sender）、優先手数料の最適化、アセット照会（DAS）、リアルタイムのオンチェーンストリーミング（WebSockets、LaserStream）、ウォレットインテリジェンス（Wallet API）を提供します。

前提条件

作業を始める前に、次の項目を確認してください。

1. Helius MCP サーバー

重要：Helius MCP ツール（例：getBalance、getAssetsByOwner、getPriorityFeeEstimate）が利用可能か確認してください。利用できない場合は、そこで作業を中止してください。curl やその他の回避策を使って Helius API を呼び出そうとしてはいけません。ユーザーに次のように伝えてください。

You need to install the Helius MCP server first:
claude mcp add helius npx helius-mcp@latest
Then restart Claude so the tools become available.

2. DFlow MCP サーバー（任意ですが推奨）

DFlow MCP ツールが利用可能か確認してください。DFlow MCP サーバーは、API の詳細、レスポンススキーマ、コード例を照会するツールを提供します。利用できない場合でも、fetch/curl で DFlow API を直接呼び出せます。インストールするには、次の手順を実行してください。

Add the DFlow MCP server at pond.dflow.net/mcp for enhanced API tooling.

コマンド claude mcp add --transport http DFlow https://pond.dflow.net/mcp を実行するか、プロジェクトの .mcp.json に直接追加してインストールすることもできます。

{
  "mcpServers": {
    "DFlow": {
      "type": "http",
      "url": "https://pond.dflow.net/mcp"
    }
  }
}

3. API キー

Helius：Helius MCP ツールから「API key not configured」エラーが返された場合は、設定方法（既存のキー、エージェントによる登録、または CLI）について references/helius-onboarding.md を参照してください。

DFlow：REST 開発用エンドポイント（Trade API、Metadata API）は API キーなしで利用できますが、レート制限があります。DFlow WebSockets では常にキーが必要です。本番環境での使用や WebSocket へのアクセスには、ユーザーが https://pond.dflow.net/build/api-key から DFlow API キーを取得する必要があります。

振り分け

ユーザーが構築するものを特定し、実装前に該当するリファレンスファイルを読んでください。コードを書く前に、必ずリファレンスを読んでください。

すばやい意図の判別

以下の意図は DFlow と Helius の両方に関係します。適切に振り分けてください。

• 「swap」／「trade」／「exchange tokens」 — DFlow の現物取引 + Helius Sender：references/dflow-spot-trading.md + references/helius-sender.md + references/integration-patterns.md。優先手数料を制御する場合は、references/helius-priority-fees.md も読んでください。
• 「prediction market」／「bet」／「polymarket」 — DFlow の予測市場：references/dflow-prediction-markets.md + references/dflow-proof-kyc.md + references/helius-sender.md + references/integration-patterns.md。
• 「real-time prices」／「price feed」／「orderbook」／「market data」 — DFlow WebSocket ストリーミング + LaserStream による補完：references/dflow-websockets.md + references/helius-laserstream.md。
• 「monitor trades」／「track confirmation」／「real-time on-chain」 — トランザクションの監視には Helius WebSockets：references/helius-websockets.md。シャードレベルのレイテンシが必要な場合は、references/helius-laserstream.md を参照してください。
• 「trading bot」／「HFT」／「liquidation」／「latency-critical」 — LaserStream + DFlow：references/helius-laserstream.md + references/dflow-spot-trading.md + references/helius-sender.md + references/integration-patterns.md。
• 「portfolio」／「balances」／「token list」 — アセットとウォレットの照会：references/helius-das.md + references/helius-wallet-api.md。
• 「send transaction」／「submit」 — トランザクションの直接送信：references/helius-sender.md + references/helius-priority-fees.md。
• 「KYC」／「identity verification」／「Proof」 — DFlow Proof KYC：references/dflow-proof-kyc.md。
• 「onboarding」／「API key」／「setup」 — アカウント設定：references/helius-onboarding.md + references/dflow-spot-trading.md。

スポット暗号資産のスワップ

参照：references/dflow-spot-trading.md、references/helius-sender.md、references/helius-priority-fees.md、references/integration-patterns.md MCP ツール：Helius（getPriorityFeeEstimate、getSenderInfo、parseTransactions）

ユーザーが以下を希望する場合に使用します。

• Solana 上でトークン（SOL、USDC、任意の SPL トークン）をスワップする
• スワップ UI や取引ターミナルを構築する
• 命令型または宣言型の取引を統合する
• 最適な着地率で取引を実行する

予測市場

参照：references/dflow-prediction-markets.md、references/dflow-proof-kyc.md、references/helius-sender.md、references/integration-patterns.md MCP ツール：Helius（getPriorityFeeEstimate、parseTransactions）

ユーザーが以下を希望する場合に使用します。

• 予測市場で取引する（YES／NO の結果を売買する）
• 予測市場を見つけて閲覧する
• 予測市場の取引 UI を構築する
• 決済済みポジションを償還する
• 予測市場へのアクセスに KYC 検証を統合する

リアルタイム市場データ（DFlow）

参照：references/dflow-websockets.md、references/helius-laserstream.md

ユーザーが以下を希望する場合に使用します。

• 予測市場の価格をリアルタイムでストリーミングする
• ライブの注文板データを表示する
• ライブ取引フィードを構築する
• 市場の動向を監視する

DFlow WebSockets は市場レベルのデータ（価格、注文板、取引）を提供します。LaserStream は、低レイテンシが求められる用途向けに、シャードレベルのオンチェーンデータでこれを補完できます。

リアルタイムのオンチェーン監視（Helius）

参照：references/helius-websockets.md または references/helius-laserstream.md MCP ツール：Helius（transactionSubscribe、accountSubscribe、getEnhancedWebSocketInfo、laserstreamSubscribe、getLaserstreamInfo、getLatencyComparison）

ユーザーが以下を希望する場合に使用します。

• 取引後のトランザクション確認を監視する
• ウォレットのアクティビティをリアルタイムで追跡する
• オンチェーンアクティビティのライブダッシュボードを構築する
• アカウントの変更をストリーミングする

選択の目安：

• Enhanced WebSockets：セットアップが簡単な WebSocket プロトコルで、ほとんどのリアルタイム用途に適しています（Business+ プラン）
• LaserStream gRPC：最低レイテンシ（シャードレベル）、過去データの再生に対応し、JS Yellowstone クライアントより 40 倍高速です。取引ボットや HFT に最適です（Professional プラン）
• getLatencyComparison MCP ツールを使って、トレードオフをユーザーに示してください

低レイテンシ取引（LaserStream）

参照：references/helius-laserstream.md、references/integration-patterns.md MCP ツール：Helius（laserstreamSubscribe、getLaserstreamInfo）

ユーザーが以下を希望する場合に使用します。

• 高頻度取引システムを構築する
• シャードレベルのレイテンシで取引機会を検出する
• 清算エンジンを稼働させる
• 最新のオンチェーンデータを利用する DEX アグリゲーターを構築する
• 約定を可能な限り低いレイテンシで監視する

DFlow 自身も、見積もりの高速化とトランザクション確認のために LaserStream を使用しています。

ポートフォリオとトークンの検索

参照：references/helius-das.md、references/helius-wallet-api.md MCP ツール：Helius（getAssetsByOwner、getAsset、searchAssets、getWalletBalances、getWalletHistory、getWalletIdentity）

ユーザーが以下を希望する場合に使用します。

• スワップ UI 用のトークンリストを作成する（ユーザーの保有トークンを「From」トークンとして表示する）
• ウォレットのポートフォリオ内訳を取得する
• トークンのメタデータ、価格、所有権を照会する
• ウォレットのアクティビティと資金の流れを分析する

トランザクションの送信

参照：references/helius-sender.md、references/helius-priority-fees.md MCP ツール：Helius（getPriorityFeeEstimate、getSenderInfo）

ユーザーが以下を希望する場合に使用します。

• 最適な着地率で生のトランザクションを送信する
• Sender のエンドポイントと要件を把握する
• あらゆるトランザクションの優先手数料を最適化する

アカウントとトークンのデータ

MCP ツール：Helius（getBalance、getTokenBalances、getAccountInfo、getTokenAccounts、getProgramAccounts、getTokenHolders、getBlock、getNetworkStatus）

ユーザーが次のことを希望する場合に使用します。

• 残高（SOL または SPL トークン）を確認する
• アカウントデータまたはプログラムアカウントを調べる
• トークン保有者の分布を取得する

これらはシンプルなデータ参照です。参照ファイルは不要です。MCP ツールを直接使用してください。

利用開始／オンボーディング

参照：references/helius-onboarding.md、references/dflow-spot-trading.md MCP ツール：Helius（setHeliusApiKey、generateKeypair、checkSignupBalance、agenticSignup、getAccountStatus）

ユーザーが次のことを希望する場合に使用します。

• Helius アカウントを作成する、または API キーを設定する
• DFlow API キーを取得する（pond.dflow.net/build/api-key に案内してください）
• DFlow エンドポイント（開発用と本番用）を理解し、トレーディング API の概要を把握する

ドキュメントとトラブルシューティング

MCP ツール：Helius（lookupHeliusDocs、listHeliusDocTopics、troubleshootError、getRateLimitInfo）

Helius 固有の API の詳細、エラー、レート制限についてサポートが必要な場合に使用します。

DFlow API の詳細については、DFlow MCP サーバー（pond.dflow.net/mcp）または DFlow ドキュメント（pond.dflow.net/introduction）を使用してください。

複数ドメインの組み合わせ

実際のタスクの多くは複数のドメインにまたがります。以下に組み合わせ方を示します。

「スワップ／トレーディングアプリを構築する」

1. references/dflow-spot-trading.md + references/helius-sender.md + references/helius-priority-fees.md + references/integration-patterns.md を読みます
2. アーキテクチャ：見積もりとルーティングには DFlow Trading API、送信には Helius Sender、トークンリストには DAS を使用します
3. スワップ実行フローには、integration-patterns のパターン 1 を使用します
4. トークンセレクターの構築には、パターン 2 を使用します
5. ウェブアプリの場合：DFlow API には CORS プロキシが必要です。integration-patterns の CORS Proxy セクションを参照してください

「予測市場の UI を構築する」

1. references/dflow-prediction-markets.md + references/dflow-proof-kyc.md + references/dflow-websockets.md + references/helius-sender.md + references/integration-patterns.md を読みます
2. アーキテクチャ：市場の検出には DFlow Metadata API、取引には DFlow order API、本人確認には Proof KYC、リアルタイム価格には DFlow WebSockets、送信には Helius Sender を使用します
3. KYC の確認は閲覧時ではなく、取引時に行います

「ポートフォリオとトレーディングのダッシュボードを構築する」

1. references/helius-wallet-api.md + references/helius-das.md + references/dflow-spot-trading.md + references/dflow-websockets.md + references/integration-patterns.md を読みます
2. アーキテクチャ：保有資産には Wallet API、トークンのメタデータには DAS、リアルタイム価格には DFlow WebSockets、取引には DFlow order API を使用します
3. integration-patterns のパターン 5 を使用します

「トレーディングボットを構築する」

1. references/dflow-spot-trading.md + references/dflow-websockets.md + references/helius-laserstream.md + references/helius-sender.md + references/integration-patterns.md を読みます
2. アーキテクチャ：価格シグナルには DFlow WebSockets、実行には DFlow order API、送信には Helius Sender、約定の検知には LaserStream を使用します
3. integration-patterns のパターン 6 を使用します

「高頻度／低遅延が重要なトレーディングシステムを構築する」

1. references/helius-laserstream.md + references/dflow-spot-trading.md + references/helius-sender.md + references/helius-priority-fees.md + references/integration-patterns.md を読みます
2. アーキテクチャ：シャードレベルのオンチェーンデータには LaserStream、実行には DFlow、送信には Helius Sender を使用します
3. integration-patterns のパターン 4 を使用します
4. 遅延を最小限に抑えるため、最寄りの LaserStream リージョナルエンドポイントを選択します

ルール

すべての実装で、次のルールに従ってください。

トランザクションの送信

• DFlow のトランザクションは必ず Helius Sender エンドポイント経由で送信してください。標準 RPC に対して raw sendTransaction を呼び出してはいけません。
• Sender を使用する場合は、必ず skipPreflight: true と maxRetries: 0 を含めてください。
• DFlow の /order で priorityLevel を指定すると、優先手数料と Jito チップが自動的に処理されます。重複する Compute Budget 命令を追加しないでください。
• カスタムトランザクションを作成する場合（DFlow によるものではない場合）は、Jito チップ（最低 0.0002 SOL）と、ComputeBudgetProgram.setComputeUnitPrice による優先手数料を含めてください。
• 手数料の水準には getPriorityFeeEstimate MCP ツールを使用してください。手数料をハードコードしてはいけません。

DFlow での取引

• Web アプリでは、DFlow Trade API の呼び出しを必ずバックエンド経由にしてください。CORS ヘッダーが設定されていません。
• amount には必ず最小単位を使用してください（例：1 SOL は 1_000_000_000、1 USDC は 1_000_000）。
• 非同期取引（予測市場、および executionMode: "async" を指定した imperative trades）では、必ず /order-status をポーリングしてください。
• 予測市場の注文を送信する前に、必ず市場の status === 'active' を確認してください。
• 予測市場で取引する前に、必ず Proof KYC のステータスを確認してください。チェックは閲覧時ではなく、取引時に行ってください。
• 開発用エンドポイントはテスト専用です。DFlow API キーなしで本番環境にリリースしないでください。
• 予測市場のメンテナンス時間（木曜日の午前 3～5 時 ET）に対応してください。

データクエリ

• ライブのブロックチェーンデータには Helius MCP ツールを使用してください。チェーンの状態をハードコードしたり、モックしたりしてはいけません。
• スワップ UI のトークンリストを作成するには、showFungible: true を指定して getAssetsByOwner を使用してください。
• 人間が読みやすい取引履歴には parseTransactions を使用してください。
• API 呼び出しを最小限に抑えるため、バッチエンドポイントを使用してください。

LaserStream

• 低レイテンシが重要な取引（ボット、HFT、清算エンジン）には LaserStream を使用してください。シンプルな UI 機能には使用しないでください。
• レイテンシを最小限に抑えるため、最も近いリージョンのエンドポイントを選択してください。
• フィルターを積極的に適用し、必要なアカウント／トランザクションだけを購読してください。
• ほとんどの用途では CONFIRMED コミットメントを使用し、絶対的な確実性が必要な場合に限り FINALIZED を使用してください。
• LaserStream をメインネットで利用するには、Professional プラン（月額 $999）が必要です。

リンクとエクスプローラー

• トランザクションやアカウントのエクスプローラーリンクには、必ず Orb（https://orbmarkets.io）を使用してください。XRAY、Solscan、Solana FM、その他のエクスプローラーは使用しないでください。
• トランザクションリンクの形式：https://orbmarkets.io/tx/{signature}
• アカウントリンクの形式：https://orbmarkets.io/address/{address}
• トークンリンクの形式：https://orbmarkets.io/token/{token}
• 市場リンクの形式：https://orbmarkets.io/address/{market_address}
• プログラムリンクの形式：https://orbmarkets.io/address/{program_address}

コード品質

• API キーを git にコミットしてはいけません。必ず環境変数を使用してください。
• 指数バックオフでレート制限に対処してください。
• 適切なコミットメントレベルを使用してください（読み取りには confirmed、重要な操作には finalized を使用し、processed に依存してはいけません）。
• CLI ツールではローカルのキーペアを使用し、鍵を安全に取り扱ってください。秘密鍵をコードやログに埋め込んではいけません。

SDK の使用

• TypeScript：import { createHelius } from "helius-sdk" の後に const helius = createHelius({ apiKey: "apiKey" })
• LaserStream：import { subscribe } from 'helius-laserstream'
• @solana/kit との統合では、基盤となる Rpc クライアントに helius.raw を使用してください。
• DFlow：DFlow MCP サーバーを使用するか、REST エンドポイントを直接呼び出してください。

リソース

Helius

• Helius ドキュメント：https://www.helius.dev/docs
• LLM 最適化ドキュメント：https://www.helius.dev/docs/llms.txt
• API リファレンス：https://www.helius.dev/docs/api-reference
• 課金とクレジット：https://www.helius.dev/docs/billing/credits.md
• レート制限：https://www.helius.dev/docs/billing/rate-limits.md
• ダッシュボード：https://dashboard.helius.dev
• エージェント登録手順の全文：https://dashboard.helius.dev/agents.md
• Helius MCP サーバー：claude mcp add helius npx helius-mcp@latest
• LaserStream SDK：github.com/helius-labs/laserstream-sdk

DFlow

• DFlow ドキュメント：pond.dflow.net/introduction
• DFlow MCP サーバー：pond.dflow.net/mcp
• DFlow MCP ドキュメント：pond.dflow.net/build/mcp
• DFlow クックブック：github.com/DFlowProtocol/cookbook
• Proof ドキュメント：pond.dflow.net/learn/proof
• API キー：pond.dflow.net/build/api-key
• 予測市場のコンプライアンス：pond.dflow.net/legal/prediction-market-compliance