Accumulate
Search…
CLI Reference
The Accumulate Command Line Interface (CLI) Tool allows users to interact with the Accumulate Network. The CLI Tool allows for a variety of operations, such as creating accounts, building transactions, and managing key books.
By default, the Command-Line Interface connects to the dedicated testnet server, but you can manually connect to a different server with -s
If you'd like to connect to a specific testnet server, you can find a list of the available servers in the Networks.go file. Or you can use the public testnet server: https://testnet.accumulatenetwork.io/v1.

Basic commands and flags

1
$ ./accumulate
Copied!
1
CLI for Accumulate Network
2
3
Usage:
4
accumulate [command]
5
6
Available Commands
7
account Create and get token accounts
8
adi Create and manage ADI
9
auth Manage authorization of an account
10
blocks Create and get blocks
11
book Manage key books for a ADI chains
12
completion Generate the autocompletion script for the specified shell
13
credits Purchase credits with acme and send to recipient.
14
data Create, add, and query adi data accounts
15
faucet Get tokens from faucet
16
get Get data by URL
17
help Help about any command
18
key Create and manage Keys for ADI Key Books, and Pages
19
oracle Send credits to a recipient
20
page Create and manage Keys, Books, and Pages
21
token Issue and get tokens
22
tx Create and get token txs
23
validator Manage validators
24
version get version of the accumulate node
25
26
Flags:
27
--authority strings Additional authorities to add when creating an account
28
-d, --debug Print accumulated API calls
29
-h, --help help for accumulate
30
-j, --json print outputs as json
31
-m, --memo string Memo
32
-a, --metadata string Transaction Metadata
33
--no-wait Don't wait for the transaction to complete
34
-n, --pretend Enables check-only mode for transactions
35
--prove Request a receipt proving the transaction or account
36
-s, --server string Accumulated server (default "https://testnet2.accumulatenetwork.io/v2")
37
-t, --timeout duration Timeout for all API requests (i.e. 10s, 1m) (default 5s)
38
-w, --wait duration Wait for the transaction to complete
39
40
Use "accumulate [command] --help" for more information about a command.
Copied!

Account

Create and get lite identities and token accounts
1
$ ./accumulate account
Copied!
1
Usage:
2
accumulate account [command]
3
4
Available Commands:
5
create Create an account
6
generate Generate random lite token account
7
get Get an account by URL
8
list Display all lite token accounts
9
qr Display QR code for lite account URL
10
restore Restore old lite token accounts
11
12
Flags:
13
-h, --help help for account
14
15
Global Flags:
16
-d, --debug Print accumulated API calls
17
-j, --json print outputs as json
18
-n, --pretend Enables check-only mode for transactions
19
--prove Request a receipt proving the transaction is in a block
20
-s, --server string Accumulated server (default "https://testnet.accumulatenetwork.io/v2")
21
-t, --timeout duration Timeout for all API requests (i.e. 10s, 1m) (default 5s)
Copied!
Account generate
Generate random Lite Identity and ACME Lite Token Account
1
Usage:
2
accumulate account generate
Copied!
Example of usage:
1
$ ./accumulate account generate
2
name : ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346
3
lite account : acc://ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346/ACME
4
public key : 03b3a92f65e9cd940010af8c438dd2354e5764a1409cbe09626b6264a195f933
5
key type : ed25519
Copied!
Get Lite Token Account by URL
1
Usage:
2
accumulate account get [url]
Copied!
Example of usage:
1
$ ./accumulate account get acc://ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346/ACME
Copied!
1
Account Url : acc://ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346/ACME
2
Token Url : acc://ACME
3
Balance : 2000000.00000000 ACME
4
Credits : 0
5
Last Used On : 1969-12-31 19:00:00 -0500 EST
Copied!
Get Lite Identity by URL
1
$ ./accumulate account get ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346
Copied!
Example of usage:
1
./accumulate get ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346
2
3
ADI Entries: start = 0, count = 10, total = 1
4
acc://ecd9d73a0b8451cebfb69eef2ff0fb5f89ccb36d10dda346/ACME (Lite Account)
Copied!

Account list

Display all lite token accounts
1
Usage:
2
accumulate account list
Copied!
Example of usage:
1
$ ./accumulate account list
2
3
name : acc://001846c0a1590675fd0ad816ab4873387ef127cd9b307c24/ACME
4
lite account : acc://001846c0a1590675fd0ad816ab4873387ef127cd9b307c24/ACME
5
public key : 3615e429b89fa3d6b636412d7a17b13cc321c14b2f2e5bf520868c9617401845
6
key type : legacyED25519
7
8
name : acc://003df7b8b865b3eda520dbb224eaf7536ee98cc25874ce54/ACME
9
lite account : acc://003df7b8b865b3eda520dbb224eaf7536ee98cc25874ce54/ACME
10
public key : 45090e7cfa0edd52db7181fa0a30f1da8d2c0b1bdc6b4847de75fe922ad9e755
11
key type : ed25519
Copied!

Account QR

