@elizaos/app-core 2.0.0-alpha.73 → 2.0.0-alpha.75

package/components/avatar/retargetMixamoFbxToVrm.js

@@ -0,0 +1,88 @@
+import * as THREE from "three";
+import { mixamoVRMRigMap } from "./mixamoVRMRigMap";
+function normalizeMixamoRigName(name) {
+    const pipe = name.lastIndexOf("|");
+    const base = pipe >= 0 ? name.slice(pipe + 1) : name;
+    const colon = base.indexOf(":");
+    if (colon >= 0) {
+        const ns = base.slice(0, colon);
+        const rest = base.slice(colon + 1);
+        if (ns === "mixamorig")
+            return `mixamorig${rest}`;
+        return rest;
+    }
+    return base;
+}
+function isVrm0(vrm) {
+    const mv = String(vrm.meta?.metaVersion ?? "");
+    return mv.startsWith("0");
+}
+function findNode(scene, rawName, normalizedName) {
+    return (scene.getObjectByName(rawName) ??
+        scene.getObjectByName(normalizedName) ??
+        scene.getObjectByName(rawName.includes(":") ? (rawName.split(":")[1] ?? rawName) : rawName) ??
+        null);
+}
+/**
+ * Retarget a Mixamo FBX animation clip onto a VRM.
+ * Quaternion tracks are converted into VRM space and position tracks are
+ * scaled by hips height ratio.
+ */
+export function retargetMixamoFbxToVrm(sourceScene, sourceClip, vrm) {
+    sourceScene.updateMatrixWorld(true);
+    vrm.scene.updateMatrixWorld(true);
+    const tracks = [];
+    const restRotationInverse = new THREE.Quaternion();
+    const parentRestWorldRotation = new THREE.Quaternion();
+    const q = new THREE.Quaternion();
+    const motionHipsNode = findNode(sourceScene, "mixamorigHips", "mixamorigHips");
+    const motionHipsHeight = Math.abs(motionHipsNode?.position.y ?? 0);
+    const vrmHipsHeight = Math.abs(vrm.humanoid?.normalizedRestPose.hips?.position?.[1] ?? 0);
+    const hipsPositionScale = motionHipsHeight > 1e-6 && vrmHipsHeight > 1e-6
+        ? vrmHipsHeight / motionHipsHeight
+        : 1;
+    for (const track of sourceClip.tracks) {
+        const parts = track.name.split(".");
+        const rawRigName = parts[0];
+        const propertyName = parts[1];
+        if (!rawRigName || !propertyName)
+            continue;
+        const normalizedRigName = normalizeMixamoRigName(rawRigName);
+        const vrmBoneName = mixamoVRMRigMap[normalizedRigName];
+        if (!vrmBoneName)
+            continue;
+        const vrmNode = vrm.humanoid?.getNormalizedBoneNode(vrmBoneName);
+        if (!vrmNode)
+            continue;
+        const mixamoRigNode = findNode(sourceScene, rawRigName, normalizedRigName);
+        if (!mixamoRigNode || !mixamoRigNode.parent)
+            continue;
+        mixamoRigNode.getWorldQuaternion(restRotationInverse).invert();
+        mixamoRigNode.parent.getWorldQuaternion(parentRestWorldRotation);
+        if (propertyName === "quaternion" &&
+            track instanceof THREE.QuaternionKeyframeTrack) {
+            const values = track.values.slice();
+            for (let i = 0; i < values.length; i += 4) {
+                q.fromArray(values, i);
+                q.premultiply(parentRestWorldRotation).multiply(restRotationInverse);
+                q.toArray(values, i);
+            }
+            tracks.push(new THREE.QuaternionKeyframeTrack(`${vrmNode.name}.quaternion`, track.times, values.map((v, i) => (isVrm0(vrm) && i % 2 === 0 ? -v : v))));
+            continue;
+        }
+        // Keep position-track behavior aligned with Girlfie runtime.
+        if (propertyName === "position" &&
+            track instanceof THREE.VectorKeyframeTrack) {
+            const values = track.values.map((v, i) => (isVrm0(vrm) && i % 3 !== 1 ? -v : v) * hipsPositionScale);
+            tracks.push(new THREE.VectorKeyframeTrack(`${vrmNode.name}.position`, track.times, values));
+        }
+    }
+    const hasHipsTrack = tracks.some((track) => track.name.startsWith(`${vrm.humanoid?.getNormalizedBoneNode("hips")?.name ?? "__missing__"}.`));
+    if (!hasHipsTrack) {
+        throw new Error(`Idle FBX retargeting failed: no hips bone track found (mapped ${tracks.length} tracks). ` +
+            "Expected Mixamo bone names like mixamorigHips/mixamorigSpine...");
+    }
+    const clip = new THREE.AnimationClip("idle", sourceClip.duration, tracks);
+    clip.optimize();
+    return clip;
+}

