feat: add params to save swap history

apps/docs/pages/core/modules/exchange.mdx

@@ -47,7 +47,9 @@ walletApiClient.exchange.complete(params: {
   hexSignature: string,
   feeStrategy: 'SLOW' | 'MEDIUM' | 'FAST',
   exchangeType: 'SWAP' | 'SELL' | 'FUND',
-  toAccountId?: string
+  toAccountId?: string,
+  swapId?: string,
+  rate?: number,
 }): Promise<{ transactionHash: string }>
 ```
 
@@ -60,6 +62,8 @@ walletApiClient.exchange.complete(params: {
 - `feeStrategy` (required): A string representing the fee strategy (`"SLOW"`, `"MEDIUM"`, or `"FAST"`).
 - `exchangeType` (required): A string specifying the type of exchange operation (`"SWAP"`, `"SELL"`, or `"FUND"`).
 - `toAccountId` (optional): Identifier of the account used as a destination (required for `"SWAP"`).
+- `swapId` (optional): Identifier of the backend swap used (required for `"SWAP"`).
+- `rate` (optional): Swap rate used in the transaction (required for `"SWAP"`).
 
 **Returns**: A promise that resolves with an object containing the `transactionHash` of the broadcasted transaction.
 

apps/wallet-api-tools/src/TemplateSelector/index.tsx

@@ -258,6 +258,8 @@ const data: Group[] = [
             hexBinaryPayload: "",
             hexSignature: "",
             feeStrategy: "SLOW | MEDIUM | FAST | CUSTOM",
+            swapId: "1234",
+            rate: 1,
           },
         },
       },

packages/client/src/modules/Exchange.ts

@@ -42,6 +42,8 @@ export class ExchangeModule {
    * @param provider - Used to verify the signature
    * @param fromAccountId - Identifier of the account used as a source for the tx
    * @param toAccountId - Identifier of the account used as a destination
+   * @param swapId - Identifier of the swap used by backend
+   * @param rate - Swap rate in the transaction
    * @param transaction - Transaction containing the recipient and amount
    * @param binaryPayload - Blueprint of the data that we'll allow signing
    * @param signature - Ensures the source of the payload
@@ -54,6 +56,8 @@ export class ExchangeModule {
     provider,
     fromAccountId,
     toAccountId,
+    swapId,
+    rate,
     transaction,
     binaryPayload,
     signature,
@@ -62,6 +66,8 @@ export class ExchangeModule {
     provider: string;
     fromAccountId: string;
     toAccountId: string;
+    swapId: string;
+    rate: number;
     transaction: Transaction;
     binaryPayload: Buffer;
     signature: Buffer;
@@ -74,6 +80,8 @@ export class ExchangeModule {
         provider,
         fromAccountId,
         toAccountId,
+        swapId,
+        rate,
         rawTransaction: serializeTransaction(transaction),
         hexBinaryPayload: binaryPayload.toString("hex"),
         hexSignature: signature.toString("hex"),

packages/core/src/spec/types/ExchangeComplete.ts

@@ -26,6 +26,8 @@ const schemaExchangeCompleteSwapParams =
   schemaExchangeCompleteBaseParams.extend({
     exchangeType: z.literal("SWAP"),
     toAccountId: z.string(),
+    swapId: z.string(),
+    rate: z.number(),
   });
 
 const schemaExchangeCompleteParams = z.discriminatedUnion("exchangeType", [

packages/server/src/internalHandlers/exchange.ts

@@ -78,6 +78,8 @@ export const complete: RPCHandler<ExchangeComplete["result"]> = async (
       ...commonParams,
       exchangeType: safeParams.exchangeType,
       toAccount,
+      swapId: safeParams.swapId,
+      rate: safeParams.rate,
     });
 
     return { transactionHash };

packages/server/src/types.ts

@@ -48,6 +48,8 @@ type ExchangeSellParams = {
 type ExchangeSwapParams = {
   exchangeType: "SWAP";
   toAccount: Account;
+  swapId: string;
+  rate: number;
 } & ExchangeBaseParams;
 
 type ExchangeParams =

spec/rpc/README.md

@@ -360,6 +360,8 @@ Returns the broadcasted transaction details.
 - `signature (hexString)`: Ensures the source of the payload
 - `feesStrategy (FeesLevel)`: Slow / Medium / Fast
 - `exchangeType (ExchangeType)`: used by the exchange transport to discern between swap/sell/fund
+- `swapId (string)`: (Swap) Live identifier of the swap used by backend
+- `rate (number)`: (Swap) Rate provider used in the transaction
 
 #### Request
 
@@ -376,7 +378,9 @@ Returns the broadcasted transaction details.
     "binaryPayload": "",
     "signature": "",
     "feesStrategy": "medium",
-    "exchangeType": "SWAP"
+    "exchangeType": "SWAP",
+    "swapId": "1234",
+    "rate": 1,
   }
 }
 ```