feat: Updating defaultMinStakingDuration to 48h post HeliconRelease ONLY (#5299)

SavalaBee · StephenButtolph · web-flow · commit a7b61f259812 · 2026-07-02T15:14:32.000Z
Signed-off-by: SavalaBee &lt;sarala.b@avalabs.org&gt;
Co-authored-by: Stephen Buttolph &lt;stephen@avalabs.org&gt;
diff --git a/config/BUILD.bazel b/config/BUILD.bazel
@@ -62,10 +62,12 @@ go_test(
     deps = [
         "//chains",
         "//config/node",
+        "//genesis",
         "//ids",
         "//snow/consensus/simplex",
         "//snow/consensus/snowball",
         "//subnets",
+        "//utils",
         "//utils/constants",
         "@com_github_spf13_pflag//:pflag",
         "@com_github_spf13_viper//:viper",
diff --git a/config/config.go b/config/config.go
@@ -805,6 +805,7 @@ func getStakingConfig(v *viper.Viper, networkID uint32) (node.StakingConfig, err
 		config.MaxValidatorStake = v.GetUint64(MaxValidatorStakeKey)
 		config.MinDelegatorStake = v.GetUint64(MinDelegatorStakeKey)
 		config.MinStakeDuration = v.GetDuration(MinStakeDurationKey)
+		config.HeliconMinStakeDuration = v.GetDuration(HeliconMinStakeDurationKey)
 		config.MaxStakeDuration = v.GetDuration(MaxStakeDurationKey)
 		config.RewardConfig.MaxConsumptionRate = v.GetUint64(StakeMaxConsumptionRateKey)
 		config.RewardConfig.MinConsumptionRate = v.GetUint64(StakeMinConsumptionRateKey)
diff --git a/config/config.md b/config/config.md
@@ -361,6 +361,7 @@ Staking economics configuration.
 | `--min-delegator-stake` | `AVAGO_MIN_DELEGATOR_STAKE` | int | network dependent | The minimum stake, in nAVAX, that can be delegated to a validator of the Primary Network. Defaults to `25000000000` (25 AVAX) on Mainnet. Defaults to `5000000` (.005 AVAX) on Test Net. This can only be changed on a local network. |
 | `--min-delegation-fee` | `AVAGO_MIN_DELEGATION_FEE` | int | `20000` | The minimum delegation fee that can be charged for delegation on the Primary Network, multiplied by \`10,000\`. Must be in the range \[0, 1000000\]. This can only be changed on a local network. |
 | `--min-stake-duration` | `AVAGO_MIN_STAKE_DURATION` | duration | `336h` | Minimum staking duration. This can only be changed on a local network. This applies to both delegation and validation periods. |
+| `--helicon-min-stake-duration` | `AVAGO_HELICON_MIN_STAKE_DURATION` | duration | `48h` | Minimum staking duration post Helicon. This can only be changed on a local network. This applies to only to validation periods. |
 | `--max-stake-duration` | `AVAGO_MAX_STAKE_DURATION` | duration | `8760h` | The maximum staking duration, in hours. This can only be changed on a local network. |
 | `--stake-minting-period` | `AVAGO_STAKE_MINTING_PERIOD` | duration | `8760h` | Consumption period of the staking function, in hours. This can only be changed on a local network. |
 | `--stake-max-consumption-rate` | `AVAGO_STAKE_MAX_CONSUMPTION_RATE` | uint | `120000` | The maximum percentage of the consumption rate for the remaining token supply in the minting period, which is 1 year on Mainnet. This can only be changed on a local network. |
diff --git a/config/config_test.go b/config/config_test.go
@@ -19,10 +19,12 @@ import (
 
 	"github.com/ava-labs/avalanchego/chains"
 	"github.com/ava-labs/avalanchego/config/node"
+	"github.com/ava-labs/avalanchego/genesis"
 	"github.com/ava-labs/avalanchego/ids"
 	"github.com/ava-labs/avalanchego/snow/consensus/simplex"
 	"github.com/ava-labs/avalanchego/snow/consensus/snowball"
 	"github.com/ava-labs/avalanchego/subnets"
+	"github.com/ava-labs/avalanchego/utils"
 	"github.com/ava-labs/avalanchego/utils/constants"
 )
 
@@ -915,6 +917,37 @@ func TestGetStakingSigner(t *testing.T) {
 	}
 }
 
+func TestGetStakingConfig_Helicon(t *testing.T) {
+	tests := []struct {
+		name string
+		set  *time.Duration
+		want time.Duration
+	}{
+		{
+			name: "default",
+			want: genesis.LocalParams.HeliconMinStakeDuration,
+		},
+		{
+			name: "overridden",
+			set:  utils.PointerTo(15 * time.Minute),
+			want: 15 * time.Minute,
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			v := setupViperFlags()
+			v.Set(DataDirKey, t.TempDir())
+			if tt.set != nil {
+				v.Set(HeliconMinStakeDurationKey, *tt.set)
+			}
+
+			config, err := getStakingConfig(v, constants.LocalID)
+			require.NoError(t, err)
+			require.Equal(t, tt.want, config.HeliconMinStakeDuration)
+		})
+	}
+}
+
 func TestGetDiskSpaceConfig(t *testing.T) {
 	tests := []struct {
 		name        string
diff --git a/config/flags.go b/config/flags.go
@@ -282,6 +282,8 @@ func addNodeFlags(fs *pflag.FlagSet) {
 	fs.Uint64(MinDelegatorFeeKey, uint64(genesis.LocalParams.MinDelegationFee), "Minimum delegation fee, in the range [0, 1000000], that can be charged for delegation on the primary network")
 	// Minimum Stake Duration
 	fs.Duration(MinStakeDurationKey, genesis.LocalParams.MinStakeDuration, "Minimum staking duration")
+	// Helicon Minimum Stake Duration
+	fs.Duration(HeliconMinStakeDurationKey, genesis.LocalParams.HeliconMinStakeDuration, "Minimum staking duration post Helicon")
 	// Maximum Stake Duration
 	fs.Duration(MaxStakeDurationKey, genesis.LocalParams.MaxStakeDuration, "Maximum staking duration")
 	// Stake Reward Configs
diff --git a/config/keys.go b/config/keys.go
@@ -42,6 +42,7 @@ const (
 	MinDelegatorStakeKey                     = "min-delegator-stake"
 	MinDelegatorFeeKey                       = "min-delegation-fee"
 	MinStakeDurationKey                      = "min-stake-duration"
+	HeliconMinStakeDurationKey               = "helicon-min-stake-duration"
 	MaxStakeDurationKey                      = "max-stake-duration"
 	StakeMaxConsumptionRateKey               = "stake-max-consumption-rate"
 	StakeMinConsumptionRateKey               = "stake-min-consumption-rate"
diff --git a/genesis/genesis_fuji.go b/genesis/genesis_fuji.go
@@ -52,13 +52,14 @@ var (
 			},
 		},
 		StakingConfig: StakingConfig{
-			UptimeRequirement: .8, // 80%
-			MinValidatorStake: 1 * units.Avax,
-			MaxValidatorStake: 3 * units.MegaAvax,
-			MinDelegatorStake: 1 * units.Avax,
-			MinDelegationFee:  20000, // 2%
-			MinStakeDuration:  24 * time.Hour,
-			MaxStakeDuration:  365 * 24 * time.Hour,
+			UptimeRequirement:       .8, // 80%
+			MinValidatorStake:       1 * units.Avax,
+			MaxValidatorStake:       3 * units.MegaAvax,
+			MinDelegatorStake:       1 * units.Avax,
+			MinDelegationFee:        20000, // 2%
+			MinStakeDuration:        24 * time.Hour,
+			MaxStakeDuration:        365 * 24 * time.Hour,
+			HeliconMinStakeDuration: 12 * time.Hour,
 			RewardConfig: reward.Config{
 				MaxConsumptionRate: .12 * reward.PercentDenominator,
 				MinConsumptionRate: .10 * reward.PercentDenominator,
diff --git a/genesis/genesis_local.go b/genesis/genesis_local.go
@@ -70,13 +70,14 @@ var (
 			},
 		},
 		StakingConfig: StakingConfig{
-			UptimeRequirement: .8, // 80%
-			MinValidatorStake: 2 * units.KiloAvax,
-			MaxValidatorStake: 3 * units.MegaAvax,
-			MinDelegatorStake: 25 * units.Avax,
-			MinDelegationFee:  20000, // 2%
-			MinStakeDuration:  24 * time.Hour,
-			MaxStakeDuration:  365 * 24 * time.Hour,
+			UptimeRequirement:       .8, // 80%
+			MinValidatorStake:       2 * units.KiloAvax,
+			MaxValidatorStake:       3 * units.MegaAvax,
+			MinDelegatorStake:       25 * units.Avax,
+			MinDelegationFee:        20000, // 2%
+			MinStakeDuration:        24 * time.Hour,
+			MaxStakeDuration:        365 * 24 * time.Hour,
+			HeliconMinStakeDuration: 1 * time.Hour,
 			RewardConfig: reward.Config{
 				MaxConsumptionRate: .12 * reward.PercentDenominator,
 				MinConsumptionRate: .10 * reward.PercentDenominator,
diff --git a/genesis/genesis_mainnet.go b/genesis/genesis_mainnet.go
@@ -52,13 +52,14 @@ var (
 			},
 		},
 		StakingConfig: StakingConfig{
-			UptimeRequirement: .8, // 80%
-			MinValidatorStake: 2 * units.KiloAvax,
-			MaxValidatorStake: 3 * units.MegaAvax,
-			MinDelegatorStake: 25 * units.Avax,
-			MinDelegationFee:  20000, // 2%
-			MinStakeDuration:  2 * 7 * 24 * time.Hour,
-			MaxStakeDuration:  365 * 24 * time.Hour,
+			UptimeRequirement:       .8, // 80%
+			MinValidatorStake:       2 * units.KiloAvax,
+			MaxValidatorStake:       3 * units.MegaAvax,
+			MinDelegatorStake:       25 * units.Avax,
+			MinDelegationFee:        20000, // 2%
+			MinStakeDuration:        2 * 7 * 24 * time.Hour,
+			MaxStakeDuration:        365 * 24 * time.Hour,
+			HeliconMinStakeDuration: 48 * time.Hour,
 			RewardConfig: reward.Config{
 				MaxConsumptionRate: .12 * reward.PercentDenominator,
 				MinConsumptionRate: .10 * reward.PercentDenominator,
diff --git a/genesis/params.go b/genesis/params.go
@@ -31,6 +31,9 @@ type StakingConfig struct {
 	// MaxStakeDuration is the maximum amount of time a validator can validate
 	// for in a single period.
 	MaxStakeDuration time.Duration `json:"maxStakeDuration"`
+	// HeliconMinStakeDuration is the minimum staking duration for the primary
+	// network after the Helicon upgrade (ACP-273).
+	HeliconMinStakeDuration time.Duration `json:"heliconMinStakeDuration"`
 	// RewardConfig is the config for the reward function.
 	RewardConfig reward.Config `json:"rewardConfig"`
 }
diff --git a/node/node.go b/node/node.go
@@ -1212,6 +1212,7 @@ func (n *Node) initVMs() error {
 				MinDelegationFee:          n.Config.MinDelegationFee,
 				MinStakeDuration:          n.Config.MinStakeDuration,
 				MaxStakeDuration:          n.Config.MaxStakeDuration,
+				HeliconMinStakeDuration:   n.Config.HeliconMinStakeDuration,
 				RewardConfig:              n.Config.RewardConfig,
 				UpgradeConfig:             n.Config.UpgradeConfig,
 				UseCurrentHeight:          n.Config.UseCurrentHeight,
diff --git a/tests/e2e/e2e_test.go b/tests/e2e/e2e_test.go
@@ -87,7 +87,8 @@ var _ = ginkgo.SynchronizedBeforeSuite(func() []byte {
 	defaultFlags := tmpnet.FlagsMap{
 		config.UpgradeFileContentKey: upgradeBase64,
 		// Ensure a min stake duration compatible with testing staking logic
-		config.MinStakeDurationKey: "1s",
+		config.MinStakeDurationKey:        "2s",
+		config.HeliconMinStakeDurationKey: "1s",
 	}
 	defaultFlags.SetDefaults(tmpnet.DefaultE2EFlags())
 
diff --git a/tests/fixture/tmpnet/defaults.go b/tests/fixture/tmpnet/defaults.go
@@ -30,7 +30,8 @@ const (
 	DefaultPreFundedKeyCount = 50
 
 	// A short minimum stake duration enables testing of staking logic.
-	DefaultMinStakeDuration = "1s"
+	DefaultMinStakeDuration        = "2s"
+	DefaultHeliconMinStakeDuration = "1s"
 
 	defaultConfigFilename = "config.json"
 )
diff --git a/vms/platformvm/config/internal.go b/vms/platformvm/config/internal.go
@@ -72,6 +72,10 @@ type Internal struct {
 	// Maximum amount of time to allow a staker to stake
 	MaxStakeDuration time.Duration
 
+	// HeliconMinStakeDuration is the minimum staking duration for the primary
+	// network after the Helicon upgrade (ACP-273).
+	HeliconMinStakeDuration time.Duration
+
 	// Config for the minting function
 	RewardConfig reward.Config
 
diff --git a/vms/platformvm/txs/executor/helpers_test.go b/vms/platformvm/txs/executor/helpers_test.go
@@ -45,8 +45,9 @@ import (
 const (
 	defaultMinValidatorStake = 5 * units.MilliAvax
 
-	defaultMinStakingDuration = 24 * time.Hour
-	defaultMaxStakingDuration = 365 * 24 * time.Hour
+	defaultMinStakingDuration        = 24 * time.Hour
+	defaultHeliconMinStakingDuration = 12 * time.Hour
+	defaultMaxStakingDuration        = 365 * 24 * time.Hour
 
 	defaultTxFee = 100 * units.NanoAvax
 )
@@ -241,15 +242,16 @@ func defaultConfig(f upgradetest.Fork) *config.Internal {
 	)
 
 	return &config.Internal{
-		Chains:                 chains.TestManager,
-		UptimeLockedCalculator: uptime.NewLockedCalculator(),
-		Validators:             validators.NewManager(),
-		MinValidatorStake:      5 * units.MilliAvax,
-		MaxValidatorStake:      500 * units.MilliAvax,
-		MinDelegatorStake:      1 * units.MilliAvax,
-		MinDelegationFee:       20000,
-		MinStakeDuration:       defaultMinStakingDuration,
-		MaxStakeDuration:       defaultMaxStakingDuration,
+		Chains:                  chains.TestManager,
+		UptimeLockedCalculator:  uptime.NewLockedCalculator(),
+		Validators:              validators.NewManager(),
+		MinValidatorStake:       5 * units.MilliAvax,
+		MaxValidatorStake:       500 * units.MilliAvax,
+		MinDelegatorStake:       1 * units.MilliAvax,
+		MinDelegationFee:        20000,
+		MinStakeDuration:        defaultMinStakingDuration,
+		HeliconMinStakeDuration: defaultHeliconMinStakingDuration,
+		MaxStakeDuration:        defaultMaxStakingDuration,
 		RewardConfig: reward.Config{
 			MaxConsumptionRate: .12 * reward.PercentDenominator,
 			MinConsumptionRate: .10 * reward.PercentDenominator,
diff --git a/vms/platformvm/txs/executor/staker_tx_verification_helpers.go b/vms/platformvm/txs/executor/staker_tx_verification_helpers.go
@@ -10,6 +10,7 @@ import (
 	"github.com/ava-labs/avalanchego/ids"
 	"github.com/ava-labs/avalanchego/utils/constants"
 	"github.com/ava-labs/avalanchego/utils/math"
+	"github.com/ava-labs/avalanchego/vms/platformvm/config"
 	"github.com/ava-labs/avalanchego/vms/platformvm/state"
 	"github.com/ava-labs/avalanchego/vms/platformvm/txs"
 )
@@ -23,6 +24,13 @@ type addValidatorRules struct {
 	minDelegationFee  uint32
 }
 
+func primaryNetworkValidatorMinStakeDuration(cfg *config.Internal, timestamp time.Time) time.Duration {
+	if cfg.UpgradeConfig.IsHeliconActivated(timestamp) {
+		return cfg.HeliconMinStakeDuration
+	}
+	return cfg.MinStakeDuration
+}
+
 func getValidatorRules(
 	backend *Backend,
 	chainState state.Chain,
@@ -33,7 +41,7 @@ func getValidatorRules(
 			assetID:           backend.Ctx.AVAXAssetID,
 			minValidatorStake: backend.Config.MinValidatorStake,
 			maxValidatorStake: backend.Config.MaxValidatorStake,
-			minStakeDuration:  backend.Config.MinStakeDuration,
+			minStakeDuration:  primaryNetworkValidatorMinStakeDuration(backend.Config, chainState.GetTimestamp()),
 			maxStakeDuration:  backend.Config.MaxStakeDuration,
 			minDelegationFee:  backend.Config.MinDelegationFee,
 		}, nil
diff --git a/vms/platformvm/txs/executor/staker_tx_verification_test.go b/vms/platformvm/txs/executor/staker_tx_verification_test.go
diff --git a/vms/platformvm/txs/executor/standard_tx_executor_test.go b/vms/platformvm/txs/executor/standard_tx_executor_test.go
diff --git a/vms/platformvm/vm_test.go b/vms/platformvm/vm_test.go
