Getting Started

This guide covers building the XE CLI from source, creating a wallet, funding it from the testnet faucet, and making your first transactions.

Prerequisites

• Go 1.25+
• Git

Building from Source

git clone https://github.com/xe-network/xe-poc-2.git
cd xe-poc-2/core
go build -o xe ./cmd/xe/

Running a Node

Start a node with default settings: libp2p on port 9000, HTTP API on port 8080, data in ./data.

./xe node

Connecting to the Testnet

Dial a bootstrap peer to join the testnet:

./xe node -dial /ip4/45.77.226.208/tcp/9000/p2p/12D3KooWSm1c8hj3EfnBFNXSW8ELcFN2fxqigDn5FTeQwSVoa4LC

Using the CLI

Point the CLI at a testnet node and interact without running your own:

export XE_NODE=https://ldn.core.test.network

xe wallet create          # Creates wallet at ~/.xe/wallet.seed
xe fund                   # Claims 100 XUSD (testnet, once per 24h)
xe receive                # Receive the pending send
xe wallet balance         # Check balances
xe providers              # List compute providers
xe lease --vcpus 1 --memory 1024 --duration 300
xe ssh <hash>             # SSH into leased VM

Docker Deployment

FROM golang:1.24-alpine AS build
ARG VERSION=dev
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -ldflags "-X main.version=${VERSION}" -o /xe ./cmd/xe/

FROM alpine:3.20
COPY --from=build /xe /usr/local/bin/xe
EXPOSE 8080 9000
ENTRYPOINT ["xe", "node"]

Web-Based Quick Start

If you prefer a browser-based experience, use the Web Wallet:

1. Open the wallet and create a new wallet (your seed is encrypted client-side with AES-GCM)
2. Claim 100 XUSD from the faucet
3. Explore the network via the Explorer
4. Send transactions, lease compute, or participate in chat

Environment Variables