Governance

Adaptive burn.

A governance-tunable dial over EIP-1559 base-fee burn, local-fee burn, and paymaster burn that nudges circulating supply toward a target band. Paymaster burn is locked at 100% — the dial only moves the other two.

STATUS: Shipped (read-only RPCs)
CRATE: tenzro-token
PERSISTENCE: CF_TOKENS
TIMELOCK: Fast-track on alarm

Two governance objects

BurnRateConfig carries the live burn rates in basis points (base_fee_burn_bps, local_fee_burn_bps, paymaster_burn_bps). SupplyTargets is the policy: rolling-window length in epochs, a neutral band, inflation/deflation alarm thresholds, target annual supply change in bps, magnitude caps for each kind of adjustment, and a fast-track timelock for alarm-state changes.

Both objects are persisted to CF_TOKENS under burn_rate:current and burn_targets:current. The latest measurement is stored under burn_metrics:latest.

Recommendation function

compute_recommendation(metrics, targets) is a pure transfer function. It returns one of: Disabled, NoChange, IncreaseBurnPct, DecreaseBurnPct, AlarmHighInflation, AlarmHighDeflation. Magnitude is capped by magnitude_cap_normal_bps (default 200) in the normal band or magnitude_cap_alarm_bps (default 100) once an alarm threshold is crossed.

Pure-function design lets governance UIs preview the dial position before the auto-proposal generator submits a change.

Reading the dial

Four read-only RPCs surface the dial state today; the mutation path arrives with the governance-executor wiring wave.

curl -X POST https://rpc.tenzro.network \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tenzro_getBurnRateConfig","params":[]}'

curl -X POST https://rpc.tenzro.network \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tenzro_getSupplyMetrics","params":[]}'

curl -X POST https://rpc.tenzro.network \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tenzro_getBurnRateRecommendation","params":[]}'

curl -X POST https://rpc.tenzro.network \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":4,"method":"tenzro_listAdaptiveBurnProposals","params":[]}'

What the snapshot contains

SupplyMetricsSnapshot is block-height anchored. It captures circulating supply at that height, the change vs. one epoch ago, the rolling bps over the configured window, a BurnBreakdown (base / local / paymaster), and an EmissionBreakdown (validator rewards, provider rewards, treasury). Snapshots are written through to CF_TOKENS every epoch.

← All docs