ARC Ecosystem

Decentralized AI Model Identity, Governance, and Orchestration Infrastructure

---

Tech Stack

---

Project Components

ARCx V2 Enhanced (LIVE)

• Address: 0xDb3C3f9ECb93f3532b4FD5B050245dd2F2Eec437
• Network: Base L2 Mainnet (Chain ID: 8453)
• Symbol: ARCX2 • Decimals: 18 • Total Supply: 1,000,000 (finalized)
• Contract Size: 24,255 bytes (under 24,576 limit)
• DEX: Uniswap V4 — LP live (no hooks)
• Status:
• Network:
• DEX:
• Type:

ARCs (In Progress)

• Status:
• Type:
• Solidity:

SoulBound NTT (Coming Soon)

• Status:
• Type:
• Solidity:

ARC NFT Ecosystem (Production Ready)

• Status:
• Type:
• Solidity:
• Frontend:
• Features: AI companions, trait system, XP progression, token-bound accounts
• Contracts: EvolvingCompanion (ERC721), TraitVault (ERC1155), ModuleMock

---

Deployed Addresses (Base L2)

Authoritative source: address.book (verify on BaseScan when in doubt).

Core Contracts

• ARCx V2 Enhanced: 0xDb3C3f9ECb93f3532b4FD5B050245dd2F2Eec437
• ARCxMath Library: 0xdfB7271303467d58F6eFa10461c9870Ed244F530
• Vesting Contract: 0x0bBf1fFda16C2d9833a972b0E9dE535Cf398B600
• Airdrop Contract: 0x40fe447cf4B2af7aa41694a568d84F1065620298
• Treasury Safe: 0x8F8fdBFa1AF9f53973a7003CbF26D854De9b2f38
• Ecosystem Safe: 0x2ebCb38562051b02dae9cAca5ed8Ddb353d225eb

Uniswap V4 Infrastructure (Base)

• Pool Manager: 0x498581ff718922c3f8e6a244956af099b2652b2b
• Position Manager (NFPM): 0x7c5f5a4bfd8fd63184577525326123b519429bdc
• Universal Router: 0x6ff5693b99212da76ad316178a184ab56d299b43

Base Network Tokens

• WETH: 0x4200000000000000000000000000000000000006
• USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Note: A Uniswap V4 Hook exists at 0xBCc34Ad1bC78c71E86A04814e69F9Cc26A456aE0, but it is not used for the live LP path.

---

Uniswap V4 — Live LP

• Pair: ARCX2 / WETH (Base L2)
• Fee Tier: 0.05% (stable pairs)
• Seeded Liquidity: 500,000 ARCX2 (50% of supply)
• Pool Manager: 0x498581ff718922c3f8e6a244956af099b2652b2b
• Position Manager (NFPM): 0x7c5f5a4bfd8fd63184577525326123b519429bdc
• Universal Router: 0x6ff5693b99212da76ad316178a184ab56d299b43
• Main LP Position: 242940 - Uniswap Position

Details and historical notes: docs/environment/V4_LP_DEPLOYMENT_SUMMARY.md (current LP config is as above).

---

Architecture

Core Contracts

ARCGovernor.sol

• Purpose: Main governance contract implementing proposal lifecycle management
• Features:
  • Multiple voting mechanisms (standard, quadratic, conviction, ranked choice, weighted)
  • Configurable voting periods and delays
  • Proposal threshold requirements
  • Quorum enforcement
  • Integration with timelock for secure execution

ARCTimelock.sol

• Purpose: Secure execution delays for governance actions
• Features:
  • Configurable delay periods
  • Role-based access control (Proposer, Executor, Admin)
  • Batch operation support
  • Emergency execution capabilities
  • Operation scheduling and cancellation

ARCProposal.sol

• Purpose: Proposal creation and management system
• Features:
  • Multiple proposal types (Basic, Treasury, Parameter, Upgrade)
  • Proposal validation and categorization
  • State management throughout proposal lifecycle
  • Integration with voting and treasury systems

ARCVoting.sol

• Purpose: Flexible voting mechanisms for different governance needs
• Features:
  • Standard voting (one token, one vote)
  • Quadratic voting (square root of tokens)
  • Conviction voting (time-weighted)
  • Ranked choice voting
  • Weighted voting (custom weight distribution)
  • Vote delegation support

ARCTreasury.sol

• Purpose: Treasury management and fund allocation
• Features:
  • Multi-sig controlled treasury operations
  • Budget allocation and tracking
  • Emergency fund mechanisms
  • Integration with governance proposals
  • Transparent fund flows

ARCDAO.sol

• Purpose: Main orchestrator contract unifying all governance components
• Features:
  • Unified interface for all governance operations
  • Proposal lifecycle management
  • Emergency functions
  • State queries and reporting
  • Role-based access control

---

Token Distribution (1,000,000 ARCX2)

• Liquidity Pool: 500,000 ARCX2 (50%) — Uniswap V4 (0.05% stable fee)
• Vesting (Ecosystem + Dev): 300,000 ARCX2 (30%)
• Airdrop: 100,000 ARCX2 (10%)
• Marketing: 100,000 ARCX2 (10%)

