Read API
iota_getChainIdentifier
Return the first four bytes of the chain's genesis checkpoint digest.
Parameters
None
Result
String< string >
Example
Gets the identifier for the chain receiving the POST.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getChainIdentifier",
"params": []
}Repsonse
{
"jsonrpc": "2.0",
"id": 1,
"result": "6364aad5"
}iota_getCheckpoint
Return a checkpoint
Parameters
id< CheckpointId >
Required: yes
Description: Checkpoint identifier, can use either checkpoint digest, or checkpoint sequence number as input.
Result
Checkpoint< Checkpoint >
Parameters
checkpointCommitments<[ CheckpointCommitment ]>
Required: yes
Description: Commitments to checkpoint state
digest< CheckpointDigest >
Required: yes
Description: Checkpoint digest
endOfEpochData< EndOfEpochData | null >
Required: no
Description: Present only on the final checkpoint of the epoch.
epoch< BigInt_for_uint64 >
Required: yes
Description: Checkpoint's epoch ID
epochRollingGasCostSummary< GasCostSummary >
Required: yes
Description: The running total gas costs of all transactions included in the current epoch so far until this checkpoint.
networkTotalTransactions< BigInt_for_uint64 >
Required: yes
Description: Total number of transactions committed since genesis, including those in this checkpoint.
previousDigest< CheckpointDigest | null >
Required: no
Description: Digest of the previous checkpoint
sequenceNumber< BigInt_for_uint64 >
Required: yes
Description: Checkpoint digest
timestampMs< BigInt_for_uint64 >
Required: yes
Description: Timestamp of the checkpoint - number of milliseconds from the Unix epoch Checkpoint timestamps are monotonic, but not strongly monotonic - subsequent checkpoints can have same timestamp if they originate from the same underlining consensus commit
transactions<[ TransactionDigest ]>
Required: yes
Description: Transaction digests
validatorSignature< Base64 >
Required: yes
Description: Validator Signature
Example
Gets checkpoint information for the checkpoint ID in the request.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getCheckpoint",
"params": [
"1000"
]
}Response
{
"jsonrpc": "2.0",
"result": {
"epoch": "5000",
"sequenceNumber": "1000",
"digest": "G6Dtzr1ZSfHFhotGsTE3cLENa7L1ooe1BBvknAUsARbV",
"networkTotalTransactions": "792385",
"previousDigest": "6tBy8RXZKrdrB4XkMQn7J3MNG4fQCo9XcRduFFvYrL5Z",
"epochRollingGasCostSummary": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"timestampMs": "1676911928",
"transactions": [
"mN8YNBgVR3wB7vfXmjVgDRF4oqxVRRjzmJ6U4mzbq77"
],
"checkpointCommitments": [],
"validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
"id": 1
}iota_getCheckpoints
Return paginated list of checkpoints
Parameters
descending_order< Boolean >
Required: yex
Description: Query result ordering, default to false (ascending order), oldest record first.
cursor< ObjectID >
Required: no
Description: Optional paging cursor
limit< ObjectID >
Required: no
Description: Maximum number of items per page
Result
CheckpointPage< Page_for_Checkpoint_and_BigInt_for_uint64 >
next_cursor points to the last item in the page; Reading with next_cursor will start from the next item after next_cursor if next_cursor is Some, otherwise it will start from the first item.
Parameters
data<[ Coin ]>
Required: yes
hasNextPage< Boolean >
Required: yes
nextCursor< ObjectID | null >
Required: no
Example
Gets a paginated list in descending order of all checkpoints starting at the provided cursor. Each page of results has a maximum number of checkpoints set by the provided limit.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getCheckpoints",
"params": [
"1004",
4,
false
]
}Response
{
"jsonrpc": "2.0",
"result": {
"data": [
{
"epoch": "5000",
"sequenceNumber": "1005",
"digest": "9zA7Q9Ka1ykvYjSQGhQCdCf32FZkcWNWx7L22JczXGsk",
"networkTotalTransactions": "792385",
"previousDigest": "8BLFxLTjWZ2KqaGc3FjR1o9aL6kbyYrmhuNfJLU1ehYt",
"epochRollingGasCostSummary": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"timestampMs": "1676911928",
"transactions": [
"7RudGLkQDBNJyqrptkrNU66Zd3pvq8MHVAHYz9WpBm59"
],
"checkpointCommitments": [],
"validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
{
"epoch": "5000",
"sequenceNumber": "1006",
"digest": "FAUWHyWacmb4Vg4QGi9a6gqeVb7ixAZiL73FaGd6WpoV",
"networkTotalTransactions": "792385",
"previousDigest": "6Pn25cieaE62AT6BwCeBoca13AGZuneucaaTGqt3gNCo",
"epochRollingGasCostSummary": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"timestampMs": "1676911928",
"transactions": [
"7r7tmP5hzgrusiN6cucFwfTveqDb7K75tMJ7oNCyoDmy"
],
"checkpointCommitments": [],
"validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
{
"epoch": "5000",
"sequenceNumber": "1007",
"digest": "B3mzC6gy87SomUQwPsmVY7mtwkZLxfm5WwNi3kKyEb3x",
"networkTotalTransactions": "792385",
"previousDigest": "CnHTfdUJr1UUqwXkYUhbQjXeM16xR33UR62jE72toCis",
"epochRollingGasCostSummary": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"timestampMs": "1676911928",
"transactions": [
"Gb1UDqhmKMzMJ5FL37kBqCcuy4TtBL2ay3qec8tEUBLj"
],
"checkpointCommitments": [],
"validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
{
"epoch": "5000",
"sequenceNumber": "1008",
"digest": "HunuJWKu7azBfS47rJTq9FHTMvUDNVo2SK4hQeh5brXp",
"networkTotalTransactions": "792385",
"previousDigest": "38fLUfuigyzLPEDrsmRhcQmhKtbEUohuFBP9NDcWBmFz",
"epochRollingGasCostSummary": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"timestampMs": "1676911928",
"transactions": [
"GWTS9QR7mjNz9fBWGkk4JZU3mrzMXrmj74uS59Cd5und"
],
"checkpointCommitments": [],
"validatorSignature": "wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}
],
"nextCursor": "1008",
"hasNextPage": true
},
"id": 1
}iota_getEvents
Return transaction events.
Parameters
transaction_digest< TransactionDigest >
Required: yes
Description: The event query criteria.
Result
Vec<IotaEvent><[ Event ]>
Example
Returns the events the transaction in the request emits.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getEvents",
"params": [
"11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX"
]
}Response
{
"jsonrpc": "2.0",
"result": {
"data": [
{
"id": {
"txDigest": "11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX",
"eventSeq": "0"
},
"packageId": "0xc54ab30a3d9adc07c1429c4d6bbecaf9457c9af77a91f631760853934d383634",
"transactionModule": "test_module",
"sender": "0xbcf7c32655009a61f1de0eae420a2e4ae1bb772ab2dd5d5a7dfa949c0ef06908",
"type": "0x0000000000000000000000000000000000000000000000000000000000000009::test::TestEvent",
"parsedJson": {
"test": "example value"
},
"bcsEncoding": "base64",
"bcs": ""
}
],
"nextCursor": {
"txDigest": "11a72GCQ5hGNpWGh2QhQkkusTEGS6EDqifJqxr7nSYX",
"eventSeq": "5"
},
"hasNextPage": false
},
"id": 1
}iota_getLatestCheckpointSequenceNumber
Return the sequence number of the latest checkpoint that has been executed
Parameters
None
Result
BigInt<u64>< BigInt_for_uint64 >
Example
Gets the sequence number for the latest checkpoint.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getLatestCheckpointSequenceNumber",
"params": []
}Response
{
"jsonrpc": "2.0",
"id": 1,
"result": "7342752"
}iota_getObject
Return the object information for a specified object
Parameters
object_id< ObjectID >
Required: yes
Description: The ID of the queried object
options< ObjectDataOptions >
Required: no
Description: Options for specifying the content to be returned
Result
IotaObjectResponse< IotaObjectResponse >
Parameters
data< ObjectData | null >
Required: no
error< ObjectResponseError | null >
Required: no
Example
Gets Object data for the ID in the request.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getObject",
"params": [
"0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
{
"showType": true,
"showOwner": true,
"showPreviousTransaction": true,
"showDisplay": false,
"showContent": true,
"showBcs": false,
"showStorageRebate": true
}
]
}Response
{
"jsonrpc": "2.0",
"result": {
"data": {
"objectId": "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809",
"version": "1",
"digest": "33K5ZXJ3RyubvYaHuEnQ1QXmmbhgtrFwp199dnEbL4n7",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0xc8ec1d5b84dd6289e193b9f88de4a994358c9f856135236c3e75a925e1c77ac3"
},
"previousTransaction": "5PLgmQye6rraDYqpV3npV6H1cUXoJZgJh1dPCyRa3WCv",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "100000000",
"id": {
"id": "0x53e4567ccafa5f36ce84c80aa8bc9be64e0d5ae796884274aef3005ae6733809"
}
}
}
}
},
"id": 1
}iota_getProtocolConfig
Return the protocol config table for the given version number. If the version number is not specified, If none is specified, the node uses the version of the latest epoch it has processed.
Parameters
version< BigInt_for_uint64 >
Required: no
Description: An optional protocol version specifier. If omitted, the latest protocol config table for the node will be returned.
Result
ProtocolConfigResponse< ProtocolConfig >
Parameters
attributes< Boolean >
Required: yes
featureFlags< Boolean >
Required: yes
maxSupportedProtocolVersion< ProtocolVersion >
Required: yes
minSupportedProtocolVersion< ProtocolVersion >
Required: yes
protocolVersion< ProtocolVersion >
Required: yes
Example
Returns the protocol config for the given protocol version. If none is specified, the node uses the version of the latest epoch it has processed
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getProtocolConfig",
"params": [
"6"
]
}Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"minSupportedProtocolVersion": "1",
"maxSupportedProtocolVersion": "7",
"protocolVersion": "6",
"featureFlags": {
"accept_zklogin_in_multisig": false,
"bridge": false,
"convert_type_argument_error": true,
"disable_invariant_violation_check_in_swap_loc": true,
"disallow_new_modules_in_deps_only_packages": true,
"enable_group_ops_native_function_msm": false,
"enable_jwk_consensus_updates": false,
"enable_poseidon": false,
"enable_vdf": false,
"hardened_otw_check": true,
"native_charging_v2": true,
"no_extraneous_module_bytes": true,
"passkey_auth": false,
"protocol_defined_base_fee": true,
"relocate_event_module": true,
"rethrow_serialization_type_layout_errors": true,
"uncompressed_g1_group_elements": false,
"zklogin_auth": false
},
"attributes": {
"address_from_bytes_cost_base": {
"u64": "52"
},
"address_from_u256_cost_base": {
"u64": "52"
},
"address_to_u256_cost_base": {
"u64": "52"
},
"base_gas_price": {
"u64": "1000"
},
"base_tx_cost_fixed": {
"u64": "1000"
},
"base_tx_cost_per_byte": {
"u64": "0"
},
"bcs_failure_cost": {
"u64": "52"
},
"bcs_legacy_min_output_size_cost": {
"u64": "1"
},
"bcs_per_byte_serialized_cost": {
"u64": "2"
},
"binary_address_identifiers": {
"u16": "100"
},
"binary_constant_pool": {
"u16": "4000"
},
"binary_enum_def_instantiations": null,
"binary_enum_defs": null,
"binary_field_handles": {
"u16": "500"
},
"binary_field_instantiations": {
"u16": "250"
},
"binary_friend_decls": {
"u16": "100"
},
"binary_function_defs": {
"u16": "1000"
},
"binary_function_handles": {
"u16": "1500"
},
"binary_function_instantiations": {
"u16": "750"
},
"binary_identifiers": {
"u16": "10000"
},
"binary_module_handles": {
"u16": "100"
},
"binary_signatures": {
"u16": "1000"
},
"binary_struct_def_instantiations": {
"u16": "100"
},
"binary_struct_defs": {
"u16": "200"
},
"binary_struct_handles": {
"u16": "300"
},
"binary_variant_handles": null,
"binary_variant_instantiation_handles": null,
"bls12381_bls12381_min_pk_verify_cost_base": {
"u64": "49282"
},
"bls12381_bls12381_min_pk_verify_msg_cost_per_block": {
"u64": "2"
},
"bls12381_bls12381_min_pk_verify_msg_cost_per_byte": {
"u64": "2"
},
"bls12381_bls12381_min_sig_verify_cost_base": {
"u64": "44064"
},
"bls12381_bls12381_min_sig_verify_msg_cost_per_block": {
"u64": "2"
},
"bls12381_bls12381_min_sig_verify_msg_cost_per_byte": {
"u64": "2"
},
"bridge_should_try_to_finalize_committee": {
"bool": "false"
},
"buffer_stake_for_protocol_upgrade_bps": {
"u64": "5000"
},
"check_zklogin_id_cost_base": {
"u64": "200"
},
"check_zklogin_issuer_cost_base": {
"u64": "200"
},
"checkpoint_summary_version_specific_data": {
"u64": "1"
},
"config_read_setting_impl_cost_base": {
"u64": "100"
},
"config_read_setting_impl_cost_per_byte": {
"u64": "40"
},
"consensus_bad_nodes_stake_threshold": {
"u64": "20"
},
"consensus_max_num_transactions_in_block": {
"u64": "512"
},
"consensus_max_transaction_size_bytes": {
"u64": "262144"
},
"consensus_max_transactions_in_block_bytes": {
"u64": "524288"
},
"crypto_invalid_arguments_cost": {
"u64": "100"
},
"debug_print_base_cost": {
"u64": "52"
},
"debug_print_stack_trace_base_cost": {
"u64": "52"
},
"dynamic_field_add_child_object_cost_base": {
"u64": "100"
},
"dynamic_field_add_child_object_struct_tag_cost_per_byte": {
"u64": "10"
},
"dynamic_field_add_child_object_type_cost_per_byte": {
"u64": "10"
},
"dynamic_field_add_child_object_value_cost_per_byte": {
"u64": "10"
},
"dynamic_field_borrow_child_object_child_ref_cost_per_byte": {
"u64": "10"
},
"dynamic_field_borrow_child_object_cost_base": {
"u64": "100"
},
"dynamic_field_borrow_child_object_type_cost_per_byte": {
"u64": "10"
},
"dynamic_field_has_child_object_cost_base": {
"u64": "100"
},
"dynamic_field_has_child_object_with_ty_cost_base": {
"u64": "100"
},
"dynamic_field_has_child_object_with_ty_type_cost_per_byte": {
"u64": "2"
},
"dynamic_field_has_child_object_with_ty_type_tag_cost_per_byte": {
"u64": "2"
},
"dynamic_field_hash_type_and_key_cost_base": {
"u64": "100"
},
"dynamic_field_hash_type_and_key_type_cost_per_byte": {
"u64": "2"
},
"dynamic_field_hash_type_and_key_type_tag_cost_per_byte": {
"u64": "2"
},
"dynamic_field_hash_type_and_key_value_cost_per_byte": {
"u64": "2"
},
"dynamic_field_remove_child_object_child_cost_per_byte": {
"u64": "2"
},
"dynamic_field_remove_child_object_cost_base": {
"u64": "100"
},
"dynamic_field_remove_child_object_type_cost_per_byte": {
"u64": "2"
},
"ecdsa_k1_decompress_pubkey_cost_base": {
"u64": "52"
},
"ecdsa_k1_ecrecover_keccak256_cost_base": {
"u64": "500"
},
"ecdsa_k1_ecrecover_keccak256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_k1_ecrecover_keccak256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_k1_ecrecover_sha256_cost_base": {
"u64": "500"
},
"ecdsa_k1_ecrecover_sha256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_k1_ecrecover_sha256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_k1_secp256k1_verify_keccak256_cost_base": {
"u64": "1470"
},
"ecdsa_k1_secp256k1_verify_keccak256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_k1_secp256k1_verify_keccak256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_k1_secp256k1_verify_sha256_cost_base": {
"u64": "1470"
},
"ecdsa_k1_secp256k1_verify_sha256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_k1_secp256k1_verify_sha256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_r1_ecrecover_keccak256_cost_base": {
"u64": "1173"
},
"ecdsa_r1_ecrecover_keccak256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_r1_ecrecover_keccak256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_r1_ecrecover_sha256_cost_base": {
"u64": "1173"
},
"ecdsa_r1_ecrecover_sha256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_r1_ecrecover_sha256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_r1_secp256r1_verify_keccak256_cost_base": {
"u64": "4225"
},
"ecdsa_r1_secp256r1_verify_keccak256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_r1_secp256r1_verify_keccak256_msg_cost_per_byte": {
"u64": "2"
},
"ecdsa_r1_secp256r1_verify_sha256_cost_base": {
"u64": "4225"
},
"ecdsa_r1_secp256r1_verify_sha256_msg_cost_per_block": {
"u64": "2"
},
"ecdsa_r1_secp256r1_verify_sha256_msg_cost_per_byte": {
"u64": "2"
},
"ecvrf_ecvrf_verify_alpha_string_cost_per_block": {
"u64": "2"
},
"ecvrf_ecvrf_verify_alpha_string_cost_per_byte": {
"u64": "2"
},
"ecvrf_ecvrf_verify_cost_base": {
"u64": "4848"
},
"ed25519_ed25519_verify_cost_base": {
"u64": "1802"
},
"ed25519_ed25519_verify_msg_cost_per_block": {
"u64": "2"
},
"ed25519_ed25519_verify_msg_cost_per_byte": {
"u64": "2"
},
"event_emit_cost_base": {
"u64": "52"
},
"event_emit_output_cost_per_byte": {
"u64": "10"
},
"event_emit_tag_size_derivation_cost_per_byte": {
"u64": "5"
},
"event_emit_value_size_derivation_cost_per_byte": {
"u64": "2"
},
"execution_version": {
"u64": "1"
},
"gas_model_version": {
"u64": "2"
},
"gas_rounding_step": {
"u64": "1000"
},
"groth16_prepare_verifying_key_bls12381_cost_base": {
"u64": "53838"
},
"groth16_prepare_verifying_key_bn254_cost_base": {
"u64": "82010"
},
"groth16_verify_groth16_proof_internal_bls12381_cost_base": {
"u64": "72090"
},
"groth16_verify_groth16_proof_internal_bls12381_cost_per_public_input": {
"u64": "8213"
},
"groth16_verify_groth16_proof_internal_bn254_cost_base": {
"u64": "115502"
},
"groth16_verify_groth16_proof_internal_bn254_cost_per_public_input": {
"u64": "9484"
},
"groth16_verify_groth16_proof_internal_public_input_cost_per_byte": {
"u64": "2"
},
"group_ops_bls12381_decode_g1_cost": {
"u64": "2848"
},
"group_ops_bls12381_decode_g2_cost": {
"u64": "3770"
},
"group_ops_bls12381_decode_gt_cost": {
"u64": "3068"
},
"group_ops_bls12381_decode_scalar_cost": {
"u64": "7"
},
"group_ops_bls12381_g1_add_cost": {
"u64": "1556"
},
"group_ops_bls12381_g1_div_cost": {
"u64": "5091"
},
"group_ops_bls12381_g1_hash_to_base_cost": {
"u64": "2962"
},
"group_ops_bls12381_g1_hash_to_cost_per_byte": {
"u64": "2"
},
"group_ops_bls12381_g1_msm_base_cost": {
"u64": "62648"
},
"group_ops_bls12381_g1_msm_base_cost_per_input": {
"u64": "1333"
},
"group_ops_bls12381_g1_mul_cost": {
"u64": "4842"
},
"group_ops_bls12381_g1_sub_cost": {
"u64": "1550"
},
"group_ops_bls12381_g1_to_uncompressed_g1_cost": {
"u64": "2099"
},
"group_ops_bls12381_g2_add_cost": {
"u64": "3048"
},
"group_ops_bls12381_g2_div_cost": {
"u64": "9206"
},
"group_ops_bls12381_g2_hash_to_base_cost": {
"u64": "8688"
},
"group_ops_bls12381_g2_hash_to_cost_per_byte": {
"u64": "2"
},
"group_ops_bls12381_g2_msm_base_cost": {
"u64": "131192"
},
"group_ops_bls12381_g2_msm_base_cost_per_input": {
"u64": "3216"
},
"group_ops_bls12381_g2_mul_cost": {
"u64": "9108"
},
"group_ops_bls12381_g2_sub_cost": {
"u64": "3019"
},
"group_ops_bls12381_gt_add_cost": {
"u64": "188"
},
"group_ops_bls12381_gt_div_cost": {
"u64": "27804"
},
"group_ops_bls12381_gt_mul_cost": {
"u64": "27490"
},
"group_ops_bls12381_gt_sub_cost": {
"u64": "497"
},
"group_ops_bls12381_msm_max_len": {
"u32": "32"
},
"group_ops_bls12381_pairing_cost": {
"u64": "26897"
},
"group_ops_bls12381_scalar_add_cost": {
"u64": "10"
},
"group_ops_bls12381_scalar_div_cost": {
"u64": "91"
},
"group_ops_bls12381_scalar_mul_cost": {
"u64": "11"
},
"group_ops_bls12381_scalar_sub_cost": {
"u64": "10"
},
"group_ops_bls12381_uncompressed_g1_sum_base_cost": {
"u64": "77"
},
"group_ops_bls12381_uncompressed_g1_sum_cost_per_term": {
"u64": "26"
},
"group_ops_bls12381_uncompressed_g1_sum_max_terms": {
"u64": "1200"
},
"group_ops_bls12381_uncompressed_g1_to_g1_cost": {
"u64": "677"
},
"hash_blake2b256_cost_base": {
"u64": "10"
},
"hash_blake2b256_data_cost_per_block": {
"u64": "2"
},
"hash_blake2b256_data_cost_per_byte": {
"u64": "2"
},
"hash_keccak256_cost_base": {
"u64": "10"
},
"hash_keccak256_data_cost_per_block": {
"u64": "2"
},
"hash_keccak256_data_cost_per_byte": {
"u64": "2"
},
"hash_sha2_256_base_cost": {
"u64": "52"
},
"hash_sha2_256_legacy_min_input_len_cost": {
"u64": "1"
},
"hash_sha2_256_per_byte_cost": {
"u64": "2"
},
"hash_sha3_256_base_cost": {
"u64": "52"
},
"hash_sha3_256_legacy_min_input_len_cost": {
"u64": "1"
},
"hash_sha3_256_per_byte_cost": {
"u64": "2"
},
"hmac_hmac_sha3_256_cost_base": {
"u64": "52"
},
"hmac_hmac_sha3_256_input_cost_per_block": {
"u64": "2"
},
"hmac_hmac_sha3_256_input_cost_per_byte": {
"u64": "2"
},
"max_accumulated_txn_cost_per_object_in_mysticeti_commit": {
"u64": "10"
},
"max_age_of_jwk_in_epochs": {
"u64": "1"
},
"max_arguments": {
"u32": "512"
},
"max_back_edges_per_function": {
"u64": "10000"
},
"max_back_edges_per_module": {
"u64": "10000"
},
"max_basic_blocks": {
"u64": "1024"
},
"max_checkpoint_size_bytes": {
"u64": "31457280"
},
"max_committee_members_count": {
"u64": "50"
},
"max_deferral_rounds_for_congestion_control": {
"u64": "10"
},
"max_dependency_depth": {
"u64": "100"
},
"max_event_emit_size": {
"u64": "256000"
},
"max_event_emit_size_total": {
"u64": "65536000"
},
"max_fields_in_struct": {
"u64": "32"
},
"max_function_definitions": {
"u64": "1000"
},
"max_function_parameters": {
"u64": "128"
},
"max_gas_computation_bucket": {
"u64": "5000000"
},
"max_gas_payment_objects": {
"u32": "256"
},
"max_gas_price": {
"u64": "100000"
},
"max_generic_instantiation_length": {
"u64": "32"
},
"max_input_objects": {
"u64": "2048"
},
"max_jwk_votes_per_validator_per_epoch": {
"u64": "240"
},
"max_loop_depth": {
"u64": "5"
},
"max_meter_ticks_per_module": {
"u64": "16000000"
},
"max_meter_ticks_per_package": {
"u64": "16000000"
},
"max_modules_in_publish": {
"u32": "64"
},
"max_move_enum_variants": null,
"max_move_identifier_len": {
"u64": "128"
},
"max_move_object_size": {
"u64": "256000"
},
"max_move_package_size": {
"u64": "102400"
},
"max_move_value_depth": {
"u64": "128"
},
"max_move_vector_len": {
"u64": "262144"
},
"max_num_deleted_move_object_ids": {
"u64": "2048"
},
"max_num_deleted_move_object_ids_system_tx": {
"u64": "32768"
},
"max_num_event_emit": {
"u64": "1024"
},
"max_num_new_move_object_ids": {
"u64": "2048"
},
"max_num_new_move_object_ids_system_tx": {
"u64": "32768"
},
"max_num_transferred_move_object_ids": {
"u64": "2048"
},
"max_num_transferred_move_object_ids_system_tx": {
"u64": "32768"
},
"max_package_dependencies": {
"u32": "32"
},
"max_programmable_tx_commands": {
"u32": "1024"
},
"max_ptb_value_size": {
"u64": "1048576"
},
"max_publish_or_upgrade_per_ptb": {
"u64": "5"
},
"max_pure_argument_size": {
"u32": "16384"
},
"max_push_size": {
"u64": "10000"
},
"max_serialized_tx_effects_size_bytes": {
"u64": "524288"
},
"max_serialized_tx_effects_size_bytes_system_tx": {
"u64": "8388608"
},
"max_size_written_objects": {
"u64": "5000000"
},
"max_size_written_objects_system_tx": {
"u64": "50000000"
},
"max_soft_bundle_size": {
"u64": "5"
},
"max_struct_definitions": {
"u64": "200"
},
"max_transactions_per_checkpoint": {
"u64": "10000"
},
"max_tx_gas": {
"u64": "50000000000"
},
"max_tx_size_bytes": {
"u64": "131072"
},
"max_type_argument_depth": {
"u32": "16"
},
"max_type_arguments": {
"u32": "16"
},
"max_type_nodes": {
"u64": "256"
},
"max_type_to_layout_nodes": {
"u64": "512"
},
"max_value_stack_size": {
"u64": "1024"
},
"max_verifier_meter_ticks_per_function": {
"u64": "16000000"
},
"min_checkpoint_interval_ms": {
"u64": "200"
},
"min_move_binary_format_version": {
"u32": "6"
},
"move_binary_format_version": {
"u32": "7"
},
"obj_access_cost_delete_per_byte": {
"u64": "40"
},
"obj_access_cost_mutate_per_byte": {
"u64": "40"
},
"obj_access_cost_read_per_byte": {
"u64": "15"
},
"obj_access_cost_verify_per_byte": {
"u64": "200"
},
"obj_data_cost_refundable": {
"u64": "100"
},
"obj_metadata_cost_non_refundable": {
"u64": "50"
},
"object_borrow_uid_cost_base": {
"u64": "52"
},
"object_delete_impl_cost_base": {
"u64": "52"
},
"object_record_new_uid_cost_base": {
"u64": "52"
},
"object_runtime_max_num_cached_objects": {
"u64": "1000"
},
"object_runtime_max_num_cached_objects_system_tx": {
"u64": "16000"
},
"object_runtime_max_num_store_entries": {
"u64": "1000"
},
"object_runtime_max_num_store_entries_system_tx": {
"u64": "16000"
},
"package_publish_cost_fixed": {
"u64": "1000"
},
"package_publish_cost_per_byte": {
"u64": "80"
},
"poseidon_bn254_cost_base": null,
"poseidon_bn254_cost_per_block": {
"u64": "388"
},
"random_beacon_dkg_timeout_round": {
"u32": "3000"
},
"random_beacon_dkg_version": {
"u64": "1"
},
"random_beacon_min_round_interval_ms": {
"u64": "500"
},
"random_beacon_reduction_allowed_delta": {
"u16": "800"
},
"random_beacon_reduction_lower_bound": {
"u32": "1000"
},
"reward_slashing_rate": {
"u64": "10000"
},
"storage_gas_price": {
"u64": "76"
},
"storage_rebate_rate": {
"u64": "10000"
},
"string_check_utf8_base_cost": {
"u64": "52"
},
"string_check_utf8_per_byte_cost": {
"u64": "2"
},
"string_index_of_base_cost": {
"u64": "52"
},
"string_index_of_per_byte_pattern_cost": {
"u64": "2"
},
"string_index_of_per_byte_searched_cost": {
"u64": "2"
},
"string_is_char_boundary_base_cost": {
"u64": "52"
},
"string_sub_string_base_cost": {
"u64": "52"
},
"string_sub_string_per_byte_cost": {
"u64": "2"
},
"transfer_freeze_object_cost_base": {
"u64": "52"
},
"transfer_receive_object_cost_base": {
"u64": "52"
},
"transfer_share_object_cost_base": {
"u64": "52"
},
"transfer_transfer_internal_cost_base": {
"u64": "52"
},
"tx_context_derive_id_cost_base": {
"u64": "52"
},
"type_name_get_base_cost": {
"u64": "52"
},
"type_name_get_per_byte_cost": {
"u64": "2"
},
"types_is_one_time_witness_cost_base": {
"u64": "52"
},
"types_is_one_time_witness_type_cost_per_byte": {
"u64": "2"
},
"types_is_one_time_witness_type_tag_cost_per_byte": {
"u64": "2"
},
"validator_target_reward": {
"u64": "767000000000000"
},
"validator_validate_metadata_cost_base": {
"u64": "20000"
},
"validator_validate_metadata_data_cost_per_byte": {
"u64": "2"
},
"vdf_hash_to_input_cost": null,
"vdf_verify_vdf_cost": null,
"vector_borrow_base_cost": {
"u64": "52"
},
"vector_destroy_empty_base_cost": {
"u64": "52"
},
"vector_empty_base_cost": {
"u64": "52"
},
"vector_length_base_cost": {
"u64": "52"
},
"vector_pop_back_base_cost": {
"u64": "52"
},
"vector_push_back_base_cost": {
"u64": "52"
},
"vector_push_back_legacy_per_abstract_memory_unit_cost": {
"u64": "2"
},
"vector_swap_base_cost": {
"u64": "52"
}
}
}
}iota_getTotalTransactionBlocks
Return the total number of transaction blocks known to the server.
Parameters
None
Result
BigInt<u64>< BigInt_for_uint64 >
Example
Gets total number of transactions on the network.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getTotalTransactionBlocks",
"params": []
}
Response
{
"jsonrpc": "2.0",
"id": 1,
"result": "32091118"
}iota_getTransactionBlock
Return the transaction response object.
Parameters
digest< TransactionDigest >
Required: yes
Description: The digest of the queried transaction
options< TransactionBlockResponseOptions >
Required: no
Description: Options for specifying the content to be returned
Result
IotaTransactionBlockResponse< TransactionBlockResponse >
Parameters
balanceChanges< BalanceChange [array,null] >
Required: No
checkpoint< BigInt_for_uint64 | null >
Required: no
Description: The checkpoint number when this transaction was included and hence finalized. This is only returned in the read api, not in the transaction execution api.
confirmedLocalExecution< [boolean,null] >
Required: no
digest< TransactionDigest >
Required: yes
effects< TransactionBlockEffects | null >
Required: no
errors<[ string ]>
Required: no
events< Event [array,null] >
Required: no
objectChanges< ObjectChange [array,null] >
Required: no
rawEffects<[ string ]>
Required: no
rawTransaction< Base64 >
Required: no
timestampMs< BigInt_for_uint64 | null >
Required: no
transaction< TransactionBlock | null >
Required: no
Example
Returns the transaction response object for specified transaction digest.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_getTransactionBlock",
"params": [
"Gm7VbpUjxNbGfqVmrBHdauHTxJpzkqiFN7UeZwQPeaor",
{
"showInput": true,
"showRawInput": false,
"showEffects": true,
"showEvents": true,
"showObjectChanges": false,
"showBalanceChanges": false,
"showRawEffects": false
}
]
}Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"digest": "Gm7VbpUjxNbGfqVmrBHdauHTxJpzkqiFN7UeZwQPeaor",
"transaction": {
"data": {
"messageVersion": "v1",
"transaction": {
"kind": "ConsensusCommitPrologueV1",
"epoch": "19",
"round": "414557",
"sub_dag_index": null,
"commit_timestamp_ms": "1748096243261",
"consensus_commit_digest": "CaJCc62oEnqv778iWMgeLPKvc7jXdNy51CAZe8ovC2rB",
"consensus_determined_version_assignments": {
"CancelledTransactions": []
}
},
"sender": "0x0000000000000000000000000000000000000000000000000000000000000000",
"gasData": {
"payment": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
],
"owner": "0x0000000000000000000000000000000000000000000000000000000000000000",
"price": "1",
"budget": "0"
}
},
"txSignatures": [
"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
]
},
"effects": {
"messageVersion": "v1",
"status": {
"status": "success"
},
"executedEpoch": "19",
"gasUsed": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"modifiedAtVersions": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"sequenceNumber": "28591794"
}
],
"sharedObjects": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"version": 28591794,
"digest": "DF9diZ4eNQbfozVFpkmZBwYgo6eEmVSigmzS9jS4eKDs"
}
],
"transactionDigest": "Gm7VbpUjxNbGfqVmrBHdauHTxJpzkqiFN7UeZwQPeaor",
"mutated": [
{
"owner": {
"Shared": {
"initial_shared_version": 1
}
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"version": 28591795,
"digest": "5HaEZJ9GwdX6ZuCybH9fQVgg9p8ppZBBcBBcEGkdsXGG"
}
}
],
"gasObject": {
"owner": {
"AddressOwner": "0x0000000000000000000000000000000000000000000000000000000000000000"
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
},
"dependencies": [
"3ZfpwocYpwB23Fx7DLScBW6Gi6fJvnSAKXFmxAm2qw2N"
]
},
"events": [],
"timestampMs": "1748096243261",
"checkpoint": "7351677"
}
}iota_multiGetObjects
Return the object data for a list of objects
Parameters
object_ids<[ ObjectID ]>
Required: yes
Description: The IDs of the queried objects
options< ObjectDataOptions >
Required: no
Description: Options for specifying the content to be returned
Result
Vec<IotaObjectResponse><[ IotaObjectResponse ]>
Example
Gets objects by IDs.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_multiGetObjects",
"params": [
[
"0x504d411325e3c7f89d412044fe99007efb0f94f1e64d2e8090c619a39299d87e",
"0x23618df6438d21a48040e6bb568cafc13246bd847c60448160e0358cac4a1134",
"0x8b95b4eaa9fd3b22b43f6b2c8e92090bd6d16522a6fd4fa83ec70a5f197ad656",
"0x3fbbd3ebef7dbcc7b02346cdf05674452cc61f316af5d5d7c02b94b023242685",
"0x9b5cd5df0df2a168259b7115a41ccc0a372b6fd0026e0c63043492ce4d0c19a6"
],
{
"showType": true,
"showOwner": true,
"showPreviousTransaction": true,
"showDisplay": false,
"showContent": true,
"showBcs": false,
"showStorageRebate": true
}
]
}Response
{
"jsonrpc": "2.0",
"result": [
{
"data": {
"objectId": "0x504d411325e3c7f89d412044fe99007efb0f94f1e64d2e8090c619a39299d87e",
"version": "1",
"digest": "AibMqH69gKT5t7rVTsDZFy2X5iHtoNDobKaZ62mg3FCU",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0xe8070b5f56bb10bafa0e2261d819b2582f82ab308bf9c96dfb22ec7345db1b5f"
},
"previousTransaction": "2QwXW3qzMEZPAyyP9VHtXbC2tp7iomypQc5XnkyPsu5d",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "100000000",
"id": {
"id": "0x504d411325e3c7f89d412044fe99007efb0f94f1e64d2e8090c619a39299d87e"
}
}
}
}
},
{
"data": {
"objectId": "0x23618df6438d21a48040e6bb568cafc13246bd847c60448160e0358cac4a1134",
"version": "1",
"digest": "D5W76mT1A3tqCmE1Z5MdV5obNzesMXLfLKpRDHSp1fyz",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0x5594d02890c986dbf328d28d21acece356d10d89e75f565b0934851ba8d5bc59"
},
"previousTransaction": "5itvhMFvtJcV6fY2VY4x7F9Ex18q2N4Rr5WU4FXTJsFU",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "100000000",
"id": {
"id": "0x23618df6438d21a48040e6bb568cafc13246bd847c60448160e0358cac4a1134"
}
}
}
}
},
{
"data": {
"objectId": "0x8b95b4eaa9fd3b22b43f6b2c8e92090bd6d16522a6fd4fa83ec70a5f197ad656",
"version": "1",
"digest": "H2o2pWgceQgTtYrMacR4xnCi4vqGiuozDA6k2rBc4m3q",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0xda104dde1de9880be827a1a753e502ebcdfec53f33e745e3f021366b7bc47c2b"
},
"previousTransaction": "8rsTRNPs13DZvD2xneZEtf2nAAipep6uHXPXWVXfzDBr",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "100000000",
"id": {
"id": "0x8b95b4eaa9fd3b22b43f6b2c8e92090bd6d16522a6fd4fa83ec70a5f197ad656"
}
}
}
}
},
{
"data": {
"objectId": "0x3fbbd3ebef7dbcc7b02346cdf05674452cc61f316af5d5d7c02b94b023242685",
"version": "1",
"digest": "3ovR1s3bZt6AN1AQ7QhGUfX9BSwgjJPvL6XaczgeSKXU",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0x00a65bf5fdccb50582333b61721e6963a25f25ac8ead5916a83f49a7b372eae7"
},
"previousTransaction": "3w6ars2tmgBST4ozGxPWzSpEGyn4AdxMBv3K9sdkCWfR",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "100000000",
"id": {
"id": "0x3fbbd3ebef7dbcc7b02346cdf05674452cc61f316af5d5d7c02b94b023242685"
}
}
}
}
},
{
"data": {
"objectId": "0x9b5cd5df0df2a168259b7115a41ccc0a372b6fd0026e0c63043492ce4d0c19a6",
"version": "1",
"digest": "25QdFqrh9FgxhGQyAxZsNEakYmHezqmU3FMPud7JGRB5",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0x3e7f360c51d035a6470f09c8d23716e4085025b89d176840d61dde92a452a72f"
},
"previousTransaction": "BE9GoMd7Mr8fGte3EdsXxUMwYjcErW71n6Gsm4iPvDmv",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "100000000",
"id": {
"id": "0x9b5cd5df0df2a168259b7115a41ccc0a372b6fd0026e0c63043492ce4d0c19a6"
}
}
}
}
}
],
"id": 1
}iota_multiGetTransactionBlocks
Returns an ordered list of transaction responses The method will throw an error if the input contains any duplicate or the input size exceeds QUERY_MAX_RESULT_LIMIT
Parameters
digests<[ TransactionDigest ]>
Required: yes
Description: A list of transaction digests.
options< TransactionBlockResponseOptions >
Required: no
Description: Config options to control which fields to fetch
Result
Vec<IotaTransactionBlockResponse><[ TransactionBlockResponse ]>
Example
Returns the transaction data for specified digest.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_multiGetTransactionBlocks",
"params": [
[
"Hj12H7iuX6ejEQCtbA2saQpa1i68f9d2CWxxgQo9QbpY",
"81rKmx5TmSzq8UK51rwHS6gQdUg618JHoa4oUxB3opb",
"AhdWMs5P16iyATKbiZ1vhoAj11Q9xKA7r9XTJDB5wFes"
],
{
"showInput": true,
"showRawInput": false,
"showEffects": true,
"showEvents": true,
"showObjectChanges": false,
"showBalanceChanges": false,
"showRawEffects": false
}
]
}Response
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"digest": "31naVGN97BseTxCCV1tnzE9RZUL8AaJojo9i2yQ8GAMy",
"transaction": {
"data": {
"messageVersion": "v1",
"transaction": {
"kind": "RandomnessStateUpdate",
"epoch": "19",
"randomness_round": "46527",
"random_bytes": [
150,
182,
203,
89,
234,
99,
161,
27,
178,
66,
114,
97,
105,
15,
185,
105,
246,
179,
175,
14,
214,
253,
52,
55,
219,
154,
128,
224,
112,
66,
1,
100,
216,
211,
148,
32,
185,
137,
25,
172,
72,
232,
224,
69,
72,
86,
140,
210
]
},
"sender": "0x0000000000000000000000000000000000000000000000000000000000000000",
"gasData": {
"payment": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
],
"owner": "0x0000000000000000000000000000000000000000000000000000000000000000",
"price": "1",
"budget": "0"
}
},
"txSignatures": [
"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
]
},
"effects": {
"messageVersion": "v1",
"status": {
"status": "success"
},
"executedEpoch": "19",
"gasUsed": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"modifiedAtVersions": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000008",
"sequenceNumber": "3146509"
},
{
"objectId": "0xe0d9265333baf9d66e2b15c0d217ca26c83b0dbb88e135d7682252d987e86ea0",
"sequenceNumber": "3146509"
}
],
"sharedObjects": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000008",
"version": 3146509,
"digest": "AEdNWfykNNw4pMtgnHiEqNFZYNA7xchCGxVk2zkX5MRk"
}
],
"transactionDigest": "31naVGN97BseTxCCV1tnzE9RZUL8AaJojo9i2yQ8GAMy",
"mutated": [
{
"owner": {
"Shared": {
"initial_shared_version": 1
}
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000008",
"version": 3146510,
"digest": "GYKi7XoHeevEB6Wr2pcYH4n2hdvjD9nGwXK7The636nz"
}
},
{
"owner": {
"ObjectOwner": "0xf036d71864eb9287330110df7475b5b98ba0564c8c69fd5f844d398560c0b41a"
},
"reference": {
"objectId": "0xe0d9265333baf9d66e2b15c0d217ca26c83b0dbb88e135d7682252d987e86ea0",
"version": 3146510,
"digest": "GoDskPrKyFcD5mJjRDViLNrD8rtRah5pDAJmPCwxbjme"
}
}
],
"gasObject": {
"owner": {
"AddressOwner": "0x0000000000000000000000000000000000000000000000000000000000000000"
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
},
"dependencies": [
"A9ZCC6LptegZ1vX7WZHerVmeiQLJbZp6rzUrYAXPZCTk"
]
},
"events": [],
"timestampMs": "1748096946580",
"checkpoint": "7354751"
},
{
"digest": "HHhgetrjfQLMsZ7UnVgwWdsgfeApK1KYDPu8VNasWN6R",
"transaction": {
"data": {
"messageVersion": "v1",
"transaction": {
"kind": "ConsensusCommitPrologueV1",
"epoch": "19",
"round": "426474",
"sub_dag_index": null,
"commit_timestamp_ms": "1748096946423",
"consensus_commit_digest": "5J6WpT6HBfcFTu2YGntQr7MD9M2JoAyGauzrtB6CyEoe",
"consensus_determined_version_assignments": {
"CancelledTransactions": []
}
},
"sender": "0x0000000000000000000000000000000000000000000000000000000000000000",
"gasData": {
"payment": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
],
"owner": "0x0000000000000000000000000000000000000000000000000000000000000000",
"price": "1",
"budget": "0"
}
},
"txSignatures": [
"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
]
},
"effects": {
"messageVersion": "v1",
"status": {
"status": "success"
},
"executedEpoch": "19",
"gasUsed": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"modifiedAtVersions": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"sequenceNumber": "28603690"
}
],
"sharedObjects": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"version": 28603690,
"digest": "symN1WDVf3gaTyPiVDDuP37cCSVt52QLnDahSYzHxom"
}
],
"transactionDigest": "HHhgetrjfQLMsZ7UnVgwWdsgfeApK1KYDPu8VNasWN6R",
"mutated": [
{
"owner": {
"Shared": {
"initial_shared_version": 1
}
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"version": 28603691,
"digest": "2Z1EdJLt6c4DgXq4GJp5A1QZnteDuGYyFTd5yFF8gWTB"
}
}
],
"gasObject": {
"owner": {
"AddressOwner": "0x0000000000000000000000000000000000000000000000000000000000000000"
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
},
"dependencies": [
"3CanzqiPTkdMXkXbdCC4L4Pkgj1rX2KYtUpqKLtSiiL1"
]
},
"events": [],
"timestampMs": "1748096946580",
"checkpoint": "7354751"
},
{
"digest": "HzHPubfbdCdmQHMcNzCwGUg4sASNouEKvNmNgXSqYv7w",
"transaction": {
"data": {
"messageVersion": "v1",
"transaction": {
"kind": "ConsensusCommitPrologueV1",
"epoch": "19",
"round": "426475",
"sub_dag_index": null,
"commit_timestamp_ms": "1748096946506",
"consensus_commit_digest": "GHS22o9N6Ejrq64K2r2wp1XT2AsFacTguxLwyH8vwuBn",
"consensus_determined_version_assignments": {
"CancelledTransactions": []
}
},
"sender": "0x0000000000000000000000000000000000000000000000000000000000000000",
"gasData": {
"payment": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
],
"owner": "0x0000000000000000000000000000000000000000000000000000000000000000",
"price": "1",
"budget": "0"
}
},
"txSignatures": [
"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=="
]
},
"effects": {
"messageVersion": "v1",
"status": {
"status": "success"
},
"executedEpoch": "19",
"gasUsed": {
"computationCost": "0",
"computationCostBurned": "0",
"storageCost": "0",
"storageRebate": "0",
"nonRefundableStorageFee": "0"
},
"modifiedAtVersions": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"sequenceNumber": "28603691"
}
],
"sharedObjects": [
{
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"version": 28603691,
"digest": "2Z1EdJLt6c4DgXq4GJp5A1QZnteDuGYyFTd5yFF8gWTB"
}
],
"transactionDigest": "HzHPubfbdCdmQHMcNzCwGUg4sASNouEKvNmNgXSqYv7w",
"mutated": [
{
"owner": {
"Shared": {
"initial_shared_version": 1
}
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
"version": 28603692,
"digest": "5LEDdvverGhYyDE2GxdKKNHSEe6oXo1uSBypLWTUctjw"
}
}
],
"gasObject": {
"owner": {
"AddressOwner": "0x0000000000000000000000000000000000000000000000000000000000000000"
},
"reference": {
"objectId": "0x0000000000000000000000000000000000000000000000000000000000000000",
"version": 0,
"digest": "11111111111111111111111111111111"
}
},
"dependencies": [
"HHhgetrjfQLMsZ7UnVgwWdsgfeApK1KYDPu8VNasWN6R"
]
},
"events": [],
"timestampMs": "1748096946580",
"checkpoint": "7354751"
}
]
}iota_tryGetPastObject
Note there is no software-level guarantee/SLA that objects with past versions can be retrieved by this API, even if the object and version exists/existed. The result may vary across nodes depending on their pruning policies. Return the object information for a specified version
Parameters
object_id< ObjectID >
Required: yes
Description: The ID of the queried object
options< ObjectDataOptions >
Required: no
Description: Options for specifying the content to be returned
version< SequenceNumber >
Required: yes
Descripiton: The version of the queried object. If None, default to the latest known version
Result
IotaPastObjectResponse< ObjectRead >
Example
Gets Past Object data.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_tryGetPastObject",
"params": [
"0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
4,
{
"showType": true,
"showOwner": true,
"showPreviousTransaction": true,
"showDisplay": false,
"showContent": true,
"showBcs": false,
"showStorageRebate": true
}
]
}Response
{
"jsonrpc": "2.0",
"result": {
"status": "VersionFound",
"details": {
"objectId": "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760",
"version": "4",
"digest": "5VPAwDXy3BL72ehFc7gSJoz27ahMd6spUg5YwYc4ibcv",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0x3568c40e814d9d5396d23087a0fd641e91e0e00df6c012cded9ef9ba5e5bf042"
},
"previousTransaction": "5jQByoouHBwaico5pQB73GdbzerC2StjTiHh5garBjiV",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "10000",
"id": {
"id": "0x11af4b844ff94b3fbef6e36b518da3ad4c5856fa686464524a876b463d129760"
}
}
}
}
},
"id": 1
}iota_tryMultiGetPastObjects
Note there is no software-level guarantee/SLA that objects with past versions can be retrieved by this API, even if the object and version exists/existed. The result may vary across nodes depending on their pruning policies. Return the object information for a specified version.
Parameters
past_objects<[ GetPastObjectRequest ]>
Required: yes
Description: A vector of object and versions to be queried
options< ObjectDataOptions >
Required: no
Description: Options for specifying the content to be returned
Result
Vec<IotaPastObjectResponse><[ ObjectRead ]>
Example
Gets Past Object data for a vector of objects.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "iota_tryMultiGetPastObjects",
"params": [
[
{
"objectId": "0xd22bbb46f892c42d9ec0ae4de93e02c75973a51c17180798237326a58694a2cf",
"version": "4"
},
{
"objectId": "0x5cd6fa76ed1d18f05f15e35075252ddec4fb83621d55952d9172fcfcb72feae2",
"version": "12"
}
],
{
"showType": true,
"showOwner": true,
"showPreviousTransaction": true,
"showDisplay": false,
"showContent": true,
"showBcs": false,
"showStorageRebate": true
}
]
}Response
{
"jsonrpc": "2.0",
"result": [
{
"status": "VersionFound",
"details": {
"objectId": "0xd22bbb46f892c42d9ec0ae4de93e02c75973a51c17180798237326a58694a2cf",
"version": "4",
"digest": "5pCqw4G6F1hXcukW3XwhBzas9RqeFrUkvNon5jgX3ewg",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0x38b3186a7bb26a1ab2c982a0a9b482aa70f5a010fffc60f20194ef0f597474e8"
},
"previousTransaction": "EupJisi3AynCmcFyhkX1azsVtR6vun1Uaf7WSRCE82jx",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "10000",
"id": {
"id": "0xd22bbb46f892c42d9ec0ae4de93e02c75973a51c17180798237326a58694a2cf"
}
}
}
}
},
{
"status": "VersionFound",
"details": {
"objectId": "0x5cd6fa76ed1d18f05f15e35075252ddec4fb83621d55952d9172fcfcb72feae2",
"version": "12",
"digest": "CE9bNT96Sa2BxQQH2id4PRxTgW5TW7zm6VVhDeRNBegW",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"owner": {
"AddressOwner": "0x54b3c61936f77fcfdaa213c2f7b4fb1b51ef9f3ed66000c0e45697dbee095479"
},
"previousTransaction": "hvBGBXvKVhC7XYgVPujuiLjxASR6UGAkSFrCRtVxX1F",
"storageRebate": "100",
"content": {
"dataType": "moveObject",
"type": "0x2::coin::Coin<0x2::iota::IOTA>",
"fields": {
"balance": "20000",
"id": {
"id": "0xd22bbb46f892c42d9ec0ae4de93e02c75973a51c17180798237326a58694a2cf"
}
}
}
}
}
],
"id": 1
}Last updated