@elizaos/agent 2.0.0-alpha.519 → 2.0.0-alpha.521

package/apps/app-steward/src/api/tx-service.d.ts

@@ -1,53 +0,0 @@
-/**
- * Ethereum transaction signing and contract interaction layer.
- *
- * Provides the missing transaction capability to Eliza's wallet system,
- * which currently only handles key generation and balance fetching.
- * Used by the registry and drop services for on-chain operations.
- */
-import { ethers } from "ethers";
-export interface JsonRpcEndpointProbeResult {
-    ok: boolean;
-    reason?: string;
-}
-export declare function normalizeJsonRpcUrl(rpcUrl: string): string;
-export declare function probeJsonRpcEndpoint(rpcUrl: string, timeoutMs?: number): Promise<JsonRpcEndpointProbeResult>;
-export declare class TxService {
-    private readonly provider;
-    private readonly wallet;
-    private readonly rpcUrl;
-    constructor(rpcUrl: string, privateKey: string);
-    /**
-     * Get fresh nonce for the wallet address.
-     * Always fetches from blockchain using a fresh provider to avoid caching issues.
-     * This ensures we always get the correct nonce even after failed transactions.
-     */
-    getFreshNonce(): Promise<number>;
-    get address(): string;
-    getBalance(): Promise<bigint>;
-    getBalanceFormatted(): Promise<string>;
-    getChainId(): Promise<number>;
-    getContract(address: string, abi: ethers.InterfaceAbi): ethers.Contract;
-    getReadOnlyContract(address: string, abi: ethers.InterfaceAbi): ethers.Contract;
-    estimateGas(tx: ethers.TransactionRequest): Promise<bigint>;
-    getFeeData(): Promise<ethers.FeeData>;
-    /**
-     * Wait for a transaction to be mined and return the receipt.
-     * Throws if the transaction fails or times out.
-     */
-    waitForTransaction(txHash: string, confirmations?: number, timeoutMs?: number): Promise<ethers.TransactionReceipt>;
-    /**
-     * Estimate the gas cost in ETH for a contract call.
-     * Useful for showing users how much gas they'll need.
-     */
-    estimateGasCostEth(tx: ethers.TransactionRequest): Promise<string>;
-    /**
-     * Check whether the wallet has enough balance for a given value + estimated gas.
-     */
-    hasEnoughBalance(value: bigint, gasEstimate: bigint): Promise<boolean>;
-    /**
-     * Log a summary of the tx service state for diagnostics.
-     */
-    logStatus(): Promise<void>;
-}
-//# sourceMappingURL=tx-service.d.ts.map

package/apps/app-steward/src/api/tx-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tx-service.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-steward/src/api/tx-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,SAAQ,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAoDrC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAwB9C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBtC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ;IAIvE,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,YAAY,GACvB,MAAM,CAAC,QAAQ;IAIZ,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAI3C;;;OAGG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAU,EACzB,SAAS,GAAE,MAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAiCrC;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5E;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CASjC"}

package/apps/app-steward/src/api/tx-service.js

