A Solidity + Hardhat educational template for an ICO (token sale) that implements whitelisting, oracle-priced multi-asset payments with Chainlink and Uniswap V3 TWAP, and vesting.

Stars

7

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It clearly explains the rationale behind each mechanism (whitelist, oracle abstraction, secured price oracle, vesting) and discusses trade-offs, making it a strong learning resource for developers.

Who it is for

  • Smart contract developers learning real-world token sale patterns
  • DeFi protocol teams designing a token sale with robust price oracles
  • Security auditors reviewing ICO logic and oracle integration
  • Students of Ethereum development seeking a well-documented template

Use cases

  • Building an ICO with buyer whitelisting and cap enforcement
  • Integrating multiple price oracles (Chainlink, Uniswap TWAP) with fail-safe checks
  • Implementing token vesting with a TGE and linear release schedule
  • Learning how to write fixture-based unit tests and live-node smoke tests for a sale contract

Strengths

  • Educational clarity: each contract and mechanism is explained with its purpose and trade-offs
  • Modular oracle design: ICO.sol uses an interface, enabling pluggable price sources and the secured oracle without modifying the sale logic
  • Real-world mechanisms: includes whitelist, multi-asset payments, oracle staleness checks, and vesting with cliff
  • Comprehensive testing: fixture-based unit tests plus a live-node smoke test covering edge cases

Considerations

  • Uses a simple on-chain whitelist (mapping) rather than a Merkle tree, which scales poorly for very large buyer lists
  • Deployment requires manually configuring oracle addresses per network; no hardcoded defaults
  • Template is educational and may need significant customization for production use (e.g., regulatory compliance, frontend integration)

README quick start

Getting started

Description

Educational ICO template in Solidity: whitelisting, oracle pricing, vesting

Related repositories

Similar projects matched by category, topics, and programming language.

project-sekai-ctf
project-sekai-ctf GitHub avatar

sekaictf-2026

This repository contains the official source code and writeups for all challenges from SekaiCTF 2026, organized by category and difficulty level.

Solidity
35
YaponsRH
YaponsRH GitHub avatar

yapons

YAPONS is an attention-to-earn protocol on Robinhood Chain that rewards users with $YAP tokens based on multi-factor mindshare scores of their X posts.

Solidity
34