THE|ARC

---

🏛️ Artifact Development Engine

Professional Development Platform for Building Smart Contract Artifacts

The Artifact Development Engine provides a unified platform for creating and deploying all types of smart contract artifacts:

• 🪙 Token Factory - Create ERC20 tokens with advanced features
• 🖼️ NFT Studio - Design and deploy NFT collections (ERC721/ERC1155)
• 🎖️ SBT Creator - Build Soulbound Tokens for credentials
• 🗳️ Governance Builder - Deploy DAO contracts with advanced voting
• 💹 DeFi Tools - Access bridges, swaps, and liquidity tools

---

Ecosystem Repository

A comprehensive decentralized autonomous organization (DAO) and governance system for the ARC ecosystem, featuring multiple voting mechanisms, secure timelock controls, modular contract architecture, and the ARCx V2 Enhanced token live on Base L2.

Overview

The ARC ecosystem provides a robust framework for decentralized decision-making and DeFi operations. It includes a suite of governance contracts and the ARCx V2 Enhanced token, now deployed and live on Base L2 Mainnet.

Project Scale

1. 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)

1. ARCs

   • Status: In progress

1. SoulBound NTT

   • Status: Coming soon

1. ARC NFT Ecosystem

   • Status: Production Ready
   • Features: AI companions, trait system, XP progression, token-bound accounts
   • Contracts: EvolvingCompanion (ERC721), TraitVault (ERC1155), ModuleMock
   • Frontend: Next.js 13 with wagmi integration

---

Deployed Addresses (Base L2)

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

• 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): 0x7c5f5a4bbd8fd63184577525326123b519429bdc
• 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

1. 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

2. 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

3. 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

4. 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

5. ARCTreasury.sol

• Purpose: Secure fund management and execution
• Features:
  • Multi-token support (native and ERC20)
  • Proposal-based fund allocation
  • Emergency withdrawal capabilities
  • Balance tracking and reporting
  • Integration with governance proposals

6. 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.