Vesting details are managed by the Master Vesting contract and subject to configured cliffs and schedules.

---

Development

Prerequisites

• Node.js 16.x or higher
• Hardhat 2.26.x or higher
• OpenZeppelin Contracts (upgradeable)

Install / Build / Test

npm install
npx hardhat compile
npx hardhat test

Project Structure (high level)

contracts/
├── dao/
├── defi/
├── pool/
├── thirdparty/
└── tokens/
    ├── arc-x/          # ARCX2 token contracts
    ├── arc-s/          # ARCs token contracts
    ├── nft/            # NFT ecosystem contracts
    │   ├── contracts/  # Smart contracts
    │   ├── scripts/    # Deployment scripts
    │   ├── test/       # Contract tests
    │   └── frontend/   # React frontend
    ├── sbt/            # SoulBound token contracts
    └── vesting/        # Vesting contracts

scripts/
├── ecosystem-manager.ts    # Master orchestrator for system health & status
├── monitor.ts             # Real-time monitoring and reporting
├── config.ts              # Configuration management and validation
├── vesting-manager.ts     # Complete vesting schedule management
├── lp-manager.ts          # Uniswap V4 LP compatibility management
├── airdrop-manager.ts     # Complete airdrop campaign management
├── deployment-manager.ts  # Contract deployment orchestration
├── shared/
│   ├── constants.ts       # Centralized address and configuration
│   └── utils.ts           # Common utility functions
└── README.md              # Comprehensive script documentation

test/
└── ...

Script Architecture

The ARC ecosystem features a comprehensive, streamlined script architecture with proper separation of concerns:

Core Management Scripts

• ecosystem-manager.ts – Master orchestrator for system health checks and status reporting
• monitor.ts – Real-time monitoring of token supply, vesting, and liquidity positions
• config.ts – Environment and configuration management with validation

Specialized Management Scripts

• vesting-manager.ts – Complete vesting schedule management and beneficiary operations
• lp-manager.ts – Uniswap V4 LP compatibility and management
• airdrop-manager.ts – Complete airdrop lifecycle from setup to claiming
• deployment-manager.ts – Contract deployment orchestration

Quick Start Commands

# System health check
npx hardhat run scripts/ecosystem-manager.ts --network base health

# Full monitoring report
npx hardhat run scripts/monitor.ts --network base report

# Configuration validation
npx hardhat run scripts/config.ts --network base validate

# Vesting setup
npx hardhat run scripts/vesting-manager.ts --network base setup-finalize

# LP compatibility check
npx hardhat run scripts/lp-manager.ts --network base check

For detailed script documentation and usage examples, see: scripts/README.md

---

Security & Operations

Security Audit Status: PERFECT 100/100 ✅

The ARC ecosystem has achieved a PERFECT security rating through comprehensive analysis:

• ✅ Zero vulnerabilities across 70+ smart contracts (Critical/High/Medium/Low: 0/0/0/0)
• ✅ 100% test pass rate - All 147 tests passing
• ✅ 92% code coverage with comprehensive test suite
• ✅ 115+ ReentrancyGuard protections throughout codebase
• ✅ 269+ access control checks ensuring proper authorization
• ✅ Zero npm vulnerabilities in 958 audited packages
• ✅ Modern Solidity 0.8.21 with built-in overflow protection
• ✅ OpenZeppelin v4.9.6 industry-standard security libraries
• ✅ Perfect score on all security metrics

📋 View Full Security Audit Report - 100/100 Rating

Key Security Features:

• Multi-sig safes secure treasury and ecosystem funds (Gnosis Safe)
• Role-based access control for administration and upgrades
• Emergency pause mechanisms available where applicable
• UUPS proxy pattern with upgrade authorization
• ReentrancyGuard on all sensitive operations
• Comprehensive test coverage (147 tests passing)
• Regular security monitoring

Security Resources:

• 🔐 Security Audit Report - PERFECT 100/100
• 🛡️ Security Policy - Vulnerability reporting
• 📧 Report vulnerabilities: security@arcexchange.io

Token Mechanics:

• Gas predictability under default token mechanics
• No dangerous patterns (delegatecall, selfdestruct, tx.origin)
• Full ERC20 compliance with ERC20Votes and ERC20Permit extensions

---

Important Links

• 🏛️ Artifact Development Engine: ./docs/artifact_development_engine.html - Unified development platform
• 💻 Contract IDE: ./docs/contract_deployment_ide.html - Write, compile & deploy contracts
• 🔐 Security Audit: ./SECURITY_AUDIT.md - PERFECT 100/100 rating
• Address Book (authoritative): ./address.book
• Release Notes: ./docs/RELEASE_NOTES.md
• Uniswap V4 LP Summary: ./docs/environment/V4_LP_DEPLOYMENT_SUMMARY.md
• NFT Ecosystem: ./contracts/tokens/nft/README.md
• NFT Frontend: ./contracts/tokens/nft/frontend/README.md
• Security Policy: ./docs/SECURITY.md
• Full Docs: ./docs/

---

License

MIT License — see LICENSE.