hemictl

hemictl

The hemictl command is a generic tool to script commands to the various daemons. The generic use is: hemictl <daemon> <action> [json parameters].

daemon determines the default URI hemictl connects to. E.g. bss is ws://localhost:8081/v1/ws.

TODO: Add environment variable override for the URI.

action determines which command will be called. E.g. ping.

parameters are JSON encoded parameters to the action. E.g. {"timestamp":1}.

Thus a command to a daemon can be issues as such:

hemictl bss ping '{"timestamp":1}'

Which will result in something like:

{
    "origintimestamp": 1,
    "timestamp": 1701091119
}

And example of a call with a failure:

hemictl bss l1tick '{"l1_height":0}'

{
    "error": {
        "timestamp": 1701091156,
        "trace": "804d952f893e686c",
        "error": "L1 tick notification with height zero"
    }
}

database

hemictl allows direct access to the storage layer. For now it only supports postgres.

hemictl bfgdb version

{"bfgdb_version":1}

Database URI may be overridden. E.g.:

LOGLEVEL=INFO PGURI="user=marco password=`cat ~/.pgsql-bfgdb-marco` database=bfgdb" ./bin/hemictl bfgdb version