@unicitylabs/sphere-sdk 0.13.2 → 0.13.3-dev.1

package/dist/index.d.cts

@@ -472,9 +472,6 @@ type StorageEventCallback = (event: StorageEvent) => void;
 interface TxfStorageDataBase {
     _meta: TxfMeta$1;
     _tombstones?: TxfTombstone[];
-    _outbox?: TxfOutboxEntry[];
-    _sent?: TxfSentEntry[];
-    _invalid?: TxfInvalidEntry[];
     _history?: HistoryRecord[];
     [key: `_${string}`]: unknown;
 }
@@ -490,25 +487,6 @@ interface TxfTombstone {
     stateHash: string;
     timestamp: number;
 }
-interface TxfOutboxEntry {
-    id: string;
-    status: string;
-    tokenId: string;
-    recipient: string;
-    createdAt: number;
-    data: unknown;
-}
-interface TxfSentEntry {
-    tokenId: string;
-    recipient: string;
-    txHash: string;
-    sentAt: number;
-}
-interface TxfInvalidEntry {
-    tokenId: string;
-    reason: string;
-    detectedAt: number;
-}
 
 /**
  * Oracle Provider Interface
@@ -1022,49 +1000,6 @@ interface TombstoneEntry {
     stateHash: string;
     timestamp: number;
 }
-/**
- * Invalidated nametag entry
- */
-interface InvalidatedNametagEntry {
-    name: string;
-    token: object;
-    timestamp: number;
-    format: string;
-    version: string;
-    invalidatedAt: number;
-    invalidationReason: string;
-}
-/**
- * Outbox entry for pending transfers
- */
-interface OutboxEntry {
-    id: string;
-    status: 'pending' | 'submitted' | 'confirmed' | 'delivered' | 'failed';
-    sourceTokenId: string;
-    salt: string;
-    commitmentJson: string;
-    recipientPubkey: string;
-    recipientNametag?: string;
-    amount: string;
-    createdAt: number;
-    updatedAt: number;
-    error?: string;
-    retryCount?: number;
-}
-/**
- * Mint outbox entry for pending mints
- */
-interface MintOutboxEntry {
-    id: string;
-    status: 'pending' | 'submitted' | 'confirmed' | 'failed';
-    type: 'split' | 'faucet' | 'other';
-    salt: string;
-    requestIdHex: string;
-    mintDataJson: string;
-    createdAt: number;
-    updatedAt: number;
-    error?: string;
-}
 /**
  * Storage metadata
  */
