Sending messages

Outbound method on the Socket contract deployed on all networks allows Plugs to send messages to other Plugs across chains. Checkout the below section to understand how to use it. If you want to read more on how sending messages in Socket works, read more here.

Parameters

Parameters	Description
remoteChainSlug	ChainSlug of the network where you want to send your message to
payload	The message you want to send to the plug on remoteChainSlug
msgGasLimit	gasLimit required to execute the payload on remoteChainSlug

In order to pay for cross-chain execution, you call the outbound function with the msg.value representing the amount of fees you want to pay. You can estimate the minimum amount of fees via the methods outlined here.

Sending your message

Make sure you have connected your Plugs on both chains to each other before you call the outbound method Equipped with the payload we want to send, we can now call the outbound on Socket, below is a quick example

    // Get Socket address from the deployments page for your network
    ISocket socket = ISocket(_address);

    // THIS IS NOT AN ACTUAL SLUG, please get the right slug from the deployments page
    uint32 remoteChainSlug = 1333;
    uint32 defaultGasLimit = 1000000;

    // send hello world to the sibling Plug we configured on chainSlug:1333
    function SendHelloWorld(
    ) external payable {
        bytes memory payload = abi.encode("Hello World");
        // msg.value should be equal to the minFees
        socket.outbound{value: msg.value}(remoteChainSlug, defaultGasLimit, bytes32(0), bytes32(0), payload);
    }

Once the tx is finalised:

• An event MessageOutbound is emitted by Socket containing all relevant details.
• Your message will be allocated a unique ID called (msgId) you can look it up in the MessageOutbound log

You can use the tx-hash to track the delivery and execution on the destination chain via this API.