update transaction tools

Author: fishonamos

packages/sui-agent/src/agents/ToolRegistry.ts

@@ -2,7 +2,7 @@ import Tools from '../utils/tools';
 import AfterMath from '../protocols/aftermath/tools';
 import Navi from '../protocols/navi/tools';
 import Cetus from '../protocols/cetus/tools';
-import Transaction from '../transactions/tools';
+import TransactionTools from '../transactions/tools';
 import Suilend from '../protocols/suilend/tools';
 /* 
 format for tool registry is:
@@ -17,7 +17,7 @@ export function registerAllTools(tools: Tools) {
   // Cetus tools
   Cetus.registerTools(tools);
   // Transaction Tools
-  Transaction.registerTools(tools);
+  TransactionTools.registerTools(tools);
   // Suilend tools
   Suilend.registerTools(tools);
 }

packages/sui-agent/src/protocols/navi/README.md

@@ -1,108 +1,135 @@
-## Navi Protocol Integration
+# Navi Protocol Integration
 
-The Sui Agent includes integration with the Navi Protocol, providing access to Navi's DeFi functionality and perpetual trading features.
+This module provides integration with the Navi perpetual trading protocol on Sui Network.
 
-### Features
+## Features
 
-#### Perpetual Trading
+- Order Management
+  - Place orders (market/limit)
+  - Cancel orders
+  - Get user orders
+- Position Management
+  - Open positions
+  - Close positions
+  - Get user positions
+  - Adjust leverage
+  - Adjust margin
+- Market Data
+  - Get orderbook
+  - Get market data
+  - Get funding rates
+- Account Management
+  - Get account info
+  - Get account balance
+  - Get account positions
 
-- Open and close positions
-- Manage leverage and margin
-- Monitor position metrics
-- Track funding rates
+## Tools
 
-#### Market Data
+### Order Management
 
-- Get real-time prices
-- View market statistics
-- Monitor trading volume
-- Track historical data
+#### `place_navi_order`
 
-#### Account Management
+Place a new order on Navi.
 
-- View account positions
-- Monitor margin levels
-- Track PnL
-- Manage collateral
+Parameters:
 
-### Example Usage
+- `symbol` (string, required): Trading pair symbol (e.g., "BTC-PERP")
+- `side` (string, required): Order side ("BUY" or "SELL")
+- `type` (string, required): Order type ("MARKET" or "LIMIT")
+- `quantity` (number, required): Order quantity
+- `price` (number, optional): Order price (required for LIMIT orders)
+- `leverage` (number, optional): Position leverage
 
-```typescript
-// Initialize the agent
-const agent = new Agents(YOUR_BEARER_TOKEN);
-
-// Get market information
-const marketInfo = await agent.SuperVisorAgent(
-  'Get Navi market information for BTC-PERP',
-);
-
-// Open a position
-const position = await agent.SuperVisorAgent(
-  'Open a long position on Navi BTC-PERP with 5x leverage and 100 USDC as margin',
-);
-
-// Check account positions
-const positions = await agent.SuperVisorAgent(
-  'Get my Navi positions for address 0x123...abc',
-);
-
-// Monitor funding rate
-const funding = await agent.SuperVisorAgent(
-  'Get current funding rate for Navi BTC-PERP market',
-);
-```
+#### `cancel_navi_order`
+
+Cancel an existing order on Navi.
+
+Parameters:
+
+- `symbol` (string, required): Trading pair symbol
+- `order_id` (string, required): Order ID to cancel
+
+### Position Management
+
+#### `adjust_navi_position`
+
+Adjust position leverage on Navi.
+
+Parameters:
+
+- `symbol` (string, required): Trading pair symbol
+- `leverage` (number, required): New leverage value
+
+#### `adjust_navi_margin`
+
+Add or remove margin from a position.
 
-### Supported Operations
+Parameters:
 
-1. Trading Operations
+- `symbol` (string, required): Trading pair symbol
+- `amount` (number, required): Amount to add/remove
+- `is_add` (boolean, required): True for adding margin, false for removing
 
-   - Open positions with leverage
-   - Close positions
-   - Adjust position size
-   - Modify leverage
-   - Set stop loss and take profit
+### Market Data
 
-2. Market Operations
+#### `get_navi_orderbook`
 
-   - Get market prices
-   - View order book depth
-   - Monitor funding rates
-   - Track trading volume
-   - View market statistics
+Get the orderbook for a trading pair.
 
-3. Account Operations
-   - View account positions
-   - Monitor margin levels
-   - Track realized/unrealized PnL
-   - Manage collateral deposits/withdrawals
+Parameters:
 
-### Configuration
+- `symbol` (string, required): Trading pair symbol
 
-The Navi integration uses the following environment variables:
+#### `get_navi_market_data`
 
-- `SUI_RPC_URL`: The Sui network RPC URL (defaults to mainnet)
-- `SUI_WALLET_ADDRESS`: The simulation account address
+Get market data for a trading pair.
 
-### Error Handling
+Parameters:
 
-All operations include comprehensive error handling and return standardized responses:
+- `symbol` (string, required): Trading pair symbol
+
+### Account Management
+
+#### `get_navi_account_info`
+
+Get account information.
+
+Parameters:
+
+- `account_address` (string, required): Account address
+
+## Usage Example
 
 ```typescript
-{
-  reasoning: string;
-  response: any;
-  status: 'success' | 'error';
-  query: string;
-  errors: string[];
-}
+// Place a market order
+await tools.execute('place_navi_order', [
+  'BTC-PERP', // symbol
+  'BUY', // side
+  'MARKET', // type
+  1.0, // quantity
+]);
+
+// Get account positions
+await tools.execute('get_navi_account_info', [
+  '0x1234...', // account_address
+]);
 ```
 
-### Testing
+## Error Handling
 
-Integration tests are available in `src/tests/navi.test.ts`. To run the tests:
+All tools return responses in a standardized format:
 
-```bash
-npm test -- navi.test.ts
+```typescript
+{
+  reasoning: string;     // Description of what happened
+  response: string;     // The actual response data
+  status: string;      // "success" or "failure"
+  query: string;       // The original query
+  errors: string[];    // Array of error messages if any
+}
 ```
 
-Make sure to set the required environment variables before running tests.
+## Dependencies
+
+- @mysten/sui: ^1.1.0
+- Other Navi-specific dependencies