Skip to content

feat(multisig): implement time-locked multisig policies in builder UI and CLI - #1041

Merged
Nanle-code merged 1 commit into
Nanle-code:masterfrom
ibrahimmujidah1-stack:feat/768-timelocked-multisig-policies
Sep 25, 2026
Merged

Nanle-code merged 1 commit into
Nanle-code:masterfrom
ibrahimmujidah1-stack:feat/768-timelocked-multisig-policies

Conversation

@ibrahimmujidah1-stack

Copy link
Copy Markdown

Summary

Implements time-locked multi-signature policies for delayed execution and governance safety:

  • Time-Lock Policy Engine (\src/utils/multisig_builder.rs):
    • Adds \TimelockPolicy\ (\min_delay_seconds, \execution_window_seconds, \unlock_at, \expires_at) to \Proposal.
    • Implements \ imelock_status()\ evaluating current execution state (\CollectingSignatures, \Locked, \ReadyToExecute, \Expired).
    • Implements \can_execute()\ checking signature thresholds, validity periods, and mandatory timelock delays.
  • CLI Flags & Enforcement (\src/commands/multisig_builder.rs):
    • \starforge multisig create: Added --timelock-delay \ and --execution-window .
    • \starforge multisig view\ & \status: Displays timelock parameters, unlock dates, and execution countdowns.
    • \starforge multisig is-ready\ & \submit: Enforces \can_execute()\ to prevent premature submissions before timelock expiry.
  • Unit Tests: Full test suite covering locked proposals, execution eligibility after delay, and expiration outside execution windows.
  • Documentation (\docs/TIMELOCKED_MULTISIG.md): Reference guide on timelock policies, states, and CLI usage.

Closes #768

@drips-wave

drips-wave Bot commented Sep 25, 2026

Copy link
Copy Markdown

@ibrahimmujidah1-stack Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

… and CLI

- Add TimelockPolicy and TimelockExecutionStatus to Proposal in src/utils/multisig_builder.rs
- Enforce mandatory timelock delay and execution window checks via proposal.can_execute()
- Add --timelock-delay and --execution-window CLI flags to 'starforge multisig create' in src/commands/multisig_builder.rs
- Display timelock delay, unlock timestamps, and real-time execution status in view and status commands
- Enforce timelock delays during 'starforge multisig is-ready' and 'starforge multisig submit'
- Add comprehensive unit tests covering timelock lifecycle (Locked, ReadyToExecute, Expired)
- Document time-lock policy mechanics and CLI examples in docs/TIMELOCKED_MULTISIG.md

Closes Nanle-code#768
@ibrahimmujidah1-stack
ibrahimmujidah1-stack force-pushed the feat/768-timelocked-multisig-policies branch from 7e86807 to 09cb528 Compare September 25, 2026 08:29
@Nanle-code
Nanle-code merged commit 9568d5a into Nanle-code:master Sep 25, 2026
17 of 44 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Advancement] Implement time-locked multisig policies in builder UI/CLI

2 participants