Skip to main content

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.

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

​
Before You Start

Make sure you have:
Your asset address(es) ready to paste
Decided which wallet to add the asset to
Verified the asset is on a supported network (TRON or Ethereum)

​
Step 1: Create or Select a Wallet

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

​
Creating a New Wallet

1

Go to Wallets

Click Wallets in the sidebar.
2

Click New Wallet

Click the New Wallet button.
3

Configure the wallet

  • Name: Give your wallet a descriptive name
  • Network: Select TRON or Ethereum
Network selection is permanent. Make sure you choose the correct network for your asset addresses.
4

Continue to add assets

Don’t click create yet—continue to Step 2 to add asset addresses.

​
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.
TRON addresses start with T and are 34 characters:
TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7

​
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
You can paste addresses directly from a spreadsheet—Chainbook handles newlines and formatting.

​
Address Validation

Chainbook validates each address:
ValidationResult
✅ Valid formatAddress is accepted
❌ Invalid formatError message shown
❌ Wrong networkError—address doesn’t match wallet network
⚠️ DuplicateWarning 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
Assets with thousands of transactions may take several minutes. You can use other parts of Chainbook while waiting.

​
Understanding Sync Status

StatusMeaningAction
🔵 SyncingCurrently importing transactionsWait for completion
🟢 SyncedUp to dateNo action needed
🟡 QueuedWaiting to startWill begin automatically
🔴 ErrorSync failedCheck 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

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.
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
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
To fix an incorrect address:
  1. Open the wallet
  2. Find the asset
  3. Click Remove
  4. Add the correct address
Removing an asset deletes its transaction data.
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.

​
Best Practices

​
Organize Before Importing

Plan your wallet structure before adding assets:
WalletPurposeAssets
Personal - TRONPersonal TRX assets2
Business - ETHCompany Ethereum5
TradingExchange assets3

​
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:

Categorize Transactions

Organize your transactions with categories.

Add Contacts

Label addresses with friendly names.

View Dashboard

Get insights from your transaction data.

Export Data

Export for accounting or tax purposes.