@lightsparkdev/lightspark-sdk 1.5.14 → 1.7.0

package/dist/{index-2b493387.d.ts → index-2f0cac65.d.ts}

@@ -44,7 +44,7 @@ declare enum CurrencyUnit {
      */
     SATOSHI = "SATOSHI",
     /**
-     * 0.001 Satoshi, or 10e-11 Bitcoin. We recommend using the Satoshi unit instead when possible. *
+     * 0.001 Satoshi, or 10e-11 Bitcoin. We recommend using the Satoshi unit instead when possible.
      */
     MILLISATOSHI = "MILLISATOSHI",
     /** United States Dollar. **/
@@ -736,7 +736,7 @@ interface LightsparkNode {
     /** The balances that describe the funds in this node. **/
     balances?: Balances | undefined;
     getAddresses(client: LightsparkClient, first?: number | undefined, types?: NodeAddressType[] | undefined): Promise<NodeToAddressesConnection>;
-    getChannels(client: LightsparkClient, first?: number | undefined, statuses?: ChannelStatus[] | undefined, after?: string | undefined): Promise<LightsparkNodeToChannelsConnection>;
+    getChannels(client: LightsparkClient, first?: number | undefined, after?: string | undefined, beforeDate?: string | undefined, afterDate?: string | undefined, statuses?: ChannelStatus[] | undefined): Promise<LightsparkNodeToChannelsConnection>;
     getDailyLiquidityForecasts(client: LightsparkClient, fromDate: string, toDate: string, direction: LightningPaymentDirection): Promise<LightsparkNodeToDailyLiquidityForecastsConnection>;
 }
 declare const getLightsparkNodeQuery: (id: string) => Query<LightsparkNode>;
@@ -829,14 +829,14 @@ declare enum TransactionStatus {
      * Clients should support unknown values as more of them could be added without notice.
      */
     FUTURE_VALUE = "FUTURE_VALUE",
-    /** Transaction succeeded.. **/
+    /** Transaction succeeded. **/
     SUCCESS = "SUCCESS",
     /** Transaction failed. **/
     FAILED = "FAILED",
     /** Transaction has been initiated and is currently in-flight. **/
     PENDING = "PENDING",
     /**
-     * For transaction type PAYMENT_REQUEST only. No payments have been made to a payment request. *
+     * For transaction type PAYMENT_REQUEST only. No payments have been made to a payment request.
      */
     NOT_STARTED = "NOT_STARTED",
     /** For transaction type PAYMENT_REQUEST only. A payment request has expired. **/
@@ -951,8 +951,8 @@ declare enum WalletStatus {
     TERMINATING = "TERMINATING",
     /**
      * The wallet has been terminated and is not available in the Lightspark infrastructure anymore.
-     * It is not connected to the Lightning network and its funds can only be accessed using the
-     * Funds Recovery flow. *
+     * It is not connected to the Lightning network and its funds can only be accessed using the Funds
+     * Recovery flow. *
      */
     TERMINATED = "TERMINATED"
 }
@@ -985,6 +985,16 @@ interface WalletToTransactionsConnection {
     typename: string;
 }
 
+declare enum RequestInitiator {
+    /**
+     * This is an enum value that represents values that could be added in the future.
+     * Clients should support unknown values as more of them could be added without notice.
+     */
+    FUTURE_VALUE = "FUTURE_VALUE",
+    CUSTOMER = "CUSTOMER",
+    LIGHTSPARK = "LIGHTSPARK"
+}
+
 /** This is an enum of the potential modes that your Bitcoin withdrawal can take. **/
 declare enum WithdrawalMode {
     /**
@@ -1003,6 +1013,7 @@ declare enum WithdrawalRequestStatus {
      * Clients should support unknown values as more of them could be added without notice.
      */
     FUTURE_VALUE = "FUTURE_VALUE",
+    CREATING = "CREATING",
     CREATED = "CREATED",
     FAILED = "FAILED",
     IN_PROGRESS = "IN_PROGRESS",
@@ -1041,10 +1052,7 @@ interface ChannelClosingTransaction {
     resolvedAt?: string | undefined;
     /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
     transactionHash?: string | undefined;
-    /**
-     * The fees that were paid by the wallet sending the transaction to commit it to the Bitcoin
-     * blockchain.
-     **/
+    /** The fees that were paid by the node for this transaction. **/
     fees?: CurrencyAmount | undefined;
     /**
      * The hash of the block that included this transaction. This will be null for unconfirmed
@@ -1059,15 +1067,17 @@ interface ChannelClosingTransaction {
 declare const getChannelClosingTransactionQuery: (id: string) => Query<ChannelClosingTransaction>;
 
 interface WithdrawalRequestToChannelClosingTransactionsConnection {
-    /** An object that holds pagination information about the objects in this connection. **/
-    pageInfo: PageInfo;
     /**
      * The total count of objects in this connection, using the current filters. It is different
      * from the number of objects returned in the current page (in the `entities` field).
      **/
     count: number;
+    /** An object that holds pagination information about the objects in this connection. **/
+    pageInfo: PageInfo;
     /** The channel closing transactions for the current page of this connection. **/
     entities: ChannelClosingTransaction[];
+    /** The typename of the object **/
+    typename: string;
 }
 
 /**
@@ -1101,10 +1111,7 @@ interface ChannelOpeningTransaction {
     resolvedAt?: string | undefined;
     /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
     transactionHash?: string | undefined;
-    /**
-     * The fees that were paid by the wallet sending the transaction to commit it to the Bitcoin
-     * blockchain.
-     **/
+    /** The fees that were paid by the node for this transaction. **/
     fees?: CurrencyAmount | undefined;
     /**
      * The hash of the block that included this transaction. This will be null for unconfirmed
@@ -1119,15 +1126,73 @@ interface ChannelOpeningTransaction {
 declare const getChannelOpeningTransactionQuery: (id: string) => Query<ChannelOpeningTransaction>;
 
 interface WithdrawalRequestToChannelOpeningTransactionsConnection {
-    /** An object that holds pagination information about the objects in this connection. **/
-    pageInfo: PageInfo;
     /**
      * The total count of objects in this connection, using the current filters. It is different
      * from the number of objects returned in the current page (in the `entities` field).
      **/
     count: number;
+    /** An object that holds pagination information about the objects in this connection. **/
+    pageInfo: PageInfo;
     /** The channel opening transactions for the current page of this connection. **/
     entities: ChannelOpeningTransaction[];
+    /** The typename of the object **/
+    typename: string;
+}
+
+/**
+ * This object represents an L1 withdrawal from your Lightspark Node to any Bitcoin wallet. You can
+ * retrieve this object to receive detailed information about any L1 withdrawal associated with
+ * your Lightspark Node or account. *
+ */
+interface Withdrawal {
+    /**
+     * The unique identifier of this entity across all Lightspark systems. Should be treated as an
+     * opaque string.
+     **/
+    id: string;
+    /** The date and time when this transaction was initiated. **/
+    createdAt: string;
+    /** The date and time when the entity was last updated. **/
+    updatedAt: string;
+    /** The current status of this transaction. **/
+    status: TransactionStatus;
+    /** The amount of money involved in this transaction. **/
+    amount: CurrencyAmount;
+    /**
+     * The height of the block that included this transaction. This will be zero for unconfirmed
+     * transactions.
+     **/
+    blockHeight: number;
+    /** The Bitcoin blockchain addresses this transaction was sent to. **/
+    destinationAddresses: string[];
+    /** The Lightspark node this withdrawal originated from. **/
+    originId: string;
+    /** The typename of the object **/
+    typename: string;
+    /** The date and time when this transaction was completed or failed. **/
+    resolvedAt?: string | undefined;
+    /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
+    transactionHash?: string | undefined;
+    /** The fees that were paid by the node for this transaction. **/
+    fees?: CurrencyAmount | undefined;
+    /**
+     * The hash of the block that included this transaction. This will be null for unconfirmed
+     * transactions.
+     **/
+    blockHash?: string | undefined;
+    /** The number of blockchain confirmations for this transaction in real time. **/
+    numConfirmations?: number | undefined;
+}
+declare const getWithdrawalQuery: (id: string) => Query<Withdrawal>;
+
+interface WithdrawalRequestToWithdrawalsConnection {
+    /**
+     * The total count of objects in this connection, using the current filters. It is different
+     * from the number of objects returned in the current page (in the `entities` field).
+     **/
+    count: number;
+    /** The withdrawals for the current page of this connection. **/
+    entities: Withdrawal[];
 }
 
 /**
@@ -1158,10 +1223,16 @@ declare class WithdrawalRequest implements Entity {
     readonly amount: CurrencyAmount;
     /** The bitcoin address where the funds should be sent. **/
     readonly bitcoinAddress: string;
-    /** The strategy that should be used to withdraw the funds from the account. **/
+    /**
+     * The strategy that should be used to withdraw the funds from the account.
+     *
+     * @deprecated It is always withdrawing from channels now.
+     **/
     readonly withdrawalMode: WithdrawalMode;
     /** The current status of this withdrawal request. **/
     readonly status: WithdrawalRequestStatus;
+    /** The initiator of the withdrawal. **/
+    readonly initiator: RequestInitiator;
     /** The typename of the object **/
     readonly typename: string;
     /**
@@ -1169,12 +1240,26 @@ declare class WithdrawalRequest implements Entity {
      * amount for the withdrawal.
      **/
     readonly estimatedAmount?: CurrencyAmount | undefined;
-    /** The actual amount that is withdrawn. It will be set once the request is completed. **/
+    /**
+     * The actual amount that is withdrawn to the bitcoin address. It will be set once the request
+     * is completed.
+     **/
     readonly amountWithdrawn?: CurrencyAmount | undefined;
+    /**
+     * The total fees the node paid for the withdrawal. It will be set once the request is
+     * completed. *
+     */
+    readonly totalFees?: CurrencyAmount | undefined;
     /** The time at which this request was completed. **/
     readonly completedAt?: string | undefined;
-    /** The withdrawal transaction that has been generated by this request. **/
+    /**
+     * The withdrawal transaction that has been generated by this request.
+     *
+     * @deprecated Use `withdrawals` instead.
+     **/
     readonly withdrawalId?: string | undefined;
+    /** The idempotency key of the withdrawal request. **/
+    readonly idempotencyKey?: string | undefined;
     constructor(
     /**
      * The unique identifier of this entity across all Lightspark systems. Should be treated as an
@@ -1198,10 +1283,16 @@ declare class WithdrawalRequest implements Entity {
     amount: CurrencyAmount, 
     /** The bitcoin address where the funds should be sent. **/
     bitcoinAddress: string, 
-    /** The strategy that should be used to withdraw the funds from the account. **/
+    /**
+     * The strategy that should be used to withdraw the funds from the account.
+     *
+     * @deprecated It is always withdrawing from channels now.
+     **/
     withdrawalMode: WithdrawalMode, 
     /** The current status of this withdrawal request. **/
     status: WithdrawalRequestStatus, 
+    /** The initiator of the withdrawal. **/
+    initiator: RequestInitiator, 
     /** The typename of the object **/
     typename: string, 
     /**
@@ -1209,14 +1300,29 @@ declare class WithdrawalRequest implements Entity {
      * amount for the withdrawal.
      **/
     estimatedAmount?: CurrencyAmount | undefined, 
-    /** The actual amount that is withdrawn. It will be set once the request is completed. **/
+    /**
+     * The actual amount that is withdrawn to the bitcoin address. It will be set once the request
+     * is completed.
+     **/
     amountWithdrawn?: CurrencyAmount | undefined, 
+    /**
+     * The total fees the node paid for the withdrawal. It will be set once the request is
+     * completed. *
+     */
+    totalFees?: CurrencyAmount | undefined, 
     /** The time at which this request was completed. **/
     completedAt?: string | undefined, 
-    /** The withdrawal transaction that has been generated by this request. **/
-    withdrawalId?: string | undefined);
-    getChannelClosingTransactions(client: LightsparkClient, first?: number | undefined): Promise<WithdrawalRequestToChannelClosingTransactionsConnection>;
-    getChannelOpeningTransactions(client: LightsparkClient, first?: number | undefined): Promise<WithdrawalRequestToChannelOpeningTransactionsConnection>;
+    /**
+     * The withdrawal transaction that has been generated by this request.
+     *
+     * @deprecated Use `withdrawals` instead.
+     **/
+    withdrawalId?: string | undefined, 
+    /** The idempotency key of the withdrawal request. **/
+    idempotencyKey?: string | undefined);
+    getChannelClosingTransactions(client: LightsparkClient, first?: number | undefined, after?: string | undefined): Promise<WithdrawalRequestToChannelClosingTransactionsConnection>;
+    getChannelOpeningTransactions(client: LightsparkClient, first?: number | undefined, after?: string | undefined): Promise<WithdrawalRequestToChannelOpeningTransactionsConnection>;
+    getWithdrawals(client: LightsparkClient, first?: number | undefined): Promise<WithdrawalRequestToWithdrawalsConnection>;
     static getWithdrawalRequestQuery(id: string): Query<WithdrawalRequest>;
     toJson(): {
         __typename: string;
@@ -1227,6 +1333,7 @@ declare class WithdrawalRequest implements Entity {
         withdrawal_request_amount: any;
         withdrawal_request_estimated_amount: any;
         withdrawal_request_amount_withdrawn: any;
+        withdrawal_request_total_fees: any;
         withdrawal_request_bitcoin_address: string;
         withdrawal_request_withdrawal_mode: WithdrawalMode;
         withdrawal_request_status: WithdrawalRequestStatus;
@@ -1234,6 +1341,8 @@ declare class WithdrawalRequest implements Entity {
         withdrawal_request_withdrawal: {
             id: string | undefined;
         };
+        withdrawal_request_idempotency_key: string | undefined;
+        withdrawal_request_initiator: RequestInitiator;
     };
 }
 
@@ -1374,7 +1483,8 @@ declare enum PaymentFailureReason {
     SELF_PAYMENT = "SELF_PAYMENT",
     INVOICE_EXPIRED = "INVOICE_EXPIRED",
     INVOICE_CANCELLED = "INVOICE_CANCELLED",
-    RISK_SCREENING_FAILED = "RISK_SCREENING_FAILED"
+    RISK_SCREENING_FAILED = "RISK_SCREENING_FAILED",
+    INSUFFICIENT_BALANCE_ON_SINGLE_PATH_INVOICE = "INSUFFICIENT_BALANCE_ON_SINGLE_PATH_INVOICE"
 }
 
 /**
@@ -1440,7 +1550,7 @@ declare class Account implements LightsparkNodeOwner, Entity {
     getChannels(client: LightsparkClient, bitcoinNetwork: BitcoinNetwork, lightningNodeId?: string | undefined, afterDate?: string | undefined, beforeDate?: string | undefined, first?: number | undefined, after?: string | undefined): Promise<AccountToChannelsConnection>;
     getTransactions(client: LightsparkClient, first?: number | undefined, after?: string | undefined, types?: TransactionType[] | undefined, afterDate?: string | undefined, beforeDate?: string | undefined, bitcoinNetwork?: BitcoinNetwork | undefined, lightningNodeId?: string | undefined, statuses?: TransactionStatus[] | undefined, excludeFailures?: TransactionFailures | undefined): Promise<AccountToTransactionsConnection>;
     getPaymentRequests(client: LightsparkClient, first?: number | undefined, after?: string | undefined, afterDate?: string | undefined, beforeDate?: string | undefined, bitcoinNetwork?: BitcoinNetwork | undefined, lightningNodeId?: string | undefined): Promise<AccountToPaymentRequestsConnection>;
-    getWithdrawalRequests(client: LightsparkClient, first?: number | undefined, after?: string | undefined, bitcoinNetworks?: BitcoinNetwork[] | undefined, statuses?: WithdrawalRequestStatus[] | undefined, nodeIds?: string[] | undefined, afterDate?: string | undefined, beforeDate?: string | undefined): Promise<AccountToWithdrawalRequestsConnection>;
+    getWithdrawalRequests(client: LightsparkClient, first?: number | undefined, after?: string | undefined, bitcoinNetworks?: BitcoinNetwork[] | undefined, statuses?: WithdrawalRequestStatus[] | undefined, nodeIds?: string[] | undefined, idempotencyKeys?: string[] | undefined, afterDate?: string | undefined, beforeDate?: string | undefined): Promise<AccountToWithdrawalRequestsConnection>;
     getWallets(client: LightsparkClient, first?: number | undefined, after?: string | undefined, thirdPartyIds?: string[] | undefined): Promise<AccountToWalletsConnection>;
     static getAccountQuery(): Query<Account>;
     toJson(): {
@@ -2068,6 +2178,8 @@ declare class OutgoingPayment implements LightningTransaction, Transaction, Enti
     readonly umaPostTransactionData?: PostTransactionData[] | undefined;
     /** The preimage of the payment. **/
     readonly paymentPreimage?: string | undefined;
+    /** The idempotency key of the payment. **/
+    readonly idempotencyKey?: string | undefined;
     constructor(
     /**
      * The unique identifier of this entity across all Lightspark systems. Should be treated as an
@@ -2110,7 +2222,9 @@ declare class OutgoingPayment implements LightningTransaction, Transaction, Enti
     /** The post transaction data which can be used in KYT payment registration. **/
     umaPostTransactionData?: PostTransactionData[] | undefined, 
     /** The preimage of the payment. **/
-    paymentPreimage?: string | undefined);
+    paymentPreimage?: string | undefined, 
+    /** The idempotency key of the payment. **/
+    idempotencyKey?: string | undefined);
     getAttempts(client: LightsparkClient, first?: number | undefined, after?: string | undefined): Promise<OutgoingPaymentToAttemptsConnection>;
     static getOutgoingPaymentQuery(id: string): Query<OutgoingPayment>;
     toJson(): {
@@ -2136,6 +2250,7 @@ declare class OutgoingPayment implements LightningTransaction, Transaction, Enti
         outgoing_payment_uma_post_transaction_data: any[] | undefined;
         outgoing_payment_payment_preimage: string | undefined;
         outgoing_payment_is_internal_payment: boolean;
+        outgoing_payment_idempotency_key: string | undefined;
     };
 }
 
