relay-diagnostic

Name: relay-diagnostic
Availability: InStock
Author: AIBTC

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

Ready to run

npx skills add https://github.com/aibtcdev/skills --skill relay-diagnostic-aibtcdev

💬 Prompt for ChatGPT / Claude Chat▼

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.