nyxora 1.7.2 → 1.7.3

package/CHANGELOG.md

@@ -5,11 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.7.2] - Unreleased
+## [1.7.3] - Unreleased
+
+### Web3 Routing & Integrations
+- **Multi-Router Selection (DeFi)**: Added a dynamic Router dropdown to the Dashboard UI, allowing users to forcefully route transactions through specific protocols natively. Supported routers include `1inch`, `CowSwap (MEV-Protected)`, `Li.Fi`, `Relay`, `Uniswap V2`, `Uniswap V3`, and `PancakeSwap`. This integration heavily relies on deep aggregator proxying (bypassing the need for complex V2/V3 ABI calldata overhead) to ensure 100% smooth, anti-fail execution without requiring additional API keys.
+
+### Security & Polish
+- **Dashboard:** Redacted the sensitive Nyxora Auth Token from appearing in the Gateway Logs component on the frontend to prevent visual leakage during screen sharing or screenshots.
+
+## [1.7.2] - 2026-06-04
 
 ### UI/UX Enhancements
 - **Google Workspace Logout**: Users can now easily disconnect their Google Workspace accounts directly from the Dashboard (OS Skills tab). This triggers a secure token purge from both the OS Keyring and local storage, ensuring privacy and seamless account switching.
 
+### Cloud-Native Deployment
+- **Official Docker & GHCR Support**: Added comprehensive Docker containerization support (`Dockerfile`) and automated publishing pipelines to GitHub Container Registry (GHCR). 
+- **Docker Documentation**: Added a dedicated `DOCKER.md` guide explaining how to pull, interactively configure, and run the Nyxora daemon via Docker with isolated Volume storage (`/root/.nyxora`).
+
+### Documentation & Compliance
+- **Legal Infrastructure**: Added standard `Privacy Policy` (`privacy.md`) and `Terms of Service` (`terms.md`) to the VitePress documentation to prepare for official Google OAuth App Verification.
+- **Enterprise Roadmap Evolution**: Updated the documentation roadmap to reflect our "Nyxora Next Update" vision, outlining future plans for a Rust-Native Signer, Idempotent Policy Engine, Multi-VM Architecture, and Google App Verification.
+
 ## [1.7.1]
 
 ### CLI Enhancements

package/README.md

@@ -40,6 +40,7 @@ It operates under an institutional-grade **Cryptographically Bound Human-in-the-
 *   **Zero-Click Multi-Session**: Instantly create isolated chat sessions with smart auto-naming triggered by your first prompt, exactly like ChatGPT.
 *   **Dynamic Trending Tokens**: Live top 5 crypto assets feed directly injected into the dashboard, completely clickable for instant AI market analysis.
 *   **Premium Utility-Centric UI**: A sleek, dark-themed dashboard built for high readability and professional Web3 execution, featuring Pseudo-Generative UI widgets (`<BalanceWidget>`, `<MarketWidget>`, `<SwapWidget>`).
