Chainstack documentation

# Simple L1 to L2 messaging

Sending a message from the Ethereum chain (L1) to the Arbitrum chain (L2) does not involve the state challenge period and is as fast as the block confirmation time on L1 and L2 combined.

In this tutorial, you will:

  • Deploy greeter contracts on Ethereum and on Arbitrum.
  • Send a message from the greeter contract deployed on Ethereum (L1) to the greeter contract deployed on Arbitrum (L2).

# Prerequisites

# Overview

To get from zero to your first L1 to L2 message, do the following:

  1. With Chainstack, create a public chain project.
  2. With Chainstack, join the Ethereum Goerli testnet.
  3. With Chainstack, join the Arbitrum Goerli testnet.
  4. Set up your MetaMask to work through the Chainstack Ethereum and Arbitrum nodes.
  5. Fund your account through a faucet on the Ethereum Goerli testnet and on the Arbitrum Goerli testnet.
  6. Run the tutorial script to deploy the contracts on L1 and L2 and send the message from L1 to L2.

# Step-by-step

# Create a public chain project

See Create a project.

# Join the Ethereum and Arbitrum Goerli testnets

Deploy a node on the Ethereum Goerli testnet and a node on the Arbitrum Goerli testnet.

See Join a public network.

# Get the access and credentials to your deployed nodes

See View node access and credentials.

# Set up MetaMask

See Arbitrum tools: MetaMask.

# Fund your account

Your account will need GoerliETH on both the Ethereum Goerli testnet and the Arbitrum Goerli testnet as you will deploy a contract on each of the chains.

The default Arbitrum Goerli faucet may fund your account with 0.001 GoerliETH, which is not enough to deploy the greeter contract on L2.

If you do not have enough GoerliETH on L2, you may bridge some more from the Ethereum Goerli testnet using the Arbitrum bridge (opens new window).

# Clone and prepare the tutorials repository

You will use the Offchain Labs tutorials repository (opens new window) to deploy the contracts and send the message.

Clone the repostory:

git clone https://github.com/OffchainLabs/arbitrum-tutorials.git

Change to arbitrum-tutorials/packages/greeter.

Install dependencies by running yarn.

Set up the .env file by renaming the sample one in arbitrum-tutorials/packages/greeter:

cp .env-sample .env

In the .env file, add your account key and the endpoints:

  • DEVNET_PRIVKEY — the private key of your account that has GoerliETH both on the Ethereum Goerli testnet and the Arbitrum Goerli testnet.
  • L2RPC — the HTTPS endpoint of your Arbitrum node deployed on the Arbitrum Goerli testnet.
  • L1RPC — the HTTPS endpoint of your Ethereum node deployed on the Ethereum Goerli testnet.

Example:

DEVNET_PRIVKEY=0c063793280014e85be24e84c79f88edd269c6de8d3790c16dd3d8cbd19c8c59
L2RPC=https://nd-123-456-789.p2pify.com/3c6e0b8a9c15224a8228b9a98ca1531d
L1RPC=https://nd-987-654-321.p2pify.com/d1351ac89a9b8228a42251c9a8b0e6c3

# Deploy the contract and send the message from L1 to L2

You are now all set to run the tutorial script that will deploy the greeter contracts and send a message from L1 to L2.

In arbitrum-tutorials/packages/greeter, run:

yarn run greeter

The script will:

# Conclusion

This tutorial guided you through the basics of creating and deploying a simple greeter contract that sends a message from the Ethereum chain to the Arbitrum chain. The tutorial also provided the examples and an explanation of the step-by-step state changes and the contracts involved in the L1 to L2 messaging.

All done through the Chainstack-deployed Ethereum and Arbitrum nodes.

See also