@atomiqlabs/lp-lib 14.0.0-dev.9 → 15.0.2

package/src/wallets/IBitcoinWallet.ts

@@ -1,69 +1,69 @@
-import {BtcTx} from "@atomiqlabs/base";
-import {Command} from "@atomiqlabs/server-base";
-import {Transaction} from "@scure/btc-signer";
-
-export type BitcoinUtxo = {
-    address: string,
-    type: "p2wpkh" | "p2sh-p2wpkh" | "p2tr",
-    confirmations: number,
-    outputScript: Buffer,
-    value: number,
-    txId: string,
-    vout: number
-};
-
-export type SignPsbtResponse = {
-    psbt: Transaction,
-    tx: Transaction,
-    raw: string,
-    txId: string,
-    networkFee: number
-};
-
-export interface IBitcoinWallet {
-
-    init(): Promise<void>;
-
-    isReady(): boolean;
-    getStatus(): string;
-    getStatusInfo(): Promise<Record<string, string>>;
-    getCommands(): Command<any>[];
-
-    toOutputScript(address: string): Buffer;
-
-    getAddressType(): "p2wpkh" | "p2sh-p2wpkh" | "p2tr";
-    /**
-     * Returns an unused address suitable for receiving
-     */
-    getAddress(): Promise<string>;
-    /**
-     * Adds previously returned address (with getAddress call), to the pool of unused addresses
-     * @param address
-     */
-    addUnusedAddress(address: string): Promise<void>;
-
-    getUtxos(): Promise<BitcoinUtxo[]>;
-    getBalance(): Promise<{confirmed: number, unconfirmed: number}>;
-    /**
-     * Returns required reserve amount that needs to be kept in the wallet (for e.g. lightning anchor channels)
-     */
-    getRequiredReserve(): Promise<number>;
-    getWalletTransactions(startHeight?: number): Promise<BtcTx[]>;
-    getWalletTransaction(txId: string): Promise<BtcTx | null>;
-    subscribeToWalletTransactions(callback: (tx: BtcTx) => void, abortSignal?: AbortSignal): void;
-
-    fundPsbt(psbt: Transaction, feeRate?: number): Promise<Transaction>;
-    signPsbt(psbt: Transaction): Promise<SignPsbtResponse>;
-    sendRawTransaction(tx: string): Promise<void>;
-    getSignedTransaction(destination: string, amount: number, feeRate?: number, nonce?: bigint, maxAllowedFeeRate?: number): Promise<SignPsbtResponse>;
-    getSignedMultiTransaction(destinations: {address: string, amount: number}[], feeRate?: number, nonce?: bigint, maxAllowedFeeRate?: number): Promise<SignPsbtResponse>;
-    estimateFee(destination: string, amount: number, feeRate?: number, feeRateMultiplier?: number): Promise<{satsPerVbyte: number, networkFee: number}>;
-    drainAll(destination: string | Buffer, inputs: Omit<BitcoinUtxo, "address">[], feeRate?: number): Promise<SignPsbtResponse>;
-    burnAll(inputs: Omit<BitcoinUtxo, "address">[]): Promise<SignPsbtResponse>;
-
-    parsePsbt(psbt: Transaction): Promise<BtcTx>;
-
-    getBlockheight(): Promise<number>;
-    getFeeRate(): Promise<number>;
-
+import {BtcTx} from "@atomiqlabs/base";
+import {Command} from "@atomiqlabs/server-base";
+import {Transaction} from "@scure/btc-signer";
+
+export type BitcoinUtxo = {
+    address: string,
+    type: "p2wpkh" | "p2sh-p2wpkh" | "p2tr",
+    confirmations: number,
+    outputScript: Buffer,
+    value: number,
+    txId: string,
+    vout: number
+};
+
+export type SignPsbtResponse = {
+    psbt: Transaction,
+    tx: Transaction,
+    raw: string,
+    txId: string,
+    networkFee: number
+};
+
+export interface IBitcoinWallet {
+
+    init(): Promise<void>;
+
+    isReady(): boolean;
+    getStatus(): string;
+    getStatusInfo(): Promise<Record<string, string>>;
+    getCommands(): Command<any>[];
+
+    toOutputScript(address: string): Buffer;
+
+    getAddressType(): "p2wpkh" | "p2sh-p2wpkh" | "p2tr";
+    /**
+     * Returns an unused address suitable for receiving
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Adds previously returned address (with getAddress call), to the pool of unused addresses
+     * @param address
+     */
+    addUnusedAddress(address: string): Promise<void>;
+
+    getUtxos(): Promise<BitcoinUtxo[]>;
+    getBalance(): Promise<{confirmed: number, unconfirmed: number}>;
+    /**
+     * Returns required reserve amount that needs to be kept in the wallet (for e.g. lightning anchor channels)
+     */
+    getRequiredReserve(): Promise<number>;
+    getWalletTransactions(startHeight?: number): Promise<BtcTx[]>;
+    getWalletTransaction(txId: string): Promise<BtcTx | null>;
+    subscribeToWalletTransactions(callback: (tx: BtcTx) => void, abortSignal?: AbortSignal): void;
+
+    fundPsbt(psbt: Transaction, feeRate?: number): Promise<Transaction>;
+    signPsbt(psbt: Transaction): Promise<SignPsbtResponse>;
+    sendRawTransaction(tx: string): Promise<void>;
+    getSignedTransaction(destination: string, amount: number, feeRate?: number, nonce?: bigint, maxAllowedFeeRate?: number): Promise<SignPsbtResponse>;
+    getSignedMultiTransaction(destinations: {address: string, amount: number}[], feeRate?: number, nonce?: bigint, maxAllowedFeeRate?: number): Promise<SignPsbtResponse>;
+    estimateFee(destination: string, amount: number, feeRate?: number, feeRateMultiplier?: number): Promise<{satsPerVbyte: number, networkFee: number}>;
+    drainAll(destination: string | Buffer, inputs: Omit<BitcoinUtxo, "address">[], feeRate?: number): Promise<SignPsbtResponse>;
+    burnAll(inputs: Omit<BitcoinUtxo, "address">[]): Promise<SignPsbtResponse>;
+
+    parsePsbt(psbt: Transaction): Promise<BtcTx>;
+
+    getBlockheight(): Promise<number>;
+    getFeeRate(): Promise<number>;
+
 }

package/src/wallets/ILightningWallet.ts

@@ -1,178 +1,178 @@
-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,
-
-    localBalance: bigint,
-    localReserve: bigint,
-    remoteBalance: bigint,
-    remoteReserve: bigint,
-    unsettledBalance: bigint,
-    transactionId: string,
-    transactionVout: number
-};
-
-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[]>;
-    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,
+
+    localBalance: bigint,
+    localReserve: bigint,
+    remoteBalance: bigint,
+    remoteReserve: bigint,
+    unsettledBalance: bigint,
+    transactionId: string,
+    transactionVout: number
+};
+
+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[]>;
+    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>;
+
 }

