Certificate Types¶

enum cardano_cert_type_t¶

Certificates are used to register, update, or deregister stake pools, and delegate stake.

Values:

enumerator CARDANO_CERT_TYPE_STAKE_REGISTRATION¶

This certificate is used when an individual wants to register as a stakeholder.

It allows the holder to participate in the staking process by delegating their stake or creating a stake pool.

enumerator CARDANO_CERT_TYPE_STAKE_DEREGISTRATION¶

This certificate is used when a stakeholder no longer wants to participate in staking.

It revokes the stake registration and the associated stake is no longer counted when calculating stake pool rewards.

enumerator CARDANO_CERT_TYPE_STAKE_DELEGATION¶

This certificate is used when a stakeholder wants to delegate their stake to a specific stake pool.

It includes the stake pool id to which the stake is delegated.

enumerator CARDANO_CERT_TYPE_POOL_REGISTRATION¶

This certificate is used to register a new stake pool.

It includes various details about the pool such as the pledge, costs, margin, reward account, and the pool’s owners and relays.

enumerator CARDANO_CERT_TYPE_POOL_RETIREMENT¶

This certificate is used to retire a stake pool.

It includes an epoch number indicating when the pool will be retired.

enumerator CARDANO_CERT_TYPE_GENESIS_KEY_DELEGATION¶

This certificate is used to delegate from a Genesis key to a set of keys.

This was primarily used in the early phases of the Cardano network’s existence during the transition from the Byron to the Shelley era.

enumerator CARDANO_CERT_TYPE_MOVE_INSTANTANEOUS_REWARDS¶

Certificate used to facilitate an instantaneous transfer of rewards within the system.

enumerator CARDANO_CERT_TYPE_REGISTRATION¶

This certificate is used when an individual wants to register as a stakeholder.

It allows the holder to participate in the staking process by delegating their stake or creating a stake pool.

Deposit must match the expected deposit amount specified by ppKeyDepositL in the protocol parameters.

Remark: Replaces the deprecated StakeRegistration in after Conway era.

enumerator CARDANO_CERT_TYPE_UNREGISTRATION¶

This certificate is used when a stakeholder no longer wants to participate in staking.

It revokes the stake registration and the associated stake is no longer counted when calculating stake pool rewards.

Deposit must match the expected deposit amount specified by ppKeyDepositL in the protocol parameters.

Remark: Replaces the deprecated StakeDeregistration in after Conway era.

enumerator CARDANO_CERT_TYPE_VOTE_DELEGATION¶

This certificate is used when an individual wants to delegate their voting rights to any other DRep.

enumerator CARDANO_CERT_TYPE_STAKE_VOTE_DELEGATION¶

This certificate is used when an individual wants to delegate their voting rights to any other DRep and simultaneously wants to delegate their stake to a specific stake pool.

enumerator CARDANO_CERT_TYPE_STAKE_REGISTRATION_DELEGATION¶

This certificate Register the stake key and delegate with a single certificate to a stake pool.

enumerator CARDANO_CERT_TYPE_VOTE_REGISTRATION_DELEGATION¶

This certificate Register the stake key and delegate with a single certificate to a DRep.

enumerator CARDANO_CERT_TYPE_STAKE_VOTE_REGISTRATION_DELEGATION¶

This certificate is used when an individual wants to register its stake key, delegate their voting rights to any other DRep and simultaneously wants to delegate their stake to a specific stake pool.

enumerator CARDANO_CERT_TYPE_AUTH_COMMITTEE_HOT¶

This certificate registers the Hot and Cold credentials of a committee member.

enumerator CARDANO_CERT_TYPE_RESIGN_COMMITTEE_COLD¶

This certificate is used then a committee member wants to resign early (will be marked on-chain as an expired member).

enumerator CARDANO_CERT_TYPE_DREP_REGISTRATION¶

In Voltaire, existing stake credentials will be able to delegate their stake to DReps for voting purposes, in addition to the current delegation to stake pools for block production.

DRep delegation will mimic the existing stake delegation mechanisms (via on-chain certificates).

This certificate register a stake key as a DRep.

enumerator CARDANO_CERT_TYPE_DREP_UNREGISTRATION¶

This certificate unregister an individual as a DRep.

Note that a DRep is retired immediately upon the chain accepting a retirement certificate, and the deposit is returned as part of the transaction that submits the retirement certificate (the same way that stake credential registration deposits are returned).

enumerator CARDANO_CERT_TYPE_UPDATE_DREP¶

Updates the DRep anchored metadata.