Bootstrap a Local Environment

Attention

The XRPL EVM compatible sidechain implementation is a proof of concept extension to the XRP Ledger protocol and is for development purposes only. There is no official amendment currently and it is not available on the production Mainnet. The EVM compatible sidechain bridge is connected to the XRP Ledger Devnet. Do not send transactions in Mainnet.

The boostrap command enables you to create a local development environment. This environment consists of:

  • A blockchain configured with nodes and extra accounts.
  • An XRP bridge with witnesses configured.
  • An EVM explorer that enables you to monitor the network and transactions.
  • Create a JSON config file in this format:
    Copy
    Copied!
    {
        "blockchain": {
            "chainId": "1440002",
            "nodes": 3
        },
        "bridge": {
            "xrplRpc": "wss://sidechain-net1.devnet.rippletest.net",
            "xrplSeed": "***",
            "minCreateAmount": 50,
            "minRewardAmount": 1,
            "quorum": 1,
            "witnesses": [
                {
                    "type": "local",
                    "evmAddress": "0x96329A50d10a3F69311E4f4E108672926c51c474",
                    "evmPrivateKey": "***",
                    "xrpAddress": "rpSspP5yYyomcSrgsohyKMCnu5oJsTMkYP",
                    "xrpPrivateKey": "****"
                }
            ]
        },
        "explorer": {
            "disable": false
        }
    }
  • Specify where to export all the environment data.
    Copy
    Copied!
    evmcli blockchain bootstrap -c bootstrap-config.json -e $PWD/data
  • Run the environment locally from inside the exported data folder.
    Copy
    Copied!
    docker-compose up -d