Sui Agent Kit: Your Gateway to Automated DeFi on Navi Protocol with UBOS

The Sui Agent Kit empowers developers to build sophisticated DeFi applications, automation scripts, and AI-powered agents on the Sui blockchain, leveraging the Navi Protocol’s liquidity and features. This kit provides a robust, agent-friendly toolkit that abstracts the complexities of the Navi Protocol SDK, exposing its functionalities as intuitive “tools” through the Model-Context Protocol (MCP).

Simplifying DeFi Development on Sui

The Sui Agent Kit addresses the challenge of interacting with DeFi protocols by offering a simplified approach. It acts as a bridge, translating simple MCP tool calls into direct interactions with the Navi Protocol on the Sui network. Built with TypeScript, this Node.js server application streamlines the development process, making it easier for developers to prototype, build, and deploy DeFi solutions.

Key Benefits:

• Simplified Interaction: Abstracts the complexities of the Navi Protocol SDK.
• Agent-Friendly Toolkit: Provides intuitive tools for building AI-powered agents.
• Rapid Prototyping: Enables developers to quickly prototype and deploy DeFi applications.
• Seamless Integration: Integrates with the Navi Protocol, leveraging its liquidity and features.

Use Cases

The Sui Agent Kit opens up a wide range of possibilities for DeFi automation and AI-powered financial solutions. Here are some compelling use cases:

1. Automated Portfolio Rebalancer

Imagine an AI agent that continuously monitors your portfolio’s health factor on the Navi Protocol. This agent can automatically deposit or withdraw collateral, and repay or borrow assets to maintain a target health factor. This ensures your portfolio remains within a safe risk range, protecting your assets from liquidation.

Key Features:

• Real-time Monitoring: Continuously tracks your portfolio’s health factor.
• Automated Adjustments: Automatically adjusts your positions to maintain a target health factor.
• Risk Management: Protects your assets from liquidation by ensuring a safe risk range.

2. Yield Farming Agent

Discover high-yield opportunities on the Navi Protocol with an intelligent yield farming agent. This agent identifies opportunities such as staking SUI for vSUI or supplying assets to maximize returns. It then automatically moves funds to capitalize on these opportunities, optimizing your yield farming strategy.

Key Features:

• Opportunity Identification: Identifies high-yield opportunities on the Navi Protocol.
• Automated Fund Movement: Automatically moves funds to maximize returns.
• Yield Optimization: Optimizes your yield farming strategy for maximum profitability.

3. DeFi Dashboard with 1-Click Actions

Create a user-friendly web interface that simplifies complex Navi Protocol actions. This dashboard uses the Sui Agent Kit in the backend to display portfolio information and allows users to perform complex actions with a single click. This makes DeFi more accessible to a wider audience.

Key Features:

• User-Friendly Interface: Simplifies complex DeFi actions.
• Portfolio Information: Displays comprehensive portfolio information.
• 1-Click Actions: Enables users to perform complex actions with a single click.

4. AI-Powered Financial Advisor

Develop an AI agent that analyzes market conditions and a user’s portfolio to suggest optimal DeFi strategies on Navi. With user permission, the agent can execute these strategies automatically, providing personalized financial advice and automated portfolio management.

Key Features:

• Market Analysis: Analyzes market conditions to identify optimal DeFi strategies.
• Personalized Advice: Provides personalized financial advice based on user’s portfolio.
• Automated Execution: Executes strategies automatically with user permission.

5. Custom Tooling for Navi

Extend the Sui Agent Kit with specialized tools or build new utilities around it for advanced Navi users. This allows you to create custom solutions tailored to specific needs and use cases, further expanding the capabilities of the Navi Protocol.

Key Features:

• Extensible Architecture: Allows for the addition of new tools and utilities.
• Custom Solutions: Enables the creation of custom solutions tailored to specific needs.
• Advanced Capabilities: Expands the capabilities of the Navi Protocol.

Core Components

The Sui Agent Kit comprises several key components that work together to provide a seamless DeFi development experience:

• MCP Server (navi-mcp-server/src/mcp_server/server.ts): Implements an MCP server using @modelcontextprotocol/sdk. It defines and registers all the tools available to interact with Navi.
• Navi SDK Integration (navi-mcp-server/src/core_navi/navi_client.ts): Manages the connection to the Navi SDK, including wallet initialization (via mnemonic or private key from .env).
• Configuration (navi-mcp-server/src/config.ts): Loads necessary environment variables (RPC URL, agent wallet credentials).
• Mappers (navi-mcp-server/src/mcp_server/mappers.ts): Handles conversions between human-readable asset symbols/amounts and the formats required by the Navi SDK.
• Tool-Based API: All interactions are exposed as MCP tools, making it easy for any MCP-compatible client (like an AI agent or the @modelcontextprotocol/inspector CLI) to use.

Key Features & Capabilities

The Sui Agent Kit empowers your applications and agents with a comprehensive set of features and capabilities:

Manage Agent Portfolio

