Skip to content

Commit a90be3f

Browse files
Merge pull request #1297 from Emmanuellsensai/feat/mainnet-sign-off-addendum-1140
feat: add mainnet sign-off addendum to RELEASE_CHECKLIST.md (#1140)
2 parents 85335e3 + 0d94717 commit a90be3f

1 file changed

Lines changed: 77 additions & 6 deletions

File tree

RELEASE_CHECKLIST.md

Lines changed: 77 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,84 @@ This document describes the steps required to publish a new release of Sanctifie
4949
- [ ] Verify https://docs.rs/sanctifier-cli shows the new version
5050
- [ ] Announce the release in relevant channels
5151

52-
## Mainnet Release Candidate Cutover Addendum (#1140)
52+
## Mainnet Release Addendum (#1140)
5353

54-
- [ ] Verify all Mainnet Launch Readiness milestone issues are resolved or explicitly deferred
55-
- [ ] Create and complete a `mainnet-signoff` issue using the `.github/ISSUE_TEMPLATE/mainnet_signoff.md` template
56-
- [ ] Ensure 2 named approvers sign off on the mainnet sign-off issue
57-
- [ ] Verify read-only mainnet fork CI job (`.github/workflows/mainnet-fork-ci.yml`) is passing
58-
- [ ] Freeze `v1.0.0-mainnet` release candidate and publish release notes
54+
> **⚠️ This addendum is mandatory for any release tagged `v1.0.0-mainnet*`.**
55+
> It MUST be completed, filled out with named sign-offs, and attached as a comment to the release PR **before** the release tag is pushed.
56+
57+
This addendum layers an additional non-skippable sign-off gate on top of the general release checklist. Mainnet releases carry materially higher stakes and require explicit, named approval against every relevant mainnet-readiness criterion.
58+
59+
### Prerequisites
60+
61+
Before the sign-off can be completed, the following must all be satisfied:
62+
63+
- [ ] All issues in the [Mainnet Launch Readiness milestone](https://github.com/HyperSafeD/Sanctifier/milestones) are resolved or explicitly deferred with a documented rationale.
64+
- [ ] The [`mainnet-fork-ci`](.github/workflows/mainnet-fork-ci.yml) workflow is passing on the release candidate branch.
65+
- [ ] The release candidate branch has been frozen and is receiving only blocker fixes.
66+
67+
### Sign-Off Checklist
68+
69+
Each of the following items must be reviewed and signed off by **two named individuals** (the Release Manager and at least one independent Second Reviewer). Place an `X` in the checkbox and write your name & date below each item.
70+
71+
```
72+
Example:
73+
- [X] **Release Manager:** Alice Smith — 2026-07-28
74+
- [X] **Second Reviewer:** Bob Chen — 2026-07-28
75+
```
76+
77+
---
78+
79+
**1. Security checklist (`SECURITY.md` addendum) — #1115**
80+
81+
Verify that the mainnet security checklist published in `SECURITY.md` has been reviewed and all applicable items are satisfied.
82+
83+
- [ ] **Release Manager:**
84+
- [ ] **Second Reviewer:**
85+
86+
---
87+
88+
**2. Formal-verification (Kani + Z3) coverage — #1114**
89+
90+
Confirm that a full formal-verification pass using Kani has been completed on every contract in scope. See [`docs/kani-integration.md`](docs/kani-integration.md) for the integration strategy and `contracts/kani-poc/` for proof-harness examples.
91+
92+
- [ ] **Release Manager:**
93+
- [ ] **Second Reviewer:**
94+
95+
---
96+
97+
**3. Rollback / circuit-breaker procedure — #1137**
98+
99+
Confirm that a documented rollback and circuit-breaker procedure exists and has been reviewed for failed mainnet deployments. See [`ROLLBACK_PROCEDURE.md`](./ROLLBACK_PROCEDURE.md) for the full procedure.
100+
101+
- [ ] **Release Manager:**
102+
- [ ] **Second Reviewer:**
103+
104+
---
105+
106+
**4. External security audit — #1112**
107+
108+
Confirm that an external smart-contract security audit has been completed and all critical/high findings are resolved or explicitly accepted with a risk rationale.
109+
110+
- [ ] **Release Manager:**
111+
- [ ] **Second Reviewer:**
112+
113+
---
114+
115+
**5. Bug bounty program — #1116**
116+
117+
Confirm that the bug bounty program (Immunefi / HackenProof) is live and accepting submissions before the mainnet release tag is cut.
118+
119+
- [ ] **Release Manager:**
120+
- [ ] **Second Reviewer:**
121+
122+
---
123+
124+
**6. Deployment safety — #1133, #1134, #1135**
125+
126+
Confirm that the `--confirm-mainnet` safety flag is enforced in deploy tooling, the end-to-end deployment runbook is complete, and a dry-run has passed.
127+
128+
- [ ] **Release Manager:**
129+
- [ ] **Second Reviewer:
59130

60131
## Rollback (if needed)
61132

0 commit comments

Comments
 (0)