tapass 0.1.0 → 0.2.0

package/dist/tapd_methods/send/get_asset_transfers.d.ts

@@ -0,0 +1,73 @@
+import type { Transfer } from '../../tapd_responses/index.js';
+import type { AuthenticatedTapdArgs } from '../../typescript/index.js';
+import type { TapdMethod } from '../../typescript/index.js';
+export type GetAssetTransfersArgs = AuthenticatedTapdArgs<{
+    /** Anchor Transaction Id Hex String */
+    transaction_id?: string;
+}>;
+export type GetAssetTransfersResult = {
+    transfers: Transfer[];
+};
+/** Get the outbound asset transfers of this node
+
+  Requires `assets:read` permission
+
+  {
+    tapd: <Authenticated tapd API Object>
+    [transaction_id]: <Anchor Transaction Id Hex String>
+  }
+
+  @returns via cbk or Promise
+  {
+    transfers: [{
+      [block_hash]: <Anchor Block Hash Hex String>
+      [block_height]: <Anchor Block Height Number>
+      created_at: <Transfer Created At ISO 8601 Date String>
+      fee: <Anchor Transaction Chain Fee Tokens Number>
+      height_hint: <Anchor Transaction Confirmation Height Hint Number>
+      inputs: [{
+        amount: <Asset Units Numeric String>
+        asset_id: <Asset Id Hex String>
+        [group_key]: <Asset Group Key Hex String>
+        is_collectible: <Asset Is Collectible Bool>
+        script_key: <Script Key Hex String>
+        transaction_id: <Spent Anchor Transaction Id Hex String>
+        transaction_vout: <Spent Anchor Transaction Output Index Number>
+      }]
+      [label]: <Transfer Label String>
+      outputs: [{
+        [address]: <Taproot Assets Address Of the Recipient String>
+        amount: <Asset Units Numeric String>
+        anchor: {
+          internal_key: <Anchor Internal Key Hex String>
+          merkle_root: <Anchor Taproot Merkle Root Hex String>
+          output_script: <Output Script Hex String>
+          passive_assets_count: <Count Of Passive Assets In the Anchor Number>
+          taproot_asset_root: <Taproot Asset Root Commitment Hex String>
+          [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+          tokens: <Anchor Output Tokens Number>
+          transaction_id: <Anchor Transaction Id Hex String>
+          transaction_vout: <Anchor Transaction Output Index Number>
+        }
+        [asset_id]: <Asset Id Hex String>
+        asset_version: <Asset Version Number>
+        [group_key]: <Asset Group Key Hex String>
+        is_collectible: <Asset Is Collectible Bool>
+        is_local: <Script Key Belongs To This Node Bool>
+        is_split_root: <Output Is the Split Root Bool>
+        [lock_time]: <Lock Time Number>
+        [proof]: <Proof File Hex String>
+        [proof_courier]: <Proof Courier Address String>
+        [proof_delivery]: <Proof Delivery State String> // complete, pending
+        [relative_lock_time]: <Relative Lock Time Number>
+        script_key: <Script Key Hex String>
+        [split_root_hash]: <Split Commitment Root Hash Hex String>
+      }]
+      [transaction]: <Raw Anchor Transaction Hex String>
+      transaction_id: <Anchor Transaction Id Hex String>
+    }]
+  }
+*/
+declare const getAssetTransfers: TapdMethod<GetAssetTransfersArgs, GetAssetTransfersResult>;
+export default getAssetTransfers;
+//# sourceMappingURL=get_asset_transfers.d.ts.map

package/dist/tapd_methods/send/get_asset_transfers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_asset_transfers.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/send/get_asset_transfers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAO1D,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;IACxD,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAOF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2DE;AACF,QAAA,MAAM,iBAAiB,EAAE,UAAU,CACjC,qBAAqB,EACrB,uBAAuB,CAgExB,CAAC;eAEa,iBAAiB"}

package/dist/tapd_methods/send/get_asset_transfers.js