Display QR code for lite account URL
1
Usage:
2
accumulate account qr [url]
Copied!
Example of usage:
1
$ ./accumulate.exe account qr acc://f5a2c0416599ae08f264d1f55779540037bb7b8c85fe6bf5/ACME
2
█████████████████████████████████████
3
██ ▄▄▄▄▄ █▀ ▀█ ▄█▀ ▄ █ ▄█ ▄▄▄▄▄ ██
4
██ █ █ ██ ▀█▄▀█ ██▄▀▄█ ▀▀█ █ █ ██
5
██ █▄▄▄█ █▄▄▀▀▄▀▀██ █ █▀▄ ▄█ █▄▄▄█ ██
6
██▄▄▄▄▄▄▄█▄▀ █▄▀ █ ▀▄█▄▀ █▄█▄▄▄▄▄▄▄██
7
██ ▀▄▀▄▀▄███▄ ▄▄ ▄ ███ ███▀▀▄▀█▄▀██
8
████▀▄▄▄▄ ██▀▄▀▄█▀█▀▀▀▀ ▀▄█ ██▄██ ██
9
██ ▄▄▄ ▄▄▀█▀▄ ███▀▄ ▄█ █ █ █▀▀ ██
10
██ ▄█▄█▄ ▀▄ █ ▀▀ ██ ██▀▄▄▀▄ ▄▄▄██
11
███▀▄▄▄█▄█▄ ██ ▀▀██▄ █ ▄ ██ ██ ██ ██
12
██▀▀▄ ██▄ ▄█▄▄▀█▀ ▀▀█▀▄██▄ ▄▀ ██ ██
13
██▄██▄▄ ▄▄▄█ ▀ ▀ ▀███ ██ █▄█ ██
14
██▄▀▄ ▄█▄▀▄ ▄▀█▀▀ ▄▀▀▀▀█▄█▄▀▄ ▄▄ ██
15
██▄█▄█▄█▄█▀▀ ▀ ▀▄ █ ▀ ▄▄▄ ▀█▀██
16
██ ▄▄▄▄▄ ███ ▄█ ▄▀ ▀ ▀█▀▀▄ █▄█ ▀██▄██
17
██ █ █ █▄▄ ▄▄█▀ ▀█▄ ▄█▀ ▄ ██▄ ██
18
██ █▄▄▄█ █▄▄▀▀█████ ██ ▀ ▀ ██ ▀▄▀▄██
19
██▄▄▄▄▄▄▄█▄▄▄█▄████▄▄██▄▄▄▄██▄█▄█▄▄██
20
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Copied!

Account Create (ADI Token Account)

Create a token account for an ADI
1
Usage:
2
accumulate account create token [origin adi] [signing key name] [key index (optional)] [key height (optional)] [new token account url] [tokenUrl] [keyBookUrl]
Copied!
Example of usage:
1
$ ./accumulate.exe account create token ADITEST key11 ADITEST/TOKENS acc://ACME acc://ADITEST/book0
2
Transaction Id : 9219c4aa063dbd4ad9a5ee02f3cca6e6445672a6f3b743aa6085239609b61d4a
3
Tendermint Reference : 9616826054dcc07d81e636ed185159249c0777ff27bf52ddae947371e0537f3d
4
Error code : ok
5
Error : CheckTx
Copied!

Account Create (ADI Data Account)

Create a data account under an ADI
1
Usage:
2
accumulate account create data [origin adi] [signing key name] [key index (optional)] [key height (optional)] [new data account url] [keyBookUrl]
Copied!
Example of usage:
1
$ ./accumulate.exe account create data ADITEST key11 ADITEST/DATA acc://ADITEST/book0
2
Transaction Id : b9807394c46d41bcdb5fa6d500624fdb6a2832b50a34cd159c7d5d026584df38
3
Tendermint Reference : aa090d8f31b863a5a0b5e313e4e6ab698b4a8762f1f16a6d24f673ccb501dc63
4
Error code : ok
5
Error : CheckTx
Copied!

ADI

Create an Accumulate Digital Identifier. The Accumulate network is managed by an enhanced version of Distributed Digital Identities and Identifiers (DDIIs) that we refer to as Accumulate Digital Identifiers (ADIs).
1
$ ./accumulate.exe adi
Copied!
1
Usage:
2
accumulate adi [command]
3
4
Available Commands:
5
create Create new ADI
6
directory Get directory of URL's associated with an ADI with starting index and number of directories to receive
7
get Get existing ADI by URL
8
list Get existing ADI by URL
9
10
Flags:
11
-h, --help help for adi
12
13
Global Flags:
14
-d, --debug Print accumulated API calls
15
-j, --json print outputs as json
16
-n, --pretend Enables check-only mode for transactions
17
--prove Request a receipt proving the transaction is in a block
18
-s, --server string Accumulated server (default "https://testnet.accumulatenetwork.io/v2")
19
-t, --timeout duration Timeout for all API requests (i.e. 10s, 1m) (default 5s)
Copied!

ADI create (Create New ADI from Lite Account)

1
Usage:
2
accumulate adi create [actor-lite-account] [adi url to create] [public-key or wallet key label] [key-book-name (optional)] [key-page-name (optional)] Create new ADI from lite account
Copied!
Example of usage:
1
$ ./accumulate.exe adi create acc://68fe2628a354d44ab349b08566ac35139a22b9896b1eff0d/ACME ADITEST key1234 ADIKEYBOOK1 ADIKEYPAGE1
2
2021/11/18 14:42:59
3
Transaction Identifier : 48217eb91f3a75fe22beddfba5166a34661d2dfd9b7ae222e8dccbe5be7ce310
4
Tendermint Reference : df2d36bfbfeaa5b42307bad269d163c18dbd710c2c961194728e16b93664a387
5
Error code : ok
Copied!

ADI create (Create new ADI for another ADI)

