📝Smart Contracts

Core smart contracts powering the 0QP protocol across all supported chains.

Contract Suite Overview

Core Contracts

0QP Token Contract

• ERC-20 standard with staking integration

• Built-in governance voting

• Cross-chain bridge compatibility

• Fee distribution automation

Trading Engine

• Hybrid order execution logic

• Multi-source liquidity aggregation

• AI strategy integration

• Cross-chain order routing

Staking Contract

• Flexible and lock staking options

• Liquid staking token (s0QP) issuance

• Automatic reward distribution

• Governance voting weight tracking

DAO Governance

• Proposal creation and voting

• Treasury management

• Multi-sig emergency controls

• Cross-chain governance execution

Contract Addresses

Ethereum Mainnet

Contract	Address	Verified
0QP Token	0xd5EA96B17Dc6092cF28A40275ad10F51db303F8E	✅
Trading Engine	0x... (TBD)
Staking Pool	0x... (TBD)
DAO Governance	0x... (TBD)

BSC

Contract	Address	Verified
0QP Token (Bridged)	0x... (TBD)
Trading Engine	0x... (TBD)
LP Rewards	0x... (TBD)

Solana

Program	Address	Verified
0QP Token	... (TBD)
Trading Program	... (TBD)
Staking Program	... (TBD)

Polygon

Contract	Address	Verified
0QP Token (Bridged)	0x... (TBD)
Micro-trading	0x... (TBD)
Gaming Integration	0x... (TBD)

Key Contract Functions

0QP Token Contract

// Simplified interface
interface I0QPToken {
    function stake(uint256 amount, uint256 lockDuration) 
        external returns (uint256 s0QPAmount);
    
    function unstake(uint256 s0QPAmount) 
        external returns (uint256 amount);
    
    function vote(uint256 proposalId, bool support) external;
    
    function claimRewards() external returns (uint256 rewards);
}

Trading Engine Contract

// Core trading interface
interface ITradingEngine {
function hybridSwap(
address tokenIn,
address tokenOut,
uint256 amountIn,
uint256 minAmountOut,
bytes calldata routeData
) external returns (uint256 amountOut);
function createP2POrder(
    address tokenIn,
    address tokenOut,
    uint256 amountIn,
    uint256 price,
    uint256 deadline
) external returns (uint256 orderId);
}

Staking Contract

// Staking management
interface IStaking {
    function stake(uint256 amount, uint256 lockDuration) external;
    function unstake(uint256 s0QPAmount) external;
    function compound() external;
    function getRewards(address user) external view returns (uint256);
}

Security Features

Access Controls

• Role-based permissions: Admin, operator, user roles

• Multi-signature: Critical functions require multiple approvals

• Time-locks: Major changes have 48-hour delay

• Emergency pause: Circuit breaker for security incidents

Audit Results

Certik Audit (Score: 92/100)

• ✅ No critical vulnerabilities

• ✅ Mathematical correctness verified

• ✅ Access control properly implemented

• ⚠️ 3 minor optimizations (resolved)

Quantstamp Audit

• ✅ No high or medium risk issues

• ✅ Gas optimization suggestions implemented

• ✅ Code quality improvements applied

• ✅ Documentation enhanced

Bug Bounty Program

• Critical: $50K - $100K

• High: $10K - $50K

• Medium: $2K - $10K

• Low: $500 - $2K

Upgrade Mechanism

Proxy Pattern

• Transparent proxies for upgradeability

• Storage separation prevents conflicts

• Admin controls through multi-sig

• Emergency upgrades with time delays

Governance Process

1. Proposal creation with technical details

2. Community review period (7 days)

3. Voting period (5 days)

4. Time-lock execution (48 hours)

5. Implementation with monitoring

Gas Optimization

Efficient Design

• Batch operations: Multiple actions in single tx

• State packing: Optimize storage usage

• Loop optimization: Minimize computation

• Event logging: Efficient indexing

Gas Costs (Ethereum)

Operation	Estimated Gas	USD Cost*
Token transfer	65,000	$3.25
Stake tokens	150,000	$7.50
Trade (small)	200,000	$10.00
Trade (large)	300,000	$15.00

*At 50 gwei, $2500 ETH

L2 Optimizations

• BSC: ~95% gas savings vs Ethereum

• Polygon: ~99% gas savings vs Ethereum

• Solana: Fixed low fees regardless of size

Integration APIs

Contract ABIs

Available at contracts.0qp.finance

• Full ABI exports for all contracts

• TypeScript type definitions

• Integration examples and tutorials

• SDK for popular frameworks

Events and Logging

// Key events for indexing
event Trade(
    address indexed user,
    address indexed tokenIn,
    address indexed tokenOut,
    uint256 amountIn,
    uint256 amountOut,
    uint256 fee
);

event Stake(
    address indexed user,
    uint256 amount,
    uint256 lockDuration,
    uint256 s0QPReceived
);

Development Tools

Testing Framework

• Hardhat: Development environment

• Foundry: Advanced testing and fuzzing

• Slither: Static analysis tool

• Echidna: Property-based testing

Deployment Process

1. Local testing: Comprehensive unit tests

2. Testnet deployment: Public testing phase

3. Security review: Final audit check

4. Mainnet deployment: Production release

5. Verification: Source code verification