@@ -0,0 +1,122 @@
+import { auto as asyncAuto } from 'async';
+import { returnResult } from 'asyncjs-util';
+import { isConnectionFailure } from '../../tapd_requests/index.js';
+import { isPermissionDenied } from '../../tapd_requests/index.js';
+import { isTapd } from '../../tapd_requests/index.js';
+import { rpcTransferAsTransfer } from '../../tapd_responses/index.js';
+const { isArray } = Array;
+const isTransactionId = (n) => /^[0-9A-F]{64}$/i.test(n);
+const method = 'listTransfers';
+const type = 'default';
+/** Get the outbound asset transfers of this node
+
+  Requires `assets:read` permission
+
+  {
+    tapd: <Authenticated tapd API Object>
+    [transaction_id]: <Anchor Transaction Id Hex String>
+  }
+
+  @returns via cbk or Promise
+  {
+    transfers: [{
+      [block_hash]: <Anchor Block Hash Hex String>
+      [block_height]: <Anchor Block Height Number>
+      created_at: <Transfer Created At ISO 8601 Date String>
+      fee: <Anchor Transaction Chain Fee Tokens Number>
+      height_hint: <Anchor Transaction Confirmation Height Hint Number>
+      inputs: [{
+        amount: <Asset Units Numeric String>
+        asset_id: <Asset Id Hex String>
+        [group_key]: <Asset Group Key Hex String>
+        is_collectible: <Asset Is Collectible Bool>
+        script_key: <Script Key Hex String>
+        transaction_id: <Spent Anchor Transaction Id Hex String>
+        transaction_vout: <Spent Anchor Transaction Output Index Number>
+      }]
+      [label]: <Transfer Label String>
+      outputs: [{
+        [address]: <Taproot Assets Address Of the Recipient String>
+        amount: <Asset Units Numeric String>
+        anchor: {
+          internal_key: <Anchor Internal Key Hex String>
+          merkle_root: <Anchor Taproot Merkle Root Hex String>
+          output_script: <Output Script Hex String>
+          passive_assets_count: <Count Of Passive Assets In the Anchor Number>
+          taproot_asset_root: <Taproot Asset Root Commitment Hex String>
+          [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+          tokens: <Anchor Output Tokens Number>
+          transaction_id: <Anchor Transaction Id Hex String>
+          transaction_vout: <Anchor Transaction Output Index Number>
+        }
+        [asset_id]: <Asset Id Hex String>
+        asset_version: <Asset Version Number>
+        [group_key]: <Asset Group Key Hex String>
+        is_collectible: <Asset Is Collectible Bool>
+        is_local: <Script Key Belongs To This Node Bool>
+        is_split_root: <Output Is the Split Root Bool>
+        [lock_time]: <Lock Time Number>
+        [proof]: <Proof File Hex String>
+        [proof_courier]: <Proof Courier Address String>
+        [proof_delivery]: <Proof Delivery State String> // complete, pending
+        [relative_lock_time]: <Relative Lock Time Number>
+        script_key: <Script Key Hex String>
+        [split_root_hash]: <Split Commitment Root Hash Hex String>
+      }]
+      [transaction]: <Raw Anchor Transaction Hex String>
+      transaction_id: <Anchor Transaction Id Hex String>
+    }]
+  }
+*/
+const getAssetTransfers = (args, cbk) => {
+    return new Promise((resolve, reject) => {
+        return asyncAuto({
+            // Check arguments
+            validate: cbk => {
+                if (!isTapd({ method, type, tapd: args.tapd })) {
+                    return cbk([400, 'ExpectedAuthenticatedTapdToGetAssetTransfers']);
+                }
+                const id = args.transaction_id;
+                if (id !== undefined && !isTransactionId(id)) {
+                    return cbk([400, 'ExpectedTransactionIdToGetAssetTransfers']);
+                }
+                return cbk();
+            },
+            // Get the transfers
+            getTransfers: [
+                'validate',
+                ({}, cbk) => {
+                    const request = { anchor_txid: args.transaction_id || '' };
+                    return args.tapd[type][method](request, (err, res) => {
+                        if (isConnectionFailure({ err })) {
+                            return cbk([503, 'FailedToConnectToTapdToGetAssetTransfers']);
+                        }
+                        if (isPermissionDenied({ err })) {
+                            return cbk([403, 'PermissionDeniedToGetAssetTransfers']);
+                        }
+                        if (!!err) {
+                            return cbk([
+                                503,
+                                'UnexpectedErrorGettingAssetTransfers',
+                                { err },
+                            ]);
+                        }
+                        if (!res || !isArray(res.transfers)) {
+                            return cbk([503, 'ExpectedArrayOfTransfersInTransfersList']);
+                        }
+                        try {
+                            return cbk(null, {
+                                transfers: res.transfers.map(rpcTransferAsTransfer),
+                            });
+                        }
+                        catch (err) {
+                            return cbk([503, err.message]);
+                        }
+                    });
+                },
+            ],
+        }, returnResult({ reject, resolve, of: 'getTransfers' }, cbk));
+    });
+};
+export default getAssetTransfers;
+//# sourceMappingURL=get_asset_transfers.js.map

