The Keymaster
Last updated
Last updated
The Keymaster is a tool that is used to manage funds for Nomad Agent Wallets. Due to the sheer number of networks Nomad supports, and the necessity for having a unique set of keys for each home, managing funds and ensuring agents can continue to function quickly becomes difficult as the network of Nomad channels grows.
Example:
For 4 homes (alfajores, kovan, rinkeby, rinkarby) with 5 addresses each (kathy, watcher, updater, processor, relayer), this means there will be 20 unique addresses and each address has to be funded on each network resulting in 20 * 4 = 80 unique accounts across all networks which must be funded and topped up regularly.
Generalized: num_homes^2 * num_addresses
The Keymaster stores metadata about addresses, sources of funds, network RPC endpoints, and more to facilitate solving this problem.
Note: Before you do anything, call the Ghostbusters.
The Keymaster is a simple Python-based CLI program, the entrypoint is keymaster.py
Install the requirements via pip:
pip3 install -r requirements.txt
The Keymaster can be invoked via python3 like so:
Subcommands can be invoked by passing them as arguments to the CLI:
The Keymaster relies on a JSON configuration file, by default located at ./keymaster.json. You can pass a new path to the file using the --config-path argument.
An example can be found at ./keymaster-example.json and its contents are repeated here for convenience:
In the top-up command, The Keymaster will load the contents of this file and use it to dynamically query the configured accounts and determine if they need to be topped up.
