@unicitylabs/sphere-sdk 0.3.6 → 0.3.8

package/dist/index.d.ts

@@ -2220,6 +2220,7 @@ type AggregatorEventCallback = OracleEventCallback;
  * Platform-independent abstraction for fetching token market prices.
  * Does not extend BaseProvider — stateless HTTP client with internal caching.
  */
+
 /**
  * Supported price provider platforms
  */
@@ -2255,6 +2256,8 @@ interface PriceProviderConfig {
     timeout?: number;
     /** Enable debug logging */
     debug?: boolean;
+    /** StorageProvider for persistent caching across page reloads (optional) */
+    storage?: StorageProvider;
 }
 /**
  * Price data provider
@@ -2281,7 +2284,7 @@ interface PriceProvider {
     /**
      * Get price for a single token
      * @param tokenName - Token name (e.g., 'bitcoin')
-     * @returns Token price or null if not available
+     * @returns Token price (zero-price entry for tokens not listed on the platform), or null on network error with no cache
      */
     getPrice(tokenName: string): Promise<TokenPrice | null>;
     /**
@@ -2295,6 +2298,7 @@ interface PriceProvider {
  *
  * Fetches token prices from CoinGecko API with internal caching.
  * Supports both free and pro API tiers.
+ * Optionally persists cache to StorageProvider for survival across page reloads.
  */
 
 /**
@@ -2308,6 +2312,9 @@ interface PriceProvider {
  * // Pro tier
  * const provider = new CoinGeckoPriceProvider({ apiKey: 'CG-xxx' });
  *
+ * // With persistent cache (survives page reloads)
+ * const provider = new CoinGeckoPriceProvider({ storage: myStorageProvider });
+ *
  * const prices = await provider.getPrices(['bitcoin', 'ethereum']);
  * console.log(prices.get('bitcoin')?.priceUsd);
  * ```
@@ -2320,8 +2327,33 @@ declare class CoinGeckoPriceProvider implements PriceProvider {
     private readonly timeout;
     private readonly debug;
     private readonly baseUrl;
+    private readonly storage;
+    /** In-flight fetch promise for deduplication of concurrent getPrices() calls */
+    private fetchPromise;
+    /** Token names being fetched in the current in-flight request */
+    private fetchNames;
+    /** Whether persistent cache has been loaded into memory */
+    private persistentCacheLoaded;
+    /** Promise for loading persistent cache (deduplication) */
+    private loadCachePromise;
     constructor(config?: Omit<PriceProviderConfig, 'platform'>);
     getPrices(tokenNames: string[]): Promise<Map<string, TokenPrice>>;
+    private doFetch;
+    /**
+     * Load cached prices from StorageProvider into in-memory cache.
+     * Only loads entries that are still within cacheTtlMs.
+     */
+    private loadFromStorage;
+    private doLoadFromStorage;
+    /**
+     * Save current prices to StorageProvider (fire-and-forget).
+     */
+    private saveToStorage;
+    /**
+     * On 429 rate-limit, extend stale cache entries so subsequent calls
+     * don't immediately retry and hammer the API.
+     */
+    private extendCacheOnRateLimit;
     getPrice(tokenName: string): Promise<TokenPrice | null>;
     clearCache(): void;
 }
@@ -3320,155 +3352,6 @@ declare class GroupChatModule {
 }
 declare function createGroupChatModule(config?: GroupChatModuleConfig): GroupChatModule;
 
