Timelock and Scheduled Actions Contract

[Mkalbani]

Location: contracts/timelock
Labels: smart-contract, soroban, good first issue
Estimated Time: 7 hours
Difficulty: Medium

Description

Implement a timelock contract for scheduling future actions, delayed transactions, and governance execution delays.

Tasks

• Design timelock queue data structure
• Implement action scheduling system
• Add minimum delay enforcement
• Create action execution after delay
• Implement action cancellation
• Add multi-signature requirement for execution
• Create grace period for execution window
• Write timelock flow tests
• Add event emission for scheduled actions
• Implement admin emergency override

Acceptance Criteria

• Actions scheduled with delays
• Minimum delays enforced
• Execution only after timelock
• Cancellations work before execution
• Multi-sig validation required
• Contract deployed to testnet

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 150 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

[soomtochukwu]

@soomtochukwu has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi @Mkalbani, I'd resolve #59 by implementing a secure Soroban Timelock contract with queue-based action scheduling, enforced min delay/grace periods, execution/cancellation flows, multi-sig validation, admin emergency override, full event emission, and comprehensive unit/integration tests.

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

[rainwaters11]

@rainwaters11 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi! I'm a full-stack Web3 dev with Soroban, Solidity, and Rust experience, and have contributed to open-source projects including WIEP. I'd love to tackle #59 - implementing the timelock contract with action scheduling, multi-sig approvals, delay enforcement, and comprehensive testing. Ready to start immediately and deliver!

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

[bakarezainab]

@bakarezainab has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi, I would like to work on this issue. I’ve contributed to the Stellar ecosystem and I’m a security researcher with experience building and auditing Soroban smart contracts. I can implement a secure timelock contract for scheduled actions and governance delays, with clear state transitions, proper access control, and an auditable design

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

[Sam-Rytech]

@Sam-Rytech has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’d like to work on this issue. I have experience building Soroban smart contracts, implementing delayed execution logic, and managing secure storage patterns for scheduled actions. I am very familiar with integrating multi-signature requirements and enforcing strict governance windows on-chain. I’m available to start immediately. Thank you for considering.

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

[Samuel1505]

@Samuel1505 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I would like to work on this issue, I'm a software developer with experience in Rust and soroban. Kindly assign me

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

[gregemax]

@gregemax has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi I’d like to apply for the Timelock Soroban contract.

I’ll implement a secure timelock with queued actions, enforced minimum delays, execution windows with grace periods, cancellation support, and multi-sig validation. I’ll add event emission, emergency admin override, full timelock flow tests, and deploy the contract to testnet to meet all acceptance criteria.

Happy to start ETA 4 hours

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

[Obiajulu-gif]

@Obiajulu-gif has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I would like to implement the Soroban timelock contract in contracts/timelock that queues actions, enforces a minimum delay, and only allows execution within a defined grace window—plus cancellation, multisig execution checks, events, and an admin emergency override.
What I will do:
Create contract + storage
Define QueuedAction struct: id, target_contract, fn_name, args, eta (execute-after timestamp), expires_at, proposer, executed, cancelled.
Store actions in a persistent map keyed by action_id.
Scheduling
schedule_action(...): validates inputs, enforces minimum delay, computes eta and expires_at (grace period), saves action, emits ActionScheduled.
Execution
execute_action(action_id, signatures/approvals): checks:
current ledger time >= eta
current ledger time <= expires_at
action not executed/cancelled
multisig threshold met (configured signers + threshold)
Performs cross-contract invocation to the target function.
Marks executed + emits ActionExecuted.

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

[dannyy2000]

@dannyy2000 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

i would like to work on this issue

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

[CMI-James]

@CMI-James has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

First time contributor to this project, I have read the issue description and I would love to take this on.

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

[Georgechisom]

@Georgechisom has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi, Please let me work on this issue, help assign it to me.

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

[KingFRANKHOOD]

@KingFRANKHOOD has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello, I’m a smart contract developer with hands-on experience building with Rust and Soroban for smart contract development.

I focus on writing clear, maintainable code and making sure features work as expected end to end, not just in isolation. I communicate progress regularly and keep things transparent as I work. I’m confident I can complete this task within an ETA of 24 hours while providing consistent updates throughout the process.

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

[Themancalledpg]

@Themancalledpg has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hi, my name is Preciousgift, and I am a fullstack and smart contract developer skilled in React, Next.js, JavaScript, TypeScript, Tailwind CSS, and Soroban. For this task, I will:
Design and implement the timelock queue data structures and scheduling logic in contracts/timelock, enforcing minimum delays and grace periods.
Build secure execution, cancellation, and emergency override functions with proper multi-signature validation for governance safety.
Add event emissions for scheduled, executed, and cancelled actions, and deploy the contract to testnet for verification.
Write comprehensive Soroban tests covering scheduling, delay enforcement, execution windows, cancellations, and multisig validation.
ETA: 10 hours

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