This page lists all message definitions for the Sui Full Node gRPC API. Each message shows its fields, types, labels (optional, repeated), and descriptions. For union fields (oneof), the available variants are listed under the union name.
Messages with more than 4 non-oneof fields show only a summary here. Use the View all fields link for the complete field-level reference, including any hidden union variants.
Marker for the final frame of a successful query stream. Every successful
stream sets QueryEnd on exactly one frame, after which no further frames
are sent. That frame always carries the final watermark. For ItemLimit, it
also carries the final matching item; for every other reason it carries no
item. A ScanLimit terminal watermark may repeat the previous frame's cursor
when its authoritative scan frontier was already emitted; this does not
repeat an item.
reason
QueryEndReason(optional) — Reason this response stopped.
QueryOptions
Cursor-bounded query options.
after
bytes(optional) — Opaque exclusive lower bound. Results must be strictly after this cursor in canonical ledger order.
before
bytes(optional) — Opaque exclusive upper bound. Results must be strictly before this cursor in canonical ledger order.
limit
uint32(optional) — The maximum number of items to return. Each method applies its own default and maximum. QueryEnd does not count against this limit.
ordering
Ordering(optional) — Ordering for returned results. Defaults to ASCENDING. Ordering only controls the order of results within the bounded interval; cursor bounds keep the same meaning for ascending and descending reads.
Watermark
Progress marker for a query scan. Carried on every response frame, whether or
not the frame delivers a matching item. Watermarks never regress in the
requested ordering, but consecutive frames may carry the same watermark when
additional work does not advance the safe resume frontier.
checkpoint
uint64(optional) — The inclusive boundary checkpoint that the scan has fully covered within the request's effective interval, in the request's ordering direction: an ascending scan has emitted every matching item in the interval at checkpoints <= checkpoint (strictly greater ones may still hold matches); a descending scan has emitted every matching item in the interval at checkpoints >= checkpoint. This boundary never regresses in the scan direction, but it may repeat while the cursor advances. Unset until the scan's first checkpoint is fully covered. For example, a scan resumed from a cursor that lands mid-checkpoint leaves this unset until the next checkpoint boundary in the scan direction is fully covered. A watermark still has a valid resume cursor while this field is unset.
cursor
bytes(optional) — Opaque cursor at this scan position. Set on every watermark. Use as options.after (ascending) or options.before (descending) on the next request to resume from here. The most recently received cursor is always the safe resume point.
int32(optional) — Version of this CheckpointContents
CheckpointedTransactionInfo
Transaction information committed to in a checkpoint.
address_aliases_versions
AddressAliasesVersion(repeated) — The AddressAliases object version, if any, that was used to verify the UserSignature at the same position in signatures. This field is present when CheckpointContents.version is >= 2.
MakeMoveVector — forall T: Vec<T> -> vector<T> Given n-values of the same type, it constructs a vector. For non-objects or an empty vector, the type tag must be specified.
merge_coins
MergeCoins — (&mut Coin<T>, Vec<Coin<T>>) It merges n-coins into the first coin.
move_call
MoveCall — A call to either an entry or a public Move function.
publish
Publish — Publishes a Move package. It takes the package bytes and a list of the package's transitive dependencies to link against on chain.
split_coins
SplitCoins — (&mut Coin<T>, Vec<u64>) -> Vec<Coin<T>> It splits off some amounts into new coins with those amounts.
transfer_objects
TransferObjects — (Vec<forall T:key+store. T>, address) It sends n-objects to the specified address. These objects must have store (public transfer) and either the previous owner must be an address or the object must be newly created.
upgrade
Upgrade — Upgrades a Move package. Takes (in order): 1. A vector of serialized modules for the package. 2. A vector of object ids for the transitive dependencies of the new package. 3. The object ID of the package being upgraded. 4. An argument holding the UpgradeTicket that must have been produced from an earlier command in the same programmable transaction.
ConsensusCommitPrologue
Consensus commit prologue system transaction.
This message can represent V1, V2, and V3 prologue types.
additional_state_digest
string(optional) — Digest of any additional state computed by the consensus handler. Used to detect forking bugs as early as possible. Present in V4.
commit_timestamp
Timestamp(optional) — Unix timestamp from consensus. Present in V1, V2, V3, V4.
consensus_commit_digest
string(optional) — Digest of consensus output. Present in V2, V3, V4.
int32(optional) — Version of this ExecutionTimeObservations
GasPayment
Payment information for executing a transaction.
budget
uint64(optional) — Total budget willing to spend for the execution of a transaction.
objects
ObjectReference(repeated) — Set of gas objects to use for payment.
owner
string(optional) — Owner of the gas objects, either the transaction sender or a sponsor.
price
uint64(optional) — Gas unit price to use when charging for computation. Must be greater than or equal to the network's current RGP (reference gas price).
Command to build a Move vector out of a set of individual elements.
element_type
string(optional) — Type of the individual elements. This is required to be set when the type can't be inferred, for example when the set of provided arguments are all pure input values.
elements
Argument(repeated) — The set individual elements to build the vector with.
MergeCoins
Command to merge multiple coins of the same type into a single coin.
string(optional) — ChainId of the network this transaction is intended for in order to prevent cross-chain replay
epoch
uint64(optional) — Maximum epoch in which a transaction can be executed. The provided maximal epoch must be greater than or equal to the current epoch for a transaction to execute.
Timestamp(optional) — Maximum UNIX timestamp in which a transaction can be executed. The provided maximal timestamp must be greater than or equal to the current clock.
ChangeEpoch — System transaction used to end an epoch. The ChangeEpoch variant is now deprecated (but the ChangeEpoch struct is still used by EndOfEpochTransaction).
EndOfEpochTransaction — Set of operations to run at the end of the epoch to close out the current epoch and start the next one.
genesis
GenesisTransaction — Transaction used to initialize the chain state. Only valid if in the genesis checkpoint (0) and if this is the very first transaction ever executed on the chain.
programmable_transaction
ProgrammableTransaction — A transaction comprised of a list of native commands and Move calls.
EventDigestEntry(repeated) — Set when the accumulator value is an event digest list (value_kind = EVENT_DIGEST). Contains a non-empty list of (event_index, digest) pairs representing authenticated event stream entries within a transaction.
integer_tuple
uint64(repeated) — Set, with len 2, when the accumulator value is an integer tuple (value_kind = INTEGER_TUPLE).
uint64(optional) — Index of the event within its transaction.
TransactionEffects
The effects of executing a transaction.
auxiliary_data_digest
string(optional) — Auxiliary data that are not protocol-critical, generated as part of the effects but are stored separately. Storing it separately allows us to avoid bloating the effects with data that are not critical. It also provides more flexibility on the format and type of the data.
bcs
Bcs(optional) — This TransactionEffects serialized as BCS.
changed_objects
ChangedObject(repeated) — Objects whose state are changed by this transaction.
dependencies
string(repeated) — The set of transaction digests this transaction depends on.
uint64(optional) — The sequence number of the checkpoint that includes the transaction that emitted this event. Populated when the event is delivered on its own (for example via LedgerService.ListEvents); left unset when the event is carried inside its transaction's events list, where the enclosing ExecutedTransaction already provides this context.
contents
Bcs(optional) — BCS serialized bytes of the event.
event_index
uint32(optional) — Zero-based index of this event within its transaction's event list.
string(optional) — PackageId of the package where this Datatype is defined. A type's defining_id is the storage_id of the package version that first introduced or added that type.
fields
FieldDescriptor(repeated) — Set of fields if this Datatype is a struct. The order of the entries is the order of how the fields are defined.
kind
DatatypeKind(optional) — Indicates whether this datatype is a 'STRUCT' or an 'ENUM'
Linkage(repeated) — The package's transitive dependencies as a mapping from the package's runtime Id (the Id it is referred to by in other packages) to its storage Id (the Id it is loaded from on chain).
modules
Module(repeated) — The modules defined by this package
original_id
string(optional) — The PackageId of the first published version of this package. A package's original_id (sometimes also called its runtime_id) is the storage_id of the first version of this package that has been published. The original_id/runtime_id is stable across all versions of the package and does not ever change.
storage_id
string(optional) — The PackageId of this package A package's storage_id is the Sui ObjectId of the package on-chain. Outside of system packages the storage_id for every package version is different.
Match by any address whose state moved as a side effect of the
transaction: object ownership changes (in either direction), prior
owners of removed/wrapped objects, and address-balance changes via
accumulator events.
address
string(optional) — The affected address (hex-encoded).
AffectedObjectFilter
Match by changed object ID.
object_id
string(optional) — The changed object ID (hex-encoded).
EmitModuleFilter
Match by an event's package/module fields, specified as a ::-delimited
Move path. These identify the top-level Move call that triggered the event.
module
string(optional) — Required. Move path of the form package[::module].
EventFilter
DNF filter for events: any term may match, and each term is an AND of
signed literals. Sender predicates match all events from matching
transactions; emit-module, event-type, and event-stream-head predicates match
individual event-space dimensions. An absent filter matches everything. A
present filter must have at least one term.
One signed event predicate literal: a predicate, optionally negated.
negated
bool — When true, the literal matches events that the predicate does not match.
Union: predicate
emit_module
EmitModuleFilter — Match events whose package/module fields match the specified filter.
event_stream_head
EventStreamHeadFilter — Match events committed to the specified authenticated event stream head.
event_type
EventTypeFilter — Match events whose type matches the specified filter.
sender
SenderFilter — Match events from transactions sent by the specified address.
EventStreamHeadFilter
Match by authenticated event stream head.
stream_id
string(optional) — The stream id address (hex-encoded).
EventTerm
One conjunction in an event DNF filter.
literals
EventLiteral(repeated) — Literals are ANDed together.
EventTypeFilter
Match by event struct type, specified as a Move type string.
event_type
string(optional) — Required. Move type string of the form address[::module[::Name[<type_params>]]].
MoveCallFilter
Match by Move function call, specified as a ::-delimited Move path.
function
string(optional) — Required. Move path of the form package[::module[::function]].
PackageWriteFilter
Match transactions that wrote a Move package.
SenderFilter
Match by transaction sender address.
address
string(optional) — The sender address (hex-encoded).
TransactionFilter
DNF filter for transactions: any term may match, and each term is an AND
of signed literals.
An absent filter matches everything. A present filter must have at least one
term.
One signed transaction predicate literal: a predicate, optionally negated.
negated
bool — When true, the literal matches transactions that the predicate does not match.
Union: predicate
affected_address
AffectedAddressFilter — Match transactions where the specified address's state moved as a side effect: it owns an object after the txn, owned an object before the txn that was mutated/transferred away/deleted/wrapped, or its address-balance changed via an accumulator event.
affected_object
AffectedObjectFilter — Match transactions whose effects include a change for the specified object.
emit_module
EmitModuleFilter — Match transactions that emitted an event whose package/module fields match the specified filter.
event_stream_head
EventStreamHeadFilter — Match transactions that wrote to the specified authenticated event stream head.
event_type
EventTypeFilter — Match transactions that emitted an event with a type matching the specified filter.
move_call
MoveCallFilter — Match transactions that made a Move call matching the specified filter.
package_write
PackageWriteFilter — Match transactions that wrote a Move package — a first publish or an upgrade, of any package.
sender
SenderFilter — Match transactions sent by the specified address.
Aggregated signature from members of a multisig committee.
bitmap
uint32(optional) — Bitmap indicating which committee members contributed to the signature.
committee
MultisigCommittee(optional) — The committee to use to validate this signature.
legacy_bitmap
bytes(optional) — If present, means this signature's on-chain format uses the old legacy multisig format.
signatures
MultisigMemberSignature(repeated) — The plain signatures encoded with signature scheme. The signatures must be in the same order as they are listed in the committee.
MultisigCommittee
A multisig committee.
members
MultisigMember(repeated) — A list of committee members and their corresponding weight.
threshold
uint32(optional) — The threshold of signatures needed to validate a signature from this committee.
Bcs(optional) — This signature serialized as as BCS. When provided as input this will support both the form that is length prefixed as well as not length prefixed.
scheme
SignatureScheme(optional) — The signature scheme of this signature.
bytes(optional) — Bitmap indicating which members of the committee contributed to this signature.
epoch
uint64(optional) — The epoch when this signature was produced. This can be used to lookup the ValidatorCommittee from this epoch to verify this signature.
signature
bytes(optional) — The 48-byte Bls12381 aggregated signature.
ValidatorCommittee
The validator set for a particular epoch.
epoch
uint64(optional) — The epoch where this committee governs.
Request message for SubscriptionService.SubscribeCheckpoints.
filter
TransactionFilter(optional) — Optional. DNF filter over indexed transaction dimensions. A checkpoint matches if any transaction it contains satisfies the filter. If absent, every checkpoint is streamed.
read_mask
FieldMask(optional) — Optional. Mask for specifying which parts of the Checkpoint should be returned (e.g. summary, contents, signatures). cursor is always populated and is not subject to the mask.
SubscribeCheckpointsResponse
Response message for SubscriptionService.SubscribeCheckpoints.
checkpoint
Checkpoint(optional) — The matching checkpoint. Unset when this frame only advances the cursor past non-matching checkpoints.
cursor
uint64(optional) — Required. The checkpoint sequence number the stream has fully covered, inclusive: every matching checkpoint from the stream's start position through cursor has been delivered. Present on every frame and advances monotonically.
SubscribeEventsRequest
Request message for SubscriptionService.SubscribeEvents.
filter
EventFilter(optional) — Optional. DNF filter over indexed dimensions. If absent, every event is streamed.
read_mask
FieldMask(optional) — Optional. Mask for specifying which parts of the Event should be returned.
SubscribeEventsResponse
Response message for SubscriptionService.SubscribeEvents.
Mirrors ListEventsResponse, except there is no end field: a subscription
stream has no successful end.
event
Event(optional) — One matching event. Its ledger position -- containing checkpoint, emitting transaction digest and offset, and index within that transaction's event list -- is reported by the corresponding fields on Event.
watermark
Watermark(optional) — Progress watermark as of this frame. Present on every frame.
SubscribeTransactionsRequest
Request message for SubscriptionService.SubscribeTransactions.
filter
TransactionFilter(optional) — Optional. DNF filter over indexed dimensions. If absent, every transaction is streamed.
read_mask
FieldMask(optional) — Optional. Mask for specifying which parts of the ExecutedTransaction should be returned.
SubscribeTransactionsResponse
Response message for SubscriptionService.SubscribeTransactions.
Mirrors ListTransactionsResponse, except there is no end field: a
subscription stream has no successful end.
transaction
ExecutedTransaction(optional) — One matching transaction. Its position within the containing checkpoint is reported by ExecutedTransaction.transaction_index.
watermark
Watermark(optional) — Progress watermark as of this frame. Present on every frame.
string(optional) — Required. The SuiNS name to lookup. Supports both @name as well as name.sui formats.
LookupNameResponse
record
NameRecord(optional) — The record for the requested name
NameRecord
data
DataEntry(repeated) — Additional data which may be stored in a record
expiration_timestamp
Timestamp(optional) — Timestamp when the record expires. This is either the expiration of the record itself or the expiration of this record's parent if this is a leaf record.
id
string(optional) — Id of this record. Note that records are stored on chain as dynamic fields of the type Field<Domain,NameRecord>.
string(optional) — Optional. Address to validate against the provided signature. If provided, this address will be compared against the the address derived from the provide signature and a successful response will only be returned if they match.
jwks
ActiveJwk(repeated) — The set of JWKs to use when verifying Zklogin signatures. If this is empty the current set of valid JWKs stored onchain will be used
message
Bcs(optional) — The message to verify against. Today the only supported message types are PersonalMessage and TransactionData and the Bcs.name must be set to indicate which type of message is being verified.
string(optional) — Required. The storage_id of any version of the package.
page_size
uint32(optional) — The maximum number of versions to return. The service may return fewer than this value. If unspecified, at most 1000 entries will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.
page_token
bytes(optional) — A page token, received from a previous ListPackageVersions call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListPackageVersions must match the call that provided the page token.
ListPackageVersionsResponse
next_page_token
bytes(optional) — A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
versions
PackageVersion(repeated) — List of all package versions, ordered by version.
PackageVersion
A simplified representation of a package version
package_id
string(optional) — The storage ID of this package version
string(optional) — Required. The ObjectId of the requested object.
read_mask
FieldMask(optional) — Mask specifying which fields to read. If no mask is specified, defaults to object_id,version,digest.
version
uint64(optional) — Request a specific version of the object. If no version is specified, and the object is live, then the latest version of the object is returned.
string(optional) — Human-readable name of the chain that this node is on. This is intended to be a human-readable name like mainnet, testnet, and so on.
chain_id
string(optional) — The chain identifier of the chain that this node is on. The chain identifier is the digest of the genesis checkpoint, the checkpoint with sequence number 0.
checkpoint_height
uint64(optional) — Checkpoint height of the most recently executed checkpoint.
epoch
uint64(optional) — Current epoch of the node based on its highest executed checkpoint.
Request message for LedgerService.ListCheckpoints.
end_checkpoint
uint64(optional) — Optional. End of the checkpoint range to query (exclusive). Defaults to the current indexed ledger tip.
filter
TransactionFilter(optional) — Optional. DNF filter over indexed transaction dimensions. A checkpoint matches if any transaction it contains satisfies the filter. If absent, all checkpoints in the range are returned.
options
QueryOptions(optional) — Optional cursor-bounded query options. If unspecified, reads in ascending order with the default item limit. The server enforces a maximum item limit and silently coerces larger values down to it. To paginate, pass the last received Watermark.cursor as options.after (ascending) or options.before (descending) on the next request.
read_mask
FieldMask(optional) — Optional. Mask for specifying which parts of the Checkpoint should be returned (e.g. summary, contents, signatures).
QueryEnd(optional) — Set exactly once, on the final frame of a successful query stream.
watermark
Watermark(optional) — Progress watermark as of this frame. Present on every frame. A ScanLimit terminal watermark may repeat the previous frame's cursor when its authoritative scan frontier was already emitted.
ListEventsRequest
Request message for LedgerService.ListEvents.
end_checkpoint
uint64(optional) — Optional. End of the checkpoint range to query (exclusive). Defaults to the current indexed ledger tip.
filter
EventFilter(optional) — Optional. DNF filter over indexed dimensions. If absent, all events in the range are returned.
options
QueryOptions(optional) — Optional cursor-bounded query options. If unspecified, reads in ascending order with the default item limit. The server enforces a maximum item limit and silently coerces larger values down to it. To paginate, pass the last received Watermark.cursor as options.after (ascending) or options.before (descending) on the next request.
read_mask
FieldMask(optional) — Optional. Mask for specifying which parts of the Event should be returned.
QueryEnd(optional) — Set exactly once, on the final frame of a successful query stream.
event
Event(optional) — One matching event. Its ledger position -- containing checkpoint, emitting transaction digest and offset, and index within that transaction's event list -- is reported by the corresponding fields on Event.
watermark
Watermark(optional) — Progress watermark as of this frame. Present on every frame. A ScanLimit terminal watermark may repeat the previous frame's cursor when its authoritative scan frontier was already emitted.
ListTransactionsRequest
Request message for LedgerService.ListTransactions.
end_checkpoint
uint64(optional) — Optional. End of the checkpoint range to query (exclusive). Defaults to the current indexed ledger tip.
filter
TransactionFilter(optional) — Optional. DNF filter over indexed dimensions. If absent, all transactions in the range are returned.
options
QueryOptions(optional) — Optional cursor-bounded query options. If unspecified, reads in ascending order with the default item limit. The server enforces a maximum item limit and silently coerces larger values down to it. To paginate, pass the last received Watermark.cursor as options.after (ascending) or options.before (descending) on the next request.
read_mask
FieldMask(optional) — Optional. Mask for specifying which parts of the ExecutedTransaction should be returned.
Response message for LedgerService.ListTransactions.
end
QueryEnd(optional) — Set exactly once, on the final frame of a successful query stream.
transaction
ExecutedTransaction(optional) — One matching transaction. Its position within the containing checkpoint is reported by ExecutedTransaction.transaction_index.
watermark
Watermark(optional) — Progress watermark as of this frame. Present on every frame. A ScanLimit terminal watermark may repeat the previous frame's cursor when its authoritative scan frontier was already emitted.
CheckpointContents(optional) — The CheckpointContents for this checkpoint.
digest
string(optional) — The digest of this Checkpoint's CheckpointSummary.
objects
ObjectSet(optional) — Set of objects either referenced as inputs or produced as outputs by transactions included in this checkpoint. In order to benefit from deduplication of objects that appear in multiple transactions in this checkpoint, objects will only be present here and the transactions.objects field will not be populated.
uint64(optional) — The balance of Balance<T> in this address's Address Balance.
balance
uint64(optional) — The total balance of coin_type in its smallest unit. This is the sum of all spendable amounts of coin_type (address_balance and coin_balance).
coin_balance
uint64(optional) — The balance of all Coin<T> objects owned by this address.
coin_type
string(optional) — The type of the coin (e.g., 0x2::sui::SUI).
CoinMetadata
Metadata for a coin type
decimals
uint32(optional) — Number of decimal places to coin uses.
Information about a coin type's 0x2::coin::TreasuryCap and its total available supply
id
string(optional) — ObjectId of the 0x2::coin::TreasuryCap object.
supply_state
SupplyState(optional) — Supply state indicating if the supply is fixed or can still be minted
total_supply
uint64(optional) — Total available supply for this coin type.
DynamicField
child_id
string(optional) — The ObjectId of the child object when a child is a dynamic object field. The presence or absence of this field can be used to determine if a child is a dynamic field or a dynamic child object
child_object
Object(optional) — The object itself when a child is a dynamic object field.
field_id
string(optional) — ObjectId of this dynamic field.
CoinMetadata(optional) — This field will be populated with information about this coin type's 0x2::coin::CoinMetadata if it exists and has not been wrapped.
regulated_metadata
RegulatedCoinMetadata(optional) — If this coin type is a regulated coin, this field will be populated with information either from its Currency object in the CoinRegistry, or from its 0x2::coin::RegulatedCoinMetadata object for coins that have not been migrated to the CoinRegistry If this coin is not known to be regulated, only the coin_regulated_state field will be populated.
treasury
CoinTreasury(optional) — This field will be populated with information about this coin type's 0x2::coin::TreasuryCap if it exists and has not been wrapped.
ListBalancesRequest
Request message for LiveDataService.ListBalances.
owner
string(optional) — Required. The owner's Sui address.
page_size
uint32(optional) — The maximum number of balance entries to return. The service may return fewer than this value. If unspecified, at most 50 entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
page_token
bytes(optional) — A page token, received from a previous ListBalances call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListBalances must match the call that provided the page token.
ListBalancesResponse
Response message for LiveDataService.ListBalances.
Return the total coin balance for all coin types, owned by the address owner.
balances
Balance(repeated) — The list of coin types and their respective balances.
next_page_token
bytes(optional) — A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
ListDynamicFieldsRequest
Request message for NodeService.ListDynamicFields
page_size
uint32(optional) — The maximum number of dynamic fields to return. The service may return fewer than this value. If unspecified, at most 50 entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
page_token
bytes(optional) — A page token, received from a previous ListDynamicFields call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDynamicFields must match the call that provided the page token.
parent
string(optional) — Required. The UID of the parent, which owns the collections of dynamic fields.
read_mask
FieldMask(optional) — Mask specifying which fields to read. If no mask is specified, defaults to parent,field_id.
ListDynamicFieldsResponse
Response message for NodeService.ListDynamicFields
dynamic_fields
DynamicField(repeated) — Page of dynamic fields owned by the specified parent.
next_page_token
bytes(optional) — A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
ListOwnedObjectsRequest
object_type
string(optional) — Optional type filter to limit the types of objects listed. Providing an object type with no type params will return objects of that type with any type parameter, e.g. 0x2::coin::Coin will return all Coin<T> objects regardless of the type parameter T. Providing a type with a type param will restrict the returned objects to only those objects that match the provided type parameters, e.g. 0x2::coin::Coin<0x2::sui::SUI> will only return Coin<SUI> objects.
owner
string(optional) — Required. The address of the account that owns the objects.
page_size
uint32(optional) — The maximum number of entries return. The service may return fewer than this value. If unspecified, at most 50 entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
page_token
bytes(optional) — A page token, received from a previous ListOwnedObjects call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListOwnedObjects must match the call that provided the page token.
TransactionChecks(optional) — Specify whether checks should be ENABLED (default) or DISABLED while executing the transaction
do_gas_selection
bool(optional) — Perform gas selection based on a budget estimation and include the selected gas payment and budget in the response. This option will be ignored if checks is DISABLED.
read_mask
FieldMask(optional) — Mask specifying which fields to read.
uint64(optional) — A suggested gas price to use, that is above RGP, in order to provide a better chance of the transaction being included in the presence of congested objects.
A staking pool embedded in each validator struct in the system state object.
activation_epoch
uint64(optional) — The epoch at which this pool became active. The value is None if the pool is pre-active and Some(<epoch_number>) if active or inactive.
deactivation_epoch
uint64(optional) — The epoch at which this staking pool ceased to be active. None = {pre-active, active}, Some(<epoch_number>) if in-active, and it was de-activated at epoch <epoch_number>.
exchange_rates
MoveTable(optional) — Exchange rate history of previous epochs. The entries start from the activation_epoch of this pool and contains exchange rates at the beginning of each epoch, i.e., right after the rewards for the previous epoch have been deposited into the pool. key: u64 (epoch number), value: PoolTokenExchangeRate
extra_fields
MoveTable(optional) — Any extra fields that's not defined statically.
uint64(optional) — Represents any remaining inflow of the storage fund that should not be taken out of the fund.
total_object_storage_rebates
uint64(optional) — This is the sum of storage_rebate of all objects currently stored on-chain. To maintain this invariant, the only inflow of this balance is storage charges collected from transactions, and the only outflow is storage rebates of transactions, including both the portion refunded to the transaction senders as well as the non-refundable portion taken out and put into non_refundable_balance.
SystemParameters
epoch_duration_ms
uint64(optional) — The duration of an epoch, in milliseconds.
extra_fields
MoveTable(optional) — Any extra fields that are not defined statically.
max_validator_count
uint64(optional) — Maximum number of active validators at any moment. We do not allow the number of validators in any epoch to go above this.
min_validator_count
uint64(optional) — Minimum number of active validators at any moment.
Note: fields of ValidatorMetadata are flattened into this type
address
string(optional) — The Sui Address of the validator. This is the sender that created the Validator object, and also the address to send validator/coins to during withdraws.
commission_rate
uint64(optional) — Commission rate of the validator, in basis point.
string(optional) — The address of the validator being reported
reporters
string(repeated) — The list of validator (addresses) that are reporting on the validator specified by reported
ValidatorSet
active_validators
Validator(repeated) — The current list of active validators.
at_risk_validators
AtRiskValidatorsEntry(repeated) — Table storing the number of epochs during which a validator's stake has been below the low stake threshold.
extra_fields
MoveTable(optional) — Any extra fields that's not defined statically.
inactive_validators
MoveTable(optional) — Mapping from a staking pool ID to the inactive validator that has that pool as its staking pool. When a validator is deactivated the validator is removed from active_validators it is added to this table so that stakers can continue to withdraw their stake from it. key: address (staking pool Id), value: 0x3::validator_wrapper::ValidatorWrapper
A rendered JSON blob based on an on-chain template.
errors
Value(optional) — If any fields failed to render, this will contain a mapping from failed field names to error messages. If all fields succeed, this will either be null or not set.
output
Value(optional) — Output for all successfully substituted display fields. Unsuccessful fields will be null, and will be accompanied by a field in errors, explaining the error.
Object
An object on the Sui blockchain.
balance
uint64(optional) — Current balance if this object is a 0x2::coin::Coin<T>