Protocol Upgrade List

The tables below provide a list of past and upcoming protocol upgrades.

For more detailed information about what upgrades are, how they work, and what changes they bring to the protocol, please refer to our upgrade overview page.

Best Effort Document

This document is a best effort attempt to keep track of all protocol upgrades.

It should not be treated as the source of truth.

See pocketd query upgrade --help to query onchain upgrade information.

Legend

• ✅ - Yes

• ❌ - No

• ❓ - Unknown/To Be Determined

• ⚠️ - Warning/Caution Required

MainNet Protocol Upgrades

Version	Planned (✅ / ❌ / ⚠️)	Breaking (✅ / ❌)	Requires Manual Intervention (❌ / ⚠️)	Upgrade Height
v0.1.29	✅	✅	❌	382250
v0.1.28	✅	✅	❌	287932
v0.1.27	✅	✅	❌	247893
v0.1.26	✅	✅	❌	190979
v0.1.25	✅	✅	❌	190974
v0.1.24	✅	✅	❌	161169
v0.1.23	✅	✅	❌	161109
v0.1.22	✅	✅	❌	155173
v0.1.21	✅	✅	❌	139917
v0.1.20	✅	✅	❌	135297
v0.1.19	❌	✅	❌	117454
v0.1.18	✅	✅	❌	116100
v0.1.17	❌	✅	❌	102142
v0.1.16	✅	❌	❌	99293
v0.1.15	❌	✅	❌	94370
v0.1.14	✅	❌	❌	93825
v0.1.13	✅	✅	❌	80510
v0.1.12	✅	❌	❌	78697
v0.1.11	✅	✅	❌	78689
v0.1.10	✅	✅	❌	78683
v0.1.9	✅	✅	❌	78678
v0.1.8	✅	✅	❌	78671
v0.1.7	✅	❌	❌	78665
v0.1.6	✅	✅	❌	78659
v0.1.5	✅	✅	❌	78654
v0.1.4	✅	✅	❌	78641
v0.1.3	✅	✅	❌	78632
v0.1.2	✅	✅	❌	78621
v0.1.1	✅	✅	❌ (genesis version)	0

Beta TestNet Protocol Upgrades

Version	Planned (✅ / ❌ / ⚠️)	Breaking (✅ / ❌)	Requires Manual Intervention (❌ / ⚠️)	Upgrade Height
v0.1.29	✅	✅	⚠️	306578
v0.1.28	✅	✅	❌	224625
v0.1.27	✅	✅	❌	168840
v0.1.26	✅	✅	❌	127361
v0.1.25	✅	✅	❌	127357
v0.1.24	✅	✅	❌	97190
v0.1.23	✅	✅	❌	93477
v0.1.22	✅	✅	❌	TBD
v0.1.21	✅	✅	❌	74806
v0.1.20	✅	✅	❌	61373
v0.1.19	❌	✅	❌	53991
v0.1.18	✅	✅	❌	52544
v0.1.17	❌	✅	❌	32910
v0.1.16	✅	❌	❌	36073
v0.1.15	❌	✅	❌	31207
v0.1.14	✅	❌	❌	30539
v0.1.13	✅	✅	❌	16745
v0.1.12	❌	❌	❌	14812
v0.1.12	✅	❌	⚠️ FAILED UPGRADE ⚠️ MANUAL CHANGES MIGHT BE REQUIRED. SEE UPGRADE NOTES.	14790
v0.1.11	✅	✅	❌	11100
v0.1.7	✅	❌	❌	6388
v0.1.6	✅	✅	❌	6110
v0.1.5	✅	✅	❌	5831
v0.1.4	✅	✅	❌	4596
v0.1.3	✅	✅	❌	4022
v0.1.2	✅	✅	❓	TBA
v0.1.1	✅	✅	❌	TODO(@okdas)
v0.0.12	✅	✅	❌	TODO(@okdas)
v0.0.11-rc	N/A	N/A	❌ (genesis version)	0

Alpha TestNet Protocol Upgrades

TODO_TECHDEBT(@okdas)

Review this section and the one below it to remove/update accordingly.

Version	Planned (✅ / ❌ / ⚠️)	Breaking (✅ / ❌)	Requires Manual Intervention (❌ / ⚠️)	Upgrade Height	Notes
v0.1.29	✅	✅	❌	375233
v0.1.28	✅	✅	❌	292157
v0.1.27	✅	✅	❌	193091
v0.1.26	✅	✅	❌	193091
v0.1.25	✅	✅	❌	181366
v0.1.24	✅	✅	❌	162494
v0.1.23	✅	✅	❌	158730	✅
v0.1.22	✅	✅	❌	155470
v0.1.21	✅	✅	❌	139917
v0.1.20	✅	✅	⚠️ Yes, a chain halt was hit and the release was re-tagged	125773
v0.1.19	❌	✅	❌	120300
v0.1.18	✅	✅	❌	118837
v0.1.17	❌	✅	❌	105177
v0.1.16	✅	✅	❌	102719
v0.1.15	❌	✅	❌	97818
v0.1.14	✅	✅	❌	97253
v0.1.13	✅	✅	❌	83570
v0.1.12	✅	✅	❌	73055
v0.1.11	✅	✅	❌	55246
v0.1.7	✅	❌	❌	33308
v0.1.6	✅	✅	❌	32979
v0.1.5	✅	✅	❌	31597
v0.1.4	✅	✅	❌	25499
v0.1.3	✅	✅	❌	22634
v0.1.2	✅	✅	❓	21515
v0.1.1	✅	✅	❌	TODO(@okdas)
v0.0.12	✅	✅	❌	TODO(@okdas)
v0.0.11	✅	✅	❌	156245
v0.0.10	✅	✅	❌	56860
v0.0.9-4	❌	✅	⚠️	46329	⚠️ follow manual upgrade instructions ⚠️
v0.0.9-3	❌	✅	❌	17102	Active Alpha TestNet Participants Only: follow manual upgrade instructions
v0.0.9	N/A	N/A	❌	N/A	genesis version

Skipped Upgrade Heights

Unsuccessful upgrades are skipped using the --unsafe-skip-upgrades flag from the cosmos sdk upgrade cancellation features.

These heights are defined in skip_upgrade_height files in pocket-network-genesis.

You can find all of them here.

The official full node accounts for this: pokt-network/poktroll//tools/installer/full-node.sh

Quick links to related sections (collapse if not needed)

• MainNet Protocol Upgrades

• Beta TestNet Protocol Upgrades

• Alpha TestNet Protocol Upgrades

• Skipped Upgrade Heights