package/components/avatar/retargetMixamoGltfToVrm.d.ts

@@ -0,0 +1,11 @@
+import type { VRM } from "@pixiv/three-vrm";
+import * as THREE from "three";
+/**
+ * Retarget a Mixamo-style GLB animation clip onto a VRM.
+ * Position tracks are ignored to avoid root motion.
+ */
+export declare function retargetMixamoGltfToVrm(animation: {
+    scene: THREE.Group;
+    animations: THREE.AnimationClip[];
+}, vrm: VRM, clipName?: string): THREE.AnimationClip;
+//# sourceMappingURL=retargetMixamoGltfToVrm.d.ts.map

package/components/avatar/retargetMixamoGltfToVrm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retargetMixamoGltfToVrm.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/retargetMixamoGltfToVrm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAoB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoC/B;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,CAAA;CAAE,EACpE,GAAG,EAAE,GAAG,EACR,QAAQ,CAAC,EAAE,MAAM,GAChB,KAAK,CAAC,aAAa,CAyErB"}

package/components/avatar/retargetMixamoGltfToVrm.js

@@ -0,0 +1,80 @@
+import * as THREE from "three";
+import { mixamoVRMRigMap } from "./mixamoVRMRigMap";
+function normalizeMixamoRigName(name) {
+    const pipe = name.lastIndexOf("|");
+    const base = pipe >= 0 ? name.slice(pipe + 1) : name;
+    const colon = base.indexOf(":");
+    if (colon >= 0) {
+        const ns = base.slice(0, colon);
+        const rest = base.slice(colon + 1);
+        if (ns === "mixamorig")
+            return `mixamorig${rest}`;
+        return rest;
+    }
+    return base;
+}
+function isVrm0(vrm) {
+    const mv = String(vrm.meta?.metaVersion ?? "");
+    return mv.startsWith("0");
+}
+function findNode(scene, rawName, normalizedName) {
+    return (scene.getObjectByName(rawName) ??
+        scene.getObjectByName(normalizedName) ??
+        scene.getObjectByName(rawName.includes(":") ? (rawName.split(":")[1] ?? rawName) : rawName) ??
+        null);
+}
+/**
+ * Retarget a Mixamo-style GLB animation clip onto a VRM.
+ * Position tracks are ignored to avoid root motion.
+ */
+export function retargetMixamoGltfToVrm(animation, vrm, clipName) {
+    animation.scene.updateMatrixWorld(true);
+    vrm.scene.updateMatrixWorld(true);
+    const sourceClip = animation.animations[0];
+    if (!sourceClip) {
+        throw new Error("GLB contains no animation clips");
+    }
+    const tracks = [];
+    const restRotationInverse = new THREE.Quaternion();
+    const parentRestWorldRotation = new THREE.Quaternion();
+    const q = new THREE.Quaternion();
+    for (const track of sourceClip.tracks) {
+        const parts = track.name.split(".");
+        const rawRigName = parts[0];
+        const propertyName = parts[1];
+        if (!rawRigName || !propertyName)
+            continue;
+        if (propertyName !== "quaternion")
+            continue;
+        if (!(track instanceof THREE.QuaternionKeyframeTrack))
+            continue;
+        const normalizedRigName = normalizeMixamoRigName(rawRigName);
+        const vrmBoneName = mixamoVRMRigMap[normalizedRigName];
+        if (!vrmBoneName)
+            continue;
+        const vrmNode = vrm.humanoid?.getNormalizedBoneNode(vrmBoneName);
+        if (!vrmNode)
+            continue;
+        const mixamoRigNode = findNode(animation.scene, rawRigName, normalizedRigName);
+        if (!mixamoRigNode || !mixamoRigNode.parent)
+            continue;
+        mixamoRigNode.getWorldQuaternion(restRotationInverse).invert();
+        mixamoRigNode.parent.getWorldQuaternion(parentRestWorldRotation);
+        const values = track.values.slice();
+        for (let i = 0; i < values.length; i += 4) {
+            q.fromArray(values, i);
+            q.premultiply(parentRestWorldRotation).multiply(restRotationInverse);
+            q.toArray(values, i);
+        }
+        tracks.push(new THREE.QuaternionKeyframeTrack(`${vrmNode.name}.quaternion`, track.times, values.map((v, i) => (isVrm0(vrm) && i % 2 === 0 ? -v : v))));
+    }
+    const hasHipsTrack = tracks.some((track) => track.name.startsWith(`${vrm.humanoid?.getNormalizedBoneNode("hips")?.name ?? "__missing__"}.`));
+    if (!hasHipsTrack) {
+        throw new Error(`Retargeting failed: no hips bone track found (mapped ${tracks.length} tracks). ` +
+            "Expected Mixamo bone names like mixamorigHips/mixamorigSpine...");
+    }
+    const name = clipName ?? sourceClip.name ?? "retargeted";
+    const clip = new THREE.AnimationClip(name, sourceClip.duration, tracks);
+    clip.optimize();
+    return clip;
+}

