# export-rng-693.testnets.xahau.network — agent briefing

Ephemeral Xahau test network. Epoch 3, resets 2026-09-01T23:59 UTC.
Everything here is disposable; nothing has value. State does not survive
an epoch reset, and network_id changes with each epoch — re-read this
file and network.json rather than hardcoding either.

## Network

- network_id: **49582** — required in every transaction
- code under test: branch `feature-export-rng` @ `877d02fb4`
  ([PR #693](https://github.com/Xahau/xahaud/pull/693))
- consensus: 5 validators + 1 public gateway, ~3.7s ledger closes
- notable amendments: `Export`, `ConsensusEntropy`, `Hooks`, `HooksUpdate1`,
  `fixHookMap`, `ZeroB2M` (full list: `server_definitions` on the RPC)

## Endpoints

| what | where |
|---|---|
| JSON-RPC | `https://export-rng-693.testnets.xahau.network/rpc` |
| WebSocket | `wss://export-rng-693.testnets.xahau.network/ws` |
| Faucet | `POST https://export-rng-693.testnets.xahau.network/faucet` `{"destination":"r..."}` → 10,000 test-XAH |
| Logs (SSE) | `https://export-rng-693.testnets.xahau.network/logs/<node>/sse?level=debug` — node ∈ `all`, `g1`, `v0`–`v4`; capped 4 conn/ip |
| Validator list | `https://vl.export-rng-693.testnets.xahau.network` |
| Peer | `peer.export-rng-693.testnets.xahau.network:24101` |
| Bootstrap descriptor | `https://export-rng-693.testnets.xahau.network/network.json` (signed) |
| Binary codec | `https://export-rng-693.testnets.xahau.network/definitions.json` |

## Quick start

- **Client**: `new Client("wss://export-rng-693.testnets.xahau.network/ws")`,
  set `NetworkID: 49582` in every transaction.
- **Fund an account**: POST the faucet, or use the portal's fixtures tab —
  YAML object graph compiled to funded accounts, trustlines, and offers.
  Aliases derive deterministic wallets: `wallet(alias) = seed( H(namespace : alias) )`.
- **Query**: the portal console speaks rippled CLI positional grammar
  (`account_info <account>`, `account_lines`, `account_offers`, `server_info`,
  `ledger`); the same commands work as JSON-RPC methods on `/rpc`.
- **Run a node**: fetch and audit `docker-entry.sh`, or follow the join
  command on the portal — stock `ubuntu:24.04`; the entry script verifies the
  hbb-static binary by sha256 from the signed descriptor before exec.

## Etiquette

- Publish inbound (`-p 24102:24102`) if you run a node; outbound-only works
  but thins the topology.
- Log streams are debug-level and public; do not scrape them at more than
  the connection cap.
- This is a feature-branch net: expect resets, expect the branch to change
  behavior between epochs, and read the PR before filing "bugs" that are
  the feature.
