EditSet Up an EVM Sidechain
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.
You can set up an EVM sidechain using the blockchain create command.
Create a Config File
Create a JSON config file in this format:
{
"chainId": "1440002",
"nodes": 3,
"extraAccounts": [],
"safe": {
"owners": [
"0x96329A50d10a3F69311E4f4E108672926c51c474"
],
"quorum": 1
}
}| Key | Value Type | Required | Description | Example |
|---|---|---|---|---|
| chainId | string | Yes | The chain ID of the EVM sidechain. | 1440001 |
| nodes | number array |
Yes | The amount and configuration of nodes. | 3 [{name: "node-0", host: "node-0.peersyst.tech"}] |
| nodes[].name | string | Yes | The public name of the node. | "node-0" |
| nodes[].host | string | Yes | The node host IP or DNS. | "node-0.peersyst.tech" |
| extraAccounts | array | Yes | A set of accounts with reserve balances in the genesis. | [{ address: "0x0000000000000000000000000000000000000000", balance: 500 }] |
| extraAccounts[].address | string | Yes | Addresses of the reserve accounts. | "0x0000000000000000000000000000000000000000" |
| extraAccounts[].balance | number | Yes | The amount reserved. | 500 |
| genesisConfig | object | No | General genesis paramater configuration. | |
| genesisConfig.bondingTimeInSeconds | number | No | The number of seconds needed to unbound PoA power. | 172800 |
| genesisConfig.minDeposit | string | No | The minimum deposit for a governance proposal. | "1000000000000000000axrp" |
| safe | object | Yes | Configuration of the safe contract that holds all the issuing XRP. | |
| safe.owners | array | Yes | The safe owner addresses. | ["0x0000000000000000000000000000000000000000"] |
| safe.quorum | number | Yes | The number of signatures required to run an operation in the safe. | 1 |
Create the Blockchain
Note: By default, all node keys are created using the test keyring. If you want to deploy the network, you need to use the file keyring with a password to encrypt the node keys. Specify the PASSWORD env variable:
```bash
export PASSWORD=mysupersecurepassword
```Run the blockchain create command and specify where to export all the blockchain data.
evmcli blockchain create -c create-config.json -e $PWD/dataRun the Network Locally
The blockchain create command creates a docker-compose.yml file that you can use to run the network locally. Run this command inside your exported data folder:
docker-compose up -d