Implement Token Vesting Contract

[Jagadeeshftw]

Description
Develop a vesting contract/module with a time-locked release mechanism that can be used for treasury vesting schedules and grant disbursement. The implementation should support a beneficiary, total allocation, start time, cliff, vesting duration, and claim operation.

Requirements and context

• Must be secure, tested, and documented.
• Should be efficient and easy to review.
• Include clear invariant checks: vested amount is monotonic and never exceeds allocation.
• Add event(s): VestingCreated, VestingClaimed, VestingRevoked (if revocation is supported).
• Use the project’s stack and conventions (Soroban/Rust), not Solidity/JS.

Suggested execution

• Fork the repo and create a branch: git checkout -b feature/token-vesting
• Implement changes:
  • Add vesting data model and storage keys.
  • Add create/claim/read methods.
  • Add time-based release math with cliff and end cap.
  • Add auth rules for creator/admin/beneficiary.
• Write comprehensive tests (unit + integration style in current Rust test setup).
• Add documentation (vesting.md) with usage examples and edge-case behavior.
• Include Rust doc comments for public functions and security assumptions.
• Run tests, capture output, and include security notes in PR.

Example commit message
feat: implement token vesting with tests and docs

Guidelines

• Minimum 95 percent test coverage.
• Clear documentation.
• Timeframe: 96 hours.

[greatest0fallt1me]

Hello Maintainers 👋,
I’m interested in picking up this issue and contributing to the project.
I have solid experience working across both frontend and blockchain layers, including building user interfaces with Next.js and developing Stellar smart contracts using Rust (Soroban). I’m familiar with translating Figma designs into pixel-accurate UIs, handling wallet integrations, and writing efficient, well-tested contract logic.
I focus on writing clean, maintainable code, following repository standards, and keeping communication transparent throughout the development process. I can start immediately and complete the work within the expected timeframe.
Excited to collaborate and add value to the project 🚀
Thank you!

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[JoaquinSkorg]

@JoaquinSkorg has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hello maintainer, I'd like to work on this issue. I have experience in working on Vesting contracts, and one can be found on my git.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @JoaquinSkorg to this issue.

[drips-wave]

Congratulations, @JoaquinSkorg! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @JoaquinSkorg: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