> For the complete documentation index, see [llms.txt](https://docs.astralbeam.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.astralbeam.io/using-astralbeam/tracking-transactions.md).

# Tracking Transactions

The AstralBeam provides a dedicated Transactions page where you can monitor the progress of all your bridge transfers.

## Accessing the Transactions Page

Navigate to [astralbeam.io/transactions](https://astralbeam.io/transactions) to view your transaction history.

## Understanding Transaction Status

### Status Indicators

| Status        | Color  | Meaning                    |
| ------------- | ------ | -------------------------- |
| **Pending**   | Yellow | Transaction is in progress |
| **Completed** | Green  | Successfully bridged       |
| **Failed**    | Red    | Transaction failed         |

### Progress Bar

For pending transactions, a progress bar shows how far along the bridge process is:

* **0-30%**: Initial transaction (lock/burn) submitted
* **30-60%**: Waiting for finality (EVM → Casper only)
* **60-90%**: Relayer attestation in progress
* **90-100%**: Final transaction (mint/unlock) being submitted

## Transaction Card Details

Each transaction card displays:

```
┌─────────────────────────────────────────────────────┐
│  [Ethereum] → [Casper]              [Pending]       │
│                                                     │
│  10 USDC                                            │
│  0xabc1...ef23 → 01def4...7890      2 minutes ago   │
│                                                     │
│  [███████████████░░░░] 75%                         │
│  Waiting for finality: ~8 minutes remaining         │
└─────────────────────────────────────────────────────┘
```

### Card Elements

| Element        | Description                    |
| -------------- | ------------------------------ |
| Network badges | Source and destination chains  |
| Status badge   | Current transaction status     |
| Amount         | Token amount being bridged     |
| Addresses      | Truncated sender and recipient |
| Timestamp      | When transaction was initiated |
| Progress bar   | Visual progress indicator      |
| Time remaining | Estimated time to completion   |

## Expanded Transaction View

Click on any transaction card to expand and see detailed step-by-step progress:

### EVM → Casper Steps

| Step                | Description                 | Explorer Link |
| ------------------- | --------------------------- | ------------- |
| Approve Token       | Token approval transaction  | Etherscan     |
| Lock Tokens         | Lock in bridge contract     | Etherscan     |
| Wait for Finality   | \~13 minutes for Ethereum   | -             |
| Relayer Attestation | M-of-N signatures collected | -             |
| Mint on Casper      | CEP-18 tokens minted        | CSPR.live     |

### Casper → EVM Steps

| Step                | Description                 | Explorer Link |
| ------------------- | --------------------------- | ------------- |
| Burn Tokens         | Burn CEP-18 on Casper       | CSPR.live     |
| Relayer Attestation | M-of-N signatures collected | -             |
| Unlock on Ethereum  | ERC-20 tokens unlocked      | Etherscan     |

## Filtering Transactions

Use the filter buttons to view specific transaction types:

| Filter        | Shows                  |
| ------------- | ---------------------- |
| **All**       | All transactions       |
| **Pending**   | In-progress transfers  |
| **Completed** | Successfully completed |
| **Failed**    | Failed transactions    |

## Transaction Explorer Links

Each step that has an on-chain transaction includes a "View tx" link:

* **Ethereum transactions**: Opens Etherscan (Sepolia)
* **Casper transactions**: Opens CSPR.live (Testnet)

## Managing Transactions

### Clear Completed

Click "Clear Completed" to remove completed and failed transactions from the list. This only clears the local display - your actual transactions remain on the blockchain.

### Transaction Persistence

Transactions are stored locally in your browser:

* Transactions persist across page refreshes
* Clearing browser data will remove local transaction history
* Completed blockchain transactions are always verifiable on explorers

## Automatic Updates

The Transactions page automatically refreshes every 5 seconds to:

* Update progress indicators
* Detect completed transactions
* Show new transactions started in the Bridge page

## Transaction Timeout Behavior

To keep the interface clean, the bridge implements automatic cleanup:

### EVM → Casper

If the lock transaction hasn't completed within 2 minutes, the transaction is automatically removed from the pending list. This happens when:

* User rejected the transaction in MetaMask
* Transaction failed due to insufficient gas
* Network issues prevented submission

### Casper → EVM

If the burn transaction hasn't completed within 2 minutes, the transaction is automatically removed. This happens when:

* User rejected the transaction in Casper Wallet
* Transaction failed due to insufficient CSPR
* Contract execution failed

## Finding Old Transactions

If a transaction is no longer visible in the Transactions page:

### On Block Explorers

**Ethereum/EVM:**

1. Go to [sepolia.etherscan.io](https://sepolia.etherscan.io)
2. Search for your address
3. View "Transactions" or "Token Transfers"

**Casper:**

1. Go to [testnet.cspr.live](https://testnet.cspr.live)
2. Search for your account
3. View "Deploys" tab

### Using the API

Query the bridge API for historical transactions:

```bash
curl "https://api.csprbridge.com/api/v1/transactions?address=YOUR_ADDRESS"
```

## Troubleshooting

### Transaction Not Appearing

1. Ensure you're on the correct page ([/transactions](https://astralbeam.io/transactions))
2. Check if filters are hiding it (click "All")
3. Refresh the page
4. Check browser's localStorage isn't blocked

### Stuck at "Pending"

1. Check blockchain explorers for transaction status
2. For EVM: Check MetaMask for pending transactions
3. For Casper: Check CSPR.live for your deploy
4. Transactions may take longer during network congestion

### Progress Not Updating

1. Page auto-refreshes every 5 seconds
2. Try manual refresh (F5 or Cmd+R)
3. Check your internet connection
4. Ensure bridge API is accessible


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.astralbeam.io/using-astralbeam/tracking-transactions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.