@buildonspark/spark-sdk 0.1.44 → 0.1.46

package/dist/{chunk-HTMXTJRK.js → chunk-N5VZVCGJ.js}

@@ -1,12 +1,12 @@
-import {
-  isReactNative
-} from "./chunk-UBT6EDVJ.js";
 import {
   generateAdaptorFromSignature,
   getRandomSigningNonce,
   getSigningCommitmentFromNonce,
   subtractPrivateKeys
 } from "./chunk-NSJF5F5O.js";
+import {
+  isReactNative
+} from "./chunk-OFCJFZ4I.js";
 import {
   splitSecretWithProofs
 } from "./chunk-QNNSEJ4P.js";
@@ -46,7 +46,7 @@ var getSparkFrostModule = async () => {
     return void 0;
   }
   if (!sparkFrostModule) {
-    sparkFrostModule = await import("./wasm-7OWFHDMS.js");
+    sparkFrostModule = await import("./spark_bindings/wasm/index.js");
   }
   return sparkFrostModule;
 };

package/dist/{chunk-SQKXGAIR.js → chunk-NTFKFRQ2.js}

@@ -4,7 +4,7 @@ import {
   RevocationSecretWithIndex,
   Timestamp,
   TokenTransaction
-} from "./chunk-4Q2ZDYYU.js";
+} from "./chunk-BGGEVUJK.js";
 
 // src/proto/lrc20.ts
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";

package/dist/{chunk-K4BJARWM.js → chunk-OBFKIEMP.js}

@@ -2,7 +2,7 @@ import {
   Network,
   TransferStatus,
   TransferType
-} from "./chunk-4Q2ZDYYU.js";
+} from "./chunk-BGGEVUJK.js";
 
 // src/types/sdk-types.ts
 import { bytesToHex } from "@noble/curves/abstract/utils";

package/dist/{chunk-UBT6EDVJ.js → chunk-OFCJFZ4I.js}

@@ -2,7 +2,7 @@
 import { isNode } from "@lightsparkdev/core";
 var isReactNative = typeof navigator !== "undefined" && navigator.product === "ReactNative";
 var isBun = globalThis.Bun !== void 0;
