> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.                                                                                                                                                                                                                                                               |