Skip to content

OffchainLabs/arbitrum-docs / .agents/skills/arbitrum-best-practices

arbitrum-best-practices

Verified

Arbitrum L2 development best practices. Use when implementing bridges, Orbit chains, SDK integrations, or debugging cross-chain transactions. Triggers on Arbitrum, L2, rollup, bridge, retryable, Orbit, Nitro, or cross-chain contexts.

rules/debug-retryable-failure.md

View on GitHub
---
title: Debug Retryables by Status
impact: MEDIUM
impactDescription: recover stuck deposits
tags: debug, retryable, troubleshooting
---

## Debug Retryables by Status

When a retryable ticket fails, the SDK status tells you exactly what went wrong. Check status before attempting recovery.

**Incorrect (guessing at the problem):**

```typescript
// Bad: Blindly retrying without diagnosis
await message.redeem({ gasLimit: 1000000n }) // Might not be the issue
```

**Correct (diagnose first via status):**

```typescript
// Good: Status-driven debugging
const status = await message.status()
switch (status) {
  case L1ToL2MessageStatus.NOT_YET_CREATED:
    // L1 tx pending or failed - check L1 transaction
    break
  case L1ToL2MessageStatus.CREATION_FAILED:
    // Submission cost too low - funds at refund address
    break
  case L1ToL2MessageStatus.FUNDS_DEPOSITED_ON_L2:
    // Auto-redeem failed - manually redeem with more gas
    await message.redeem({ gasLimit: 500000n })
    break
  case L1ToL2MessageStatus.EXPIRED:
    // Missed 7-day window - recover via refund address
    break
}
```

| Status | Cause | Recovery |
|--------|-------|----------|
| `CREATION_FAILED` | Low submission cost | Retry with higher maxSubmissionCost |
| `FUNDS_DEPOSITED_ON_L2` | Insufficient L2 gas | Manual redeem with more gas |
| `EXPIRED` | Missed 7-day window | Funds at refund addresses |

For detailed troubleshooting, see [L1 to L2 Messaging](https://docs.arbitrum.io/how-arbitrum-works/arbos/l1-l2-messaging).
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: 197kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall