Admin API

The admin api allows clients to examine dijets node's internal state, its set of connections, and similar internal protocol data.

Format#

This API uses the json 2.0 RPC format. For details, see here.

Endpoint#

/ext/admin

Methods#

admin.alias#

Assign an API endpoint an alias, a different endpoint for the API. The original endpoint will still work. This change only affects this node; other nodes will not know about this alias.

Signature:

admin.alias({endpoint:string, alias:string}) -> {}

• endpoint is the original endpoint of the API. endpoint should only include the part of the endpoint after /ext/.
• The API being aliased can now be called at ext/alias.
• alias can be at most 512 characters.

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.alias",
5    "params": {
6        "alias":"myAlias",
7        "endpoint":"bc/X"
8    }
9}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

Now, calls to the Value Chain can be made to either /ext/bc/X or, equivalently, to /ext/myAlias.

admin.aliasChain#

Give a blockchain an alias, a different name that can be used any place the blockchain’s ID is used.

Signature:

admin.aliasChain(
    {
        chain:string,
        alias:string
    }
) -> {}

• chain is the blockchain’s ID.
• alias can now be used in place of the blockchain’s ID (in API endpoints, for example.)

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.aliasChain",
5    "params": {
6        "chain":"sV6o671RtkGBcno1FiaDbVcFv2sG5aVXMZYzKdP4VQAWmJQnM",
7        "alias":"myBlockchainAlias"
8    }
9}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

Now, instead of interacting with the blockchain whose ID is sV6o671RtkGBcno1FiaDbVcFv2sG5aVXMZYzKdP4VQAWmJQnM by making API calls to /ext/bc/sV6o671RtkGBcno1FiaDbVcFv2sG5aVXMZYzKdP4VQAWmJQnM, one can also make calls to ext/bc/myBlockchainAlias.

admin.getChainAliases#

Returns the aliases of the chain

Signature:

admin.getChainAliases(
    {
        chain:string
    }
) -> {aliases:string[]}

• chain is the blockchain’s ID.

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.getChainAliases",
5    "params": {
6        "chain":"sV6o671RtkGBcno1FiaDbVcFv2sG5aVXMZYzKdP4VQAWmJQnM"
7    }
8}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "aliases": [
      "X",
      "avm",
      "2eNy1mUFdmaxXNj1eQHUe7Np4gju9sJsEtWQ4MX3ToiNKuADed"
    ]
  },
  "id": 1
}

admin.getLoggerLevel#

Returns log and display levels of loggers.

Signature:

admin.getLoggerLevel(
    {
        loggerName:string // optional
    }
) -> {
        loggerLevels: {
            loggerName: {
                    logLevel: string,
                    displayLevel: string
            }
        }
    }

• loggerName is the name of the logger to be returned. This is an optional argument. If not specified, it returns all possible loggers.

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.getLoggerLevel",
5    "params": {
6        "loggerName": "C"
7    }
8}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "loggerLevels": {
      "C": {
        "logLevel": "DEBUG",
        "displayLevel": "INFO"
      }
    }
  },
  "id": 1
}

admin.loadVMs#

Dynamically loads any virtual machines installed on the node as plugins.

Signature:

admin.loadVMs() -> {
    newVMs: map[string][]string
    failedVMs: map[string]string,
}

• failedVMs is only included in the response if at least one virtual machine fails to be loaded.

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.loadVMs",
5    "params" :{}
6}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "newVMs": {
      "tGas3T58KzdjLHhBDMnH2TvrddhqTji5iZAMZ3RXs2NLpSnhH": ["foovm"]
    },
    "failedVMs": {
      "rXJsCSEYXg2TehWxCEEGj6JU2PWKTkd6cBdNLjoe2SpsKD9cy": "error message"
    }
  },
  "id": 1
}

admin.lockProfile#

Writes a profile of mutex statistics to lock.profile.

Signature:

admin.lockProfile() -> {}

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.lockProfile",
5    "params" :{}
6}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

admin.memoryProfile#

Writes a memory profile of the to mem.profile.

Signature:

admin.memoryProfile() -> {}

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.memoryProfile",
5    "params" :{}
6}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

admin.setLoggerLevel#

Sets log and display levels of loggers.

Signature:

admin.setLoggerLevel(
    {
        loggerName: string, // optional
        logLevel: string, // optional
        displayLevel: string, // optional
    }
) -> {}

• loggerName is the logger's name to be changed. This is an optional parameter. If not specified, it changes all possible loggers.
• logLevel is the log level of written logs, can be omitted.
• displayLevel is the log level of displayed logs, can be omitted.

logLevel and displayLevel cannot be omitted at the same time.

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.setLoggerLevel",
5    "params": {
6        "loggerName": "C",
7        "logLevel": "DEBUG",
8        "displayLevel": "INFO"
9    }
10}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

admin.startCPUProfiler#

Start profiling the CPU utilization of the node. To stop, call admin.stopCPUProfiler. On stop, writes the profile to cpu.profile.

Signature:

admin.startCPUProfiler() -> {}

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.startCPUProfiler",
5    "params" :{}
6}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

admin.stopCPUProfiler#

Stop the CPU profile that was previously started.

Signature:

admin.stopCPUProfiler() -> {}

Example Call:

1curl -X POST --data '{
2    "jsonrpc":"2.0",
3    "id"     :1,
4    "method" :"admin.stopCPUProfiler"
5}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/admin

Example Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}