Nimble

Nimble Nimble is an AI‐agent‐based solver network that helps users get the best price for swaps and also supports deposits and withdrawals in Morpho vaults. The network is chain‐agnostic and has been demonstrated on Base for this project. The solver agents are built with Coinbase’s AgentKit, and the frontend is deployed on OpSec.

Table of Contents Overview Architecture High-Level Flow Swap Infrastructure Deposit and Withdraw Infrastructure Features Getting Started Prerequisites Installation Configuration Running Locally Usage Swapping Assets Depositing to Morpho Vaults Withdrawing from Morpho Vaults Deployment Project Status Contributing License

1. Overview Nimble orchestrates a network of AI solver agents to:

Find optimal swap routes for users across multiple liquidity pools and DEXes. Automate yield optimization for deposits and withdrawals in Morpho vaults. This project consists of:

Nimble Frontend – A user interface that interacts with the backends (Swap, Deposit, Withdraw). Swap Backend – Collects quotes from multiple solver agents and executes swaps at the best price. Deposit Backend – Finds the best vault for Morpho deposits, ensures optimal yields, and handles the deposit process. Withdraw Backend – Retrieves user funds from Morpho vaults, returning tokens seamlessly. 2. Architecture The Nimble architecture has three major components: Swap Infrastructure, Deposit Infrastructure, and Withdraw Infrastructure. These are orchestrated by the Nimble Frontend.

2.1 High-Level Flow User -> Nimble Frontend -> (Swap Backend | Deposit Backend | Withdraw Backend) -> User

User interacts with the Nimble Frontend. Frontend forwards requests to the appropriate backend. Backend leverages one or more solver agents (built with Coinbase’s AgentKit) to: Run an auction among solver agents. Retrieve best route (for swaps) or best vault (for deposits). Execute the transaction on-chain. Result is returned to the user (swapped assets or updated vault balance). ![High-Level Diagram] image

2.2 Swap Infrastructure The swap flow is:

User approves token spending to the Swap Contract. Solver Agents each propose a quote (e.g., price, route, etc.). Swap Contract runs an auction to pick the best solver agent. Winning Solver Agent executes the swap and sends funds back to the user. ![Swap Infrastructure] image

2.3 Deposit and Withdraw Infrastructure User gives approval to the Deposit Contract or Withdraw Contract. Solver Agents propose yields (for deposits) or methods (for withdrawals). Deposit or Withdraw Contract chooses the best agent based on yield or other optimization criteria. Winning Agent finalizes depositing or withdrawing on behalf of the user. ![Deposit/Withdraw Infrastructure] image

1. Features Multi-Chain Compatibility: Designed to work on any EVM-compatible chain. AgentKit Integration: Leverages Coinbase’s AgentKit to build AI-driven solver agents. Optimized Swaps: Runs an auction to always secure the best swap price. Morpho Vault Deposits/Withdrawals: Automates yield optimization by selecting the highest-yield vault at deposit time and the appropriate vault for withdrawal. End-to-End Operational: Deployed on Base for demonstration, with a functioning frontend on OpSec.
2. Getting Started 4.1 Prerequisites Node.js (v16+ recommended) Yarn or npm Git Coinbase or another Web3 wallet for testing on Base or other test networks. 4.2 Installation Clone this repository:

git clone https://github.com/purebl00d/nimble.git

Install dependencies:

cd nimble npm install

4.3 Configuration Copy .env.example to .env and fill in the required environment variables:

cp .env.example .env

CDP_API_KEY_NAME: Key name of the CDP API Key CDP_API_KEY_PRIVATE_KEY: CDP API KEY from coinbase developer kit. OPENAI_API_KEY: you OPEN AI API key for the models NETWORK_ID: for example base-mainnet 4.4 Running Locally Start the local dev server (frontend):

yarn start

This runs the Nimble frontend on http://localhost:5171.

Backends may each have separate start scripts (depending on how you organize your project):

Example yarn run swap-backend yarn run deposit-backend yarn run withdraw-backend

1. Usage 5.1 Swapping Assets On the Nimble Frontend, connect your wallet (MetaMask or similar). Navigate to the Swap tab. Select tokens to swap. Approve the contract for token spending (if prompted). Click Swap. Nimble runs an internal auction among solver agents (e.g., agent 1, agent 2, agent 3). The best quote is displayed, and the swap is executed. Receipt of transaction will show up once confirmed. 5.2 Depositing to Morpho Vaults Go to the Deposit section in the frontend. Approve the deposit contract (if needed). Enter the amount to deposit. Click Deposit. The deposit contract finds the best vault (via an auction among the solver agents). Your assets are deposited into the chosen vault for optimal yield. 5.3 Withdrawing from Morpho Vaults Navigate to the Withdraw section. Approve if required. Enter the amount (or select “withdraw all”). Click Withdraw. Nimble chooses the correct vault and handles the withdrawal on your behalf. Funds are returned to your wallet.
2. Deployment Frontend is deployed on OpSec. If you want to deploy your own instance, configure hosting and run:

npm run dev

Then upload the build artifacts to your hosting service of choice.

Smart Contracts are on Base (testnet or mainnet). You can adapt the deployment scripts to other EVM chains.

1. Project Status Alpha Release: The core functionality (swap, deposit, withdraw) is operational on Base for demonstration. Next Steps: Audit and security reviews. Expand solver agent strategies for even better yields and swap quotes. Expand to additional chains (e.g., Ethereum mainnet, Polygon, Arbitrum).

