TokenVesting

src/TokenVesting.sol — locks any ERC-20 and releases it linearly to a fixed beneficiary.

Constructor

constructor(address _token, address _beneficiary, uint64 _cliffDuration, uint64 _duration)

Parameter	Description
`_token`	ERC-20 to vest (typically AUR)
`_beneficiary`	Immutable recipient of released tokens
`_cliffDuration`	Seconds from deposit until the cliff
`_duration`	Total vesting duration in seconds (`>= _cliffDuration`)

Durations are configured at deployment, but timestamps remain zero until the one-time deposit arrives:

State var	Value
`start`	`block.timestamp` when `deposit` succeeds
`cliff`	`start + cliffDuration`
`end`	`start + duration`

Reverts with InvalidDuration() if _duration == 0 or _cliffDuration > _duration.

Deposit

function deposit(uint256 amount) external

One-time, one-way. Transfers tokens from msg.sender into the contract and starts the schedule in the same transaction. The contract records the actual balance received, making deposits safe for tokens that deduct a transfer fee. Subsequent calls revert with AlreadyDeposited().

Caller must approve this contract before calling.

Vesting Schedule

function vestedAmount(uint64 timestamp) public view returns (uint256)

Time range	Returns
`timestamp < cliff`	`0`
`cliff <= timestamp < end`	`totalAmount * (timestamp - start) / (end - start)`
`timestamp >= end`	`totalAmount`

Accrual is linear from start, not from cliff. The cliff makes the entire accrued amount claimable in a lump sum on first release.

Example: 1,000 tokens, 30-day cliff, 365-day total. At day 30, (1000 * 30) / 365 ≈ 82 tokens are immediately claimable.

Release

function release() external

Transfers all currently releasable tokens to beneficiary. Anyone can call; tokens always go to the fixed beneficiary, never to msg.sender.

Check	Error
`block.timestamp < cliff`	`CliffNotReached()`
`releasable() == 0`	`NothingToRelease()`

State

Variable	Type	Description
`cliffDuration`	`uint64`	Immutable delay from deposit to cliff
`duration`	`uint64`	Immutable total schedule length
`totalAmount`	`uint256`	Actual token balance received by `deposit`
`released`	`uint256`	Cumulative tokens already transferred
`deposited`	`bool`	Guards against double-deposit

Events

Event	Emitted by
`Deposited(address depositor, uint256 amount)`	`deposit`
`Released(address beneficiary, uint256 amount)`	`release`

Custom Errors

Error	Condition
`AlreadyDeposited()`	Second call to `deposit`
`ZeroAmount()`	`deposit(0)`
`InvalidDuration()`	`_duration == 0` or `_cliffDuration > _duration`
`ZeroAddress()`	Zero token or beneficiary address
`CliffNotReached()`	`release` called before cliff
`NothingToRelease()`	No vested tokens pending release