1
Usage:
2
accumulate adi create [actor-adi-url] [wallet signing key label] [key index (optional)] [key height (optional)] [adi url to create] [public key or wallet key label] [key book url (optional)] [key page url (optional)] Create new ADI for another ADI
Copied!
Example of usage:
1
$ ./accumulate.exe adi create ADITEST key1234 0 1 ADITEST2 key5678 ADIKEYBOOK2 ADIKEYPAGE2
2
2021/11/19 14:50:30
3
Transaction Identifier : c6f0b82a557fe1e3c77484c188aa2978a7a5974bc7252fe33eb5577fabd4a290
4
Tendermint Reference : 1e47824134f333f8d3d0b9d84a413583a57ba3d9cede00d53462c58fb0e9f9ef
5
Error code : ok
Copied!

ADI directory

Get directory of URL's associated with an ADI with starting index and number of directories to receive
1
$ ./accumulate.exe adi directory
Copied!
1
Usage:
2
accumulate adi directory [url] Get directory of sub-chains associate with a URL
Copied!
Example of usage:
1
$ ./accumulate.exe adi directory ADITEST
2
ADI Entries
3
acc://ADITEST1/ssg0 (Key Book)
4
acc://ADITEST1/sigspec0 (Key Page)
Copied!

ADI get

Get existing ADI by URL
1
Usage:
2
accumulate adi get [URL]
Copied!
Example of usage:
1
ADI Url : acc://ADITEST
2
Key Book Url : acc://ADITEST/keybook1
Copied!

ADI list

Get existing ADI list
1
Usage:
2
accumulate adi list
Copied!
Example of usage:
1
acc://ADITEST1 : key11
2
acc://adione : key61
3
acc://aditwo : key51
4
acc://aditthree : key61
Copied!

Book

1
$ ./accumulate.exe book
Copied!
1
Usage:
2
accumulate book get [URL] Get existing Key Book by URL
3
accumulate book create [actor adi url] [signing key name] [key index (optional)] [key height (optional)] [new key book url] [key page url 1] ... [key page url n + 1] Create new key book and assign key pages 1 to N+1 to the book
Copied!
Example usage:
1
accumulate book create acc://RedWagon redKey5 acc://RedWagon/RedBook acc://RedWagon/RedPage1
Copied!
Get Key Book
Get existing Key Book by URL
1
Usage:
2
accumulate key get book [URL]
Copied!
Example of usage:
1
$ ./accumulate.exe get ADITEST/ADIKEYBOOK1
2
Height Key Page Url
3
1 : acc://ADITEST/ADIKEYBOOK1
Copied!
Key Book Create
1
Usage:
2
accumulate key book create [actor adi url] [signing key label] [key index (optional)] [key height (optional)] [new key book url] [key page url 1] ... [key page url n] Create new key page with 1 to N public keys
Copied!
Example of usage:
1
$ ./accumulate.exe key book create ADITEST key1234 1 1 ADITEST/KEYBOOK1.1 ADITEST/KEYPAGE1.1 ADITEST/KEYPAGE1.2 ADITEST/KEYPAGE1.3
2
Transaction Identifier : dd351321ca42568b9cc7e3a8faa88481e0e7e6759f4fd6b3976950b74865623a
3
Tendermint Reference : 71d231c0645a74c7ea21347bdcb54610e946f8a99eff0f48562634c14a928e27
4
Error code : ok
Copied!

Completion

1
Usage:
2
Generate the autocompletion script for accumulate for the specified shell. See each sub-command's help for details on how to use the generated script.
Copied!
1
$ ./accumulate.exe completion
Copied!
1
Available Commands:
2
bash generate the autocompletion script for bash
3
fish generate the autocompletion script for fish
4
powershell generate the autocompletion script for powershell
5
zsh generate the autocompletion script for zsh
6
7
Flags:
8
-h, --help help for completion
9
10
Global Flags:
11
-d, --debug Print accumulated API calls
12
-j, --json print outputs as json
13
-n, --pretend Enables check-only mode for transactions
14
-s, --server string Accumulated server (default "http://localhost:35554/v1")
15
-t, --timeout duration Timeout for all API requests (i.e. 10s, 1m) (default 5s)
16
17
Use "accumulate completion [command] --help" for more information about a command.
Copied!

Credits

Send credits using a lite account or adi key page to another lite account or adi key page
1
$ ./accumulate.exe credits
Copied!
1
Usage:
2
accumulate credits [origin lite account] [lite account or key page url] [amount]
3
Send credits using a lite account or adi key page to another lite account or adi key page
4
accumulate credits [origin url] [origin key name] [key index (optional)] [key height (optional)] [key page or lite account url] [amount]
5
Send credits to another lite account or adi key page
Copied!
Example of usage:
1
$ ./accumulate.exe credits acc://5a48d2999da25641db06a8e4baf54a275bfc6ed90cbcd21a/ACME acc://53948aeb1cda7cf854c6ec3104a66e336d26be1ad1790bb7/ACME 100
2
2021/12/02 20:58:43
3
Transaction Identifier : 4f8e7f98d0da08b1a3731f4a20e92e5a0a82f1b42e84958aff0eecc122d363af
4
Tendermint Reference : dfd9d4b558c3abe05b93aa79f3e61190b180778269e37094d01ce1c4f48a354f
5
Error code : ok
Copied!

Data

