feat: send digital asset

TICKET: COIN-3820

Author: bhavidhingra

examples/ts/nft/get-wallet-nfts.ts

@@ -0,0 +1,31 @@
+/**
+ * Get the NFT balance of a wallet at BitGo.
+ * This makes use of the convenience function wallets().get()
+ *
+ * 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: '',
+  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, allTokens: true });
+
+  console.log('\nWallet ID:', wallet.id());
+  console.log('\nSupported NFTs:', );
+  console.log(wallet.nftBalances());
+  console.log('\nUnsupported NFTs:', );
+  console.log(wallet.unsupportedNftBalances());
+}
+
+main().catch((e) => console.error(e));

examples/ts/nft/send-wallet-nfts.ts

@@ -0,0 +1,42 @@
+/**
+ * Send an NFT of a wallet at BitGo.
+ *
+ * Copyright 2025, BitGo, Inc.  All Rights Reserved.
+ */
+import { BitGoAPI } from '@bitgo/sdk-api';
+import { Tapt } from "@bitgo/sdk-coin-apt";
+import { TokenType } from "@bitgo/sdk-core";
+
+require('dotenv').config({ path: '../../../.env' });
+
+const bitgo = new BitGoAPI({
+  accessToken: '',
+  env: 'test',
+});
+
+const coin = 'tapt';
+bitgo.register(coin, Tapt.createInstance);
+
+const walletId = '';
+
+async function main() {
+  bitgo.unlock({ otp: '000000' });
+  const wallet = await bitgo.coin(coin).wallets().get({id: walletId, allTokens: true});
+
+  console.log('\nWallet ID:', wallet.id());
+  console.log('\nSupported NFTs:', );
+  console.log(wallet.nftBalances());
+
+  const resp = await wallet.sendNft({
+    walletPassphrase: '',
+    type: 'transfer',
+  }, {
+    type: TokenType.DIGITAL_ASSET,
+    tokenId: '0x6dac741daaf6ee98d91b0d88df7e169b0110f2e3b14b998896aa36c8e54b3449',
+    tokenContractAddress: '0xbbc561fbfa5d105efd8dfb06ae3e7e5be46331165b99d518f094c701e40603b5',
+    recipientAddress: '0x9fef749050644625012a2c866973775e7123753b3eef0a1a4037453ac26d79bf',
+  });
+  console.log('\nSend NFT Response:', resp);
+}
+
+main().catch((e) => console.error(e));

modules/abstract-eth/src/abstractEthLikeNewCoins.ts

@@ -2728,6 +2728,9 @@ export abstract class AbstractEthLikeNewCoins extends AbstractEthLikeCoin {
 
         return transferBuilder.build();
       }
+
+      default:
+        throw new Error(`Unsupported NFT type: ${params.type}`);
     }
   }
 

modules/sdk-core/src/bitgo/baseCoin/iBaseCoin.ts

@@ -14,7 +14,7 @@ import { IWebhooks } from '../webhook/iWebhooks';
 import { TransactionType } from '../../account-lib';
 import { IInscriptionBuilder } from '../inscriptionBuilder';
 import { Hash } from 'crypto';