package/dist/tapd_methods/send/get_asset_transfers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_asset_transfers.js","sourceRoot":"","sources":["../../../src/tapd_methods/send/get_asset_transfers.ts"],"names":[],"mappings":"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"}

package/dist/tapd_methods/send/index.d.ts

@@ -0,0 +1,15 @@
+export { default as burnAsset } from './burn_asset.js';
+export type { BurnAssetArgs } from './burn_asset.js';
+export type { BurnAssetResult } from './burn_asset.js';
+export { default as getAssetTransfers } from './get_asset_transfers.js';
+export type { GetAssetTransfersArgs } from './get_asset_transfers.js';
+export type { GetAssetTransfersResult } from './get_asset_transfers.js';
+export { default as registerAssetTransfer } from './register_asset_transfer.js';
+export type { RegisterAssetTransferArgs } from './register_asset_transfer.js';
+export type { RegisterAssetTransferResult } from './register_asset_transfer.js';
+export { default as sendAsset } from './send_asset.js';
+export type { SendAssetArgs } from './send_asset.js';
+export type { SendAssetResult } from './send_asset.js';
+export { default as subscribeToAssetSends } from './subscribe_to_asset_sends.js';
+export type { SubscribeToAssetSendsArgs } from './subscribe_to_asset_sends.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tapd_methods/send/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/send/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAC,qBAAqB,EAAC,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,8BAA8B,CAAC;AAC9E,YAAY,EAAC,yBAAyB,EAAC,MAAM,8BAA8B,CAAC;AAC5E,YAAY,EAAC,2BAA2B,EAAC,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAC,yBAAyB,EAAC,MAAM,+BAA+B,CAAC"}

package/dist/tapd_methods/send/index.js

@@ -0,0 +1,6 @@
+export { default as burnAsset } from './burn_asset.js';
+export { default as getAssetTransfers } from './get_asset_transfers.js';
+export { default as registerAssetTransfer } from './register_asset_transfer.js';
+export { default as sendAsset } from './send_asset.js';
+export { default as subscribeToAssetSends } from './subscribe_to_asset_sends.js';
+//# sourceMappingURL=index.js.map

package/dist/tapd_methods/send/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tapd_methods/send/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAGtE,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,8BAA8B,CAAC;AAG9E,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,+BAA+B,CAAC"}

package/dist/tapd_methods/send/register_asset_transfer.d.ts

