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.