@buildonspark/spark-sdk 0.2.2 → 0.2.4

package/dist/index.d.cts

@@ -1,20 +1,201 @@
-export { AuthenticationError, ConfigurationError, InternalValidationError, NetworkError, NotImplementedError, RPCError, SparkSDKError, TokenTransactionService, ValidationError } from './index.node.cjs';
-export { B as Bech32mTokenIdentifier, a as Bech32mTokenIdentifierData, C as ConfigOptions, s as ConnectionManager, u as CreateLightningInvoiceParams, D as DecodedSparkAddressData, w as DepositParams, I as InitWalletResponse, L as LRC_WALLET_NETWORK, b as LRC_WALLET_NETWORK_TYPE, N as Network, c as NetworkToProto, d as NetworkType, P as PayLightningInvoiceParams, R as RawTokenIdentifierHex, S as SparkAddressData, e as SparkAddressFormat, o as SparkWallet, y as SparkWalletEvents, q as SparkWalletProps, r as TokenBalanceMap, x as TokenMetadataMap, T as TokenOutputsMap, v as TransferParams, U as UserTokenMetadata, t as WalletConfig, W as WalletConfigService, f as decodeBech32mTokenIdentifier, g as decodeSparkAddress, h as encodeBech32mTokenIdentifier, i as encodeSparkAddress, j as getNetwork, k as getNetworkFromAddress, l as getNetworkFromString, m as isValidPublicKey, n as isValidSparkAddress, p as protoToNetwork } from './spark-wallet-CHwKQYJu.cjs';
-export { B as BroadcastConfig, a as BroadcastResult, D as DEFAULT_FEE_SATS, F as FeeBumpTxChain, b as FeeBumpTxPackage, c as FeeRate, L as LeafInfo, T as TxChain, U as Utxo, d as addPrivateKeys, e as addPublicKeys, f as applyAdaptorToSignature, g as applyAdditiveTweakToPublicKey, h as checkIfSelectedOutputsAreAvailable, i as checkIfValidSequence, j as collectResponses, k as computeTaprootKeyNoScript, l as constructFeeBumpTx, m as constructUnilateralExitFeeBumpPackages, n as constructUnilateralExitTxs, o as createRefundTx, p as createSigningCommitment, q as createSigningNonce, r as decodeBytesToSigningCommitment, s as decodeBytesToSigningNonce, t as encodeSigningCommitmentToBytes, u as encodeSigningNonceToBytes, v as filterTokenBalanceForTokenPublicKey, w as generateAdaptorFromSignature, x as generateSignatureFromExistingAdaptor, y as getCurrentTimelock, z as getEphemeralAnchorOutput, A as getLatestDepositTxId, C as getNextTransactionSequence, E as getP2TRAddressFromPkScript, G as getP2TRAddressFromPublicKey, H as getP2TRScriptFromPublicKey, I as getP2WPKHAddressFromPublicKey, J as getRandomSigningNonce, K as getSigHashFromTx, M as getSigningCommitmentFromNonce, N as getSparkAddressFromTaproot, O as getTransactionSequence, P as getTransferPackageSigningPayload, Q as getTxFromRawTxBytes, R as getTxFromRawTxHex, S as getTxId, V as getTxIdNoReverse, W as isEphemeralAnchorOutput, X as isTxBroadcast, Y as lastKeyWithTarget, Z as maybeApplyFee, _ as proofOfPossessionMessageHashForDepositAddress, $ as subtractPrivateKeys, a0 as subtractPublicKeys, a1 as sumAvailableTokens, a2 as sumOfPrivateKeys, a3 as validateOutboundAdaptorSignature } from './xchain-address-D5MIHCDL.cjs';
-export { ag as AggregateFrostParams, a2 as DefaultSparkSigner, ai as DerivedHDKey, a6 as KeyDerivation, ae as KeyDerivationType, aj as KeyPair, af as SignFrostParams, a9 as SigningCommitment, a7 as SigningCommitmentWithOptionalNonce, a8 as SigningNonce, a1 as SparkSigner, ah as SplitSecretWithProofsParams, ab as TaprootOutputKeysGenerator, ac as TaprootSparkSigner, ad as UnsafeStatelessSparkSigner, K as VerifiableSecretShare, M as bigIntToPrivateKey, N as computerLagrangeCoefficients, O as evaluatePolynomial, Q as fieldDiv, W as generatePolynomialForSecretSharing, X as getRandomBigInt, Y as modInverse, Z as recoverSecret, _ as splitSecret, $ as splitSecretWithProofs, a0 as validateShare } from './client-CcYzmpmj.cjs';
+import { W as WalletConfigService, C as ConnectionManager, u as TokenOutputsMap, B as Bech32mTokenIdentifier } from './spark-wallet-DG3x2obf.cjs';
+export { n as Bech32mTokenIdentifierData, b as ConfigOptions, r as CreateLightningInvoiceParams, D as DecodedSparkAddressData, s as DepositParams, I as InitWalletResponse, L as LRC_WALLET_NETWORK, k as LRC_WALLET_NETWORK_TYPE, N as Network, h as NetworkToProto, g as NetworkType, P as PayLightningInvoiceParams, R as RawTokenIdentifierHex, c as SparkAddressData, S as SparkAddressFormat, y as SparkWallet, x as SparkWalletEvents, w as SparkWalletProps, t as TokenBalanceMap, v as TokenMetadataMap, T as TransferParams, U as UserTokenMetadata, a as WalletConfig, q as decodeBech32mTokenIdentifier, d as decodeSparkAddress, o as encodeBech32mTokenIdentifier, e as encodeSparkAddress, j as getNetwork, l as getNetworkFromAddress, m as getNetworkFromString, f as isValidPublicKey, i as isValidSparkAddress, p as protoToNetwork } from './spark-wallet-DG3x2obf.cjs';
+export { aa as BroadcastConfig, ab as BroadcastResult, P as DEFAULT_FEE_SATS, L as DIRECT_TIMELOCK_OFFSET, a8 as FeeBumpTxChain, a7 as FeeBumpTxPackage, a6 as FeeRate, N as INITIAL_DIRECT_SEQUENCE, M as INITIAL_SEQUENCE, a4 as LeafInfo, O as TEST_UNILATERAL_DIRECT_SEQUENCE, T as TEST_UNILATERAL_SEQUENCE, a9 as TxChain, a5 as Utxo, p as addPrivateKeys, n as addPublicKeys, b as applyAdaptorToSignature, o as applyAdditiveTweakToPublicKey, I as checkIfSelectedOutputsAreAvailable, a0 as checkIfValidSequence, y as collectResponses, c as computeTaprootKeyNoScript, af as constructFeeBumpTx, ae as constructUnilateralExitFeeBumpPackages, ad as constructUnilateralExitTxs, Z as createConnectorRefundTransactions, W as createLeafNodeTx, U as createNodeTx, V as createNodeTxs, X as createRefundTx, Y as createRefundTxs, R as createRootTx, E as createSigningCommitment, A as createSigningNonce, S as createSplitTx, G as decodeBytesToSigningCommitment, D as decodeBytesToSigningNonce, a1 as doesLeafNeedRefresh, F as encodeSigningCommitmentToBytes, C as encodeSigningNonceToBytes, J as filterTokenBalanceForTokenPublicKey, a as generateAdaptorFromSignature, g as generateSignatureFromExistingAdaptor, _ as getCurrentTimelock, a3 as getEphemeralAnchorOutput, u as getLatestDepositTxId, a2 as getNextTransactionSequence, f as getP2TRAddressFromPkScript, e as getP2TRAddressFromPublicKey, d as getP2TRScriptFromPublicKey, h as getP2WPKHAddressFromPublicKey, z as getRandomSigningNonce, k as getSigHashFromTx, B as getSigningCommitmentFromNonce, ag as getSparkAddressFromTaproot, $ as getTransactionSequence, K as getTransferPackageSigningPayload, j as getTxFromRawTxBytes, i as getTxFromRawTxHex, l as getTxId, m as getTxIdNoReverse, ac as isEphemeralAnchorOutput, w as isTxBroadcast, t as lastKeyWithTarget, Q as maybeApplyFee, x as proofOfPossessionMessageHashForDepositAddress, q as subtractPrivateKeys, s as subtractPublicKeys, H as sumAvailableTokens, r as sumOfPrivateKeys, v as validateOutboundAdaptorSignature } from './xchain-address-HBr6isnc.cjs';
+export { A as AggregateFrostParams, D as DefaultSparkSigner, p as DerivedHDKey, l as KeyDerivation, K as KeyDerivationType, q as KeyPair, n as SignFrostParams, k as SigningCommitment, i as SigningCommitmentWithOptionalNonce, j as SigningNonce, S as SparkSigner, o as SplitSecretWithProofsParams, T as TaprootOutputKeysGenerator, a as TaprootSparkSigner, U as UnsafeStatelessSparkSigner, V as VerifiableSecretShare, h as bigIntToPrivateKey, c as computerLagrangeCoefficients, e as evaluatePolynomial, f as fieldDiv, b as generatePolynomialForSecretSharing, g as getRandomBigInt, m as modInverse, r as recoverSecret, s as splitSecret, d as splitSecretWithProofs, v as validateShare } from './client-KhNkrXz4.cjs';
+import { j as OutputWithPreviousTransactionData, T as TokenTransaction, l as TokenTransactionWithStatus } from './spark-B_7nZx6T.cjs';
+import { TokenTransaction as TokenTransaction$1, TokenTransactionWithStatus as TokenTransactionWithStatus$1 } from './proto/spark_token.cjs';
 export { TokenSigner } from '@buildonspark/lrc20-sdk';
 export { MultisigReceiptInput } from '@buildonspark/lrc20-sdk/lrc/types';
