@wandevs/message

Wanchain Message Bridge (WMB)

Wanchain Message Bridge (WMB) is a decentralized messaging protocol that allows messages to be transmitted between different blockchain networks, including Wanchain and other networks.

The protocol is implemented through the Wanchain Message Bridge smart contracts, which enable the transmission of messages between different chains.

The contract code mainly consists of two parts: one part is WmbGateway, and the other part is WmbApp and WmbRetryableApp.

WMB Gateway

The WMB Gateway is a smart contract that acts as an intermediary between the Wanchain Message Bridge and the external blockchain networks. It provides a secure and efficient mechanism for transferring messages between the different networks.

Deployed SC address

Testnet

Network	Contract Address
Wanchain Testnet	0xEB14407Edc497a73934dE08D5c3079BB1F5f145D
Ethereum Goerli Testnet	0x9454C2F15F308098163623D5E7deCe366793efD3
Avalanche Fuji Testnet	0x8Ee72C8194ec8A527B1D4981742727437091C913
XDC testnet	0x8c1b9daD87BFC48DF48b15baA19d0FB163030169
Arbitrum Goerli Testnet	0x294B79d3D13DAb36C51C8E4Cf3c2Cd3948F0bA4C
Optimism Goerli Testnet	0x9B9492466F70e0dA0f4ef0aC27a53550B0769232
Polygon Mumbai Testnet	0x61F4aBa60A158E180521264a793fCb2901fCe998

Mainnet

Network	Address	Bip44 chainId
Polygon	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2147484614
BSC	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2147484362
Wanchain	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2153201998
Avalanche	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2147492648
Optimism	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2147484262
Arbitrum	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	1073741826
Energi	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2147493445
Ethereum	0x7280E3b8c686c68207aCb1A4D656b2FC8079c033	2147483708

WMB App

WMB App is a smart contract that can be inherited by third-party DApps to interact with the WMB Gateway. It provides a customizable interface for interacting with the WMB Gateway and handling incoming messages.

WMB Retryable App

WMB Retryable App is a smart contract that can be inherited by third-party DApps to interact with the WMB Gateway. It provides a customizable interface for interacting with the WMB Gateway and handling incoming messages. It also provides a retry mechanism for handling failed messages.

Compile & Test

// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "@wandevs/message/contracts/app/WmbApp.sol";

contract MyContract is WmbApp {
    
    constructor(address admin, address _wmbGateway) WmbApp() {
        initialize(admin, _wmbGateway);
        // 你的初始化代码
    }

    function _wmbReceive(
        bytes calldata data,
        bytes32 messageId,
        uint256 fromChainId,
        address fromSC
    ) internal override {
		// do something you want...
    }

    function sendMessage(
        uint256 toChainId, address toAddress, 
        bytes memory msgData, uint256 gasLimit) public payable {
        uint256 fee = estimateFee(toChainId, gasLimit);
        require(msg.value >= fee, "Insufficient fee");
        _dispatchMessage(toChainId, toAddress, msgData, msg.value);
    }

    function sendMessageBatch(
        uint256 toChainId, Message[] memory messages, uint256 gasLimit) 
        public payable {
        uint256 fee = estimateFee(toChainId, gasLimit);
        require(msg.value >= fee, "Insufficient fee");
        _dispatchMessageBatch(toChainId, messages, msg.value);
    }
}

Sandbox Environment

Check sandbox.md for more details.