@wowok/wowok 2.3.7 → 2.3.8

package/dist/esm/{network-DOe6BgcD.mjs → network-CeDd07Hg.mjs}

@@ -1 +1 @@
-import{n as a35a}from'./rolldown-runtime-DkIiUugF.mjs';var network_exports=a35a({'ENTRYPOINT':()=>ENTRYPOINT,'getFullnodeUrl':()=>getFullnodeUrl});let ENTRYPOINT=function(a){return a['Testnet']='testnet',a['Localnet']='localnet',a['Mainnet']='mainnet',a;}({});function getFullnodeUrl(a){if(a==='testnet'&&process['env']['WOWOK_RPC_URL'])return process['env']['WOWOK_RPC_URL'];switch(a){case'testnet':return'https://fullnode.testnet.wowok.net:443';case'localnet':return'http://127.0.0.1:9000';case'mainnet':return'https://fullnode.mainnet.wowok.net:443';default:throw new Error('Unknown\x20network:\x20'+a);}}export{getFullnodeUrl as n,network_exports as r,ENTRYPOINT as t};
+import{t as a34a}from'./rolldown-runtime-D7D4PA-g.mjs';var network_exports=a34a({'ENTRYPOINT':()=>ENTRYPOINT,'getFullnodeUrl':()=>getFullnodeUrl});let ENTRYPOINT=function(a){return a['Testnet']='testnet',a['Localnet']='localnet',a['Mainnet']='mainnet',a;}({});function getFullnodeUrl(a){if(a==='testnet'&&process['env']['WOWOK_RPC_URL'])return process['env']['WOWOK_RPC_URL'];switch(a){case'testnet':return'https://fullnode.testnet.wowok.net:443';case'localnet':return'http://127.0.0.1:9000';case'mainnet':return'https://fullnode.mainnet.wowok.net:443';default:throw new Error('Unknown\x20network:\x20'+a);}}export{getFullnodeUrl as n,network_exports as r,ENTRYPOINT as t};

package/dist/esm/{networks-DhrBVvu6.d.mts → networks-CEYOA-1U.d.mts}

@@ -1,15 +1,4 @@
 //#region src/w/local/evm/networks.d.ts
