Account

The Account entity represents accounts observed in the network activity. For example, when the corresponding public key was passed as a deploy argument. With this approach, CSPR.cloud is also capable of capturing accounts that don’t have an on-chain balance, but which can own fungible or non-fungible tokens (NFT). Such accounts will have the purse and the on-chain balance returned by CSPR.cloud API.

Properties

The Account entity has the following properties:

Property
Type
Description

public_key

string(68)

Account public key represented as a hexadecimal string. Primary account identifier

account_hash

string(64)

32-byte hash of the public_key represented as a hexadecimal string. Secondary account identifier

balance

uint64

The liquid balance of the account’s main purse in motes

main_purse_uref

string(73)

Account main purse URef in the uref-dead...beef-007 format

deployment_threshold

uint64

The minimum total weight of associated keys required to deploy (i.e. execute transfer).

key_management_threshold

uint64

The minimum total weight of associated keys required to perform key management operations (e.g. add/remove keys, change thresholds).

genesis_balance

uint64

The initial token balance allocated to the account at the network genesis, before any transfers have occurred.

Example

{
  "account_hash": "fa12d2dd5547714f8c2754d418aa8c9d59dc88780350cb4254d622e2d4ef7e69",
  "balance": 1801534117600521,
  "genesis_balance": 1801534117600521,
  "deployment_threshold": 1,
  "key_management_threshold": 1,
  "main_purse_uref": "uref-bb9f47c30ddbe192438fad10b7db8200247529d6592af7159d92c5f3aa7716a1-007",
  "public_key": "0106ca7c39cd272dbf21a86eeb3b36b7c26e2e9b94af64292419f7862936bca2ca"
}

Optional properties

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

Property
Type
Description

auction_status

string

Account auction status: inactive_bidder, active_bidder, active_validator, pending_validator

delegated_balance

uint64

Total funds delegated across all validators

staked_balance

uint64

Total funds staked as validator

undelegating_balance

uint64

Total undelegated funds that will be returned to the account main purse after the 7 era lockdown period. Accounts that delegate to a validator with a max delegation amount will have the exceed reward amount automatically undelegated at the end of every era

account_info

Account info provided by the account owner

centralized_account_info

Account information available for known accounts provided by CSPR.cloud team

cspr_name

string

Primary CSPR.name of the account

rank

uint64

Rank of the account based on its total balance on the network

Relations

The Account entity has the following relations with other entities:

Entity
Mapping property
Description

account_hash

Account can have account info data if provided by the owner to the Account Info contract

public_key

Account can be a bidder in the auction

owner_public_key

Account can deploy contracts to the network

caller_public_key

Account can call deploys on the network

proposer_public_key

Account can have delegations to validators

public_key

Account can receive delegator rewards

owner_hash

Account can own fungible tokens

from_hash, to_hash

Account can be on the sending or receiving end of a fungible token action

owner_hash

Account can own NFTs

from_hash, to_hash

Account can be on the sending or receiving end of a fungible token action

owner_hash

Account can own multiple NFTs in one NFT contract

initiator_account_hash, to_account_hash

Account can initiate transfers and be a transfer recipient

public_key

Account can be a validator

Endpoints

The Account entity has the following endpoints:

Relation endpoints

The Account entity has the following relation endpoints:

Last updated