> ## Documentation Index
> Fetch the complete documentation index at: https://docs.biconomy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cleanup Transactions

> Return leftover tokens after failed operations

Cleanup transactions ensure users get their tokens back if something fails mid-execution—especially important for cross-chain flows.

## Why Cleanups Matter

Single-chain flows are atomic: all succeed or all fail. Cross-chain flows aren't—a bridge might succeed but the destination swap fails, leaving tokens stranded.

**Cleanups automatically return leftover tokens to the user.**

## Fusion Mode

For external wallets (MetaMask, Rabby):

```typescript theme={null}
const quote = await meeClient.getFusionQuote({
  trigger,
  instructions: [bridge, swap, deposit],
  cleanUps: [
    {
      chainId: base.id,
      tokenAddress: USDC,
      recipientAddress: userEOA
    }
  ],
  feeToken: { chainId: base.id, address: USDC }
});
```

No `dependsOn` needed—Fusion batches everything automatically.

## EIP-7702 / Smart Account Mode

For embedded wallets or SCAs:

```typescript theme={null}
const quote = await meeClient.getQuote({
  instructions: [bridge, swap, deposit],
  cleanUps: [
    {
      chainId: base.id,
      tokenAddress: USDC,
      recipientAddress: userEOA,
      dependsOn: [userOp(2)]  // Wait for instruction 2
    }
  ],
  feeToken: { chainId: base.id, address: USDC }
});
```

Use `dependsOn` when cleanup should wait for specific instructions.

## Multi-Token Cleanup

Return multiple tokens:

```typescript theme={null}
cleanUps: [
  {
    chainId: base.id,
    tokenAddress: USDT,
    recipientAddress: userEOA,
    dependsOn: [userOp(1)]
  },
  {
    chainId: base.id,
    tokenAddress: USDC,
    recipientAddress: userEOA,
    dependsOn: [userOp(2)]
  }
]
```

Each cleanup executes after its dependency resolves.

## How It Works

1. Cleanup instructions are added to the transaction
2. They wait until dependent operations complete
3. Transfer any remaining balance back to user
4. If balance is 0, cleanup harmlessly reverts

<Info>
  Cleanups always run last and only transfer tokens that remain in the smart account.
</Info>

## When to Use

| Scenario                     | Use Cleanup? |
| ---------------------------- | ------------ |
| Cross-chain bridge + swap    | ✅ Yes        |
| Multi-step DeFi flow         | ✅ Yes        |
| Simple single-chain transfer | ❌ Not needed |
| Atomic single-chain batch    | ❌ Not needed |

## Tips

* **Fusion**: Skip `dependsOn`—handled automatically
* **EIP-7702/SCA**: Use `dependsOn` for non-sequential flows
* Always set `recipientAddress` to the user's EOA
* Cleanups prevent funds from being stuck in intermediate accounts