Skip to content

Add emergency pause runbook - #513

Merged
Chucks1093 merged 5 commits into
accesslayerorg:mainfrom
wheval:docs/emergency-pause-usage
Jun 28, 2026
Merged

Chucks1093 merged 5 commits into
accesslayerorg:mainfrom
wheval:docs/emergency-pause-usage

Conversation

@wheval

@wheval wheval commented Jun 27, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds docs/emergency-pause-runbook.md — a step-by-step guide for using the contract's pause / unpause admin mechanism

The runbook covers:

  • Conditions that justify an emergency pause (active exploit, critical bug, treasury drain, unauthorized admin change)
  • What is blocked vs. what stays live while paused (all write paths blocked; all get_*/is_* views continue to work)
  • How to invoke pause via Stellar CLI and JS SDK, with a verification step
  • Steps to take while paused: snapshot state, reproduce in a fork, fix, deploy via upgrade, test on testnet first
  • Criteria that must all be met before calling unpause (fix deployed and verified, affected users identified, post-mortem ready)
  • An explicit warning against unpausing without a deployed fix

Closes #490

Document when to use the contract's pause/unpause mechanism, how to invoke
it via CLI and JS SDK, what operations are blocked vs. still available while
paused, steps to take while paused (snapshot, reproduce, fix, upgrade), and
the criteria that must hold before calling unpause.

Closes accesslayerorg#490
@drips-wave

drips-wave Bot commented Jun 27, 2026

Copy link
Copy Markdown

@wheval 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

wheval added 4 commits June 28, 2026 16:13
try_register_creator now takes 5 arguments but tests in
max_supply_zero_rejected.rs were calling it with 4, causing CI to fail
with E0061. Added &None as the curve_preset argument to all 6 call sites.
All 5-arg call sites now use the multi-line argument style to satisfy
the rustfmt format check in CI.
…upstream

Merges upstream/main (adds 3 new test files) and fixes the 4-arg
register_creator call in holder_count_unchanged_after_supply_cap_exceeded.rs
so CI compiles cleanly.
@Chucks1093
Chucks1093 merged commit 1f85a73 into accesslayerorg:main Jun 28, 2026
1 check 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.

Add docs for emergency pause recommended usage and steps to resume safely

2 participants