@@ -0,0 +1,77 @@
+import type { Asset } from '../../tapd_responses/index.js';
+import type { AuthenticatedTapdArgs } from '../../typescript/index.js';
+import type { TapdMethod } from '../../typescript/index.js';
+export type RegisterAssetTransferArgs = AuthenticatedTapdArgs<{
+    /** Asset Id Hex String */
+    asset_id: string;
+    /** Asset Group Key Hex String */
+    group_key?: string;
+    /** Script Key Hex String */
+    script_key: string;
+    /** Anchor Transaction Id Hex String */
+    transaction_id: string;
+    /** Anchor Transaction Output Index Number */
+    transaction_vout: number;
+}>;
+export type RegisterAssetTransferResult = Asset;
+/** Register an inbound asset transfer that has no Taproot Assets address
+
+  Use this for an interactive transfer, when the sender sent the proof by a
+  different way. The proof must already be in the local universe, and the
+  script key must already be known to this node.
+
+  Requires `assets:write` permission
+
+  {
+    asset_id: <Asset Id Hex String>
+    [group_key]: <Asset Group Key Hex String>
+    script_key: <Script Key Hex String>
+    tapd: <Authenticated tapd API Object>
+    transaction_id: <Anchor Transaction Id Hex String>
+    transaction_vout: <Anchor Transaction Output Index Number>
+  }
+
+  @returns via cbk or Promise
+  {
+    amount: <Asset Units Numeric String>
+    [anchor]: {
+      [block_hash]: <Anchor Block Hash Hex String>
+      [block_height]: <Anchor Block Height Number>
+      [confirmed_at]: <Anchor Confirmed At ISO 8601 Date String>
+      internal_key: <Anchor Internal Key Hex String>
+      merkle_root: <Anchor Taproot Merkle Root Hex String>
+      [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+      transaction: <Raw Anchor Transaction Hex String>
+      transaction_id: <Anchor Transaction Id Hex String>
+      transaction_vout: <Anchor Transaction Output Index Number>
+    }
+    asset_id: <Asset Id Hex String>
+    [decimal_display]: <Decimal Places To Show Number>
+    genesis_output_index: <Genesis Commitment Output Index Number>
+    genesis_transaction_id: <Genesis Point Transaction Id Hex String>
+    genesis_transaction_vout: <Genesis Point Transaction Output Index Number>
+    [group]: {
+      key: <Tweaked Group Key Hex String>
+      raw_key: <Raw Group Key Hex String>
+      [tapscript_root]: <Group Tapscript Root Hex String>
+      [witness]: <Group Membership Witness Hex String>
+    }
+    is_burn: <Asset Is Burned Bool>
+    is_collectible: <Asset Is Collectible Bool>
+    is_local: <Script Key Belongs To This Node Bool>
+    is_spent: <Asset Is Spent Bool>
+    [lease_expires_at]: <Lease Expires At ISO 8601 Date String>
+    [lease_owner]: <Lease Owner Id Hex String>
+    [lock_time]: <Lock Time Number>
+    meta_hash: <Asset Metadata Hash Hex String>
+    name: <Asset Name String>
+    [relative_lock_time]: <Relative Lock Time Number>
+    script_key: <Script Key Hex String>
+    script_key_type: <Script Key Type String>
+    script_version: <Script Version Number>
+    version: <Asset Version Number>
+  }
+*/
+declare const registerAssetTransfer: TapdMethod<RegisterAssetTransferArgs, RegisterAssetTransferResult>;
+export default registerAssetTransfer;
+//# sourceMappingURL=register_asset_transfer.d.ts.map

package/dist/tapd_methods/send/register_asset_transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register_asset_transfer.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/send/register_asset_transfer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,+BAA+B,CAAC;AACzD,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAc1D,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;IAC5D,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAOhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDE;AACF,QAAA,MAAM,qBAAqB,EAAE,UAAU,CACrC,yBAAyB,EACzB,2BAA2B,CA+G5B,CAAC;eAEa,qBAAqB"}

package/dist/tapd_methods/send/register_asset_transfer.js

