Skip to content

Releases: oak-network/contracts

v1.0.0 – The Genesis Release of CC Protocol

30 Oct 15:49
8169e5a

Choose a tag to compare

🚀 Creative Crowdfunding Protocol (CC Protocol) — v1.0.0

The First Stable Release of the CC Protocol Smart Contracts

We’re excited to announce the v1.0.0 release of the Creative Crowdfunding Protocol (CC Protocol) — a decentralized crowdfunding framework designed to empower creators and communities to launch, manage, and fund campaigns across multiple platforms in Web3.

This initial release establishes the core smart contract architecture, featuring modular design, secure fund management, and flexible deployment workflows for on-chain crowdfunding infrastructure.


🧩 Overview

CC Protocol provides a standardized and extensible infrastructure for crowdfunding initiatives on-chain, enabling:

  • Cross-platform campaign creation
  • Configurable treasury models
  • Secure, transparent fund flows
  • Protocol-level governance parameters

This version introduces a complete architectural redesign, enhanced deployment scripts, and a refined treasury model using the ERC1167 Minimal Proxy pattern for optimal gas efficiency and scalability.


✨ Key Highlights in v1.0.0

🏗️ Architecture Redesign

  • Introduced ERC1167 Minimal Proxy (Clones) for gas-efficient treasury deployments.
  • Replaced constructor-heavy contracts with initializer-based setup to support proxy deployments.
  • Refactored inheritance structures for better code modularity and reusability.
  • Added pause and cancel functionality for campaign lifecycle management.
  • Unified access control patterns across contracts for consistent permissions handling.
  • Introduced custom errors for improved gas efficiency and debugging.

🔐 Security & Reliability

  • Updated all contracts to Solidity 0.8.20 with improved overflow safety and features.
  • Added initialization guards to prevent re-initialization vulnerabilities.
  • Reworked validation logic to ensure safer campaign and treasury state transitions.
  • Fixed critical issue in claimRefund logic for accurate accounting and fee handling.
  • Implemented better check-effects-interactions patterns in token minting and pledging.

💰 Treasury Model Enhancements

  • Consolidated treasury models with improved inheritance and consistency.
  • Introduced enhanced reward batching for efficient claim and refund operations.
  • Simplified naming conventions and removed redundant logic.
  • Improved campaign state transitions (launch, pause, cancel) for clearer lifecycle flow.

⚙️ Deployment & Configuration

  • Modularized deployment scripts using Foundry’s scripting framework.
  • Added implementation-specific deployment scripts for fine-grained control.
  • Introduced automated platform setup and configurable fee parameters.
  • Reorganized .env configuration for better clarity and flexibility.
  • Introduced dedicated initialization scripts for GlobalParams, TreasuryFactory, and CampaignInfoFactory.

🧾 Data & Validation Improvements

  • Simplified logical conditions for better readability and gas performance.
  • Prevented redundant or unsafe state changes (e.g., double platform approvals).
  • Introduced explicit mappings for platform approval tracking.
  • Fixed updateGoalAmount() to correctly enforce validation rules.
  • Automatic fee reset when deselecting a platform.

🧰 Documentation & Project Structure

  • Fully restructured documentation with improved navigation and examples.
  • Added detailed deployment and testing guides in docs/.
  • Reorganized test directory with clearer mocks separation (mocks/TestUSD).
  • Updated license headers and repository structure for clarity.

⚠️ Breaking Changes

This release includes several breaking changes as part of the architectural overhaul:

  • TreasuryFactory API: Updated method signatures and initialization flows.
  • Platform identifiers: Renamed from platformBytesplatformHash.
  • Reward management: Updated function signatures and naming conventions.
  • Deployment scripts: Rewritten to use initializer patterns instead of constructors.

If you are upgrading from a pre-release or prototype version, you will need to update deployment scripts and interfaces accordingly.


🧪 Developer Experience

The development environment is fully compatible with Foundry:

forge build
forge test
forge script script/DeployAll.s.sol:DeployAll --rpc-url $RPC_URL --private-key $PRIVATE_KEY --broadcast

Comprehensive documentation is available in the docs/ directory, including:

  • Contract interfaces
  • Deployment guides
  • Development setup
  • Security notes

🔒 Security

The CC Protocol codebase adheres to best practices in smart contract security:

  • Modular design for isolated risk domains
  • Verified initialization flow for proxy contracts
  • Professional Audits (see audits/ directory)

Further audits will accompany future releases as new features and treasury models are added.


🤝 Contributing

We welcome contributors to the CC Protocol ecosystem!

  • Open issues for bugs or suggestions
  • Submit PRs to enhance functionality or security
  • Improve documentation or tests
  • Review coding and testing standards in our Contributing Guidelines

🪩 Credits

This release was made possible thanks to everyone contributing to the Creative Crowdfunding Protocol.
Built with ❤️ by the CC Protocol team and the open-source community.


🏁 Summary

v1.0.0 establishes the foundation of the Creative Crowdfunding Protocol — a secure, modular, and flexible framework for decentralized crowdfunding.

The next releases will focus on extended treasury models