Implementation of VestraChain – Token Vesting Smart Contract

[bukas898]

📦 Summary

This PR introduces the initial version of the VestraChain Clarity smart contract, which implements a secure, identity-verified token vesting system with epoch-based release schedules. It provides all core functionality required to set up and manage vesting allocations, enforce KYC, and handle token claims on-chain.

---

🚀 Features Implemented

• Treasury-Controlled Vesting Initialization

• Creation of Vesting Schedules

  • Identity-proof (SHA256 hash)
  • Unlock epochs and token amounts
  • Schedule duplication prevention

• KYC Verification Mechanism

  • STX fee enforcement
  • Beneficiary registration tracking

• Secure Token Claiming Logic

  • Time-based unlocking using epochs
  • One-time claim enforcement
  • Proof-of-identity verification

• Claim Tracking & Event Logging

  • History of claims per beneficiary/schedule
  • Read-only event retrieval

• Admin Epoch Control

  • Updatable only by treasury manager
  • Ensures vesting progresses predictably

• Data Integrity Guards

  • Overflow checks
  • Length validations
  • Schedule ID range constraints

---

📖 Public Functions

• initialize-vesting
• create-schedule
• update-epoch
• complete-kyc
• claim-tokens

📊 Read-Only Interfaces

• get-beneficiary-status
• get-claim-events
• get-current-epoch
• get-schedule-description
• get-vesting-stats

---

🧪 Next Steps

• Write and commit unit tests for all core logic paths
• Integrate front-end for KYC and claim flows
• Deploy to testnet and conduct audit