@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/api/auth-routes.js

@@ -0,0 +1,54 @@
+import crypto from "node:crypto";
+export async function handleAuthRoutes(ctx) {
+    const { req, res, method, pathname, readJsonBody, json, error, pairingEnabled, ensurePairingCode, normalizePairingCode, rateLimitPairing, getPairingExpiresAt, clearPairing, } = ctx;
+    if (!pathname.startsWith("/api/auth/"))
+        return false;
+    if (method === "GET" && pathname === "/api/auth/status") {
+        const required = Boolean(process.env.ELIZA_API_TOKEN?.trim());
+        const enabled = pairingEnabled();
+        if (enabled)
+            ensurePairingCode();
+        json(res, {
+            required,
+            pairingEnabled: enabled,
+            expiresAt: enabled ? getPairingExpiresAt() : null,
+        });
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/auth/pair") {
+        const body = await readJsonBody(req, res);
+        if (!body)
+            return true;
+        const token = process.env.ELIZA_API_TOKEN?.trim();
+        if (!token) {
+            error(res, "Pairing not enabled", 400);
+            return true;
+        }
+        if (!pairingEnabled()) {
+            error(res, "Pairing disabled", 403);
+            return true;
+        }
+        if (!rateLimitPairing(req.socket.remoteAddress ?? null)) {
+            error(res, "Too many attempts. Try again later.", 429);
+            return true;
+        }
+        const provided = normalizePairingCode(body.code ?? "");
+        const current = ensurePairingCode();
+        if (!current || Date.now() > getPairingExpiresAt()) {
+            ensurePairingCode();
+            error(res, "Pairing code expired. Check server logs for a new code.", 410);
+            return true;
+        }
+        const expected = normalizePairingCode(current);
+        const a = Buffer.from(expected, "utf8");
+        const b = Buffer.from(provided, "utf8");
+        if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
+            error(res, "Invalid pairing code", 403);
+            return true;
+        }
+        clearPairing();
+        json(res, { token });
+        return true;
+    }
+    return false;
+}

package/packages/agent/src/api/bsc-trade.d.ts

@@ -0,0 +1,34 @@
+/**
+ * BSC trade preflight + quote helpers.
+ *
+ * Safety-first scope:
+ * - No execution/signing here.
+ * - Validate wallet/rpc/chain/gas/token before producing a quote.
+ */
+import type { BscTradePreflightResponse, BscTradeQuoteRequest, BscTradeQuoteResponse, BscUnsignedApprovalTx, BscUnsignedTradeTx } from "../contracts/wallet.js";
+export declare const PANCAKE_SWAP_V2_ROUTER: string;
+export declare const BSC_WBNB_FALLBACK: string;
+export interface BscTradeRpcConfig {
+    rpcUrls?: string[] | null;
+    nodeRealBscRpcUrl?: string | null;
+    quickNodeBscRpcUrl?: string | null;
+    bscRpcUrl?: string | null;
+    cloudManagedAccess?: boolean | null;
+}
+export interface BuildBscTradePreflightInput extends BscTradeRpcConfig {
+    walletAddress: string | null;
+    tokenAddress?: string | null;
+}
+export interface BuildBscTradeQuoteInput extends BscTradeRpcConfig {
+    walletAddress: string | null;
+    request: BscTradeQuoteRequest;
+}
+export declare function resolveBscRpcUrls(input: BscTradeRpcConfig): string[];
+export declare function resolvePrimaryBscRpcUrl(input: BscTradeRpcConfig): string | null;
+export declare function readTokenDecimals(rpcUrls: string[], tokenAddress: string): Promise<number>;
+export declare function buildBscTradePreflight(input: BuildBscTradePreflightInput): Promise<BscTradePreflightResponse>;
+export declare function buildBscTradeQuote(input: BuildBscTradeQuoteInput): Promise<BscTradeQuoteResponse>;
+export declare function buildBscBuyUnsignedTx(quote: BscTradeQuoteResponse, recipientAddress: string | null, deadlineSeconds?: number): BscUnsignedTradeTx;
+export declare function buildBscSellUnsignedTx(quote: BscTradeQuoteResponse, recipientAddress: string | null, deadlineSeconds?: number): BscUnsignedTradeTx;
+export declare function buildBscApproveUnsignedTx(tokenAddress: string, ownerAddress: string | null, spenderAddress: string, amountWei: string): BscUnsignedApprovalTx;
+//# sourceMappingURL=bsc-trade.d.ts.map

