Skip to content

Governance Event Schema Reference

This reference describes the input.governance event that Adder emits for a transaction that contains Cardano governance data. The event identifies the transaction and chain position, then groups proposal, voting, certificate, and committee data in the payload object.

Adder emits one input.governance event for each transaction that contains governance data. Adder omits the event when a transaction contains no governance data. Adder can emit the same transaction again after a rollback or replay.

The event contains these top-level fields:

FieldTypeDescription
timestampstringEvent timestamp.
typestringAlways input.governance.
contextobjectTransaction and chain position data.
payloadobjectBlock data and governance structures.

The context object identifies the transaction and its position on the chain.

FieldTypeDescription
transactionHashstring32-byte transaction hash in hexadecimal form.
blockNumbernumberAbsolute block height.
slotNumbernumberSlot number of the block.
transactionIdxnumberZero-based transaction index within the block.
networkMagicnumberNetwork magic value for the connected node.

The payload object contains the block hash and governance arrays. Adder omits an array when it contains no items.

FieldTypeDescription
blockHashstringBlock hash in hexadecimal form.
transactionCborstringTransaction CBOR in hexadecimal form when --input-chainsync-include-cbor is enabled.
proposalProceduresarrayGovernance actions proposed in the transaction.
votingProceduresarrayVotes cast in the transaction.
drepCertificatesarrayDRep registration, update, and deregistration certificates.
voteDelegationCertificatesarrayStake credential to DRep vote delegation certificates.
committeeCertificatesarrayConstitutional Committee authorization and resignation certificates.

Each item represents a proposed governance action.

FieldTypeDescription
indexnumberProposal index within the transaction.
depositnumber (uint64)Proposal deposit in Lovelaces. Adder emits the field as a non-negative unsigned 64-bit value.
rewardAccountstringStake or reward address that receives the deposit after completion.
actionTypestringOne of ParameterChange, HardForkInitiation, TreasuryWithdrawal, NoConfidence, UpdateCommittee, NewConstitution, Info, or Unknown.
actionDataobjectData for the selected action type.
anchorobjectGovernance metadata with url and dataHash strings.

Each item represents a vote on an active proposal.

FieldTypeDescription
voterTypestringDRep, SPO, CCHot, or Unknown.
voterHashstringVoter credential hash in hexadecimal form.
voterIdstringBech32 voter identifier, such as drep1....
govActionTxIdstringTransaction ID of the governance action.
govActionIndexnumberGovernance action index within that transaction.
votestringYes, No, Abstain, or Unknown.
anchorobjectGovernance metadata with url and dataHash strings.

Each item represents a change to a DRep status.

FieldTypeDescription
certificateTypestringRegistration, Update, or Deregistration.
drepHashstringDRep credential hash in hexadecimal form.
drepIdstringBech32 DRep ID, such as drep1... or drep_script1....
depositnumber (uint64)Lovelace deposit for registration or deregistration. Adder emits the field as a non-negative unsigned 64-bit value when present and omits it when its value is zero.
anchorobjectDRep metadata with url and dataHash strings.

Each item represents a stake address delegating voting power to a DRep or a predefined state.

FieldTypeDescription
certificateTypestringOne of VoteDelegation, StakeVoteDelegation, VoteRegistrationDelegation, or StakeVoteRegistrationDelegation.
stakeCredentialstringDelegator stake credential hash in hexadecimal form.
drepTypestringKeyHash, ScriptHash, Abstain, or NoConfidence.
drepHashstringDRep credential hash in hexadecimal form; Adder omits it for Abstain and NoConfidence.
drepIdstringBech32 DRep ID; Adder omits it for Abstain and NoConfidence.
poolKeyHashstringPool key hash in hexadecimal form for combined stake and vote delegation types.
depositnumber (uint64)Lovelace deposit for registration and delegation types. Adder emits the field as a non-negative unsigned 64-bit value when present and omits it when its value is zero.

Each item represents a Constitutional Committee credential change.

FieldTypeDescription
certificateTypestringAuthHot for hot credential authorization or ResignCold for cold credential resignation.
coldCredentialstringCommittee cold credential hash in hexadecimal form.
hotCredentialstringCommittee hot credential hash in hexadecimal form for AuthHot.
anchorobjectMetadata with url and dataHash strings.

JSON represents the three deposit fields as numeric values. The JSON format does not enforce a language-specific integer type. Consumers must deserialize each present value as a non-negative unsigned 64-bit integer and preserve the full range from 0 through 18,446,744,073,709,551,615.

Values greater than 9,223,372,036,854,775,807 exceed the signed 64-bit maximum. Consumers must not convert these values to signed integers or clamp them at that maximum.

The following example shows the three deposit fields, including values above the signed 64-bit maximum:

{
"timestamp": "2026-07-17T21:40:00Z",
"type": "input.governance",
"context": {
"transactionHash": "58200a1ad4abcd7290bc9831d102e34fa9de1e0287a98bcdef1238b1f20a67bc",
"blockNumber": 10528430,
"slotNumber": 68493120,
"transactionIdx": 3,
"networkMagic": 764824073
},
"payload": {
"blockHash": "13aa2accf2e1561723aa26871e071fdf32c867cff7e7d50ad470d62fdeadbeef",
"proposalProcedures": [
{
"index": 0,
"deposit": 18446744073709551615,
"rewardAccount": "stake_test1u9f9v0z5zzlldgx58n8tklphu8mf7h4jvp2j2gddluemnssjfnkzz",
"actionType": "Info",
"actionData": {},
"anchor": { "url": "", "dataHash": "" }
}
],
"drepCertificates": [
{
"certificateType": "Registration",
"drepHash": "81f156d98e1f02123abccdef5439a89d71fa9d8b76c8db028c7df0e1",
"drepId": "drep1p4h4ea7y70ede2wy7x3t83x4umm63wwq68308f94cmt7szexmnr",
"deposit": 9223372036854775808,
"anchor": { "url": "", "dataHash": "" }
}
],
"voteDelegationCertificates": [
{
"certificateType": "VoteRegistrationDelegation",
"stakeCredential": "81f156d98e1f02123abccdef5439a89d71fa9d8b76c8db028c7df0e1",
"drepType": "Abstain",
"deposit": 42
}
]
}
}

Use the following filters with --filter-type input.governance:

FlagDescription
--filter-drepMatches DRep registration, update, and deregistration certificates; vote delegation certificates targeting the DRep; and votes cast by the DRep. The value accepts hexadecimal or Bech32 form, including script DRep IDs.
--filter-poolMatches votes cast by a stake pool as an SPO and vote delegation certificates that reference the pool key hash.
--filter-addressMatches proposal reward accounts, treasury withdrawal destination addresses, and delegating stake credentials.

For example, filter governance events for a DRep with:

Terminal window
./adder --filter-type input.governance \
--filter-drep drep1p4h4ea7y70ede2wy7x3t83x4umm63wwq68308f94cmt7szexmnr

Doc Holiday logo

Docs authored by Doc Holiday