tapass 0.0.0-stage → 0.2.0

package/dist/tapd_grpc/grpc_ssl.d.ts

@@ -0,0 +1,19 @@
+import grpc from '@grpc/grpc-js';
+export default _default;
+/** Get SSL for gRPC
+
+  {
+    [cert]: <Cert Hex or Base64 String>
+  }
+
+  @returns
+  {
+    ssl: <SSL gRPC Object>
+  }
+*/
+declare function _default({ cert }: {
+    cert?: string;
+}): {
+    ssl: grpc.ChannelCredentials;
+};
+//# sourceMappingURL=grpc_ssl.d.ts.map

package/dist/tapd_grpc/grpc_ssl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc_ssl.d.ts","sourceRoot":"","sources":["../../src/tapd_grpc/grpc_ssl.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,eAAe,CAAC;;AAMjC;;;;;;;;;;EAUE;0BACc,EAAC,IAAI,EAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC;IAC7B,GAAG"}

package/dist/tapd_grpc/grpc_ssl.js

@@ -0,0 +1,18 @@
+import grpc from '@grpc/grpc-js';
+import decodeSerialized from './decode_serialized.js';
+const { createSsl } = grpc.credentials;
+/** Get SSL for gRPC
+
+  {
+    [cert]: <Cert Hex or Base64 String>
+  }
+
+  @returns
+  {
+    ssl: <SSL gRPC Object>
+  }
+*/
+export default ({ cert }) => {
+    return { ssl: createSsl(decodeSerialized({ serialized: cert }).decoded) };
+};
+//# sourceMappingURL=grpc_ssl.js.map

package/dist/tapd_grpc/grpc_ssl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc_ssl.js","sourceRoot":"","sources":["../../src/tapd_grpc/grpc_ssl.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,eAAe,CAAC;AAEjC,OAAO,gBAAgB,MAAM,wBAAwB,CAAC;AAEtD,MAAM,EAAC,SAAS,EAAC,GAAG,IAAI,CAAC,WAAW,CAAC;AAErC;;;;;;;;;;EAUE;AACF,eAAe,CAAC,EAAC,IAAI,EAAkB,EAAE,EAAE;IACzC,OAAO,EAAC,GAAG,EAAE,SAAS,CAAC,gBAAgB,CAAC,EAAC,UAAU,EAAE,IAAI,EAAC,CAAC,CAAC,OAAO,CAAC,EAAC,CAAC;AACxE,CAAC,CAAC"}

package/dist/tapd_grpc/index.d.ts

@@ -0,0 +1,6 @@
+export { default as authenticatedTapdGrpc } from './authenticated_tapd_grpc.js';
+export type { AuthenticatedTapd } from './types.js';
+export type { TapdAuthentication } from './types.js';
+export type { TapdService } from './types.js';
+export type { TapdServiceType } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tapd_grpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tapd_grpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,8BAA8B,CAAC;AAC9E,YAAY,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAClD,YAAY,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AACnD,YAAY,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC"}

package/dist/tapd_grpc/index.js

@@ -0,0 +1,2 @@
+export { default as authenticatedTapdGrpc } from './authenticated_tapd_grpc.js';
+//# sourceMappingURL=index.js.map

package/dist/tapd_grpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tapd_grpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,8BAA8B,CAAC"}

package/dist/tapd_grpc/types.d.ts