Nimble Nimble is an AI‐agent‐based solver network that helps users get the best price for swaps and also supports deposits and withdrawals in Morpho vaults. The network is chain‐agnostic and has been demonstrated on Base for this project. The solver agents are built with Coinbase’s AgentKit, and the frontend is deployed on OpSec.

Table of Contents Overview Architecture High-Level Flow Swap Infrastructure Deposit and Withdraw Infrastructure Features Getting Started Prerequisites Installation Configuration Running Locally Usage Swapping Assets Depositing to Morpho Vaults Withdrawing from Morpho Vaults Deployment Project Status Contributing License

1. Overview Nimble orchestrates a network of AI solver agents to:

Find optimal swap routes for users across multiple liquidity pools and DEXes. Automate yield optimization for deposits and withdrawals in Morpho vaults. This project consists of:

Nimble Frontend – A user interface that interacts with the backends (Swap, Deposit, Withdraw). Swap Backend – Collects quotes from multiple solver agents and executes swaps at the best price. Deposit Backend – Finds the best vault for Morpho deposits, ensures optimal yields, and handles the deposit process. Withdraw Backend – Retrieves user funds from Morpho vaults, returning tokens seamlessly. 2. Architecture The Nimble architecture has three major components: Swap Infrastructure, Deposit Infrastructure, and Withdraw Infrastructure. These are orchestrated by the Nimble Frontend.

2.1 High-Level Flow User -> Nimble Frontend -> (Swap Backend | Deposit Backend | Withdraw Backend) -> User

User interacts with the Nimble Frontend. Frontend forwards requests to the appropriate backend. Backend leverages one or more solver agents (built with Coinbase’s AgentKit) to: Run an auction among solver agents. Retrieve best route (for swaps) or best vault (for deposits). Execute the transaction on-chain. Result is returned to the user (swapped assets or updated vault balance). ![High-Level Diagram] image

2.2 Swap Infrastructure The swap flow is:

User approves token spending to the Swap Contract. Solver Agents each propose a quote (e.g., price, route, etc.). Swap Contract runs an auction to pick the best solver agent. Winning Solver Agent executes the swap and sends funds back to the user. ![Swap Infrastructure] image

2.3 Deposit and Withdraw Infrastructure User gives approval to the Deposit Contract or Withdraw Contract. Solver Agents propose yields (for deposits) or methods (for withdrawals). Deposit or Withdraw Contract chooses the best agent based on yield or other optimization criteria. Winning Agent finalizes depositing or withdrawing on behalf of the user. ![Deposit/Withdraw Infrastructure] image

1. Features Multi-Chain Compatibility: Designed to work on any EVM-compatible chain. AgentKit Integration: Leverages Coinbase’s AgentKit to build AI-driven solver agents. Optimized Swaps: Runs an auction to always secure the best swap price. Morpho Vault Deposits/Withdrawals: Automates yield optimization by selecting the highest-yield vault at deposit time and the appropriate vault for withdrawal. End-to-End Operational: Deployed on Base for demonstration, with a functioning frontend on OpSec.
2. Getting Started 4.1 Prerequisites Node.js (v16+ recommended) Yarn or npm Git Coinbase or another Web3 wallet for testing on Base or other test networks. 4.2 Installation Clone this repository:

git clone https://github.com/purebl00d/nimble.git

Install dependencies:

cd nimble npm install

4.3 Configuration Copy .env.example to .env and fill in the required environment variables:

cp .env.example .env

CDP_API_KEY_NAME: Key name of the CDP API Key CDP_API_KEY_PRIVATE_KEY: CDP API KEY from coinbase developer kit. OPENAI_API_KEY: you OPEN AI API key for the models NETWORK_ID: for example base-mainnet 4.4 Running Locally Start the local dev server (frontend):

yarn start

This runs the Nimble frontend on http://localhost:5171.

Backends may each have separate start scripts (depending on how you organize your project):

Example yarn run swap-backend yarn run deposit-backend yarn run withdraw-backend

1. Usage 5.1 Swapping Assets On the Nimble Frontend, connect your wallet (MetaMask or similar). Navigate to the Swap tab. Select tokens to swap. Approve the contract for token spending (if prompted). Click Swap. Nimble runs an internal auction among solver agents (e.g., agent 1, agent 2, agent 3). The best quote is displayed, and the swap is executed. Receipt of transaction will show up once confirmed. 5.2 Depositing to Morpho Vaults Go to the Deposit section in the frontend. Approve the deposit contract (if needed). Enter the amount to deposit. Click Deposit. The deposit contract finds the best vault (via an auction among the solver agents). Your assets are deposited into the chosen vault for optimal yield. 5.3 Withdrawing from Morpho Vaults Navigate to the Withdraw section. Approve if required. Enter the amount (or select “withdraw all”). Click Withdraw. Nimble chooses the correct vault and handles the withdrawal on your behalf. Funds are returned to your wallet.
2. Deployment Frontend is deployed on OpSec. If you want to deploy your own instance, configure hosting and run:

npm run dev

Then upload the build artifacts to your hosting service of choice.

Smart Contracts are on Base (testnet or mainnet). You can adapt the deployment scripts to other EVM chains.

1. Project Status Alpha Release: The core functionality (swap, deposit, withdraw) is operational on Base for demonstration. Next Steps: Audit and security reviews. Expand solver agent strategies for even better yields and swap quotes. Expand to additional chains (e.g., Ethereum mainnet, Polygon, Arbitrum).