-/**
- * EVM 多链网络配置与注册表
- *
- * 设计目标：
- * - 一份配置覆盖一条链的所有参数（chainId、rpcUrls、explorer、确认数、gas 策略、超时等）
- * - 通过 EvmNetworkRegistry 单例集中管理，支持按 chainId / name 查找
- * - 智能维护：备用 RPC 故障转移、chainId 缓存、健康检查
- * - 与 BridgeConfig 协同：bridge 初始化时把 EvmChainConfig 注册进来，
- *   EvmAccount 调用时即可自动找到对应网络的 RPC，无需重复传参
- * - 预留 L2 扩展：每条 L2 都是独立的 EvmNetworkConfig
- */
 /**
  * 单条 EVM 链的完整网络配置
  *
@@ -44,8 +33,12 @@ interface EvmNetworkConfig {
 /**
  * ETH 主网默认配置
  *
- * NOTE: rpcUrls 使用公共 RPC 仅作占位，生产环境建议通过
- * `EvmNetworkRegistry.Instance().register(...)` 覆盖为付费 RPC（Alchemy/Infura/自建节点）。
+ * 默认配置 10 个免费公共 RPC，按顺序尝试，主 RPC 失败自动故障转移到备用。
+ * 公共 RPC 易触发 429 限流，建议通过 `EvmNetworkRegistry.Instance().addRpc(...)`
+ * 或 `setRpcs(...)` 追加 / 替换为付费 RPC（Alchemy/Infura/自建节点）以提升稳定性。
+ *
+ * 健康状态过期：被标记为不可用的 RPC 在 5 分钟后自动重新加入轮询池
+ * （见 `EvmNetworkRegistry.DEFAULT_UNHEALTHY_RETRY_MS`）。
  */
 declare const ETH_MAINNET: EvmNetworkConfig;
 /**
@@ -72,6 +65,13 @@ declare const ETH_MAINNET: EvmNetworkConfig;
  */
 declare class EvmNetworkRegistry {
   private static _instance;
+  /**
+   * 默认 RPC 不可用重试窗口：5 分钟。
+   *
+   * 公共 RPC 429 限流通常在分钟级别恢复，5 分钟保证既不会被永久剔除，
+   * 也不会反复重试坏节点。可通过 `markUnhealthy(url, customMs)` 覆盖。
+   */
+  static readonly DEFAULT_UNHEALTHY_RETRY_MS: number;
   /** 按 chainId 索引 */
   private byChainId;
   /** 按小写 name 索引 */
@@ -81,7 +81,22 @@ declare class EvmNetworkRegistry {
   /** chainId 缓存（RPC 返回的真实 chainId，避免重复查询） */
   private chainIdCache;
   /** RPC 故障转移状态：url → 下次重试时间 */
-  private unhealthyRpc;
+  unhealthyRpc: Map<string, number>;
+  /**
+   * RPC 失败计数器：url → 累计失败次数。
+   *
+   * 用于"垃圾 RPC 反复复位"问题：失败次数越多，恢复时间越长，排序越靠后。
+   * 成功调用一次清零（见 markHealthy）。
+   *
+   * 恢复时间策略（指数退避）：
+   *   1 次 = 5 分钟
+   *   2 次 = 15 分钟
+   *   3 次 = 30 分钟
+   *   4+ 次 = 60 分钟（上限）
+   */
+  unhealthyCounter: Map<string, number>;
+  /** Persistence: evm_network_rpcs table in account.db (shared with evm-account) */
+  private _persistStore;
   private constructor();
   static Instance(): EvmNetworkRegistry;
   /** 注册或覆盖一条网络配置 */
@@ -106,18 +121,82 @@ declare class EvmNetworkRegistry {
   resolve(network?: number | string): Promise<EvmNetworkConfig>;
   /**
    * 选出当前可用的 RPC URL（跳过被标记为不可用的）
+   *
+   * 改进：按"健康度"排序，失败次数少的优先。
+   * 即使所有 RPC 都"过期可重试"，也会优先选择历史记录好的。
    */
   pickHealthyRpc(cfg: EvmNetworkConfig): string;
-  /** 标记 RPC 不可用（一段时间后自动恢复） */
+  /**
+   * 标记 RPC 不可用。
+   *
+   * 改进：使用指数退避，失败次数越多，恢复时间越长。
+   * 这样"垃圾 RPC"反复失败后会被自动降级，不会反复复位影响体验。
+   *
+   * 恢复时间策略：
+   *   1 次 = 5 分钟
+   *   2 次 = 15 分钟
+   *   3 次 = 30 分钟
+   *   4+ 次 = 60 分钟（上限）
+   */
   markUnhealthy(url: string, retryAfterMs?: number): void;
-  /** 标记 RPC 恢复健康 */
+  /** 标记 RPC 恢复健康（成功调用一次后清零计数） */
   markHealthy(url: string): void;
+  /** 查询某个 RPC 当前是否被标记为不可用 */
+  isUnhealthy(url: string): boolean;
+  /** 查询某条链上所有 RPC 的健康状态（用于 AI / 用户管理 RPC） */
+  listRpcStatus(chainIdOrName?: number | string): Array<{
+    url: string;
+    healthy: boolean;
+    retryInMs?: number;
+    failCount: number;
+  }>;
+  /**
+   * 给指定链追加一个 RPC（去重，已存在则忽略）
+   *
+   * 用于 AI / 用户动态管理 RPC 端点：
+   *   registry.addRpc("mainnet", "https://my-private-rpc.example.com")
+   */
+  addRpc(chainIdOrName: number | string, rpcUrl: string): boolean;
+  /**
+   * 从指定链移除一个 RPC
+   *
+   * 注意：不应移除链上最后一个 RPC，否则将无法发起任何请求。
+   */
+  removeRpc(chainIdOrName: number | string, rpcUrl: string): boolean;
+  /**
+   * 完全替换指定链的 RPC 列表
+   *
+   * 用于 AI / 用户批量替换 RPC（如全部切换到付费节点）。
+   * 必须至少传入一个 RPC。
+   */
+  setRpcs(chainIdOrName: number | string, rpcUrls: string[]): boolean;
   /** 健康检查（ping RPC 节点） */
   ping(url: string, timeoutMs?: number): Promise<boolean>;
   /** 通过 RPC 查询 chainId（带缓存） */
   queryChainIdFromRpc(rpcUrl: string): Promise<number>;
   /** 清空 chainId 缓存（切换节点后调用） */
   clearChainIdCache(): void;
+  /**
+   * Lazy init: use SQLiteAccountStorage with table "evm_network_rpcs" in account.db.
+   * Same database file as evm-account.ts, but isolated table.
+   * Data format: single JSON row — { "<chainId>": ["url1", "url2", ...], ... }
+   */
+  private _getPersistStore;
+  /** Save all chains' RPC URLs as a single JSON blob */
+  private _saveAllRpcs;
+  /** Load all chains' RPC overrides from account.db, applied on top of defaults */
+  private _loadAllRpcs;
+  /**
+   * Batch add RPC URLs to a chain. Duplicates are silently ignored.
+   * Returns the number of URLs actually added.
+   */
+  addRpcs(chainIdOrName: number | string, rpcUrls: string[]): number;
+  /**
+   * Batch remove RPC URLs from a chain.
+   * At least one RPC must remain. Silently skips URLs not found.
+   * Returns the number of URLs actually removed.
+   */
+  removeRpcs(chainIdOrName: number | string, rpcUrls: string[]): number;
   private buildTempConfig;
 }
 /**