Types
The following definitions expand on parameters seen elsewhere within the SDK standard and are provided for clarity and completeness.
Account
Structure representing a user's Account, stored in global state.
Required Parameters:
AccountActionThresholds
Thresholds that have to be met when executing an action of a certain type.
Required Parameters:
-
deployment
Threshold for deploy execution. -
key_management
Threshold for managing account keys.
AccountAssociatedKeys
A collection of weighted public keys (represented as account hashes) associated with an account.
AccountAssociatedKeyWeight
The weight associated with public keys in an account's associated keys.
AccountHash
The AccountHash is a 32-byte hash derived from a supported PublicKey. Its role is to standardize keys that can vary in length.
AccountIdentifier
Identifier of an account.
Contains one of:
ActivationPoint
The first era to which the associated protocol version applies.
Any of:
AddressableEntity
AddressableEntityHash
The hex-encoded address of the addressable entity.
Approval
A struct containing a signature and the public key of the signer.
Required Parameters:
Array_of_AssociatedKey
An array of AssociatedKeys.
Array_of_BlockProof
An array of BlockProofs
.
Array_of_EntityVersionAndHash
An array of EntityVersionAndHashes.
Array_of_EraReward
An array of EraRewards.
Array_of_MessageTopic
An array of MessageTopics.
Array_of_NamedEntryPoint
An array of named entry points.
Array_of_NamedUserGroup
An array of NamedUserGroups.
Array_of_PublicKeyAndBid
An array of bids associated with given public keys.
Array_of_PublicKeyAndDelegator
An array consisting of PublicKeyAndDelegators.
Array_of_ValidatorWeight
An array of ValidatorWeights
.
AssociatedKey
A key granted limited permissions to an Account, for purposes such as multisig.
Required Parameters:
AuctionState
Data structure summarizing auction contract data.
Required Parameters:
-
bids
All bids contained within a vector. -
block_height
Block height. -
era_validators
Era validators. -
state_root_hash
Global state hash.
AvailableBlockRange
An unbroken, inclusive range of blocks.
Required Parameters:
-
low
The inclusive lower bound of the range. -
high
The inclusive upper bound of the range.
BalanceHoldWithProof
Hold amount at a given block time.
Required Parameters:
-
amount
The amount in the hold. -
proof
A string proof that the given value is present in the Merkle trie. -
time
The block time at which the hold was created.
Bid
An entry in the validator map.
Required Parameters:
-
bonding_purse
The purse that was used for bonding. -
delegation_rate
The delegation rate. -
delegators
The validator's delegators, indexed by their public keys. -
inactive
true
if validator has been "evicted". -
staked_amount
The amount of tokens staked by a validator (not including delegators). -
validator_public_key
Validator's public key.
Optional Parameters:
vesting_schedule
Vesting schedule for a genesis validator.None
if non-genesis validator.
BidKind
Auction bid variants.
One of:
-
Unified
A unified record indexed on validator data, with an embedded collection of all delegator bids assigned to that validator. The `Unified`` variant is for legacy retrograde support; new instances will not be created going forward. -
Validator
A bid record containing only validator data. -
Delegator
A bid record containing only delegator data. -
Bridge
A bridge record pointing to a newValidatorBid
after the public key was changed. -
Credit
Credited amount.
Block
A block after execution.
One of:
BlockBodyV1
The body portion of a block prior to Casper 2.0.
Required Parameters:
-
deploy_hashes
The deploy hashes of the non-transfer deploys within the block. -
proposer
The public key of the validator that proposed the block. -
transfer_hashes
The deploy hashes of the transfers within the block.
BlockBodyV2
The body portion of a block.
Required Parameters:
-
rewarded_signatures
List of identifiers for finality signatures for a particular past block. -
transactions
Map of transactions mapping categories to a list of transaction hashes.
BlockHash
A cryptographic hash identifying a Block
.
BlockHeader
The versioned header portion of a block. It encapsulates different variants of the BlockHeader
struct.
One of:
-
Version1
The legacy, initial version of the header portion of a block. -
Version2
The version 2 of the header portion of a block.
BlockHeaderV1
The header portion of a block prior to Casper 2.0.
Required Parameters:
-
height
The height of this block. -
random_bit
A random bit needed for initializing a future era.
Optional Parameters:
BlockHeaderV2
The header portion of a block.
Required Parameters:
-
accumulated_seed
A seed needed for initializing a future era. -
body_hash
The hash of the block's body. -
current_gas_price
The gas price of the era. -
height
The height of this block. -
parent_hash
The parent block's hash. -
proposer
The public key of the validator which proposed the block. -
protocol_version
The protocol version of the network from when this block was created. -
random_bit
A random bit needed for initializing a future era. -
state_root_hash
The root hash of global state after the deploys in this block have been executed. -
timestamp
The timestamp from when the block was proposed.
Optional Parameters:
-
era_end
TheEraEnd
of a block if it is a switch block. -
last_switch_block_hash
The most recent switch block hash.
BlockIdentifier
Identifier for possible ways to retrieve a Block.
-
Hash
Identify and retrieve the Block with its hash. -
Height
Identify and retrieve the Block with its height.
BlockProof
A validator's public key paired with a corresponding signature of a given block hash.
Required Parameters:
BlockSynchronizerStatus
The status of the block synchronizer.
Optional Parameters:
-
Historical
The status of syncing a historical block, if any. -
Forward
The status of syncing a forward block, if any.
BlockSyncStatus
The status of syncing an individual block.
Required Parameters:
-
acquisition_state
The state of acquisition of the data associated with the block as a string. -
block_hash
The block hash.
Optional Parameters:
block_height
The height of the block, if known.
BlockTime
A newtype wrapping a u64
, which represents the block time.
BlockV1
A block after execution with the resulting global state root hash prior to Casper 2.0. This is the core component of the Casper linear blockchain.
Required Parameters:
-
body
The body portion of the block. -
hash
The block hash identifying this block. -
header
The header portion of the block.
BlockV2
A block after execution, with the resulting global state root hash. This is the core component of the Casper linear blockchain.
Required Parameters:
-
body
The body portion of the block. -
hash
The block hash identifying this block. -
header
The header portion of the block.
Bridge
A bridge record pointing to a new ValidatorBid
after the public key was changed.
Required Parameters:
-
era_id
Era when bridge record was created. -
old_validator_public_key
Previous validator public key associated with the bid. -
new_validator_public_key
New validator public key associated with the bid.
Bytes
Hex-encoded bytes.
ByteCode
A container for a contract's Wasm bytes.
Required Parameters:
ByteCodeHash
The hex-encoded address of a smart contract AddressableEntity
.
ByteCodeKind
The type of byte code.
One of:
-
Empty
Empty byte code. -
V1CasperWasm
Byte code to be executed with the version 1 Casper execution engine.
BytesreprError
Serialization and deserialization errors.
-
EarlyEndOfStream
Early end of stream while deserializing. -
Formatting
Formatting error while deserializing. -
LeftOverBytes
Not all input bytes were consumed. -
OutOfMemory
Out of memory error. -
NotRepresentable
No serialized representation is available for a value. -
ExceededRecursionDepth
Exceeded a recursion depth limit.
ChainspecRawBytes
The raw bytes of the chainspec.toml, genesis accounts.toml, and global_state.toml files.
Required Parameters:
chainspec_bytes
Hex-encoded raw bytes of the current chainspec.toml file.
Optional Parameters:
-
maybe_genesis_accounts_bytes
Hex-encoded raw bytes of the current genesis accounts.toml file. -
maybe_global_state_bytes
Hex-encoded raw bytes of the current global_state.toml file.
Contract
A contract struct that can be serialized as a JSON object.
Required Parameters:
ContractHash
The hash address of the contract.
ContractPackage
Contract definition, metadata and security container.
Required Parameters:
ContractPackageHash
The hash address of the contract package.
ContractPackageStatus
An enum to determine the lock status of the contract package.
One of:
-
Locked
The package is locked and cannot be versioned. -
Unlocked
The package is unlocked and can be versioned.
ContractVersion
The version of the contract.
Required Parameters:
-
contract_version
-
protocol_version_major
ContractVersionKey
Major element of ProtocolVersion
combined with ContractVersion
.
ContractWasm
A container for a contract's Wasm bytes.
Required Parameter:
ContractWasmHash
The hash address of the contract Wasm.
Delegator
Represents a party delegating their stake to a validator (or "delegatee").
Required Parameters:
Additional Parameters:
Deploy
A Deploy; an item containing a smart contract along with the requester's signature(s).
Required properties:
DeployHash
Hex-encoded Deploy hash.
DeployHeader
The header portion of a Deploy.
Required Parameters:
-
chain_name
A user defined string. -
gas_price
Defined as an integer in UInt64 format.
DeployInfo
Information relating to the given Deploy.
Required Parameters:
-
deploy_hash
The relevant Deploy. -
from
Account identifier of the creator of the Deploy. -
gas
Gas cost of executing the Deploy. -
source
Source purse used for payment of the Deploy. -
transfers
Transfers performed by the Deploy.
DictionaryIdentifier
Options for dictionary item lookups.
-
AccountNamedKey
Lookup a dictionary item via an Account's named keys.Required Parameters:
-
key
The Account key as a formatted string whose named keys contain dictionary_name. -
dictionary_name
The named key under which the dictionary seed URef is stored. -
dictionary_item_key
The dictionary item key formatted as a string.
-
-
ContractNamedKey
Lookup a dictionary item via a Contract's named keys.Required Parameters:
-
key
The contract key as a formatted string whose named keys contains dictionary_name. -
dictionary_name
The named key under which the dictionary seed URef is stored. -
dictionary_item_key
The dictionary item key formatted as a string.
-
-
EntityNamedKey
Required Parameters:
-
key
The entity address formatted as a string. -
dictionary_name
The named key under which the dictionary seed URef is stored. -
dictionary_item_key
The dictionary item key formatted as a string.
-
-
URef
Lookup a dictionary item via its seed URef.Required Parameters:
-
seed_uref
The dictionary's seed URef. -
dictionary_item_key
The dictionary item key formatted as a string.
-
-
Dictionary
Lookup a dictionary item via its unique key.
Digest
Hex-encoded hash digest.
Effects
A log of all transforms produced during execution.
EntityActionThresholds
Thresholds that have to be met when executing an action of a certain type.
Required Parameters:
-
deployment
Threshold for deploy execution. -
key_management
Threshold for managing account keys. -
upgrade_management
Threshold for upgrading contracts.
EntityAddr
The address for an AddressableEntity which contains the 32 bytes and tagging information.
Any of:
-
The address for a system entity account or contract.
-
The address of an entity that corresponds to an Account.
-
The address of an entity that corresponds to a user (non-system) smart contract.
EntityAssociatedKeys
A collection of weighted public keys (represented as account hashes) associated with an account. See Array_of_AssociatedKey.
EntityAssociatedKeyWeight
The weight associated with public keys in an entity's associated keys.
EntityIdentifier
Identifier of an addressable entity.
One of:
EntityKind
The type of Package
.
One of:
-
System
Package associated with a native contract implementation. -
Account
Package associated with an Account hash. -
SmartContract
Packages associated with Wasm stored on chain.
EntityOrAccount
An addressable entity or a legacy account.
One of:
-
AddressableEntity
An addressable entity. -
Account
A legacy account.
EntityVersionAndHash
An entity version associated with the given hash.
Required Parameters:
EntityVersionKey
Major element of ProtocolVersion
combined with EntityVersion
.
Required Parameters:
-
entity_version
Automatically incremented value for a contract version within a majorProtocolVersion
. -
protocol_version_major
Major element ofProtocolVersion
with which aContractVersion
is compatible.
EntryPoint
Metadata describing a callable entry point and its return value, if any. All required parameters should be declared, whereas all non-required parameters should not be declared. Non-required parameters should not be confused with optional parameters.
Required Parameters:
-
name
EntryPoint2
Type signature of a method. Order of arguments matters since they can be referenced by index as well as their name.
Required Parameters:
-
name
The string name of the entrypoint.
EntryPointAccess
Enum describing the possible access control options for a contract entry point.
One of:
-
Public
A public entry point is callable by any caller. -
Groups
Only callers from the authorized, listed groups may call this entry point. Note: If this list is empty then this entry point is not callable from outside the contract. -
Template
A string type that can't be accessed directly but is kept in the derived Wasm bytes.
EntryPointPayment
An enum specifying who pays for the invocation and execution of the entrypoint.
One of:
-
Caller
The caller must cover the cost. -
SelfOnly
The current execution will cover the cost to execute self but not the cost of any subsequently invoked contracts. -
SelfOnward
The current execution will cover the cost to execute self and the cost of any subsequently invoked contracts.
EntryPointType
Context of an entry point execution. The most significant bit represents the version. For example, 0b0
represents session and contract entry points up to version 2.0. And, 0b1
is for versions 2.x and later (i.e. installer and utility entry points).
One of:
-
Caller
Runs using the calling entity's context. In v1.x, this was used for both session code that ran using the originating account's context and stored session code that ran in the caller's context. In v2.x, the renamed Caller variant is exclusively used for Wasm running using the initiating account entity's context. Previously installed 1.x stored session code should continue to work as the binary value matches, but we no longer allow such logic to be upgraded, nor do we allow new stored session code to be installed. -
Called
Runs within the called entity's context. -
Factory
This entry point is intended to extract a subset of bytecode. Runs within the called entity's context.
EntryPointValue
The encaspulated representation of entrypoints.
One of:
-
V1CasperVm
Entrypoints to be executed against the V1 Casper VM. -
V2CasperVm
Entrypoints to be executed against the V2 Casper VM.
EntryPointV2
The entry point for the V2 Casper VM.
Required Parameters:
-
flags
The flags as a uint32 integer. -
function_index
The selector as a uint32 integer.
EraEndV1
Information related to the end of an era and validator weights for the following era prior to Casper 2.0.
Required Parameters:
EraEndV2
Information related to the end of an era and validator weights for the following era.
Required Parameters:
-
equivocators
The set of equivocators. -
inactive_validators
Validators that haven't produced any units during the era. -
next_era_gas_price
The gas price for the next era as auint8
integer. Minimum 0.0 motes. -
next_era_validator_weights
The validators for the upcoming era and their respective weights. -
rewards
The rewards distributed to the validators.
EraID
Era ID newtype.
EraIdentifier
Identifier for an era.
One of:
EraInfo
Auction metadata. Intended to be recorded at each era.
Required Parameters:
seigniorage_allocation
Information about a seigniorage allocation.
EraReport_for_PublicKey
Equivocation, reward and validator inactivity information.
Required Parameters:
-
equivocators
The set of equivocators. -
rewards
Rewards for finalization of earlier blocks. -
inactive_validators
Validators that haven't produced any unit during the era.
EraReward
A validator's public key paired with a measure of the value of its contribution to consensus, as a fraction of the configured maximum block reward.
Required Parameters:
-
amount
The reward amount. -
validator
The validator's public key.
EraSummary
The summary of an era.
Required Parameters:
-
block_hash
The Block hash. -
era_id
The era id. -
merkle_proof
The merkle proof. -
state_root_hash
Hex-encoded hash of the state root. -
stored_value
The StoredValue containing era information.
ExecutableDeployItem
Represents possible variants of an executable Deploy.
ExecutionInfo
The block hash and height in which a given deploy was executed, along with the execution result if known.
Required Parameters:
-
block_hash
The hash of the block in which the deploy was executed. -
block_height
The height of the block in which the deploy was executed.
Optional Parameters:
execution_result
The execution result if known.
ExecutionEffect
The journal of execution transforms from a single Deploy.
Required Parameters:
ExecutionResult
The versioned result of executing a single Deploy.
One of:
ExecutionResultV1
The result of executing a single deploy prior to Casper 2.0.
One of:
-
Failure
The result of a failed executionRequired Parameters:
error_message
The error message associated with executing the Deploy. -
Success
The result of a successful execution.Required Parameters:
ExecutionResultV2
The result of executing a single transaction.
Required Parameters:
-
consumed
How much gas was consumed executing this transaction. -
cost
How much was paid for this transaction. -
effects
The effects of executing this transaction. -
initiator
Who initiated this transaction. -
limit
The maximum allowed gas limit for this transaction. -
payment
Breakdown of payments made to cover the cost. -
size_estimate
The size estimate of the transaction -
transfers
A record of transfers performed while executing this transaction.
Optional Parameters:
error_message
If there is no error message, this execution was processed successfully. If there is an error message, this execution failed to fully process for the stated reason.
Gas
The Gas
struct represents a U512
amount of gas.
GlobalStateIdentifier
Identifier for possible ways to query global state.
-
BlockHash
Query using a block hash. -
BlockHeight
Query using a block height. -
StateRootHash
Query using the state root hash.
Group
A (labelled) "user group". Each entry point of a versioned contract may be associated with one or more user groups which are allowed to call it.
InitiatorAddr
The address of the initiator of a transaction
Contains one of:
-
publickey
The public key of the initiator. -
accounthash
The account hash derived from the public key of the initiator.
JsonBlockWithSignatures
A JSON-friendly representation of a block and the signatures for that block.
Required Parameters:
-
block
The block. -
proofs
The proofs of the block, i.e. a collection of validators' signatures of the block hash.
JsonEraValidators
The validators for the given era.
Required Parameters:
JsonValidatorChanges
The changes in a validator's status.
Required Parameters:
-
public_key
The public key of the validator. -
status_changes
The set of changes to the validator's status.
JsonValidatorStatusChange
A single change to a validator's status in the given era.
Required Parameters:
-
era_id
The era in which the change occurred. -
validator_change
The change in validator status.
JsonValidatorsWeights
A validator's weight.
Required Parameters:
Key
The key as a formatted string, under which data can be stored in global state.
MessageChecksum
Message checksum as a formatted string.
MessageTopic
A topic for contract-level messages.
Required Parameters:
-
topic_name
A string used to identify the message topic. -
topic_name_hash
The hash of the name of the message topic.
MessageTopicSummary
Summary of a message topic that will be stored in global state.
Required Parameters:
-
message_count
The number of messages in this topic.
MinimalBlockInfo
Minimal info of a Block
.
Required Parameters:
-
height
The block height.
NamedArg
Named arguments to a contract.
NamedEntryPoint
A named entry point.
Required Parameters:
-
name
A string identifying the entry point.
NamedKey
A named key.
Required Parameters:
-
key
The value of the entry: a casperKey
type. -
name
The name of the entry.
NamedKeys
NamedKeyValue
A NamedKey
value.
Required Parameters:
-
name
The name of theKey
encoded as aCLValue
. -
named_key
The actualKey
encoded as aCLValue
.
NamedUserGroup
A named group
.
Required Parameters:
NextUpgrade
Information about the next protocol upgrade.
Required Parameters:
Operation
An operation performed while executing a Deploy.
Required Parameters:
-
key
The formatted string of theKey
.
OpKind
The type of operation performed while executing a Deploy.
One of:
-
Read
A read operation. -
Write
A write operation. -
Add
An addition. -
NoOp
An operation which has no effect. -
Prune
A prune operation.
Package
Entity definition, metadata and security container.
Required Parameters:
-
disabled_versions
Collection of disabled entity versions. The runtime will not permit disabled entity versions to be executed. -
groups
Mapping maintaining the set of URefs associated with each user group, used to control access to methods in a particular version of the entity. A method is callable by any context which knows any of the URefs associated with the method's user group. -
lock_status
A flag that determines whether a entity is locked. -
versions
All versions (enabled & disabled).
Parameter
Parameter to an entry point.
Required Parameters:
-
name
PackageHash
The hex-encoded address of a package associated with an AddressableEntity
.
PackageStatus
An enum to determine the lock status of the package.
One of:
-
Locked
The package is locked and cannot be versioned. -
Unlocked
The package is unlocked and can be versioned.
PaymentInfo
Breakdown of payments made to cover the cost.
Required Parameters:
source
Source purse used for payment of the transaction.
PeerEntry
Node peer entry.
Required Parameters:
-
address
Node address. -
node_id
Node ID.
Peers
Map of peer IDs to network addresses.
PricingMode
The pricing mode of a transaction.
One of:
-
Classic
The original payment model, where the creator of the transaction specifies how much they will pay, at what gas price. -
Fixed
The cost of the transaction is determined by the cost table, per the transaction category. -
Reserved
The payment for this transaction was previously reserved (Not currently implemented).
ProtocolVersion
Casper Platform protocol version.
PublicKey
Hex-encoded cryptographic public key, including the algorithm tag prefix.
PublicKeyAndBid
A bid associated with the given public key.
Required Parameters:
PublicKeyAndDelegator
A delegator associated with the given validator.
Required Parameters:
PurseIdentifier
The identifier of a purse.
One of:
-
main_purse_under_public_key
The main purse under a providedPublicKey
. -
main_purse_under_account_hash
The main purse under a providedAccountHash
. -
main_purse_under_entity_addr
The main purse of the account identified by thisEntityAddr
. -
purse_uref
A specific purse identified by the associatedURef
.
ReservationKind
Container for bytes recording location, type and data for a gas reservation.
Required Parameters:
-
reservation_data
Hex-encoded bytes. -
reservation_kind
Auint8
integer.
RewardedSignatures
Describes finality signatures that will be rewarded in a block. Consists of a vector of SingleBlockRewardedSignatures
, each of which describes signatures for a single ancestor block. The first entry represents the signatures for the parent block, the second for the parent of the parent, and so on.
RuntimeArgs
Represents a collection of arguments passed to a smart contract.
SeigniorageAllocation
Information about a seigniorage allocation.
One of:
-
Validator
Info about a seigniorage allocation for a validator.Required Parameters:
amount
Allocated amount.validator_public_key
Validator's public key. -
Delegator
Info about a seigniorage allocation for a delegator.Require Parameters:
amount
Allocated amount.delegator_public_key
Delegator's public key.validator_public_key
Validator's public key.
Signature
Hex-encoded cryptographic signature, including the algorithm tag prefix.
SingleBlockRewardedSignatures
List of identifiers for finality signatures for a particular past block. That past block height is equal to current_height
minus signature_rewards_max_delay
, the latter being defined in the chainspec.
StoredValue
Representation of a value stored in global state.
-
CLValue
A Casper-specific value. -
Account
An Account. -
ContractWasm
A contract's Wasm. -
Contract
Entry points supported by a contract. -
ContractPackage
A contract definition, metadata, and security container. -
LegacyTransfer
A version 1 (legacy) transfer. -
DeployInfo
A record of a Deploy. -
EraInfo
Information about an era. -
Bid
A bid. -
Withdraw
A withdraw. -
Unbonding
Unbonding information. -
AddressableEntity
An AddressableEntity. -
BidKind
A variant that storedBidKind
. -
[
Package
] APackage
. -
[
ByteCode
] A record of byte code. -
MessageTopic
A variant that stores a message topic. -
Message
A variant that stores a message digest. -
NamedKey
A NamedKey record. -
Reservation
A reservation record. -
EntryPoint
An entrypoint record.
SystemEntityType
System contract types.
-
Mint
-
HandlePayment
-
StandardPayment
-
Auction
TimeDiff
Human-readable duration.
Timestamp
Timestamp formatted as per RFC 3339.
TopicNameHash
The hash of the name of the message topic.
Transaction
A versioned wrapper for a transaction or deploy.
Contains one of:
or
TransactionEntryPoint
An entry point of a transaction.
One of:
-
Call
The standardcall
entry point used in session code. -
Custom
A non-native, arbitrary entry point. -
Transfer
Thetransfer
native entry point, used to reference motes from a source purse to a target purse. -
AddBid
Theadd_bid
native entry point, used to create or top off a bid purse. -
WithdrawBid
Thewithdraw_bid
native entry point, used to decrease a validator's stake. -
Delegate
Thedelegate
native entry point, used to add a new delegator or increase an existing delegator's stake. -
Undelegate
Theundelegate
native entry point, used to reduce a delegator's stake or remove the delegator if the remaining stake is zero. -
Redelegate
Theredelegate
native entry point, used to reduce a delegator's stake or remove the delegator if the remaining stake is zero. After the unbonding delay, it will automatically delegate to a new validator. -
ActivateBid
Theactivate_bid
native entry point, used to used to reactivate an inactive bid. -
ChangeBidPublicKey
Thechange_bid_public_key
native entry point, used to change a bid's public key.
TransactionHash
A versioned wrapper for a transaction hash or deploy hash.
One of:
TransactionInvocationTarget
The identifier of a stored
transaction target.
One of:
-
ByHash
The hex-encoded entity address identifying the invocable entity. -
ByName
The alias identifying the invocable entity. -
ByPackageHash
The address and optional version identifying the package.Required Parameters:
addr
The hex-encoded address of the package.
Optional parameters:
version
The package version. IfNone
, the latest enabled version is implied.
-
ByPackageName
The alias and optional version identifying the package.Required Parameters:
name
The package name.
Optional Parameters:
version
The package version. IfNone
, the latest enabled version is implied.
TransactionRuntime
Runtime used to execute a transaction.
Parameters:
-
VmCasperV1
The Casper Version 1 Virtual Machine. -
VmCasperV2
The Casper Version 2 Virtual Machine.
TransactionScheduling
The scheduling mode of a transaction.
One of:
-
Standard
No special scheduling applied. -
FutureEra
Execution should be scheduled for the specific era.Required parameters for
FutureEra
: -
FutureTimestamp
Execution should be scheduled for the specific timestamp or later.Required parameters for
FutureTimestamp
:
TransactionTarget
The execution target of a Transaction.
One of:
-
native
The execution target is a native operation. -
stored
The execution target is a stored entity or package.Required parameters for a
stored
target: -
session
The execution target is the included module bytes.Required parameters for a
session
target:
TransactionV1
A unit of work sent by a client to the network, which when executed can cause global state to be altered.
Required Parameters:
TransactionV1Body
The body of a TransactionV1.
Required Parameters:
TransactionV1Hash
A hex-encoded TransactionV1 hash.
TransactionV1Header
The header portion of a TransactionV1.
Required Parameters:
-
chain_name
Transfer
A versioned wrapper for a transfer.
One of:
TransferAddr
Hex-encoded version 1 transfer address.
TransferV1
Represents a transfer from one purse to another.
Required Parameters:
-
amount
Transfer amount. -
deploy_hash
Deploy that created the transfer. -
from
Account from which transfer was executed. -
source
Source purse. -
target
Target purse.
Optional Parameters:
-
id
User-defined ID. -
to
Account to which funds are transferred.
TransferV2
Represents a version 2 transfer from one purse to another.
Required Parameters:
-
amount
Transfer amount. -
transaction_hash
Transaction that created the transfer. -
from
Entity from which transfer was executed. -
source
Source purse. -
target
Target purse.
Optional Parameters:
-
id
User-defined ID. -
to
Account to which funds are transferred.
TransformError
Error type for applying and combining transforms. A TypeMismatch
occurs when a transform cannot be applied because the types are not compatible (e.g. trying to add a number to a string).
One of:
-
deprecated
Type no longer supported.
TransformV1
A transformation performed while executing a Deploy.
Required Parameters:
-
key
The formatted string of theKey
. -
transforms
The transformation.
TransformV2
A transformation performed while executing a Deploy.
Required Parameters:
-
key
The formatted string of theKey
. -
kind
The transformation.
TransformKindV1
The actual transformation performed while executing a Deploy in version 1.
One of:
-
Identity
A transform having no effect. -
WriteCLValue
Writes the given CLValue to global state. -
WriteAccount
Writes the given Account to global state. -
WriteContractWasm
Writes a smart contract as Wasm to global state. -
WriteContract
Writes a smart contract to global state. -
WriteContractPackage
Writes a smart contract package to global state. -
WriteDeployInfo
Writes the given DeployInfo to global state. -
WriteEraInfo
Writes the given EraInfo to global state. -
WriteTransfer
Writes the given Transfer to global state. -
WriteBid
Writes the given Bid to global state. -
WriteWithdraw
Writes the given Withdraw to global state. -
WriteUnbonding
Writes the given Unbonding to global state. -
WriteAddressableEntity
Writes the addressable entity to global state. -
WriteBidKind
Writes the given BidKind to global state. -
AddInt32
Adds the giveni32
. -
AddUInt64
Adds the givenu64
. -
AddUInt128
Adds the givenU128
. -
AddUInt256
Adds the givenU256
. -
AddUInt512
Adds the givenU512
. -
AddKeys
Adds the given collection of named keys. -
Prune
Removes the pathing to the global state entry of the specified key. The pruned element remains reachable from previously generated global state root hashes, but will not be included in the next generated global state root hash and subsequent states. -
Failure
Represents the case where applying a transform would cause an error.
TransformKindV2
The actual transformation performed while executing a Deploy in version 2.
One of:
-
Identity
A transform having no effect. -
Write
Writes the new value in global state. -
AddInt32
Adds the giveni32
. -
AddUInt64
Adds the givenu64
. -
AddUInt128
Adds the givenU128
. -
AddUInt256
Adds the givenU256
. -
AddUInt512
Adds the givenU512
. -
AddKeys
Adds the given collection of named keys. -
Prune
Removes the pathing to the global state entry of the specified key. The pruned element remains reachable from previously generated global state root hashes, but will not be included in the next generated global state root hash and subsequent states. -
Failure
Represents the case where applying a transform would cause an error.
TypeMismatch
An error struct representing a type mismatch in StoredValue
operations.
-
expected
The name of the expected type. -
found
The actual type found.
U128
Decimal representation of a 128-bit integer.
U256
Decimal representation of a 256-bit integer.
U512
Decimal representation of a 512-bit integer.
UnbondingPurse
Unbonding purse.
Required Parameters:
-
amount
Unbonding amount. -
bonding_purse
Bonding purse. -
era_of_creation
Era in which the unbonding request was created. -
unbonder_public_key
Unbonder's public key. -
validator_public_key
The original validator's public key.
Optional Parameters:
new_validator
The redelegated validator's public key.
URef
Hex-encoded, formatted URef.
ValidatorBid
An entry in the validator map.
Required Parameters:
-
bonding_purse
Bonding purse. -
delegation_rate
The delegation rate. -
inactive
true
if the validator has been "evicted". -
maximum_delegation_amount
Minimum allowed delegation amount in motes. -
minimum_delegation_amount
Maximum allowed delegation amount in motes. -
staked_amount
The amount of tokens staked by a validator. -
validator_public_key
The validator's public key.
Optional Parameters:
ValidatorChange
A change to a validator's status between two eras.
One of:
-
Added
The validator was just added to the validator set. -
Removed
The validator was removed from the validator set. -
Banned
The validator was banned from this era. -
CannotPropose
The validator was excluded from proposing new blocks in this era. -
SeenAsFaulty
We saw the validator misbehave in this era.
ValidatorCredit
Validator credit record.
Required Parameters:
-
amount
The credit amount. -
era_id
The era id the credit was created. -
validator_public_key
The validator's public key.
ValidatorWeight
A validator's public key paired with its weight, i.e. the total number of motes it staked together with its delegators.
Required Parameters:
VestingSchedule
Vesting schedule for a genesis validator.
Required Parameters:
initial_release_timestamp_millies
Timestamp of the initial release.
Optional Parameters:
locked_amounts
The amount of locked motes.
WithdrawPurse
Withdraw purse, previously known as unbonding purse prior to 1.5. Withdraw purses remain as historical data.
Required Parameters:
-
amount
Unbonding amount. -
bonding_purse
Bonding purse. -
era_of_creation
Era in which the unbonding request was created. -
unbonder_public_key
Unbonder's public key. -
validator_public_key
The original validator's public key.