-var packageVersion = true ? "0.1.44" : "unknown";
+var packageVersion = true ? "0.1.46" : "unknown";
 var baseEnvStr = "unknown";
 if (isBun) {
   const bunVersion = "version" in globalThis.Bun ? globalThis.Bun.version : "unknown-version";

package/dist/{chunk-XX4RRWOX.js → chunk-UXDODSDT.js}

@@ -1,6 +1,3 @@
-import {
-  encodeSparkAddress
-} from "./chunk-KEKGSH7B.js";
 import {
   getNetwork,
   getNetworkFromAddress
@@ -8,16 +5,19 @@ import {
 import {
   ELECTRS_CREDENTIALS,
   getElectrsUrl
-} from "./chunk-EKFD62HN.js";
+} from "./chunk-4EMV7HHW.js";
+import {
+  encodeSparkAddress
+} from "./chunk-KMUMFYFX.js";
+import {
+  ValidationError
+} from "./chunk-GSI4OLXZ.js";
 import {
   BitcoinNetwork_default
 } from "./chunk-HMLOC6TE.js";
 import {
   TreeNode
-} from "./chunk-4Q2ZDYYU.js";
-import {
-  ValidationError
-} from "./chunk-GSI4OLXZ.js";
+} from "./chunk-BGGEVUJK.js";
 import {
   Buffer
 } from "./chunk-MVRQ5US7.js";
@@ -306,10 +306,8 @@ function checkIfValidSequence(currSequence) {
   }
 }
 function getNextTransactionSequence(currSequence, forRefresh) {
-  checkIfValidSequence(currSequence);
   const currentTimelock = getCurrentTimelock(currSequence);
   const nextTimelock = currentTimelock - TIME_LOCK_INTERVAL;
-  checkIfValidSequence(nextTimelock);
   if (forRefresh && nextTimelock <= 100 && currentTimelock > 0) {
     return {
       nextSequence: 1 << 30 | nextTimelock,

package/dist/graphql/objects/index.d.cts

@@ -1,13 +1,14 @@
 import { B as BitcoinNetwork } from '../../BitcoinNetwork-TnABML0T.cjs';
 import { Query } from '@lightsparkdev/core';
-import { k as CurrencyAmount, P as PageInfo, K as SspClient } from '../../RequestLightningSendInput-BxbCtwpV.cjs';
-export { C as ClaimStaticDepositOutput, a as CompleteCoopExitInput, b as CompleteLeavesSwapInput, c as CoopExitFeeEstimate, d as CoopExitFeeEstimatesInput, e as CoopExitFeeEstimatesOutput, f as CoopExitFeeQuote, h as CoopExitFeeQuoteInput, i as CoopExitRequest, l as CurrencyUnit, E as ExitSpeed, G as GetChallengeOutput, I as Invoice, L as Leaf, m as LeavesSwapFeeEstimateOutput, o as LeavesSwapRequest, q as LightningReceiveRequest, r as LightningReceiveRequestStatus, s as LightningSendFeeEstimateOutput, u as LightningSendRequest, v as LightningSendRequestStatus, R as RequestCoopExitInput, w as RequestLeavesSwapInput, x as RequestLightningReceiveInput, y as RequestLightningSendInput, S as SparkCoopExitRequestStatus, z as SparkLeavesSwapRequestStatus, A as SparkTransferToLeavesConnection, B as StaticDepositQuoteInput, D as StaticDepositQuoteOutput, F as SwapLeaf, T as Transfer, U as UserLeafInput, V as VerifyChallengeOutput, g as getCoopExitFeeQuoteQuery, j as getCoopExitRequestQuery, n as getLeavesSwapRequestQuery, p as getLightningReceiveRequestQuery, t as getLightningSendRequestQuery } from '../../RequestLightningSendInput-BxbCtwpV.cjs';
+import { k as CurrencyAmount, P as PageInfo, K as SspClient } from '../../RequestLightningSendInput-2cSh_In4.cjs';
+export { C as ClaimStaticDepositOutput, a as CompleteCoopExitInput, b as CompleteLeavesSwapInput, c as CoopExitFeeEstimate, d as CoopExitFeeEstimatesInput, e as CoopExitFeeEstimatesOutput, f as CoopExitFeeQuote, h as CoopExitFeeQuoteInput, i as CoopExitRequest, l as CurrencyUnit, E as ExitSpeed, G as GetChallengeOutput, I as Invoice, L as Leaf, m as LeavesSwapFeeEstimateOutput, o as LeavesSwapRequest, q as LightningReceiveRequest, r as LightningReceiveRequestStatus, s as LightningSendFeeEstimateOutput, u as LightningSendRequest, v as LightningSendRequestStatus, R as RequestCoopExitInput, w as RequestLeavesSwapInput, x as RequestLightningReceiveInput, y as RequestLightningSendInput, S as SparkCoopExitRequestStatus, z as SparkLeavesSwapRequestStatus, A as SparkTransferToLeavesConnection, B as StaticDepositQuoteInput, D as StaticDepositQuoteOutput, F as SwapLeaf, T as Transfer, U as UserLeafInput, V as VerifyChallengeOutput, g as getCoopExitFeeQuoteQuery, j as getCoopExitRequestQuery, n as getLeavesSwapRequestQuery, p as getLightningReceiveRequestQuery, t as getLightningSendRequestQuery } from '../../RequestLightningSendInput-2cSh_In4.cjs';
 export { L as LightningSendFeeEstimateInput } from '../../LightningSendFeeEstimateInput-BgOhEAI-.cjs';
-import '../../signer-DaY8c60s.cjs';
+import '../../signer-BP6F__oR.cjs';
 import '@scure/bip32';
-import '../../spark-C4ZrsgjC.cjs';
+import '../../spark-DbzGfse6.cjs';
 import '@bufbuild/protobuf/wire';
 import 'nice-grpc-common';
+import '../../types-C-Rp0Oo7.cjs';
 import '@buildonspark/lrc20-sdk';
 import '@scure/btc-signer';
 import 'bitcoinjs-lib';

package/dist/graphql/objects/index.d.ts

@@ -1,13 +1,14 @@
 import { B as BitcoinNetwork } from '../../BitcoinNetwork-TnABML0T.js';
 import { Query } from '@lightsparkdev/core';
-import { k as CurrencyAmount, P as PageInfo, K as SspClient } from '../../RequestLightningSendInput-RGel43ks.js';
-export { C as ClaimStaticDepositOutput, a as CompleteCoopExitInput, b as CompleteLeavesSwapInput, c as CoopExitFeeEstimate, d as CoopExitFeeEstimatesInput, e as CoopExitFeeEstimatesOutput, f as CoopExitFeeQuote, h as CoopExitFeeQuoteInput, i as CoopExitRequest, l as CurrencyUnit, E as ExitSpeed, G as GetChallengeOutput, I as Invoice, L as Leaf, m as LeavesSwapFeeEstimateOutput, o as LeavesSwapRequest, q as LightningReceiveRequest, r as LightningReceiveRequestStatus, s as LightningSendFeeEstimateOutput, u as LightningSendRequest, v as LightningSendRequestStatus, R as RequestCoopExitInput, w as RequestLeavesSwapInput, x as RequestLightningReceiveInput, y as RequestLightningSendInput, S as SparkCoopExitRequestStatus, z as SparkLeavesSwapRequestStatus, A as SparkTransferToLeavesConnection, B as StaticDepositQuoteInput, D as StaticDepositQuoteOutput, F as SwapLeaf, T as Transfer, U as UserLeafInput, V as VerifyChallengeOutput, g as getCoopExitFeeQuoteQuery, j as getCoopExitRequestQuery, n as getLeavesSwapRequestQuery, p as getLightningReceiveRequestQuery, t as getLightningSendRequestQuery } from '../../RequestLightningSendInput-RGel43ks.js';
+import { k as CurrencyAmount, P as PageInfo, K as SspClient } from '../../RequestLightningSendInput-CN6BNg_g.js';
+export { C as ClaimStaticDepositOutput, a as CompleteCoopExitInput, b as CompleteLeavesSwapInput, c as CoopExitFeeEstimate, d as CoopExitFeeEstimatesInput, e as CoopExitFeeEstimatesOutput, f as CoopExitFeeQuote, h as CoopExitFeeQuoteInput, i as CoopExitRequest, l as CurrencyUnit, E as ExitSpeed, G as GetChallengeOutput, I as Invoice, L as Leaf, m as LeavesSwapFeeEstimateOutput, o as LeavesSwapRequest, q as LightningReceiveRequest, r as LightningReceiveRequestStatus, s as LightningSendFeeEstimateOutput, u as LightningSendRequest, v as LightningSendRequestStatus, R as RequestCoopExitInput, w as RequestLeavesSwapInput, x as RequestLightningReceiveInput, y as RequestLightningSendInput, S as SparkCoopExitRequestStatus, z as SparkLeavesSwapRequestStatus, A as SparkTransferToLeavesConnection, B as StaticDepositQuoteInput, D as StaticDepositQuoteOutput, F as SwapLeaf, T as Transfer, U as UserLeafInput, V as VerifyChallengeOutput, g as getCoopExitFeeQuoteQuery, j as getCoopExitRequestQuery, n as getLeavesSwapRequestQuery, p as getLightningReceiveRequestQuery, t as getLightningSendRequestQuery } from '../../RequestLightningSendInput-CN6BNg_g.js';
 export { L as LightningSendFeeEstimateInput } from '../../LightningSendFeeEstimateInput-BgOhEAI-.js';
-import '../../signer-D7vfYik9.js';
+import '../../signer-BVZJXcq7.js';
 import '@scure/bip32';
-import '../../spark-C4ZrsgjC.js';
+import '../../spark-DbzGfse6.js';
 import '@bufbuild/protobuf/wire';
 import 'nice-grpc-common';
+import '../../types-C-Rp0Oo7.js';
 import '@buildonspark/lrc20-sdk';
 import '@scure/btc-signer';
 import 'bitcoinjs-lib';

package/dist/index-CKL5DodV.d.cts

@@ -0,0 +1,214 @@
+import * as btc from '@scure/btc-signer';
+import { Transaction } from '@scure/btc-signer';
+import { TransactionOutput, TransactionInput } from '@scure/btc-signer/psbt';
+import { N as Network } from './network-Css46DAz.cjs';
+import { S as SparkSigner, i as SigningNonce, h as SigningCommitment } from './signer-BP6F__oR.cjs';
+import { j as OutputWithPreviousTransactionData, k as TransferPackage, g as SparkServiceClient } from './spark-DbzGfse6.cjs';
+import { ConfigOptions } from './services/wallet-config.cjs';
+import { SparkAddressFormat } from './address/index.cjs';
+
+type HumanReadableTokenIdentifier = `btk1${string}` | `btkrt1${string}` | `btkt1${string}` | `btks1${string}` | `btkl1${string}`;
+
+type CreateLightningInvoiceParams = {
+    amountSats: number;
+    memo?: string;
+    expirySeconds?: number;
+    includeSparkAddress?: boolean;
+    receiverIdentityPubkey?: string;
+    descriptionHash?: string;
+};
+type PayLightningInvoiceParams = {
+    invoice: string;
+    maxFeeSats: number;
+    preferSpark?: boolean;
+    amountSatsToSend?: number;
+};
+type TransferParams = {
+    amountSats: number;
+    receiverSparkAddress: string;
+};
+type DepositParams = {
+    signingPubKey: Uint8Array;
+    verifyingKey: Uint8Array;
+    depositTx: Transaction;
+    vout: number;
+};
+/**
+ * Token metadata containing essential information about a token.
+ * This is the wallet's internal representation with JavaScript-friendly types.
+ *
+ * rawTokenIdentifier: This is the raw binary token identifier - This is used to encode the human readable token identifier.
+ *
+ * tokenPublicKey: This is the hex-encoded public key of the token issuer - Same as issuerPublicKey.
+ *
+ * @example
+ * ```typescript
+ * const tokenMetadata: TokenMetadata = {
+ *   rawTokenIdentifier: new Uint8Array([1, 2, 3]),
+ *   tokenPublicKey: "0348fbb...",
+ *   tokenName: "SparkToken",
+ *   tokenTicker: "SPK",
+ *   decimals: 8,
+ *   maxSupply: 1000000n
+ * };
+ * ```
+ */
+type TokenMetadata = {
+    /** Raw binary token identifier - This is used to encode the human readable token identifier */
+    rawTokenIdentifier: Uint8Array;
+    /** Hex-encoded public key of the token issuer - Same as issuerPublicKey */
+    tokenPublicKey: string;
+    /** Human-readable name of the token (e.g., SparkToken)*/
+    tokenName: string;
+    /** Short ticker symbol for the token (e.g., "SPK") */
+    tokenTicker: string;
+    /** Number of decimal places for token amounts */
+    decimals: number;
+    /** Maximum supply of tokens that can ever be minted */
+    maxSupply: bigint;
+};
+type TokenBalanceMap = Map<HumanReadableTokenIdentifier, {
+    balance: bigint;
+    tokenMetadata: TokenMetadata;
+}>;
+type InitWalletResponse = {
+    mnemonic?: string | undefined;
+};
+interface SparkWalletProps {
+    mnemonicOrSeed?: Uint8Array | string;
+    accountNumber?: number;
+    signer?: SparkSigner;
+    options?: ConfigOptions;
+}
+interface SparkWalletEvents {
+    /** Emitted when an incoming transfer is successfully claimed. Includes the transfer ID and new total balance. */
+    "transfer:claimed": (transferId: string, updatedBalance: number) => void;
+    /** Emitted when a deposit is marked as available. Includes the deposit ID and new total balance. */
+    "deposit:confirmed": (depositId: string, updatedBalance: number) => void;
+    /** Emitted when the stream is connected */
+    "stream:connected": () => void;
+    /** Emitted when the stream disconnects and fails to reconnect after max attempts */
+    "stream:disconnected": (reason: string) => void;
+    /** Emitted when attempting to reconnect the stream */
+    "stream:reconnecting": (attempt: number, maxAttempts: number, delayMs: number, error: string) => void;
+}
+
+declare function generateSignatureFromExistingAdaptor(signature: Uint8Array, adaptorPrivateKeyBytes: Uint8Array): Uint8Array;
+declare function generateAdaptorFromSignature(signature: Uint8Array): {
+    adaptorSignature: Uint8Array;
+    adaptorPrivateKey: Uint8Array;
+};
+declare function validateOutboundAdaptorSignature(pubkey: Uint8Array, hash: Uint8Array, signature: Uint8Array, adaptorPubkey: Uint8Array): boolean;
+declare function applyAdaptorToSignature(pubkey: Uint8Array, hash: Uint8Array, signature: Uint8Array, adaptorPrivateKeyBytes: Uint8Array): Uint8Array;
+
+declare function computeTaprootKeyNoScript(pubkey: Uint8Array): Uint8Array;
+declare function getP2TRScriptFromPublicKey(pubKey: Uint8Array, network: Network): Uint8Array;
+declare function getP2TRAddressFromPublicKey(pubKey: Uint8Array, network: Network): string;
+declare function getP2TRAddressFromPkScript(pkScript: Uint8Array, network: Network): string;
+declare function getP2WPKHAddressFromPublicKey(pubKey: Uint8Array, network: Network): string;
+declare function getTxFromRawTxHex(rawTxHex: string): btc.Transaction;
+declare function getTxFromRawTxBytes(rawTxBytes: Uint8Array): btc.Transaction;
+declare function getSigHashFromTx(tx: btc.Transaction, inputIndex: number, prevOutput: TransactionOutput): Uint8Array;
+declare function getTxId(tx: btc.Transaction): string;
+declare function getTxIdNoReverse(tx: btc.Transaction): string;
+
+declare function addPublicKeys(a: Uint8Array, b: Uint8Array): Uint8Array;
+declare function applyAdditiveTweakToPublicKey(pubkey: Uint8Array, tweak: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function subtractPublicKeys(a: Uint8Array, b: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function addPrivateKeys(a: Uint8Array, b: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function subtractPrivateKeys(a: Uint8Array, b: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function sumOfPrivateKeys(keys: Uint8Array[]): Uint8Array<ArrayBufferLike>;
+declare function lastKeyWithTarget(target: Uint8Array, keys: Uint8Array[]): Uint8Array<ArrayBufferLike>;
+
+declare function getLatestDepositTxId(address: string): Promise<string | null>;
+declare function isTxBroadcast(txid: string, baseUrl: string, network?: any): Promise<boolean>;
+
+declare function proofOfPossessionMessageHashForDepositAddress(userPubkey: Uint8Array, operatorPubkey: Uint8Array, depositAddress: string): Uint8Array;
+
+declare function collectResponses<T>(responses: PromiseSettledResult<T>[]): T[];
+
+declare function getRandomSigningNonce(): SigningNonce;
+declare function createSigningNonce(binding: Uint8Array, hiding: Uint8Array): SigningNonce;
+declare function getSigningCommitmentFromNonce(nonce: SigningNonce): SigningCommitment;
+declare function encodeSigningNonceToBytes(nonce: SigningNonce): Uint8Array;
+declare function decodeBytesToSigningNonce(bytes: Uint8Array): SigningNonce;
+declare function createSigningCommitment(binding: Uint8Array, hiding: Uint8Array): SigningCommitment;
+declare function encodeSigningCommitmentToBytes(commitment: SigningCommitment): Uint8Array;
+declare function decodeBytesToSigningCommitment(bytes: Uint8Array): SigningCommitment;
+
+declare function calculateAvailableTokenAmount(outputLeaves: OutputWithPreviousTransactionData[]): bigint;
+declare function checkIfSelectedOutputsAreAvailable(selectedOutputs: OutputWithPreviousTransactionData[], tokenOutputs: Map<string, OutputWithPreviousTransactionData[]>, tokenPublicKey: Uint8Array): boolean;
+declare function filterTokenBalanceForTokenPublicKey(tokenBalances: TokenBalanceMap, publicKey: string): {
+    balance: bigint;
+};
+
+declare function getTransferPackageSigningPayload(transferID: string, transferPackage: TransferPackage): Uint8Array;
+
+declare const DEFAULT_FEE_SATS: number;
+/**
+ * Subtracts the default fee from the amount if it's greater than the fee.
+ * Returns the original amount if it's less than or equal to the fee.
+ */
+declare function maybeApplyFee(amount: bigint): bigint;
+declare function createRefundTx(sequence: number, nodeOutPoint: TransactionInput, amountSats: bigint, receivingPubkey: Uint8Array, network: Network): Transaction;
+declare function getCurrentTimelock(currSequence?: number): number;
+declare function getTransactionSequence(currSequence?: number): number;
+declare function checkIfValidSequence(currSequence?: number): void;
+declare function getNextTransactionSequence(currSequence?: number, forRefresh?: boolean): {
+    nextSequence: number;
+    needRefresh: boolean;
+};
+declare function getEphemeralAnchorOutput(): TransactionOutput;
+
+interface LeafInfo {
+    leafId: string;
+    nodeTx: string;
+    refundTx: string;
+}
+interface Utxo {
+    txid: string;
+    vout: number;
+    value: bigint;
+    script: string;
+    publicKey: string;
+}
+interface FeeRate {
+    satPerVbyte: number;
+}
+interface FeeBumpTxPackage {
+    tx: string;
+    feeBumpPsbt?: string;
+}
+interface FeeBumpTxChain {
+    leafId: string;
+    txPackages: FeeBumpTxPackage[];
+}
+interface TxChain {
+    leafId: string;
+    transactions: string[];
+}
+interface BroadcastConfig {
+    bitcoinCoreRpcUrl?: string;
+    rpcUsername?: string;
+    rpcPassword?: string;
+    autoBroadcast?: boolean;
+    network?: "MAINNET" | "REGTEST" | "TESTNET" | "SIGNET" | "LOCAL";
+}
+interface BroadcastResult {
+    success: boolean;
+    txids?: string[];
+    error?: string;
+    broadcastedPackages?: number;
+}
+declare function isEphemeralAnchorOutput(script?: Uint8Array, amount?: bigint): boolean;
+declare function constructUnilateralExitTxs(nodeHexStrings: string[], sparkClient?: SparkServiceClient, network?: any): Promise<TxChain[]>;
+declare function constructUnilateralExitFeeBumpPackages(nodeHexStrings: string[], utxos: Utxo[], feeRate: FeeRate, electrsUrl: string, sparkClient?: SparkServiceClient, network?: any): Promise<FeeBumpTxChain[]>;
+declare function constructFeeBumpTx(txHex: string, utxos: Utxo[], feeRate: FeeRate, previousFeeBumpTx?: string): {
+    feeBumpPsbt: string;
+    usedUtxos: Utxo[];
+    correctedParentTx?: string;
+};
+
+declare function getSparkAddressFromTaproot(taprootAddress: string): SparkAddressFormat;
+
+export { getEphemeralAnchorOutput as $, proofOfPossessionMessageHashForDepositAddress as A, collectResponses as B, type CreateLightningInvoiceParams as C, type DepositParams as D, getRandomSigningNonce as E, createSigningNonce as F, getSigningCommitmentFromNonce as G, encodeSigningNonceToBytes as H, type InitWalletResponse as I, decodeBytesToSigningNonce as J, createSigningCommitment as K, encodeSigningCommitmentToBytes as L, decodeBytesToSigningCommitment as M, calculateAvailableTokenAmount as N, checkIfSelectedOutputsAreAvailable as O, type PayLightningInvoiceParams as P, filterTokenBalanceForTokenPublicKey as Q, getTransferPackageSigningPayload as R, type SparkWalletProps as S, type TransferParams as T, DEFAULT_FEE_SATS as U, maybeApplyFee as V, createRefundTx as W, getCurrentTimelock as X, getTransactionSequence as Y, checkIfValidSequence as Z, getNextTransactionSequence as _, type TokenMetadata as a, type LeafInfo as a0, type Utxo as a1, type FeeRate as a2, type FeeBumpTxPackage as a3, type FeeBumpTxChain as a4, type TxChain as a5, type BroadcastConfig as a6, type BroadcastResult as a7, isEphemeralAnchorOutput as a8, constructUnilateralExitTxs as a9, constructUnilateralExitFeeBumpPackages as aa, constructFeeBumpTx as ab, getSparkAddressFromTaproot as ac, type TokenBalanceMap as b, type SparkWalletEvents as c, generateAdaptorFromSignature as d, applyAdaptorToSignature as e, computeTaprootKeyNoScript as f, generateSignatureFromExistingAdaptor as g, getP2TRScriptFromPublicKey as h, getP2TRAddressFromPublicKey as i, getP2TRAddressFromPkScript as j, getP2WPKHAddressFromPublicKey as k, getTxFromRawTxHex as l, getTxFromRawTxBytes as m, getSigHashFromTx as n, getTxId as o, getTxIdNoReverse as p, addPublicKeys as q, applyAdditiveTweakToPublicKey as r, subtractPublicKeys as s, addPrivateKeys as t, subtractPrivateKeys as u, validateOutboundAdaptorSignature as v, sumOfPrivateKeys as w, lastKeyWithTarget as x, getLatestDepositTxId as y, isTxBroadcast as z };

package/dist/index-COm59SPw.d.ts

@@ -0,0 +1,214 @@
+import * as btc from '@scure/btc-signer';
+import { Transaction } from '@scure/btc-signer';
+import { TransactionOutput, TransactionInput } from '@scure/btc-signer/psbt';
+import { N as Network } from './network-hynb7iTZ.js';
+import { S as SparkSigner, i as SigningNonce, h as SigningCommitment } from './signer-BVZJXcq7.js';
+import { j as OutputWithPreviousTransactionData, k as TransferPackage, g as SparkServiceClient } from './spark-DbzGfse6.js';
+import { ConfigOptions } from './services/wallet-config.js';
+import { SparkAddressFormat } from './address/index.js';
+
+type HumanReadableTokenIdentifier = `btk1${string}` | `btkrt1${string}` | `btkt1${string}` | `btks1${string}` | `btkl1${string}`;
+
+type CreateLightningInvoiceParams = {
+    amountSats: number;
+    memo?: string;
+    expirySeconds?: number;
+    includeSparkAddress?: boolean;
+    receiverIdentityPubkey?: string;
+    descriptionHash?: string;
+};
+type PayLightningInvoiceParams = {
+    invoice: string;
+    maxFeeSats: number;
+    preferSpark?: boolean;
+    amountSatsToSend?: number;
+};
+type TransferParams = {
+    amountSats: number;
+    receiverSparkAddress: string;
+};
+type DepositParams = {
+    signingPubKey: Uint8Array;
+    verifyingKey: Uint8Array;
+    depositTx: Transaction;
+    vout: number;
+};
+/**
+ * Token metadata containing essential information about a token.
+ * This is the wallet's internal representation with JavaScript-friendly types.
+ *
+ * rawTokenIdentifier: This is the raw binary token identifier - This is used to encode the human readable token identifier.
+ *
+ * tokenPublicKey: This is the hex-encoded public key of the token issuer - Same as issuerPublicKey.
+ *
+ * @example
+ * ```typescript
+ * const tokenMetadata: TokenMetadata = {
+ *   rawTokenIdentifier: new Uint8Array([1, 2, 3]),
+ *   tokenPublicKey: "0348fbb...",
+ *   tokenName: "SparkToken",
+ *   tokenTicker: "SPK",
+ *   decimals: 8,
+ *   maxSupply: 1000000n
+ * };
+ * ```
+ */
+type TokenMetadata = {
+    /** Raw binary token identifier - This is used to encode the human readable token identifier */
+    rawTokenIdentifier: Uint8Array;
+    /** Hex-encoded public key of the token issuer - Same as issuerPublicKey */
+    tokenPublicKey: string;
+    /** Human-readable name of the token (e.g., SparkToken)*/
+    tokenName: string;
+    /** Short ticker symbol for the token (e.g., "SPK") */
+    tokenTicker: string;
+    /** Number of decimal places for token amounts */
+    decimals: number;
+    /** Maximum supply of tokens that can ever be minted */
+    maxSupply: bigint;
+};
+type TokenBalanceMap = Map<HumanReadableTokenIdentifier, {
+    balance: bigint;
+    tokenMetadata: TokenMetadata;
+}>;
+type InitWalletResponse = {
+    mnemonic?: string | undefined;
+};
+interface SparkWalletProps {
+    mnemonicOrSeed?: Uint8Array | string;
+    accountNumber?: number;
+    signer?: SparkSigner;
+    options?: ConfigOptions;
+}
+interface SparkWalletEvents {
+    /** Emitted when an incoming transfer is successfully claimed. Includes the transfer ID and new total balance. */
+    "transfer:claimed": (transferId: string, updatedBalance: number) => void;
+    /** Emitted when a deposit is marked as available. Includes the deposit ID and new total balance. */
+    "deposit:confirmed": (depositId: string, updatedBalance: number) => void;
+    /** Emitted when the stream is connected */
+    "stream:connected": () => void;
+    /** Emitted when the stream disconnects and fails to reconnect after max attempts */
+    "stream:disconnected": (reason: string) => void;
+    /** Emitted when attempting to reconnect the stream */
+    "stream:reconnecting": (attempt: number, maxAttempts: number, delayMs: number, error: string) => void;
+}
+
+declare function generateSignatureFromExistingAdaptor(signature: Uint8Array, adaptorPrivateKeyBytes: Uint8Array): Uint8Array;
+declare function generateAdaptorFromSignature(signature: Uint8Array): {
+    adaptorSignature: Uint8Array;
+    adaptorPrivateKey: Uint8Array;
+};
+declare function validateOutboundAdaptorSignature(pubkey: Uint8Array, hash: Uint8Array, signature: Uint8Array, adaptorPubkey: Uint8Array): boolean;
+declare function applyAdaptorToSignature(pubkey: Uint8Array, hash: Uint8Array, signature: Uint8Array, adaptorPrivateKeyBytes: Uint8Array): Uint8Array;
+
+declare function computeTaprootKeyNoScript(pubkey: Uint8Array): Uint8Array;
+declare function getP2TRScriptFromPublicKey(pubKey: Uint8Array, network: Network): Uint8Array;
+declare function getP2TRAddressFromPublicKey(pubKey: Uint8Array, network: Network): string;
+declare function getP2TRAddressFromPkScript(pkScript: Uint8Array, network: Network): string;
+declare function getP2WPKHAddressFromPublicKey(pubKey: Uint8Array, network: Network): string;
+declare function getTxFromRawTxHex(rawTxHex: string): btc.Transaction;
+declare function getTxFromRawTxBytes(rawTxBytes: Uint8Array): btc.Transaction;
+declare function getSigHashFromTx(tx: btc.Transaction, inputIndex: number, prevOutput: TransactionOutput): Uint8Array;
+declare function getTxId(tx: btc.Transaction): string;
+declare function getTxIdNoReverse(tx: btc.Transaction): string;
+
+declare function addPublicKeys(a: Uint8Array, b: Uint8Array): Uint8Array;
+declare function applyAdditiveTweakToPublicKey(pubkey: Uint8Array, tweak: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function subtractPublicKeys(a: Uint8Array, b: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function addPrivateKeys(a: Uint8Array, b: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function subtractPrivateKeys(a: Uint8Array, b: Uint8Array): Uint8Array<ArrayBufferLike>;
+declare function sumOfPrivateKeys(keys: Uint8Array[]): Uint8Array<ArrayBufferLike>;
+declare function lastKeyWithTarget(target: Uint8Array, keys: Uint8Array[]): Uint8Array<ArrayBufferLike>;
+
+declare function getLatestDepositTxId(address: string): Promise<string | null>;
+declare function isTxBroadcast(txid: string, baseUrl: string, network?: any): Promise<boolean>;
+
+declare function proofOfPossessionMessageHashForDepositAddress(userPubkey: Uint8Array, operatorPubkey: Uint8Array, depositAddress: string): Uint8Array;
+
+declare function collectResponses<T>(responses: PromiseSettledResult<T>[]): T[];
+
+declare function getRandomSigningNonce(): SigningNonce;
+declare function createSigningNonce(binding: Uint8Array, hiding: Uint8Array): SigningNonce;
+declare function getSigningCommitmentFromNonce(nonce: SigningNonce): SigningCommitment;
+declare function encodeSigningNonceToBytes(nonce: SigningNonce): Uint8Array;
+declare function decodeBytesToSigningNonce(bytes: Uint8Array): SigningNonce;
+declare function createSigningCommitment(binding: Uint8Array, hiding: Uint8Array): SigningCommitment;
+declare function encodeSigningCommitmentToBytes(commitment: SigningCommitment): Uint8Array;
+declare function decodeBytesToSigningCommitment(bytes: Uint8Array): SigningCommitment;
+
+declare function calculateAvailableTokenAmount(outputLeaves: OutputWithPreviousTransactionData[]): bigint;
+declare function checkIfSelectedOutputsAreAvailable(selectedOutputs: OutputWithPreviousTransactionData[], tokenOutputs: Map<string, OutputWithPreviousTransactionData[]>, tokenPublicKey: Uint8Array): boolean;
+declare function filterTokenBalanceForTokenPublicKey(tokenBalances: TokenBalanceMap, publicKey: string): {
+    balance: bigint;
+};
+
+declare function getTransferPackageSigningPayload(transferID: string, transferPackage: TransferPackage): Uint8Array;
+
+declare const DEFAULT_FEE_SATS: number;
+/**
+ * Subtracts the default fee from the amount if it's greater than the fee.
+ * Returns the original amount if it's less than or equal to the fee.
+ */
+declare function maybeApplyFee(amount: bigint): bigint;
+declare function createRefundTx(sequence: number, nodeOutPoint: TransactionInput, amountSats: bigint, receivingPubkey: Uint8Array, network: Network): Transaction;
+declare function getCurrentTimelock(currSequence?: number): number;
+declare function getTransactionSequence(currSequence?: number): number;
+declare function checkIfValidSequence(currSequence?: number): void;
+declare function getNextTransactionSequence(currSequence?: number, forRefresh?: boolean): {
+    nextSequence: number;
+    needRefresh: boolean;
+};
+declare function getEphemeralAnchorOutput(): TransactionOutput;
+
+interface LeafInfo {
+    leafId: string;
+    nodeTx: string;
+    refundTx: string;
+}
+interface Utxo {
+    txid: string;
+    vout: number;
+    value: bigint;
+    script: string;
+    publicKey: string;
+}
+interface FeeRate {
+    satPerVbyte: number;
+}
+interface FeeBumpTxPackage {
+    tx: string;
+    feeBumpPsbt?: string;
+}
+interface FeeBumpTxChain {
+    leafId: string;
+    txPackages: FeeBumpTxPackage[];
+}
+interface TxChain {
+    leafId: string;
+    transactions: string[];
+}
+interface BroadcastConfig {
+    bitcoinCoreRpcUrl?: string;
+    rpcUsername?: string;
+    rpcPassword?: string;
+    autoBroadcast?: boolean;
+    network?: "MAINNET" | "REGTEST" | "TESTNET" | "SIGNET" | "LOCAL";
+}
+interface BroadcastResult {
+    success: boolean;
+    txids?: string[];
+    error?: string;
+    broadcastedPackages?: number;
+}
+declare function isEphemeralAnchorOutput(script?: Uint8Array, amount?: bigint): boolean;
+declare function constructUnilateralExitTxs(nodeHexStrings: string[], sparkClient?: SparkServiceClient, network?: any): Promise<TxChain[]>;
+declare function constructUnilateralExitFeeBumpPackages(nodeHexStrings: string[], utxos: Utxo[], feeRate: FeeRate, electrsUrl: string, sparkClient?: SparkServiceClient, network?: any): Promise<FeeBumpTxChain[]>;
+declare function constructFeeBumpTx(txHex: string, utxos: Utxo[], feeRate: FeeRate, previousFeeBumpTx?: string): {
+    feeBumpPsbt: string;
+    usedUtxos: Utxo[];
+    correctedParentTx?: string;
+};
+
+declare function getSparkAddressFromTaproot(taprootAddress: string): SparkAddressFormat;
+
+export { getEphemeralAnchorOutput as $, proofOfPossessionMessageHashForDepositAddress as A, collectResponses as B, type CreateLightningInvoiceParams as C, type DepositParams as D, getRandomSigningNonce as E, createSigningNonce as F, getSigningCommitmentFromNonce as G, encodeSigningNonceToBytes as H, type InitWalletResponse as I, decodeBytesToSigningNonce as J, createSigningCommitment as K, encodeSigningCommitmentToBytes as L, decodeBytesToSigningCommitment as M, calculateAvailableTokenAmount as N, checkIfSelectedOutputsAreAvailable as O, type PayLightningInvoiceParams as P, filterTokenBalanceForTokenPublicKey as Q, getTransferPackageSigningPayload as R, type SparkWalletProps as S, type TransferParams as T, DEFAULT_FEE_SATS as U, maybeApplyFee as V, createRefundTx as W, getCurrentTimelock as X, getTransactionSequence as Y, checkIfValidSequence as Z, getNextTransactionSequence as _, type TokenMetadata as a, type LeafInfo as a0, type Utxo as a1, type FeeRate as a2, type FeeBumpTxPackage as a3, type FeeBumpTxChain as a4, type TxChain as a5, type BroadcastConfig as a6, type BroadcastResult as a7, isEphemeralAnchorOutput as a8, constructUnilateralExitTxs as a9, constructUnilateralExitFeeBumpPackages as aa, constructFeeBumpTx as ab, getSparkAddressFromTaproot as ac, type TokenBalanceMap as b, type SparkWalletEvents as c, generateAdaptorFromSignature as d, applyAdaptorToSignature as e, computeTaprootKeyNoScript as f, generateSignatureFromExistingAdaptor as g, getP2TRScriptFromPublicKey as h, getP2TRAddressFromPublicKey as i, getP2TRAddressFromPkScript as j, getP2WPKHAddressFromPublicKey as k, getTxFromRawTxHex as l, getTxFromRawTxBytes as m, getSigHashFromTx as n, getTxId as o, getTxIdNoReverse as p, addPublicKeys as q, applyAdditiveTweakToPublicKey as r, subtractPublicKeys as s, addPrivateKeys as t, subtractPrivateKeys as u, validateOutboundAdaptorSignature as v, sumOfPrivateKeys as w, lastKeyWithTarget as x, getLatestDepositTxId as y, isTxBroadcast as z };