-import './spark-BUOx3U7Q.cjs';
-import '@bufbuild/protobuf/wire';
-import 'nice-grpc-common';
-import './proto/spark_token.cjs';
 import '@scure/btc-signer';
 import 'bitcoinjs-lib';
 import 'nice-grpc';
 import 'nice-grpc-web';
+import '@bufbuild/protobuf/wire';
+import 'nice-grpc-common';
 import 'eventemitter3';
-import './sdk-types-DJ2ve9YY.cjs';
+import './sdk-types-CB9HrW5O.cjs';
 import '@scure/btc-signer/psbt';
 import '@lightsparkdev/core';
 import '@scure/bip32';
 import './types-BADxR3bm.cjs';
+
+declare class SparkSDKError extends Error {
+    readonly context: Record<string, unknown>;
+    readonly originalError?: Error;
+    constructor(message: string, context?: Record<string, unknown>, originalError?: Error);
+    toString(): string;
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * NetworkError should be used for any errors related to network communication,
+ * such as failed HTTP requests, timeouts, or connection issues.
+ * This includes:
+ * - Failed API calls
+ * - Network timeouts
+ * - Connection refused
+ * - DNS resolution failures
+ * - SSL/TLS errors
+ */
+declare class NetworkError extends SparkSDKError {
+    constructor(message: string, context?: {
+        url?: string;
+        method?: string;
+        statusCode?: number;
+        response?: unknown;
+        errorCount?: number;
+        errors?: string;
+        operation?: string;
+        nodeSignaturesCount?: number;
+    }, originalError?: Error);
+}
+/**
+ * ValidationError should be used for any errors related to data validation in regards to the user's input,
+ * This includes:
+ * - Invalid signatures
+ * - Malformed addresses
+ * - Invalid proof of possession
+ * - Invalid cryptographic parameters
+ * - Data format validation failures
+ */
+declare class ValidationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        field?: string;
+        value?: unknown;
+        expected?: unknown;
+        expectedLength?: number;
+        actualLength?: number;
+        rValue?: bigint;
+        fieldPrime?: bigint;
+        sValue?: bigint;
+        groupOrder?: bigint;
+        index?: number;
+        treeLength?: number;
+        addressNodesLength?: number;
+    }, originalError?: Error);
+}
+/**
+ * InternalValidationError should be used for any errors related to internal data validation
+ * that is not related to the user's input.
+ * This includes:
+ * - Invalid SO responses
+ */
+declare class InternalValidationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        field?: string;
+        value?: unknown;
+        expected?: unknown;
+        outputIndex?: number;
+        keyshareInfo?: unknown;
+        signingOperators?: unknown;
+    }, originalError?: Error);
+}
+/**
+ * AuthenticationError should be used specifically for authentication and authorization failures,
+ * such as invalid credentials or insufficient permissions.
+ * This includes:
+ * - Invalid API keys
+ * - Expired tokens
+ * - Insufficient permissions
+ * - Authentication token validation failures
+ * - Authorization failures
+ */
+declare class AuthenticationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        endpoint?: string;
+        reason?: string;
+    }, originalError?: Error);
+}
+/**
+ * RPCError should be used for errors that occur during RPC (Remote Procedure Call) operations,
+ * such as invalid RPC parameters or RPC-specific failures.
+ * This includes:
+ * - Invalid RPC method calls
+ * - RPC parameter validation failures
+ * - RPC-specific error codes
+ * - RPC protocol errors
+ */
+declare class RPCError extends SparkSDKError {
+    constructor(message: string, context?: {
+        method?: string;
+        params?: unknown;
+        code?: number;
+    }, originalError?: Error);
+}
+/**
+ * ConfigurationError should be used for errors related to SDK configuration,
+ * such as missing or invalid configuration values.
+ * This includes:
+ * - Missing required configuration
+ * - Invalid configuration values
+ * - Configuration format errors
+ * - Environment-specific configuration issues
+ */
+declare class ConfigurationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        configKey?: string;
+        value?: unknown;
+    }, originalError?: Error);
+}
+/***
+ * NotImplementedError should be used for any errors related to features that are not yet implemented.
+ */
+declare class NotImplementedError extends SparkSDKError {
+    constructor(message: string, context?: Record<string, unknown>, originalError?: Error);
+}
+
+interface FetchOwnedTokenOutputsParams {
+    ownerPublicKeys: Uint8Array[];
+    issuerPublicKeys?: Uint8Array[];
+    tokenIdentifiers?: Uint8Array[];
+}
+interface QueryTokenTransactionsParams {
+    ownerPublicKeys?: string[];
+    issuerPublicKeys?: string[];
+    tokenTransactionHashes?: string[];
+    tokenIdentifiers?: string[];
+    outputIds?: string[];
+    pageSize: number;
+    offset: number;
+}
+declare class TokenTransactionService {
+    protected readonly config: WalletConfigService;
+    protected readonly connectionManager: ConnectionManager;
+    constructor(config: WalletConfigService, connectionManager: ConnectionManager);
+    tokenTransfer(tokenOutputs: TokenOutputsMap, receiverOutputs: {
+        tokenIdentifier: Bech32mTokenIdentifier;
+        tokenAmount: bigint;
+        receiverSparkAddress: string;
+    }[], outputSelectionStrategy?: "SMALL_FIRST" | "LARGE_FIRST", selectedOutputs?: OutputWithPreviousTransactionData[]): Promise<string>;
+    constructTransferTokenTransactionV0(selectedOutputs: OutputWithPreviousTransactionData[], tokenOutputData: Array<{
+        receiverSparkAddress: Uint8Array;
+        tokenPublicKey: Uint8Array;
+        tokenAmount: bigint;
+    }>): Promise<TokenTransaction>;
+    constructTransferTokenTransaction(selectedOutputs: OutputWithPreviousTransactionData[], tokenOutputData: Array<{
+        receiverSparkAddress: Uint8Array;
+        rawTokenIdentifier: Uint8Array;
+        tokenAmount: bigint;
+    }>): Promise<TokenTransaction$1>;
+    collectOperatorIdentityPublicKeys(): Uint8Array[];
+    broadcastTokenTransaction(tokenTransaction: TokenTransaction | TokenTransaction$1, outputsToSpendSigningPublicKeys?: Uint8Array[], outputsToSpendCommitments?: Uint8Array[]): Promise<string>;
+    private broadcastTokenTransactionV0;
+    private broadcastTokenTransactionV1;
+    private startTokenTransactionV0;
+    private startTokenTransaction;
+    private signTokenTransactionV0;
+    private signTokenTransaction;
+    fetchOwnedTokenOutputs(params: FetchOwnedTokenOutputsParams): Promise<OutputWithPreviousTransactionData[]>;
+    queryTokenTransactions(params: QueryTokenTransactionsParams): Promise<TokenTransactionWithStatus[] | TokenTransactionWithStatus$1[]>;
+    private fetchOwnedTokenOutputsV0;
+    private fetchOwnedTokenOutputsV1;
+    private queryTokenTransactionsV0;
+    private queryTokenTransactionsV1;
+    selectTokenOutputs(tokenOutputs: OutputWithPreviousTransactionData[], tokenAmount: bigint, strategy: "SMALL_FIRST" | "LARGE_FIRST"): OutputWithPreviousTransactionData[];
+    private sortTokenOutputsByStrategy;
+    private signMessageWithKey;
+    private finalizeTokenTransaction;
+    private createSignaturesForOperators;
+}
+
+export { AuthenticationError, Bech32mTokenIdentifier, ConfigurationError, ConnectionManager, InternalValidationError, NetworkError, NotImplementedError, RPCError, SparkSDKError, TokenOutputsMap, TokenTransactionService, ValidationError, WalletConfigService };

