@exagent/agent 0.1.11 → 0.1.13

package/dist/index.d.ts

@@ -35,36 +35,42 @@ declare const TradingConfigSchema: z.ZodObject<{
     maxDailyLossBps: z.ZodDefault<z.ZodNumber>;
     maxConcurrentPositions: z.ZodDefault<z.ZodNumber>;
     tradingIntervalMs: z.ZodDefault<z.ZodNumber>;
+    maxSlippageBps: z.ZodDefault<z.ZodNumber>;
+    minTradeValueUSD: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     timeHorizon: "intraday" | "swing" | "position";
     maxPositionSizeBps: number;
     maxDailyLossBps: number;
     maxConcurrentPositions: number;
     tradingIntervalMs: number;
+    maxSlippageBps: number;
+    minTradeValueUSD: number;
 }, {
     timeHorizon?: "intraday" | "swing" | "position" | undefined;
     maxPositionSizeBps?: number | undefined;
     maxDailyLossBps?: number | undefined;
     maxConcurrentPositions?: number | undefined;
     tradingIntervalMs?: number | undefined;
+    maxSlippageBps?: number | undefined;
+    minTradeValueUSD?: number | undefined;
 }>;
 type TradingConfig = z.infer<typeof TradingConfigSchema>;
-declare const VaultPolicySchema: z.ZodEnum<["disabled", "manual", "auto_when_qualified"]>;
+declare const VaultPolicySchema: z.ZodEnum<["disabled", "manual"]>;
 type VaultPolicy = z.infer<typeof VaultPolicySchema>;
 declare const VaultConfigSchema: z.ZodObject<{
-    policy: z.ZodDefault<z.ZodEnum<["disabled", "manual", "auto_when_qualified"]>>;
+    policy: z.ZodDefault<z.ZodEnum<["disabled", "manual"]>>;
     defaultName: z.ZodOptional<z.ZodString>;
     defaultSymbol: z.ZodOptional<z.ZodString>;
     feeRecipient: z.ZodOptional<z.ZodString>;
     preferVaultTrading: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    policy: "disabled" | "manual" | "auto_when_qualified";
+    policy: "disabled" | "manual";
     preferVaultTrading: boolean;
     defaultName?: string | undefined;
     defaultSymbol?: string | undefined;
     feeRecipient?: string | undefined;
 }, {
-    policy?: "disabled" | "manual" | "auto_when_qualified" | undefined;
+    policy?: "disabled" | "manual" | undefined;
     defaultName?: string | undefined;
     defaultSymbol?: string | undefined;
     feeRecipient?: string | undefined;
@@ -88,7 +94,7 @@ type RelayConfig$1 = z.infer<typeof RelayConfigSchema>;
 declare const AgentConfigSchema: z.ZodObject<{
     agentId: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
     name: z.ZodString;
-    network: z.ZodDefault<z.ZodEnum<["mainnet", "testnet"]>>;
+    network: z.ZodDefault<z.ZodLiteral<"mainnet">>;
     wallet: z.ZodOptional<z.ZodObject<{
         setup: z.ZodDefault<z.ZodEnum<["generate", "provide"]>>;
     }, "strip", z.ZodTypeAny, {
@@ -125,33 +131,39 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxDailyLossBps: z.ZodDefault<z.ZodNumber>;
         maxConcurrentPositions: z.ZodDefault<z.ZodNumber>;
         tradingIntervalMs: z.ZodDefault<z.ZodNumber>;
+        maxSlippageBps: z.ZodDefault<z.ZodNumber>;
+        minTradeValueUSD: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         timeHorizon: "intraday" | "swing" | "position";
         maxPositionSizeBps: number;
         maxDailyLossBps: number;
         maxConcurrentPositions: number;
         tradingIntervalMs: number;
+        maxSlippageBps: number;
+        minTradeValueUSD: number;
     }, {
         timeHorizon?: "intraday" | "swing" | "position" | undefined;
         maxPositionSizeBps?: number | undefined;
         maxDailyLossBps?: number | undefined;
         maxConcurrentPositions?: number | undefined;
         tradingIntervalMs?: number | undefined;
+        maxSlippageBps?: number | undefined;
+        minTradeValueUSD?: number | undefined;
     }>>;
     vault: z.ZodDefault<z.ZodObject<{
-        policy: z.ZodDefault<z.ZodEnum<["disabled", "manual", "auto_when_qualified"]>>;
+        policy: z.ZodDefault<z.ZodEnum<["disabled", "manual"]>>;
         defaultName: z.ZodOptional<z.ZodString>;
         defaultSymbol: z.ZodOptional<z.ZodString>;
         feeRecipient: z.ZodOptional<z.ZodString>;
         preferVaultTrading: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        policy: "disabled" | "manual" | "auto_when_qualified";
+        policy: "disabled" | "manual";
         preferVaultTrading: boolean;
         defaultName?: string | undefined;
         defaultSymbol?: string | undefined;
         feeRecipient?: string | undefined;
     }, {
-        policy?: "disabled" | "manual" | "auto_when_qualified" | undefined;
+        policy?: "disabled" | "manual" | undefined;
         defaultName?: string | undefined;
         defaultSymbol?: string | undefined;
         feeRecipient?: string | undefined;
@@ -174,7 +186,7 @@ declare const AgentConfigSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     agentId: string | number;
     name: string;
-    network: "mainnet" | "testnet";
+    network: "mainnet";
     llm: {
         provider: "custom" | "openai" | "anthropic" | "google" | "deepseek" | "mistral" | "groq" | "together" | "ollama";
         temperature: number;
@@ -190,9 +202,11 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxDailyLossBps: number;
         maxConcurrentPositions: number;
         tradingIntervalMs: number;
+        maxSlippageBps: number;
+        minTradeValueUSD: number;
     };
     vault: {
-        policy: "disabled" | "manual" | "auto_when_qualified";
+        policy: "disabled" | "manual";
         preferVaultTrading: boolean;
         defaultName?: string | undefined;
         defaultSymbol?: string | undefined;
@@ -218,7 +232,7 @@ declare const AgentConfigSchema: z.ZodObject<{
         temperature?: number | undefined;
         maxTokens?: number | undefined;
     };
-    network?: "mainnet" | "testnet" | undefined;
+    network?: "mainnet" | undefined;
     wallet?: {
         setup?: "generate" | "provide" | undefined;
     } | undefined;
@@ -229,9 +243,11 @@ declare const AgentConfigSchema: z.ZodObject<{
         maxDailyLossBps?: number | undefined;
         maxConcurrentPositions?: number | undefined;
         tradingIntervalMs?: number | undefined;
+        maxSlippageBps?: number | undefined;
+        minTradeValueUSD?: number | undefined;
     } | undefined;
     vault?: {
-        policy?: "disabled" | "manual" | "auto_when_qualified" | undefined;
+        policy?: "disabled" | "manual" | undefined;
         defaultName?: string | undefined;
         defaultSymbol?: string | undefined;
         feeRecipient?: string | undefined;
@@ -253,6 +269,17 @@ interface MarketData {
     prices: Record<string, number>;
     balances: Record<string, bigint>;
     portfolioValue: number;
+    /** 24h trading volume in USD per token */
+    volume24h?: Record<string, number>;
+    /** 24h price change percentage per token */
+    priceChange24h?: Record<string, number>;
+    /** Current Base gas price in wei */
+    gasPrice?: bigint;
+    /** Network context */
+    network?: {
+        chainId: number;
+        blockNumber?: number;
+    };
 }
 interface TradeSignal {
     action: 'buy' | 'sell' | 'hold';
@@ -289,7 +316,7 @@ interface LLMMetadata {
  * Vault Manager for Trading Agents
  *
  * Handles vault creation, qualification checking, and vault-aware trading.
- * Respects the agent's vault policy (disabled, manual, auto_when_qualified).
+ * Respects the agent's vault policy (disabled, manual).
  */
 
 interface VaultStatus {
@@ -301,14 +328,13 @@ interface VaultStatus {
     requirementsMet: boolean;
     requirements: {
         veXARequired: bigint;
-        burnFee: bigint;
         isBypassed: boolean;
     };
 }
 interface VaultManagerConfig {
     agentId: bigint;
     agentName: string;
-    network: 'mainnet' | 'testnet';
+    network: 'mainnet';
     walletKey: `0x${string}`;
     vaultConfig: VaultConfig;
 }
@@ -325,6 +351,7 @@ declare class VaultManager {
     private cachedVaultAddress;
     private lastVaultCheck;
     private readonly VAULT_CACHE_TTL;
+    private enabled;
     constructor(config: VaultManagerConfig);
     /**
      * Get the agent's vault policy
@@ -340,28 +367,22 @@ declare class VaultManager {
     getVaultStatus(): Promise<VaultStatus>;
     /**
      * Get vault creation requirements
+     * Note: No burnFee on mainnet — vault creation requires USDC seed instead
      */
     getRequirements(): Promise<{
         veXARequired: bigint;
-        burnFee: bigint;
         isBypassed: boolean;
     }>;
     /**
      * Get the agent's vault address (cached)
      */
     getVaultAddress(): Promise<Address | null>;
-    /**
-     * Check if the agent should create a vault based on policy and qualification
-     */
-    shouldCreateVault(): Promise<{
-        should: boolean;
-        reason: string;
-    }>;
     /**
      * Create a vault for the agent
+     * @param seedAmount - USDC seed amount in raw units (default: 100e6 = 100 USDC)
      * @returns Vault address if successful
      */
-    createVault(): Promise<{
+    createVault(seedAmount?: bigint): Promise<{
         success: boolean;
         vaultAddress?: Address;
         txHash?: Hash;
@@ -384,15 +405,6 @@ declare class VaultManager {
         txHash?: Hash;
         error?: string;
     } | null>;
-    /**
-     * Run the auto-creation check (call this periodically in the agent loop)
-     * Only creates vault if policy is 'auto_when_qualified'
-     */
-    checkAndAutoCreateVault(): Promise<{
-        action: 'created' | 'skipped' | 'already_exists' | 'not_qualified';
-        vaultAddress?: Address;
-        reason: string;
-    }>;
 }
 
 /**
@@ -464,13 +476,13 @@ declare class AgentRuntime {
     private isRunning;
     private mode;
     private configHash;
-    private lastVaultCheck;
     private cycleCount;
     private lastCycleAt;
     private lastPortfolioValue;
     private lastEthBalance;
     private processAlive;
-    private readonly VAULT_CHECK_INTERVAL;
+    private riskUniverse;
+    private allowedTokens;
     constructor(config: RuntimeConfig);
     /**
      * Initialize the agent runtime
@@ -490,6 +502,11 @@ declare class AgentRuntime {
      * that waits for the owner to link it from the website.
      */
     private ensureWalletLinked;
+    /**
+     * Load risk universe and allowed tokens from on-chain registry.
+     * This prevents the agent from wasting gas on trades that will revert.
+     */
+    private loadTradingRestrictions;
     /**
      * Sync the LLM config hash to chain for epoch tracking.
      * If the wallet has insufficient gas, enters a recovery loop
@@ -521,13 +538,10 @@ declare class AgentRuntime {
      */
     private runCycle;
     /**
-     * Check if ETH balance is below threshold and notify
+     * Check if ETH balance is below threshold and notify.
+     * Returns true if trading should continue, false if ETH is critically low.
      */
     private checkFundsLow;
-    /**
-     * Check for vault auto-creation based on policy
-     */
-    private checkVaultAutoCreation;
     /**
      * Stop the agent process completely
      */
@@ -537,7 +551,9 @@ declare class AgentRuntime {
      */
     private getRpcUrl;
     /**
-     * Default tokens to track
+     * Default tokens to track.
+     * These are validated against the on-chain registry's isTradeAllowed() during init —
+     * agents in restricted risk universes will have ineligible tokens filtered out.
      */
     private getDefaultTokens;
     private sleep;
@@ -745,11 +761,14 @@ declare function getAllStrategyTemplates(): StrategyTemplate[];
 
 /**
  * Trade Executor
- * Handles execution of trade signals through the ExagentRouter
+ * Handles execution of trade signals through the ExagentRouter.
+ * All trades go through the router — there is no direct DEX bypass.
+ * Pre-checks token eligibility to avoid wasting gas on reverts.
  */
 declare class TradeExecutor {
     private client;
     private config;
+    private allowedTokens;
     constructor(client: ExagentClient, config: RuntimeConfig);
     /**
      * Execute a single trade signal
@@ -770,7 +789,7 @@ declare class TradeExecutor {
         error?: string;
     }>>;
     /**
-     * Validate a signal against config limits
+     * Validate a signal against config limits and token restrictions
      */
     private validateSignal;
     private delay;
@@ -783,7 +802,10 @@ declare class TradeExecutor {
 declare class RiskManager {
     private config;
     private dailyPnL;
+    private dailyFees;
     private lastResetDate;
+    /** Minimum trade value in USD — trades below this are rejected as dust */
+    private minTradeValueUSD;
     constructor(config: TradingConfig);
     /**
      * Filter signals through risk checks
@@ -794,6 +816,10 @@ declare class RiskManager {
      * Validate individual signal against risk limits
      */
     private validateSignal;
+    /**
+     * Count non-zero token positions (excluding native ETH and stablecoins used as base currency)
+     */
+    private countActivePositions;
     /**
      * Check if daily loss limit has been hit
      */
@@ -803,14 +829,23 @@ declare class RiskManager {
      */
     private estimateSignalValue;
     /**
-     * Update daily PnL after a trade
+     * Update daily PnL after a trade (market gains/losses only)
      */
     updatePnL(pnl: number): void;
+    /**
+     * Update daily fees (trading fees, gas costs, etc.)
+     * Fees are tracked separately and do NOT count toward the daily loss limit.
+     * This prevents protocol fees from triggering circuit breakers.
+     */
+    updateFees(fees: number): void;
     /**
      * Get current risk status
+     * @param portfolioValue - Current portfolio value in USD (needed for accurate loss limit)
      */
-    getStatus(): {
+    getStatus(portfolioValue?: number): {
         dailyPnL: number;
+        dailyFees: number;
+        dailyNetPnL: number;
         dailyLossLimit: number;
         isLimitHit: boolean;
     };
@@ -818,22 +853,39 @@ declare class RiskManager {
 
 /**
  * Market Data Service
- * Fetches prices and portfolio data for strategy analysis.
+ * Fetches real prices from CoinGecko and on-chain balances for strategy analysis.
  *
  * Queries real on-chain balances for:
  * - Native ETH (via eth_getBalance)
  * - ERC-20 tokens (via balanceOf)
+ *
+ * Fetches real prices from CoinGecko free API.
+ * Refuses to return data if prices are stale (>60s old) to prevent
+ * agents from making decisions with outdated price information.
  */
 declare class MarketDataService {
     private rpcUrl;
     private client;
+    /** Cached prices from last fetch */
+    private cachedPrices;
+    /** Timestamp of last successful price fetch */
+    private lastPriceFetchAt;
     constructor(rpcUrl: string);
+    /** Cached volume data */
+    private cachedVolume24h;
+    /** Cached price change data */
+    private cachedPriceChange24h;
     /**
      * Fetch current market data for the agent
      */
     fetchMarketData(walletAddress: string, tokenAddresses: string[]): Promise<MarketData>;
     /**
-     * Fetch token prices from price oracle
+     * Check if cached prices are still fresh
+     */
+    get pricesAreFresh(): boolean;
+    /**
+     * Fetch token prices from CoinGecko free API
+     * Returns cached prices if still fresh (<60s old)
      */
     private fetchPrices;
     /**