package/components/chainConfig.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Central chain configuration registry.
+ *
+ * Every chain-specific constant (explorer URLs, native token details,
+ * gas thresholds, stablecoin addresses, logo URLs, address validation)
+ * lives here so that UI components and hooks can derive values from
+ * a single source of truth rather than scattering inline constants.
+ */
+export type ChainKey = "bsc" | "avax" | "solana" | "ethereum" | "base" | "arbitrum" | "optimism" | "polygon";
+export interface Stablecoin {
+    symbol: string;
+    address: string;
+}
+export interface ChainConfig {
+    /** Unique identifier used as filter key and in storage keys. */
+    chainKey: ChainKey;
+    /** Human-readable chain name. */
+    name: string;
+    /** Native gas-token symbol (e.g. BNB, AVAX, SOL). */
+    nativeSymbol: string;
+    /** Native token decimals. */
+    nativeDecimals: number;
+    /** Whether this is an EVM-compatible chain. */
+    isEvm: boolean;
+    /** Base URL of the chain's block explorer. */
+    explorerBaseUrl: string;
+    /** Path template for token pages — `{address}` is replaced. */
+    explorerTokenPath: string;
+    /** Path template for transaction pages — `{hash}` is replaced. */
+    explorerTxPath: string;
+    /** URL for the native gas-token logo. */
+    nativeLogoUrl: string;
+    /** TrustWallet assets CDN slug (e.g. `smartchain`, `avalanchec`). */
+    trustWalletSlug: string | null;
+    /** Minimum native balance to consider the wallet "trade-ready". */
+    gasReadyThreshold: number;
+    /** Reserve kept aside from max-balance swaps. */
+    swapGasReserve: number;
+    /** Well-known stablecoin contract addresses on this chain. */
+    stablecoins: Stablecoin[];
+    /** Regex to validate an address on this chain. */
+    addressRegex: RegExp;
+    /** Chain ID used by the DexScreener API. */
+    dexScreenerChainId: string;
+    /** Alternative chain name strings that resolve to this config. */
+    nameVariants: string[];
+    /** Brand color for the chain (hex string, e.g. `"#627eea"`). */
+    color: string;
+}
+export declare const CHAIN_CONFIGS: Record<ChainKey, ChainConfig>;
+/** Resolve a chain name (case-insensitive, trimmed) to its config. */
+export declare function getChainConfig(chainName: string): ChainConfig | null;
+/**
+ * Resolve a chain name string to a `ChainKey`.
+ * Returns `null` for unrecognised chains.
+ */
+export declare function resolveChainKey(chainName: string): ChainKey | null;
+/**
+ * Build the explorer URL for a token on the given chain.
+ * Returns `null` if the chain is unknown or the address is invalid.
+ */
+export declare function getExplorerTokenUrl(chainName: string, address: string): string | null;
+/**
+ * Build the explorer URL for a transaction on the given chain.
+ * Returns `null` if the chain is unknown.
+ */
+export declare function getExplorerTxUrl(chainName: string, hash: string): string | null;
+/**
+ * Get the native token logo URL for a chain, or `null` if unknown.
+ */
+export declare function getNativeLogoUrl(chainName: string): string | null;
+/**
+ * Get the TrustWallet CDN logo URL for a contract token on the given chain.
+ * Returns `null` if the chain has no TrustWallet slug or no contract address.
+ */
+export declare function getContractLogoUrl(chainName: string, contractAddress: string | null): string | null;
+/**
+ * Resolve a stablecoin address on a given chain by symbol.
+ * Returns `null` if not found.
+ */
+export declare function getStablecoinAddress(chainName: string, symbol: string): string | null;
+/** The primary chains we want to support prominently. */
+export declare const PRIMARY_CHAIN_KEYS: ChainKey[];
+/**
+ * Map a chain focus key (ChainKey or "all") to the legacy WalletRpcChain used
+ * by legacyCustomChains. Returns null for "all" or unknown chains.
+ */
+export declare function chainKeyToWalletRpcChain(chainFocus: string): "evm" | "bsc" | "solana" | null;
+//# sourceMappingURL=chainConfig.d.ts.map

