# Recovery Procedures

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

**Purpose**: Step-by-step recovery procedures for various failure scenarios

---

## 🔄 Transaction Recovery

### Stuck Transaction

**Scenario**: Transaction pending for extended period

**Recovery**:
1. Check transaction status
   ```bash
   cast tx <tx_hash> --rpc-url $RPC_URL
   ```

2. Check nonce
   ```bash
   cast nonce <address> --rpc-url $RPC_URL
   ```

3. Retry with higher gas
   ```bash
   bash scripts/retry-failed-transactions.sh
   ```

---

## 💰 Balance Recovery

### Insufficient Balance

**Scenario**: Not enough ETH or LINK for operations

**Recovery**:
1. Check current balances
   ```bash
   bash scripts/check-bridge-status.sh
   ```

2. Transfer funds
   - Transfer ETH to deployer address
   - Transfer LINK tokens if needed

3. Verify balances
   ```bash
   cast balance <address> --rpc-url $RPC_URL
   ```

---

## 🔗 Chain Configuration Recovery

### Missing Destination Chain

**Scenario**: Destination chain not configured

**Recovery**:
1. Verify chain selector
2. Add destination
   ```bash
   bash scripts/configure-bridge-destinations.sh
   ```

3. Verify configuration
   ```bash
   bash scripts/verify-bridge-configuration.sh
   ```

---

## 🌐 Network Recovery

### RPC Outage

**Scenario**: RPC endpoint unavailable

**Recovery**:
1. Check RPC status
   ```bash
   cast block-number --rpc-url $RPC_URL
   ```

2. Switch to backup RPC
   - Update RPC_URL in .env
   - Restart services

3. Verify connectivity
   ```bash
   bash scripts/health-check.sh
   ```

---

## 🔒 Security Recovery

### Unauthorized Access

**Scenario**: Suspicious activity detected

**Recovery**:
1. Pause bridge immediately
   ```bash
   cast send <BRIDGE_ADDRESS> "pause()" --rpc-url $RPC_URL --private-key $PRIVATE_KEY
   ```

2. Review logs
   ```bash
   tail -1000 logs/alerts-*.log
   ```

3. Rotate keys if needed
4. Resume after security review

---

**Last Updated**: $(date)