> ## 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.

# Assets

> Add and manage blockchain assets for transaction tracking

Assets are the core data source in Chainbook. Each asset you add is synced automatically to import all historical and new transactions.

## Adding Assets

Assets are added through wallets. Each asset belongs to exactly one wallet and inherits the wallet's network type.

<Steps>
  <Step title="Open your wallet">
    Navigate to **Wallets** and click on the wallet where you want to add an asset.
  </Step>

  <Step title="Click Add Asset">
    Click the **Add Asset** button.
  </Step>

  <Step title="Enter the asset address">
    Paste your asset address.

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

        ```
        TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
        ```
      </Tab>

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

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

    <Check>
      Chainbook validates the address format before adding.
    </Check>
  </Step>

  <Step title="Start syncing">
    Click **Add** to save the asset. Syncing begins automatically.
  </Step>
</Steps>

## Asset Syncing

### Initial Sync

When you first add an asset, Chainbook performs a full historical sync:

1. **Fetches all transactions** - Every transaction involving this address
2. **Processes token transfers** - Identifies TRC-20/ERC-20 token movements
3. **Calculates balances** - Determines current and historical balances
4. **Indexes data** - Makes transactions searchable and filterable

<Info>
  Initial sync time depends on the asset's transaction history. An asset with thousands of transactions may take several minutes.
</Info>

### Ongoing Sync

After initial sync, assets are updated automatically:

| Sync Type | Frequency       | What's Updated                      |
| --------- | --------------- | ----------------------------------- |
| Regular   | Every 5 minutes | New transactions since last sync    |
| Manual    | On demand       | Full refresh of recent transactions |

### Manual Sync

To force an immediate sync:

1. Open the wallet containing the asset
2. Click the **Sync** button next to the asset
3. Wait for sync to complete

<Note>
  Manual sync is useful if you're expecting a transaction that hasn't appeared yet.
</Note>

## Asset Information

Each asset displays:

| Field                 | Description                     |
| --------------------- | ------------------------------- |
| **Address**           | The full blockchain address     |
| **Network**           | TRON or Ethereum                |
| **Last Sync**         | When the asset was last updated |
| **Status**            | Current sync status             |
| **Transaction Count** | Total number of transactions    |

## Sync Status Indicators

| Icon | Status  | Meaning                          |
| ---- | ------- | -------------------------------- |
| 🟢   | Synced  | Fully up to date                 |
| 🔵   | Syncing | Currently importing transactions |
| 🟡   | Queued  | Waiting to sync                  |
| 🔴   | Error   | Sync failed, will retry          |

### Handling Sync Errors

If an asset shows an error status:

1. **Wait for automatic retry** - Chainbook retries failed syncs automatically
2. **Check the address** - Ensure the asset address is correct
3. **Manual sync** - Try forcing a manual sync
4. **Contact support** - If errors persist, reach out to support

<AccordionGroup>
  <Accordion title="Common sync errors">
    **Rate limit exceeded**

    * Too many requests to blockchain API
    * Automatically resolved within minutes

    **Network timeout**

    * Temporary network connectivity issue
    * Will retry automatically

    **Invalid address**

    * Address format is incorrect
    * Remove and re-add with correct address
  </Accordion>

  <Accordion title="What if transactions are missing?">
    If you notice missing transactions:

    1. Wait for sync to complete (check status indicator)
    2. Try a manual sync
    3. Verify the transaction exists on the blockchain explorer
    4. Contact support if the issue persists
  </Accordion>
</AccordionGroup>

## Removing Assets

<Warning>
  Removing an asset permanently deletes all its transaction data from Chainbook. This action cannot be undone.
</Warning>

To remove an asset:

<Steps>
  <Step title="Open the wallet">
    Navigate to the wallet containing the asset.
  </Step>

  <Step title="Find the asset">
    Locate the asset in the asset list.
  </Step>

  <Step title="Click Remove">
    Click the trash icon or **Remove** button.
  </Step>

  <Step title="Confirm deletion">
    Click **Confirm** in the confirmation dialog.
  </Step>
</Steps>

## Best Practices

### Asset Organization

<Tip>
  Group related assets in the same wallet for easier management and reporting.
</Tip>

**Good organization:**

* All personal assets in "Personal" wallet
* All business assets in "Business" wallet
* Trading assets in "Trading" wallet

**Avoid:**

* Mixing personal and business assets
* Creating too many small wallets

### Address Security

<Note>
  Chainbook only tracks public asset addresses. We never ask for or store private keys.
</Note>

* Only add addresses you own or have permission to track
* Asset addresses are visible to anyone with access to the wallet
* Shared wallets show all asset addresses to all members

### Monitoring Multiple Addresses

If you have many addresses to track:

1. **Use consistent naming** for wallets
2. **Group by purpose** rather than by address
3. **Consider using tags** via categories for additional organization
4. **Review limits** - Check your plan's asset limits

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I track any asset address?">
    Yes, you can track any valid public asset address on supported networks. You don't need to own the asset - Chainbook reads public blockchain data.
  </Accordion>

  <Accordion title="Will the asset owner know I'm tracking them?">
    No. Chainbook only reads public blockchain data. There's no connection to the actual asset, and no notification is sent to the asset owner.
  </Accordion>

  <Accordion title="How far back does historical data go?">
    Chainbook imports the complete transaction history of each asset, from the first transaction to present.
  </Accordion>

  <Accordion title="Can I move an asset between wallets?">
    Currently, you cannot move assets between wallets. You would need to remove the asset from one wallet and add it to another, which means re-syncing the transaction history.
  </Accordion>
</AccordionGroup>