No description
777bec8563
Extend the patch to also replace the NatSpec comments above MAX_ANCHOR_WIDTH,
which became misleading after switching to type(uint24).max. The old comments
claimed overflow-safety ("fits in int24"); the new comments document that the
production cap is 1233, that values above 123358 overflow int24 and revert,
and that this is tolerable in the evolution context where reverts score zero
fitness. The patch now correctly updates both the constant and its documentation.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
||
|---|---|---|
| .claude | ||
| .codeberg/ISSUE_TEMPLATE | ||
| .husky | ||
| .woodpecker | ||
| containers | ||
| docker | ||
| docs | ||
| kraiken-lib | ||
| landing | ||
| onchain | ||
| packages | ||
| scripts | ||
| services | ||
| tests | ||
| tools | ||
| web-app | ||
| .claude-code-supervisor.yml | ||
| .dockerignore | ||
| .gitignore | ||
| .gitmodules | ||
| .lintstagedrc.json | ||
| AGENTS.md | ||
| docker-compose.yml | ||
| eslint.config.js | ||
| HARBERG.md | ||
| IMPLEMENTATION_SUMMARY.md | ||
| package-lock.json | ||
| package.json | ||
| playwright.config.ts | ||
| README.md | ||
| STATE.md | ||
| TECHNICAL_APPENDIX.md | ||
| USERTEST-REPORT-V2.md | ||
| VERSION_VALIDATION.md | ||
KRAIKEN
The fairest ponzi in the world.
KRAIKEN is a DeFi protocol that couples Harberger-tax staking with a dominant Uniswap V3 liquidity manager. The result: asymmetric slippage, sentiment-driven pricing, and VWAP-based price memory that protects the protocol from exploitation.
Deployed on Base.
The Three Stages
- Harberger — A staking market balanced by the Harberger tax. Complete.
- KRAIKEN — Token issuance governed by an automated liquidity manager. Current stage.
- SoverAIgns — The liquidity manager augmented by AI for outlandish performance. Future.
How It Works
Three-Position Liquidity Strategy
The LiquidityManager maintains three Uniswap V3 positions simultaneously:
- Anchor — Shallow liquidity near the current price. Fast price discovery, high slippage for attackers.
- Discovery — Medium liquidity bordering the anchor. The fee capture zone.
- Floor — Deep liquidity at VWAP-adjusted distance. Price memory that protects against whale dumps.
Any round-trip trade (buy → recenter → sell) pays disproportionate slippage costs twice, making manipulation unprofitable.
Harberger Tax Sentiment Oracle
Stakers self-assess tax rates on their positions. Higher tax = higher confidence. Positions can be snatched by anyone willing to pay more. This creates a continuous prediction market for token sentiment.
OptimizerV3
Reads staking data (% staked, average tax rate) and outputs a binary bear/bull configuration:
- Bear (~94% of state space): AS=30%, AW=100, CI=0, DD=0.3e18 — protective
- Bull (>91% staked, low tax): AS=100%, AW=20, CI=0, DD=1e18 — aggressive fee capture
The binary step avoids the AW 40-80 kill zone where intermediate parameters are exploitable.
VWAP Floor Defense
The floor position uses volume-weighted average price with directional recording (buys only). During sell pressure, the VWAP-to-price distance grows, making the floor resist walkdown. This gives the protocol "eternal memory" against dormant whale attacks.
Tech Stack
| Component | Technology | Location |
|---|---|---|
| Smart Contracts | Solidity, Foundry | onchain/ |
| Indexer | Ponder (TypeScript) | services/ponder/ |
| Staking App | Vue 3, Vite, Wagmi | web-app/ |
| Landing Page | Vue 3, Vite | landing/ |
| Automation Bot | Node.js, Express | services/txnBot/ |
| Shared Library | TypeScript | kraiken-lib/ |
| Block Explorer | Otterscan | Docker service |
| Reverse Proxy | Caddy | Docker service |
Repository Structure
harb/
├── onchain/ # Solidity contracts, tests, deployment scripts, analysis
│ ├── src/ # Core: Kraiken, Stake, LiquidityManager, OptimizerV3
│ ├── test/ # Foundry test suite
│ ├── script/ # Deployment scripts
│ └── analysis/ # Fuzzing, parameter sweeps, security review
├── services/
│ ├── ponder/ # Blockchain indexer → GraphQL API
│ └── txnBot/ # recenter() + payTax() automation
├── web-app/ # Staking dashboard (Vue 3)
├── landing/ # Marketing site (Vue 3)
├── kraiken-lib/ # Shared TypeScript helpers and ABIs
├── tests/e2e/ # Playwright end-to-end tests
├── scripts/ # Dev environment, CI bootstrap, utilities
├── docker/ # CI Dockerfiles
├── containers/ # Entrypoints, Caddyfile
└── docs/ # Deployment runbook, Docker guide
Quick Start
# Prerequisites: Docker Engine (Linux) or Colima (Mac)
# See docs/docker.md for installation
nohup ./scripts/dev.sh start & # Start full stack (~3-6 min first time)
tail -f nohup.out # Watch progress
./scripts/dev.sh health # Verify all services healthy
Access points (via Caddy on port 8081):
- Landing: http://localhost:8081/
- Staking app: http://localhost:8081/app/
- GraphQL: http://localhost:8081/api/graphql
Contracts (Base Mainnet)
| Contract | Address |
|---|---|
| Kraiken | 0x45caa5929f6ee038039984205bdecf968b954820 |
| Stake | 0xed70707fab05d973ad41eae8d17e2bcd36192cfc |
| LiquidityManager | 0x7fd4e645ce258dd3942eddbeb2f99137da8ba13b |
Documentation
- AGENTS.md — Development guide and operational reference
- TECHNICAL_APPENDIX.md — Deep technical analysis of protocol mechanics
- docs/DEPLOYMENT_RUNBOOK.md — Production deployment guide
- onchain/UNISWAP_V3_MATH.md — Uniswap V3 math reference
- onchain/analysis/SECURITY_REVIEW.md — Security analysis and fuzzing results
License
GPL-3.0-or-later