-/**
- * Market Module Types
- * Intent bulletin board for posting and discovering intents,
- * plus real-time feed subscription.
- */
-type IntentType = 'buy' | 'sell' | 'service' | 'announcement' | 'other' | (string & {});
-type IntentStatus = 'active' | 'closed' | 'expired';
-interface MarketModuleConfig {
-    /** Market API base URL (default: https://market-api.unicity.network) */
-    apiUrl?: string;
-    /** Request timeout in ms (default: 30000) */
-    timeout?: number;
-}
-interface MarketModuleDependencies {
-    identity: FullIdentity;
-    emitEvent: <T extends SphereEventType>(type: T, data: SphereEventMap[T]) => void;
-}
-interface PostIntentRequest {
-    description: string;
-    intentType: IntentType;
-    category?: string;
-    price?: number;
-    currency?: string;
-    location?: string;
-    contactHandle?: string;
-    expiresInDays?: number;
-}
-interface PostIntentResult {
-    intentId: string;
-    message: string;
-    expiresAt: string;
-}
-interface MarketIntent {
-    id: string;
-    intentType: IntentType;
-    category?: string;
-    price?: string;
-    currency: string;
-    location?: string;
-    status: IntentStatus;
-    createdAt: string;
-    expiresAt: string;
-}
-interface SearchIntentResult {
-    id: string;
-    score: number;
-    agentNametag?: string;
-    agentPublicKey: string;
-    description: string;
-    intentType: IntentType;
-    category?: string;
-    price?: number;
-    currency: string;
-    location?: string;
-    contactMethod: string;
-    contactHandle?: string;
-    createdAt: string;
-    expiresAt: string;
-}
-interface SearchFilters {
-    intentType?: IntentType;
-    category?: string;
-    minPrice?: number;
-    maxPrice?: number;
-    location?: string;
-    /** Minimum similarity score (0–1). Results below this threshold are excluded (client-side). */
-    minScore?: number;
-}
-interface SearchOptions {
-    filters?: SearchFilters;
-    limit?: number;
-}
-interface SearchResult {
-    intents: SearchIntentResult[];
-    count: number;
-}
-/** A listing broadcast on the live feed */
-interface FeedListing {
-    id: string;
-    title: string;
-    descriptionPreview: string;
-    agentName: string;
-    agentId: number;
-    type: IntentType;
-    createdAt: string;
-}
-/** WebSocket message: initial batch of recent listings */
-interface FeedInitialMessage {
-    type: 'initial';
-    listings: FeedListing[];
-}
-/** WebSocket message: single new listing */
-interface FeedNewMessage {
-    type: 'new';
-    listing: FeedListing;
-}
-type FeedMessage = FeedInitialMessage | FeedNewMessage;
-/** Callback for live feed events */
-type FeedListener = (message: FeedMessage) => void;
-
-/**
- * Market Module
- *
- * Intent bulletin board — post and discover intents (buy, sell,
- * service, announcement, other) with secp256k1-signed requests
- * tied to the wallet identity. Includes real-time feed via WebSocket.
- */
-
-declare class MarketModule {
-    private readonly apiUrl;
-    private readonly timeout;
-    private identity;
-    private registered;
-    constructor(config?: MarketModuleConfig);
-    /** Called by Sphere after construction */
-    initialize(deps: MarketModuleDependencies): void;
-    /** No-op — stateless module */
-    load(): Promise<void>;
-    /** No-op — stateless module */
-    destroy(): void;
-    /** Post a new intent (agent is auto-registered on first post) */
-    postIntent(intent: PostIntentRequest): Promise<PostIntentResult>;
-    /** Semantic search for intents (public — no auth required) */
-    search(query: string, opts?: SearchOptions): Promise<SearchResult>;
-    /** List own intents (authenticated) */
-    getMyIntents(): Promise<MarketIntent[]>;
-    /** Close (delete) an intent */
-    closeIntent(intentId: string): Promise<void>;
-    /** Fetch the most recent listings via REST (public — no auth required) */
-    getRecentListings(): Promise<FeedListing[]>;
-    /**
-     * Subscribe to the live listing feed via WebSocket.
-     * Returns an unsubscribe function that closes the connection.
-     *
-     * Requires a WebSocket implementation — works natively in browsers
-     * and in Node.js 21+ (or with the `ws` package).
-     */
-    subscribeFeed(listener: FeedListener): () => void;
-    private ensureIdentity;
-    /** Register the agent's public key with the server (idempotent) */
-    private ensureRegistered;
-    private parseResponse;
-    private apiPost;
-    private apiGet;
-    private apiDelete;
-    private apiPublicPost;
-}
-declare function createMarketModule(config?: MarketModuleConfig): MarketModule;
-
 /**
  * SDK2 Constants
  * Default configuration values and storage keys
@@ -3527,6 +3410,10 @@ declare const STORAGE_KEYS: {
     readonly TOKEN_REGISTRY_CACHE: "token_registry_cache";
     /** Timestamp of last token registry cache update (ms since epoch) */
     readonly TOKEN_REGISTRY_CACHE_TS: "token_registry_cache_ts";
