Files
ark/website/docs/user/noah-cli.md
Marco Argentieri 8371e9f1c2 rename dev_portal to website (#20)
* rename dev_portal to website

* rename dev_portal to website

* master not main
2023-11-29 00:35:10 +01:00

1.8 KiB

sidebar_position, title
sidebar_position title
2 Noah CLI

The Noah CLI allows you to interact with the Ark Service Provider (ASP). It is a command line tool that can be used to create and manage your Ark Wallet.

Configure the CLI

The noah CLI requires a set of variables to be set, use flags to set them.

noah config connect <ARK_URL>

Set up Noah wallet

noah init is a command that sets up a Noah wallet with a 32-bytes private key and a password in order to encrypt the private key.

noah init --password <PASSWORD> [--prvkey <PRIVATE_KEY>]

Receive VTXO

Get receiving address

You can use the noah CLI to print your Ark address. This can be used to receive VTXO.

noah receive

:::tip testnet only: noah faucet <AMOUNT> to receive newly created VTXO from the service provider. :::

Print balance

noah balance

balance returns the sum of all VTXOs belonging to the Noah wallet.

Send VTXO(s)

noah send --receivers '[{"to": "<ARK_ADDRESS", "amount": <AMOUNT>}, ...]'

Noah CLI is responsible to select the coins to send for the given amount. It will sync with the service provider to forfeit the VTXO(s) and create a new VTXO belonging to the recipient. A change VTXO will be created if needed. Asks user password before signing.

Redemption

Collaborative redemption

noah redeem --address <ONCHAIN_ADDRESS> --amount <AMOUNT>

Noah CLI will sync with the service provider in order to redeem onchain the given amount in the next round, any remaining change will become a new vTXO. Asks user password before signing.

Unilateral redemption

noah redeem --address <ONCHAIN_ADDRESS> --force

With the --force flag Noah CLI will unilateraly redeem all VTXOs by signing the psbt(s) and broadcast them. Asks user password before signing.