Disconnected
m1n3 docs
Getting Started

Miner Setup

Connect your mining hardware to a m1n3 pool and start earning shares

Requirements

RequirementDescription
Sui WalletA Sui address to receive mining shares and submit transactions
Mining HardwareAny SHA-256 mining hardware (ASIC recommended for mainnet)
Internet ConnectionStable connection to reach the stratum server and Sui network
SUI for GasSmall amount of SUI tokens to pay for on-chain transactions

Sui Wallet Setup

1. Install Sui CLI

# Using Homebrew (macOS)
brew install sui

# Using Cargo (all platforms)
cargo install --locked --git https://github.com/MystenLabs/sui.git --branch mainnet sui

2. Create a new address

sui client new-address ed25519

# Save the recovery phrase securely!

3. Fund your wallet

Transfer a small amount of SUI to your address for gas fees. You can get your active address with:

sui client active-address

Option A: Connect to an Existing Pool

The fastest way to start mining. Point your mining hardware at a running m1n3 stratum server using the standard stratum protocol:

stratum+tcp://<pool-server>:3333
Username: <sui_address>.<worker_name>   (e.g. 0x1234...abcd.rig1)
Password: x

Username format: Your Sui address followed by a dot and a worker name of your choice. The worker name helps you identify different rigs in pool statistics.

Option B: Run Your Own Stratum Server

Full control over your mining setup.

1. Build the stratum server

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

2. Configure and run

./target/release/m1n3-stratum \
  --bitcoin-rpc http://user:pass@127.0.0.1:8332 \
  --port 3333 \
  --sui-package 0xdf7cc2d80454cd56818e58e727b48beb2f8c441fcf6e4f46fd2282d24427a895 \
  --sui-pool 0x5b38b5c0ef42da7ae9776b3dedf0a04997d550121f5283790d526bbca46f3128 \
  --template-registry 0xaae6cb21c622ed2ae1ac3425eb8eca2c591eb7d291dbff3c39827de4ba5d746d \
  --initial-difficulty 4096 \
  --target-shares-per-min 10 \
  --decentralized true \
  --sui-rpc-url https://fullnode.mainnet.sui.io:443

3. Connect your miners

Point your mining hardware at localhost:3333 using the same username format described above.

Miner Registration

Before submitting shares, your Sui address must be registered as a miner in the pool's on-chain registry. This is a one-time transaction.

sui client call \
  --package 0xdf7cc2d80454cd56818e58e727b48beb2f8c441fcf6e4f46fd2282d24427a895 \
  --module pool \
  --function register_miner \
  --args 0x5b38b5c0ef42da7ae9776b3dedf0a04997d550121f5283790d526bbca46f3128

Note: If you're connecting to a pool that handles registration automatically, you may not need this step. Check with your pool operator.