← Back to Home

Base Nation

Automated Liquidity Manager (ALM) Whitepaper

1. Introduction to Base Nation

Base Nation is an open, decentralized Automated Liquidity Manager (ALM) built specifically for the Base network. Inspired by the necessity to streamline decentralized finance (DeFi), Base Nation natively leverages the advanced concentrated liquidity architecture of Aerodrome Slipstream. The platform's smart contracts and off-chain keeper network ensure a frictionless user experience, serving as an accessible gateway to advanced yield generation without the complexity traditionally associated with active liquidity management.

2. Our Mission

Concentrated liquidity provides incredible capital efficiency, but it requires constant, vigilant management to ensure positions do not fall "out of range." For the average retail user, monitoring tick boundaries and actively rebalancing positions is unrealistic. We are here to rewrite this narrative.

Our overarching mission is to empower everyone, everywhere. In just a few seamless interactions on Base Nation, users can effortlessly deposit WETH and USDC, delegating the complex, gas-intensive work of active liquidity rebalancing to our automated keeper network. By fostering universal accessibility and prioritizing simplified workflows, Base Nation aims to democratize access to institutional-grade DeFi yields.

3. Platform Architecture

The technical foundation of Base Nation emphasizes unmatched security, performance, and automation. The platform consists of two primary layers: the on-chain Smart Vault and the off-chain Rust Keeper Bot.

Aerodrome Slipstream Integration

At the core of Base Nation's yield optimization strategy is a deep integration with the Aerodrome Slipstream protocol. The Vault creates highly concentrated, ultra-narrow liquidity positions in Aerodrome pools to maximize trading fee capture per dollar deposited. Because these narrow ranges easily fall out of bounds during market movements, the architecture relies heavily on our keeper automation to shift the liquidity to the active price tick.

4. Vault Smart Contract Mechanics

Asset management is strictly governed by the proprietary Base Nation Vault Smart Contract (`BaseNationVault.sol`). This architecture guarantees that funds remain highly secure, adhering to programmatic, immutable rules.

Non-Custodial ERC721 Integration

Unlike traditional vaults that pool all user funds into a single contract-owned liquidity position (creating accounting complexities), the Base Nation Vault mints individual Aerodrome Slipstream NFTs directly to the user's wallet. The Vault acts as a highly optimized router and manager. The user retains sole ownership of their NFT position at all times, making the platform fully non-custodial.

Proportional Withdrawal Logic

When a user initiates a withdrawal, the Vault automatically burns the underlying Aerodrome NFT, harvests all accumulated trading fees, and returns the exact proportional share of WETH and USDC directly to the user's wallet. There are no exit fees, and the user's principal and rewards are immediately settled.

5. The Rust Keeper Network

To perpetually guarantee optimal capital efficiency, Base Nation operates an off-chain network of Keeper Bots written in Rust. These bots monitor the Aerodrome pool state block-by-block.

When the active market price moves outside of a user's concentrated liquidity bounds, the Keeper Bot detects the "out of range" status. It immediately triggers the `rebalance()` function on the Vault. The Vault then automatically withdraws the old liquidity, recalculates the current tick, and redeploys the assets into a new, perfectly centered narrow range. This automated shifting ensures that user liquidity is always actively earning fees, without any manual intervention from the user.

6. Security & Trust

Unwavering security is the cornerstone of the Base Nation philosophy. Comprehensive measures are implemented across the protocol stack to safeguard the community's assets, allowing users to invest with absolute peace of mind.

Security MechanismImplementation Details
Non-Custodial DesignThe operators have absolutely no access to user funds. NFT positions are minted directly to the depositor's wallet, ensuring that only the user can authorize withdrawals.
Permissionless RebalancingWhile the Rust Keeper Bot automates the process, the `rebalance()` function is entirely permissionless. In the event the official bot goes offline, any user or third party can call the function to re-center the liquidity.
Strict State ValidationThe Vault uses exact `msg.sender` validation and Aerodrome `NonfungiblePositionManager` verifications to ensure that only the rightful owner of a position can withdraw or modify it.