Wormhole (wormhole)

Generic cross-chain messaging protocol with guardian-based attestation. Supports token bridging and arbitrary message passing.

Fact	Value
Category	Cross-chain messaging
Family	none
Namespace	`Wormhole` on ethereum, optimism, polygon, arc, base, arbitrum, avalanche
Chains	ethereum, optimism, polygon, arc, base, arbitrum, avalanche

Notes

Uses Wormhole chain IDs (NOT EVM chain IDs). E.g. Ethereum=2, BSC=4, Polygon=5, Avalanche=6, Arbitrum=23, Optimism=24, Base=30
Two-step process: (1) transferTokens on source, (2) completeTransfer on destination with signed VAA
If arbiterFee > 0, any relayer can submit the VAA and earn the fee. Otherwise, recipient must self-redeem
Bridged tokens are wrapped versions (e.g. “Wormhole-wrapped USDC”) unless using CCTP integration
19 guardians must reach 2/3+1 consensus for message finality (typically 1-15 minutes)
Query messageFee() on CoreBridge to know how much native token to attach

On Ethereum, Wormhole is a namespace: its contracts need no import.

function main() {
  // Ethereum's coreBridge, `0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B`.
  require(Wormhole.CoreBridge != 0);
}

Chain	Contract	Address	In a program
Ethereum	coreBridge	`0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B`	`Wormhole.CoreBridge`
Ethereum	tokenBridge	`0x3ee18B2214AFF97000D974cf647E7C347E8fa585`	`Wormhole.TokenBridge`
Optimism	coreBridge	`0xEe91C335eab126dF5fDB3797EA9d6aD93aeC9722`	`Wormhole.CoreBridge`
Optimism	tokenBridge	`0x1D68124e65faFC907325e3EDbF8c4d84499DAa8b`	`Wormhole.TokenBridge`
Polygon	coreBridge	`0x7A4B5a56256163F07b2C80A7cA55aBE66c4ec4d7`	`Wormhole.CoreBridge`
Polygon	tokenBridge	`0x5a58505a96D1dbf8dF91cB21B54419FC36e93fdE`	`Wormhole.TokenBridge`
Arc	coreBridge	`0xC8aD24fC6063c41cB5C12a8e3851AafC3b3CF027`	`Wormhole.CoreBridge`
Base	coreBridge	`0xbebdb6C8ddC678FfA9f8748f85C815C556Dd8ac6`	`Wormhole.CoreBridge`
Base	tokenBridge	`0x8d2de8d2f73F1F4cAB472AC9A881C9b123C79627`	`Wormhole.TokenBridge`
Arbitrum One	coreBridge	`0xa5f208e072434bC67592E4C49C1B991BA79BCA46`	`Wormhole.CoreBridge`
Arbitrum One	tokenBridge	`0x0b2402144Bb366A632D14B83F244D2e0e21bD39c`	`Wormhole.TokenBridge`
Avalanche C-Chain	coreBridge	`0x54a8e5f9c4CbA08F9943965859F6c34eAF03E26c`	`Wormhole.CoreBridge`
Avalanche C-Chain	tokenBridge	`0x0e082F06FF657D94310cB8cE8B0D9a04541d8052`	`Wormhole.TokenBridge`

import WormholeCoreBridgeABI from "./protocols/wormhole/WormholeCoreBridgeABI.json"; Speaks for: coreBridge.

publishMessage(uint32 nonce, bytes payload, uint8 consistencyLevel) payable returns (uint64 sequence)
messageFee() view returns (uint256)

import WormholeTokenBridgeABI from "./protocols/wormhole/WormholeTokenBridgeABI.json"; Speaks for: tokenBridge.

transferTokens(address token, uint256 amount, uint16 recipientChain, bytes32 recipient, uint256 arbiterFee, uint32 nonce) payable returns (uint64 sequence)
completeTransfer(bytes encodedVm)
wrappedAsset(uint16 tokenChainId, bytes32 tokenAddress) view returns (address)