1
$ ./accumulate.exe data
Copied!
1
accumulate account create data [actor adi url] [signing key name] [key index (optional)] [key height (optional)] [adi data account url] [key book (optional)]
2
Create new data account
3
example usage: accumulate account create data acc://actor signingKeyName acc://actor/dataAccount acc://actor/book0
4
5
accumulate account create data lite [lite token account] [name_0] ... [name_n]
6
Create new lite data account creating a chain based upon a name list
7
accumulate account create data lite [origin url] [signing key name] [key index (optional)] [key height (optional)] [name_0] ... [name_n]
8
Create new lite data account creating a chain based upon a name list
9
example usage: accumulate account create data lite acc://actor signingKeyName example1 example2
10
accumulate data get [DataAccountURL]
11
Get existing Key Page by URL
12
accumulate data get [DataAccountURL] [EntryHash]
13
Get data entry by entryHash in hex
14
accumulate data get [DataAccountURL] [start index] [count] expand(optional)
15
Get a set of data entries starting from start and going to start+count, if "expand" is specified, data entries will also be provided
16
accumulate data write [data account url] [signingKey] [extid_0 optional)] ... [extid_n (optional)] [data]
17
Write entry to your data account. Note: extid's and data needs to be a quoted string or hex
18
accumulate data write-to [account url] [signing key] [lite data account] [extid_0 (optional)] ... [extid_n (optional)] [data]
Copied!

Create Data Account

Create new data account
1
Usage:
2
accumulate account create data [origin adi] [signing key name] [key index (optional)] [key height (optional)] [adi data account url] [keyBookUrl]
Copied!
Example of usage:
1
$ ./accumulate.exe account create data ADITEST key11 ADITEST/DATA acc://ADITEST/book0
2
Transaction Id : b9807394c46d41bcdb5fa6d500624fdb6a2832b50a34cd159c7d5d026584df38
3
Tendermint Reference : aa090d8f31b863a5a0b5e313e4e6ab698b4a8762f1f16a6d24f673ccb501dc63
4
Error code : ok
5
Error : CheckTx
Copied!

Create Data Lite Account

Create new lite data account creating a chain based upon a name list
1
Usage:
2
accumulate account create data lite [lite token account] [name_0] ... [name_n]
Copied!
Example of usage:
1
$ ./accumulate.exe account create data lite acc://acf81a8d470f0ac2a085b4159da659ccf3a25681ab5f8257/ACME k01 k02
2
Account Url :acc://0401cc2a360c4685095bac0c751e3b2a6590c4663a46c33a
3
4
Account Id :0401cc2a360c4685095bac0c751e3b2a6590c466b33f63b9028f50d90c9fd13c
5
Entry Hash :a61b9a70ae0a12ac3c3ee5c2f3085be2e77848e6d2dcc0759ae94bd46a6ab1b6
6
Transaction Hash : c6736b1f4bd11e4b546e2a1adef7e9c54256d6e3764a7a9d53eedc60bfa4d3db
7
Envelope Hash : f80afa894e57472cfe395988705a3475c6f9c215f0ed43686db48294c9efb9b4
8
Simple Hash : 87cf3322eb18fd6ab2ea53f06287cd478e4e16d6ca33c9474b632816c3ed29a1
9
Error code : ok
Copied!

Get Data

Get existing Key Page by URL
1
Usage:
2
accumulate data get [DataAccountURL]
Copied!
Example of usage:
1
$ ./accumulate.exe data get acc://ADITEST/DATA
2
{
3
"type":"dataEntry",
4
"merkleState":{
5
"count":2,
6
"roots":[
7
null,
8
"87c5cc4a4f86accac328b5773c3e6fe29e8af23cbaa5a14f154011e2e71af4d2"
9
]
10
},
11
"data":{
12
"entry":{
13
"data":"61646974776f64617461"
14
},
15
"entryHash":"b45fa53718dbc5bf31f2f6134d1ff84fe22b3760face9c2ab012fd66d16d1808"
16
}
17
}
Copied!

Get Data (entry hash)

Get data entry by entryHash in hex
1
Usage:
2
accumulate data get [DataAccountURL] [EntryHash]
Copied!
Example of usage:
1
$ ./accumulate.exe data get acc://ADITEST/DATA b45fa53718dbc5bf31f2f6134d1ff84fe22b3760face9c2ab012fd66d16d1808
2
{
3
"type":"dataEntry",
4
"merkleState":{
5
"count":2,
6
"roots":[
7
null,
8
"87c5cc4a4f86accac328b5773c3e6fe29e8af23cbaa5a14f154011e2e71af4d2"
9
]
10
},
11
"data":{
12
"entry":{
13
"data":"61646974776f64617461"
14
},
15
"entryHash":"b45fa53718dbc5bf31f2f6134d1ff84fe22b3760face9c2ab012fd66d16d1808"
16
}
17
}
Copied!

Get Data (start & count)

Get a set of data entries starting from start and going to start+count, if "expand" is specified, data entries will also be provided
1
Usage:
2
accumulate data get [DataAccountURL] [start index] [count] expand(optional)
Copied!
Example of usage:
1
$ ./accumulate.exe data get acc://ADITEST/DATA 0 1
2
{
3
"type":"dataEntry",
4
"merkleState":{
5
"count":2,
6
"roots":[
7
null,
8
"87c5cc4a4f86accac328b5773c3e6fe29e8af23cbaa5a14f154011e2e71af4d2"
9
]
10
},
11
"data":{
12
"entry":{
13
"data":"61646974776f64617461"
14
},
15
"entryHash":"b45fa53718dbc5bf31f2f6134d1ff84fe22b3760face9c2ab012fd66d16d1808"
16
}
17
}
Copied!

Data Write

