example.md

# Examples of gcli commands for copy-paste

Useful when developing: replace `gcli` by `cargo run --` to build in debug mode and launch gcli.

## Configuration

It can be handful to use Gcli with a configuration file to avoid passing arguments on every command.

```sh
# show config commands
gcli config
# show where config file is stored
gcli config where
# save config to use gdev network for next commands
gcli --network gdev config save
# save config to use Alice predefined secret
gcli -S predefined -s Alice config save
# these can be combined
gcli --network local -S predefined -s test1 config save
```

In the following, we assume this last command was run.

## Commands

```sh
# get duniter current block
gcli blockchain current-block
# get balance of configured account
gcli account balance
# get identity information without indexer
gcli --no-indexer identity get -a 5Hn2LeMZXPFitMwrmrGucwtAPSLEiP4o5zTF7kHzMBtEkJUr 
# get information about test1 identity (needs indexer)
gcli identity get --username test1
# claim universal dividends
gcli ud claim
# transfer 5000 units
gcli account transfer 5000 5E4i8vcNjnrDp21Sbnp32WHm2gz8YP3GGFwmdpfg5bHd8Whb
```

## Indexer commands

You can check first that indexer is on the same network as Duniter node:

```sh
# check if indexer is on the same chain as duniter
gcli indexer check
```

The following commands uniquely relate with indexer.

```sh
# show latest indexer indexed block
gcli indexer latest-block
```