Merge pull request #6202 from BitGo/coin-3872-consolidate-nfts-without-address

chore: assert both nftCollectionId and nftId

Author: bhavidhingra

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

@@ -4,7 +4,7 @@
  * Copyright 2025, BitGo, Inc.  All Rights Reserved.
  */
 import { BitGoAPI } from '@bitgo/sdk-api';
-import { Tapt } from "@bitgo/sdk-coin-apt";
+import { Tapt } from '@bitgo/sdk-coin-apt';
 require('dotenv').config({ path: '../../../.env' });
 
 const bitgo = new BitGoAPI({

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

@@ -1175,6 +1175,13 @@ export class Wallet implements IWallet {
       throw new Error('limit argument must be between 1 and 500');
     }
 
+    // Assert that either both nftCollectionId and nftId are provided or neither are provided
+    const hasNftCollectionId = !_.isUndefined(query.nftCollectionId);
+    const hasNftId = !_.isUndefined(query.nftId);
+    if (hasNftCollectionId !== hasNftId) {
+      throw new Error('nftCollectionId and nftId must both be provided or both be omitted');
+    }
+
     return this.bitgo
       .get(this.baseCoin.url('/wallet/' + this._wallet.id + '/addresses/balances'))
       .query(query)