Uniswap Price Oracle: 使用方法? (開発者ガイド)

Uniswap 価格オラクルについて

1. Uniswap 価格オラクルは、瞬間的なスポット価格ではなく、過去のプールリザーブから導出される時間加重平均価格 (TWAP) に依存します。

2. 各オラクルは、ブロックごとに更新される累積価格値を保存するため、開発者はカスタムの時間枠にわたる平均を計算できます。

3. コアメカニズムには、ペアコントラクトからのprice0CumulativeLast変数とprice1CumulativeLast変数の読み取りが含まれます。

4. これらの値は、価格と最後の更新からの経過時間 (秒単位) の合計を表します。

5. 開発者は、 observe()を呼び出すか、2 つのスナップショットの差を手動で計算して、必要な期間にわたる平均価格を導き出す必要があります。

Oracle 監視のセットアップ

1. Oracle の機能がアクティブになる前に、 initialize()を使用してプールを初期化する必要があります。

2. #observe()関数を使用すると、呼び出しごとに最大 512 個の観測値まで、複数の価格ポイントを一度に取得できます。

3. 観測スロットは、512 を法とするインデックスを持つ固定サイズの配列です。各スロットにはタイムスタンプと価格データが保持されます。

4. 開発者は、要求された時間枠が利用可能な最も古い観測の経過期間を超えないようにする必要があります。

5. 要求されたタイムスタンプの観測が存在しない場合、フォールバック ロジックがオフチェーンで実装されていない限り、システムは元に戻ります。

時間加重平均価格の計算

1. TWAP を計算するには、終了時の累積価格から開始時の累積価格を引き、経過秒数で割ります。

2. 式は次のとおりです: (P_end - P_start) / (t_end - t_start) 。ここで、P は累積価格を示し、t はブロックのタイムスタンプを示します。

3. token0/token1 ペアの場合、 price0CumulativeLast はtoken0 ごとの token1 の比率を生成し、 price1CumulativeLastは token1 ごとの token0 を生成します。

4. 固定小数点演算により精度が失われる可能性があります。開発者は中間計算にQ112.112形式を使用する必要があります。

5. オフチェーンの計算では、多くの場合、タイムスタンプのスプーフィングによる操作を防ぐために、オンチェーンのタイムスタンプと同期し、ブロック番号を検証する必要があります。

セキュリティに関する考慮事項と制限事項

1. オラクルは、攻撃者が単一ブロック内でリザーブを操作できるため、十分な時間枠なしで使用された場合、フラッシュ ローン攻撃に対して脆弱になります。

2. 観察期間が短いと、低流動性条件下でのボラティリティの急上昇やフロントランニングの影響を受けやすくなります。

3. 開発者は、ペア コントラクトが正しいバージョンの Uniswap V2 または V3 Oracle インターフェイスを実装していることを確認する必要があります。

4. 再入保護は監視機能に組み込まれていますが、カスタム ラッパーは徹底的に監査されないとリスクを再導入する可能性があります。

5. 古いデータに対するネイティブのエラー処理は存在しません。アプリケーションは、古いスロットを監視する場合、タイムアウトとフォールバックのメカニズムを実装する必要があります。

よくある質問

Q: Uniswap オラクルは、外部呼び出しなしで Solidity スマート コントラクトで直接使用できますか? A: はい、ただし保存された累積値を観察する場合にのみ使用できます。実際の TWAP 計算には時間デルタの計算が必要であり、これにはオフチェーンの前処理またはオンチェーンのタイムスタンプ検証のいずれかが必要です。

Q: 保存されている最も古いスロットよりも古い観測をリクエストした場合はどうなりますか? A: 呼び出し元が循環バッファ範囲内の有効なインデックスを提供しない限り、 observe()関数はTooOldエラーで元に戻ります。

Q: 高価値の DeFi プロトコルに Uniswap V2 オラクルを使用するのは安全ですか? A: 選択した時間枠によって異なります。操作に対する耐性が必要なプロトコルでは、24 時間を超えるウィンドウを使用し、冗長性を確保するために他のデータ ソースと組み合わせる必要があります。

Q: Uniswap V3 オラクルは、使用パターンの点で V2 と大きく異なりますか? A: はい、V3 ではティックベースの価格設定と集中流動性が導入されており、開発者は不均一な時間間隔にわたる累積価格データを解釈する際にアクティブな流動性の範囲を考慮する必要があります。