Exchange Integration Guide

This guide covers the practical integration path for exchanges and custodians: deposits, withdrawals, wallet balance sync, DEX quoting/execution, and QP EVM/QRC readiness. Pair this with the Whitepaper and Wallet API.

1) Core Architecture

Signature layer: Ed25519 transaction signatures (canonical message signing).
Spend gate: validator shard-part verification per transaction.
Chain accounting: QP stored in atomic units with 8 decimals (1 QP = 100,000,000 atoms).
DEX policy: lot engine is whole-token quantity only (integer qty).

2) Required Endpoints

GET /balance/{address}
GET /usdt/balance?address=...
POST /submitTransaction
GET /dex/quote?side=BUY|SELL&token=QP&qty=...
POST /dex/execute
GET /dex/state, /dex/lastPrice, /dex/trades

3) Amount & Lot Rules (Critical)

On-chain QP balances: atomic 8-decimal integers.
Transfer submission currently uses whole-token quantity in wallet UX.
DEX qty must be an integer; fractional values are rejected.
Lot model: first 5,000 QP lot, then 1,000-QP lots.

4) Canonical Signing

Sign exactly these message formats before submission:

// Chain transfer:
from|to|amount|nonce|data

// DEX authorization:
DEX|SIDE|TOKEN|QTY|NONCE|ADDRESS

Use integer qty for DEX signing to avoid verification mismatch.

5) DEX Curve Summary

Price floor: $0.01.
Step: +0.05% per lot (constant across the curve).
Display price rounded to $0.001.

The algo venue is tuned for early liquidity (about first 30M QP) and is designed to complement order-book exchange liquidity.

6) Fees

Swap: 0.5% in USDT (cap $100).
Transfer gas: 0.5% in USDT (cap $100).
Swaps charge swap fee only; transfers charge gas only.

7) EVM / QRC Integration Status

V1: QP EVM-compatible execution model is active for contract tooling and staged deploy flow.
QRC tokens: contract operations follow the same deterministic signing and validator gate posture.
V2 roadmap: expanded contract checker pipeline + AI-scored policy hooks + richer external data adapters.

For production exchange-side contract routing, use the Smart Contracts dashboard and current node endpoints documented above until public contract RPC docs are finalized.

8) Support

Integration support: support@qqp.io and partners@qqp.io.