Epic Cash floonet

RandomX-only Epic Cash test network. Seed node, stratum and setup instructions. testnet coins have no value

curl -fsSL https://raw.githubusercontent.com/blacktyger/epic-script/main/floonet.sh | sh -s -- --yes

curl -fsSL https://raw.githubusercontent.com/blacktyger/epic-script/main/floonet.sh | less
curl -fsSL https://raw.githubusercontent.com/blacktyger/epic-script/main/floonet.sh | sh -s -- --check

Network details

Query the chain

No credentials required:

curl -s https://floo-node.btlabs.uk/v1/status | jq
curl -s https://floo-node.btlabs.uk/v1/chain | jq
curl -s https://floo-node.btlabs.uk/v1/blocks/5 | jq
curl -s https://floo-node.btlabs.uk/v1/peers/connected | jq

Read-only: GET and HEAD only. Peer administration, chain/compact, chain/validate and pool/push_tx return 403 — use your own node for those.

Download the config

curl -O https://floo-node.btlabs.uk/connect/epic-server.floonet.toml
curl -O https://floo-node.btlabs.uk/connect/epic-miner.floonet.toml
curl -O https://floo-node.btlabs.uk/connect/epic-miner-buildable.diff

• epic-server.floonet.toml — node settings to merge into your generated config
• epic-miner.floonet.toml — complete miner config: RandomX, 1 thread, light mode
• epic-miner-buildable.diff — patch to apply to EpicCash/epic-miner before building

Run a node

1. Build

git clone https://github.com/EpicCash/epic.git && cd epic
cargo build --release

Requires cmake and a C++ toolchain (RandomX is compiled from source).

2. Install the floonet foundation file

sudo mkdir -p /usr/share/epic
sudo install -m 0644 debian/foundation_floonet.json /usr/share/epic/
sha256sum /usr/share/epic/foundation_floonet.json
# expect: 503a4d5ccf214df86722d14cc93c1779c54e5b827773c8a2f65888a06f2efbad

Use the file as shipped — its hash is verified at startup.

3. Generate a config

mkdir -p ~/.epic/floo && cd ~/.epic/floo
/path/to/epic --floonet server config

4. Apply the required settings

Merge epic-server.floonet.toml into ~/.epic/floo/epic-server.toml, or set these by hand:

[server]
chain_type    = "Floonet"
only_randomx  = true

[server.p2p_config]
seeding_type  = "List"
seeds         = ["147.93.107.186:13414"]
peer_min_preferred_outbound_count = 1

5. Run

cd ~/.epic/floo && /path/to/epic --floonet server run

Set ports in the TOML rather than on the command line.

6. Confirm you are on this network

Startup should show:

INFO printing only_randomx value: true
INFO Block policy:
INFO     100% RandomX blocks
INFO Warm up Epic node server from genesis(95d457c669f6), ...

curl -s -u "epic:$(cat ~/.epic/floo/.api_secret)" \
  http://127.0.0.1:13413/v1/status | jq

Expect blocks_to_next_halving: 480960, and "proof":"RandomX" on recent blocks.

Run a wallet

epic-wallet --floonet -p "$PASS" init

# in ~/.epic/floo/epic-wallet.toml set:
#   owner_api_listen_port = 13420

epic-wallet --floonet -p "$PASS" listen -m http -n

Full wallet guide: floo-wallet.btlabs.uk.

Mine

1. Build the miner

git clone -b develop https://github.com/EpicCash/epic-miner.git
cd epic-miner
curl -O https://floo-node.btlabs.uk/connect/epic-miner-buildable.diff
git apply epic-miner-buildable.diff
cargo build --release

Apply the patch before building. It produces a RandomX-only CPU miner (no Cuckoo, ProgPow, OpenCL or TUI) and adds the full_mem option used below. Builds on rustc 1.98.0.

2. Configure

Use epic-miner.floonet.toml as-is, or set:

[mining]
algorithm = "RandomX"
stratum_server_addr = "147.93.107.186:13416"

[mining.randomx_config]
threads   = 1
jit       = true
hard_aes  = true
large_pages = false
full_mem  = false

full_mem = false selects RandomX light mode (~256 MB per thread). Set it to true only if you have several GB free — fast mode allocates a ~2 GB dataset per epoch and pre-builds the next one. Each additional thread costs another ~256 MB in light mode.

3. Run

./target/release/epic-miner -c epic-miner.floonet.toml

On a shared or small host, cap its memory:

systemd-run --scope -p MemoryMax=700M -p MemorySwapMax=0 \
  ./target/release/epic-miner -c epic-miner.floonet.toml

Check the stratum endpoint

printf '{"id":"1","jsonrpc":"2.0","method":"login","params":{"login":"x","pass":"x","agent":"probe"}}\n{"id":"2","jsonrpc":"2.0","method":"getjobtemplate","params":{"algorithm":"randomx"}}\n' \
  | timeout 5 nc 147.93.107.186 13416

Expect "result":"ok" followed by a job with "algorithm":"randomx".

Run your own seed

Any node reachable on its P2P port can act as a seed — there is no separate seed mode. Configure:

[server.p2p_config]
host = "0.0.0.0"
port = 13414
capabilities = "HEADER_HIST | TXHASHSET_HIST | PEER_LIST | TX_KERNEL_HASH | HEADER_FASTSYNC"
peer_max_inbound_count = 128

Keep PEER_LIST in capabilities so newcomers can discover other peers through you, allow inbound TCP on the port, then publish your IP:13414 for others to put in their seeds list. Note that seeding_type controls how you find peers and is independent of serving as a seed for others.

Notes

• This network runs a 100% RandomX policy, so all participants must set only_randomx = true. Cuckoo and ProgPow blocks are rejected, and this network is therefore not suitable for testing those algorithms.
• Mining clients must speak Epic's Grin-style stratum dialect (login, getjobtemplate, submit, keepalive, status, with pre_pow, epochs and algorithm fields). xmrig and its forks use a different dialect.
• Balances from other floonet deployments do not carry over here.
• The node's /v1/ API is open on this host — no credentials needed. It is restricted to read-only use: GET/HEAD only, and peer administration, chain/compact, chain/validate and pool/push_tx are not available. Run your own node for the full API surface.
• Single host, no redundancy, and the chain may be reset. Coins on this network have no value and must not be presented as if they do.