Skip to content

Latest commit

 

History

History
48 lines (39 loc) · 2.23 KB

type_metadata.md

File metadata and controls

48 lines (39 loc) · 2.23 KB
Raw

Type Metadata

Name Type Description
version unsigned int64 The latest block (ledger) version
timestamp unsigned int64 The latest block (ledger) timestamp, unit is microsecond
chain_id unsigned int8 Chain ID of the Diem network
script_hash_allow_list List List of allowed scripts hex-encoded hash bytes, server may not return this field if the allow list not found in on chain configuration.
module_publishing_allowed boolean True for allowing publishing customized script, server may not return this field if the flag not found in on chain configuration.
diem_version unsigned int64 Diem chain major version number
accumulator_root_hash string accumulator root hash of the block (ledger) version
dual_attestation_limit unsigned int64 The dual attestation limit on-chain. Defined in terms of micro-XDX.

Note:

  1. see DiemTransactionPublishingOption for more details of script_hash_allow_list and module_publishing_allowed.
  2. Fields script_hash_allow_list, module_publishing_allowed and diem_version are only returned when requesting latest version by get_metadata method call.

Example

// Request: fetches current block metadata
curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"get_metadata","params":[],"id":1}' https://testnet.diem.com/v1

// Response
{
  "id": 1,
  "jsonrpc": "2.0",
  "diem_chain_id": 2,
  "diem_ledger_timestampusec": 1596680521771648,
  "diem_ledger_version": 3253133,
  "result": {
    "timestamp": 1596680521771648,
    "version": 3253133,
    "chain_id": 4,
    "script_hash_allow_list": [
        <allowed scripts hex-encoded hash string>
    ],
    "module_publishing_allowed": false,
    "diem_version": 1,
    "accumulator_root_hash": "<hash string>",
    "dual_attestation_limit": 1000000000
  }
}