Stacking Lottery Skill

Provides stacking lottery pot operations on stackspot.app:

• Pot Discovery — List all known pot contracts with their current value and lock status.
• Pot State — Query full on-chain state for a pot: value, participant count, lock status, config, pool config, and details.
• Join Pot — Contribute STX to a pot before it fills and starts stacking.
• Start Pot — Trigger a full pot to begin stacking through the platform contract.
• Claim Rewards — Claim sBTC rewards if your address was selected as the VRF winner.
• Cancel Pot — Cancel a pot before it starts and recover contributed STX.

How it works: Participants join pots by contributing STX. When a pot reaches its maximum participant count, the platform contract triggers stacking via Proof of Transfer (PoX) for one full cycle. At unlock, a VRF-selected winner receives the stacking yield in sBTC. All participants (winner included) receive their original STX back.

All stacking lottery operations are mainnet-only. Write operations (join-pot, start-pot, claim-rewards, cancel-pot) require an unlocked wallet (use bun run wallet/wallet.ts unlock first).

Usage

bun run stacking-lottery/stacking-lottery.ts <subcommand> [options]