@fedimint/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 fedimint
+
+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

@@ -0,0 +1,18 @@
+# @fedimint/core
+
+### This is early software. Use with caution. Report Bugs.
+
+Check out the [Getting Started Guide](https://web.fedimint.org/core/getting-started.html) for more information.
+
+> Note: `@fedimint/core` now expects a platform-specific transport implementation. For browser usage install `@fedimint/transport-web` and provide a `WasmWorkerTransport` instance when constructing a `WalletDirector`.
+
+---
+
+Also check out the examples for working code
+
+- [Vite + React](https://web.fedimint.org/examples/vite-react)
+- [Bare JS](https://web.fedimint.org/examples/bare-js)
+
+### Resources
+
+- [Bitcoin Mints](https://bitcoinmints.com/?tab=mints&showFedimint=true) - list of public federations with invite codes

package/dist/dts/FedimintWallet.d.ts

@@ -0,0 +1,51 @@
+import { TransportClient } from './transport';
+import { BalanceService, MintService, LightningService, FederationService, RecoveryService, WalletService } from './services';
+export declare class FedimintWallet {
+    private _client;
+    balance: BalanceService;
+    mint: MintService;
+    lightning: LightningService;
+    federation: FederationService;
+    recovery: RecoveryService;
+    wallet: WalletService;
+    private _openPromise;
+    private _resolveOpen;
+    private _isOpen;
+    /**
+     * Creates a new instance of FedimintWallet.
+     *
+     * This constructor initializes a FedimintWallet instance, which manages communication
+     * with a Web Worker. The Web Worker is responsible for running WebAssembly code that
+     * handles the core Fedimint Client operations.
+     *
+     * (default) When not in lazy mode, the constructor immediately initializes the
+     * Web Worker and begins loading the WebAssembly module in the background. This
+     * allows for faster subsequent operations but may increase initial load time.
+     *
+     * In lazy mode, the Web Worker and WebAssembly initialization are deferred until
+     * the first operation that requires them, reducing initial overhead at the cost
+     * of a slight delay on the first operation.
+     *
+     * @example
+     * // Create a wallet with immediate initialization
+     * const wallet = new FedimintWallet();
+     * wallet.open();
+     *
+     * // Create a wallet with lazy initialization
+     * const lazyWallet = new FedimintWallet(true);
+     * // Some time later...
+     * lazyWallet.initialize();
+     * lazyWallet.open();
+     */
+    constructor(_client: TransportClient);
+    waitForOpen(): Promise<void>;
+    open(clientName?: string): Promise<boolean>;
+    joinFederation(inviteCode: string, clientName?: string): Promise<boolean>;
+    /**
+     * This should ONLY be called when UNLOADING the wallet client.
+     * After this call, the FedimintWallet instance should be discarded.
+     */
+    cleanup(): Promise<void>;
+    isOpen(): boolean;
+}
+//# sourceMappingURL=FedimintWallet.d.ts.map

package/dist/dts/FedimintWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FedimintWallet.d.ts","sourceRoot":"","sources":["../../src/FedimintWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAA;AAInB,qBAAa,cAAc;IAsCb,OAAO,CAAC,OAAO;IArCpB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,UAAU,EAAE,iBAAiB,CAAA;IAC7B,QAAQ,EAAE,eAAe,CAAA;IACzB,MAAM,EAAE,aAAa,CAAA;IAE5B,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,OAAO,CAAiB;IAEhC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;gBACiB,OAAO,EAAE,eAAe;IAYtC,WAAW;IAKX,IAAI,CAAC,UAAU,GAAE,MAA4B;IAa7C,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAA4B;IAuB1C;;;OAGG;IACG,OAAO;IAMb,MAAM;CAGP"}

package/dist/dts/WalletDirector.d.ts

@@ -0,0 +1,79 @@
+import { TransportClient } from './transport';
+import { type LogLevel } from './utils/logger';
+import { FederationConfig, JSONValue } from './types';
+import { Transport } from '@fedimint/types';
+import { FedimintWallet } from './FedimintWallet';
+export declare class WalletDirector {
+    protected _client: TransportClient;
+    /**
+     * Creates a new instance of WalletDirector.
+     *
+     * @param {Transport} [transport] - Optional worker client instance. Provide your
+     *                         own to use a custom transport (e.g. React Native).
+     *
+     * @param {boolean} lazy - If true, delays Web Worker and WebAssembly initialization
+     *                         until needed. Default is false.
+     */
+    constructor(transport: Transport, lazy?: boolean);
+    initialize(): Promise<void>;
+    createWallet(): Promise<FedimintWallet>;
+    previewFederation(inviteCode: string): Promise<{
+        config: FederationConfig;
+        federation_id: string;
+    }>;
+    /**
+     * Sets the log level for the library.
+     * @param level The desired log level ('DEBUG', 'INFO', 'WARN', 'ERROR', 'NONE').
+     */
+    setLogLevel(level: LogLevel): void;
+    /**
+     * Parses a federation invite code and retrieves its details.
+     *
+     * This method sends the provided invite code to the TransportClient for parsing.
+     * The response includes the federation_id and url.
+     *
+     * @param {string} inviteCode - The invite code to be parsed.
+     * @returns {Promise<{ federation_id: string, url: string}>}
+     *          A promise that resolves to an object containing:
+     *          - `federation_id`: The id of the feder.
+     *          - `url`: One of the apipoints to connect to the federation
+     *
+     * @throws {Error} If the TransportClient encounters an issue during the parsing process.
+     *
+     * @example
+     * const inviteCode = "example-invite-code";
+     * const parsedCode = await wallet.parseInviteCode(inviteCode);
+     * console.log(parsedCode.federation_id, parsedCode.url);
+     */
+    parseInviteCode(inviteCode: string): Promise<{
+        type: string;
+        data: JSONValue;
+        requestId: number;
+    }>;
+    /**
+     * Parses a BOLT11 Lightning invoice and retrieves its details.
+     *
+     * This method sends the provided invoice string to the TransportClient for parsing.
+     * The response includes details such as the amount, expiry, and memo.
+     *
+     * @param {string} invoiceStr - The BOLT11 invoice string to be parsed.
+     * @returns {Promise<{ amount: string, expiry: number, memo: string }>}
+     *          A promise that resolves to an object containing:
+     *          - `amount`: The amount specified in the invoice.
+     *          - `expiry`: The expiry time of the invoice in seconds.
+     *          - `memo`: A description or memo attached to the invoice.
+     *
+     * @throws {Error} If the TransportClient encounters an issue during the parsing process.
+     *
+     * @example
+     * const invoiceStr = "lnbc1...";
+     * const parsedInvoice = await wallet.parseBolt11Invoice(invoiceStr);
+     * console.log(parsedInvoice.amount, parsedInvoice.expiry, parsedInvoice.memo);
+     */
+    parseBolt11Invoice(invoiceStr: string): Promise<{
+        type: string;
+        data: JSONValue;
+        requestId: number;
+    }>;
+}
+//# sourceMappingURL=WalletDirector.d.ts.map

package/dist/dts/WalletDirector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletDirector.d.ts","sourceRoot":"","sources":["../../src/WalletDirector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,qBAAa,cAAc;IAEzB,SAAS,CAAC,OAAO,EAAE,eAAe,CAAA;IAElC;;;;;;;;OAQG;gBACS,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,OAAe;IAWjD,UAAU;IAOV,YAAY;IAKZ,iBAAiB,CAAC,UAAU,EAAE,MAAM;gBAG9B,gBAAgB;uBACT,MAAM;;IAKzB;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ;IAK3B;;;;;;;;;;;;;;;;;;OAkBG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM;cAG9B,MAAM;cACN,SAAS;mBACJ,MAAM;;IAKrB;;;;;;;;;;;;;;;;;;;OAmBG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM;cAGjC,MAAM;cACN,SAAS;mBACJ,MAAM;;CAItB"}

package/dist/dts/index.d.ts

@@ -0,0 +1,5 @@
+export { WalletDirector } from './WalletDirector';
+export { TransportClient } from './transport';
+export type { FedimintWallet } from './FedimintWallet';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,mBAAmB,SAAS,CAAA"}

package/dist/dts/services/BalanceService.d.ts

@@ -0,0 +1,15 @@
+import { TransportClient } from '../transport';
+/**
+ * Balance Service
+ *
+ * The Balance Service provides methods to interact with the balance of a Fedimint wallet.
+ */
+export declare class BalanceService {
+    private client;
+    constructor(client: TransportClient);
+    /** https://web.fedimint.org/core/FedimintWallet/BalanceService/getBalance */
+    getBalance(): Promise<number>;
+    /** https://web.fedimint.org/core/FedimintWallet/BalanceService/subscribeBalance */
+    subscribeBalance(onSuccess?: (balanceMsats: number) => void, onError?: (error: string) => void): import("..").CancelFunction;
+}
+//# sourceMappingURL=BalanceService.d.ts.map

package/dist/dts/services/BalanceService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BalanceService.d.ts","sourceRoot":"","sources":["../../../src/services/BalanceService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;GAIG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,6EAA6E;IACvE,UAAU;IAIhB,mFAAmF;IACnF,gBAAgB,CACd,SAAS,GAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAe,EACpD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;CAU9C"}

package/dist/dts/services/FederationService.d.ts

@@ -0,0 +1,13 @@
+import type { OperationKey, OperationLog, Transactions } from '../types';
+import { TransportClient } from '../transport';
+export declare class FederationService {
+    private client;
+    constructor(client: TransportClient);
+    getConfig(): Promise<import("@fedimint/types").JSONValue>;
+    getFederationId(): Promise<string>;
+    getInviteCode(peer?: number): Promise<string | null>;
+    listOperations(limit?: number, last_seen?: OperationKey): Promise<[OperationKey, OperationLog][]>;
+    getOperation(operationId: string): Promise<OperationLog | null>;
+    listTransactions(limit?: number, last_seen?: OperationKey): Promise<Transactions[]>;
+}
+//# sourceMappingURL=FederationService.d.ts.map

package/dist/dts/services/FederationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FederationService.d.ts","sourceRoot":"","sources":["../../../src/services/FederationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,YAAY,EACZ,YAAY,EACZ,YAAY,EAGb,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,SAAS;IAIT,eAAe;IAIf,aAAa,CAAC,IAAI,GAAE,MAAU;IAM9B,cAAc,CAClB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;IAWpC,YAAY,CAAC,WAAW,EAAE,MAAM;IAQhC,gBAAgB,CACpB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,YAAY,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;CAgK3B"}

package/dist/dts/services/LightningService.d.ts

@@ -0,0 +1,48 @@
+import { TransportClient } from '../transport';
+import type { CreateBolt11Response, GatewayInfo, JSONObject, LightningGateway, LnInternalPayState, LnPayState, LnReceiveState, OutgoingLightningPayment } from '../types';
+export declare class LightningService {
+    private client;
+    constructor(client: TransportClient);
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/createInvoice#lightning-createinvoice */
+    createInvoice(amountMsats: number, description: string, expiryTime?: number, // in seconds
+    gatewayInfo?: GatewayInfo, extraMeta?: JSONObject): Promise<CreateBolt11Response>;
+    createInvoiceTweaked(amountMsats: number, description: string, tweakKey: string, index: number, expiryTime?: number, // in seconds
+    gatewayInfo?: GatewayInfo, extraMeta?: JSONObject): Promise<CreateBolt11Response>;
+    scanReceivesForTweaks(tweakKey: string, indices: number[], extraMeta?: JSONObject): Promise<string[]>;
+    private _getDefaultGatewayInfo;
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/payInvoice#lightning-payinvoice-invoice-string */
+    payInvoice(invoice: string, gatewayInfo?: GatewayInfo, extraMeta?: JSONObject): Promise<OutgoingLightningPayment>;
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/payInvoice#lightning-payinvoicesync-invoice-string */
+    payInvoiceSync(invoice: string, timeoutMs?: number, gatewayInfo?: GatewayInfo, extraMeta?: JSONObject): Promise<{
+        success: false;
+        error?: string;
+    } | {
+        success: true;
+        data: {
+            feeMsats: number;
+            preimage: string;
+        };
+    }>;
+    subscribeInternalPayment(operation_id: string, onSuccess?: (state: LnInternalPayState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+    subscribeLnClaim(operationId: string, onSuccess?: (state: LnReceiveState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/payInvoice#lightning-payinvoice-invoice-string */
+    subscribeLnPay(operationId: string, onSuccess?: (state: LnPayState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/payInvoice#lightning-payinvoice-invoice-string */
+    waitForPay(operationId: string): Promise<{
+        success: false;
+        error?: string;
+    } | {
+        success: true;
+        data: {
+            preimage: string;
+        };
+    }>;
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/createInvoice#lightning-createinvoice */
+    subscribeLnReceive(operationId: string, onSuccess?: (state: LnReceiveState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+    /** https://web.fedimint.org/core/FedimintWallet/LightningService/createInvoice#lightning-createinvoice */
+    waitForReceive(operationId: string, timeoutMs?: number): Promise<LnReceiveState>;
+    getGateway(gatewayId?: string | null, forceInternal?: boolean): Promise<LightningGateway | null>;
+    listGateways(): Promise<LightningGateway[]>;
+    updateGatewayCache(): Promise<import("@fedimint/types").JSONValue>;
+}
+//# sourceMappingURL=LightningService.d.ts.map

package/dist/dts/services/LightningService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightningService.d.ts","sourceRoot":"","sources":["../../../src/services/LightningService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,wBAAwB,EACzB,MAAM,UAAU,CAAA;AAEjB,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,0GAA0G;IACpG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa;IAClC,WAAW,CAAC,EAAE,WAAW,EACzB,SAAS,CAAC,EAAE,UAAU;IAgBlB,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa;IAClC,WAAW,CAAC,EAAE,WAAW,EACzB,SAAS,CAAC,EAAE,UAAU;IAmBlB,qBAAqB,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,CAAC,EAAE,UAAU;YAaV,sBAAsB;IAMpC,mHAAmH;IAC7G,UAAU,CACd,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,EACzB,SAAS,CAAC,EAAE,UAAU;IAcxB,uHAAuH;IACjH,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAc,EACzB,WAAW,CAAC,EAAE,WAAW,EACzB,SAAS,CAAC,EAAE,UAAU;iBAGP,KAAK;gBAAU,MAAM;;iBAErB,IAAI;cACP;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;;IA8BpD,wBAAwB,CACtB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAe,EACzD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;IAY7C,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAe,EACrD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;IAa7C,mHAAmH;IACnH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAe,EACjD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;IAW7C,mHAAmH;IAC7G,UAAU,CAAC,WAAW,EAAE,MAAM;iBAEnB,KAAK;gBAAU,MAAM;;iBACrB,IAAI;cAAQ;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE;;IA4BjD,0GAA0G;IAC1G,kBAAkB,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAe,EACrD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;IAW7C,0GAA0G;IACpG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc;IAyB7D,UAAU,CACd,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,aAAa,GAAE,OAAe;IAY1B,YAAY;IAQZ,kBAAkB;CAGzB"}

package/dist/dts/services/MintService.d.ts

@@ -0,0 +1,23 @@
+import { TransportClient } from '../transport';
+import type { Duration, JSONObject, JSONValue, NoteCountByDenomination, ReissueExternalNotesState, SpendNotesState } from '../types';
+export declare class MintService {
+    private client;
+    constructor(client: TransportClient);
+    /** https://web.fedimint.org/core/FedimintWallet/MintService/redeemEcash */
+    redeemEcash(notes: string): Promise<string>;
+    reissueExternalNotes(oobNotes: string, extraMeta?: JSONObject): Promise<string>;
+    subscribeReissueExternalNotes(operationId: string, onSuccess?: (state: ReissueExternalNotesState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+    /** https://web.fedimint.org/core/FedimintWallet/MintService/spendNotes */
+    spendNotes(amountMsats: number, tryCancelAfter?: number | Duration, // defaults to 1 day
+    includeInvite?: boolean, extraMeta?: JSONValue): Promise<{
+        notes: string;
+        operation_id: string;
+    }>;
+    /** https://web.fedimint.org/core/FedimintWallet/MintService/parseEcash */
+    parseNotes(oobNotes: string): Promise<number>;
+    tryCancelSpendNotes(operationId: string): Promise<void>;
+    subscribeSpendNotes(operationId: string, onSuccess?: (state: SpendNotesState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+    awaitSpendOobRefund(operationId: string): Promise<JSONValue>;
+    getNotesByDenomination(): Promise<NoteCountByDenomination>;
+}
+//# sourceMappingURL=MintService.d.ts.map

package/dist/dts/services/MintService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MintService.d.ts","sourceRoot":"","sources":["../../../src/services/MintService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EAGT,uBAAuB,EACvB,yBAAyB,EACzB,eAAe,EAChB,MAAM,UAAU,CAAA;AAEjB,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,2EAA2E;IACrE,WAAW,CAAC,KAAK,EAAE,MAAM;IAWzB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,UAAe;IAWvE,6BAA6B,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAe,EAChE,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;IAa7C,0EAA0E;IACpE,UAAU,CACd,WAAW,EAAE,MAAM,EAInB,cAAc,GAAE,MAAM,GAAG,QAAoB,EAAE,oBAAoB;IACnE,aAAa,GAAE,OAAe,EAC9B,SAAS,GAAE,SAAc;;;;IA0B3B,0EAA0E;IACpE,UAAU,CAAC,QAAQ,EAAE,MAAM;IAM3B,mBAAmB,CAAC,WAAW,EAAE,MAAM;IAM7C,mBAAmB,CACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAe,EACtD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;IAWvC,mBAAmB,CAAC,WAAW,EAAE,MAAM;IAMvC,sBAAsB;CAO7B"}

package/dist/dts/services/RecoveryService.d.ts

@@ -0,0 +1,13 @@
+import type { JSONValue } from '../types';
+import { TransportClient } from '../transport';
+export declare class RecoveryService {
+    private client;
+    constructor(client: TransportClient);
+    hasPendingRecoveries(): Promise<boolean>;
+    waitForAllRecoveries(): Promise<void>;
+    subscribeToRecoveryProgress(onSuccess: (progress: {
+        module_id: number;
+        progress: JSONValue;
+    }) => void, onError: (error: string) => void): import("../types").CancelFunction;
+}
+//# sourceMappingURL=RecoveryService.d.ts.map

package/dist/dts/services/RecoveryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryService.d.ts","sourceRoot":"","sources":["../../../src/services/RecoveryService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,oBAAoB;IAQpB,oBAAoB;IAI1B,2BAA2B,CACzB,SAAS,EAAE,CAAC,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,CAAA;KAAE,KAAK,IAAI,EACzE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;CAOnC"}

package/dist/dts/services/WalletService.d.ts

@@ -0,0 +1,13 @@
+import { JSONValue, WalletSummary, GenerateAddressResponse, WalletDepositState } from '../types';
+import { TransportClient } from '../transport';
+export declare class WalletService {
+    private client;
+    constructor(client: TransportClient);
+    getWalletSummary(): Promise<WalletSummary>;
+    generateAddress(extraMeta?: JSONValue): Promise<GenerateAddressResponse>;
+    sendOnchain(amountSat: number, address: string, extraMeta?: JSONValue): Promise<{
+        operation_id: string;
+    }>;
+    subscribeDeposit(operation_id: string, onSuccess?: (state: WalletDepositState) => void, onError?: (error: string) => void): import("../types").CancelFunction;
+}
+//# sourceMappingURL=WalletService.d.ts.map

package/dist/dts/services/WalletService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletService.d.ts","sourceRoot":"","sources":["../../../src/services/WalletService.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAI1C,eAAe,CAAC,SAAS,GAAE,SAAc;IAUzC,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAc,GACxB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAOpC,gBAAgB,CACd,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAe,EACzD,OAAO,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAe;CAU9C"}

package/dist/dts/services/index.d.ts

@@ -0,0 +1,7 @@
+export { MintService } from './MintService';
+export { BalanceService } from './BalanceService';
+export { LightningService } from './LightningService';
+export { RecoveryService } from './RecoveryService';
+export { FederationService } from './FederationService';
+export { WalletService } from './WalletService';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/dts/transport/TransportClient.d.ts

@@ -0,0 +1,55 @@
+import type { CancelFunction, JSONValue, ModuleKind, StreamError } from '../types';
+import { Logger } from '../utils/logger';
+import type { Transport, TransportMessageType } from '@fedimint/types';
+/**
+ * Handles communication with a generic transport.
+ * Must be instantiated with a platform-specific transport. (wasm for web, react native, etc.)
+ */
+export declare class TransportClient {
+    private readonly transport;
+    private requestCounter;
+    private requestCallbacks;
+    private initPromise;
+    logger: Logger;
+    /**
+     * @summary Constructor for the TransportClient
+     * @param transport - The platform-specific transport to use. (wasm for web, react native, etc.)
+     */
+    constructor(transport: Transport);
+    initialize(): Promise<boolean>;
+    private handleLogMessage;
+    private handleTransportError;
+    private handleTransportMessage;
+    sendSingleMessage<Response extends JSONValue = JSONValue, Payload extends JSONValue = JSONValue>(type: TransportMessageType, payload?: Payload): Promise<Response>;
+    /**
+     * @summary Initiates an RPC stream with the specified module and method.
+     *
+     * @description
+     * This function sets up an RPC stream by sending a request to a worker and
+     * handling responses asynchronously. It ensures that unsubscription is handled
+     * correctly, even if the unsubscribe function is called before the subscription
+     * is fully established, by deferring the unsubscription attempt using `setTimeout`.
+     *
+     * The function operates in a non-blocking manner, leveraging Promises to manage
+     * asynchronous operations and callbacks to handle responses.
+     *
+     *
+     * @template Response - The expected type of the successful response.
+     * @template Body - The type of the request body.
+     * @param module - The module kind to interact with.
+     * @param method - The method name to invoke on the module.
+     * @param body - The request payload.
+     * @param onSuccess - Callback invoked with the response data on success.
+     * @param onError - Callback invoked with error information if an error occurs.
+     * @param onEnd - Optional callback invoked when the stream ends.
+     * @returns A function that can be called to cancel the subscription.
+     *
+     */
+    rpcStream<Response extends JSONValue = JSONValue, Body extends JSONValue = JSONValue>(module: ModuleKind, method: string, body: Body, onSuccess: (res: Response) => void, onError: (res: StreamError['error']) => void, onEnd?: () => void): CancelFunction;
+    private _rpcStreamInner;
+    rpcSingle<Response extends JSONValue = JSONValue, Error extends string = string>(module: ModuleKind, method: string, body: JSONValue): Promise<Response>;
+    cleanup(): Promise<void>;
+    _getRequestCounter(): number;
+    _getRequestCallbackMap(): Map<number, (value: any) => void>;
+}
+//# sourceMappingURL=TransportClient.d.ts.map

package/dist/dts/transport/TransportClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportClient.d.ts","sourceRoot":"","sources":["../../../src/transport/TransportClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EAEZ,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,EACV,SAAS,EAET,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,WAAW,CAA0C;IAC7D,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;gBACS,SAAS,EAAE,SAAS;IAUhC,UAAU;IAMV,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,oBAAoB,CAE3B;IAED,OAAO,CAAC,sBAAsB,CAkB7B;IAMD,iBAAiB,CACf,QAAQ,SAAS,SAAS,GAAG,SAAS,EACtC,OAAO,SAAS,SAAS,GAAG,SAAS,EACrC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,OAAO;IAgC/C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CACP,QAAQ,SAAS,SAAS,GAAG,SAAS,EACtC,IAAI,SAAS,SAAS,GAAG,SAAS,EAElC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,EAClC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,EAC5C,KAAK,GAAE,MAAM,IAAe,GAC3B,cAAc;YA0CH,eAAe;IAuC7B,SAAS,CACP,QAAQ,SAAS,SAAS,GAAG,SAAS,EACtC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAO/C,OAAO;IAQb,kBAAkB;IAGlB,sBAAsB,wBApO6B,GAAG,KAAK,IAAI;CAuOhE"}

package/dist/dts/transport/index.d.ts

@@ -0,0 +1,2 @@
+export { TransportClient } from './TransportClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/dts/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './wallet';
+export * from './utils';
+export * from './transport';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/dist/dts/types/transport.d.ts

@@ -0,0 +1,2 @@
+export * from '@fedimint/types';
+//# sourceMappingURL=transport.d.ts.map

package/dist/dts/types/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/types/transport.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/dts/types/utils.d.ts

@@ -0,0 +1,21 @@
+import type { JSONValue } from '@fedimint/types';
+type Alias<T> = T & {};
+type Resolve<T> = T & unknown;
+type Seconds = Alias<number>;
+type Nanos = Alias<number>;
+type Duration = {
+    nanos: Nanos;
+    secs: Seconds;
+};
+type MSats = Alias<number>;
+type Sats = Alias<number>;
+type JSONObject = Record<string, JSONValue>;
+type Result<T, U = string> = {
+    success: true;
+    data?: T;
+} | {
+    success: false;
+    error: U;
+};
+export { Alias, Resolve, Duration, MSats, Sats, JSONValue, JSONObject, Result };
+//# sourceMappingURL=utils.d.ts.map

package/dist/dts/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/types/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;AACtB,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;AAE7B,KAAK,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;AAC5B,KAAK,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;AAE1B,KAAK,QAAQ,GAAG;IACd,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,KAAK,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;AAC1B,KAAK,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;AAEzB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAE3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,IACrB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAEhC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA"}