package/packages/agent/src/api/bsc-trade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsc-trade.d.ts","sourceRoot":"","sources":["../../../../../src/api/bsc-trade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EAErB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAYhC,eAAO,MAAM,sBAAsB,QAElC,CAAC;AACF,eAAO,MAAM,iBAAiB,QAE7B,CAAC;AAgBF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AA6BD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA0BpE;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,GACvB,MAAM,GAAG,IAAI,CAef;AAuJD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAajB;AAmCD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAkIpC;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAiIhC;AAcD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,CA8BpB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,CA+BpB;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAuCvB"}

package/packages/agent/src/api/bsc-trade.js

@@ -0,0 +1,567 @@
+/**
+ * BSC trade preflight + quote helpers.
+ *
+ * Safety-first scope:
+ * - No execution/signing here.
+ * - Validate wallet/rpc/chain/gas/token before producing a quote.
+ */
+import { logger } from "@elizaos/core";
+import { ethers } from "ethers";
+import { buildCloudEvmRpcUrl, DEFAULT_PUBLIC_BSC_RPC_URLS, } from "./wallet-rpc.js";
+const FETCH_TIMEOUT_MS = 15_000;
+const BSC_CHAIN_ID = 56;
+const MIN_GAS_BNB = "0.005";
+const DEFAULT_SLIPPAGE_BPS = 300;
+const MAX_SLIPPAGE_BPS = 5_000;
+export const PANCAKE_SWAP_V2_ROUTER = ethers.getAddress("0x10ED43C718714eb63d5aA57B78B54704E256024E");
+export const BSC_WBNB_FALLBACK = ethers.getAddress("0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c");
+const ROUTER_IFACE = new ethers.Interface([
+    "function WETH() view returns (address)",
+    "function getAmountsOut(uint256 amountIn, address[] calldata path) view returns (uint256[] memory amounts)",
+    "function swapExactETHForTokensSupportingFeeOnTransferTokens(uint amountOutMin, address[] path, address to, uint deadline)",
+    "function swapExactTokensForETHSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] path, address to, uint deadline)",
+]);
+const ERC20_IFACE = new ethers.Interface([
+    "function symbol() view returns (string)",
+    "function decimals() view returns (uint8)",
+    "function balanceOf(address owner) view returns (uint256)",
+    "function approve(address spender, uint256 amount) returns (bool)",
+]);
+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 resolveBscRpcUrls(input) {
+    const candidates = [
+        ...(input.rpcUrls ?? []).map((url) => normalizeRpcUrl(url)),
+        normalizeRpcUrl(input.nodeRealBscRpcUrl !== undefined
+            ? input.nodeRealBscRpcUrl
+            : process.env.NODEREAL_BSC_RPC_URL),
+        normalizeRpcUrl(input.quickNodeBscRpcUrl !== undefined
+            ? input.quickNodeBscRpcUrl
+            : process.env.QUICKNODE_BSC_RPC_URL),
+        // Standard plugin env key used across elizaOS EVM tooling.
+        normalizeRpcUrl(input.bscRpcUrl !== undefined ? input.bscRpcUrl : process.env.BSC_RPC_URL),
+        buildCloudEvmRpcUrl("bsc", {
+            cloudManagedAccess: input.cloudManagedAccess,
+        }),
+        ...(input.cloudManagedAccess
+            ? DEFAULT_PUBLIC_BSC_RPC_URLS.map((url) => normalizeRpcUrl(url))
+            : []),
+    ].filter((v) => Boolean(v));
+    return [...new Set(candidates)];
+}
+export function resolvePrimaryBscRpcUrl(input) {
+    const urls = resolveBscRpcUrls(input);
+    if (urls.length === 0)
+        return null;
+    const primary = urls[0];
+    try {
+        const parsed = new URL(primary);
+        if (parsed.protocol === "http:") {
+            logger.warn(`BSC RPC URL uses http: (${parsed.host}) — MITM risk for trade execution. Use https: in production.`);
+        }
+    }
+    catch {
+        // URL parsing failed; normalizeRpcUrl already validated it, so this shouldn't happen
+    }
+    return primary;
+}
+function hostLabel(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return "rpc";
+    }
+}
+function normalizeAddress(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    try {
+        return ethers.getAddress(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+function parseRpcChainId(value) {
+    if (!value || typeof value !== "string")
+        return null;
+    if (!value.startsWith("0x"))
+        return null;
+    const parsed = Number.parseInt(value, 16);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function clampSlippageBps(value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return DEFAULT_SLIPPAGE_BPS;
+    }
+    const rounded = Math.round(value);
+    if (rounded < 1)
+        return 1;
+    if (rounded > MAX_SLIPPAGE_BPS)
+        return MAX_SLIPPAGE_BPS;
+    return rounded;
+}
+function clampDeadlineSeconds(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return 600;
+    const rounded = Math.round(value);
+    if (rounded < 60)
+        return 60;
+    if (rounded > 3600)
+        return 3600;
+    return rounded;
+}
+function parsePositiveDecimal(value) {
+    const amount = Number.parseFloat(value);
+    if (!Number.isFinite(amount) || amount <= 0) {
+        throw new Error("Amount must be a positive number.");
+    }
+    return amount;
+}
+function formatPrice(amountIn, amountOut) {
+    const inNum = Number.parseFloat(amountIn);
+    const outNum = Number.parseFloat(amountOut);
+    if (!Number.isFinite(inNum) || !Number.isFinite(outNum) || inNum <= 0) {
+        return "0";
+    }
+    const price = outNum / inNum;
+    if (price >= 1000)
+        return price.toFixed(2);
+    if (price >= 1)
+        return price.toFixed(4);
+    if (price >= 0.001)
+        return price.toFixed(6);
+    return price.toExponential(4);
+}
+async function rpcCallWithFallback(rpcUrls, method, params) {
+    if (rpcUrls.length === 0) {
+        throw new Error("No BSC RPC endpoints configured.");
+    }
+    const payload = JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method,
+        params,
+    });
+    let lastError = "Unknown RPC error";
+    for (const rpcUrl of rpcUrls) {
+        try {
+            const response = await fetch(rpcUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+                body: payload,
+            });
+            const raw = await response.text();
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${raw.slice(0, 180)}`);
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                throw new Error(`Invalid JSON response: ${raw.slice(0, 180)}`);
+            }
+            if (parsed.error) {
+                throw new Error(parsed.error.message ?? `RPC error ${parsed.error.code}`);
+            }
+            if (parsed.result === undefined || parsed.result === null) {
+                throw new Error("RPC returned empty result.");
+            }
+            return { result: parsed.result, rpcUrl };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            lastError = `${hostLabel(rpcUrl)}: ${message}`;
+        }
+    }
+    throw new Error(lastError);
+}
+async function ethCall(rpcUrls, to, data) {
+    return rpcCallWithFallback(rpcUrls, "eth_call", [
+        { to, data },
+        "latest",
+    ]);
+}
+async function readWrappedNativeAddress(rpcUrls) {
+    try {
+        const encoded = ROUTER_IFACE.encodeFunctionData("WETH", []);
+        const call = await ethCall(rpcUrls, PANCAKE_SWAP_V2_ROUTER, encoded);
+        const decoded = ROUTER_IFACE.decodeFunctionResult("WETH", call.result);
+        const wrappedNative = decoded[0];
+        if (typeof wrappedNative !== "string" || !wrappedNative) {
+            throw new Error("Router WETH() returned an invalid address.");
+        }
+        return ethers.getAddress(wrappedNative);
+    }
+    catch (err) {
+        logger.warn(`[bsc-trade] failed to read router WETH(), falling back to WBNB constant: ${err instanceof Error ? err.message : String(err)}`);
+        return BSC_WBNB_FALLBACK;
+    }
+}
+export async function readTokenDecimals(rpcUrls, tokenAddress) {
+    try {
+        const encoded = ERC20_IFACE.encodeFunctionData("decimals", []);
+        const call = await ethCall(rpcUrls, tokenAddress, encoded);
+        const decoded = ERC20_IFACE.decodeFunctionResult("decimals", call.result);
+        const decimals = decoded[0];
+        if (typeof decimals !== "bigint")
+            return 18;
+        const parsed = Number(decimals);
+        if (!Number.isFinite(parsed) || parsed < 0)
+            return 18;
+        return parsed;
+    }
+    catch {
+        return 18;
+    }
+}
+async function readTokenSymbol(rpcUrls, tokenAddress) {
+    try {
+        const encoded = ERC20_IFACE.encodeFunctionData("symbol", []);
+        const call = await ethCall(rpcUrls, tokenAddress, encoded);
+        const decoded = ERC20_IFACE.decodeFunctionResult("symbol", call.result);
+        const symbol = decoded[0];
+        if (typeof symbol === "string" && symbol.trim()) {
+            return symbol.trim().slice(0, 16);
+        }
+    }
+    catch {
+        // Ignore and fall back to a deterministic symbol-like label.
+    }
+    return `TKN-${tokenAddress.slice(2, 6).toUpperCase()}`;
+}
+async function readTokenBalanceWei(rpcUrls, tokenAddress, walletAddress) {
+    const encoded = ERC20_IFACE.encodeFunctionData("balanceOf", [walletAddress]);
+    const call = await ethCall(rpcUrls, tokenAddress, encoded);
+    const decoded = ERC20_IFACE.decodeFunctionResult("balanceOf", call.result);
+    const balance = decoded[0];
+    if (typeof balance !== "bigint") {
+        throw new Error("Token balance response is invalid.");
+    }
+    return balance;
+}
+export async function buildBscTradePreflight(input) {
+    const checks = {
+        walletReady: false,
+        rpcReady: false,
+        chainReady: false,
+        gasReady: false,
+        tokenAddressValid: true,
+    };
+    const reasons = [];
+    const walletAddress = normalizeAddress(input.walletAddress);
+    const tokenAddressRaw = (input.tokenAddress ?? "").trim();
+    const tokenAddress = tokenAddressRaw
+        ? normalizeAddress(tokenAddressRaw)
+        : null;
+    const rpcUrls = resolveBscRpcUrls(input);
+    let chainId = null;
+    let bnbBalance = null;
+    let activeRpcUrl = null;
+    checks.walletReady = Boolean(walletAddress);
+    if (!checks.walletReady) {
+        reasons.push("Wallet not ready. Create or connect an EVM wallet first.");
+    }
+    if (tokenAddressRaw && !tokenAddress) {
+        checks.tokenAddressValid = false;
+        reasons.push("Token address format is invalid.");
+    }
+    if (rpcUrls.length === 0) {
+        reasons.push("BSC RPC not configured. Connect Eliza Cloud or set NODEREAL_BSC_RPC_URL, QUICKNODE_BSC_RPC_URL, or BSC_RPC_URL.");
+    }
+    else {
+        try {
+            const chainResponse = await rpcCallWithFallback(rpcUrls, "eth_chainId", []);
+            activeRpcUrl = chainResponse.rpcUrl;
+            checks.rpcReady = true;
+            chainId = parseRpcChainId(chainResponse.result);
+            checks.chainReady = chainId === BSC_CHAIN_ID;
+            if (!checks.chainReady) {
+                reasons.push(chainId === null
+                    ? "Unable to read chain id from RPC."
+                    : `RPC chain mismatch. Expected BSC (56), got ${chainId}.`);
+            }
+        }
+        catch (err) {
+            reasons.push(`BSC RPC unavailable: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (checks.walletReady && checks.rpcReady) {
+        try {
+            const rpcCandidates = activeRpcUrl
+                ? [activeRpcUrl, ...rpcUrls.filter((url) => url !== activeRpcUrl)]
+                : rpcUrls;
+            const balanceResponse = await rpcCallWithFallback(rpcCandidates, "eth_getBalance", [walletAddress, "latest"]);
+            if (!activeRpcUrl)
+                activeRpcUrl = balanceResponse.rpcUrl;
+            const balanceWei = BigInt(balanceResponse.result);
+            bnbBalance = ethers.formatEther(balanceWei);
+            checks.gasReady = balanceWei >= ethers.parseEther(MIN_GAS_BNB);
+            if (!checks.gasReady) {
+                reasons.push(`Insufficient BNB gas. Keep at least ${MIN_GAS_BNB} BNB available.`);
+            }
+        }
+        catch (err) {
+            reasons.push(`Failed to read wallet balance: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (tokenAddressRaw && tokenAddress && checks.rpcReady && checks.chainReady) {
+        try {
+            const rpcCandidates = activeRpcUrl
+                ? [activeRpcUrl, ...rpcUrls.filter((url) => url !== activeRpcUrl)]
+                : rpcUrls;
+            const codeResponse = await rpcCallWithFallback(rpcCandidates, "eth_getCode", [tokenAddress, "latest"]);
+            if (!activeRpcUrl)
+                activeRpcUrl = codeResponse.rpcUrl;
+            const code = codeResponse.result.trim().toLowerCase();
+            if (code === "0x" || code === "0x0") {
+                checks.tokenAddressValid = false;
+                reasons.push("Token contract not found on BSC.");
+            }
+        }
+        catch (err) {
+            checks.tokenAddressValid = false;
+            reasons.push(`Token contract check failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const ok = checks.walletReady &&
+        checks.rpcReady &&
+        checks.chainReady &&
+        checks.gasReady &&
+        checks.tokenAddressValid;
+    return {
+        ok,
+        walletAddress,
+        rpcUrlHost: activeRpcUrl ? hostLabel(activeRpcUrl) : null,
+        chainId,
+        bnbBalance,
+        minGasBnb: MIN_GAS_BNB,
+        checks,
+        reasons,
+    };
+}
+export async function buildBscTradeQuote(input) {
+    const side = input.request.side;
+    if (side !== "buy" && side !== "sell") {
+        throw new Error('Unsupported trade side. Use "buy" or "sell".');
+    }
+    const tokenAddress = normalizeAddress(input.request.tokenAddress);
+    if (!tokenAddress) {
+        throw new Error("Token address is required.");
+    }
+    const amountInput = input.request.amount.trim();
+    parsePositiveDecimal(amountInput);
+    const slippageBps = clampSlippageBps(input.request.slippageBps);
+    const preflight = await buildBscTradePreflight({
+        walletAddress: input.walletAddress,
+        tokenAddress,
+        nodeRealBscRpcUrl: input.nodeRealBscRpcUrl,
+        quickNodeBscRpcUrl: input.quickNodeBscRpcUrl,
+    });
+    if (!preflight.ok) {
+        throw new Error(preflight.reasons[0] ?? "Trade preflight failed.");
+    }
+    const rpcUrls = resolveBscRpcUrls(input);
+    if (rpcUrls.length === 0) {
+        throw new Error("BSC RPC unavailable.");
+    }
+    const wrappedNativeAddress = await readWrappedNativeAddress(rpcUrls);
+    const tokenDecimals = await readTokenDecimals(rpcUrls, tokenAddress);
+    const tokenSymbol = await readTokenSymbol(rpcUrls, tokenAddress);
+    const amountInWei = side === "buy"
+        ? ethers.parseEther(amountInput)
+        : ethers.parseUnits(amountInput, tokenDecimals);
+    if (side === "sell") {
+        if (!preflight.walletAddress) {
+            throw new Error("Wallet not ready for sell quote.");
+        }
+        const tokenBalanceWei = await readTokenBalanceWei(rpcUrls, tokenAddress, preflight.walletAddress);
+        if (amountInWei > tokenBalanceWei) {
+            throw new Error("Insufficient token balance for sell amount.");
+        }
+    }
+    if (side === "buy" && preflight.bnbBalance) {
+        const walletBalanceWei = ethers.parseEther(preflight.bnbBalance);
+        const gasReserveWei = ethers.parseEther(MIN_GAS_BNB);
+        if (amountInWei + gasReserveWei > walletBalanceWei) {
+            throw new Error(`Insufficient BNB for amount + gas reserve (${MIN_GAS_BNB} BNB).`);
+        }
+    }
+    const route = side === "buy"
+        ? [wrappedNativeAddress, tokenAddress]
+        : [tokenAddress, wrappedNativeAddress];
+    const quoteCall = ROUTER_IFACE.encodeFunctionData("getAmountsOut", [
+        amountInWei,
+        route,
+    ]);
+    const quoteResponse = await ethCall(rpcUrls, PANCAKE_SWAP_V2_ROUTER, quoteCall);
+    const decoded = ROUTER_IFACE.decodeFunctionResult("getAmountsOut", quoteResponse.result);
+    const amountsOut = decoded[0];
+    if (!Array.isArray(amountsOut) || amountsOut.length < 2) {
+        throw new Error("Router returned an invalid quote.");
+    }
+    const amountOutWei = amountsOut[amountsOut.length - 1];
+    if (typeof amountOutWei !== "bigint") {
+        throw new Error("Router quote output type is invalid.");
+    }
+    let minReceiveWei = (amountOutWei * BigInt(10_000 - slippageBps)) / 10000n;
+    if (minReceiveWei === 0n && amountOutWei > 0n) {
+        minReceiveWei = 1n; // Prevent zero-slippage execution for small amounts
+    }
+    const outDecimals = side === "buy" ? tokenDecimals : 18;
+    const inSymbol = side === "buy" ? "BNB" : tokenSymbol;
+    const outSymbol = side === "buy" ? tokenSymbol : "BNB";
+    const amountInFormatted = side === "buy"
+        ? ethers.formatEther(amountInWei)
+        : ethers.formatUnits(amountInWei, tokenDecimals);
+    const amountOutFormatted = ethers.formatUnits(amountOutWei, outDecimals);
+    const minReceiveFormatted = ethers.formatUnits(minReceiveWei, outDecimals);
+    return {
+        ok: true,
+        side,
+        routerAddress: PANCAKE_SWAP_V2_ROUTER,
+        wrappedNativeAddress,
+        tokenAddress,
+        slippageBps,
+        route,
+        quoteIn: {
+            symbol: inSymbol,
+            amount: amountInFormatted,
+            amountWei: amountInWei.toString(),
+        },
+        quoteOut: {
+            symbol: outSymbol,
+            amount: amountOutFormatted,
+            amountWei: amountOutWei.toString(),
+        },
+        minReceive: {
+            symbol: outSymbol,
+            amount: minReceiveFormatted,
+            amountWei: minReceiveWei.toString(),
+        },
+        price: formatPrice(amountInFormatted, amountOutFormatted),
+        preflight,
+    };
+}
+/**
+ * Assert that the quote's routerAddress matches the expected PancakeSwap V2 router.
+ * Prevents a compromised or tampered quote from directing funds to an arbitrary address.
+ */
+function assertRouterAddress(quote) {
+    if (quote.routerAddress !== PANCAKE_SWAP_V2_ROUTER) {
+        throw new Error(`Unexpected router address in quote: ${quote.routerAddress}. Expected PancakeSwap V2 router ${PANCAKE_SWAP_V2_ROUTER}.`);
+    }
+}
+export function buildBscBuyUnsignedTx(quote, recipientAddress, deadlineSeconds) {
+    assertRouterAddress(quote);
+    if (quote.side !== "buy") {
+        throw new Error("Only buy execution is currently supported.");
+    }
+    const normalizedRecipient = normalizeAddress(recipientAddress);
+    if (!normalizedRecipient) {
+        throw new Error("Recipient wallet address is required.");
+    }
+    const now = Math.floor(Date.now() / 1000);
+    const deadline = now + clampDeadlineSeconds(deadlineSeconds);
+    const data = ROUTER_IFACE.encodeFunctionData("swapExactETHForTokensSupportingFeeOnTransferTokens", [
+        BigInt(quote.minReceive.amountWei),
+        quote.route,
+        normalizedRecipient,
+        deadline,
+    ]);
+    return {
+        chainId: BSC_CHAIN_ID,
+        from: normalizedRecipient,
+        to: quote.routerAddress,
+        data,
+        valueWei: quote.quoteIn.amountWei,
+        deadline,
+        explorerUrl: "https://bscscan.com",
+    };
+}
+export function buildBscSellUnsignedTx(quote, recipientAddress, deadlineSeconds) {
+    assertRouterAddress(quote);
+    if (quote.side !== "sell") {
+        throw new Error("Only sell execution is supported for this payload.");
+    }
+    const normalizedRecipient = normalizeAddress(recipientAddress);
+    if (!normalizedRecipient) {
+        throw new Error("Recipient wallet address is required.");
+    }
+    const now = Math.floor(Date.now() / 1000);
+    const deadline = now + clampDeadlineSeconds(deadlineSeconds);
+    const data = ROUTER_IFACE.encodeFunctionData("swapExactTokensForETHSupportingFeeOnTransferTokens", [
+        BigInt(quote.quoteIn.amountWei),
+        BigInt(quote.minReceive.amountWei),
+        quote.route,
+        normalizedRecipient,
+        deadline,
+    ]);
+    return {
+        chainId: BSC_CHAIN_ID,
+        from: normalizedRecipient,
+        to: quote.routerAddress,
+        data,
+        valueWei: "0",
+        deadline,
+        explorerUrl: "https://bscscan.com",
+    };
+}
+export function buildBscApproveUnsignedTx(tokenAddress, ownerAddress, spenderAddress, amountWei) {
+    const normalizedToken = normalizeAddress(tokenAddress);
+    if (!normalizedToken) {
+        throw new Error("Token address is invalid for approval payload.");
+    }
+    const normalizedOwner = normalizeAddress(ownerAddress);
+    if (!normalizedOwner) {
+        throw new Error("Owner wallet address is required for approval payload.");
+    }
+    const normalizedSpender = normalizeAddress(spenderAddress);
+    if (!normalizedSpender) {
+        throw new Error("Spender address is invalid for approval payload.");
+    }
+    let amount;
+    try {
+        amount = BigInt(amountWei);
+    }
+    catch {
+        throw new Error(`Invalid approval amount: expected integer string, got "${String(amountWei).slice(0, 20)}"`);
+    }
+    if (amount <= 0n) {
+        throw new Error("Approval amount must be greater than zero.");
+    }
+    const data = ERC20_IFACE.encodeFunctionData("approve", [
+        normalizedSpender,
+        amount,
+    ]);
+    return {
+        chainId: BSC_CHAIN_ID,
+        from: normalizedOwner,
+        to: normalizedToken,
+        data,
+        valueWei: "0",
+        explorerUrl: "https://bscscan.com",
+        spender: normalizedSpender,
+        amountWei: amount.toString(),
+    };
+}

package/packages/agent/src/api/bug-report-routes.d.ts

@@ -0,0 +1,7 @@
+import type { RouteRequestContext } from "./route-helpers";
+export declare const BUG_REPORT_REPO = "elizaos/eliza";
+export declare function rateLimitBugReport(ip: string | null): boolean;
+export declare function resetBugReportRateLimit(): void;
+export declare function sanitize(input: string, maxLen?: number): string;
+export declare function handleBugReportRoutes(ctx: RouteRequestContext): Promise<boolean>;
+//# sourceMappingURL=bug-report-routes.d.ts.map

package/packages/agent/src/api/bug-report-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-report-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/bug-report-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAmB/C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAe7D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAaD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,MAAM,CAE/D;AA6BD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,OAAO,CAAC,CAyElB"}