caelum0x 1fa82f19ea feat: close Python/Rust VaultClient pool-stats parity gap, fix stale anvil-deploy tests
@qie-forge/core's TS VaultClient already exposed getLiquidationBonusBps/
getLenderShares/getPoolStats (totalAssets/totalReserves/protocolReserves/
totalDebtPrincipal/borrowCap/reserveFactorBps/totalLenderShares/
lenderShares) — Python's and Rust's VaultClient never did, a real
cross-language parity gap flagged but deliberately left open by the
previous pass. Ported the same methods to packages/python/qie_forge/
vault.py and packages/rust/src/vault.rs.

While wiring these up, found both SDKs' own "proven against real
deployed bytecode" integration tests (tests/test_anvil_integration.py,
tests/anvil_integration.rs) had been silently broken since an earlier
same-day pass grew QieForgeVault's constructor from 7 to 11 args
(liquidationBonusMaxBps/treasury/reserveFactorBps/borrowCap) without
updating either test's deploy call — confirmed via a pre-fix run
(Python: `TypeError: Incorrect argument count`, Rust:
`DecodingError(InvalidData)`). Fixed both deploy calls and extended
both tests to assert the new pool-stats/liquidation-bonus fields
against real on-chain state.

Verified live: Rust `cargo test --test anvil_integration` 2/2 pass
against real deployed bytecode on a local anvil devnet; Python
`pytest` 15 passed/8 skipped (skips are live-network tests gated
behind QIE_FORGE_RUN_LIVE_TESTS). Rust `cargo build`/`cargo clippy`
clean, no new warnings.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-29 13:01:41 +03:00
..

qie-forge (Python SDK)

Python client mirroring @qie-forge/core: a real chain client (web3.py), the real (corrected) QIE Oracle ABI, a fail-closed QUSDC helper, a Blockscout explorer client, pure AMM quote math + unsigned-transaction building, and a read-only lending-vault client.

Install

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

Usage

from qie_forge import ChainClient, OracleClient

chain = ChainClient("mainnet")
print(chain.get_snapshot())

oracle = OracleClient(chain, deployed_networks=["mainnet"])
btc = oracle.get_price("BTC")
print(btc.asset, btc.human_price, btc.description)

Tests

pytest -q                                  # unit + anvil-integration tests (offline-safe, no live network)
QIE_FORGE_RUN_LIVE_TESTS=1 pytest -q       # also hits the real QIE testnet/mainnet RPCs
  • tests/test_networks.py, tests/test_qusdc.py, tests/test_amm_math.py — pure unit tests, no network.
  • tests/test_chain_live.py, tests/test_oracle_live.py — real calls against https://testnet.qie.digital/api/eth-rpc (chain 1983) and https://rpc1mainnet.qie.digital (chain 1990), gated behind QIE_FORGE_RUN_LIVE_TESTS=1.
  • tests/test_anvil_integration.py — deploys the ACTUAL compiled packages/contracts bytecode to a local anvil devnet and exercises VaultClient/amm.py against it; requires Foundry's anvil on PATH (skips cleanly if absent).

23/23 tests pass as of 2026-10-26 (15 offline-safe + 8 live).