Proprietary — Ikenga-Metuh-C-F © 2020 - 2026. Licensed to IKSectors Ltd.
This repository contains the complete audit package for IKChain — a custom EVM blockchain with integrated DeFi infrastructure. It includes all Solidity smart contracts, test suites, deployment scripts, prior audit reports, and the rebranded blockchain node files.
For a full manifest of all files and their purpose, see EXTERNAL_AUDIT_PACKAGE.md.
IKChain-Audit/
├── EXTERNAL_AUDIT_PACKAGE.md # Full audit manifest (start here)
├── README.md # This file
├── contracts/ # 16 Solidity contracts (~5,485 LOC)
│ ├── bridge/ # Cross-chain bridge (3 contracts)
│ ├── dex/ # AMM DEX — IKXchange (5 contracts)
│ ├── governance/ # Timelock controller (1 contract)
│ ├── identity/ # KYC/identity registry (1 contract)
│ ├── payments/ # Payment gateway (1 contract)
│ ├── stablecoins/ # Stablecoin suite (3 contracts)
│ ├── token/ # IKCr ERC-20 token (1 contract)
│ └── treasury/ # Token sale with vesting (1 contract)
├── test/ # 9 test files, 371 verified tests (~6,268 LOC)
├── scripts/ # 5 deployment scripts (~1,107 LOC)
├── audit-reports/ # Prior IKSecure audit reports (v1.0, v2.0, v3.0, rebrand)
│ ├── IKCHAIN_SECURITY_AUDIT_v1.0.md
│ ├── IKCHAIN_SECURITY_AUDIT_v2.0.md
│ ├── IKCHAIN_SECURITY_AUDIT_v3.0.md
│ ├── REBRAND_SECURITY_ASSESSMENT.md
│ └── VULNERABILITY_TRACKER.md
├── security-handoffs/ # Remediation completion reports
│ ├── SECURITY_REMEDIATION_HANDOFF_v2.0.md
│ ├── REMEDIATION_COMPLETION_REPORT_v2.0.md
│ └── REBRAND_SECURITY_HANDOFF.md
├── ikchain-core/ # Polygon Edge v1.3.2 fork — rebranded files (7 files)
├── hardhat.config.js # Hardhat configuration
├── package.json # Dependencies
└── .env.example # Environment variable template
| Component | Version |
|---|---|
| Solidity | ^0.8.20 |
| OpenZeppelin Contracts | v5.4.0 |
| Hardhat | v2.28.4 |
| ethers.js | v6.16.0 |
| Node.js | v20+ (recommended) |
| IKChain Core | Polygon Edge v1.3.2 fork |
| Consensus | IBFT 2.0 (PoA with BLS) |
| Chain ID | 4269 (Mainnet/Local) / 4270 (Testnet) |
| # | Contract | Path | LOC |
|---|---|---|---|
| 1 | IKCrypto.sol | contracts/token/ | 424 |
| 2 | IKPaymentGateway.sol | contracts/payments/ | 731 |
| 3 | IKRegistry.sol | contracts/identity/ | 604 |
| 4 | IKUSD.sol | contracts/stablecoins/ | 323 |
| 5 | IKStablecoin.sol | contracts/stablecoins/ | 137 |
| 6 | IKStablecoinFactory.sol | contracts/stablecoins/ | 123 |
| 7 | IKBridgeBase.sol | contracts/bridge/ | 627 |
| 8 | IKBridgeIKChain.sol | contracts/bridge/ | 595 |
| 9 | IKBridgedToken.sol | contracts/bridge/ | 143 |
| 10 | IKXFactory.sol | contracts/dex/ | 143 |
| 11 | IKXPair.sol | contracts/dex/ | 288 |
| 12 | IKXRouter.sol | contracts/dex/ | 399 |
| 13 | IKXTWAPOracle.sol | contracts/dex/ | 230 |
| 14 | IIKXCallee.sol | contracts/dex/ | 29 |
| 15 | IKTreasurySale.sol | contracts/treasury/ | 623 |
| 16 | IKGovernanceTimelock.sol | contracts/governance/ | 41 |
# Install dependencies
npm install
# Copy environment config
cp .env.example .env
# Compile contracts
npx hardhat compile
# Run tests
npx hardhat test
# Run tests with gas reporting
REPORT_GAS=true npx hardhat test
# Check contract sizes
npx hardhat size-contracts| Version | Date | Scope | Findings |
|---|---|---|---|
| v1.0 | 2026-02-12 | Initial audit (13 contracts) | 42 total (7C, 12H, 14M, 9L) |
| v2.0 | 2026-02-13 | Full re-audit (13 contracts) | 53 total (13C, 12H, 16M, 12L) |
| v3.0 | 2026-02-16 | Verification audit (16 contracts) | PASS + 5 informational |
| Rebrand | 2026-02-16 | Polygon Edge rebrand + governance | 13 total (3C, 2H, 3M, 2L, 3I) |
Full details in audit-reports/ and security-handoffs/.
See Section 8 of EXTERNAL_AUDIT_PACKAGE.md for open critical, high, and informational findings that an external auditor should independently verify.
This code is proprietary. This repository is shared solely for audit purposes. Do not redistribute, fork, or publish any findings without written consent from the IP owner.
© 2020 - 2026 IKSectors Ltd under licence from Ikenga-Metuh-C-F. All rights reserved.