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>
40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
python -m venv .venv && source .venv/bin/activate
|
|
pip install -e ".[dev]"
|
|
```
|
|
|
|
## Usage
|
|
|
|
```python
|
|
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
|
|
|
|
```bash
|
|
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).
|