Stability Pool / Emissions Controller by piesrtasty · Pull Request #134 · hai-on-op/core

piesrtasty · 2026-01-12T02:56:44Z

Summary

This PR adds the Stability Pool, Emissions Controller, and strategy-step framework.

At a high level, users can now deposit HAI into the Stability Pool and receive sHAI, the pool can participate in collateral auctions and route purchased collateral back into HAI through configurable onchain strategy pipelines, and

KITE emissions are distributed through a standalone controller with dynamic splits between stability-side rewards and minting-side rewards.

This gives the protocol a dedicated HAI backstop with configurable liquidation routing, instead of relying on a single hardcoded unwind path per collateral.

It also decouples emissions logic from the pool itself, which makes reward distribution easier to reason about and easier to evolve over time.

What’s included

Stability Pool

new StabilityPool ERC4626 vault for depositing HAI and minting sHAI
KITE reward accounting for stakers
auction-cover flow via coverAndRepayDebt
SAFEEngine / CoinJoin / CollateralJoin integration for handling internal/external coin flows
initial non-transferable sHAI lifecycle, with one-way transfer enablement once governance wants to cut emissions over

Emissions Controller

new EmissionsController contract to manage KITE emissions separately from the pool
configurable stability vs minting rewards split
split updates based on onchain price deviation / redemption price context
explicit tracking for minting-side rewards distribution
support for custom emission durations and extending emissions later

Strategy Steps

new pluggable strategy-step system for liquidation routes
onchain preview + minOut enforcement before execution
support for multi-step pipelines instead of one fixed swap path per collateral
initial strategy-step implementations for:
- Velodrome swap
- Velodrome CL swap
- Velodrome LP removal
- Velodrome LP remove + swap
- Curve swap
- Balancer swap
- Beefy vault withdrawal
- Yearn / ERC4626 vault withdrawal

Notes

This PR is a pretty large feature drop and touches:

vault/share accounting
emissions distribution
liquidation flows
strategy execution / preview logic
SAFEEngine accounting boundaries

Most of the work here is around making those pieces compose cleanly.

Testing

Covered with unit + E2E tests across:

Stability Pool
Emissions Controller
strategy steps / strategy pipelines
auction cover flows
emissions accrual / cutover behavior

forge test --match-path 'test/unit/stability-pool/*.t.sol' -vv
forge test --match-path 'test/unit/stability-pool/strategy-steps/*.t.sol' -vv
forge test --match-path 'test/unit/jobs/StabilityPool*.t.sol' -vv
forge test --match-path 'test/e2e/stability-pool/*' -vv

In Depth Guide: https://hackmd.io/@lets-get-hai/stability-pool-auditor-guide

Adds a new oracle relayer that allows reading from a CurveStableSwapNG pool. We will use the relayer to return a price of HAI / BOLD from the HAI / BOLD curve pool at https://www.curve.finance/dex/optimism/pools/factory-stable-ng-81 This feed will then be combined with the existing BOLD / USD Chainlink compatible Pyth feed to produce a HAI / USD price. The pool's `price_oracle(i)` returns an EMA, however because HAI has an external rate oracle configured for the pool, the redemption price, we need to adjust the raw value by the rate to get the actual HAI / BOLD exchange rate. Additional Changes - bumped `evm_version` to `shanghai` because needed the `PUSH0` opcode - updated fork block in end to end oracle tests and fixed broken beefy / yearn tests in that file

piesrtasty · 2026-03-03T21:05:40Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: da810f7c0e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

piesrtasty · 2026-03-03T22:30:40Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 45a3b1a442

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

piesrtasty · 2026-03-03T22:47:16Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 16ae80726f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

piesrtasty · 2026-03-04T03:05:10Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6ecd98880b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-03-04T04:49:24Z

Codex Review: Didn't find any major issues. You're on a roll.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…n can trade more than previewed.

…cade into deposit/withdraw failures while rewards are active.

…historical claims.

…im transfer success.

