Node Registration

This guide walks you through registering your Bittensor full-archive node on the FlameWire network.

Supported Chains

Currently, only Bittensor nodes can be registered. Ethereum and Sui support are coming soon.

Prerequisites

Before registering, ensure you have:

  • A full-archive Bittensor node running and fully synced
  • Your node must be online and accessible from the internet
  • A Bittensor wallet with a registered hotkey on subnet 97
  • The btcli command-line tool installed

On the node machine, install signing dependencies:

sudo apt install -y libclang-dev clang curl build-essential
cargo install subkey --git https://github.com/paritytech/polkadot-sdk

Node Configuration

Your node must be properly configured before registration:

RequirementDetails
Open PortsPorts 9944 (WebSocket RPC) and 30333 (P2P) must be open and accessible
RPC MethodsNode must be started with the --rpc-methods=unsafe flag
URL ProtocolURL must use ws:// or wss:// protocol

Security Note

The --rpc-methods=unsafe flag exposes additional RPC methods.

Registration Steps

Step 1: Access the FlameWire Dashboard

Navigate to the FlameWire application and sign in with your Google account:

FlameWire App

After signing in, you'll be redirected to the My Nodes page with the registration modal already open.

Step 2: Enter Your Node URL and Hotkey

In the registration modal, enter your node's WebSocket endpoint and your hotkey.

ws://your_node_ip:9944

Or if you have SSL configured:

wss://your_node_domain:9944

Step 3: Sign the Registration Message

Sign the verification message on the node machine using the node key (not the wallet hotkey):

echo -n "verify:[hotkey]" | subkey sign \
  --scheme ed25519 \
  --suri "0x$(cat /path-to/chains/bittensor/network/secret_ed25519 | xxd -p -c 32)"

Replace the placeholders with your actual values:

  • [hotkey] — Your SS58 hotkey address (starts with 5)
  • /path-to/chains/bittensor/network/secret_ed25519 — Your node key file path

Example:

echo -n "verify:5ExampleHotkeyAddress" | subkey sign \
  --scheme ed25519 \
  --suri "0x$(cat /var/lib/bittensor/chains/bittensor/network/secret_ed25519 | xxd -p -c 32)"

Step 4: Complete the Registration

Paste the values into the modal:

  1. Hotkey — Your Bittensor hotkey address (starts with 5)
  2. Signature — The signature output from the subkey sign command

Click + Register Node to complete the registration.

Registration Complete

Once registered, your node will appear in the dashboard. FlameWire will begin health checks and your node will start receiving RPC traffic once verified.

Node Verification

After registration, FlameWire performs automatic verification:

  • Connectivity check — Ensures your node is reachable
  • Sync status — Verifies your node is fully synced
  • Archive data — Confirms historical block data is available

You can monitor your node's status in the dashboard. A Healthy status indicates your node is ready to receive traffic.

You can also track miner status on the subnet metagraph:

btcli subnet metagraph --subtensor.network finney --subnet.netuid 97

Common Issues

IssueSolution
Node not reachableCheck that ports 9944 and 30333 are open in your firewall
Invalid signatureEnsure the message is exactly verify:[hotkey], use echo -n, and verify the node key path is correct
Node not syncingWait for your node to fully sync before registering
WebSocket connection failedVerify --rpc-methods=unsafe flag is set when starting your node