Whitepaper: Crypto Range Keeper
1. Introduction & Executive Summary
1.1. The Problem: The Complexity Barrier of Uniswap V3
Uniswap V3 revolutionized decentralized finance (DeFi) by introducing concentrated liquidity. By allowing liquidity providers (LPs) to allocate capital within specific price ranges, it unlocked capital efficiency orders of magnitude higher than traditional AMMs.
However, for everyday investors — whether crypto-native or transitioning from traditional finance (high-yield savings, bonds, equities) — managing Uniswap V3 manually presents significant operational friction:
- Constant Oversight: Crypto markets run 24/7. Prices rapidly drift outside chosen boundaries, halting yield generation entirely until manual intervention occurs.
- Complex Calculations: Determining optimal tick spacing, calculating position ratios, and accounting for network overhead require continuous technical analysis.
- Friction & Drag: Manually closing, rebalancing, and reopening positions incurs persistent performance drag through DEX slippage and transaction fees.
1.2. The Solution: Crypto Range Keeper
Crypto Range Keeper (cryptorangekeeper.com) was built to democratize institutional-grade concentrated liquidity management.
We abstracted the underlying mathematical and operational complexity directly into automated, non-custodial smart contracts. Through cryptorangekeeper.com, users can connect a Web3 wallet, deposit capital, and deploy an automated yield strategy in just two clicks — generating continuous fee yield that significantly outpaces traditional yield-bearing instruments.
The protocol actively manages automated vaults across top-tier Layer-2 networks:
- ETH / USDC (0.05% Fee Tier) on Arbitrum One
- ETH / USDC (0.30% Fee Tier) on Base
2. Core Strategy & System Mechanics
Crypto Range Keeper relies on a streamlined Single-Sided Range-Following strategy engineered for maximum capital efficiency, automated compounding, and zero-slippage rebalancing.
2.1. Dynamic Narrow Range (≤1.5%)
Rather than diluting capital across broad price channels, Crypto Range Keeper concentrates 100% of its vaults' assets within a tight price band (≤1.5%).
- This approach achieves massive capital concentration, maximizing the vault's share of pool trading fees per dollar deposited.
- Spacing parameters (e.g., 1.4%) are empirically optimized to balance maximum yield capture with realistic holding times inside the active tick range.
2.2. Automated Fee Compounding
Trading fees earned from Uniswap V3 swaps do not sit idle. During each rebalance, accumulated fees are automatically harvested and merged into the primary deposit.
- This unlocks the exponential power of compound interest (Auto-Compounding), driving net APY significantly higher than static LP positions over time.
2.3. Edge Fee Capture Mechanics
In Uniswap V3, capital productivity peaks near the boundaries of a concentrated range:
- 100% Asset Utilization: While neutral at the midpoint, a position shifts entirely into a single asset near its range boundary — maximizing liquidity density at the active market price.
- Arbitrage Flow Realization: As spot prices test range edges, high-frequency arbitrage bots execute large-volume swaps to align DEX prices with centralized exchanges (CEXs), driving rapid fee spikes precisely at those edge ticks.
The vault holds positions through these boundary transitions to capture peak fee volume before executing a rebalance.
2.4. Rebalance Mechanics (1-Hour Check & Single-Sided Deployment)
- 1-Hour Health Checks: The automated keeper node inspects price positions hourly, filtering out noise, transient wicks, and false breakouts.
- Zero-Slippage Rebalancing: If price closes outside the active range on the hour, the vault burns and collects the position. Crucially, the contract never executes market swaps on a DEX to rebalance inventory.
- Single-Sided Re-entry:
- Downside Exit (100% ETH held): The contract deploys a 100% single-sided ETH range with a ~0.05% offset above current spot price.
- Upside Exit (100% USDC held): The contract deploys a 100% single-sided USDC range with a ~0.05% offset below current spot price.
- Volatility Check (ATR-Based Rebalance Skip): Before executing a rebalance, the keeper compares the most recent hourly price move against the pool's own recent volatility (a simplified Average True Range computed from the bot's locally logged price history). If the current move significantly exceeds typical recent volatility, the rebalance is skipped for that hour — repositioning into a still-moving market tends to produce a range the price immediately exits again, at the cost of gas and slippage for negligible fee capture. The position simply holds as-is until the next hourly check.
3. Architecture & Security (The KISS Framework)
Crypto Range Keeper follows the KISS principle (Keep It Simple, Stupid). We purposefully eschewed off-chain databases, centralized user tracking, and complex middleware in favor of a 100% On-Chain Architecture.
[ User Interface ]
│
├─── (Web App / Arbiscan / BaseScan)
▼
[ Vault Smart Contract ] ◄─── (Hourly Keepers) ─── [ Lightweight Keeper Node ]
(Arbitrum / Base) (Independent VPS)
3.1. Core Components
- Frontend: A lightweight web interface running client-side. It functions purely to display real-time chain state and formulate transactions for Web3 wallets (MetaMask, Rabby, Coinbase Wallet).
- Vault Smart Contracts: The single source of truth. Contracts manage asset custody, collect Uniswap V3 fees, account for user shares, and handle withdrawals entirely on-chain.
- Keeper Automation: A lightweight node hosted on an independent VPS. Every hour, it triggers public view/execution methods on the vault contract to check ranges and execute rebalances when necessary.
3.2. Complete On-Chain Autonomy
The system operates without SQL databases, central servers, or proprietary analytics backends:
- On-Chain Accounting: Public view functions calculate user balances, harvested fees, and performance metrics directly from live state variables.
- Censorship Resistance: Should cryptorangekeeper.com ever go offline, user capital remains completely safe and accessible. Anyone can interact directly with the verified contracts on Arbiscan or BaseScan to withdraw 100% of their deposit and earned fees at any time, subject to a brief per-address cooldown of up to 1 hour between withdrawals (a deliberate protection against griefing-style attacks on the pool's liquidity, not a restriction on legitimate withdrawals).
3.3. Gas Efficiency
By eliminating DEX swap calls from within smart contract logic and leveraging Layer-2 execution, keeper transactions consume minimal gas (typically pennies on Arbitrum and Base). This ensures frictionless automation without fee erosion.
4. Fee Structure & Economics
We operate under a simple aligned-incentives model: the protocol only earns when depositors earn.
4.1. Transparent Fees
- 0% Deposit / Withdrawal Fees: Entering and exiting vaults carries no protocol surcharge (users pay standard L2 network gas).
- Performance Fee: A small, flat percentage is deducted exclusively from actual realized Uniswap V3 trading fees during harvest and rebalance events.
4.2. Low Barriers to Entry
L2 gas efficiency allows users to deploy small capital allocations ($10–$100+) productively, without yields getting wiped out by onboarding costs.
Note: the vault contract itself also enforces a small minimum deposit — this exists as protection against Sybil-style griefing attacks on the pool, not as a meaningful floor for genuine investors.
5. Risk Disclosure
Deploying capital into decentralized markets carries inherent risks. Crypto Range Keeper maintains full transparency regarding protocol trade-offs:
5.1. Spot Price Exposure
Vault strategies do not hedge underlying asset prices. During market downturns, vault inventory shifts to 100% ETH. Consequently, the USD-denominated value of your deposit will fluctuate alongside spot market prices — similar to holding ETH spot. However, accumulated LP fees help buffer net downside compared to passive holding.
5.2. Upside Realization Risk
During rapid rallies, vault inventory shifts to 100% USDC. While this locks in USD profits, continued parabolic price action means your net performance in USD may lag behind simply holding spot ETH (HODL).
5.3. Smart Contract Risk
While our contracts prioritize minimal surface area and battle-tested patterns, all smart contract interactions carry inherent technology risks.
6. Roadmap & Pragmatic Scaling
We prioritize lean execution and proven market fit over speculative, bloated roadmaps.
6.1. Current Status
- Live vaults operating on primary Layer-2 networks:
- ETH / USDC (0.05% Fee Tier) on Arbitrum One
- ETH / USDC (0.30% Fee Tier) on Base
- Smart contract source code is Source Code Verified (Exact Match) on Arbiscan and BaseScan.
6.2. Frictionless Monitoring (KISS Analytics)
Rather than building redundant internal analytics tools, we leverage established ecosystem infrastructure:
- Direct integration links to independent portfolio trackers (e.g., DeBank, Report.finance) on the web app — planned, not yet live.
- Regular performance reports and yield stats published across official community channels.
6.3. Market-Driven Agility
Arbitrum and Base currently host the deepest L2 DEX liquidity. Rather than spreading liquidity thin across dozens of chains, we maintain an agile, modular infrastructure:
- Rapid Deployment Capability: Our lightweight codebase allows us to deploy new vault strategies and list them on the interface within hours whenever high-conviction liquidity opportunities emerge.
Conclusion
Crypto Range Keeper (cryptorangekeeper.com) streamlines Uniswap V3 concentrated liquidity into an automated, transparent, and resilient yield engine.
By pairing narrow single-sided ranges, zero-slippage rebalancing, automated fee compounding, and uncompromising on-chain autonomy, the protocol offers a robust gateway to Web3 yield for investors at any level.