package/dist/index.d.ts

@@ -1,20 +1,201 @@
-export { AuthenticationError, ConfigurationError, InternalValidationError, NetworkError, NotImplementedError, RPCError, SparkSDKError, TokenTransactionService, ValidationError } from './index.node.js';
-export { B as Bech32mTokenIdentifier, a as Bech32mTokenIdentifierData, C as ConfigOptions, s as ConnectionManager, u as CreateLightningInvoiceParams, D as DecodedSparkAddressData, w as DepositParams, I as InitWalletResponse, L as LRC_WALLET_NETWORK, b as LRC_WALLET_NETWORK_TYPE, N as Network, c as NetworkToProto, d as NetworkType, P as PayLightningInvoiceParams, R as RawTokenIdentifierHex, S as SparkAddressData, e as SparkAddressFormat, o as SparkWallet, y as SparkWalletEvents, q as SparkWalletProps, r as TokenBalanceMap, x as TokenMetadataMap, T as TokenOutputsMap, v as TransferParams, U as UserTokenMetadata, t as WalletConfig, W as WalletConfigService, f as decodeBech32mTokenIdentifier, g as decodeSparkAddress, h as encodeBech32mTokenIdentifier, i as encodeSparkAddress, j as getNetwork, k as getNetworkFromAddress, l as getNetworkFromString, m as isValidPublicKey, n as isValidSparkAddress, p as protoToNetwork } from './spark-wallet-B_96y9BS.js';
-export { B as BroadcastConfig, a as BroadcastResult, D as DEFAULT_FEE_SATS, F as FeeBumpTxChain, b as FeeBumpTxPackage, c as FeeRate, L as LeafInfo, T as TxChain, U as Utxo, d as addPrivateKeys, e as addPublicKeys, f as applyAdaptorToSignature, g as applyAdditiveTweakToPublicKey, h as checkIfSelectedOutputsAreAvailable, i as checkIfValidSequence, j as collectResponses, k as computeTaprootKeyNoScript, l as constructFeeBumpTx, m as constructUnilateralExitFeeBumpPackages, n as constructUnilateralExitTxs, o as createRefundTx, p as createSigningCommitment, q as createSigningNonce, r as decodeBytesToSigningCommitment, s as decodeBytesToSigningNonce, t as encodeSigningCommitmentToBytes, u as encodeSigningNonceToBytes, v as filterTokenBalanceForTokenPublicKey, w as generateAdaptorFromSignature, x as generateSignatureFromExistingAdaptor, y as getCurrentTimelock, z as getEphemeralAnchorOutput, A as getLatestDepositTxId, C as getNextTransactionSequence, E as getP2TRAddressFromPkScript, G as getP2TRAddressFromPublicKey, H as getP2TRScriptFromPublicKey, I as getP2WPKHAddressFromPublicKey, J as getRandomSigningNonce, K as getSigHashFromTx, M as getSigningCommitmentFromNonce, N as getSparkAddressFromTaproot, O as getTransactionSequence, P as getTransferPackageSigningPayload, Q as getTxFromRawTxBytes, R as getTxFromRawTxHex, S as getTxId, V as getTxIdNoReverse, W as isEphemeralAnchorOutput, X as isTxBroadcast, Y as lastKeyWithTarget, Z as maybeApplyFee, _ as proofOfPossessionMessageHashForDepositAddress, $ as subtractPrivateKeys, a0 as subtractPublicKeys, a1 as sumAvailableTokens, a2 as sumOfPrivateKeys, a3 as validateOutboundAdaptorSignature } from './xchain-address-DLbW1iDh.js';
-export { ag as AggregateFrostParams, a2 as DefaultSparkSigner, ai as DerivedHDKey, a6 as KeyDerivation, ae as KeyDerivationType, aj as KeyPair, af as SignFrostParams, a9 as SigningCommitment, a7 as SigningCommitmentWithOptionalNonce, a8 as SigningNonce, a1 as SparkSigner, ah as SplitSecretWithProofsParams, ab as TaprootOutputKeysGenerator, ac as TaprootSparkSigner, ad as UnsafeStatelessSparkSigner, K as VerifiableSecretShare, M as bigIntToPrivateKey, N as computerLagrangeCoefficients, O as evaluatePolynomial, Q as fieldDiv, W as generatePolynomialForSecretSharing, X as getRandomBigInt, Y as modInverse, Z as recoverSecret, _ as splitSecret, $ as splitSecretWithProofs, a0 as validateShare } from './client-CGTRS23n.js';
+import { W as WalletConfigService, C as ConnectionManager, u as TokenOutputsMap, B as Bech32mTokenIdentifier } from './spark-wallet-C1Tr_VKI.js';
+export { n as Bech32mTokenIdentifierData, b as ConfigOptions, r as CreateLightningInvoiceParams, D as DecodedSparkAddressData, s as DepositParams, I as InitWalletResponse, L as LRC_WALLET_NETWORK, k as LRC_WALLET_NETWORK_TYPE, N as Network, h as NetworkToProto, g as NetworkType, P as PayLightningInvoiceParams, R as RawTokenIdentifierHex, c as SparkAddressData, S as SparkAddressFormat, y as SparkWallet, x as SparkWalletEvents, w as SparkWalletProps, t as TokenBalanceMap, v as TokenMetadataMap, T as TransferParams, U as UserTokenMetadata, a as WalletConfig, q as decodeBech32mTokenIdentifier, d as decodeSparkAddress, o as encodeBech32mTokenIdentifier, e as encodeSparkAddress, j as getNetwork, l as getNetworkFromAddress, m as getNetworkFromString, f as isValidPublicKey, i as isValidSparkAddress, p as protoToNetwork } from './spark-wallet-C1Tr_VKI.js';
+export { aa as BroadcastConfig, ab as BroadcastResult, P as DEFAULT_FEE_SATS, L as DIRECT_TIMELOCK_OFFSET, a8 as FeeBumpTxChain, a7 as FeeBumpTxPackage, a6 as FeeRate, N as INITIAL_DIRECT_SEQUENCE, M as INITIAL_SEQUENCE, a4 as LeafInfo, O as TEST_UNILATERAL_DIRECT_SEQUENCE, T as TEST_UNILATERAL_SEQUENCE, a9 as TxChain, a5 as Utxo, p as addPrivateKeys, n as addPublicKeys, b as applyAdaptorToSignature, o as applyAdditiveTweakToPublicKey, I as checkIfSelectedOutputsAreAvailable, a0 as checkIfValidSequence, y as collectResponses, c as computeTaprootKeyNoScript, af as constructFeeBumpTx, ae as constructUnilateralExitFeeBumpPackages, ad as constructUnilateralExitTxs, Z as createConnectorRefundTransactions, W as createLeafNodeTx, U as createNodeTx, V as createNodeTxs, X as createRefundTx, Y as createRefundTxs, R as createRootTx, E as createSigningCommitment, A as createSigningNonce, S as createSplitTx, G as decodeBytesToSigningCommitment, D as decodeBytesToSigningNonce, a1 as doesLeafNeedRefresh, F as encodeSigningCommitmentToBytes, C as encodeSigningNonceToBytes, J as filterTokenBalanceForTokenPublicKey, a as generateAdaptorFromSignature, g as generateSignatureFromExistingAdaptor, _ as getCurrentTimelock, a3 as getEphemeralAnchorOutput, u as getLatestDepositTxId, a2 as getNextTransactionSequence, f as getP2TRAddressFromPkScript, e as getP2TRAddressFromPublicKey, d as getP2TRScriptFromPublicKey, h as getP2WPKHAddressFromPublicKey, z as getRandomSigningNonce, k as getSigHashFromTx, B as getSigningCommitmentFromNonce, ag as getSparkAddressFromTaproot, $ as getTransactionSequence, K as getTransferPackageSigningPayload, j as getTxFromRawTxBytes, i as getTxFromRawTxHex, l as getTxId, m as getTxIdNoReverse, ac as isEphemeralAnchorOutput, w as isTxBroadcast, t as lastKeyWithTarget, Q as maybeApplyFee, x as proofOfPossessionMessageHashForDepositAddress, q as subtractPrivateKeys, s as subtractPublicKeys, H as sumAvailableTokens, r as sumOfPrivateKeys, v as validateOutboundAdaptorSignature } from './xchain-address-BHu6CpZC.js';
+export { A as AggregateFrostParams, D as DefaultSparkSigner, p as DerivedHDKey, l as KeyDerivation, K as KeyDerivationType, q as KeyPair, n as SignFrostParams, k as SigningCommitment, i as SigningCommitmentWithOptionalNonce, j as SigningNonce, S as SparkSigner, o as SplitSecretWithProofsParams, T as TaprootOutputKeysGenerator, a as TaprootSparkSigner, U as UnsafeStatelessSparkSigner, V as VerifiableSecretShare, h as bigIntToPrivateKey, c as computerLagrangeCoefficients, e as evaluatePolynomial, f as fieldDiv, b as generatePolynomialForSecretSharing, g as getRandomBigInt, m as modInverse, r as recoverSecret, s as splitSecret, d as splitSecretWithProofs, v as validateShare } from './client-BF4cn8F4.js';
+import { j as OutputWithPreviousTransactionData, T as TokenTransaction, l as TokenTransactionWithStatus } from './spark-B_7nZx6T.js';
+import { TokenTransaction as TokenTransaction$1, TokenTransactionWithStatus as TokenTransactionWithStatus$1 } from './proto/spark_token.js';
 export { TokenSigner } from '@buildonspark/lrc20-sdk';
 export { MultisigReceiptInput } from '@buildonspark/lrc20-sdk/lrc/types';
