You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 6db111f
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/operate/run-a-signer/pox-5-upgrade-guide.md
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -64,13 +64,13 @@ For a new signer, generate the key offline with `stacks-cli make_keychain` or yo
64
64
65
65
#### Prepare the signer-manager
66
66
67
-
The signer-manager is the on-chain contract that connects stake to the signer and handles reward accounting — pool operators deploy and administer it. Because its code cannot be changed after deployment, get the source, canonical hash, wallet roles, and test results right before you go to mainnet. For the detail behind each action here, see the [PoX-5 signer integration guide](https://pox-5.vercel.app/docs/development/advanced/signers).
67
+
The signer-manager is the on-chain contract that connects stake to the signer and handles reward accounting — pool operators deploy and administer it. Because its code cannot be changed after deployment, get the source, wallet roles, and test results right before you go to mainnet. For the detail behind each action here, see the [PoX-5 signer integration guide](https://pox-5.vercel.app/docs/development/advanced/signers).
68
68
69
69
Before activation:
70
70
71
-
* Use the [mainnet reference signer-manager](https://github.com/stx-labs/signer-sidekick/blob/f0248dc0be7ab2d6f2958289f05f2b0833fa871f/contracts/reference-manager/generated/mainnet/signer-manager.clar) by default. Customize it only if your integration requires different behavior. Independently review and test any custom manager; do not deploy the unmodified `stacks-core` test fixture because it is not configured for mainnet.
72
-
*Record the expected canonical SHA-256, `7fd58a7591ff0ae1643eb7e71ea2867385bcac237a3ea819f52301310c0d2e27`, the contract name, and the intended principal.
73
-
*Use a compatible wallet, such as [Leather](https://leather.io/), for deployment. If the deployment wallet will not remain the administrator, rotate admin control to your cold wallet before registration.
71
+
* Use the [mainnet reference signer-manager](https://github.com/stx-labs/signer-sidekick/blob/11f8ff79e309db14357c4adfbbe31e1aeb7cd17e/contracts/reference-manager/generated/mainnet/signer-manager.clar) by default. Customize it only if your integration requires different behavior. Independently review and test any custom manager; do not deploy the unmodified `stacks-core` test fixture because it is not configured for mainnet.
72
+
*Verify the source you are about to deploy on the [Signer Sidekick deploy page](https://stx.fan/signer/03-deploy-manager.html), which computes three hashes of it and compares them against the reference. Use the **structure** hash: it tokenises the Clarity and ignores whitespace, comments and commas, so it still matches after `clarinet format` or any re-indentation, where the raw and canonical hashes shift for reasons unrelated to the code. The structure hash does not cover comment text.
73
+
*Record the contract name and the intended principal.
74
74
* In Signer Sidekick, select **Testnet** and complete steps 1–7 in the next section. Test your reward-claim procedure separately using the process under **Operate rewards**.
75
75
* Assign owners for rewards, accounting, monitoring, and support.
76
76
@@ -82,15 +82,15 @@ This section walks through the seven on-chain steps to bring a PoX-5 stacking po
82
82
83
83
Use [Signer Sidekick](https://stx.fan/signer/) to rehearse on **Testnet** first; select **Mainnet** only after PoX-5 is active, and confirm the network indicator on every page. Signer Sidekick is one tool; the links below open its individual steps, and the [PoX-5 signer integration guide](https://pox-5.vercel.app/docs/development/advanced/signers) covers the detail behind each one.
| 1. Preflight | Confirm the network, PoX-5 contract, balance, cycle, and signer-set minimum. |[Preflight](https://stx.fan/signer/01-connect-preflight.html); connect the admin wallet, no transaction. |
88
-
| 2. Deploy | Deploy the mainnet reference signer-manager approved for your rollout. Continue only if its canonical SHA-256 matches `7fd58a7591ff0ae1643eb7e71ea2867385bcac237a3ea819f52301310c0d2e27`.|[Deploy manager](https://stx.fan/signer/03-deploy-manager.html); deployment wallet. |
89
-
| 3. Secure admin | Add the cold admin, reconnect as that admin, then remove the temporary deployer. Never remove the last working admin. | Deploy page → **Admin rotation**; deployment wallet, then cold admin if needed. |
90
-
| 4. Generate grant | On the signer host, create the one-time signer-manager grant using a fresh `auth-id`. | Signer key; off-chain command below. |
91
-
| 5. Register | Submit `register-self` and verify that the manager resolves to the expected signer public key. |[Register-self](https://stx.fan/signer/04-register-self.html); manager admin. |
92
-
| 6. Stake | Lock STX for 1–96 cycles. The signer needs at least 50,000 STX in aggregate for the upcoming cycle; an individual stake may be smaller. |[Stake](https://stx.fan/signer/05-stake.html); staker wallet. |
93
-
| 7. Verify | Confirm registration, grant validity, assigned STX, and eligibility for the upcoming cycle. |[Rewards + status](https://stx.fan/signer/06-rewards-status.html); read-only. |
| 1. Preflight | Confirm the network, PoX-5 contract, balance, cycle, and signer-set minimum. |[Preflight](https://stx.fan/signer/01-connect-preflight.html); connect the admin wallet, no transaction. |
88
+
| 2. Deploy | Deploy the mainnet reference signer-manager approved for your rollout. Check its structure hash against the reference first. |[Deploy manager](https://stx.fan/signer/03-deploy-manager.html); deployment wallet. |
89
+
| 3. Secure admin | Add the cold admin, reconnect as that admin, then remove the temporary deployer. Never remove the last working admin. | Deploy page → **Admin rotation**; deployment wallet, then cold admin if needed. |
90
+
| 4. Generate grant | On the signer host, create the one-time signer-manager grant using a fresh `auth-id`. | Signer key; off-chain command below. |
91
+
| 5. Register | Submit `register-self` and verify that the manager resolves to the expected signer public key. |[Register-self](https://stx.fan/signer/04-register-self.html); manager admin. |
92
+
| 6. Stake | Lock STX for 1–96 cycles. The signer needs at least 50,000 STX in aggregate for the upcoming cycle; an individual stake may be smaller. |[Stake](https://stx.fan/signer/05-stake.html); staker wallet. |
93
+
| 7. Verify | Confirm registration, grant validity, assigned STX, and eligibility for the upcoming cycle. |[Rewards + status](https://stx.fan/signer/06-rewards-status.html); read-only. |
94
94
95
95
New to these actions? The [PoX-5 signer integration guide](https://pox-5.vercel.app/docs/development/advanced/signers) and [PoX-5 STX staking guide](https://pox-5.vercel.app/docs/development/solo-stx) give step-by-step detail behind each Signer Sidekick page.
96
96
@@ -150,7 +150,7 @@ Provide Stacks with the running versions, signer-manager principal, registration
For native BTC bonds or whitelisted sBTC community pools, use the separate [PoX-5 pools integration guide](https://pox-5.vercel.app/docs/development/pools).
0 commit comments