@@ -1084,10 +1019,7 @@ interface TxfStorageData {
     _nametag?: NametagData;
     _nametags?: NametagData[];
     _tombstones?: TombstoneEntry[];
-    _invalidatedNametags?: InvalidatedNametagEntry[];
-    _outbox?: OutboxEntry[];
-    _mintOutbox?: MintOutboxEntry[];
-    [key: string]: TxfToken | TxfMeta | NametagData | NametagData[] | TombstoneEntry[] | InvalidatedNametagEntry[] | OutboxEntry[] | MintOutboxEntry[] | undefined;
+    [key: string]: TxfToken | TxfMeta | NametagData | NametagData[] | TombstoneEntry[] | undefined;
 }
 interface ValidationIssue {
     tokenId: string;
@@ -1097,20 +1029,11 @@ interface ValidationIssue {
 interface TokenValidationResult {
     isValid: boolean;
     reason?: string;
-    action?: 'ACCEPT' | 'RETRY_LATER' | 'DISCARD_FORK';
 }
 /**
  * Check if a key is an active token key
  */
 declare function isTokenKey(key: string): boolean;
-/**
- * Check if a key is an archived token key
- */
-declare function isArchivedKey(key: string): boolean;
-/**
- * Check if a key is a forked token key
- */
-declare function isForkedKey(key: string): boolean;
 /**
  * Extract token ID from storage key
  */
@@ -1119,25 +1042,6 @@ declare function tokenIdFromKey(key: string): string;
  * Create storage key from token ID
  */
 declare function keyFromTokenId(tokenId: string): string;
-/**
- * Extract token ID from archived key
- */
-declare function tokenIdFromArchivedKey(key: string): string;
-/**
- * Create archived key from token ID
- */
-declare function archivedKeyFromTokenId(tokenId: string): string;
-/**
- * Create forked key from token ID and state hash
- */
-declare function forkedKeyFromTokenIdAndState(tokenId: string, stateHash: string): string;
-/**
- * Parse forked key into tokenId and stateHash
- */
-declare function parseForkedKey(key: string): {
-    tokenId: string;
-    stateHash: string;
-} | null;
 /**
  * Validate 64-character hex token ID
  */
@@ -3327,6 +3231,21 @@ declare class PaymentsModule {
      * and the SENT history record (dedupKey'd by transferId — idempotent).
      */
     private resumeIntent;
+    /**
+     * A resumed split that produced no output: a lost source means the leg delivered
+     * nothing (returns false), and every checkpoint failure keeps the intent open by
+     * throwing. There is no path here that records the spend.
+     */
+    private classifyResumeSplitFailure;
+    /**
+     * Drop the local records of the sources a resume consumed (present when
+     * resuming on the originating device). M7: each removal carries the LOCAL state
+     * we spent, so a source a concurrent claim reactivated to a NEW state (a
+     * self-send round-trip) is KEPT, not destroyed.
+     */
+    private dropResumedSources;
+    /** §10: the SENT record — same dedupKey as the original attempt, so a resume after the history POST is a server-side no-op. */
+    private recordResumedSentHistory;
     /**
      * Persist the token state to every (non-disabled) token storage provider.
      *
@@ -7833,25 +7752,22 @@ interface DiscoverAddressesResult {
 }
 
 /**
- * Legacy File Serialization Types
+ * Text Wallet Backup Serialization Types
  */
 
-type LegacyFileType = 'dat' | 'txt' | 'json' | 'mnemonic' | 'unknown';
-interface LegacyFileInfo {
-    fileType: LegacyFileType;
-    isEncrypted: boolean;
-    isBIP32: boolean;
-    hasMnemonic: boolean;
-}
 /**
- * Result of parsing a legacy wallet file
+ * Result of parsing a text wallet backup file
  */
+/** Backup file shapes `Sphere.importFromLegacyFile` accepts. Bitcoin Core `.dat` was removed (#604 — L3-only). */
+type LegacyFileType = 'txt' | 'json' | 'mnemonic' | 'unknown';
+/** Reports PBKDF2 progress while decrypting a password-protected backup. */
+type DecryptionProgressCallback = (iteration: number, total: number) => Promise<void> | void;
 interface LegacyFileParsedData {
     /** Master private key (hex) */
     masterKey: string;
     /** Chain code for BIP32 derivation */
     chainCode?: string;
-    /** Descriptor path from wallet.dat (e.g., "84'/1'/0'") */
+    /** Descriptor path (e.g., "84'/1'/0'") */
     descriptorPath?: string;
     /** Mnemonic if available */
     mnemonic?: string;
@@ -7866,31 +7782,8 @@ interface LegacyFileParseResult {
     data?: LegacyFileParsedData;
     /** Indicates file needs password for decryption */
     needsPassword?: boolean;
-    /** CMasterKey data for .dat decryption */
-    encryptionInfo?: {
-        iterations: number;
-        salt: Uint8Array;
-        encryptedKey: Uint8Array;
-    };
     error?: string;
 }
-/**
- * Progress callback for decryption operations
- */
-type DecryptionProgressCallback = (iteration: number, total: number) => Promise<void> | void;
-/**
- * Options for importing from legacy file
- */
-interface LegacyFileImportOptions {
-    /** Raw file content */
-    fileContent: string | Uint8Array;
-    /** File name (for type detection) */
-    fileName: string;
-    /** Password for encrypted files */
-    password?: string;
-    /** Progress callback for long decryption operations */
-    onDecryptProgress?: DecryptionProgressCallback;
-}
 
 /**
  * Sphere - Main SDK Entry Point
@@ -7933,7 +7826,6 @@ 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 */
@@ -8541,6 +8433,43 @@ declare class Sphere {
      * modules fall back to their legacy path, same as init).
      */
     setOracleApiKey(apiKey: string): Promise<void>;
+    /**
+     * Import a wallet from a backup file: a `UNICITY WALLET DETAILS` text backup
+     * (the format `exportToTxt` writes, optionally password-encrypted), a legacy
+     * flat-JSON webwallet export, or a bare mnemonic in a text file.
+     *
+     * @example
+     * const result = await Sphere.importFromLegacyFile({
+     *   fileContent: await file.text(),
+     *   fileName: file.name,
+     *   password,          // when the backup is encrypted
+     *   ...providers,
+     * });
+     */
+    static importFromLegacyFile(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
+        /** The backup file's text. */
+        fileContent: string;
+        /** File name (used for type detection) */
+        fileName: string;
+        /** Password for encrypted files */
+        password?: string;
+        /** Progress callback for long decryption operations */
+        onDecryptProgress?: DecryptionProgressCallback;
+    }): Promise<{
+        success: boolean;
+        sphere?: Sphere;
+        mnemonic?: string;
+        needsPassword?: boolean;
+        error?: string;
+    }>;
+    /**
+     * Detect legacy file type from filename and content
+     */
+    static detectLegacyFileType(fileName: string, content: string): LegacyFileType;
+    /**
+     * Check if a legacy file is encrypted
+     */
+    static isLegacyFileEncrypted(fileName: string, content: string): boolean;
     /**
      * Check if wallet has BIP32 master key for HD derivation
      */
@@ -8625,60 +8554,6 @@ declare class Sphere {
         mnemonic?: string;
         error?: string;
     }>;
-    /**
-     * Import wallet from legacy file (.dat, .txt, or mnemonic text)
-     *
-     * Supports:
-     * - Bitcoin Core wallet.dat files (SQLite format, encrypted or unencrypted)
-     * - Text backup files (UNICITY WALLET DETAILS format)
-     * - Plain mnemonic text (12 or 24 words)
-     *
-     * @returns Object with success status, created Sphere instance, and optionally recovered mnemonic
-     *
-     * @example
-     * ```ts
-     * // Import from .dat file
-     * const fileBuffer = await file.arrayBuffer();
-     * const result = await Sphere.importFromLegacyFile({
-     *   fileContent: new Uint8Array(fileBuffer),
-     *   fileName: 'wallet.dat',
-     *   password: 'wallet-password', // if encrypted
-     *   storage, transport, oracle,
-     * });
-     *
-     * // Import from .txt file
-     * const textContent = await file.text();
-     * const result = await Sphere.importFromLegacyFile({
-     *   fileContent: textContent,
-     *   fileName: 'backup.txt',
-     *   storage, transport, oracle,
-     * });
-     * ```
-     */
-    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) */
-        fileName: string;
-        /** Password for encrypted files */
-        password?: string;
-        /** Progress callback for long decryption operations */
-        onDecryptProgress?: DecryptionProgressCallback;
-    }): Promise<{
-        success: boolean;
-        sphere?: Sphere;
-        mnemonic?: string;
-        needsPassword?: boolean;
-        error?: string;
-    }>;
-    /**
-     * Detect legacy file type from filename and content
-     */
-    static detectLegacyFileType(fileName: string, content: string | Uint8Array): LegacyFileType;
-    /**
-     * Check if a legacy file is encrypted
-     */
-    static isLegacyFileEncrypted(fileName: string, content: string | Uint8Array): boolean;
     /**
      * Get the current active address index
      *
@@ -9325,49 +9200,6 @@ declare function formatAmount(amount: bigint | string, options?: {
     maxFractionDigits?: number;
 }): string;
 
-/**
- * Encode data to bech32 address
- *
- * @example
- * ```ts
- * const address = encodeBech32('bc', 1, pubkeyHash);
- * // 'bc1qw...'
- * ```
- */
-declare function encodeBech32(hrp: string, version: number, program: Uint8Array): string;
-/**
- * Decode bech32 address
- *
- * @example
- * ```ts
- * const result = decodeBech32('bc1qw...');
- * // { hrp: 'bc', witnessVersion: 1, data: Uint8Array }
- * ```
- */
-declare function decodeBech32(addr: string): {
-    hrp: string;
-    witnessVersion: number;
-    data: Uint8Array;
-} | null;
-/**
- * Create address from public key hash
- *
- * @example
- * ```ts
- * const address = createAddress('bc', pubkeyHash);
- * // 'bc1...'
- * ```
- */
-declare function createAddress(hrp: string, pubkeyHash: Uint8Array | string): string;
-/**
- * Validate bech32 address
- */
-declare function isValidBech32(addr: string): boolean;
-/**
- * Get HRP from address
- */
-declare function getAddressHrp(addr: string): string | null;
-
 /**
  * Browser-safe UUID v4 generation.
  *
@@ -10590,100 +10422,27 @@ declare function parseWalletText(content: string): LegacyFileParseResult;
 declare function parseAndDecryptWalletText(content: string, password: string): LegacyFileParseResult;
 
 /**
- * Wallet.dat Parsing
+ * TXF storage-data serializer.
  *
- * Parses Bitcoin Core wallet.dat files (SQLite format)
- * Extracts keys, chain codes, and descriptors
- */
-
-interface CMasterKeyData {
-    encryptedKey: Uint8Array;
-    salt: Uint8Array;
-    derivationMethod: number;
-    iterations: number;
-    position: number;
-}
-interface WalletDatInfo {
-    isSQLite: boolean;
-    isEncrypted: boolean;
-    isDescriptorWallet: boolean;
-    hasHDChain: boolean;
-    descriptorKeys: string[];
-    legacyKeys: string[];
-    chainCode: string | null;
-    descriptorPath: string | null;
-    cmasterKeys: CMasterKeyData[];
-    descriptorId: Uint8Array | null;
-    xpubString: string | null;
-}
-/**
- * Check if data is a valid SQLite database
- */
-declare function isSQLiteDatabase(data: Uint8Array): boolean;
-/**
- * Check if wallet.dat is encrypted
- */
-declare function isWalletDatEncrypted(data: Uint8Array): boolean;
-/**
- * Decrypt master key from CMasterKey structure
- */
-declare function decryptCMasterKey(cmk: CMasterKeyData, password: string, onProgress?: DecryptionProgressCallback): Promise<string>;
-/**
- * Decrypt private key using decrypted master key
- */
-declare function decryptPrivateKey(encryptedKey: Uint8Array, pubkey: Uint8Array, masterKeyHex: string): string;
-/**
- * Parse wallet.dat file
- * For encrypted wallets, returns info for decryption
- */
-declare function parseWalletDat(data: Uint8Array): LegacyFileParseResult;
-/**
- * Parse and decrypt wallet.dat file
- */
-declare function parseAndDecryptWalletDat(data: Uint8Array, password: string, onProgress?: DecryptionProgressCallback): Promise<LegacyFileParseResult>;
-
-/**
- * TXF Serializer for SDK2
- * Converts between SDK Token format and TXF storage format
+ * Builds and parses the `TxfStorageData` DOCUMENT — the `_meta` / `_nametags` /
+ * `_tombstones` / `_history` envelope plus the per-token slots. Tokens
+ * themselves are opaque v2 CBOR blobs (hex) in `Token.sdkData`; this file never
+ * decodes one.
  *
- * Platform-independent implementation that works with SDK types directly.
+ * A record that is not a v2 blob is logged and skipped on both the read and the
+ * write path — never reinterpreted.
  */
 
 /**
- * Normalize SDK token JSON to canonical TXF storage format.
- * Converts all bytes objects to hex strings before storage.
- */
-declare function normalizeSdkTokenToStorage(sdkTokenJson: unknown): TxfToken;
-/**
- * Extract TXF token structure from Token.sdkData (jsonData)
- */
-declare function tokenToTxf(token: Token): TxfToken | null;
-/**
- * Convert token interface to simplified Token for parsing
- */
-interface TokenLike {
-    id: string;
-    sdkData?: string;
-}
-/**
- * Extract TXF from any object with id and sdkData
- */
-declare function objectToTxf(obj: TokenLike): TxfToken | null;
-/**
- * Convert TXF token to Token interface
- */
-declare function txfToToken(tokenId: string, txf: TxfToken): Token;
-/**
- * Build TXF storage data from tokens and metadata
+ * Build TXF storage data from tokens and metadata.
+ *
+ * Only v2 blob tokens are written. Anything else in `sdkData` has no v2
+ * encoding, so it is dropped with a warning rather than written back in a shape
+ * the reader cannot interpret.
  */
 declare function buildTxfStorageData(tokens: Token[], meta: Omit<TxfMeta, 'formatVersion'>, options?: {
     nametags?: NametagData[];
     tombstones?: TombstoneEntry[];
-    archivedTokens?: Map<string, TxfToken>;
-    forkedTokens?: Map<string, TxfToken>;
-    outboxEntries?: OutboxEntry[];
-    mintOutboxEntries?: MintOutboxEntry[];
-    invalidatedNametags?: InvalidatedNametagEntry[];
     historyEntries?: HistoryRecord[];
 }): Promise<TxfStorageData>;
 interface ParsedStorageData {
@@ -10691,11 +10450,6 @@ interface ParsedStorageData {
     meta: TxfMeta | null;
     nametags: NametagData[];
     tombstones: TombstoneEntry[];
-    archivedTokens: Map<string, TxfToken>;
-    forkedTokens: Map<string, TxfToken>;
-    outboxEntries: OutboxEntry[];
-    mintOutboxEntries: MintOutboxEntry[];
-    invalidatedNametags: InvalidatedNametagEntry[];
     historyEntries: HistoryRecord[];
     validationErrors: string[];
 }
@@ -10703,35 +10457,6 @@ interface ParsedStorageData {
  * Parse TXF storage data
  */
 declare function parseTxfStorageData(data: unknown): ParsedStorageData;
-/**
- * Get token ID from Token object (prefers genesis.data.tokenId)
- */
-declare function getTokenId(token: Token): string;
-/**
- * Get the current state hash from a TXF token
- * Checks multiple sources in order of preference:
- * 1. Last transaction's newStateHash
- * 2. _integrity.currentStateHash
- * 3. Last transaction's inclusionProof authenticator stateHash
- * 4. Genesis inclusionProof authenticator stateHash (for never-transferred tokens)
- */
-declare function getCurrentStateHash(txf: TxfToken): string | undefined;
-/**
- * Check if token has valid TXF data
- */
-declare function hasValidTxfData(token: Token): boolean;
-/**
- * Check if token has uncommitted transactions
- */
-declare function hasUncommittedTransactions(token: Token): boolean;
-/**
- * Check if a TXF token has missing newStateHash on any transaction
- */
-declare function hasMissingNewStateHash(txf: TxfToken): boolean;
-/**
- * Count committed transactions in a token
- */
-declare function countCommittedTransactions(token: Token): number;
 
 /**
  * Token Validation Service — engine-based (v2).
@@ -11145,9 +10870,8 @@ declare function coinIdsMatch(a: string, b: string): boolean;
 /**
  * Standard address parsing, validation, and normalization for Unicity addresses.
  *
- * Three address formats:
+ * Two address formats:
  * - DIRECT://  — Resolved on-chain address (hex, 64-80 chars after prefix)
- * - PROXY://   — Proxy address derived from nametag hash
  * - @nametag   — Human-readable alias resolved via transport
  *
  * This module is the single source of truth for address handling.
@@ -11155,34 +10879,33 @@ declare function coinIdsMatch(a: string, b: string): boolean;
  *
  * @module
  */
-/** The three address format types supported by Unicity. */
-type AddressType = 'DIRECT' | 'PROXY' | 'NAMETAG';
+/** The address format types supported by Unicity. */
+type AddressType = 'DIRECT' | 'NAMETAG';
 /** A parsed address with its type and components. */
 interface ParsedAddress {
     /** Address format type */
     readonly type: AddressType;
     /** Original raw address string */
     readonly raw: string;
-    /** The value part after the prefix (hex for DIRECT/PROXY, name for NAMETAG) */
+    /** The value part after the prefix (hex for DIRECT, name for NAMETAG) */
     readonly value: string;
 }
 /**
  * Parse a Unicity address string into its components.
  *
- * @param address - A DIRECT://, PROXY://, or @nametag address string.
+ * @param address - A DIRECT:// or @nametag address string.
  * @returns Parsed address or null if invalid/unrecognized format.
  *
  * @example
  * parseAddress('DIRECT://0000ab12...') → { type: 'DIRECT', raw: '...', value: '0000ab12...' }
  * parseAddress('@alice')               → { type: 'NAMETAG', raw: '@alice', value: 'alice' }
- * parseAddress('PROXY://abc123...')     → { type: 'PROXY', raw: '...', value: 'abc123...' }
  * parseAddress('invalid')              → null
  */
 declare function parseAddress(address: string): ParsedAddress | null;
 /**
  * Check if a string is a valid Unicity address (any format).
  *
- * Accepts DIRECT://, PROXY://, or @nametag.
+ * Accepts DIRECT:// or @nametag.
  */
 declare function isValidAddress(address: string): boolean;
 /**
@@ -11193,7 +10916,6 @@ declare function isValidDirectAddress(address: string): boolean;
  * Normalize an address for comparison.
  *
  * - DIRECT:// → lowercase hex
- * - PROXY://  → lowercase hex
  * - @nametag  → lowercase name
  *
  * Returns the original string if not a recognized format.
@@ -11208,4 +10930,4 @@ declare function normalizeAddress(address: string): string;
  */
 declare function addressesMatch(a: string, b: string): boolean;
 
-export { AUTH_CHALLENGE_PREFIX, type AddressInfo, type AddressMode, type AddressType, type AggregatorEvent, type AggregatorEventCallback, type AggregatorEventType, type AggregatorProvider, type ApplyDeltaAdded, type ApplyDeltaOptions, type ApplyDeltaRequest, type Asset, type BaseProvider, type BlobUrlEntry, type BroadcastHandler, type BroadcastMessage, type CMasterKeyData, COIN_TYPES, ChallengeTemplateError, type CheckNetworkHealthOptions, type CoinBalance, CoinGeckoPriceProvider, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, type ComposingIndicator, type ConversationPage, type CreateGroupOptions, type CreateInvoiceRequest, DEFAULT_AGGREGATOR_TIMEOUT, DEFAULT_AGGREGATOR_URL, DEFAULT_DERIVATION_PATH, DEFAULT_GROUP_RELAYS, DEFAULT_MARKET_API_URL, DEFAULT_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DeliverOptions, type DeliveryBlobKeys, type DeliveryCustody, type DeliveryDisposition, type DeliveryProvider, type DeliveryReceipt, type DerivationMode, type DirectMessage, type DiscoverAddressProgress, type DiscoverAddressesOptions, type DiscoverAddressesResult, type DiscoveredAddress, type EncryptedData, type ExtendedValidationResult, FIELD_ENCRYPTION_HKDF_INFO, FIELD_ENVELOPE_MAX_BYTES, FIELD_ENVELOPE_NONCE_BYTES, FIELD_ENVELOPE_PREFIX, type FullIdentity, type GetConversationPageOptions, type GetInvoicesOptions, type GetSwapsFilter, GroupChatModule, type GroupChatModuleConfig, type GroupChatModuleDependencies, type GroupData, type GroupMemberData, type GroupMessageData, GroupRole, GroupVisibility, type HealthCheckFn, type Identity, type IdentityConfig, type IncomingBroadcast, type IncomingDelivery, type IncomingMessage, type IncomingPaymentRequest, type IncomingTokenTransfer, type IncomingTransfer, type InitProgress, type InitProgressCallback, type InitProgressStep, type IntentRecord, type IntentStatus, type IntentType, type InvalidatedNametagEntry, type InventoryAsset, type InventoryItem, type InventoryPage, type InventoryView, type InvoiceRequestedAsset, type KeyValueStore, LIMITS, type LegacyFileImportOptions, type LegacyFileInfo, type LegacyFileParseResult, type LegacyFileParsedData, type LegacyFileType, type LoadResult, type LogHandler, type LogLevel, type LoggerConfig, type ManifestAuxiliary, type ManifestFields, type ManifestSignatures, type MarketIntent, MarketModule, type MarketModuleConfig, type MarketModuleDependencies, type MessageHandler, type MintOutboxEntry, NETWORKS, NIP29_KINDS, NOSTR_EVENT_KINDS, type NametagBindingProof, type NametagData, type NetworkHealthResult, type NetworkType, type OracleEvent, type OracleEventCallback, type OracleEventType, type OracleProvider, type OutboxEntry, type OutgoingPaymentRequest, type ParsedAddress, type ParsedStorageData, PartialSendConflictError, type PayInvoiceParams, type PaymentRequest, type PaymentRequestHandler, type PaymentRequestResponse, type PaymentRequestResponseHandler, type PaymentRequestResponseType, type PaymentRequestResult, type PaymentRequestStatus, PaymentsModule, type PaymentsModuleConfig, type PaymentsModuleDependencies, type PaymentsWalletApiPort, type PeerInfo, type PostIntentRequest, type PostIntentResult, type PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RecoverRemovedResult, type RegistryNetwork, type ReturnPaymentParams, SIGN_MESSAGE_PREFIX, STORAGE_KEYS, STORAGE_KEYS_ADDRESS, STORAGE_KEYS_GLOBAL, STORAGE_PREFIX, type SaveResult, type SearchFilters, type SearchIntentResult, type SearchOptions, type SearchResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, type SphereImportOptions, type SphereInitOptions, type SphereInitResult, type SphereLoadOptions, type SphereStatus, type SphereWalletApiSession, type StorageEvent, type StorageEventCallback, type StorageEventType, type StorageProvider, type SwapDeal, type SwapManifest, SwapModule, type SwapModuleConfig, type SwapProgress, type SwapProposalResult, type SwapRef, type SwapRole, type SyncResult, TEST_AGGREGATOR_URL, TEST_NOSTR_RELAYS, TIMEOUTS, type Token, type TokenDefinition, type TokenIcon, type TokenPrice, TokenRegistry, type TokenStatus, type TokenStorageProvider, type TokenTransferDetail, type TokenTransferHandler, type TokenTransferPayload, type ValidationResult as TokenValidationResult, TokenValidator, type TombstoneEntry, type TrackedAddress, type TrackedAddressEntry, type TransactionHistoryEntry, type TransferMode, type TransferRequest, type TransferResult, type TransferStatus, type TransportEvent, type TransportEventCallback, type TransportEventType, type TransportProvider, type TxfAuthenticator, type TxfGenesis, type TxfGenesisData, type TxfInclusionProof, type TxfIntegrity, type TxfInvalidEntry, type TxfMerkleStep, type TxfMerkleTreePath, type TxfMeta$1 as TxfMeta, type TxfOutboxEntry, type TxfSentEntry, type TxfState, type TxfStorageData, type TxfStorageDataBase, type TxfToken, type TxfTombstone, type TxfTransaction, type UploadUrlEntry, type UploadUrlRequest, type ValidationAction, type ValidationIssue, type WakeCallback, type WakeEvent, type WakeSocketHandle, WalletApiClient, type WalletApiClientConfig, WalletApiError, type WalletApiErrorCode, type WalletApiIdentity, type WalletDatInfo, type WalletInfo, type WalletJSON, type WalletJSONExportOptions, type WalletSource, WholeBlobInventoryAdapter, type WholeBlobStore, addressesMatch, archivedKeyFromTokenId, assertFieldEnvelopeShape, base58Decode, base58Encode, buildManifest, buildTxfStorageData, bytesToHex, checkNetworkHealth, coinIdsMatch, composeDeliveryKeys, computeDeliveryId, computeSwapId, countCommittedTransactions, createAddress, createCommunicationsModule, createGroupChatModule, createKeyPair, createMarketModule, createNametagBinding, createPaymentsModule, createPriceProvider, createSphere, createSwapModule, createTokenValidator, decodeBech32, decrypt, decryptCMasterKey, decryptField, decryptFieldBytes, decryptJson, decryptMnemonic, decryptPrivateKey, decryptSimple, decryptTextFormatKey, decryptWithSalt, deriveAddressInfo, deriveChildKey, deriveFieldEncryptionKey, deriveKeyAtPath, doubleSha256, encodeBech32, encrypt, encryptField, encryptFieldBytes, encryptMnemonic, encryptSimple, extractFromText, findPattern, forkedKeyFromTokenIdAndState, formatAmount, generateAddressFromMasterKey, generateMasterKey, generateMnemonic, getAddressHrp, getAddressId, getAddressStorageKey, getCoinIdByName, getCoinIdBySymbol, getCurrentStateHash, getPublicKey, getSphere, getTokenDecimals, getTokenDefinition, getTokenIconUrl, getTokenId, getTokenName, getTokenSymbol, hasMissingNewStateHash, hasUncommittedTransactions, hasValidTxfData, hash160, hashSignMessage, hexToBytes, identityFromMnemonicSync, initSphere, isArchivedKey, isForkedKey, isKnownToken, isPossiblyCommittedSendOutcome, isSQLiteDatabase, isSphereError, isTextWalletEncrypted, isTokenKey, isValidAddress, isValidBech32, isValidDirectAddress, isValidNametag, isValidPrivateKey, isValidTokenId, isWalletDatEncrypted, isWalletTextFormat, keyFromTokenId, loadSphere, logger, mnemonicToSeedSync, normalizeAddress, normalizeCoinId, normalizeSdkTokenToStorage, objectToTxf, parseAddress, parseAndDecryptWalletDat, parseAndDecryptWalletText, parseForkedKey, parseTokenAmount, parseTxfStorageData, parseWalletDat, parseWalletText, randomBytes, randomHex, randomUUID, recoverPubkeyFromSignature, ripemd160, safeParseTokenAmount, sha256, signMessage, signSwapManifest, sleep, sphereExists, toHumanReadable, tokenIdFromArchivedKey, tokenIdFromKey, tokenToTxf, txfToToken, validateManifest, validateMnemonic, verifyChallengeTemplate, verifyManifestIntegrity, verifyNametagBinding, verifySignedMessage, verifySwapSignature };
+export { AUTH_CHALLENGE_PREFIX, type AddressInfo, type AddressMode, type AddressType, type AggregatorEvent, type AggregatorEventCallback, type AggregatorEventType, type AggregatorProvider, type ApplyDeltaAdded, type ApplyDeltaOptions, type ApplyDeltaRequest, type Asset, type BaseProvider, type BlobUrlEntry, type BroadcastHandler, type BroadcastMessage, COIN_TYPES, ChallengeTemplateError, type CheckNetworkHealthOptions, type CoinBalance, CoinGeckoPriceProvider, CommunicationsModule, type CommunicationsModuleConfig, type CommunicationsModuleDependencies, type ComposingIndicator, type ConversationPage, type CreateGroupOptions, type CreateInvoiceRequest, DEFAULT_AGGREGATOR_TIMEOUT, DEFAULT_AGGREGATOR_URL, DEFAULT_DERIVATION_PATH, DEFAULT_GROUP_RELAYS, DEFAULT_MARKET_API_URL, DEFAULT_NOSTR_RELAYS, DEV_AGGREGATOR_URL, type DecryptionProgressCallback, type DeliverOptions, type DeliveryBlobKeys, type DeliveryCustody, type DeliveryDisposition, type DeliveryProvider, type DeliveryReceipt, type DerivationMode, type DirectMessage, type DiscoverAddressProgress, type DiscoverAddressesOptions, type DiscoverAddressesResult, type DiscoveredAddress, type EncryptedData, type ExtendedValidationResult, FIELD_ENCRYPTION_HKDF_INFO, FIELD_ENVELOPE_MAX_BYTES, FIELD_ENVELOPE_NONCE_BYTES, FIELD_ENVELOPE_PREFIX, type FullIdentity, type GetConversationPageOptions, type GetInvoicesOptions, type GetSwapsFilter, GroupChatModule, type GroupChatModuleConfig, type GroupChatModuleDependencies, type GroupData, type GroupMemberData, type GroupMessageData, GroupRole, GroupVisibility, type HealthCheckFn, type Identity, type IdentityConfig, type IncomingBroadcast, type IncomingDelivery, type IncomingMessage, type IncomingPaymentRequest, type IncomingTokenTransfer, type IncomingTransfer, type InitProgress, type InitProgressCallback, type InitProgressStep, type IntentRecord, type IntentStatus, type IntentType, type InventoryAsset, type InventoryItem, type InventoryPage, type InventoryView, type InvoiceRequestedAsset, type KeyValueStore, LIMITS, type LegacyFileParseResult, type LegacyFileParsedData, type LegacyFileType, type LoadResult, type LogHandler, type LogLevel, type LoggerConfig, type ManifestAuxiliary, type ManifestFields, type ManifestSignatures, type MarketIntent, MarketModule, type MarketModuleConfig, type MarketModuleDependencies, type MessageHandler, NETWORKS, NIP29_KINDS, NOSTR_EVENT_KINDS, type NametagBindingProof, type NametagData, type NetworkHealthResult, type NetworkType, type OracleEvent, type OracleEventCallback, type OracleEventType, type OracleProvider, type OutgoingPaymentRequest, type ParsedAddress, type ParsedStorageData, PartialSendConflictError, type PayInvoiceParams, type PaymentRequest, type PaymentRequestHandler, type PaymentRequestResponse, type PaymentRequestResponseHandler, type PaymentRequestResponseType, type PaymentRequestResult, type PaymentRequestStatus, PaymentsModule, type PaymentsModuleConfig, type PaymentsModuleDependencies, type PaymentsWalletApiPort, type PeerInfo, type PostIntentRequest, type PostIntentResult, type PricePlatform, type PriceProvider, type PriceProviderConfig, type ProviderMetadata, type ProviderRole, type ProviderStatus, type ProviderStatusInfo, type ReceiveOptions, type ReceiveResult, type RecoverRemovedResult, type RegistryNetwork, type ReturnPaymentParams, SIGN_MESSAGE_PREFIX, STORAGE_KEYS, STORAGE_KEYS_ADDRESS, STORAGE_KEYS_GLOBAL, STORAGE_PREFIX, type SaveResult, type SearchFilters, type SearchIntentResult, type SearchOptions, type SearchResult, type ServiceHealthResult, type SpentTokenInfo, type SpentTokenResult, Sphere, type SphereCreateOptions, SphereError, type SphereErrorCode, type SphereEventHandler, type SphereEventMap, type SphereEventType, type SphereImportOptions, type SphereInitOptions, type SphereInitResult, type SphereLoadOptions, type SphereStatus, type SphereWalletApiSession, type StorageEvent, type StorageEventCallback, type StorageEventType, type StorageProvider, type SwapDeal, type SwapManifest, SwapModule, type SwapModuleConfig, type SwapProgress, type SwapProposalResult, type SwapRef, type SwapRole, type SyncResult, TEST_AGGREGATOR_URL, TEST_NOSTR_RELAYS, TIMEOUTS, type Token, type TokenDefinition, type TokenIcon, type TokenPrice, TokenRegistry, type TokenStatus, type TokenStorageProvider, type TokenTransferDetail, type TokenTransferHandler, type TokenTransferPayload, type ValidationResult as TokenValidationResult, TokenValidator, type TombstoneEntry, type TrackedAddress, type TrackedAddressEntry, type TransactionHistoryEntry, type TransferMode, type TransferRequest, type TransferResult, type TransferStatus, type TransportEvent, type TransportEventCallback, type TransportEventType, type TransportProvider, type TxfAuthenticator, type TxfGenesis, type TxfGenesisData, type TxfInclusionProof, type TxfIntegrity, type TxfMerkleStep, type TxfMerkleTreePath, type TxfMeta$1 as TxfMeta, type TxfState, type TxfStorageData, type TxfStorageDataBase, type TxfToken, type TxfTombstone, type TxfTransaction, type UploadUrlEntry, type UploadUrlRequest, type ValidationAction, type ValidationIssue, type WakeCallback, type WakeEvent, type WakeSocketHandle, WalletApiClient, type WalletApiClientConfig, WalletApiError, type WalletApiErrorCode, type WalletApiIdentity, type WalletInfo, type WalletJSON, type WalletJSONExportOptions, type WalletSource, WholeBlobInventoryAdapter, type WholeBlobStore, addressesMatch, assertFieldEnvelopeShape, base58Decode, base58Encode, buildManifest, buildTxfStorageData, bytesToHex, checkNetworkHealth, coinIdsMatch, composeDeliveryKeys, computeDeliveryId, computeSwapId, createCommunicationsModule, createGroupChatModule, createKeyPair, createMarketModule, createNametagBinding, createPaymentsModule, createPriceProvider, createSphere, createSwapModule, createTokenValidator, decrypt, decryptField, decryptFieldBytes, decryptJson, decryptMnemonic, decryptSimple, decryptTextFormatKey, decryptWithSalt, deriveAddressInfo, deriveChildKey, deriveFieldEncryptionKey, deriveKeyAtPath, doubleSha256, encrypt, encryptField, encryptFieldBytes, encryptMnemonic, encryptSimple, extractFromText, findPattern, formatAmount, generateAddressFromMasterKey, generateMasterKey, generateMnemonic, getAddressId, getAddressStorageKey, getCoinIdByName, getCoinIdBySymbol, getPublicKey, getSphere, getTokenDecimals, getTokenDefinition, getTokenIconUrl, getTokenName, getTokenSymbol, hash160, hashSignMessage, hexToBytes, identityFromMnemonicSync, initSphere, isKnownToken, isPossiblyCommittedSendOutcome, isSphereError, isTextWalletEncrypted, isTokenKey, isValidAddress, isValidDirectAddress, isValidNametag, isValidPrivateKey, isValidTokenId, isWalletTextFormat, keyFromTokenId, loadSphere, logger, mnemonicToSeedSync, normalizeAddress, normalizeCoinId, parseAddress, parseAndDecryptWalletText, parseTokenAmount, parseTxfStorageData, parseWalletText, randomBytes, randomHex, randomUUID, recoverPubkeyFromSignature, ripemd160, safeParseTokenAmount, sha256, signMessage, signSwapManifest, sleep, sphereExists, toHumanReadable, tokenIdFromKey, validateManifest, validateMnemonic, verifyChallengeTemplate, verifyManifestIntegrity, verifyNametagBinding, verifySignedMessage, verifySwapSignature };