caelum0x 0e758bf547 feat: Python/Rust SDKs, deeper Solidity tests, live frontend on Vercel
Phase 2 of the QIE Forge build (owner directive: go deeper, ship a real
public app). Nothing here replaces or removes the phase-1 contracts/SDK —
this adds to it.

- Solidity: 25 -> 35 Foundry tests. New coverage: 3-pool multi-hop
  routing, swapTokensForExactTokens, oracle adapter edge cases
  (decimals-too-large, feed rotation, staleness-disable), and vault
  liquidation edge cases (zero-debt, over-repay, partial liquidation,
  sequential liquidators).
- packages/python: a real web3.py SDK mirroring @qie-forge/core
  (chain/oracle/qusdc/explorer/amm/vault). 23/23 tests pass, including
  2 integration tests that deploy the actual compiled contract
  bytecode to a local anvil devnet and prove the SDK's reads/quotes
  match real on-chain state exactly.
- packages/rust: a real ethers-rs SDK with an abigen!-generated
  binding for the corrected oracle ABI. 13/13 tests pass (9 offline,
  4 live against real testnet/mainnet). No anvil-integration test yet
  (honest gap, documented).
- apps/web: a Next.js 16 + viem frontend, deployed live and public at
  https://qie-forge.vercel.app. Server-rendered home page calls
  @qie-forge/core directly for real testnet/mainnet block numbers and
  real oracle prices on every request. /swap and /vault show an
  honest "not deployed yet" state, proven correct against a real local
  anvil deployment (the API route's quote matched a direct cast call
  to the deployed router exactly) before confirming that empty state
  is what ships today.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-27 00:09:34 +03:00

1.5 KiB

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).