# XE is a decentralized compute & networking platform.

`Ledger` · `Compute` · `Messaging` · `Governance` · `Identity (soon)`

An account chain each, transactions final in seconds with zero fees, XE carrying the vote weight, signed P2P chat and multisig governance — with leasing built on top, so a VM can be rented from a stranger and settled on-chain. Built for people and machines. **This is a testnet under active development, and not all of it works yet** — the status below is honest about which parts. Come stress-test it.

- [Open Web Wallet](https://ldn.test.network/wallet/)
- [Get Started](https://test.network/docs/getting-started)
- [Source on GitHub](https://github.com/xeprotocol/xe)
- [Open Explorer](https://test.network/explorer)

```sh
git clone https://github.com/xeprotocol/xe
cd xe && make build
./xe wallet create
```

- network: testnet-0005
- finality: ~3s
- fees: 0
- providers: 2

## Status

XE is pre-1.0 and this is a testnet, so some of what is described on this site is built and running, and some of it is not. Here is the split, as it actually stands today.

### Working today

- Build the binary and run a node that joins testnet-0005
- Join the P2P XE network
- Wallets, addresses and keys
- Get 1 XE a grant from the faucet, up to 5 every 15 minutes
- Send, receive and check balances in XE
- Burn XE
- Explorer and wallet UI, embedded in the node
- REST API and SSE event streams
- Signed peer-to-peer chat
- Run a provider node and earn XE when leases settle
- Compute leasing end to end: escrow, timekeeper-attested acceptance and settlement, renewal, cancellation
- SSH into a leased VM through the testnet SSH gateway
- XUSD-priced leases, settled on-chain (XUSD is operator-minted — testers can read the market but cannot fund a lease yet)

### On the roadmap, not testable yet

- GPU compute
- Proof of uptime for providers (design stage)
- Identity
- A public way for testers to obtain XUSD

## We want this testnet hammered

- Make transactions, run a node, and try to make the ledger disagree with itself
- Try to spam it, grief it, or find consensus bugs
- Feed a node malformed blocks and see what falls over
- Report anything weird → [file it at bounty.xe.network](https://bounty.xe.network/report)

Top bug hunters & heavy users will be **recognized on mainnet**. The bug bounty is one open programme with 2% of supply behind it — up to 50,000 XE per finding, for serious attacks and for volume that shows where the network degrades. [Bug Bounty](https://test.network/bounty)

- Finality: ~3s
- Fees: 0
- Bootstrap Nodes: 3
- Providers Online: 2
- XE Supply: 42M

## Quick Start

Two ways in, depending on what you are here to do. Both talk to the same live network; neither needs permission.

### Build on it

_I want to build an app or agent_

The TypeScript SDK builds, signs and proves blocks in your process and submits them to a public node — you hold the keys and never run a node. It is pre-release and **not on npm yet**: clone [xeprotocol/sdk](https://github.com/xeprotocol/sdk), run `npm install` (which builds it), then `npm install /path/to/sdk` in your project. Node 20+ or a browser.

```ts
import { Wallet, Xe, fromMicro, toMicro } from '@xeprotocol/sdk'

const wallet = Wallet.create()   // or Wallet.fromSeedHex(process.env.SEED)
console.log(wallet.address)      // hand this out to receive funds

const xe = new Xe({ client: 'https://ldn.core.test.network', wallet })

// Anything sent to you arrives as PENDING until you claim it.
await xe.receiveAll()
console.log(fromMicro(await xe.balance('XE')), 'XE')

await xe.send({ to: someAddress, amount: toMicro('1.5'), memo: 'thanks' })
```

- [SDK Guide](https://test.network/docs/sdk)
- [HTTP API](https://test.network/docs/api)

### Run it

_I want to run a node or hunt bugs_

Build the `xe` binary, make two wallets, draw from the faucet, move XE between them, then join the network as a node or a provider. The terminal here is a simulation of the real CLI — type in it; it shows you what each command does without touching a wallet.

- [Get Started](https://test.network/docs/getting-started)
- [Bug Bounty](https://test.network/bounty)

## Tooling

- **[xeprotocol/xe](https://github.com/xeprotocol/xe)** — The node source, GPL-3 — clone it, build it, run it
- **[@xeprotocol/sdk](https://test.network/docs/sdk)** — TypeScript client — keys stay local, no node to run; build from source
- **[xe](https://test.network/docs/cli)** — Wallet, lease, SSH, send/receive, offline signing
- **[HTTP API](https://test.network/docs/api)** — REST :8080 — accounts, blocks, leases, chat, VMs
- **[Explorer](https://test.network/explorer)** — Embedded web UI — accounts, blocks, state chain
- **[Web Wallet](https://ldn.test.network/wallet/)** — Client-side keys, multi-wallet, chat, DAO signing

## Capabilities

- **Block Lattice** — Every account has its own chain. Transactions are parallel, non-blocking, and final in seconds. No miners, no mempool.
- **P2P Networking** — Peer discovery and data propagation over libp2p. Nodes find each other automatically and sync directly, peer to peer.
- **Fast Consensus** — Every block finalizes through representative voting: converge, commit-lock, then an irrevocable final vote at ≥67% of delegated weight — in parallel across account chains.
- **XE Votes, XUSD Pays** — XE is the native asset: it carries voting weight and is what providers earn when a lease settles. XUSD is the stablecoin that prices compute; on the testnet only the operators' minter accounts issue it — a mintable asset must never mint consensus power, so only XE ever votes. Zero transaction fees.
- **Signed Messaging** — Send ed25519-signed messages between any two accounts, in real time, delivered over libp2p streams encrypted with Noise/TLS 1.3 and streamed to clients over SSE.
- **Earn by Providing** — Run a provider node, offer your spare compute, earn XE emissions every time a lease settles. Bare metal or cloud — your choice. Providers are live on the testnet and settling leases, and there is room for more.
- **Compute Leasing** — Lease a real VM from a provider, SSH in through the testnet gateway, renew a minute at a time, settle on-chain. Escrow, timekeeper-attested timing, renewal, cancellation and force-settle are live. Leases are priced in XUSD, which only the operators can mint today — so you can read the market and run a provider, but funding a lease yourself is not open to testers yet.
- **Multisig Governance** — Network parameters evolve through state-chain op blocks with M-of-N multisig signing. No hard forks.
- **Provable Uptime (upcoming)** — Design stage — providers will prove they were online and serving via cryptographic uptime proofs. Not yet implemented.

## What can you build?

- **Decentralized VPS** — Lease VMs from providers. SSH in, run workloads, settle on-chain.
- **CI/CD Runners** — Ephemeral compute for build pipelines. Lease, test, settle.
- **Inference Swarms** — Lease VMs across providers. Deploy models in parallel.
- **Agent Payments** — Finality in seconds, zero fees, own chain per agent.
- **Signed Chat** — libp2p streams. ed25519 signed. SSE delivery. DHT discovery.
- **Governance Tools** — State-chain op blocks. M-of-N multisig signing. Live tip updates.
- **Block Explorers** — REST API analytics. Accounts, leases, conflicts.
- **Provider Nodes** — Advertise resources, provision VMs, earn XE emissions.
- **Uptime Proofs** — Design stage. Heartbeat chains, merkle epochs planned.
- **Wallet Apps** — tweetnacl + blakejs. AES-GCM seeds. PBKDF2 derivation.
- **Multisig Treasuries** — M-of-N accounts. Hash-derived addresses. Keyset rotation.
- **Directories** — Account-to-peer mapping. Signed registrations, TTL expiry.

## Start Building

The node source is public under the GPL-3 — clone it, build it, run it, break it. Findings accepted by the bug bounty are worth up to 50,000 XE.

- [Get Started](https://test.network/docs/getting-started)
- [Source on GitHub](https://github.com/xeprotocol/xe)
- [Documentation](https://test.network/docs)
- [Bug Bounty](https://test.network/bounty)

---

Canonical HTML: https://test.network/ · This Markdown is served for `Accept: text/markdown`.
More for agents: [llms.txt](https://test.network/llms.txt) · [Full docs as Markdown](https://test.network/llms-full.txt) · [OpenAPI](https://test.network/openapi.json) · [Sitemap](https://test.network/sitemap.xml)