mcpField
D
dflow-platform-fees

dflow-platform-fees

github.com/dflowprotocol開発047 回インストール3 週間前に更新
リポジトリ

dflow-platform-fees について

dflow-platform-feesは、DFlow Trade API経由の取引にビルダー向け手数料を加えるスキルです。手数料パラメーター、トークンアカウント、APIキーの選択、運用上の注意点を扱い、詳細なエンコードはDFlow docs MCPを参照します。

主な機能

  1. 01ベーシスポイントで固定料率を設定
  2. 02手数料を負担するトークン側の選択
  3. 03既存の手数料アカウントの指定
  4. 04受取トークンとアカウントの照合
  5. 05APIキーとホストの選択を考慮
  6. 06手数料とスリッページの問題を回避

活用シーン

  1. 01アプリ経由の取引から手数料を徴収
  2. 02USDCまたはSOLで手数料を受領
  3. 03Trade API注文への手数料パラメーター追加
  4. 04取引前の手数料アカウント設定確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dflowprotocol/dflow-skills --skill dflow-platform-fees

インストール後、Claude Code で/dflow-platform-feesを入力して読み込まれたか確認します。

詳細

DFlow プラットフォーム手数料

アプリが DFlow Trade API 経由でルーティングする取引に手数料を設定できます。取引が正常に実行されると、ビルダーが管理するトークンアカウントに支払われます。これはビルダーからユーザーへの手数料であり、ビルダーが自らの流通網を収益化するためのものです。

前提条件

  • DFlow docs MCP（https://pond.dflow.net/mcp）— リポジトリの READMEに従ってインストールしてください。このスキルは手順を示すもので、MCP はリファレンスです。正確なパラメーターのエンコード方法、レスポンスの形式、すべてのモードの組み合わせは MCP に記載されています。推測しないでください。

対象範囲

API のみです。 プラットフォーム手数料は Trade API の /order パラメーターです。dflow CLI は自分自身の取引に使うもので、流通プロダクトの収益化には使わないため、プラットフォーム手数料のフラグは公開していません。--platform-fee-bps オプションを探さないでください。

他の取引スキルと同様、使用するホストは API キーの有無によって異なります。本番環境では https://quote-api.dflow.net と x-api-key、開発環境では https://dev-quote-api.dflow.net を使います。

手数料モデル — platformFeeBps

取引額に対する固定割合をベーシスポイントで指定します（1 bps = 0.01％）。platformFeeBps: 50 → 手数料 0.5％です。

/order の主要パラメーター

パラメーターの詳細とエンコード方法については、docs MCP を参照するか、次のページを直接読んでください：/spot/trading/platform-fees、/spot/recipes/platform-fees。

  • platformFeeBps — bps 単位で指定する固定手数料です。
  • platformFeeMode — 手数料を支払う側を指定します：outputMint（デフォルト）または inputMint。
  • feeAccount — 手数料の受取先となる SPL トークンアカウントです。取引前に作成済みである必要があります。DFlow は作成しません。

手数料アカウント（ATA）

手数料を受け取るトークンごとに、1 つの ATA が必要です。USDC と SOL で手数料を受け取るビルダーは、USDC 用と SOL 用の ATA がそれぞれ必要です。どちらも事前に作成し、ビルダーのウォレットで管理してください。リクエストごとに該当する ATA を feeAccount として渡すと、DFlow が読み取り、モードに対応するトークンと一致することを検証したうえで、取引が成功した場合に送金します。

ユーザーに確認すること（確認しないこと）

不足している場合は確認してください：

  1. 手数料率 — 手数料の bps 値です。
  2. 受取トークン — どのトークンで手数料を受け取りたいですか。また、ビルダーのウォレットが所有する、対応する ATA はすでにありますか。
  3. DFlow API キー。 プラットフォーム手数料は HTTP 専用の機能です（ユーザー自身の /order 呼び出しに指定するパラメーター）。CLI フラグはないため、スクリプトの HTTP クライアントにキーを渡す必要があります。簡潔で中立的な質問をしてください：「DFlow API キーをお持ちですか？」 キーの保存場所を決めつけないでください。「環境変数にありますか？」 や 「DFLOW_API_KEY は設定されていますか？」 といった聞き方は、ユーザーが求めていない環境変数のデフォルト設定へ誘導してしまいます。選択肢を示してください。環境変数や開発環境へ黙ってフォールバックしないでください。DFlow のキーはすべての用途で1 つだけです。同じ x-api-key で Trade API と Metadata API、REST と WebSocket を利用できます。はい → 本番環境の https://quote-api.dflow.net と x-api-key を使用します。いいえ → レート制限のある開発環境の https://dev-quote-api.dflow.net を使用します。案内先：https://pond.dflow.net/get-started/api-key。

次のことは確認しないでください：

  • RPC、署名、スリッページ — 手数料とは別の項目です。基本の取引スキルで対応します。
  • ユーザー が誰かに関すること — プラットフォーム手数料はリクエストごとのパラメーターであり、ウォレット単位の設定ではありません。

注意点（docs MCP には記載されていないこと）

  • 手数料を徴収しない場合は、platformFeeBps を設定しないでください。 API は指定された手数料をスリッページ許容値に反映します。オンチェーンで実際に手数料が徴収されないと、スリッページの予算が何も得られないまま「消費」され、ユーザーに不利な価格になります。実際に受取先となる feeAccount がある場合に限り、ゼロ以外の値を渡してください。
  • feeAccount は取引前に存在している必要があります。 DFlow は作成しません。存在しない場合、取引は失敗します。
  • 徴収するトークンごとに ATA が 1 つ必要です。 USDC 用の手数料アカウントは、SOL 用の手数料アカウントとは異なります。必要なものを事前に作成してください。
  • 手数料が適用されるのは、取引が成功した場合のみです。 失敗・キャンセル・取り消しとなった取引では、手数料は発生せず、送金も行われません。失敗した取引を手数料徴収対象の取引量に含めないでください。

当てはまらない場合

パラメーターの正確なエンコード方法については docs MCP を、実行可能なコード例については /spot/recipes/platform-fees を参照し、スリッページとの相互作用については FAQ の項目を確認してください。

関連スキル

  • dflow-spot-trading — 基本となる spot /order 呼び出しを作成し、その上にこれらのパラメーターを追加します。優先手数料と、スポンサー付き／ガスレスのフローも扱います。

コメント

Markdown 対応