Sending Tokens from a Lite Token Account via CLI
This guide will show you how to send tokens from a Lite Token Account (LTA) with the CLI
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 information, see the Lite Account Deep Dive section.
Lite token accounts can send transactions to other users by specifying the recipient's address and the number of tokens to be transferred. This article provides a general overview of sending a transaction using a lite token account.
- You need basic knowledge of CLI
- You need basic knowledge of Git
Your account connects to the accumulate mainnet by default. If you want to connect to the testnet, append this flag and argument to every command you run:
-s https://testnet.accumulatenetwork.io/v2The 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.
./accumulate account generate
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:
acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME : c11d64fa7aca19c365fb4e392fac540033493911e604bf629465132392d18ba4
If you are on testnet, you can use the built-in faucet. The faucet account will broadcast the existence of your new account and give you some free tokens.
This command only exists on testnet. For Mainnet users, you will need to purchase ACME or receive some from a friend.
Syntax
./accumulate faucet <your account address> -s
https://testnet.accumulatenetwork.io/v2
Example
./accumulate faucet acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
The above command will return an output similar to the following:
Transaction Hash : 00cf5a4366492b678465b2e4ff73bbe7df99d9eee7b85f053b6c4ee8bf29fbdd
Envelope Hash : 89b5a24c608e4d67e23a700acba1db03e4202b9c0a881e2ef5b4fdbfffe3fa5c
Simple Hash : 6493d0887aa9838f6d522b3a84a5843308e32f699ae4150da14ad89ad827bc40
Error code : ok
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 access to send credits to another lite account.
Syntax:
accumulate credits <origin lite account> <lite account or key page url><amount>
Example
./accumulate credits acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME 10
The above command will return an output similar to the following:
Transaction Hash : d64847cee49418516596c905b12f0002cc6b06decec1356e9c48f0040c1b6f4f
Envelope Hash : d24209b25204e300cd53be560cf91fdbeb4eb05f572f7c5acc96a58443658b0e
Simple Hash : 07b567df37b86050f6ef636e9118d23926206f459ffd4f82d28f208e7d2151b1
Error code : ok
Check the account balance to see how many tokens you have received from the faucet. Then, use the account get command.
Syntax
./accumulate account get <your account address>
Example
./accumulate account get acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
The above command will return an output similar to the following:
Account Url : acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
Token Url : acc://ACME
Balance : unknown
Credits : 0
Nonce : 0
To get it in a JSON format, use this
-j flag../accumulate account get acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME -j
The above command will return an output similar to the following:
{"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"}
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, then create an additional account to receive the tokens.
To send the tokens, use the command below.
Syntax:
./accumulate tx create <sending account> <receiving account> <Amount>
Example:
./accumulate tx create acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME acc://b3e4778e8940f13e4ddf1716b453b366e2a4b3a59b99bd03/ACME 5
The above command will return an output similar to the following:
Transaction Hash : f8174628b1236865d71473d542691da5c7887210052972bdc22dff97866955ae
Envelope Hash : 0c0cb20f870fed7d648641c04689459dbaa591aa5fbef52a7d459967fac3dbc6
Simple Hash : 72036bde24d55a7e54177fa9268f94b5281596fca2c82d3074f9cec8dfacda6b
Error code : ok
Finally, let's make sure that the transaction was successful. You will use the tx get command to do that and pass in the transaction id txid that you received in the response output from step 5.
Syntax:
./accumulate tx get <transaction hash>
Example:
./accumulate tx get f8174628b1236865d71473d542691da5c7887210052972bdc22dff97866955ae
The above command will return an output similar to the following:
Send unknown from acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME to
- Synthetic Transaction :
---
- Transaction : f8174628b1236865d71473d542691da5c7887210052972bdc22dff97866955ae
- Signer Url : acc://5c33543157a40920252fa27d20079925807f611a9c4746c4/ACME
- Signatures :
- : 02474b235a3ae7fd5c8afc86a731d7b90b79aa9feb3cbb58b3d3aa452f3e48ce2b8bb88bfa7aada62a6b8ed9d2c269a13f31a0d3343d0958c9a337b9d8bd9507 (sig) / c11d64fa7aca19c365fb4e392fac540033493911e604bf629465132392d18ba4 (key)
- Key Page : 1 (height) / 0 (index)
===
- Synthetic Transaction 0 : 4e148c20cf0838718485597c60ce3d7880914d298337bd040b7799ea196b9606