Kusama

Kusama exposes network changes to live economic conditions before Polkadot may adopt them.

Kusama gives software and governance changes a live, value-bearing setting before comparable changes may appear on Polkadot. That role is more demanding than a testnet because accounts, KSM and public decisions have real consequences. It also makes the network less suitable for anyone who expects every interface and rule to remain unchanged. The useful question is whether faster adaptation helps the intended task enough to justify checking current runtime behavior before signing or relying on a feature.

Its canary role exposes runtime changes to real governance and economic consequences before comparable changes may reach Polkadot.

From proposed change to live consequence

Since Kusama's 2025 Asset Hub migration, OpenGov has operated on Asset Hub, while the relay chain and system chains retain separate runtimes. An OpenGov referendum can schedule a material protocol change for enactment in the targeted on-chain runtime. Once enacted, changed WebAssembly logic can alter available calls, storage rules or transaction weights without splitting the network into competing versions. Governance therefore affects the software behavior that users and applications encounter.

A proposal page, discussion thread or release note shows intent rather than availability. The change becomes operational when the live runtime exposes it and nodes execute the new logic. Applications must then encode calls against current metadata, while users need a successful dispatch and the intended state change. This gap between approval and execution matters most when a feature is time-sensitive or an interface cached an older runtime description.

The canary role has economic weight

The network tests change under real incentives because its token, governance decisions and user balances carry value. Kusama is a live, standalone network with its own governance and economic value, rather than a faucet-funded test environment. Participants can experience actual fees, deposits and operational disruption when software behaves differently than expected.

A testnet still has a separate purpose. It lets developers find basic defects without placing valuable state at risk. Kusama adds conditions that a laboratory network cannot fully reproduce, including public participation, independent applications and economic choices. That extra realism makes its evidence useful, but it also means an unsuccessful transaction or incompatible integration is a real event rather than a disposable rehearsal.

Kusama changes do not automatically reach Polkadot

Polkadot provides the comparison because the networks share substantial technology and Kusama commonly receives experimental changes earlier. Their priorities differ: Kusama favors quicker adaptation, while Polkadot uses a more conservative pace for changes that may reach a broader set of users and integrations.

The relationship does not create automatic promotion. Each network has its own runtime, community and governance decisions, so successful behavior on Kusama can inform a later Polkadot proposal without forcing the same outcome. A feature may change before that point, remain on Kusama or never proceed further. Projects can also continue operating there when its faster governance cycle matches their needs.

Tasks that fit a faster change cycle

A task fits Kusama when early access to live behavior matters more than a long period of interface stability. The strongest fit comes from a concrete need to observe, integrate or govern a change, rather than a general appetite for novelty.

Workflows with strict change controls may prefer Polkadot after equivalent functionality reaches it. A valueless test network remains the better starting point when failure must not expose KSM or persistent account state. The appropriate environment changes with the cost of disruption and the value of obtaining live evidence early.

Can a user treat Kusama like a testnet?

No. A Kusama action can spend KSM, change public state and create consequences that cannot be dismissed by resetting a local environment. Permissionless access does not make those effects temporary. The network should be approached as production infrastructure with a faster tolerance for change.

That distinction affects ordinary use as much as development. An interface may describe an available call correctly today and require refreshed metadata after a later upgrade. A transaction hash only identifies a submission; it does not by itself prove successful execution. The relevant evidence is the finalized dispatch outcome together with the expected event or storage change.

Reading the runtime before relying on it

The runtime of the chain that owns a call defines whether it exists, how its inputs are encoded and which rules apply to its state transition.

Runtime version and metadata

A runtime upgrade replaces the on-chain WebAssembly code that defines state-transition logic without requiring a network-wide hard fork. Runtime metadata describes the pallets, calls, storage items, events, errors and types available for a particular version. A runtime-aware application uses that description to construct requests and decode results instead of assuming an older interface remains valid.

From approval to observable behavior

Governance status and runtime state answer different questions. Approval establishes that a proposal passed its required process. At enactment, the approved call is dispatched, but a cross-chain action still requires confirmation on its target chain.

Before enactment

An approved referendum may still have an enactment point ahead of it. Until the runtime changes, applications should continue using the calls and types exposed by the current metadata. An announcement or approved status cannot substitute for that live description.

After enactment

Once the new code is active, the node reports the applicable runtime version and metadata. Applications may need to refresh generated interfaces or cached definitions before constructing another transaction. The useful confirmation is not merely a higher version identifier, but the presence and behavior of the expected call, storage item or event.

Following a newly enacted call into live state

Consider a hypothetical application that announces support for a call approved through Kusama governance. A reader wants to use it promptly, yet needs independent completion evidence before continuing. At each point, inspect the relevant chain's state for evidence that the process reached that stage. Stop if the evidence belongs only to an earlier stage.

Summary: Following a newly enacted call into live state
Stage Live state to inspect Completion evidence Boundary
Governance outcome Referendum status and applicable track Approved outcome with enactment recorded Approval alone does not activate runtime code
Runtime enactment Target chain's current runtime version and metadata Active metadata exposes the intended call and types A missing call means the application cannot use it yet
User action Finalized block, dispatch result and affected state Successful dispatch with the expected event or storage change A transaction hash without successful dispatch is not completion

On the normal path, the referendum reaches enactment, the application refreshes its runtime description and the signed call succeeds in a finalized block. The reader exits the process only after the intended state is visible. No fixed waiting period can replace these observations because governance tracks, enactment scheduling and block inclusion address different parts of the process.

