Clive Updates - Recurrent transfer and claim a new account token now available in CLI

The new release brings the possibility to use two new operations in CLI - recurrent transfer and claiming a new account token. We have also made some improvements regarding presenting Hive Power.

In TUI (text-based user interface) we have worked for consistency and corrected some issues (check the issue list at the bottom of the article). The major change from a user point of view is the change of binding - F6 is now used instead of F10. We start to work on Alarms but more about it in the next article.

Recurrent transfer

The recurrent_transfer_operation sends a specified amount to a receiver regularly, every frequency until repeat transfers are made.

Currently, only one recurrent transfer for a given receiver can be defined. As of HF 28, a user will be able to use pair-id to create more than one recurrent transfer to the same receiver.

The definition of recurrent transfer can be modified or removed before the last execution. The recurrent transfer can be defined in HIVE or HBD.

Please be aware that recurrent transfers are not supported by every exchange.

Creating recurrent transfer using CLI

A user may create a recurrent transfer using the command clive process transfer-schedule create.

In this release only creating recurrent transfer in HIVE is possible.

Notice that frequency can be defined using hH - hours, dD - days, and wW - weeks.

Before HF 28, the parameter pair-id should not be used – the transaction with specified pair-id will be rejected by the blockchain.

Example:

A user wants to define a recurrent transfer to guest4test4 with 0.001 HIVE. The transfer should be sent twice with 24 hours between transfers.

clive process transfer-schedule create --frequency 24h --repeat 2 --to guest4test4 --amount "0.001 hive" --sign alias1 --password alicealice

You can check the transaction here: https://explore.openhive.network/transaction/b595d33bfad8b774f149d9454acf2ecd954512be

Check the schedule of recurrent transfer

Information about currently ongoing recurrent transfers can be checked using the following command:

clive show transfer-schedule

Two tables will be shown, the first one containing information about defined recurrent transfers, and the second one a schedule of a maximum of 10 upcoming transfers.

Example:

clive show transfer-schedule

Modifying recurrent transfer using CLI

The currently ongoing recurrent transfer may be modified. You can modify:

• amount
• frequency
• repeat
• memo

Notice that if you change the frequency, the first execution after modification is update date + frequency.

The recurrent transfer may be modified by the command: clive process transfer-schedule modify.

Example:

A user wants to modify the frequency and repeat of the transfer. The frequency of a previously created recurrent transfer is 1d and this transfer will be executed one more time (“remaining” in the table above), a user wants to change the frequency to 1w and the repeat to 3.

clive process transfer-schedule modify --to guest4test4 --frequency 1w --repeat 3 --sign alias1 --password alicealice

clive show transfer-schedule

You can check the transaction here: https://explore.openhive.network/tx/90a0a3cd20a4ecf49f5f5cb02ccdf1b44ba0fe69

Removing recurrent transfer using CLI

The recurrent transfer may be removed by the command: clive process transfer-schedule remove.

In order to remove a recurrent transfer, the recurrent transfer operation with an amount of 0 is created.

Example:
A user wants to remove a recurrent transfer.

Claim a new account token

One of the possible ways to create an account for a new user in Hive is to use a pair of operations: claim_account_operation and create_claimed_account_operation.

Using the claim_account_operation a user may claim a new account token and pay for it with HIVE or Resource Credit (RC). After executing the operation claim_account_operation the user receives a new account token, but a new account is not created.

A new account token can be now claimed using CLI Clive.

Claim a new account token in CLI

A user can claim a new account token and pay for it using Hive or RC. If the fee is not specified, the RC is used by default.

The command description:

clive process claim new-account-token -h

Example:

A user claims a new account token, but does not specify the fee so it will be paid in RC. The user doesn’t broadcast the transaction (using –no-broadcast flag), because the account guest4test1 doesn’t have enough RC to execute the transaction.

clive process claim new-account-token --sign alias1 --password alicealice --no-broadcast

The number of available new account tokens can be checked with:

clive show new-account-token

TUI - Change of binding from F10 to F6

The changing of binding is not a huge change, but if you already use a Clive it may be confusing because we change one of the most important bindings.
The reason for that was that in some Linux terminals, the F10 conflicts with other keyboard shortcuts of the terminal itself.

Command schema

Complete list of corrected issues

More info about running Clive can be found here: Clive - alpha release. Please make sure you are using the most recent version: v1.27.5.11

TL;DR

docker run -ti hiveio/clive:v1.27.5.11

Your feedback is invaluable and always welcome.