コンテンツにスキップ

ガバナンスイベントリファレンス

Adderは、Cardanoブロックチェーン上のオンチェーンガバナンスアクションと証明書の活動について、構造化イベントを出力します。AdderはイベントにConway時代のガバナンスデータを含め、提案、投票、DRep登録、投票委任、憲法委員会の変更を監視できるようにします。

chainsync入力プラグインは、Conway時代のオンチェーンガバナンスデータを含むブロック内トランザクションごとに、input.governanceイベントを1件出力します。1件のトランザクションからは必ず1件のinput.governanceイベントを出力し、そのトランザクションから検出したすべてのガバナンスデータをイベントにまとめます。

Adderは、同じトランザクションの通常のinput.transactionイベントに加えてガバナンスイベントも出力します。ロールバック後の再生または再処理では、Adderが同じトランザクションを再度出力することがあります。ガバナンスデータを含まないトランザクションは、input.governanceイベントを生成しません。

  • イベントタイプ名: input.governance

ガバナンスイベントは、timestamp、type、context、payloadを含むトップレベルのJSONオブジェクトです。

contextオブジェクトは、ガバナンスデータを検出したトランザクションとチェーン上の位置を示します。

フィールド型説明
transactionHashstringガバナンスデータを含むトランザクションの32バイト、16進数エンコード済みハッシュ。
blockNumbernumberトランザクションを含むブロックの絶対ブロック高。
slotNumbernumberトランザクションを含むブロックのスロット番号。
transactionIdxnumberブロック内のトランザクションのインデックス(0始まり)。
networkMagicnumber接続先ノードのネットワークマジック識別子。

payloadオブジェクトは、ブロック情報とガバナンス関連項目の配列を含みます。Adderは各配列が空の場合にその配列を省略します。

フィールド型説明
blockHashstringトランザクションを含むブロックの16進数エンコード済みハッシュ。
transactionCborstring16進数形式の生トランザクションCBOR。Adderは--input-chainsync-include-cborを設定した場合だけこのフィールドを含めます。
proposalProceduresarrayこのトランザクションで提案したガバナンスアクションの一覧。
votingProceduresarrayこのトランザクションで実行した投票の一覧。
drepCertificatesarrayDRepの登録、更新、または登録解除証明書の一覧。
voteDelegationCertificatesarrayステーク資格情報からDRepへの投票委任証明書の一覧。
committeeCertificatesarray憲法委員会の承認または辞任証明書の一覧。

提案、DRep、投票委任の各depositフィールドはuint64として値を保持します。Adderは0から18446744073709551615までの値を保持します。下流のコンシューマーは符号付き値としてデシリアライズしたり、MaxInt64でクランプしたりしないでください。

新しいガバナンス提案を表します。

フィールド型説明
indexnumberトランザクション内の提案インデックス。
deposituint64この提案がロックするLovelaceのデポジット。Adderはuint64として値を保持します。
rewardAccountstring完了時にデポジットを返すステークまたは報酬アドレス。
actionTypestringParameterChange、HardForkInitiation、TreasuryWithdrawal、NoConfidence、UpdateCommittee、NewConstitution、Infoのいずれか。認識されないタイプにはUnknownを使用します。
actionDataobjectアクション固有のデータ。認識されたアクションでは、アクション名(parameterChange、treasuryWithdrawal、newConstitutionなど)をキーとする1つのフィールドに値を設定します。
anchorobject{ "url", "dataHash" }。メタデータがない場合、両方の文字列は空です。

アクティブな提案への投票を表します。

フィールド型説明
voterTypestringDRep(Delegate Representative)、SPO(Stake Pool Operator)、CCHot(Constitutional Committee Hot Credential)のいずれか。認識されないタイプにはUnknownを使用します。
voterHashstring投票者の資格情報ハッシュを16進数でエンコードした値。
voterIdstring投票者のBech32識別子(例: drep1...)。
govActionTxIdstring投票対象のガバナンスアクションのトランザクションID。
govActionIndexnumberそのトランザクション内のガバナンスアクションのインデックス。
votestring実行した投票。Yes、No、Abstainのいずれか。認識されない値にはUnknownを使用します。
anchorobject{ "url", "dataHash" }。投票メタデータがない場合、両方の文字列は空です。

DRepの状態変更を表します。

フィールド型説明
certificateTypestringRegistration、Update、Deregistrationのいずれか。
drepHashstringDRep資格情報ハッシュを16進数でエンコードした値。
drepIdstringBech32形式のDRep ID(drep1...またはdrep_script1...)。
deposituint64登録時に必要なLovelaceのデポジット、または登録解除時に返すLovelaceのデポジット。Adderは値をuint64として保持し、0の場合は省略します。
anchorobject{ "url", "dataHash" }。DRepメタデータがない場合、両方の文字列は空です。

ステークアドレスがDRepまたは事前定義された状態に投票権を委任したことを表します。

