@unicitylabs/sphere-sdk 0.5.1 → 0.5.3

package/dist/index.d.cts

@@ -711,6 +711,70 @@ interface UnconfirmedResolutionResult {
         status: 'resolved' | 'pending' | 'failed';
     }>;
 }
+/**
+ * A single direct (whole-token) transfer entry inside a combined bundle.
+ * The receiver processes each entry the same way as a standalone NOSTR-FIRST
+ * commitment-only transfer.
+ */
+interface DirectTokenEntry {
+    /** JSON-serialized SDK token */
+    sourceToken: string;
+    /** JSON-serialized TransferCommitment */
+    commitmentData: string;
+    /** Token value (display metadata) */
+    amount: string;
+    /** Coin ID hex */
+    coinId: string;
+    /** Extracted tokenId for receiver-side dedup (optional) */
+    tokenId?: string;
+}
+/**
+ * Combined Transfer Bundle V6
+ *
+ * Packs ALL tokens for a single send() operation into ONE Nostr message:
+ * - An optional V5 split bundle (when the sender had to split a token)
+ * - Zero or more direct token entries (whole tokens transferred as-is)
+ *
+ * Benefits over V5 + NOSTR-FIRST multi-message approach:
+ * - Single Nostr event = no relay overwrite issues (kind 31113 replaceable events)
+ * - Atomic delivery: all tokens arrive together or not at all
+ * - One notification, one history entry on receiver side
+ */
+interface CombinedTransferBundleV6 {
+    /** Bundle version */
+    version: '6.0';
+    /** Bundle type identifier */
+    type: 'COMBINED_TRANSFER';
+    /** Transfer ID (matches sender's TransferResult.id) */
+    transferId: string;
+    /** V5 split bundle (null if no split was needed) */
+    splitBundle: InstantSplitBundleV5 | null;
+    /** Direct tokens sent without splitting */
+    directTokens: DirectTokenEntry[];
+    /** Total transfer amount (display metadata) */
+    totalAmount: string;
+    /** Coin ID hex */
+    coinId: string;
+    /** Sender's transport pubkey */
+    senderPubkey: string;
+    /** Optional memo (one per transfer) */
+    memo?: string;
+}
+/**
+ * Type guard for CombinedTransferBundleV6
+ */
+declare function isCombinedTransferBundleV6(obj: unknown): obj is CombinedTransferBundleV6;
+/**
+ * Result of building a split bundle (without sending it)
+ */
+interface BuildSplitBundleResult {
+    /** The constructed V5 bundle */
+    bundle: InstantSplitBundleV5;
+    /** Split group ID for correlation */
+    splitGroupId: string;
+    /** Call this after transport delivery to start background mint proof + change token creation */
+    startBackground: () => Promise<void>;
+}
 
 /**
  * Payment Session Types
@@ -942,6 +1006,8 @@ interface Asset {
     readonly confirmedTokenCount: number;
     /** Number of unconfirmed tokens aggregated */
     readonly unconfirmedTokenCount: number;
+    /** Number of tokens currently being sent */
+    readonly transferringTokenCount: number;
     /** Price per whole unit in USD (null if PriceProvider not configured) */
     readonly priceUsd: number | null;
     /** Price per whole unit in EUR (null if PriceProvider not configured) */
@@ -1508,6 +1574,12 @@ interface HistoryRecord {
     recipientNametag?: string;
     /** Optional memo/message attached to the transfer */
     memo?: string;
+    /** All token IDs in a combined transfer (V6 bundle breakdown) */
+    tokenIds?: Array<{
+        id: string;
+        amount: string;
+        source: 'split' | 'direct';
+    }>;
 }
 /**
  * Storage result types
@@ -1599,6 +1671,7 @@ interface TxfStorageDataBase {
     _outbox?: TxfOutboxEntry[];
     _sent?: TxfSentEntry[];
     _invalid?: TxfInvalidEntry[];
+    _history?: HistoryRecord[];
     [key: `_${string}`]: unknown;
 }
 interface TxfMeta {
@@ -2577,6 +2650,7 @@ declare class PaymentsModule {
     private loadedPromise;
     private loaded;
     private processedSplitGroupIds;
+    private processedCombinedTransferIds;
     private storageEventUnsubscribers;
     private syncDebounceTimer;
     private static readonly SYNC_DEBOUNCE_MS;
@@ -2646,6 +2720,43 @@ declare class PaymentsModule {
      * @returns InstantSplitResult with timing info
      */
     sendInstant(request: TransferRequest, options?: InstantSplitOptions): Promise<InstantSplitResult>;
+    /**
+     * Save a V5 split bundle as an unconfirmed token (shared by V5 standalone and V6 combined).
+     * Returns the created UI token, or null if deduped.
+     *
+     * @param deferPersistence - If true, skip addToken/save calls (caller batches them).
+     *   The token is still added to the in-memory map for dedup; caller must call save().
+     */
+    private saveUnconfirmedV5Token;
+    /**
+     * Save a commitment-only (NOSTR-FIRST) token and start proof polling.
+     * Shared by standalone NOSTR-FIRST handler and V6 combined handler.
+     * Returns the created UI token, or null if deduped/tombstoned.
+     *
+     * @param deferPersistence - If true, skip save() and commitment submission
+     *   (caller batches them). Token is added to in-memory map + proof polling is queued.
+     * @param skipGenesisDedup - If true, skip genesis-ID-only dedup. V6 handler sets this
+     *   because bundle-level dedup protects against replays, and split children share genesis IDs.
+     */
+    private saveCommitmentOnlyToken;
+    /**
+     * Process a received COMBINED_TRANSFER V6 bundle.
+     *
+     * Unpacks a single Nostr message into its component tokens:
+     * - Optional V5 split bundle (saved as unconfirmed, resolved lazily)
+     * - Zero or more direct tokens (saved as unconfirmed, proof-polled)
+     *
+     * Emits ONE transfer:incoming event and records ONE history entry.
+     */
+    private processCombinedTransferBundle;
+    /**
+     * Persist processed combined transfer IDs to KV storage.
+     */
+    private saveProcessedCombinedTransferIds;
+    /**
+     * Load processed combined transfer IDs from KV storage.
+     */
+    private loadProcessedCombinedTransferIds;
     /**
      * Process a received INSTANT_SPLIT bundle.
      *
@@ -2836,7 +2947,8 @@ declare class PaymentsModule {
     getAssets(coinId?: string): Promise<Asset[]>;
     /**
      * Aggregate tokens by coinId with confirmed/unconfirmed breakdown.
-     * Excludes tokens with status 'spent', 'invalid', or 'transferring'.
+     * Excludes tokens with status 'spent' or 'invalid'.
+     * Tokens with status 'transferring' are counted as unconfirmed (visible in UI as "Sending").
      */
     private aggregateTokens;
     /**
@@ -3087,6 +3199,13 @@ declare class PaymentsModule {
      * Also performs one-time migration from legacy KV storage.
      */
     loadHistory(): Promise<void>;
+    /**
+     * Import history entries from remote TXF data into local store.
+     * Delegates to the local TokenStorageProvider's importHistoryEntries() for
+     * persistent storage, with in-memory fallback.
+     * Reused by both load() (initial IPFS fetch) and _doSync() (merge result).
+     */
+    private importRemoteHistoryEntries;
     /**
      * Get the first local token storage provider (for history operations).
      */
@@ -3236,7 +3355,7 @@ declare class PaymentsModule {
     /**
      * Handle NOSTR-FIRST commitment-only transfer (recipient side)
      * This is called when receiving a transfer with only commitmentData and no proof yet.
-     * We create the token as 'submitted', submit commitment (idempotent), and poll for proof.
+     * Delegates to saveCommitmentOnlyToken() helper, then emits event + records history.
      */
     private handleCommitmentOnlyTransfer;
     /**
@@ -3779,6 +3898,8 @@ declare const STORAGE_KEYS_ADDRESS: {
     readonly GROUP_CHAT_PROCESSED_EVENTS: "group_chat_processed_events";
     /** Processed V5 split group IDs for Nostr re-delivery dedup */
     readonly PROCESSED_SPLIT_GROUP_IDS: "processed_split_group_ids";
+    /** Processed V6 combined transfer IDs for Nostr re-delivery dedup */
+    readonly PROCESSED_COMBINED_TRANSFER_IDS: "processed_combined_transfer_ids";
 };
 /** @deprecated Use STORAGE_KEYS_GLOBAL and STORAGE_KEYS_ADDRESS instead */
 declare const STORAGE_KEYS: {
@@ -3804,6 +3925,8 @@ declare const STORAGE_KEYS: {
     readonly GROUP_CHAT_PROCESSED_EVENTS: "group_chat_processed_events";
     /** Processed V5 split group IDs for Nostr re-delivery dedup */
     readonly PROCESSED_SPLIT_GROUP_IDS: "processed_split_group_ids";
+    /** Processed V6 combined transfer IDs for Nostr re-delivery dedup */
+    readonly PROCESSED_COMBINED_TRANSFER_IDS: "processed_combined_transfer_ids";
     /** Encrypted BIP39 mnemonic */
     readonly MNEMONIC: "mnemonic";
     /** Encrypted master private key */
@@ -5472,6 +5595,7 @@ declare function buildTxfStorageData(tokens: Token[], meta: Omit<TxfMeta$1, 'for
     outboxEntries?: OutboxEntry[];
     mintOutboxEntries?: MintOutboxEntry[];
     invalidatedNametags?: InvalidatedNametagEntry[];
+    historyEntries?: HistoryRecord[];
 }): Promise<TxfStorageData>;
 interface ParsedStorageData {
     tokens: Token[];
@@ -5483,6 +5607,7 @@ interface ParsedStorageData {
     outboxEntries: OutboxEntry[];
     mintOutboxEntries: MintOutboxEntry[];
     invalidatedNametags: InvalidatedNametagEntry[];
+    historyEntries: HistoryRecord[];
     validationErrors: string[];
 }
 /**
@@ -6624,4 +6749,4 @@ declare function getCoinIdBySymbol(symbol: string): string | undefined;
  */
 declare function getCoinIdByName(name: string): string | undefined;
 
-export { type AddressInfo, type AddressMode, type AggregatorClient, type AggregatorEvent, type AggregatorEventCallback, type AggregatorEventType, type AggregatorProvider, type AggregatorProviderConfig, type Asset, type BackgroundProgressStatus, type BaseProvider, type BroadcastHandler, type BroadcastMessage, type CMasterKeyData, COIN_TYPES, type CheckNetworkHealthOptions, CoinGeckoPriceProvider, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, type ComposingIndicator, type ConversationPage, type CreateGroupOptions, DEFAULT_AGGREGATOR_TIMEOUT, DEFAULT_AGGREGATOR_URL, DEFAULT_DERIVATION_PATH, DEFAULT_ELECTRUM_URL, DEFAULT_GROUP_RELAYS, DEFAULT_IPFS_BOOTSTRAP_PEERS, DEFAULT_IPFS_GATEWAYS, DEFAULT_MARKET_API_URL, DEFAULT_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DerivationMode, type DirectMessage, type DiscoverAddressProgress, type DiscoverAddressesOptions, type DiscoverAddressesResult, type DiscoveredAddress, type ExtendedValidationResult, type FullIdentity, type GetConversationPageOptions, GroupChatModule, type GroupChatModuleConfig, type GroupChatModuleDependencies, type GroupData, type GroupMemberData, type GroupMessageData, GroupRole, GroupVisibility, type HealthCheckFn, type Identity, type IdentityConfig, type InclusionProof, type IncomingBroadcast, type IncomingMessage, type IncomingPaymentRequest$1 as IncomingPaymentRequest, type IncomingTokenTransfer, type IncomingTransfer, type InitProgress, type InitProgressCallback, type InitProgressStep, type InstantSplitBundle, type InstantSplitBundleV4, type InstantSplitBundleV5, type InstantSplitOptions, type InstantSplitProcessResult, type InstantSplitResult, type InstantSplitV5RecoveryMetadata, type IntentStatus, type IntentType, type InvalidatedNametagEntry, index as L1, type L1Balance, L1PaymentsModule, type L1PaymentsModuleConfig, type L1PaymentsModuleDependencies, type L1SendRequest, type L1SendResult, type L1Transaction, type L1Utxo, LIMITS, type LegacyFileImportOptions, type LegacyFileInfo, type LegacyFileParseResult, type LegacyFileParsedData, type LegacyFileType, type LoadResult, type LoggingConfig, type MarketIntent, MarketModule, type MarketModuleConfig, type MarketModuleDependencies, type MessageHandler, type MintOutboxEntry, type MintParams, type MintResult, NETWORKS, NIP29_KINDS, NOSTR_EVENT_KINDS, type NametagData, type NetworkHealthResult, type NetworkType, type OracleEvent, type OracleEventCallback, type OracleEventType, type OracleProvider, type OutboxEntry, type OutgoingPaymentRequest, type ParsedStorageData, type PaymentRequest, type PaymentRequestHandler$1 as PaymentRequestHandler, type PaymentRequestResponse, type PaymentRequestResponseHandler$1 as PaymentRequestResponseHandler, type PaymentRequestResponseType$1 as PaymentRequestResponseType, type PaymentRequestResult, type PaymentRequestStatus, type PaymentSession, type PaymentSessionDirection, type PaymentSessionError, type PaymentSessionErrorCode, type PaymentSessionStatus, PaymentsModule, type PaymentsModuleConfig, type PaymentsModuleDependencies, type PeerInfo, type PendingV5Finalization, type PostIntentRequest, type PostIntentResult, type PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RegistryNetwork, STORAGE_KEYS, STORAGE_KEYS_ADDRESS, STORAGE_KEYS_GLOBAL, STORAGE_PREFIX, type SaveResult, type ScanAddressProgress, type ScanAddressesOptions, type ScanAddressesResult, type ScannedAddressResult, type SearchFilters, type SearchIntentResult, type SearchOptions, type SearchResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereConfig, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, type SphereImportOptions, type SphereInitOptions, type SphereInitResult, type SphereLoadOptions, type SphereStatus, type SplitPaymentSession, type SplitRecoveryResult, type StorageEvent, type StorageEventCallback, type StorageEventType, type StorageProvider, type StorageProviderConfig, type SubmitResult, type SyncResult, TEST_AGGREGATOR_URL, TEST_ELECTRUM_URL, TEST_NOSTR_RELAYS, TIMEOUTS, type Token, type TokenDefinition, type TokenIcon, type TokenPrice, TokenRegistry, type TokenState, type TokenStatus, type TokenStorageProvider, type TokenTransferDetail, type TokenTransferHandler, type TokenTransferPayload, type ValidationResult as TokenValidationResult, TokenValidator, type TombstoneEntry, type TrackedAddress, type TrackedAddressEntry, type TransactionHistoryEntry, type TransferCommitment, type TransferMode, type TransferRequest, type TransferResult, type TransferStatus, type TransportEvent, type TransportEventCallback, type TransportEventType, type TransportProvider, type TransportProviderConfig, type TrustBaseLoader, type TxfAuthenticator, type TxfGenesis, type TxfGenesisData, type TxfInclusionProof, type TxfIntegrity, type TxfInvalidEntry, type TxfMerkleStep, type TxfMerkleTreePath, type TxfMeta, type TxfOutboxEntry, type TxfSentEntry, type TxfState, type TxfStorageData, type TxfStorageDataBase, type TxfToken, type TxfTombstone, type TxfTransaction, type UnconfirmedResolutionResult, type V5FinalizationStage, type ValidationAction, type ValidationIssue, type ValidationResult$1 as ValidationResult, type WaitOptions, type WalletDatInfo, type WalletInfo, type WalletJSON$1 as WalletJSON, type WalletJSONExportOptions$1 as WalletJSONExportOptions, type WalletSource, archivedKeyFromTokenId, base58Decode, base58Encode, buildTxfStorageData, bytesToHex, checkNetworkHealth, countCommittedTransactions, createAddress, createCommunicationsModule, createGroupChatModule, createKeyPair, createL1PaymentsModule, createMarketModule, createPaymentSession, createPaymentSessionError, createPaymentsModule, createPriceProvider, createSphere, createSplitPaymentSession, createTokenValidator, decodeBech32, decryptCMasterKey, decryptPrivateKey, decryptTextFormatKey, deriveAddressInfo, deriveChildKey$1 as deriveChildKey, deriveKeyAtPath$1 as deriveKeyAtPath, doubleSha256, encodeBech32, extractFromText, findPattern, forkedKeyFromTokenIdAndState, formatAmount, generateMasterKey, generateMnemonic, getAddressHrp, getAddressId, getAddressStorageKey, getCoinIdByName, getCoinIdBySymbol, getCurrentStateHash, getPublicKey, getSphere, getTokenDecimals, getTokenDefinition, getTokenIconUrl, getTokenId, getTokenName, getTokenSymbol, hasMissingNewStateHash, hasUncommittedTransactions, hasValidTxfData, hash160, hexToBytes, identityFromMnemonicSync, initSphere, isArchivedKey, isForkedKey, isInstantSplitBundle, isInstantSplitBundleV4, isInstantSplitBundleV5, isKnownToken, isPaymentSessionTerminal, isPaymentSessionTimedOut, isSQLiteDatabase, isTextWalletEncrypted, isTokenKey, isValidBech32, isValidNametag, isValidPrivateKey, isValidTokenId, isWalletDatEncrypted, isWalletTextFormat, keyFromTokenId, loadSphere, mnemonicToSeedSync, normalizeSdkTokenToStorage, objectToTxf, parseAndDecryptWalletDat, parseAndDecryptWalletText, parseForkedKey, parseTxfStorageData, parseWalletDat, parseWalletText, randomBytes, randomHex, randomUUID, ripemd160, sha256, sleep, sphereExists, toHumanReadable, toSmallestUnit, tokenIdFromArchivedKey, tokenIdFromKey, tokenToTxf, txfToToken, validateMnemonic };
+export { type AddressInfo, type AddressMode, type AggregatorClient, type AggregatorEvent, type AggregatorEventCallback, type AggregatorEventType, type AggregatorProvider, type AggregatorProviderConfig, type Asset, type BackgroundProgressStatus, type BaseProvider, type BroadcastHandler, type BroadcastMessage, type BuildSplitBundleResult, type CMasterKeyData, COIN_TYPES, type CheckNetworkHealthOptions, CoinGeckoPriceProvider, type CombinedTransferBundleV6, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, type ComposingIndicator, type ConversationPage, type CreateGroupOptions, DEFAULT_AGGREGATOR_TIMEOUT, DEFAULT_AGGREGATOR_URL, DEFAULT_DERIVATION_PATH, DEFAULT_ELECTRUM_URL, DEFAULT_GROUP_RELAYS, DEFAULT_IPFS_BOOTSTRAP_PEERS, DEFAULT_IPFS_GATEWAYS, DEFAULT_MARKET_API_URL, DEFAULT_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DerivationMode, type DirectMessage, type DirectTokenEntry, type DiscoverAddressProgress, type DiscoverAddressesOptions, type DiscoverAddressesResult, type DiscoveredAddress, type ExtendedValidationResult, type FullIdentity, type GetConversationPageOptions, GroupChatModule, type GroupChatModuleConfig, type GroupChatModuleDependencies, type GroupData, type GroupMemberData, type GroupMessageData, GroupRole, GroupVisibility, type HealthCheckFn, type Identity, type IdentityConfig, type InclusionProof, type IncomingBroadcast, type IncomingMessage, type IncomingPaymentRequest$1 as IncomingPaymentRequest, type IncomingTokenTransfer, type IncomingTransfer, type InitProgress, type InitProgressCallback, type InitProgressStep, type InstantSplitBundle, type InstantSplitBundleV4, type InstantSplitBundleV5, type InstantSplitOptions, type InstantSplitProcessResult, type InstantSplitResult, type InstantSplitV5RecoveryMetadata, type IntentStatus, type IntentType, type InvalidatedNametagEntry, index as L1, type L1Balance, L1PaymentsModule, type L1PaymentsModuleConfig, type L1PaymentsModuleDependencies, type L1SendRequest, type L1SendResult, type L1Transaction, type L1Utxo, LIMITS, type LegacyFileImportOptions, type LegacyFileInfo, type LegacyFileParseResult, type LegacyFileParsedData, type LegacyFileType, type LoadResult, type LoggingConfig, type MarketIntent, MarketModule, type MarketModuleConfig, type MarketModuleDependencies, type MessageHandler, type MintOutboxEntry, type MintParams, type MintResult, NETWORKS, NIP29_KINDS, NOSTR_EVENT_KINDS, type NametagData, type NetworkHealthResult, type NetworkType, type OracleEvent, type OracleEventCallback, type OracleEventType, type OracleProvider, type OutboxEntry, type OutgoingPaymentRequest, type ParsedStorageData, type PaymentRequest, type PaymentRequestHandler$1 as PaymentRequestHandler, type PaymentRequestResponse, type PaymentRequestResponseHandler$1 as PaymentRequestResponseHandler, type PaymentRequestResponseType$1 as PaymentRequestResponseType, type PaymentRequestResult, type PaymentRequestStatus, type PaymentSession, type PaymentSessionDirection, type PaymentSessionError, type PaymentSessionErrorCode, type PaymentSessionStatus, PaymentsModule, type PaymentsModuleConfig, type PaymentsModuleDependencies, type PeerInfo, type PendingV5Finalization, type PostIntentRequest, type PostIntentResult, type PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RegistryNetwork, STORAGE_KEYS, STORAGE_KEYS_ADDRESS, STORAGE_KEYS_GLOBAL, STORAGE_PREFIX, type SaveResult, type ScanAddressProgress, type ScanAddressesOptions, type ScanAddressesResult, type ScannedAddressResult, type SearchFilters, type SearchIntentResult, type SearchOptions, type SearchResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereConfig, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, type SphereImportOptions, type SphereInitOptions, type SphereInitResult, type SphereLoadOptions, type SphereStatus, type SplitPaymentSession, type SplitRecoveryResult, type StorageEvent, type StorageEventCallback, type StorageEventType, type StorageProvider, type StorageProviderConfig, type SubmitResult, type SyncResult, TEST_AGGREGATOR_URL, TEST_ELECTRUM_URL, TEST_NOSTR_RELAYS, TIMEOUTS, type Token, type TokenDefinition, type TokenIcon, type TokenPrice, TokenRegistry, type TokenState, type TokenStatus, type TokenStorageProvider, type TokenTransferDetail, type TokenTransferHandler, type TokenTransferPayload, type ValidationResult as TokenValidationResult, TokenValidator, type TombstoneEntry, type TrackedAddress, type TrackedAddressEntry, type TransactionHistoryEntry, type TransferCommitment, type TransferMode, type TransferRequest, type TransferResult, type TransferStatus, type TransportEvent, type TransportEventCallback, type TransportEventType, type TransportProvider, type TransportProviderConfig, type TrustBaseLoader, type TxfAuthenticator, type TxfGenesis, type TxfGenesisData, type TxfInclusionProof, type TxfIntegrity, type TxfInvalidEntry, type TxfMerkleStep, type TxfMerkleTreePath, type TxfMeta, type TxfOutboxEntry, type TxfSentEntry, type TxfState, type TxfStorageData, type TxfStorageDataBase, type TxfToken, type TxfTombstone, type TxfTransaction, type UnconfirmedResolutionResult, type V5FinalizationStage, type ValidationAction, type ValidationIssue, type ValidationResult$1 as ValidationResult, type WaitOptions, type WalletDatInfo, type WalletInfo, type WalletJSON$1 as WalletJSON, type WalletJSONExportOptions$1 as WalletJSONExportOptions, type WalletSource, archivedKeyFromTokenId, base58Decode, base58Encode, buildTxfStorageData, bytesToHex, checkNetworkHealth, countCommittedTransactions, createAddress, createCommunicationsModule, createGroupChatModule, createKeyPair, createL1PaymentsModule, createMarketModule, createPaymentSession, createPaymentSessionError, createPaymentsModule, createPriceProvider, createSphere, createSplitPaymentSession, createTokenValidator, decodeBech32, decryptCMasterKey, decryptPrivateKey, decryptTextFormatKey, deriveAddressInfo, deriveChildKey$1 as deriveChildKey, deriveKeyAtPath$1 as deriveKeyAtPath, doubleSha256, encodeBech32, extractFromText, findPattern, forkedKeyFromTokenIdAndState, formatAmount, generateMasterKey, generateMnemonic, getAddressHrp, getAddressId, getAddressStorageKey, getCoinIdByName, getCoinIdBySymbol, getCurrentStateHash, getPublicKey, getSphere, getTokenDecimals, getTokenDefinition, getTokenIconUrl, getTokenId, getTokenName, getTokenSymbol, hasMissingNewStateHash, hasUncommittedTransactions, hasValidTxfData, hash160, hexToBytes, identityFromMnemonicSync, initSphere, isArchivedKey, isCombinedTransferBundleV6, isForkedKey, isInstantSplitBundle, isInstantSplitBundleV4, isInstantSplitBundleV5, isKnownToken, isPaymentSessionTerminal, isPaymentSessionTimedOut, isSQLiteDatabase, isTextWalletEncrypted, isTokenKey, isValidBech32, isValidNametag, isValidPrivateKey, isValidTokenId, isWalletDatEncrypted, isWalletTextFormat, keyFromTokenId, loadSphere, mnemonicToSeedSync, normalizeSdkTokenToStorage, objectToTxf, parseAndDecryptWalletDat, parseAndDecryptWalletText, parseForkedKey, parseTxfStorageData, parseWalletDat, parseWalletText, randomBytes, randomHex, randomUUID, ripemd160, sha256, sleep, sphereExists, toHumanReadable, toSmallestUnit, tokenIdFromArchivedKey, tokenIdFromKey, tokenToTxf, txfToToken, validateMnemonic };

package/dist/index.d.ts

@@ -711,6 +711,70 @@ interface UnconfirmedResolutionResult {
         status: 'resolved' | 'pending' | 'failed';
     }>;
 }
+/**
+ * A single direct (whole-token) transfer entry inside a combined bundle.
+ * The receiver processes each entry the same way as a standalone NOSTR-FIRST
+ * commitment-only transfer.
+ */
+interface DirectTokenEntry {
+    /** JSON-serialized SDK token */
+    sourceToken: string;
+    /** JSON-serialized TransferCommitment */
+    commitmentData: string;
+    /** Token value (display metadata) */
+    amount: string;
+    /** Coin ID hex */
+    coinId: string;
+    /** Extracted tokenId for receiver-side dedup (optional) */
+    tokenId?: string;
+}
+/**
+ * Combined Transfer Bundle V6
+ *
+ * Packs ALL tokens for a single send() operation into ONE Nostr message:
+ * - An optional V5 split bundle (when the sender had to split a token)
+ * - Zero or more direct token entries (whole tokens transferred as-is)
+ *
+ * Benefits over V5 + NOSTR-FIRST multi-message approach:
+ * - Single Nostr event = no relay overwrite issues (kind 31113 replaceable events)
+ * - Atomic delivery: all tokens arrive together or not at all
+ * - One notification, one history entry on receiver side
+ */
+interface CombinedTransferBundleV6 {
+    /** Bundle version */
+    version: '6.0';
+    /** Bundle type identifier */
+    type: 'COMBINED_TRANSFER';
+    /** Transfer ID (matches sender's TransferResult.id) */
+    transferId: string;
+    /** V5 split bundle (null if no split was needed) */
+    splitBundle: InstantSplitBundleV5 | null;
+    /** Direct tokens sent without splitting */
+    directTokens: DirectTokenEntry[];
+    /** Total transfer amount (display metadata) */
+    totalAmount: string;
+    /** Coin ID hex */
+    coinId: string;
+    /** Sender's transport pubkey */
+    senderPubkey: string;
+    /** Optional memo (one per transfer) */
+    memo?: string;
+}
+/**
+ * Type guard for CombinedTransferBundleV6
+ */
+declare function isCombinedTransferBundleV6(obj: unknown): obj is CombinedTransferBundleV6;
+/**
+ * Result of building a split bundle (without sending it)
+ */
+interface BuildSplitBundleResult {
+    /** The constructed V5 bundle */
+    bundle: InstantSplitBundleV5;
+    /** Split group ID for correlation */
+    splitGroupId: string;
+    /** Call this after transport delivery to start background mint proof + change token creation */
+    startBackground: () => Promise<void>;
+}
 
 /**
  * Payment Session Types
@@ -942,6 +1006,8 @@ interface Asset {
     readonly confirmedTokenCount: number;
     /** Number of unconfirmed tokens aggregated */
     readonly unconfirmedTokenCount: number;
+    /** Number of tokens currently being sent */
+    readonly transferringTokenCount: number;
     /** Price per whole unit in USD (null if PriceProvider not configured) */
     readonly priceUsd: number | null;
     /** Price per whole unit in EUR (null if PriceProvider not configured) */
@@ -1508,6 +1574,12 @@ interface HistoryRecord {
     recipientNametag?: string;
     /** Optional memo/message attached to the transfer */
     memo?: string;
+    /** All token IDs in a combined transfer (V6 bundle breakdown) */
+    tokenIds?: Array<{
+        id: string;
+        amount: string;
+        source: 'split' | 'direct';
+    }>;
 }
 /**
  * Storage result types
@@ -1599,6 +1671,7 @@ interface TxfStorageDataBase {
     _outbox?: TxfOutboxEntry[];
     _sent?: TxfSentEntry[];
     _invalid?: TxfInvalidEntry[];
+    _history?: HistoryRecord[];
     [key: `_${string}`]: unknown;
 }
 interface TxfMeta {
@@ -2577,6 +2650,7 @@ declare class PaymentsModule {
     private loadedPromise;
     private loaded;
     private processedSplitGroupIds;
+    private processedCombinedTransferIds;
     private storageEventUnsubscribers;
     private syncDebounceTimer;
     private static readonly SYNC_DEBOUNCE_MS;
@@ -2646,6 +2720,43 @@ declare class PaymentsModule {
      * @returns InstantSplitResult with timing info
      */
     sendInstant(request: TransferRequest, options?: InstantSplitOptions): Promise<InstantSplitResult>;
+    /**
+     * Save a V5 split bundle as an unconfirmed token (shared by V5 standalone and V6 combined).
+     * Returns the created UI token, or null if deduped.
+     *
+     * @param deferPersistence - If true, skip addToken/save calls (caller batches them).
+     *   The token is still added to the in-memory map for dedup; caller must call save().
+     */
+    private saveUnconfirmedV5Token;
+    /**
+     * Save a commitment-only (NOSTR-FIRST) token and start proof polling.
+     * Shared by standalone NOSTR-FIRST handler and V6 combined handler.
+     * Returns the created UI token, or null if deduped/tombstoned.
+     *
+     * @param deferPersistence - If true, skip save() and commitment submission
+     *   (caller batches them). Token is added to in-memory map + proof polling is queued.
+     * @param skipGenesisDedup - If true, skip genesis-ID-only dedup. V6 handler sets this
+     *   because bundle-level dedup protects against replays, and split children share genesis IDs.
+     */
+    private saveCommitmentOnlyToken;
+    /**
+     * Process a received COMBINED_TRANSFER V6 bundle.
+     *
+     * Unpacks a single Nostr message into its component tokens:
+     * - Optional V5 split bundle (saved as unconfirmed, resolved lazily)
+     * - Zero or more direct tokens (saved as unconfirmed, proof-polled)
+     *
+     * Emits ONE transfer:incoming event and records ONE history entry.
+     */
+    private processCombinedTransferBundle;
+    /**
+     * Persist processed combined transfer IDs to KV storage.
+     */
+    private saveProcessedCombinedTransferIds;
+    /**
+     * Load processed combined transfer IDs from KV storage.
+     */
+    private loadProcessedCombinedTransferIds;
     /**
      * Process a received INSTANT_SPLIT bundle.
      *
@@ -2836,7 +2947,8 @@ declare class PaymentsModule {
     getAssets(coinId?: string): Promise<Asset[]>;
     /**
      * Aggregate tokens by coinId with confirmed/unconfirmed breakdown.
-     * Excludes tokens with status 'spent', 'invalid', or 'transferring'.
+     * Excludes tokens with status 'spent' or 'invalid'.
+     * Tokens with status 'transferring' are counted as unconfirmed (visible in UI as "Sending").
      */
     private aggregateTokens;
     /**
@@ -3087,6 +3199,13 @@ declare class PaymentsModule {
      * Also performs one-time migration from legacy KV storage.
      */
     loadHistory(): Promise<void>;
+    /**
+     * Import history entries from remote TXF data into local store.
+     * Delegates to the local TokenStorageProvider's importHistoryEntries() for
+     * persistent storage, with in-memory fallback.
+     * Reused by both load() (initial IPFS fetch) and _doSync() (merge result).
+     */
+    private importRemoteHistoryEntries;
     /**
      * Get the first local token storage provider (for history operations).
      */
@@ -3236,7 +3355,7 @@ declare class PaymentsModule {
     /**
      * Handle NOSTR-FIRST commitment-only transfer (recipient side)
      * This is called when receiving a transfer with only commitmentData and no proof yet.
-     * We create the token as 'submitted', submit commitment (idempotent), and poll for proof.
+     * Delegates to saveCommitmentOnlyToken() helper, then emits event + records history.
      */
     private handleCommitmentOnlyTransfer;
     /**
@@ -3779,6 +3898,8 @@ declare const STORAGE_KEYS_ADDRESS: {
     readonly GROUP_CHAT_PROCESSED_EVENTS: "group_chat_processed_events";
     /** Processed V5 split group IDs for Nostr re-delivery dedup */
     readonly PROCESSED_SPLIT_GROUP_IDS: "processed_split_group_ids";
+    /** Processed V6 combined transfer IDs for Nostr re-delivery dedup */
+    readonly PROCESSED_COMBINED_TRANSFER_IDS: "processed_combined_transfer_ids";
 };
 /** @deprecated Use STORAGE_KEYS_GLOBAL and STORAGE_KEYS_ADDRESS instead */
 declare const STORAGE_KEYS: {
@@ -3804,6 +3925,8 @@ declare const STORAGE_KEYS: {
     readonly GROUP_CHAT_PROCESSED_EVENTS: "group_chat_processed_events";
     /** Processed V5 split group IDs for Nostr re-delivery dedup */
     readonly PROCESSED_SPLIT_GROUP_IDS: "processed_split_group_ids";
+    /** Processed V6 combined transfer IDs for Nostr re-delivery dedup */
+    readonly PROCESSED_COMBINED_TRANSFER_IDS: "processed_combined_transfer_ids";
     /** Encrypted BIP39 mnemonic */
     readonly MNEMONIC: "mnemonic";
     /** Encrypted master private key */
@@ -5472,6 +5595,7 @@ declare function buildTxfStorageData(tokens: Token[], meta: Omit<TxfMeta$1, 'for
     outboxEntries?: OutboxEntry[];
     mintOutboxEntries?: MintOutboxEntry[];
     invalidatedNametags?: InvalidatedNametagEntry[];
+    historyEntries?: HistoryRecord[];
 }): Promise<TxfStorageData>;
 interface ParsedStorageData {
     tokens: Token[];
@@ -5483,6 +5607,7 @@ interface ParsedStorageData {
     outboxEntries: OutboxEntry[];
     mintOutboxEntries: MintOutboxEntry[];
     invalidatedNametags: InvalidatedNametagEntry[];
+    historyEntries: HistoryRecord[];
     validationErrors: string[];
 }
 /**
@@ -6624,4 +6749,4 @@ declare function getCoinIdBySymbol(symbol: string): string | undefined;
  */
 declare function getCoinIdByName(name: string): string | undefined;
 
-export { type AddressInfo, type AddressMode, type AggregatorClient, type AggregatorEvent, type AggregatorEventCallback, type AggregatorEventType, type AggregatorProvider, type AggregatorProviderConfig, type Asset, type BackgroundProgressStatus, type BaseProvider, type BroadcastHandler, type BroadcastMessage, type CMasterKeyData, COIN_TYPES, type CheckNetworkHealthOptions, CoinGeckoPriceProvider, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, type ComposingIndicator, type ConversationPage, type CreateGroupOptions, DEFAULT_AGGREGATOR_TIMEOUT, DEFAULT_AGGREGATOR_URL, DEFAULT_DERIVATION_PATH, DEFAULT_ELECTRUM_URL, DEFAULT_GROUP_RELAYS, DEFAULT_IPFS_BOOTSTRAP_PEERS, DEFAULT_IPFS_GATEWAYS, DEFAULT_MARKET_API_URL, DEFAULT_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DerivationMode, type DirectMessage, type DiscoverAddressProgress, type DiscoverAddressesOptions, type DiscoverAddressesResult, type DiscoveredAddress, type ExtendedValidationResult, type FullIdentity, type GetConversationPageOptions, GroupChatModule, type GroupChatModuleConfig, type GroupChatModuleDependencies, type GroupData, type GroupMemberData, type GroupMessageData, GroupRole, GroupVisibility, type HealthCheckFn, type Identity, type IdentityConfig, type InclusionProof, type IncomingBroadcast, type IncomingMessage, type IncomingPaymentRequest$1 as IncomingPaymentRequest, type IncomingTokenTransfer, type IncomingTransfer, type InitProgress, type InitProgressCallback, type InitProgressStep, type InstantSplitBundle, type InstantSplitBundleV4, type InstantSplitBundleV5, type InstantSplitOptions, type InstantSplitProcessResult, type InstantSplitResult, type InstantSplitV5RecoveryMetadata, type IntentStatus, type IntentType, type InvalidatedNametagEntry, index as L1, type L1Balance, L1PaymentsModule, type L1PaymentsModuleConfig, type L1PaymentsModuleDependencies, type L1SendRequest, type L1SendResult, type L1Transaction, type L1Utxo, LIMITS, type LegacyFileImportOptions, type LegacyFileInfo, type LegacyFileParseResult, type LegacyFileParsedData, type LegacyFileType, type LoadResult, type LoggingConfig, type MarketIntent, MarketModule, type MarketModuleConfig, type MarketModuleDependencies, type MessageHandler, type MintOutboxEntry, type MintParams, type MintResult, NETWORKS, NIP29_KINDS, NOSTR_EVENT_KINDS, type NametagData, type NetworkHealthResult, type NetworkType, type OracleEvent, type OracleEventCallback, type OracleEventType, type OracleProvider, type OutboxEntry, type OutgoingPaymentRequest, type ParsedStorageData, type PaymentRequest, type PaymentRequestHandler$1 as PaymentRequestHandler, type PaymentRequestResponse, type PaymentRequestResponseHandler$1 as PaymentRequestResponseHandler, type PaymentRequestResponseType$1 as PaymentRequestResponseType, type PaymentRequestResult, type PaymentRequestStatus, type PaymentSession, type PaymentSessionDirection, type PaymentSessionError, type PaymentSessionErrorCode, type PaymentSessionStatus, PaymentsModule, type PaymentsModuleConfig, type PaymentsModuleDependencies, type PeerInfo, type PendingV5Finalization, type PostIntentRequest, type PostIntentResult, type PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RegistryNetwork, STORAGE_KEYS, STORAGE_KEYS_ADDRESS, STORAGE_KEYS_GLOBAL, STORAGE_PREFIX, type SaveResult, type ScanAddressProgress, type ScanAddressesOptions, type ScanAddressesResult, type ScannedAddressResult, type SearchFilters, type SearchIntentResult, type SearchOptions, type SearchResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereConfig, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, type SphereImportOptions, type SphereInitOptions, type SphereInitResult, type SphereLoadOptions, type SphereStatus, type SplitPaymentSession, type SplitRecoveryResult, type StorageEvent, type StorageEventCallback, type StorageEventType, type StorageProvider, type StorageProviderConfig, type SubmitResult, type SyncResult, TEST_AGGREGATOR_URL, TEST_ELECTRUM_URL, TEST_NOSTR_RELAYS, TIMEOUTS, type Token, type TokenDefinition, type TokenIcon, type TokenPrice, TokenRegistry, type TokenState, type TokenStatus, type TokenStorageProvider, type TokenTransferDetail, type TokenTransferHandler, type TokenTransferPayload, type ValidationResult as TokenValidationResult, TokenValidator, type TombstoneEntry, type TrackedAddress, type TrackedAddressEntry, type TransactionHistoryEntry, type TransferCommitment, type TransferMode, type TransferRequest, type TransferResult, type TransferStatus, type TransportEvent, type TransportEventCallback, type TransportEventType, type TransportProvider, type TransportProviderConfig, type TrustBaseLoader, type TxfAuthenticator, type TxfGenesis, type TxfGenesisData, type TxfInclusionProof, type TxfIntegrity, type TxfInvalidEntry, type TxfMerkleStep, type TxfMerkleTreePath, type TxfMeta, type TxfOutboxEntry, type TxfSentEntry, type TxfState, type TxfStorageData, type TxfStorageDataBase, type TxfToken, type TxfTombstone, type TxfTransaction, type UnconfirmedResolutionResult, type V5FinalizationStage, type ValidationAction, type ValidationIssue, type ValidationResult$1 as ValidationResult, type WaitOptions, type WalletDatInfo, type WalletInfo, type WalletJSON$1 as WalletJSON, type WalletJSONExportOptions$1 as WalletJSONExportOptions, type WalletSource, archivedKeyFromTokenId, base58Decode, base58Encode, buildTxfStorageData, bytesToHex, checkNetworkHealth, countCommittedTransactions, createAddress, createCommunicationsModule, createGroupChatModule, createKeyPair, createL1PaymentsModule, createMarketModule, createPaymentSession, createPaymentSessionError, createPaymentsModule, createPriceProvider, createSphere, createSplitPaymentSession, createTokenValidator, decodeBech32, decryptCMasterKey, decryptPrivateKey, decryptTextFormatKey, deriveAddressInfo, deriveChildKey$1 as deriveChildKey, deriveKeyAtPath$1 as deriveKeyAtPath, doubleSha256, encodeBech32, extractFromText, findPattern, forkedKeyFromTokenIdAndState, formatAmount, generateMasterKey, generateMnemonic, getAddressHrp, getAddressId, getAddressStorageKey, getCoinIdByName, getCoinIdBySymbol, getCurrentStateHash, getPublicKey, getSphere, getTokenDecimals, getTokenDefinition, getTokenIconUrl, getTokenId, getTokenName, getTokenSymbol, hasMissingNewStateHash, hasUncommittedTransactions, hasValidTxfData, hash160, hexToBytes, identityFromMnemonicSync, initSphere, isArchivedKey, isForkedKey, isInstantSplitBundle, isInstantSplitBundleV4, isInstantSplitBundleV5, isKnownToken, isPaymentSessionTerminal, isPaymentSessionTimedOut, isSQLiteDatabase, isTextWalletEncrypted, isTokenKey, isValidBech32, isValidNametag, isValidPrivateKey, isValidTokenId, isWalletDatEncrypted, isWalletTextFormat, keyFromTokenId, loadSphere, mnemonicToSeedSync, normalizeSdkTokenToStorage, objectToTxf, parseAndDecryptWalletDat, parseAndDecryptWalletText, parseForkedKey, parseTxfStorageData, parseWalletDat, parseWalletText, randomBytes, randomHex, randomUUID, ripemd160, sha256, sleep, sphereExists, toHumanReadable, toSmallestUnit, tokenIdFromArchivedKey, tokenIdFromKey, tokenToTxf, txfToToken, validateMnemonic };
+export { type AddressInfo, type AddressMode, type AggregatorClient, type AggregatorEvent, type AggregatorEventCallback, type AggregatorEventType, type AggregatorProvider, type AggregatorProviderConfig, type Asset, type BackgroundProgressStatus, type BaseProvider, type BroadcastHandler, type BroadcastMessage, type BuildSplitBundleResult, type CMasterKeyData, COIN_TYPES, type CheckNetworkHealthOptions, CoinGeckoPriceProvider, type CombinedTransferBundleV6, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, type ComposingIndicator, type ConversationPage, type CreateGroupOptions, DEFAULT_AGGREGATOR_TIMEOUT, DEFAULT_AGGREGATOR_URL, DEFAULT_DERIVATION_PATH, DEFAULT_ELECTRUM_URL, DEFAULT_GROUP_RELAYS, DEFAULT_IPFS_BOOTSTRAP_PEERS, DEFAULT_IPFS_GATEWAYS, DEFAULT_MARKET_API_URL, DEFAULT_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DerivationMode, type DirectMessage, type DirectTokenEntry, type DiscoverAddressProgress, type DiscoverAddressesOptions, type DiscoverAddressesResult, type DiscoveredAddress, type ExtendedValidationResult, type FullIdentity, type GetConversationPageOptions, GroupChatModule, type GroupChatModuleConfig, type GroupChatModuleDependencies, type GroupData, type GroupMemberData, type GroupMessageData, GroupRole, GroupVisibility, type HealthCheckFn, type Identity, type IdentityConfig, type InclusionProof, type IncomingBroadcast, type IncomingMessage, type IncomingPaymentRequest$1 as IncomingPaymentRequest, type IncomingTokenTransfer, type IncomingTransfer, type InitProgress, type InitProgressCallback, type InitProgressStep, type InstantSplitBundle, type InstantSplitBundleV4, type InstantSplitBundleV5, type InstantSplitOptions, type InstantSplitProcessResult, type InstantSplitResult, type InstantSplitV5RecoveryMetadata, type IntentStatus, type IntentType, type InvalidatedNametagEntry, index as L1, type L1Balance, L1PaymentsModule, type L1PaymentsModuleConfig, type L1PaymentsModuleDependencies, type L1SendRequest, type L1SendResult, type L1Transaction, type L1Utxo, LIMITS, type LegacyFileImportOptions, type LegacyFileInfo, type LegacyFileParseResult, type LegacyFileParsedData, type LegacyFileType, type LoadResult, type LoggingConfig, type MarketIntent, MarketModule, type MarketModuleConfig, type MarketModuleDependencies, type MessageHandler, type MintOutboxEntry, type MintParams, type MintResult, NETWORKS, NIP29_KINDS, NOSTR_EVENT_KINDS, type NametagData, type NetworkHealthResult, type NetworkType, type OracleEvent, type OracleEventCallback, type OracleEventType, type OracleProvider, type OutboxEntry, type OutgoingPaymentRequest, type ParsedStorageData, type PaymentRequest, type PaymentRequestHandler$1 as PaymentRequestHandler, type PaymentRequestResponse, type PaymentRequestResponseHandler$1 as PaymentRequestResponseHandler, type PaymentRequestResponseType$1 as PaymentRequestResponseType, type PaymentRequestResult, type PaymentRequestStatus, type PaymentSession, type PaymentSessionDirection, type PaymentSessionError, type PaymentSessionErrorCode, type PaymentSessionStatus, PaymentsModule, type PaymentsModuleConfig, type PaymentsModuleDependencies, type PeerInfo, type PendingV5Finalization, type PostIntentRequest, type PostIntentResult, type PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RegistryNetwork, STORAGE_KEYS, STORAGE_KEYS_ADDRESS, STORAGE_KEYS_GLOBAL, STORAGE_PREFIX, type SaveResult, type ScanAddressProgress, type ScanAddressesOptions, type ScanAddressesResult, type ScannedAddressResult, type SearchFilters, type SearchIntentResult, type SearchOptions, type SearchResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereConfig, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, type SphereImportOptions, type SphereInitOptions, type SphereInitResult, type SphereLoadOptions, type SphereStatus, type SplitPaymentSession, type SplitRecoveryResult, type StorageEvent, type StorageEventCallback, type StorageEventType, type StorageProvider, type StorageProviderConfig, type SubmitResult, type SyncResult, TEST_AGGREGATOR_URL, TEST_ELECTRUM_URL, TEST_NOSTR_RELAYS, TIMEOUTS, type Token, type TokenDefinition, type TokenIcon, type TokenPrice, TokenRegistry, type TokenState, type TokenStatus, type TokenStorageProvider, type TokenTransferDetail, type TokenTransferHandler, type TokenTransferPayload, type ValidationResult as TokenValidationResult, TokenValidator, type TombstoneEntry, type TrackedAddress, type TrackedAddressEntry, type TransactionHistoryEntry, type TransferCommitment, type TransferMode, type TransferRequest, type TransferResult, type TransferStatus, type TransportEvent, type TransportEventCallback, type TransportEventType, type TransportProvider, type TransportProviderConfig, type TrustBaseLoader, type TxfAuthenticator, type TxfGenesis, type TxfGenesisData, type TxfInclusionProof, type TxfIntegrity, type TxfInvalidEntry, type TxfMerkleStep, type TxfMerkleTreePath, type TxfMeta, type TxfOutboxEntry, type TxfSentEntry, type TxfState, type TxfStorageData, type TxfStorageDataBase, type TxfToken, type TxfTombstone, type TxfTransaction, type UnconfirmedResolutionResult, type V5FinalizationStage, type ValidationAction, type ValidationIssue, type ValidationResult$1 as ValidationResult, type WaitOptions, type WalletDatInfo, type WalletInfo, type WalletJSON$1 as WalletJSON, type WalletJSONExportOptions$1 as WalletJSONExportOptions, type WalletSource, archivedKeyFromTokenId, base58Decode, base58Encode, buildTxfStorageData, bytesToHex, checkNetworkHealth, countCommittedTransactions, createAddress, createCommunicationsModule, createGroupChatModule, createKeyPair, createL1PaymentsModule, createMarketModule, createPaymentSession, createPaymentSessionError, createPaymentsModule, createPriceProvider, createSphere, createSplitPaymentSession, createTokenValidator, decodeBech32, decryptCMasterKey, decryptPrivateKey, decryptTextFormatKey, deriveAddressInfo, deriveChildKey$1 as deriveChildKey, deriveKeyAtPath$1 as deriveKeyAtPath, doubleSha256, encodeBech32, extractFromText, findPattern, forkedKeyFromTokenIdAndState, formatAmount, generateMasterKey, generateMnemonic, getAddressHrp, getAddressId, getAddressStorageKey, getCoinIdByName, getCoinIdBySymbol, getCurrentStateHash, getPublicKey, getSphere, getTokenDecimals, getTokenDefinition, getTokenIconUrl, getTokenId, getTokenName, getTokenSymbol, hasMissingNewStateHash, hasUncommittedTransactions, hasValidTxfData, hash160, hexToBytes, identityFromMnemonicSync, initSphere, isArchivedKey, isCombinedTransferBundleV6, isForkedKey, isInstantSplitBundle, isInstantSplitBundleV4, isInstantSplitBundleV5, isKnownToken, isPaymentSessionTerminal, isPaymentSessionTimedOut, isSQLiteDatabase, isTextWalletEncrypted, isTokenKey, isValidBech32, isValidNametag, isValidPrivateKey, isValidTokenId, isWalletDatEncrypted, isWalletTextFormat, keyFromTokenId, loadSphere, mnemonicToSeedSync, normalizeSdkTokenToStorage, objectToTxf, parseAndDecryptWalletDat, parseAndDecryptWalletText, parseForkedKey, parseTxfStorageData, parseWalletDat, parseWalletText, randomBytes, randomHex, randomUUID, ripemd160, sha256, sleep, sphereExists, toHumanReadable, toSmallestUnit, tokenIdFromArchivedKey, tokenIdFromKey, tokenToTxf, txfToToken, validateMnemonic };