@buildonspark/spark-sdk 0.1.41 → 0.1.43

package/dist/native/index.d.cts

@@ -1395,6 +1395,10 @@ interface ISigningCommitment {
     hiding: Uint8Array;
     binding: Uint8Array;
 }
+interface DummyTx {
+    tx: Uint8Array;
+    txid: string;
+}
 
 type Polynomial = {
     fieldModulus: bigint;
@@ -1670,6 +1674,17 @@ interface CoopExitFeeEstimatesOutput {
     speedSlow?: CoopExitFeeEstimate | undefined;
 }
 
+declare enum ExitSpeed {
+    /**
+     * 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",
+    FAST = "FAST",
+    MEDIUM = "MEDIUM",
+    SLOW = "SLOW"
+}
+
 declare enum SparkCoopExitRequestStatus {
     /**
      * This is an enum value that represents values that could be added in the future.
@@ -1677,6 +1692,7 @@ declare enum SparkCoopExitRequestStatus {
      */
     FUTURE_VALUE = "FUTURE_VALUE",
     INITIATED = "INITIATED",
+    INBOUND_TRANSFER_CHECKED = "INBOUND_TRANSFER_CHECKED",
     TX_SIGNED = "TX_SIGNED",
     TX_BROADCASTED = "TX_BROADCASTED",
     WAITING_ON_TX_CONFIRMATIONS = "WAITING_ON_TX_CONFIRMATIONS",
@@ -1789,6 +1805,8 @@ interface LightningReceiveRequest {
     transfer?: Transfer | undefined;
     /** The payment preimage of the invoice if retrieved from SE. **/
     paymentPreimage?: string | undefined;
+    /** The receiver's identity public key if different from owner of the request. **/
+    receiverIdentityPublicKey?: string | undefined;
 }
 
 interface LightningSendFeeEstimateOutput {
@@ -1842,13 +1860,13 @@ declare class SspClient {
     });
     executeRawQuery<T>(query: Query<T>, needsAuth?: boolean): Promise<T | null>;
     getSwapFeeEstimate(amountSats: number): Promise<LeavesSwapFeeEstimateOutput | null>;
-    getLightningSendFeeEstimate(encodedInvoice: string): Promise<LightningSendFeeEstimateOutput | null>;
+    getLightningSendFeeEstimate(encodedInvoice: string, amountSats?: number): Promise<LightningSendFeeEstimateOutput | null>;
     getCoopExitFeeEstimate({ leafExternalIds, withdrawalAddress, }: CoopExitFeeEstimatesInput): Promise<CoopExitFeeEstimatesOutput | null>;
     getCurrentUser(): Promise<void>;
     completeCoopExit({ userOutboundTransferExternalId, coopExitRequestId, }: CompleteCoopExitInput): Promise<CoopExitRequest | null>;
     requestCoopExit({ leafExternalIds, withdrawalAddress, idempotencyKey, exitSpeed, }: RequestCoopExitInput): Promise<CoopExitRequest | null>;
     requestLightningReceive({ amountSats, network, paymentHash, expirySecs, memo, includeSparkAddress, receiverIdentityPubkey, descriptionHash, }: RequestLightningReceiveInput): Promise<LightningReceiveRequest | null>;
-    requestLightningSend({ encodedInvoice, idempotencyKey, }: RequestLightningSendInput): Promise<LightningSendRequest | null>;
+    requestLightningSend({ encodedInvoice, idempotencyKey, amountSats, }: RequestLightningSendInput): Promise<LightningSendRequest | null>;
     requestLeaveSwap({ adaptorPubkey, totalAmountSats, targetAmountSats, feeSats, userLeaves, idempotencyKey, }: RequestLeavesSwapInput): Promise<LeavesSwapRequest | null>;
     completeLeaveSwap({ adaptorSecretKey, userOutboundTransferExternalId, leavesSwapRequestId, }: CompleteLeavesSwapInput): Promise<LeavesSwapRequest | null>;
     getLightningReceiveRequest(id: string): Promise<LightningReceiveRequest | null>;
@@ -1946,21 +1964,14 @@ interface CoopExitRequest {
     coopExitTxid: string;
     /** The typename of the object **/
     typename: string;
+    /** The fee quote user requested for this coop exit. **/
+    feeQuoteId?: string | undefined;
+    /** The exit speed user requested for this coop exit. **/
+    exitSpeed?: ExitSpeed | undefined;
     /** The swap transfer. **/
     transfer?: Transfer | undefined;
 }
 
-declare enum ExitSpeed {
-    /**
-     * 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",
-    FAST = "FAST",
-    MEDIUM = "MEDIUM",
-    SLOW = "SLOW"
-}
-
 interface GetChallengeOutput {
     protectedChallenge: string;
 }
@@ -1971,6 +1982,11 @@ interface LeavesSwapFeeEstimateOutput {
 
 interface LightningSendFeeEstimateInput {
     encodedInvoice: string;
+    /**
+ * The amount you will pay for this invoice in sats. It should ONLY be set when the invoice amount is
+ * zero.
+**/
+    amountSats?: number | undefined;
 }
 
 declare enum LightningSendRequestStatus {
@@ -2022,6 +2038,8 @@ interface RequestCoopExitInput {
     idempotencyKey: string;
     exitSpeed: ExitSpeed;
     withdrawAll: boolean;
+    feeLeafExternalIds?: string[] | undefined;
+    feeQuoteId?: string | undefined;
 }
 
 interface UserLeafInput {
@@ -2037,6 +2055,7 @@ interface RequestLeavesSwapInput {
     feeSats: number;
     userLeaves: UserLeafInput[];
     idempotencyKey: string;
+    targetAmountSatsList?: number[] | undefined;
 }
 
 interface RequestLightningReceiveInput {
@@ -2054,7 +2073,10 @@ interface RequestLightningReceiveInput {
     includeSparkAddress: boolean;
     /** The expiry of the lightning invoice in seconds. Default value is 86400 (1 day). **/
     expirySecs?: number | undefined;
-    /** The memo to include in the lightning invoice. **/
+    /**
+ * The memo to include in the lightning invoice. Should not be provided if the description_hash is
+ * provided.
+**/
     memo?: string | undefined;
     /**
  * The public key of the user receiving the lightning invoice. If not present, the receiver will be
@@ -2063,7 +2085,8 @@ interface RequestLightningReceiveInput {
     receiverIdentityPubkey?: string | undefined;
     /**
  * The h tag of the invoice. This is the hash of a longer description to include in the lightning
- * invoice. It is used in LNURL and UMA as the hash of the metadata.
+ * invoice. It is used in LNURL and UMA as the hash of the metadata. This field is mutually exclusive
+ * with the memo field. Only one or the other should be provided.
 **/
     descriptionHash?: string | undefined;
 }
@@ -2071,6 +2094,11 @@ interface RequestLightningReceiveInput {
 interface RequestLightningSendInput {
     encodedInvoice: string;
     idempotencyKey: string;
+    /**
+ * The amount you will pay for this invoice in sats. It should ONLY be set when the invoice amount is
+ * zero.
+**/
+    amountSats?: number | undefined;
 }
 
 declare enum Network {
@@ -2126,6 +2154,7 @@ type ConfigOptions = MayHaveLrc20WalletApiConfig & MayHaveSspClientOptions & {
     readonly lrc20Address?: string;
     readonly threshold?: number;
     readonly tokenSignatures?: "ECDSA" | "SCHNORR";
+    readonly tokenValidityDurationSeconds?: number;
     readonly tokenTransactionVersion?: "V0" | "V1";
     readonly electrsUrl?: string;
     readonly lrc20ApiConfig?: LRC20WalletApiConfig;
@@ -2154,6 +2183,7 @@ declare class WalletConfigService implements HasLrc20WalletApiConfig, HasSspClie
     getNetworkProto(): number;
     getTokenSignatures(): "ECDSA" | "SCHNORR";
     getTokenTransactionVersion(): "V0" | "V1";
+    getTokenValidityDurationSeconds(): number;
     getElectrsUrl(): string;
     getSspIdentityPublicKey(): string;
 }
@@ -2385,6 +2415,7 @@ declare class ConnectionManager {
     getStreamChannel(address: string): Promise<Channel | Channel$1 | undefined>;
     private authenticate;
     private createSparkAuthnGrpcConnection;
+    private createAuthnMiddleware;
     private createMiddleware;
     private createNodeMiddleware;
     private createBrowserMiddleware;
@@ -2820,6 +2851,7 @@ type PayLightningInvoiceParams = {
     invoice: string;
     maxFeeSats: number;
     preferSpark?: boolean;
+    amountSatsToSend?: number;
 };
 type TransferParams = {
     amountSats: number;
@@ -3148,16 +3180,17 @@ declare class SparkWallet extends EventEmitter {
      * @param {Object} params - Parameters for paying the invoice
      * @param {string} params.invoice - The BOLT11-encoded Lightning invoice to pay
      * @param {boolean} [params.preferSpark] - Whether to prefer a spark transfer over lightning for the payment
+     * @param {number} [params.amountSatsToSend] - The amount in sats to send. This is only valid for 0 amount lightning invoices.
      * @returns {Promise<LightningSendRequest>} The Lightning payment request details
      */
-    payLightningInvoice({ invoice, maxFeeSats, preferSpark, }: PayLightningInvoiceParams): Promise<LightningSendRequest | WalletTransfer>;
+    payLightningInvoice({ invoice, maxFeeSats, preferSpark, amountSatsToSend, }: PayLightningInvoiceParams): Promise<LightningSendRequest | WalletTransfer>;
     /**
      * Gets fee estimate for sending Lightning payments.
      *
      * @param {LightningSendFeeEstimateInput} params - Input parameters for fee estimation
      * @returns {Promise<number>} Fee estimate for sending Lightning payments
      */
-    getLightningSendFeeEstimate({ encodedInvoice, }: LightningSendFeeEstimateInput): Promise<number>;
+    getLightningSendFeeEstimate({ encodedInvoice, amountSats, }: LightningSendFeeEstimateInput): Promise<number>;
     /**
      * Generates a deposit address for a tree.
      *
@@ -3363,6 +3396,8 @@ declare class SparkWallet extends EventEmitter {
 declare function getLatestDepositTxId(address: string): Promise<string | null>;
 declare function isTxBroadcast(txid: string, baseUrl: string, network?: any): Promise<boolean>;
 
+declare function createDummyTx(address: string, amountSats: bigint): Promise<DummyTx>;
+
 declare function generateSignatureFromExistingAdaptor(signature: Uint8Array, adaptorPrivateKeyBytes: Uint8Array): Uint8Array;
 declare function generateAdaptorFromSignature(signature: Uint8Array): {
     adaptorSignature: Uint8Array;
@@ -3480,4 +3515,4 @@ declare function constructFeeBumpTx(txHex: string, utxos: Utxo[], feeRate: FeeRa
 
 declare function getSparkAddressFromTaproot(taprootAddress: string): SparkAddressFormat;
 
-export { AuthenticationError, type BroadcastConfig, type BroadcastResult, ConfigurationError, DEFAULT_FEE_SATS, ReactNativeSparkSigner as DefaultSparkSigner, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, InternalValidationError, LRC_WALLET_NETWORK, LRC_WALLET_NETWORK_TYPE, type LeafInfo, Network, NetworkError, NetworkToProto, type NetworkType, NotImplementedError, RPCError, ReactNativeSparkSigner, SparkSDKError, SparkWallet, type TxChain, type Utxo, ValidationError, type VerifiableSecretShare, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, bigIntToPrivateKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, checkIfValidSequence, collectResponses, computeTaprootKeyNoScript, computerLagrangeCoefficients, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, evaluatePolynomial, fieldDiv, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generatePolynomialForSecretSharing, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNetwork, getNetworkFromAddress, getNetworkFromString, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomBigInt, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getSparkAddressFromTaproot, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, modInverse, proofOfPossessionMessageHashForDepositAddress, recoverSecret, splitSecret, splitSecretWithProofs, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature, validateShare };
+export { AuthenticationError, type BroadcastConfig, type BroadcastResult, ConfigurationError, DEFAULT_FEE_SATS, ReactNativeSparkSigner as DefaultSparkSigner, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, InternalValidationError, LRC_WALLET_NETWORK, LRC_WALLET_NETWORK_TYPE, type LeafInfo, Network, NetworkError, NetworkToProto, type NetworkType, NotImplementedError, RPCError, ReactNativeSparkSigner, SparkSDKError, SparkWallet, type TxChain, type Utxo, ValidationError, type VerifiableSecretShare, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, bigIntToPrivateKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, checkIfValidSequence, collectResponses, computeTaprootKeyNoScript, computerLagrangeCoefficients, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createDummyTx, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, evaluatePolynomial, fieldDiv, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generatePolynomialForSecretSharing, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNetwork, getNetworkFromAddress, getNetworkFromString, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomBigInt, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getSparkAddressFromTaproot, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, modInverse, proofOfPossessionMessageHashForDepositAddress, recoverSecret, splitSecret, splitSecretWithProofs, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature, validateShare };

package/dist/native/index.d.ts

@@ -1395,6 +1395,10 @@ interface ISigningCommitment {
     hiding: Uint8Array;
     binding: Uint8Array;
 }
+interface DummyTx {
+    tx: Uint8Array;
+    txid: string;
+}
 
 type Polynomial = {
     fieldModulus: bigint;
@@ -1670,6 +1674,17 @@ interface CoopExitFeeEstimatesOutput {
     speedSlow?: CoopExitFeeEstimate | undefined;
 }
 
+declare enum ExitSpeed {
+    /**
+     * 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",
+    FAST = "FAST",
+    MEDIUM = "MEDIUM",
+    SLOW = "SLOW"
+}
+
 declare enum SparkCoopExitRequestStatus {
     /**
      * This is an enum value that represents values that could be added in the future.
@@ -1677,6 +1692,7 @@ declare enum SparkCoopExitRequestStatus {
      */
     FUTURE_VALUE = "FUTURE_VALUE",
     INITIATED = "INITIATED",
+    INBOUND_TRANSFER_CHECKED = "INBOUND_TRANSFER_CHECKED",
     TX_SIGNED = "TX_SIGNED",
     TX_BROADCASTED = "TX_BROADCASTED",
     WAITING_ON_TX_CONFIRMATIONS = "WAITING_ON_TX_CONFIRMATIONS",
@@ -1789,6 +1805,8 @@ interface LightningReceiveRequest {
     transfer?: Transfer | undefined;
     /** The payment preimage of the invoice if retrieved from SE. **/
     paymentPreimage?: string | undefined;
+    /** The receiver's identity public key if different from owner of the request. **/
+    receiverIdentityPublicKey?: string | undefined;
 }
 
 interface LightningSendFeeEstimateOutput {
@@ -1842,13 +1860,13 @@ declare class SspClient {
     });
     executeRawQuery<T>(query: Query<T>, needsAuth?: boolean): Promise<T | null>;
     getSwapFeeEstimate(amountSats: number): Promise<LeavesSwapFeeEstimateOutput | null>;
-    getLightningSendFeeEstimate(encodedInvoice: string): Promise<LightningSendFeeEstimateOutput | null>;
+    getLightningSendFeeEstimate(encodedInvoice: string, amountSats?: number): Promise<LightningSendFeeEstimateOutput | null>;
     getCoopExitFeeEstimate({ leafExternalIds, withdrawalAddress, }: CoopExitFeeEstimatesInput): Promise<CoopExitFeeEstimatesOutput | null>;
     getCurrentUser(): Promise<void>;
     completeCoopExit({ userOutboundTransferExternalId, coopExitRequestId, }: CompleteCoopExitInput): Promise<CoopExitRequest | null>;
     requestCoopExit({ leafExternalIds, withdrawalAddress, idempotencyKey, exitSpeed, }: RequestCoopExitInput): Promise<CoopExitRequest | null>;
     requestLightningReceive({ amountSats, network, paymentHash, expirySecs, memo, includeSparkAddress, receiverIdentityPubkey, descriptionHash, }: RequestLightningReceiveInput): Promise<LightningReceiveRequest | null>;
-    requestLightningSend({ encodedInvoice, idempotencyKey, }: RequestLightningSendInput): Promise<LightningSendRequest | null>;
+    requestLightningSend({ encodedInvoice, idempotencyKey, amountSats, }: RequestLightningSendInput): Promise<LightningSendRequest | null>;
     requestLeaveSwap({ adaptorPubkey, totalAmountSats, targetAmountSats, feeSats, userLeaves, idempotencyKey, }: RequestLeavesSwapInput): Promise<LeavesSwapRequest | null>;
     completeLeaveSwap({ adaptorSecretKey, userOutboundTransferExternalId, leavesSwapRequestId, }: CompleteLeavesSwapInput): Promise<LeavesSwapRequest | null>;
     getLightningReceiveRequest(id: string): Promise<LightningReceiveRequest | null>;
@@ -1946,21 +1964,14 @@ interface CoopExitRequest {
     coopExitTxid: string;
     /** The typename of the object **/
     typename: string;
+    /** The fee quote user requested for this coop exit. **/
+    feeQuoteId?: string | undefined;
+    /** The exit speed user requested for this coop exit. **/
+    exitSpeed?: ExitSpeed | undefined;
     /** The swap transfer. **/
     transfer?: Transfer | undefined;
 }
 
-declare enum ExitSpeed {
-    /**
-     * 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",
-    FAST = "FAST",
-    MEDIUM = "MEDIUM",
-    SLOW = "SLOW"
-}
-
 interface GetChallengeOutput {
     protectedChallenge: string;
 }
@@ -1971,6 +1982,11 @@ interface LeavesSwapFeeEstimateOutput {
 
 interface LightningSendFeeEstimateInput {
     encodedInvoice: string;
+    /**
+ * The amount you will pay for this invoice in sats. It should ONLY be set when the invoice amount is
+ * zero.
+**/
+    amountSats?: number | undefined;
 }
 
 declare enum LightningSendRequestStatus {
@@ -2022,6 +2038,8 @@ interface RequestCoopExitInput {
     idempotencyKey: string;
     exitSpeed: ExitSpeed;
     withdrawAll: boolean;
+    feeLeafExternalIds?: string[] | undefined;
+    feeQuoteId?: string | undefined;
 }
 
 interface UserLeafInput {
@@ -2037,6 +2055,7 @@ interface RequestLeavesSwapInput {
     feeSats: number;
     userLeaves: UserLeafInput[];
     idempotencyKey: string;
+    targetAmountSatsList?: number[] | undefined;
 }
 
 interface RequestLightningReceiveInput {
@@ -2054,7 +2073,10 @@ interface RequestLightningReceiveInput {
     includeSparkAddress: boolean;
     /** The expiry of the lightning invoice in seconds. Default value is 86400 (1 day). **/
     expirySecs?: number | undefined;
-    /** The memo to include in the lightning invoice. **/
+    /**
+ * The memo to include in the lightning invoice. Should not be provided if the description_hash is
+ * provided.
+**/
     memo?: string | undefined;
     /**
  * The public key of the user receiving the lightning invoice. If not present, the receiver will be
@@ -2063,7 +2085,8 @@ interface RequestLightningReceiveInput {
     receiverIdentityPubkey?: string | undefined;
     /**
  * The h tag of the invoice. This is the hash of a longer description to include in the lightning
- * invoice. It is used in LNURL and UMA as the hash of the metadata.
+ * invoice. It is used in LNURL and UMA as the hash of the metadata. This field is mutually exclusive
+ * with the memo field. Only one or the other should be provided.
 **/
     descriptionHash?: string | undefined;
 }
@@ -2071,6 +2094,11 @@ interface RequestLightningReceiveInput {
 interface RequestLightningSendInput {
     encodedInvoice: string;
     idempotencyKey: string;
+    /**
+ * The amount you will pay for this invoice in sats. It should ONLY be set when the invoice amount is
+ * zero.
+**/
+    amountSats?: number | undefined;
 }
 
 declare enum Network {
@@ -2126,6 +2154,7 @@ type ConfigOptions = MayHaveLrc20WalletApiConfig & MayHaveSspClientOptions & {
     readonly lrc20Address?: string;
     readonly threshold?: number;
     readonly tokenSignatures?: "ECDSA" | "SCHNORR";
+    readonly tokenValidityDurationSeconds?: number;
     readonly tokenTransactionVersion?: "V0" | "V1";
     readonly electrsUrl?: string;
     readonly lrc20ApiConfig?: LRC20WalletApiConfig;
@@ -2154,6 +2183,7 @@ declare class WalletConfigService implements HasLrc20WalletApiConfig, HasSspClie
     getNetworkProto(): number;
     getTokenSignatures(): "ECDSA" | "SCHNORR";
     getTokenTransactionVersion(): "V0" | "V1";
+    getTokenValidityDurationSeconds(): number;
     getElectrsUrl(): string;
     getSspIdentityPublicKey(): string;
 }
@@ -2385,6 +2415,7 @@ declare class ConnectionManager {
     getStreamChannel(address: string): Promise<Channel | Channel$1 | undefined>;
     private authenticate;
     private createSparkAuthnGrpcConnection;
+    private createAuthnMiddleware;
     private createMiddleware;
     private createNodeMiddleware;
     private createBrowserMiddleware;
@@ -2820,6 +2851,7 @@ type PayLightningInvoiceParams = {
     invoice: string;
     maxFeeSats: number;
     preferSpark?: boolean;
+    amountSatsToSend?: number;
 };
 type TransferParams = {
     amountSats: number;
@@ -3148,16 +3180,17 @@ declare class SparkWallet extends EventEmitter {
      * @param {Object} params - Parameters for paying the invoice
      * @param {string} params.invoice - The BOLT11-encoded Lightning invoice to pay
      * @param {boolean} [params.preferSpark] - Whether to prefer a spark transfer over lightning for the payment
+     * @param {number} [params.amountSatsToSend] - The amount in sats to send. This is only valid for 0 amount lightning invoices.
      * @returns {Promise<LightningSendRequest>} The Lightning payment request details
      */
-    payLightningInvoice({ invoice, maxFeeSats, preferSpark, }: PayLightningInvoiceParams): Promise<LightningSendRequest | WalletTransfer>;
+    payLightningInvoice({ invoice, maxFeeSats, preferSpark, amountSatsToSend, }: PayLightningInvoiceParams): Promise<LightningSendRequest | WalletTransfer>;
     /**
      * Gets fee estimate for sending Lightning payments.
      *
      * @param {LightningSendFeeEstimateInput} params - Input parameters for fee estimation
      * @returns {Promise<number>} Fee estimate for sending Lightning payments
      */
-    getLightningSendFeeEstimate({ encodedInvoice, }: LightningSendFeeEstimateInput): Promise<number>;
+    getLightningSendFeeEstimate({ encodedInvoice, amountSats, }: LightningSendFeeEstimateInput): Promise<number>;
     /**
      * Generates a deposit address for a tree.
      *
@@ -3363,6 +3396,8 @@ declare class SparkWallet extends EventEmitter {
 declare function getLatestDepositTxId(address: string): Promise<string | null>;
 declare function isTxBroadcast(txid: string, baseUrl: string, network?: any): Promise<boolean>;
 
+declare function createDummyTx(address: string, amountSats: bigint): Promise<DummyTx>;
+
 declare function generateSignatureFromExistingAdaptor(signature: Uint8Array, adaptorPrivateKeyBytes: Uint8Array): Uint8Array;
 declare function generateAdaptorFromSignature(signature: Uint8Array): {
     adaptorSignature: Uint8Array;
@@ -3480,4 +3515,4 @@ declare function constructFeeBumpTx(txHex: string, utxos: Utxo[], feeRate: FeeRa
 
 declare function getSparkAddressFromTaproot(taprootAddress: string): SparkAddressFormat;
 
-export { AuthenticationError, type BroadcastConfig, type BroadcastResult, ConfigurationError, DEFAULT_FEE_SATS, ReactNativeSparkSigner as DefaultSparkSigner, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, InternalValidationError, LRC_WALLET_NETWORK, LRC_WALLET_NETWORK_TYPE, type LeafInfo, Network, NetworkError, NetworkToProto, type NetworkType, NotImplementedError, RPCError, ReactNativeSparkSigner, SparkSDKError, SparkWallet, type TxChain, type Utxo, ValidationError, type VerifiableSecretShare, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, bigIntToPrivateKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, checkIfValidSequence, collectResponses, computeTaprootKeyNoScript, computerLagrangeCoefficients, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, evaluatePolynomial, fieldDiv, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generatePolynomialForSecretSharing, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNetwork, getNetworkFromAddress, getNetworkFromString, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomBigInt, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getSparkAddressFromTaproot, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, modInverse, proofOfPossessionMessageHashForDepositAddress, recoverSecret, splitSecret, splitSecretWithProofs, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature, validateShare };
+export { AuthenticationError, type BroadcastConfig, type BroadcastResult, ConfigurationError, DEFAULT_FEE_SATS, ReactNativeSparkSigner as DefaultSparkSigner, type FeeBumpTxChain, type FeeBumpTxPackage, type FeeRate, InternalValidationError, LRC_WALLET_NETWORK, LRC_WALLET_NETWORK_TYPE, type LeafInfo, Network, NetworkError, NetworkToProto, type NetworkType, NotImplementedError, RPCError, ReactNativeSparkSigner, SparkSDKError, SparkWallet, type TxChain, type Utxo, ValidationError, type VerifiableSecretShare, addPrivateKeys, addPublicKeys, applyAdaptorToSignature, applyAdditiveTweakToPublicKey, bigIntToPrivateKey, calculateAvailableTokenAmount, checkIfSelectedOutputsAreAvailable, checkIfValidSequence, collectResponses, computeTaprootKeyNoScript, computerLagrangeCoefficients, constructFeeBumpTx, constructUnilateralExitFeeBumpPackages, constructUnilateralExitTxs, createDummyTx, createRefundTx, createSigningCommitment, createSigningNonce, decodeBytesToSigningCommitment, decodeBytesToSigningNonce, encodeSigningCommitmentToBytes, encodeSigningNonceToBytes, evaluatePolynomial, fieldDiv, filterTokenBalanceForTokenPublicKey, generateAdaptorFromSignature, generatePolynomialForSecretSharing, generateSignatureFromExistingAdaptor, getCurrentTimelock, getEphemeralAnchorOutput, getLatestDepositTxId, getNetwork, getNetworkFromAddress, getNetworkFromString, getNextTransactionSequence, getP2TRAddressFromPkScript, getP2TRAddressFromPublicKey, getP2TRScriptFromPublicKey, getP2WPKHAddressFromPublicKey, getRandomBigInt, getRandomSigningNonce, getSigHashFromTx, getSigningCommitmentFromNonce, getSparkAddressFromTaproot, getTransactionSequence, getTransferPackageSigningPayload, getTxFromRawTxBytes, getTxFromRawTxHex, getTxId, getTxIdNoReverse, isEphemeralAnchorOutput, isTxBroadcast, lastKeyWithTarget, maybeApplyFee, modInverse, proofOfPossessionMessageHashForDepositAddress, recoverSecret, splitSecret, splitSecretWithProofs, subtractPrivateKeys, subtractPublicKeys, sumOfPrivateKeys, validateOutboundAdaptorSignature, validateShare };