@@ -0,0 +1,35 @@
+/** gRPC methods of one tapd service */
+export type TapdService = {
+    [method: string]: (...args: any[]) => any;
+};
+/** Authenticated tapd gRPC API Object */
+export type AuthenticatedTapd = {
+    /** AssetWallet Methods */
+    assetwallet: TapdService;
+    /** TaprootAssets Methods */
+    default: TapdService;
+    /** Mailbox Methods */
+    mailbox: TapdService;
+    /** Mint Methods */
+    mint: TapdService;
+    /** Rfq Methods */
+    rfq: TapdService;
+    /** TaprootAssetChannels Methods */
+    tapchannel: TapdService;
+    /** TapDev Methods */
+    tapdev: TapdService;
+    /** Universe Methods */
+    universe: TapdService;
+};
+export type TapdServiceType = keyof AuthenticatedTapd;
+export type TapdAuthentication = {
+    /** Base64 or Hex Serialized tapd TLS Cert String */
+    cert?: string;
+    /** Base64 or Hex Serialized Macaroon String */
+    macaroon?: string;
+    /** Path to Protos Directory With taprpc and lnrpc Directories String */
+    path?: string;
+    /** Host:Port Network Address String */
+    socket?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tapd_grpc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tapd_grpc/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IAAC,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAC,CAAC;AAEtE,yCAAyC;AACzC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,0BAA0B;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,sBAAsB;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,kBAAkB;IAClB,GAAG,EAAE,WAAW,CAAC;IACjB,mCAAmC;IACnC,UAAU,EAAE,WAAW,CAAC;IACxB,qBAAqB;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/tapd_grpc/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tapd_grpc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tapd_grpc/types.ts"],"names":[],"mappings":""}

package/dist/tapd_methods/address/create_asset_address.d.ts

@@ -0,0 +1,52 @@
+import type { Address } from '../../tapd_responses/index.js';
+import type { AuthenticatedTapdArgs } from '../../typescript/index.js';
+import type { TapdMethod } from '../../typescript/index.js';
+export type CreateAssetAddressArgs = AuthenticatedTapdArgs<{
+    /** Asset Units To Receive Numeric String */
+    amount?: string;
+    /** Asset Id Hex String */
+    asset_id?: string;
+    /** Asset Group Key Hex String */
+    group_key?: string;
+    /** Proof Courier Address String */
+    proof_courier?: string;
+    /** Address Version Number */
+    version?: number;
+}>;
+export type CreateAssetAddressResult = Address;
+/** Create a Taproot Assets address to receive an asset
+
+  Requires `addresses:write` permission
+
+  An `asset_id` or a `group_key` is required, but not both
+
+  When there is a `group_key` and no `version`, tapd makes a V2 address
+
+  {
+    [amount]: <Asset Units To Receive Numeric String>
+    [asset_id]: <Asset Id Hex String>
+    [group_key]: <Asset Group Key Hex String>
+    [proof_courier]: <Proof Courier Address String>
+    tapd: <Authenticated tapd API Object>
+    [version]: <Address Version Number> // 0 || 1 || 2
+  }
+
+  @returns via cbk or Promise
+  {
+    address: <Encoded Taproot Assets Address String>
+    amount: <Asset Units To Receive Numeric String>
+    [asset_id]: <Asset Id Hex String>
+    asset_version: <Asset Version Number>
+    [group_key]: <Asset Group Key Hex String>
+    internal_key: <Internal Key Hex String>
+    is_collectible: <Asset Is Collectible Bool>
+    proof_courier: <Proof Courier Address String>
+    script_key: <Script Key Hex String>
+    [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+    taproot_output_key: <Taproot Output Key Hex String>
+    version: <Address Version Number>
+  }
+*/
+declare const createAssetAddress: TapdMethod<CreateAssetAddressArgs, CreateAssetAddressResult>;
+export default createAssetAddress;
+//# sourceMappingURL=create_asset_address.d.ts.map

package/dist/tapd_methods/address/create_asset_address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_asset_address.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/address/create_asset_address.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAgB1D,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;IACzD,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAO/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCE;AACF,QAAA,MAAM,kBAAkB,EAAE,UAAU,CAClC,sBAAsB,EACtB,wBAAwB,CA8FzB,CAAC;eAEa,kBAAkB"}

package/dist/tapd_methods/address/create_asset_address.js

@@ -0,0 +1,127 @@
+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 { rpcAddrAsAddress } from '../../tapd_responses/index.js';
+const addressVersions = [
+    'ADDR_VERSION_V0',
+    'ADDR_VERSION_V1',
+    'ADDR_VERSION_V2',
+];
+const { from } = Buffer;
+const isAssetId = (n) => /^[0-9A-F]{64}$/i.test(n);
+const isHex = (n) => !!n && !(n.length % 2) && /^[0-9A-F]*$/i.test(n);
+const isNumeric = (n) => typeof n === 'string' && /^\d+$/.test(n);
+const method = 'newAddr';
+const notFoundError = 'unable to find asset or group';
+const type = 'default';
+const unspecifiedVersion = 'ADDR_VERSION_UNSPECIFIED';
+/** Create a Taproot Assets address to receive an asset
+
+  Requires `addresses:write` permission
+
+  An `asset_id` or a `group_key` is required, but not both
+
+  When there is a `group_key` and no `version`, tapd makes a V2 address
+
+  {
+    [amount]: <Asset Units To Receive Numeric String>
+    [asset_id]: <Asset Id Hex String>
+    [group_key]: <Asset Group Key Hex String>
+    [proof_courier]: <Proof Courier Address String>
+    tapd: <Authenticated tapd API Object>
+    [version]: <Address Version Number> // 0 || 1 || 2
+  }
+
+  @returns via cbk or Promise
+  {
+    address: <Encoded Taproot Assets Address String>
+    amount: <Asset Units To Receive Numeric String>
+    [asset_id]: <Asset Id Hex String>
+    asset_version: <Asset Version Number>
+    [group_key]: <Asset Group Key Hex String>
+    internal_key: <Internal Key Hex String>
+    is_collectible: <Asset Is Collectible Bool>
+    proof_courier: <Proof Courier Address String>
+    script_key: <Script Key Hex String>
+    [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+    taproot_output_key: <Taproot Output Key Hex String>
+    version: <Address Version Number>
+  }
+*/
+const createAssetAddress = (args, cbk) => {
+    return new Promise((resolve, reject) => {
+        return asyncAuto({
+            // Check arguments
+            validate: cbk => {
+                if (args.amount !== undefined && !isNumeric(args.amount)) {
+                    return cbk([400, 'ExpectedNumericAmountToCreateAssetAddress']);
+                }
+                if (!args.asset_id && !args.group_key) {
+                    return cbk([400, 'ExpectedAssetIdOrGroupKeyToCreateAssetAddress']);
+                }
+                if (!!args.asset_id && !!args.group_key) {
+                    return cbk([400, 'UnexpectedAssetIdAndGroupKeyForAssetAddress']);
+                }
+                if (!!args.asset_id && !isAssetId(args.asset_id)) {
+                    return cbk([400, 'ExpectedAssetIdHexToCreateAssetAddress']);
+                }
+                if (!!args.group_key && !isHex(args.group_key)) {
+                    return cbk([400, 'ExpectedGroupKeyHexToCreateAssetAddress']);
+                }
+                if (!isTapd({ method, type, tapd: args.tapd })) {
+                    return cbk([400, 'ExpectedAuthenticatedTapdToCreateAssetAddress']);
+                }
+                if (args.version !== undefined && !addressVersions[args.version]) {
+                    return cbk([400, 'ExpectedKnownVersionToCreateAssetAddress']);
+                }
+                return cbk();
+            },
+            // Create the address
+            createAddress: [
+                'validate',
+                ({}, cbk) => {
+                    const request = {
+                        address_version: args.version === undefined
+                            ? unspecifiedVersion
+                            : addressVersions[args.version],
+                        amt: args.amount || '0',
+                        asset_id: from(args.asset_id || '', 'hex'),
+                        group_key: from(args.group_key || '', 'hex'),
+                        proof_courier_addr: args.proof_courier || '',
+                    };
+                    return args.tapd[type][method](request, (err, res) => {
+                        if (isConnectionFailure({ err })) {
+                            return cbk([503, 'FailedToConnectToTapdToCreateAssetAddress']);
+                        }
+                        if (isPermissionDenied({ err })) {
+                            return cbk([403, 'PermissionDeniedToCreateAssetAddress']);
+                        }
+                        if (!!err && String(err.details).includes(notFoundError)) {
+                            const isGroup = !!args.group_key;
+                            return cbk([
+                                404,
+                                isGroup ? 'AssetGroupNotFound' : 'AssetNotFound',
+                            ]);
+                        }
+                        if (!!err) {
+                            return cbk([503, 'UnexpectedErrorCreatingAssetAddress', { err }]);
+                        }
+                        if (!res) {
+                            return cbk([503, 'ExpectedResponseForAssetAddressCreation']);
+                        }
+                        try {
+                            return cbk(null, rpcAddrAsAddress(res));
+                        }
+                        catch (err) {
+                            return cbk([503, err.message]);
+                        }
+                    });
+                },
+            ],
+        }, returnResult({ reject, resolve, of: 'createAddress' }, cbk));
+    });
+};
+export default createAssetAddress;
+//# sourceMappingURL=create_asset_address.js.map

package/dist/tapd_methods/address/create_asset_address.js.map

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

package/dist/tapd_methods/address/decode_asset_address.d.ts

@@ -0,0 +1,38 @@
+import type { Address } from '../../tapd_responses/index.js';
+import type { AuthenticatedTapdArgs } from '../../typescript/index.js';
+import type { TapdMethod } from '../../typescript/index.js';
+export type DecodeAssetAddressArgs = AuthenticatedTapdArgs<{
+    /** Encoded Taproot Assets Address String */
+    address: string;
+}>;
+export type DecodeAssetAddressResult = Address;
+/** Decode a Taproot Assets address
+
+  Requires `addresses:read` permission
+
+  The address must be for the network of tapd
+
+  {
+    address: <Encoded Taproot Assets Address String>
+    tapd: <Authenticated tapd API Object>
+  }
+
+  @returns via cbk or Promise
+  {
+    address: <Encoded Taproot Assets Address String>
+    amount: <Asset Units To Receive Numeric String>
+    [asset_id]: <Asset Id Hex String>
+    asset_version: <Asset Version Number>
+    [group_key]: <Asset Group Key Hex String>
+    internal_key: <Internal Key Hex String>
+    is_collectible: <Asset Is Collectible Bool>
+    proof_courier: <Proof Courier Address String>
+    script_key: <Script Key Hex String>
+    [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+    taproot_output_key: <Taproot Output Key Hex String>
+    version: <Address Version Number>
+  }
+*/
+declare const decodeAssetAddress: TapdMethod<DecodeAssetAddressArgs, DecodeAssetAddressResult>;
+export default decodeAssetAddress;
+//# sourceMappingURL=decode_asset_address.d.ts.map

package/dist/tapd_methods/address/decode_asset_address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode_asset_address.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/address/decode_asset_address.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAM1D,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;IACzD,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAO/C;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BE;AACF,QAAA,MAAM,kBAAkB,EAAE,UAAU,CAClC,sBAAsB,EACtB,wBAAwB,CAwDzB,CAAC;eAEa,kBAAkB"}

package/dist/tapd_methods/address/decode_asset_address.js

@@ -0,0 +1,81 @@
+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 { rpcAddrAsAddress } from '../../tapd_responses/index.js';
+const invalidAddressError = 'unable to decode addr';
+const method = 'decodeAddr';
+const type = 'default';
+/** Decode a Taproot Assets address
+
+  Requires `addresses:read` permission
+
+  The address must be for the network of tapd
+
+  {
+    address: <Encoded Taproot Assets Address String>
+    tapd: <Authenticated tapd API Object>
+  }
+
+  @returns via cbk or Promise
+  {
+    address: <Encoded Taproot Assets Address String>
+    amount: <Asset Units To Receive Numeric String>
+    [asset_id]: <Asset Id Hex String>
+    asset_version: <Asset Version Number>
+    [group_key]: <Asset Group Key Hex String>
+    internal_key: <Internal Key Hex String>
+    is_collectible: <Asset Is Collectible Bool>
+    proof_courier: <Proof Courier Address String>
+    script_key: <Script Key Hex String>
+    [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+    taproot_output_key: <Taproot Output Key Hex String>
+    version: <Address Version Number>
+  }
+*/
+const decodeAssetAddress = (args, cbk) => {
+    return new Promise((resolve, reject) => {
+        return asyncAuto({
+            // Check arguments
+            validate: cbk => {
+                if (!args.address || typeof args.address !== 'string') {
+                    return cbk([400, 'ExpectedAssetAddressToDecode']);
+                }
+                if (!isTapd({ method, type, tapd: args.tapd })) {
+                    return cbk([400, 'ExpectedAuthenticatedTapdToDecodeAssetAddress']);
+                }
+                return cbk();
+            },
+            // Decode the address
+            decode: [
+                'validate',
+                ({}, cbk) => {
+                    const request = { addr: args.address };
+                    return args.tapd[type][method](request, (err, res) => {
+                        if (isConnectionFailure({ err })) {
+                            return cbk([503, 'FailedToConnectToTapdToDecodeAssetAddress']);
+                        }
+                        if (isPermissionDenied({ err })) {
+                            return cbk([403, 'PermissionDeniedToDecodeAssetAddress']);
+                        }
+                        if (!!err && String(err.details).includes(invalidAddressError)) {
+                            return cbk([400, 'ExpectedValidAssetAddressToDecode']);
+                        }
+                        if (!!err) {
+                            return cbk([503, 'UnexpectedErrorDecodingAssetAddress', { err }]);
+                        }
+                        try {
+                            return cbk(null, rpcAddrAsAddress(res));
+                        }
+                        catch (err) {
+                            return cbk([503, err.message]);
+                        }
+                    });
+                },
+            ],
+        }, returnResult({ reject, resolve, of: 'decode' }, cbk));
+    });
+};
+export default decodeAssetAddress;
+//# sourceMappingURL=decode_asset_address.js.map

package/dist/tapd_methods/address/decode_asset_address.js.map

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

package/dist/tapd_methods/address/get_asset_addresses.d.ts

@@ -0,0 +1,54 @@
+import type { Address } from '../../tapd_responses/index.js';
+import type { AuthenticatedTapdArgs } from '../../typescript/index.js';
+import type { TapdMethod } from '../../typescript/index.js';
+export type GetAssetAddressesArgs = AuthenticatedTapdArgs<{
+    /** Created After ISO 8601 Date String */
+    created_after?: string;
+    /** Created Before ISO 8601 Date String */
+    created_before?: string;
+    /** Page Result Limit Number */
+    limit?: number;
+    /** Opaque Paging Token String */
+    token?: string;
+}>;
+export type GetAssetAddressesResult = {
+    addresses: Address[];
+    /** Next Opaque Paging Token */
+    next?: string;
+};
+/** Get the Taproot Assets addresses that this node created, oldest first
+
+  Requires `addresses:read` permission
+
+  Use the `next` token with the same filters to get the next page
+
+  {
+    [created_after]: <Created After ISO 8601 Date String>
+    [created_before]: <Created Before ISO 8601 Date String>
+    [limit]: <Page Result Limit Number>
+    tapd: <Authenticated tapd API Object>
+    [token]: <Opaque Paging Token String>
+  }
+
+  @returns via cbk or Promise
+  {
+    addresses: [{
+      address: <Encoded Taproot Assets Address String>
+      amount: <Asset Units To Receive Numeric String>
+      [asset_id]: <Asset Id Hex String>
+      asset_version: <Asset Version Number>
+      [group_key]: <Asset Group Key Hex String>
+      internal_key: <Internal Key Hex String>
+      is_collectible: <Asset Is Collectible Bool>
+      proof_courier: <Proof Courier Address String>
+      script_key: <Script Key Hex String>
+      [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+      taproot_output_key: <Taproot Output Key Hex String>
+      version: <Address Version Number>
+    }]
+    [next]: <Next Opaque Paging Token String>
+  }
+*/
+declare const getAssetAddresses: TapdMethod<GetAssetAddressesArgs, GetAssetAddressesResult>;
+export default getAssetAddresses;
+//# sourceMappingURL=get_asset_addresses.d.ts.map

package/dist/tapd_methods/address/get_asset_addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_asset_addresses.d.ts","sourceRoot":"","sources":["../../../src/tapd_methods/address/get_asset_addresses.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAa1D,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;IACxD,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAOF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCE;AACF,QAAA,MAAM,iBAAiB,EAAE,UAAU,CACjC,qBAAqB,EACrB,uBAAuB,CAgIxB,CAAC;eAEa,iBAAiB"}

package/dist/tapd_methods/address/get_asset_addresses.js

@@ -0,0 +1,153 @@
+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 { rpcAddrAsAddress } from '../../tapd_responses/index.js';
+const asSeconds = (n) => (!n ? 0 : Math.floor(Date.parse(n) / 1e3));
+const defaultLimit = 100;
+const { isArray } = Array;
+const isDate = (n) => Date.parse(n) > 0;
+const { isSafeInteger } = Number;
+const maxLimit = 2147483647;
+const method = 'queryAddrs';
+const { parse } = JSON;
+const { stringify } = JSON;
+const type = 'default';
+/** Get the Taproot Assets addresses that this node created, oldest first
+
+  Requires `addresses:read` permission
+
+  Use the `next` token with the same filters to get the next page
+
+  {
+    [created_after]: <Created After ISO 8601 Date String>
+    [created_before]: <Created Before ISO 8601 Date String>
+    [limit]: <Page Result Limit Number>
+    tapd: <Authenticated tapd API Object>
+    [token]: <Opaque Paging Token String>
+  }
+
+  @returns via cbk or Promise
+  {
+    addresses: [{
+      address: <Encoded Taproot Assets Address String>
+      amount: <Asset Units To Receive Numeric String>
+      [asset_id]: <Asset Id Hex String>
+      asset_version: <Asset Version Number>
+      [group_key]: <Asset Group Key Hex String>
+      internal_key: <Internal Key Hex String>
+      is_collectible: <Asset Is Collectible Bool>
+      proof_courier: <Proof Courier Address String>
+      script_key: <Script Key Hex String>
+      [tapscript_sibling]: <Tapscript Sibling Preimage Hex String>
+      taproot_output_key: <Taproot Output Key Hex String>
+      version: <Address Version Number>
+    }]
+    [next]: <Next Opaque Paging Token String>
+  }
+*/
+const getAssetAddresses = (args, cbk) => {
+    return new Promise((resolve, reject) => {
+        return asyncAuto({
+            // Check arguments
+            validate: cbk => {
+                const after = args.created_after;
+                const before = args.created_before;
+                if (after !== undefined && !isDate(after)) {
+                    return cbk([400, 'ExpectedValidCreatedAfterDateToGetAddresses']);
+                }
+                if (before !== undefined && !isDate(before)) {
+                    return cbk([400, 'ExpectedValidCreatedBeforeDateToGetAddresses']);
+                }
+                if (args.limit !== undefined && !isSafeInteger(args.limit)) {
+                    return cbk([400, 'ExpectedIntegerLimitToGetAssetAddresses']);
+                }
+                if (args.limit !== undefined && args.limit < 1) {
+                    return cbk([400, 'ExpectedPositiveLimitToGetAssetAddresses']);
+                }
+                if (args.limit !== undefined && args.limit > maxLimit) {
+                    return cbk([400, 'ExpectedSmallerLimitToGetAssetAddresses']);
+                }
+                if (!!args.limit && !!args.token) {
+                    return cbk([400, 'UnexpectedLimitWhenPagingAddressesWithToken']);
+                }
+                if (!isTapd({ method, type, tapd: args.tapd })) {
+                    return cbk([400, 'ExpectedAuthenticatedTapdToGetAssetAddresses']);
+                }
+                return cbk();
+            },
+            // Get the addresses
+            getAddresses: [
+                'validate',
+                ({}, cbk) => {
+                    let limit = args.limit || defaultLimit;
+                    let offset = 0;
+                    // tapd reads the offset as a row offset in the results
+                    if (!!args.token) {
+                        try {
+                            const pagingToken = parse(args.token);
+                            limit = pagingToken.limit;
+                            offset = pagingToken.offset;
+                        }
+                        catch (err) {
+                            return cbk([
+                                400,
+                                'ExpectedValidPagingTokenToGetAddresses',
+                                { err },
+                            ]);
+                        }
+                        if (!isSafeInteger(limit) || limit < 1 || limit > maxLimit) {
+                            return cbk([400, 'ExpectedValidPagingTokenToGetAddresses']);
+                        }
+                        if (!isSafeInteger(offset) || offset < 0 || offset > maxLimit) {
+                            return cbk([400, 'ExpectedValidPagingTokenToGetAddresses']);
+                        }
+                    }
+                    const request = {
+                        created_after: asSeconds(args.created_after),
+                        created_before: asSeconds(args.created_before),
+                        limit,
+                        offset,
+                    };
+                    return args.tapd[type][method](request, (err, res) => {
+                        if (isConnectionFailure({ err })) {
+                            return cbk([503, 'FailedToConnectToTapdToGetAssetAddresses']);
+                        }
+                        if (isPermissionDenied({ err })) {
+                            return cbk([403, 'PermissionDeniedToGetAssetAddresses']);
+                        }
+                        if (!!err) {
+                            return cbk([
+                                503,
+                                'UnexpectedErrorGettingAssetAddresses',
+                                { err },
+                            ]);
+                        }
+                        if (!res || !isArray(res.addrs)) {
+                            return cbk([
+                                503,
+                                'ExpectedArrayOfAddressesInAddressesResponse',
+                            ]);
+                        }
+                        try {
+                            const addresses = res.addrs.map(rpcAddrAsAddress);
+                            // A full page means that there can be more results
+                            const isFullPage = addresses.length === limit;
+                            const next = stringify({ limit, offset: offset + limit });
+                            return cbk(null, {
+                                addresses,
+                                next: isFullPage ? next : undefined,
+                            });
+                        }
+                        catch (err) {
+                            return cbk([503, err.message]);
+                        }
+                    });
+                },
+            ],
+        }, returnResult({ reject, resolve, of: 'getAddresses' }, cbk));
+    });
+};
+export default getAssetAddresses;
+//# sourceMappingURL=get_asset_addresses.js.map