-import './spark-BUOx3U7Q.js';
-import '@bufbuild/protobuf/wire';
-import 'nice-grpc-common';
-import './proto/spark_token.js';
 import '@scure/btc-signer';
 import 'bitcoinjs-lib';
 import 'nice-grpc';
 import 'nice-grpc-web';
+import '@bufbuild/protobuf/wire';
+import 'nice-grpc-common';
 import 'eventemitter3';
-import './sdk-types-DCIVdKUT.js';
+import './sdk-types-CkRNraXT.js';
 import '@scure/btc-signer/psbt';
 import '@lightsparkdev/core';
 import '@scure/bip32';
 import './types-BADxR3bm.js';
+
+declare class SparkSDKError extends Error {
+    readonly context: Record<string, unknown>;
+    readonly originalError?: Error;
+    constructor(message: string, context?: Record<string, unknown>, originalError?: Error);
+    toString(): string;
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * NetworkError should be used for any errors related to network communication,
+ * such as failed HTTP requests, timeouts, or connection issues.
+ * This includes:
+ * - Failed API calls
+ * - Network timeouts
+ * - Connection refused
+ * - DNS resolution failures
+ * - SSL/TLS errors
+ */
+declare class NetworkError extends SparkSDKError {
+    constructor(message: string, context?: {
+        url?: string;
+        method?: string;
+        statusCode?: number;
+        response?: unknown;
+        errorCount?: number;
+        errors?: string;
+        operation?: string;
+        nodeSignaturesCount?: number;
+    }, originalError?: Error);
+}
+/**
+ * ValidationError should be used for any errors related to data validation in regards to the user's input,
+ * This includes:
+ * - Invalid signatures
+ * - Malformed addresses
+ * - Invalid proof of possession
+ * - Invalid cryptographic parameters
+ * - Data format validation failures
+ */
+declare class ValidationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        field?: string;
+        value?: unknown;
+        expected?: unknown;
+        expectedLength?: number;
+        actualLength?: number;
+        rValue?: bigint;
+        fieldPrime?: bigint;
+        sValue?: bigint;
+        groupOrder?: bigint;
+        index?: number;
+        treeLength?: number;
+        addressNodesLength?: number;
+    }, originalError?: Error);
+}
+/**
+ * InternalValidationError should be used for any errors related to internal data validation
+ * that is not related to the user's input.
+ * This includes:
+ * - Invalid SO responses
+ */
+declare class InternalValidationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        field?: string;
+        value?: unknown;
+        expected?: unknown;
+        outputIndex?: number;
+        keyshareInfo?: unknown;
+        signingOperators?: unknown;
+    }, originalError?: Error);
+}
+/**
+ * AuthenticationError should be used specifically for authentication and authorization failures,
+ * such as invalid credentials or insufficient permissions.
+ * This includes:
+ * - Invalid API keys
+ * - Expired tokens
+ * - Insufficient permissions
+ * - Authentication token validation failures
+ * - Authorization failures
+ */
+declare class AuthenticationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        endpoint?: string;
+        reason?: string;
+    }, originalError?: Error);
+}
+/**
+ * RPCError should be used for errors that occur during RPC (Remote Procedure Call) operations,
+ * such as invalid RPC parameters or RPC-specific failures.
+ * This includes:
+ * - Invalid RPC method calls
+ * - RPC parameter validation failures
+ * - RPC-specific error codes
+ * - RPC protocol errors
+ */
+declare class RPCError extends SparkSDKError {
+    constructor(message: string, context?: {
+        method?: string;
+        params?: unknown;
+        code?: number;
+    }, originalError?: Error);
+}
+/**
+ * ConfigurationError should be used for errors related to SDK configuration,
+ * such as missing or invalid configuration values.
+ * This includes:
+ * - Missing required configuration
+ * - Invalid configuration values
+ * - Configuration format errors
+ * - Environment-specific configuration issues
+ */
+declare class ConfigurationError extends SparkSDKError {
+    constructor(message: string, context?: {
+        configKey?: string;
+        value?: unknown;
+    }, originalError?: Error);
+}
+/***
+ * NotImplementedError should be used for any errors related to features that are not yet implemented.
+ */
+declare class NotImplementedError extends SparkSDKError {
+    constructor(message: string, context?: Record<string, unknown>, originalError?: Error);
+}
+
+interface FetchOwnedTokenOutputsParams {
+    ownerPublicKeys: Uint8Array[];
+    issuerPublicKeys?: Uint8Array[];
+    tokenIdentifiers?: Uint8Array[];
+}
+interface QueryTokenTransactionsParams {
+    ownerPublicKeys?: string[];
+    issuerPublicKeys?: string[];
+    tokenTransactionHashes?: string[];
+    tokenIdentifiers?: string[];
+    outputIds?: string[];
+    pageSize: number;
+    offset: number;
+}
+declare class TokenTransactionService {
+    protected readonly config: WalletConfigService;
+    protected readonly connectionManager: ConnectionManager;
+    constructor(config: WalletConfigService, connectionManager: ConnectionManager);
+    tokenTransfer(tokenOutputs: TokenOutputsMap, receiverOutputs: {
+        tokenIdentifier: Bech32mTokenIdentifier;
+        tokenAmount: bigint;
+        receiverSparkAddress: string;
+    }[], outputSelectionStrategy?: "SMALL_FIRST" | "LARGE_FIRST", selectedOutputs?: OutputWithPreviousTransactionData[]): Promise<string>;
+    constructTransferTokenTransactionV0(selectedOutputs: OutputWithPreviousTransactionData[], tokenOutputData: Array<{
+        receiverSparkAddress: Uint8Array;
+        tokenPublicKey: Uint8Array;
+        tokenAmount: bigint;
+    }>): Promise<TokenTransaction>;
+    constructTransferTokenTransaction(selectedOutputs: OutputWithPreviousTransactionData[], tokenOutputData: Array<{
+        receiverSparkAddress: Uint8Array;
+        rawTokenIdentifier: Uint8Array;
+        tokenAmount: bigint;
+    }>): Promise<TokenTransaction$1>;
+    collectOperatorIdentityPublicKeys(): Uint8Array[];
+    broadcastTokenTransaction(tokenTransaction: TokenTransaction | TokenTransaction$1, outputsToSpendSigningPublicKeys?: Uint8Array[], outputsToSpendCommitments?: Uint8Array[]): Promise<string>;
+    private broadcastTokenTransactionV0;
+    private broadcastTokenTransactionV1;
+    private startTokenTransactionV0;
+    private startTokenTransaction;
+    private signTokenTransactionV0;
+    private signTokenTransaction;
+    fetchOwnedTokenOutputs(params: FetchOwnedTokenOutputsParams): Promise<OutputWithPreviousTransactionData[]>;
+    queryTokenTransactions(params: QueryTokenTransactionsParams): Promise<TokenTransactionWithStatus[] | TokenTransactionWithStatus$1[]>;
+    private fetchOwnedTokenOutputsV0;
+    private fetchOwnedTokenOutputsV1;
+    private queryTokenTransactionsV0;
+    private queryTokenTransactionsV1;
+    selectTokenOutputs(tokenOutputs: OutputWithPreviousTransactionData[], tokenAmount: bigint, strategy: "SMALL_FIRST" | "LARGE_FIRST"): OutputWithPreviousTransactionData[];
+    private sortTokenOutputsByStrategy;
+    private signMessageWithKey;
+    private finalizeTokenTransaction;
+    private createSignaturesForOperators;
+}
+
+export { AuthenticationError, Bech32mTokenIdentifier, ConfigurationError, ConnectionManager, InternalValidationError, NetworkError, NotImplementedError, RPCError, SparkSDKError, TokenOutputsMap, TokenTransactionService, ValidationError, WalletConfigService };

