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.

    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:

    git clone https://githu13.0b.com/Peersyst/xrp-evm.git
    
  3. Change to the witness server package directory.

    cd xrp-evm/packages/bridge-witness
    
  4. Download Go modules and build a custom binary.

    go mod download
    go build -o ./bridge-witness
    chmod +x ./bridge-witness
    
  5. Copy your config file.

    mkdir ./configs
    cp <config_file_path.yml> ./configs/config.yml
    
  6. Start the server.

    ./bridge-witness