A full liquidate() bad-debt write-off can drive totalAssets() to exactly zero while totalLenderShares() stays nonzero (the wiped-out lender never called withdraw()). deposit()'s exchange-rate formula divided by that zero assetsBefore and reverted with a bare Panic(0x12) on every future deposit forever -- a real, permanent DoS on new lending liquidity. Confirmed live via git stash against the pre-fix bytecode before writing the fix. Added an epoch-stamped lender share balance: deposit() now detects this exact state (totalLenderShares > 0, assetsBefore == 0), bumps a new lenderEpoch, resets totalLenderShares, and mints the next depositor fresh 1:1 shares. The epoch stamp (not a bare reset) is what keeps this safe -- every prior stale holder's effective lenderShares() reads zero against the new epoch, so they can never dilute or later drain a fresh depositor's money once the pool has real value in it again. Verified two ways: a new Foundry regression test reproducing the exact wipeout-then-deposit sequence (64 -> 65/65 pass), and live against a fresh throwaway vault deployed on the persistent self-hosted demo chain (http://130.61.180.42:8647) -- real deposit() succeeded post-wipeout, the stale lender's lenderShares() read 0, and their own withdraw(1) reverted InsufficientShares. The public demo's own vault was untouched (its 0% APR position never reaches this state). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@qie-forge/contracts
Foundry package for QIE Forge's Solidity contracts: QieForgeFactory/
QieForgePair/QieForgeRouter (clean-room constant-product AMM) and
QieForgeVault (overcollateralized lending), plus QieOracleAdapter
(normalizes QIE's real Chainlink-shaped oracle aggregators). See the repo
root README.md, docs/STATUS.md, and plans/qie-hackathon.md for the
full product/research story — this file only covers building, testing, and
deploying this package.
Build & test
forge build
forge test # 44/44 as of 2026-10-29 — AMM invariants, LP math, fee
# accrual, TWAP, router multi-hop, oracle staleness,
# vault LTV/health-factor/interest/liquidation
Deploy
Deployment is split into two scripts, run in order, because the AMM core has no asset-specific state but the vault does:
-
script/Deploy.s.sol— deploysQieForgeFactory,QieForgeRouter, and a bareQieOracleAdapter. No real asset addresses needed.DEPLOYER_PRIVATE_KEY=0x... \ forge script script/Deploy.s.sol:Deploy \ --rpc-url qie_mainnet --broadcast --private-key $DEPLOYER_PRIVATE_KEY -
script/DeployVault.s.sol— deploysQieForgeVaultagainst the oracle adapter from step 1 and real collateral/borrow asset addresses. Fails closed (reverts with a named error) if any required address is unset — it will not deploy against a guessed address.DEPLOYER_PRIVATE_KEY=0x... \ QIE_FORGE_ORACLE_ADAPTER_ADDRESS=0x... \ QIE_FORGE_VAULT_COLLATERAL_ADDRESS=0x... \ QIE_FORGE_VAULT_BORROW_ADDRESS=0x... \ forge script script/DeployVault.s.sol:DeployVault \ --rpc-url qie_mainnet --broadcast --private-key $DEPLOYER_PRIVATE_KEYAfter this, call
QieOracleAdapter.setFeed(asset, aggregator)for both the collateral and borrow assets using QIE's real deployed oracle aggregator addresses (seepackages/core/src/oracle.ts) — the vault revertsNoFeedConfiguredonborrow()/healthFactor()/liquidate()until both feeds exist.
[rpc_endpoints] in foundry.toml already has qie_testnet and
qie_mainnet wired to the real, verified RPC URLs (see docs/STATUS.md
for how the previously-documented testnet RPC was found dead and replaced).
Dry run before spending real gas
Both scripts above were verified end-to-end (2026-10-29) against a real local fork of live QIE Mainnet — no real funds, no real risk, same exact bytecode path:
anvil --fork-url https://rpc1mainnet.qie.digital
# in another shell, using anvil's funded default test account:
DEPLOYER_PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 \
forge script script/Deploy.s.sol:Deploy --rpc-url http://127.0.0.1:8545 --broadcast
See docs/STATUS.md for the full transcript (real addresses, real block
numbers) and script/DeployVault.s.sol's doc comment for the equivalent
vault dry-run command.
Demo deployment (not Testnet/Mainnet)
script/DeployDemo.s.sol deploys the full stack plus two mock ERC-20s to
a disposable anvil devnet and seeds real liquidity + a real open vault
position — this is what the live frontend's /swap and /vault point at
by default so they never show an empty state. It is explicitly labeled
demo everywhere (NEXT_PUBLIC_QIE_FORGE_NETWORK=demo) and is not a
Testnet or Mainnet deployment.
License
MIT.