An edge case appears when approval is visible but the live metadata still lacks the call, or when a finalized extrinsic reports a dispatch error. That is the recovery boundary. If metadata still lacks the call, wait for actual enactment. If the call is present but the application's definitions are stale, refresh its metadata and reconstruct the call. A dispatch error requires correcting its reported cause before another submission. Repeatedly submitting the same stale payload adds fees without resolving an encoding or availability mismatch.

Following a newly enacted call into live state: On the normal path, the referendum reaches enactment, the application refreshes its runtime description and the signed call succeeds in a finalized block. The reader exits the process only after the intended state is visible.; No fixed waiting period can replace these observations because governance tracks, enactment scheduling and block inclusion address different parts of the process.
Following a newly enacted call into live state - diagram

Open full-size image

Governance controls the pace

Kusama changes through OpenGov, where origins and tracks shape how proposals move toward a decision and enactment. Faster adaptation still follows explicit on-chain rules.

Origins separate authority

An origin represents the level and kind of authority that a proposal needs. A high-privilege runtime change does not share the same route as every treasury action or lower-impact decision. This separation limits what a successful referendum on one track can execute, so the proposal's call and origin matter alongside its headline.

Tracks separate timelines

Tracks define stages such as preparation, decision, confirmation and enactment, with parameters suited to their authority. Those parameters can differ between Kusama and Polkadot and may change through governance. Read the live track and referendum state when timing matters; an old schedule or a different network's parameter does not establish the current enactment point.

Economic signals reveal more than lab tests

Live economic conditions show how people behave when transactions, deposits and operational mistakes have value. They can reveal participation patterns, application compatibility problems and incentive effects that a valueless environment may not reproduce. For changes that have passed basic technical testing, a canary network adds evidence from live use.

Real exposure does not certify that software is safe or complete. Limited use may leave rare faults undiscovered, while successful execution under one runtime says little about a later version. Kusama supplies evidence from live operation, not a guarantee for every user, connected chain or future Polkadot deployment. The value of that evidence rises with relevant use and clear on-chain observations.

Recovery boundaries after an unexpected result

An unexpected result should first be classified by its on-chain evidence. A call absent from metadata points to availability or stale-interface trouble. Rejection before inclusion can reflect invalid encoding, an outdated runtime context, a nonce conflict or insufficient funds for the applicable fee. A finalized extrinsic with a dispatch error reached the chain but did not complete the requested operation.

Successful dispatch with a missing application display suggests a different boundary. The chain state may already be correct while an indexer, cache or interface has not caught up. Recheck the relevant event or storage value through a current chain connection before taking another state-changing action. A retry becomes reasonable only after the failure cause has changed or the first action is confirmed absent; otherwise it can duplicate a valid operation.

The fit changes with tolerance for change

Kusama suits work that benefits from seeing protocol changes under live governance and economic pressure before similar ideas mature elsewhere. That benefit carries an obligation to read current metadata, distinguish approval from enactment and verify actual state instead of relying on announcements.

The choice changes when interface stability, slower governance or tightly controlled integrations outweigh early access. A test network is preferable when economic exposure adds no useful evidence. Polkadot becomes the stronger comparison when a more conservative change process matters more than encountering new runtime behavior first.

Kusama questions, answered

Why can a pending Kusama transaction become invalid after an upgrade?

A pending transaction can become invalid when the active runtime no longer accepts its signed context or encoded call. Nodes revalidate queued transactions, so a payload built with older metadata may be dropped rather than included. A nonce conflict, expired transaction or changed call definition can produce a similar symptom. Reconnect to the current runtime, refresh metadata and reconstruct the transaction instead of repeatedly broadcasting the old signed payload.

Can a runtime upgrade change Kusama transaction fee calculations?

Yes, an upgrade can change runtime logic that affects transaction weights, fee-related constants or the calls available to users. That does not mean every upgrade changes fees, and an earlier estimate cannot establish the charge under a later runtime. Obtain a fresh estimate for the exact call and current runtime before signing. The finalized transaction event records the fee actually charged when the action reaches execution.

Does a Kusama runtime upgrade alter every connected chain at once?

No, connected parachains can have their own runtimes, state-transition rules and upgrade processes. A Kusama relay-chain change may affect shared interfaces or assumptions that those chains rely on, but it does not automatically replace each parachain's code. Application maintainers must identify which runtime owns the affected call and inspect that chain's metadata. Compatibility work may still be necessary when a relay-chain change modifies a shared protocol boundary.

Are historical Kusama transactions still readable after a runtime change?

Yes, historical blocks and transactions remain part of the chain, but accurate decoding may require metadata from the runtime version active at that block. Current metadata can assign different call indexes, types or event definitions after an upgrade. An explorer or archival tool that preserves versioned metadata can interpret the older record correctly. A decoding failure in a current interface does not establish that the historical transaction disappeared or never executed.

Can a hardware wallet sign every new Kusama call immediately?

Not necessarily. A hardware wallet, companion application or signing interface may need updated call information before it can decode and display a new runtime operation clearly. Support varies by device software and by the call being signed. If the device cannot present the payload in an understandable form, wait for compatible support rather than approving opaque data. Runtime availability and signer compatibility are separate conditions.

Does a Kusama upgrade require a new account or recovery phrase?

A runtime upgrade does not normally replace the cryptographic keys that control a Kusama account. It can change calls, storage handling or application compatibility, so wallet software may need current metadata or an update. Keep the existing key material unless a specific account migration genuinely requires another supported action. A prompt asking for a recovery phrase merely to activate a runtime upgrade is not evidence of an on-chain requirement.

Last updated