UniswapPoolProcessor - Multi-Chain Uniswap V4 Liquidity Manager & Auto-Rebalancing Bot

UniswapPoolProcessor is a multi-chain liquidity management and auto-rebalancing bot designed for concentrated liquidity pools on Uniswap V4. It automates position creation, monitoring, closing, and rebalancing while providing configurable controls for liquidity ranges, token allocation, swaps, gas costs, slippage, and transaction risk.

The product includes both a ready-to-use Windows application and the complete Go source code, allowing you to review, modify, rebuild, and extend the software for your own requirements.

What UniswapPoolProcessor Does

The application connects to a blockchain network through your RPC endpoint, reads the current state of a Uniswap V4 pool, calculates an appropriate liquidity range, and creates a concentrated-liquidity position through Uniswap V4 PositionManager.

After creating the position, the bot continuously monitors it. When the configured time interval, price movement, or range-exit condition is reached, it can close the existing position and create a new position using an updated liquidity range.

Every liquidity position is represented by a PositionManager NFT with its own token ID. Information about managed positions is stored in a local SQLite database.

Main Features

• Automated Uniswap V4 liquidity management - creates, monitors, closes, and reopens concentrated-liquidity positions.
• Multi-chain support - manage strategies across several supported EVM-compatible networks.
• Multiple concurrent strategies - run several independent pool strategies at the same time.
• Time-based rebalancing - rebalance positions at a configurable time interval.
• Price-based rebalancing - rebalance after a configured price movement or when the price exits the active liquidity range.
• Manual and automatic range calculation - define your own range or let the application calculate one automatically.
• Automatic token ratio calculation - calculates the required token0/token1 ratio for the selected price range.
• Wallet balance allocation - use fixed token amounts or a configurable percentage of the available wallet balance.
• Automatic swap support - exchanges part of one token when the wallet does not have enough of the other token.
• Configurable slippage protection - minimum received amounts are calculated before swap and liquidity removal operations.
• Gas controls - configure maximum gas price, gas limit, priority fee, and transaction deadlines.
• MEV-risk detection - performs additional heuristic checks before blockchain transactions.
• Bounded token approvals - ERC-20 and Permit2 approvals are created for required amounts with limited Permit2 expiration periods.
• Local position database - stores managed position data in SQLite.
• Rotating application logs - writes detailed operational information to local log files with automatic rotation.
• Graceful shutdown - safely stops active strategies when receiving Ctrl+C or a termination signal.

Automatic Liquidity Range Strategies

UniswapPoolProcessor can calculate liquidity ranges using historical prices, volatility, volatility clustering, and available liquidity depth.

The following automatic range profiles are available:

• Aggressive - narrow ranges designed for higher capital concentration and more frequent management.
• Balanced - a compromise between capital efficiency and range width.
• Conservative - wider ranges intended to reduce the frequency of range exits.
• Ultra-Conservative - the widest automatic range profile.

You can also specify a symmetric percentage range or configure separate lower and upper price boundaries manually.

Rebalancing Modes

Time-Based Mode

The bot checks and rebalances the position after a configurable number of minutes. This mode is suitable when you want position updates to follow a fixed schedule.

Price-Based Mode

The bot checks the price at a configurable interval and can rebalance when:

• the market price exits the active liquidity range; or
• the configured price-change threshold is reached.

When automatic range selection is enabled, the application can also calculate the price-change threshold automatically.

Token and Balance Management

• Configure token amounts in human-readable units instead of wei.
• Set only one token amount and allow the application to calculate the required second token amount.
• Allocate a configurable percentage of the current wallet balance to a strategy.
• Configure token balance buffers to account for price changes and rounding.
• Reduce calculated liquidity by a chosen percentage to keep a reserve in the wallet.

Automatic Swap Integration

If the wallet does not have enough of one token, UniswapPoolProcessor can calculate and perform a swap through Uniswap Universal Router using Permit2.

Before submitting a swap, the application can:

