refactor(sdk-coin-ton): add support to use custom sub wallet id

Ticket: WIN-7823

Author: veetragjain

modules/sdk-coin-ton/CHANGELOG.md

@@ -5,88 +5,48 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ## [3.10.3](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.10.2...@bitgo/sdk-coin-ton@3.10.3) (2025-11-06)
 
-
 ### Bug Fixes
 
-* **sdk-coin-ton:** build tx using tx builder factory ([ef94b98](https://github.com/BitGo/BitGoJS/commit/ef94b98976789ce0b967933d2e0d1ed7ea4f4b37))
-
-
-
-
+- **sdk-coin-ton:** build tx using tx builder factory ([ef94b98](https://github.com/BitGo/BitGoJS/commit/ef94b98976789ce0b967933d2e0d1ed7ea4f4b37))
 
 ## [3.10.2](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.10.1...@bitgo/sdk-coin-ton@3.10.2) (2025-10-31)
 
 **Note:** Version bump only for package @bitgo/sdk-coin-ton
 
-
-
-
-
 ## [3.10.1](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.10.0...@bitgo/sdk-coin-ton@3.10.1) (2025-10-29)
 
 **Note:** Version bump only for package @bitgo/sdk-coin-ton
 
-
-
-
-
 # [3.10.0](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.7...@bitgo/sdk-coin-ton@3.10.0) (2025-10-24)
 
-
 ### Features
 
-* **sdk-coin-ton:** add wallet contract v3 transaction support ([b5653fb](https://github.com/BitGo/BitGoJS/commit/b5653fb7678d5b7b418bba682dc501d4f495b848))
-
-
-
-
+- **sdk-coin-ton:** add wallet contract v3 transaction support ([b5653fb](https://github.com/BitGo/BitGoJS/commit/b5653fb7678d5b7b418bba682dc501d4f495b848))
 
 ## [3.9.7](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.6...@bitgo/sdk-coin-ton@3.9.7) (2025-10-21)
 
 **Note:** Version bump only for package @bitgo/sdk-coin-ton
 
-
-
-
-
 ## [3.9.6](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.5...@bitgo/sdk-coin-ton@3.9.6) (2025-10-16)
 
 **Note:** Version bump only for package @bitgo/sdk-coin-ton
 
-
-
-
-
 ## [3.9.5](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.4...@bitgo/sdk-coin-ton@3.9.5) (2025-10-13)
 
 **Note:** Version bump only for package @bitgo/sdk-coin-ton
 
-
-
-
-
 ## [3.9.4](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.3...@bitgo/sdk-coin-ton@3.9.4) (2025-10-09)
 
-
 ### Bug Fixes
 
-* run check-fmt on code files only ([9745196](https://github.com/BitGo/BitGoJS/commit/9745196b02b9678c740d290a4638ceb153a8fd75))
-
-
-
-
+- run check-fmt on code files only ([9745196](https://github.com/BitGo/BitGoJS/commit/9745196b02b9678c740d290a4638ceb153a8fd75))
 
 ## [3.9.3](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.2...@bitgo/sdk-coin-ton@3.9.3) (2025-10-08)
 
-
 ### Bug Fixes
 
-* add explicit 'files' in package json ([3b00373](https://github.com/BitGo/BitGoJS/commit/3b0037396f6ac16bb9380bd85bf37f2b133068f4))
-* **sdk-coin-ton:** parse token transactions correctly ([4fd4c0a](https://github.com/BitGo/BitGoJS/commit/4fd4c0a769e46bfe5d3a187e1a9c0ecfc72bc5e2))
-
-
-
-
+- add explicit 'files' in package json ([3b00373](https://github.com/BitGo/BitGoJS/commit/3b0037396f6ac16bb9380bd85bf37f2b133068f4))
+- **sdk-coin-ton:** parse token transactions correctly ([4fd4c0a](https://github.com/BitGo/BitGoJS/commit/4fd4c0a769e46bfe5d3a187e1a9c0ecfc72bc5e2))
 
 ## [3.9.2](https://github.com/BitGo/BitGoJS/compare/@bitgo/sdk-coin-ton@3.9.1...@bitgo/sdk-coin-ton@3.9.2) (2025-10-02)
 

modules/sdk-coin-ton/src/lib/constants.ts

@@ -1,3 +1,4 @@
+export const VESTING_CONTRACT_WALLET_ID = 268;
 export const WALLET_ID = 698983191;
 export const JETTON_TRANSFER_OPCODE = 0x0f8a7ea5;
 export const WITHDRAW_OPCODE = '00001000';

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

@@ -14,6 +14,7 @@ export interface TxData {
   seqno: number;
   expirationTime: number;
   publicKey: string;
+  sub_wallet_id: number;
   signature: string;
   bounceable: boolean;
 }

modules/sdk-coin-ton/src/lib/transaction.ts

@@ -5,7 +5,7 @@ import { Cell } from 'tonweb/dist/types/boc/cell';
 import { BaseKey, BaseTransaction, Entry, Recipient, TransactionRecipient, TransactionType } from '@bitgo/sdk-core';
 import { BaseCoin as CoinConfig } from '@bitgo/statics';
 import { TransactionExplanation, TxData } from './iface';
-import { WITHDRAW_OPCODE, WALLET_ID, JETTON_TRANSFER_OPCODE } from './constants';
+import { WITHDRAW_OPCODE, WALLET_ID, JETTON_TRANSFER_OPCODE, VESTING_CONTRACT_WALLET_ID } from './constants';
 
 export class Transaction extends BaseTransaction {
   public recipient: Recipient;
@@ -19,6 +19,7 @@ export class Transaction extends BaseTransaction {
   sender: string;
   publicKey: string;
   isV3ContractMessage: boolean;
+  sub_wallet_id: number;
   protected unsignedMessage: string;
   protected finalMessage: string;
 
@@ -52,6 +53,7 @@ export class Transaction extends BaseTransaction {
       amount: this.recipient.amount,
       withdrawAmount: this.withdrawAmount,
       seqno: this.seqno,
+      sub_wallet_id: this.sub_wallet_id,
       expirationTime: this.expireTime,
       publicKey: this.publicKey,
       signature: this._signatures[0],
@@ -72,7 +74,14 @@ export class Transaction extends BaseTransaction {
   }
 
   async build(): Promise<void> {
-    const signingMessage = this.createSigningMessage(WALLET_ID, this.seqno, this.expireTime);
+    if (!this.sub_wallet_id) {
+      if (this.isV3ContractMessage) {
+        this.sub_wallet_id = VESTING_CONTRACT_WALLET_ID;
+      } else {
+        this.sub_wallet_id = WALLET_ID;
+      }
+    }
+    const signingMessage = this.createSigningMessage(this.sub_wallet_id, this.seqno, this.expireTime);
     const sendMode = 3; // default sendMode
     signingMessage.bits.writeUint8(sendMode);
     const outMsg = this.createOutMsg(this.recipient.address, this.recipient.amount, this.message);
@@ -189,6 +198,7 @@ export class Transaction extends BaseTransaction {
       this.message = parsed.payload;
       this._signatures.push(parsed.signature);
       this.bounceable = parsed.bounce;
+      this.sub_wallet_id = parsed.walletId;
     } catch (e) {
       throw new Error('invalid raw transaction');
     }
@@ -263,7 +273,7 @@ export class Transaction extends BaseTransaction {
     // signing message
 
     const walletId = slice.loadUint(32).toNumber();
-    if (walletId !== WALLET_ID) throw new Error('invalid walletId');
+    if (walletId !== WALLET_ID && walletId !== VESTING_CONTRACT_WALLET_ID) throw new Error('invalid walletId');
 
     const expireAt = slice.loadUint(32).toNumber();
 

modules/sdk-coin-ton/src/lib/transactionBuilder.ts

@@ -184,4 +184,8 @@ export abstract class TransactionBuilder extends BaseTransactionBuilder {
     this.transaction.isV3ContractMessage = bool;
     return this;
   }
+  subWalletId(id: number): TransactionBuilder {
+    this.transaction.sub_wallet_id = id;
+    return this;
+  }
 }

modules/sdk-coin-ton/test/unit/transferBuilder.ts

@@ -3,6 +3,7 @@ import TonWeb from 'tonweb';
 import { TransactionType } from '@bitgo/sdk-core';
 import { coins } from '@bitgo/statics';
 import { TransactionBuilderFactory, KeyPair } from '../../src';
+import { WALLET_ID } from '../../src/lib/constants';
 import * as testData from '../resources/ton';
 import * as utils from '../../src/lib/utils';
 
@@ -258,5 +259,6 @@ describe('Ton Transfer Builder', () => {
     jsonTx.seqno.should.equal(3);
     jsonTx.expirationTime.should.equal(1761215512);
     jsonTx.bounceable.should.equal(true);
+    jsonTx.sub_wallet_id.should.equal(WALLET_ID);
   });
 });