stacking-lottery

What problem does it solve?

Managing STACKING lottery pots on stackspot.app involves coordinating on-chain state, contributions, timing, and rewards across multiple pots. This CLI unifies pot discovery, state queries, contributions, and reward claims, simplifying end-to-end workflow while enforcing mainnet-only and wallet-security requirements.

Core Features & Use Cases

• Pot Discovery: List all known pots with current on-chain value and lock status.
• Pot State: Retrieve full on-chain state for a selected pot, including configs and pool details.
• Join Pot: Contribute STX to a pot before it stacks, with minimums enforced.
• Start Pot: Trigger stacking for a pot during the PoX prepare phase.
• Claim Rewards: Claim sBTC rewards if selected as VRF winner; all participants recover STX.
• Cancel Pot: Cancel a pot before stacking begins to recover contributed STX.

Quick Start

Run bun run stacking-lottery/stacking-lottery.ts <subcommand> [options] to manage pots on mainnet.