Write entry to your data account.
1
Usage:
2
accumulate data write [data account url] [signingKey] [extid_0 optional)] ... [extid_n (optional)] [data]
Copied!
Example of usage:
1
$ ./accumulate.exe data write acc://ADITEST/DATA key61 "testdata"
2
Entry Hash : b45fa53718dbc5bf31f2f6134d1ff84fe22b3760face9c2ab012fd66d16d1808
3
Transaction Id : 513050cc0fb5459a27f7fd1661656d5c5b7fe3879740d51aabab0e072a0bb857
4
Tendermint Reference : 76821f50a8fa63fe6d74263754ad0c728003466d14822686963b604731225907
5
Error code : ok
6
Error : CheckTx
Copied!

Data Write-To

Write entry to your data account.
1
Usage:
2
accumulate data write-to [account url] [signing key] [lite data account] [extid_0 (optional)] ... [extid_n (optional)] [data]
Copied!
Example of usage:
1
$ ./accumulate.exe data write-to acc://ADITEST key61 acc://08aecb75d3025d00bdc899e0ae675a6f03afc89d83e88879 testdata
2
Account Url : acc://08aecb75d3025d00bdc899e0ae675a6f03afc89d83e88879
3
Account Id : 08aecb75d3025d00bdc899e0ae675a6f03afc89dde9836db705242e5b3355cce
4
Entry Hash : 89b9534d62d826478abb26cf53315dcefb49805471d226049ac1076f9269e6d1
5
Transaction Hash : 992af3be5221b8edca8b0252620f11d6b86720a9d5c005656d1f49a673ecac69
6
Envelope Hash : afd6e529c7c215b15730270113b77f770d351d6d1444bbff0b181a8d454235ee
7
Simple Hash : 8e3fec17b992b01b4bc69e54a097a8b62ed6dabca9021fcc64ccadeb40abcf33
8
Error code : ok
Copied!

Faucet

Faucet sends some TestNet ACME tokens to the requested anonymous token account.
1
$ ./accumulate.exe faucet
Copied!
1
Usage:
2
faucet [url] Get tokens from faucet to address
Copied!
Example of usage:
1
$ ./accumulate.exe faucet acc://3ed6b2003242d2166508e117a2a66f8ca742b72e8d90d736/ACME
2
Transaction Identifier : b72669697b6641f71595df9df0381599fdff5429171772d9f79e75533b7e5f57
3
Tendermint Reference : 36fde0e08fec2b123e8eb1876827d60be237e8b7c15ddb1505f4091bd4cba284
4
Error code : ok
Copied!

Help

CLI Help
1
$ ./accumulate.exe help
Copied!
1
CLI for Accumulate Network
2
3
Usage:
4
accumulate [command] [flags]
5
6
Available Commands
7
account Create and get token accounts
8
adi Create and manage ADI
9
book Manage key books for a ADI chains
10
completion generate the autocompletion script for the specified shell
11
credits Send credits to a recipient
12
data Create, add, and query adi data accounts
13
faucet Get tokens from faucet
14
get Get data by URL
15
help Help about any command
16
key Create and manage Keys for ADI Key Books, and Pages
17
page Create and manage Keys, Books, and Pages
18
token Issue and get tokens
19
tx Create and get token txs
20
version get version of the accumulate node
21
22
Flags:
23
-d, --debug Print accumulated API calls
24
-h, --help help for accumulate
25
-j, --json print outputs as json
26
-n, --pretend Enables check-only mode for transactions
27
-s, --server string Accumulated server (default "https://testnet.accumulatenetwork.io/v1")
28
-t, --timeout duration Timeout for all API requests (i.e. 10s, 1m) (default 5s)
29
30
Use "accumulate [command] --help" for more information about a command.
Copied!

Key