@@ -0,0 +1,165 @@
+import { auto as asyncAuto } from 'async';
+import { returnResult } from 'asyncjs-util';
+import { isConnectionFailure } from '../../tapd_requests/index.js';
+import { isPermissionDenied } from '../../tapd_requests/index.js';
+import { isTapd } from '../../tapd_requests/index.js';
+import { rpcAssetAsAsset } from '../../tapd_responses/index.js';
+const existsError = 'proof already exists for this transfer';
+const { from } = Buffer;
+const isAssetId = (n) => /^[0-9A-F]{64}$/i.test(n);
+const isPublicKey = (n) => /^0[23][0-9A-F]{64}$/i.test(n);
+const { isSafeInteger } = Number;
+const isTransactionId = (n) => /^[0-9A-F]{64}$/i.test(n);
+const method = 'registerTransfer';
+const proofNotFoundError = 'error fetching full proof';
+const scriptKeyNotFoundError = 'error fetching script key';
+const parseErrors = ['error parsing script key', 'error parsing group key'];
+const type = 'default';
+/** Register an inbound asset transfer that has no Taproot Assets address
+
+  Use this for an interactive transfer, when the sender sent the proof by a
+  different way. The proof must already be in the local universe, and the
+  script key must already be known to this node.
+
+  Requires `assets:write` permission
+
+  {
+    asset_id: <Asset Id Hex String>
+    [group_key]: <Asset Group Key Hex String>
+    script_key: <Script Key Hex String>
+    tapd: <Authenticated tapd API Object>
+    transaction_id: <Anchor Transaction Id Hex String>
+    transaction_vout: <Anchor Transaction Output Index Number>
+  }
+
+  @returns via cbk or Promise
+  {
+    amount: <Asset Units Numeric String>
+    [anchor]: {
+      [block_hash]: <Anchor Block Hash Hex String>
+      [block_height]: <Anchor Block Height Number>
+      [confirmed_at]: <Anchor Confirmed At ISO 8601 Date String>
+      internal_key: <Anchor Internal Key Hex String>
+      merkle_root: <Anchor Taproot Merkle Root Hex String>
+      [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+      transaction: <Raw Anchor Transaction Hex String>
+      transaction_id: <Anchor Transaction Id Hex String>
+      transaction_vout: <Anchor Transaction Output Index Number>
+    }
+    asset_id: <Asset Id Hex String>
+    [decimal_display]: <Decimal Places To Show Number>
+    genesis_output_index: <Genesis Commitment Output Index Number>
+    genesis_transaction_id: <Genesis Point Transaction Id Hex String>
+    genesis_transaction_vout: <Genesis Point Transaction Output Index Number>
+    [group]: {
+      key: <Tweaked Group Key Hex String>
+      raw_key: <Raw Group Key Hex String>
+      [tapscript_root]: <Group Tapscript Root Hex String>
+      [witness]: <Group Membership Witness Hex String>
+    }
+    is_burn: <Asset Is Burned Bool>
+    is_collectible: <Asset Is Collectible Bool>
+    is_local: <Script Key Belongs To This Node Bool>
+    is_spent: <Asset Is Spent Bool>
+    [lease_expires_at]: <Lease Expires At ISO 8601 Date String>
+    [lease_owner]: <Lease Owner Id Hex String>
+    [lock_time]: <Lock Time Number>
+    meta_hash: <Asset Metadata Hash Hex String>
+    name: <Asset Name String>
+    [relative_lock_time]: <Relative Lock Time Number>
+    script_key: <Script Key Hex String>
+    script_key_type: <Script Key Type String>
+    script_version: <Script Version Number>
+    version: <Asset Version Number>
+  }
+*/
+const registerAssetTransfer = (args, cbk) => {
+    return new Promise((resolve, reject) => {
+        return asyncAuto({
+            // Check arguments
+            validate: cbk => {
+                if (!args.asset_id || !isAssetId(args.asset_id)) {
+                    return cbk([400, 'ExpectedAssetIdToRegisterAssetTransfer']);
+                }
+                if (!!args.group_key && !isPublicKey(args.group_key)) {
+                    return cbk([400, 'ExpectedGroupKeyHexToRegisterAssetTransfer']);
+                }
+                if (!args.script_key || !isPublicKey(args.script_key)) {
+                    return cbk([400, 'ExpectedScriptKeyToRegisterAssetTransfer']);
+                }
+                if (!isTapd({ method, type, tapd: args.tapd })) {
+                    return cbk([
+                        400,
+                        'ExpectedAuthenticatedTapdToRegisterAssetTransfer',
+                    ]);
+                }
+                if (!args.transaction_id || !isTransactionId(args.transaction_id)) {
+                    return cbk([400, 'ExpectedTransactionIdToRegisterAssetTransfer']);
+                }
+                const vout = args.transaction_vout;
+                if (!isSafeInteger(vout) || vout < 0) {
+                    return cbk([400, 'ExpectedOutputIndexToRegisterAssetTransfer']);
+                }
+                return cbk();
+            },
+            // Register the transfer
+            register: [
+                'validate',
+                ({}, cbk) => {
+                    // tapd reads the outpoint transaction id in internal byte order
+                    const request = {
+                        asset_id: from(args.asset_id, 'hex'),
+                        group_key: from(args.group_key || '', 'hex'),
+                        outpoint: {
+                            output_index: args.transaction_vout,
+                            txid: from(args.transaction_id, 'hex').reverse(),
+                        },
+                        script_key: from(args.script_key, 'hex'),
+                    };
+                    return args.tapd[type][method](request, (err, res) => {
+                        if (isConnectionFailure({ err })) {
+                            return cbk([
+                                503,
+                                'FailedToConnectToTapdToRegisterAssetTransfer',
+                            ]);
+                        }
+                        if (isPermissionDenied({ err })) {
+                            return cbk([403, 'PermissionDeniedToRegisterAssetTransfer']);
+                        }
+                        const details = String(err?.details);
+                        if (!!err && parseErrors.some(n => details.includes(n))) {
+                            return cbk([400, 'ExpectedValidKeysToRegisterAssetTransfer']);
+                        }
+                        if (!!err && details.includes(scriptKeyNotFoundError)) {
+                            return cbk([404, 'ScriptKeyNotFoundToRegisterAssetTransfer']);
+                        }
+                        if (!!err && details.includes(existsError)) {
+                            return cbk([409, 'AssetTransferIsAlreadyRegistered']);
+                        }
+                        if (!!err && details.includes(proofNotFoundError)) {
+                            return cbk([404, 'ProofNotFoundToRegisterAssetTransfer']);
+                        }
+                        if (!!err) {
+                            return cbk([
+                                503,
+                                'UnexpectedErrorRegisteringAssetTransfer',
+                                { err },
+                            ]);
+                        }
+                        if (!res) {
+                            return cbk([503, 'ExpectedResponseToRegisterAssetTransfer']);
+                        }
+                        try {
+                            return cbk(null, rpcAssetAsAsset(res.registered_asset));
+                        }
+                        catch (err) {
+                            return cbk([503, err.message]);
+                        }
+                    });
+                },
+            ],
+        }, returnResult({ reject, resolve, of: 'register' }, cbk));
+    });
+};
+export default registerAssetTransfer;
+//# sourceMappingURL=register_asset_transfer.js.map

