@bitgo-beta/abstract-lightning 1.0.1-beta.98 → 1.0.1-beta.981

package/dist/src/lightning/signature.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyMessageSignature = verifyMessageSignature;
+exports.createMessageSignature = createMessageSignature;
+const utxolib = __importStar(require("@bitgo-beta/utxo-lib"));
+const sdkcore = __importStar(require("@bitgo-beta/sdk-core"));
+const signableJson_1 = require("./signableJson");
+/**
+ * Verifies a signature for a given message.
+ *
+ * @param {Signable} message - The message to verify.
+ * @param {string} signature - The signature to verify, in hexadecimal format.
+ * @param {string} pub - The public key in BIP32 format.
+ * @param {utxolib.Network} network - The network to use for verification.
+ * @returns {boolean} - Returns true if the signature is valid, false otherwise.
+ */
+function verifyMessageSignature(message, signature, pub, network = utxolib.networks.bitcoin) {
+    const messageString = JSON.stringify((0, signableJson_1.canonicalizeObject)(message));
+    const pubKey = utxolib.bip32.fromBase58(pub, network).publicKey;
+    const signatureBuffer = Buffer.from(signature, 'hex');
+    return sdkcore.verifyMessage(messageString, pubKey, signatureBuffer, network);
+}
+/**
+ * Creates a signature for a given message.
+ *
+ * @param {Signable} message - The message to sign.
+ * @param {string} prv - The private key in BIP32 format.
+ * @param {utxolib.Network} network - The network to use for signing.
+ * @returns {string} - Returns the signature in hexadecimal format.
+ */
+function createMessageSignature(message, xprv, network = utxolib.networks.bitcoin) {
+    const requestString = JSON.stringify((0, signableJson_1.canonicalizeObject)(message));
+    const prvKey = utxolib.bip32.fromBase58(xprv, network);
+    return sdkcore.signMessage(requestString, prvKey, network).toString('hex');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2lnbmF0dXJlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2xpZ2h0bmluZy9zaWduYXR1cmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFhQSx3REFVQztBQVVELHdEQVFDO0FBekNELDhEQUFnRDtBQUNoRCw4REFBZ0Q7QUFDaEQsaURBQThEO0FBRTlEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBZ0Isc0JBQXNCLENBQ3BDLE9BQWlCLEVBQ2pCLFNBQWlCLEVBQ2pCLEdBQVcsRUFDWCxVQUEyQixPQUFPLENBQUMsUUFBUSxDQUFDLE9BQU87SUFFbkQsTUFBTSxhQUFhLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFBLGlDQUFrQixFQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDbEUsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDLFNBQVMsQ0FBQztJQUNoRSxNQUFNLGVBQWUsR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUN0RCxPQUFPLE9BQU8sQ0FBQyxhQUFhLENBQUMsYUFBYSxFQUFFLE1BQU0sRUFBRSxlQUFlLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFDaEYsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxTQUFnQixzQkFBc0IsQ0FDcEMsT0FBaUIsRUFDakIsSUFBWSxFQUNaLFVBQTJCLE9BQU8sQ0FBQyxRQUFRLENBQUMsT0FBTztJQUVuRCxNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUEsaUNBQWtCLEVBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQztJQUNsRSxNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDdkQsT0FBTyxPQUFPLENBQUMsV0FBVyxDQUFDLGFBQWEsRUFBRSxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDO0FBQzdFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyB1dHhvbGliIGZyb20gJ0BiaXRnby1iZXRhL3V0eG8tbGliJztcbmltcG9ydCAqIGFzIHNka2NvcmUgZnJvbSAnQGJpdGdvLWJldGEvc2RrLWNvcmUnO1xuaW1wb3J0IHsgY2Fub25pY2FsaXplT2JqZWN0LCBTaWduYWJsZSB9IGZyb20gJy4vc2lnbmFibGVKc29uJztcblxuLyoqXG4gKiBWZXJpZmllcyBhIHNpZ25hdHVyZSBmb3IgYSBnaXZlbiBtZXNzYWdlLlxuICpcbiAqIEBwYXJhbSB7U2lnbmFibGV9IG1lc3NhZ2UgLSBUaGUgbWVzc2FnZSB0byB2ZXJpZnkuXG4gKiBAcGFyYW0ge3N0cmluZ30gc2lnbmF0dXJlIC0gVGhlIHNpZ25hdHVyZSB0byB2ZXJpZnksIGluIGhleGFkZWNpbWFsIGZvcm1hdC5cbiAqIEBwYXJhbSB7c3RyaW5nfSBwdWIgLSBUaGUgcHVibGljIGtleSBpbiBCSVAzMiBmb3JtYXQuXG4gKiBAcGFyYW0ge3V0eG9saWIuTmV0d29ya30gbmV0d29yayAtIFRoZSBuZXR3b3JrIHRvIHVzZSBmb3IgdmVyaWZpY2F0aW9uLlxuICogQHJldHVybnMge2Jvb2xlYW59IC0gUmV0dXJucyB0cnVlIGlmIHRoZSBzaWduYXR1cmUgaXMgdmFsaWQsIGZhbHNlIG90aGVyd2lzZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHZlcmlmeU1lc3NhZ2VTaWduYXR1cmUoXG4gIG1lc3NhZ2U6IFNpZ25hYmxlLFxuICBzaWduYXR1cmU6IHN0cmluZyxcbiAgcHViOiBzdHJpbmcsXG4gIG5ldHdvcms6IHV0eG9saWIuTmV0d29yayA9IHV0eG9saWIubmV0d29ya3MuYml0Y29pblxuKTogYm9vbGVhbiB7XG4gIGNvbnN0IG1lc3NhZ2VTdHJpbmcgPSBKU09OLnN0cmluZ2lmeShjYW5vbmljYWxpemVPYmplY3QobWVzc2FnZSkpO1xuICBjb25zdCBwdWJLZXkgPSB1dHhvbGliLmJpcDMyLmZyb21CYXNlNTgocHViLCBuZXR3b3JrKS5wdWJsaWNLZXk7XG4gIGNvbnN0IHNpZ25hdHVyZUJ1ZmZlciA9IEJ1ZmZlci5mcm9tKHNpZ25hdHVyZSwgJ2hleCcpO1xuICByZXR1cm4gc2RrY29yZS52ZXJpZnlNZXNzYWdlKG1lc3NhZ2VTdHJpbmcsIHB1YktleSwgc2lnbmF0dXJlQnVmZmVyLCBuZXR3b3JrKTtcbn1cblxuLyoqXG4gKiBDcmVhdGVzIGEgc2lnbmF0dXJlIGZvciBhIGdpdmVuIG1lc3NhZ2UuXG4gKlxuICogQHBhcmFtIHtTaWduYWJsZX0gbWVzc2FnZSAtIFRoZSBtZXNzYWdlIHRvIHNpZ24uXG4gKiBAcGFyYW0ge3N0cmluZ30gcHJ2IC0gVGhlIHByaXZhdGUga2V5IGluIEJJUDMyIGZvcm1hdC5cbiAqIEBwYXJhbSB7dXR4b2xpYi5OZXR3b3JrfSBuZXR3b3JrIC0gVGhlIG5ldHdvcmsgdG8gdXNlIGZvciBzaWduaW5nLlxuICogQHJldHVybnMge3N0cmluZ30gLSBSZXR1cm5zIHRoZSBzaWduYXR1cmUgaW4gaGV4YWRlY2ltYWwgZm9ybWF0LlxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlTWVzc2FnZVNpZ25hdHVyZShcbiAgbWVzc2FnZTogU2lnbmFibGUsXG4gIHhwcnY6IHN0cmluZyxcbiAgbmV0d29yazogdXR4b2xpYi5OZXR3b3JrID0gdXR4b2xpYi5uZXR3b3Jrcy5iaXRjb2luXG4pOiBzdHJpbmcge1xuICBjb25zdCByZXF1ZXN0U3RyaW5nID0gSlNPTi5zdHJpbmdpZnkoY2Fub25pY2FsaXplT2JqZWN0KG1lc3NhZ2UpKTtcbiAgY29uc3QgcHJ2S2V5ID0gdXR4b2xpYi5iaXAzMi5mcm9tQmFzZTU4KHhwcnYsIG5ldHdvcmspO1xuICByZXR1cm4gc2RrY29yZS5zaWduTWVzc2FnZShyZXF1ZXN0U3RyaW5nLCBwcnZLZXksIG5ldHdvcmspLnRvU3RyaW5nKCdoZXgnKTtcbn1cbiJdfQ==

package/dist/src/wallet/custodialLightning.d.ts

@@ -0,0 +1,7 @@
+import { ILightningWallet, LightningWallet } from './lightning';
+import * as sdkcore from '@bitgo-beta/sdk-core';
+export type ICustodialLightningWallet = ILightningWallet;
+export declare class CustodialLightningWallet extends LightningWallet implements ICustodialLightningWallet {
+    constructor(wallet: sdkcore.IWallet);
+}
+//# sourceMappingURL=custodialLightning.d.ts.map

package/dist/src/wallet/custodialLightning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custodialLightning.d.ts","sourceRoot":"","sources":["../../../src/wallet/custodialLightning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAEhD,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AAEzD,qBAAa,wBAAyB,SAAQ,eAAgB,YAAW,yBAAyB;gBACpF,MAAM,EAAE,OAAO,CAAC,OAAO;CAMpC"}

package/dist/src/wallet/custodialLightning.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustodialLightningWallet = void 0;
+const lightning_1 = require("./lightning");
+class CustodialLightningWallet extends lightning_1.LightningWallet {
+    constructor(wallet) {
+        super(wallet);
+        if (wallet.subType() !== 'lightningCustody') {
+            throw new Error(`Invalid lightning wallet type for custodial lightning: ${wallet.subType()}`);
+        }
+    }
+}
+exports.CustodialLightningWallet = CustodialLightningWallet;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3VzdG9kaWFsTGlnaHRuaW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3dhbGxldC9jdXN0b2RpYWxMaWdodG5pbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsMkNBQWdFO0FBS2hFLE1BQWEsd0JBQXlCLFNBQVEsMkJBQWU7SUFDM0QsWUFBWSxNQUF1QjtRQUNqQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDZCxJQUFJLE1BQU0sQ0FBQyxPQUFPLEVBQUUsS0FBSyxrQkFBa0IsRUFBRSxDQUFDO1lBQzVDLE1BQU0sSUFBSSxLQUFLLENBQUMsMERBQTBELE1BQU0sQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDaEcsQ0FBQztJQUNILENBQUM7Q0FDRjtBQVBELDREQU9DIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgSUxpZ2h0bmluZ1dhbGxldCwgTGlnaHRuaW5nV2FsbGV0IH0gZnJvbSAnLi9saWdodG5pbmcnO1xuaW1wb3J0ICogYXMgc2RrY29yZSBmcm9tICdAYml0Z28tYmV0YS9zZGstY29yZSc7XG5cbmV4cG9ydCB0eXBlIElDdXN0b2RpYWxMaWdodG5pbmdXYWxsZXQgPSBJTGlnaHRuaW5nV2FsbGV0O1xuXG5leHBvcnQgY2xhc3MgQ3VzdG9kaWFsTGlnaHRuaW5nV2FsbGV0IGV4dGVuZHMgTGlnaHRuaW5nV2FsbGV0IGltcGxlbWVudHMgSUN1c3RvZGlhbExpZ2h0bmluZ1dhbGxldCB7XG4gIGNvbnN0cnVjdG9yKHdhbGxldDogc2RrY29yZS5JV2FsbGV0KSB7XG4gICAgc3VwZXIod2FsbGV0KTtcbiAgICBpZiAod2FsbGV0LnN1YlR5cGUoKSAhPT0gJ2xpZ2h0bmluZ0N1c3RvZHknKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYEludmFsaWQgbGlnaHRuaW5nIHdhbGxldCB0eXBlIGZvciBjdXN0b2RpYWwgbGlnaHRuaW5nOiAke3dhbGxldC5zdWJUeXBlKCl9YCk7XG4gICAgfVxuICB9XG59XG4iXX0=

package/dist/src/wallet/index.d.ts

@@ -0,0 +1,5 @@
+export * from './lightning';
+export * from './custodialLightning';
+export * from './selfCustodialLightning';
+export * from './wallet';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wallet/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC"}

package/dist/src/wallet/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lightning"), exports);
+__exportStar(require("./custodialLightning"), exports);
+__exportStar(require("./selfCustodialLightning"), exports);
+__exportStar(require("./wallet"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvd2FsbGV0L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSw4Q0FBNEI7QUFDNUIsdURBQXFDO0FBQ3JDLDJEQUF5QztBQUN6QywyQ0FBeUIiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2xpZ2h0bmluZyc7XG5leHBvcnQgKiBmcm9tICcuL2N1c3RvZGlhbExpZ2h0bmluZyc7XG5leHBvcnQgKiBmcm9tICcuL3NlbGZDdXN0b2RpYWxMaWdodG5pbmcnO1xuZXhwb3J0ICogZnJvbSAnLi93YWxsZXQnO1xuIl19

package/dist/src/wallet/lightning.d.ts

@@ -0,0 +1,141 @@
+import * as sdkcore from '@bitgo-beta/sdk-core';
+import { PendingApprovalData, TxRequestState } from '@bitgo-beta/sdk-core';
+import { CreateInvoiceBody, Invoice, InvoiceQuery, LightningAuthKeychain, LightningKeychain, LndCreatePaymentResponse, SubmitPaymentParams, Transaction, TransactionQuery, ListTransactionsResponse, PaymentInfo, PaymentQuery, LightningOnchainWithdrawParams, LightningOnchainWithdrawResponse, ListInvoicesResponse, ListPaymentsResponse } from '../codecs';
+export type PayInvoiceResponse = {
+    /**
+     * Unique identifier for the payment request submitted to BitGo.
+     */
+    txRequestId: string;
+    /**
+     * Status of the payment request submission to BitGo.
+     * - `'delivered'`: Successfully received by BitGo, but may or may not have been sent to the Lightning Network yet.
+     * - For the actual payment status, refer to `paymentStatus` and track `transfer`.
+     */
+    txRequestState: TxRequestState;
+    /**
+     * Pending approval details, if applicable.
+     * - If present, the payment has not been initiated yet.
+     */
+    pendingApproval?: PendingApprovalData;
+    /**
+     * Current snapshot of payment status (if available).
+     * - **`'in_flight'`**: Payment is in progress.
+     * - **`'settled'`**: Payment was successfully completed.
+     * - **`'failed'`**: Payment failed.
+     * This field is absent if approval is required before processing.
+     */
+    paymentStatus?: LndCreatePaymentResponse;
+};
+/**
+ * Get the lightning keychain for the given wallet.
+ */
+export declare function getLightningKeychain(wallet: sdkcore.IWallet): Promise<LightningKeychain>;
+/**
+ * Get the lightning auth keychains for the given wallet.
+ */
+export declare function getLightningAuthKeychains(wallet: sdkcore.IWallet): Promise<{
+    userAuthKey: LightningAuthKeychain;
+    nodeAuthKey: LightningAuthKeychain;
+}>;
+export interface ILightningWallet {
+    /**
+     * Creates a lightning invoice
+     * @param {object} params Invoice parameters
+     * @param {bigint} params.valueMsat The value of the invoice in millisatoshis
+     * @param {string} [params.memo] A memo or description for the invoice
+     * @param {number} [params.expiry] The expiry time of the invoice in seconds
+     * @returns {Promise<Invoice>} A promise that resolves to the created invoice
+     */
+    createInvoice(params: CreateInvoiceBody): Promise<Invoice>;
+    /**
+     * Get invoice details by payment hash
+     * @param {string} paymentHash - Payment hash to lookup
+     * @returns {Promise<Invoice>} Invoice details
+     * @throws {InvalidPaymentHash} When payment hash is not valid
+     */
+    getInvoice(paymentHash: string): Promise<Invoice>;
+    /**
+     * Lists current lightning invoices
+     * @param {InvoiceQuery} params Query parameters for filtering invoices
+     * @param {string} [params.status] The status of the invoice (open, settled, canceled)
+     * @param {bigint} [params.limit] The maximum number of invoices to return
+     * @param {Date} [params.startDate] The start date for the query
+     * @param {Date} [params.endDate] The end date for the query
+     * @param {string} [params.prevId] Continue iterating (provided by nextBatchPrevId in the previous list)
+     * @returns {Promise<ListInvoicesResponse>} List of invoices and nextBatchPrevId
+     */
+    listInvoices(params: InvoiceQuery): Promise<ListInvoicesResponse>;
+    /**
+     * Pay a lightning invoice
+     * @param {SubmitPaymentParams} params - Payment parameters
+     * @param {string} params.invoice - The invoice to pay
+     * @param {string} params.amountMsat - The amount to pay in millisatoshis
+     * @param {string} params.passphrase - The wallet passphrase
+     * @param {string} [params.sequenceId] - Optional sequence ID for the respective payment transfer
+     * @param {string} [params.comment] - Optional comment for the respective payment transfer
+     * @returns {Promise<PayInvoiceResponse>} Payment result containing transaction request details and payment status
+     */
+    payInvoice(params: SubmitPaymentParams): Promise<PayInvoiceResponse>;
+    /**
+     * On chain withdrawal
+     * @param {LightningOnchainWithdrawParams} params - Withdraw parameters
+     * @param {LightningOnchainRecipient[]} params.recipients - The recipients to pay
+     * @param {bigint} [params.satsPerVbyte] - Optional value for sats per virtual byte. If not present, it will be estimated.
+     * @param {number} [params.numBlocks] - Target blocks for the transaction to be confirmed
+     * @param {string} params.passphrase - The wallet passphrase
+     * @param {string} [params.sequenceId] - Optional sequence ID for the respective withdraw transfer
+     * @param {string} [params.comment] - Optional comment for the respective withdraw transfer
+     * @returns {Promise<LightningOnchainWithdrawResponse>} Withdraw result containing transaction request details and status
+     */
+    withdrawOnchain(params: LightningOnchainWithdrawParams): Promise<LightningOnchainWithdrawResponse>;
+    /**
+     * Get payment details by payment id
+     * @param {string} paymentId - Payment id to lookup
+     * @returns {Promise<PaymentInfo>} Payment details
+     * @throws {InvalidPaymentId} When payment id is not valid
+     */
+    getPayment(paymentId: string): Promise<PaymentInfo>;
+    /**
+     * List payments for a wallet with optional filtering
+     * @param {PaymentQuery} params Query parameters for filtering payments
+     * @param {string} [params.status] The status of the payment
+     * @param {bigint} [params.limit] The maximum number of payments to return
+     * @param {Date} [params.startDate] The start date for the query
+     * @param {Date} [params.endDate] The end date for the query
+     * @param {string} [params.paymentHash] The payment hash of the payments
+     * @param {string} [params.prevId] Continue iterating (provided by nextBatchPrevId in the previous list)
+     * @returns {Promise<ListPaymentsResponse>} List of payments and nextBatchPrevId
+     */
+    listPayments(params: PaymentQuery): Promise<ListPaymentsResponse>;
+    /**
+     * Get transaction details by ID
+     * @param {string} txId - Transaction ID to lookup
+     * @returns {Promise<Transaction>} Transaction details
+     * @throws {InvalidTxId} When transaction ID is not valid
+     */
+    getTransaction(txId: string): Promise<Transaction>;
+    /**
+     * List transactions for a wallet with optional filtering and cursor-based pagination
+     * @param {TransactionQuery} params Query parameters for filtering transactions
+     * @param {bigint} [params.limit] The maximum number of transactions to return
+     * @param {Date} [params.startDate] The start date for the query
+     * @param {Date} [params.endDate] The end date for the query
+     * @param {string} [params.prevId] Transaction ID for cursor-based pagination (from nextBatchPrevId)
+     * @returns {Promise<ListTransactionsResponse>} List of transactions with pagination info
+     */
+    listTransactions(params: TransactionQuery): Promise<ListTransactionsResponse>;
+}
+export declare class LightningWallet implements ILightningWallet {
+    wallet: sdkcore.IWallet;
+    constructor(wallet: sdkcore.IWallet);
+    createInvoice(params: CreateInvoiceBody): Promise<Invoice>;
+    getInvoice(paymentHash: string): Promise<Invoice>;
+    listInvoices(params: InvoiceQuery): Promise<ListInvoicesResponse>;
+    payInvoice(params: SubmitPaymentParams): Promise<PayInvoiceResponse>;
+    withdrawOnchain(params: LightningOnchainWithdrawParams): Promise<LightningOnchainWithdrawResponse>;
+    getPayment(paymentId: string): Promise<PaymentInfo>;
+    listPayments(params: PaymentQuery): Promise<ListPaymentsResponse>;
+    getTransaction(txId: string): Promise<Transaction>;
+    listTransactions(params: TransactionQuery): Promise<ListTransactionsResponse>;
+}
+//# sourceMappingURL=lightning.d.ts.map

package/dist/src/wallet/lightning.d.ts.map

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