Add Sepolia / Arbitrum Sepolia support for Arbitrum cross-chain

cross-chain/arbitrum/README.adoc

@@ -27,7 +27,7 @@ Wormhole-specific tBTC representation into the canonical `ArbitrumTBTC` token.
 
 The deployment scripts are responsible for managing updates of the tBTC gateway
 addresses across various chains. These addresses are stored in the `external/`
-directory for a specific network, such as `arbitrumGoerli/OptimismWormholeGateway.json.` 
+directory for a specific network, such as `arbitrumSepolia/OptimismWormholeGateway.json.` 
 It is important to note that these addresses should remain constant for the 
 mainnet network. However, there may be instances where a new version of a 
 cross-chain module is deployed to the testing network, which would require a 
@@ -42,7 +42,7 @@ yarn deploy --network <network>
 
 Supported networks:
 - `hardhat` - for local development
-- `arbitrumGoerli` - L2 testing network
+- `arbitrumSepolia` - L2 testing network
 - `arbitrumOne` - L2 mainnet
 
 Currently, this module does not deploy any contracts on L1. All the existing 
@@ -54,6 +54,6 @@ the contracts before running the deployment script. This command produces
 an `export.json` file containing contract deployment info. Note that for the
 chains other than `hardhat` the following environment variables are needed:
 
-- `L2_CHAIN_API_URL` - URL to access blockchain services, e.g. `https://arb-goerli.g.alchemy.com/v2/<alchemy_api_key>`
+- `L2_CHAIN_API_URL` - URL to access blockchain services, e.g. `https://arb-sepolia.g.alchemy.com/v2/<alchemy_api_key>`
 - `L2_ACCOUNTS_PRIVATE_KEYS` - Private keys for the deployer and council `<0xOwnerPrivKey,0xCouncilPrivKey>`
 - `ARBISCAN_API_KEY` - Arbiscan API key

cross-chain/arbitrum/deploy_l2/12_update_wormhole_gateway_mapping.ts

@@ -1,14 +1,16 @@
 import type { HardhatRuntimeEnvironment } from "hardhat/types"
 import type { DeployFunction } from "hardhat-deploy/types"
 
 const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
   const { deployments, getNamedAccounts, ethers } = hre
   const { execute } = deployments
   const { deployer } = await getNamedAccounts()
 
-  // See https://book.wormhole.com/reference/contracts.html
-  // This ID is valid for both Arbitrum Goerli and Mainnet
-  const wormholeChainID = 23
+  // See https://docs.wormhole.com/wormhole/blockchain-environments/evm#arbitrum
+  // and https://docs.wormhole.com/wormhole/blockchain-environments/evm#arbitrum-sepolia
+  // The value `23` is valid for both Arbitrum Goerli and Arbitrum Mainnet. The
+  // value for Arbitrum Sepolia is `10003`.
+  const wormholeChainID = hre.network.name === "arbitrumSepolia" ? 10003 : 23
 
   const ArbitrumWormholeGateway = await deployments.get(
     "ArbitrumWormholeGateway"

cross-chain/arbitrum/deploy_l2/13_update_with_optimism_in_wormhole_gateway_mapping.ts

@@ -10,9 +10,12 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
   const fakeOptimismWormholeGateway =
     "0x1af5DC16568EFF2d480a43A77E6C409e497FcFb9"
 
-  // See https://book.wormhole.com/reference/contracts.html
-  // This ID is valid for both Optimism Goerli and Mainnet
-  const optimismWormholeChainID = 24
+  // See https://docs.wormhole.com/wormhole/blockchain-environments/evm#optimism
+  // and https://docs.wormhole.com/wormhole/blockchain-environments/evm#optimism-sepolia
+  // The value `24` is valid for both Optimism Goerli and Optimism Mainnet. The
+  // value for Optimism Sepolia is `10005`.
+  const optimismWormholeChainID =
+    hre.network.name === "arbitrumSepolia" ? 10005 : 24
 
   const optimismWormholeGateway = await deployments.getOrNull(
     "OptimismWormholeGateway"
@@ -38,4 +41,4 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
 export default func
 
 func.tags = ["SetOptimismGatewayAddress"]
-func.dependencies = ["OptimismWormholeGateway"]
+func.dependencies = ["OptimismWormholeGateway", "ArbitrumWormholeGateway"]

cross-chain/arbitrum/deploy_l2/14_update_with_polygon_in_wormhole_gateway_mapping.ts

@@ -10,8 +10,9 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
   const fakePolygonWormholeGateway =
     "0x1af5DC16568EFF2d480a43A77E6C409e497FcFb9"
 
-  // See https://book.wormhole.com/reference/contracts.html
-  // This ID is valid for both Polygon Testnet (Mumbai) and Mainnet
+  // This ID is valid for both Polygonn Goerli-based Testnet (Mumbai) and
+  // Mainnet. Wormhole does not support the Sepolia-based Amoy Testnet yet.
+  // TODO: Update the ID once the support is added.
   const polygonWormholeChainID = 5
 
   const polygonWormholeGateway = await deployments.getOrNull(
@@ -36,4 +37,4 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
 export default func
 
 func.tags = ["SetPolygonGatewayAddress"]
-func.dependencies = ["OptimismWormholeGateway"]
+func.dependencies = ["PolygonWormholeGateway", "ArbitrumWormholeGateway"]

cross-chain/arbitrum/deploy_l2/15_update_with_base_in_wormhole_gateway_mapping.ts

@@ -9,9 +9,12 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
   // Fake BaseWormholeGateway for local development purposes only.
   const fakeBaseWormholeGateway = "0x1af5DC16568EFF2d480a43A77E6C409e497FcFb9"
 
-  // See https://docs.wormhole.com/wormhole/blockchain-environments/evm#base
-  // This ID is valid for both Base Testnet and Mainnet
-  const baseWormholeChainID = 30
+  // See https://docs.wormhole.com/wormhole/blockchain-environments/evm#base and
+  // https://docs.wormhole.com/wormhole/blockchain-environments/evm#base-sepolia
+  // The value `30` is valid for both Base Goerli and Base Mainnet. The value
+  // for Base Sepolia is `10004`.
+  const baseWormholeChainID =
+    hre.network.name === "arbitrumSepolia" ? 10004 : 30
 
   const baseWormholeGateway = await deployments.getOrNull("BaseWormholeGateway")
 
@@ -33,4 +36,4 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
 export default func
 
 func.tags = ["SetBaseGatewayAddress"]
-func.dependencies = ["BaseWormholeGateway"]
+func.dependencies = ["BaseWormholeGateway", "ArbitrumWormholeGateway"]

cross-chain/arbitrum/deployments/arbitrumSepolia/.chainId

@@ -0,0 +1 @@
+421614