@unicitylabs/sphere-sdk 0.3.4 → 0.3.6

package/dist/index.d.ts

@@ -3320,6 +3320,155 @@ 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
@@ -3374,6 +3523,10 @@ declare const STORAGE_KEYS: {
     readonly GROUP_CHAT_PROCESSED_EVENTS: "group_chat_processed_events";
     /** Group chat: last used relay URL (stale data detection) */
     readonly GROUP_CHAT_RELAY_URL: "group_chat_relay_url";
+    /** Cached token registry JSON (fetched from remote) */
+    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";
 };
 /** Default Nostr relays */
 declare const DEFAULT_NOSTR_RELAYS: readonly ["wss://relay.unicity.network", "wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
@@ -3472,6 +3625,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
     readonly testnet: {
         readonly name: "Testnet";
@@ -3480,6 +3634,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
     readonly dev: {
         readonly name: "Development";
@@ -3488,6 +3643,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
 };
 type NetworkType = keyof typeof NETWORKS;
@@ -3504,6 +3660,8 @@ 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 */
@@ -3669,6 +3827,8 @@ 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 {
@@ -3694,6 +3854,8 @@ 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 {
@@ -3727,6 +3889,8 @@ 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 {
@@ -3774,6 +3938,8 @@ 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 {
@@ -3811,6 +3977,7 @@ declare class Sphere {
     private _payments;
     private _communications;
     private _groupChat;
+    private _market;
     private eventHandlers;
     private _disabledProviders;
     private _providerEventCleanups;
@@ -3858,6 +4025,13 @@ declare class Sphere {
      * (different input shape: { enabled?, relays? }). Both fill relay URLs from network defaults.
      */
     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
+     */
+    private static resolveMarketConfig;
     /**
      * Create new wallet with mnemonic
      */
@@ -3916,6 +4090,8 @@ 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 */
@@ -5704,8 +5880,9 @@ declare namespace index {
  * Token Registry
  *
  * Provides token definitions (metadata) for known tokens on the Unicity network.
- * Uses bundled static data for offline access and consistency.
+ * Fetches from a remote URL, caches in StorageProvider, and refreshes periodically.
  */
+
 /**
  * Icon entry for token
  */
@@ -5737,18 +5914,45 @@ interface TokenDefinition {
  * Network type for registry lookup
  */
 type RegistryNetwork = 'testnet' | 'mainnet' | 'dev';
+/**
+ * Configuration options for remote registry refresh
+ */
+interface TokenRegistryConfig {
+    /** Remote URL to fetch token definitions from */
+    remoteUrl?: string;
+    /** StorageProvider for persistent caching */
+    storage?: StorageProvider;
+    /** Refresh interval in ms (default: 1 hour) */
+    refreshIntervalMs?: number;
+    /** Start auto-refresh immediately (default: true) */
+    autoRefresh?: boolean;
+}
 /**
  * Token Registry service
  *
  * Provides lookup functionality for token definitions by coin ID.
  * Uses singleton pattern for efficient memory usage.
  *
+ * Data flow:
+ * 1. On `configure()`: load cached definitions from StorageProvider (if fresh)
+ * 2. Fetch from remote URL in background
+ * 3. On successful fetch: update in-memory maps + persist to StorageProvider
+ * 4. Repeat every `refreshIntervalMs` (default 1 hour)
+ *
+ * If no cache and no network — registry is empty (lookup methods return fallbacks).
+ *
  * @example
  * ```ts
  * import { TokenRegistry } from '@unicitylabs/sphere-sdk';
  *
+ * // Usually called automatically by createBrowserProviders / createNodeProviders
+ * TokenRegistry.configure({
+ *   remoteUrl: 'https://raw.githubusercontent.com/.../unicity-ids.testnet.json',
+ *   storage: myStorageProvider,
+ * });
+ *
  * const registry = TokenRegistry.getInstance();
- * const def = registry.getDefinition('455ad8720656b08e8dbd5bac1f3c73eeea5431565f6c1c3af742b1aa12d41d89');
+ * const def = registry.getDefinition('455ad87...');
  * console.log(def?.symbol); // 'UCT'
  * ```
  */
@@ -5757,19 +5961,79 @@ declare class TokenRegistry {
     private readonly definitionsById;
     private readonly definitionsBySymbol;
     private readonly definitionsByName;
+    private remoteUrl;
+    private storage;
+    private refreshIntervalMs;
+    private refreshTimer;
+    private lastRefreshAt;
+    private refreshPromise;
     private constructor();
     /**
      * Get singleton instance of TokenRegistry
      */
     static getInstance(): TokenRegistry;
     /**
-     * Reset the singleton instance (useful for testing)
+     * Configure remote registry refresh with persistent caching.
+     *
+     * On first call:
+     * 1. Loads cached data from StorageProvider (if available and fresh)
+     * 2. Starts periodic remote fetch (if autoRefresh is true, which is default)
+     *
+     * @param options - Configuration options
+     * @param options.remoteUrl - Remote URL to fetch definitions from
+     * @param options.storage - StorageProvider for persistent caching
+     * @param options.refreshIntervalMs - Refresh interval in ms (default: 1 hour)
+     * @param options.autoRefresh - Start auto-refresh immediately (default: true)
+     */
+    static configure(options: TokenRegistryConfig): void;
+    /**
+     * Reset the singleton instance (useful for testing).
+     * Stops auto-refresh if running.
      */
     static resetInstance(): void;
     /**
-     * Load registry data from bundled JSON
+     * Destroy the singleton: stop auto-refresh and reset.
+     */
+    static destroy(): void;
+    /**
+     * Load definitions from StorageProvider cache.
+     * Only applies if cache exists and is fresh (within refreshIntervalMs).
+     */
+    private loadFromCache;
+    /**
+     * Save definitions to StorageProvider cache.
+     */
+    private saveToCache;
+    /**
+     * Apply an array of token definitions to the internal maps.
+     * Clears existing data before applying.
+     */
+    private applyDefinitions;
+    /**
+     * Validate that data is an array of objects with 'id' field
+     */
+    private isValidDefinitionsArray;
+    /**
+     * Fetch token definitions from the remote URL and update the registry.
+     * On success, also persists to StorageProvider cache.
+     * Returns true on success, false on failure. On failure, existing data is preserved.
+     * Concurrent calls are deduplicated — only one fetch runs at a time.
+     */
+    refreshFromRemote(): Promise<boolean>;
+    private doRefresh;
+    /**
+     * Start periodic auto-refresh from the remote URL.
+     * Does an immediate fetch, then repeats at the configured interval.
+     */
+    startAutoRefresh(intervalMs?: number): void;
+    /**
+     * Stop periodic auto-refresh
+     */
+    stopAutoRefresh(): void;
+    /**
+     * Timestamp of the last successful remote refresh (0 if never refreshed)
      */
-    private loadRegistry;
+    getLastRefreshAt(): number;
     /**
      * Get token definition by hex coin ID
      * @param coinId - 64-character hex string
@@ -5897,4 +6161,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_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 };
+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 };