[Contract] Implement Token Lock/Unlock and Ownership Percentage

[yusuftomilola]

Allows token holders to be temporarily locked (e.g. during a voting window or vesting period), preventing token transfers.

Requirements

lock_tokens(env, asset_id, holder, until_timestamp) — Stores a lock record for the holder until the given ledger timestamp.

unlock_tokens(env, asset_id, holder) — Removes the lock record.

Transfer gate: In transfer_tokens, before executing, check if the from address has an active lock. If env.ledger().timestamp() < lock.until_timestamp, return Error::TokensLocked.

is_tokens_locked(env, asset_id, holder) — Read-only check.

Acceptance Criteria

• Locked tokens cannot be transferred
• Lock expires automatically when timestamp passes (checked in transfer)
• unlock_tokens clears the lock regardless of timestamp

[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

[supreme2580]

@supreme2580 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi can I be assigned to this?

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

[0xOlivanode]

@0xOlivanode has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi, I’m Olivia Immanuel, a smart contract developer with experience in Solidity, Cairo, and Rust. I’m interested in this issue and would love to be assigned to work on it.

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

[Jayking40]

@Jayking40 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I'd like to work on this issue. I have strong experience with rust, nestjs, next.js, react and can deliver a clean, well-tested implementation.

My approach:

1. Analyze the existing codebase and understand the current architecture
2. Implement the solution following project conventions and patterns
3. Write comprehensive tests and ensure all existing tests pass
4. Submit a clean PR with clear documentation

ETA: within 24 hours

I'm available to start immediately and can provide regular progress updates.

GitHub: @Jayking40

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

[SamixYasuke]

@SamixYasuke has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hello, I'd love to work on this

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

[7maylord]

@7maylord has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi, i can work on this issue, please assign it to me

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