diff --git a/components/CsvTable.vue b/components/CsvTable.vue index 2d41c9e..e4e1924 100644 --- a/components/CsvTable.vue +++ b/components/CsvTable.vue @@ -37,9 +37,17 @@ onMounted(async () => { + + diff --git a/public/files/address_book_entries.csv b/public/files/address_book_entries.csv new file mode 100644 index 0000000..e3a615b --- /dev/null +++ b/public/files/address_book_entries.csv @@ -0,0 +1,5 @@ +address,name,blockchain,location +0xa83114a443da1cecefc50368531cace9f37fcccb,harvey,, +0x388c818ca8b9251b393131c08a736a67ccb19297,donna,,global +0xdac17f958d2ee523a2206206994597c13d831ec7,mike,arbitrum_one, +bc1q2t0ad9cqars69ge9v7v7td7rpg3p7etgqfe0zn,rachel,btc,private \ No newline at end of file diff --git a/public/files/blockchain-accounts.csv b/public/files/blockchain-accounts.csv new file mode 100644 index 0000000..501fcef --- /dev/null +++ b/public/files/blockchain-accounts.csv @@ -0,0 +1,13 @@ +address,address extras,chain,label,tags +0x99A91871b93E13F53D8209529B5E390664bf25d8,,evm,eth with validators,eth-1;eth-with-validators +0x9DBE4Eb4A0a41955E1DC733E322f84295a0aa5c0,,evm,hahaha,evm-tag +0xc37b40ABdB939635068d3c5f13E7faF686F03B65,,evm,, +bc1qdf3av8da4up78shctfual6j6cv3kyvcw6qk3fz,,btc,bitcoin-1,bitcoin-1 +qz5hccuhr036drq7m3mah3qf5x3f5phv05v5rtu5z2,,bch,bitcoin-cash-1,bitcoin-cash-1 +EbEjgkw4Z2jFtaDad7zj59LrfmyuznXJzCmQh2qUfMvjiUj,,ksm,kusama-1,kusama-1 +14rw69gBpjYwdiw5MzvsZCSYVnHqubpUSHC5QPNBY5MPAoRi,,dot,polkadot-1,polkadot-1 +xpub6CcGTthbwnbxsMRuEF3XoYdekGtnGTsbiZ4ZKeqMC1UuqPYqh2xQj9hbEQj8AB9EuGeFHz4o3hWayZm5ahr5fyV2SNfNyA6htsZngM1DFBz,,btc,xpub-1,xpub-1 +0x80858247aa14f2c23e9a83b65d2a3e3de22f16ddaaf3fad0fee52601d3f67f71ccb72b196a4789a9d0aa057721745996,,eth2,, +0x918583458bae9b00cfb9d78497d58f9678cf91755a08682410756909de021666208ecf84e97ac5abddbf5f17af5fb11d,ownershipPercentage=50.00,eth2,, +0xab423fb58c3498a8014bcc115be96bea77c99004fb59d3580d75fff0054e113d126ee6dd65faa027732f7cf38fdb4dd2,ownershipPercentage=22.00,eth2,, +0xa49152b5babd0130d9e5e3480eb9d17dfad5c090e6a7b6849e14b6baba0d47444fdd454303bfd202b6ae895654f678c0,ownershipPercentage=33.00,eth2,, diff --git a/public/images/import_addressbook_entries.png b/public/images/import_addressbook_entries.png new file mode 100644 index 0000000..65251fd Binary files /dev/null and b/public/images/import_addressbook_entries.png differ diff --git a/public/images/import_and_export_blockchain_accounts.png b/public/images/import_and_export_blockchain_accounts.png new file mode 100644 index 0000000..80d881c Binary files /dev/null and b/public/images/import_and_export_blockchain_accounts.png differ diff --git a/usage-guides/accounts-and-balances.md b/usage-guides/accounts-and-balances.md index ae8f008..f4c636c 100644 --- a/usage-guides/accounts-and-balances.md +++ b/usage-guides/accounts-and-balances.md @@ -12,24 +12,24 @@ For now, the following chains are supported in rotki (and the list will be growi - **EVM Chains**: - - Ethereum - - Optimism - - Polygon PoS - - Arbitrum One - - Base - - Gnosis - - Scroll - - Avalanche - - zkSync Lite + - Ethereum (eth) + - Optimism (optimism) + - Polygon PoS (polygon_pos) + - Arbitrum One (arbitrum_one) + - Base (base) + - Gnosis (gnosis) + - Scroll (scroll) + - Avalanche (avax) + - zkSync Lite (zksync_lite) - **Bitcoin Chains**: - - Bitcoin - - Bitcoin Cash + - Bitcoin (btc) + - Bitcoin Cash (bch) - **Substrate Chains**: - - Polkadot - - Kusama + - Polkadot (dot) + - Kusama (ksm) To add or modify an account navigate to the `Blockchain Balances` sub-page and click the "**Add Account**" button on the top right. Now choose the blockchain on which you want to add an account. Then type or paste the address in the "Account" textbox and press the "Save" Button. Note that you can add multiple accounts if you click the "**Add multiple addresses**" checkbox and provide a comma separated list of addresses. @@ -93,6 +93,22 @@ For EVM accounts, it is possible to trigger the process of detecting tokens befo 3. To re-detect tokens for only one account, click the refresh button in the corresponding row. +## Import and Export Blockchain Accounts (CSV) + +You can export your blockchain accounts to CSV and then import them again into another rotki account (if you need to do it for your tax accountant, etc.). Also, if you have many accounts that you want to add to rotki, you can create your CSV and import it into rotki. + +You can do it in the menu `Accounts & Balances > Blockchain Balances` by clicking the three-dot menu. + +![Import and Export Blockchain Accounts](/images/import_and_export_blockchain_accounts.png) + + + +1. The `address` field is **required**. For an xpub, input the xpub address. For a validator, input the publicKey. +2. The `address extras` field is **optional**. You can specify `ownershipPercentage=xx` for validators and `derivationPath=xx` for xpubs. +3. The `chain` field is **required**. You can find supported chain IDs in the [supported blockchain](#adding-and-removing-blockchain-accounts) section. Use `evm` to add to all EVM chains. +4. The `label` field is **optional**. +5. The `tags` field is **optional**. Multiple tags should be separated by semicolons (`;`). + ## Checking Exchange Balances You can check all of the asset balances that you have in each connected exchange in the "Exchange Balances" sub-page. Clicking the "Add exchange" button takes you to the API Keys page where you can manage your exchange connections (see [Adding an exchange](/usage-guides/importing-data.html#adding-an-exchange)). diff --git a/usage-guides/address-book.md b/usage-guides/address-book.md index b077023..089d2fb 100644 --- a/usage-guides/address-book.md +++ b/usage-guides/address-book.md @@ -17,3 +17,29 @@ rotki provides an address book for blockchains. This replaces addresses with nam > 4. Ethereum Tokens > 5. Hardcoded Mappings > 6. ENS names. + +## Import multiple address books (CSV) + +You can add multiple address book entries at once with CSV import. You can find the menu in the three-dots menu here. + +![Import Address Book Entries](/images/import_addressbook_entries.png) + + + +1. The `address` field is **required**. +2. The `name` field is **required**. +3. The `blockchain` field is **optional**. You can find supported chain IDs in the [supported blockchains](/usage-guides/accounts-and-balances#adding-and-removing-blockchain-accounts) section. Leave it blank to add the entry to all chains. +4. The `location` field is **optional**. You can set it to either `global` or `private`. By default, it will be saved as `private`. + +## Import multiple address books (CSV) + +You can add multiple address book entries at once with CSV import. You can find the menu in the three-dots menu here. + +![Import Address Book Entries](/images/import_addressbook_entries.png) + + + +1. The `address` field is **required**. +2. The `name` field is **required**. +3. The `blockchain` field is **optional**. You can find supported chain IDs in the [supported blockchain](/usage-guides/accounts-and-balances#adding-and-removing-blockchain-accounts) section. Leave it blank to add it to all chains. +4. The `location` field is **optional**. You can either set it to `global` or `private`. By default it will be saved as `private`.