package/dist/swaps/escrow/frombtcln_autoinit/FromBtcLnAuto.d.ts

@@ -1,104 +0,0 @@
-import { Express } from "express";
-import { FromBtcLnAutoSwap, FromBtcLnAutoSwapState } from "./FromBtcLnAutoSwap";
-import { MultichainData, SwapHandlerType } from "../../SwapHandler";
-import { ISwapPrice } from "../../../prices/ISwapPrice";
-import { ChainSwapType, ClaimEvent, InitializeEvent, RefundEvent, SwapData } from "@atomiqlabs/base";
-import { IIntermediaryStorage } from "../../../storage/IIntermediaryStorage";
-import { FromBtcBaseConfig, FromBtcBaseSwapHandler } from "../FromBtcBaseSwapHandler";
-import { ILightningWallet } from "../../../wallets/ILightningWallet";
-import { LightningAssertions } from "../../assertions/LightningAssertions";
-export type FromBtcLnAutoConfig = FromBtcBaseConfig & {
-    invoiceTimeoutSeconds?: number;
-    minCltv: bigint;
-    gracePeriod: bigint;
-    gasTokenMax: {
-        [chainId: string]: bigint;
-    };
-};
-export type FromBtcLnAutoRequestType = {
-    address: string;
-    paymentHash: string;
-    amount: bigint;
-    token: string;
-    gasToken: string;
-    gasAmount: bigint;
-    claimerBounty: bigint;
-    descriptionHash?: string;
-    exactOut?: boolean;
-};
-/**
- * Swap handler handling from BTCLN swaps using submarine swaps
- */
-export declare class FromBtcLnAuto extends FromBtcBaseSwapHandler<FromBtcLnAutoSwap, FromBtcLnAutoSwapState> {
-    readonly type = SwapHandlerType.FROM_BTCLN_AUTO;
-    readonly swapType = ChainSwapType.HTLC;
-    readonly config: FromBtcLnAutoConfig;
-    readonly lightning: ILightningWallet;
-    readonly LightningAssertions: LightningAssertions;
-    constructor(storageDirectory: IIntermediaryStorage<FromBtcLnAutoSwap>, path: string, chains: MultichainData, lightning: ILightningWallet, swapPricing: ISwapPrice, config: FromBtcLnAutoConfig);
-    protected processPastSwap(swap: FromBtcLnAutoSwap): Promise<"REFUND" | "SETTLE" | null>;
-    protected refundSwaps(refundSwaps: FromBtcLnAutoSwap[]): Promise<void>;
-    protected settleInvoices(swaps: FromBtcLnAutoSwap[]): Promise<void>;
-    /**
-     * Checks past swaps, refunds and deletes ones that are already expired.
-     */
-    protected processPastSwaps(): Promise<void>;
-    protected processInitializeEvent(chainIdentifier: string, savedSwap: FromBtcLnAutoSwap, event: InitializeEvent<SwapData>): Promise<void>;
-    protected processClaimEvent(chainIdentifier: string, savedSwap: FromBtcLnAutoSwap, event: ClaimEvent<SwapData>): Promise<void>;
-    protected processRefundEvent(chainIdentifier: string, savedSwap: FromBtcLnAutoSwap, event: RefundEvent<SwapData>): Promise<void>;
-    /**
-     * Called when lightning HTLC is received, also signs an init transaction on the smart chain side, expiry of the
-     *  smart chain authorization starts ticking as soon as this HTLC is received
-     *
-     * @param invoiceData
-     * @param invoice
-     */
-    private htlcReceived;
-    private offerHtlc;
-    /**
-     * Checks invoice description hash
-     *
-     * @param descriptionHash
-     * @throws {DefinedRuntimeError} will throw an error if the description hash is invalid
-     */
-    private checkDescriptionHash;
-    /**
-     * Asynchronously sends the LN node's public key to the client, so he can pre-fetch the node's channels from 1ml api
-     *
-     * @param responseStream
-     */
-    private sendPublicKeyAsync;
-    /**
-     * Returns the CLTV timeout (blockheight) of the received HTLC corresponding to the invoice. If multiple HTLCs are
-     *  received (MPP) it returns the lowest of the timeouts
-     *
-     * @param invoice
-     */
-    private getInvoicePaymentsTimeout;
-    /**
-     * Checks if the received HTLC's CLTV timeout is large enough to still process the swap
-     *
-     * @param invoice
-     * @throws {DefinedRuntimeError} Will throw if HTLC expires too soon and therefore cannot be processed
-     * @returns expiry timeout in seconds
-     */
-    private checkHtlcExpiry;
-    /**
-     * Cancels the swap (CANCELED state) & also cancels the LN invoice (including all pending HTLCs)
-     *
-     * @param invoiceData
-     */
-    private cancelSwapAndInvoice;
-    /**
-     *
-     * Checks if the lightning invoice is in HELD state (htlcs received but yet unclaimed)
-     *
-     * @param paymentHash
-     * @throws {DefinedRuntimeError} Will throw if the lightning invoice is not found, or if it isn't in the HELD state
-     * @returns the fetched lightning invoice
-     */
-    private checkInvoiceStatus;
-    startRestServer(restServer: Express): void;
-    init(): Promise<void>;
-    getInfoData(): any;
-}