method_get_metadata.md

Method get_metadata

Description

Get the blockchain / ledger metadata.

Parameters

Name	Type	Description
version	unsigned int64	The transaction version, this parameter is optional, default is server's latest transaction version.

Returns

Metadata

Note: fields script_hash_allow_list, module_publishing_allowed and diem_version are only returned when no version argument provided.

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
  }
}