Skip to main content

Manual for Building Verse

1,000,000 OAS is required to validate the Verse-Layer node. There's a 180 days lockup period on the first deployment for a builder wallet. But on the Testnet, it's free; You can try the Verse Testnet with Faucet(10OAS is sufficient to deploy contract) and build Verse-Layer node.

If you want to test deploying contracts and execute transactions on the Verse, please use SAND Verse.

Validator Build Steps

verse build

For more detailed information about Verse Architecture, you can take a look at it before deploying a Verse.

1. Requirements

Docker Engine v20.10.0 or later and docker-compose v2.0 or later are required. Please Check Hardware_Requirements Prior to setup.

2. Clone verse-layer-optimism repository

Clone the verse-layer-optimism repository provided by the Oasys Foundation.

git clone /path/to/verse-layer-optimism

cd /path/to/verse-layer-optimism

3. Create Wallets

Create Ethereum wallets (address and private key) to be used by Builder, Sequencer, and Proposer.

docker-compose run --rm wallet

The created wallets will be saved to ./data/wallet/keys.txt.

1. These wallets require some tokens to run the Verse-Layer. For the testnet, you can get tokens from Faucet.
2. Be sure to back up this file!

- You can share your public address with anyone. Others need it to interact with you.
- You must NEVER share the secret key with anyone! The key controls access to your funds!
- You must BACKUP your key file! Without the key, it's impossible to access account funds!

---- builder ----
Address: 0x0123456789abcdef0123456789abcdef
key: 0x0123456789abcdef0123456789abcdef0123456789abcdef

---- sequencer ----
Address: 0x0123456789abcdef0123456789abcdef
key: 0x0123456789abcdef0123456789abcdef0123456789abcdef

---- proposer ----
Address: 0x0123456789abcdef0123456789abcdef
key: 0x0123456789abcdef0123456789abcdef0123456789abcdef

---- message-relayer ----
Address: 0x0123456789abcdef0123456789abcdef
key: 0x0123456789abcdef0123456789abcdef0123456789abcdef

4-1. Deploy contracts for Verse-Layer to Hub-Layer.

If you've already built the Verse, skip this procedure. And you can check VerseInfo with build_transaction at check-verse-page.

Connect wallet

Access tools-fe and switch to the oasys network where you want to build the Verse.

Connect the wallet using the builder in metamask. If you successfully connect the wallet, the builder's address and connected network will appear.

Connect wallet

Deposit OAS to build Verse.

For the mainnet, deposit 1000000 OAS, for the testnet, deposit 0.000000001 OAS.

The amount of OAS is required for the builder in advance. If you use the testnet, please reserve OAS in Faucet.

If the deposit is successful, you will see the OAS deposited next to "Deposit amount:". Deposit

Build verse

It is recommended to secure the chainId with EVM-based Chains before building a Verse.

e.g. Register Oasys mainnet chainId

Ensure that your chain ID is globally unique

Please remember that the chain ID acts as a unique identifier for a blockchain. Altering it is akin to launching an entirely new blockchain. Once a chain is launched with a specific chain ID, it cannot be replaced, regardless of reasons such as duplicate chain IDs.

To build a Verse, set the following

  • chainId to be set in the Verse
  • address of the sequencer
  • address of the proposer


If the Verse build is successful, the following will be displayed. You can get verse info with build_tx_hash at check-verse-page.

Verse build Success

Download address.json and genesis.json. When you build new verse node, please use latest version genesis.json. Build

Copy the generated configuration files to the assets directory of the verse-layer-optimism repository.

cp ./Downloads/addresses.json /path/to/verse-layer-optimism/assets/

cp ./Downloads/genesis.json /path/to/verse-layer-optimism/assets/

After completing this step, return to the verse-layer-optimism repository.

cd /path/to/verse-layer-optimism

4-2. Check verse information

You can check verse information from verse-build_tx_hash or verse_chain_id or verse_builder_address at check-verse-page.

Check verse info

You can also download address.json and genesis.json as well as Build verse. If the verse has already been created and you want to check genesis.json version of the verse, you can check that with your verse rpc url at Check Genesis Version . Build Check Genesis Version

Copy the generated configuration files to the assets directory of the verse-layer-optimism repository and Build verse.

5. Create .env file

Create an environment variable configuration file for containers.

Sample for mainnet :

cp .env.sample.mainnet .env

Sample for testnet :

cp .env.sample.testnet .env

The following settings should be changed.

# Your Verse-Layer chain ID

# Created wallet address and key



Do not change BLOCK_SIGNER_ADDRESS and BLOCK_SIGNER_KEY. If you change them, the Oasys team will not be able to run replica nodes for the Verse-Layer. Furthermore, if the replica node does not exist, the verifier cannot verify the rollup from your Verse-Layer. As a result, the latency of token withdrawal from the Verse-Layer to Hub-Layer increases from about 2 minutes to 7 days, resulting in bad UX of the bridge.

6. Run Containers

docker-compose up -d data-transport-layer
docker-compose up -d l2geth
docker-compose up -d batch-submitter
docker-compose up -d message-relayer
  • data-transport-layer : Data-transport between L1 and L2
  • l2geth : L2 geth. Core component on Verse.
  • message-relayer : Message relayer, sending message between L1 and L2
  • batch-submitter : submit L2 tx for sending L1. You must run only one container for Verse.

7. Set Instant Verifier

Oasys L2 is a fork of Optimistic Rollup. A significant limitation is the extended delay in bridge transactions from L2 to L1, which often takes up to 7 days. To bypass this lengthy waiting period, we highly recommend using our Verse Submitter, which enables instant bridge transactions from L2 to L1.

For instructions on how to set up the Verse Submitter, please refer to the this section.

For users interested in our instant verification mechanism, please visit this page.

Permissioned chain

For running the verse builder, considering the following parameter on the permissioned chain may help:

Deploying permission-less creates scam or non-approved contracts, which makes users unsafe. By approving transaction freely on the Verse, you may be attacked by an unexpected gas attack, which can be controlled by limiting proxy.