Documentation
repository
Repository
darwinmarket/darwin-qorechain, MIT.
contracts/ Solidity 0.8.28, Foundry, OpenZeppelin
pqc/PqcAuth.sol ML-DSA-87 check against the on-chain key registry
pqc/PqcAdmin.sol admin powers usable only with a post-quantum signature
DarwinOracle.sol price rounds signed by the reporter, breaker, spacing, staleness
DarwinReserve.sol oracle-priced inventory market maker
DarwinBasket.sol ERC-20 share, in-kind mint/redeem, NAV, curator-signed rebalances
DarwinRouter.sol buy or sell a whole basket with fUSD in one call
DarwinTestToken.sol fQOR, fQWAKK: price-tracking stand-ins, ML-DSA-87 minting
WQOR.sol wrapped QOR
account/ DarwinAccount, DarwinAccountFactory: users' accounts, ML-DSA-87 only
ops/ TypeScript, QoreChain SDK, viem
relayer.ts the original relayer: signed intents through authz (shares bought before accounts)
deploy-accounts.ts deploys the account factory
account-check.ts the account path end to end on the testnet, through the app's API
keeper.ts local keeper; in production app/src/server does it on demand
evm.ts reads and writes; write() sends a hybrid MsgCrossVMCall
pq-audit.ts every Darwin transaction since a date hybrid-verified
prices.ts BTC/ETH spot median, QOR market price, QWAKK pool median
oracle.ts, rebalance.ts, window.ts, deploy.ts, redeploy-v2.ts, ...
app/ Next.js: Darwin's mainnet front on QoreChain
src/lib/qore/ chain reads, QoreX, the account and relayer clients, in-browser verification;
nativeCalls.ts decodes native calls (calldata, memo), which leave no EVM logs
src/server/ keys, chain.ts (writeNative: hybrid MsgCrossVMCall), keeper.ts (rounds,
rebalances on demand), accounts.ts (the account relayer), relayer.ts (original)
src/app/api/ REST proxy, relayer proxy, trades summary, price history
docs/ audit map, pricing, testing, CBOM, submission, E2E reports
docs-site/ this documentation
deployments/diana.json every address, role, seed and retired versionKits
| Kit | Used for |
|---|---|
QoreChain SDK (@qorechain/sdk, @qorechain/evm) | key derivation, hybrid signing of every Darwin transaction (MsgCrossVMCall), PQC registration, EVM windows (deployment only) |
QoreSign (@qorechain/qoresign) | both halves of every signed message checked in the relayer; in-browser checks of committed transactions |
qorechain-pqc (@qorechain/pqc) | in-browser verification of account trades and oracle rounds |
QoreChain React (@qorechain/react) | the PQC key badge |
Wallet adapter (@qorechain/wallet-adapter) | QoreX capability checks and requests |
QoreX integrations (@qorechain/qorex-wallet-mock) | browser end-to-end tests |
MCP + qore CLI (@qorechain/mcp, @qorechain/qore-cli) | second opinion in the on-chain suite; .mcp.json for agents |
QoreScan (@qorechain/qorescan) | the CBOM |