Accumulate
Search…
Getting Started
Deep Dive
Developer Resources
Integration
Create a lite account
In this tutorial, you will learn how to create and fund an account, send tokens between the two, send credits, check account balance, and check transaction info.
Lite Accounts are a ‘lite’ version of ADIs that may appeal to users who want to send and receive tokens and maintain a record of their token accounts and transactions despite their comparatively limited utility and flexibility. For more info, check this link.
Requirements:
- Basic CLI Knowledge
- Git
1: Generate a lite account
The first step is to create a lite token account using the account generate command.
This command will create an account URL and the corresponding public key stored locally on your computer.
1
./accumulate account generate
Copied!
If you are on Windows, you must use ./accumulate.exe instead.
Once you run the command, you should get an output with the address for your token account. It will look something like the following:
1
acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME : c11d64fa7aca19c365fb4e392fac540033493911e604bf629465132392d18ba4
Copied!
2: Funding your account
You will fund your new account using the faucet command, which will broadcast the existence of your new account and give you some free tokens.
Since this command requires broadcasting to the network, you need to ensure you are connected to a node. We do that with the -s flag then the server address for the node we wish to connect to comes next.
Your account connects to the accumulate testnet by default.
If you want to connect to the devnet, add this flag and argument -s https://devnet.accumulatenetwork.io/v2
Syntax
1
./accumulate faucet <your account address>
Copied!
Example
1
./accumulate faucet acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
Copied!
The above command will return an output similar to the following:
1
Transaction Hash : 00cf5a4366492b678465b2e4ff73bbe7df99d9eee7b85f053b6c4ee8bf29fbdd
2
Envelope Hash : 89b5a24c608e4d67e23a700acba1db03e4202b9c0a881e2ef5b4fdbfffe3fa5c
3
Simple Hash : 6493d0887aa9838f6d522b3a84a5843308e32f699ae4150da14ad89ad827bc40
4
Error code : ok
Copied!
3: Send Credits
Credits are payments made by users to compensate for the computing energy required to process and validate transactions on the Accumulate protocol.
To send ACME tokens to another account, you need to purchase credits with ACME and send them to a recipient.
To send credits to your lite account, run the example command in your terminal
The command below gives your accumulate URL the access to send credits to another lite account.
Syntax:
1
accumulate credits <origin lite account> <lite account or key page url><amount>
Copied!
Example
1
./accumulate credits acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME 10
Copied!
The above command will return an output similar to the following:
1
Transaction Hash : d64847cee49418516596c905b12f0002cc6b06decec1356e9c48f0040c1b6f4f
2
Envelope Hash : d24209b25204e300cd53be560cf91fdbeb4eb05f572f7c5acc96a58443658b0e
3
Simple Hash : 07b567df37b86050f6ef636e9118d23926206f459ffd4f82d28f208e7d2151b1
4
Error code : ok
Copied!
4: Check your Balance
Check the account balance to see how many tokens you have received from the faucet. Then, use the account get command.
Syntax
1
./accumulate account get <your account address>
Copied!
Example
1
./accumulate account get acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
Copied!
The above command will return an output similar to the following:
1
Account Url : acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
2
Token Url : acc://ACME
3
Balance : unknown
4
Credits : 0
5
Nonce : 0
Copied!
To get it in a json format a -j flag
1
./accumulate account get acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME -j
Copied!
The above command will return an output similar to the following:
1
{"type":"liteTokenAccount","mainChain":{"height":1,"count":1,"roots":["e0ae7b03ca99b41eb1e545fa9b647d933e7b74b127224eef6743e45fdc7b9ac0"]},"data":{"balance":"1000000000","creditBalance":"0","keyBook":"","managerKeyBook":"","tokenUrl":"acc://ACME","type":"liteTokenAccount","url":"acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME"},"chainId":"9c92f4565ea7bc81191a201b2a778e004222b4b3f8701ee57eaca29cb12579d9"}
Copied!
5: Send Tokens
Let's try sending some ACME tokens from one account to the other. You can use the account we already funded as the sending account. You'll need to create an additional account to receive the tokens.
To send the tokens, use the command below.
Syntax:
1
./accumulate tx create <sending account> <receiving account> <Amount>
Copied!
Example:
1
./accumulate tx create acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME acc://b3e4778e8940f13e4ddf1716b453b366e2a4b3a59b99bd03/ACME 5
Copied!
The above command will return an output similar to the following:
1
Transaction Hash : f8174628b1236865d71473d542691da5c7887210052972bdc22dff97866955ae
2
Envelope Hash : 0c0cb20f870fed7d648641c04689459dbaa591aa5fbef52a7d459967fac3dbc6
3
Simple Hash : 72036bde24d55a7e54177fa9268f94b5281596fca2c82d3074f9cec8dfacda6b
4
Error code : ok
Copied!
6: Get Transaction Hash:
Finally, let's make sure that the transaction was successful. You will use the tx get command to do that, and you will pass in the transaction id ("txid") that you received in the response output from step 5.
Syntax:
1
./accumulate tx get Transaction hash
Copied!
Example:
1
./accumulate tx get f8174628b1236865d71473d542691da5c7887210052972bdc22dff97866955ae
Copied!
The above command will return an output similar to the following:
1
Send unknown from acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME to
2
- Synthetic Transaction :
3
---
4
- Transaction : f8174628b1236865d71473d542691da5c7887210052972bdc22dff97866955ae
5
- Signer Url : acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
6
- Signatures :
7
- : 02474b235a3ae7fd5c8afc86a731d7b90b79aa9feb3cbb58b3d3aa452f3e48ce2b8bb88bfa7aada62a6b8ed9d2c269a13f31a0d3343d0958c9a337b9d8bd9507 (sig) / c11d64fa7aca19c365fb4e392fac540033493911e604bf629465132392d18ba4 (key)
8
- Key Page : 1 (height) / 0 (index)
9
===
10
- Synthetic Transaction 0 : 4e148c20cf0838718485597c60ce3d7880914d298337bd040b7799ea196b9606
Copied!