Skip to content

Solizardking/clawd-bot / .agents/skills/vulcan-error-recovery

vulcan-error-recovery

Verified

Error category routing, tx_failed recovery, and network error handling for Vulcan.

vulcan-error-recovery

Use this skill for:

  • Routing errors by category
  • Recovering from failed on-chain transactions
  • Handling network and rate limit errors

Error Envelope Format

{
  "ok": false,
  "error": {
    "category": "validation",
    "code": "UNKNOWN_MARKET",
    "message": "Market not found",
    "retryable": false
  }
}

Category Routing Table

CategoryExitRetryableAction
validation1NoFix the input. Common: UNKNOWN_MARKET, MISSING_ARG, INVALID_INTERVAL
auth2NoCheck wallet exists and password is correct. Run vulcan wallet list
config3NoRun vulcan setup to recreate config
api4NoPhoenix API issue. Check vulcan status for connectivity
network5YesTransient. Retry with exponential backoff (1s, 2s, 4s)
rate_limit6YesWait 5s and retry. Reduce request frequency
tx_failed7NoCritical: verify state before retrying. See below
io8YesFile permission issue. Check ~/.vulcan/ permissions
dangerous_gate9NoAdd acknowledged: true to the tool call
internal10NoBug in vulcan. Report it

tx_failed Recovery (Critical)

On-chain transactions can fail in complex ways. Never blind-retry.

  1. Check position state first:

    vulcan_position_list → {}
    vulcan_margin_status → {}
    
  2. Common causes:

    • Blockhash expired — transaction took too long. Safe to retry with fresh state.
    • Insufficient SOL for fees — check vulcan_wallet_balance.
    • Account state changed — another transaction modified the account between build and send.
    • Slippage exceeded — market moved. Re-check price and retry.
  3. Recovery pattern:

    1. vulcan_position_list → {}           # did the original tx partially succeed?
    2. vulcan_margin_status → {}           # is collateral state as expected?
    3. vulcan_wallet_balance → {}          # enough SOL for fees?
    4. vulcan_market_ticker → { symbol }   # has price moved significantly?
    5. Re-attempt the operation if state is clean
    

Network Error Recovery

1. Wait 1 second
2. Retry the same call
3. If still failing, wait 2 seconds and retry
4. After 3 failures, check connectivity: vulcan_status → {}
5. Report to user if API is down

Common Error Codes and Fixes

CodeFix
UNKNOWN_MARKETRun vulcan_market_list to see available symbols
MISSING_ARGCheck tool schema for required fields
NO_POSITIONNo open position. Check vulcan_position_list
ISOLATED_ONLY_MARKETRe-run with isolated: true, collateral: <amount>
NO_DEFAULT_WALLETRun vulcan wallet set-default <name>
DECRYPT_FAILEDWrong password. Check VULCAN_WALLET_PASSWORD
NO_TRADER_ACCOUNTRegister with vulcan_account_register
BUILD_TPSL_FAILEDTP/SL only works when opening/extending a position. Same-call TP/SL is supported on market orders and cross-margin limit orders; use post-hoc TP/SL tools for isolated limit orders.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 193kUpdated Claude CodeCodexVerifiedInstall