@buildonspark/spark-sdk 0.2.3 → 0.2.5

package/dist/index.d.cts

@@ -1,20 +1,200 @@
-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-DJJm19BP.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-SZ7dkVUE.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-Di65w0Us.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-Di65w0Us.cjs';
+export { ab as BroadcastConfig, ac as BroadcastResult, Q as DEFAULT_FEE_SATS, M as DIRECT_TIMELOCK_OFFSET, a9 as FeeBumpTxChain, a8 as FeeBumpTxPackage, a7 as FeeRate, O as INITIAL_DIRECT_SEQUENCE, N as INITIAL_SEQUENCE, a5 as LeafInfo, P as TEST_UNILATERAL_DIRECT_SEQUENCE, T as TEST_UNILATERAL_SEQUENCE, aa as TxChain, a6 as Utxo, q as addPrivateKeys, o as addPublicKeys, b as applyAdaptorToSignature, p as applyAdditiveTweakToPublicKey, J as checkIfSelectedOutputsAreAvailable, a1 as checkIfValidSequence, z as collectResponses, c as computeTaprootKeyNoScript, ag as constructFeeBumpTx, af as constructUnilateralExitFeeBumpPackages, ae as constructUnilateralExitTxs, _ as createConnectorRefundTransactions, X as createLeafNodeTx, V as createNodeTx, W as createNodeTxs, Y as createRefundTx, Z as createRefundTxs, S as createRootTx, F as createSigningCommitment, B as createSigningNonce, U as createSplitTx, H as decodeBytesToSigningCommitment, E as decodeBytesToSigningNonce, a2 as doesLeafNeedRefresh, G as encodeSigningCommitmentToBytes, D as encodeSigningNonceToBytes, K as filterTokenBalanceForTokenPublicKey, a as generateAdaptorFromSignature, g as generateSignatureFromExistingAdaptor, $ as getCurrentTimelock, a4 as getEphemeralAnchorOutput, w as getLatestDepositTxId, a3 as getNextTransactionSequence, f as getP2TRAddressFromPkScript, e as getP2TRAddressFromPublicKey, d as getP2TRScriptFromPublicKey, h as getP2WPKHAddressFromPublicKey, A as getRandomSigningNonce, k as getSigHashFromTx, C as getSigningCommitmentFromNonce, ah as getSparkAddressFromTaproot, a0 as getTransactionSequence, L as getTransferPackageSigningPayload, n as getTxEstimatedVbytesSizeByNumberOfInputsOutputs, j as getTxFromRawTxBytes, i as getTxFromRawTxHex, l as getTxId, m as getTxIdNoReverse, ad as isEphemeralAnchorOutput, x as isTxBroadcast, u as lastKeyWithTarget, R as maybeApplyFee, y as proofOfPossessionMessageHashForDepositAddress, r as subtractPrivateKeys, s as subtractPublicKeys, I as sumAvailableTokens, t as sumOfPrivateKeys, v as validateOutboundAdaptorSignature } from './xchain-address-CqRu3F21.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-C88GCTPB.cjs';
+import { f as OutputWithPreviousTransactionData, T as TokenTransaction, k as TokenTransactionWithStatus } from './spark-ESAfZARg.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-B_7nZx6T.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-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,200 @@
-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-CxcGPXRB.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-Bh9w1SeC.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-B2WwKN8W.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-B2WwKN8W.js';
+export { ab as BroadcastConfig, ac as BroadcastResult, Q as DEFAULT_FEE_SATS, M as DIRECT_TIMELOCK_OFFSET, a9 as FeeBumpTxChain, a8 as FeeBumpTxPackage, a7 as FeeRate, O as INITIAL_DIRECT_SEQUENCE, N as INITIAL_SEQUENCE, a5 as LeafInfo, P as TEST_UNILATERAL_DIRECT_SEQUENCE, T as TEST_UNILATERAL_SEQUENCE, aa as TxChain, a6 as Utxo, q as addPrivateKeys, o as addPublicKeys, b as applyAdaptorToSignature, p as applyAdditiveTweakToPublicKey, J as checkIfSelectedOutputsAreAvailable, a1 as checkIfValidSequence, z as collectResponses, c as computeTaprootKeyNoScript, ag as constructFeeBumpTx, af as constructUnilateralExitFeeBumpPackages, ae as constructUnilateralExitTxs, _ as createConnectorRefundTransactions, X as createLeafNodeTx, V as createNodeTx, W as createNodeTxs, Y as createRefundTx, Z as createRefundTxs, S as createRootTx, F as createSigningCommitment, B as createSigningNonce, U as createSplitTx, H as decodeBytesToSigningCommitment, E as decodeBytesToSigningNonce, a2 as doesLeafNeedRefresh, G as encodeSigningCommitmentToBytes, D as encodeSigningNonceToBytes, K as filterTokenBalanceForTokenPublicKey, a as generateAdaptorFromSignature, g as generateSignatureFromExistingAdaptor, $ as getCurrentTimelock, a4 as getEphemeralAnchorOutput, w as getLatestDepositTxId, a3 as getNextTransactionSequence, f as getP2TRAddressFromPkScript, e as getP2TRAddressFromPublicKey, d as getP2TRScriptFromPublicKey, h as getP2WPKHAddressFromPublicKey, A as getRandomSigningNonce, k as getSigHashFromTx, C as getSigningCommitmentFromNonce, ah as getSparkAddressFromTaproot, a0 as getTransactionSequence, L as getTransferPackageSigningPayload, n as getTxEstimatedVbytesSizeByNumberOfInputsOutputs, j as getTxFromRawTxBytes, i as getTxFromRawTxHex, l as getTxId, m as getTxIdNoReverse, ad as isEphemeralAnchorOutput, x as isTxBroadcast, u as lastKeyWithTarget, R as maybeApplyFee, y as proofOfPossessionMessageHashForDepositAddress, r as subtractPrivateKeys, s as subtractPublicKeys, I as sumAvailableTokens, t as sumOfPrivateKeys, v as validateOutboundAdaptorSignature } from './xchain-address-BsveIy5l.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-Dg6vS_2I.js';
+import { f as OutputWithPreviousTransactionData, T as TokenTransaction, k as TokenTransactionWithStatus } from './spark-ESAfZARg.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-B_7nZx6T.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-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-PTRXJS7Q.js";
+import "./chunk-LQZL2D3Y.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,
@@ -71,6 +84,7 @@ import {
   getSparkAddressFromTaproot,
   getTransactionSequence,
   getTransferPackageSigningPayload,
+  getTxEstimatedVbytesSizeByNumberOfInputsOutputs,
   getTxFromRawTxBytes,
   getTxFromRawTxHex,
   getTxId,
@@ -93,17 +107,20 @@ import {
   sumOfPrivateKeys,
   validateOutboundAdaptorSignature,
   validateShare
-} from "./chunk-PLLJIZC3.js";
+} from "./chunk-U7LRIWTF.js";
 import "./chunk-G4MSZ6DE.js";
