Upstream Updates - Mon Oct 6 00:15:54 UTC 2025 #1355
Description
SIMD
Opened
Closed
- SIMD-0359: Poseidon Syscall - Enforce Input Length solana-foundation/solana-improvement-documents#367
- SIMD-0337: Markers for Alpenglow Fast Leader Handover solana-foundation/solana-improvement-documents#337
- SIMD-0312: CreateAccountAllowPrefund solana-foundation/solana-improvement-documents#312
Agave Wiki
ebb1787565e4ada3e8d5f504efcd665eaa185e6a^..fc352b2c151b5c0de734dc5741e96e856c1f8a81
diff --git a/2025-10-01-Testnet-rollback-and-restart.md b/2025-10-01-Testnet-rollback-and-restart.md
new file mode 100644
index 0000000..4f6591b
--- /dev/null
+++ b/2025-10-01-Testnet-rollback-and-restart.md
@@ -0,0 +1,122 @@
+***
+This testnet restart is NOT urgent. Follow these instructions when you have time, but don't skip sleep or disrupt other plans for this.
+
+## Summary
+|Attribute|Value|
+|---------|-----|
+|Ledger tool version|v3.0.4|
+|Validator version|Agave: v2.3.11 </br> Frankendancer: v0.708.20306|
+|Snapshot slot|361144648|
+|Restart slot|361144649|
+|Shred version|41708|
+|Expected bank hash|4NuNyboT36pwwGJvMPZLreFqYpkbpBjX82nkt4AkJ9QT|
+
+## Step 1. Stop the validator process if you haven't already
+
+## Step 2: Install the correct version of agave-ledger-tool
+This is necessary to create the correct snapshot in step 3.
+
+Build Agave v3.0.4. Build instructions are available here: https://docs.anza.xyz/cli/install#build-from-source
+
+Confirm that `agave-ledger-tool --version` shows version v3.0.4
+
+## Step 3. Create snapshot
+This command creates a snapshot but removes 4 activated feature gate account.
+
+ agave-ledger-tool --ledger <ledger-path> create-snapshot n+ --incremental n+ --snapshots <snapshot-path> n+ --hard-fork 361144648 n+ --deactivate-feature-gate n+ htsptAwi2yRoZH83SKaUXykeZGtZHgxkS2QwW1pssR8 n+ turbnbNRp22nwZCmgVVXFSshz7H7V23zMzQgA46YpmQ n+ --enable-capitalization-change n+ -- 361144648 <snapshot-path>
+
+
+The output should include this at (or near) the end:
+```
+ Successfully created snapshot for slot 361144649, hash 4NuNyboT36pwwGJvMPZLreFqYpkbpBjX82nkt4AkJ9QT, base slot: <BASE_SLOT>: /home/sol/ledger-snapshots/incremental-snapshot-<BASE_SLOT>-361144649-<SNAPSHOT_HASH>.tar.zst
+ Capitalization change: -1907040 lamports
+ Shred version: 41708
+```
+
+The capitalization change is expected because we deactivated a feature gate.
+
+Note that each operator's snapshot file name may contain different base slot number and hash, but
+* the bank hash should be 4NuNyboT36pwwGJvMPZLreFqYpkbpBjX82nkt4AkJ9QT
+* the second slot number should be 361144649
+* the shred version should be 41708
+
+Once you have created a snapshot move all the other snapshots to a backup directory, so your snapshot directory contains one full snapshot and one incremental snapshot. Note that the <BASE_SLOT> in these two filenames should match.
+
+ snapshot-<BASE_SLOT>-<BASE_SNAPSHOT_HASH>.tar.zst
+ incremental-snapshot-<BASE_SLOT>-361144649-<SNAPSHOT_HASH>.tar.zst
+
+If you fail to create a snapshot see the appendix for possible fixes.
+
+## Step 4: Install Restart Version
+This is the version we want to use to restart the cluster.
+
+Agave: `agave-install init v2.3.11`
+
+Frankendancer: Install `v0.708.20306`
+
+## Step 5: Update startup config and start your validator
+### Agave
+Add these arguments to your validator startup script:
+
+ --wait-for-supermajority 361144649 n+ --expected-shred-version 41708 n+ --expected-bank-hash 4NuNyboT36pwwGJvMPZLreFqYpkbpBjX82nkt4AkJ9QT n+
+
+As it starts, the validator will load the snapshot for slot `361144649` and wait for 80% of the stake to come online before producing/validating new blocks.
+
+To confirm your restarted validator is correctly waiting for 80% stake, look for this periodic log message to confirm it is waiting:
+
+ INFO solana_core::validator] Waiting for 80% of activated stake at slot 361144649 to be in gossip...
+
+And if you have RPC enabled, ask it for the current slot:
+
+ solana --url http://127.0.0.1:8899 slot
+
+Any number other than `361144649` means you did not complete the steps correctly.
+
+Once started you should see log entries for “active stake” visible in gossip and “waiting for 80% of stake” to be visible. You can track these to see how the stake progresses.
+
+
+***
+
+## Appendix (use this only if step 3 failed)
+
+If you get an error like this:
+
+ Error: Slot 361144648 is not available
+
+Or this:
+
+ Unable to process blockstore from starting slot <slot> to 361144648; the ending slot is less than the starting slot. The starting slot will be the latest snapshot slot, or genesis if the --no-snapshot flag is specified or if no snapshots are found.
+
+Your snapshots directory contains a snapshot that is for a slot `>361144648`. If you also have a snapshot for slot `<=361144648` then move snapshots for slots `>361144648` to a backup directory and run the `agave-ledger-tool` command again. If you do not have a snapshot for slot `<=361144648` then you will need to download a snapshot
+
+If you successfully created a snapshot, resume the instructions above starting at Step 4. If you are unable to create a snapshot, follow the instructions below on downloading a snapshot.
+
+If you could not produce your snapshot locally follow these appendix steps
+
+### Step 1: Download a snapshot from a known validator
+
+If you are unable to generate a snapshot locally for slot `361144649` you will need to download one from a known validator. Add these lines to your startup script.
+
+ --known-validator 5D1fNXzvv5NjV1ysLjirC4WY92RNsVH18vjmcszZd8on n+ --expected-shred-version 41708 n+
+Remove the flag `--no-snapshot-fetch` in your startup script if it is present.
+
+### Step 2: After download, restart
+
+Verify that you have a new snapshot in your snapshot directory. If the snapshot is done downloading, stop your validator process.
+
+Add the flag `--no-snapshot-fetch` to your startup script
+
+Resume the instructions above starting at Step 4.
No newline at end of file
diff --git a/Feature-Gate-Tracker-Schedule.md b/Feature-Gate-Tracker-Schedule.md
index 158e03d..028343c 100644
--- a/Feature-Gate-Tracker-Schedule.md
+++ b/Feature-Gate-Tracker-Schedule.md
@@ -18,13 +18,14 @@ The version floor is the current minimum supported software version for a cluste
### Pending Devnet Activation
| Key | SIMD | Agave Version | FD Version | Jito Version | Testnet | Devnet | Description | Owner |
|-----|------|---------------|------------|--------------|---------|--------|-------------|-------|
+| turbnbNRp22nwZCmgVVXFSshz7H7V23zMzQgA46YpmQ | | v2.2.8 | v0.708.20306 | | 846 | | disable turbine fanout experiment | bw-solana |
### Pending Testnet Activation
| Key | SIMD | Agave Version | FD Version | Jito Version | Testnet | Devnet | Description | Owner |
|-----|------|---------------|------------|--------------|---------|--------|-------------|-------|
-| turbnbNRp22nwZCmgVVXFSshz7H7V23zMzQgA46YpmQ | | v2.2.8 | | | | | disable turbine fanout experiment | bw-solana |
-| DeS7sR48ZcFTUmt5FFEVDr1v1bh73aAbZiZq3SYr8Eh8 | 0186 | v2.3.0 | | | | | Feature Gate: Loaded Transaction Data Size Specification | 2501babe |
-| 7VVhpg5oAjAmnmz1zCcSHb2Z9ecZB2FQqpnEwReka9Zm | 0242 | v2.3.0 | | | | | SIMD-0242: Static Nonce Account Only | jstarry |
+| DeS7sR48ZcFTUmt5FFEVDr1v1bh73aAbZiZq3SYr8Eh8 | 0186 | v2.3.0 | v0.709.30000 | | | | Feature Gate: Loaded Transaction Data Size Specification | 2501babe |
+| 7VVhpg5oAjAmnmz1zCcSHb2Z9ecZB2FQqpnEwReka9Zm | 0242 | v2.3.0 | v0.709.30000 | | | | SIMD-0242: Static Nonce Account Only | jstarry |
| C37iaPi6VE4CZDueU1vL8y6pGp5i8amAbEsF31xzz723 | 0219 | | | | | | Stricter ABI and Runtime Constraints | Lichtso |
+| ENTRYnPAoT5Swwx73YDGzMp3XnNH1kxacyvLosRHza1i | 0083 | v2.3.0 | v0.709.30000 | | | | Relax intrabatch account locks | 2501babe |
| 6TkHkRmP7JZy1fdM6fg5uXn76wChQBWGokHBJzrLB3mj | 0268 | | | | | | SIMD-0268: Raise CPI Nesting Limit | buffalojoec |
diff --git a/_Sidebar.md b/_Sidebar.md
index 9d65edc..56faba6 100644
--- a/_Sidebar.md
+++ b/_Sidebar.md
@@ -20,4 +20,4 @@
* **Migration**
* [Agave v2.0 Migration](Agave-v2.0-Transition-Guide)
* **Restart Instructions**
- * [2025-07-02 Testnet Restart](2025-07-02-Testnet-Rollback-and-Restart)
+ * [2025-10-01 Testnet Restart](2025-10-01-Testnet-rollback-and-restart)
diff --git a/feature-gate-tracker-schedule.json b/feature-gate-tracker-schedule.json
index 2d29ad3..04a280e 100644
--- a/feature-gate-tracker-schedule.json
+++ b/feature-gate-tracker-schedule.json
@@ -1402,7 +1402,7 @@
"Title": "Increase Account Limit to 40% of Block CU"
}
],
- "3 - Ready for Testnet": [
+ "2 - Ready for Devnet": [
{
"Comms Required": null,
"Description": null,
@@ -1412,7 +1412,7 @@
"v2.2.8"
],
"Min FD Versions": [
- ""
+ "v0.708.20306"
],
"Min Jito Versions": [
""
@@ -1427,10 +1427,12 @@
"SIMDs": [
""
],
- "Status": "3 - Ready for Testnet",
- "Testnet Epoch": "",
+ "Status": "2 - Ready for Devnet",
+ "Testnet Epoch": 846,
"Title": "disable turbine fanout experiment"
- },
+ }
+ ],
+ "3 - Ready for Testnet": [
{
"Comms Required": null,
"Description": null,
@@ -1440,7 +1442,7 @@
"v2.3.0"
],
"Min FD Versions": [
- ""
+ "v0.709.30000"
],
"Min Jito Versions": [
""
@@ -1468,7 +1470,7 @@
"v2.3.0"
],
"Min FD Versions": [
- ""
+ "v0.709.30000"
],
"Min Jito Versions": [
""
@@ -1515,6 +1517,34 @@
"Testnet Epoch": "",
"Title": "Stricter ABI and Runtime Constraints"
},
+ {
+ "Comms Required": null,
+ "Description": null,
+ "Devnet Epoch": null,
+ "Feature ID": "ENTRYnPAoT5Swwx73YDGzMp3XnNH1kxacyvLosRHza1i",
+ "Min Agave Versions": [
+ "v2.3.0"
+ ],
+ "Min FD Versions": [
+ "v0.709.30000"
+ ],
+ "Min Jito Versions": [
+ ""
+ ],
+ "Owners": [
+ "2501babe"
+ ],
+ "Planned Testnet Order": "",
+ "SIMD Links": [
+ "https://github.com/solana-foundation/solana-improvement-documents/blob/main/proposals/0083-relax-entry-constraints.md"
+ ],
+ "SIMDs": [
+ "0083"
+ ],
+ "Status": "3 - Ready for Testnet",
+ "Testnet Epoch": "",
+ "Title": "Relax intrabatch account locks"
+ },
{
"Comms Required": null,
"Description": null,
@@ -1870,34 +1900,6 @@
"Testnet Epoch": "",
"Title": "Feature Gate: Enables deployment and execution of SBPFv3 programs"
},
- {
- "Comms Required": null,
- "Description": null,
- "Devnet Epoch": null,
- "Feature ID": "EbAhnReKK8Sf88CvAfAXbgKji8DV48rsp4q2sgHqgWef",
- "Min Agave Versions": [
- ""
- ],
- "Min FD Versions": [
- "v0.709.30000"
- ],
- "Min Jito Versions": [
- ""
- ],
- "Owners": [
- "2501babe"
- ],
- "Planned Testnet Order": "",
- "SIMD Links": [
- "https://github.com/solana-foundation/solana-improvement-documents/blob/main/proposals/0083-relax-entry-constraints.md"
- ],
- "SIMDs": [
- "0083"
- ],
- "Status": null,
- "Testnet Epoch": "",
- "Title": "Relax intrabatch account locks"
- },
{
"Comms Required": null,
"Description": null,
@@ -2005,6 +2007,34 @@
"Status": null,
"Testnet Epoch": "",
"Title": "SIMD-0204: Enable slashable event verification"
+ },
+ {
+ "Comms Required": null,
+ "Description": null,
+ "Devnet Epoch": null,
+ "Feature ID": null,
+ "Min Agave Versions": [
+ ""
+ ],
+ "Min FD Versions": [
+ ""
+ ],
+ "Min Jito Versions": [
+ ""
+ ],
+ "Owners": [
+ "buffalojoec"
+ ],
+ "Planned Testnet Order": "",
+ "SIMD Links": [
+ ""
+ ],
+ "SIMDs": [
+ ""
+ ],
+ "Status": null,
+ "Testnet Epoch": "",
+ "Title": "SIMD-0321: Instruction Data Pointer in VM Register 2"
}
]
}
diff --git a/v3.0-Release-Schedule.md b/v3.0-Release-Schedule.md
index 264b6bb..a3bad40 100644
--- a/v3.0-Release-Schedule.md
+++ b/v3.0-Release-Schedule.md
@@ -8,8 +8,8 @@ This is a tentative schedule for the stabilization and rollout of Agave <VERSION
|4|2025-08-25|2025-09-07|Devnet: Upgrade to v3.0.|
|5|2025-09-01|||
|6|2025-09-08|||
-|7|2025-09-22||Tag Mainnet-beta Upgrade Candidate (MUC) on v3.0 branch.|
-|8|2025-09-29||Testnet: Live downgrade to v2.3.*, upgrade to MUC (100%). <br/>Mainnet-beta: Ask for volunteers to take 10% of stake to to v3.0|
+|7|2025-09-22|2025-09-09|Tag Mainnet-beta Upgrade Candidate (MUC) on v3.0 branch.|
+|8|2025-09-29|2025-10-01|Testnet: Live downgrade to v2.3.*, upgrade to MUC (100%). <br/>Mainnet-beta: Ask for volunteers to take 10% of stake to to v3.0|
|9|2025-10-06||Mainnet-beta: Ask for volunteers to take 25% of stake to v3.0|
|10|2025-10-13||Mainnet-beta: Recommend all nodes upgrade to v3.0|
|11|2025-10-20||Create v3.1 branch|
No newline at end of file