mcpField
J
jupiter-swap-migration

jupiter-swap-migration

github.com/jup-ag開発85287 回インストール16 週間前に更新
リポジトリ

jupiter-swap-migration について

jupiter-swap-migration は、既存の Jupiter スワップ連携を Metis v1 または Ultra から Swap API v2 へ移行するスキルです。移行経路、パラメーターとレスポンスの対応、移行後の確認項目を案内します。

主な機能

  1. 01Ultra・Metis からの移行経路
  2. 02パラメーターとレスポンスの対応
  3. 03移行前後のコード例
  4. 04エンドポイントとフィールドの監査項目
  5. 05Swap v2 のエラー・トランザクション更新

活用シーン

  1. 01Ultra 連携を /order に更新
  2. 02Metis のフローを /build に移行
  3. 03Metis の実行を /order と /execute に切り替え
  4. 04旧エンドポイントやフィールドをコード内で確認

インストール

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

$npx skills add https://github.com/jup-ag/agent-skills --skill jupiter-swap-migration

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
examples/
metis-to-build.md
metis-to-order.md
ultra-to-order.md

詳細

Jupiter スワップ移行ガイド

既存の Jupiter スワップ連携を Metis（v1） または Ultra から、統合された Swap API v2 に移行します。

ターゲットベース URL：https://api.jup.ag/swap/v2 認証：developers.jup.ag の x-api-key（変更なし）

使用する場合／使用しない場合

次の場合に使用します：

  • api.jup.ag/swap/v1/quote、api.jup.ag/swap/v1/swap-instructions、または ultra-api.jup.ag を呼び出すコードを移行する場合。
  • Jupiter スワップのエンドポイントを v2 に更新する場合。
  • Metis の 2 段階フローから、統合された /build または /order エンドポイントに切り替える場合。

次の場合は使用しないでください：

  • Jupiter 連携を新規に構築する場合（代わりに integrating-jupiter スキルを使用してください）。
  • スワップ以外の Jupiter API（Lend、Trigger、Recurring など）を扱う場合。

トリガー：ultra、metis、ultra swap、ultra api、ultra-api.jup.ag、/ultra/v1、swap/v1、swap-instructions、migrate swap、ultra migration、metis migration、swap v1 to v2、v1 to v2、upgrade jupiter、swap-instructions deprecated、deprecated swap、old jupiter api、swap upgrade、update swap api、quote endpoint deprecated、swap stopped working、swap broken、ExactOut removed、swapMode removed、userPublicKey、parameter rename、addressLookupTable、response format changed

移行パス

移行元移行先作業量選択するタイミング
Ultra → /orderGET /swap/v2/order + POST /swap/v2/execute最小限（URL の変更のみ）Ultra ユーザーの標準
Metis → /buildGET /swap/v2/build中程度（パラメーターとレスポンスのマッピング）トランザクションの合成が必要な場合
Metis → /orderGET /swap/v2/order + POST /swap/v2/execute中程度（フローの変更）トランザクションを変更する必要はなく、実行管理を任せたい場合

パスの詳細

各パスには、変更前／変更後のコード、パラメーターのマッピング、レスポンスの変更を含む専用の例があります：

移行後のチェックリスト

  1. URL の監査：コードベースで ultra-api.jup.ag、/ultra/v1/、/swap/v1/quote、/swap/v1/swap-instructions を検索し、すべて置き換えられていることを確認します
  2. パラメーターの変更：userPublicKey → taker（/build パスの場合）
  3. swapMode の削除：v2 がサポートするのは ExactIn のみです。ExactOut を使用している場合は、フローを再設計してください。このモードは利用できなくなりました
  4. slippageBps のデフォルト値：/build では省略時に 50 bps がデフォルトで適用されます。/order では、連携が特定の値に依存している場合、デフォルト値を確認してください
  5. レスポンスのフィールド名：/execute のレスポンスに inputAmountResult／outputAmountResult（v2 の正式なフィールド名）がコードで使用されていることを確認します
  6. ALT の処理：/build を使用する場合は、addressLookupTableAddresses（配列）から addressesByLookupTableAddress（オブジェクト）に切り替え、RPC による ALT 解決コードを削除します
  7. 手数料イベントの解析：v2 の命令は手数料イベントを出力しません。それらに依存するトランザクションパーサーがあれば更新します
  8. ルートプランの形式：ルートプランを解析する場合は、percent ではなく bps フィールド（正式なフィールド）を使用します
  9. エラーコード：Swap v2 のエラーコードに合わせてエラー処理を更新します
  10. テスト：少額で devnet／mainnet のスワップをエンドツーエンドで実行し、動作を確認します

廃止

Jupiter が v1（/swap/v1）エンドポイントと Ultra（ultra-api.jup.ag）ドメインを廃止したら、このスキルを削除します。その時点で、すべての連携はすでに v2 に移行しています。

確認期限：2026-09-01 — v1／Ultra エンドポイントが廃止されているか確認します。

参考資料

移行ガイドは、対象プロファイル別の3つに分かれています（旧単一の migration ページは廃止されました）。

コメント

Markdown 対応