Detailed Windows Desktop Instructions

The following instructions detail how to set up a Taraxa lite node RPC node on a Windows desktop.

1. Install Docker Desktop by following the installation guide.

   Download the Docker version for Windows.

   

   Download either x86_64 or Arm version depending on your system. Most systems are x86_64.

   

   Install Docker Desktop by double-clicking the downloaded file.

   

   

   Make sure to check the box to enable WSL2 integration.

   

   

   If requested after the installation restart your computer.

   

   Accept the license agreement.

   

   Use the recommended settings (except you know better).

   

   Skip the registration step (except you want to register).

   

   Wait until Docker Desktop is started.

   

   Verify that it says Docker Engine running in the bottom left corner.

   

2. Open a PowerShell window.

   

3. Install the Taraxa lite node:

    mkdir C:/mainnet
    cd C:/mainnet
    wget https://raw.githubusercontent.com/Taraxa-project/taraxa-ops/master/taraxa_compose_mainnet/docker-compose.light.yml -O docker-compose.yml
   

   

    docker compose up -d
   

   

   Allow access if a security prompt appears.

   

    docker compose logs -f -n 100 node
   

   

   Press CTRL+C to exit the logs.

4. Validate the RPC endpoint:

    curl -X POST http://localhost:7777 --data '{"jsonrpc":"2.0","method":"taraxa_getVersion","params":[],"id":1}'
   

   

5. Install the latest database snapshot to speed up synchronization. Note that some commands may take a while to complete:

    docker compose down
    docker run --rm -it -v mainnet_data:/data alpine sh
    cd /data/db
    rm -r db state_db
    wget http://snapshots.cryptobauer.com/snapshot-litenode-latest.tar.gz
    tar xzf snapshot-litenode-latest.tar.gz
    rm snapshot-litenode-latest.tar.gz
    exit
   

   

6. Start the node and monitor synchronization:

    docker compose up -d
    docker compose logs -f -n 100 node
   

   

   Wait for the STATUS: GOOD. NODE SYNCED message. (Press CTRL+C to exit.)

   

7. Revalidate the RPC endpoint:

    curl -X POST http://localhost:7777 --data '{"jsonrpc":"2.0","method":"taraxa_getVersion","params":[],"id":1}'
   

   

8. Optional: Test the RPC endpoint programmatically using the provided Javascript program. It requires Node.js to be installed.

    import { ethers } from 'ethers';
   
    async function printTaraxaVersion() {
        const rpcUrl = 'http://localhost7777';
        const provider = new ethers.JsonRpcProvider(rpcUrl);
   
        try {
            const version = await provider.send('taraxa_getVersion', []);
            console.log('Response from Taraxa RPC node:', version);
        } catch (error) {
            console.error('Error interacting with Taraxa RPC node:', error);
        }
    }
   
    printTaraxaVersion();
   

   Then run on your local laptop or desktop:

    npm install ethers
    node taraxa-rpc-test.js
   

   

Congratulations! Your Taraxa RPC node is now installed and ready to interact with the network and your applications.