No description
0cb2e7ba07
Fixes #618 ## Changes Add stack depth validation in processExecIf() so asymmetric EXEC.IF branches (where one branch pushes more values than the other) throw an explicit error instead of silently padding with '0'. Error messages identify both branch depths for DYADIC and BOOLEAN stacks. Removed dead-code '0'/'false' fallbacks in buildAssignments and reconstruction. Updated existing unbalanced-branch tests to expect errors; added regression tests for error message content and BOOLEAN mismatch. All existing seed files (optimizer_v3.push3, optimizer_seed.push3) continue to transpile. Co-authored-by: openhands <openhands@all-hands.dev> Reviewed-on: https://codeberg.org/johba/harb/pulls/1033 Reviewed-by: Disinto_bot <disinto_bot@noreply.codeberg.org> |
||
|---|---|---|
| .claude | ||
| .codeberg/ISSUE_TEMPLATE | ||
| .husky | ||
| .woodpecker | ||
| containers | ||
| docker | ||
| docs | ||
| evidence | ||
| formulas | ||
| 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 | ||
| VISION.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