@circuitorg/agent-sdk 1.2.3 → 1.2.4

package/README.md

@@ -24,6 +24,11 @@ A simplified TypeScript SDK for building automated agents to deploy on Circuit.
   - [📈 Polymarket Prediction Markets](#-polymarket-prediction-markets)
     - [Place Market Orders](#place-market-orders)
     - [Redeem Positions](#redeem-positions)
+  - [Hyperliquid Perpetuals Trading](#hyperliquid-perpetuals-trading)
+    - [Account Information](#account-information)
+    - [Place Orders](#place-orders)
+    - [Order Management](#order-management)
+    - [Transfer Between Accounts](#transfer-between-accounts)
   - [📊 Transaction History](#-transaction-history)
   - [🚀 Sign \& Send Transactions](#-sign--send-transactions)
     - [Ethereum (any EVM chain)](#ethereum-any-evm-chain)
@@ -328,6 +333,91 @@ async function stop(agent: AgentContext): Promise<void> {
 }
 ```
 
+## Hyperliquid Perpetuals Trading
+
+Trade perpetual futures on Hyperliquid DEX with leverage.
+
+### Account Information
+
+```typescript
+async function run(agent: AgentContext): Promise<void> {
+  // Check balances
+  const balances = await agent.platforms.hyperliquid.balances();
+  if (balances.success && balances.data) {
+    await agent.log(`Account value: $${balances.data.perp.accountValue}`);
+    await agent.log(`Withdrawable: $${balances.data.perp.withdrawable}`);
+  }
+
+  // View open positions
+  const positions = await agent.platforms.hyperliquid.positions();
+  if (positions.success && positions.data) {
+    for (const pos of positions.data) {
+      await agent.log(`${pos.symbol}: ${pos.side} ${pos.size} @ ${pos.entryPrice}`);
+      await agent.log(`Unrealized PnL: $${pos.unrealizedPnl}`);
+    }
+  }
+}
+```
+
+### Place Orders
+
+```typescript
+async function run(agent: AgentContext): Promise<void> {
+  // Market order
+  const order = await agent.platforms.hyperliquid.placeOrder({
+    symbol: "BTC-USD",
+    side: "buy",
+    size: 0.0001,
+    price: 110000,  // Acts as slippage limit for market orders
+    market: "perp",
+    type: "market"
+  });
+
+  if (order.success && order.data) {
+    await agent.log(`Order ${order.data.orderId}: ${order.data.status}`);
+  } else {
+    await agent.log(order.error, { error: true });
+  }
+}
+```
+
+### Order Management
+
+```typescript
+async function run(agent: AgentContext): Promise<void> {
+  // Get open orders
+  const openOrders = await agent.platforms.hyperliquid.openOrders();
+
+  // Get specific order details
+  const order = await agent.platforms.hyperliquid.order("12345");
+
+  // Cancel an order
+  const result = await agent.platforms.hyperliquid.deleteOrder("12345", "BTC-USD");
+
+  // View historical orders
+  const history = await agent.platforms.hyperliquid.orders();
+
+  // Check order fills
+  const fills = await agent.platforms.hyperliquid.orderFills();
+}
+```
+
+### Transfer Between Accounts
+
+```typescript
+async function run(agent: AgentContext): Promise<void> {
+  // Transfer USDC from spot to perp account
+  const transfer = await agent.platforms.hyperliquid.transfer({
+    amount: 1000.0,
+    toPerp: true
+  });
+
+  if (transfer.success) {
+    await agent.log("Transfer completed");
+  }
+}
+```
+
 ## 📊 Transaction History
 
 Get a list of asset changes for all confirmed transactions during your session. This is useful for tracking what assets have moved in and out of the agent's wallet.

package/index.d.ts

@@ -701,6 +701,236 @@ type PolymarketRedeemPositionsRequest = z.infer<typeof PolymarketRedeemPositions
 type PolymarketMarketOrderResponse = z.infer<typeof PolymarketMarketOrderResponseSchema>;
 type PolymarketRedeemPositionsResponse = z.infer<typeof PolymarketRedeemPositionsResponseSchema>;
 
+/**
+ * Request to place an order on Hyperliquid
+ */
+declare const HyperliquidPlaceOrderRequestSchema: z.ZodObject<{
+    symbol: z.ZodString;
+    side: z.ZodEnum<{
+        buy: "buy";
+        sell: "sell";
+    }>;
+    size: z.ZodNumber;
+    price: z.ZodNumber;
+    market: z.ZodEnum<{
+        perp: "perp";
+        spot: "spot";
+    }>;
+    type: z.ZodOptional<z.ZodEnum<{
+        market: "market";
+        limit: "limit";
+        stop: "stop";
+        take_profit: "take_profit";
+    }>>;
+    triggerPrice: z.ZodOptional<z.ZodNumber>;
+    reduceOnly: z.ZodOptional<z.ZodBoolean>;
+    postOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Request to transfer between spot and perp accounts on Hyperliquid
+ */
+declare const HyperliquidTransferRequestSchema: z.ZodObject<{
+    amount: z.ZodNumber;
+    toPerp: z.ZodBoolean;
+}, z.core.$strip>;
+declare const HyperliquidPlaceOrderResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        orderId: z.ZodString;
+        symbol: z.ZodString;
+        side: z.ZodEnum<{
+            buy: "buy";
+            sell: "sell";
+        }>;
+        price: z.ZodNumber;
+        size: z.ZodNumber;
+        filled: z.ZodNumber;
+        status: z.ZodString;
+        market: z.ZodEnum<{
+            perp: "perp";
+            spot: "spot";
+        }>;
+        clientOrderId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidOrderResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        orderId: z.ZodString;
+        symbol: z.ZodString;
+        side: z.ZodEnum<{
+            buy: "buy";
+            sell: "sell";
+        }>;
+        price: z.ZodNumber;
+        size: z.ZodNumber;
+        filled: z.ZodNumber;
+        status: z.ZodString;
+        market: z.ZodEnum<{
+            perp: "perp";
+            spot: "spot";
+        }>;
+        clientOrderId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidDeleteOrderResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodUndefined>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidBalancesResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        perp: z.ZodObject<{
+            accountValue: z.ZodString;
+            totalMarginUsed: z.ZodString;
+            withdrawable: z.ZodString;
+        }, z.core.$strip>;
+        spot: z.ZodArray<z.ZodObject<{
+            coin: z.ZodString;
+            total: z.ZodString;
+            hold: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidPositionsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        symbol: z.ZodString;
+        side: z.ZodEnum<{
+            long: "long";
+            short: "short";
+        }>;
+        size: z.ZodString;
+        entryPrice: z.ZodString;
+        markPrice: z.ZodString;
+        liquidationPrice: z.ZodNullable<z.ZodString>;
+        unrealizedPnl: z.ZodString;
+        leverage: z.ZodString;
+        marginUsed: z.ZodString;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidOpenOrdersResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        orderId: z.ZodString;
+        symbol: z.ZodString;
+        side: z.ZodEnum<{
+            buy: "buy";
+            sell: "sell";
+        }>;
+        price: z.ZodNumber;
+        size: z.ZodNumber;
+        filled: z.ZodNumber;
+        status: z.ZodString;
+        market: z.ZodEnum<{
+            perp: "perp";
+            spot: "spot";
+        }>;
+        clientOrderId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidOrderFillsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        orderId: z.ZodString;
+        symbol: z.ZodString;
+        side: z.ZodEnum<{
+            buy: "buy";
+            sell: "sell";
+        }>;
+        price: z.ZodString;
+        size: z.ZodString;
+        fee: z.ZodString;
+        timestamp: z.ZodNumber;
+        isMaker: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidHistoricalOrdersResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        orderId: z.ZodString;
+        symbol: z.ZodString;
+        side: z.ZodEnum<{
+            buy: "buy";
+            sell: "sell";
+        }>;
+        price: z.ZodNumber;
+        size: z.ZodNumber;
+        filled: z.ZodNumber;
+        status: z.ZodEnum<{
+            filled: "filled";
+            open: "open";
+            canceled: "canceled";
+            triggered: "triggered";
+            rejected: "rejected";
+            marginCanceled: "marginCanceled";
+            liquidatedCanceled: "liquidatedCanceled";
+        }>;
+        market: z.ZodEnum<{
+            perp: "perp";
+            spot: "spot";
+        }>;
+        timestamp: z.ZodNumber;
+        statusTimestamp: z.ZodNumber;
+        orderType: z.ZodEnum<{
+            Market: "Market";
+            Limit: "Limit";
+            "Stop Market": "Stop Market";
+            "Stop Limit": "Stop Limit";
+            "Take Profit Market": "Take Profit Market";
+            "Take Profit Limit": "Take Profit Limit";
+        }>;
+        clientOrderId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidTransferResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodUndefined>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HyperliquidLiquidationsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodNumber;
+        liquidatedPositions: z.ZodArray<z.ZodObject<{
+            symbol: z.ZodString;
+            side: z.ZodEnum<{
+                long: "long";
+                short: "short";
+            }>;
+            size: z.ZodString;
+        }, z.core.$strip>>;
+        totalNotional: z.ZodString;
+        accountValue: z.ZodString;
+        leverageType: z.ZodEnum<{
+            Cross: "Cross";
+            Isolated: "Isolated";
+        }>;
+        txHash: z.ZodString;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type HyperliquidPlaceOrderRequest = z.infer<typeof HyperliquidPlaceOrderRequestSchema>;
+type HyperliquidTransferRequest = z.infer<typeof HyperliquidTransferRequestSchema>;
+type HyperliquidPlaceOrderResponse = z.infer<typeof HyperliquidPlaceOrderResponseSchema>;
+type HyperliquidOrderResponse = z.infer<typeof HyperliquidOrderResponseSchema>;
+type HyperliquidDeleteOrderResponse = z.infer<typeof HyperliquidDeleteOrderResponseSchema>;
+type HyperliquidBalancesResponse = z.infer<typeof HyperliquidBalancesResponseSchema>;
+type HyperliquidPositionsResponse = z.infer<typeof HyperliquidPositionsResponseSchema>;
+type HyperliquidOpenOrdersResponse = z.infer<typeof HyperliquidOpenOrdersResponseSchema>;
+type HyperliquidOrderFillsResponse = z.infer<typeof HyperliquidOrderFillsResponseSchema>;
+type HyperliquidHistoricalOrdersResponse = z.infer<typeof HyperliquidHistoricalOrdersResponseSchema>;
+type HyperliquidTransferResponse = z.infer<typeof HyperliquidTransferResponseSchema>;
+type HyperliquidLiquidationsResponse = z.infer<typeof HyperliquidLiquidationsResponseSchema>;
+
 /**
  * Memory type definitions for agent session storage
  *
@@ -1044,7 +1274,7 @@ declare class AgentSdk {
          * @returns SwidgeExecuteResponse or array of responses (matching input type) with transaction status and details
          *   - `success` (boolean): Whether the execution was successful
          *   - `data` (SwidgeExecuteData | undefined): Execution result containing:
-         *     - `status`: "success" | "failure" | "refund" | "delayed" - Final transaction status
+         *     - `status`: "success" | "failure" | "refund" | "delayed" | "error" - Final transaction status
          *     - `in`: Source transaction details with txs array (transaction hashes)
          *     - `out`: Destination transaction details with txs array (transaction hashes)
          *     - Additional metadata about the swap/bridge operation
@@ -1432,6 +1662,400 @@ declare class AgentSdk {
              */
             redeemPositions: (request?: PolymarketRedeemPositionsRequest) => Promise<PolymarketRedeemPositionsResponse>;
         };
+        /**
+         * 🔄 Hyperliquid: Trade perpetuals on Hyperliquid DEX
+         *
+         * Access perpetuals trading operations including orders, positions, and transfers.
+         * All operations are policy-checked and signed automatically.
+         */
+        hyperliquid: {
+            /**
+             * Place an order on Hyperliquid
+             *
+             * Submit a market, limit, stop, or take-profit order for perpetuals or spot trading.
+             *
+             * **Input**: `HyperliquidPlaceOrderRequest`
+             *   - `symbol` (string): Trading pair symbol (e.g., "BTC-USD")
+             *   - `side` ("buy" | "sell"): Order side
+             *   - `size` (number): Order size
+             *   - `price` (number): Order price (for market orders, acts as slippage limit)
+             *   - `market` ("perp" | "spot"): Market type
+             *   - `type` (string, optional): Order type ("limit", "market", "stop", "take_profit")
+             *   - `triggerPrice` (number, optional): Trigger price for stop/take-profit orders
+             *   - `reduceOnly` (boolean, optional): Whether this is a reduce-only order
+             *   - `postOnly` (boolean, optional): Whether this is a post-only order
+             *
+             * **Output**: `HyperliquidPlaceOrderResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidOrderInfo | undefined): Order information (only present on success)
+             *     - `data.orderId` (string): Order ID
+             *     - `data.symbol` (string): Trading pair symbol
+             *     - `data.side` ("buy" | "sell"): Order side
+             *     - `data.price` (number): Order price
+             *     - `data.size` (number): Order size
+             *     - `data.filled` (number): Filled amount
+             *     - `data.status` (string): Order status
+             *     - `data.market` ("perp" | "spot"): Market type
+             *     - `data.clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @param request - Order parameters
+             * @returns Promise resolving to HyperliquidPlaceOrderResponse
+             *
+             * @example
+             * ```ts
+             * // Market order
+             * const result = await sdk.platforms.hyperliquid.placeOrder({
+             *   symbol: "BTC-USD",
+             *   side: "buy",
+             *   size: 0.0001,
+             *   price: 110000,
+             *   market: "perp",
+             *   type: "market",
+             * });
+             *
+             * // Limit order
+             * const result = await sdk.platforms.hyperliquid.placeOrder({
+             *   symbol: "BTC-USD",
+             *   side: "buy",
+             *   size: 0.0001,
+             *   price: 100000,
+             *   market: "perp",
+             *   type: "limit",
+             * });
+             *
+             * if (result.success && result.data) {
+             *   console.log(`Order placed: ${result.data.orderId}`);
+             *   console.log(`Status: ${result.data.status}`);
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            placeOrder: (request: HyperliquidPlaceOrderRequest) => Promise<HyperliquidPlaceOrderResponse>;
+            /**
+             * Get order information by order ID
+             *
+             * Retrieve details for a specific order including status, filled amount, and price.
+             *
+             * **Input**: `orderId` (string) - Unique order identifier
+             *
+             * **Output**: `HyperliquidOrderResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidOrderInfo | undefined): Order details (only present on success)
+             *     - `data.orderId` (string): Order ID
+             *     - `data.symbol` (string): Trading pair symbol
+             *     - `data.side` ("buy" | "sell"): Order side
+             *     - `data.price` (number): Order price
+             *     - `data.size` (number): Order size
+             *     - `data.filled` (number): Filled amount
+             *     - `data.status` (string): Order status
+             *     - `data.market` ("perp" | "spot"): Market type
+             *     - `data.clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @param orderId - Order ID to query
+             * @returns Promise resolving to HyperliquidOrderResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.order("12345");
+             * if (result.success && result.data) {
+             *   console.log(`Order ${result.data.orderId}: ${result.data.status}`);
+             *   console.log(`Filled: ${result.data.filled}/${result.data.size}`);
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            order: (orderId: string) => Promise<HyperliquidOrderResponse>;
+            /**
+             * Cancel an order
+             *
+             * Cancel an open order by order ID and symbol.
+             *
+             * **Input**:
+             *   - `orderId` (string): Order ID to cancel
+             *   - `symbol` (string): Trading symbol
+             *
+             * **Output**: `HyperliquidDeleteOrderResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * Note: This operation returns no data on success (void response).
+             *
+             * @param orderId - Order ID to cancel
+             * @param symbol - Trading symbol
+             * @returns Promise resolving to HyperliquidDeleteOrderResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.deleteOrder("12345", "BTC-USD");
+             * if (result.success) {
+             *   console.log("Order cancelled successfully");
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            deleteOrder: (orderId: string, symbol: string) => Promise<HyperliquidDeleteOrderResponse>;
+            /**
+             * Get account balances
+             *
+             * Retrieve perp and spot account balances.
+             *
+             * **Output**: `HyperliquidBalancesResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidBalances | undefined): Balance data (only present on success)
+             *     - `data.perp` (HyperliquidPerpBalance): Perp account balance
+             *       - `data.perp.accountValue` (string): Total account value
+             *       - `data.perp.totalMarginUsed` (string): Total margin used
+             *       - `data.perp.withdrawable` (string): Withdrawable amount
+             *     - `data.spot` (HyperliquidSpotBalance[]): Spot token balances
+             *       - `data.spot[].coin` (string): Token symbol
+             *       - `data.spot[].total` (string): Total balance
+             *       - `data.spot[].hold` (string): Amount on hold
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidBalancesResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.balances();
+             * if (result.success && result.data) {
+             *   console.log(`Account value: ${result.data.perp.accountValue}`);
+             *   console.log(`Withdrawable: ${result.data.perp.withdrawable}`);
+             *   for (const balance of result.data.spot) {
+             *     console.log(`${balance.coin}: ${balance.total}`);
+             *   }
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            balances: () => Promise<HyperliquidBalancesResponse>;
+            /**
+             * Get open positions
+             *
+             * Retrieve all open perpetual positions with PnL and position details.
+             *
+             * **Output**: `HyperliquidPositionsResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidPosition[] | undefined): Array of open positions (only present on success)
+             *     - `data[].symbol` (string): Trading pair symbol (e.g., "BTC-USD")
+             *     - `data[].side` ("long" | "short"): Position side
+             *     - `data[].size` (string): Position size
+             *     - `data[].entryPrice` (string): Average entry price
+             *     - `data[].markPrice` (string): Current mark price
+             *     - `data[].liquidationPrice` (string | null): Liquidation price (null if no risk)
+             *     - `data[].unrealizedPnl` (string): Unrealized profit/loss
+             *     - `data[].leverage` (string): Current leverage
+             *     - `data[].marginUsed` (string): Margin allocated to position
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidPositionsResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.positions();
+             * if (result.success && result.data) {
+             *   for (const pos of result.data) {
+             *     console.log(`${pos.symbol}: ${pos.side} ${pos.size}`);
+             *     console.log(`Entry: ${pos.entryPrice}, Mark: ${pos.markPrice}`);
+             *     console.log(`Unrealized PnL: ${pos.unrealizedPnl}`);
+             *   }
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            positions: () => Promise<HyperliquidPositionsResponse>;
+            /**
+             * Get open orders
+             *
+             * Retrieve all currently open orders.
+             *
+             * **Output**: `HyperliquidOpenOrdersResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidOrderInfo[] | undefined): Array of open orders (only present on success)
+             *     - `data[].orderId` (string): Order ID
+             *     - `data[].symbol` (string): Trading pair symbol
+             *     - `data[].side` ("buy" | "sell"): Order side
+             *     - `data[].price` (number): Order price
+             *     - `data[].size` (number): Order size
+             *     - `data[].filled` (number): Filled amount
+             *     - `data[].status` (string): Order status
+             *     - `data[].market` ("perp" | "spot"): Market type
+             *     - `data[].clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidOpenOrdersResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.openOrders();
+             * if (result.success && result.data) {
+             *   console.log(`You have ${result.data.length} open orders`);
+             *   for (const order of result.data) {
+             *     console.log(`${order.symbol}: ${order.side} ${order.size} @ ${order.price}`);
+             *   }
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            openOrders: () => Promise<HyperliquidOpenOrdersResponse>;
+            /**
+             * Get order fill history
+             *
+             * Retrieve order fill history including partial and complete fills.
+             *
+             * **Output**: `HyperliquidOrderFillsResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidFill[] | undefined): Array of order fills (only present on success)
+             *     - `data[].orderId` (string): Order ID
+             *     - `data[].symbol` (string): Trading pair symbol
+             *     - `data[].side` ("buy" | "sell"): Fill side
+             *     - `data[].price` (string): Fill price
+             *     - `data[].size` (string): Fill size
+             *     - `data[].fee` (string): Trading fee paid
+             *     - `data[].timestamp` (number): Fill timestamp in milliseconds
+             *     - `data[].isMaker` (boolean): True if maker, false if taker
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidOrderFillsResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.orderFills();
+             * if (result.success && result.data) {
+             *   console.log(`Total fills: ${result.data.length}`);
+             *   for (const fill of result.data) {
+             *     const fillType = fill.isMaker ? "maker" : "taker";
+             *     console.log(`${fill.symbol}: ${fill.size} @ ${fill.price} (${fillType}, fee: ${fill.fee})`);
+             *   }
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            orderFills: () => Promise<HyperliquidOrderFillsResponse>;
+            /**
+             * Get historical orders
+             *
+             * Retrieve order history including filled, cancelled, and expired orders.
+             *
+             * **Output**: `HyperliquidHistoricalOrdersResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidHistoricalOrder[] | undefined): Array of historical orders (only present on success)
+             *     - `data[].orderId` (string): Order ID
+             *     - `data[].symbol` (string): Trading pair symbol
+             *     - `data[].side` ("buy" | "sell"): Order side
+             *     - `data[].price` (number): Order price
+             *     - `data[].size` (number): Order size
+             *     - `data[].filled` (number): Filled amount
+             *     - `data[].status` ("open" | "filled" | "canceled" | "triggered" | "rejected" | "marginCanceled" | "liquidatedCanceled"): Order status
+             *     - `data[].market` ("perp" | "spot"): Market type
+             *     - `data[].timestamp` (number): Order creation timestamp in milliseconds
+             *     - `data[].statusTimestamp` (number): Status update timestamp in milliseconds
+             *     - `data[].orderType` ("Market" | "Limit" | "Stop Market" | "Stop Limit" | "Take Profit Market" | "Take Profit Limit"): Order type
+             *     - `data[].clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidHistoricalOrdersResponse
+             *
+             * @example
+             * ```ts
+             * const result = await sdk.platforms.hyperliquid.orders();
+             * if (result.success && result.data) {
+             *   console.log(`Order history: ${result.data.length} orders`);
+             *   const filled = result.data.filter(o => o.status === "filled");
+             *   console.log(`Filled orders: ${filled.length}`);
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            orders: () => Promise<HyperliquidHistoricalOrdersResponse>;
+            /**
+             * Transfer between spot and perp accounts
+             *
+             * Move funds between your spot wallet and perpetuals trading account.
+             *
+             * **Input**: `HyperliquidTransferRequest`
+             *   - `amount` (number): Amount to transfer
+             *   - `toPerp` (boolean): True to transfer to perp account, False to transfer to spot
+             *
+             * **Output**: `HyperliquidTransferResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * Note: This operation returns no data on success (void response).
+             *
+             * @param request - Transfer parameters
+             * @returns Promise resolving to HyperliquidTransferResponse
+             *
+             * @example
+             * ```ts
+             * // Transfer 1000 USDC to perp account
+             * const result = await sdk.platforms.hyperliquid.transfer({
+             *   amount: 1000,
+             *   toPerp: true
+             * });
+             *
+             * if (result.success) {
+             *   console.log("Transfer completed successfully");
+             * } else {
+             *   console.error(`Error: ${result.error}`);
+             * }
+             * ```
+             */
+            transfer: (request: HyperliquidTransferRequest) => Promise<HyperliquidTransferResponse>;
+            /**
+             * Get liquidation events
+             *
+             * Retrieve liquidation events for the account, optionally filtered by start time.
+             *
+             * **Input**: `startTime` (number, optional) - Unix timestamp in milliseconds to filter liquidations from
+             *
+             * **Output**: `HyperliquidLiquidationsResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidLiquidation[] | undefined): Array of liquidation events (only present on success)
+             *     - `data[].timestamp` (number): Liquidation timestamp in milliseconds
+             *     - `data[].liquidatedPositions` (HyperliquidLiquidatedPosition[]): Liquidated positions
+             *       - `data[].liquidatedPositions[].symbol` (string): Position symbol (e.g., "BTC-USD")
+             *       - `data[].liquidatedPositions[].side` ("long" | "short"): Position side
+             *       - `data[].liquidatedPositions[].size` (string): Position size that was liquidated
+             *     - `data[].totalNotional` (string): Total notional value liquidated
+             *     - `data[].accountValue` (string): Account value at liquidation
+             *     - `data[].leverageType` ("Cross" | "Isolated"): Leverage type
+             *     - `data[].txHash` (string): Transaction hash
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @param startTime - Optional start time for filtering (Unix timestamp in milliseconds)
+             * @returns Promise resolving to HyperliquidLiquidationsResponse
+             *
+             * @example
+             * ```ts
+             * // Get all liquidations (defaults to last 30 days)
+             * const all = await sdk.platforms.hyperliquid.liquidations();
+             *
+             * // Get liquidations from last 24h
+             * const yesterday = Date.now() - (24 * 60 * 60 * 1000);
+             * const recent = await sdk.platforms.hyperliquid.liquidations(yesterday);
+             *
+             * if (recent.success && recent.data) {
+             *   console.log(`Liquidations in last 24h: ${recent.data.length}`);
+             *   for (const liq of recent.data) {
+             *     console.log(`Liquidated ${liq.liquidatedPositions.length} positions`);
+             *   }
+             * } else {
+             *   console.error(`Error: ${recent.error}`);
+             * }
+             * ```
+             */
+            liquidations: (startTime?: number) => Promise<HyperliquidLiquidationsResponse>;
+        };
     };
     /**
      * Handle EVM transaction signing and broadcasting
@@ -1463,6 +2087,46 @@ declare class AgentSdk {
     private handleSwidgeExecute;
     private handlePolymarketMarketOrder;
     private handlePolymarketRedeemPositions;
+    /**
+     * Handle Hyperliquid place order requests
+     */
+    private handleHyperliquidPlaceOrder;
+    /**
+     * Handle Hyperliquid get order requests
+     */
+    private handleHyperliquidGetOrder;
+    /**
+     * Handle Hyperliquid delete order requests
+     */
+    private handleHyperliquidDeleteOrder;
+    /**
+     * Handle Hyperliquid get balances requests
+     */
+    private handleHyperliquidGetBalances;
+    /**
+     * Handle Hyperliquid get positions requests
+     */
+    private handleHyperliquidGetPositions;
+    /**
+     * Handle Hyperliquid get open orders requests
+     */
+    private handleHyperliquidGetOpenOrders;
+    /**
+     * Handle Hyperliquid get order fills requests
+     */
+    private handleHyperliquidGetOrderFills;
+    /**
+     * Handle Hyperliquid get historical orders requests
+     */
+    private handleHyperliquidGetHistoricalOrders;
+    /**
+     * Handle Hyperliquid transfer requests
+     */
+    private handleHyperliquidTransfer;
+    /**
+     * Handle Hyperliquid get liquidations requests
+     */
+    private handleHyperliquidGetLiquidations;
     /**
      * Handle memory set requests
      */
@@ -1703,7 +2367,7 @@ interface CurrentPosition {
  * - **Request metadata**: `sessionId`, `sessionWalletAddress`, `currentPositions`
  * - **Core methods**: `log()`, `signAndSend()`, `signMessage()`
  * - **Memory operations**: `memory.set()`, `memory.get()`, `memory.delete()`, `memory.list()`
- * - **Platform integrations**: `platforms.polymarket.*` for prediction market trading
+ * - **Platform integrations**: `platforms.polymarket.*` for prediction market trading, `platforms.hyperliquid.*` for perpetuals trading
  * - **Cross-chain swaps**: `swidge.quote()`, `swidge.execute()`
  *
  * The agent developer's execution and stop functions receive this object:
@@ -1768,10 +2432,14 @@ interface CurrentPosition {
  * @property memory.delete - Delete a key from session memory
  * @property memory.list - List all keys in session memory
  *
- * @property platforms - Platform integrations (Polymarket, etc.)
+ * @property platforms - Platform integrations (Polymarket, Hyperliquid, etc.)
  * @property platforms.polymarket - Prediction market trading operations
  * @property platforms.polymarket.marketOrder - Execute a buy or sell market order on Polymarket
  * @property platforms.polymarket.redeemPositions - Redeem settled positions and claim winnings
+ * @property platforms.hyperliquid - Perpetuals trading operations on Hyperliquid DEX
+ * @property platforms.hyperliquid.placeOrder - Place an order on Hyperliquid
+ * @property platforms.hyperliquid.balances - Get account balances
+ * @property platforms.hyperliquid.positions - Get open positions
  *
  * @property swidge - Cross-chain swap and bridge operations
  * @property swidge.quote - Get a quote for swapping tokens between networks
@@ -2113,7 +2781,7 @@ declare class AgentContext {
      * Access platform integrations for trading and DeFi operations.
      *
      * Platform integrations provide seamless access to external services like
-     * prediction markets, lending protocols, and more.
+     * prediction markets, perpetuals trading, and more.
      */
     readonly platforms: {
         /**
@@ -2205,6 +2873,399 @@ declare class AgentContext {
              */
             redeemPositions: (request?: PolymarketRedeemPositionsRequest) => Promise<PolymarketRedeemPositionsResponse>;
         };
+        /**
+         * Access Hyperliquid perpetuals trading operations.
+         *
+         * Trade perpetual contracts on Hyperliquid DEX using your session wallet.
+         */
+        hyperliquid: {
+            /**
+             * Place an order on Hyperliquid
+             *
+             * Submit a market, limit, stop, or take-profit order for perpetuals or spot trading.
+             *
+             * **Input**: `HyperliquidPlaceOrderRequest`
+             *   - `symbol` (string): Trading pair symbol (e.g., "BTC-USD")
+             *   - `side` ("buy" | "sell"): Order side
+             *   - `size` (number): Order size
+             *   - `price` (number): Order price (for market orders, acts as slippage limit)
+             *   - `market` ("perp" | "spot"): Market type
+             *   - `type` (string, optional): Order type ("limit", "market", "stop", "take_profit")
+             *   - `triggerPrice` (number, optional): Trigger price for stop/take-profit orders
+             *   - `reduceOnly` (boolean, optional): Whether this is a reduce-only order
+             *   - `postOnly` (boolean, optional): Whether this is a post-only order
+             *
+             * **Output**: `HyperliquidPlaceOrderResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidOrderInfo | undefined): Order information (only present on success)
+             *     - `data.orderId` (string): Order ID
+             *     - `data.symbol` (string): Trading pair symbol
+             *     - `data.side` ("buy" | "sell"): Order side
+             *     - `data.price` (number): Order price
+             *     - `data.size` (number): Order size
+             *     - `data.filled` (number): Filled amount
+             *     - `data.status` (string): Order status
+             *     - `data.market` ("perp" | "spot"): Market type
+             *     - `data.clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @param request - Order parameters
+             * @returns Promise resolving to HyperliquidPlaceOrderResponse
+             *
+             * @example
+             * ```ts
+             * // Market order
+             * const result = await agent.platforms.hyperliquid.placeOrder({
+             *   symbol: "BTC-USD",
+             *   side: "buy",
+             *   size: 0.0001,
+             *   price: 110000,
+             *   market: "perp",
+             *   type: "market",
+             * });
+             *
+             * // Limit order
+             * const result = await agent.platforms.hyperliquid.placeOrder({
+             *   symbol: "BTC-USD",
+             *   side: "buy",
+             *   size: 0.0001,
+             *   price: 100000,
+             *   market: "perp",
+             *   type: "limit",
+             * });
+             *
+             * if (result.success && result.data) {
+             *   await agent.log(`Order placed: ${result.data.orderId}`);
+             *   await agent.log(`Status: ${result.data.status}`);
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            placeOrder: (request: HyperliquidPlaceOrderRequest) => Promise<HyperliquidPlaceOrderResponse>;
+            /**
+             * Get order information by order ID
+             *
+             * Retrieve details for a specific order including status, filled amount, and price.
+             *
+             * **Input**: `orderId` (string) - Unique order identifier
+             *
+             * **Output**: `HyperliquidOrderResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidOrderInfo | undefined): Order details (only present on success)
+             *     - `data.orderId` (string): Order ID
+             *     - `data.symbol` (string): Trading pair symbol
+             *     - `data.side` ("buy" | "sell"): Order side
+             *     - `data.price` (number): Order price
+             *     - `data.size` (number): Order size
+             *     - `data.filled` (number): Filled amount
+             *     - `data.status` (string): Order status
+             *     - `data.market` ("perp" | "spot"): Market type
+             *     - `data.clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @param orderId - Order ID to query
+             * @returns Promise resolving to HyperliquidOrderResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.order("12345");
+             * if (result.success && result.data) {
+             *   await agent.log(`Order ${result.data.orderId}: ${result.data.status}`);
+             *   await agent.log(`Filled: ${result.data.filled}/${result.data.size}`);
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            order: (orderId: string) => Promise<HyperliquidOrderResponse>;
+            /**
+             * Cancel an order
+             *
+             * Cancel an open order by order ID and symbol.
+             *
+             * **Input**:
+             *   - `orderId` (string): Order ID to cancel
+             *   - `symbol` (string): Trading symbol
+             *
+             * **Output**: `HyperliquidDeleteOrderResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * Note: This operation returns no data on success (void response).
+             *
+             * @param orderId - Order ID to cancel
+             * @param symbol - Trading symbol
+             * @returns Promise resolving to HyperliquidDeleteOrderResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.deleteOrder("12345", "BTC-USD");
+             * if (result.success) {
+             *   await agent.log("Order cancelled successfully");
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            deleteOrder: (orderId: string, symbol: string) => Promise<HyperliquidDeleteOrderResponse>;
+            /**
+             * Get account balances
+             *
+             * Retrieve perp and spot account balances.
+             *
+             * **Output**: `HyperliquidBalancesResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidBalances | undefined): Balance data (only present on success)
+             *     - `data.perp` (HyperliquidPerpBalance): Perp account balance
+             *       - `data.perp.accountValue` (string): Total account value
+             *       - `data.perp.totalMarginUsed` (string): Total margin used
+             *       - `data.perp.withdrawable` (string): Withdrawable amount
+             *     - `data.spot` (HyperliquidSpotBalance[]): Spot token balances
+             *       - `data.spot[].coin` (string): Token symbol
+             *       - `data.spot[].total` (string): Total balance
+             *       - `data.spot[].hold` (string): Amount on hold
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidBalancesResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.balances();
+             * if (result.success && result.data) {
+             *   await agent.log(`Account value: ${result.data.perp.accountValue}`);
+             *   await agent.log(`Withdrawable: ${result.data.perp.withdrawable}`);
+             *   for (const balance of result.data.spot) {
+             *     await agent.log(`${balance.coin}: ${balance.total}`);
+             *   }
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            balances: () => Promise<HyperliquidBalancesResponse>;
+            /**
+             * Get open positions
+             *
+             * Retrieve all open perpetual positions with PnL and position details.
+             *
+             * **Output**: `HyperliquidPositionsResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidPosition[] | undefined): Array of open positions (only present on success)
+             *     - `data[].symbol` (string): Trading pair symbol (e.g., "BTC-USD")
+             *     - `data[].side` ("long" | "short"): Position side
+             *     - `data[].size` (string): Position size
+             *     - `data[].entryPrice` (string): Average entry price
+             *     - `data[].markPrice` (string): Current mark price
+             *     - `data[].liquidationPrice` (string | null): Liquidation price (null if no risk)
+             *     - `data[].unrealizedPnl` (string): Unrealized profit/loss
+             *     - `data[].leverage` (string): Current leverage
+             *     - `data[].marginUsed` (string): Margin allocated to position
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidPositionsResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.positions();
+             * if (result.success && result.data) {
+             *   for (const pos of result.data) {
+             *     await agent.log(`${pos.symbol}: ${pos.side} ${pos.size}`);
+             *     await agent.log(`Entry: ${pos.entryPrice}, Mark: ${pos.markPrice}`);
+             *     await agent.log(`Unrealized PnL: ${pos.unrealizedPnl}`);
+             *   }
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            positions: () => Promise<HyperliquidPositionsResponse>;
+            /**
+             * Get open orders
+             *
+             * Retrieve all currently open orders.
+             *
+             * **Output**: `HyperliquidOpenOrdersResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidOrderInfo[] | undefined): Array of open orders (only present on success)
+             *     - `data[].orderId` (string): Order ID
+             *     - `data[].symbol` (string): Trading pair symbol
+             *     - `data[].side` ("buy" | "sell"): Order side
+             *     - `data[].price` (number): Order price
+             *     - `data[].size` (number): Order size
+             *     - `data[].filled` (number): Filled amount
+             *     - `data[].status` (string): Order status
+             *     - `data[].market` ("perp" | "spot"): Market type
+             *     - `data[].clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidOpenOrdersResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.openOrders();
+             * if (result.success && result.data) {
+             *   await agent.log(`You have ${result.data.length} open orders`);
+             *   for (const order of result.data) {
+             *     await agent.log(`${order.symbol}: ${order.side} ${order.size} @ ${order.price}`);
+             *   }
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            openOrders: () => Promise<HyperliquidOpenOrdersResponse>;
+            /**
+             * Get order fill history
+             *
+             * Retrieve order fill history including partial and complete fills.
+             *
+             * **Output**: `HyperliquidOrderFillsResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidFill[] | undefined): Array of order fills (only present on success)
+             *     - `data[].orderId` (string): Order ID
+             *     - `data[].symbol` (string): Trading pair symbol
+             *     - `data[].side` ("buy" | "sell"): Fill side
+             *     - `data[].price` (string): Fill price
+             *     - `data[].size` (string): Fill size
+             *     - `data[].fee` (string): Trading fee paid
+             *     - `data[].timestamp` (number): Fill timestamp in milliseconds
+             *     - `data[].isMaker` (boolean): True if maker, false if taker
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidOrderFillsResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.orderFills();
+             * if (result.success && result.data) {
+             *   await agent.log(`Total fills: ${result.data.length}`);
+             *   for (const fill of result.data) {
+             *     const fillType = fill.isMaker ? "maker" : "taker";
+             *     await agent.log(`${fill.symbol}: ${fill.size} @ ${fill.price} (${fillType}, fee: ${fill.fee})`);
+             *   }
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            orderFills: () => Promise<HyperliquidOrderFillsResponse>;
+            /**
+             * Get historical orders
+             *
+             * Retrieve order history including filled, cancelled, and expired orders.
+             *
+             * **Output**: `HyperliquidHistoricalOrdersResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidHistoricalOrder[] | undefined): Array of historical orders (only present on success)
+             *     - `data[].orderId` (string): Order ID
+             *     - `data[].symbol` (string): Trading pair symbol
+             *     - `data[].side` ("buy" | "sell"): Order side
+             *     - `data[].price` (number): Order price
+             *     - `data[].size` (number): Order size
+             *     - `data[].filled` (number): Filled amount
+             *     - `data[].status` ("open" | "filled" | "canceled" | "triggered" | "rejected" | "marginCanceled" | "liquidatedCanceled"): Order status
+             *     - `data[].market` ("perp" | "spot"): Market type
+             *     - `data[].timestamp` (number): Order creation timestamp in milliseconds
+             *     - `data[].statusTimestamp` (number): Status update timestamp in milliseconds
+             *     - `data[].orderType` ("Market" | "Limit" | "Stop Market" | "Stop Limit" | "Take Profit Market" | "Take Profit Limit"): Order type
+             *     - `data[].clientOrderId` (string | undefined): Client order ID
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @returns Promise resolving to HyperliquidHistoricalOrdersResponse
+             *
+             * @example
+             * ```ts
+             * const result = await agent.platforms.hyperliquid.orders();
+             * if (result.success && result.data) {
+             *   await agent.log(`Order history: ${result.data.length} orders`);
+             *   const filled = result.data.filter(o => o.status === "filled");
+             *   await agent.log(`Filled orders: ${filled.length}`);
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            orders: () => Promise<HyperliquidHistoricalOrdersResponse>;
+            /**
+             * Transfer between spot and perp accounts
+             *
+             * Move funds between your spot wallet and perpetuals trading account.
+             *
+             * **Input**: `HyperliquidTransferRequest`
+             *   - `amount` (number): Amount to transfer
+             *   - `toPerp` (boolean): True to transfer to perp account, False to transfer to spot
+             *
+             * **Output**: `HyperliquidTransferResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * Note: This operation returns no data on success (void response).
+             *
+             * @param request - Transfer parameters
+             * @returns Promise resolving to HyperliquidTransferResponse
+             *
+             * @example
+             * ```ts
+             * // Transfer 1000 USDC to perp account
+             * const result = await agent.platforms.hyperliquid.transfer({
+             *   amount: 1000,
+             *   toPerp: true
+             * });
+             *
+             * if (result.success) {
+             *   await agent.log("Transfer completed successfully");
+             * } else {
+             *   await agent.log(`Error: ${result.error}`, { error: true });
+             * }
+             * ```
+             */
+            transfer: (request: HyperliquidTransferRequest) => Promise<HyperliquidTransferResponse>;
+            /**
+             * Get liquidation events
+             *
+             * Retrieve liquidation events for the account, optionally filtered by start time.
+             *
+             * **Input**: `startTime` (number, optional) - Unix timestamp in milliseconds to filter liquidations from
+             *
+             * **Output**: `HyperliquidLiquidationsResponse`
+             *   - `success` (boolean): Whether the operation was successful
+             *   - `data` (HyperliquidLiquidation[] | undefined): Array of liquidation events (only present on success)
+             *     - `data[].timestamp` (number): Liquidation timestamp in milliseconds
+             *     - `data[].liquidatedPositions` (HyperliquidLiquidatedPosition[]): Liquidated positions
+             *       - `data[].liquidatedPositions[].symbol` (string): Position symbol (e.g., "BTC-USD")
+             *       - `data[].liquidatedPositions[].side` ("long" | "short"): Position side
+             *       - `data[].liquidatedPositions[].size` (string): Position size that was liquidated
+             *     - `data[].totalNotional` (string): Total notional value liquidated
+             *     - `data[].accountValue` (string): Account value at liquidation
+             *     - `data[].leverageType` ("Cross" | "Isolated"): Leverage type
+             *     - `data[].txHash` (string): Transaction hash
+             *   - `error` (string | undefined): Error message (only present on failure)
+             *
+             * @param startTime - Optional start time for filtering (Unix timestamp in milliseconds)
+             * @returns Promise resolving to HyperliquidLiquidationsResponse
+             *
+             * @example
+             * ```ts
+             * // Get all liquidations (defaults to last 30 days)
+             * const all = await agent.platforms.hyperliquid.liquidations();
+             *
+             * // Get liquidations from last 24h
+             * const yesterday = Date.now() - (24 * 60 * 60 * 1000);
+             * const recent = await agent.platforms.hyperliquid.liquidations(yesterday);
+             *
+             * if (recent.success && recent.data) {
+             *   await agent.log(`Liquidations in last 24h: ${recent.data.length}`);
+             *   for (const liq of recent.data) {
+             *     await agent.log(`Liquidated ${liq.liquidatedPositions.length} positions`);
+             *   }
+             * } else {
+             *   await agent.log(`Error: ${recent.error}`, { error: true });
+             * }
+             * ```
+             */
+            liquidations: (startTime?: number) => Promise<HyperliquidLiquidationsResponse>;
+        };
     };
     /**
      * Access cross-chain swap and bridge operations.
@@ -2560,4 +3621,4 @@ declare function isSolanaNetwork(network: Network): network is "solana";
  */
 declare function getChainIdFromNetwork(network: `ethereum:${number}`): number;
 
-export { APIClient, Agent, AgentContext, AgentSdk, type AssetChange, type CurrentPosition, type CurrentPositionsData, type CurrentPositionsResponse, type EnrichedPosition, type LogResponse, type MemoryDeleteResponse, type MemoryGetResponse, type MemoryListResponse, type MemorySetResponse, type Network, type PolymarketMarketOrderRequest, type PolymarketMarketOrderResponse, type PolymarketRedeemPositionsRequest, type PolymarketRedeemPositionsResponse, QUOTE_RESULT, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type SignMessageRequest, type SignMessageResponse, type StopFunctionContract, type SwidgeExecuteResponse, type SwidgeQuoteRequest, type SwidgeQuoteResponse, type SwidgeQuoteResult, type TransactionsResponse, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork, type runFunctionContract };
+export { APIClient, Agent, AgentContext, AgentSdk, type AssetChange, type CurrentPosition, type CurrentPositionsData, type CurrentPositionsResponse, type EnrichedPosition, type HyperliquidBalancesResponse, type HyperliquidDeleteOrderResponse, type HyperliquidHistoricalOrdersResponse, type HyperliquidLiquidationsResponse, type HyperliquidOpenOrdersResponse, type HyperliquidOrderFillsResponse, type HyperliquidOrderResponse, type HyperliquidPlaceOrderRequest, type HyperliquidPlaceOrderResponse, type HyperliquidPositionsResponse, type HyperliquidTransferRequest, type HyperliquidTransferResponse, type LogResponse, type MemoryDeleteResponse, type MemoryGetResponse, type MemoryListResponse, type MemorySetResponse, type Network, type PolymarketMarketOrderRequest, type PolymarketMarketOrderResponse, type PolymarketRedeemPositionsRequest, type PolymarketRedeemPositionsResponse, QUOTE_RESULT, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type SignMessageRequest, type SignMessageResponse, type StopFunctionContract, type SwidgeExecuteResponse, type SwidgeQuoteRequest, type SwidgeQuoteResponse, type SwidgeQuoteResult, type TransactionsResponse, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork, type runFunctionContract };

package/index.js

@@ -1 +1 @@
-import{loadAuthFromFileSystem as e}from"./chunk-4I3A6QAK.js";var r=class{config;baseUrl;authorizationHeader;isCloudflareWorker(){return"undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare}hasServiceBinding(){if(this.isCloudflareWorker()){if(void 0!==globalThis.AGENTS_TO_API_PROXY)return!0;if(void 0!==globalThis.__AGENT_ENV__&&globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)return!0}return!1}constructor(e){this.config=e,this.baseUrl=e.baseUrl||"https://agents.circuit.org",this.authorizationHeader=e.authorizationHeader}getAgentSlug(){return"undefined"!=typeof process&&process.env?.CIRCUIT_AGENT_SLUG?process.env.CIRCUIT_AGENT_SLUG:void 0!==globalThis.CIRCUIT_AGENT_SLUG?globalThis.CIRCUIT_AGENT_SLUG:void 0}getAuthHeaders(){const e={};e["X-Session-Id"]=this.config.sessionId.toString();const r=this.getAgentSlug();if(r&&(e["X-Agent-Slug"]=r),this.isCloudflareWorker())return e;if(this.authorizationHeader)return e.Authorization=this.authorizationHeader,e;try{const r=this.loadAuthConfig();r?.sessionToken&&(e.Authorization=`Bearer ${r.sessionToken}`)}catch{}return e}loadAuthConfig(){try{return e()}catch{}}async makeRequest(e,r={}){const t={...{"Content-Type":"application/json",...this.getAuthHeaders()},...r.headers};let s;if(this.hasServiceBinding()){let o;if(void 0!==globalThis.AGENTS_TO_API_PROXY)o=globalThis.AGENTS_TO_API_PROXY;else{if(void 0===globalThis.__AGENT_ENV__||!globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)throw new Error("Service binding detected but not accessible");o=globalThis.__AGENT_ENV__.AGENTS_TO_API_PROXY}const a={...r,headers:t},n=`https://agents-to-api-proxy.circuit-0bc.workers.dev${e}`;s=await o.fetch(n,a)}else{const o=`${this.baseUrl}${e}`,a={...r,headers:t};s=await fetch(o,a)}if(!s.ok){const e=await s.json().catch(()=>({})),r=e.message||e.error||`HTTP ${s.status}: ${s.statusText}`,t=new Error(r);throw t.error=e.error,t.errorMessage=e.message,t.errorDetails=e,t.statusCode=s.status,t}return await s.json()}async get(e){return this.makeRequest(e,{method:"GET"})}async post(e,r){return this.makeRequest(e,{method:"POST",body:r?JSON.stringify(r):void 0})}async delete(e){return this.makeRequest(e,{method:"DELETE"})}};function t(e){return e.startsWith("ethereum:")}function s(e){return"solana"===e}function o(e){return Number(e.split(":")[1])}var a=class{client;config;constructor(e){this.config=e,this.client=new r(e)}async _sendLog(e){await this.client.post("/v1/logs",e)}async signAndSend(e){try{if(t(e.network)){const r=o(e.network);if("toAddress"in e.request)return await this.handleEvmTransaction({chainId:r,toAddress:e.request.toAddress,data:e.request.data,valueWei:e.request.value,message:e.message})}if(s(e.network)&&"hexTransaction"in e.request)return await this.handleSolanaTransaction({hexTransaction:e.request.hexTransaction,message:e.message});const r=`Unsupported network: ${e.network}`;return{success:!1,error:"Unsupported Network",errorMessage:r,errorDetails:{message:r}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async signMessage(e){try{if(t(e.network))return await this.handleEvmSignMessage(e);const r=`Unsupported network: ${e.network}`;return{success:!1,error:"Unsupported Network",errorMessage:r,errorDetails:{message:r}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}swidge={quote:async e=>this.handleSwidgeQuote(e),execute:function(e){return this.handleSwidgeExecute(e)}.bind(this)};memory={set:async(e,r)=>this.handleMemorySet(e,r),get:async e=>this.handleMemoryGet(e),delete:async e=>this.handleMemoryDelete(e),list:async()=>this.handleMemoryList()};platforms={polymarket:{marketOrder:async e=>this.handlePolymarketMarketOrder(e),redeemPositions:async e=>this.handlePolymarketRedeemPositions(e||{tokenIds:[]})}};async handleEvmTransaction(e){try{const r=await this.client.post("/v1/transactions/evm",e),t=await this.client.post(`/v1/transactions/evm/${r.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:r.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async handleSolanaTransaction(e){try{const r=await this.client.post("/v1/transactions/solana",e),t=await this.client.post(`/v1/transactions/solana/${r.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:r.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async handleEvmSignMessage(e){try{return{success:!0,data:await this.client.post("/v1/messages/evm",{messageType:e.request.messageType,data:e.request.data,chainId:e.request.chainId})}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async _updateJobStatus(e){try{return await this.client.post(`/v1/jobs/${e.jobId}/status`,e)}catch(e){return{status:400,message:`Failed to update job status: ${e instanceof Error?e.message:"Unknown error"}`}}}async handleSwidgeQuote(e){try{return{success:!0,data:await this.client.post("/v1/swidge/quote",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to get swidge quote";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleSwidgeExecute(e){try{const r=await this.client.post("/v1/swidge/execute",e);if(Array.isArray(r))return r.map(e=>{const r="success"===e.status;return{success:r,data:e,error:r?void 0:e.error}});const t="success"===r.status;return{success:t,data:r,error:t?void 0:r.error}}catch(r){const t=r.error,s=r.errorMessage,o=r.errorDetails||{},a=r instanceof Error?r.message:"Failed to execute swidge swap";return Array.isArray(e)?[{success:!1,error:t||"SDK Error",errorMessage:s||a,errorDetails:o}]:{success:!1,error:t||"SDK Error",errorMessage:s||a,errorDetails:o}}}async handlePolymarketMarketOrder(e){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/market-order",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to execute polymarket market order";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketRedeemPositions(e){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/redeem-positions",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to redeem polymarket positions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemorySet(e,r){try{return{success:!0,data:await this.client.post(`/v1/memory/${e}`,{value:r})}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to set memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryGet(e){try{return{success:!0,data:await this.client.get(`/v1/memory/${e}`)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to get memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryDelete(e){try{return{success:!0,data:await this.client.delete(`/v1/memory/${e}`)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to delete memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryList(){try{return{success:!0,data:await this.client.get("/v1/memory/list")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to list memory keys";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async transactions(){try{return{success:!0,data:await this.client.get("/v1/transactions/ledger")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to fetch transactions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async getCurrentPositions(){try{return{success:!0,data:await this.client.get("/v1/positions/current")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to fetch current positions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}};import{existsSync as n,readFileSync as i}from"fs";import{join as c}from"path";import{zValidator as u}from"@hono/zod-validator";import{Hono as l}from"hono";import{cors as d}from"hono/cors";import*as h from"zod";var m=class{sessionId;sessionWalletAddress;currentPositions;t;constructor(e){this.sessionId=e.sessionId,this.sessionWalletAddress=e.sessionWalletAddress,this.currentPositions=e.currentPositions,this.t=new a({sessionId:e.sessionId,baseUrl:e.baseUrl,authorizationHeader:e.authorizationHeader})}async log(e,r){const{error:t=!1,debug:s=!1}=r||{};let o,a;const n=(e,r)=>{if("bigint"==typeof r)return r.toString();if("function"==typeof r)return`[Function: ${r.name||"anonymous"}]`;if(void 0===r)return"[undefined]";if(null===r)return null;if("object"==typeof r&&!Array.isArray(r)&&r.toString!==Object.prototype.toString)try{const e=r.toString();if("[object Object]"!==e)return e}catch(e){}return r};if("object"==typeof e&&null!==e?(o=JSON.stringify(e,n,2),a=JSON.stringify(e,n)):(o=String(e),a=String(e)),t?console.error(o):console.log(o),s)return{success:!0};const i=t?"error":"observe";try{const e=a.length>250?a.slice(0,250):a;return await this.t._sendLog([{type:i,shortMessage:e}]),{success:!0}}catch(e){const r=e instanceof Error?e.message:"Failed to send log";return console.error(`Failed to send log to backend: ${r}`),{success:!1,error:"Log Error",errorMessage:r,errorDetails:{message:r,type:e instanceof Error?e.constructor.name:"UnknownError"}}}}async signAndSend(e){return this.t.signAndSend(e)}async signMessage(e){return this.t.signMessage(e)}memory={set:async(e,r)=>this.t.memory.set(e,r),get:async e=>this.t.memory.get(e),delete:async e=>this.t.memory.delete(e),list:async()=>this.t.memory.list()};platforms={polymarket:{marketOrder:async e=>this.t.platforms.polymarket.marketOrder(e),redeemPositions:async e=>this.t.platforms.polymarket.redeemPositions(e)}};swidge={quote:async e=>this.t.swidge.quote(e),execute:function(e){return this.t.swidge.execute(e)}.bind(this)};async transactions(){return this.t.transactions()}async getCurrentPositions(){return this.t.getCurrentPositions()}},g=h.object({network:h.string(),assetAddress:h.string(),tokenId:h.string().nullable(),avgUnitCost:h.string(),currentQty:h.string()}),y=h.object({sessionId:h.number(),sessionWalletAddress:h.string(),jobId:h.string().optional(),currentPositions:h.array(g)}),p=(h.object({status:h.string()}),class{app;runFunction;stopFunction;healthCheckFunction=async()=>({status:"healthy",timestamp:(new Date).toISOString()});constructor(e){this.app=new l,this.runFunction=e.runFunction,this.stopFunction=e.stopFunction,this.app.use("*",d()),this.setupRoutes()}defaultStopFunction=async e=>{await e.log(`Agent stopped for session ${e.sessionId}`)};async executeWithJobTracking(e,r,t){let s,o=!1;try{const s=new m({sessionId:e.sessionId,sessionWalletAddress:e.sessionWalletAddress,currentPositions:e.currentPositions,authorizationHeader:t});await r(s),o=!0}catch(e){s=this.getErrorMessage(e),o=!1,console.error("Agent function error:",s)}finally{e.jobId&&await this.updateJobStatus(e.sessionId,e.jobId,o?"success":"failed",s,t)}}getErrorMessage(e){if(null==e)return"Unknown error";try{const r=e?.constructor?.name||"Error";let t="";t=e instanceof Error&&e.message||String(e),t=t.replace(/[^\x20-\x7E\n\t]/g,"");const s=`${r}: ${t}`;return s.length>1e3?`${s.substring(0,997)}...`:s}catch{return"Unknown error (message extraction failed)"}}async updateJobStatus(e,r,t,s,o){const n=new a({sessionId:e,authorizationHeader:o});for(let e=1;e<=3;e++)try{return void await n._updateJobStatus({jobId:r,status:t,errorMessage:s})}catch(r){console.error(`Status update attempt ${e}/3 failed:`,r),e<3&&await new Promise(r=>setTimeout(r,100*2**(e-1)))}if("failed"===t)try{return console.warn(`Issue updating job status to '${t}' with error message, attempting to update status without error message`),void await n._updateJobStatus({jobId:r,status:t,errorMessage:void 0})}catch(e){console.error(`CRITICAL: Failed to update job ${r} status. Likely API connectivity issue:`,e)}else console.error(`CRITICAL: Failed to update job ${r} status to success after 3 attempts`)}setupRoutes(){this.app.post("/run",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization");return await this.executeWithJobTracking(r,this.runFunction,t),e.json({success:!0,message:"Execution completed"})}),this.app.post("/execute",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization");return await this.executeWithJobTracking(r,this.runFunction,t),e.json({success:!0,message:"Execution completed"})}),this.app.post("/stop",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization"),s=this.stopFunction||this.defaultStopFunction;return await this.executeWithJobTracking(r,s,t),e.json({success:!0,message:"Stop completed"})}),this.app.get("/health",async e=>{try{const r=await this.healthCheckFunction();return e.json(r)}catch(r){return console.error("Agent health check error:",r),e.json({status:"unhealthy",error:r instanceof Error?r.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const e=c(process.cwd(),"package.json");if(n(e)){const r=JSON.parse(i(e,"utf-8"));if(r.circuit?.port)return console.log("⚠️  Warning: circuit.port in package.json is deprecated. Use AGENT_PORT environment variable instead."),Number.parseInt(r.circuit.port,10)}}catch(e){console.log("Could not read package.json for port configuration")}return null}async run(e){if("undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare)return this.getExport();const r=globalThis.Bun?.env,t=process.env.AGENT_PORT||r?.AGENT_PORT,s=this.getPortFromPackageJson();let o=e;!o&&t&&(o=Number.parseInt(t,10)),!o&&s&&(o=s),o||(o=3e3),console.log("🔧 Agent configuration:"),console.log(`   Explicit port parameter: ${e||"not set"}`),console.log(`   process.env.AGENT_PORT: ${process.env.AGENT_PORT||"not set"}`),console.log(`   Bun.env.AGENT_PORT: ${r?.AGENT_PORT||"not set"}`),console.log(`   package.json circuit.port: ${s||"not set"} (deprecated)`),console.log(`   Final port: ${o}`);try{const{serve:e}=await import("@hono/node-server");console.log(`🚀 Server is running on port ${o}`),console.log("📍 Available endpoints: GET /health, POST /run, POST /execute (backward compat), POST /stop"),e({fetch:this.app.fetch,port:o})}catch(e){console.error("Failed to start local server. @hono/node-server is not available."),console.error("For local development, install @hono/node-server: npm install @hono/node-server"),process.exit(1)}}getExport(){return{fetch:async(e,r,t)=>(r&&"undefined"!=typeof globalThis&&(globalThis.__AGENT_ENV__=r),this.app.fetch(e,r,t))}}});import{z as f}from"zod";var w=f.templateLiteral(["ethereum:",f.coerce.number().int().nonnegative()]),v=f.union([f.literal("solana"),w]),E=f.object({address:f.string(),network:v}),T=(f.object({from:E,to:E,fromToken:f.string().optional(),toToken:f.string().optional(),amount:f.string(),slippage:f.string().optional()}),f.object({network:v,address:f.string(),token:f.string().nullable(),name:f.string().optional(),symbol:f.string().optional(),decimals:f.number().optional(),amount:f.string().optional(),minimumAmount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()})),b=f.object({usd:f.string().optional(),percentage:f.string().optional()}),k=f.object({name:f.string(),amount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()}),D=f.object({programId:f.string(),keys:f.array(f.object({pubkey:f.string(),isSigner:f.boolean(),isWritable:f.boolean()})),data:f.union([f.string(),f.instanceof(Buffer)])}),S=f.object({type:f.literal("evm"),from:f.string().regex(/^0x[a-fA-F0-9]{40}$/),to:f.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:f.number(),value:f.number(),data:f.string().regex(/^0x[a-fA-F0-9]*$/),gas:f.number().nullish(),maxFeePerGas:f.number().nullish(),maxPriorityFeePerGas:f.number().nullish()}),A=f.object({type:f.literal("solana"),instructions:f.array(D),addressLookupTableAddresses:f.array(f.string())}),M=f.object({type:f.literal("transaction"),description:f.string(),transactionDetails:f.union([S,A]),metadata:f.record(f.string(),f.string())}),F=f.object({type:f.literal("signature"),description:f.string(),signatureData:f.string(),metadata:f.record(f.string(),f.string())}),$=f.discriminatedUnion("type",[M,F]),O=f.object({engine:f.literal("relay"),assetSend:T,assetReceive:T,priceImpact:b,fees:f.array(k),steps:f.array($)}),U=f.object({network:f.string(),txs:f.array(f.string())}),x=f.object({status:f.union([f.literal("success"),f.literal("failure"),f.literal("refund"),f.literal("delayed")]),in:U,out:U,lastUpdated:f.number(),error:f.string().optional()}),I={FOUND:"QUOTE_FOUND",NO_QUOTE_PROVIDED:"No quote provided",WALLET_NOT_FOUND:"Wallet not found",WALLET_MISMATCH:"From wallet does not match session wallet",PRICE_IMPACT_TOO_HIGH:"Failed to get quote. Error: Price impact is too high",NO_ROUTES_FOUND:"Failed to get quote. Error: no routes found",AMOUNT_TOO_SMALL:"Failed to get quote. APIError: Swap output amount is too small to cover fees required to execute swap"},P=e=>f.object({success:f.boolean(),data:e.optional(),error:f.string().optional(),errorMessage:f.string().optional(),errorDetails:f.object({message:f.string().optional(),error:f.string().optional(),status:f.number().optional(),statusText:f.string().optional()}).optional()});P(O),P(x);export{r as APIClient,p as Agent,m as AgentContext,a as AgentSdk,I as QUOTE_RESULT,o as getChainIdFromNetwork,t as isEthereumNetwork,s as isSolanaNetwork};
+import{loadAuthFromFileSystem as r}from"./chunk-4I3A6QAK.js";var e=class{config;baseUrl;authorizationHeader;isCloudflareWorker(){return"undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare}hasServiceBinding(){if(this.isCloudflareWorker()){if(void 0!==globalThis.AGENTS_TO_API_PROXY)return!0;if(void 0!==globalThis.__AGENT_ENV__&&globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)return!0}return!1}constructor(r){this.config=r,this.baseUrl=r.baseUrl||"https://agents.circuit.org",this.authorizationHeader=r.authorizationHeader}getAgentSlug(){return"undefined"!=typeof process&&process.env?.CIRCUIT_AGENT_SLUG?process.env.CIRCUIT_AGENT_SLUG:void 0!==globalThis.CIRCUIT_AGENT_SLUG?globalThis.CIRCUIT_AGENT_SLUG:void 0}getAuthHeaders(){const r={};r["X-Session-Id"]=this.config.sessionId.toString();const e=this.getAgentSlug();if(e&&(r["X-Agent-Slug"]=e),this.isCloudflareWorker())return r;if(this.authorizationHeader)return r.Authorization=this.authorizationHeader,r;try{const e=this.loadAuthConfig();e?.sessionToken&&(r.Authorization=`Bearer ${e.sessionToken}`)}catch{}return r}loadAuthConfig(){try{return r()}catch{}}async makeRequest(r,e={}){const t={...{"Content-Type":"application/json",...this.getAuthHeaders()},...e.headers};let s;if(this.hasServiceBinding()){let o;if(void 0!==globalThis.AGENTS_TO_API_PROXY)o=globalThis.AGENTS_TO_API_PROXY;else{if(void 0===globalThis.__AGENT_ENV__||!globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)throw new Error("Service binding detected but not accessible");o=globalThis.__AGENT_ENV__.AGENTS_TO_API_PROXY}const a={...e,headers:t},n=`https://agents-to-api-proxy.circuit-0bc.workers.dev${r}`;s=await o.fetch(n,a)}else{const o=`${this.baseUrl}${r}`,a={...e,headers:t};s=await fetch(o,a)}if(!s.ok){const r=await s.json().catch(()=>({})),e=r.message||r.error||`HTTP ${s.status}: ${s.statusText}`,t=new Error(e);throw t.error=r.error,t.errorMessage=r.message,t.errorDetails=r,t.statusCode=s.status,t}return await s.json()}async get(r){return this.makeRequest(r,{method:"GET"})}async post(r,e){return this.makeRequest(r,{method:"POST",body:e?JSON.stringify(e):void 0})}async delete(r){return this.makeRequest(r,{method:"DELETE"})}};function t(r){return r.startsWith("ethereum:")}function s(r){return"solana"===r}function o(r){return Number(r.split(":")[1])}var a=class{client;config;constructor(r){this.config=r,this.client=new e(r)}async _sendLog(r){await this.client.post("/v1/logs",r)}async signAndSend(r){try{if(t(r.network)){const e=o(r.network);if("toAddress"in r.request)return await this.handleEvmTransaction({chainId:e,toAddress:r.request.toAddress,data:r.request.data,valueWei:r.request.value,message:r.message})}if(s(r.network)&&"hexTransaction"in r.request)return await this.handleSolanaTransaction({hexTransaction:r.request.hexTransaction,message:r.message});const e=`Unsupported network: ${r.network}`;return{success:!1,error:"Unsupported Network",errorMessage:e,errorDetails:{message:e}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async signMessage(r){try{if(t(r.network))return await this.handleEvmSignMessage(r);const e=`Unsupported network: ${r.network}`;return{success:!1,error:"Unsupported Network",errorMessage:e,errorDetails:{message:e}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}swidge={quote:async r=>this.handleSwidgeQuote(r),execute:function(r){return this.handleSwidgeExecute(r)}.bind(this)};memory={set:async(r,e)=>this.handleMemorySet(r,e),get:async r=>this.handleMemoryGet(r),delete:async r=>this.handleMemoryDelete(r),list:async()=>this.handleMemoryList()};platforms={polymarket:{marketOrder:async r=>this.handlePolymarketMarketOrder(r),redeemPositions:async r=>this.handlePolymarketRedeemPositions(r||{tokenIds:[]})},hyperliquid:{placeOrder:async r=>this.handleHyperliquidPlaceOrder(r),order:async r=>this.handleHyperliquidGetOrder(r),deleteOrder:async(r,e)=>this.handleHyperliquidDeleteOrder(r,e),balances:async()=>this.handleHyperliquidGetBalances(),positions:async()=>this.handleHyperliquidGetPositions(),openOrders:async()=>this.handleHyperliquidGetOpenOrders(),orderFills:async()=>this.handleHyperliquidGetOrderFills(),orders:async()=>this.handleHyperliquidGetHistoricalOrders(),transfer:async r=>this.handleHyperliquidTransfer(r),liquidations:async r=>this.handleHyperliquidGetLiquidations(r)}};async handleEvmTransaction(r){try{const e=await this.client.post("/v1/transactions/evm",r),t=await this.client.post(`/v1/transactions/evm/${e.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:e.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async handleSolanaTransaction(r){try{const e=await this.client.post("/v1/transactions/solana",r),t=await this.client.post(`/v1/transactions/solana/${e.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:e.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async handleEvmSignMessage(r){try{return{success:!0,data:await this.client.post("/v1/messages/evm",{messageType:r.request.messageType,data:r.request.data,chainId:r.request.chainId})}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async _updateJobStatus(r){try{return await this.client.post(`/v1/jobs/${r.jobId}/status`,r)}catch(r){return{status:400,message:`Failed to update job status: ${r instanceof Error?r.message:"Unknown error"}`}}}async handleSwidgeQuote(r){try{return{success:!0,data:await this.client.post("/v1/swidge/quote",r)}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to get swidge quote";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleSwidgeExecute(r){try{const e=await this.client.post("/v1/swidge/execute",r);if(Array.isArray(e))return e.map(r=>{const e="success"===r.status;return{success:e,data:r,error:e?void 0:r.error}});const t="success"===e.status;return{success:t,data:e,error:t?void 0:e.error}}catch(e){const t=e.error,s=e.errorMessage,o=e.errorDetails||{},a=e instanceof Error?e.message:"Failed to execute swidge swap";return Array.isArray(r)?[{success:!1,error:t||"SDK Error",errorMessage:s||a,errorDetails:o}]:{success:!1,error:t||"SDK Error",errorMessage:s||a,errorDetails:o}}}async handlePolymarketMarketOrder(r){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/market-order",r)}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to execute polymarket market order";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketRedeemPositions(r){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/redeem-positions",r)}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to redeem polymarket positions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleHyperliquidPlaceOrder(r){try{return await this.client.post("/v1/platforms/hyperliquid/order",r)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to place order";return{success:!1,error:e||t}}}async handleHyperliquidGetOrder(r){try{return await this.client.get(`/v1/platforms/hyperliquid/order/${r}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get order";return{success:!1,error:e||t}}}async handleHyperliquidDeleteOrder(r,e){try{return await this.client.delete(`/v1/platforms/hyperliquid/order/${r}/${e}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to delete order";return{success:!1,error:e||t}}}async handleHyperliquidGetBalances(){try{return await this.client.get("/v1/platforms/hyperliquid/balances")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get balances";return{success:!1,error:e||t}}}async handleHyperliquidGetPositions(){try{return await this.client.get("/v1/platforms/hyperliquid/positions")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get positions";return{success:!1,error:e||t}}}async handleHyperliquidGetOpenOrders(){try{return await this.client.get("/v1/platforms/hyperliquid/orders")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get open orders";return{success:!1,error:e||t}}}async handleHyperliquidGetOrderFills(){try{return await this.client.get("/v1/platforms/hyperliquid/orders/fill-history")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get order fills";return{success:!1,error:e||t}}}async handleHyperliquidGetHistoricalOrders(){try{return await this.client.get("/v1/platforms/hyperliquid/orders/historical")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get historical orders";return{success:!1,error:e||t}}}async handleHyperliquidTransfer(r){try{return await this.client.post("/v1/platforms/hyperliquid/transfer",r)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to transfer";return{success:!1,error:e||t}}}async handleHyperliquidGetLiquidations(r){try{const e=r?`?startTime=${r}`:"";return await this.client.get(`/v1/platforms/hyperliquid/liquidations${e}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get liquidations";return{success:!1,error:e||t}}}async handleMemorySet(r,e){try{return{success:!0,data:await this.client.post(`/v1/memory/${r}`,{value:e})}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to set memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryGet(r){try{return{success:!0,data:await this.client.get(`/v1/memory/${r}`)}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to get memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryDelete(r){try{return{success:!0,data:await this.client.delete(`/v1/memory/${r}`)}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to delete memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryList(){try{return{success:!0,data:await this.client.get("/v1/memory/list")}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to list memory keys";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async transactions(){try{return{success:!0,data:await this.client.get("/v1/transactions/ledger")}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to fetch transactions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async getCurrentPositions(){try{return{success:!0,data:await this.client.get("/v1/positions/current")}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to fetch current positions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}};import{existsSync as n,readFileSync as i}from"fs";import{join as c}from"path";import{zValidator as u}from"@hono/zod-validator";import{Hono as l}from"hono";import{cors as d}from"hono/cors";import*as h from"zod";var y=class{sessionId;sessionWalletAddress;currentPositions;t;constructor(r){this.sessionId=r.sessionId,this.sessionWalletAddress=r.sessionWalletAddress,this.currentPositions=r.currentPositions,this.t=new a({sessionId:r.sessionId,baseUrl:r.baseUrl,authorizationHeader:r.authorizationHeader})}async log(r,e){const{error:t=!1,debug:s=!1}=e||{};let o,a;const n=(r,e)=>{if("bigint"==typeof e)return e.toString();if("function"==typeof e)return`[Function: ${e.name||"anonymous"}]`;if(void 0===e)return"[undefined]";if(null===e)return null;if("object"==typeof e&&!Array.isArray(e)&&e.toString!==Object.prototype.toString)try{const r=e.toString();if("[object Object]"!==r)return r}catch(r){}return e};if("object"==typeof r&&null!==r?(o=JSON.stringify(r,n,2),a=JSON.stringify(r,n)):(o=String(r),a=String(r)),t?console.error(o):console.log(o),s)return{success:!0};const i=t?"error":"observe";try{const r=a.length>250?a.slice(0,250):a;return await this.t._sendLog([{type:i,shortMessage:r}]),{success:!0}}catch(r){const e=r instanceof Error?r.message:"Failed to send log";return console.error(`Failed to send log to backend: ${e}`),{success:!1,error:"Log Error",errorMessage:e,errorDetails:{message:e,type:r instanceof Error?r.constructor.name:"UnknownError"}}}}async signAndSend(r){return this.t.signAndSend(r)}async signMessage(r){return this.t.signMessage(r)}memory={set:async(r,e)=>this.t.memory.set(r,e),get:async r=>this.t.memory.get(r),delete:async r=>this.t.memory.delete(r),list:async()=>this.t.memory.list()};platforms={polymarket:{marketOrder:async r=>this.t.platforms.polymarket.marketOrder(r),redeemPositions:async r=>this.t.platforms.polymarket.redeemPositions(r)},hyperliquid:{placeOrder:async r=>this.t.platforms.hyperliquid.placeOrder(r),order:async r=>this.t.platforms.hyperliquid.order(r),deleteOrder:async(r,e)=>this.t.platforms.hyperliquid.deleteOrder(r,e),balances:async()=>this.t.platforms.hyperliquid.balances(),positions:async()=>this.t.platforms.hyperliquid.positions(),openOrders:async()=>this.t.platforms.hyperliquid.openOrders(),orderFills:async()=>this.t.platforms.hyperliquid.orderFills(),orders:async()=>this.t.platforms.hyperliquid.orders(),transfer:async r=>this.t.platforms.hyperliquid.transfer(r),liquidations:async r=>this.t.platforms.hyperliquid.liquidations(r)}};swidge={quote:async r=>this.t.swidge.quote(r),execute:function(r){return this.t.swidge.execute(r)}.bind(this)};async transactions(){return this.t.transactions()}async getCurrentPositions(){return this.t.getCurrentPositions()}},p=h.object({network:h.string(),assetAddress:h.string(),tokenId:h.string().nullable(),avgUnitCost:h.string(),currentQty:h.string()}),m=h.object({sessionId:h.number(),sessionWalletAddress:h.string(),jobId:h.string().optional(),currentPositions:h.array(p)}),g=(h.object({status:h.string()}),class{app;runFunction;stopFunction;healthCheckFunction=async()=>({status:"healthy",timestamp:(new Date).toISOString()});constructor(r){this.app=new l,this.runFunction=r.runFunction,this.stopFunction=r.stopFunction,this.app.use("*",d()),this.setupRoutes()}defaultStopFunction=async r=>{await r.log(`Agent stopped for session ${r.sessionId}`)};async executeWithJobTracking(r,e,t){let s,o=!1;try{const s=new y({sessionId:r.sessionId,sessionWalletAddress:r.sessionWalletAddress,currentPositions:r.currentPositions,authorizationHeader:t});await e(s),o=!0}catch(r){s=this.getErrorMessage(r),o=!1,console.error("Agent function error:",s)}finally{r.jobId&&await this.updateJobStatus(r.sessionId,r.jobId,o?"success":"failed",s,t)}}getErrorMessage(r){if(null==r)return"Unknown error";try{const e=r?.constructor?.name||"Error";let t="";t=r instanceof Error&&r.message||String(r),t=t.replace(/[^\x20-\x7E\n\t]/g,"");const s=`${e}: ${t}`;return s.length>1e3?`${s.substring(0,997)}...`:s}catch{return"Unknown error (message extraction failed)"}}async updateJobStatus(r,e,t,s,o){const n=new a({sessionId:r,authorizationHeader:o});for(let r=1;r<=3;r++)try{return void await n._updateJobStatus({jobId:e,status:t,errorMessage:s})}catch(e){console.error(`Status update attempt ${r}/3 failed:`,e),r<3&&await new Promise(e=>setTimeout(e,100*2**(r-1)))}if("failed"===t)try{return console.warn(`Issue updating job status to '${t}' with error message, attempting to update status without error message`),void await n._updateJobStatus({jobId:e,status:t,errorMessage:void 0})}catch(r){console.error(`CRITICAL: Failed to update job ${e} status. Likely API connectivity issue:`,r)}else console.error(`CRITICAL: Failed to update job ${e} status to success after 3 attempts`)}setupRoutes(){this.app.post("/run",u("json",m),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization");return await this.executeWithJobTracking(e,this.runFunction,t),r.json({success:!0,message:"Execution completed"})}),this.app.post("/execute",u("json",m),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization");return await this.executeWithJobTracking(e,this.runFunction,t),r.json({success:!0,message:"Execution completed"})}),this.app.post("/stop",u("json",m),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization"),s=this.stopFunction||this.defaultStopFunction;return await this.executeWithJobTracking(e,s,t),r.json({success:!0,message:"Stop completed"})}),this.app.get("/health",async r=>{try{const e=await this.healthCheckFunction();return r.json(e)}catch(e){return console.error("Agent health check error:",e),r.json({status:"unhealthy",error:e instanceof Error?e.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const r=c(process.cwd(),"package.json");if(n(r)){const e=JSON.parse(i(r,"utf-8"));if(e.circuit?.port)return console.log("⚠️  Warning: circuit.port in package.json is deprecated. Use AGENT_PORT environment variable instead."),Number.parseInt(e.circuit.port,10)}}catch(r){console.log("Could not read package.json for port configuration")}return null}async run(r){if("undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare)return this.getExport();const e=globalThis.Bun?.env,t=process.env.AGENT_PORT||e?.AGENT_PORT,s=this.getPortFromPackageJson();let o=r;!o&&t&&(o=Number.parseInt(t,10)),!o&&s&&(o=s),o||(o=3e3),console.log("🔧 Agent configuration:"),console.log(`   Explicit port parameter: ${r||"not set"}`),console.log(`   process.env.AGENT_PORT: ${process.env.AGENT_PORT||"not set"}`),console.log(`   Bun.env.AGENT_PORT: ${e?.AGENT_PORT||"not set"}`),console.log(`   package.json circuit.port: ${s||"not set"} (deprecated)`),console.log(`   Final port: ${o}`);try{const{serve:r}=await import("@hono/node-server");console.log(`🚀 Server is running on port ${o}`),console.log("📍 Available endpoints: GET /health, POST /run, POST /execute (backward compat), POST /stop"),r({fetch:this.app.fetch,port:o})}catch(r){console.error("Failed to start local server. @hono/node-server is not available."),console.error("For local development, install @hono/node-server: npm install @hono/node-server"),process.exit(1)}}getExport(){return{fetch:async(r,e,t)=>(e&&"undefined"!=typeof globalThis&&(globalThis.__AGENT_ENV__=e),this.app.fetch(r,e,t))}}});import{z as f}from"zod";var w=f.templateLiteral(["ethereum:",f.coerce.number().int().nonnegative()]),v=f.union([f.literal("solana"),w]),E=f.object({address:f.string(),network:v}),b=(f.object({from:E,to:E,fromToken:f.string().optional(),toToken:f.string().optional(),amount:f.string(),slippage:f.string().optional()}),f.object({network:v,address:f.string(),token:f.string().nullable(),name:f.string().optional(),symbol:f.string().optional(),decimals:f.number().optional(),amount:f.string().optional(),minimumAmount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()})),T=f.object({usd:f.string().optional(),percentage:f.string().optional()}),k=f.object({name:f.string(),amount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()}),D=f.object({programId:f.string(),keys:f.array(f.object({pubkey:f.string(),isSigner:f.boolean(),isWritable:f.boolean()})),data:f.union([f.string(),f.instanceof(Buffer)])}),F=f.object({type:f.literal("evm"),from:f.string().regex(/^0x[a-fA-F0-9]{40}$/),to:f.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:f.number(),value:f.number(),data:f.string().regex(/^0x[a-fA-F0-9]*$/),gas:f.number().nullish(),maxFeePerGas:f.number().nullish(),maxPriorityFeePerGas:f.number().nullish()}),S=f.object({type:f.literal("solana"),instructions:f.array(D),addressLookupTableAddresses:f.array(f.string())}),O=f.object({type:f.literal("transaction"),description:f.string(),transactionDetails:f.union([F,S]),metadata:f.record(f.string(),f.string())}),A=f.object({type:f.literal("signature"),description:f.string(),signatureData:f.string(),metadata:f.record(f.string(),f.string())}),M=f.discriminatedUnion("type",[O,A]),$=f.object({engine:f.literal("relay"),assetSend:b,assetReceive:b,priceImpact:T,fees:f.array(k),steps:f.array(M)}),q=f.object({network:f.string(),txs:f.array(f.string())}),P=f.object({status:f.union([f.literal("success"),f.literal("failure"),f.literal("refund"),f.literal("delayed")]),in:q,out:q,lastUpdated:f.number(),error:f.string().optional()}),U={FOUND:"QUOTE_FOUND",NO_QUOTE_PROVIDED:"No quote provided",WALLET_NOT_FOUND:"Wallet not found",WALLET_MISMATCH:"From wallet does not match session wallet",PRICE_IMPACT_TOO_HIGH:"Failed to get quote. Error: Price impact is too high",NO_ROUTES_FOUND:"Failed to get quote. Error: no routes found",AMOUNT_TOO_SMALL:"Failed to get quote. APIError: Swap output amount is too small to cover fees required to execute swap"},x=r=>f.object({success:f.boolean(),data:r.optional(),error:f.string().optional(),errorMessage:f.string().optional(),errorDetails:f.object({message:f.string().optional(),error:f.string().optional(),status:f.number().optional(),statusText:f.string().optional()}).optional()});x($),x(P);export{e as APIClient,g as Agent,y as AgentContext,a as AgentSdk,U as QUOTE_RESULT,o as getChainIdFromNetwork,t as isEthereumNetwork,s as isSolanaNetwork};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circuitorg/agent-sdk",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "typescript sdk for the Agent Toolset Service",
   "type": "module",
   "main": "index.js",