@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/api/wallet-rpc.d.ts

@@ -1,14 +1,16 @@
-import type { ElizaConfig } from "../config/config";
-import { type WalletConfigUpdateRequest, type WalletRpcChain, type WalletRpcCredentialKey, type WalletRpcSelections } from "../contracts/wallet";
-export declare const DEFAULT_CLOUD_API_BASE_URL = "https://elizacloud.ai/api/v1";
-export declare const DEFAULT_PUBLIC_BSC_RPC_URLS: readonly ["https://bsc-dataseed1.binance.org/"];
-export declare const DEFAULT_PUBLIC_ETHEREUM_RPC_URLS: readonly ["https://ethereum.publicnode.com/"];
-export declare const DEFAULT_PUBLIC_BASE_RPC_URLS: readonly ["https://base.publicnode.com/"];
-export declare const DEFAULT_PUBLIC_AVALANCHE_RPC_URLS: readonly ["https://avalanche.publicnode.com/ext/bc/C/rpc"];
-export declare const DEFAULT_PUBLIC_SOLANA_RPC_URLS: readonly ["https://api.mainnet-beta.solana.com"];
+import { type WalletConfigUpdateRequest, type WalletRpcChain, type WalletRpcCredentialKey, type WalletRpcSelections } from "@elizaos/shared";
+import type { ElizaConfig } from "../config/config.ts";
+export declare const DEFAULT_PUBLIC_BSC_RPC_URLS: readonly ["https://bsc.publicnode.com/", "https://bsc-rpc.publicnode.com/", "https://binance.llamarpc.com/", "https://rpc.ankr.com/bsc", "https://bsc-dataseed.bnbchain.org/", "https://bsc-dataseed1.binance.org/", "https://bsc-dataseed2.binance.org/", "https://bsc-dataseed3.binance.org/"];
+export declare const DEFAULT_PUBLIC_BSC_TESTNET_RPC_URLS: readonly ["https://bsc-testnet.publicnode.com/", "https://bsc-testnet-rpc.publicnode.com/", "https://data-seed-prebsc-1-s1.binance.org:8545/"];
+export declare const DEFAULT_PUBLIC_ETHEREUM_RPC_URLS: readonly ["https://ethereum.publicnode.com/", "https://ethereum-rpc.publicnode.com/", "https://eth.llamarpc.com/", "https://rpc.ankr.com/eth"];
+export declare const DEFAULT_PUBLIC_BASE_RPC_URLS: readonly ["https://base.publicnode.com/", "https://base-rpc.publicnode.com/", "https://base.llamarpc.com/", "https://mainnet.base.org/"];
+export declare const DEFAULT_PUBLIC_AVALANCHE_RPC_URLS: readonly ["https://avalanche.publicnode.com/ext/bc/C/rpc", "https://avalanche-c-chain-rpc.publicnode.com/", "https://api.avax.network/ext/bc/C/rpc", "https://rpc.ankr.com/avalanche"];
+export declare const DEFAULT_PUBLIC_SOLANA_RPC_URLS: readonly ["https://api.mainnet-beta.solana.com", "https://solana-rpc.publicnode.com"];
+export declare const DEFAULT_PUBLIC_SOLANA_TESTNET_RPC_URLS: readonly ["https://api.devnet.solana.com"];
 type WalletCapableConfig = Pick<ElizaConfig, "cloud" | "env"> & {
     wallet?: {
         rpcProviders?: Partial<Record<keyof WalletRpcSelections, string>>;
+        network?: "mainnet" | "testnet";
     };
 };
 export interface InventoryProviderOption {
@@ -27,8 +29,10 @@ export interface WalletRpcResolutionOptions {
     cloudManagedAccess?: boolean | null;
     cloudApiKey?: string | null;
     cloudBaseUrl?: string | null;
+    walletNetwork?: "mainnet" | "testnet" | null;
 }
 export interface WalletRpcReadiness {
+    walletNetwork: "mainnet" | "testnet";
     cloudManagedAccess: boolean;
     managedBscRpcReady: boolean;
     evmBalanceReady: boolean;
@@ -42,12 +46,11 @@ export interface WalletRpcReadiness {
     solanaRpcUrls: string[];
 }
 type SupportedCloudEvmRpcChain = "mainnet" | "base" | "bsc" | "avalanche";
+export declare function resolveWalletNetworkMode(config?: WalletCapableConfig | null, fallback?: string | null): "mainnet" | "testnet";
 export declare function normalizeRpcUrl(url: string | null | undefined): string | null;
-export declare function resolveCloudApiBaseUrl(rawBaseUrl?: string | null): string | null;
-export declare function resolveCloudApiKey(config?: Pick<ElizaConfig, "cloud"> | null): string | null;
 export declare function buildCloudEvmRpcUrl(chain: SupportedCloudEvmRpcChain, options?: WalletRpcResolutionOptions): string | null;
 export declare function buildCloudSolanaRpcUrl(options?: WalletRpcResolutionOptions): string | null;
-export declare function hasElizaCloudRpcAccess(config?: Pick<ElizaConfig, "cloud"> | null): boolean;
+export declare function hasElizaCloudRpcAccess(config?: WalletCapableConfig | null): boolean;
 export declare function getStoredWalletRpcSelections(config?: WalletCapableConfig | null): WalletRpcSelections;
 export declare function getInventoryProviderOptions(): InventoryProviderOption[];
 export declare function resolveBscRpcUrls(options?: WalletRpcResolutionOptions): string[];

package/packages/agent/src/api/wallet-rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-rpc.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet-rpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wallet-rpc.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet-rpc.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAavD,eAAO,MAAM,2BAA2B,kSAS9B,CAAC;AACX,eAAO,MAAM,mCAAmC,gJAItC,CAAC;AAIX,eAAO,MAAM,gCAAgC,gJAKnC,CAAC;AACX,eAAO,MAAM,4BAA4B,0IAK/B,CAAC;AACX,eAAO,MAAM,iCAAiC,wLAKpC,CAAC;AACX,eAAO,MAAM,8BAA8B,uFAGjC,CAAC;AACX,eAAO,MAAM,sCAAsC,4CAEzC,CAAC;AAEX,KAAK,mBAAmB,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE;QACP,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;KACjC,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,cAAc,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,mBAAmB,CAAC;IAC1C,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,KAAK,yBAAyB,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;AAwD1E,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,EACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,SAAS,GAAG,SAAS,CAWvB;AAqED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAa7E;AA6BD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,yBAAyB,EAChC,OAAO,GAAE,0BAA+B,GACvC,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,0BAA+B,GACvC,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAClC,OAAO,CAYT;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAClC,mBAAmB,CAErB;AAED,wBAAgB,2BAA2B,IAAI,uBAAuB,EAAE,CAqGvE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,0BAA+B,GACvC,MAAM,EAAE,CAkBV;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,0BAA+B,GACvC,MAAM,EAAE,CAKV;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,0BAA+B,GACvC,MAAM,EAAE,CAKV;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,0BAA+B,GACvC,MAAM,EAAE,CAKV;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,0BAA+B,GACvC,MAAM,EAAE,CAgBV;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,yBAAyB,GAChC,IAAI,CA2DN;AAED,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAClC,kBAAkB,CAsDpB"}

package/packages/agent/src/api/wallet-rpc.js

@@ -1,19 +1,57 @@
-import { DEFAULT_WALLET_RPC_SELECTIONS, normalizeWalletRpcSelections, } from "../contracts/wallet";
-export const DEFAULT_CLOUD_API_BASE_URL = "https://elizacloud.ai/api/v1";
+import { normalizeCloudSecret as normalizeSecret, resolveCloudApiBaseUrl, resolveCloudApiKey, } from "@elizaos/plugin-elizacloud";
+import { DEFAULT_WALLET_RPC_SELECTIONS, isElizaCloudServiceSelectedInConfig, migrateLegacyRuntimeConfig, normalizeWalletRpcSelections, } from "@elizaos/shared";
+// Cloud-auth helpers (`resolveCloudApiKey`, `resolveCloudApiBaseUrl`,
+// `DEFAULT_CLOUD_API_BASE_URL`, `CloudApiKeyRuntimeLike`) live in
+// `@elizaos/plugin-elizacloud/cloud/cloud-api-key`. They are imported above
+// for use within this module; consumers should import them from
+// `@elizaos/plugin-elizacloud/cloud/cloud-api-key` directly.
+// Multiple BSC public RPCs so we have working fallbacks when Eliza
+// Cloud's proxy returns 401 (plan/account issue) AND the primary
+// Binance dataseed endpoint is blocked/rate-limited. Order matters —
+// the wallet resolver tries them in sequence, so put the most reliable
+// community endpoints first.
 export const DEFAULT_PUBLIC_BSC_RPC_URLS = [
+    "https://bsc.publicnode.com/",
+    "https://bsc-rpc.publicnode.com/",
+    "https://binance.llamarpc.com/",
+    "https://rpc.ankr.com/bsc",
+    "https://bsc-dataseed.bnbchain.org/",
     "https://bsc-dataseed1.binance.org/",
+    "https://bsc-dataseed2.binance.org/",
+    "https://bsc-dataseed3.binance.org/",
 ];
+export const DEFAULT_PUBLIC_BSC_TESTNET_RPC_URLS = [
+    "https://bsc-testnet.publicnode.com/",
+    "https://bsc-testnet-rpc.publicnode.com/",
+    "https://data-seed-prebsc-1-s1.binance.org:8545/",
+];
+// Same reasoning for Ethereum / Base / Avalanche — give the resolver
+// multiple community endpoints so a single DNS/rate-limit failure
+// doesn't block wallet execution end-to-end.
 export const DEFAULT_PUBLIC_ETHEREUM_RPC_URLS = [
     "https://ethereum.publicnode.com/",
+    "https://ethereum-rpc.publicnode.com/",
+    "https://eth.llamarpc.com/",
+    "https://rpc.ankr.com/eth",
 ];
 export const DEFAULT_PUBLIC_BASE_RPC_URLS = [
     "https://base.publicnode.com/",
+    "https://base-rpc.publicnode.com/",
+    "https://base.llamarpc.com/",
+    "https://mainnet.base.org/",
 ];
 export const DEFAULT_PUBLIC_AVALANCHE_RPC_URLS = [
     "https://avalanche.publicnode.com/ext/bc/C/rpc",
+    "https://avalanche-c-chain-rpc.publicnode.com/",
+    "https://api.avax.network/ext/bc/C/rpc",
+    "https://rpc.ankr.com/avalanche",
 ];
 export const DEFAULT_PUBLIC_SOLANA_RPC_URLS = [
     "https://api.mainnet-beta.solana.com",
+    "https://solana-rpc.publicnode.com",
+];
+export const DEFAULT_PUBLIC_SOLANA_TESTNET_RPC_URLS = [
+    "https://api.devnet.solana.com",
 ];
 const PROVIDER_CREDENTIAL_KEYS = {
     evm: {
@@ -53,11 +91,24 @@ const WALLET_RPC_CONFIG_KEYS = [
     "BSC_RPC_URL",
     "SOLANA_RPC_URL",
 ];
-function normalizeSecret(value) {
-    if (typeof value !== "string")
-        return null;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : null;
+function _resolveWalletNetwork() {
+    const explicit = process.env.ELIZA_WALLET_NETWORK?.trim().toLowerCase();
+    if (explicit === "testnet")
+        return "testnet";
+    if (explicit === "mainnet")
+        return "mainnet";
+    return process.env.BSC_TESTNET_RPC_URL?.trim() ? "testnet" : "mainnet";
+}
+export function resolveWalletNetworkMode(config, fallback) {
+    const normalized = (fallback ??
+        config?.wallet?.network ??
+        process.env.ELIZA_WALLET_NETWORK ??
+        "")
+        .trim()
+        .toLowerCase();
+    if (normalized === "testnet")
+        return "testnet";
+    return "mainnet";
 }
 function uniqueRpcUrls(...groups) {
     return [
@@ -94,6 +145,9 @@ function inferSelectedRpcProviders() {
             : DEFAULT_WALLET_RPC_SELECTIONS.solana,
     };
 }
+function walletSelectionsUseElizaCloud(selections) {
+    return Object.values(selections).some((provider) => provider === "eliza-cloud");
+}
 function hasLegacyCustomChainUrl(chain) {
     return LEGACY_CUSTOM_CHAIN_KEYS[chain].some((key) => Boolean(normalizeSecret(process.env[key])));
 }
@@ -118,35 +172,13 @@ export function normalizeRpcUrl(url) {
         return null;
     }
 }
-export function resolveCloudApiBaseUrl(rawBaseUrl) {
-    const candidate = normalizeSecret(rawBaseUrl ?? process.env.ELIZAOS_CLOUD_BASE_URL) ??
-        DEFAULT_CLOUD_API_BASE_URL;
-    try {
-        const parsed = new URL(candidate);
-        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-            return null;
-        }
-        parsed.hash = "";
-        parsed.search = "";
-        const normalizedBase = parsed.toString().replace(/\/+$/, "");
-        return normalizedBase.endsWith("/api/v1")
-            ? normalizedBase
-            : `${normalizedBase}/api/v1`;
-    }
-    catch {
-        return null;
-    }
-}
-export function resolveCloudApiKey(config) {
-    return normalizeSecret(config?.cloud?.apiKey ?? process.env.ELIZAOS_CLOUD_API_KEY);
-}
 function buildCloudRpcProxyUrl(pathname, options = {}) {
     const cloudApiKey = normalizeSecret(options.cloudApiKey ?? process.env.ELIZAOS_CLOUD_API_KEY);
     const cloudManagedAccess = options.cloudManagedAccess ?? Boolean(cloudApiKey);
     if (!cloudManagedAccess || !cloudApiKey) {
         return null;
     }
-    const cloudBaseUrl = resolveCloudApiBaseUrl(options.cloudBaseUrl);
+    const cloudBaseUrl = resolveCloudApiBaseUrl(options.cloudBaseUrl ?? undefined);
     if (!cloudBaseUrl) {
         return null;
     }
@@ -161,7 +193,12 @@ export function buildCloudSolanaRpcUrl(options = {}) {
     return buildCloudRpcProxyUrl("proxy/solana-rpc", options);
 }
 export function hasElizaCloudRpcAccess(config) {
-    return Boolean(resolveCloudApiKey(config));
+    const selectedRpcProviders = hasStoredSelections(config)
+        ? getStoredWalletRpcSelections(config)
+        : inferSelectedRpcProviders();
+    return Boolean(resolveCloudApiKey(config) &&
+        (walletSelectionsUseElizaCloud(selectedRpcProviders) ||
+            isElizaCloudServiceSelectedInConfig((config ?? {}), "rpc")));
 }
 export function getStoredWalletRpcSelections(config) {
     return normalizeWalletRpcSelections(config?.wallet?.rpcProviders);
@@ -269,12 +306,18 @@ export function getInventoryProviderOptions() {
     ];
 }
 export function resolveBscRpcUrls(options = {}) {
+    const network = resolveWalletNetworkMode(undefined, options.walletNetwork);
+    const cloudRpcUrl = network === "mainnet" ? buildCloudEvmRpcUrl("bsc", options) : null;
+    const publicDefaults = network === "testnet"
+        ? DEFAULT_PUBLIC_BSC_TESTNET_RPC_URLS
+        : DEFAULT_PUBLIC_BSC_RPC_URLS;
     return uniqueRpcUrls([
+        process.env.BSC_TESTNET_RPC_URL,
         process.env.NODEREAL_BSC_RPC_URL,
         process.env.QUICKNODE_BSC_RPC_URL,
         process.env.BSC_RPC_URL,
-        buildCloudEvmRpcUrl("bsc", options),
-    ], options.cloudManagedAccess ? DEFAULT_PUBLIC_BSC_RPC_URLS : []);
+        cloudRpcUrl,
+    ], options.cloudManagedAccess ? publicDefaults : []);
 }
 export function resolveEthereumRpcUrls(options = {}) {
     return uniqueRpcUrls([process.env.ETHEREUM_RPC_URL, buildCloudEvmRpcUrl("mainnet", options)], options.cloudManagedAccess ? DEFAULT_PUBLIC_ETHEREUM_RPC_URLS : []);
@@ -286,7 +329,16 @@ export function resolveAvalancheRpcUrls(options = {}) {
     return uniqueRpcUrls([process.env.AVALANCHE_RPC_URL, buildCloudEvmRpcUrl("avalanche", options)], options.cloudManagedAccess ? DEFAULT_PUBLIC_AVALANCHE_RPC_URLS : []);
 }
 export function resolveSolanaRpcUrls(options = {}) {
-    return uniqueRpcUrls([process.env.SOLANA_RPC_URL, buildCloudSolanaRpcUrl(options)], options.cloudManagedAccess ? DEFAULT_PUBLIC_SOLANA_RPC_URLS : []);
+    const network = resolveWalletNetworkMode(undefined, options.walletNetwork);
+    const cloudRpcUrl = network === "mainnet" ? buildCloudSolanaRpcUrl(options) : null;
+    const publicDefaults = network === "testnet"
+        ? DEFAULT_PUBLIC_SOLANA_TESTNET_RPC_URLS
+        : DEFAULT_PUBLIC_SOLANA_RPC_URLS;
+    return uniqueRpcUrls([
+        process.env.SOLANA_TESTNET_RPC_URL,
+        process.env.SOLANA_RPC_URL,
+        cloudRpcUrl,
+    ], publicDefaults);
 }
 export function applyWalletRpcConfigUpdate(config, update) {
     config.env ??= {};
@@ -301,7 +353,17 @@ export function applyWalletRpcConfigUpdate(config, update) {
     config.wallet = {
         ...config.wallet,
         rpcProviders: normalizedSelections,
+        network: update.walletNetwork === "testnet"
+            ? "testnet"
+            : update.walletNetwork === "mainnet"
+                ? "mainnet"
+                : config.wallet?.network,
     };
+    if (update.walletNetwork === "testnet" ||
+        update.walletNetwork === "mainnet") {
+        env.ELIZA_WALLET_NETWORK = update.walletNetwork;
+        process.env.ELIZA_WALLET_NETWORK = update.walletNetwork;
+    }
     for (const key of WALLET_RPC_CONFIG_KEYS) {
         const value = update.credentials?.[key];
         if (typeof value === "string" && value.trim()) {
@@ -328,24 +390,32 @@ export function applyWalletRpcConfigUpdate(config, update) {
     }
 }
 export function resolveWalletRpcReadiness(config) {
+    if (config && typeof config === "object" && !Array.isArray(config)) {
+        migrateLegacyRuntimeConfig(config);
+    }
+    const walletNetwork = resolveWalletNetworkMode(config);
     const cloudApiKey = resolveCloudApiKey(config);
     const cloudBaseUrl = resolveCloudApiBaseUrl(config?.cloud?.baseUrl);
-    const cloudManagedAccess = Boolean(cloudApiKey);
+    const selectedRpcProviders = hasStoredSelections(config)
+        ? getStoredWalletRpcSelections(config)
+        : inferSelectedRpcProviders();
+    const cloudRpcSelected = walletSelectionsUseElizaCloud(selectedRpcProviders) ||
+        isElizaCloudServiceSelectedInConfig((config ?? {}), "rpc");
+    const cloudManagedAccess = Boolean(cloudApiKey && cloudRpcSelected);
     const cloudOptions = {
         cloudManagedAccess,
         cloudApiKey,
         cloudBaseUrl,
+        walletNetwork,
     };
     const bscRpcUrls = resolveBscRpcUrls(cloudOptions);
     const ethereumRpcUrls = resolveEthereumRpcUrls(cloudOptions);
     const baseRpcUrls = resolveBaseRpcUrls(cloudOptions);
     const avalancheRpcUrls = resolveAvalancheRpcUrls(cloudOptions);
     const solanaRpcUrls = resolveSolanaRpcUrls(cloudOptions);
-    const selectedRpcProviders = hasStoredSelections(config)
-        ? getStoredWalletRpcSelections(config)
-        : inferSelectedRpcProviders();
     const legacyCustomChains = buildLegacyCustomChains(selectedRpcProviders);
     return {
+        walletNetwork,
         cloudManagedAccess,
         managedBscRpcReady: bscRpcUrls.length > 0,
         evmBalanceReady: Boolean(process.env.ALCHEMY_API_KEY?.trim() ||

package/packages/agent/src/api/wallet-trading-profile.d.ts

@@ -1,29 +1,10 @@
-import type { BscTradeSide, BscTradeTxStatus, WalletTradeLedgerEntry, WalletTradeLedgerQuoteLeg, WalletTradeSource, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow } from "../contracts/wallet.js";
+import type { BscTradeTxStatus, WalletTradeLedgerEntry, WalletTradeLedgerRecordInput, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow } from "@elizaos/shared";
 interface WalletTradeLedgerStore {
     version: 1;
     updatedAt: string;
     entries: WalletTradeLedgerEntry[];
 }
-export interface WalletTradeLedgerRecordInput {
-    hash: string;
-    source: WalletTradeSource;
-    side: BscTradeSide;
-    tokenAddress: string;
-    slippageBps: number;
-    route: string[];
-    quoteIn: WalletTradeLedgerQuoteLeg;
-    quoteOut: WalletTradeLedgerQuoteLeg;
-    status: BscTradeTxStatus;
-    confirmations: number;
-    nonce: number | null;
-    blockNumber: number | null;
-    gasUsed: string | null;
-    effectiveGasPriceWei: string | null;
-    reason?: string;
-    explorerUrl: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
+export type { WalletTradeLedgerRecordInput };
 export interface WalletTradeLedgerStatusPatch {
     status: BscTradeTxStatus;
     confirmations: number;
@@ -47,5 +28,4 @@ export declare function recordWalletTradeLedgerEntry(input: WalletTradeLedgerRec
 export declare function updateWalletTradeLedgerEntryStatus(hash: string, patch: WalletTradeLedgerStatusPatch, stateDir?: string): WalletTradeLedgerEntry | null;
 export declare function buildWalletTradingProfile(entries: WalletTradeLedgerEntry[], options?: Pick<WalletTradingProfileOptions, "window" | "source">): WalletTradingProfileResponse;
 export declare function loadWalletTradingProfile(options?: WalletTradingProfileOptions): WalletTradingProfileResponse;
-export {};
 //# sourceMappingURL=wallet-trading-profile.d.ts.map

package/packages/agent/src/api/wallet-trading-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-trading-profile.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet-trading-profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EAEjB,4BAA4B,EAC5B,gCAAgC,EAEhC,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAOhC,UAAU,sBAAsB;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,yBAAyB,CAAC;IACnC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,MAAM,CAAC,EAAE,gCAAgC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+ND,wBAAgB,mCAAmC,CACjD,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,CAyBxB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,CASxB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,4BAA4B,EACnC,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,CAgDxB;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,4BAA4B,EACnC,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,GAAG,IAAI,CAyC/B;AA0ED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,GAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,GAAG,QAAQ,CAAM,GACnE,4BAA4B,CA+K9B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,2BAAgC,GACxC,4BAA4B,CAG9B"}
+{"version":3,"file":"wallet-trading-profile.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet-trading-profile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,gBAAgB,EAChB,sBAAsB,EAEtB,4BAA4B,EAG5B,4BAA4B,EAC5B,gCAAgC,EAEhC,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AASzB,UAAU,sBAAsB;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,YAAY,EAAE,4BAA4B,EAAE,CAAC;AAE7C,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,MAAM,CAAC,EAAE,gCAAgC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsND,wBAAgB,mCAAmC,CACjD,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,CAyBxB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,CASxB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,4BAA4B,EACnC,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,CAgDxB;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,4BAA4B,EACnC,QAAQ,GAAE,MAA0B,GACnC,sBAAsB,GAAG,IAAI,CA6C/B;AAgFD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,GAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,GAAG,QAAQ,CAAM,GACnE,4BAA4B,CAiL9B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,2BAAgC,GACxC,4BAA4B,CAG9B"}

package/packages/agent/src/api/wallet-trading-profile.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { resolveStateDir } from "../config/paths.js";
+import { writeJsonAtomicSync } from "../utils/atomic-json.js";
 const WALLET_PROFILE_LEDGER_VERSION = 1;
 const MAX_WALLET_PROFILE_LEDGER_ENTRIES = 2000;
 const ONE_DAY_MS = 24 * 60 * 60 * 1000;
@@ -11,6 +12,12 @@ const TRADE_STATUS_SET = new Set([
     "reverted",
     "not_found",
 ]);
+const ALLOWED_STATUS_TRANSITIONS = {
+    pending: new Set(["pending", "success", "reverted", "not_found"]),
+    not_found: new Set(["pending", "success", "reverted", "not_found"]),
+    success: new Set(["success"]),
+    reverted: new Set(["reverted"]),
+};
 const TRADE_SIDE_SET = new Set(["buy", "sell"]);
 function nowIso() {
     return new Date().toISOString();
@@ -45,6 +52,9 @@ function normalizeStatus(value) {
         return "pending";
     return normalized;
 }
+function canTransitionTradeStatus(current, next) {
+    return ALLOWED_STATUS_TRANSITIONS[current].has(next);
+}
 function normalizeSide(value) {
     if (typeof value !== "string")
         return "buy";
@@ -161,28 +171,6 @@ function sortAndTrimEntries(entries) {
         return sorted;
     return sorted.slice(sorted.length - MAX_WALLET_PROFILE_LEDGER_ENTRIES);
 }
-function ensureLedgerDir(filePath) {
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
-    }
-}
-function atomicWriteLedger(filePath, store) {
-    ensureLedgerDir(filePath);
-    const tmpPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
-    try {
-        fs.writeFileSync(tmpPath, JSON.stringify(store, null, 2), {
-            encoding: "utf-8",
-            mode: 0o600,
-        });
-        fs.renameSync(tmpPath, filePath);
-    }
-    finally {
-        if (fs.existsSync(tmpPath)) {
-            fs.rmSync(tmpPath, { force: true });
-        }
-    }
-}
 function defaultLedgerStore() {
     return {
         version: WALLET_PROFILE_LEDGER_VERSION,
@@ -228,7 +216,7 @@ export function writeWalletTradeLedgerStore(store, stateDir = resolveStateDir())
         updatedAt: nowIso(),
         entries: sortAndTrimEntries(store.entries),
     };
-    atomicWriteLedger(filePath, normalized);
+    writeJsonAtomicSync(filePath, normalized);
     return normalized;
 }
 export function recordWalletTradeLedgerEntry(input, stateDir = resolveStateDir()) {
@@ -284,9 +272,13 @@ export function updateWalletTradeLedgerEntryStatus(hash, patch, stateDir = resol
     if (index < 0)
         return null;
     const current = store.entries[index];
+    const nextStatus = normalizeStatus(patch.status);
+    if (!canTransitionTradeStatus(current.status, nextStatus)) {
+        return current;
+    }
     const updated = {
         ...current,
-        status: normalizeStatus(patch.status),
+        status: nextStatus,
         confirmations: Math.max(0, Math.floor(toFiniteNumber(patch.confirmations))),
         nonce: patch.nonce === null ? null : Math.floor(toFiniteNumber(patch.nonce)),
         blockNumber: patch.blockNumber === null
@@ -316,7 +308,10 @@ export function updateWalletTradeLedgerEntryStatus(hash, patch, stateDir = resol
     return updated;
 }
 function resolveWindow(window) {
-    if (window === "7d" || window === "30d" || window === "all")
+    if (window === "24h" ||
+        window === "7d" ||
+        window === "30d" ||
+        window === "all")
         return window;
     return "30d";
 }
@@ -380,11 +375,13 @@ export function buildWalletTradingProfile(entries, options = {}) {
     const window = resolveWindow(options.window);
     const source = resolveSource(options.source);
     const now = Date.now();
-    const cutoffMs = window === "7d"
-        ? now - 7 * ONE_DAY_MS
-        : window === "30d"
-            ? now - 30 * ONE_DAY_MS
-            : 0;
+    const cutoffMs = window === "24h"
+        ? now - ONE_DAY_MS
+        : window === "7d"
+            ? now - 7 * ONE_DAY_MS
+            : window === "30d"
+                ? now - 30 * ONE_DAY_MS
+                : 0;
     const filtered = entries
         .filter((entry) => {
         if (source !== "all" && entry.source !== source)

package/packages/agent/src/api/wallet.d.ts

@@ -1,9 +1,13 @@
-import type { KeyValidationResult, SolanaTokenBalance, WalletAddresses, WalletChain, WalletGenerateResult, WalletImportResult, WalletKeys } from "../contracts/wallet";
-export type { BscTradeExecuteRequest, BscTradeExecuteResponse, BscTradeExecutionResult, BscTradePreflightRequest, BscTradePreflightResponse, BscTradeQuoteRequest, BscTradeQuoteResponse, BscTradeSide, BscTradeTxStatus, BscTradeTxStatusResponse, BscTransferExecuteRequest, BscTransferExecuteResponse, BscTransferExecutionResult, BscUnsignedApprovalTx, BscUnsignedTradeTx, BscUnsignedTransferTx, EvmChainBalance, EvmTokenBalance, KeyValidationResult, SolanaTokenBalance, TradePermissionMode, WalletAddresses, WalletBalancesResponse, WalletChain, WalletConfigStatus, WalletGenerateResult, WalletImportResult, WalletKeys, WalletTradeLedgerEntry, WalletTradeSource, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow, } from "../contracts/wallet";
-export { computeValueUsd, DEX_PRICE_TIMEOUT_MS, DEXPAPRIKA_CHAIN_MAP, DEXSCREENER_CHAIN_MAP, type DexScreenerPair, type DexTokenMeta, fetchDexPaprikaPrices, fetchDexPrices, fetchDexScreenerPrices, WRAPPED_NATIVE, } from "./wallet-dex-prices";
-export { type AnkrTokenAsset, DEFAULT_EVM_CHAINS, type EvmProviderKeys, fetchEvmBalances, resolveEvmProviderKeys, } from "./wallet-evm-balance";
+import type { KeyValidationResult, SolanaTokenBalance, WalletAddresses, WalletChain, WalletGenerateResult, WalletImportResult, WalletKeys } from "@elizaos/shared";
+export type { BscTradeExecuteRequest, BscTradeExecuteResponse, BscTradeExecutionResult, BscTradePreflightRequest, BscTradePreflightResponse, BscTradeQuoteRequest, BscTradeQuoteResponse, BscTradeSide, BscTradeTxStatus, BscTradeTxStatusResponse, BscTransferExecuteRequest, BscTransferExecuteResponse, BscTransferExecutionResult, BscUnsignedApprovalTx, BscUnsignedTradeTx, BscUnsignedTransferTx, EvmChainBalance, EvmTokenBalance, KeyValidationResult, SolanaTokenBalance, TradePermissionMode, WalletAddresses, WalletBalancesResponse, WalletChain, WalletConfigStatus, WalletGenerateResult, WalletImportResult, WalletKeys, WalletTradeLedgerEntry, WalletTradeSource, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow, } from "@elizaos/shared";
+export { computeValueUsd, DEX_PRICE_TIMEOUT_MS, DEXPAPRIKA_CHAIN_MAP, DEXSCREENER_CHAIN_MAP, type DexScreenerPair, type DexTokenMeta, fetchDexPaprikaPrices, fetchDexPrices, fetchDexScreenerPrices, WRAPPED_NATIVE, } from "./wallet-dex-prices.ts";
+export { type AnkrTokenAsset, DEFAULT_EVM_CHAINS, type EvmProviderKeys, fetchEvmBalances, resolveEvmProviderKeys, } from "./wallet-evm-balance.ts";
 export declare const MANAGED_EVM_ADDRESS_ENV_KEY = "ELIZA_MANAGED_EVM_ADDRESS";
 export declare const MANAGED_SOLANA_ADDRESS_ENV_KEY = "ELIZA_MANAGED_SOLANA_ADDRESS";
+export declare const CLOUD_EVM_ADDRESS_ENV_KEY = "ELIZA_CLOUD_EVM_ADDRESS";
+export declare const CLOUD_SOLANA_ADDRESS_ENV_KEY = "ELIZA_CLOUD_SOLANA_ADDRESS";
+export declare const WALLET_SOURCE_EVM_ENV_KEY = "WALLET_SOURCE_EVM";
+export declare const WALLET_SOURCE_SOLANA_ENV_KEY = "WALLET_SOURCE_SOLANA";
 export declare function deriveEvmAddress(privateKeyHex: string): string;
 export declare function deriveSolanaAddress(privateKeyString: string): string;
 export declare function validateEvmPrivateKey(key: string): KeyValidationResult;
@@ -14,10 +18,39 @@ export declare function validatePrivateKey(key: string): KeyValidationResult;
 export declare function maskSecret(value: string): string;
 export declare function generateWalletKeys(): WalletKeys;
 export declare function generateWalletForChain(chain: WalletChain): WalletGenerateResult;
+export { syncSolanaPublicKeyEnv } from "./wallet-env-sync.ts";
+export declare function setSolanaWalletEnv(privateKey: string): string | null;
 /** Validate key, store in process.env. Caller persists to config if needed. */
 export declare function importWallet(chain: WalletChain, privateKey: string): WalletImportResult;
-/** Derive addresses from env keys. Works without a running runtime. */
+export declare const STEWARD_EVM_ADDRESS_ENV_KEY = "STEWARD_EVM_ADDRESS";
+export declare const STEWARD_SOLANA_ADDRESS_ENV_KEY = "STEWARD_SOLANA_ADDRESS";
+/**
+ * Initialise the steward wallet address cache.
+ *
+ * Call once during server startup.  Fetches addresses from the steward API
+ * and writes them to `process.env.STEWARD_EVM_ADDRESS` /
+ * `process.env.STEWARD_SOLANA_ADDRESS` so the synchronous
+ * `getWalletAddresses()` can use them without hitting the network.
+ */
+export declare function initStewardWalletCache(): Promise<void>;
+/**
+ * Derive addresses from env keys.  Works without a running runtime.
+ *
+ * Resolution order (steward-first):
+ *   1. Steward cached addresses  (`STEWARD_EVM_ADDRESS` / `STEWARD_SOLANA_ADDRESS`)
+ *   2. Local private key derivation  (`EVM_PRIVATE_KEY` / `SOLANA_PRIVATE_KEY`)
+ *   3. Managed address env vars  (`ELIZA_MANAGED_EVM_ADDRESS` / `ELIZA_MANAGED_SOLANA_ADDRESS`)
+ */
 export declare function getWalletAddresses(): WalletAddresses;
+/**
+ * Extended wallet addresses including steward-managed wallets.
+ * Calls steward API (async) to discover additional addresses.
+ * Key-derived addresses are always preferred; steward addresses fill gaps.
+ */
+export declare function getWalletAddressesWithSteward(): Promise<WalletAddresses & {
+    stewardEvmAddress?: string | null;
+    stewardSolanaAddress?: string | null;
+}>;
 export declare function fetchSolanaBalances(address: string, heliusKey: string): Promise<{
     solBalance: string;
     solValueUsd: string;

package/packages/agent/src/api/wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACX,MAAM,qBAAqB,CAAC;AAI7B,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,4BAA4B,EAC5B,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,cAAc,EACnB,kBAAkB,EAClB,KAAK,eAAe,EACpB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAK9B,eAAO,MAAM,2BAA2B,8BAA8B,CAAC;AACvE,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AAQ7E,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAW9D;AAkID,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAmBpE;AAqED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CA+BtE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAyBzE;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAQnE;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAID,wBAAgB,kBAAkB,IAAI,UAAU,CAS/C;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,GACjB,oBAAoB,CAWtB;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAiBpB;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,eAAe,CAkDpD;AAmDD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC,CAqFD;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC,CAiCD"}
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../../../src/api/wallet.ts"],"names":[],"mappings":"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"}