• calculate the required input amount;
• request a quote through Uniswap V4 Quoter;
• calculate the minimum acceptable output amount;
• apply the configured slippage tolerance;
• check gas parameters and expected losses;
• create a deadline using a recent block timestamp;
• submit the transaction and wait for confirmation.

Important: the current automatic swap implementation is intended primarily for pools where token0 is the network's native currency, such as ETH/USDC. For ERC-20/ERC-20 pools, a manual wallet balance top-up may be required when one token is missing.

MEV and Transaction Risk Checks

The built-in MEV-risk module performs configurable heuristic checks before selected operations. Individual checks can generate a warning or stop the transaction.

Available checks include:

• excessive transaction deadlines;
• excessive configured slippage;
• sudden quote changes between consecutive requests;
• unusual gas estimates compared with recent blocks;
• unsafe or excessively small minimum output values;
• large swap events detected in recent blocks;
• sudden token0/token1 ratio changes;
• liquidity addition and removal deadline checks;
• detection of Hooks associated with the pool.

These checks can help identify certain risks, but they are not a private relay and cannot guarantee protection against front-running, sandwich attacks, or other forms of MEV.

Supported Networks

The software contains profiles for the following networks:

• Ethereum
• Unichain
• Optimism
• Base
• Arbitrum
• Polygon
• Blast
• Zora
• Ink
• Avalanche
• BNB Chain
• Local Hardhat development network

Network availability depends on valid RPC endpoints and current contract addresses. The user must verify PoolManager, PositionManager, StateView, Universal Router, Permit2, and Quoter addresses for the selected network.

Key Advantages

• Saves operational time by automating repetitive liquidity position management.
• Flexible strategy configuration for different pools, networks, price ranges, and risk preferences.
• Concurrent strategy execution allows several pools to be managed from one application.
• Full local control - configuration, logs, and the position database remain on your system.
• No black-box dependency - the complete source code is included and can be independently reviewed.
• Customizable architecture - developers can modify the strategy logic, network profiles, risk checks, logging, or integrations.
• Transparent configuration through a readable YAML file.
• Detailed logging simplifies monitoring, diagnostics, and strategy analysis.
• Built in Go for efficient concurrent operation and straightforward deployment.

What You Receive

• Complete UniswapPoolProcessor source code written in Go
• Prebuilt Windows executable
• Editable config.yaml configuration file
• Windows startup script
• Required project files and Go dependency definitions
• Local database and logging directory structure
• English user guide
• Russian user guide

The included source code allows you to inspect how the application works, build your own executable, customize its behavior, and integrate additional functionality.

System and Usage Requirements

• Windows is recommended for using the included executable.
• Go 1.27 and a compatible C compiler are required when building from source because the SQLite dependency uses CGO.
• A valid RPC endpoint for each selected blockchain network is required.
• A dedicated wallet funded with pool tokens and the network's native currency for gas fees is required.
• The user must provide and verify the correct Uniswap V4 contract addresses and Pool ID.
• Previous experience with Uniswap V4, concentrated liquidity, wallet security, gas fees, slippage, and impermanent loss is strongly recommended.

Who This Product Is For

• Uniswap V4 liquidity providers
• DeFi users managing concentrated-liquidity positions
• Developers building custom Uniswap V4 automation
• Researchers studying automated LP management strategies
• Advanced users who need configurable multi-chain LP tooling

Security Recommendations

• Always use a dedicated wallet for the application.
• Start with small token amounts when testing a new configuration.
• Never publish or share your private key or configured YAML file.
• Verify every contract address using official network sources.
• Keep enough native currency available for gas fees.
• Regularly review and revoke token approvals that are no longer needed.
• Back up the local position database before updating the application.

Important Notice

UniswapPoolProcessor is a technical automation tool and does not provide financial or investment advice. Blockchain transactions are irreversible, and profitability is not guaranteed.

Liquidity provision involves risks including impermanent loss, market price movement, slippage, failed transactions, smart-contract risks, MEV, high gas fees, and loss of transaction fees. The buyer is solely responsible for software configuration, wallet and private-key security, pool selection, submitted transactions, and any resulting financial loss.

This is an independent software product and is not an official product of Uniswap Labs.