chore: Update examples

examples/lzapp-migration/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** Both `lzapp.config.ts` and `layerzero.config.ts` ship a single-DVN default for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to every `requiredDVNs` array. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="width: 400px" src="https://docs.layerzero.network/img/LayerZero_Logo_White.svg"/>

examples/lzapp-migration/layerzero.config.ts

@@ -3,6 +3,12 @@ import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 // Note:  Do not use address for EVM OmniPointHardhat contracts.  Contracts are loaded using hardhat-deploy.
 const sepoliaContract: OmniPointHardhat = {
     eid: EndpointId.SEPOLIA_TESTNET, /// EndpointV1

examples/lzapp-migration/lzapp.config.ts

@@ -2,6 +2,12 @@ import { EndpointId } from '@layerzerolabs/lz-definitions'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 const sepoliaContract: OmniPointHardhat = {
     eid: EndpointId.SEPOLIA_TESTNET, /// EndpointV1
     contractName: 'LzApp', // Update this if trying out the other contracts, i.e. MyLzApp

examples/mint-burn-oft-adapter/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, replace `<SECONDARY_DVN>` with a non-LayerZero-Labs DVN provider. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="max-width: 500px" src="https://d3a2dpnnrypp5h.cloudfront.net/bridge-app/lz.png"/>

examples/mint-burn-oft-adapter/layerzero.config.ts

@@ -36,8 +36,10 @@ const pathways: TwoWayConfig[] = [
     [
         baseContract, // Chain A contract
         arbitrumContract, // Chain B contract
-        [['LayerZero Labs'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
-        [1, 1], // [A to B confirmations, B to A confirmations]
+        // Replace <SECONDARY_DVN> with a non-LayerZero-Labs DVN provider for this pathway.
+        // See https://docs.layerzero.network/v2/deployments/dvn-addresses for available providers.
+        [['LayerZero Labs', '<SECONDARY_DVN>'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
+        [1, 1], // [A to B confirmations, B to A confirmations] — production typically uses 15+
         [EVM_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Chain B enforcedOptions, Chain A enforcedOptions
     ],
 ]

examples/oapp-aptos-move/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `move.layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to every `requiredDVNs` array. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 # OApp Aptos Move Example
 
 ## Setup and Installation

examples/oapp-aptos-move/move.layerzero.config.ts

@@ -3,6 +3,12 @@ import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oapp-read/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production read OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN read channel for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to the `requiredDVNs` array to avoid single-point-of-trust state queries. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="width: 400px" src="https://docs.layerzero.network/img/LayerZero_Logo_White.svg"/>

examples/oapp-read/layerzero.config.ts

@@ -2,6 +2,12 @@ import { ChannelId, EndpointId } from '@layerzerolabs/lz-definitions'
 import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 import { type OAppReadOmniGraphHardhat, type OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN on the read channel for clarity.
+// Production read OApps must use at least 2 DVNs to avoid single-point-of-trust state queries.
+// Before mainnet, add a non-LayerZero-Labs DVN to `requiredDVNs` below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 const sepoliaContract: OmniPointHardhat = {
     eid: EndpointId.ARBSEP_V2_TESTNET,
     contractName: 'ReadPublic',

examples/oapp-solana/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, replace `<SECONDARY_DVN>` with a non-LayerZero-Labs DVN provider. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="width: 400px" src="https://docs.layerzero.network/img/LayerZero_Logo_White.svg"/>

examples/oapp-solana/docs/move.layerzero.config.ts

@@ -4,6 +4,12 @@ import { EndpointId } from '@layerzerolabs/lz-definitions'
 import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 import { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oapp-solana/layerzero.config.ts

@@ -43,7 +43,9 @@ const pathways: TwoWayConfig[] = [
     [
         arbitrumContract, // Arbitrum contract
         solanaContract, // Solana contract
-        [['LayerZero Labs'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
+        // Replace <SECONDARY_DVN> with a non-LayerZero-Labs DVN provider for this pathway.
+        // See https://docs.layerzero.network/v2/deployments/dvn-addresses for available providers.
+        [['LayerZero Labs', '<SECONDARY_DVN>'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
         [20, 32], // [Arbitrum to Solana outbound confirmations, Solana to Arbitrum outbound confirmations]
         [SOLANA_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Arbitrum to Solana enforcedOptions, Solana to Arbitrum enforcedOptions
     ],

examples/oapp/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, replace `<SECONDARY_DVN>` with a non-LayerZero-Labs DVN provider. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="width: 400px" src="https://docs.layerzero.network/img/LayerZero_Logo_Black.svg"/>

examples/oapp/layerzero.config.ts

@@ -34,8 +34,10 @@ const pathways: TwoWayConfig[] = [
     [
         baseContract, // Chain A contract
         arbitrumContract, // Chain B contract
-        [['LayerZero Labs'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
-        [1, 1], // [A to B confirmations, B to A confirmations]
+        // Replace <SECONDARY_DVN> with a non-LayerZero-Labs DVN provider for this pathway.
+        // See https://docs.layerzero.network/v2/deployments/dvn-addresses for available providers.
+        [['LayerZero Labs', '<SECONDARY_DVN>'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
+        [1, 1], // [A to B confirmations, B to A confirmations] — production typically uses 15+
         [EVM_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Chain B enforcedOptions, Chain A enforcedOptions
     ],
 ]

examples/oft-adapter-aptos-move/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `move.layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to every `requiredDVNs` array. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 # OFT Adapter Aptos Move Example
 
 ## Setup and Installation

examples/oft-adapter-aptos-move/move.layerzero.config.ts

@@ -3,6 +3,12 @@ import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oft-adapter-initia/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `move.layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to every `requiredDVNs` array. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 ## OFT Initia Example
 
 The following is a guide for deploying OFT's and wiring them to Initia.

examples/oft-adapter-initia/move.layerzero.config.ts

@@ -3,6 +3,12 @@ import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oft-adapter/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, replace `<SECONDARY_DVN>` with a non-LayerZero-Labs DVN provider. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="width: 400px" src="https://docs.layerzero.network/img/LayerZero_Logo_Black.svg"/>

examples/oft-adapter/layerzero.config.ts

@@ -51,8 +51,10 @@ const pathways: TwoWayConfig[] = [
     [
         baseContract, // Chain A contract
         arbitrumContract, // Chain B contract
-        [['LayerZero Labs'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
-        [1, 1], // [A to B confirmations, B to A confirmations]
+        // Replace <SECONDARY_DVN> with a non-LayerZero-Labs DVN provider for this pathway.
+        // See https://docs.layerzero.network/v2/deployments/dvn-addresses for available providers.
+        [['LayerZero Labs', '<SECONDARY_DVN>'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
+        [1, 1], // [A to B confirmations, B to A confirmations] — production typically uses 15+
         [EVM_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Chain B enforcedOptions, Chain A enforcedOptions
     ],
 ]

examples/oft-aptos-move/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `move.layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to every `requiredDVNs` array. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 # OFT Aptos Move Example
 
 ## Setup and Installation

examples/oft-aptos-move/move.layerzero.config.ts

@@ -3,6 +3,12 @@ import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oft-hyperliquid/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, replace `<SECONDARY_DVN>` with a non-LayerZero-Labs DVN provider. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <img alt="LayerZero" style="width: 400px" src="https://docs.layerzero.network/img/LayerZero_Logo_White.svg"/>

examples/oft-hyperliquid/layerzero.config.ts

@@ -36,7 +36,9 @@ const pathways: TwoWayConfig[] = [
     [
         hyperevmContract, // Chain A contract
         arbitrumContract, // Chain B contract
-        [['LayerZero Labs'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
+        // Replace <SECONDARY_DVN> with a non-LayerZero-Labs DVN provider for this pathway.
+        // See https://docs.layerzero.network/v2/deployments/dvn-addresses for available providers.
+        [['LayerZero Labs', '<SECONDARY_DVN>'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
         [1, 20], // [A to B confirmations, B to A confirmations]
         [EVM_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Chain B enforcedOptions, Chain A enforcedOptions
     ],

examples/oft-initia/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `move.layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, add a non-LayerZero-Labs DVN to every `requiredDVNs` array. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 ## OFT Initia Example
 
 The following is a guide for deploying OFT's and wiring them to Initia.

examples/oft-initia/move.layerzero.config.ts

@@ -3,6 +3,12 @@ import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 
 import type { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oft-solana/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> **Production OApps must use at least 2 DVNs.** This example's `layerzero.config.ts` ships a single-DVN default for clarity. Before deploying to mainnet, replace `<SECONDARY_DVN>` with a non-LayerZero-Labs DVN provider. See the [Production DVN Configuration](https://docs.layerzero.network/v2/deployments/dvn-addresses) reference and the [migration guide for existing 1-of-1 OApps](https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn).
+
 <p align="center">
   <a href="https://layerzero.network">
     <picture>

examples/oft-solana/docs/move.layerzero.config.ts

@@ -4,6 +4,12 @@ import { EndpointId } from '@layerzerolabs/lz-definitions'
 import { ExecutorOptionType } from '@layerzerolabs/lz-v2-utilities'
 import { OAppOmniGraphHardhat, OmniPointHardhat } from '@layerzerolabs/toolbox-hardhat'
 
+// TODO: This example uses a single LayerZero Labs DVN in `requiredDVNs` for clarity.
+// Production OApps must use at least 2 DVNs. Before mainnet, add a non-LayerZero-Labs
+// DVN to each `requiredDVNs` array below. See:
+//   - DVN providers:    https://docs.layerzero.network/v2/deployments/dvn-addresses
+//   - Migration guide:  https://docs.layerzero.network/v2/get-started/migrating-from-single-dvn
+
 enum MsgType {
     SEND = 1,
     SEND_AND_CALL = 2,

examples/oft-solana/layerzero.config.ts

@@ -53,7 +53,9 @@ export default async function () {
         [
             arbitrumContract, // Chain A contract
             solanaContract, // Chain B contract
-            [['LayerZero Labs'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
+            // Replace <SECONDARY_DVN> with a non-LayerZero-Labs DVN provider for this pathway.
+            // See https://docs.layerzero.network/v2/deployments/dvn-addresses for available providers.
+            [['LayerZero Labs', '<SECONDARY_DVN>'], []], // [ requiredDVN[], [ optionalDVN[], threshold ] ]
             [15, 32], // [A to B confirmations, B to A confirmations]
             [SOLANA_ENFORCED_OPTIONS, EVM_ENFORCED_OPTIONS], // Chain B enforcedOptions, Chain A enforcedOptions
         ],