@buildonspark/spark-sdk 0.1.34 → 0.1.35

package/dist/native/index.d.cts

@@ -1705,7 +1705,7 @@ declare class SspClient {
     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, }: RequestLightningReceiveInput): Promise<LightningReceiveRequest | null>;
+    requestLightningReceive({ amountSats, network, paymentHash, expirySecs, memo, includeSparkAddress, receiverIdentityPubkey, descriptionHash, }: RequestLightningReceiveInput): Promise<LightningReceiveRequest | null>;
     requestLightningSend({ encodedInvoice, idempotencyKey, }: RequestLightningSendInput): Promise<LightningSendRequest | null>;
     requestLeaveSwap({ adaptorPubkey, totalAmountSats, targetAmountSats, feeSats, userLeaves, idempotencyKey, }: RequestLeavesSwapInput): Promise<LeavesSwapRequest | null>;
     completeLeaveSwap({ adaptorSecretKey, userOutboundTransferExternalId, leavesSwapRequestId, }: CompleteLeavesSwapInput): Promise<LeavesSwapRequest | null>;
@@ -1911,6 +1911,11 @@ interface RequestLightningReceiveInput {
  * the creator of this request.
 **/
     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.
+**/
+    descriptionHash?: string | undefined;
 }
 
 interface RequestLightningSendInput {
@@ -1940,7 +1945,7 @@ type ConfigOptions = MayHaveLrc20WalletApiConfig & MayHaveSspClientOptions & {
     readonly frostSignerAddress?: string;
     readonly lrc20Address?: string;
     readonly threshold?: number;
-    readonly useTokenTransactionSchnorrSignatures?: boolean;
+    readonly tokenSignatures?: "ECDSA" | "SCHNORR";
     readonly electrsUrl?: string;
     readonly lrc20ApiConfig?: LRC20WalletApiConfig;
     readonly sspClientOptions?: SspClientOptions;
@@ -1966,7 +1971,7 @@ declare class WalletConfigService implements HasLrc20WalletApiConfig, HasSspClie
     getNetwork(): Network;
     getNetworkType(): NetworkType;
     getNetworkProto(): number;
-    shouldSignTokenTransactionsWithSchnorr(): boolean;
+    getTokenSignatures(): "ECDSA" | "SCHNORR";
     getElectrsUrl(): string;
     getSspIdentityPublicKey(): string;
 }
@@ -2461,6 +2466,7 @@ type CreateLightningInvoiceParams = {
     expirySeconds?: number;
     includeSparkAddress?: boolean;
     receiverIdentityPubkey?: string;
+    descriptionHash?: string;
 };
 type PayLightningInvoiceParams = {
     invoice: string;
@@ -2678,8 +2684,24 @@ declare class SparkWallet extends EventEmitter {
         sspSignature: string;
         outputIndex?: number;
     }): Promise<ClaimStaticDepositOutput | null>;
+    /**
+     * Refunds a static deposit to a destination address.
+     *
+     * @param {string} depositTransactionId - The ID of the transaction
+     * @param {number} [outputIndex] - The index of the output
+     * @param {string} destinationAddress - The destination address
+     * @param {number} fee - The fee to refund
+     * @returns {Promise<string>} The hex of the refund transaction
+     */
+    refundStaticDeposit({ depositTransactionId, outputIndex, destinationAddress, fee, }: {
+        depositTransactionId: string;
+        outputIndex?: number;
+        destinationAddress: string;
+        fee: number;
+    }): Promise<string>;
     private getStaticDepositSigningPayload;
     private getDepositTransactionVout;
+    private getDepositTransaction;
     /**
      * Finalizes a deposit to the wallet.
      *
@@ -2767,9 +2789,10 @@ declare class SparkWallet extends EventEmitter {
      * @param {number} [params.expirySeconds] - Optional expiry time in seconds
      * @param {boolean} [params.includeSparkAddress] - Optional boolean signalling whether or not to include the spark address in the invoice
      * @param {string} [params.receiverIdentityPubkey] - Optional public key of the wallet receiving the lightning invoice. If not present, the receiver will be the creator of this request.
+     * @param {string} [params.descriptionHash] - Optional 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.
      * @returns {Promise<LightningReceiveRequest>} BOLT11 encoded invoice
      */
-    createLightningInvoice({ amountSats, memo, expirySeconds, includeSparkAddress, receiverIdentityPubkey, }: CreateLightningInvoiceParams): Promise<LightningReceiveRequest>;
+    createLightningInvoice({ amountSats, memo, expirySeconds, includeSparkAddress, receiverIdentityPubkey, descriptionHash, }: CreateLightningInvoiceParams): Promise<LightningReceiveRequest>;
     /**
      * Pays a Lightning invoice.
      *

package/dist/native/index.d.ts

@@ -1705,7 +1705,7 @@ declare class SspClient {
     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, }: RequestLightningReceiveInput): Promise<LightningReceiveRequest | null>;
+    requestLightningReceive({ amountSats, network, paymentHash, expirySecs, memo, includeSparkAddress, receiverIdentityPubkey, descriptionHash, }: RequestLightningReceiveInput): Promise<LightningReceiveRequest | null>;
     requestLightningSend({ encodedInvoice, idempotencyKey, }: RequestLightningSendInput): Promise<LightningSendRequest | null>;
     requestLeaveSwap({ adaptorPubkey, totalAmountSats, targetAmountSats, feeSats, userLeaves, idempotencyKey, }: RequestLeavesSwapInput): Promise<LeavesSwapRequest | null>;
     completeLeaveSwap({ adaptorSecretKey, userOutboundTransferExternalId, leavesSwapRequestId, }: CompleteLeavesSwapInput): Promise<LeavesSwapRequest | null>;
@@ -1911,6 +1911,11 @@ interface RequestLightningReceiveInput {
  * the creator of this request.
 **/
     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.
+**/
+    descriptionHash?: string | undefined;
 }
 
 interface RequestLightningSendInput {
@@ -1940,7 +1945,7 @@ type ConfigOptions = MayHaveLrc20WalletApiConfig & MayHaveSspClientOptions & {
     readonly frostSignerAddress?: string;
     readonly lrc20Address?: string;
     readonly threshold?: number;
-    readonly useTokenTransactionSchnorrSignatures?: boolean;
+    readonly tokenSignatures?: "ECDSA" | "SCHNORR";
     readonly electrsUrl?: string;
     readonly lrc20ApiConfig?: LRC20WalletApiConfig;
     readonly sspClientOptions?: SspClientOptions;
@@ -1966,7 +1971,7 @@ declare class WalletConfigService implements HasLrc20WalletApiConfig, HasSspClie
     getNetwork(): Network;
     getNetworkType(): NetworkType;
     getNetworkProto(): number;
-    shouldSignTokenTransactionsWithSchnorr(): boolean;
+    getTokenSignatures(): "ECDSA" | "SCHNORR";
     getElectrsUrl(): string;
     getSspIdentityPublicKey(): string;
 }
@@ -2461,6 +2466,7 @@ type CreateLightningInvoiceParams = {
     expirySeconds?: number;
     includeSparkAddress?: boolean;
     receiverIdentityPubkey?: string;
+    descriptionHash?: string;
 };
 type PayLightningInvoiceParams = {
     invoice: string;
@@ -2678,8 +2684,24 @@ declare class SparkWallet extends EventEmitter {
         sspSignature: string;
         outputIndex?: number;
     }): Promise<ClaimStaticDepositOutput | null>;
+    /**
+     * Refunds a static deposit to a destination address.
+     *
+     * @param {string} depositTransactionId - The ID of the transaction
+     * @param {number} [outputIndex] - The index of the output
+     * @param {string} destinationAddress - The destination address
+     * @param {number} fee - The fee to refund
+     * @returns {Promise<string>} The hex of the refund transaction
+     */
+    refundStaticDeposit({ depositTransactionId, outputIndex, destinationAddress, fee, }: {
+        depositTransactionId: string;
+        outputIndex?: number;
+        destinationAddress: string;
+        fee: number;
+    }): Promise<string>;
     private getStaticDepositSigningPayload;
     private getDepositTransactionVout;
+    private getDepositTransaction;
     /**
      * Finalizes a deposit to the wallet.
      *
@@ -2767,9 +2789,10 @@ declare class SparkWallet extends EventEmitter {
      * @param {number} [params.expirySeconds] - Optional expiry time in seconds
      * @param {boolean} [params.includeSparkAddress] - Optional boolean signalling whether or not to include the spark address in the invoice
      * @param {string} [params.receiverIdentityPubkey] - Optional public key of the wallet receiving the lightning invoice. If not present, the receiver will be the creator of this request.
+     * @param {string} [params.descriptionHash] - Optional 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.
      * @returns {Promise<LightningReceiveRequest>} BOLT11 encoded invoice
      */
-    createLightningInvoice({ amountSats, memo, expirySeconds, includeSparkAddress, receiverIdentityPubkey, }: CreateLightningInvoiceParams): Promise<LightningReceiveRequest>;
+    createLightningInvoice({ amountSats, memo, expirySeconds, includeSparkAddress, receiverIdentityPubkey, descriptionHash, }: CreateLightningInvoiceParams): Promise<LightningReceiveRequest>;
     /**
      * Pays a Lightning invoice.
      *

package/dist/native/index.js

@@ -692,6 +692,10 @@ var DefaultSparkSigner = class {
       HARDENED_OFFSET + idx
     );
     this.staticDepositKeyMap.set(idx, staticDepositKey);
+    this.publicKeyToPrivateKeyMap.set(
+      bytesToHex2(staticDepositKey.publicKey),
+      bytesToHex2(staticDepositKey.privateKey)
+    );
     return staticDepositKey.publicKey;
   }
   async getStaticDepositSigningKey(idx) {
@@ -1089,7 +1093,7 @@ import {
 import { secp256k1 as secp256k115 } from "@noble/curves/secp256k1";
 import { validateMnemonic } from "@scure/bip39";
 import { wordlist as wordlist2 } from "@scure/bip39/wordlists/english";
-import { Address as Address6, OutScript as OutScript5 } from "@scure/btc-signer";
+import { Address as Address6, OutScript as OutScript5, Transaction as Transaction9 } from "@scure/btc-signer";
 import { Mutex } from "async-mutex";
 import { uuidv7 as uuidv74 } from "uuidv7";
 
@@ -1702,6 +1706,7 @@ var RequestLightningReceive = `
     $memo: String
     $include_spark_address: Boolean
     $receiver_identity_pubkey: PublicKey
+    $description_hash: Hash32
   ) {
     request_lightning_receive(
       input: {
@@ -1712,6 +1717,7 @@ var RequestLightningReceive = `
         memo: $memo
         include_spark_address: $include_spark_address
         receiver_identity_pubkey: $receiver_identity_pubkey
+        description_hash: $description_hash
       }
     ) {
       request {
@@ -2440,7 +2446,8 @@ var SspClient = class {
     expirySecs,
     memo,
     includeSparkAddress,
-    receiverIdentityPubkey
+    receiverIdentityPubkey,
+    descriptionHash
   }) {
     return await this.executeRawQuery({
       queryPayload: RequestLightningReceive,
@@ -2451,7 +2458,8 @@ var SspClient = class {
         expiry_secs: expirySecs,
         memo,
         include_spark_address: includeSparkAddress,
-        receiver_identity_pubkey: receiverIdentityPubkey
+        receiver_identity_pubkey: receiverIdentityPubkey,
+        description_hash: descriptionHash
       },
       constructObject: (response) => {
         return LightningReceiveRequestFromJson(
@@ -2713,9 +2721,6 @@ var SparkAuthProvider = class {
 // src/graphql/objects/ClaimStaticDeposit.ts
 import { isObject as isObject6 } from "@lightsparkdev/core";
 
-// src/graphql/objects/Connection.ts
-import { LightsparkException as LightsparkException2 } from "@lightsparkdev/core";
-
 // src/graphql/objects/ExitSpeed.ts
 var ExitSpeed = /* @__PURE__ */ ((ExitSpeed2) => {
   ExitSpeed2["FUTURE_VALUE"] = "FUTURE_VALUE";
@@ -16023,7 +16028,7 @@ var BASE_CONFIG = {
   frostSignerAddress: getLocalFrostSignerAddress(),
   threshold: 2,
   signingOperators: getLocalSigningOperators(),
-  useTokenTransactionSchnorrSignatures: true,
+  tokenSignatures: "SCHNORR",
   electrsUrl: getElectrsUrl("LOCAL"),
   expectedWithdrawBondSats: 1e4,
   expectedWithdrawRelativeBlockLocktime: 1e3,
@@ -16048,7 +16053,7 @@ var LOCAL_WALLET_CONFIG_SCHNORR = {
 };
 var LOCAL_WALLET_CONFIG_ECDSA = {
   ...LOCAL_WALLET_CONFIG,
-  useTokenTransactionSchnorrSignatures: false,
+  tokenSignatures: "ECDSA",
   threshold: 3
   // 3 for issuance tests.
 };
@@ -16228,8 +16233,8 @@ var WalletConfigService = class {
   getNetworkProto() {
     return NetworkToProto[Network2[this.config.network]];
   }
-  shouldSignTokenTransactionsWithSchnorr() {
-    return this.config.useTokenTransactionSchnorrSignatures;
+  getTokenSignatures() {
+    return this.config.tokenSignatures;
   }
   getElectrsUrl() {
     return this.config.electrsUrl;
@@ -19259,7 +19264,8 @@ var LightningService = class {
     invoiceCreator,
     amountSats,
     memo,
-    receiverIdentityPubkey
+    receiverIdentityPubkey,
+    descriptionHash
   }) {
     const randBytes = crypto3.getRandomValues(new Uint8Array(32));
     const preimage = numberToBytesBE4(
@@ -19271,7 +19277,8 @@ var LightningService = class {
       amountSats,
       memo,
       preimage,
-      receiverIdentityPubkey
+      receiverIdentityPubkey,
+      descriptionHash
     });
   }
   async createLightningInvoiceWithPreImage({
@@ -19279,14 +19286,16 @@ var LightningService = class {
     amountSats,
     memo,
     preimage,
-    receiverIdentityPubkey
+    receiverIdentityPubkey,
+    descriptionHash
   }) {
     const paymentHash = sha25610(preimage);
     const invoice = await invoiceCreator(
       amountSats,
       paymentHash,
       memo,
-      receiverIdentityPubkey
+      receiverIdentityPubkey,
+      descriptionHash
     );
     if (!invoice) {
       throw new ValidationError("Failed to create lightning invoice", {
@@ -23762,7 +23771,7 @@ var TokenTransactionService = class {
             const transferInput = finalTokenTransaction.tokenInputs.transferInput;
             for (let i = 0; i < transferInput.outputsToSpend.length; i++) {
               let ownerSignature;
-              if (this.config.shouldSignTokenTransactionsWithSchnorr()) {
+              if (this.config.getTokenSignatures() === "SCHNORR") {
                 ownerSignature = await this.config.signer.signSchnorrWithIdentityKey(
                   payloadHash
                 );
@@ -23951,15 +23960,15 @@ var TokenTransactionService = class {
   }
   // Helper function for deciding if the signer public key is the identity public key
   async signMessageWithKey(message, publicKey) {
-    const signWithSchnorr = this.config.shouldSignTokenTransactionsWithSchnorr();
+    const tokenSignatures = this.config.getTokenSignatures();
     if (bytesToHex9(publicKey) === bytesToHex9(await this.config.signer.getIdentityPublicKey())) {
-      if (signWithSchnorr) {
+      if (tokenSignatures === "SCHNORR") {
         return await this.config.signer.signSchnorrWithIdentityKey(message);
       } else {
         return await this.config.signer.signMessageWithIdentityKey(message);
       }
     } else {
-      if (signWithSchnorr) {
+      if (tokenSignatures === "SCHNORR") {
         return await this.config.signer.signSchnorr(message, publicKey);
       } else {
         return await this.config.signer.signMessageWithPublicKey(
@@ -25766,6 +25775,7 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
       transactionId,
       outputIndex,
       network.toLowerCase(),
+      0 /* Fixed */,
       creditAmountSats,
       sspSignature
     );
@@ -25786,7 +25796,131 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
     }
     return response;
   }
-  async getStaticDepositSigningPayload(transactionID, outputIndex, network, creditAmountSats, sspSignature) {
+  /**
+   * Refunds a static deposit to a destination address.
+   *
+   * @param {string} depositTransactionId - The ID of the transaction
+   * @param {number} [outputIndex] - The index of the output
+   * @param {string} destinationAddress - The destination address
+   * @param {number} fee - The fee to refund
+   * @returns {Promise<string>} The hex of the refund transaction
+   */
+  async refundStaticDeposit({
+    depositTransactionId,
+    outputIndex,
+    destinationAddress,
+    fee
+  }) {
+    if (fee <= 300) {
+      throw new ValidationError("Fee must be greater than 300", {
+        field: "fee",
+        value: fee
+      });
+    }
+    let network = this.config.getNetwork();
+    let networkType = this.config.getNetworkProto();
+    const networkJSON = networkToJSON(networkType);
+    const depositTx = await this.getDepositTransaction(depositTransactionId);
+    if (outputIndex === void 0) {
+      outputIndex = await this.getDepositTransactionVout(depositTransactionId);
+    }
+    const totalAmount = depositTx.getOutput(outputIndex).amount;
+    const creditAmountSats = Number(totalAmount) - fee;
+    if (creditAmountSats <= 0) {
+      throw new ValidationError(
+        "Fee too large. Credit amount must be greater than 0",
+        {
+          field: "creditAmountSats",
+          value: creditAmountSats
+        }
+      );
+    }
+    const tx = new Transaction9();
+    tx.addInput({
+      txid: depositTransactionId,
+      index: outputIndex,
+      witnessScript: new Uint8Array()
+    });
+    const addressDecoded = Address6(getNetwork(network)).decode(
+      destinationAddress
+    );
+    const outputScript = OutScript5.encode(addressDecoded);
+    tx.addOutput({
+      script: outputScript,
+      amount: BigInt(creditAmountSats)
+    });
+    const spendTxSighash = getSigHashFromTx(
+      tx,
+      0,
+      depositTx.getOutput(outputIndex)
+    );
+    const signingNonceCommitment = await this.config.signer.getRandomSigningCommitment();
+    const signingJob = {
+      rawTx: tx.toBytes(),
+      signingPublicKey: await this.config.signer.getStaticDepositSigningKey(0),
+      signingNonceCommitment
+    };
+    const message = await this.getStaticDepositSigningPayload(
+      depositTransactionId,
+      outputIndex,
+      networkJSON.toLowerCase(),
+      2 /* Refund */,
+      creditAmountSats,
+      bytesToHex12(spendTxSighash)
+    );
+    const hashBuffer = sha25613(message);
+    const swapResponseUserSignature = await this.config.signer.signMessageWithIdentityKey(hashBuffer);
+    const sparkClient = await this.connectionManager.createSparkClient(
+      this.config.getCoordinatorAddress()
+    );
+    const transferId = uuidv74();
+    const swapResponse = await sparkClient.initiate_utxo_swap({
+      onChainUtxo: {
+        txid: hexToBytes13(depositTransactionId),
+        vout: outputIndex,
+        network: networkType
+      },
+      requestType: 2 /* Refund */,
+      amount: {
+        creditAmountSats: 0,
+        $case: "creditAmountSats"
+      },
+      userSignature: swapResponseUserSignature,
+      sspSignature: new Uint8Array(),
+      transfer: {
+        transferId,
+        ownerIdentityPublicKey: await this.config.signer.getIdentityPublicKey(),
+        receiverIdentityPublicKey: await this.config.signer.getIdentityPublicKey()
+      },
+      spendTxSigningJob: signingJob
+    });
+    if (!swapResponse) {
+      throw new Error("Failed to initiate utxo swap");
+    }
+    const userSignature = await this.config.signer.signFrost({
+      message: spendTxSighash,
+      publicKey: swapResponse.depositAddress.verifyingPublicKey,
+      privateAsPubKey: await this.config.signer.getStaticDepositSigningKey(0),
+      selfCommitment: signingNonceCommitment,
+      statechainCommitments: swapResponse.spendTxSigningResult.signingNonceCommitments,
+      verifyingKey: swapResponse.depositAddress.verifyingPublicKey
+    });
+    const signatureResult = await this.config.signer.aggregateFrost({
+      message: spendTxSighash,
+      statechainSignatures: swapResponse.spendTxSigningResult.signatureShares,
+      statechainPublicKeys: swapResponse.spendTxSigningResult.publicKeys,
+      verifyingKey: swapResponse.depositAddress.verifyingPublicKey,
+      statechainCommitments: swapResponse.spendTxSigningResult.signingNonceCommitments,
+      selfCommitment: signingNonceCommitment,
+      publicKey: await this.config.signer.getStaticDepositSigningKey(0),
+      selfSignature: userSignature
+    });
+    tx.updateInput(0, {
+      finalScriptWitness: [signatureResult]
+    });
+    return tx.hex;
+  }
+  async getStaticDepositSigningPayload(transactionID, outputIndex, network, requestType, creditAmountSats, sspSignature) {
     const encoder = new TextEncoder();
     const parts = [];
     parts.push(encoder.encode("claim_static_deposit"));
@@ -25795,8 +25929,22 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
     const outputIndexBuffer = new ArrayBuffer(4);
     new DataView(outputIndexBuffer).setUint32(0, outputIndex, true);
     parts.push(new Uint8Array(outputIndexBuffer));
+    let requestTypeInt;
+    switch (requestType) {
+      case 0 /* Fixed */:
+        requestTypeInt = 0;
+        break;
+      case 1 /* MaxFee */:
+        requestTypeInt = 1;
+        break;
+      case 2 /* Refund */:
+        requestTypeInt = 2;
+        break;
+      default:
+        requestTypeInt = 0;
+    }
     const requestTypeBuffer = new ArrayBuffer(1);
-    new DataView(requestTypeBuffer).setUint8(0, 0);
+    new DataView(requestTypeBuffer).setUint8(0, requestTypeInt);
     parts.push(new Uint8Array(requestTypeBuffer));
     const creditAmountBuffer = new ArrayBuffer(8);
     const creditAmountView = new DataView(creditAmountBuffer);
@@ -25816,6 +25964,31 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
     return payload;
   }
   async getDepositTransactionVout(txid) {
+    const depositTx = await this.getDepositTransaction(txid);
+    const staticDepositAddresses = new Set(
+      await this.queryStaticDepositAddresses()
+    );
+    let vout = -1;
+    for (let i = 0; i < depositTx.outputsLength; i++) {
+      const output = depositTx.getOutput(i);
+      if (!output) {
+        continue;
+      }
+      const parsedScript = OutScript5.decode(output.script);
+      const address2 = Address6(getNetwork(this.config.getNetwork())).encode(
+        parsedScript
+      );
+      if (staticDepositAddresses.has(address2)) {
+        vout = i;
+        break;
+      }
+    }
+    if (vout === -1) {
+      throw new Error("No static deposit address found");
+    }
+    return vout;
+  }
+  async getDepositTransaction(txid) {
     if (!txid) {
       throw new ValidationError("Transaction ID cannot be empty", {
         field: "txid"
@@ -25850,28 +26023,7 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
       });
     }
     const depositTx = getTxFromRawTxHex(txHex);
-    const staticDepositAddresses = new Set(
-      await this.queryStaticDepositAddresses()
-    );
-    let vout = -1;
-    for (let i = 0; i < depositTx.outputsLength; i++) {
-      const output = depositTx.getOutput(i);
-      if (!output) {
-        continue;
-      }
-      const parsedScript = OutScript5.decode(output.script);
-      const address2 = Address6(getNetwork(this.config.getNetwork())).encode(
-        parsedScript
-      );
-      if (staticDepositAddresses.has(address2)) {
-        vout = i;
-        break;
-      }
-    }
-    if (vout === -1) {
-      throw new Error("No static deposit address found");
-    }
-    return vout;
+    return depositTx;
   }
   /**
    * Finalizes a deposit to the wallet.
@@ -26412,6 +26564,7 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
    * @param {number} [params.expirySeconds] - Optional expiry time in seconds
    * @param {boolean} [params.includeSparkAddress] - Optional boolean signalling whether or not to include the spark address in the invoice
    * @param {string} [params.receiverIdentityPubkey] - Optional public key of the wallet receiving the lightning invoice. If not present, the receiver will be the creator of this request.
+   * @param {string} [params.descriptionHash] - Optional 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.
    * @returns {Promise<LightningReceiveRequest>} BOLT11 encoded invoice
    */
   async createLightningInvoice({
@@ -26419,7 +26572,8 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
     memo,
     expirySeconds = 60 * 60 * 24 * 30,
     includeSparkAddress = false,
-    receiverIdentityPubkey
+    receiverIdentityPubkey,
+    descriptionHash
   }) {
     const sspClient = this.getSspClient();
     if (isNaN(amountSats) || amountSats < 0) {
@@ -26457,7 +26611,7 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
         expected: "Memo size within limits"
       });
     }
-    const requestLightningInvoice = async (amountSats2, paymentHash, memo2, receiverIdentityPubkey2) => {
+    const requestLightningInvoice = async (amountSats2, paymentHash, memo2, receiverIdentityPubkey2, descriptionHash2) => {
       const network = this.config.getNetwork();
       let bitcoinNetwork = BitcoinNetwork_default.REGTEST;
       if (network === 0 /* MAINNET */) {
@@ -26472,7 +26626,8 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
         expirySecs: expirySeconds,
         memo: memo2,
         includeSparkAddress,
-        receiverIdentityPubkey: receiverIdentityPubkey2
+        receiverIdentityPubkey: receiverIdentityPubkey2,
+        descriptionHash: descriptionHash2
       });
       if (!invoice2) {
         throw new Error("Failed to create lightning invoice");
@@ -26511,7 +26666,8 @@ var SparkWallet = class _SparkWallet extends EventEmitter {
       amountSats,
       memo,
       invoiceCreator: requestLightningInvoice,
-      receiverIdentityPubkey
+      receiverIdentityPubkey,
+      descriptionHash
     });
     return invoice;
   }

package/dist/services/config.cjs

@@ -1535,6 +1535,10 @@ var DefaultSparkSigner = class {
       HARDENED_OFFSET + idx
     );
     this.staticDepositKeyMap.set(idx, staticDepositKey);
+    this.publicKeyToPrivateKeyMap.set(
+      (0, import_utils4.bytesToHex)(staticDepositKey.publicKey),
+      (0, import_utils4.bytesToHex)(staticDepositKey.privateKey)
+    );
     return staticDepositKey.publicKey;
   }
   async getStaticDepositSigningKey(idx) {
@@ -2052,7 +2056,7 @@ var BASE_CONFIG = {
   frostSignerAddress: getLocalFrostSignerAddress(),
   threshold: 2,
   signingOperators: getLocalSigningOperators(),
-  useTokenTransactionSchnorrSignatures: true,
+  tokenSignatures: "SCHNORR",
   electrsUrl: getElectrsUrl("LOCAL"),
   expectedWithdrawBondSats: 1e4,
   expectedWithdrawRelativeBlockLocktime: 1e3,
@@ -2077,7 +2081,7 @@ var LOCAL_WALLET_CONFIG_SCHNORR = {
 };
 var LOCAL_WALLET_CONFIG_ECDSA = {
   ...LOCAL_WALLET_CONFIG,
-  useTokenTransactionSchnorrSignatures: false,
+  tokenSignatures: "ECDSA",
   threshold: 3
   // 3 for issuance tests.
 };
@@ -2257,8 +2261,8 @@ var WalletConfigService = class {
   getNetworkProto() {
     return NetworkToProto[Network2[this.config.network]];
   }
-  shouldSignTokenTransactionsWithSchnorr() {
-    return this.config.useTokenTransactionSchnorrSignatures;
+  getTokenSignatures() {
+    return this.config.tokenSignatures;
   }
   getElectrsUrl() {
     return this.config.electrsUrl;

package/dist/services/config.d.cts

@@ -1,5 +1,5 @@
 import { HasLrc20WalletApiConfig, LRC20WalletApiConfig } from '@buildonspark/lrc20-sdk';
-import { H as HasSspClientOptions, B as SspClientOptions } from '../RequestLightningSendInput-DmKacsgf.cjs';
+import { H as HasSspClientOptions, B as SspClientOptions } from '../RequestLightningSendInput-BtR12ZlP.cjs';
 import { B as BitcoinNetwork } from '../BitcoinNetwork-TnABML0T.cjs';
 import { S as SparkSigner } from '../signer-DQfFgVNA.cjs';
 import { N as Network, a as NetworkType } from '../network-Dbxfi7Tp.cjs';
@@ -30,7 +30,7 @@ declare class WalletConfigService implements HasLrc20WalletApiConfig, HasSspClie
     getNetwork(): Network;
     getNetworkType(): NetworkType;
     getNetworkProto(): number;
-    shouldSignTokenTransactionsWithSchnorr(): boolean;
+    getTokenSignatures(): "ECDSA" | "SCHNORR";
     getElectrsUrl(): string;
     getSspIdentityPublicKey(): string;
 }

package/dist/services/config.d.ts

@@ -1,5 +1,5 @@
 import { HasLrc20WalletApiConfig, LRC20WalletApiConfig } from '@buildonspark/lrc20-sdk';
-import { H as HasSspClientOptions, B as SspClientOptions } from '../RequestLightningSendInput-BlPkzGp-.js';
+import { H as HasSspClientOptions, B as SspClientOptions } from '../RequestLightningSendInput-Dfx7JYWT.js';
 import { B as BitcoinNetwork } from '../BitcoinNetwork-TnABML0T.js';
 import { S as SparkSigner } from '../signer-Db_TjQFj.js';
 import { N as Network, a as NetworkType } from '../network-Bc-W9qLR.js';
@@ -30,7 +30,7 @@ declare class WalletConfigService implements HasLrc20WalletApiConfig, HasSspClie
     getNetwork(): Network;
     getNetworkType(): NetworkType;
     getNetworkProto(): number;
-    shouldSignTokenTransactionsWithSchnorr(): boolean;
+    getTokenSignatures(): "ECDSA" | "SCHNORR";
     getElectrsUrl(): string;
     getSspIdentityPublicKey(): string;
 }

package/dist/services/config.js

@@ -1,9 +1,9 @@
 import {
   WalletConfigService
-} from "../chunk-R6CHT54Z.js";
-import "../chunk-BIG76NRT.js";
+} from "../chunk-C4URKX6J.js";
+import "../chunk-W7N2ABBH.js";
 import "../chunk-VJTDG4BQ.js";
-import "../chunk-3PRCVHIV.js";
+import "../chunk-ZUVYYR5T.js";
 import "../chunk-7VMYMQLF.js";
 import "../chunk-MGPRLH6Q.js";
 import "../chunk-HMLOC6TE.js";