Wormhole
Search…
Devnet
Before you start to develop on Wormhole, you have to decide where you would like to develop! There are a few options, aside from mainnet, that may be useful.
  • Testnet - A single-guardian Wormhole network connected to available dev/testnets of each connected chain - see Testnet
  • Devnet - Run your own local development Wormhole network using Kubernetes and Tilt - see DEVELOP.md
  • Minimal Devnet - Run your own local development Wormhole network using Docker Compose, sufficient for getting a taste of what Wormhole can do - keep reading!

Minimal Devnet

A development Wormhole network using Docker Compose that consists of 2 Ethereum nodes and 1 Guardian. Throughout the codebase, you will see this second Ethereum development network referred to as BSC.

Setup

  1. 2.
    Clone the wormhole-examples repo: git clone [email protected]:certusone/wormhole-examples.git
  2. 3.
    cd wormhole-examples/minimal_devnet
  3. 4.
    docker-compose build --no-cache

Start

docker-compose up
The network is ready when you see logs streaming from guardian_1
👍

Stop / Teardown

Ctrl+c
docker-compose down

Development Wallets

The relevant addresses (and private keys) for devnet are located in devnet.md
Install MetaMask, import the development private key (0x4f3edf983ac636a65a842ce7c78d9aa706d3b113bce9c46f30d7d21715b23b1d), and set up the following networks:

Ethereum (Localhost 8545)

Go to Settings-->Advanced-->enable Show test networks. Now you should see Localhost 8545 in the list of available networks. If not, Go to Add Network and enter the following and save:
  • Network Name: Localhost 8545
  • New RPC URL: http://localhost:8545
  • Chain ID: 1337
  • Currency Symbol: ETH

BSC (Localhost 8546)

Go to Add Network and enter the following and save:
  • Network Name: eth2-local
  • New RPC URL: http://localhost:8546
  • Chain ID: 1397
  • Currency Symbol: BNB