@unicitylabs/sphere-sdk 0.4.6 → 0.4.8

package/dist/index.d.cts

@@ -1503,6 +1503,14 @@ interface TransportProvider extends BaseProvider {
      * @returns PeerInfo or null if no binding found
      */
     resolveTransportPubkeyInfo?(transportPubkey: string): Promise<PeerInfo | null>;
+    /**
+     * Batch-resolve multiple transport pubkeys to peer info.
+     * Used for HD address discovery: derives transport pubkeys for indices 0..N
+     * and queries binding events in a single batch.
+     * @param transportPubkeys - Array of transport-specific pubkeys to look up
+     * @returns Array of PeerInfo for pubkeys that have binding events (may be shorter than input)
+     */
+    discoverAddresses?(transportPubkeys: string[]): Promise<PeerInfo[]>;
     /**
      * Recover nametag for current identity by decrypting stored encrypted nametag
      * Used after wallet import to recover associated nametag
@@ -3446,6 +3454,12 @@ declare class GroupChatModule {
     onMessage(handler: (message: GroupMessageData) => void): () => void;
     getRelayUrls(): string[];
     getMyPublicKey(): string | null;
+    /**
+     * Returns the latest message timestamp (in Nostr seconds) across the given groups,
+     * or 0 if no messages exist.  Used to set `since` on subscriptions so the relay
+     * only sends events we don't already have.
+     */
+    private getLatestMessageTimestamp;
     private fetchRelayAdmins;
     private doFetchRelayAdmins;
     private fetchGroupMetadataInternal;
@@ -3866,9 +3880,9 @@ declare const COIN_TYPES: {
     readonly TEST: "TEST";
 };
 /** Default Fulcrum electrum server for mainnet */
-declare const DEFAULT_ELECTRUM_URL: "wss://fulcrum.alpha.unicity.network:50004";
+declare const DEFAULT_ELECTRUM_URL: "wss://fulcrum.unicity.network:50004";
 /** Testnet Fulcrum electrum server */
-declare const TEST_ELECTRUM_URL: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+declare const TEST_ELECTRUM_URL: "wss://fulcrum.unicity.network:50004";
 /** Testnet Nostr relays */
 declare const TEST_NOSTR_RELAYS: readonly ["wss://nostr-relay.testnet.unicity.network"];
 /** Default group chat relays (NIP-29 Zooid relay) */
@@ -3880,7 +3894,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://aggregator.unicity.network/rpc";
         readonly nostrRelays: readonly ["wss://relay.unicity.network", "wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.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";
     };
@@ -3889,7 +3903,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://goggregator-test.unicity.network";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.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";
     };
@@ -3898,7 +3912,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://dev-aggregator.dyndns.org/rpc";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.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";
     };
@@ -3990,6 +4004,70 @@ interface ScanAddressesResult {
     scannedCount: number;
 }
 
+/**
+ * HD Address Discovery — discover previously used addresses via transport binding events.
+ *
+ * Derives transport pubkeys for HD indices and batch-queries the relay.
+ * Complements L1 scan (scan.ts) by finding L3-only addresses.
+ */
+
+/** Progress callback for address discovery */
+interface DiscoverAddressProgress {
+    /** Current batch being queried */
+    currentBatch: number;
+    /** Total batches planned */
+    totalBatches: number;
+    /** Number of addresses discovered so far */
+    discoveredCount: number;
+    /** Current gap count (consecutive empty indices) */
+    currentGap: number;
+    /** Phase: 'transport' or 'l1' */
+    phase: 'transport' | 'l1';
+}
+/** Single discovered address result */
+interface DiscoveredAddress {
+    /** HD derivation index */
+    index: number;
+    /** L1 bech32 address (alpha1...) */
+    l1Address: string;
+    /** L3 DIRECT address */
+    directAddress: string;
+    /** 33-byte compressed chain pubkey */
+    chainPubkey: string;
+    /** Nametag (from binding event) */
+    nametag?: string;
+    /** L1 balance in ALPHA (0 if only discovered via transport) */
+    l1Balance: number;
+    /** Discovery source */
+    source: 'transport' | 'l1' | 'both';
+}
+/** Options for address discovery */
+interface DiscoverAddressesOptions {
+    /** Max HD indices to probe (default: 50) */
+    maxAddresses?: number;
+    /** Stop after N consecutive empty indices (default: 20) */
+    gapLimit?: number;
+    /** Batch size for transport queries (default: 20) */
+    batchSize?: number;
+    /** Also run L1 balance scan (default: true) */
+    includeL1Scan?: boolean;
+    /** Progress callback */
+    onProgress?: (progress: DiscoverAddressProgress) => void;
+    /** Abort signal */
+    signal?: AbortSignal;
+    /** Auto-track discovered addresses (default: true) */
+    autoTrack?: boolean;
+}
+/** Result of address discovery */
+interface DiscoverAddressesResult {
+    /** All discovered addresses */
+    addresses: DiscoveredAddress[];
+    /** Total indices scanned */
+    scannedCount: number;
+    /** Whether scan was aborted */
+    aborted: boolean;
+}
+
 /**
  * Legacy File Serialization Types
  */
