Uniswap V4: フックの使用方法? (高度な機能)

Uniswap V4 のフックを理解する

1. フックは、Uniswap V4 プールに直接組み込まれたモジュール式のカスタマイズ可能なロジック拡張機能であり、開発者がスワップ、流動性プロビジョニング、料金徴収中の特定の時点でカスタム動作を挿入できるようにします。

2. V3 の静的な料金層や不変のプール パラメーターとは異なり、V4 では、コア プロトコルの信頼最小化設計を変更することなく、スワップ実行、流動性の追加/削除、料金収集などのコア アクションの前後にフックを実行できます。

3. 各フックは、 beforeSwap 、 afterSwap 、 beforeAddLiquidity 、およびafterRemoveLiquidityなどの必須関数を定義する IHook インターフェイスに準拠する個別のスマート コントラクトとして実装されます。

4. プールは、指定されたフック アドレスを使用してデプロイする必要があります。フックは、一度設定されると、プールが再初期化されない限り変更できません。これは、不変性と監査可能性を保証する意図的な制約です。

5. フック コントラクトはオンチェーンで検証され、DoS ベクトルを防止するためにコールバックごとに厳格なガス制限に合格する必要があり、無駄のない決定論的なロジックが適用されます。

カスタムフックコントラクトのデプロイ

1. 開発者は、ユースケースに関連する必要なコールバックのみに焦点を当てて、IHook を実装する Solidity コードを作成します。たとえば、価格オラクル検証フックは、オフチェーン参照から 0.5% を超えて逸脱する取引を拒否するbeforeSwapのみを実装できます。

2. フック コントラクトには、呼び出し元にフックのデプロイが許可されている場合に true を返すvalidateHook関数が含まれている必要があります。多くの場合、デプロイはガバナンスまたはマルチシグ ウォレットに制限されます。

3. コンパイルには、Uniswap の検証済みコンパイラ設定と互換性のある EVM 互換バイトコードをターゲットにする必要があります。逸脱があると、プールの作成中にデプロイメントが失敗します。

4. 導入が成功すると、フック アドレスが、トークン アドレス、料金層、ティック間隔とともにパラメータとしてcreatePool関数に渡されます。

5. ライブになると、そのプールとのすべてのやり取りは登録されたフックを介して自動的にルーティングされます。標準のトランザクション署名以外にユーザー側の設定やウォレットの承認は必要ありません。

実際のフックの使用例

1.動的な手数料調整: フックはオンチェーンのボラティリティ指標を監視し、スリッページが高い状況では手数料の割合を増加させ、落ち着きが戻ったら基本レートに戻します。

2.流動性ロックの強制: 流動性を削除する前に、フックはポジションが少なくとも 72 時間アクティブであるかどうかをチェックし、短期的な投機を阻止するために早期の決済を拒否します。

3.コンプライアンス フィルタリング: オンチェーン KYC オラクルはbeforeAddLiquidity内でクエリされます。規制対象組織によってホワイトリストに登録されていないアドレスは参加を拒否されます。

4.料金再分配ロジック: 各スワップの後、フックは収集した料金を横取りし、リアルタイムの APY 計算に基づいて一部をステーキング報酬コントラクトに転送します。

5.ポジション健全性モニタリング: afterSwap中に、フックは集中流動性ポジションの更新された LTV 比率を計算し、しきい値を超えた場合に清算シグナルをトリガーします。

フック統合のセキュリティに関する考慮事項

1. フックはプールの完全な実行コンテキストを継承します。つまり、悪意のあるロジックやバグのあるロジックにより、流動性が凍結されたり、手数料が流出したり、ティック データ構造が破損したりする可能性があります。

2. 再入は明示的に禁止されています。Uniswap V4 ランタイムはフック コールバックへの非再入エントリを強制し、プールの状態を変更する関数への再帰的コールバックを防ぎます。

3. ガス使用量はコールバックごとに 200,000 ユニット未満に抑える必要があります。この制限を超えると、プライマリ スワップまたは流動性操作を含むトランザクション全体が元に戻ります。

4. すべてのフック ストレージの書き込みは、フック自身のコントラクト ストレージに分離されます。プール ストレージへの直接アクセスは許可されず、懸念事項の分離が維持されます。

5. フックによって行われる外部呼び出しは、Chainlink 価格フィードや ENS リゾルバーなど、事前に承認されたインターフェイスのみに制限されます。任意の外部コントラクト呼び出しはプロトコル レベルでブロックされます。

よくある質問

Q: 単一のフックを複数の Uniswap V4 プール間で再利用できますか?はい。フック コントラクトは、IHook に準拠し、各プールの作成時に検証に合格する限り、任意の数のプールから参照できます。

Q: プールのデプロイ後にフックをアップグレードすることはできますか?いいえ。フック アドレスは、プールの不変の初期化パラメータに焼き付けられます。アップグレードには、更新されたフック アドレスを使用して新しいプールをデプロイする必要があります。

Q: フックは、MetaMask や Rabby などのウォレットのフロントエンド UI の動作に影響しますか?直接ではありません。ウォレットには標準のスワップ インターフェイスが表示されます。ただし、フックによって条件付きの復帰が導入される場合 (たとえば、特定のアドレスのスワップをブロックする場合)、dApp がフック固有のエラー解析を統合しない限り、トランザクションはサイレントに失敗します。

Q: 一般に使用できる、Uniswap が管理する公式のフックはありますか? Uniswap Labs は、基本料金アキュムレーターやタイムロック流動性フックを含むリファレンス実装を GitHub の uniswap-v4-hooks リポジトリの下で公開しており、すべて MIT ライセンスと監査を受けています。