…ense/large routes

…n because it does not model reserve changes from remove+swap atomically.

piesrtasty · 2026-03-06T02:20:42Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1a8c119388

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

piesrtasty · 2026-03-06T02:39:08Z

@codex review

chatgpt-codex-connector · 2026-03-06T02:49:37Z

Codex Review: Didn't find any major issues. Breezy!

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

piesrtasty · 2026-03-06T03:27:44Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7814edc4e4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

piesrtasty · 2026-03-06T04:02:13Z

@codex review

chatgpt-codex-connector · 2026-03-06T04:13:23Z

Codex Review: Didn't find any major issues. 👍

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chore: repo cleanup (#142)

Feat: StakingManager cooldown

* chore: repo cleanup (#142) * Merge pull request #144 from hai-on-op/feat/staking-manager-cooldown Feat: StakingManager cooldown * feat: tenderly tooling * chore: formatting * Stability Pool Audit Fixes (#146) * fix: ECR-01S: Inexistent Sanitization of Input Addresses * fix: MHT-01S: Illegible Numeric Value Representation * fix: SPL-01S: Illegible Numeric Value Representations * fix: SPL-02S: Inexistent Sanitization of Input Addresses * fix: BVS-01M: Redundant Deadline Buffers * fix: BVS-03M: Insecure On-Chain Preview * fix: BVS-03M - scripts * fix: CSS-01M: Insecure On-Chain Preview * update: BVS-01M / CSS-01M - useOracleFloor config * fix: ECR-01M: Emission Rate Truncations * fix: ECR-02M: Uniform Deviation Direction * fix: EGN-01M: Inexistent Validation of Length * fix: MHT-01M: Insecure Negation of Signed Integers * fix: SPL-01M: First-Depositor Attack Susceptibility * fix: SPL-03M: Inexistent Validation of Step Sequence * fix: VCL-01M: Potentially Lingering Approval * fix: VCL-02M: Insecure On-Chain Preview * fix: VLP-01M: Redundant Deadline Buffer * fix: VLP-02M: Insecure On-Chain Preview * feat: remove instances of OZ Math * fix: VLR-01M: Redundant Deadline Buffer * fix: VLR-02M: Insecure Preview Assumption * fix: VLR-03M: Insecure On-Chain Preview * fix: VSS-01M: Redundant Deadline Buffers * fix: VSS-02M: Insecure On-Chain Preview * fix: BVS-01C: Function Selector Value Literal

…s-controller' into feat/stability-pool-and-emissions-controller # Conflicts: # script/tenderly/bootstrap-stability-pool.mjs # script/tenderly/stability-pool-config.mjs # script/tenderly/verify-stability-pool-manifest.mjs

piesrtasty added 4 commits August 19, 2025 22:38

haiVELO v2 Audit Fixes

d769fbc

Feat: veNFT Manager (#127)

59ef427

Non Migration Version of WrappedTokenV2

47f00b5

feat: base stability pool and emissions controller

d915111

wei3erHase reviewed Feb 3, 2026

View reviewed changes

Comment thread src/contracts/StabilityPool.sol Outdated

piesrtasty added 11 commits February 5, 2026 21:53

feat: wip

be74d43

Bump Package Version for ABI Export - 1.0.9

1bd0fea

feat: stability pool wip

b623613

feat: stability pool wip

de203e9

Curve Oracle Audit Updates

3a3fb23

feat: testing and core functionality

bb8bfae

feat: linting fixes

ad8f444

feat: handle sweeping stability fees into pool

848227f

feat: add jobs for 3 keeper methods

49c7a8e

feat: add suggestions from slither and aderyn static analyzers

da810f7

chatgpt-codex-connector Bot reviewed Mar 3, 2026

View reviewed changes

Comment thread src/contracts/stability-pool/StabilityPool.sol

Comment thread src/contracts/stability-pool/StabilityPool.sol Outdated

piesrtasty added 3 commits March 3, 2026 16:56

feat: support dynamic emissions controller duration and extension

60b6d43

feat: fix p1: Sync reward debt after claiming rewards

f09fe1d

feat: fix p1: Validate auction house before granting SAFE permissions

45a3b1a

chatgpt-codex-connector Bot reviewed Mar 3, 2026

View reviewed changes

Comment thread src/contracts/stability-pool/StabilityPool.sol Outdated

feat: fix p2: Update sweep cooldown only after a nonzero exit

16ae807

chatgpt-codex-connector Bot reviewed Mar 3, 2026

View reviewed changes

Comment thread src/contracts/stability-pool/StabilityPool.sol

feat: fix p1: Approve CoinJoin before exiting extra internal coin

6ecd988

chatgpt-codex-connector Bot reviewed Mar 4, 2026

View reviewed changes

Comment thread src/contracts/stability-pool/StabilityPool.sol Outdated

feat: fix p1: Track KITE inflows when no sHAI supply exists

cb52dae

piesrtasty added 7 commits March 5, 2026 13:34

feat: fix: p1: preview/execution amount mismatch in strategy executio…

8ee35b2

…n can trade more than previewed.

feat: fix p2: EmissionsController underfunding can DoS claims and cas…

1bec140

…cade into deposit/withdraw failures while rewards are active.

feat: fix p2: after cutover, KITE top-ups cannot restore underfunded …

3d97669

…historical claims.

feat: P2: (Liveness/design): withdraw/redeem is coupled to reward cla…

604e751

…im transfer success.

feat: P3: CL quoter has a hard step cap that can revert previews in d…

3a196d1

…ense/large routes

feat: P3: VeloLPRemoveAndSwapStep•preview() can diverge from executio…

2c35279

…n because it does not model reserve changes from remove+swap atomically.

feat: linting fixes

1a8c119

chatgpt-codex-connector Bot reviewed Mar 6, 2026

View reviewed changes

Comment thread src/contracts/stability-pool/EmissionsController.sol Outdated

feat: P1: Cap receiver handoff payout to available KITE

1e12380

piesrtasty added 2 commits March 5, 2026 22:10

feat: support min profit enforcement

e0c92ac

feat: ensure treasury can't lose with reward > profit

7814edc

chatgpt-codex-connector Bot reviewed Mar 6, 2026

View reviewed changes

Comment thread src/contracts/stability-pool/StabilityPool.sol Outdated

feat change to fund auction capped bid

4a8f789

piesrtasty added 8 commits March 5, 2026 23:24

Merge branch 'dev' into feat/stability-pool-and-emissions-controller

e1fa035

Merge pull request #143 from hai-on-op/dev

6f8682e

chore: repo cleanup (#142)

Merge pull request #145 from hai-on-op/dev

57c1b21

Feat: StakingManager cooldown

feat: merge main

81f979f

feat: tenderly tooling

6d15a5a

chore: formatting

7c9c1f3

piesrtasty merged commit 1f8c199 into dev Jun 19, 2026
1 of 2 checks passed

piesrtasty deleted the feat/stability-pool-and-emissions-controller branch June 19, 2026 02:28

Uh oh!

Conversation

piesrtasty commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What’s included

Stability Pool

Emissions Controller

Strategy Steps

Notes

Testing

Uh oh!

Uh oh!

piesrtasty commented Mar 3, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

piesrtasty commented Mar 3, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

piesrtasty commented Mar 3, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

piesrtasty commented Mar 4, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot commented Mar 4, 2026

Uh oh!

piesrtasty commented Mar 6, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

piesrtasty commented Mar 6, 2026

Uh oh!

chatgpt-codex-connector Bot commented Mar 6, 2026

Uh oh!

piesrtasty commented Mar 6, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

piesrtasty commented Mar 6, 2026

Uh oh!

chatgpt-codex-connector Bot commented Mar 6, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

piesrtasty commented Jan 12, 2026 •

edited

Loading