Managed the Keys, Key Pages, and Key Book for your Accumulate Digital
1
$ ./accumulate.exe key
Copied!
1
Usage:
2
accumulate key generate [key name] Generate a new key and give it a name in the wallet
3
accumulate key list List generated keys associated with the wallet
4
accumulate key import mnemonic [mnemonic phrase...] Import the mneumonic phrase used to generate keys in the wallet
5
accumulate key import private [private key hex] [key name] Import a key and give it a name in the wallet
6
accumulate key import lite [private key hex] Import a key as an anonymous address
7
accumulate key export all export all keys in wallet
8
accumulate key export private [key name] export the private key by key name
9
accumulate key export mnemonic export the mnemonic phrase if one was entered
10
accumulate key export seed export the seed generated from the mnemonic phrase
Copied!
Key Generation
1
Usage:
2
accumulate key generate [label] Generate a new key and give it a label in the wallet
Copied!
Example of usage:
1
$ ./accumulate.exe key generate key1234
2
key1234 : e7f1541f7460fc38ef8ffeb5d483415074d68621b004614209d3d461d7abee12
Copied!
Key List
1
Usage:
2
accumulate key list List generated keys associated with the wallet
Copied!
Example of usage:
1
$ ./accumulate.exe key list
2
Public Key Key name
3
e7f1541f7460fc38ef8ffeb5d483415074d68621b004614209d3d461d7abee12 key1234
Copied!
Key Import Mnemonic
1
Usage:
2
accumulate key import mnemonic [mnemonic phrase...] Import the mnemonic phrase used to generate keys in the wallet
Copied!
Example of Usage:
1
$ ./accumulate.exe key mnemonic humor demand lesson identify rookie road truth beef benefit thank camera tumble
2
Mnemonic imported
Copied!
Key Import Private Key
1
Usage:
2
accumulate key import private [private key hex] [key name] Import a key and give it a name in the wallet
Copied!
Example of Usage:
1
$ ./accumulate.exe key import private c25288e8262fc23a5e8fc3acd523428b6913d05166f47022abef52acdba47930 benkey4
2
name :benkey4
3
public key :d5b57f10eb85a751094fcf943fc4997e45f0a90955294ca99cc5ee298d301690
Copied!
Key Import Lite
1
Usage:
2
accumulate key import lite [private key hex] Import a key as an anonymous address
Copied!
Example of Usage:
1
$ ./accumulate.exe key import lite 52693a08f2511ecd05b41e0ea6e6b6f2b7dee4248293b8c4ae9e4aacb8f3ae54
2
name :acc://4111d56848824a2d74ee93e2c42091f7019a87c7649b48fe/ACME
3
public key :76324e43a382e6ff6a9724f8dae137b93f5d5a61a3eb9d6e5213739b656c5d44
Copied!
Key Export All
1
Usage:
2
accumulate key export all export all keys in wallet
Copied!
Example of usage:
1
$ ./accumulate.exe key export all
2
name : key101
3
private key : 23ab78aa778b044045e8287aca3347fe4e04d5060c5dbeb214661ef0bf2eec89
4
public key : e086e27ff0bb5b146b6bdf55c8273211ddb62c684923502e22ef9d2d8b9a9ad5
5
name : key102
6
private key : 7302b5758d15c5ef9eec4ba7182d3a18ba10776f8bb921945f3766028260b3f8
7
public key : e7f1541f7460fc38ef8ffeb5d483415074d68621b004614209d3d461d7abee12
Copied!
Key Export Private
1
Usage:
2
accumulate key export private [key name] export the private key by key name
Copied!
Example of usage:
1
$ ./accumulate.exe key export private key1234
2
name : key1234
3
private key : 7302b5758d15c5ef9eec4ba7182d3a18ba10776f8bb921945f3766028260b3f8
4
public key : e7f1541f7460fc38ef8ffeb5d483415074d68621b004614209d3d461d7abee12
Copied!
Key Export Mnemonic
1
Usage:
2
accumulate key export mnemonic export the mnemonic phrase if one was entered
Copied!
Example of usage:
1
$ ./accumulate.exe key export mnemonic
2
mnemonic phrase: humor demand lesson identify rookie road truth beef benefit thank camera tumble
Copied!
Key Export Seed
1
accumulate key export seed export the seed generated from the mnemonic phrase
Copied!
Example of usage:
1
$ ./accumulate.exe key export seed
2
seed: b1310fcca7d5938d552561757d1e62a11a6fd3939cabdcfbbad94d1a6fb6a873f81b15f286ab4bed8e6139e4a6348387d555b72cf0e98793f5828264cfa78c77
Copied!

Manager

Update Manager
1
Usage:
2
accumulate manager set [key page url] [signing key name] [key book url]
Copied!
Example of usage:
1
$ ./accumulate manager set ADITEST/page keytest ADITEST/book
2
Transaction Hash : 6b0e7de9b549823623e2ac019442e415968a892d602b91c04390acfb641c51f4
3
Envelope Hash : 227b322acda0564b6ef7d6753e7cf1442df689fdc84b8659b3b6c2ce52af259b
4
Simple Hash : cc8af739ecabaa116f7484000cd8b9ff8d0065672a9b7b17d59ea742e5e5b4d5
5
Error code : ok
Copied!
Remove Manager
1
accumulate manager remove [key page url] [signing key name]
Copied!
Example of usage:
1
$ ./accumulate manager remove ADITEST/page keytest
2
Transaction Hash : 1ec19ab6084c1e82632a3c441de82a4ddb659afc3b40dda365510e07465f080d
3
Envelope Hash : 53ca879b1dc6bac8899d5bf70657dd9af4f027f87000cd5673c1b40b62b7d425
4
Simple Hash : 4cbe000690b7eb27d669584e28497403dae7539864bf030dc178b559dcb58a90
5
Error code : ok
Copied!

Page

