Skip to content

feat: support pox-5#2357

Draft
brady-stacks wants to merge 13 commits intostx-labs:mainfrom
brady-stacks:feat/pox-5
Draft

feat: support pox-5#2357
brady-stacks wants to merge 13 commits intostx-labs:mainfrom
brady-stacks:feat/pox-5

Conversation

@brady-stacks
Copy link
Copy Markdown
Contributor

@brady-stacks brady-stacks commented Apr 9, 2026

  • Add PoX-5 support to Clarinet (pox-5 boot contract, epoch 3.5 config, updated stacking/signing logic for new PoX
  • devnet snapshot uses a SnapshotLevel enum now (epoch 3.5 burn height 163)
  • Update default epoch timing constants (3.1–3.5) so epochs transition at consecutive burn heights, and make epoch 3.5 a non-optional default in DevnetConfig
  • Add btc_balance field to AccountConfig for seeding BTC in stacker wallets during devnet genesis
  • Add PoX-5 stacking transaction generation using make_pox_5_signer_key_signature / make_pox_5_signer_grant_signature
  • Handle snapshot boot gaps in the observer's StacksBlockPool by creating a new fork when a block is far ahead (>10 blocks) of all existing fork tips
    • Skip Docker image pull when the image already exists locally
    • Skip devnet compatibility checks when --from-genesis is passed

@brady-stacks brady-stacks marked this pull request as draft April 9, 2026 15:44
@brady-stacks brady-stacks marked this pull request as ready for review April 10, 2026 17:37
epoch_3_3: devnet_config.epoch_3_3.unwrap_or(DEFAULT_EPOCH_3_3),
epoch_3_4: devnet_config.epoch_3_4.unwrap_or(DEFAULT_EPOCH_3_4),
epoch_3_5: devnet_config.epoch_3_5,
epoch_3_5: Some(devnet_config.epoch_3_5.unwrap_or(DEFAULT_EPOCH_3_5)),
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't want to have a default value here.

At some point, we'll be in a state where Clarinet will have to support both epoch 3.4 (by default) and preview for epoch 3.5.

If/when the user sets an epoch 3.5 height (along with a 3.5 image), Clarinet will handle it, but otherwise it'll still default to 3.4 until 3.5 activates on mainnet.

Until will eventually default to 3.5, like we recently did for 3.4 #2342

@brady-stacks brady-stacks marked this pull request as draft April 13, 2026 15:38
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.

2 participants