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
# qie-forge (Python SDK)
feat: QIE Forge — clean-room AMM + lending vault, SDK, and CLI for QIE
Initial build for QIE Mainnet Hackathon 3.0 (DeFi & Financial
Infrastructure track). Includes:
- packages/contracts: constant-product AMM (factory/pair/router),
over-collateralized lending vault, and an oracle adapter wrapping
QIE's real deployed price-feed contracts. 25/25 Foundry tests pass
locally. Clean-room: no existing DEX/lending protocol source was
read or copied.
- packages/core: TypeScript SDK (viem-based) for QIE's chain, the
real (corrected) oracle ABI, a fail-closed QUSDC helper, a
Blockscout explorer client, and QIE Wallet connection constants.
Live-verified against real testnet (chain 1983) and mainnet
(chain 1990) RPCs and the real oracle contracts.
- packages/cli: a small CLI built on @qie-forge/core.
Real findings from building this, documented in README.md and
docs/STATUS.md: the previously-documented testnet RPC URL is dead
(replacement found and verified live); QIE's own oracle docs describe
a getPrice(string) function that reverts on the real deployed
contracts, which actually implement a Chainlink AggregatorV3-style
interface (verified live via raw eth_call); the oracle is deployed on
Mainnet only, not Testnet.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-26 23:34:51 +03:00
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
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).