tapass 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 bnonni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,98 @@
-# Temporary Holding Version
+# tapass
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Methods for the Taproot Assets daemon (tapd), in the style of
+[lightning](https://github.com/alexbosworth/lightning).
+
+## Install
+
+    npm install tapass
+
+tapass needs Node.js 22.12 or later.
+
+## tapd Authentication
+
+To connect to tapd, you need the TLS certificate and a macaroon. Encode each
+file as base64:
+
+    base64 -w0 ~/.tapd/tls.cert
+    base64 -w0 ~/.tapd/data/mainnet/admin.macaroon
+
+Then make an authenticated tapd object:
+
+```js
+import {authenticatedTapdGrpc} from 'tapass';
+
+const {tapd} = authenticatedTapdGrpc({
+  cert: 'base64 encoded tls.cert',
+  macaroon: 'base64 encoded admin.macaroon',
+  socket: '127.0.0.1:10029',
+});
+```
+
+## Methods
+
+- [createAssetAddress](#createassetaddress): Create a Taproot Assets address
+  to receive an asset
+
+### createAssetAddress
+
+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>
+    }
+
+Example:
+
+```js
+import {createAssetAddress} from 'tapass';
+
+const {address} = await createAssetAddress({amount: '100', asset_id, tapd});
+```
+
+## Errors
+
+Methods return errors as arrays: `[code, 'ErrorMessage', {err}]`.
+
+- `400`: An argument is not correct.
+- `403`: The macaroon does not have the permission for the method.
+- `404`: tapd does not have the item, for example an asset.
+- `503`: tapd returned an error, or tapd is not available.
+
+## Development
+
+    pnpm install
+    pnpm test
+    pnpm lint
+    pnpm build
+
+To copy the protos of a different tapd release into `protos/`:
+
+    pnpm sync-protos v0.8.5

package/dist/grpc/emit_subscription_error.d.ts

@@ -0,0 +1,21 @@
+import type { EventEmitter } from 'node:events';
+import type { ClientReadableStream } from '@grpc/grpc-js';
+type Args = {
+    emitter: EventEmitter;
+    subscription: ClientReadableStream<unknown>;
+};
+export default _default;
+/** Get a function that emits an error from a gRPC subscription proxy
+
+  {
+    emitter: <Event Subscription Proxy Object>
+    subscription: <gRPC Subscription Object>
+  }
+
+  @returns
+  <Error Emission Function>
+*/
+declare function _default({ emitter, subscription }: Args): (err?: {
+    details?: string;
+}) => void;
+//# sourceMappingURL=emit_subscription_error.d.ts.map

package/dist/grpc/emit_subscription_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit_subscription_error.d.ts","sourceRoot":"","sources":["../../src/grpc/emit_subscription_error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAIxD,KAAK,IAAI,GAAG;IACV,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;CAC7C,CAAC;;AAEF;;;;;;;;;EASE;0BACc,EAAC,OAAO,EAAE,YAAY,EAAC,EAAE,IAAI,UAC7B;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC"}

package/dist/grpc/emit_subscription_error.js

@@ -0,0 +1,26 @@
+const cancelError = 'Cancelled on client';
+/** Get a function that emits an error from a gRPC subscription proxy
+
+  {
+    emitter: <Event Subscription Proxy Object>
+    subscription: <gRPC Subscription Object>
+  }
+
+  @returns
+  <Error Emission Function>
+*/
+export default ({ emitter, subscription }) => {
+    return (err) => {
+        subscription.cancel();
+        if (!!err && err.details === cancelError) {
+            subscription.removeAllListeners();
+        }
+        // Exit early when there are no error listeners
+        if (!emitter.listenerCount('error')) {
+            return;
+        }
+        emitter.emit('error', err);
+        return;
+    };
+};
+//# sourceMappingURL=emit_subscription_error.js.map

package/dist/grpc/emit_subscription_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit_subscription_error.js","sourceRoot":"","sources":["../../src/grpc/emit_subscription_error.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAO1C;;;;;;;;;EASE;AACF,eAAe,CAAC,EAAC,OAAO,EAAE,YAAY,EAAO,EAAE,EAAE;IAC/C,OAAO,CAAC,GAAwB,EAAE,EAAE;QAClC,YAAY,CAAC,MAAM,EAAE,CAAC;QAEtB,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;YACzC,YAAY,CAAC,kBAAkB,EAAE,CAAC;QACpC,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE3B,OAAO;IACT,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/grpc/grpc_services.d.ts

@@ -0,0 +1,46 @@
+/** gRPC settings for tapd
+
+  `includeDirs` and `protoFiles` paths are relative to `protosDir`.
+  `protosDir` is relative to the `tapd_grpc` directory.
+*/
+declare const _default: {
+    readonly defaultSocket: 'localhost:10029';
+    readonly grpcSslCipherSuites: 'HIGH+ECDSA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384';
+    readonly includeDirs: readonly ['taprpc', 'lnrpc'];
+    readonly keepaliveTimeMs: 60000;
+    readonly keepaliveTimeoutMs: 120000;
+    readonly maxReceiveMessageLength: 924288000;
+    readonly packageTypes: {
+        readonly AssetWallet: 'assetwalletrpc';
+        readonly Mailbox: 'authmailboxrpc';
+        readonly Mint: 'mintrpc';
+        readonly Rfq: 'rfqrpc';
+        readonly TapDev: 'tapdevrpc';
+        readonly TaprootAssetChannels: 'tapchannelrpc';
+        readonly TaprootAssets: 'taprpc';
+        readonly Universe: 'universerpc';
+    };
+    readonly protoFiles: {
+        readonly AssetWallet: 'taprpc/assetwalletrpc/assetwallet.proto';
+        readonly Mailbox: 'taprpc/authmailboxrpc/mailbox.proto';
+        readonly Mint: 'taprpc/mintrpc/mint.proto';
+        readonly Rfq: 'taprpc/rfqrpc/rfq.proto';
+        readonly TapDev: 'taprpc/tapdevrpc/tapdev.proto';
+        readonly TaprootAssetChannels: 'taprpc/tapchannelrpc/tapchannel.proto';
+        readonly TaprootAssets: 'taprpc/taprootassets.proto';
+        readonly Universe: 'taprpc/universerpc/universe.proto';
+    };
+    readonly protosDir: '../../protos/';
+    readonly serviceTypes: {
+        readonly assetwallet: 'AssetWallet';
+        readonly default: 'TaprootAssets';
+        readonly mailbox: 'Mailbox';
+        readonly mint: 'Mint';
+        readonly rfq: 'Rfq';
+        readonly tapchannel: 'TaprootAssetChannels';
+        readonly tapdev: 'TapDev';
+        readonly universe: 'Universe';
+    };
+};
+export default _default;
+//# sourceMappingURL=grpc_services.d.ts.map

package/dist/grpc/grpc_services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc_services.d.ts","sourceRoot":"","sources":["../../src/grpc/grpc_services.ts"],"names":[],"mappings":"AAAA;;;;EAIE;;aAEA,aAAa,EAAE,iBAAiB;aAChC,mBAAmB,EACjB,oOAAoO;aACtO,WAAW,YAAG,QAAQ,EAAE,OAAO;aAC/B,eAAe,EAAE,KAAK;aACtB,kBAAkB,EAAE,MAAM;aAC1B,uBAAuB,EAAE,SAAS;aAClC,YAAY;iBACV,WAAW,EAAE,gBAAgB;iBAC7B,OAAO,EAAE,gBAAgB;iBACzB,IAAI,EAAE,SAAS;iBACf,GAAG,EAAE,QAAQ;iBACb,MAAM,EAAE,WAAW;iBACnB,oBAAoB,EAAE,eAAe;iBACrC,aAAa,EAAE,QAAQ;iBACvB,QAAQ,EAAE,aAAa;;aAEzB,UAAU;iBACR,WAAW,EAAE,yCAAyC;iBACtD,OAAO,EAAE,qCAAqC;iBAC9C,IAAI,EAAE,2BAA2B;iBACjC,GAAG,EAAE,yBAAyB;iBAC9B,MAAM,EAAE,+BAA+B;iBACvC,oBAAoB,EAAE,uCAAuC;iBAC7D,aAAa,EAAE,4BAA4B;iBAC3C,QAAQ,EAAE,mCAAmC;;aAE/C,SAAS,EAAE,eAAe;aAC1B,YAAY;iBACV,WAAW,EAAE,aAAa;iBAC1B,OAAO,EAAE,eAAe;iBACxB,OAAO,EAAE,SAAS;iBAClB,IAAI,EAAE,MAAM;iBACZ,GAAG,EAAE,KAAK;iBACV,UAAU,EAAE,sBAAsB;iBAClC,MAAM,EAAE,QAAQ;iBAChB,QAAQ,EAAE,UAAU"}

package/dist/grpc/grpc_services.js

@@ -0,0 +1,45 @@
+/** gRPC settings for tapd
+
+  `includeDirs` and `protoFiles` paths are relative to `protosDir`.
+  `protosDir` is relative to the `tapd_grpc` directory.
+*/
+export default {
+    defaultSocket: 'localhost:10029',
+    grpcSslCipherSuites: 'HIGH+ECDSA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384',
+    includeDirs: ['taprpc', 'lnrpc'],
+    keepaliveTimeMs: 60000,
+    keepaliveTimeoutMs: 120000,
+    maxReceiveMessageLength: 924288000,
+    packageTypes: {
+        AssetWallet: 'assetwalletrpc',
+        Mailbox: 'authmailboxrpc',
+        Mint: 'mintrpc',
+        Rfq: 'rfqrpc',
+        TapDev: 'tapdevrpc',
+        TaprootAssetChannels: 'tapchannelrpc',
+        TaprootAssets: 'taprpc',
+        Universe: 'universerpc',
+    },
+    protoFiles: {
+        AssetWallet: 'taprpc/assetwalletrpc/assetwallet.proto',
+        Mailbox: 'taprpc/authmailboxrpc/mailbox.proto',
+        Mint: 'taprpc/mintrpc/mint.proto',
+        Rfq: 'taprpc/rfqrpc/rfq.proto',
+        TapDev: 'taprpc/tapdevrpc/tapdev.proto',
+        TaprootAssetChannels: 'taprpc/tapchannelrpc/tapchannel.proto',
+        TaprootAssets: 'taprpc/taprootassets.proto',
+        Universe: 'taprpc/universerpc/universe.proto',
+    },
+    protosDir: '../../protos/',
+    serviceTypes: {
+        assetwallet: 'AssetWallet',
+        default: 'TaprootAssets',
+        mailbox: 'Mailbox',
+        mint: 'Mint',
+        rfq: 'Rfq',
+        tapchannel: 'TaprootAssetChannels',
+        tapdev: 'TapDev',
+        universe: 'Universe',
+    },
+};
+//# sourceMappingURL=grpc_services.js.map

package/dist/grpc/grpc_services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc_services.js","sourceRoot":"","sources":["../../src/grpc/grpc_services.ts"],"names":[],"mappings":"AAAA;;;;EAIE;AACF,eAAe;IACb,aAAa,EAAE,iBAAiB;IAChC,mBAAmB,EACjB,oOAAoO;IACtO,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,MAAM;IAC1B,uBAAuB,EAAE,SAAS;IAClC,YAAY,EAAE;QACZ,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,WAAW;QACnB,oBAAoB,EAAE,eAAe;QACrC,aAAa,EAAE,QAAQ;QACvB,QAAQ,EAAE,aAAa;KACxB;IACD,UAAU,EAAE;QACV,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,qCAAqC;QAC9C,IAAI,EAAE,2BAA2B;QACjC,GAAG,EAAE,yBAAyB;QAC9B,MAAM,EAAE,+BAA+B;QACvC,oBAAoB,EAAE,uCAAuC;QAC7D,aAAa,EAAE,4BAA4B;QAC3C,QAAQ,EAAE,mCAAmC;KAC9C;IACD,SAAS,EAAE,eAAe;IAC1B,YAAY,EAAE;QACZ,WAAW,EAAE,aAAa;QAC1B,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,UAAU,EAAE,sBAAsB;QAClC,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,UAAU;KACrB;CACO,CAAC"}

package/dist/grpc/handle_remove_listener.d.ts

@@ -0,0 +1,18 @@
+import type { EventEmitter } from 'node:events';
+import type { ClientReadableStream } from '@grpc/grpc-js';
+type Args = {
+    emitter: EventEmitter;
+    events: string[];
+    subscription: ClientReadableStream<unknown>;
+};
+export default _default;
+/** Cancel a gRPC subscription when all its event listeners are removed
+
+  {
+    emitter: <EventEmitter Subscription Proxy Object>
+    events: [<Event Name String>]
+    subscription: <gRPC Subscription Object>
+  }
+*/
+declare function _default({ emitter, events, subscription }: Args): void;
+//# sourceMappingURL=handle_remove_listener.d.ts.map

package/dist/grpc/handle_remove_listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle_remove_listener.d.ts","sourceRoot":"","sources":["../../src/grpc/handle_remove_listener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAIxD,KAAK,IAAI,GAAG;IACV,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;CAC7C,CAAC;;AAEF;;;;;;;EAOE;0BACc,EAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAC,EAAE,IAAI"}

package/dist/grpc/handle_remove_listener.js

@@ -0,0 +1,22 @@
+const sumOf = (arr) => arr.reduce((sum, n) => sum + n, Number());
+/** Cancel a gRPC subscription when all its event listeners are removed
+
+  {
+    emitter: <EventEmitter Subscription Proxy Object>
+    events: [<Event Name String>]
+    subscription: <gRPC Subscription Object>
+  }
+*/
+export default ({ emitter, events, subscription }) => {
+    // Cancel the subscription when all listeners are removed
+    emitter.on('removeListener', () => {
+        const counts = events.map(n => emitter.listenerCount(n));
+        // Exit early when there are still active listeners
+        if (!!sumOf(counts)) {
+            return;
+        }
+        subscription.cancel();
+        return;
+    });
+};
+//# sourceMappingURL=handle_remove_listener.js.map

package/dist/grpc/handle_remove_listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle_remove_listener.js","sourceRoot":"","sources":["../../src/grpc/handle_remove_listener.ts"],"names":[],"mappings":"AAIA,MAAM,KAAK,GAAG,CAAC,GAAa,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAQ3E;;;;;;;EAOE;AACF,eAAe,CAAC,EAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAO,EAAE,EAAE;IACvD,yDAAyD;IACzD,OAAO,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzD,mDAAmD;QACnD,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,YAAY,CAAC,MAAM,EAAE,CAAC;QAEtB,OAAO;IACT,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/grpc/index.d.ts

@@ -0,0 +1,32 @@
+import emitSubscriptionError from './emit_subscription_error.js';
+import handleRemoveListener from './handle_remove_listener.js';
+export declare const defaultSocket: "localhost:10029", grpcSslCipherSuites: "HIGH+ECDSA:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384", includeDirs: readonly ["taprpc", "lnrpc"], keepaliveTimeMs: 60000, keepaliveTimeoutMs: 120000, maxReceiveMessageLength: 924288000, packageTypes: {
+    readonly AssetWallet: 'assetwalletrpc';
+    readonly Mailbox: 'authmailboxrpc';
+    readonly Mint: 'mintrpc';
+    readonly Rfq: 'rfqrpc';
+    readonly TapDev: 'tapdevrpc';
+    readonly TaprootAssetChannels: 'tapchannelrpc';
+    readonly TaprootAssets: 'taprpc';
+    readonly Universe: 'universerpc';
+}, protoFiles: {
+    readonly AssetWallet: 'taprpc/assetwalletrpc/assetwallet.proto';
+    readonly Mailbox: 'taprpc/authmailboxrpc/mailbox.proto';
+    readonly Mint: 'taprpc/mintrpc/mint.proto';
+    readonly Rfq: 'taprpc/rfqrpc/rfq.proto';
+    readonly TapDev: 'taprpc/tapdevrpc/tapdev.proto';
+    readonly TaprootAssetChannels: 'taprpc/tapchannelrpc/tapchannel.proto';
+    readonly TaprootAssets: 'taprpc/taprootassets.proto';
+    readonly Universe: 'taprpc/universerpc/universe.proto';
+}, protosDir: "../../protos/", serviceTypes: {
+    readonly assetwallet: 'AssetWallet';
+    readonly default: 'TaprootAssets';
+    readonly mailbox: 'Mailbox';
+    readonly mint: 'Mint';
+    readonly rfq: 'Rfq';
+    readonly tapchannel: 'TaprootAssetChannels';
+    readonly tapdev: 'TapDev';
+    readonly universe: 'Universe';
+};
+export { emitSubscriptionError, handleRemoveListener };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,MAAM,8BAA8B,CAAC;AAEjE,OAAO,oBAAoB,MAAM,6BAA6B,CAAC;AAE/D,eAAO,MACL,aAAa,qBACb,mBAAmB,wOACnB,WAAW,gCACX,eAAe,SACf,kBAAkB,UAClB,uBAAuB,aACvB,YAAY;;;;;;;;;GACZ,UAAU;;;;;;;;;GACV,SAAS,mBACT,YAAY;;;;;;;;;CACE,CAAC;AAEjB,OAAO,EAAC,qBAAqB,EAAE,oBAAoB,EAAC,CAAC"}

package/dist/grpc/index.js

@@ -0,0 +1,6 @@
+import emitSubscriptionError from './emit_subscription_error.js';
+import grpcServices from './grpc_services.js';
+import handleRemoveListener from './handle_remove_listener.js';
+export const { defaultSocket, grpcSslCipherSuites, includeDirs, keepaliveTimeMs, keepaliveTimeoutMs, maxReceiveMessageLength, packageTypes, protoFiles, protosDir, serviceTypes, } = grpcServices;
+export { emitSubscriptionError, handleRemoveListener };
+//# sourceMappingURL=index.js.map

package/dist/grpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/grpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,MAAM,8BAA8B,CAAC;AACjE,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,oBAAoB,MAAM,6BAA6B,CAAC;AAE/D,MAAM,CAAC,MAAM,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,GACb,GAAG,YAAY,CAAC;AAEjB,OAAO,EAAC,qBAAqB,EAAE,oBAAoB,EAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tapd_grpc/index.js';
+export * from './tapd_methods/index.js';
+export type * from './typescript/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,mBAAmB,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './tapd_grpc/index.js';
+export * from './tapd_methods/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/tapd_grpc/api_for_proto.d.ts

@@ -0,0 +1,28 @@
+import type { ChannelCredentials, ChannelOptions } from '@grpc/grpc-js';
+type Args = {
+    credentials: ChannelCredentials;
+    includes: string[];
+    params: ChannelOptions;
+    path: string;
+    service: string;
+    socket: string;
+    type: string;
+};
+export default _default;
+/** Get an api for a proto file
+
+  {
+    credentials: <gRPC Credentials Object>
+    includes: [<Proto Import Directory Path String>]
+    params: <gRPC Channel Options Object>
+    path: <Proto File Path String>
+    service: <Service Name String>
+    socket: <Host:Port Network Address String>
+    type: <RPC Type String>
+  }
+
+  @returns
+  <API Object>
+*/
+declare function _default(args: Args): any;
+//# sourceMappingURL=api_for_proto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api_for_proto.d.ts","sourceRoot":"","sources":["../../src/tapd_grpc/api_for_proto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,kBAAkB,EAAE,cAAc,EAAC,MAAM,eAAe,CAAC;AAKtE,KAAK,IAAI,GAAG;IACV,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;;AAEF;;;;;;;;;;;;;;EAcE;0BACc,IAAI,EAAE,IAAI"}

package/dist/tapd_grpc/api_for_proto.js

@@ -0,0 +1,24 @@
+import grpc from '@grpc/grpc-js';
+import { loadSync } from '@grpc/proto-loader';
+import grpcOptions from './grpc_options.js';
+/** Get an api for a proto file
+
+  {
+    credentials: <gRPC Credentials Object>
+    includes: [<Proto Import Directory Path String>]
+    params: <gRPC Channel Options Object>
+    path: <Proto File Path String>
+    service: <Service Name String>
+    socket: <Host:Port Network Address String>
+    type: <RPC Type String>
+  }
+
+  @returns
+  <API Object>
+*/
+export default (args) => {
+    const options = { ...grpcOptions, includeDirs: args.includes };
+    const rpc = grpc.loadPackageDefinition(loadSync(args.path, options));
+    return new rpc[args.type][args.service](args.socket, args.credentials, args.params);
+};
+//# sourceMappingURL=api_for_proto.js.map

package/dist/tapd_grpc/api_for_proto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_for_proto.js","sourceRoot":"","sources":["../../src/tapd_grpc/api_for_proto.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,eAAe,CAAC;AAEjC,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAE5C,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAY5C;;;;;;;;;;;;;;EAcE;AACF,eAAe,CAAC,IAAU,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,EAAC,GAAG,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAC,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAQ,CAAC;IAE5E,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CACrC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,CACZ,CAAC;AACJ,CAAC,CAAC"}

package/dist/tapd_grpc/authenticated_tapd_grpc.d.ts

@@ -0,0 +1,35 @@
+import type { AuthenticatedTapd } from './types.js';
+import type { TapdAuthentication } from './types.js';
+export default _default;
+/** Initiate a gRPC API Methods Object for authenticated methods
+
+  Both the cert and macaroon expect the entire serialized tapd generated file
+
+  {
+    [cert]: <Base64 or Hex Serialized tapd TLS Cert String>
+    [macaroon]: <Base64 or Hex Serialized Macaroon String>
+    [path]: <Path to Protos Directory With taprpc and lnrpc Directories String>
+    [socket]: <Host:Port Network Address String>
+  }
+
+  @throws
+  <Error>
+
+  @returns
+  {
+    tapd: {
+      assetwallet: <AssetWallet API Methods Object>
+      default: <TaprootAssets API Methods Object>
+      mailbox: <Mailbox API Methods Object>
+      mint: <Mint API Methods Object>
+      rfq: <Rfq API Methods Object>
+      tapchannel: <TaprootAssetChannels API Methods Object>
+      tapdev: <TapDev API Methods Object>
+      universe: <Universe API Methods Object>
+    }
+  }
+*/
+declare function _default(args: TapdAuthentication): {
+    tapd: AuthenticatedTapd;
+};
+//# sourceMappingURL=authenticated_tapd_grpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authenticated_tapd_grpc.d.ts","sourceRoot":"","sources":["../../src/tapd_grpc/authenticated_tapd_grpc.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;;AAOnD;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BE;0BACc,IAAI,EAAE,kBAAkB,GAAG;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAC"}

package/dist/tapd_grpc/authenticated_tapd_grpc.js

@@ -0,0 +1,76 @@
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { defaultSocket } from '../grpc/index.js';
+import { grpcSslCipherSuites } from '../grpc/index.js';
+import { includeDirs } from '../grpc/index.js';
+import { keepaliveTimeMs } from '../grpc/index.js';
+import { keepaliveTimeoutMs } from '../grpc/index.js';
+import { packageTypes } from '../grpc/index.js';
+import { protoFiles } from '../grpc/index.js';
+import { protosDir } from '../grpc/index.js';
+import { serviceTypes } from '../grpc/index.js';
+import apiForProto from './api_for_proto.js';
+import grpcCredentials from './grpc_credentials.js';
+const defaultProtosPath = fileURLToPath(new URL(protosDir, import.meta.url));
+const { GRPC_SSL_CIPHER_SUITES } = process.env;
+const { keys } = Object;
+/** Initiate a gRPC API Methods Object for authenticated methods
+
+  Both the cert and macaroon expect the entire serialized tapd generated file
+
+  {
+    [cert]: <Base64 or Hex Serialized tapd TLS Cert String>
+    [macaroon]: <Base64 or Hex Serialized Macaroon String>
+    [path]: <Path to Protos Directory With taprpc and lnrpc Directories String>
+    [socket]: <Host:Port Network Address String>
+  }
+
+  @throws
+  <Error>
+
+  @returns
+  {
+    tapd: {
+      assetwallet: <AssetWallet API Methods Object>
+      default: <TaprootAssets API Methods Object>
+      mailbox: <Mailbox API Methods Object>
+      mint: <Mint API Methods Object>
+      rfq: <Rfq API Methods Object>
+      tapchannel: <TaprootAssetChannels API Methods Object>
+      tapdev: <TapDev API Methods Object>
+      universe: <Universe API Methods Object>
+    }
+  }
+*/
+export default (args) => {
+    const { credentials } = grpcCredentials(args);
+    const protosPath = args.path || defaultProtosPath;
+    if (!!args.cert && GRPC_SSL_CIPHER_SUITES !== grpcSslCipherSuites) {
+        process.env.GRPC_SSL_CIPHER_SUITES = grpcSslCipherSuites;
+    }
+    const includes = includeDirs.map(dir => join(protosPath, dir));
+    const params = {
+        'grpc.keepalive_time_ms': keepaliveTimeMs,
+        'grpc.keepalive_timeout_ms': keepaliveTimeoutMs,
+        'grpc.max_receive_message_length': -1,
+        'grpc.max_send_message_length': -1,
+    };
+    const types = keys(serviceTypes);
+    // Assemble different services from their proto files
+    return {
+        tapd: types.reduce((services, type) => {
+            const service = serviceTypes[type];
+            services[type] = apiForProto({
+                credentials,
+                includes,
+                params,
+                service,
+                path: join(protosPath, protoFiles[service]),
+                socket: args.socket || defaultSocket,
+                type: packageTypes[service],
+            });
+            return services;
+        }, {}),
+    };
+};
+//# sourceMappingURL=authenticated_tapd_grpc.js.map

package/dist/tapd_grpc/authenticated_tapd_grpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticated_tapd_grpc.js","sourceRoot":"","sources":["../../src/tapd_grpc/authenticated_tapd_grpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAC9C,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAKpD,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7E,MAAM,EAAC,sBAAsB,EAAC,GAAG,OAAO,CAAC,GAAG,CAAC;AAC7C,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BE;AACF,eAAe,CAAC,IAAwB,EAA6B,EAAE;IACrE,MAAM,EAAC,WAAW,EAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,iBAAiB,CAAC;IAElD,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,sBAAsB,KAAK,mBAAmB,EAAE,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,mBAAmB,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG;QACb,wBAAwB,EAAE,eAAe;QACzC,2BAA2B,EAAE,kBAAkB;QAC/C,iCAAiC,EAAE,CAAC,CAAC;QACrC,8BAA8B,EAAE,CAAC,CAAC;KACnC,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAsB,CAAC;IAEtD,qDAAqD;IACrD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;YACpC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAEnC,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;gBAC3B,WAAW;gBACX,QAAQ;gBACR,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC3C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa;gBACpC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;aAC5B,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC,EAAE,EAAuB,CAAC;KAC5B,CAAC;AACJ,CAAC,CAAC"}

package/dist/tapd_grpc/decode_serialized.d.ts

@@ -0,0 +1,18 @@
+export default _default;
+/** Get decoded Base64 or Hex encoded data
+
+  {
+    [serialized]: <Serialized Data String>
+  }
+
+  @returns
+  {
+    [decoded]: <Deserialized Data Buffer>
+  }
+*/
+declare function _default({ serialized }: {
+    serialized?: string;
+}): {
+    decoded?: Buffer;
+};
+//# sourceMappingURL=decode_serialized.d.ts.map

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

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

package/dist/tapd_grpc/decode_serialized.js

@@ -0,0 +1,23 @@
+const { from } = Buffer;
+const isHex = (n) => !(n.length % 2) && /^[0-9A-F]*$/i.test(n);
+/** Get decoded Base64 or Hex encoded data
+
+  {
+    [serialized]: <Serialized Data String>
+  }
+
+  @returns
+  {
+    [decoded]: <Deserialized Data Buffer>
+  }
+*/
+export default ({ serialized }) => {
+    if (!!serialized && !isHex(serialized)) {
+        return { decoded: from(serialized, 'base64') };
+    }
+    if (!!serialized && isHex(serialized)) {
+        return { decoded: from(serialized, 'hex') };
+    }
+    return {};
+};
+//# sourceMappingURL=decode_serialized.js.map

package/dist/tapd_grpc/decode_serialized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode_serialized.js","sourceRoot":"","sources":["../../src/tapd_grpc/decode_serialized.ts"],"names":[],"mappings":"AAAA,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,CAAC;AACtB,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEvE;;;;;;;;;;EAUE;AACF,eAAe,CAAC,EAAC,UAAU,EAAwB,EAAsB,EAAE;IACzE,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,EAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,EAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC"}