KANARIdocs
Network
Documentation
Kanari DocsDeveloper documentation
Kanari DocsDeveloper documentationKanari Docs InstallationSet up a content-driven documentation site with Kanari Docs
Welcome to Kanari Docs
Introduction
Quick StartSetup Node
Architecture
Protocol StackCheckpoints and Mysticeti DAGExecution and State
Operations
Multi-node DevnetRPC Gateway and LimitsSnapshot and Validator Backup
Security
Security HardeningTesting and Audit Coverage
CLI
Kanari Node CLIKanari CLIClient OperationsMove DevelopmentKeytool Operations
API Reference
API Reference
Guides
Transferring CoinsGas Model

Kanari Documentation

Gas Model

Kanari gas model versions and the active selector.

Last updated

Gas Model

Kanari keeps gas policy implementations in crates/kanari-types/src/gas_v*.rs and selects the active policy from crates/kanari-types/src/gas.rs.

The current selector is:

select_gas_impl!(v2);

Changing only this selector switches the active exported gas policy for consumers that import through kanari_types::gas or crate-level re-exports.

Versions

VersionPurposePricing behavior
v1Baseline gas modelSui-like storage accounting and rebate behavior.
v2Free-storage experimentStorage-related charging is disabled/zeroed for cheaper dev/test execution.
v3Discount modelEffective gas price is requested / 10.
v3_1Milder discount modelEffective gas price is requested / 5.

Because prices are integer Mist values, discounted versions round down. For example, v3 turns requested prices below 10 into an effective price of 0; v3.1 turns requested prices below 5 into 0.

Operational guidance

  • Use v2 for cheap devnet/testnet experiments where storage pricing is intentionally disabled.
  • Use v3 only if you want a very aggressive tenfold discount.
  • Use v3_1 when you want cheaper-than-v1 pricing but less rounding-to-zero than v3.
  • Do not change the active gas selector on only one validator in a shared network. All validators must run the same binary and gas policy to keep execution deterministic.