package/components/chainConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainConfig.d.ts","sourceRoot":"","sources":["../../src/components/chainConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,QAAQ,GAChB,KAAK,GACL,MAAM,GACN,QAAQ,GACR,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,CAAC;IACnB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IAIf,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IAIvB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAI/B,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IAIvB,8DAA8D;IAC9D,WAAW,EAAE,UAAU,EAAE,CAAC;IAI1B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IAIrB,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC;IAI3B,kEAAkE;IAClE,YAAY,EAAE,MAAM,EAAE,CAAC;IAIvB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,CA+LvD,CAAC;AAYF,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAEpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAMf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAIf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,GAAG,IAAI,CAKf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAKf;AAED,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,EAMxC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GACjB,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAYjC"}

package/components/chainConfig.js

@@ -0,0 +1,287 @@
+/**
+ * Central chain configuration registry.
+ *
+ * Every chain-specific constant (explorer URLs, native token details,
+ * gas thresholds, stablecoin addresses, logo URLs, address validation)
+ * lives here so that UI components and hooks can derive values from
+ * a single source of truth rather than scattering inline constants.
+ */
+/* ── Registry ──────────────────────────────────────────────────────── */
+const HEX_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
+const SOLANA_ADDRESS_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+export const CHAIN_CONFIGS = {
+    bsc: {
+        chainKey: "bsc",
+        name: "BSC",
+        nativeSymbol: "BNB",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://bscscan.com",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/smartchain/info/logo.png",
+        trustWalletSlug: "smartchain",
+        gasReadyThreshold: 0.005,
+        swapGasReserve: 0.002,
+        stablecoins: [
+            { symbol: "USDT", address: "0x55d398326f99059fF775485246999027B3197955" },
+            { symbol: "USDC", address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "bsc",
+        nameVariants: ["bsc", "bnb chain", "bnb smart chain"],
+        color: "#f3ba2f",
+    },
+    avax: {
+        chainKey: "avax",
+        name: "Avalanche",
+        nativeSymbol: "AVAX",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://snowtrace.io",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/avalanchec/info/logo.png",
+        trustWalletSlug: "avalanchec",
+        gasReadyThreshold: 0.01,
+        swapGasReserve: 0.005,
+        stablecoins: [
+            { symbol: "USDT", address: "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7" },
+            { symbol: "USDC", address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "avalanche",
+        nameVariants: ["avax", "avalanche", "c-chain", "avalanche c-chain"],
+        color: "#e84142",
+    },
+    solana: {
+        chainKey: "solana",
+        name: "Solana",
+        nativeSymbol: "SOL",
+        nativeDecimals: 9,
+        isEvm: false,
+        explorerBaseUrl: "https://solscan.io",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/solana/info/logo.png",
+        trustWalletSlug: "solana",
+        gasReadyThreshold: 0.01,
+        swapGasReserve: 0.005,
+        stablecoins: [
+            {
+                symbol: "USDC",
+                address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+            },
+        ],
+        addressRegex: SOLANA_ADDRESS_RE,
+        dexScreenerChainId: "solana",
+        nameVariants: ["solana", "sol"],
+        color: "#9945ff",
+    },
+    ethereum: {
+        chainKey: "ethereum",
+        name: "Ethereum",
+        nativeSymbol: "ETH",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://etherscan.io",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/info/logo.png",
+        trustWalletSlug: "ethereum",
+        gasReadyThreshold: 0.005,
+        swapGasReserve: 0.002,
+        stablecoins: [
+            { symbol: "USDT", address: "0xdAC17F958D2ee523a2206206994597C13D831ec7" },
+            { symbol: "USDC", address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "ethereum",
+        nameVariants: ["ethereum", "mainnet", "eth"],
+        color: "#627eea",
+    },
+    base: {
+        chainKey: "base",
+        name: "Base",
+        nativeSymbol: "ETH",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://basescan.org",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/base/info/logo.png",
+        trustWalletSlug: "base",
+        gasReadyThreshold: 0.005,
+        swapGasReserve: 0.001,
+        stablecoins: [
+            { symbol: "USDC", address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "base",
+        nameVariants: ["base"],
+        color: "#0052ff",
+    },
+    arbitrum: {
+        chainKey: "arbitrum",
+        name: "Arbitrum",
+        nativeSymbol: "ETH",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://arbiscan.io",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/info/logo.png",
+        trustWalletSlug: null,
+        gasReadyThreshold: 0.005,
+        swapGasReserve: 0.001,
+        stablecoins: [
+            { symbol: "USDC", address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "arbitrum",
+        nameVariants: ["arbitrum"],
+        color: "#12aaff",
+    },
+    optimism: {
+        chainKey: "optimism",
+        name: "Optimism",
+        nativeSymbol: "ETH",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://optimistic.etherscan.io",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/info/logo.png",
+        trustWalletSlug: null,
+        gasReadyThreshold: 0.005,
+        swapGasReserve: 0.001,
+        stablecoins: [
+            { symbol: "USDC", address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "optimism",
+        nameVariants: ["optimism"],
+        color: "#ff0420",
+    },
+    polygon: {
+        chainKey: "polygon",
+        name: "Polygon",
+        nativeSymbol: "MATIC",
+        nativeDecimals: 18,
+        isEvm: true,
+        explorerBaseUrl: "https://polygonscan.com",
+        explorerTokenPath: "/token/{address}",
+        explorerTxPath: "/tx/{hash}",
+        nativeLogoUrl: "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/polygon/info/logo.png",
+        trustWalletSlug: "polygon",
+        gasReadyThreshold: 0.5,
+        swapGasReserve: 0.1,
+        stablecoins: [
+            { symbol: "USDT", address: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F" },
+            { symbol: "USDC", address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359" },
+        ],
+        addressRegex: HEX_ADDRESS_RE,
+        dexScreenerChainId: "polygon",
+        nameVariants: ["polygon"],
+        color: "#8247e5",
+    },
+};
+/* ── Lookup helpers ────────────────────────────────────────────────── */
+/** Pre-built lookup table: lowercase variant → ChainConfig. */
+const _variantMap = new Map();
+for (const config of Object.values(CHAIN_CONFIGS)) {
+    for (const variant of config.nameVariants) {
+        _variantMap.set(variant.toLowerCase(), config);
+    }
+}
+/** Resolve a chain name (case-insensitive, trimmed) to its config. */
+export function getChainConfig(chainName) {
+    return _variantMap.get(chainName.trim().toLowerCase()) ?? null;
+}
+/**
+ * Resolve a chain name string to a `ChainKey`.
+ * Returns `null` for unrecognised chains.
+ */
+export function resolveChainKey(chainName) {
+    const config = getChainConfig(chainName);
+    return config?.chainKey ?? null;
+}
+/**
+ * Build the explorer URL for a token on the given chain.
+ * Returns `null` if the chain is unknown or the address is invalid.
+ */
+export function getExplorerTokenUrl(chainName, address) {
+    const config = getChainConfig(chainName);
+    if (!config)
+        return null;
+    const trimmed = address.trim();
+    if (!config.addressRegex.test(trimmed))
+        return null;
+    return `${config.explorerBaseUrl}${config.explorerTokenPath.replace("{address}", trimmed)}`;
+}
+/**
+ * Build the explorer URL for a transaction on the given chain.
+ * Returns `null` if the chain is unknown.
+ */
+export function getExplorerTxUrl(chainName, hash) {
+    const config = getChainConfig(chainName);
+    if (!config)
+        return null;
+    return `${config.explorerBaseUrl}${config.explorerTxPath.replace("{hash}", hash.trim())}`;
+}
+/**
+ * Get the native token logo URL for a chain, or `null` if unknown.
+ */
+export function getNativeLogoUrl(chainName) {
+    return getChainConfig(chainName)?.nativeLogoUrl ?? null;
+}
+/**
+ * Get the TrustWallet CDN logo URL for a contract token on the given chain.
+ * Returns `null` if the chain has no TrustWallet slug or no contract address.
+ */
+export function getContractLogoUrl(chainName, contractAddress) {
+    if (!contractAddress)
+        return null;
+    const config = getChainConfig(chainName);
+    if (!config?.trustWalletSlug)
+        return null;
+    return `https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/${config.trustWalletSlug}/assets/${contractAddress}/logo.png`;
+}
+/**
+ * Resolve a stablecoin address on a given chain by symbol.
+ * Returns `null` if not found.
+ */
+export function getStablecoinAddress(chainName, symbol) {
+    const config = getChainConfig(chainName);
+    if (!config)
+        return null;
+    const upper = symbol.trim().toUpperCase();
+    return config.stablecoins.find((s) => s.symbol === upper)?.address ?? null;
+}
+/** The primary chains we want to support prominently. */
+export const PRIMARY_CHAIN_KEYS = [
+    "ethereum",
+    "base",
+    "bsc",
+    "avax",
+    "solana",
+];
+/**
+ * Map a chain focus key (ChainKey or "all") to the legacy WalletRpcChain used
+ * by legacyCustomChains. Returns null for "all" or unknown chains.
+ */
+export function chainKeyToWalletRpcChain(chainFocus) {
+    if (chainFocus === "all")
+        return null;
+    if (chainFocus === "bsc" || chainFocus === "solana")
+        return chainFocus;
+    const evmKeys = [
+        "ethereum",
+        "base",
+        "avax",
+        "arbitrum",
+        "optimism",
+        "polygon",
+    ];
+    return evmKeys.includes(chainFocus) ? "evm" : null;
+}

package/components/companion/CompanionHeader.d.ts

@@ -0,0 +1,15 @@
+import type { UiLanguage } from "@elizaos/app-core/i18n";
+import type { ShellView, UiTheme } from "@elizaos/app-core/state";
+import { type ReactNode } from "react";
+export interface CompanionHeaderProps {
+    activeShellView: ShellView;
+    onShellViewChange: (view: ShellView) => void;
+    uiLanguage: UiLanguage;
+    setUiLanguage: (language: UiLanguage) => void;
+    uiTheme: UiTheme;
+    setUiTheme: (theme: UiTheme) => void;
+    t: (key: string) => string;
+    children?: ReactNode;
+}
+export declare const CompanionHeader: import("react").NamedExoticComponent<CompanionHeaderProps>;
+//# sourceMappingURL=CompanionHeader.d.ts.map

package/components/companion/CompanionHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanionHeader.d.ts","sourceRoot":"","sources":["../../../src/components/companion/CompanionHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG7C,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,SAAS,CAAC;IAC3B,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,4DAiC1B,CAAC"}

package/components/companion/CompanionHeader.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo } from "react";
+import { ShellHeaderControls } from "../shared/ShellHeaderControls";
+export const CompanionHeader = memo(function CompanionHeader(props) {
+    const { activeShellView, onShellViewChange, uiLanguage, setUiLanguage, uiTheme, setUiTheme, t, children, } = props;
+    return (_jsx("header", { className: "absolute inset-x-0 top-0 z-10", "data-no-camera-drag": "true", children: _jsx(ShellHeaderControls, { activeShellView: activeShellView, onShellViewChange: onShellViewChange, uiLanguage: uiLanguage, setUiLanguage: setUiLanguage, uiTheme: uiTheme, setUiTheme: setUiTheme, t: t, className: "pointer-events-auto px-3 py-2 sm:px-4 sm:py-3", children: children }) }));
+});

package/components/companion/CompanionSceneHost.d.ts

@@ -0,0 +1,2 @@
+export { CompanionSceneHost, SharedCompanionScene, useSharedCompanionScene, } from "../CompanionSceneHost";
+//# sourceMappingURL=CompanionSceneHost.d.ts.map

package/components/companion/CompanionSceneHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanionSceneHost.d.ts","sourceRoot":"","sources":["../../../src/components/companion/CompanionSceneHost.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC"}

package/components/companion/CompanionSceneHost.js

@@ -0,0 +1 @@
+export { CompanionSceneHost, SharedCompanionScene, useSharedCompanionScene, } from "../CompanionSceneHost";

package/components/companion/VrmStage.d.ts

@@ -0,0 +1,3 @@
+export type { VrmStageAvatarEntry } from "../VrmStage";
+export { VrmStage } from "../VrmStage";
+//# sourceMappingURL=VrmStage.d.ts.map

package/components/companion/VrmStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VrmStage.d.ts","sourceRoot":"","sources":["../../../src/components/companion/VrmStage.tsx"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/components/companion/VrmStage.js

@@ -0,0 +1 @@
+export { VrmStage } from "../VrmStage";

package/components/companion/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Companion / 3D avatar components.
+ *
+ * Import from `@elizaos/app-core/companion` instead of
+ * `@elizaos/app-core/components` to opt-in to the three.js-based
+ * avatar rendering stack (~850 KB+). Consumers that don't need 3D
+ * companions can skip this entry point entirely.
+ */
+export * from "../avatar/VrmEngine";
+export * from "../avatar/VrmViewer";
+export * from "../ChatAvatar";
+export * from "../CompanionSceneHost";
+export * from "../CompanionShell";
+export * from "../CompanionView";
+export * from "../companion-shell-styles";
+export { useSharedCompanionScene } from "../shared-companion-scene-context";
+export * from "../VrmStage";
+//# sourceMappingURL=index.d.ts.map

package/components/companion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,cAAc,aAAa,CAAC"}

package/components/companion/index.js

@@ -0,0 +1,17 @@
+/**
+ * Companion / 3D avatar components.
+ *
+ * Import from `@elizaos/app-core/companion` instead of
+ * `@elizaos/app-core/components` to opt-in to the three.js-based
+ * avatar rendering stack (~850 KB+). Consumers that don't need 3D
+ * companions can skip this entry point entirely.
+ */
+export * from "../avatar/VrmEngine";
+export * from "../avatar/VrmViewer";
+export * from "../ChatAvatar";
+export * from "../CompanionSceneHost";
+export * from "../CompanionShell";
+export * from "../CompanionView";
+export * from "../companion-shell-styles";
+export { useSharedCompanionScene } from "../shared-companion-scene-context";
+export * from "../VrmStage";