CLI Quick Start Guide

Hey, Powerian! Welcome to the Power DCloud CLI! This guide will help you get started with the tpe CLI to manage your decentralized applications and services on the Power DCloud platform.

Prerequisites

Node.js must be installed on your machine.
You must have access to terminal or command line interface.

Installation

Install the tpe CLI:

npm
Yarn
pnpm

npm install -g @thepowereco/cli

yarn global add @thepowereco/cli

pnpm add -g @thepowereco/cli

Verify the installation:
```
tpe --version
```
If the installation was successful, the command returns something like this:
```
@thepowereco/cli/1.11.131 darwin-arm64 node-v20.12.2
```

Getting Started

Account Management

Register a new account:
```
tpe acc register --chain 1 --password yourpassword --filePath /path/to/save_a_file.pem
```
Keys:
- --chain — a chain, where the account will be created,
- --password — password for a key file. Ensure, you've remembered it, otherwise you'll lose access to your account!
- --filePath — path to save account key file.
Note
Make sure you add .pem to your account key file.

If the account is created successfully, you'll get a message like:
```
Account registration... done
{
  "chain": 1,
  "wif": "ACCOUNT_WIF",
  "address": "ACCOUNT_ADDRESS",
  "seed": "SEED_PHRASE"
}
File saved at: /Users/usr/new_account_test.pem
```

Check wallet balance:

tpe acc get-balance --address YOUR_WALLET_ADDRESS

Send SK tokens:

tpe acc send-sk -a 100 -t RECIPIENT_ADDRESS -k /path/to/keyfile.pem --password yourpassword

Keys:

-a — amount to be sent,
-t — recipient address,
-k — path to your key file,
--password — your key file password.

If the command is successful, you'll get the following message:

Loading... done
{
  "txId": "2hcUb7e4QstfpX4W-c1n1.ed",
  "res": "ok",
  "block": "C67977213CF7C1BEE04935E047C8469FDA1111EA328DB4E93E58D442F1D65FB1"
}

Send tokens to contracts, without running EVM:
```
tpe acc send-sk -a 1 -k ./power_wallet_**_***.pem -t AA100002352165683776 -g NORUN -v 0
```
Keys:
- -a — amount to be sent,
- -t — recipient address,
- -k — path to your key file,
- -g - token used to pay for gas. NORUN means that EVM will not start,
- -v — gas value for deployment.

Container Management

Create a new container:
```
tpe container create --keyFilePath /path/to/keyfile.pem --password yourpassword --containerName "MyContainer"
```
Keys:
- keyFilePath — path to your key file,
- --password — your key file password,
- containerName — choose the name for your container.
If a container has been created successfully, you'll get the following message:
```
Loading... done
Container Container_test created with order ID: 9
Transaction: [TRANSACTION_LINK]
```

List your containers:

tpe container list --keyFilePath /path/to/keyfile.pem --password yourpassword

Keys:

keyFilePath — path to your key file,
--password — your key file password.

If the command is successful, you'll get the following message:

Loading... done
┌────┬────────────────┬─────────┬──────────────────────────────────────────────┬─────────────────────┬─────────────────┬──────────────────────┬───────────┐
│ Id │ Name           │ Status  │ Pubkey                                       │ Created             │ Active provider │ Handover To Provider │ Hold time │
├────┼────────────────┼─────────┼──────────────────────────────────────────────┼─────────────────────┼─────────────────┼──────────────────────┼───────────┤
│ 9  │ Container_test │ Pending │ CONTAINER_PUBLIC_KEY                         │ 16.07.2024 20:23:36 │ 0               │ 0                    │ 0         │
└────┴────────────────┴─────────┴──────────────────────────────────────────────┴─────────────────────┴─────────────────┴──────────────────────┴───────────┘

