Active Contract Set Snapshots

The Active Contract Set (ACS) is a point-in-time snapshot of all active Daml contracts on Canton Network, fetched from the /v0/state/acs endpoint. The ACS includes all contract types visible to the Global Synchronizer Foundation’s super validator node: Amulet UTXOs (CC balances), validator licenses, featured app rights, traffic contracts, transfer preapprovals, and governance contracts. As of 2026-04-01, the ACS contains 76,000+ active contracts. Snapshots are taken periodically (not per-block) and provide complete balance coverage across all parties — unlike the updates stream which only captures parties that recently transacted.

Table Details

Property	Value
Table Name	`canton.raw.active_contract_set_snapshots`
Table Status	Production-Ready
Unique Key	`record_time`, `contract_id`
Clustering Key(s)	`to_date("record_time")`

Table Columns

Column Name	Data Type	Description
contract_id	VARCHAR(16777216)	Unique identifier for the Daml contract. Stable across its lifetime — the same contract_id appears in events when this contract is created or consumed.
event_id	VARCHAR(16777216)	The event_id of the `created_event` that originally created this contract.
event_type	VARCHAR(16777216)	Always `created_event` for ACS records — the ACS only contains active (not yet archived) contracts.
record_time	TIMESTAMP_NTZ(9)	The point-in-time at which this ACS snapshot was taken. All contracts in the same snapshot share the same record_time.
migration_id	NUMBER(38,0)	Synchronizer migration epoch. Canton upgrades increment this value (currently 0–4). The active migration_id must match the time range being queried.
template_id	VARCHAR(16777216)	The Daml template of this contract, formatted as `package_hash:Module.Path:TemplateName`. Common types include `Splice.Amulet:Amulet` (CC balances), `Splice.ValidatorLicense:ValidatorLicense`, and `Splice.MemberTraffic:MemberTraffic`.
package_name	VARCHAR(16777216)	Human-readable Daml package name (e.g., `splice-amulet`, `splice-dso-governance`, `splice-wallet`).
signatories	VARIANT	Array of parties that signed this contract.
observers	VARIANT	Array of parties that can observe this contract but are not signatories.
create_arguments	VARIANT	The constructor arguments of the contract, containing its full state. For Amulet contracts, includes `owner`, `amount.initialAmount`, `amount.createdAt.number`, and `amount.ratePerRound.rate` — the fields needed to compute the current CC balance via `initialAmount - (currentRound - createdAtRound) × ratePerRound`.
contract_created_at	TIMESTAMP_NTZ(9)	The record_time when this contract was originally created in the updates stream. Useful for computing contract age.
_created_at	TIMESTAMP_NTZ(9)	Timestamp of when the entry was created in the database.
_updated_at	TIMESTAMP_NTZ(9)	Timestamp of when the entry was last updated in the database.

Overview

Data Verticals

Solana

Hyperliquid

Lighter

Bitcoin Ecosystem

EVM

Cosmos Ecosystem

Move Ecosystem

Other Ecosystems

Table Details

Table Columns

​Table Details

​Table Columns

Table Details

Table Columns