token-lifecycle

name	token-lifecycle
description	Reference for Doppler token creation, vesting, inflation, and factory selection across DERC20, DERC2080, CloneERC20, and CloneDERC20VotesV2 paths.
license	MIT
metadata	{"author":"doppler","version":"2.0"}

Source References: Use Doppler deployments as the contract source of truth for deployed addresses and revisions.

Token Lifecycle

When to use

• You are choosing a token factory for a launch
• You need vesting/inflation semantics for Doppler asset tokens
• You are debugging vesting release, pool lock behavior, or mint-rate logic

Prerequisites

• Determine governance posture first:
  • OpenZeppelin Governor: disabled (default for most launches)
  • OpenZeppelin Governor: enabled (when token-holder governance is required)
• Determine required token capabilities (votes, permit, clone vs full deployment)
• Confirm Airlock-compatible factory interface (ITokenFactory)

Core workflow

1. Pick factory path:
   • TokenFactory / DERC20
   • TokenFactory80 / DERC2080
   • CloneERC20Factory / CloneERC20
   • CloneERC20VotesFactory / CloneERC20Votes
   • CloneDERC20VotesV2Factory / CloneDERC20VotesV2 (multi-schedule vesting)
2. Validate token data encoding expected by selected factory.
3. Validate vesting schedule constraints and per-address/global premint caps.
4. Verify pool lock/unlock timing relative to migration and inflation mint start.

Quick facts

Family	Votes	Vesting model	Deployment style
DERC20 / DERC2080	Yes	Single-schedule style	Full deployment
CloneERC20	No	Single-schedule style	ERC1167 clone
CloneERC20Votes	Yes	Single-schedule style	ERC1167 clone
CloneDERC20VotesV2	Yes	Multi-schedule vesting	ERC1167 clone

Failure modes

• Mismatched encoded token data vs selected factory ABI
• Invalid vesting schedule arrays or lengths
• Premint caps exceeded per address or globally
• Attempting inflation mint before unlock/initial mint window

References

• FACTORIES.md
• VESTING.md
• Source: doppler/src/tokens/*.sol (especially CloneDERC20VotesV2.sol, CloneDERC20VotesV2Factory.sol)

Related skills

• airlock
• pda-static
• pda-dynamic
• pda-multicurve