-import { MPCTx, PopulatedIntent } from '../utils';
+import { MPCTx, PopulatedIntent, TokenType } from '../utils';
 
 export const multisigTypes = {
   onchain: 'onchain',
@@ -449,7 +449,7 @@ export type NFTTransferOptions = {
   recipientAddress: string;
 } & (
   | {
-      type: 'ERC721';
+      type: 'ERC721' | TokenType.DIGITAL_ASSET;
       tokenId: string;
     }
   | {

modules/sdk-core/src/bitgo/utils/tss/baseTypes.ts

@@ -148,6 +148,7 @@ export enum TokenType {
   ERC721 = 'ERC721',
   ERC1155 = 'ERC1155',
   ERC20 = 'ERC20',
+  DIGITAL_ASSET = 'Digital Asset',
 }
 export interface TokenTransferRecipientParams {
   tokenType: TokenType;

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

@@ -646,6 +646,7 @@ export interface SendManyOptions extends PrebuildAndSignTransactionOptions {
     feeLimit?: string;
     data?: string;
     tokenName?: string;
+    tokenData?: TokenTransferRecipientParams;
   }[];
   numBlocks?: number;
   feeRate?: number;

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

@@ -25,26 +25,30 @@ import { decryptKeychainPrivateKey, Keychain, KeychainWithEncryptedPrv } from '.
 import { IPendingApproval, PendingApproval, PendingApprovals } from '../pendingApproval';
 import { TradingAccount } from '../trading';
 import {
-  inferAddressType,
-  RequestTracer,
-  TxRequest,
   EddsaUnsignedTransaction,
+  inferAddressType,
   IntentOptionsForMessage,
   IntentOptionsForTypedData,
+  RequestTracer,
   RequestType,
+  TokenTransferRecipientParams,
+  TokenType,
+  TxRequest,
 } from '../utils';
 import {
   AccelerateTransactionOptions,
   AddressesOptions,
   BuildConsolidationTransactionOptions,
   BuildTokenEnablementOptions,
+  BulkCreateShareOption,
+  BulkWalletShareKeychain,
+  BulkWalletShareOptions,
   ChangeFeeOptions,
   ConsolidateUnspentsOptions,
   CreateAddressOptions,
+  CreateBulkWalletShareListResponse,
   CreatePolicyRuleOptions,
   CreateShareOptions,
-  BulkCreateShareOption,
-  BulkWalletShareOptions,
   CrossChainUTXO,
   DeployForwardersOptions,
   DownloadKeycardOptions,
@@ -54,13 +58,15 @@ import {
   ForwarderBalance,
   ForwarderBalanceOptions,
   FreezeOptions,
+  FundForwarderParams,
   FundForwardersOptions,
   GetAddressOptions,
   GetPrvOptions,
   GetTransactionOptions,
   GetTransferOptions,
   GetUserPrvOptions,
   IWallet,
+  ManageUnspentReservationOptions,
   MaximumSpendable,
   MaximumSpendableOptions,
   ModifyWebhookOptions,
@@ -76,7 +82,9 @@ import {
   SendNFTOptions,
   SendNFTResult,
   SendOptions,
+  SharedKeyChain,
   ShareWalletOptions,
+  SignAndSendTxRequestOptions,
   SimulateWebhookOptions,
   SubmitTransactionOptions,
   SubWalletType,
@@ -94,12 +102,6 @@ import {
   WalletSignTransactionOptions,
   WalletSignTypedDataOptions,
   WalletType,
-  CreateBulkWalletShareListResponse,
-  SharedKeyChain,
-  BulkWalletShareKeychain,
-  ManageUnspentReservationOptions,
-  SignAndSendTxRequestOptions,
-  FundForwarderParams,
 } from './iWallet';
 import { GoStakingWallet, StakingWallet } from '../staking';
 import EddsaUtils from '../utils/tss/eddsa';
@@ -2405,7 +2407,7 @@ export class Wallet implements IWallet {
     if (!this.baseCoin.isValidAddress(recipientAddress)) {
       throw new Error(`Invalid recipient address ${recipientAddress}`);
     }
-    const baseAddress = this.coinSpecific()?.baseAddress;
+    const baseAddress = this.coinSpecific()?.baseAddress || this.coinSpecific()?.rootAddress;
     if (!baseAddress) {
       throw new Error('Missing base address for wallet');
     }
@@ -2463,6 +2465,30 @@ export class Wallet implements IWallet {
           ],
         });
       }
+
+      case TokenType.DIGITAL_ASSET: {
+        if (!nftBalance.collections[sendNftOptions.tokenId]) {
+          throw new Error(
+            `Token ${sendNftOptions.tokenId} not found in collection ${tokenContractAddress} or does not have a spendable balance`
+          );
+        }
+        const tokenData: TokenTransferRecipientParams = {
+          tokenType: sendNftOptions.type,
+          tokenQuantity: '1', // This NFT standard will always have quantity of 1
+          tokenContractAddress,
+          tokenId: sendNftOptions.tokenId,
+        };
+        return this.sendMany({
+          ...sendOptions,
+          recipients: [
+            {
+              address: recipientAddress,
+              amount: '1', // the amount needs to be non-zero for the transaction to be valid, it is ignored
+              tokenData,
+            },
+          ],
+        });
+      }
     }
   }
 

yarn.lock

@@ -12148,18 +12148,7 @@ html-minifier-terser@^6.0.2:
     tapable "^1.1.3"
     util.promisify "1.0.0"
 
-"html-webpack-plugin-5@npm:html-webpack-plugin@^5":
-  version "5.6.3"
-  resolved "https://registry.npmjs.org/html-webpack-plugin/-/html-webpack-plugin-5.6.3.tgz#a31145f0fee4184d53a794f9513147df1e653685"
-  integrity sha512-QSf1yjtSAsmf7rYBV7XX86uua4W/vkhIt0xNXKbsi2foEeW7vjJQz4bhnpL3xH+l1ryl1680uNv968Z+X6jSYg==
-  dependencies:
-    "@types/html-minifier-terser" "^6.0.0"
-    html-minifier-terser "^6.0.2"
-    lodash "^4.17.21"
-    pretty-error "^4.0.0"
-    tapable "^2.0.0"
-
-html-webpack-plugin@^5.5.0:
+"html-webpack-plugin-5@npm:html-webpack-plugin@^5", html-webpack-plugin@^5.5.0:
   version "5.6.3"
   resolved "https://registry.npmjs.org/html-webpack-plugin/-/html-webpack-plugin-5.6.3.tgz#a31145f0fee4184d53a794f9513147df1e653685"
   integrity sha512-QSf1yjtSAsmf7rYBV7XX86uua4W/vkhIt0xNXKbsi2foEeW7vjJQz4bhnpL3xH+l1ryl1680uNv968Z+X6jSYg==
@@ -18783,16 +18772,7 @@ string-argv@^0.3.1:
   resolved "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz#2b6d0ef24b656274d957d54e0a4bbf6153dc02b6"
   integrity sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==
 
-"string-width-cjs@npm:string-width@^4.2.0":
-  version "4.2.3"
-  resolved "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
-  integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
-  dependencies:
-    emoji-regex "^8.0.0"
-    is-fullwidth-code-point "^3.0.0"
-    strip-ansi "^6.0.1"
-
-"string-width@^1.0.2 || 2 || 3 || 4", string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.3:
+"string-width-cjs@npm:string-width@^4.2.0", "string-width@^1.0.2 || 2 || 3 || 4", string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.3:
   version "4.2.3"
   resolved "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
   integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
@@ -18868,7 +18848,7 @@ string_decoder@~1.1.1:
   dependencies:
     safe-buffer "~5.1.0"
 
-"strip-ansi-cjs@npm:strip-ansi@^6.0.1":
+"strip-ansi-cjs@npm:strip-ansi@^6.0.1", strip-ansi@^6.0.0, strip-ansi@^6.0.1:
   version "6.0.1"
   resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
   integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
@@ -18882,13 +18862,6 @@ strip-ansi@^3.0.1:
   dependencies:
     ansi-regex "^2.0.0"
 
-strip-ansi@^6.0.0, strip-ansi@^6.0.1:
-  version "6.0.1"
-  resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
-  integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
-  dependencies:
-    ansi-regex "^5.0.1"
-
 strip-ansi@^7.0.1:
   version "7.1.0"
   resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz#d5b6568ca689d8561370b0707685d22434faff45"
@@ -20754,7 +20727,7 @@ [email protected]:
   resolved "https://registry.npmjs.org/workerpool/-/workerpool-6.2.0.tgz#827d93c9ba23ee2019c3ffaff5c27fccea289e8b"
   integrity sha512-Rsk5qQHJ9eowMH28Jwhe8HEbmdYDX4lwoMWshiCXugjtHqMD9ZbiqSDLxcsfdqsETPzVUtX5s1Z5kStiIM6l4A==
 
-"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0":
+"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0", wrap-ansi@^7.0.0:
   version "7.0.0"
   resolved "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
   integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
@@ -20772,15 +20745,6 @@ wrap-ansi@^6.0.1, wrap-ansi@^6.2.0:
     string-width "^4.1.0"
     strip-ansi "^6.0.0"
 
-wrap-ansi@^7.0.0:
-  version "7.0.0"
-  resolved "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
-  integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
-  dependencies:
-    ansi-styles "^4.0.0"
-    string-width "^4.1.0"
-    strip-ansi "^6.0.0"
-
 wrap-ansi@^8.1.0:
   version "8.1.0"
   resolved "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz#56dc22368ee570face1b49819975d9b9a5ead214"