フィールド型説明
certificateTypestringVoteDelegation、StakeVoteDelegation、VoteRegistrationDelegation、StakeVoteRegistrationDelegationのいずれか。
stakeCredentialstring委任元のステーク資格情報ハッシュを16進数でエンコードした値。
drepTypestring委任先。KeyHash、ScriptHash、Abstain、NoConfidenceのいずれか。
drepHashstringDRep資格情報ハッシュを16進数でエンコードした値。AbstainまたはNoConfidenceではAdderはこのフィールドを省略します。
drepIdstringBech32形式のDRep ID。AbstainまたはNoConfidenceではAdderはこのフィールドを省略します。
poolKeyHashstringプールキーのハッシュを16進数でエンコードした値。Adderはステーク委任と投票委任を組み合わせたタイプだけこのフィールドを含めます。
deposituint64登録委任タイプのLovelaceデポジット。Adderは値をuint64として保持し、0の場合は省略します。

憲法委員会の資格情報の変更を表します。

フィールド型説明
certificateTypestringホット資格情報を承認するAuthHot、またはコールド資格情報を辞任するResignCold。
coldCredentialstring委員会のコールド資格情報ハッシュを16進数でエンコードした値。
hotCredentialstring委員会のホット資格情報ハッシュを16進数でエンコードした値。AdderはAuthHotの場合だけこのフィールドを含めます。
anchorobjectAdderは常にシリアライズします。ResignCold証明書がメタデータを提供しない場合、文字列は空です。

対応するガバナンスアクション

Section titled “対応するガバナンスアクション”

Conway台帳は、次の7種類の提案アクションを定義します。

  1. ParameterChange: 1つ以上のネットワークプロトコルパラメーターの更新を提案します。
  2. HardForkInitiation: 新しいプロトコルバージョンへのハードフォークを提案します。
  3. TreasuryWithdrawal: 指定した報酬アカウントへのLovelaceの国庫引き出しを提案します。
  4. NoConfidence: 現在の憲法委員会への不信任を提案します。
  5. UpdateCommittee: 憲法委員会のメンバー、しきい値、または任期の変更を提案します。
  6. NewConstitution: ネットワーク憲法とそのオフチェーンアンカーの更新を提案します。
  7. Info: 台帳状態を変更しないアクションです。通常はコミュニティの意向確認や告知に使用します。

ガバナンスイベントのフィルタリング

Section titled “ガバナンスイベントのフィルタリング”

ガバナンスイベントは、次のCardano固有のパイプラインフィルターに対応します。

  • DRepフィルタリング(--filter-drep): 特定のDRepに関係するイベントに一致します。対象はDRepの登録、更新、登録解除証明書、そのDRepを対象とする投票委任証明書、そのDRepが投票者である投票手順です。16進数形式とBech32形式(スクリプトDRep IDを含む)に対応します。
  • プールフィルタリング(--filter-pool): ステークプールに関係するイベントに一致します。対象は、SPOとしてプールが実行した投票手順と、プールキーハッシュを参照する投票委任証明書です。
  • アドレスフィルタリング(--filter-address): ガバナンスアクションに関係するアドレスに一致します。対象は、提案の報酬アカウント、国庫引き出し先アドレス、委任元のステーク資格情報です。
ターミナルウィンドウ
# Bech32でDRepをフィルタリング
./adder --filter-type input.governance \
--filter-drep drep1p4h4ea7y70ede2wy7x3t83x4umm63wwq68308f94cmt7szexmnr
# ステークアドレスをフィルタリング(カンマ区切りの複数アドレスはOR)
./adder --filter-type input.governance \
--filter-address stake1u9f9v0z5zzlldgx58n8tklphu8mf7h4jvp2j2gddluemnssjfnkzz
plugins:
filter:
event:
type: "input.governance"
cardano:
drep: "drep1p4h4ea7y70ede2wy7x3t83x4umm63wwq68308f94cmt7szexmnr"
address: "stake1u9f9v0z5zzlldgx58n8tklphu8mf7h4jvp2j2gddluemnssjfnkzz"

次の例は、DRep登録証明書を含むinput.governanceイベントのペイロードです。

{
"timestamp": "2026-07-17T21:40:00Z",
"type": "input.governance",
"context": {
"transactionHash": "58200a1ad4abcd7290bc9831d102e34fa9de1e0287a98bcdef1238b1f20a67bc",
"blockNumber": 10528430,
"slotNumber": 68493120,
"transactionIdx": 3,
"networkMagic": 764824073
},
"payload": {
"blockHash": "13aa2accf2e1561723aa26871e071fdf32c867cff7e7d50ad470d62fdeadbeef",
"drepCertificates": [
{
"certificateType": "Registration",
"drepHash": "81f156d98e1f02123abccdef5439a89d71fa9d8b76c8db028c7df0e1",
"drepId": "drep1p4h4ea7y70ede2wy7x3t83x4umm63wwq68308f94cmt7szexmnr",
"deposit": 500000000,
"anchor": {
"url": "https://example.com/drep-metadata.json",
"dataHash": "58200a1ad4abcd7290bc9831d102e34fa9de1e0287a98bcdef1238b1f20a67bc"
}
}
]
}
}

Doc Holiday logo

Docs authored by Doc Holiday