Rust Testing Interface

The Rust testing interface (RTI) is a simple way to perform some actions on the Entropy network directly from the command line. The RTI is intended for testing Entropy Core functionality.

Limitations

Actions like deploying a program or storing accounts aren’t possible through this interface. Developers looking for a fully featured command-line interface should see the Entropy CLI.

⚠️

No Secure Key Storage: This CLI has no secure private key storage and is only intended for use with test networks. Do not use this interface in a production environment. If you want a fully featured interface, check out the Entropy CLI.

Installation

We’ve made installing this CLI straightforward by using Rust’s Cargo crate manager.

Prerequisites

To run this CLI, you need to:

Install the OpenSSL and pkg-config packages:

brew install openssl pkg-config

sudo apt install libssl-dev pkg-config

Ensure that the latest stable release of Rust is installed:

# Any Unix-based operating system:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Install the CLI

The easiest way to install this CLI is to use the pre-built crate through Cargo:

cargo install entropy-test-cli

Updating crates.io index
Downloaded entropy-test-cli v0.1.0

...

Installed package `entropy-test-cli v0.1.0` (executable `entropy-test-cli`)

Environment variables

You can use the following environment variables to make using this CLI easier:

Variable	Description	Example
`ENTROPY_MNEMONIC`	The mnemonic of the account you’d like to use when interacting with this CLI.	`ENTROPY_MNEMONIC='choice square dance because into glance hazard return cram host snap deer'`
`ENTROPY_DEVNET`	The specific chain-endpoint you want to use when interacting with this CLI.	`ENTROPY_DEVNET='wss://testnet.entropy.xyz'`

Usage

You can use this CLI to register an account with the network, display a list of registered accounts, ask the network to sign a message, store a program on the network, and update a program that you stored on the network.

Register

Usage

entropy-test-cli register <MNEMONIC> [KEY_VISIBILITY] [PROGRAMS]

Example

entropy-test-cli --chain-endpoint="wss://testnet.entropy.xyz" register "image point raccoon steak champion clown adult until hamster sun army year"

Status

Display a list of registered Entropy accounts.

Usage

entropy-test-cli status

Example

entropy-test-cli --chain-endpoint="wss://testnet.entropy.xyz" status

Sign

Ask the network to sign a given message.

Usage

entropy-test-cli sign <SIGNATURE_VERIFYING_KEY> <MESSAGE> [AUXILARY_DATA]

Example

entropy-test-cli --chain-endpoint="wss://testnet.entropy.xyz" sign "0x1ca639d1cae8ea4e4bd37f972999e0e140866614b621bc09950ceb469b987e27" "Good morning."

Store program

Store a given program on-chain.

Usage

entropy-test-cli store-program <MNEMONIC> [PROGRAM_FILE] [CONFIG_INTERFACE_FILE] [AUX_DATA_INTERFACE_FILE]

Example

entropy-test-cli --chain-endpoint="wss://testnet.entropy.xyz" store-program "image point raccoon steak champion clown adult until hamster sun army year" ./program.wasm ./interface-file.config ./aux-data.config

Update programs

Update the program for a particular account.

Usage

entropy-test-cli update-programs <SIGNATURE_VERIFYING_KEY> <MNEMONIC> [PROGRAMS]

Example

entropy-test-cli --chain-endpoint="wss://testnet.entropy.xyz" update-programs "0x1ca639d1cae8ea4e4bd37f972999e0e140866614b621bc09950ceb469b987e27" "image point raccoon steak champion clown adult until hamster sun army year" ./programs

Networks Tools