@atomiqlabs/lp-lib 16.2.0 → 16.2.1

package/src/wallets/ILightningWallet.ts

@@ -1,200 +1,200 @@
-import {Command} from "@atomiqlabs/server-base";
-
-export type IncomingLightningNetworkPayment = {
-    createdAt: number,
-    confirmedAt: number,
-
-    createdHeight: number,
-    timeout: number,
-
-    status: "held" | "canceled" | "confirmed"
-
-    mtokens: bigint
-}
-
-export type LightningNetworkInvoice = {
-    id: string,
-    request: string,
-    secret?: string,
-
-    cltvDelta: number,
-    mtokens: bigint,
-
-    createdAt: number,
-    expiresAt: number,
-
-    description: string,
-    descriptionHash?: string,
-
-    payments: IncomingLightningNetworkPayment[],
-
-    status: "unpaid" | "held" | "canceled" | "confirmed"
-};
-
-export type OutgoingLightningNetworkPayment = {
-    failedReason?: "insufficient_balance" | "invalid_payment" | "pathfinding_timeout" | "route_not_found",
-    status: "confirmed" | "failed" | "pending",
-    secret?: string,
-    feeMtokens?: bigint
-};
-
-export type LightningNetworkChannel = {
-    id: string,
-    capacity: bigint,
-    isActive: boolean,
-    peerPublicKey: string,
-
-    localBalance: bigint,
-    localReserve: bigint,
-    remoteBalance: bigint,
-    remoteReserve: bigint,
-    unsettledBalance: bigint,
-    transactionId: string,
-    transactionVout: number
-};
-
-export type OpenChannelRequest = {
-    amountSats: bigint,
-    peerPublicKey: string,
-    peerAddress?: string,
-    feeRate?: number,
-    channelFees?: {
-        feeRatePPM?: bigint,
-        baseFeeMsat?: bigint
-    }
-}
-
-export type CloseChannelRequest = {
-    channelId: string,
-    feeRate?: number,
-    forceClose?: boolean
-}
-
-export type InvoiceInit = {
-    mtokens: bigint,
-    descriptionHash?: string
-    description?: string,
-    cltvDelta?: number,
-    expiresAt?: number,
-};
-
-export type HodlInvoiceInit = {
-    description: string,
-    cltvDelta: number,
-    expiresAt: number,
-    id: string,
-    mtokens: bigint,
-    descriptionHash?: string
-};
-
-export type LNRoutes = {
-    publicKey: string,
-    feeRate?: number,
-    cltvDelta?: number,
-    channel?: string,
-    baseFeeMtokens?: bigint
-}[][];
-
-export type ParsedPaymentRequest = {
-    id: string,
-    mtokens: bigint,
-    expiryEpochMillis: number,
-    destination: string,
-    cltvDelta: number,
-    description: string,
-    routes: LNRoutes
-};
-
-export type LightningPaymentInit = {
-    request: string,
-    maxFeeMtokens?: bigint,
-    maxTimeoutHeight?: number
-};
-
-export type LightningBalanceResponse = {
-    localBalance: bigint,
-    remoteBalance: bigint,
-    unsettledBalance: bigint
-};
-
-export type ProbeAndRouteInit = {
-    request: string,
-    amountMtokens: bigint,
-    maxFeeMtokens: bigint,
-    maxTimeoutHeight: number
-}
-
-export type ProbeAndRouteResponse = {
-    confidence: number,
-    feeMtokens: bigint,
-    destination: string,
-    privateRoutes: LNRoutes
-}
-
-export function routesMatch(routesA: LNRoutes, routesB: LNRoutes) {
-    if(routesA===routesB) return true;
-    if(routesA==null || routesB==null) {
-        return false;
-    }
-    if(routesA.length!==routesB.length) return false;
-    for(let i=0;i<routesA.length;i++) {
-        if(routesA[i]===routesB[i]) continue;
-        if(routesA[i]==null || routesB[i]==null) {
-            return false;
-        }
-        if(routesA[i].length!==routesB[i].length) return false;
-        for(let e=0;e<routesA[i].length;e++) {
-            if(routesA[i][e]===routesB[i][e]) continue;
-            if(routesA[i][e]==null || routesB[i][e]==null) {
-                return false;
-            }
-            if(
-                routesA[i][e].publicKey!==routesB[i][e].publicKey ||
-                routesA[i][e].baseFeeMtokens!==routesB[i][e].baseFeeMtokens ||
-                routesA[i][e].channel!==routesB[i][e].channel ||
-                routesA[i][e].cltvDelta!==routesB[i][e].cltvDelta ||
-                routesA[i][e].feeRate!==routesB[i][e].feeRate
-            ) {
-                return false;
-            }
-        }
-    }
-
-    return true;
-}
-
-export interface ILightningWallet {
-
-    init(): Promise<void>;
-
-    isReady(): boolean;
-    getStatus(): string;
-    getStatusInfo(): Promise<Record<string, string>>;
-    getCommands(): Command<any>[];
-
-    createInvoice(init: InvoiceInit): Promise<LightningNetworkInvoice>;
-    createHodlInvoice(init: HodlInvoiceInit): Promise<LightningNetworkInvoice>;
-    getInvoice(paymentHash: string): Promise<LightningNetworkInvoice | null>;
-    cancelHodlInvoice(paymentHash: string): Promise<void>;
-    settleHodlInvoice(secret: string): Promise<void>;
-    waitForInvoice(paymentHash: string, abortSignal?: AbortSignal): Promise<LightningNetworkInvoice>;
-
-    pay(init: LightningPaymentInit): Promise<void>;
-    getPayment(paymentHash: string): Promise<OutgoingLightningNetworkPayment | null>
-    waitForPayment(paymentHash: string, abortSignal?: AbortSignal): Promise<OutgoingLightningNetworkPayment>;
-    probe(init: ProbeAndRouteInit): Promise<ProbeAndRouteResponse | null>;
-    route(init: ProbeAndRouteInit): Promise<ProbeAndRouteResponse | null>;
-
-    parsePaymentRequest(request: string): Promise<ParsedPaymentRequest>;
-
-    getBlockheight(): Promise<number>;
-    getChannels(activeOnly?: boolean): Promise<LightningNetworkChannel[]>;
-    getPendingChannels(): Promise<LightningNetworkChannel[]>;
-    openChannel(req: OpenChannelRequest): Promise<LightningNetworkChannel>;
-    closeChannel(req: CloseChannelRequest): Promise<string>;
-
-    getLightningBalance(): Promise<LightningBalanceResponse>;
-
-    getIdentityPublicKey(): Promise<string>;
-
-}
+import {Command} from "@atomiqlabs/server-base";
+
+export type IncomingLightningNetworkPayment = {
+    createdAt: number,
+    confirmedAt: number,
+
+    createdHeight: number,
+    timeout: number,
+
+    status: "held" | "canceled" | "confirmed"
+
+    mtokens: bigint
+}
+
+export type LightningNetworkInvoice = {
+    id: string,
+    request: string,
+    secret?: string,
+
+    cltvDelta: number,
+    mtokens: bigint,
+
+    createdAt: number,
+    expiresAt: number,
+
+    description: string,
+    descriptionHash?: string,
+
+    payments: IncomingLightningNetworkPayment[],
+
+    status: "unpaid" | "held" | "canceled" | "confirmed"
+};
+
+export type OutgoingLightningNetworkPayment = {
+    failedReason?: "insufficient_balance" | "invalid_payment" | "pathfinding_timeout" | "route_not_found",
+    status: "confirmed" | "failed" | "pending",
+    secret?: string,
+    feeMtokens?: bigint
+};
+
+export type LightningNetworkChannel = {
+    id: string,
+    capacity: bigint,
+    isActive: boolean,
+    peerPublicKey: string,
+
+    localBalance: bigint,
+    localReserve: bigint,
+    remoteBalance: bigint,
+    remoteReserve: bigint,
+    unsettledBalance: bigint,
+    transactionId: string,
+    transactionVout: number
+};
+
+export type OpenChannelRequest = {
+    amountSats: bigint,
+    peerPublicKey: string,
+    peerAddress?: string,
+    feeRate?: number,
+    channelFees?: {
+        feeRatePPM?: bigint,
+        baseFeeMsat?: bigint
+    }
+}
+
+export type CloseChannelRequest = {
+    channelId: string,
+    feeRate?: number,
+    forceClose?: boolean
+}
+
+export type InvoiceInit = {
+    mtokens: bigint,
+    descriptionHash?: string
+    description?: string,
+    cltvDelta?: number,
+    expiresAt?: number,
+};
+
+export type HodlInvoiceInit = {
+    description: string,
+    cltvDelta: number,
+    expiresAt: number,
+    id: string,
+    mtokens: bigint,
+    descriptionHash?: string
+};
+
+export type LNRoutes = {
+    publicKey: string,
+    feeRate?: number,
+    cltvDelta?: number,
+    channel?: string,
+    baseFeeMtokens?: bigint
+}[][];
+
+export type ParsedPaymentRequest = {
+    id: string,
+    mtokens: bigint,
+    expiryEpochMillis: number,
+    destination: string,
+    cltvDelta: number,
+    description: string,
+    routes: LNRoutes
+};
+
+export type LightningPaymentInit = {
+    request: string,
+    maxFeeMtokens?: bigint,
+    maxTimeoutHeight?: number
+};
+
+export type LightningBalanceResponse = {
+    localBalance: bigint,
+    remoteBalance: bigint,
+    unsettledBalance: bigint
+};
+
+export type ProbeAndRouteInit = {
+    request: string,
+    amountMtokens: bigint,
+    maxFeeMtokens: bigint,
+    maxTimeoutHeight: number
+}
+
+export type ProbeAndRouteResponse = {
+    confidence: number,
+    feeMtokens: bigint,
+    destination: string,
+    privateRoutes: LNRoutes
+}
+
+export function routesMatch(routesA: LNRoutes, routesB: LNRoutes) {
+    if(routesA===routesB) return true;
+    if(routesA==null || routesB==null) {
+        return false;
+    }
+    if(routesA.length!==routesB.length) return false;
+    for(let i=0;i<routesA.length;i++) {
+        if(routesA[i]===routesB[i]) continue;
+        if(routesA[i]==null || routesB[i]==null) {
+            return false;
+        }
+        if(routesA[i].length!==routesB[i].length) return false;
+        for(let e=0;e<routesA[i].length;e++) {
+            if(routesA[i][e]===routesB[i][e]) continue;
+            if(routesA[i][e]==null || routesB[i][e]==null) {
+                return false;
+            }
+            if(
+                routesA[i][e].publicKey!==routesB[i][e].publicKey ||
+                routesA[i][e].baseFeeMtokens!==routesB[i][e].baseFeeMtokens ||
+                routesA[i][e].channel!==routesB[i][e].channel ||
+                routesA[i][e].cltvDelta!==routesB[i][e].cltvDelta ||
+                routesA[i][e].feeRate!==routesB[i][e].feeRate
+            ) {
+                return false;
+            }
+        }
+    }
+
+    return true;
+}
+
+export interface ILightningWallet {
+
+    init(): Promise<void>;
+
+    isReady(): boolean;
+    getStatus(): string;
+    getStatusInfo(): Promise<Record<string, string>>;
+    getCommands(): Command<any>[];
+
+    createInvoice(init: InvoiceInit): Promise<LightningNetworkInvoice>;
+    createHodlInvoice(init: HodlInvoiceInit): Promise<LightningNetworkInvoice>;
+    getInvoice(paymentHash: string): Promise<LightningNetworkInvoice | null>;
+    cancelHodlInvoice(paymentHash: string): Promise<void>;
+    settleHodlInvoice(secret: string): Promise<void>;
+    waitForInvoice(paymentHash: string, abortSignal?: AbortSignal): Promise<LightningNetworkInvoice>;
+
+    pay(init: LightningPaymentInit): Promise<void>;
+    getPayment(paymentHash: string): Promise<OutgoingLightningNetworkPayment | null>
+    waitForPayment(paymentHash: string, abortSignal?: AbortSignal): Promise<OutgoingLightningNetworkPayment>;
+    probe(init: ProbeAndRouteInit): Promise<ProbeAndRouteResponse | null>;
+    route(init: ProbeAndRouteInit): Promise<ProbeAndRouteResponse | null>;
+
+    parsePaymentRequest(request: string): Promise<ParsedPaymentRequest>;
+
+    getBlockheight(): Promise<number>;
+    getChannels(activeOnly?: boolean): Promise<LightningNetworkChannel[]>;
+    getPendingChannels(): Promise<LightningNetworkChannel[]>;
+    openChannel(req: OpenChannelRequest): Promise<LightningNetworkChannel>;
+    closeChannel(req: CloseChannelRequest): Promise<string>;
+
+    getLightningBalance(): Promise<LightningBalanceResponse>;
+
+    getIdentityPublicKey(): Promise<string>;
+
+}

package/src/wallets/ISpvVaultSigner.ts

@@ -1,11 +1,11 @@
-import {Transaction} from "@scure/btc-signer";
-
-export interface ISpvVaultSigner {
-
-    init(): Promise<void>;
-
-    getAddressType(): "p2wpkh" | "p2tr";
-    getAddress(chainId: string, vaultId: bigint): Promise<string>;
-    signPsbt(chainId: string, vaultId: bigint, psbt: Transaction, inputs: number[]): Promise<Transaction>;
-
+import {Transaction} from "@scure/btc-signer";
+
+export interface ISpvVaultSigner {
+
+    init(): Promise<void>;
+
+    getAddressType(): "p2wpkh" | "p2tr";
+    getAddress(chainId: string, vaultId: bigint): Promise<string>;
+    signPsbt(chainId: string, vaultId: bigint, psbt: Transaction, inputs: number[]): Promise<Transaction>;
+
 }