feat: consolidate NFTs without address input

TICKET: COIN-3872

Author: bhavidhingra

examples/ts/nft/list-wallet-addresses-by-balance.ts

@@ -0,0 +1,29 @@
+/**
+ * List address of an NFT on a wallet.
+ *
+ * Copyright 2025, BitGo, Inc.  All Rights Reserved.
+ */
+import { BitGoAPI } from '@bitgo/sdk-api';
+import { Tapt } from "@bitgo/sdk-coin-apt";
+require('dotenv').config({ path: '../../../.env' });
+
+const bitgo = new BitGoAPI({
+  accessToken: process.env.TESTNET_ACCESS_TOKEN,
+  env: 'test',
+});
+
+const coin = 'tapt';
+bitgo.register(coin, Tapt.createInstance);
+
+const walletId = '';
+
+async function main() {
+  const wallet = await bitgo.coin(coin).wallets().get({ id: walletId });
+  const addresses = await wallet.addressesByBalance({
+    nftCollectionId: '',
+    nftId: '',
+  });
+  console.log(JSON.stringify(addresses.addresses));
+}
+
+main().catch((e) => console.error(e));

examples/ts/nft/nft-consolidation-send.ts

@@ -32,7 +32,6 @@ async function main() {
 
   const sendConsolidations = await wallet.sendAccountConsolidations({
     walletPassphrase,
-    consolidateAddresses: [''],
     nftCollectionId: '',
     nftId: '',
   });

modules/sdk-core/src/bitgo/wallet/iWallet.ts

@@ -423,7 +423,9 @@ export interface AddressesOptions extends PaginationOptions {
 }
 
 export interface AddressesByBalanceOptions extends PaginationOptions {
-  token: string;
+  token?: string;
+  nftCollectionId?: string;
+  nftId?: string;
   sort?: number;
 }
 

modules/sdk-core/src/bitgo/wallet/wallet.ts

@@ -1155,6 +1155,8 @@ export class Wallet implements IWallet {
   async addressesByBalance(params: AddressesByBalanceOptions): Promise<any> {
     const query: AddressesByBalanceOptions = {
       token: params.token,
+      nftCollectionId: params.nftCollectionId,
+      nftId: params.nftId,
     };
     query.sort = params.sort ?? -1;
     query.page = params.page ?? 1;
@@ -1166,10 +1168,10 @@ export class Wallet implements IWallet {
     if (!_.isNumber(query.page)) {
       throw new Error('invalid page argument, expecting number');
     }
-    if (!_.isNumber(params.limit)) {
+    if (!_.isNumber(query.limit)) {
       throw new Error('invalid limit argument, expecting number');
     }
-    if (params.limit < 1 || params.limit > 500) {
+    if (query.limit < 1 || query.limit > 500) {
       throw new Error('limit argument must be between 1 and 500');
     }