1
$ ./accumulate.exe page
Copied!
1
accumulate page create [actor adi url] [signing key name] [key index (optional)] [key height (optional)] [new key page url] [public key 1] ... [public key hex or label n + 1]
2
Create new key page with 1 to N+1 public keys
3
example usage: accumulate key page create acc://RedWagon redKey5 acc://RedWagon/RedPage1 redKey1 redKey2 redKey3
4
accumulate page get [URL]
5
Get existing Key Page by URL
6
accumulate page key update [key page url] [signing key name] [key index (optional)] [key height (optional)] [old key label] [new public key or label]
7
Update key in a key page with a new public key
8
example usage: accumulate page key update acc://RedWagon/RedPage1 redKey1 redKey2 redKey3
9
accumulate page key add [key page url] [signing key name] [key index (optional)] [key height (optional)] [new key label]
10
Add key to a key page
11
example usage: accumulate page key add acc://RedWagon/RedPage1 redKey1 redKey2
12
accumulate page key remove [key page url] [signing key name] [key index (optional)] [key height (optional)] [old key label]
13
Remove key from a key page
14
example usage: accumulate page key remove acc://RedWagon/RedPage1 redKey1 redKey2
Copied!
Get Key Page
Get existing Key Page by URL
1
Usage:
2
accumulate key get page [URL]
Copied!
Example of usage:
1
$ ./accumulate.exe get ADITEST/ADIKEYPAGE1
2
Index Nonce Public Key Key Name
3
0 0 ec52b1f5b263010912431bf8e4af6ed84b3b3d64baff41b306fec359a512e7b5
Copied!
Key Page Create
Create new key page with 1 to N public keys within the wallet
1
Usage:
2
accumulate key page create [actor adi url] [signing key label] [key index (optional)] [key height (optional)] [new key page url] [public key label 1] ... [public key label n]
Copied!
Example of usage:
1
$ ./accumulate.exe key page create ADITEST key1234 ADITEST/ADIKEYPAGE1.4 KEY1.4 KEY1.41 KEY1.42
2
{
3
"​​""data":{
4
"​​""codespace":"",
5
"hash":"494832A75CE0F4995965ABC142C1ED7B2AD1A98167D828B30B9122777EA361E5",
6
"txid":"d8072c4c1ebab505a9eea8298013606c4b77ac6fa3814596b05c2dc2d9d51912"
7
}"​​",
8
"keyPage":null,
9
"sponsor":"",
10
"txid":null,
11
"type":"sigSpec"
12
}"
Copied!
Page Key Update
Update key page with a new public key
1
Usage:
2
accumulate key page update [key page url] [signing key label] [key index (optional)] [key height (optional)] [old key label] [new public key or label]
Copied!
Example of usage:
1
$ ./accumulate.exe page key update ADITEST/ADIKEYPAGE1 key5678 1 1 key5678 key1234
2
Transaction Identifier : f61b5344e863141f25d34c2f40d8d1e2bd4cd29687c5f98822f91e9e39500682
3
Tendermint Reference : 2572c943abfc91b7e2192d9522657f5fffc8f4da1df55d5d0807ebca6f67faf7
4
Error code : ok
Copied!
Page Key Add
Add key to key page
1
accumulate key page add [key page url] [signing key label] [key index (optional)] [key height (optional)] [new key label]
Copied!
Example of usage:
1
$ ./accumulate.exe page key add ADITEST/ADIKEYPAGE1 key1234 1 1 key5678
2
Transaction Identifier : f61b5344e863141f25d34c2f40d8d1e2bd4cd29687c5f98822f91e9e39500682
3
Tendermint Reference : 2572c943abfc91b7e2192d9522657f5fffc8f4da1df55d5d0807ebca6f67faf7
4
Error code : ok
Copied!
Page Key Remove
Remove key in key page
1
accumulate key page remove [key page url] [signing key label] [key index (optional)] [key height (optional)] [old key label]
Copied!
Example of usage:
1
$ ./accumulate.exe page key remove ADITEST/ADIKEYPAGE1 key1234 1 1 key1234
2
Transaction Identifier : f61b5344e863141f25d34c2f40d8d1e2bd4cd29687c5f98822f91e9e39500682
3
Tendermint Reference : 2572c943abfc91b7e2192d9522657f5fffc8f4da1df55d5d0807ebca6f67faf7
4
Error code : ok
Copied!

Token

1
$ ./accumulate.exe token
Copied!
1
Usage:
2
burn burn tokens
3
create Create new token
4
get get token by URL
5
issue send tokens from a token url to a recipient
Copied!

Token Burn

Burn Tokens
1
Usage:
2
accumulate token burn [adi or lite token account] [adi signer key name (if applicable)] [amount] [flags]
Copied!
Example of usage:
1
./accumulate token burn acc://09bca3fcd7e28434f4fb5a3c7317d64e955acbc102e45df5/ACME 1
2
3
Transaction Hash : a6d7f5aa0c373c6888adba7e3c84df0b3c5b2688427df420c4c749cf452a5864
4
Envelope Hash : b0a58ed58f096cf35a50eda7fcb728fa0a7d9129d5e061d03071fa1a00d927ba
5
Simple Hash : 0f5d6fa9ba05d322487ce35db53a5f69d0e1bc0f52c3bbd972cb2cde88042b37
6
Error code : ok
Copied!

Token Create

Create new token
1
Usage:
2
accumulate token create [origin adi url] [signer key name] [url] [symbol] [precision] [properties]
Copied!
Example of usage:
1
./accumulate token create acc://ADITEST key11 acc://ADITEST/TokenTest ADT 2
2
3
Transaction Hash : 42b9cc80cd430a3dcf759e43190192b358743b42d4f80d4c6367e7b36b90a364
4
Envelope Hash : e72f8b6561dda8531a2fd3c58317bc35e4300e9953762f662a0b5a0ee4392a4f
5
Simple Hash : e8bd622ebe235c99e799e6780f42f8cae6248211a62303086cea82a9bbbeca0d
6
Error code : ok
Copied!

Token Get

Get token by URL
1
Usage:
2
accumulate token get [url]
Copied!
Example of usage:
1
./accumulate token get acc://ADITEST/TokenTest
2
3
Token URL : acc://ADITEST/TokenTest
4
Symbol : ADT
5
Precision : 2
6
Supply : 0
7
Supply Limit : no
8
Properties URL :
Copied!

Token Issue

Send tokens from a token url to a recipient
1
Usage:
2
accumulate token issue [adi token url] [signer key name] [recipient url] [amount] [flags]
Copied!
Example of usage:
1
./accumulate token issue acc://fun/funtoken kgkey acc://09bca3fcd7e28434f4fb5a3c7317d64e955acbc102e45df5/ACME 1
2
3
Transaction Hash : a2c232565b3b9864740966b17a97a14560e8a9bbf2cbf362928a113e2435a4af
4
Envelope Hash : 2b40effc2cb9edc6edc7dfc7482684a487a100dc485469bc5f4e376181f0f6c0
5
Simple Hash : 7d8197f93f3f361be3dbc92dd0ac8bd7cd51da2b1ec28f25ce7ae3d4db6de7ae
6
Error code : ok
Copied!

