Skip to main content
Schema: canton.core Table: fact_round_closes Type: Incremental

Description

Tracks SummarizingMiningRound contract creation events, representing when mining rounds close and summarize their results. Contains issuance configuration, reward caps, and amulet price information.

Key Use Cases

  • Monitoring mining round lifecycle (closing/summary phase)
  • Analyzing issuance configuration per round
  • Understanding reward percentage allocations
  • Tracking amulet price at round close
  • Monitoring reward caps for different participant types

Important Relationships

  • Counterpart to core__fact_round_opens (same round_number, different phases)
  • Amulet price links to various reward calculations
  • Issuance config drives reward distribution

Commonly-used Fields

  • round_number: Sequential round identifier
  • amulet_to_issue_per_year: Annual issuance target
  • validator_reward_percentage: Percentage allocated to validators
  • app_reward_percentage: Percentage allocated to apps
  • validator_reward_cap: Maximum validator rewards
  • featured_app_reward_cap: Maximum featured app rewards
  • unfeatured_app_reward_cap: Maximum unfeatured app rewards
  • amulet_price_usd: USD price of amulet at round close
  • tick_duration_microseconds: Duration of each tick in the round

Columns

Column NameData TypeDescription
UPDATE_IDTEXTUnique identifier for the Canton update/transaction. An update contains one or more events and represents an atomic change to the blockchain state.
MIGRATION_IDTEXTCanton migration identifier. Used to track different phases or migrations in the Canton network’s evolution.
RECORD_TIMETEXTTimestamp when the update was recorded in the system.
EFFECTIVE_ATTEXTTimestamp when the event or update became effective on the blockchain. This is the canonical time for ordering and analyzing blockchain events.
EVENT_IDTEXTUnique identifier for the event within the Canton blockchain.
EVENT_INDEXTEXTOrdering index of events within an update. Events within the same update are sequentially numbered starting from 0.
ROUND_NUMBERTEXTSequential number identifying a mining round in the Canton network.
AMULET_TO_ISSUE_PER_YEARTEXTTarget annual issuance rate of amulets in the issuance configuration.
VALIDATOR_REWARD_PERCENTAGETEXTPercentage of issuance allocated to validator rewards.
APP_REWARD_PERCENTAGETEXTPercentage of issuance allocated to application rewards.
VALIDATOR_REWARD_CAPTEXTMaximum amulet amount for validator rewards.
FEATURED_APP_REWARD_CAPTEXTMaximum amulet amount for featured app rewards.
UNFEATURED_APP_REWARD_CAPTEXTMaximum amulet amount for unfeatured app rewards.
VALIDATOR_FAUCET_CAPTEXTMaximum amulet amount for validator faucet (optional/may be NULL).
AMULET_PRICE_USDTEXTUSD price of one amulet.
TICK_DURATION_MICROSECONDSTEXTDuration of each tick in microseconds.
DSO_PARTYTEXTParty identifier for the DSO (Digital Synchronizer Operator) that manages network governance and operations.
EVENT_TYPETEXTType of event: ‘created_event’ for contract creation or ‘exercised_event’ for method execution on existing contracts.
CONTRACT_IDTEXTUnique identifier for the contract being created or exercised in this event.
PACKAGE_NAMETEXTThe Canton package name containing the contract template.
TEMPLATE_IDTEXTThe template/type of the contract, including package information. Format: ‘package_id:ModuleName:ContractType’
CREATED_ATTEXTTimestamp when the contract was created.
SIGNATORIESTEXTArray of party identifiers who are signatories to the contract.
OBSERVERSTEXTArray of party identifiers who can observe the contract but are not signatories.
ISSUANCE_CONFIGTEXTJSON object containing full issuance configuration.
EVENT_JSONTEXTFull JSON object containing all event data. Useful for detailed analysis and accessing fields not explicitly extracted.
FACT_MINING_ROUND_IDTEXTSurrogate key generated from round_number
INSERTED_TIMESTAMPTEXTTimestamp when the record was inserted into this table (Snowflake SYSDATE).
MODIFIED_TIMESTAMPTEXTTimestamp when the record was last modified in this table (Snowflake SYSDATE).