DEV Community

Cover image for How to Mine a Spirit Card: Browser and CLI Walkthrough (2026)
Spirit Cards
Spirit Cards

Posted on

How to Mine a Spirit Card: Browser and CLI Walkthrough (2026)

How to Mine a Spirit Card: Browser and CLI Walkthrough (2026)

Spirit Cards — banner


To mine a Spirit Card, open the mine page at spiritcards.fun/mine in a desktop browser, connect an EVM wallet, and press start — at the launch difficulty of 20 bits, a typical laptop finds a valid card in about five seconds. Prefer a dedicated machine? The CLI miner in our public repo does the same work with the same work format, and it's the better option for leaving something grinding overnight.

This is the walkthrough we wish existed when we started testing. It covers both paths, the real costs, and the mistakes that cost new miners fees.

What you're actually doing when you "mine"

The miner searches for a nonce that satisfies a hash condition:

work = keccak256(chainId ‖ contract ‖ miner ‖ nonce)
valid when leadingZeroBits(work) ≥ requiredBits
Enter fullscreen mode Exit fullscreen mode

When a valid nonce turns up, the client submits it, and the contract forges a card whose traits derive from that hash. The part we care about: the Mined event emits the exact work bytes, so the number your miner shows you can be checked against the chain. If a project can't offer that, it isn't really mining — it's a random number generator with extra steps.

Path 1 — browser mining (where most people start)

  1. Open the mine page at spiritcards.fun/mine on a desktop. The mobile browser works for viewing, but mining is a CPU job and phones thermal-throttle fast.
  2. Connect your wallet. The site detects and switches you to Robinhood Chain (chainId 4663). If you've never added the chain, this happens for you — no manual RPC fiddling. The chain guide in this series covers the wallet side in detail.
  3. Press start. The miner runs in a background thread, so you can browse the collection, read the docs, or leave the tab and work on something else.
  4. Confirm the mint when it lands. A valid hash is not a card yet — you approve the forge transaction and pay the current fee. This is the step people miss when they say "nothing happened."
  5. Respect the cooldown. Between mints there's a 45-second cooldown. It's short, but it exists, and it applies to everyone equally.
  6. Repeat, and watch the era. Each era nudges difficulty up by 0.33 bits and the fee up by 25%. Early mining is genuinely cheaper; that's not marketing, it's the curve.

Path 2 — CLI mining (dedicated machines)

  1. Clone the repo from github.com/spiritcards and enter the miner/ folder.
  2. Install dependencies. Run the bundled dry-run mode first — it exercises the full pipeline without sending anything on-chain.
  3. Configure RPC and wallet through environment variables. Say it with us: never put a private key in a file you might commit. Use a dedicated hot wallet with only what you need.
  4. Start the miner. It resolves chainId and the current difficulty on its own, then grinds.
  5. Submit the transaction when it finds a solution — identical work bytes to the browser path, just faster machines and no tab babysitting.

Benchmarks we've actually run (October 2026)

Setup Hashrate Time per base card (~20 bits) Notes
Ryzen 7 5800H laptop, one thread ~211 kH/s ~5 s Measured with our CLI benchmark
Mid-range phone, browser device-dependent minutes, with thermal throttling Viewing only, in our opinion
High-core desktop, CLI scales with cores you give it seconds at base; slows as eras raise difficulty No special hardware required

We publish our measurement script alongside the miner, so you can reproduce the number on your own hardware instead of trusting ours.

The cost math nobody mentions

Three line items matter, and two of them surprise people:

  • The forge fee. Starts near $1 in ETH, rises 25% per era. You pay it whether the card turns out to be a keeper or merge fodder.
  • The chip. An ERC-1155 "chip" token cuts 30% off your next forge fee. If you're planning a mining session, using a chip first is free money.
  • Gas. On Robinhood Chain gas runs in hundredths of a gwei, so minting gas is noise compared to the fee. This is exactly why the game can afford to be transaction-heavy — the chain-level guide goes into the numbers.

One more: mining is single-target. You're not "pointing hashrate at a pool" — one valid hash, one card, then the cooldown. Plan sessions, not a firehose.

Three mistakes we've watched new miners make

We've sat through a lot of first sessions by now, and the same three mistakes keep showing up.

  • Mining on a machine that's already throttling. Laptop on a soft surface, external monitor attached, three Chrome tabs open — and then the miner wonders why it's slow. Give the miner a machine that isn't fighting for heat headroom.
  • Forgetting the confirmation step. The miner's job ends at "found". The card exists only after the forge transaction confirms. If a session looks stuck, check the wallet for a pending approval before filing a bug report.
  • Burning the era curve on a whim. The fee rises every era, so undecided duplicates get more expensive to replace over time, not less. Decide whether you're collecting or grazing before you merge your way through a week of mining.

None of these are exotic failure modes. They're the difference between a hobby that behaves and one that eats your weekend.

FAQ

Does mining work on a phone?
The site is usable, but sustained hashing on a phone will cook your battery and throttle within minutes. We keep a benchmark page for curiosity, not as a farming strategy.

I found a hash but didn't get a card — bug?
Check two things: whether the mint transaction was confirmed, and whether you were inside the cooldown window. A found-and-submitted hash that misses the confirmation step isn't forged yet.

Can I run several miners at once?
Technically yes, and some people do — but the cooldown and the rising era fee apply to the whole game state, not per machine. Multiple rigs mostly buy you more shots at the same curve.

Is the CLI miner safe to run?
It's open source, doesn't phone home, and the docs describe every parameter. Read it before you run it — that's what public code is for.

Limitations — what this guide doesn't cover

  • Wallet security beyond the basics. If you're mining with meaningful value, use a hardware wallet and a throwaway hot wallet for the grind.
  • Tax and legal treatment. Your jurisdiction, your accountant.
  • Profitability claims. Mining produces a card. What it's worth is decided later by other people, and that's not something we control or promise.

Links we keep handy

Start at spiritcards.fun · source and miner at GitHub · docs EN and 中文 · updates on X · questions in Telegram.

Mining has costs and no guarantees. Verify the contract address from the official site before approving anything.

Top comments (0)