package/dist/tapd_methods/send/register_asset_transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register_asset_transfer.js","sourceRoot":"","sources":["../../../src/tapd_methods/send/register_asset_transfer.ts"],"names":[],"mappings":"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"}

package/dist/tapd_methods/send/send_asset.d.ts

@@ -0,0 +1,94 @@
+import type { Transfer } from '../../tapd_responses/index.js';
+import type { AuthenticatedTapdArgs } from '../../typescript/index.js';
+import type { TapdMethod } from '../../typescript/index.js';
+export type SendAssetArgs = AuthenticatedTapdArgs<{
+    addresses: {
+        /** Taproot Assets Address String */
+        address: string;
+        /** Asset Units To Send Numeric String */
+        amount?: string;
+    }[];
+    /** Chain Fee Tokens Per Virtual Byte Number */
+    fee_tokens_per_vbyte?: number;
+    /** Skip the Proof Courier Ping Check Bool */
+    is_courier_ping_skipped?: boolean;
+    /** Transfer Label String */
+    label?: string;
+}>;
+export type SendAssetResult = Transfer;
+/** Send assets to Taproot Assets addresses
+
+  Requires `assets:write` permission
+
+  All addresses must be for the same asset id or asset group
+
+  An `amount` is only for an address without an amount, for example a V2
+  address. When an address has an `amount`, tapd v0.8.0 or later is
+  necessary.
+
+  A fee rate below 253 tokens per thousand weight units (about 1.012 tokens
+  per virtual byte) is raised to 253, because tapd rejects a lower rate
+
+  {
+    addresses: [{
+      address: <Taproot Assets Address String>
+      [amount]: <Asset Units To Send Numeric String>
+    }]
+    [fee_tokens_per_vbyte]: <Chain Fee Tokens Per Virtual Byte Number>
+    [is_courier_ping_skipped]: <Skip the Proof Courier Ping Check Bool>
+    [label]: <Transfer Label String>
+    tapd: <Authenticated tapd API Object>
+  }
+
+  @returns via cbk or Promise
+  {
+    [block_hash]: <Anchor Block Hash Hex String>
+    [block_height]: <Anchor Block Height Number>
+    created_at: <Transfer Created At ISO 8601 Date String>
+    fee: <Anchor Transaction Chain Fee Tokens Number>
+    height_hint: <Anchor Transaction Confirmation Height Hint Number>
+    inputs: [{
+      amount: <Asset Units Numeric String>
+      asset_id: <Asset Id Hex String>
+      [group_key]: <Asset Group Key Hex String>
+      is_collectible: <Asset Is Collectible Bool>
+      script_key: <Script Key Hex String>
+      transaction_id: <Spent Anchor Transaction Id Hex String>
+      transaction_vout: <Spent Anchor Transaction Output Index Number>
+    }]
+    [label]: <Transfer Label String>
+    outputs: [{
+      [address]: <Taproot Assets Address Of the Recipient String>
+      amount: <Asset Units Numeric String>
+      anchor: {
+        internal_key: <Anchor Internal Key Hex String>
+        merkle_root: <Anchor Taproot Merkle Root Hex String>
+        output_script: <Output Script Hex String>
+        passive_assets_count: <Count Of Passive Assets In the Anchor Number>
+        taproot_asset_root: <Taproot Asset Root Commitment Hex String>
+        [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+        tokens: <Anchor Output Tokens Number>
+        transaction_id: <Anchor Transaction Id Hex String>
+        transaction_vout: <Anchor Transaction Output Index Number>
+      }
+      [asset_id]: <Asset Id Hex String>
+      asset_version: <Asset Version Number>
+      [group_key]: <Asset Group Key Hex String>
+      is_collectible: <Asset Is Collectible Bool>
+      is_local: <Script Key Belongs To This Node Bool>
+      is_split_root: <Output Is the Split Root Bool>
+      [lock_time]: <Lock Time Number>
+      [proof]: <Proof File Hex String>
+      [proof_courier]: <Proof Courier Address String>
+      [proof_delivery]: <Proof Delivery State String> // complete, pending
+      [relative_lock_time]: <Relative Lock Time Number>
+      script_key: <Script Key Hex String>
+      [split_root_hash]: <Split Commitment Root Hash Hex String>
+    }]
+    [transaction]: <Raw Anchor Transaction Hex String>
+    transaction_id: <Anchor Transaction Id Hex String>
+  }
+*/
+declare const sendAsset: TapdMethod<SendAssetArgs, SendAssetResult>;
+export default sendAsset;
+//# sourceMappingURL=send_asset.d.ts.map

package/dist/tapd_methods/send/send_asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send_asset.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/send/send_asset.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAc1D,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;IAChD,SAAS,EAAE;QACT,oCAAoC;QACpC,OAAO,EAAE,MAAM,CAAC;QAChB,yCAAyC;QACzC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,+CAA+C;IAC/C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AAOvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwEE;AACF,QAAA,MAAM,SAAS,EAAE,UAAU,CAAC,aAAa,EAAE,eAAe,CAmGzD,CAAC;eAEa,SAAS"}