LayerZero コントラクトを使用してクロスチェーン メッセージを実行するにはどうすればよいですか?

LayerZero アーキテクチャを理解する

1. LayerZero は、信頼できる仲介者やラップされた資産に依存せずにブロックチェーン間の通信を可能にする、軽量で許可のない相互運用性プロトコルとして動作します。

2. 各チェーンに展開されたウルトラ ライト ノード (ULN) を利用して、ブロックチェーン全体の状態を保存せずにメッセージの整合性と一貫性を検証します。

3. コア コンポーネントには、メッセージ ルーティングを処理するエンドポイント コントラクトと、ブロック ヘッダーとトランザクション プルーフを個別にフェッチおよび配信する Oracle および Relayer サービスが含まれます。

4. 各チェーンは独自のエンドポイント アドレスを維持するため、開発者は互換性のある ULN アダプタを展開するか、相互作用してクロスチェーン呼び出しを開始する必要があります。

5. メッセージ配信は非同期かつ決定的です。一度送信されると、Oracle と Relayer の両方が同じブロック ハッシュと証明を確認するまで保留状態になります。

エンドポイントの展開と構成

1. 開発者はまず、LayerZero の公式ドキュメントまたはエクスプローラー ツールを使用して、ソース チェーンと宛先チェーンの正しいエンドポイント アドレスを特定する必要があります。

2. LayerZeroReceiverまたはLayerZeroUserApplicationConfigから継承するカスタム コントラクトをソース チェーンにデプロイして、送信ロジックを定義する必要があります。

3. エンドポイントは、両方のチェーンのネイティブ トークンでのガス支払いを必要とします。送信者はアウトバウンド送信の料金を支払い、受信者はインバウンドの実行料金を負担します。

4. dstChainId 、 dstEndpoint 、 adapterParamsなどの構成パラメータは、送信前に正確にエンコードする必要があります。

5.adapterParams の構成が間違っている場合、特に ZRO 料金の見積もりが間違っている場合やペイロード圧縮設定が間違っている場合、中継中にサイレント障害が発生する可能性があります。

ペイロードのエンコードと送信

1. アプリケーション データは、Solidity のabi.encodeまたは同等のツールを使用してバイトに ABI エンコードし、動的な配列のあいまいさや位置合わせの不一致がないようにする必要があります。

2. エンドポイントの送信関数は、宛先チェーン ID、宛先アドレス、エンコードされたペイロードとアダプター固有のパラメーターの 3 つの引数を受け入れます。

3. ペイロード サイズは、宛先チェーンのブロック ガス制限と LayerZero のメッセージごとの上限によって制限されます。LZ4 または同様の前処理で圧縮しない限り、10KB を超えると拒否が引き起こされることがよくあります。

4. 開発者は、最初の送信とその後のexecuteOnReceive呼び出しの両方に十分なガス許容量を含める必要があります。過小評価すると、宛先でのメッセージ処理が停止します。

5. すべてのペイロードは、一度送信されると不変になります。ソースチェーンでのトランザクション確認後は、編集やキャンセルはできません。

メッセージの受信と検証

1. 宛先コントラクトは、リレー検証が成功するとエンドポイントによって自動的に呼び出されるlzReceive を実装する必要があります。

2. lzReceive内で、開発者はsrcAddressとsrcChainIdを検証して、スプーフィングや不正なオリジン インジェクションを防ぐ必要があります。

3. リエントランシー ガードは必須です。実行中に状態をロックできないと、二重支払いや再帰的呼び出しのエクスプロイトが可能になる可能性があります。

4. デコードはソースのエンコードを正確に反映する必要があります。型や順序が一致しないと、チェーン上でエラー メッセージが表示されずに元に戻ります。

5. lzReceive内のmsg.senderは、元のユーザーではなく常にローカルのエンドポイント コントラクトであるため、アクセス制御は検証されたソース識別子に依存する必要があります。

よくある質問

Q: Arbitrum にコントラクトを展開せずに、イーサリアムから Arbitrum にメッセージを送信できますか? A: いいえ。lzReceiveを実装する受信コントラクトは Arbitrum 上に存在し、ローカル エンドポイントに登録されている必要があります。

Q: Oracle が Relayer とは異なるブロック ハッシュを報告した場合はどうなりますか? A: 両方のサービスが同一の値に収束するまで、メッセージは無期限に停止します。自動再試行やフォールバックは発生しません。

Q: 運用契約でエンドポイント アドレスをハードコードしても安全ですか? A: はい。ただし、ターゲット チェーン上で不変であることが確認された後でのみです。一部のテストネット エンドポイントはアップグレードされますが、メインネット エンドポイントは修正されます。

Q: エンコードが正しいように見えても、トランザクションが「無効なペイロード」で元に戻るのはなぜですか? A: これは通常、ABI エンコーダーのバージョンの不一致、構造体フィールド セレクターの欠落、またはabi.encodeの代わりにabi.encodePackedの誤った使用が原因で発生します。