Get Test Tokens in Shellnet

This guide explains how to top up an address with test tokens in the `Shellnet` network

For the Shellnet network only

Please update tvm-cli v3+ and use the new extended address format:

<dapp_id>::<account_id>

You can receive test tokens in two ways: * by using the giver * by requesting them from us through our Telegram channel

Requirements

Before you start, make sure you have:

• tvm-cli installed

• GiverV3 ABI file

• Recipient wallet or contract address

Right now, in enabled DEV mode, you will see the address of your Multifactor contract

GiverV3 contract artifacts are available in the repository Acki Nacki

GitHub - ackinacki/ackinacki: Acki Nacki Block Keeper/Block Manager Node ImplementationGitHub

Test Tokens

Token amounts in ecc are specified in the smallest units.

Token	`ecc` key	Decimals	Example
NACKL	1	9	100 NACKL = 100,000,000,000
SHELL	2	9	100 SHELL = 100,000,000,000
USDC	3	6	100 USDC = 100,000,000

• Make sure the recipient address is correct before running the command

• Keep the value parameter set to 1000000000

Get SHELL

Replace 0:348c....66bf with the recipient address.

The command below sends 1000 SHELL.

tvm-cli -j -u shellnet.ackinacki.org callx \
  --abi acki-nacki/contracts/giver/GiverV3.abi.json \
  --addr 0000000000000000000000000000000000000000000000000000000000000000::1111111111111111111111111111111111111111111111111111111111111111 \
  -m sendCurrency \
  '{"dest":"0:348c....66bf","value":1000000000,"ecc":{"2":1000000000000}}'

Get NACKL

Replace 0:348c....66bf with the recipient address.

The command below sends 100 NACKL.

tvm-cli -j -u shellnet.ackinacki.org callx \
  --abi acki-nacki/contracts/giver/GiverV3.abi.json \
  --addr 0000000000000000000000000000000000000000000000000000000000000000::1111111111111111111111111111111111111111111111111111111111111111 \
  -m sendCurrency \
  '{"dest":"0:348c....66bf","value":1000000000,"ecc":{"1":100000000000}}'

Get USDC

Replace 0:348c....66bf with the recipient address.

The command below sends 5000 USDC.

tvm-cli -j -u shellnet.ackinacki.org callx \
  --abi acki-nacki/contracts/giver/GiverV3.abi.json \
  --addr 0000000000000000000000000000000000000000000000000000000000000000::1111111111111111111111111111111111111111111111111111111111111111 \
  -m sendCurrency \
  '{"dest":"0:348c....66bf","value":1000000000,"ecc":{"3":5000000000}}'

Get multiple tokens

You can request several test tokens in one command by adding multiple keys to ecc.

The command below sends 1000 NACKL, 50000 SHELL, and 5000 USDC.

tvm-cli -j -u shellnet.ackinacki.org callx \
  --abi acki-nacki/contracts/giver/GiverV3.abi.json \
  --addr 0000000000000000000000000000000000000000000000000000000000000000::1111111111111111111111111111111111111111111111111111111111111111 \
  -m sendCurrency \
  '{"dest":"0:348c....66bf","value":1000000000,"ecc":{"1":1000000000000,"2":50000000000000,"3":5000000000}}'

Get VMSHELL to a Precomputed Address

Use this option to send test SHELL tokens to an address where the contract has not yet been deployed.

The SHELL tokens will be converted into VMSHELL at the destination address.

These tokens will be used to pay for the deployment of that contract.

Replace 0:348c....66bf with the recipient address.

The command below sends 1000 SHELL, which will be credited as 1000 VMSHELL.

tvm-cli -j -u shellnet.ackinacki.org callx \
  --abi acki-nacki/contracts/giver/GiverV3.abi.json \
  --addr 0000000000000000000000000000000000000000000000000000000000000000::1111111111111111111111111111111111111111111111111111111111111111 \
  -m sendCurrencyWithFlag \
  '{"dest":"0:348c....66bf","value":1000000000,"ecc":{"2":1000000000000},"flag":16}'