Skip to main content
Contracts are immutable once deployed, so any change requires a new deployment under a new version. This page records every version and states the impact on existing callers. Source and verification certificates: xpectrum-xyz/xpectrum-contracts.

​
Versioning

vMAJOR.MINOR.PATCH, classified by one question: does an existing, correct caller keep working, unchanged, with the same result? Standards (XNS-1, the Metadata Standard) version separately from the contracts that implement them, as vMAJOR.MINOR.

​
Deployed now

XNS1.aml is the reference implementation and is not deployed.

​
XNS1 v4.0.0

Reference implementation. Verified, not deployed. Breaking against rev 3. Rev 3 is withdrawn and is not included in this repository. Existing implementations based on it should migrate to v4.0.0.

​
What changes for implementers

  • is_approved_or_owner returns u128 (1 or 0). Rev 3 returned bool, which Xmarket.require(approved == 1) cannot satisfy, so a literal rev-3 implementation is untradeable on Xmarket. This is the reason for the migration.
  • total_supply() is live supply. total_minted() is the id count. Rev 3 had one counter.
  • New: burn(token_id) (holder only), total_minted(), burned(), is_burned(token_id).
  • get_contract_info() gained total_minted | burned | events.
  • Mint emits Transferred(id, 0, to); rev 3 emitted (id, caller, to). Burn emits Transferred(id, owner, 0).
  • event_log and get_event_log added, so an XNS-1 contract is visible to an indexer at all.
  • bool removed from state and from numerically compared parameters.
  • get_token_circle_info version is now 2: the active column is 1/0.

​
Hashes

Source f55d89cd…, identical on both chains. Bytecode differs per chain, which is expected: Verified true, 0 errors, 7 warnings on both.

​
XuperFactory v2.0.0

2026-08-21, mainnet. Breaking. Replaces SuperFactory, which was deployed on 2026-07-20 and never used (count 0, so nothing was orphaned). What changes for callers
  • The contract is renamed SuperFactory to XuperFactory. Revert strings are prefixed xuperfactory:.
  • create_collection is payable and requires value >= launch_fee. A call that sends nothing now reverts. This is the breaking part.
  • The genesis parameter is renamed xpectra. Positional order is unchanged, so the wire format is identical and no signature changes.
  • New views get_launch_fee() and get_fee_balance().
What changes for creators
  • Launching costs a 1 OCT fee, on top of about 0.2 OCT of network fee. The fee is owner-settable and readable on-chain, and zero is legal.
Hashes The mainnet and devnet builds differ because the embedded Xcollection is compiled per chain. Same source, different bytecode, which is expected on this toolchain.

​
Xcollection v4.0.0

2026-08-21, mainnet, embedded in XuperFactory v2.0.0. Breaking. Folds in an earlier build from 2026-08-12 that was never deployed. What changes for callers
  • genesis_mint(genesis_id) is now xholder_mint(xpectra_id).
  • get_genesis_status, has_claimed_genesis and is_genesis_id_used are now get_xholder_status, has_claimed_xholder and is_xpectra_id_used.
  • genesis_contract, genesis_minted_count, genesis_claimed and used_genesis_ids are now xpectra_contract, xholder_minted_count, xholder_claimed and used_xpectra_ids.
  • event GenesisMint is now event XholderMint. Indexers must update their filter, otherwise these mints will no longer be observed.
  • total_supply() now returns live supply and total_minted() returns the id count. Callers reading total_supply as the total ever minted will receive a different value.
  • get_contract_info() gained a trailing burned column.
  • New: burn(token_id), total_minted(), burned(), is_burned(token_id).
  • get_provenance_hash is now a view fn. Reading it no longer costs a transaction.
What changes for creators
  • The Xholder reserve ceiling is 111, previously 222. For collections above 555 supply this materially changes the reserved allocation.
  • The minimum phase length is 240 epochs, approximately 40 minutes, previously 360. The earlier value assumed exactly ten seconds per epoch, a rate the chain has not sustained. 240 is derived from the fastest rate measured over 160 days.
  • Burning is available, holder-only. It never lowers max_supply and never reopens a mint slot.
Hashes

​
Xcollection v3.1.1

2026-07-20, mainnet, embedded in SuperFactory. Patch. Hardening only, no interface change: checked mint-cost multiplication, a bounds check on get_approved, dropped vestigial guards, and xholder_mint marks claim state before the external owner_of call.

​
Xcollection v3.1.0

2026-06-26, devnet. Minor. What changes for creators
  • The Xholder claim became one per wallet and was decoupled from the Guaranteed allocation. It no longer increments gtd_minted or consumes gtd_cap/gtd_wallet_cap, so the reserve can never erode a creator’s own allowlist.
  • New view has_claimed_genesis (renamed to has_claimed_xholder in v4.0.0).

​
Xincinerator v1.0.0 and XincineratorLog v1.0.0

2026-07-28, mainnet. New. Xincinerator is an ownerless sink: no owner, no entry points, no call(), two view functions and nothing else. A token sent to it can never be moved again. XincineratorLog batches transfers into it and emits Burned, and can only ever name the incinerator fixed in its constructor. Used to burn 111 Xpectra. See Xpectra. Hashes

​
XpectrumGenesis v1.0.1

2026-07-21, mainnet, deployed as Xpectra. Patch. Hardening for parity with Xcollection: checked mint-cost multiplication, a bounds check on get_approved, dropped vestigial guards. No interface change. Hashes: bytecode_hash 9e17d6c9…

​
Xmarket v3.2.0

2026-07-20, mainnet. Breaking, relative to v3.1. What changes for callers
  • make_collection_offer(nft, duration, quantity) takes a quantity. get_offer now returns 9 fields, and the coffer event 7.
  • Accepting an offer emits an osale event rather than sale. Previously an offer accept emitted sale carrying an offer id in the listing-id field, which corrupted indexer listing tables. Consumers indexing sales must handle osale.
  • A cancel event is now logged when an accept auto-closes a listing, with status 0 rather than 2.
  • New cancel_offer event.
  • New standard_mode compatibility lane: owner-flagged collections are checked via owner_of plus get_approved, which lets ERC-721-shaped contracts trade.
  • Accepting one’s own offer is now rejected.
Hashes: bytecode_hash 943cbd42…

​
Earlier

Versions preceding this point were deployed to devnet only. The public history begins at mainnet launch on 2026-07-20.