It is possible to provision a local "network" consisting of a single validator node. This may be useful for specific development use cases.
Before proceeding, make sure to look at the prerequisites required for running an Oasis Core environment followed by build instructions for the respective environment (non-SGX or SGX). The following sections assume that you have successfully completed the required build steps.
These instructions are for a development-only instance, do not use them for setting up any kind of production instances as they are unsafe and will result in insecure configurations leading to node compromise.
Provisioning an Entity
To provision an entity we first prepare an empty directory under /path/to/entity and then initialize the entity:
This enables unsafe debug-only flags which must never be used in a production setting as they may result in node compromise.
Using the Node CLI
The oasis-node exposes an RPC interface via a UNIX socket located in its data directory (e.g., under /path/to/node/internal.sock). To simplify the following instructions set up an ADDR environment variable pointing to it:
This can then be used to execute CLI commands against the running node (in a separate terminal). For example to show all registered entities: