Node Runner Setup

Requirements

Bitcoin Core Setup

1. Install Bitcoin Core

# macOS
brew install bitcoin

# Ubuntu/Debian
sudo apt install bitcoind

2. Configure bitcoin.conf

Enable RPC access so the gossip node can query your full node:

server=1
rpcuser=your_rpc_user
rpcpassword=your_rpc_password
rpcallowip=127.0.0.1
rpcport=8332
txindex=1

3. Start and sync

bitcoind -daemon

Initial sync may take several days depending on your hardware. Monitor progress with:

bitcoin-cli getblockchaininfo

4. Verify RPC is working

bitcoin-cli getblockcount

This should return the current block height. If it errors, check your bitcoin.conf settings.

Gossip Node Setup

1. Build the gossip node

git clone https://github.com/m1n3-protocol/m1n3-gossip.git
cd m1n3-gossip
cargo build --release

2. Create config.toml

listen_addr = "/ip4/0.0.0.0/tcp/4001"
bootstrap_peers = []
bitcoin_rpc_url = "http://localhost:8332"
sui_rpc_url = "https://fullnode.mainnet.sui.io:443"
sui_keypair_path = "~/.sui/sui_config/sui.keystore"
package_id = "0xdf7cc2d80454cd56818e58e727b48beb2f8c441fcf6e4f46fd2282d24427a895"
registry_id = "0x5e57b2a7b4714387e9fd7be7baebfe2c079c43bc0dac87703eae6612c9580571"
treasury_id = "0xa0a23418245518fb3ec4d81ed513126f9794318414e6eb93bcb5199ea8b2760d"

3. Run the node

./target/release/m1n3-gossip --config config.toml

The gossip node will connect to your Bitcoin Core instance and begin monitoring for new blocks.

Earning M1N3 Tokens

When your gossip node detects a new Bitcoin block, it automatically submits a block registration transaction to the Sui blockchain. Successful registrations mint M1N3 tokens to your wallet.

• Block verification — your node validates the block header against Bitcoin Core
• On-chain registration — the block hash is registered in the BlockRegistry on Sui
• Token minting — M1N3 tokens are minted to your Sui address as a reward
• First come, first served — only the first registration per block earns the reward

Tip: Low-latency connections to both Bitcoin Core and the Sui RPC are critical for being the first to register blocks.