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

# Importing Assets

> Complete guide to adding assets and syncing transaction history

This guide walks you through importing assets into Chainbook and understanding the sync process.

## Before You Start

Make sure you have:

<Check>
  Your asset address(es) ready to paste
</Check>

<Check>
  Decided which wallet to add the asset to
</Check>

<Check>
  Verified the asset is on a supported network (TRON or Ethereum)
</Check>

## Step 1: Create or Select a Wallet

Assets belong to wallets. First, ensure you have a wallet ready.

### Creating a New Wallet

<Steps>
  <Step title="Go to Wallets">
    Click **Wallets** in the sidebar.
  </Step>

  <Step title="Click New Wallet">
    Click the **New Wallet** button.
  </Step>

  <Step title="Configure the wallet">
    * **Name**: Give your wallet a descriptive name
    * **Network**: Select TRON or Ethereum

    <Warning>
      Network selection is permanent. Make sure you choose the correct network for your asset addresses.
    </Warning>
  </Step>

  <Step title="Continue to add assets">
    Don't click create yet—continue to Step 2 to add asset addresses.
  </Step>
</Steps>

### Using an Existing Wallet

If adding to an existing wallet:

1. Go to **Wallets**
2. Click on the wallet
3. Click **Add Asset**

## Step 2: Add Asset Addresses

### Single Asset

Enter your asset address in the input field.

<Tabs>
  <Tab title="TRON">
    TRON addresses start with `T` and are 34 characters:

    ```
    TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
    ```
  </Tab>

  <Tab title="Ethereum">
    Ethereum addresses start with `0x` and are 42 characters:

    ```
    0x742d35Cc6634C0532925a3b844Bc9e7595f5aB00
    ```
  </Tab>
</Tabs>

### Multiple Assets

Add multiple assets at once:

1. Click **Add Multiple** or paste multiple addresses
2. Enter one address per line
3. Chainbook validates all addresses before saving

```
TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
TN3W4H6rK7z1L5B9M2c4X8Y6Z0P3Q7R1S5
TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE
```

<Tip>
  You can paste addresses directly from a spreadsheet—Chainbook handles newlines and formatting.
</Tip>

### Address Validation

Chainbook validates each address:

| Validation       | Result                                      |
| ---------------- | ------------------------------------------- |
| ✅ Valid format   | Address is accepted                         |
| ❌ Invalid format | Error message shown                         |
| ❌ Wrong network  | Error—address doesn't match wallet network  |
| ⚠️ Duplicate     | Warning if address already exists in wallet |

## Step 3: Start Syncing

Click **Create Wallet** (new wallet) or **Add Asset** (existing wallet).

### What Happens During Sync

1. **Initial fetch** - Chainbook retrieves your transaction history
2. **Processing** - Transactions are processed and stored
3. **Indexing** - Data is indexed for search and filtering
4. **Complete** - Asset shows as "Synced"

### Sync Progress

During sync, you'll see:

* Progress indicator (percentage)
* Transaction count being imported
* Estimated time remaining

<Info>
  Assets with thousands of transactions may take several minutes. You can use other parts of Chainbook while waiting.
</Info>

## Understanding Sync Status

| Status         | Meaning                          | Action                         |
| -------------- | -------------------------------- | ------------------------------ |
| 🔵 **Syncing** | Currently importing transactions | Wait for completion            |
| 🟢 **Synced**  | Up to date                       | No action needed               |
| 🟡 **Queued**  | Waiting to start                 | Will begin automatically       |
| 🔴 **Error**   | Sync failed                      | Check address, try manual sync |

### Manual Sync

To force an immediate sync:

1. Open the wallet
2. Find the asset
3. Click the **Sync** button (refresh icon)
4. Wait for sync to complete

Use manual sync when:

* You expect a transaction that hasn't appeared
* Status shows an error
* It's been a while since last sync

## After Import

Once your assets are synced:

### View Transactions

1. Click **Transactions** in the sidebar
2. All transactions from your assets appear
3. Use filters to find specific transactions

### Add Contacts

Label frequently seen addresses:

1. Go to **Contacts**
2. Click **Add Contact**
3. Enter the address and a friendly name
4. Transactions now show the contact name

### Set Up Categories

Organize transactions by type:

1. Go to **Settings** → **Categories**
2. Create categories that match your needs
3. Assign categories to transactions

## Troubleshooting

<AccordionGroup>
  <Accordion title="Sync is taking a long time">
    Large assets with extensive history take longer to sync:

    * 100-500 transactions: 1-2 minutes
    * 500-2000 transactions: 2-5 minutes
    * 2000+ transactions: 5-10+ minutes

    Leave Chainbook open and wait for completion.
  </Accordion>

  <Accordion title="Sync shows an error">
    Common causes and solutions:

    **Rate limit exceeded**

    * Wait a few minutes and try manual sync
    * Too many API requests to blockchain provider

    **Invalid address**

    * Verify the address is correct
    * Check you're using the right network

    **Network timeout**

    * Temporary connectivity issue
    * Try manual sync after a few minutes
  </Accordion>

  <Accordion title="Missing transactions">
    If some transactions don't appear:

    1. Ensure sync is complete (status shows Synced)
    2. Check filters aren't hiding transactions
    3. Verify transaction is confirmed on blockchain
    4. Try a manual sync
    5. Contact support if issues persist
  </Accordion>

  <Accordion title="Wrong address added">
    To fix an incorrect address:

    1. Open the wallet
    2. Find the asset
    3. Click **Remove**
    4. Add the correct address

    <Warning>
      Removing an asset deletes its transaction data.
    </Warning>
  </Accordion>

  <Accordion title="Adding an asset to wrong wallet">
    Assets can't be moved between wallets:

    1. Remove the asset from the wrong wallet
    2. Add it to the correct wallet
    3. Wait for re-sync

    Transaction data will be re-imported.
  </Accordion>
</AccordionGroup>

## Best Practices

### Organize Before Importing

Plan your wallet structure before adding assets:

| Wallet          | Purpose             | Assets |
| --------------- | ------------------- | ------ |
| Personal - TRON | Personal TRX assets | 2      |
| Business - ETH  | Company Ethereum    | 5      |
| Trading         | Exchange assets     | 3      |

### Verify Addresses

Double-check addresses before adding:

* Copy directly from your asset app
* Verify first and last 4 characters
* Use blockchain explorer to confirm

### Add Contacts Early

Add contacts for known addresses right after import:

* Makes transaction review easier
* Improves report readability
* Helps with categorization

### Monitor Sync Notifications

Check notifications for sync updates:

* Successful completion
* Error alerts
* New transaction notifications

## What's Next?

After importing your assets:

<CardGroup cols={2}>
  <Card title="Categorize Transactions" icon="tags" href="/guides/categorizing-transactions">
    Organize your transactions with categories.
  </Card>

  <Card title="Add Contacts" icon="address-book" href="/features/contacts">
    Label addresses with friendly names.
  </Card>

  <Card title="View Dashboard" icon="chart-pie" href="/features/dashboard">
    Get insights from your transaction data.
  </Card>

  <Card title="Export Data" icon="file-export" href="/guides/exporting-data">
    Export for accounting or tax purposes.
  </Card>
</CardGroup>