@elizaos/agent 0.25.8 → 2.0.0-alpha.83

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

@@ -0,0 +1,367 @@
+import { DEFAULT_WALLET_RPC_SELECTIONS, normalizeWalletRpcSelections, } from "../contracts/wallet";
+export const DEFAULT_CLOUD_API_BASE_URL = "https://elizacloud.ai/api/v1";
+export const DEFAULT_PUBLIC_BSC_RPC_URLS = [
+    "https://bsc-dataseed1.binance.org/",
+];
+export const DEFAULT_PUBLIC_ETHEREUM_RPC_URLS = [
+    "https://ethereum.publicnode.com/",
+];
+export const DEFAULT_PUBLIC_BASE_RPC_URLS = [
+    "https://base.publicnode.com/",
+];
+export const DEFAULT_PUBLIC_AVALANCHE_RPC_URLS = [
+    "https://avalanche.publicnode.com/ext/bc/C/rpc",
+];
+export const DEFAULT_PUBLIC_SOLANA_RPC_URLS = [
+    "https://api.mainnet-beta.solana.com",
+];
+const PROVIDER_CREDENTIAL_KEYS = {
+    evm: {
+        "eliza-cloud": [],
+        alchemy: ["ALCHEMY_API_KEY"],
+        infura: ["INFURA_API_KEY"],
+        ankr: ["ANKR_API_KEY"],
+    },
+    bsc: {
+        "eliza-cloud": [],
+        alchemy: ["ALCHEMY_API_KEY"],
+        ankr: ["ANKR_API_KEY"],
+        nodereal: ["NODEREAL_BSC_RPC_URL"],
+        quicknode: ["QUICKNODE_BSC_RPC_URL"],
+    },
+    solana: {
+        "eliza-cloud": [],
+        "helius-birdeye": ["HELIUS_API_KEY", "BIRDEYE_API_KEY"],
+    },
+};
+const LEGACY_CUSTOM_CHAIN_KEYS = {
+    evm: ["ETHEREUM_RPC_URL", "BASE_RPC_URL", "AVALANCHE_RPC_URL"],
+    bsc: ["BSC_RPC_URL"],
+    solana: ["SOLANA_RPC_URL"],
+};
+const WALLET_RPC_CONFIG_KEYS = [
+    "ALCHEMY_API_KEY",
+    "INFURA_API_KEY",
+    "ANKR_API_KEY",
+    "ETHEREUM_RPC_URL",
+    "BASE_RPC_URL",
+    "AVALANCHE_RPC_URL",
+    "HELIUS_API_KEY",
+    "BIRDEYE_API_KEY",
+    "NODEREAL_BSC_RPC_URL",
+    "QUICKNODE_BSC_RPC_URL",
+    "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 uniqueRpcUrls(...groups) {
+    return [
+        ...new Set(groups
+            .flat()
+            .map((url) => normalizeRpcUrl(url))
+            .filter((url) => Boolean(url))),
+    ];
+}
+function hasStoredSelections(config) {
+    const selections = config?.wallet?.rpcProviders;
+    return Boolean(selections && Object.keys(selections).length > 0);
+}
+function inferSelectedRpcProviders() {
+    return {
+        evm: process.env.ALCHEMY_API_KEY?.trim()
+            ? "alchemy"
+            : process.env.INFURA_API_KEY?.trim()
+                ? "infura"
+                : process.env.ANKR_API_KEY?.trim()
+                    ? "ankr"
+                    : DEFAULT_WALLET_RPC_SELECTIONS.evm,
+        bsc: process.env.NODEREAL_BSC_RPC_URL?.trim()
+            ? "nodereal"
+            : process.env.QUICKNODE_BSC_RPC_URL?.trim()
+                ? "quicknode"
+                : process.env.ALCHEMY_API_KEY?.trim()
+                    ? "alchemy"
+                    : process.env.ANKR_API_KEY?.trim()
+                        ? "ankr"
+                        : DEFAULT_WALLET_RPC_SELECTIONS.bsc,
+        solana: process.env.HELIUS_API_KEY?.trim() || process.env.BIRDEYE_API_KEY?.trim()
+            ? "helius-birdeye"
+            : DEFAULT_WALLET_RPC_SELECTIONS.solana,
+    };
+}
+function hasLegacyCustomChainUrl(chain) {
+    return LEGACY_CUSTOM_CHAIN_KEYS[chain].some((key) => Boolean(normalizeSecret(process.env[key])));
+}
+function buildLegacyCustomChains(selections) {
+    return Object.keys(LEGACY_CUSTOM_CHAIN_KEYS).filter((chain) => selections[chain] === DEFAULT_WALLET_RPC_SELECTIONS[chain] &&
+        hasLegacyCustomChainUrl(chain));
+}
+export function normalizeRpcUrl(url) {
+    if (typeof url !== "string")
+        return null;
+    const trimmed = url.trim();
+    if (!trimmed)
+        return null;
+    try {
+        const parsed = new URL(trimmed);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            return null;
+        }
+        return parsed.toString();
+    }
+    catch {
+        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);
+    if (!cloudBaseUrl) {
+        return null;
+    }
+    const url = new URL(pathname.replace(/^\/+/, ""), `${cloudBaseUrl.replace(/\/+$/, "")}/`);
+    url.searchParams.set("api_key", cloudApiKey);
+    return normalizeRpcUrl(url.toString());
+}
+export function buildCloudEvmRpcUrl(chain, options = {}) {
+    return buildCloudRpcProxyUrl(`proxy/evm-rpc/${chain}`, options);
+}
+export function buildCloudSolanaRpcUrl(options = {}) {
+    return buildCloudRpcProxyUrl("proxy/solana-rpc", options);
+}
+export function hasElizaCloudRpcAccess(config) {
+    return Boolean(resolveCloudApiKey(config));
+}
+export function getStoredWalletRpcSelections(config) {
+    return normalizeWalletRpcSelections(config?.wallet?.rpcProviders);
+}
+export function getInventoryProviderOptions() {
+    return [
+        {
+            id: "evm",
+            name: "EVM",
+            description: "Ethereum, Base, Arbitrum, Optimism, Polygon.",
+            rpcProviders: [
+                {
+                    id: "eliza-cloud",
+                    name: "Eliza Cloud",
+                    description: "Managed RPC. No setup needed.",
+                    envKey: null,
+                    requiresKey: false,
+                },
+                {
+                    id: "infura",
+                    name: "Infura",
+                    description: "Reliable EVM infrastructure.",
+                    envKey: "INFURA_API_KEY",
+                    requiresKey: true,
+                },
+                {
+                    id: "alchemy",
+                    name: "Alchemy",
+                    description: "Full-featured EVM data platform.",
+                    envKey: "ALCHEMY_API_KEY",
+                    requiresKey: true,
+                },
+                {
+                    id: "ankr",
+                    name: "Ankr",
+                    description: "Decentralized RPC provider.",
+                    envKey: "ANKR_API_KEY",
+                    requiresKey: true,
+                },
+            ],
+        },
+        {
+            id: "bsc",
+            name: "BSC",
+            description: "BNB Smart Chain tokens, NFTs, and trades.",
+            rpcProviders: [
+                {
+                    id: "eliza-cloud",
+                    name: "Eliza Cloud",
+                    description: "Managed RPC. No setup needed.",
+                    envKey: null,
+                    requiresKey: false,
+                },
+                {
+                    id: "alchemy",
+                    name: "Alchemy",
+                    description: "Managed BSC RPC via Alchemy.",
+                    envKey: "ALCHEMY_API_KEY",
+                    requiresKey: true,
+                },
+                {
+                    id: "ankr",
+                    name: "Ankr",
+                    description: "Decentralized BSC RPC provider.",
+                    envKey: "ANKR_API_KEY",
+                    requiresKey: true,
+                },
+                {
+                    id: "nodereal",
+                    name: "NodeReal",
+                    description: "Dedicated BSC RPC endpoint.",
+                    envKey: "NODEREAL_BSC_RPC_URL",
+                    requiresKey: true,
+                },
+                {
+                    id: "quicknode",
+                    name: "QuickNode",
+                    description: "Managed BSC RPC endpoint.",
+                    envKey: "QUICKNODE_BSC_RPC_URL",
+                    requiresKey: true,
+                },
+            ],
+        },
+        {
+            id: "solana",
+            name: "Solana",
+            description: "Solana mainnet tokens and NFTs.",
+            rpcProviders: [
+                {
+                    id: "eliza-cloud",
+                    name: "Eliza Cloud",
+                    description: "Managed RPC. No setup needed.",
+                    envKey: null,
+                    requiresKey: false,
+                },
+                {
+                    id: "helius-birdeye",
+                    name: "Helius + Birdeye",
+                    description: "Solana balances and NFT metadata.",
+                    envKey: "HELIUS_API_KEY",
+                    requiresKey: true,
+                },
+            ],
+        },
+    ];
+}
+export function resolveBscRpcUrls(options = {}) {
+    return uniqueRpcUrls([
+        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 : []);
+}
+export function resolveEthereumRpcUrls(options = {}) {
+    return uniqueRpcUrls([process.env.ETHEREUM_RPC_URL, buildCloudEvmRpcUrl("mainnet", options)], options.cloudManagedAccess ? DEFAULT_PUBLIC_ETHEREUM_RPC_URLS : []);
+}
+export function resolveBaseRpcUrls(options = {}) {
+    return uniqueRpcUrls([process.env.BASE_RPC_URL, buildCloudEvmRpcUrl("base", options)], options.cloudManagedAccess ? DEFAULT_PUBLIC_BASE_RPC_URLS : []);
+}
+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 : []);
+}
+export function applyWalletRpcConfigUpdate(config, update) {
+    config.env ??= {};
+    const env = config.env;
+    const normalizedSelections = normalizeWalletRpcSelections(update.selections);
+    const selectedCredentialKeys = new Set();
+    for (const chain of Object.keys(normalizedSelections)) {
+        for (const key of PROVIDER_CREDENTIAL_KEYS[chain][normalizedSelections[chain]]) {
+            selectedCredentialKeys.add(key);
+        }
+    }
+    config.wallet = {
+        ...config.wallet,
+        rpcProviders: normalizedSelections,
+    };
+    for (const key of WALLET_RPC_CONFIG_KEYS) {
+        const value = update.credentials?.[key];
+        if (typeof value === "string" && value.trim()) {
+            const normalizedValue = value.trim();
+            env[key] = normalizedValue;
+            process.env[key] = normalizedValue;
+            continue;
+        }
+        if (typeof value === "string" || !selectedCredentialKeys.has(key)) {
+            delete env[key];
+            delete process.env[key];
+        }
+    }
+    const heliusKey = update.credentials?.HELIUS_API_KEY?.trim();
+    if (heliusKey) {
+        const solanaRpcUrl = `https://mainnet.helius-rpc.com/?api-key=${heliusKey}`;
+        env.SOLANA_RPC_URL = solanaRpcUrl;
+        process.env.SOLANA_RPC_URL = solanaRpcUrl;
+    }
+    else if (typeof update.credentials?.HELIUS_API_KEY === "string" &&
+        typeof update.credentials?.SOLANA_RPC_URL !== "string") {
+        delete env.SOLANA_RPC_URL;
+        delete process.env.SOLANA_RPC_URL;
+    }
+}
+export function resolveWalletRpcReadiness(config) {
+    const cloudApiKey = resolveCloudApiKey(config);
+    const cloudBaseUrl = resolveCloudApiBaseUrl(config?.cloud?.baseUrl);
+    const cloudManagedAccess = Boolean(cloudApiKey);
+    const cloudOptions = {
+        cloudManagedAccess,
+        cloudApiKey,
+        cloudBaseUrl,
+    };
+    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 {
+        cloudManagedAccess,
+        managedBscRpcReady: bscRpcUrls.length > 0,
+        evmBalanceReady: Boolean(process.env.ALCHEMY_API_KEY?.trim() ||
+            process.env.ANKR_API_KEY?.trim() ||
+            process.env.INFURA_API_KEY?.trim() ||
+            bscRpcUrls.length > 0 ||
+            ethereumRpcUrls.length > 0 ||
+            baseRpcUrls.length > 0 ||
+            avalancheRpcUrls.length > 0),
+        solanaBalanceReady: Boolean(process.env.HELIUS_API_KEY?.trim() || solanaRpcUrls.length > 0),
+        selectedRpcProviders,
+        legacyCustomChains,
+        bscRpcUrls,
+        ethereumRpcUrls,
+        baseRpcUrls,
+        avalancheRpcUrls,
+        solanaRpcUrls,
+    };
+}

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

@@ -0,0 +1,51 @@
+import type { BscTradeSide, BscTradeTxStatus, WalletTradeLedgerEntry, WalletTradeLedgerQuoteLeg, WalletTradeSource, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow } from "../contracts/wallet.js";
+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 interface WalletTradeLedgerStatusPatch {
+    status: BscTradeTxStatus;
+    confirmations: number;
+    nonce: number | null;
+    blockNumber: number | null;
+    gasUsed: string | null;
+    effectiveGasPriceWei: string | null;
+    reason?: string;
+    explorerUrl?: string;
+    updatedAt?: string;
+}
+export interface WalletTradingProfileOptions {
+    window?: WalletTradingProfileWindow;
+    source?: WalletTradingProfileSourceFilter;
+    stateDir?: string;
+}
+export declare function resolveWalletTradingProfileFilePath(stateDir?: string): string;
+export declare function readWalletTradeLedgerStore(stateDir?: string): WalletTradeLedgerStore;
+export declare function writeWalletTradeLedgerStore(store: WalletTradeLedgerStore, stateDir?: string): WalletTradeLedgerStore;
+export declare function recordWalletTradeLedgerEntry(input: WalletTradeLedgerRecordInput, stateDir?: string): WalletTradeLedgerEntry;
+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

@@ -0,0 +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"}