Merge pull request #905 from lightninglabs/docs-taproot-assets

Update taproot-assets documentation

Author: github-actions[bot]

docs/taproot-assets/release-notes/release-notes-0.7.0.md

@@ -26,6 +26,16 @@
 - [An integration test flake was
   fixed](https://github.com/lightninglabs/taproot-assets/pull/1651).
 
+- Fixed two send related bugs that would lead to either a `invalid transfer 
+  asset witness` or `unable to fund address send: error funding packet: unable 
+  to list eligible coins: unable to query commitments: mismatch of managed utxo
+  and constructed tap commitment root` error when sending assets.
+  The [PR that fixed the two
+  bugs](https://github.com/lightninglabs/taproot-assets/pull/1741) also
+  optimized sending to V2 TAP addresses by removing the need for creating
+  tombstone outputs on a full-value send (by using interactive transfers for V2
+  addresses).
+
 # New Features
 
 ## Functional Enhancements
@@ -81,6 +91,15 @@
   tag and also needs to be toggled on via the `channel.noop-htlcs` configuration
   option.
 
+- [Two new configuration values were added to improve privacy when using public
+  or untrusted third-party price
+  oracles](https://github.com/lightninglabs/taproot-assets/pull/1677):
+  `experimental.rfq.sendpricehint` controls whether a price hint is queried
+  from the local price oracle and sent to the peer when requesting a price
+  quote (opt-in, default `false`). `experimental.rfq.priceoraclesendpeerid`
+  controls whether the peer's identity public key is sent to the local price
+  oracle when querying asset price rates.
+
 ## RPC Additions
 
 - The [price oracle RPC calls now have an intent, optional peer ID and metadata

docs/taproot-assets/rfq-and-decimal-display.md

@@ -208,6 +208,42 @@ convert from mSAT to asset units as follows:
   `price_in_asset`
    * `Y` is the number of asset units per BTC, specified by `price_out_asset`
 
+### Price oracle interaction
+
+```mermaid
+sequenceDiagram
+    actor User
+    box Seller (user)
+    participant NodeA as Node A
+    participant OracleA as Price Oracle A
+    end
+    box Buyer (edge node)
+    participant NodeB as Node B
+    participant OracleB as Price Oracle B
+    end
+
+    User->>+NodeA: SendPayment
+    
+    NodeA->>+NodeA: AddAssetSellOrder
+
+    NodeA->>+OracleA: Get price rate hint<br/>(QueryAssetRate[type=SALE,intent=PAY_INVOICE_HINT,peer=NodeB])
+    OracleA-->>-NodeA: Price rate hint
+
+    NodeA->>+NodeB: Send sell request with price<br/>rate hint over p2p
+
+    NodeB->>+OracleB: Determine actual price<br/>rate using suggested price<br/>(QueryAssetRate[type=PURCHASE,intent=PAY_INVOICE,peer=NodeA])
+    OracleB-->>-NodeB: Actual price rate
+
+    NodeB-->>-NodeA: Return actual price rate
+
+    NodeA->>+OracleA: Validate actual price rate<br/>(QueryAssetRate[type=SALE,intent=PAY_INVOICE_QUALIFY,peer=NodeB])
+    OracleA-->>-NodeA: Approve actual price rate
+    
+    NodeA->>-NodeA: Send payment over LN using approved actual price rate
+    
+    NodeA->>-User: Payment result
+```
+
 ## Buy Order (Receiving via an Invoice)
 
 The buy order covers the second user story: The user wants to get paid, they
@@ -245,6 +281,43 @@ node as:
     * `M` is the number of mSAT in a BTC (100,000,000,000), specified by
       `price_in_asset`
 
+### Price oracle interaction
+
+```mermaid
+sequenceDiagram
+    actor User
+    box Buyer (user)
+        participant NodeA as Node A
+        participant OracleA as Price Oracle A
+    end
+    box Seller (edge node)
+        participant NodeB as Node B
+        participant OracleB as Price Oracle B
+    end
+
+    User->>+NodeA: AddInvoice
+
+    NodeA->>+NodeA: AddAssetBuyOrder
+
+    NodeA->>+OracleA: Get price rate hint<br/>(QueryAssetRate[type=PURCHASE,intent=RECV_PAYMENT_HINT,peer=NodeB])
+    OracleA-->>-NodeA: Price rate hint
+
+    NodeA->>+NodeB: Send buy request with price<br/>rate hint over p2p
+
+    NodeB->>+OracleB: Determine actual price<br/>rate using suggested price<br/>(QueryAssetRate[type=SALE,intent=RECV_PAYMENT,peer=NodeA])
+    OracleB-->>-NodeB: Actual price rate
+
+    NodeB-->>-NodeA: Return actual price rate
+
+    NodeA->>+OracleA: Validate actual price rate<br/>(QueryAssetRate[type=PURCHASE,intent=RECV_PAYMENT_QUALIFY,peer=NodeB])
+    OracleA-->>-NodeA: Approve actual price rate
+
+    NodeA->>-NodeA: Create invoice using actual price rate
+
+    NodeA->>-User: Invoice
+```
+
+
 ## Examples
 
 See `TestFindDecimalDisplayBoundaries` and `TestUsdToJpy`  in