stacking-lottery

Manage STACKING lottery pot lifecycle on stackspot.app with CLI commands.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill stacking-lottery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stacking-lottery
Source: https://github.com/Jay0xx/forge0btc-news-agent/tree/main/aibtcdev-skills/stacking-lottery
Command: npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill stacking-lottery

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about stacking-lottery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage STX stacking lottery pots on stackspot.app?

Managing STX stacking lottery pots involves discovering pots, inspecting on-chain state, joining with STX contributions, starting stacking during the PoX prepare phase, and claiming sBTC rewards when selected as the VRF winner.

What do I need to contribute STX to a PoX stacking pot?

Contributing STX to a PoX stacking pot requires a mainnet wallet unlock for write operations and meeting the enforced pot minimum contribution threshold before the stacking phase begins.

Can I claim sBTC rewards from a stacking lottery pot?

Claiming sBTC rewards is available if selected as the VRF winner; the claiming process also ensures all participants recover their contributed STX from the pot.

How do I cancel a stacking pot and recover contributed STX?

Canceling a stacking pot allows you to recover contributed STX by triggering the cancellation command before the pot begins its stacking phase.

Does the stacking lottery CLI support testnet or only mainnet operations?

The stacking lottery CLI enforces mainnet-only operations, requiring mainnet network checks for write operations like joining, starting, and claiming, while allowing read-only queries for state inspection.

How do I check the on-chain state and lock status of stacking pots?

Checking on-chain state and lock status uses read-only queries to retrieve full pot configurations, pool details, and current on-chain values across all known pots without needing wallet unlocks.