Skip to content

Updated coinbase interval for pox-5 #7324

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rob-stacks merged 14 commits into from
Jun 26, 2026
Merged

Updated coinbase interval for pox-5 #7324

Show file tree
Hide file tree
Changes from 13 commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
024e59f
updated coinbase interval for pox-5
rob-stacks Jun 15, 2026
8788e03
fmt-stacks
rob-stacks Jun 15, 2026
50ab1a2
added changelog
rob-stacks Jun 15, 2026
5c32bc3
remove 500stx boost
rob-stacks Jun 15, 2026
5b3d08b
fixed coinbase intervals
rob-stacks Jun 15, 2026
2b75d43
cleaned up
rob-stacks Jun 15, 2026
e2de1ff
fmt-stacks
rob-stacks Jun 15, 2026
96ab864
fixed sip-031 schedule
rob-stacks Jun 15, 2026
8bddeef
refactored code to use constants instead of hardcoded values
rob-stacks Jun 16, 2026
b43900b
fmt-stacks
rob-stacks Jun 16, 2026
5087856
fixed comments
rob-stacks Jun 17, 2026
ba5ab1d
fixed comments [2]
rob-stacks Jun 17, 2026
7db3ec3
clippy fix
rob-stacks Jun 17, 2026
c4840aa
added BITCOIN_TESTNET_GENESIS_BURN_HEIGHT, BITCOIN_TESTNET_STACKS_40_…
rob-stacks Jun 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions changelog.d/coinbase-intervals.changed
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Updated coinbase intervals for Epoch 4.0
37 changes: 16 additions & 21 deletions stacks-common/src/types/mod.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -183,21 +183,23 @@ pub struct CoinbaseInterval {
pub effective_start_height: u64,
}

// From SIP-029:
/// Burnchain height of the Stacks genesis block (mainnet).
pub const BITCOIN_MAINNET_GENESIS_BURN_HEIGHT: u64 = 666_050;

/// Burnchain height at which the Stacks 4.0 epoch activates (mainnet).
pub const BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT: u64 = 1_012_860;
Comment thread
rob-stacks marked this conversation as resolved.

// Mainnet coinbase intervals, as defined in SIP-029 + SIP-045
//
// | Coinbase Interval | Bitcoin Height | Offset Height | Approx. Supply | STX Reward | Annual Inflation |
// |--------------------|----------------|---------------------|------------------|------------|------------------|
// | Current | - | - | 1,552,452,847 | 1000 | - |
// | 1st | 945,000 | 278,950 | 1,627,352,847 | 500 (50%) | 3.23% |
// | 2nd | 1,050,000 | 383,950 | 1,679,852,847 | 250 (50%) | 1.57% |
// | 3rd | 1,260,000 | 593,950 | 1,732,352,847 | 125 (50%) | 0.76% |
// | 4th | 1,470,000 | 803,950 | 1,758,602,847 | 62.5 (50%) | 0.37% |
// | - | 2,197,560 | 1,531,510 | 1,804,075,347 | 62.5 (0%) | 0.18% |
// | Coinbase Interval | Bitcoin Height | Offset Height | Approx. Supply | STX Reward | Annual Inflation |
// |--------------------|---------------------------------------|---------------------|------------------|------------|------------------|
// | Current | - | - | 1,552,452,847 | 1000 | - |
// | 1st (SIP-029) | 945,000 | 278,950 | 1,627,352,847 | 500 (50%) | 3.23% |
// | 2nd (SIP-045) | BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT | - | TBD | 1000 | Variable |
//
// The above is for mainnet, which has a burnchain year of 52596 blocks and starts at burnchain height 666050.

