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.