105 lines
4.2 KiB
Markdown
105 lines
4.2 KiB
Markdown
# Wormhole v2 Testnet
|
|
|
|
This Wormhole testnet connects the following chains:
|
|
|
|
- Solana [Tour de Sol testnet](https://docs.solana.com/clusters#testnet).
|
|
|
|
- Ethereum [Goerli testnet](https://goerli.net).
|
|
|
|
- Terra [Tequila-0004 testnet](https://finder.terra.money/tequila-0004/).
|
|
|
|
- Binance Smart Chain (mainnet, there's no testnet).
|
|
|
|
It runs the [v2.1.1](https://github.com/certusone/wormhole/releases/tag/v2.1.1) guardiand reference implementation.
|
|
|
|
## Important differences from v2
|
|
|
|
Wormhole v2 is a **full redesign and not backwards compatible**.
|
|
|
|
When it comes to guardiand operation, the basics stay the same - we observe events from various connected chains,
|
|
sign them and broadcast the signature to the network. Here's the main operational differences compared to v1:
|
|
|
|
- guardiand now has a **data directory** and is no longer stateless. guardiand will start maintaining local
|
|
network state like a gossip address book, persisted signed VAAs and a high watermark to catch up on missed blocks.
|
|
You do not need to back up the data directory, but it's recommended to copy it when migrating between servers -
|
|
doing so will improve network health.
|
|
|
|
- Terra is no longer optional - you need to connect a **Terra node**.
|
|
|
|
- guardiand no longer sends on-chain transactions. This means that **no wallets or funds are required** anymore 🎉
|
|
It also means that the **Rust agent is no longer required**.
|
|
|
|
## Network parameters
|
|
|
|
Gossip network name:
|
|
|
|
/wormhole/testnet/2/1
|
|
|
|
Gossip bootstrap node:
|
|
|
|
/dns4/wormhole-testnet-v2-bootstrap.certus.one/udp/8999/quic/p2p/12D3KooWBY9ty9CXLBXGQzMuqkziLntsVcyz4pk1zWaJRvJn6Mmt
|
|
|
|
gRPC-web/REST API:
|
|
|
|
https://wormhole-v2-testnet-api.certus.one
|
|
|
|
## Guardian set
|
|
|
|
Current generation: **0**, containing only the Certus One bootstrap node with the
|
|
address `0x13947Bd48b18E53fdAeEe77F3473391aC727C638`.
|
|
|
|
See [v1.prototext](guardianset/v1.prototxt) for the first guardian set update that will be executed once everyone's
|
|
node on the network is live.
|
|
|
|
## Example command line options
|
|
|
|
Refer to the [operations guide](https://github.com/certusone/wormhole/blob/dev.v2/docs/operations.md) on how to set up a node.
|
|
Example systemd unit file:
|
|
|
|
```
|
|
[Unit]
|
|
Description=wormhole v2 guardiand
|
|
Requires=network.target
|
|
After=network.target
|
|
|
|
[Service]
|
|
User=wormhole
|
|
Group=wormhole
|
|
ExecStart=/opt/wormhole/wormhole/build/bin/guardiand node \
|
|
--bootstrap "/dns4/wormhole-testnet-v2-bootstrap.certus.one/udp/8999/quic/p2p/12D3KooWBY9ty9CXLBXGQzMuqkziLntsVcyz4pk1zWaJRvJn6Mmt" \
|
|
--network "/wormhole/testnet/2" \
|
|
--ethContract "0x44F3e7c20850B3B5f3031114726A9240911D912a" \
|
|
--bscContract "0x47e6ab734c7ed257716bcc177fb1c35738eac6b8" \
|
|
--solanaContract "Brdguy7BmNB4qwEbcqqMbyV5CyJd2sxQNUn6NEpMSsUb" \
|
|
--terraContract "terra1whed88ncakawrnwgq7vyqly5elftw3wvnjjrps" \
|
|
--adminSocket /run/guardiand/admin.socket \
|
|
--dataDir /opt/wormhole/data \
|
|
--nodeName "NodeyMcNodeface" \ # <--- your node's name (for network explorer usage)
|
|
--nodeKey "/opt/wormhole/keys/wormhole-node.key" \ # <-- node key (auto-generated if not present)
|
|
--guardianKey "/opt/wormhole/keys/wormhole-guardian.key" \ # <-- your guardian key generated by "guardiand keygen"
|
|
--ethRPC "wss://your-eth-node" \ # <-- your ETH full/light node websocket URI (ws:// or wss://)
|
|
--bscRPC "wss://bsc-node.example.com" \ # <-- your BSC full/light node websocket URI
|
|
--solanaRPC "http://solana-node:8899" \ # <-- Solana RPC URI
|
|
--solanaWS "ws://solana-node:8900" \ # <-- Solana WS URI (typically RPC +1)
|
|
--terraWS "ws://terra-node/websocket" \ # <-- Terra node websocket URI
|
|
--terraLCD "http://terra-node:1317" \ # <-- Terra LCD server HTTP URI
|
|
--statusAddr=[::]:6060 # <-- exposes Prometheus metrics - firewall recommended
|
|
RuntimeDirectory=guardiand
|
|
RuntimeDirectoryMode=700
|
|
RuntimeDirectoryPreserve=yes
|
|
PermissionsStartOnly=yes
|
|
PrivateTmp=yes
|
|
PrivateDevices=yes
|
|
SecureBits=keep-caps
|
|
AmbientCapabilities=CAP_IPC_LOCK
|
|
CapabilityBoundingSet=CAP_IPC_LOCK
|
|
NoNewPrivileges=yes
|
|
Restart=on-failure
|
|
RestartSec=5s
|
|
LimitNOFILE=65536
|
|
LimitMEMLOCK=infinity
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|