docs: update some changes in 1.39.0

Author: lukicenturi

.vitepress/config.mts

@@ -68,6 +68,7 @@ export default defineConfig({
           { text: 'Taking Notes In-App', link: '/usage-guides/user-notes' },
           { text: 'Address Book', link: '/usage-guides/address-book' },
           { text: 'Calendar', link: '/usage-guides/calendar' },
+          { text: 'On-Chain Transactions', link: '/usage-guides/onchain' },
         ],
       },
       {

public/images/add_tx_by_hash.png

@@ -90,6 +90,12 @@ Users can link assets on exchanges to those recognized by rotki. If you encounte
 
 ![Manage centralized exchange asset mapping](/images/rotki_manage_cex_mapping.png)
 
+## Manage Counterparty Mapping
+
+Users can also link assets on any counterparty to those recognized by rotki.
+
+![Manage counterparty asset mapping](/images/rotki_manage_counterparty_mapping.png)
+
 ## Newly detected tokens
 
 All newly detected EVM tokens will appear in the list of newly detected tokens. You should inspect this list often and accept valid tokens and reject spam assets by adding them to the ignored tokens list.

public/images/delete_transaction_events.png

@@ -1,61 +1,8 @@
-# Historical events
-
-## Exchange Trades
-
-### Adding manual trades
-
-rotki will pull all your trade history from the exchanges whenever it needs it. But most of us have probably also done some OTC trades or taxable events at some point. Such events could even just be mining tokens, depending on your jurisdiction, participating in an ICO or getting paid in crypto.
-
-You can go to this page via `History → Exch. Trades`.
-Clicking on the "Add an external trade" button will open a menu like the following.
-
-![Add an external trade](/images/external_trade.png)
-
-To add a new trade, fill in all the fields and press the "Save" button.
-
-In the `amount` field you can register the amount of the base asset bought or sold. The `rate` field represents the rate of quote asset per base asset that was bought or sold. If there was a fee for the trade you should input it in the corresponding box and also enter the currency the fee was paid in. This field is optional so if the Fee was 0 you can leave this field empty. You can optionally provide additional notes or even links to blockchain explorers for each trade.
-
-In the Trades page you can see a table of all your external trades. You can edit or delete a trade by clicking on the appropriate icon at the rightmost part of each trade under the "Actions" column.
-
-Currently rotki tracks your balance by querying the different supported protocols, exchanges and blockchains. If you manually add information about a trade your balances will not be updated since trades are not consulted when updating the accounts' balances. If you want to manually update your balance for an asset please refer to the [manual balances section](/usage-guides/accounts-and-balances.html#adding-manual-balances).
-
-### Filtering trades
-
-rotki supports filtering your trades with a combination of filters. All of the filters are applied at the same time
-limiting the trades to the ones that satisfy all the applied filters.
-
-![Filtering trades](/images/sc_history_trades_filter.png)
-
-You can filter using the following keys:
-
-- **base:** the base asset of the trades.
-- **quote:** the quote asset of the trades.
-- **action:** it can be buy or sell.
-- **start:** will only filter any trades from that date onwards.
-- **end:** will only filter any trades that happened before the selected date.
-- **location:** the location of the trade, e.g. kraken, uniswap etc.
-
-![Trade filter suggestions](/images/sc_history_trades_filter_suggestions.png)
-
-When selecting a filter, by clicking or typing the filter you will get some suggestions based on the available data.
-
-When a suggestion appears you can navigate to the next available suggestion using the tab button or you can also change
-the select suggestion using the up/down arrows in your keyboard. You can submit the selected filter by pressing enter.
-
-![Multiple trade filters applied](/images/sc_history_trades_filter_multi.png)
-
-After adding your filters you can press enter to close the menu.
-
-By default, all trades will be processed in accounting, but you can ignore unwanted trades, so they won't be processed.
-You can select the checkbox on the left part of each entry and click `Ignore`/`Unignore`.
-
-![Ignore trades](/images/sc_history_trades_ignore.png)
-
-## History Events
+# History events
 
 rotki is capable of pulling and decoding a bunch of different events, ranging from EVM chain transactions to exchanges events and more. When you visit the `History Events` section the process to obtain all the information will start. You will be able to check the status in an informative breakdown per blockchain address. Free users are limited to a number of latest events.
 
----
+## Supported events
 
 Currently, these events are detected automatically by rotki:
 
@@ -65,10 +12,11 @@ Currently, these events are detected automatically by rotki:
 - ETH block events
 - ETH deposit events
 - Asset movement events (deposits and withdrawals).
+- Swap events (trades).
 
 Additionally, you can add your custom events.
 
----
+## Events filtering
 
 History events can be filtered if you have a premium subscription activated. You can filter by:
 
@@ -86,19 +34,19 @@ History events can be filtered if you have a premium subscription activated. You
 - Only show customized events
 - ... more
 
-![History events query status breakdown](/images/events_query_process.png)
+![History events query status](/images/events_query_process.png)
 
-### Ignore events in accounting
-
-By default, all events will be processed in accounting, but you can ignore unwanted events, so they won't be processed. You can click on the three dots to display the options for the group of events, and click `Ignore events in accounting`/`Unignore events in accounting`.
-
-### Export History Events as CSV
+## Export history events as CSV
 
 Events can be exported as CSV, click on `Export CSV` button and accept prompt to download exported events.
 
 ![Button to download events as csv](/images/events_csv_export.png)
 
-### Redecoding EVM transactions
+## Ignore events in accounting
+
+By default, all events will be processed in accounting, but you can ignore unwanted events, so they won't be processed. You can click on the three dots to display the options for the group of events, and click `Ignore events in accounting`/`Unignore events in accounting`.
+
+## Redecoding EVM transactions
 
 It is possible that you need to redecode events for an EVM transaction. To do that you have two options. The first of them is to click on the three dots to display the options for an EVM transaction and click on `Redecode events`. This will start the process to read the transaction's events again and try to understand what happened in them. If there are any custom events in the transaction, there will be one more confirmation, asking whether to also reset these custom events or not.
 
@@ -118,18 +66,28 @@ You will see the status of the EVM events redecoding.
 
 EVM Transactions and the events can be deleted, but to restore them you will have to either purge all transactions or add by the transaction hash.
 
-### Add transaction by hash
+## Delete event
+
+![Menu to delete EVM transactions events](/images/delete_transaction_events.png)
+
+## Add transaction by hash
 
 ![Add transaction by hash](/images/add_tx_by_hash.png)
 
 If you want to add a transaction that was either deleted or for some reason missed, or was not found by rotki, you can add it by transaction hash by clicking the menu as seen in the picture.
 
-![Menu to delete EVM transactions events](/images/delete_transaction_events.png)
+## Re-Pulling Transactions
+
+You can re-pull EVM transactions for a specific account within a selected time range, in case any past issues prevented events from being retrieved properly.
+
+## Missing accounting rule
 
 If you see this warning button, it means the event won't be processed correctly in accounting. It could be due to improper decoding or a missing accounting rule for that event. You can fix it by editing the event or adding the missing accounting rule. You can also edit the events if they have special meaning to you, such as OTC trades or transfers between accounts.
 
 ![The button indicates that the event won't be processed correctly.](/images/event_not_processed.png)
 
+## Add / edit events
+
 There are 6 types of events in rotki:
 
 :::tabs
@@ -180,6 +138,8 @@ Here the non obvious fields are:
 == Asset Movement Event
 ![Asset movement event form](/images/events_asset_movement_form.png)
 
+== Swap Event
+![Swap event form](/images/events_swap_event_form.png)
 :::
 
 For history event, and EVM history event, if any event was not decoded the way you expected it to be, you can always customize events using the settings described above or file a bug report on our github repository / in our discord server. The customizations that you make also affect how events are processed in accounting.

public/images/events_asset_movement_form.png

@@ -0,0 +1,35 @@
+# On-Chain Transactions
+
+rotki allows you to perform on-chain transactions by connecting your wallet (either through a browser wallet or WalletConnect).
+Currently, rotki only supports sending native tokens and ERC-20 tokens.
+
+![On chain send tokens](/images/onchain_send.png)
+
+::: info
+You can only send tokens from an address that is registered as an EVM account in rotki. Otherwise, rotki won't be able to retrieve the list of tokens.
+:::
+
+## Connect to a Browser Wallet from the Electron App
+
+If you're using rotki via the Electron app, you won't be able to connect directly to your browser wallet. Instead, rotki provides a bridge for this purpose. Follow these steps:
+
+1. Click the "Open Browser Wallet Bridge" button. This will open a page in your browser.
+   ![Open browser wallet bridge](/images/onchain_browser_wallet_bridge_1.png)
+
+2. On the bridge page, the first step is to connect it to your browser wallet.
+   ![Connect wallet in browser wallet bridge](/images/onchain_browser_wallet_bridge_2.png)
+
+3. Once connected, the page should display your wallet status.
+   ![Wallet connect bridge connected](/images/onchain_browser_wallet_bridge_3.png)
+
+4. Now you’ll need the `WalletConnect Pair URI`. Go back to the Electron app, click `Connect Wallet`, and choose `WalletConnect`.
+   ![Wallet Connect](/images/onchain_browser_wallet_bridge_4.png)
+
+5. Wait for the QR code to appear, then click `Copy Link`. The Pair URI will be copied to your clipboard. It will look something like this:
+   `wc:0579c1fee69aad512b6ef19a977a08f6c60b19415661cfa2882039da038a24fb@2?relay-protocol=irn&symKey=55d16a7cfc2198dfc1058254a7862c98aad401814bb86219041687d5b6de4020&expiryTimestamp=1744297123`
+   ![Copy Wallet Connect pairing URI](/images/onchain_browser_wallet_bridge_5.png)
+
+6. Return to the bridge page in your browser, paste the Pair URI, and click `Start Pairing`.
+   ![Wallet Connect bridge start pairing](/images/onchain_browser_wallet_bridge_6.png)
+
+You're now connected and can perform transactions from the Electron app.