bore-miner

AL8 BORE mining SDK and CLI for Base. Agent-first defaults are built in, so miners can run with no required CLI args after init.

Installation

npm install bore-miner
# or run directly
npx bore-miner --help

Agent-First Quick Start

# 1) Create owner EOA + smart wallet config (.env)
npx bore-miner init

# 2) Start continuous mining
npx bore-miner mine

Default bootstrap settings:

• RPC: https://mainnet.base.org
• Paymaster: https://www.minebore.com/api/sponsor
• Network: Base Mainnet
• Contract: auto-detected from network defaults

You can override any default with CLI flags or .env values.

CLI Commands

bore-miner --help
bore-miner init --help
bore-miner mine --help

Main commands:

• init: create owner EOA key + gasless-smart-wallet config
• mine: continuous mining loop
• mine-epoch: mine one epoch and exit
• status: current epoch phase/timers and minted counters
• stats: chain-level tokenomics/burn metrics (RPC-only)
• balance: owner + smart-wallet balances

Logging modes:

• default: live status line (clean terminal UX)
• --log-everything: full line-by-line logs for piping/agents

Self-pay runway model:

• Commit gas: 70,000
• Reveal gas: 105,000
• Safety buffer: +10%
• Miner estimates remaining mined-epoch runway and warns below 100 by default (--topup-warning-mines).

Mining Workflow (Current BoreAL8)

1. Miner waits for commit window.
2. Miner selects tx route per epoch:
   • gasless smart-wallet path when paymaster health is good
   • self-pay EOA path when paymaster is unavailable
3. Miner grinds nonces (prefilter -> AL8 -> PoW) for the selected mining address.
4. Miner submits commit and waits for confirmation.
5. Miner waits for reveal window.
6. Miner submits reveal, parses reward, and updates session counters.

Important protocol constraint

BoreAL8 keeps one active commit state per miner address. That means a single address cannot safely pipeline epoch N+1 commit while epoch N is still unrevealed.

For parallel mining across overlapping windows, use multiple mining addresses.

Programmatic Usage

import { BoreAL8Miner } from 'bore-miner';

const miner = new BoreAL8Miner({
  rpcUrl: 'https://sepolia.base.org',
  privateKey: process.env.PRIVATE_KEY!,
  contractAddress: process.env.CONTRACT_ADDRESS!,
  paymasterUrl: process.env.PAYMASTER_URL,
});

await miner.mine();

Fast Nonce Search API

import { al8 } from 'bore-miner';

const y = al8(challenge, minerAddress, nonce, epoch);

MCP Server

npx bore-miner-mcp

Available MCP tools:

• bore_contract_probe
• bore_status
• bore_stats
• bore_recent_events
• bore_balance
• bore_gasless_health
• bore_mine_epoch
• bore_init_wallet

License

MIT