• navi_getAgentPortfolio: Retrieve current supply and borrow balances.
• navi_getAgentHealthFactor: Check the agent’s health factor.
• navi_getAgentDynamicHealthFactor: Predict health factor after hypothetical supply/borrow changes.

Interact with Lending Pools

• navi_depositAsset: Deposit SUI, USDC, USDT, etc., as collateral.
• navi_withdrawAsset: Withdraw deposited assets.
• navi_borrowAsset: Borrow assets against collateral.
• navi_repayDebt: Repay borrowed amounts.

Execute Swaps (via NAVI Aggregator)

• navi_getSwapQuote: Get a quote for swapping one asset for another.
• navi_executeSwap: Execute the token swap.

Leverage Liquid Staking (vSUI)

• navi_stakeSuiForVSui: Stake SUI to receive vSUI (VoloSui).
• navi_unstakeVSuiForSui: Unstake vSUI to receive SUI back.

Handle Rewards

• navi_getAgentAvailableRewards: Check for unclaimed rewards.
• navi_claimAllAgentRewards: Claim all available rewards.
• navi_getAgentRewardsHistory: View history of claimed rewards.

Access Market Data

• navi_getPoolInfoBySymbol: Get details for a specific asset pool (e.g., SUI pool).
• navi_getAllPoolsInfo: Get details for all available asset pools.
• navi_getReserveDetail: Get in-depth information about a specific asset reserve.

Basic Server Ping

• ping: Check if the Sui Agent Kit server is responsive.

Integrating with UBOS: Unleash the Full Potential of AI Agents

While the Sui Agent Kit provides the foundational infrastructure for building DeFi agents on Sui, integrating it with a platform like UBOS unlocks its full potential. UBOS is a full-stack AI agent development platform designed to orchestrate, connect, and customize AI agents for various business departments.

How UBOS Enhances the Sui Agent Kit:

• Agent Orchestration: UBOS allows you to orchestrate multiple Sui Agent Kit instances, creating complex multi-agent systems that can execute sophisticated DeFi strategies.
• Enterprise Data Connectivity: UBOS enables you to connect the Sui Agent Kit to your enterprise data sources, providing agents with access to real-world information for better decision-making.
• Custom Agent Building: UBOS allows you to build custom AI agents using your own LLM models, tailoring the agents to your specific needs and use cases.
• Seamless Integration: UBOS provides a seamless integration experience, allowing you to easily deploy and manage Sui Agent Kit instances within your existing infrastructure.

By integrating the Sui Agent Kit with UBOS, you can create powerful AI agents that automate DeFi tasks, optimize investment strategies, and provide personalized financial advice. UBOS empowers you to leverage the full potential of AI agents in the world of decentralized finance.

Getting Started

To get started with the Sui Agent Kit, follow these steps:

Prerequisites

1. Node.js and npm: Ensure you have a recent version installed.

2. Sui Wallet: You’ll need a Sui wallet mnemonic or private key for the agent. This wallet will be used to sign transactions and interact with the Navi Protocol. Make sure it has SUI for gas fees and any assets you intend to use for testing (e.g., SUI for deposits).

3. Clone the Repository:

   bash git clone https://github.com/ParaDevsAI/Sui-Agent-Kit-Navi/ cd Sui-Agent-Kit-Navi

Setup & Configuration

1. Navigate to the Server Directory:

   bash cd navi-mcp-server

2. Install Dependencies:

   bash npm install

3. Configure Environment Variables:

   Create a .env file in the navi-mcp-server directory. You can copy ../.env.example (if you create one at the root) or create it from scratch:

   env

   Sui RPC URL - Mainnet, Testnet, or Devnet

   SUI_RPC_URL=https://fullnode.mainnet.sui.io:443

   Your Agent’s Wallet Mnemonic (recommended for ease of use)

   NAVI_AGENT_MNEMONIC=“your twelve or twenty-four word mnemonic phrase here”

   OR, if using a private key (Base64 encoded private key bytes - NOT the hex string)

   Ensure this is the private key for the account derived from the mnemonic if you used mnemonic first

   NAVI_AGENT_PRIVATE_KEY=“your_base64_encoded_private_key_bytes_here”

   Important:

   • Replace placeholders with your actual data.
   • If using NAVI_AGENT_PRIVATE_KEY, it MUST be the Base64 encoded bytes of the private key.
   • Never commit your .env file with real credentials to a public repository! The .gitignore file should already prevent this.

Build the Kit

From the navi-mcp-server directory:

bash npm run build

This compiles the TypeScript code into JavaScript in the dist directory.

Run the Sui Agent Kit Server

From the navi-mcp-server directory:

bash node dist/index.js

You should see log messages indicating the server has started and is connected to the Navi SDK. It’s now ready to accept MCP tool calls!

Contributing

The Sui Agent Kit is a community asset, and contributions are welcome! Whether it’s adding new tools, improving documentation, fixing bugs, or suggesting new features, please feel free to open an issue or submit a pull request.

Let’s build the future of decentralized finance on Sui, together!