Merge pull request #5988 from BitGo/coin-3820-send-nft

feat: send digital asset

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: '',
+    tokenContractAddress: '',
+    recipientAddress: '',
+  });
+  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,
+            },
+          ],
+        });
+      }
     }
   }