@@ -4052,6 +4130,17 @@ interface LegacyFileImportOptions {
 
 declare function isValidNametag(nametag: string): boolean;
 
+/** Steps reported by the onProgress callback during wallet init/create/load/import */
+type InitProgressStep = 'clearing' | 'storing_keys' | 'initializing' | 'recovering_nametag' | 'registering_nametag' | 'syncing_identity' | 'syncing_tokens' | 'discovering_addresses' | 'finalizing' | 'complete';
+/** Progress info passed to onProgress callback */
+interface InitProgress {
+    /** Current step identifier */
+    readonly step: InitProgressStep;
+    /** Human-readable description of what's happening */
+    readonly message: string;
+}
+/** Callback for tracking wallet initialization progress */
+type InitProgressCallback = (progress: InitProgress) => void;
 /** Options for creating a new wallet */
 interface SphereCreateOptions {
     /** BIP39 mnemonic (12 or 24 words) */
@@ -4084,6 +4173,15 @@ interface SphereCreateOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to encrypt the wallet. If omitted, mnemonic is stored as plaintext. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses after creation.
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** Options for loading existing wallet */
 interface SphereLoadOptions {
@@ -4111,6 +4209,15 @@ interface SphereLoadOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to decrypt the wallet. Must match the password used during creation. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses on load.
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** Options for importing a wallet */
 interface SphereImportOptions {
@@ -4146,6 +4253,15 @@ interface SphereImportOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to encrypt the wallet. If omitted, mnemonic/key is stored as plaintext. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses after import.
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** L1 (ALPHA blockchain) configuration */
 interface L1Config {
@@ -4195,6 +4311,16 @@ interface SphereInitOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to encrypt/decrypt the wallet. If omitted, mnemonic is stored as plaintext. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses when creating from mnemonic.
+     * Only applies when wallet is newly created (not on load of existing wallet).
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** Result of init operation */
 interface SphereInitResult {
@@ -4466,14 +4592,9 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromJSON(options: {
+    static importFromJSON(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         jsonContent: string;
         password?: string;
-        storage: StorageProvider;
-        transport: TransportProvider;
-        oracle: OracleProvider;
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         mnemonic?: string;
@@ -4509,7 +4630,7 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromLegacyFile(options: {
+    static importFromLegacyFile(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         /** File content - Uint8Array for .dat, string for .txt */
         fileContent: string | Uint8Array;
         /** File name (used for type detection) */
@@ -4518,18 +4639,6 @@ declare class Sphere {
         password?: string;
         /** Progress callback for long decryption operations */
         onDecryptProgress?: DecryptionProgressCallback;
-        /** Storage provider instance */
-        storage: StorageProvider;
-        /** Transport provider instance */
-        transport: TransportProvider;
-        /** Oracle provider instance */
-        oracle: OracleProvider;
-        /** Optional token storage provider */
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        /** Optional nametag to register */
-        nametag?: string;
-        /** L1 (ALPHA blockchain) configuration */
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         sphere?: Sphere;
@@ -4630,6 +4739,11 @@ declare class Sphere {
     switchToAddress(index: number, options?: {
         nametag?: string;
     }): Promise<void>;
+    /**
+     * Background transport sync and nametag operations after address switch.
+     * Runs after switchToAddress returns so L1/L3 queries can start immediately.
+     */
+    private postSwitchSync;
     /**
      * Re-initialize modules after address switch
      */
@@ -4719,6 +4833,22 @@ declare class Sphere {
         hidden: boolean;
         nametag?: string;
     }>): Promise<void>;
+    /**
+     * Discover previously used HD addresses.
+     *
+     * Primary: queries Nostr relay for identity binding events (fast, single batch query).
+     * Secondary: runs L1 balance scan to find legacy addresses with no binding event.
+     *
+     * @example
+     * ```ts
+     * const result = await sphere.discoverAddresses();
+     * console.log(`Found ${result.addresses.length} addresses`);
+     *
+     * // With auto-tracking
+     * await sphere.discoverAddresses({ autoTrack: true });
+     * ```
+     */
+    discoverAddresses(options?: DiscoverAddressesOptions): Promise<DiscoverAddressesResult>;
     /**
      * Get aggregated status of all providers, grouped by role.
      *
@@ -6440,4 +6570,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 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 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 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 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 };

package/dist/index.d.ts

@@ -1503,6 +1503,14 @@ interface TransportProvider extends BaseProvider {
      * @returns PeerInfo or null if no binding found
      */
     resolveTransportPubkeyInfo?(transportPubkey: string): Promise<PeerInfo | null>;
+    /**
+     * Batch-resolve multiple transport pubkeys to peer info.
+     * Used for HD address discovery: derives transport pubkeys for indices 0..N
+     * and queries binding events in a single batch.
+     * @param transportPubkeys - Array of transport-specific pubkeys to look up
+     * @returns Array of PeerInfo for pubkeys that have binding events (may be shorter than input)
+     */
+    discoverAddresses?(transportPubkeys: string[]): Promise<PeerInfo[]>;
     /**
      * Recover nametag for current identity by decrypting stored encrypted nametag
      * Used after wallet import to recover associated nametag
@@ -3446,6 +3454,12 @@ declare class GroupChatModule {
     onMessage(handler: (message: GroupMessageData) => void): () => void;
     getRelayUrls(): string[];
     getMyPublicKey(): string | null;
+    /**
+     * Returns the latest message timestamp (in Nostr seconds) across the given groups,
+     * or 0 if no messages exist.  Used to set `since` on subscriptions so the relay
+     * only sends events we don't already have.
+     */
+    private getLatestMessageTimestamp;
     private fetchRelayAdmins;
     private doFetchRelayAdmins;
     private fetchGroupMetadataInternal;
@@ -3866,9 +3880,9 @@ declare const COIN_TYPES: {
     readonly TEST: "TEST";
 };
 /** Default Fulcrum electrum server for mainnet */
-declare const DEFAULT_ELECTRUM_URL: "wss://fulcrum.alpha.unicity.network:50004";
+declare const DEFAULT_ELECTRUM_URL: "wss://fulcrum.unicity.network:50004";
 /** Testnet Fulcrum electrum server */
-declare const TEST_ELECTRUM_URL: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+declare const TEST_ELECTRUM_URL: "wss://fulcrum.unicity.network:50004";
 /** Testnet Nostr relays */
 declare const TEST_NOSTR_RELAYS: readonly ["wss://nostr-relay.testnet.unicity.network"];
 /** Default group chat relays (NIP-29 Zooid relay) */
@@ -3880,7 +3894,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://aggregator.unicity.network/rpc";
         readonly nostrRelays: readonly ["wss://relay.unicity.network", "wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.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";
     };
@@ -3889,7 +3903,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://goggregator-test.unicity.network";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.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";
     };
@@ -3898,7 +3912,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://dev-aggregator.dyndns.org/rpc";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.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";
     };
@@ -3990,6 +4004,70 @@ interface ScanAddressesResult {
     scannedCount: number;
 }
 
+/**
+ * HD Address Discovery — discover previously used addresses via transport binding events.
+ *
+ * Derives transport pubkeys for HD indices and batch-queries the relay.
+ * Complements L1 scan (scan.ts) by finding L3-only addresses.
+ */
+
+/** Progress callback for address discovery */
+interface DiscoverAddressProgress {
+    /** Current batch being queried */
+    currentBatch: number;
+    /** Total batches planned */
+    totalBatches: number;
+    /** Number of addresses discovered so far */
+    discoveredCount: number;
+    /** Current gap count (consecutive empty indices) */
+    currentGap: number;
+    /** Phase: 'transport' or 'l1' */
+    phase: 'transport' | 'l1';
+}
+/** Single discovered address result */
+interface DiscoveredAddress {
+    /** HD derivation index */
+    index: number;
+    /** L1 bech32 address (alpha1...) */
+    l1Address: string;
+    /** L3 DIRECT address */
+    directAddress: string;
+    /** 33-byte compressed chain pubkey */
+    chainPubkey: string;
+    /** Nametag (from binding event) */
+    nametag?: string;
+    /** L1 balance in ALPHA (0 if only discovered via transport) */
+    l1Balance: number;
+    /** Discovery source */
+    source: 'transport' | 'l1' | 'both';
+}
+/** Options for address discovery */
+interface DiscoverAddressesOptions {
+    /** Max HD indices to probe (default: 50) */
+    maxAddresses?: number;
+    /** Stop after N consecutive empty indices (default: 20) */
+    gapLimit?: number;
+    /** Batch size for transport queries (default: 20) */
+    batchSize?: number;
+    /** Also run L1 balance scan (default: true) */
+    includeL1Scan?: boolean;
+    /** Progress callback */
+    onProgress?: (progress: DiscoverAddressProgress) => void;
+    /** Abort signal */
+    signal?: AbortSignal;
+    /** Auto-track discovered addresses (default: true) */
+    autoTrack?: boolean;
+}
+/** Result of address discovery */
+interface DiscoverAddressesResult {
+    /** All discovered addresses */
+    addresses: DiscoveredAddress[];
+    /** Total indices scanned */
+    scannedCount: number;
+    /** Whether scan was aborted */
+    aborted: boolean;
+}
+
 /**
  * Legacy File Serialization Types
  */
@@ -4052,6 +4130,17 @@ interface LegacyFileImportOptions {
 
 declare function isValidNametag(nametag: string): boolean;
 
+/** Steps reported by the onProgress callback during wallet init/create/load/import */
+type InitProgressStep = 'clearing' | 'storing_keys' | 'initializing' | 'recovering_nametag' | 'registering_nametag' | 'syncing_identity' | 'syncing_tokens' | 'discovering_addresses' | 'finalizing' | 'complete';
+/** Progress info passed to onProgress callback */
+interface InitProgress {
+    /** Current step identifier */
+    readonly step: InitProgressStep;
+    /** Human-readable description of what's happening */
+    readonly message: string;
+}
+/** Callback for tracking wallet initialization progress */
+type InitProgressCallback = (progress: InitProgress) => void;
 /** Options for creating a new wallet */
 interface SphereCreateOptions {
     /** BIP39 mnemonic (12 or 24 words) */
@@ -4084,6 +4173,15 @@ interface SphereCreateOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to encrypt the wallet. If omitted, mnemonic is stored as plaintext. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses after creation.
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** Options for loading existing wallet */
 interface SphereLoadOptions {
@@ -4111,6 +4209,15 @@ interface SphereLoadOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to decrypt the wallet. Must match the password used during creation. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses on load.
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** Options for importing a wallet */
 interface SphereImportOptions {
@@ -4146,6 +4253,15 @@ interface SphereImportOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to encrypt the wallet. If omitted, mnemonic/key is stored as plaintext. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses after import.
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** L1 (ALPHA blockchain) configuration */
 interface L1Config {
@@ -4195,6 +4311,16 @@ interface SphereInitOptions {
     market?: MarketModuleConfig | boolean;
     /** Optional password to encrypt/decrypt the wallet. If omitted, mnemonic is stored as plaintext. */
     password?: string;
+    /**
+     * Auto-discover previously used HD addresses when creating from mnemonic.
+     * Only applies when wallet is newly created (not on load of existing wallet).
+     * - true: discover with defaults (Nostr + L1 scan, autoTrack: true)
+     * - DiscoverAddressesOptions: custom config
+     * - false/undefined: no auto-discovery (default)
+     */
+    discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /** Optional callback to report initialization progress steps */
+    onProgress?: InitProgressCallback;
 }
 /** Result of init operation */
 interface SphereInitResult {
@@ -4466,14 +4592,9 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromJSON(options: {
+    static importFromJSON(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         jsonContent: string;
         password?: string;
-        storage: StorageProvider;
-        transport: TransportProvider;
-        oracle: OracleProvider;
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         mnemonic?: string;
@@ -4509,7 +4630,7 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromLegacyFile(options: {
+    static importFromLegacyFile(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         /** File content - Uint8Array for .dat, string for .txt */
         fileContent: string | Uint8Array;
         /** File name (used for type detection) */
@@ -4518,18 +4639,6 @@ declare class Sphere {
         password?: string;
         /** Progress callback for long decryption operations */
         onDecryptProgress?: DecryptionProgressCallback;
-        /** Storage provider instance */
-        storage: StorageProvider;
-        /** Transport provider instance */
-        transport: TransportProvider;
-        /** Oracle provider instance */
-        oracle: OracleProvider;
-        /** Optional token storage provider */
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        /** Optional nametag to register */
-        nametag?: string;
-        /** L1 (ALPHA blockchain) configuration */
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         sphere?: Sphere;
@@ -4630,6 +4739,11 @@ declare class Sphere {
     switchToAddress(index: number, options?: {
         nametag?: string;
     }): Promise<void>;
+    /**
+     * Background transport sync and nametag operations after address switch.
+     * Runs after switchToAddress returns so L1/L3 queries can start immediately.
+     */
+    private postSwitchSync;
     /**
      * Re-initialize modules after address switch
      */
@@ -4719,6 +4833,22 @@ declare class Sphere {
         hidden: boolean;
         nametag?: string;
     }>): Promise<void>;
+    /**
+     * Discover previously used HD addresses.
+     *
+     * Primary: queries Nostr relay for identity binding events (fast, single batch query).
+     * Secondary: runs L1 balance scan to find legacy addresses with no binding event.
+     *
+     * @example
+     * ```ts
+     * const result = await sphere.discoverAddresses();
+     * console.log(`Found ${result.addresses.length} addresses`);
+     *
+     * // With auto-tracking
+     * await sphere.discoverAddresses({ autoTrack: true });
+     * ```
+     */
+    discoverAddresses(options?: DiscoverAddressesOptions): Promise<DiscoverAddressesResult>;
     /**
      * Get aggregated status of all providers, grouped by role.
      *
@@ -6440,4 +6570,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 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 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 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 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 };