stacking

Automate PoX stacking operations on the Stacks blockchain to lock STX and manage rewards.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander.

What problem does it solve?

PoX staking operations enable users to lock STX to earn Bitcoin rewards, automating a financially productive workflow and removing manual tracking.

Core Features & Use Cases

  • Read-only queries: get-pox-info and get-stacking-status to monitor PoX cycles and current stacking state without unlocking a wallet.
  • Write operations: stack-stx and extend-stacking to initiate or extend staking with an unlocked wallet, including validation of burn height, lock period, and BTC address format.
  • Use Case: A developer can script periodic checks and automatically lock STX when cycle thresholds are met.

Quick Start

Run bun run stacking/stacking.ts get-pox-info to view current PoX cycle information.

Frequently Asked Questions about stacking

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

FAQPage Schema
How do I automate PoX stacking on the Stacks blockchain to earn BTC rewards?

You can automate PoX stacking to earn BTC rewards by using a CLI tool to lock STX tokens and manage reward cycles. It validates burn height, lock period, and BTC address format, outputting structured JSON with explorer URLs.

How do I check my STX stacking status without unlocking my wallet?

You can check your STX stacking status without unlocking your wallet by running read-only queries like get-pox-info and get-stacking-status. These commands monitor current PoX cycles and stacking state, returning structured JSON data.

Do I need an unlocked wallet to extend STX stacking operations?

Yes, you need an unlocked wallet to extend STX stacking operations. Write actions such as stack-stx and extend-stacking require an unlocked wallet to authorize the transaction and validate the lock period on the Stacks blockchain.

What validation does the stacking CLI perform before locking STX tokens?

The stacking CLI performs input validation for version, hashbytes, burn height, and lock period before locking STX tokens. This ensures that write operations like stack-stx meet Stacks blockchain requirements and produce valid structured JSON output.

Can I script periodic checks to automatically lock STX when PoX cycle thresholds are met?

Yes, you can script periodic checks to automatically lock STX when PoX cycle thresholds are met. By combining read-only queries to monitor cycles with write actions to stack-stx, developers can automate the entire workflow via the CLI.

What is the best way to monitor current PoX cycle information for STX tokens?

The best way to monitor current PoX cycle information for STX tokens is running a read-only get-pox-info query. This returns structured JSON data detailing the cycle state without requiring an unlocked wallet, providing immediate visibility.