feat: added optional token field in canton

transfer builder

Ticket: COIN-7303

Author: ravibitgo

modules/sdk-coin-canton/src/lib/iface.ts

@@ -152,4 +152,5 @@ export interface CantonTransferRequest {
   expiryEpoch: number;
   sendViaOneStep: boolean;
   memoId?: string;
+  token?: string;
 }

modules/sdk-coin-canton/src/lib/transferBuilder.ts

@@ -13,6 +13,7 @@ export class TransferBuilder extends TransactionBuilder {
   private _sendOneStep = false;
   private _expiryEpoch: number;
   private _memoId: string;
+  private _token: string;
   constructor(_coinConfig: Readonly<CoinConfig>) {
     super(_coinConfig);
   }
@@ -145,6 +146,20 @@ export class TransferBuilder extends TransactionBuilder {
     return this;
   }
 
+  /**
+   * Sets the optional token field if present, used for canton token transaction
+   * @param name - the bitgo name of the token
+   * @returns The current builder for chaining
+   * @throws Error if name is invalid
+   */
+  token(name: string): this {
+    if (!name || !name.trim()) {
+      throw new Error('token name must be a non-empty string');
+    }
+    this._token = name.trim();
+    return this;
+  }
+
   /**
    * Get the canton transfer request object
    * @returns CantonTransferRequest
@@ -163,6 +178,9 @@ export class TransferBuilder extends TransactionBuilder {
     if (this._memoId) {
       data.memoId = this._memoId;
     }
+    if (this._token) {
+      data.token = this._token;
+    }
     return data;
   }