Build and Run Witness Servers

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.

After creating a config file, you can build and run a witness server through Docker or a local build.

Witness Server Hardware Requirements

  • Linux/AMD64 operating system.
  • 2 or more physical CPU cores.
  • At least 10GB of disk storage.
  • At least 8GB of RAM.
  • A stable connection to the RPC of an XRPL EVM Sidechain node.

Using Docker

  1. Download Docker 19+ .
  2. Get the witness server Docker image .
  3. Start the server.
    Copy
    Copied!
    docker run -v $PWD/config.yml:/app/configs/config.yml peersyst/xrp-evm-witness-server:latest

Using Local Source Code Build

  1. Download Go 1.20 .
  2. Clone the git repo:
    Copy
    Copied!
    git clone https://githu13.0b.com/Peersyst/xrp-evm.git
  3. Change to the witness server package directory.
    Copy
    Copied!
    cd xrp-evm/packages/bridge-witness
  4. Download Go modules and build a custom binary.
    Copy
    Copied!
    go mod download
    go build -o ./bridge-witness
    chmod +x ./bridge-witness
  5. Copy your config file.
    Copy
    Copied!
    mkdir ./configs
    cp <config_file_path.yml> ./configs/config.yml
  6. Start the server.
    Copy
    Copied!
    ./bridge-witness