/// Mainnet coinbase intervals, as of SIP-029
Comment thread
rob-stacks marked this conversation as resolved.
pub static COINBASE_INTERVALS_MAINNET: LazyLock<[CoinbaseInterval; 5]> = LazyLock::new(|| {
pub static COINBASE_INTERVALS_MAINNET: LazyLock<[CoinbaseInterval; 3]> = LazyLock::new(|| {
let emissions_schedule = [
CoinbaseInterval {
coinbase: 1_000 * u128::from(MICROSTACKS_PER_STACKS),
Expand All @@ -208,16 +210,9 @@ pub static COINBASE_INTERVALS_MAINNET: LazyLock<[CoinbaseInterval; 5]> = LazyLoc
effective_start_height: 278_950,
},
CoinbaseInterval {
coinbase: 250 * u128::from(MICROSTACKS_PER_STACKS),
effective_start_height: 383_950,
},
CoinbaseInterval {
coinbase: 125 * u128::from(MICROSTACKS_PER_STACKS),
effective_start_height: 593_950,
},
CoinbaseInterval {
coinbase: (625 * u128::from(MICROSTACKS_PER_STACKS)) / 10,
effective_start_height: 803_950,
coinbase: 1_000 * u128::from(MICROSTACKS_PER_STACKS),
effective_start_height: BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT
- BITCOIN_MAINNET_GENESIS_BURN_HEIGHT,
},
];
assert!(CoinbaseInterval::check_order(&emissions_schedule));
Expand Down
130 changes: 34 additions & 96 deletions stacks-common/src/types/tests.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,9 @@
use std::str::FromStr;

use super::{
set_test_coinbase_schedule, CoinbaseInterval, StacksEpochId, COINBASE_INTERVALS_MAINNET,
COINBASE_INTERVALS_TESTNET,
set_test_coinbase_schedule, CoinbaseInterval, StacksEpochId,
BITCOIN_MAINNET_GENESIS_BURN_HEIGHT, BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT,
COINBASE_INTERVALS_MAINNET, COINBASE_INTERVALS_TESTNET,
};

#[test]
Expand All @@ -41,14 +42,13 @@ fn test_stacks_epoch_id_display_fromstr_tryfrom_roundtrip() {

#[test]
fn test_mainnet_coinbase_emissions() {
assert_eq!(COINBASE_INTERVALS_MAINNET.len(), 5);
assert_eq!(COINBASE_INTERVALS_MAINNET.len(), 3);
assert_eq!(COINBASE_INTERVALS_MAINNET[0].coinbase, 1_000_000_000);
assert_eq!(COINBASE_INTERVALS_MAINNET[1].coinbase, 500_000_000);
assert_eq!(COINBASE_INTERVALS_MAINNET[2].coinbase, 250_000_000);
assert_eq!(COINBASE_INTERVALS_MAINNET[3].coinbase, 125_000_000);
assert_eq!(COINBASE_INTERVALS_MAINNET[4].coinbase, 62_500_000);
assert_eq!(COINBASE_INTERVALS_MAINNET[2].coinbase, 1_000_000_000);

// heights from SIP-029 and SIP-045

// heights from SIP-029
Comment thread
rob-stacks marked this conversation as resolved.
assert_eq!(
COINBASE_INTERVALS_MAINNET[0].effective_start_height,
666_050 - 666_050
Expand All @@ -59,15 +59,7 @@ fn test_mainnet_coinbase_emissions() {
);
assert_eq!(
COINBASE_INTERVALS_MAINNET[2].effective_start_height,
1_050_000 - 666_050
);
assert_eq!(
COINBASE_INTERVALS_MAINNET[3].effective_start_height,
1_260_000 - 666_050
);
assert_eq!(
COINBASE_INTERVALS_MAINNET[4].effective_start_height,
1_470_000 - 666_050
BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT - BITCOIN_MAINNET_GENESIS_BURN_HEIGHT
);
}

Expand All @@ -93,111 +85,52 @@ fn test_get_coinbase_at_effective_height() {
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
944_999 - 666050
944_999 - 666_050
),
1_000_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
945_000 - 666050
945_000 - 666_050
),
500_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
945_001 - 666050
945_001 - 666_050
),
500_000_000
);

assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_049_999 - 666050
BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT - BITCOIN_MAINNET_GENESIS_BURN_HEIGHT - 1
),
500_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_050_000 - 666050
BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT - BITCOIN_MAINNET_GENESIS_BURN_HEIGHT
),
250_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_050_001 - 666050
),
250_000_000
);

assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_259_999 - 666050
),
250_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_260_000 - 666050
),
125_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_260_001 - 666050
),
125_000_000
);

assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_469_999 - 666050
),
125_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_470_000 - 666050
),
62_500_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
1_470_001 - 666050
),
62_500_000
);

assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
2_197_559 - 666050
),
62_500_000
1_000_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
2_197_560 - 666050
BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT - BITCOIN_MAINNET_GENESIS_BURN_HEIGHT + 1
),
62_500_000
1_000_000_000
);
assert_eq!(
CoinbaseInterval::get_coinbase_at_effective_height(
&*COINBASE_INTERVALS_MAINNET,
2_197_561 - 666050
2_000_000 - BITCOIN_MAINNET_GENESIS_BURN_HEIGHT
),
62_500_000
1_000_000_000
);
}

Expand All @@ -212,17 +145,22 @@ fn test_epoch_coinbase_reward() {
assert_eq!(epoch.coinbase_reward(true, 666050, 945_000), 500_000_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 945_001), 500_000_000);

assert_eq!(epoch.coinbase_reward(true, 666050, 1_049_999), 500_000_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 1_050_000), 250_000_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 1_050_001), 250_000_000);

assert_eq!(epoch.coinbase_reward(true, 666050, 1_259_999), 250_000_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 1_260_000), 125_000_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 1_260_001), 125_000_000);

assert_eq!(epoch.coinbase_reward(true, 666050, 1_469_999), 125_000_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 1_470_000), 62_500_000);
assert_eq!(epoch.coinbase_reward(true, 666050, 1_470_001), 62_500_000);
assert_eq!(
epoch.coinbase_reward(true, 666050, BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT - 1),
500_000_000
);
assert_eq!(
epoch.coinbase_reward(true, 666050, BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT),
1_000_000_000
);
assert_eq!(
epoch.coinbase_reward(true, 666050, BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT + 1),
1_000_000_000
);
assert_eq!(
epoch.coinbase_reward(true, 666050, 2_000_000),
1_000_000_000
);
}

// old coinbase schedule
Expand Down
2 changes: 1 addition & 1 deletion stackslib/src/core/mod.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ pub const BITCOIN_MAINNET_STACKS_33_BURN_HEIGHT: u64 = 923_222;
/// This is Epoch-3.4, activation timing proposed in SIP-039
pub const BITCOIN_MAINNET_STACKS_34_BURN_HEIGHT: u64 = 943_333;
/// This is Epoch-4.0, activation timing TBD. Placeholder until scheduled.
pub const BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT: u64 = 4_000_000;
pub use stacks_common::types::BITCOIN_MAINNET_STACKS_40_BURN_HEIGHT;

/// Bitcoin mainline testnet3 activation heights.
/// TODO: No longer used since testnet3 is dead, so remove.
Expand Down
Loading