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>
61 lines
1.9 KiB
Python
61 lines
1.9 KiB
Python
"""Blockscout REST API client — mirrors packages/core/src/explorer.ts.
|
|
QIE already runs a real Blockscout-family explorer; this does not
|
|
re-implement indexing, only wraps the existing public API.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
|
|
import requests
|
|
|
|
from .errors import QieForgeError
|
|
from .networks import QieNetworkConfig
|
|
|
|
|
|
@dataclass
|
|
class ExplorerAddressInfo:
|
|
hash: str
|
|
is_contract: bool
|
|
is_verified: bool | None
|
|
coin_balance: str | None
|
|
|
|
|
|
class ExplorerClient:
|
|
def __init__(self, network: QieNetworkConfig, timeout: float = 10.0):
|
|
self._network = network
|
|
self._timeout = timeout
|
|
|
|
def _fetch_json(self, path: str) -> dict:
|
|
url = f"{self._network.explorer_api_url}{path}"
|
|
try:
|
|
res = requests.get(url, timeout=self._timeout)
|
|
except requests.RequestException as exc:
|
|
raise QieForgeError(
|
|
"EXPLORER_UNAVAILABLE",
|
|
f"Could not reach QIE {self._network.name} explorer API at {url}: {exc}",
|
|
{"url": url},
|
|
) from exc
|
|
if not res.ok:
|
|
raise QieForgeError(
|
|
"EXPLORER_UNAVAILABLE",
|
|
f"QIE {self._network.name} explorer API returned HTTP {res.status_code} for {url}",
|
|
{"url": url, "status": res.status_code},
|
|
)
|
|
return res.json()
|
|
|
|
def get_address(self, address: str) -> ExplorerAddressInfo:
|
|
data = self._fetch_json(f"/v2/addresses/{address}")
|
|
return ExplorerAddressInfo(
|
|
hash=str(data.get("hash", address)),
|
|
is_contract=bool(data.get("is_contract")),
|
|
is_verified=data.get("is_verified"),
|
|
coin_balance=data.get("coin_balance"),
|
|
)
|
|
|
|
def address_url(self, address: str) -> str:
|
|
return f"{self._network.explorer_url}/address/{address}"
|
|
|
|
def tx_url(self, tx_hash: str) -> str:
|
|
return f"{self._network.explorer_url}/tx/{tx_hash}"
|