@@ -2964,9 +3079,12 @@ declare class LightsparkClient {
      *     h-tag (SHA256 purpose of payment) of the resulting Bolt 11 invoice. See
      *     [this spec](https://github.com/lnurl/luds/blob/luds/06.md#pay-to-static-qrnfclink) for details.
      * @param expirySecs The number of seconds until the invoice expires. Defaults to 3600 (1 hour).
+     * @param signingPrivateKey The receiver's signing private key. Used to hash the receiver identifier.
+     * @param receiverIdentifier Optional identifier of the receiver. If provided, this will be hashed using a
+     *     monthly-rotated seed and used for anonymized analysis.
      * @returns An Invoice object representing the generated invoice.
      */
-    createUmaInvoice(nodeId: string, amountMsats: number, metadata: string, expirySecs?: number | undefined): Promise<Invoice | undefined>;
+    createUmaInvoice(nodeId: string, amountMsats: number, metadata: string, expirySecs?: number | undefined, signingPrivateKey?: Uint8Array | undefined, receiverIdentifier?: string | undefined): Promise<Invoice | undefined>;
     /**
      * Cancels an existing unpaid invoice and returns that invoice. Cancelled invoices cannot be paid.
      *
@@ -3064,9 +3182,12 @@ declare class LightsparkClient {
      * @param amountMsats The amount to pay in msats for a zero-amount invoice. Defaults to the full amount of the
      *     invoice. NOTE: This parameter can only be passed for a zero-amount
      *     invoice. Otherwise, the call will fail.
+     * @param signingPrivateKey The sender's signing private key. Used to hash the sender identifier.
+     * @param senderIdentifier Optional identifier of the sender. If provided, this will be hashed using a
+     *     monthly-rotated seed and used for anonymized analysis.
      * @returns An `OutgoingPayment` object if the payment was successful, or undefined if the payment failed.
      */
-    payUmaInvoice(payerNodeId: string, encodedInvoice: string, maximumFeesMsats: number, timeoutSecs?: number, amountMsats?: number | undefined): Promise<OutgoingPayment | undefined>;
+    payUmaInvoice(payerNodeId: string, encodedInvoice: string, maximumFeesMsats: number, timeoutSecs?: number, amountMsats?: number | undefined, signingPrivateKey?: Uint8Array | undefined, senderIdentifier?: string | undefined): Promise<OutgoingPayment | undefined>;
     /**
      * Waits for a transaction to have a completed status, and returns the
      * transaction.
@@ -3229,7 +3350,23 @@ declare class LightsparkClient {
      * @returns The invitation with the given code, or null if no invitation exists with that code.
      */
     fetchUmaInvitation(invitationCode: string): Promise<UmaInvitation | null>;
+    /**
+     * Fetches a created invoice by its payment hash.
+     *
+     * @param paymentHash
+     * @returns The invoice if there is one corresponding to the payment hash, or null if no invoice exists with that payment hash.
+     */
+    invoiceForPaymentHash(paymentHash: string): Promise<Invoice | null>;
+    /**
+     * Fetches outgoing payments for a given payment hash if there are any.
+     *
+     * @param paymentHash
+     * @param statuses Filter to only include payments with the given statuses. If not provided, all statuses are included.
+     */
+    outgoingPaymentsForPaymentHash(paymentHash: string, statuses?: TransactionStatus[] | undefined): Promise<OutgoingPayment[]>;
     private hashPhoneNumber;
+    hashUmaIdentifier(identifier: string, signingPrivateKey: Uint8Array): Promise<string>;
+    getUtcDateTime(): Date;
     /**
      * Executes a raw `Query` against the Lightspark API.
      *
@@ -3399,6 +3536,9 @@ interface CreateLnurlInvoiceInput {
     metadataHash: string;
     /** The expiry of the invoice in seconds. Default value is 86400 (1 day). **/
     expirySecs?: number | undefined;
+    /** An optional, monthly-rotated, unique hashed identifier corresponding to the receiver of the
+     * payment. **/
+    receiverHash?: string | undefined;
 }
 
 interface CreateNodeWalletAddressInput {
@@ -3480,6 +3620,7 @@ interface CreateUmaInvoiceInput {
     amountMsats: number;
     metadataHash: string;
     expirySecs?: number | undefined;
+    receiverHash?: string | undefined;
 }
 
 interface DeclineToSignMessagesInput {
@@ -3575,10 +3716,7 @@ interface Deposit {
     resolvedAt?: string | undefined;
     /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
     transactionHash?: string | undefined;
-    /**
-     * The fees that were paid by the wallet sending the transaction to commit it to the Bitcoin
-     * blockchain.
-     **/
+    /** The fees that were paid by the node for this transaction. **/
     fees?: CurrencyAmount | undefined;
     /**
      * The hash of the block that included this transaction. This will be null for unconfirmed
@@ -3590,6 +3728,20 @@ interface Deposit {
 }
 declare const getDepositQuery: (id: string) => Query<Deposit>;
 
+interface FailHtlcsInput {
+    /** The id of invoice which the pending HTLCs that need to be failed are paying for. **/
+    invoiceId: string;
+    /**
+     * Whether the invoice needs to be canceled after failing the htlcs. If yes, the invoice cannot
+     * be paid anymore.
+     **/
+    cancelInvoice: boolean;
+}
+
+interface FailHtlcsOutput {
+    invoiceId: string;
+}
+
 interface FundNodeInput {
     nodeId: string;
     amountSats?: number | undefined;
@@ -3721,6 +3873,15 @@ interface IncomingPaymentsForInvoiceQueryOutput {
     payments: IncomingPayment[];
 }
 
+interface InvoiceForPaymentHashInput {
+    /** The 32-byte hash of the payment preimage for which to fetch an invoice. **/
+    paymentHash: string;
+}
+
+interface InvoiceForPaymentHashOutput {
+    invoiceId?: string | undefined;
+}
+
 interface LightningFeeEstimateForInvoiceInput {
     /** The node from where you want to send the payment. **/
     nodeId: string;
@@ -3932,7 +4093,7 @@ declare class LightsparkNodeWithOSK implements LightsparkNode, Node, Entity {
      */
     encryptedSigningPrivateKey?: Secret | undefined);
     getAddresses(client: LightsparkClient, first?: number | undefined, types?: NodeAddressType[] | undefined): Promise<NodeToAddressesConnection>;
-    getChannels(client: LightsparkClient, first?: number | undefined, statuses?: ChannelStatus[] | undefined, after?: string | undefined): Promise<LightsparkNodeToChannelsConnection>;
+    getChannels(client: LightsparkClient, first?: number | undefined, after?: string | undefined, beforeDate?: string | undefined, afterDate?: string | undefined, statuses?: ChannelStatus[] | undefined): Promise<LightsparkNodeToChannelsConnection>;
     getDailyLiquidityForecasts(client: LightsparkClient, fromDate: string, toDate: string, direction: LightningPaymentDirection): Promise<LightsparkNodeToDailyLiquidityForecastsConnection>;
     static getLightsparkNodeWithOSKQuery(id: string): Query<LightsparkNodeWithOSK>;
     toJson(): {
@@ -4131,7 +4292,7 @@ declare class LightsparkNodeWithRemoteSigning implements LightsparkNode, Node, E
     /** The balances that describe the funds in this node. **/
     balances?: Balances | undefined);
     getAddresses(client: LightsparkClient, first?: number | undefined, types?: NodeAddressType[] | undefined): Promise<NodeToAddressesConnection>;
-    getChannels(client: LightsparkClient, first?: number | undefined, statuses?: ChannelStatus[] | undefined, after?: string | undefined): Promise<LightsparkNodeToChannelsConnection>;
+    getChannels(client: LightsparkClient, first?: number | undefined, after?: string | undefined, beforeDate?: string | undefined, afterDate?: string | undefined, statuses?: ChannelStatus[] | undefined): Promise<LightsparkNodeToChannelsConnection>;
     getDailyLiquidityForecasts(client: LightsparkClient, fromDate: string, toDate: string, direction: LightningPaymentDirection): Promise<LightsparkNodeToDailyLiquidityForecastsConnection>;
     static getLightsparkNodeWithRemoteSigningQuery(id: string): Query<LightsparkNodeWithRemoteSigning>;
     toJson(): {
@@ -4159,6 +4320,22 @@ declare class LightsparkNodeWithRemoteSigning implements LightsparkNode, Node, E
     };
 }
 
+declare enum OnChainFeeTarget {
+    /**
+     * This is an enum value that represents values that could be added in the future.
+     * Clients should support unknown values as more of them could be added without notice.
+     */
+    FUTURE_VALUE = "FUTURE_VALUE",
+    /** Transaction expected to be confirmed within 2 blocks. **/
+    HIGH = "HIGH",
+    /** Transaction expected to be confirmed within 6 blocks. **/
+    MEDIUM = "MEDIUM",
+    /** Transaction expected to be confirmed within 18 blocks. **/
+    LOW = "LOW",
+    /** Transaction expected to be confirmed within 50 blocks. **/
+    BACKGROUND = "BACKGROUND"
+}
+
 /**
  * This object represents an L1 transaction that occurred on the Bitcoin Network. You can retrieve
  * this object to receive information about a specific on-chain transaction made on the Lightning
@@ -4191,10 +4368,7 @@ interface OnChainTransaction {
     resolvedAt?: string | undefined;
     /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
     transactionHash?: string | undefined;
-    /**
-     * The fees that were paid by the wallet sending the transaction to commit it to the Bitcoin
-     * blockchain.
-     **/
+    /** The fees that were paid by the node for this transaction. **/
     fees?: CurrencyAmount | undefined;
     /**
      * The hash of the block that included this transaction. This will be null for unconfirmed
@@ -4206,6 +4380,14 @@ interface OnChainTransaction {
 }
 declare const getOnChainTransactionQuery: (id: string) => Query<OnChainTransaction>;
 
+interface OutgoingPaymentForIdempotencyKeyInput {
+    idempotencyKey: string;
+}
+
+interface OutgoingPaymentForIdempotencyKeyOutput {
+    paymentId?: string | undefined;
+}
+
 interface OutgoingPaymentsForInvoiceQueryInput {
     /** The encoded invoice that the outgoing payments paid to. **/
     encodedInvoice: string;
@@ -4217,6 +4399,17 @@ interface OutgoingPaymentsForInvoiceQueryOutput {
     payments: OutgoingPayment[];
 }
 
+interface OutgoingPaymentsForPaymentHashQueryInput {
+    /** The 32-byte hash of the payment preimage for which to fetch payments **/
+    paymentHash: string;
+    /** An optional filter to only query outgoing payments of given statuses. **/
+    statuses?: TransactionStatus[] | undefined;
+}
+
+interface OutgoingPaymentsForPaymentHashQueryOutput {
+    payments: OutgoingPayment[];
+}
+
 interface PayInvoiceInput {
     /** The node from where you want to send the payment. **/
     nodeId: string;
@@ -4234,6 +4427,11 @@ interface PayInvoiceInput {
      * invoice amount is zero.
      **/
     amountMsats?: number | undefined;
+    /**
+     * The idempotency key of the request. The same result will be returned for the same
+     * idempotency key. *
+     */
+    idempotencyKey?: string | undefined;
 }
 
 interface PayInvoiceOutput {
@@ -4247,6 +4445,12 @@ interface PayUmaInvoiceInput {
     timeoutSecs: number;
     maximumFeesMsats: number;
     amountMsats?: number | undefined;
+    idempotencyKey?: string | undefined;
+    /**
+     * An optional, monthly-rotated, unique hashed identifier corresponding to the sender of the
+     * payment. *
+     */
+    senderHash?: string | undefined;
 }
 
 interface RegisterPaymentInput {
@@ -4314,7 +4518,8 @@ declare enum RemoteSigningSubEventType {
     DERIVE_KEY_AND_SIGN = "DERIVE_KEY_AND_SIGN",
     RELEASE_PAYMENT_PREIMAGE = "RELEASE_PAYMENT_PREIMAGE",
     REQUEST_INVOICE_PAYMENT_HASH = "REQUEST_INVOICE_PAYMENT_HASH",
-    REVEAL_COUNTERPARTY_PER_COMMITMENT_SECRET = "REVEAL_COUNTERPARTY_PER_COMMITMENT_SECRET"
+    REVEAL_COUNTERPARTY_PER_COMMITMENT_SECRET = "REVEAL_COUNTERPARTY_PER_COMMITMENT_SECRET",
+    VLS_MESSAGE = "VLS_MESSAGE"
 }
 
 interface RequestWithdrawalInput {
@@ -4329,6 +4534,22 @@ interface RequestWithdrawalInput {
     amountSats: number;
     /** The strategy that should be used to withdraw the funds from this node. **/
     withdrawalMode: WithdrawalMode;
+    /**
+     * The idempotency key of the request. The same result will be returned for the same
+     * idempotency key. *
+     */
+    idempotencyKey?: string | undefined;
+    /**
+     * The target of the fee that should be used when crafting the L1 transaction. You should only
+     * set `fee_target` or `sats_per_vbyte`. If neither of them is set, default value of MEDIUM
+     * will be used as `fee_target`.
+     **/
+    feeTarget?: OnChainFeeTarget | undefined;
+    /**
+     * A manual fee rate set in sat/vbyte that should be used when crafting the L1 transaction. You
+     * should only set `fee_target` or `sats_per_vbyte`
+     **/
+    satsPerVbyte?: number | undefined;
 }
 
 interface RequestWithdrawalOutput {
@@ -4420,6 +4641,11 @@ interface SendPaymentInput {
      * msats. *
      */
     maximumFeesMsats: number;
+    /**
+     * The idempotency key of the request. The same result will be returned for the same
+     * idempotency key. *
+     */
+    idempotencyKey?: string | undefined;
 }
 
 interface SendPaymentOutput {
@@ -4527,55 +4753,6 @@ declare enum WebhookEventType {
     HIGH_BALANCE = "HIGH_BALANCE"
 }
 
-/**
- * This object represents an L1 withdrawal from your Lightspark Node to any Bitcoin wallet. You can
- * retrieve this object to receive detailed information about any L1 withdrawal associated with
- * your Lightspark Node or account. *
- */
-interface Withdrawal {
-    /**
-     * The unique identifier of this entity across all Lightspark systems. Should be treated as an
-     * opaque string.
-     **/
-    id: string;
-    /** The date and time when this transaction was initiated. **/
-    createdAt: string;
-    /** The date and time when the entity was last updated. **/
-    updatedAt: string;
-    /** The current status of this transaction. **/
-    status: TransactionStatus;
-    /** The amount of money involved in this transaction. **/
-    amount: CurrencyAmount;
-    /**
-     * The height of the block that included this transaction. This will be zero for unconfirmed
-     * transactions.
-     **/
-    blockHeight: number;
-    /** The Bitcoin blockchain addresses this transaction was sent to. **/
-    destinationAddresses: string[];
-    /** The Lightspark node this withdrawal originated from. **/
-    originId: string;
-    /** The typename of the object **/
-    typename: string;
-    /** The date and time when this transaction was completed or failed. **/
-    resolvedAt?: string | undefined;
-    /** The hash of this transaction, so it can be uniquely identified on the Lightning Network. **/
-    transactionHash?: string | undefined;
-    /**
-     * The fees that were paid by the wallet sending the transaction to commit it to the Bitcoin
-     * blockchain.
-     **/
-    fees?: CurrencyAmount | undefined;
-    /**
-     * The hash of the block that included this transaction. This will be null for unconfirmed
-     * transactions.
-     **/
-    blockHash?: string | undefined;
-    /** The number of blockchain confirmations for this transaction in real time. **/
-    numConfirmations?: number | undefined;
-}
-declare const getWithdrawalQuery: (id: string) => Query<Withdrawal>;
-
 interface WithdrawalFeeEstimateInput {
     /** The node from which you'd like to make the withdrawal. **/
     nodeId: string;
@@ -4593,4 +4770,4 @@ interface WithdrawalFeeEstimateOutput {
     feeEstimate: CurrencyAmount;
 }
 
-export { DeclineToSignMessagesInput as $, Account as A, Balances as B, CancelInvoiceInput as C, ClaimUmaInvitationWithIncentivesOutput as D, ComplianceProvider as E, Connection as F, CreateApiTokenInput as G, CreateApiTokenOutput as H, CreateInvitationWithIncentivesInput as I, CreateInvitationWithIncentivesOutput as J, CreateInvoiceInput as K, LightsparkClient as L, CreateInvoiceOutput as M, CreateLnurlInvoiceInput as N, CreateNodeWalletAddressInput as O, CreateNodeWalletAddressOutput as P, CreateTestModeInvoiceInput as Q, CreateTestModeInvoiceOutput as R, CreateTestModePaymentInput as S, CreateTestModePaymentoutput as T, CreateUmaInvitationInput as U, CreateUmaInvitationOutput as V, WebhookEventType as W, CreateUmaInvoiceInput as X, CurrencyAmount as Y, CurrencyUnit as Z, DailyLiquidityForecast as _, AccountToApiTokensConnection as a, PaymentRequest as a$, DeclineToSignMessagesOutput as a0, DeleteApiTokenInput as a1, DeleteApiTokenOutput as a2, Deposit as a3, getDepositQuery as a4, Entity as a5, FeeEstimate as a6, FundNodeInput as a7, FundNodeOutput as a8, GraphNode as a9, getLightsparkNodeOwnerQuery as aA, LightsparkNodeStatus as aB, LightsparkNodeToChannelsConnection as aC, LightsparkNodeToDailyLiquidityForecastsConnection as aD, LightsparkNodeWithOSK as aE, LightsparkNodeWithRemoteSigning as aF, MultiSigAddressValidationParameters as aG, Node as aH, getNodeQuery as aI, NodeAddress as aJ, NodeAddressType as aK, NodeToAddressesConnection as aL, OnChainTransaction as aM, getOnChainTransactionQuery as aN, OutgoingPayment as aO, OutgoingPaymentAttempt as aP, OutgoingPaymentAttemptStatus as aQ, OutgoingPaymentAttemptToHopsConnection as aR, OutgoingPaymentToAttemptsConnection as aS, OutgoingPaymentsForInvoiceQueryInput as aT, OutgoingPaymentsForInvoiceQueryOutput as aU, PageInfo as aV, PayInvoiceInput as aW, PayInvoiceOutput as aX, PayUmaInvoiceInput as aY, PaymentDirection as aZ, PaymentFailureReason as a_, Hop as aa, getHopQuery as ab, HtlcAttemptFailureCode as ac, IdAndSignature as ad, IncentivesIneligibilityReason as ae, IncentivesStatus as af, IncomingPayment as ag, IncomingPaymentAttempt as ah, getIncomingPaymentAttemptQuery as ai, IncomingPaymentAttemptStatus as aj, IncomingPaymentToAttemptsConnection as ak, IncomingPaymentsForInvoiceQueryInput as al, IncomingPaymentsForInvoiceQueryOutput as am, Invoice as an, getInvoiceQuery as ao, InvoiceData as ap, InvoiceType as aq, LightningFeeEstimateForInvoiceInput as ar, LightningFeeEstimateForNodeInput as as, LightningFeeEstimateOutput as at, LightningPaymentDirection as au, LightningTransaction as av, getLightningTransactionQuery as aw, LightsparkNode as ax, getLightsparkNodeQuery as ay, LightsparkNodeOwner as az, AccountToChannelsConnection as b, getPaymentRequestQuery as b0, PaymentRequestData as b1, PaymentRequestStatus as b2, Permission as b3, PostTransactionData as b4, RegionCode as b5, RegisterPaymentInput as b6, RegisterPaymentOutput as b7, ReleaseChannelPerCommitmentSecretInput as b8, ReleaseChannelPerCommitmentSecretOutput as b9, SingleNodeDashboard as bA, Transaction as bB, getTransactionQuery as bC, TransactionFailures as bD, TransactionStatus as bE, TransactionType as bF, TransactionUpdate as bG, UmaInvitation as bH, getUmaInvitationQuery as bI, UpdateChannelPerCommitmentPointInput as bJ, UpdateChannelPerCommitmentPointOutput as bK, UpdateNodeSharedSecretInput as bL, UpdateNodeSharedSecretOutput as bM, Wallet as bN, WalletStatus as bO, WalletToPaymentRequestsConnection as bP, WalletToTransactionsConnection as bQ, WalletToWithdrawalRequestsConnection as bR, Withdrawal as bS, getWithdrawalQuery as bT, WithdrawalFeeEstimateInput as bU, WithdrawalFeeEstimateOutput as bV, WithdrawalMode as bW, WithdrawalRequest as bX, WithdrawalRequestStatus as bY, WithdrawalRequestToChannelClosingTransactionsConnection as bZ, WithdrawalRequestToChannelOpeningTransactionsConnection as b_, ReleasePaymentPreimageInput as ba, ReleasePaymentPreimageOutput as bb, RemoteSigningSubEventType as bc, RequestWithdrawalInput as bd, RequestWithdrawalOutput as be, RichText as bf, RiskRating as bg, RoutingTransaction as bh, getRoutingTransactionQuery as bi, RoutingTransactionFailureReason as bj, ScreenNodeInput as bk, ScreenNodeOutput as bl, Secret as bm, SendPaymentInput as bn, SendPaymentOutput as bo, SetInvoicePaymentHashInput as bp, SetInvoicePaymentHashOutput as bq, SignInvoiceInput as br, SignInvoiceOutput as bs, SignMessagesInput as bt, SignMessagesOutput as bu, Signable as bv, getSignableQuery as bw, SignablePayload as bx, getSignablePayloadQuery as by, SignablePayloadStatus as bz, AccountToNodesConnection as c, AccountToPaymentRequestsConnection as d, AccountToTransactionsConnection as e, AccountToWalletsConnection as f, AccountToWithdrawalRequestsConnection as g, ApiToken as h, getApiTokenQuery as i, AuditLogActor as j, getAuditLogActorQuery as k, BlockchainBalance as l, CancelInvoiceOutput as m, Channel as n, ChannelClosingTransaction as o, getChannelClosingTransactionQuery as p, ChannelFees as q, ChannelOpeningTransaction as r, getChannelOpeningTransactionQuery as s, ChannelSnapshot as t, getChannelSnapshotQuery as u, ChannelStatus as v, ChannelToTransactionsConnection as w, ClaimUmaInvitationInput as x, ClaimUmaInvitationOutput as y, ClaimUmaInvitationWithIncentivesInput as z };
+export { DeclineToSignMessagesInput as $, Account as A, Balances as B, CancelInvoiceInput as C, ClaimUmaInvitationWithIncentivesOutput as D, ComplianceProvider as E, Connection as F, CreateApiTokenInput as G, CreateApiTokenOutput as H, CreateInvitationWithIncentivesInput as I, CreateInvitationWithIncentivesOutput as J, CreateInvoiceInput as K, LightsparkClient as L, CreateInvoiceOutput as M, CreateLnurlInvoiceInput as N, CreateNodeWalletAddressInput as O, CreateNodeWalletAddressOutput as P, CreateTestModeInvoiceInput as Q, CreateTestModeInvoiceOutput as R, CreateTestModePaymentInput as S, CreateTestModePaymentoutput as T, CreateUmaInvitationInput as U, CreateUmaInvitationOutput as V, WebhookEventType as W, CreateUmaInvoiceInput as X, CurrencyAmount as Y, CurrencyUnit as Z, DailyLiquidityForecast as _, AccountToApiTokensConnection as a, OutgoingPaymentsForInvoiceQueryOutput as a$, DeclineToSignMessagesOutput as a0, DeleteApiTokenInput as a1, DeleteApiTokenOutput as a2, Deposit as a3, getDepositQuery as a4, Entity as a5, FailHtlcsInput as a6, FailHtlcsOutput as a7, FeeEstimate as a8, FundNodeInput as a9, getLightningTransactionQuery as aA, LightsparkNode as aB, getLightsparkNodeQuery as aC, LightsparkNodeOwner as aD, getLightsparkNodeOwnerQuery as aE, LightsparkNodeStatus as aF, LightsparkNodeToChannelsConnection as aG, LightsparkNodeToDailyLiquidityForecastsConnection as aH, LightsparkNodeWithOSK as aI, LightsparkNodeWithRemoteSigning as aJ, MultiSigAddressValidationParameters as aK, Node as aL, getNodeQuery as aM, NodeAddress as aN, NodeAddressType as aO, NodeToAddressesConnection as aP, OnChainFeeTarget as aQ, OnChainTransaction as aR, getOnChainTransactionQuery as aS, OutgoingPayment as aT, OutgoingPaymentAttempt as aU, OutgoingPaymentAttemptStatus as aV, OutgoingPaymentAttemptToHopsConnection as aW, OutgoingPaymentForIdempotencyKeyInput as aX, OutgoingPaymentForIdempotencyKeyOutput as aY, OutgoingPaymentToAttemptsConnection as aZ, OutgoingPaymentsForInvoiceQueryInput as a_, FundNodeOutput as aa, GraphNode as ab, Hop as ac, getHopQuery as ad, HtlcAttemptFailureCode as ae, IdAndSignature as af, IncentivesIneligibilityReason as ag, IncentivesStatus as ah, IncomingPayment as ai, IncomingPaymentAttempt as aj, getIncomingPaymentAttemptQuery as ak, IncomingPaymentAttemptStatus as al, IncomingPaymentToAttemptsConnection as am, IncomingPaymentsForInvoiceQueryInput as an, IncomingPaymentsForInvoiceQueryOutput as ao, Invoice as ap, getInvoiceQuery as aq, InvoiceData as ar, InvoiceForPaymentHashInput as as, InvoiceForPaymentHashOutput as at, InvoiceType as au, LightningFeeEstimateForInvoiceInput as av, LightningFeeEstimateForNodeInput as aw, LightningFeeEstimateOutput as ax, LightningPaymentDirection as ay, LightningTransaction as az, AccountToChannelsConnection as b, WalletToWithdrawalRequestsConnection as b$, OutgoingPaymentsForPaymentHashQueryInput as b0, OutgoingPaymentsForPaymentHashQueryOutput as b1, PageInfo as b2, PayInvoiceInput as b3, PayInvoiceOutput as b4, PayUmaInvoiceInput as b5, PaymentDirection as b6, PaymentFailureReason as b7, PaymentRequest as b8, getPaymentRequestQuery as b9, SetInvoicePaymentHashOutput as bA, SignInvoiceInput as bB, SignInvoiceOutput as bC, SignMessagesInput as bD, SignMessagesOutput as bE, Signable as bF, getSignableQuery as bG, SignablePayload as bH, getSignablePayloadQuery as bI, SignablePayloadStatus as bJ, SingleNodeDashboard as bK, Transaction as bL, getTransactionQuery as bM, TransactionFailures as bN, TransactionStatus as bO, TransactionType as bP, TransactionUpdate as bQ, UmaInvitation as bR, getUmaInvitationQuery as bS, UpdateChannelPerCommitmentPointInput as bT, UpdateChannelPerCommitmentPointOutput as bU, UpdateNodeSharedSecretInput as bV, UpdateNodeSharedSecretOutput as bW, Wallet as bX, WalletStatus as bY, WalletToPaymentRequestsConnection as bZ, WalletToTransactionsConnection as b_, PaymentRequestData as ba, PaymentRequestStatus as bb, Permission as bc, PostTransactionData as bd, RegionCode as be, RegisterPaymentInput as bf, RegisterPaymentOutput as bg, ReleaseChannelPerCommitmentSecretInput as bh, ReleaseChannelPerCommitmentSecretOutput as bi, ReleasePaymentPreimageInput as bj, ReleasePaymentPreimageOutput as bk, RemoteSigningSubEventType as bl, RequestInitiator as bm, RequestWithdrawalInput as bn, RequestWithdrawalOutput as bo, RichText as bp, RiskRating as bq, RoutingTransaction as br, getRoutingTransactionQuery as bs, RoutingTransactionFailureReason as bt, ScreenNodeInput as bu, ScreenNodeOutput as bv, Secret as bw, SendPaymentInput as bx, SendPaymentOutput as by, SetInvoicePaymentHashInput as bz, AccountToNodesConnection as c, Withdrawal as c0, getWithdrawalQuery as c1, WithdrawalFeeEstimateInput as c2, WithdrawalFeeEstimateOutput as c3, WithdrawalMode as c4, WithdrawalRequest as c5, WithdrawalRequestStatus as c6, WithdrawalRequestToChannelClosingTransactionsConnection as c7, WithdrawalRequestToChannelOpeningTransactionsConnection as c8, WithdrawalRequestToWithdrawalsConnection as c9, AccountToPaymentRequestsConnection as d, AccountToTransactionsConnection as e, AccountToWalletsConnection as f, AccountToWithdrawalRequestsConnection as g, ApiToken as h, getApiTokenQuery as i, AuditLogActor as j, getAuditLogActorQuery as k, BlockchainBalance as l, CancelInvoiceOutput as m, Channel as n, ChannelClosingTransaction as o, getChannelClosingTransactionQuery as p, ChannelFees as q, ChannelOpeningTransaction as r, getChannelOpeningTransactionQuery as s, ChannelSnapshot as t, getChannelSnapshotQuery as u, ChannelStatus as v, ChannelToTransactionsConnection as w, ClaimUmaInvitationInput as x, ClaimUmaInvitationOutput as y, ClaimUmaInvitationWithIncentivesInput as z };