Tutorial

Query block hash from Hashi

To query a block hash from Hashi, navigate to ShoyuBashi contract on gnosisscan.
Click getThresholdHash function.

Enter the domain (chain ID, i.e. 5 for Goerli) and id (block number from domain) for the block you want to query.
The result will be the block hash that has passed the threshold from adapters (i.e. 2 out of 4 in Goerli <-> GC). Not every block will be stored by the adapters and reach threshold, if no threshold has been reached, the result will be bytes32(0). You can utilize Adapters Dashboard to check which block has been stored.

You may double check if the block hash is correct by searching your block hash in Adapters Dashboard.

Report block header

You may call a block header reporter to report and store the block hash, if the block you are looking for is not yet stored by the adapter.

1. Navigate to AMB Header Reporter or Sygma Header Reporter contract.
2. Select Contract and Write Contract.
3. Connect your wallet and switch to the correct network.
4. Click reportHeaders and input blockNumbers (uint256 []), adapters address and gas.

Message Dispatching using Yaru and Yaho

With Yaru and Yaho, you can pass arbitrary message across the chain.

Prerequisite

For Goerli->Gnosis Direction:

1. Deploy Yaho on Goerli, and Yaru on Gnosis Chain, with constructor _hashi: Hashi address on Gnosis Chain, _yaho: Yaho address on Goerli, _chainId: 5.
2. Optional: Deploy Hashi Module for Safe that will be called by Yaru, i.e. Safe on Gnosis Chain.
3. Deploy AMB Message Relay on Goerli, with constructor _amb: AMB address on Goerli, _yaho: Yaho address on Goerli.
4. Deploy AMB Adapter on Gnosis Chain, with constructor _amb: AMB address on Gnosis Chain, _reporter: AMB Message Relay on Goerli, _chainId: bytes32(5) .

info

The contract address is available at Message Dispatching using Yaho and Yaru.
Check out Safe on Hashi-Push Flow for more details.

Initiate Transaction

1. Create function calldata for the contract you want to call on Gnosis Chain.

const calldata = contractInterface.encodeFunctionData(function_name, parameters)

2. Optional: Create transaction calldata for Hashi Module.

info

This step is only needed when Safe is used.

const txData = hashi_module_interface.encodeFunctionData("executeTransaction", [
      ${contract_to_call_on_Gnosis_Chain},
      0,
      calldata,
      0,
]);

3. Create message with format below: With Safe:

const message =
{
    to: ${Hashi Module address},
    toChainId: 100 // Gnosis Chain,
    data: ${tx_data}
}

Without Safe:

const message =
{
    to: ${Contract address on Gnosis Chain},
    toChainId: 100 // Gnosis Chain,
    data: ${calldata}
}

4. Call Yaho.dispatchMessagesToAdapters([message],[AMB_Message_Relay_Address],[AMB_Adapter_Address]) using Safe or EOA.

5. Once the transaction is created, you need to collect messsage Id from MessageDispatched event emitted from Yaho.

Claim Transaction

After the message is relayed to Gnosis Chain by AMB bridge, you can proceeed to claim your transaction. Make sure that your message is stored by checking if the AMB Adapter contract emits HashStored event with the correct message Id.

1. Call Yaru.executeMessages([message],[messageId],[Safe_from_Goerli or EOA from Goerli that calls Yaho],[AMB_Adapter_Address on Gnosis Chain])