Node Registration
This guide walks you through registering your Bittensor full-archive node on the FlameWire network.
Supported Chains
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
btclicommand-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-sdkNode Configuration
Your node must be properly configured before registration:
| Requirement | Details |
|---|---|
| Open Ports | Ports 9944 (WebSocket RPC) and 30333 (P2P) must be open and accessible |
| RPC Methods | Node must be started with the --rpc-methods=unsafe flag |
| URL Protocol | URL must use ws:// or wss:// protocol |
Security Note
--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:
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:9944Or if you have SSL configured:
wss://your_node_domain:9944Step 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 with5)/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:
- Hotkey — Your Bittensor hotkey address (starts with
5) - Signature — The signature output from the
subkey signcommand
Click + Register Node to complete the registration.
Registration Complete
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 97Common Issues
| Issue | Solution |
|---|---|
| Node not reachable | Check that ports 9944 and 30333 are open in your firewall |
| Invalid signature | Ensure the message is exactly verify:[hotkey], use echo -n, and verify the node key path is correct |
| Node not syncing | Wait for your node to fully sync before registering |
| WebSocket connection failed | Verify --rpc-methods=unsafe flag is set when starting your node |