_fee

CryptoTransferFailed

EnforcedPause

ExpectedPause

GetTokenCustomFeesFailed

GetTokenTypeFailed

SingleAssociationFailed

TokenTransferFailed

account

endOfExemptionTimestamp

AccountExempt

ExemptionRevoked

newFee

FeeAmountUpdated

receiver

amount

davinciAddress

FeesWithdrawn

previousOwner

newOwner

OwnershipTransferred

Paused

creator

token

beneficiary

vestingDuration

cycleDuration

cliffDuration

cliffAmount

ScheduleCreated

TokenAssociated

actor

UnclaimedAmountWithdrawn

Unpaused

VestingEnded

DAVINCI_ADDRESS

DAVINCI_TREASURY

MAX_FEE

associateToken

collectedFees

totalAmount

beneficiaries

totalCycles

createSchedules

exemptAccount

exemptAccounts

getConfig

maxNumberOfCycles

minCycleDuration

maxCycleDuration

maxCliffPercent

getExemptAccount

getSchedule

start

claimedAmount

owner

pause

paused

renounceOwnership

revokeExemption

transferOwnership

unpause

updateFee

vestingSchedules

withdrawFees

withdrawUnclaimedAmount


## Key Updates  

### Vesting HBAR  
- **HBAR Support**: Users can now create vesting schedules for **HBAR**, represented by `address(0)` in the contract.  
- **Seamless Integration**: HBAR vesting follows the same rules as token vesting, allowing gradual releases over time.  

&nbsp;

### Updated Schedule Creation  
- **New Structure**: Users now define **cycle duration**, **cliff duration**, and **number of cycles**, instead of specifying a total vesting duration directly.  
- **Batch Scheduling**: Users can create **up to 50 schedules in a single transaction**, optimizing large-scale vesting setups.  
- **Beneficiary Array Input**: The function argument now accepts an **array of beneficiaries**, allowing multiple vesting schedules to be created at once. However, **each schedule still belongs to only one beneficiary**, just as in V1.  
- **Each Beneficiary Entry Includes**:  
	- **Account ID** (the beneficiary receiving the vested tokens)  
	- **Total Amount** (the full allocation for that specific schedule)  
	- **Cliff Amount** (if applicable, the amount released at the cliff stage before cycles begin)  

&nbsp;


### Fee Management  
- **DAVINCI Fee Currency**: Fees for creating schedules are now exclusively payable in the **DAVINCI** token, supporting the platform's native utility token.  
- **Fee Structure**:  
	- **Maximum Schedule Fee**: 200 DAVINCI for creating a vesting schedule.  
	- **Withdrawal Fee**: Set at **one-tenth** of the schedule creation fee.  
	- **Batch Scheduling**: While multiple schedules can be created in one call, **each schedule is charged individually**.  

&nbsp;


### Cliff Periods  
- **New Optional Feature**: Vesting schedules can now include a **cliff period**, a designated amount and duration that precedes the standard vesting cycles.  
- **Independent Parameters**: The **cliff amount** and **cliff duration** are separate from the vesting schedule's cycle-based releases, offering more control over initial token distributions. 

&nbsp;
 

### Expanded Vesting Schedule Constraints  
- **Increased Maximum Cycles**: A vesting schedule can now have up to **250 cycles** (previously 120).  
- **Cliff & Cycle Duration Rules**: Both must be at least **1 hour** and cannot exceed **10 years**.  
- **Minimum Allocation:** The amount allocated must be sufficient to cover at least one unit of the token per period.
- **Minimum Cycles:** Each vesting schedule must have at least one cycle.
- **Maximum Cliff Amount:** Cliff amount cannot be more 95% of the total vesting amount.

&nbsp;


---

&nbsp;


## Inherited Functionality 


### **DaVinciFeeChargable**  
This contract inherits all the features of **DavinciFeeChargable**, enabling seamless fee management using the **DAVINCI** token:  
- **Fee Updates**: The contract owner can update the schedule creation fee, capped at 200 DAVINCI.  
- **Treasury Withdrawals**: Collected fees can only be withdrawn to the DAVINCI token treasury account.  
- **Fee Exemptions**: Accounts, including other contracts, can be exempted from paying fees, with the ability to revoke exemptions when necessary.  

&nbsp;


### **OpenZeppelin Modules**  
- **Ownable**: Ensures only the contract owner can perform administrative actions such as updating fees or pausing the contract.  
- **ReentrancyGuard**: Protects the contract from reentrancy attacks, improving the security of withdrawals.  
- **Pausable**: The contract owner can **pause schedule creation and token association**, ensuring operational control when needed.  


&nbsp;

---

&nbsp;


## Features  


### **Vesting Schedule Management**  
- **Multi-Schedule Support**: Users can create **up to 50 vesting schedules in a single transaction**, making batch scheduling more efficient.  
- **Flexible Parameters**: Users define the **cycle duration, cliff duration, and number of cycles** for their vesting schedules.  
- **Each Vesting Schedule Remains Independent**: Although the creation function accepts an array of beneficiaries, **each schedule is defined separately and assigned to one beneficiary**.  

&nbsp;


### **Token & HBAR Vesting**  
- **User-Controlled Vesting**: Users specify the **vesting cycles, token amount, and release schedule**.  
- **Cliff Feature**: Enables a dedicated **initial lock period** before standard cycle-based vesting begins.  

&nbsp;


### **Withdrawal Functionality**  
- **Progressive Releases**: Users can withdraw tokens as they vest over time, ensuring gradual distribution.  
- **Optimized Fees**: Withdrawal fees are capped at **one-tenth** of the schedule creation fee.  

&nbsp;


---

&nbsp;


## Enforced Rules  
1. **No NFTs**: Non-fungible tokens (NFTs) cannot be associated with the contract.  
2. **No Custom Fees**: Tokens with custom fees are not supported, ensuring predictable transaction costs.  
3. **Fee Schedule Key Tokens**: Tokens with **fee schedule keys** are supported, but withdrawal limitations apply if custom fees are introduced after locking.  

&nbsp;


---

&nbsp;


With these enhancements, **TokenVesting V2** provides increased flexibility, scalable batch scheduling, and secure operations, making it a powerful solution for structured token releases on the **DaVinciGraph** platform.
		

The Token Vesting Contract is engineered to manage the timed distribution of tokens to specific recipients under predefined conditions. It allows beneficiaries to withdraw allocated tokens in a structured manner over a set period, ensuring a gradual release of tokens. The contract features the ability to define vesting schedules, allocate tokens to different recipients, and initiate the vesting process. Beneficiaries can claim their vested tokens after each vesting milestone is reached. This contract is ideal for managing employee incentives, long-term project allocations, or any scenario requiring phased token distribution.

DaVinciGraph Token Vesting

Disclaimer

New Vesting Schedule