skills.rest
aibtcdev
aibtcdevOFFICIAL
Explore all skills by this author →
Website𝕏@aibtcdevGitHub

relay-diagnostic

Diagnose sponsor relay health and nonce state to identify stalled transactions.

9|43|Updated Feb 19, 2026
Search Tags:#recovery#nonce#sponsor#mempool#relay-health#rbf#gap-fill
One-click install
npx skills add https://github.com/aibtcdev/skills --skill relay-diagnostic-aibtcdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: relay-diagnostic
Source: https://github.com/aibtcdev/skills/tree/main/relay-diagnostic
Command: npx skills add https://github.com/aibtcdev/skills --skill relay-diagnostic-aibtcdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses stuck sponsor transactions on the Stacks relay by surfacing nonce state and enabling automated recovery paths.

Core Features & Use Cases

  • Check-health: Non-destructive health check that reports relay status and sponsor nonce state.
  • Recover: Requires an unlocked wallet to source sponsor API key; attempts RBF, gap-fill, or both to unblock pending transactions.
  • Use Case: A sponsor's transactions stall due to nonce gaps; run check-health, then recover to restore flow.

Quick Start

Run check-health to inspect the sponsor relay nonce state, then run recover with --action both after unlocking your wallet to trigger automated recovery.

Frequently Asked Questions about relay-diagnostic

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

FAQPage Schema
How do I diagnose stuck sponsor transactions on the Stacks relay?▼

To diagnose stuck sponsor transactions, run a check-health operation to read and report the relay status alongside the sponsor nonce state, identifying any nonce gaps causing stalls.

What is the best way to recover stalled sponsored transactions using RBF or gap-fill?▼

Recovering stalled sponsored transactions requires an unlocked wallet to source the sponsor API key, which then triggers RBF, gap-fill, or both via the relay endpoints to unblock pending transactions.

How does a nonce gap cause sponsored transactions to stall on the relay?▼

A nonce gap causes sponsored transactions to stall by breaking the sequential transaction order on the relay, which surfaces during a health check and requires a gap-fill recovery action to restore flow.

Do I need an unlocked wallet to check sponsor relay health?▼

You do not need an unlocked wallet to check sponsor relay health because the check-health action is read-only, but an unlocked wallet is required for the recover action to source the sponsor API key.

Can I run both RBF and gap-fill simultaneously to unblock pending sponsor transactions?▼

You can run both RBF and gap-fill simultaneously to unblock pending sponsor transactions by executing the recover action with the both parameter after unlocking your wallet.

Why does my sponsor transaction recovery fail on the Stacks relay?▼

Sponsor transaction recovery fails if the wallet is not unlocked to source the sponsor API key, preventing the system from triggering RBF or gap-fill via the relay endpoints to unblock pending transactions.

Related Skills

Explore More Software Engineering Skills→
Jay0xxJay0xx

relay-diagnostic

Diagnose sponsor relay nonce health and automate recovery for stuck transactions.

Community
Advanced
gykk16gykk16

transaction

Define Spring transaction propagation, isolation, rollback, and read-only routing rules.

Community
Intermediate
hairyfhairyf
4

mempool

Query Bitcoin and Liquid network data via REST and WebSocket APIs.

Community
Intermediate
l3wil3wi
11

circle-cctp

Implement Circle CCTP to bridge USDC across chains with attestation and finality.

Community
Advanced