Upload files to a container:
```
tpe container upload --containerId CONTAINER_ID --keyFilePath /path/to/keyfile.pem --password yourpassword --filesPath /path/to/files
```
Keys:
- containerId — your container ID. You can
- keyFilePath — path to your key file,
- --password — your key file password.
Update your files in the container:
```
tpe container update -k ./key.pem -p mypassword -i 123 -n "New Container Name" -f ./containerKey.pem -s containerpassword
```
Keys:
- -k — path to the key file.
- -p — key file password.
- -i — container ID.
- -n — container name.
- -f — path to the container key file.
- -s — container key file password.
Perform container actions:
- container_start — start the container.
- container_stop — stop the container.
- container_destroy — destroy the container.
- container_handover — handover the container.
- container_getPort — get the container port.
- container_getLogs — get container logs.
```
tpe container actions -m "container_getPort" -p "1 web 5000" -f ./path/to/keyfile.pem -s mypassword
```
Keys:
- -m — action (method),
- -p — action parameters,
- -f — path to container key file,
- -s — container password.

Smart Contract Management

Deploy a smart contract:
```
tpe contract deploy --abiPath /path/to/contract.abi --binPath /path/to/bin --keyFilePath /path/to/keyfile.pem --password yourpassword
```
Keys:
- --abiPath — path to contract .abi file. Please, refer to Create and prepare a smart contract section for more information,
- --binPath — path to contract .bin file. Please, refer to Create and prepare a smart contract section for more information,
- --keyFilePath — path to your account key file. Please, refer to Account Management section of this document,
- --password — your account password.
Call a method on a deployed contract:
```
tpe contract get --abiPath /path/to/contract.abi --address CONTRACT_ADDRESS --method METHOD_NAME --params "param1 param2"
```
Keys:
- --abiPath — path to contract .abi file. Please, refer to Create and prepare a smart contract section for more information,
- --address — your deployed contract address,
- --method — method you'd like to call,
- --params — method parameters.
Execute a method on a smart contract:
```
tpe contract set --abiPath /path/to/abi.json --address CONTRACT_ADDRESS --keyFilePath /path/to/keyfile.pem --method METHOD_NAME --params "param1 param2" --password yourpassword
```
Keys:
- --abiPath — path to contract .abi file. Please, refer to Create and prepare a smart contract section for more information,
- --address — your deployed contract address,
- --keyFilePath — path to your account key file. Please, refer to Account Management section of this document,
- --method — method you'd like to call,
- --params — method parameters,
- --password — your account password.

Storage Management

Upload application files to storage:

tpe storage upload --configPath /path/to/config.json

List storage tasks:

tpe storage tasklist --configPath /path/to/config.json

Provider management

Create a new provider with a given name and key pair:
```
tpe provider create -k ./key.pem -p mypassword -n "NewProvider" -s containerpassword
```
Keys:
- -a — provider smart contract address,
- -k — path to your key file,
- -n — provider name,
- -p — key file password,
- -r — sponsor address.
List all providers or filter by key file or address:
```
tpe provider list -k ./key.pem -p mypassword
```
Keys:
- -a — provider smart contract address,
- -k — key file password,
- -o — order smart contract address,
- -p — key file password,
- -r — filter by address.
Set or update the URL for a specific provider using the provider ID.

note
Requires a key file for authentication.
```
tpe provider set-url -k ./key.pem -p mypassword -i 123 -u "https://provider.example.com"
```
Keys:
- -a — order smart contract address,
- -i — provider ID,
- -k — path to the key file,
- -p — key file password,
- -r — sponsor address,
- -u — provider URL.

Additional Commands

View all available commands:
```
tpe help
```
Update the tpe CLI:
```
tpe update
```
Display autocomplete installation instructions:
```
tpe autocomplete [SHELL] [-r]
```
where
- [SHELL] — shell type (zsh, bash, or powershell)
- -r — refresh cache. This option ignores displaying instructions.

CLI Quick Start Guide

Prerequisites​

Installation​

Getting Started​

Account Management​

Container Management​

Smart Contract Management​

Storage Management​

Provider management​

Additional Commands​