Tx

Send token from one anonymous token account to another one.
1
$ ./accumulate.exe tx
Copied!
1
Usage:
2
accumulate tx get [txid]
3
Get token transaction by txid
4
accumulate tx create [from] [to] [amount]
5
Create new token tx
6
accumulate tx execute [from] [payload]
7
Execute an arbitrary transaction
8
accumulate tx sign [origin] [signing key name] [key index (optional)] [key height (optional)] [txid]
9
Sign a pending transaction
10
accumulate tx history [url] [starting transaction number] [ending transaction number]
11
Get transaction history
12
accumulate tx pending [txid]
13
Get token transaction by txid
14
accumulate tx pending [height]
15
Get token transaction by block height
16
accumulate tx pending [starting transaction number] [ending transaction number]
17
Get token transaction by block height
18
Copied!

Tx Get

Get token transaction by txid
1
Usage:
2
accumulate tx get [txid]
Copied!
Example of usage:
1
$ ./accumulate.exe tx get 46469416c03b2b386e6c10da8e873f0d61392fc1e8384b63123d8d1e8a7326dd
2
{
3
"data":{
4
"from":"acc://7117c50f04f1254d56b704dc05298912deeb25dbc1d26ef6/ACME",
5
"to":[
6
{
7
"amount":1000000000,
8
"txid":"60d4c56055876cfa955721ff8613d9e372de02167951f360e4bcb27d2b1efb48",
9
"url":"acc://e3f53a4582a9193914effacbd2ef5ad8105a61cdf78ee414/ACME"
10
}
11
],
12
"txid":"46469416c03b2b386e6c10da8e873f0d61392fc1e8384b63123d8d1e8a7326dd"
13
},
14
"keyPage":{
15
"height":1,
16
"index":0
17
},
18
"sig":"ce03ba0e52cdd4ce140de75f51727e2c40b1cc1f141e16916ad5f3a435935b81e99e43ce15274f973e1a06dab2dc174567f0544e1dfec39b516ef095fbf8670f",
19
"signer":{
20
"nonce":1635714053572291600,
21
"publicKey":"d03c683332ed36add8d0eeb9eee9e2669b5565decec03acc43d762f3f79f49c2"
22
},
23
"sponsor":"acc://7117c50f04f1254d56b704dc05298912deeb25dbc1d26ef6/ACME",
24
"status":{
25
"code":"0"
26
},
27
"type":"tokenTx"
28
}
Copied!

Tx Create

Create new token tx
1
Usage:
2
accumulate tx create [from] [to] [amount]
Copied!
Example of usage:
1
$ ./accumulate.exe tx create acc://68fe2628a354d44ab349b08566ac35139a22b9896b1eff0d/ACME acc://78ef49e7ff69a7099774b72ec31edffb6c5a66a964aaa6e9/ACME 500000000
2
3
Transaction Identifier : 4a6683f35ac3191a482e606ac37e6224ef325936d045252af7bf7c5bd9970dfb
4
Tendermint Reference : 7745ebf61e42ee1b9e83b18a05125031d78f3bfdfe460e7be58f3c9296769e6a
5
Error code : ok
Copied!

Tx Create (between ADI token accounts)

Send tokens between ADI token accounts.
1
Usage:
2
accumulate tx create [from] [to] [amount]
Copied!
Example of usage:
1
$ ./accumulate.exe tx create acc://adione/one key61 acc://adithree/three 0.5
2
3
Transaction Identifier : 73fc83c76f36a6a1850e84d2149223de69903c5c635be64ef234d61f8929b4ae
4
Tendermint Reference : b981ef488248ad3adf4b799a4b717e9f8026b0b8f6e162fa992b26ba68777385
5
Error code : ok
6
Error : CheckTx
Copied!

Tx Execute

Execute an arbitrary transaction
1
Usage:
2
accumulate tx execute [from] [payload]
Copied!
Example of usage:
1
$ ./accumulate tx execute acc://ADITEST key1 '{"type": "createTokenAccount", "url": "acc://ADITEST/tokn", "tokenUrl": "acc://ACME"}'
2
3
Transaction Hash : ab1031b05c5c5800354fc42c5d0d96f1f4e03c67248e97a3d24d0c255d574cf5
4
Envelope Hash : 37fe7276d368c0228acfcc1b646a02bf0b696b4b83707abbf986ce2dcd550a33
5
Simple Hash : 458cc577e82bc7ec2240dce06e4ec66d03bba8246b977dff486366e774fef581
6
Error code : ok
Copied!

Tx Sign

Sign a pending transaction
1
Usage:
2
accumulate tx sign [origin] [signing key name] [key index (optional)] [key height (optional)] [txid]
Copied!
Example of usage:
1
$ ./accumulate tx sign ADITEST/testtoken key2 fa3aac0886f345ec32b5762277de2a6645b6d8ac5551e7aa0761e41e80a7726b
2
3
Transaction Hash : fa3aac0886f345ec32b5762277de2a6645b6d8ac5551e7aa0761e41e80a7726b
4
Envelope Hash : 87d9a4019c019267e6a1f452e7119ab4cb9bd300827f41b84ce56e31a9acb7be
5
Simple Hash : 1d5f884c4cde73d3b561a9ebe6cc9909fce6435220cf2644bd2925fa3cff6367
6
Error code : ok
Copied!