+    /** Cached price data JSON (from CoinGecko or other provider) */
+    readonly PRICE_CACHE: "price_cache";
+    /** Timestamp of last price cache update (ms since epoch) */
+    readonly PRICE_CACHE_TS: "price_cache_ts";
 };
 /** Default Nostr relays */
 declare const DEFAULT_NOSTR_RELAYS: readonly ["wss://relay.unicity.network", "wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
@@ -3660,8 +3547,6 @@ declare const TIMEOUTS: {
     /** Sync interval */
     readonly SYNC_INTERVAL: 60000;
 };
-/** Default Market API URL (intent bulletin board) */
-declare const DEFAULT_MARKET_API_URL: "https://market-api.unicity.network";
 /** Validation limits */
 declare const LIMITS: {
     /** Min nametag length */
@@ -3827,8 +3712,6 @@ interface SphereCreateOptions {
     groupChat?: GroupChatModuleConfig | boolean;
     /** Optional password to encrypt the wallet. If omitted, mnemonic is stored as plaintext. */
     password?: string;
-    /** Market module configuration. true = enable with defaults, object = custom config. */
-    market?: MarketModuleConfig | boolean;
 }
 /** Options for loading existing wallet */
 interface SphereLoadOptions {
@@ -3854,8 +3737,6 @@ interface SphereLoadOptions {
     groupChat?: GroupChatModuleConfig | boolean;
     /** Optional password to decrypt the wallet. Must match the password used during creation. */
     password?: string;
-    /** Market module configuration. true = enable with defaults, object = custom config. */
-    market?: MarketModuleConfig | boolean;
 }
 /** Options for importing a wallet */
 interface SphereImportOptions {
@@ -3889,8 +3770,6 @@ interface SphereImportOptions {
     groupChat?: GroupChatModuleConfig | boolean;
     /** Optional password to encrypt the wallet. If omitted, mnemonic/key is stored as plaintext. */
     password?: string;
-    /** Market module configuration. true = enable with defaults, object = custom config. */
-    market?: MarketModuleConfig | boolean;
 }
 /** L1 (ALPHA blockchain) configuration */
 interface L1Config {
@@ -3938,8 +3817,6 @@ interface SphereInitOptions {
     groupChat?: GroupChatModuleConfig | boolean;
     /** Optional password to encrypt/decrypt the wallet. If omitted, mnemonic is stored as plaintext. */
     password?: string;
-    /** Market module configuration. true = enable with defaults, object = custom config. */
-    market?: MarketModuleConfig | boolean;
 }
 /** Result of init operation */
 interface SphereInitResult {
@@ -3977,7 +3854,6 @@ declare class Sphere {
     private _payments;
     private _communications;
     private _groupChat;
-    private _market;
     private eventHandlers;
     private _disabledProviders;
     private _providerEventCleanups;
@@ -4026,12 +3902,15 @@ declare class Sphere {
      */
     private static resolveGroupChatConfig;
     /**
-     * Resolve market module config from Sphere.init() options.
-     * - `true` → enable with default API URL
-     * - `MarketModuleConfig` → pass through with defaults
-     * - `undefined` → no market module
+     * Configure TokenRegistry in the main bundle context.
+     *
+     * The provider factory functions (createBrowserProviders / createNodeProviders)
+     * are compiled into separate bundles by tsup, each with their own inlined copy
+     * of TokenRegistry. Their TokenRegistry.configure() call configures a different
+     * singleton than the one used by PaymentsModule (which lives in the main bundle).
+     * This method ensures the main bundle's TokenRegistry is properly configured.
      */
-    private static resolveMarketConfig;
+    private static configureTokenRegistry;
     /**
      * Create new wallet with mnemonic
      */
@@ -4090,8 +3969,6 @@ declare class Sphere {
     get communications(): CommunicationsModule;
     /** Group chat module (NIP-29). Null if not configured. */
     get groupChat(): GroupChatModule | null;
-    /** Market module (intent bulletin board). Null if not configured. */
-    get market(): MarketModule | null;
     /** Current identity (public info only) */
     get identity(): Identity | null;
     /** Is ready */
@@ -5967,6 +5844,7 @@ declare class TokenRegistry {
     private refreshTimer;
     private lastRefreshAt;
     private refreshPromise;
+    private initialLoadPromise;
     private constructor();
     /**
      * Get singleton instance of TokenRegistry
@@ -5995,6 +5873,18 @@ declare class TokenRegistry {
      * Destroy the singleton: stop auto-refresh and reset.
      */
     static destroy(): void;
+    /**
+     * Wait for the initial data load (cache or remote) to complete.
+     * Returns true if data was loaded, false if not (timeout or no data source).
+     *
+     * @param timeoutMs - Maximum wait time in ms (default: 10s). Set to 0 for no timeout.
+     */
+    static waitForReady(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Perform initial data load: try cache first, fall back to remote fetch.
+     * After initial data is available, start periodic auto-refresh if configured.
+     */
+    private performInitialLoad;
     /**
      * Load definitions from StorageProvider cache.
      * Only applies if cache exists and is fresh (within refreshIntervalMs).
@@ -6161,4 +6051,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 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 ExtendedValidationResult, type FullIdentity, 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 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_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 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, 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 CMasterKeyData, COIN_TYPES, type CheckNetworkHealthOptions, CoinGeckoPriceProvider, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, 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_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DerivationMode, type DirectMessage, type ExtendedValidationResult, type FullIdentity, 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 InstantSplitBundle, type InstantSplitBundleV4, type InstantSplitBundleV5, type InstantSplitOptions, type InstantSplitProcessResult, type InstantSplitResult, type InstantSplitV5RecoveryMetadata, 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 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 PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RegistryNetwork, STORAGE_KEYS, STORAGE_PREFIX, type SaveResult, type ScanAddressProgress, type ScanAddressesOptions, type ScanAddressesResult, type ScannedAddressResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereConfig, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, 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, 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, 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 };