-import "./chunk-3SEOTO43.js";
-import "./chunk-CDLETEDT.js";
+import "./chunk-3SPMJMUX.js";
+import "./chunk-CQY5ML2A.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 +133,8 @@ export {
   RPCError,
   SparkSDKError,
   SparkWallet,
+  TEST_UNILATERAL_DIRECT_SEQUENCE,
+  TEST_UNILATERAL_SEQUENCE,
   TaprootOutputKeysGenerator,
   TaprootSparkSigner,
   TokenTransactionService,
@@ -135,13 +154,21 @@ export {
   constructFeeBumpTx,
   constructUnilateralExitFeeBumpPackages,
   constructUnilateralExitTxs,
+  createConnectorRefundTransactions,
+  createLeafNodeTx,
+  createNodeTx,
+  createNodeTxs,
   createRefundTx,
+  createRefundTxs,
+  createRootTx,
   createSigningCommitment,
   createSigningNonce,
+  createSplitTx,
   decodeBech32mTokenIdentifier,
   decodeBytesToSigningCommitment,
   decodeBytesToSigningNonce,
   decodeSparkAddress,
+  doesLeafNeedRefresh,
   encodeBech32mTokenIdentifier,
   encodeSigningCommitmentToBytes,
   encodeSigningNonceToBytes,
@@ -170,6 +197,7 @@ export {
   getSparkAddressFromTaproot,
   getTransactionSequence,
   getTransferPackageSigningPayload,
+  getTxEstimatedVbytesSizeByNumberOfInputsOutputs,
   getTxFromRawTxBytes,
   getTxFromRawTxHex,
   getTxId,