Delegation

The Delegation entity represents a record of a delegation transaction in the context of Casper Network Staking vs. Delegating process

Properties

The Delegation entity has the following properties:

Property	Type	Description
delegator_identifier	string(64)	A representation of the delegator identifier, which can be either: a hex-encoded public key, or a purse URef, depending on delegator_identifier_type_id
delegator_identifier_type_id	uint8	Identifier representing the type of the delegator identifier: 0 for PublicKey, 1 for purse URef`
public_key	string(68)	Public key of the delegator represented as a hexadecimal string (deprecated: use delegator_identifier instead, this property will be removed in future versions)
validator_public_key	string(68)	Public key of the validator represented as a hexadecimal string
stake	string	Delegation amount in motes. The type is string to avoid overflow in languages that don't support uint64, which is the correct type.
bonding_purse	string(72)	URef of the purse from which the delegation was made in the uref-dead...beef-007 format

Example

{
  "bonding_purse": "uref-2bd212c2b75dbc99a6ac8ea7d543b322967f39132ad7bc2c927cfed21d3fce4a-007",
  "delegator_identifier": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02",
  "delegator_identifier_type_id": 0,
  "public_key": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02",
  "stake": "10118248961309619",
  "validator_public_key": "0107a9a673f54c231da8a9cf96e041701293e15c7f05dd5e7fddb2678ccb411555"
}

Optional properties

Depending on the endpoint some of the following optional properties may be included in the Delegation entity:

Property	Type	Description
account_info	AccountInfo	Account info provided by the delegator
validator_account_info	AccountInfo	Account info provided by the validator
centralized_account_info	CentralizedAccountInfo	Account information available for known accounts provided by CSPR.cloud team
bidder	Bidder	Bidder auction info of the validator
cspr_name	string	Primary CSPR.name of the account
validator_cspr_name	string	Primary CSPR.name of the validator account

Relations

The Delegation entity has the following relations with other entities:

Entity	Mapping property	Description
Account	public_key	Delegations are made by accounts
Validator	validator_public_key	Delegations are made to validators
Bidder	validator_public_key	Delegations can be made to bidders who are not validators yet

Endpoints

The Delegation entity has the following endpoints:

• Get account delegations

• Get purse delegations

• Get validator delegations

Relation endpoints

None