@coti-io/coti-wallet-plugin 0.2.0 → 0.2.2

package/dist/index.d.mts

@@ -234,11 +234,12 @@ interface CotiPluginConfig {
      */
     snapVersion?: string;
     /**
-     * When false, the plugin will not call `wallet_requestSnaps` to install or
-     * reconnect the Snap. An already-installed Snap can still be used for AES
-     * key retrieval. Default: true.
+     * When false, Snap is fully disabled for this app: no install/connect,
+     * no AES key probe/retrieval, and strategy routing ignores an already-installed
+     * Snap. Unlock continues via encrypted backup restore and/or contract
+     * onboarding. Default: true.
      */
-    snapInstallEnabled?: boolean;
+    snapEnabled?: boolean;
     /** If set, enforces a specific network chain ID (decimal string or hex). */
     defaultNetworkId?: string;
     /** Sepolia RPC URL for PoD portal operations. */
@@ -302,8 +303,8 @@ declare function getSnapRequestParams(snapId?: string, snapVersion?: string): Re
  * Returns the current plugin configuration.
  */
 declare function getPluginConfig(): Readonly<CotiPluginConfig>;
-/** Whether `wallet_requestSnaps` install/connect is allowed for this app. */
-declare function isSnapInstallEnabled(): boolean;
+/** Whether Snap usage (install, probe, AES key retrieve/save) is allowed for this app. */
+declare function isSnapEnabled(): boolean;
 
 /**
  * Internal logger for the COTI Wallet Plugin.
@@ -3707,6 +3708,12 @@ interface AesKeyProviderOptions {
     forceContractOnboarding?: boolean;
     /** Whether contract-onboarding should save a client-encrypted AES backup. */
     saveBackup?: boolean;
+    /**
+     * Persist the onboarded AES key to Snap after contract onboarding.
+     * Used when the unlock UI just connected Snap (`wallet_requestSnaps`) but
+     * `isMetaMaskWithSnap` may still be stale.
+     */
+    persistToSnap?: boolean;
     /** Only restore via Snap-side decrypt / backup; never export raw key or run contract onboarding. */
     restoreOnly?: boolean;
     /** Unlock via Snap typed decrypt RPC (no raw AES export). Used when AES is already stored in Snap. */
@@ -4752,4 +4759,4 @@ declare function muteChainUpdates(): void;
 declare function unmuteChainUpdates(): void;
 declare function isChainUpdatesMuted(): boolean;
 
-export { type AesKeyChainId, type AesKeyProviderOptions, BRIDGE_ABI, BRIDGE_ERC20_ABI, type BridgeData, type BridgeFees, type BridgeStatus, CHAIN_CONFIGS, CONTRACT_ADDRESSES, COTI_MAINNET_CHAIN_ID, COTI_MAINNET_RPC, COTI_PRICE_CONSUMER_ABI, COTI_TESTNET_CHAIN_ID$1 as COTI_TESTNET_CHAIN_ID, COTI_TESTNET_POD_INBOX, COTI_TESTNET_RPC, type ChainIndexPageUi, type ConnectorProviderSource, type CotiBridgeFeeQuote, CotiErrorCode, type CotiPluginConfig, CotiPluginError, DEFAULT_CHAIN_ID, DEFAULT_POD_BALANCE_STATE, DEFAULT_POD_EXPLORER_BASE_URL, type EIP1193Provider, ERC20_ABI, ETHEREUM_MAINNET_CHAIN_ID, ETHEREUM_MAINNET_RPC, type EncryptedAesBackup, type FeeEstimate, type GrantResult, LIMITS, type Logger, MINIMUM_PORTAL_IN_AMOUNTS, MULTIPLE_WALLETS_ERROR_SUBSTRING, type NetworkEnforcerResult, NetworkGuard, type NetworkGuardProps, ONBOARDING_STEPS, ONBOARD_MODAL_STYLE_KEYS, OnboardModal, type OnboardModalPage, type OnboardModalProps, type OnboardModalTheme, type OnboardModalWarnings, type OnboardingProgressCallback, type OnboardingServiceRequest, type OnboardingServices, type OnboardingStep, type OnboardingStepInfo, COTI_TESTNET_CHAIN_ID as POD_COTI_TESTNET_CHAIN_ID, POD_INBOX_ADDRESS, POD_PORTAL_ADMIN_ABI, POD_PRICE_ORACLE_ABI, POD_PTOKEN_ABI, SEPOLIA_CHAIN_ID as POD_SEPOLIA_CHAIN_ID, PRIVACY_PORTAL_ABI, PRIVATE_ERC20_TRANSFER_256_SIG, type PodBalanceState, type PodBalanceTrustState, type PodPortalFeeQuote, type PodPortalRequest, type PodPortalRequestStatus, type PodWithdrawPermit, type ChainConfig as PortalChainConfig, type PortalStrategy, type PrivacyBridgeContextType, type PrivacyBridgeModalsContextValue, type PrivacyBridgeNetworkContextValue, type PrivacyBridgePodContextValue, PrivacyBridgeProvider, type PrivacyBridgeProviderProps, type PrivacyBridgeSwapContextValue, type PrivacyBridgeTokensContextValue, type PrivacyBridgeUnlockContextValue, type PrivacyBridgeWalletContextValue, type PrivateUnlockControllerValue, PrivateUnlockProvider, type PrivateUnlockProviderOptions, type PrivateUnlockProviderProps, type RefreshPrivateBalancesOptions, type ResolvedIndexPageUi, SEPOLIA_CHAIN_ID$1 as SEPOLIA_CHAIN_ID, SEPOLIA_RPC, SEPOLIA_RPC_FALLBACK, SUPPORTED_TOKENS, type SaveEncryptedAesBackupRequest, type SimulationResult, TOKEN_ABI, type TokenConfig, type UnlockStrategy, WALLET_CONNECT_FAILURE_EVENT, type WagmiConfigOptions, WagmiRainbowKitProvider, type WalletConnectFailureDetail, type WalletNetworkConfig, type WalletType, type WalletTypeInfo, addThousandsSeparators, buildPodExplorerRequestUrl, computeCotiFee, computeErc20Fee, configureCotiPlugin, cotiMainnet, cotiTestnet, estimateBridgeFee, estimateCotiBridgeGasFeeDisplay, estimatePodPortalFees, ethereumMainnet, executePodPortalTransaction, fetchBridgeFees, fetchPodBridgeData, fetchPodOracleTokenUsdPrice, fetchTokenUsdPrice, formatBalanceWithNotation, formatPodFeeDisplay, formatPortalFeeDisplay, formatTokenBalanceDisplay, getChainConfig, getChainIdConstants, getContractAddresses, getEip6963MetaMaskProvider, getEip6963RabbyProvider, getEthereumProvider, getExplorerBaseUrlForChain, getNetworkNameForChain, getPluginConfig, getPodGasPrice, getPodInboxAddress, getPodSdkConfig, getPrivateTokensForChain, getPublicTokensForChain, getRpcUrlForChain, getRpcUrlForChainId, getRpcUrlsForChain, getSepoliaGasPrice, getSnapRequestParams, getTokenSimulationMeta, getTokensForChain, getUnlockStrategyForChain, getWagmiConfig, getWalletNetworkConfigs, getWalletNetworkOptions, hasCotiErrorCode, isChainUpdatesMuted, isCotiPluginError, isMultipleWalletsError, isSnapInstallEnabled, loadPodRequests, logger, mobileZerionWallet, muteChainUpdates, defaultStyles as onboardModalDefaultStyles, podRequestsStorageKey, quoteCotiBridgeFees, quotePodPortalTransactionFees, quotePortalFeeOnly, requireChainConfig, resolveConnectedProvider, resolveIndexPageUi, resolveMetaMaskInjectedTarget, resolvePodRequestStatus, resolvePodTxGasPrice, resolvePrivateTokenContractAddress, resolvePrivateTokenTransferTarget, resolveRabbyInjectedTarget, savePodRequests, sepolia, setDebugLogging, signPodWithdrawPermit, simulateFeeOnChain, simulatePodPortalFee, truncateDecimalValue, unmuteChainUpdates, useBalanceUpdater, useBridgeData, useBridgeStatus, useMetamask, useNetworkEnforcer, usePrivacyBridgeContext, usePrivacyBridgeModals, usePrivacyBridgeNetwork, usePrivacyBridgePod, usePrivacyBridgeSwap, usePrivacyBridgeTokens, usePrivacyBridgeUnlock, usePrivacyBridgeWallet, usePrivateTokenBalance, usePrivateUnlock, useWalletType, wagmiConfig };
+export { type AesKeyChainId, type AesKeyProviderOptions, BRIDGE_ABI, BRIDGE_ERC20_ABI, type BridgeData, type BridgeFees, type BridgeStatus, CHAIN_CONFIGS, CONTRACT_ADDRESSES, COTI_MAINNET_CHAIN_ID, COTI_MAINNET_RPC, COTI_PRICE_CONSUMER_ABI, COTI_TESTNET_CHAIN_ID$1 as COTI_TESTNET_CHAIN_ID, COTI_TESTNET_POD_INBOX, COTI_TESTNET_RPC, type ChainIndexPageUi, type ConnectorProviderSource, type CotiBridgeFeeQuote, CotiErrorCode, type CotiPluginConfig, CotiPluginError, DEFAULT_CHAIN_ID, DEFAULT_POD_BALANCE_STATE, DEFAULT_POD_EXPLORER_BASE_URL, type EIP1193Provider, ERC20_ABI, ETHEREUM_MAINNET_CHAIN_ID, ETHEREUM_MAINNET_RPC, type EncryptedAesBackup, type FeeEstimate, type GrantResult, LIMITS, type Logger, MINIMUM_PORTAL_IN_AMOUNTS, MULTIPLE_WALLETS_ERROR_SUBSTRING, type NetworkEnforcerResult, NetworkGuard, type NetworkGuardProps, ONBOARDING_STEPS, ONBOARD_MODAL_STYLE_KEYS, OnboardModal, type OnboardModalPage, type OnboardModalProps, type OnboardModalTheme, type OnboardModalWarnings, type OnboardingProgressCallback, type OnboardingServiceRequest, type OnboardingServices, type OnboardingStep, type OnboardingStepInfo, COTI_TESTNET_CHAIN_ID as POD_COTI_TESTNET_CHAIN_ID, POD_INBOX_ADDRESS, POD_PORTAL_ADMIN_ABI, POD_PRICE_ORACLE_ABI, POD_PTOKEN_ABI, SEPOLIA_CHAIN_ID as POD_SEPOLIA_CHAIN_ID, PRIVACY_PORTAL_ABI, PRIVATE_ERC20_TRANSFER_256_SIG, type PodBalanceState, type PodBalanceTrustState, type PodPortalFeeQuote, type PodPortalRequest, type PodPortalRequestStatus, type PodWithdrawPermit, type ChainConfig as PortalChainConfig, type PortalStrategy, type PrivacyBridgeContextType, type PrivacyBridgeModalsContextValue, type PrivacyBridgeNetworkContextValue, type PrivacyBridgePodContextValue, PrivacyBridgeProvider, type PrivacyBridgeProviderProps, type PrivacyBridgeSwapContextValue, type PrivacyBridgeTokensContextValue, type PrivacyBridgeUnlockContextValue, type PrivacyBridgeWalletContextValue, type PrivateUnlockControllerValue, PrivateUnlockProvider, type PrivateUnlockProviderOptions, type PrivateUnlockProviderProps, type RefreshPrivateBalancesOptions, type ResolvedIndexPageUi, SEPOLIA_CHAIN_ID$1 as SEPOLIA_CHAIN_ID, SEPOLIA_RPC, SEPOLIA_RPC_FALLBACK, SUPPORTED_TOKENS, type SaveEncryptedAesBackupRequest, type SimulationResult, TOKEN_ABI, type TokenConfig, type UnlockStrategy, WALLET_CONNECT_FAILURE_EVENT, type WagmiConfigOptions, WagmiRainbowKitProvider, type WalletConnectFailureDetail, type WalletNetworkConfig, type WalletType, type WalletTypeInfo, addThousandsSeparators, buildPodExplorerRequestUrl, computeCotiFee, computeErc20Fee, configureCotiPlugin, cotiMainnet, cotiTestnet, estimateBridgeFee, estimateCotiBridgeGasFeeDisplay, estimatePodPortalFees, ethereumMainnet, executePodPortalTransaction, fetchBridgeFees, fetchPodBridgeData, fetchPodOracleTokenUsdPrice, fetchTokenUsdPrice, formatBalanceWithNotation, formatPodFeeDisplay, formatPortalFeeDisplay, formatTokenBalanceDisplay, getChainConfig, getChainIdConstants, getContractAddresses, getEip6963MetaMaskProvider, getEip6963RabbyProvider, getEthereumProvider, getExplorerBaseUrlForChain, getNetworkNameForChain, getPluginConfig, getPodGasPrice, getPodInboxAddress, getPodSdkConfig, getPrivateTokensForChain, getPublicTokensForChain, getRpcUrlForChain, getRpcUrlForChainId, getRpcUrlsForChain, getSepoliaGasPrice, getSnapRequestParams, getTokenSimulationMeta, getTokensForChain, getUnlockStrategyForChain, getWagmiConfig, getWalletNetworkConfigs, getWalletNetworkOptions, hasCotiErrorCode, isChainUpdatesMuted, isCotiPluginError, isMultipleWalletsError, isSnapEnabled, loadPodRequests, logger, mobileZerionWallet, muteChainUpdates, defaultStyles as onboardModalDefaultStyles, podRequestsStorageKey, quoteCotiBridgeFees, quotePodPortalTransactionFees, quotePortalFeeOnly, requireChainConfig, resolveConnectedProvider, resolveIndexPageUi, resolveMetaMaskInjectedTarget, resolvePodRequestStatus, resolvePodTxGasPrice, resolvePrivateTokenContractAddress, resolvePrivateTokenTransferTarget, resolveRabbyInjectedTarget, savePodRequests, sepolia, setDebugLogging, signPodWithdrawPermit, simulateFeeOnChain, simulatePodPortalFee, truncateDecimalValue, unmuteChainUpdates, useBalanceUpdater, useBridgeData, useBridgeStatus, useMetamask, useNetworkEnforcer, usePrivacyBridgeContext, usePrivacyBridgeModals, usePrivacyBridgeNetwork, usePrivacyBridgePod, usePrivacyBridgeSwap, usePrivacyBridgeTokens, usePrivacyBridgeUnlock, usePrivacyBridgeWallet, usePrivateTokenBalance, usePrivateUnlock, useWalletType, wagmiConfig };

package/dist/index.d.ts

@@ -234,11 +234,12 @@ interface CotiPluginConfig {
      */
     snapVersion?: string;
     /**
-     * When false, the plugin will not call `wallet_requestSnaps` to install or
-     * reconnect the Snap. An already-installed Snap can still be used for AES
-     * key retrieval. Default: true.
+     * When false, Snap is fully disabled for this app: no install/connect,
+     * no AES key probe/retrieval, and strategy routing ignores an already-installed
+     * Snap. Unlock continues via encrypted backup restore and/or contract
+     * onboarding. Default: true.
      */
-    snapInstallEnabled?: boolean;
+    snapEnabled?: boolean;
     /** If set, enforces a specific network chain ID (decimal string or hex). */
     defaultNetworkId?: string;
     /** Sepolia RPC URL for PoD portal operations. */
@@ -302,8 +303,8 @@ declare function getSnapRequestParams(snapId?: string, snapVersion?: string): Re
  * Returns the current plugin configuration.
  */
 declare function getPluginConfig(): Readonly<CotiPluginConfig>;
-/** Whether `wallet_requestSnaps` install/connect is allowed for this app. */
-declare function isSnapInstallEnabled(): boolean;
+/** Whether Snap usage (install, probe, AES key retrieve/save) is allowed for this app. */
+declare function isSnapEnabled(): boolean;
 
 /**
  * Internal logger for the COTI Wallet Plugin.
@@ -3707,6 +3708,12 @@ interface AesKeyProviderOptions {
     forceContractOnboarding?: boolean;
     /** Whether contract-onboarding should save a client-encrypted AES backup. */
     saveBackup?: boolean;
+    /**
+     * Persist the onboarded AES key to Snap after contract onboarding.
+     * Used when the unlock UI just connected Snap (`wallet_requestSnaps`) but
+     * `isMetaMaskWithSnap` may still be stale.
+     */
+    persistToSnap?: boolean;
     /** Only restore via Snap-side decrypt / backup; never export raw key or run contract onboarding. */
     restoreOnly?: boolean;
     /** Unlock via Snap typed decrypt RPC (no raw AES export). Used when AES is already stored in Snap. */
@@ -4752,4 +4759,4 @@ declare function muteChainUpdates(): void;
 declare function unmuteChainUpdates(): void;
 declare function isChainUpdatesMuted(): boolean;
 
-export { type AesKeyChainId, type AesKeyProviderOptions, BRIDGE_ABI, BRIDGE_ERC20_ABI, type BridgeData, type BridgeFees, type BridgeStatus, CHAIN_CONFIGS, CONTRACT_ADDRESSES, COTI_MAINNET_CHAIN_ID, COTI_MAINNET_RPC, COTI_PRICE_CONSUMER_ABI, COTI_TESTNET_CHAIN_ID$1 as COTI_TESTNET_CHAIN_ID, COTI_TESTNET_POD_INBOX, COTI_TESTNET_RPC, type ChainIndexPageUi, type ConnectorProviderSource, type CotiBridgeFeeQuote, CotiErrorCode, type CotiPluginConfig, CotiPluginError, DEFAULT_CHAIN_ID, DEFAULT_POD_BALANCE_STATE, DEFAULT_POD_EXPLORER_BASE_URL, type EIP1193Provider, ERC20_ABI, ETHEREUM_MAINNET_CHAIN_ID, ETHEREUM_MAINNET_RPC, type EncryptedAesBackup, type FeeEstimate, type GrantResult, LIMITS, type Logger, MINIMUM_PORTAL_IN_AMOUNTS, MULTIPLE_WALLETS_ERROR_SUBSTRING, type NetworkEnforcerResult, NetworkGuard, type NetworkGuardProps, ONBOARDING_STEPS, ONBOARD_MODAL_STYLE_KEYS, OnboardModal, type OnboardModalPage, type OnboardModalProps, type OnboardModalTheme, type OnboardModalWarnings, type OnboardingProgressCallback, type OnboardingServiceRequest, type OnboardingServices, type OnboardingStep, type OnboardingStepInfo, COTI_TESTNET_CHAIN_ID as POD_COTI_TESTNET_CHAIN_ID, POD_INBOX_ADDRESS, POD_PORTAL_ADMIN_ABI, POD_PRICE_ORACLE_ABI, POD_PTOKEN_ABI, SEPOLIA_CHAIN_ID as POD_SEPOLIA_CHAIN_ID, PRIVACY_PORTAL_ABI, PRIVATE_ERC20_TRANSFER_256_SIG, type PodBalanceState, type PodBalanceTrustState, type PodPortalFeeQuote, type PodPortalRequest, type PodPortalRequestStatus, type PodWithdrawPermit, type ChainConfig as PortalChainConfig, type PortalStrategy, type PrivacyBridgeContextType, type PrivacyBridgeModalsContextValue, type PrivacyBridgeNetworkContextValue, type PrivacyBridgePodContextValue, PrivacyBridgeProvider, type PrivacyBridgeProviderProps, type PrivacyBridgeSwapContextValue, type PrivacyBridgeTokensContextValue, type PrivacyBridgeUnlockContextValue, type PrivacyBridgeWalletContextValue, type PrivateUnlockControllerValue, PrivateUnlockProvider, type PrivateUnlockProviderOptions, type PrivateUnlockProviderProps, type RefreshPrivateBalancesOptions, type ResolvedIndexPageUi, SEPOLIA_CHAIN_ID$1 as SEPOLIA_CHAIN_ID, SEPOLIA_RPC, SEPOLIA_RPC_FALLBACK, SUPPORTED_TOKENS, type SaveEncryptedAesBackupRequest, type SimulationResult, TOKEN_ABI, type TokenConfig, type UnlockStrategy, WALLET_CONNECT_FAILURE_EVENT, type WagmiConfigOptions, WagmiRainbowKitProvider, type WalletConnectFailureDetail, type WalletNetworkConfig, type WalletType, type WalletTypeInfo, addThousandsSeparators, buildPodExplorerRequestUrl, computeCotiFee, computeErc20Fee, configureCotiPlugin, cotiMainnet, cotiTestnet, estimateBridgeFee, estimateCotiBridgeGasFeeDisplay, estimatePodPortalFees, ethereumMainnet, executePodPortalTransaction, fetchBridgeFees, fetchPodBridgeData, fetchPodOracleTokenUsdPrice, fetchTokenUsdPrice, formatBalanceWithNotation, formatPodFeeDisplay, formatPortalFeeDisplay, formatTokenBalanceDisplay, getChainConfig, getChainIdConstants, getContractAddresses, getEip6963MetaMaskProvider, getEip6963RabbyProvider, getEthereumProvider, getExplorerBaseUrlForChain, getNetworkNameForChain, getPluginConfig, getPodGasPrice, getPodInboxAddress, getPodSdkConfig, getPrivateTokensForChain, getPublicTokensForChain, getRpcUrlForChain, getRpcUrlForChainId, getRpcUrlsForChain, getSepoliaGasPrice, getSnapRequestParams, getTokenSimulationMeta, getTokensForChain, getUnlockStrategyForChain, getWagmiConfig, getWalletNetworkConfigs, getWalletNetworkOptions, hasCotiErrorCode, isChainUpdatesMuted, isCotiPluginError, isMultipleWalletsError, isSnapInstallEnabled, loadPodRequests, logger, mobileZerionWallet, muteChainUpdates, defaultStyles as onboardModalDefaultStyles, podRequestsStorageKey, quoteCotiBridgeFees, quotePodPortalTransactionFees, quotePortalFeeOnly, requireChainConfig, resolveConnectedProvider, resolveIndexPageUi, resolveMetaMaskInjectedTarget, resolvePodRequestStatus, resolvePodTxGasPrice, resolvePrivateTokenContractAddress, resolvePrivateTokenTransferTarget, resolveRabbyInjectedTarget, savePodRequests, sepolia, setDebugLogging, signPodWithdrawPermit, simulateFeeOnChain, simulatePodPortalFee, truncateDecimalValue, unmuteChainUpdates, useBalanceUpdater, useBridgeData, useBridgeStatus, useMetamask, useNetworkEnforcer, usePrivacyBridgeContext, usePrivacyBridgeModals, usePrivacyBridgeNetwork, usePrivacyBridgePod, usePrivacyBridgeSwap, usePrivacyBridgeTokens, usePrivacyBridgeUnlock, usePrivacyBridgeWallet, usePrivateTokenBalance, usePrivateUnlock, useWalletType, wagmiConfig };
+export { type AesKeyChainId, type AesKeyProviderOptions, BRIDGE_ABI, BRIDGE_ERC20_ABI, type BridgeData, type BridgeFees, type BridgeStatus, CHAIN_CONFIGS, CONTRACT_ADDRESSES, COTI_MAINNET_CHAIN_ID, COTI_MAINNET_RPC, COTI_PRICE_CONSUMER_ABI, COTI_TESTNET_CHAIN_ID$1 as COTI_TESTNET_CHAIN_ID, COTI_TESTNET_POD_INBOX, COTI_TESTNET_RPC, type ChainIndexPageUi, type ConnectorProviderSource, type CotiBridgeFeeQuote, CotiErrorCode, type CotiPluginConfig, CotiPluginError, DEFAULT_CHAIN_ID, DEFAULT_POD_BALANCE_STATE, DEFAULT_POD_EXPLORER_BASE_URL, type EIP1193Provider, ERC20_ABI, ETHEREUM_MAINNET_CHAIN_ID, ETHEREUM_MAINNET_RPC, type EncryptedAesBackup, type FeeEstimate, type GrantResult, LIMITS, type Logger, MINIMUM_PORTAL_IN_AMOUNTS, MULTIPLE_WALLETS_ERROR_SUBSTRING, type NetworkEnforcerResult, NetworkGuard, type NetworkGuardProps, ONBOARDING_STEPS, ONBOARD_MODAL_STYLE_KEYS, OnboardModal, type OnboardModalPage, type OnboardModalProps, type OnboardModalTheme, type OnboardModalWarnings, type OnboardingProgressCallback, type OnboardingServiceRequest, type OnboardingServices, type OnboardingStep, type OnboardingStepInfo, COTI_TESTNET_CHAIN_ID as POD_COTI_TESTNET_CHAIN_ID, POD_INBOX_ADDRESS, POD_PORTAL_ADMIN_ABI, POD_PRICE_ORACLE_ABI, POD_PTOKEN_ABI, SEPOLIA_CHAIN_ID as POD_SEPOLIA_CHAIN_ID, PRIVACY_PORTAL_ABI, PRIVATE_ERC20_TRANSFER_256_SIG, type PodBalanceState, type PodBalanceTrustState, type PodPortalFeeQuote, type PodPortalRequest, type PodPortalRequestStatus, type PodWithdrawPermit, type ChainConfig as PortalChainConfig, type PortalStrategy, type PrivacyBridgeContextType, type PrivacyBridgeModalsContextValue, type PrivacyBridgeNetworkContextValue, type PrivacyBridgePodContextValue, PrivacyBridgeProvider, type PrivacyBridgeProviderProps, type PrivacyBridgeSwapContextValue, type PrivacyBridgeTokensContextValue, type PrivacyBridgeUnlockContextValue, type PrivacyBridgeWalletContextValue, type PrivateUnlockControllerValue, PrivateUnlockProvider, type PrivateUnlockProviderOptions, type PrivateUnlockProviderProps, type RefreshPrivateBalancesOptions, type ResolvedIndexPageUi, SEPOLIA_CHAIN_ID$1 as SEPOLIA_CHAIN_ID, SEPOLIA_RPC, SEPOLIA_RPC_FALLBACK, SUPPORTED_TOKENS, type SaveEncryptedAesBackupRequest, type SimulationResult, TOKEN_ABI, type TokenConfig, type UnlockStrategy, WALLET_CONNECT_FAILURE_EVENT, type WagmiConfigOptions, WagmiRainbowKitProvider, type WalletConnectFailureDetail, type WalletNetworkConfig, type WalletType, type WalletTypeInfo, addThousandsSeparators, buildPodExplorerRequestUrl, computeCotiFee, computeErc20Fee, configureCotiPlugin, cotiMainnet, cotiTestnet, estimateBridgeFee, estimateCotiBridgeGasFeeDisplay, estimatePodPortalFees, ethereumMainnet, executePodPortalTransaction, fetchBridgeFees, fetchPodBridgeData, fetchPodOracleTokenUsdPrice, fetchTokenUsdPrice, formatBalanceWithNotation, formatPodFeeDisplay, formatPortalFeeDisplay, formatTokenBalanceDisplay, getChainConfig, getChainIdConstants, getContractAddresses, getEip6963MetaMaskProvider, getEip6963RabbyProvider, getEthereumProvider, getExplorerBaseUrlForChain, getNetworkNameForChain, getPluginConfig, getPodGasPrice, getPodInboxAddress, getPodSdkConfig, getPrivateTokensForChain, getPublicTokensForChain, getRpcUrlForChain, getRpcUrlForChainId, getRpcUrlsForChain, getSepoliaGasPrice, getSnapRequestParams, getTokenSimulationMeta, getTokensForChain, getUnlockStrategyForChain, getWagmiConfig, getWalletNetworkConfigs, getWalletNetworkOptions, hasCotiErrorCode, isChainUpdatesMuted, isCotiPluginError, isMultipleWalletsError, isSnapEnabled, loadPodRequests, logger, mobileZerionWallet, muteChainUpdates, defaultStyles as onboardModalDefaultStyles, podRequestsStorageKey, quoteCotiBridgeFees, quotePodPortalTransactionFees, quotePortalFeeOnly, requireChainConfig, resolveConnectedProvider, resolveIndexPageUi, resolveMetaMaskInjectedTarget, resolvePodRequestStatus, resolvePodTxGasPrice, resolvePrivateTokenContractAddress, resolvePrivateTokenTransferTarget, resolveRabbyInjectedTarget, savePodRequests, sepolia, setDebugLogging, signPodWithdrawPermit, simulateFeeOnChain, simulatePodPortalFee, truncateDecimalValue, unmuteChainUpdates, useBalanceUpdater, useBridgeData, useBridgeStatus, useMetamask, useNetworkEnforcer, usePrivacyBridgeContext, usePrivacyBridgeModals, usePrivacyBridgeNetwork, usePrivacyBridgePod, usePrivacyBridgeSwap, usePrivacyBridgeTokens, usePrivacyBridgeUnlock, usePrivacyBridgeWallet, usePrivateTokenBalance, usePrivateUnlock, useWalletType, wagmiConfig };

package/dist/index.js

@@ -568,10 +568,10 @@ function configureCotiPlugin(config) {
       ...config.onboardingServices
     }
   };
-  if ("snapInstallEnabled" in config && _config.debug) {
-    console.log("[CotiPlugin] snapInstallEnabled:", {
-      snapInstallEnabled: config.snapInstallEnabled,
-      effective: isSnapInstallEnabled()
+  if ("snapEnabled" in config && _config.debug) {
+    console.log("[CotiPlugin] snapEnabled:", {
+      snapEnabled: config.snapEnabled,
+      effective: isSnapEnabled()
     });
   }
 }
@@ -582,8 +582,8 @@ function getSnapRequestParams(snapId = _config.snapId, snapVersion) {
 function getPluginConfig() {
   return _config;
 }
-function isSnapInstallEnabled() {
-  return getPluginConfig().snapInstallEnabled !== false;
+function isSnapEnabled() {
+  return getPluginConfig().snapEnabled !== false;
 }
 var _config;
 var init_plugin = __esm({
@@ -592,7 +592,7 @@ var init_plugin = __esm({
     init_chains();
     _config = {
       snapId: "npm:@coti-io/coti-snap",
-      snapInstallEnabled: true,
+      snapEnabled: true,
       defaultNetworkId: void 0,
       debug: false,
       clearSessionKeyOnWagmiDisconnect: false,
@@ -1205,7 +1205,7 @@ __export(index_exports, {
   isChainUpdatesMuted: () => isChainUpdatesMuted,
   isCotiPluginError: () => isCotiPluginError,
   isMultipleWalletsError: () => isMultipleWalletsError,
-  isSnapInstallEnabled: () => isSnapInstallEnabled,
+  isSnapEnabled: () => isSnapEnabled,
   loadPodRequests: () => loadPodRequests,
   logger: () => logger,
   mobileZerionWallet: () => mobileZerionWallet,
@@ -1558,6 +1558,7 @@ var resolveBridgeAddress = (chainId, symbol, pubTok) => {
   if (symbol === "USDC.e") return addresses.PrivacyBridgeUSDCe;
   if (symbol === "WADA") return addresses.PrivacyBridgeWADA;
   if (symbol === "gCOTI") return addresses.PrivacyBridgegCOTI;
+  if (symbol === "NIGHT") return addresses.PrivacyBridgeNight;
   return addresses.PrivacyBridgeCotiNative;
 };
 var quoteCotiBridgeFees = async (params) => {
@@ -1589,7 +1590,7 @@ var quoteCotiBridgeFees = async (params) => {
     if (isWbtc) {
       publicDecimals = 8;
       privateDecimals = 8;
-    } else if (isUsdt || isUsdcE || isWada) {
+    } else if (isUsdt || isUsdcE || isWada || isNight) {
       publicDecimals = 6;
       privateDecimals = 6;
     }
@@ -3828,6 +3829,17 @@ var usePrivateTokenBalance = () => {
       if (error instanceof CotiPluginError) {
         throw error;
       }
+      const message = error instanceof Error ? error.message : String(error?.message ?? error ?? "");
+      const code = error?.code;
+      const isDecryptPayloadFailure = message.includes("Invalid encrypted payload") || code === -32603 && /encrypt|decrypt|ciphertext/i.test(message);
+      if (isDecryptPayloadFailure || canUseSnapDecrypt) {
+        logger.error(`\u274C Failed to decrypt private balance for ${contractAddress}`, error);
+        throw new CotiPluginError(
+          "AES_KEY_MISMATCH" /* AES_KEY_MISMATCH */,
+          isDecryptPayloadFailure ? "Could not decrypt private balances. The Snap AES key may be missing or invalid \u2014 re-onboarding is required." : "Could not decrypt private balances via Snap. Re-onboarding may be required.",
+          message
+        );
+      }
       logger.error(`\u274C Failed to fetch/decrypt for ${contractAddress}`, error);
       return "0.00";
     }
@@ -4228,7 +4240,7 @@ var useBalanceUpdater = ({
                   return { symbol: token.symbol, value, isMismatch: false };
                 } catch (e) {
                   const msg = e?.message || "";
-                  const isMismatch = msg.includes("AES key mismatch") || msg.includes("onboarding") || msg.includes("ACCOUNT_NOT_ONBOARDED") || msg.includes("implausible decrypted balance");
+                  const isMismatch = e instanceof CotiPluginError && (e.code === "AES_KEY_MISMATCH" /* AES_KEY_MISMATCH */ || e.code === "ACCOUNT_NOT_ONBOARDED" /* ACCOUNT_NOT_ONBOARDED */) || msg.includes("AES key mismatch") || msg.includes("Invalid encrypted payload") || msg.includes("onboarding") || msg.includes("ACCOUNT_NOT_ONBOARDED") || msg.includes("implausible decrypted balance");
                   if (isMismatch) {
                     logger.warn(`\u26A0\uFE0F Private token decrypt mismatch for ${tokenAddress}. Falling back to 0.`);
                     return { symbol: token.symbol, value: "0", isMismatch: true };
@@ -4312,8 +4324,10 @@ var SYMBOL_TO_ORACLE_BASE = {
   USDT: "USDT",
   USDC: "USDC",
   "USDC.e": "USDC",
-  WADA: "ADA"
-  // gCOTI is not in the on-chain price consumer
+  WADA: "ADA",
+  // Consumer base is uppercase GCOTI (lowercase gCOTI reverts).
+  gCOTI: "GCOTI",
+  NIGHT: "NIGHT"
 };
 function getPriceConsumerAddress(chainId = 7082400) {
   const addresses = CONTRACT_ADDRESSES[chainId];
@@ -4421,7 +4435,8 @@ var TOKEN_TO_ORACLE_SYMBOL = {
   USDT: "USDT",
   "USDC.e": "USDC",
   WADA: "ADA",
-  gCOTI: "GCOTI"
+  gCOTI: "GCOTI",
+  NIGHT: "NIGHT"
 };
 var TOKEN_DECIMALS = {
   COTI: 18,
@@ -4430,7 +4445,8 @@ var TOKEN_DECIMALS = {
   USDT: 6,
   "USDC.e": 6,
   WADA: 6,
-  gCOTI: 18
+  gCOTI: 18,
+  NIGHT: 6
 };
 async function simulateFeeOnChain(bridgeAddress, amount, fixedFee, percentageBps, maxFee, oracleSymbol, tokenDecimals, provider) {
   try {
@@ -4943,6 +4959,10 @@ var useSnap = (setSnapError) => {
     }
   }, [resolveProvider]);
   const isSnapInstalled = (0, import_react6.useCallback)(async () => {
+    if (!isSnapEnabled()) {
+      logger.log("\u2139\uFE0F Snap disabled via plugin config \u2014 treating as not installed");
+      return false;
+    }
     const provider = await resolveProvider();
     if (!provider) {
       logger.log("\u274C isSnapInstalled: No MetaMask provider");
@@ -4972,8 +4992,8 @@ var useSnap = (setSnapError) => {
     }
   }, [detectFlask, resolveProvider]);
   const connectToSnap = (0, import_react6.useCallback)(async () => {
-    if (!isSnapInstallEnabled()) {
-      logger.log("\u2139\uFE0F Snap install disabled via plugin config");
+    if (!isSnapEnabled()) {
+      logger.log("\u2139\uFE0F Snap disabled via plugin config");
       return false;
     }
     const provider = await resolveProvider();
@@ -5120,6 +5140,13 @@ var useSnap = (setSnapError) => {
     return parseSnapItUint256(result?.value);
   }, [connectedAddress, invokeSnapOperation]);
   const getAESKeyFromSnap = (0, import_react6.useCallback)(async (accountAddress, options) => {
+    if (!isSnapEnabled()) {
+      logger.log("\u2139\uFE0F Snap disabled via plugin config \u2014 treating as unavailable");
+      throw new CotiPluginError(
+        "SNAP_CONNECT_FAILED" /* SNAP_CONNECT_FAILED */,
+        "COTI Snap is disabled for this app"
+      );
+    }
     if (setSnapError) setSnapError(null);
     const skipCache = options?.skipCache === true;
     if (isSnapRequestPending.current) {
@@ -5256,6 +5283,7 @@ var useSnap = (setSnapError) => {
     }
   }, [isSnapInstalled, setSnapError, resolveProvider, syncEnvironment]);
   const hasAesKeyInSnap = (0, import_react6.useCallback)(async (accountAddress) => {
+    if (!isSnapEnabled()) return null;
     const provider = await resolveProvider();
     if (!provider) return null;
     const installed = await isSnapInstalled();
@@ -5288,6 +5316,10 @@ var useSnap = (setSnapError) => {
     }
   }, [isSnapInstalled, resolveProvider, syncEnvironment]);
   const saveAESKeyToSnap = (0, import_react6.useCallback)(async (key, accountAddress = "") => {
+    if (!isSnapEnabled()) {
+      logger.log("\u2139\uFE0F Snap disabled via plugin config \u2014 skipping AES key save");
+      return false;
+    }
     const provider = await resolveProvider();
     if (!provider) return false;
     try {
@@ -6726,7 +6758,7 @@ function useWalletType() {
   const walletType = mapConnectorIdToWalletType(connectorId);
   (0, import_react12.useEffect)(() => {
     let cancelled = false;
-    if (walletType !== "metamask" || !connector) {
+    if (walletType !== "metamask" || !connector || !isSnapEnabled()) {
       setIsMetaMaskWithSnap(false);
       return;
     }
@@ -7815,7 +7847,8 @@ function useAesKeyProvider(walletTypeInfo) {
             }
           }
           let savedToSnap = false;
-          const canSaveToConnectedSnap = aesKey && walletTypeInfo.walletType === "metamask" && walletTypeInfo.isMetaMaskWithSnap && canPersistAesKeyToSnap();
+          const shouldPersistToSnap = walletTypeInfo.isMetaMaskWithSnap || options.persistToSnap === true;
+          const canSaveToConnectedSnap = !!aesKey && walletTypeInfo.walletType === "metamask" && shouldPersistToSnap && canPersistAesKeyToSnap();
           const canSaveEncryptedBackup = aesKey && isValidAesKey(aesKey) && options.saveBackup && servicesEnabled && (services?.saveEncryptedAesBackup || services?.replaceEncryptedAesBackup);
           if (canSaveToConnectedSnap) {
             emitStep("persisting-key");
@@ -7827,7 +7860,7 @@ function useAesKeyProvider(walletTypeInfo) {
                 success: "Onboarding succeeded, but the AES key could not be saved to MetaMask Snap. You can retry by unlocking again."
               });
             }
-          } else if (aesKey && walletTypeInfo.walletType === "metamask" && canPersistAesKeyToSnap() && !walletTypeInfo.isMetaMaskWithSnap) {
+          } else if (aesKey && walletTypeInfo.walletType === "metamask" && canPersistAesKeyToSnap() && !shouldPersistToSnap) {
             logger.log(
               "\u2139\uFE0F Skipping Snap AES persist \u2014 Snap is not connected to this origin"
             );
@@ -7912,7 +7945,17 @@ function useAesKeyProvider(walletTypeInfo) {
         }
       }
     },
-    [walletTypeInfo.walletType, getAESKeyFromSnap, saveAESKeyToSnap, clearSnapCache, connector, connectedChainId, emitStep, reportOnboardingFailure]
+    [
+      walletTypeInfo.walletType,
+      walletTypeInfo.isMetaMaskWithSnap,
+      getAESKeyFromSnap,
+      saveAESKeyToSnap,
+      clearSnapCache,
+      connector,
+      connectedChainId,
+      emitStep,
+      reportOnboardingFailure
+    ]
   );
   return {
     getAesKey,
@@ -8297,6 +8340,7 @@ var usePrivacyBridgeNetworkSession = ({
 // src/context/privacyBridge/usePrivacyBridgeAccountSync.ts
 var import_react20 = require("react");
 var import_wagmi9 = require("wagmi");
+init_plugin();
 init_logger();
 var usePrivacyBridgeAccountSync = ({
   core,
@@ -8343,13 +8387,13 @@ var usePrivacyBridgeAccountSync = ({
   );
   const getAESKeyForCurrentNetwork = (0, import_react20.useCallback)(
     async (accountAddress, options) => {
-      if (options?.skipCache && walletTypeInfo.walletType === "metamask" && !options.forceContractOnboarding && !options.restoreOnly) {
+      if (options?.skipCache && walletTypeInfo.walletType === "metamask" && isSnapEnabled() && !options.forceContractOnboarding && !options.restoreOnly) {
         return getAESKeyFromSnap(accountAddress, { skipCache: true });
       }
       if (sessionAesKey && !options?.forceContractOnboarding) return sessionAesKey;
       return options === void 0 ? getAesKeyFromProvider(accountAddress) : getAesKeyFromProvider(accountAddress, options.onProgress, options);
     },
-    [sessionAesKey, getAesKeyFromProvider, getAESKeyFromSnap]
+    [sessionAesKey, getAesKeyFromProvider, getAESKeyFromSnap, walletTypeInfo.walletType]
   );
   const { updateAccountState } = useBalanceUpdater({
     setWalletAddress,
@@ -11162,8 +11206,8 @@ function usePrivateUnlockController(options = {}) {
   isPrivateUnlockedRef.current = unlock.isPrivateUnlocked;
   const connectedAddress = wallet.walletAddress || "";
   const isMetaMaskWallet = walletTypeInfo.walletType === "metamask";
-  const canAttemptSnapInstall = isMetaMaskWallet && !isMetaMaskMobileBrowser() && isSnapInstallEnabled();
-  const usesSnapStorage = canAttemptSnapInstall && (walletTypeInfo.isMetaMaskWithSnap || snapConnectedInModal);
+  const canUseSnap = isMetaMaskWallet && !isMetaMaskMobileBrowser() && isSnapEnabled();
+  const usesSnapStorage = canUseSnap && (walletTypeInfo.isMetaMaskWithSnap || snapConnectedInModal);
   const isActiveUnlockRequest = (0, import_react28.useCallback)(
     (requestId) => requestId === unlockRequestIdRef.current,
     []
@@ -11261,7 +11305,7 @@ function usePrivateUnlockController(options = {}) {
     dismissOnboardModal();
   }, [dismissOnboardModal, wallet.walletAddress]);
   const connectSnap = (0, import_react28.useCallback)(async () => {
-    if (!canAttemptSnapInstall) return false;
+    if (!canUseSnap) return false;
     setModalError(null);
     try {
       const connected = await unlock.requestSnapConnection();
@@ -11280,7 +11324,7 @@ function usePrivateUnlockController(options = {}) {
       });
       return false;
     }
-  }, [canAttemptSnapInstall, unlock]);
+  }, [canUseSnap, unlock]);
   const handleRestoreUnlockProgress = (0, import_react28.useCallback)((step) => {
     if (step === "signing-backup") {
       setCurrentStep(step);
@@ -11465,7 +11509,7 @@ function usePrivateUnlockController(options = {}) {
     contractOnboardingFailureRef.current = null;
     try {
       let useSnapStorageForOnboarding = usesSnapStorage || snapConnectedInModalRef.current;
-      if (!useSnapStorageForOnboarding && canAttemptSnapInstall) {
+      if (!useSnapStorageForOnboarding && canUseSnap) {
         useSnapStorageForOnboarding = await connectSnap();
       }
       if (!isActiveUnlockRequest(requestId)) {
@@ -11474,6 +11518,8 @@ function usePrivateUnlockController(options = {}) {
       const ok = await unlock.refreshPrivateBalances({
         forceContractOnboarding: true,
         saveBackup: useSnapStorageForOnboarding ? false : saveBackup,
+        // Explicit: don't rely on isMetaMaskWithSnap which can lag after connectSnap.
+        persistToSnap: useSnapStorageForOnboarding,
         onProgress: (step, details) => {
           if (isActiveUnlockRequest(requestId)) {
             handleContractOnboardingProgress(step, details);
@@ -11529,7 +11575,7 @@ function usePrivateUnlockController(options = {}) {
         setIsUnlocking(false);
       }
     }
-  }, [canAttemptSnapInstall, connectSnap, connectedAddress, currentStep, dismissOnboardModal, handleContractOnboardingProgress, handleOnboardingIncomplete, isActiveUnlockRequest, onOnboardingCancelled, saveBackup, showOnboardingComplete, unlock, usesSnapStorage]);
+  }, [canUseSnap, connectSnap, connectedAddress, currentStep, dismissOnboardModal, handleContractOnboardingProgress, handleOnboardingIncomplete, isActiveUnlockRequest, onOnboardingCancelled, saveBackup, showOnboardingComplete, unlock, usesSnapStorage]);
   const handleOnboardModalClose = (0, import_react28.useCallback)(() => {
     if (currentStep === "complete" || currentStep === "validating-key" && pendingCompleteRequestIdRef.current !== null) {
       void finishSuccessfulOnboarding();
@@ -12720,7 +12766,7 @@ var import_rainbowkit3 = require("@rainbow-me/rainbowkit");
   isChainUpdatesMuted,
   isCotiPluginError,
   isMultipleWalletsError,
-  isSnapInstallEnabled,
+  isSnapEnabled,
   loadPodRequests,
   logger,
   mobileZerionWallet,