johba/harb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request 'chore: gardener housekeeping 2026-03-23' (#1135) from chore/gardener-20260323-0704 into master

Browse source
This commit is contained in:
johba 2026-03-23 08:16:03 +01:00
commit 144d6a2f7f
9 changed files with 14 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

2
AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: Harb Stack
## What is KRAIKEN?

2
formulas/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 6b9dad5 -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: Formulas
Formulas are TOML files that declare automated pipeline jobs for the harb evaluator.

2
kraiken-lib/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Kraiken Library - Agent Guide
Shared TypeScript helpers used by the landing app, txnBot, and other services to talk to KRAIKEN contracts and the Ponder GraphQL API.

3
landing/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Landing Interface - Agent Guide
Vue 3 + Vite application that delivers the public marketing site and forthcoming staking UI.
@ -14,6 +14,7 @@ Vue 3 + Vite application that delivers the public marketing site and forthcoming
## Key Views & Components
- `HomeView.vue` - Launch countdown, feature overview, and staking CTA
- `DocsView.vue` - Documentation portal with responsive navigation and generated table of contents
- `SecurityInfo.vue` - Displays unaudited badge (planned Q3 2026), KRAIKEN Token and Stake contract addresses with copy-to-clipboard, BaseScan and source links (#147)
- Layout components (`KNavbar.vue`, `KFooter.vue`, `LeftRightComponent.vue`) manage shared chrome
- UI components (`KButton.vue`, `Countdown.vue`, `SocialButton.vue`, icon set) supply reusable primitives

7
onchain/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: Kraiken Protocol
## Protocol Philosophy & Business Logic
@ -43,7 +43,7 @@ The staking system traces a triangle in (staking%, avgTax) space:
## System Snapshot
- Kraiken ERC20 with mint/burn via LiquidityManager. VERSION=2.
- LiquidityManager.sol: ANCHOR + DISCOVERY + FLOOR positions with asymmetric slippage.
- VWAPTracker.sol: squared price in X96, compression, directional recording (price-fall / ETH-outflow events only — buy-only cycles must NOT update VWAP or the floor tracks the inflated price, crystallising IL; see issue #543).
- VWAPTracker.sol: squared price in X96, compression, directional recording (price-fall / ETH-outflow events only — buy-only cycles must NOT update VWAP or the floor tracks the inflated price, crystallising IL; see issue #543). Uses `_hasRecenterTick` boolean guard to decouple bootstrap detection from VWAP recording — prevents tick-0 ambiguity when `lastRecenterTick==0` after bootstrap (#609).
- OptimizerV3.sol: UUPS upgradeable, direct 2D binary mapping.
- Stake.sol: self-assessed tax, snatching auctions, discrete brackets, UBI redistribution.
@ -71,3 +71,6 @@ The staking system traces a triangle in (staking%, avgTax) space:
- Outstanding supply excludes LM position balances and KRK held by `feeDestination` (only when `feeDestination != address(0) && feeDestination != address(this)`) and `stakingPool` (only when `stakingPoolAddr != address(0) && stakingPoolAddr != feeDestination`).
- `recenterAccess` is removed — `recenter()` always enforces cooldown and TWAP stability. No bypass path exists.
- `feeDestinationLocked` prevents CREATE2 bypass: once `feeDestination` is set to a contract address, it cannot be changed. `setFeeDestination` checks `.code.length > 0` to detect contract addresses.
- Optimizer input slots 0-7 all require `<= 1e18` — the overflow guard previously only applied to slot 0 (`percentageStaked`); slots 1-7 (including `averageTaxRate`) are now also validated (#997).
- Floor Ratchet attack (buy→stake→recenter oscillation) is defeated — evidence in `evidence/red-team/2026-03-22-floor-ratchet-oscillation.json` shows floor holds under 2000-trade oscillation (#1067).
- Fee-income delta_bps calculation is documented in `evidence/README.md`; `LmTotalEth.s.sol` now captures the auditable snapshot methodology (#1084).

2
scripts/harb-evaluator/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 6b9dad5 -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Agent Brief: harb-evaluator
The evaluator runtime executes formula-defined pipelines. Scripts in this

2
services/ponder/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Ponder Indexer - Agent Guide
Ponder-based indexer that records Kraiken protocol activity and exposes the GraphQL API consumed by the app and automation bot.

2
services/txnBot/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Transaction Bot - Agent Guide
Automation service that maintains liquidity alignment and tax enforcement for the KRAIKEN protocol.

2
web-app/AGENTS.md
View file

@ -1,4 +1,4 @@
<!-- last-reviewed: 5f01d55cc7ce0f3499967536971878ef968d59ba -->
<!-- last-reviewed: 224edcc6d3a61aa5a61b2816061f253584791cfd -->
# Web App - Agent Guide
Vue 3 + TypeScript staking interface for KRAIKEN, enabling users to stake tokens, manage positions, and interact with Harberger-tax mechanics.