package/dist/index.js

@@ -1,10 +1,13 @@
-import "./chunk-S2AL73MZ.js";
+import "./chunk-TVUMSHWA.js";
 import "./chunk-BYXBJQAS.js";
 import {
   AuthenticationError,
   ConfigurationError,
   DEFAULT_FEE_SATS,
+  DIRECT_TIMELOCK_OFFSET,
   DefaultSparkSigner,
+  INITIAL_DIRECT_SEQUENCE,
+  INITIAL_SEQUENCE,
   InternalValidationError,
   KeyDerivationType,
   LRC_WALLET_NETWORK,
@@ -17,6 +20,8 @@ import {
   RPCError,
   SparkSDKError,
   SparkWallet,
+  TEST_UNILATERAL_DIRECT_SEQUENCE,
+  TEST_UNILATERAL_SEQUENCE,
   TaprootOutputKeysGenerator,
   TaprootSparkSigner,
   TokenTransactionService,
@@ -36,13 +41,21 @@ import {
   constructFeeBumpTx,
   constructUnilateralExitFeeBumpPackages,
   constructUnilateralExitTxs,
+  createConnectorRefundTransactions,
+  createLeafNodeTx,
+  createNodeTx,
+  createNodeTxs,
   createRefundTx,
+  createRefundTxs,
+  createRootTx,
   createSigningCommitment,
   createSigningNonce,
+  createSplitTx,
   decodeBech32mTokenIdentifier,
   decodeBytesToSigningCommitment,
   decodeBytesToSigningNonce,
   decodeSparkAddress,
+  doesLeafNeedRefresh,
   encodeBech32mTokenIdentifier,
   encodeSigningCommitmentToBytes,
   encodeSigningNonceToBytes,
@@ -93,17 +106,20 @@ import {
   sumOfPrivateKeys,
   validateOutboundAdaptorSignature,
   validateShare
-} from "./chunk-2TUM3R6C.js";
-import "./chunk-4JD4HIAN.js";
-import "./chunk-TM6CHQXC.js";
-import "./chunk-CDLETEDT.js";
-import "./chunk-2ENZX6LT.js";
+} from "./chunk-W4ZRBSWM.js";
+import "./chunk-G4MSZ6DE.js";
+import "./chunk-3SEOTO43.js";
+import "./chunk-WAQKYSDI.js";
+import "./chunk-AAZWSPUK.js";
 import "./chunk-MVRQ5US7.js";
 export {
   AuthenticationError,
   ConfigurationError,
   DEFAULT_FEE_SATS,
+  DIRECT_TIMELOCK_OFFSET,
   DefaultSparkSigner,
+  INITIAL_DIRECT_SEQUENCE,
+  INITIAL_SEQUENCE,
   InternalValidationError,
   KeyDerivationType,
   LRC_WALLET_NETWORK,
@@ -116,6 +132,8 @@ export {
   RPCError,
   SparkSDKError,
   SparkWallet,
+  TEST_UNILATERAL_DIRECT_SEQUENCE,
+  TEST_UNILATERAL_SEQUENCE,
   TaprootOutputKeysGenerator,
   TaprootSparkSigner,
   TokenTransactionService,
@@ -135,13 +153,21 @@ export {
   constructFeeBumpTx,
   constructUnilateralExitFeeBumpPackages,
   constructUnilateralExitTxs,
+  createConnectorRefundTransactions,
+  createLeafNodeTx,
+  createNodeTx,
+  createNodeTxs,
   createRefundTx,
+  createRefundTxs,
+  createRootTx,
   createSigningCommitment,
   createSigningNonce,
+  createSplitTx,
   decodeBech32mTokenIdentifier,
   decodeBytesToSigningCommitment,
   decodeBytesToSigningNonce,
   decodeSparkAddress,
+  doesLeafNeedRefresh,
   encodeBech32mTokenIdentifier,
   encodeSigningCommitmentToBytes,
   encodeSigningNonceToBytes,