opm

Odyssey Plugin Manager (opm)

Note: This code is currently in Alpha. Proceed at your own risk.

opm is a command-line tool to manage virtual machines binaries for odysseygo.

opm allows users to build their own custom repositories to provide virtual machine and subnet definitions outside of the odyssey-plugins-core repository. odyssey-plugins-core is a community-sourced set of plugins and subnets that ships with the opm, but users have the option of adding their own using the add-repository command.

Installation

Pre-Built Binaries

Instructions

To download a binary for the latest release, run:

curl -sSfL https://raw.githubusercontent.com/DioneProtocol/opm/develop/scripts/install.sh | sh -s

The binary will be installed inside the ./bin directory (relative to where the install command was run).

Downloading binaries from the Github UI will cause permission errors on Mac.

To add the binary to your path, run

cd bin
export PATH=$PWD:$PATH

To add it to your path permanently, add an export command to your shell initialization script (ex: .bashrc).

Installing in Custom Location

To download the binary into a specific directory, run:

curl -sSfL https://raw.githubusercontent.com/DioneProtocol/opm/develop/scripts/install.sh | sh -s -- -b <relative directory>

Source

If you are planning on building from source, you will need golang >= 1.18.x installed.

To build from source, you can use the provided build script from the repository root.

./scripts/build.sh

The resulting opm binary will be available in ./build/opm.

Commands

add-repository

Starts tracking a plugin repository.

opm add-repository --alias DioneProtocol/core --url https://github.com/DioneProtocol/odyssey-plugins-core.git --branch develop

Parameters:

• --alias: The alias of the repository to track (must be in the form of foo/bar i.e organization/repository).
• --url: The url to the repository.
• --branch: The branch name to track.

install-vm

Installs a virtual machine by its alias. Either a partial alias (e.g spacesvm) or a fully qualified name including the repository (e.g DioneProtocol/core:spacesvm) to disambiguate between multiple repositories can be used.

If multiple matches are found (e.g repository-1/foovm, repository-2/foovm), you will be required to specify the fully qualified name of the virtual machine to disambiguate the repository to install from.

This will install the virtual machine binary to your odysseygo plugin path.

opm install-vm --vm spacesvm

Parameters:

• --vm: The alias of the VM to install.

join-subnet

Joins a subnet by its alias. Either a partial alias (e.g spaces) or a fully qualified name including the repository (e.g DioneProtocol/core:spaces) to disambiguate between multiple repositories can be used.

This will install dependencies for the subnet by calling install-vm on each virtual machine required by the subnet.

If multiple matches are found (e.g repository-1/foo, repository-2/foo), you will be required to specify the fully qualified name of the subnet definition to disambiguate the repository to install from.

opm join-subnet --subnet spaces

Parameters:

• --subnet: The alias of the VM to install.

list-repositories

Lists all tracked repositories.

opm list-repositories

uninstall-vm

Installs a virtual machine by its alias.

If multiple matches are found (e.g repository-1/foovm, repository-2/foovm), you will be required to specify the fully qualified name of the virtual machine to disambiguate the repository to install from.

This will remove the virtual machine binary from your odysseygo plugin path.

opm uninstall-vm --vm spacesvm

Parameters:

• --vm: The alias of the VM to uninstall.

update

Fetches the latest plugin definitions from all tracked repositories.

opm list-repositories

upgrade

Upgrades a virtual machine binary. If one is not provided, this will upgrade all virtual machine binaries in your odysseygo plugin path with the latest synced definitions.

For a virtual machine to be upgraded, it must have been installed using the opm.

opm upgrade

Parameters

• --vm: (Optional) The alias of the VM to upgrade. If none is provided, all VMs are upgraded.

remove-repository

Stops tracking a repository and wipes all local definitions from that repository.

opm remove-repository --alias organization/repository

Parameters:

• --alias: The alias of the repository to start tracking.

Setting up Credentials for a Private Plugin Repository

You'll need to specify the --credentials-file flag which contains your github personal access token.

Example token file:

username: joshua-kim (for GitHub, this field doesn't matter. You can use your username as a placeholder)
password: <personal access token here>

Example command to download a subnet's VMs from a private repository:

opm join-subnet --subnet=foobar --credentials-file=/home/joshua-kim/token