@@ -1,217 +0,0 @@
-/**
- * Ethereum transaction signing and contract interaction layer.
- *
- * Provides the missing transaction capability to Eliza's wallet system,
- * which currently only handles key generation and balance fetching.
- * Used by the registry and drop services for on-chain operations.
- */
-import { createIntegrationTelemetrySpan } from "@elizaos/agent/diagnostics/integration-observability";
-import { logger } from "@elizaos/core";
-import { ethers } from "ethers";
-/**
- * Validate that a private key is a valid 32-byte hex string.
- */
-function isValidPrivateKey(key) {
-    const normalized = key.startsWith("0x") ? key.slice(2) : key;
-    // Must be 64 hex characters (32 bytes)
-    if (normalized.length !== 64)
-        return false;
-    // Must be valid hex
-    return /^[0-9a-fA-F]+$/.test(normalized);
-}
-export function normalizeJsonRpcUrl(rpcUrl) {
-    const trimmed = rpcUrl.trim();
-    if (!trimmed) {
-        throw new Error("EVM JSON-RPC URL is required.");
-    }
-    let parsed;
-    try {
-        parsed = new URL(trimmed);
-    }
-    catch {
-        throw new Error(`Invalid EVM JSON-RPC URL "${trimmed}": expected an http(s) URL.`);
-    }
-    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-        throw new Error(`Invalid EVM JSON-RPC URL "${trimmed}": expected http: or https:.`);
-    }
-    return parsed.toString();
-}
-export async function probeJsonRpcEndpoint(rpcUrl, timeoutMs = 2_000) {
-    const normalizedRpcUrl = normalizeJsonRpcUrl(rpcUrl);
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const response = await fetch(normalizedRpcUrl, {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({
-                jsonrpc: "2.0",
-                id: 1,
-                method: "eth_chainId",
-                params: [],
-            }),
-            signal: controller.signal,
-        });
-        if (!response.ok) {
-            return {
-                ok: false,
-                reason: `HTTP ${response.status} ${response.statusText}`.trim(),
-            };
-        }
-        const body = (await response.json());
-        if (typeof body.result === "string" &&
-            /^0x[0-9a-fA-F]+$/.test(body.result)) {
-            return { ok: true };
-        }
-        const errorMessage = typeof body.error?.message === "string"
-            ? body.error.message
-            : "missing eth_chainId result";
-        return { ok: false, reason: errorMessage };
-    }
-    catch (err) {
-        const message = err instanceof Error && err.name === "AbortError"
-            ? `timed out after ${timeoutMs}ms`
-            : err instanceof Error
-                ? err.message
-                : String(err);
-        return { ok: false, reason: message };
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-export class TxService {
-    provider;
-    wallet;
-    rpcUrl;
-    constructor(rpcUrl, privateKey) {
-        // Validate private key before attempting to create wallet
-        if (!isValidPrivateKey(privateKey)) {
-            const preview = privateKey.length > 10
-                ? `${privateKey.slice(0, 6)}...${privateKey.slice(-4)}`
-                : "(empty or too short)";
-            throw new Error(`Invalid EVM_PRIVATE_KEY: expected 64-character hex string, got ${preview}. ` +
-                `Please set a valid private key in your environment or .env file.`);
-        }
-        this.rpcUrl = normalizeJsonRpcUrl(rpcUrl);
-        this.provider = new ethers.JsonRpcProvider(this.rpcUrl);
-        const normalizedKey = privateKey.startsWith("0x")
-            ? privateKey
-            : `0x${privateKey}`;
-        // Create wallet with provider
-        this.wallet = new ethers.Wallet(normalizedKey, this.provider);
-    }
-    /**
-     * Get fresh nonce for the wallet address.
-     * Always fetches from blockchain using a fresh provider to avoid caching issues.
-     * This ensures we always get the correct nonce even after failed transactions.
-     */
-    async getFreshNonce() {
-        const span = createIntegrationTelemetrySpan({
-            boundary: "wallet",
-            operation: "rpc_get_nonce",
-        });
-        // Use a fresh provider for each nonce lookup to avoid ethers.js v6 caching
-        const freshProvider = new ethers.JsonRpcProvider(this.rpcUrl);
-        try {
-            const nonce = await freshProvider.getTransactionCount(this.wallet.address, "pending");
-            span.success();
-            return nonce;
-        }
-        catch (err) {
-            span.failure({ error: err });
-            throw err;
-        }
-        finally {
-            freshProvider.destroy();
-        }
-    }
-    get address() {
-        return this.wallet.address;
-    }
-    async getBalance() {
-        return this.provider.getBalance(this.wallet.address);
-    }
-    async getBalanceFormatted() {
-        const balance = await this.getBalance();
-        return ethers.formatEther(balance);
-    }
-    async getChainId() {
-        const network = await this.provider.getNetwork();
-        return Number(network.chainId);
-    }
-    getContract(address, abi) {
-        return new ethers.Contract(address, abi, this.wallet);
-    }
-    getReadOnlyContract(address, abi) {
-        return new ethers.Contract(address, abi, this.provider);
-    }
-    async estimateGas(tx) {
-        return this.provider.estimateGas(tx);
-    }
-    async getFeeData() {
-        return this.provider.getFeeData();
-    }
-    /**
-     * Wait for a transaction to be mined and return the receipt.
-     * Throws if the transaction fails or times out.
-     */
-    async waitForTransaction(txHash, confirmations = 1, timeoutMs = 120_000) {
-        const span = createIntegrationTelemetrySpan({
-            boundary: "wallet",
-            operation: "rpc_wait_for_transaction",
-            timeoutMs,
-        });
-        let receipt;
-        try {
-            receipt = await this.provider.waitForTransaction(txHash, confirmations, timeoutMs);
-        }
-        catch (err) {
-            span.failure({ error: err });
-            throw err;
-        }
-        if (!receipt) {
-            const err = new Error(`Transaction ${txHash} timed out after ${timeoutMs}ms`);
-            span.failure({ error: err, errorKind: "timeout" });
-            throw err;
-        }
-        if (receipt.status === 0) {
-            const err = new Error(`Transaction ${txHash} reverted`);
-            span.failure({ error: err, errorKind: "tx_reverted" });
-            throw err;
-        }
-        span.success();
-        return receipt;
-    }
-    /**
-     * Estimate the gas cost in ETH for a contract call.
-     * Useful for showing users how much gas they'll need.
-     */
-    async estimateGasCostEth(tx) {
-        const gasLimit = await this.estimateGas(tx);
-        const feeData = await this.getFeeData();
-        const gasPrice = feeData.gasPrice ?? feeData.maxFeePerGas ?? 0n;
-        const costWei = gasLimit * gasPrice;
-        return ethers.formatEther(costWei);
-    }
-    /**
-     * Check whether the wallet has enough balance for a given value + estimated gas.
-     */
-    async hasEnoughBalance(value, gasEstimate) {
-        const balance = await this.getBalance();
-        const feeData = await this.getFeeData();
-        const gasPrice = feeData.gasPrice ?? feeData.maxFeePerGas ?? 0n;
-        const gasCost = gasEstimate * gasPrice;
-        return balance >= value + gasCost;
-    }
-    /**
-     * Log a summary of the tx service state for diagnostics.
-     */
-    async logStatus() {
-        const [balance, chainId] = await Promise.all([
-            this.getBalanceFormatted(),
-            this.getChainId(),
-        ]);
-        logger.info(`[tx-service] address=${this.address} chain=${chainId} balance=${balance} ETH`);
-    }
-}

package/apps/app-steward/src/api/wallet-bsc-routes.d.ts

@@ -1,63 +0,0 @@
-/**
- * BSC wallet trade routes: preflight, quote, tx-status, trading profile,
- * transfer/execute, and production-defaults.
- *
- * Extracted from server.ts to reduce file size.
- */
-import type http from "node:http";
-import type { ReadJsonBodyOptions } from "@elizaos/agent/api/http-helpers";
-import type { ElizaConfig } from "@elizaos/agent/config/config";
-export interface WalletBscRouteDeps {
-    getWalletAddresses: () => {
-        evmAddress: string | null;
-        solanaAddress: string | null;
-    };
-    resolveWalletRpcReadiness: (config: ElizaConfig) => {
-        bscRpcUrls: string[];
-        cloudManagedAccess: boolean;
-    };
-    resolvePrimaryBscRpcUrl: (args: {
-        rpcUrls: string[];
-        cloudManagedAccess: boolean;
-    }) => string | null;
-    buildBscTradePreflight: (args: {
-        walletAddress: string | null;
-        tokenAddress?: string;
-        rpcUrls: string[];
-        cloudManagedAccess: boolean;
-    }) => Promise<unknown>;
-    buildBscTradeQuote: (args: {
-        walletAddress: string | null;
-        rpcUrls: string[];
-        cloudManagedAccess: boolean;
-        request: {
-            side: "buy" | "sell";
-            tokenAddress: string;
-            amount: string;
-            slippageBps?: number;
-            routeProvider?: "auto" | "pancakeswap-v2" | "0x";
-        };
-    }) => Promise<unknown>;
-    updateWalletTradeLedgerEntryStatus: (hash: string, update: unknown) => unknown;
-    loadWalletTradingProfile: (opts: unknown) => unknown;
-    resolveTradePermissionMode: (config: ElizaConfig) => unknown;
-    isAgentAutomationRequest: (req: http.IncomingMessage) => boolean;
-    canUseLocalTradeExecution: (mode: unknown, isAgentRequest: boolean) => boolean;
-    saveElizaConfig: (config: ElizaConfig) => void;
-}
-export interface WalletBscRouteContext {
-    req: http.IncomingMessage;
-    res: http.ServerResponse;
-    method: string;
-    pathname: string;
-    url: URL;
-    state: {
-        config: ElizaConfig;
-    };
-    json: (res: http.ServerResponse, data: unknown, status?: number) => void;
-    error: (res: http.ServerResponse, message: string, status?: number) => void;
-    readJsonBody: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
-    deps: WalletBscRouteDeps;
-}
-export declare function handleWalletBscRoutes(ctx: WalletBscRouteContext): Promise<boolean>;
-//# sourceMappingURL=wallet-bsc-routes.d.ts.map

package/apps/app-steward/src/api/wallet-bsc-routes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wallet-bsc-routes.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-steward/src/api/wallet-bsc-routes.ts"],"names":[],"mappings":"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"}

package/apps/app-steward/src/api/wallet-bsc-routes.js

@@ -1,318 +0,0 @@
-/**
- * BSC wallet trade routes: preflight, quote, tx-status, trading profile,
- * transfer/execute, and production-defaults.
- *
- * Extracted from server.ts to reduce file size.
- */
-import { logger } from "@elizaos/core";
-import { ethers } from "ethers";
-// ---------------------------------------------------------------------------
-// Route handler
-// ---------------------------------------------------------------------------
-export async function handleWalletBscRoutes(ctx) {
-    const { req, res, method, pathname, url, state, json, error, readJsonBody, deps, } = ctx;
-    // ── POST /api/wallet/trade/preflight ───────────────────────────────────
-    if (method === "POST" && pathname === "/api/wallet/trade/preflight") {
-        const body = await readJsonBody(req, res);
-        if (!body)
-            return true;
-        const addrs = deps.getWalletAddresses();
-        const walletRpcReadiness = deps.resolveWalletRpcReadiness(state.config);
-        try {
-            const result = await deps.buildBscTradePreflight({
-                walletAddress: addrs.evmAddress ?? null,
-                tokenAddress: body.tokenAddress,
-                rpcUrls: walletRpcReadiness.bscRpcUrls,
-                cloudManagedAccess: walletRpcReadiness.cloudManagedAccess,
-            });
-            json(res, result);
-        }
-        catch (err) {
-            logger.error(`[api] BSC trade preflight failed: ${err instanceof Error ? err.message : err}`);
-            error(res, `Trade preflight failed: ${err instanceof Error ? err.message : "unknown error"}`, 500);
-        }
-        return true;
-    }
-    // ── POST /api/wallet/trade/quote ────────────────────────────────────────
-    if (method === "POST" && pathname === "/api/wallet/trade/quote") {
-        const body = await readJsonBody(req, res);
-        if (!body)
-            return true;
-        if (!body.side || !body.tokenAddress || !body.amount) {
-            error(res, "side, tokenAddress, and amount are required", 400);
-            return true;
-        }
-        const addrs = deps.getWalletAddresses();
-        const walletRpcReadiness = deps.resolveWalletRpcReadiness(state.config);
-        try {
-            const result = await deps.buildBscTradeQuote({
-                walletAddress: addrs.evmAddress ?? null,
-                rpcUrls: walletRpcReadiness.bscRpcUrls,
-                cloudManagedAccess: walletRpcReadiness.cloudManagedAccess,
-                request: {
-                    side: body.side,
-                    tokenAddress: body.tokenAddress,
-                    amount: body.amount,
-                    slippageBps: body.slippageBps,
-                    routeProvider: body.routeProvider,
-                },
-            });
-            json(res, result);
-        }
-        catch (err) {
-            logger.error(`[api] BSC trade quote failed: ${err instanceof Error ? err.message : err}`);
-            error(res, `Trade quote failed: ${err instanceof Error ? err.message : "unknown error"}`, 500);
-        }
-        return true;
-    }
-    // ── GET /api/wallet/trade/tx-status ────────────────────────────────────
-    if (method === "GET" && pathname === "/api/wallet/trade/tx-status") {
-        const hash = url.searchParams.get("hash");
-        if (!hash?.trim()) {
-            error(res, "hash query parameter is required", 400);
-            return true;
-        }
-        const walletRpcReadiness = deps.resolveWalletRpcReadiness(state.config);
-        const rpcUrl = deps.resolvePrimaryBscRpcUrl({
-            rpcUrls: walletRpcReadiness.bscRpcUrls,
-            cloudManagedAccess: walletRpcReadiness.cloudManagedAccess,
-        });
-        if (!rpcUrl) {
-            error(res, "BSC RPC not configured.", 503);
-            return true;
-        }
-        try {
-            const provider = new ethers.JsonRpcProvider(rpcUrl);
-            const receipt = await provider.getTransactionReceipt(hash);
-            let txStatus;
-            let blockNumber = null;
-            let gasUsed = null;
-            let effectiveGasPriceWei = null;
-            let confirmations = 0;
-            let nonce = null;
-            if (!receipt) {
-                const tx = await provider.getTransaction(hash);
-                txStatus = tx ? "pending" : "not_found";
-                if (tx)
-                    nonce = tx.nonce;
-            }
-            else {
-                txStatus = receipt.status === 1 ? "success" : "reverted";
-                blockNumber = receipt.blockNumber ?? null;
-                gasUsed = receipt.gasUsed?.toString() ?? null;
-                effectiveGasPriceWei = receipt.gasPrice?.toString() ?? null;
-                const currentBlock = await provider.getBlockNumber();
-                confirmations =
-                    blockNumber !== null ? Math.max(0, currentBlock - blockNumber) : 0;
-                const tx = await provider.getTransaction(hash);
-                if (tx)
-                    nonce = tx.nonce;
-            }
-            if (txStatus === "success" || txStatus === "reverted") {
-                try {
-                    deps.updateWalletTradeLedgerEntryStatus(hash, {
-                        status: txStatus,
-                        confirmations,
-                        nonce,
-                        blockNumber,
-                        gasUsed,
-                        effectiveGasPriceWei,
-                        explorerUrl: `https://bscscan.com/tx/${hash}`,
-                    });
-                }
-                catch (ledgerErr) {
-                    logger.warn(`[api] Failed to update trade ledger: ${ledgerErr instanceof Error ? ledgerErr.message : ledgerErr}`);
-                }
-            }
-            provider.destroy();
-            json(res, {
-                ok: true,
-                hash,
-                status: txStatus,
-                explorerUrl: `https://bscscan.com/tx/${hash}`,
-                chainId: 56,
-                blockNumber,
-                confirmations,
-                nonce,
-                gasUsed,
-                effectiveGasPriceWei,
-            });
-        }
-        catch (err) {
-            logger.error(`[api] BSC tx-status failed: ${err instanceof Error ? err.message : err}`);
-            error(res, `TX status check failed: ${err instanceof Error ? err.message : "unknown error"}`, 500);
-        }
-        return true;
-    }
-    // ── GET /api/wallet/trading/profile ────────────────────────────────────
-    if (method === "GET" && pathname === "/api/wallet/trading/profile") {
-        const windowParam = url.searchParams.get("window");
-        const sourceParam = url.searchParams.get("source");
-        const window = windowParam === "7d" || windowParam === "30d" || windowParam === "all"
-            ? windowParam
-            : "30d";
-        const source = sourceParam === "agent" ||
-            sourceParam === "manual" ||
-            sourceParam === "all"
-            ? sourceParam
-            : "all";
-        try {
-            const profile = deps.loadWalletTradingProfile({ window, source });
-            json(res, profile);
-        }
-        catch (err) {
-            logger.error(`[api] Wallet trading profile failed: ${err instanceof Error ? err.message : err}`);
-            error(res, `Trading profile fetch failed: ${err instanceof Error ? err.message : "unknown error"}`, 500);
-        }
-        return true;
-    }
-    // ── POST /api/wallet/transfer/execute ──────────────────────────────────
-    if (method === "POST" && pathname === "/api/wallet/transfer/execute") {
-        const body = await readJsonBody(req, res);
-        if (!body)
-            return true;
-        if (!body.toAddress?.trim() ||
-            !body.amount?.trim() ||
-            !body.assetSymbol?.trim()) {
-            error(res, "toAddress, amount, and assetSymbol are required", 400);
-            return true;
-        }
-        const tradePermissionMode = deps.resolveTradePermissionMode(state.config);
-        const isAgentRequest = deps.isAgentAutomationRequest(req);
-        const hasLocalKey = Boolean(process.env.EVM_PRIVATE_KEY?.trim());
-        const canExecuteLocally = deps.canUseLocalTradeExecution(tradePermissionMode, isAgentRequest);
-        const addrs = deps.getWalletAddresses();
-        const walletRpcReadiness = deps.resolveWalletRpcReadiness(state.config);
-        let toAddress;
-        try {
-            toAddress = ethers.getAddress(body.toAddress.trim());
-        }
-        catch {
-            error(res, "Invalid toAddress — must be a valid EVM address", 400);
-            return true;
-        }
-        const isBnb = body.assetSymbol.toUpperCase() === "BNB";
-        let decimals = 18;
-        if (body.tokenAddress) {
-            try {
-                const tokenContract = new ethers.Contract(body.tokenAddress, ["function decimals() view returns (uint8)"], new ethers.JsonRpcProvider(deps.resolvePrimaryBscRpcUrl({
-                    rpcUrls: walletRpcReadiness.bscRpcUrls,
-                    cloudManagedAccess: walletRpcReadiness.cloudManagedAccess,
-                }) ?? "https://bsc-dataseed1.binance.org/"));
-                decimals = Number(await tokenContract.decimals());
-            }
-            catch {
-                // Fallback to 18 if decimals call fails
-            }
-        }
-        const unsignedTx = {
-            chainId: 56,
-            from: addrs.evmAddress ?? null,
-            to: isBnb ? toAddress : (body.tokenAddress ?? toAddress),
-            data: isBnb
-                ? "0x"
-                : (() => {
-                    const iface = new ethers.Interface([
-                        "function transfer(address to, uint256 amount) returns (bool)",
-                    ]);
-                    return iface.encodeFunctionData("transfer", [
-                        toAddress,
-                        ethers.parseUnits(body.amount?.trim(), decimals),
-                    ]);
-                })(),
-            valueWei: isBnb ? ethers.parseEther(body.amount.trim()).toString() : "0",
-            explorerUrl: "https://bscscan.com",
-            assetSymbol: body.assetSymbol,
-            amount: body.amount.trim(),
-            tokenAddress: body.tokenAddress,
-        };
-        if (!hasLocalKey || !canExecuteLocally || body.confirm !== true) {
-            json(res, {
-                ok: true,
-                mode: hasLocalKey && canExecuteLocally ? "local-key" : "user-sign",
-                executed: false,
-                requiresUserSignature: true,
-                toAddress,
-                amount: body.amount.trim(),
-                assetSymbol: body.assetSymbol,
-                tokenAddress: body.tokenAddress,
-                unsignedTx,
-            });
-            return true;
-        }
-        const rpcUrl = deps.resolvePrimaryBscRpcUrl({
-            rpcUrls: walletRpcReadiness.bscRpcUrls,
-            cloudManagedAccess: walletRpcReadiness.cloudManagedAccess,
-        });
-        if (!rpcUrl) {
-            error(res, "BSC RPC not configured for local execution.", 503);
-            return true;
-        }
-        try {
-            const evmKey = process.env.EVM_PRIVATE_KEY ?? "";
-            const provider = new ethers.JsonRpcProvider(rpcUrl);
-            const wallet = new ethers.Wallet(evmKey.startsWith("0x") ? evmKey : `0x${evmKey}`, provider);
-            const txReq = {
-                to: unsignedTx.to,
-                data: unsignedTx.data,
-                value: BigInt(unsignedTx.valueWei),
-                chainId: unsignedTx.chainId,
-            };
-            const txResponse = await wallet.sendTransaction(txReq);
-            const nonce = txResponse.nonce;
-            provider.destroy();
-            json(res, {
-                ok: true,
-                mode: "local-key",
-                executed: true,
-                requiresUserSignature: false,
-                toAddress,
-                amount: body.amount.trim(),
-                assetSymbol: body.assetSymbol,
-                tokenAddress: body.tokenAddress,
-                unsignedTx,
-                execution: {
-                    hash: txResponse.hash,
-                    nonce,
-                    gasLimit: txResponse.gasLimit?.toString() ?? "0",
-                    valueWei: unsignedTx.valueWei,
-                    explorerUrl: `https://bscscan.com/tx/${txResponse.hash}`,
-                    blockNumber: null,
-                    status: "pending",
-                },
-            });
-        }
-        catch (err) {
-            logger.error(`[api] Transfer execute failed: ${err instanceof Error ? err.message : err}`);
-            error(res, `Transfer failed: ${err instanceof Error ? err.message : "unknown error"}`, 500);
-        }
-        return true;
-    }
-    // ── POST /api/wallet/production-defaults ───────────────────────────────
-    if (method === "POST" && pathname === "/api/wallet/production-defaults") {
-        const changed = [];
-        if (!state.config.features) {
-            state.config.features = {};
-        }
-        const features = state.config.features;
-        if (!features.tradePermissionMode) {
-            features.tradePermissionMode = "user-sign-only";
-            changed.push("tradePermissionMode=user-sign-only");
-        }
-        if (changed.length > 0) {
-            try {
-                deps.saveElizaConfig(state.config);
-            }
-            catch (err) {
-                logger.warn(`[api] production-defaults config save failed: ${err instanceof Error ? err.message : err}`);
-            }
-        }
-        json(res, {
-            ok: true,
-            applied: changed,
-            tradePermissionMode: deps.resolveTradePermissionMode(state.config),
-        });
-        return true;
-    }
-    return false;
-}