Skip to content

Multi-sig authority rotation tutorial #129

Description

@truthixify

Tier: M (2-4 days) | Type: tutorial

Context. guides/stellar-multisig-withdrawal.mdx already has a ## Recovery Scenarios section (line 266) covering "Lost signer, threshold still reachable" (line 268), "Lost signer, threshold no longer reachable" (line 294), and "Changing the threshold" (line 302). What it does NOT cover is the operational-runbook side: staged add-then-remove for zero-downtime rotation, emergency rotation on suspected key compromise, and the auditor trail (what a rotation looks like in the announcement stream). Custodians running Wraith at scale keep asking for a scripted 2-of-3 to fresh 2-of-3 rotation with the trail annotated.

Scope.

  • New guides/stellar/multisig-authority-rotation.mdx.
  • Explicit cross-link + delta note vs the existing three recovery scenarios in stellar-multisig-withdrawal.mdx (this page picks up where those leave off).
  • Rotation without downtime: staged add-then-remove.
  • Emergency rotation on suspected compromise.
  • Auditor trail: what a rotation looks like in the announcement stream, block-by-block.
  • End-to-end scripted example rotating a 2-of-3 to a fresh 2-of-3 on futurenet.

Acceptance.

  • Example rotates a 2-of-3 to a new 2-of-3 on futurenet
  • Renders in mint dev
  • Passes Compile docs snippets CI
  • Cross-linked with stellar-multisig-withdrawal.mdx
  • Nav entry under Guides

Files. guides/stellar/multisig-authority-rotation.mdx (new), docs.json.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Stellar WaveIssues in the Stellar wave programdocsDocumentationdripsFunded via Drips Networkhelp wantedExtra attention is neededsecuritySecurity-sensitive workstellarTouches Stellar / Soroban codestellar-waveAuto-created for Wave 8wave-8Auto-created for Wave 8writing

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions