Decks and weight

Decks and weight revised: all 6 fact-check gaps and all 26 voice items applied, figures and tables renumbered in page order, prose cut from 1,001 to 867 words; the 600 +-15% ceiling is not reachable w

A deck is 1 to 128 of your cards bound as one unit. MinePool computes its weight once from tier, stars and a per-element set bonus, locks every card, and the deck is born passive. That weight is its share of every vein, every cycle.

Before this page Your cards are revealed, so you know their tier and stars; see Sealed cards. Every constant here has a row in Reference.

What it is #

A deck is an ordered list of 1 to 128 of your cards, bound in one call to bindDeck(cardIds). The mine treats it as one worker with one weight, one lock and one claim, so the roll moves accumulators and never walks decks (contracts/interfaces/IMinePool.sol:24-26).

Every deck mines all three veins at once (contracts/src/MinePool.sol:261). Binding needs no $CARDS.

The deck is born passive, endCycle set to currentCycle - 1, and earns nothing until you buy a shift (MinePool.sol:267-268). The contract answers with DeckBound(owner, deckId, weight, costWeight) (MinePool.sol:279). The name you type stays in the app; only the card ids go on-chain (app/web/src/app/deck/DeckApp.tsx:204-205).

Rules #

• bindDeck needs reveal, else NotRevealedYet, and is frozen by pause, else EnforcedPause (MinePool.sol:214-215).
• It takes 1 to 128 cards, else EmptyDeck or DeckTooLarge (MinePool.sol:216-218).
• Each card must be yours and in no deck, else CardUnavailable; a duplicated id fails the same way (MinePool.sol:233-237).
• MinersNFT locks every card at bind and unlocks it only at unbind (MinePool.sol:275-277,351-354). Every transfer or burn of a locked card reverts; only mint is exempt (contracts/src/MinersNFT.sol:488-494). The odd part is that a passive deck stays locked. Until you unbind, a card cannot be transferred, sold, burned or merged, else CardLocked (MinersNFT.sol:323-324,492). Approvals can still be set; the transfer itself reverts.
• Only MinePool toggles the lock; its address was set once at deploy and cannot be set again (MinersNFT.sol:458-464,472-481; contracts/script/Deploy.s.sol:126).
• Weight is computed once at bind and cached; locked cards cannot merge, so it never drifts (MinePool.sol:265-266; MinersNFT.sol:323-324).
• Cost weight excludes one-of-ones, which add mining weight and never pay $CARDS (MinePool.sol:249,258).
• A deck is passive when endCycle is below the current cycle and active at or above (IMinePool.sol:53-54; MinePool.sol:112-116). Retired is a flag set when the bond ran out at a claim; the next buyShifts clears it (IMinePool.sol:62-63; MinePool.sol:311).
• unbindDeck(deckId) is owner-only and frozen by pause (MinePool.sol:332-334). The deck must be passive, else DeckStillActive, and fully claimed, else PendingNotSettled (MinePool.sol:335-345). Then every card unlocks and the whole remaining bond is refunded (MinePool.sol:347-359). An active deck cannot be unbound early.

Numbers #

Card weight is 2^(tier-1) x (1 + 0.25 x stars), on-chain (1 << (tier-1)) x (4 + stars) x WAD / 4, an exact integer at 1e18 (MinePool.sol:61,247). Each tier doubles the one below.

The set bonus is per element and counts distinct designs of that element inside the deck (MinePool.sol:242-246,758-764). It multiplies only that element's cards (MinePool.sol:254-259). A full set is all 63 designs of one element, not all 9 tiers; the one-of-one's design 63 counts as one.

Deck weight is the sum over elements of card weights times bonus (MinePool.sol:252-259). A card's own weight ignores element. The deck's does not.

The four editions of one design count once; the count comes from a per-element design mask (MinePool.sol:242-246).

Worked example #

Worked example B, the deck every page uses. Five Fire cards, designs 0 to 4, all Tier 1 with 0 stars, and five Moon cards, designs 0 to 4, all Tier 2 with 1 star.

Fire: 5 cards x 1 = 5
5 distinct Fire designs, x1.15 = 5.75
Moon: 5 cards x 2.5 = 12.5
5 distinct Moon designs, x1.15 = 14.375
W = 5.75 + 14.375 = 20.125
Cost weight = 20.125, no one-of-ones in the deck      (MinePool.sol:247,249,254-259)

In the one-of-one variant the cost weight stays 20.125 (MinePool.sol:249).

Edge cases #

• A deck made only of one-of-ones has cost weight 0, so its required bond is 0 and a claim never clips it (MinePool.sol:249).
• Claim first, then unbind; a retired deck keeps its cards locked until then (MinePool.sol:351-354).
• Merge removes a card and can drop an element below a set-bonus step (MinePool.sol:758-764); see Merge.
• START MINING binds the deck. The bond comes with the first shift, and the mine will not sell that shift until the deck's bond covers requiredBond(deckId, nCycles); see Shifts.
• The builder does not stop you at 128. The contract does, with DeckTooLarge (MinePool.sol:218).

Verify it on-chain #

Verify it on-chain On MinePool's read-contract tab, MAX_DECK_CARDS() returns 128 (MinePool.sol:54). deckInfo(deckId) returns weight, costWeight, endCycle, bondRemaining and retired (MinePool.sol:698-712); compare endCycle with currentCycle() for the state (MinePool.sol:112-116,151).

cardDeck(id) returns the deck an id sits in, 0 for none (MinePool.sol:157). locked(id) on MinersNFT reads true while the card is in a deck (MinersNFT.sol:484-486). Weights come back as 1e18 integers, so 20.125 reads as 20125000000000000000, 20.125 x 10^18 (MinePool.sol:61,247).

Not in the game #

Not in the game "Hold all 9 tiers of one element and every card in that set doubles." The x2.0 needs 63 distinct designs of one element in one deck (MinePool.sol:758-764). "Element does not affect power." The set bonus is per element (MinePool.sol:252-259). "60-card deck limit." The cap is 128 cards (MinePool.sol:54).

Next #

Read this if you are here to... Top up a bond, read the bond rule. Claim, read Claiming. Merge two of a kind, read Merge. Sell a card, read the lock in Rules; nothing moves until you unbind.

Next page: Shifts, bond and the cost of working.