+*   **Context Overrides Defaults (NLP Intelligence)**: The Dashboard configuration (default chain & router) acts only as a safety net. If you issue an explicit command via Telegram (e.g., *"Swap 10 USDC to USDT on Arbitrum using Li.Fi"*), the NLP engine dynamically bypasses the default settings and executes exactly what you asked for, ensuring maximum flexibility.
 *   **Deep Personalization**: Feed the agent custom rules via `user.md` and define its core persona via `IDENTITY.md`.
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nyxora",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "license": "MIT",
   "workspaces": [
     "packages/*"

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nyxora-agent-core",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "private": true,
   "main": "src/gateway/server.ts",
   "dependencies": {

package/packages/core/src/config/parser.ts

@@ -39,7 +39,9 @@ export async function saveApiKeys(newKeys: Record<string, string>): Promise<void
 export interface NyxoraConfig {
   agent: {
     name: string;
+    description: string;
     default_chain: string;
+    default_router?: string;
   };
   llm: {
     provider: 'openai' | 'anthropic' | 'ollama' | 'gemini' | 'openrouter';
@@ -136,7 +138,7 @@ export function loadConfig(): NyxoraConfig {
     
     // Merge with defaults
     return {
-      agent: parsed.agent || { name: 'Nyxora-Default', default_chain: 'base' },
+      agent: parsed.agent || { name: 'Nyxora-Default', description: 'An autonomous agent running on your local machine.', default_chain: 'base', default_router: 'auto' },
       llm: parsed.llm || { 
         provider: 'openai', 
         model: 'gpt-4o-mini', 
@@ -165,7 +167,12 @@ export function loadConfig(): NyxoraConfig {
       console.error('[Config] Failed to load config.yaml. Using default configuration.', error);
     }
     return {
-      agent: { name: 'Nyxora-Default', default_chain: 'base' },
+      agent: {
+      name: "Nyxora-Default",
+      description: "An autonomous agent running on your local machine.",
+      default_chain: "ethereum",
+      default_router: "auto"
+    },
       llm: { 
         provider: 'openai', 
         model: 'gpt-4o-mini', 

package/packages/core/src/web3/skills/swapToken.ts

@@ -3,7 +3,8 @@ import { getPublicClient, getAddress, ChainName, SUPPORTED_CHAIN_NAMES } from '.
 import { txManager } from '../../agent/transactionManager';
 import { resolveToken, ERC20_ABI } from '../utils/tokens';
 import { saveTokenToWhitelist } from '../../utils/userWhitelistManager';
-import crypto from 'crypto';
+import { loadConfig } from '../../config/parser';
+import * as crypto from 'crypto';
 
 const CHAIN_IDS: Record<string, number> = {
   ethereum: 1,
@@ -15,7 +16,7 @@ const CHAIN_IDS: Record<string, number> = {
   polygon: 137,
 };
 
-async function getLifiQuote(fromChainId: number, toChainId: number, fromToken: string, toToken: string, amountWei: string, userAddress: string, slippage: number) {
+async function getLifiQuote(fromChainId: number, toChainId: number, fromToken: string, toToken: string, amountWei: string, userAddress: string, slippage: number, providerName?: string) {
   const url = new URL('https://li.quest/v1/quote');
   url.searchParams.append('fromChain', fromChainId.toString());
   url.searchParams.append('toChain', toChainId.toString());
@@ -24,6 +25,21 @@ async function getLifiQuote(fromChainId: number, toChainId: number, fromToken: s
   url.searchParams.append('fromAmount', amountWei);
   url.searchParams.append('fromAddress', userAddress);
   url.searchParams.append('slippage', slippage.toString());
+  
+  // Specific Exchange forcing (Native-feel integration via Aggregator constraint)
+  if (providerName && providerName !== 'lifi' && providerName !== 'auto') {
+    // Map our internal names to Li.Fi exchange names
+    const exchangeMap: Record<string, string> = {
+      'uniswap_v2': 'uniswap_v2',
+      'uniswap_v3': 'uniswap_v3',
+      'pancakeswap': 'pancakeswap',
+      '1inch': 'oneinch',
+      'cowswap': 'cowswap'
+    };
+    if (exchangeMap[providerName]) {
+      url.searchParams.append('allowExchanges', exchangeMap[providerName]);
+    }
+  }
 
   const res = await fetch(url.toString());
   if (!res.ok) {
@@ -65,7 +81,7 @@ export async function prepareSwapToken(
   toToken: string, 
   amountStr: string,
   mode: "auto" | "manual" = "auto",
-  providerName: "lifi" | "relay" = "lifi",
+  providerName: "auto" | "lifi" | "relay" | "uniswap_v2" | "uniswap_v3" | "pancakeswap" | "1inch" | "cowswap" = "auto",
   slippagePercent: number = 0.5
 ): Promise<string> {
   try {
@@ -101,7 +117,17 @@ export async function prepareSwapToken(
     let approvalAddress: string | null = null;
     let expectedOutputStr = "";
 
-    let actualProvider = mode === "auto" ? "lifi" : providerName;
+    // If auto, read from global configuration set by Dashboard UI
+    let actualProvider = mode === "auto" ? "auto" : providerName;
+    if (actualProvider === "auto") {
+      try {
+        const config = loadConfig();
+        actualProvider = (config.agent.default_router as any) || "lifi";
+        if (actualProvider === "auto") actualProvider = "lifi"; // strict fallback
+      } catch (e) {
+        actualProvider = "lifi";
+      }
+    }
     const isTestnet = chainId === 11155111;
 
     // --- SEPOLIA TESTNET MOCK ---
@@ -121,14 +147,7 @@ export async function prepareSwapToken(
     }
     // --- END MOCK ---
 
-    if (actualProvider === "lifi") {
-      const quote = await getLifiQuote(chainId, chainId, fromTokenAddress, toTokenAddress, amountWei, userAddress, slippagePercent / 100);
-      txRequest = quote.transactionRequest;
-      approvalAddress = quote.estimate.approvalAddress;
-      
-      const toDecimals = quote.action.toToken.decimals;
-      expectedOutputStr = formatUnits(BigInt(quote.estimate.toAmount), toDecimals);
-    } else if (actualProvider === "relay") {
+    if (actualProvider === "relay") {
       const relayQuote = await getRelayQuote(chainId, chainId, fromTokenAddress, toTokenAddress, amountWei, userAddress);
       if (!relayQuote.steps || relayQuote.steps.length === 0) throw new Error("No route found by Relay.");
       
@@ -144,6 +163,15 @@ export async function prepareSwapToken(
       }
       
       expectedOutputStr = relayQuote.details?.currencyOut?.amountFormatted || "Unknown";
+    } else {
+      // Use Li.Fi for lifi, 1inch, cowswap, uniswap_v2, uniswap_v3, pancakeswap
+      // We mapped the allowExchanges inside getLifiQuote
+      const quote = await getLifiQuote(chainId, chainId, fromTokenAddress, toTokenAddress, amountWei, userAddress, slippagePercent / 100, actualProvider);
+      txRequest = quote.transactionRequest;
+      approvalAddress = quote.estimate.approvalAddress;
+      
+      const toDecimals = quote.action.toToken.decimals;
+      expectedOutputStr = formatUnits(BigInt(quote.estimate.toAmount), toDecimals);
     }
 
     // Check allowance early so we know if we need to auto-approve
@@ -250,11 +278,11 @@ export const swapTokenToolDefinition = {
         mode: {
           type: "string",
           enum: ["auto", "manual"],
-          description: "auto uses lifi. manual uses the specified provider."
+          description: "auto uses default router. manual uses the specified provider."
         },
         providerName: {
           type: "string",
-          enum: ["lifi", "relay"],
+          enum: ["auto", "lifi", "relay", "uniswap_v2", "uniswap_v3", "pancakeswap", "1inch", "cowswap"],
           description: "Used if mode is manual."
         }
       },

package/packages/core/src/web3/utils/routers.ts

@@ -0,0 +1,102 @@
+export const ROUTER_ADDRESSES: Record<string, Record<string, string>> = {
+  uniswap_v2: {
+    ethereum: '0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D'
+  },
+  uniswap_v3: {
+    ethereum: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+    base: '0x2626664c2603336E57B271c5C0b26F421741e481',
+    arbitrum: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+    optimism: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+    polygon: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45'
+  },
+  pancakeswap: {
+    bsc: '0x10ED43C718714eb63d5aA57B78B54704E256024E'
+  }
+};
+
+export const UNISWAP_V2_ROUTER_ABI = [
+  {
+    "inputs": [
+      { "internalType": "uint256", "name": "amountIn", "type": "uint256" },
+      { "internalType": "uint256", "name": "amountOutMin", "type": "uint256" },
+      { "internalType": "address[]", "name": "path", "type": "address[]" },
+      { "internalType": "address", "name": "to", "type": "address" },
+      { "internalType": "uint256", "name": "deadline", "type": "uint256" }
+    ],
+    "name": "swapExactTokensForTokens",
+    "outputs": [{ "internalType": "uint256[]", "name": "amounts", "type": "uint256[]" }],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      { "internalType": "uint256", "name": "amountIn", "type": "uint256" },
+      { "internalType": "address[]", "name": "path", "type": "address[]" }
+    ],
+    "name": "getAmountsOut",
+    "outputs": [{ "internalType": "uint256[]", "name": "amounts", "type": "uint256[]" }],
+    "stateMutability": "view",
+    "type": "function"
+  }
+];
+
+export const UNISWAP_V3_ROUTER_ABI = [
+  {
+    "inputs": [
+      {
+        "components": [
+          { "internalType": "address", "name": "tokenIn", "type": "address" },
+          { "internalType": "address", "name": "tokenOut", "type": "address" },
+          { "internalType": "uint24", "name": "fee", "type": "uint24" },
+          { "internalType": "address", "name": "recipient", "type": "address" },
+          { "internalType": "uint256", "name": "amountIn", "type": "uint256" },
+          { "internalType": "uint256", "name": "amountOutMinimum", "type": "uint256" },
+          { "internalType": "uint160", "name": "sqrtPriceLimitX96", "type": "uint160" }
+        ],
+        "internalType": "struct IV3SwapRouter.ExactInputSingleParams",
+        "name": "params",
+        "type": "tuple"
+      }
+    ],
+    "name": "exactInputSingle",
+    "outputs": [{ "internalType": "uint256", "name": "amountOut", "type": "uint256" }],
+    "stateMutability": "payable",
+    "type": "function"
+  }
+];
+
+export const UNISWAP_V3_QUOTER_ABI = [
+  {
+    "inputs": [
+      {
+        "components": [
+          { "internalType": "address", "name": "tokenIn", "type": "address" },
+          { "internalType": "address", "name": "tokenOut", "type": "address" },
+          { "internalType": "uint256", "name": "amountIn", "type": "uint256" },
+          { "internalType": "uint24", "name": "fee", "type": "uint24" },
+          { "internalType": "uint160", "name": "sqrtPriceLimitX96", "type": "uint160" }
+        ],
+        "internalType": "struct IQuoterV2.QuoteExactInputSingleParams",
+        "name": "params",
+        "type": "tuple"
+      }
+    ],
+    "name": "quoteExactInputSingle",
+    "outputs": [
+      { "internalType": "uint256", "name": "amountOut", "type": "uint256" },
+      { "internalType": "uint160", "name": "sqrtPriceX96After", "type": "uint160" },
+      { "internalType": "uint32", "name": "initializedTicksCrossed", "type": "uint32" },
+      { "internalType": "uint256", "name": "gasEstimate", "type": "uint256" }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  }
+];
+
+export const QUOTER_ADDRESSES: Record<string, string> = {
+  ethereum: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  base: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+  arbitrum: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  optimism: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+  polygon: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e'
+};