LLM Notice: This documentation site supports content negotiation for AI agents. Request any page with Accept: text/markdown or Accept: text/plain header to receive Markdown instead of HTML. Alternatively, append ?format=md to any URL. All markdown files are available at /md/ prefix paths. For all content in one file, visit /llms-full.txt
Skip to main content

Contract

The FlowEpoch contract is the state machine that manages Epoch phases and emits service events. The FlowClusterQC and FlowDKG contracts manage the processes that happen during the Epoch Setup phase.

These contracts are all deployed to the same account as the FlowIDTableStaking contract.

Sources:

NetworkContract Address
Emulator0xf8d6e0586b0a20c7
Cadence Testing Framework0x0000000000000001
Testnet0x9eca2b38b18b5dfe
Mainnet0x8624b52f9ddcd04a

Transactions

Get epoch info

These scripts are read-only and get info about the current state of the epoch contract.

IDNameSource
EP.01Get Epoch Metadata[epoch/get_epoch_metadata.cdc]
EP.02Get Configurable Metadata[epoch/get_config_metadata.cdc]
EP.03Get Epoch Counter[epoch/get_epoch_counter.cdc]
EP.04Get Epoch Phase[epoch/get_epoch_phase.cdc]

Quorum certificate transactions and scripts

IDNameSource
QC.01Create QC Voter[quorumCertificate/get_epoch_metadata.cdc]
QC.02Submit QC Vote[quorumCertificate/get_config_metadata.cdc]
QC.03Get Collector Cluster[quorumCertificate/scripts/get_cluster.cdc]
QC.04Get QC Enabled[quorumCertificate/scripts/get_qc_enabled.cdc]
QC.05Get Node Has Voted[quorumCertificate/scripts/get_node_has_voted.cdc]
QC.06Get QC Voting Complete[quorumCertificate/scripts/get_voting_completed.cdc]

DKG transactions and scripts

IDNameSource
DKG.01Create DKG Participant[dkg/create_participant.cdc]
DKG.02Get Configurable Metadata[dkg/send_whiteboard_message.cdc]
DKG.03Send Final Submission[dkg/send_final_submission.cdc]
DKG.04Get DKG Enabled[dkg/scripts/get_dkg_enabled.cdc]
DKG.05Get DKG Completed[dkg/scripts/get_dkg_completed.cdc]
DKG.06Get Whiteboard Messages[dkg/scripts/get_whiteboard_messages.cdc]
DKG.07Get Final Submissions[dkg/scripts/get_final_submissions.cdc]
DKG.08Get Node Has Submitted[dkg/scripts/get_node_has_submitted.cdc]

Events

See the epoch documentation for a list and documentation for important FlowEpoch events.

[epoch/get_epoch_metadata.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/epoch/scripts/get_epoch_metadata.cdc) [epoch/get_config_metadata.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/epoch/scripts/get_config_metadata.cdc [epoch/get_epoch_counter.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/epoch/scripts/get_epoch_counter.cdc [epoch/get_epoch_phase.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/epoch/scripts/get_epoch_phase.cdc)
[quorumCertificate/get_epoch_metadata.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/quorumCertificate/create_voter.cdc) [quorumCertificate/get_config_metadata.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/quorumCertificate/submit_vote.cdc [quorumCertificate/scripts/get_cluster.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/quorumCertificate/scripts/get_cluster.cdc [quorumCertificate/scripts/get_qc_enabled.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/quorumCertificate/scripts/get_qc_enabled.cdc [quorumCertificate/scripts/get_node_has_voted.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/quorumCertificate/scripts/get_node_has_voted.cdc [quorumCertificate/scripts/get_voting_completed.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/quorumCertificate/scripts/get_voting_completed.cdc [dkg/create_participant.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/create_participant.cdc [dkg/send_whiteboard_message.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/send_whiteboard_message.cdc [dkg/send_final_submission.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/send_final_submission.cdc [dkg/scripts/get_dkg_enabled.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/scripts/get_dkg_enabled.cdc [dkg/scripts/get_dkg_completed.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/scripts/get_dkg_completed.cdc [dkg/scripts/get_whiteboard_messages.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/scripts/get_whiteboard_messages.cdc [dkg/scripts/get_final_submissions.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/scripts/get_final_submissions.cdc [dkg/scripts/get_node_has_submitted.cdc]: https://github.com/onflow/flow-core-contracts/blob/master/transactions/dkg/scripts/get_node_has_submitted.cdc