Add Fee Credit to Your Wallet

Before you can make any transaction from your wallet, you need to have enough funds on your fee credit balance to pay for the cost of transactions and data storage on the blockchain. Each wallet account has its own fee credit balance for every partition.

Transaction fees are paid in Alphabill's native currency, ALPHA, and the fee per transaction is 0.000'000'01 ALPHA (that is, 1 tema). Actions that consist of three transactions (3 x 0.000'000'01 ALPHA) are: updating fee credit record, reclaiming fee credit, and consolidating bills.

Known Issue

The wallet fees list command does not currently show the fee credit balance for the EVM Partition. This is a known issue under review and will be addressed in a future release.

Prerequisites

Before you begin, make sure you have completed the following steps:

• When using public Alphabill testnet:

  • You have set up an Alphabill CLI wallet.
  • Your wallet is funded with testnet ALPHA.

• When using local Alphabill devnet:

  • You have set up an Alphabill CLI wallet.
  • You have set up a local Alphabill devnet and it is running on your machine.
  • Your wallet is funded with local devnet ALPHA.

Add Fee Credit

Go to the alphabill-wallet/build directory and add 1 ALPHA to your fee credit balance to cover transaction fees from your default account. The fee for this transaction will also be paid from the fee credit record being created.

tip

• To manage fees for accounts other than the default account ("1"), use the --key flag and specify the account number.
• For other wallets, use the --wallet-location flag and specify the location of the wallet.
• If you want to add more funds to the fee credit balance than the default 1 ALPHA, use the --amount flag at the end of the command and specify the amount.

Public testnet

• Money Partition:

  ./abwallet wallet fees add \
  --rpc-url https://money-partition.testnet.alphabill.org
  Example response:

  Successfully created 1 fee credits on money partition.
  Paid 0.000'000'02 ALPHA fee for transactions.

• User Token Partition:

  ./abwallet wallet fees add \
  --rpc-url https://money-partition.testnet.alphabill.org \
  --partition tokens \
  --partition-rpc-url https://tokens-partition.testnet.alphabill.org
  Example response:

  Successfully created 1 fee credits on tokens partition.
  Paid 0.000'000'02 ALPHA fee for transactions.

• EVM Partition:

  ./abwallet wallet fees add \
  --rpc-url https://money-partition.testnet.alphabill.org \
  --partition evm \
  --partition-rpc-url https://evm-partition.testnet.alphabill.org
  Example response:

  Successfully created 1 fee credits on evm partition.
  Paid 0.000'000'02 ALPHA fee for transactions.

Local devnet

• Money Partition:

  ./abwallet wallet fees add
  Example response:

  Successfully created 1 fee credits on money partition.
  Paid 0.000'000'02 ALPHA fee for transactions.

• User Token Partition:

  ./abwallet wallet fees add \
  --partition tokens
  Example response:

  Successfully created 1 fee credits on tokens partition.
  Paid 0.000'000'02 ALPHA fee for transactions.

• EVM Partition:

  ./abwallet wallet fees add \
  --partition evm
  Example response:

  Successfully created 1 fee credits on evm partition.
  Paid 0.000'000'02 ALPHA fee for transactions.

List Fee Credit

Confirm that your wallet's fee credit balance is now sufficient with testnet or devnet ALPHA for transaction fees:

tip

To list the fee credits of another wallet, use the --wallet-location flag and specify the location of the wallet.

Public testnet

• Money Partition

  ./abwallet wallet fees list \
  --rpc-url https://money-partition.testnet.alphabill.org
  Example response:

  Partition: money
  Account #1 0.999'999'98
  Account #2 0.000'000'00

• User Token Partition

  ./abwallet wallet fees list \
  --rpc-url https://money-partition.testnet.alphabill.org \
  --partition tokens \
  --partition-rpc-url https://tokens-partition.testnet.alphabill.org
  Example response:

  Partition: tokens
  Account #1 0.999'999'98
  Account #2 0.000'000'00

• EVM Partition

  ./abwallet wallet fees list \
  --rpc-url https://money-partition.testnet.alphabill.org \
  --partition evm \
  --partition-rpc-url https://evm-partition.testnet.alphabill.org
  Example response:

  Partition: evm
  Account #1 0.999'999'98
  Account #2 0.000'000'00

Local devnet

• Money Partition

  ./abwallet wallet fees list
  Example response:

  Partition: money
  Account #1 0.999'999'98
  Account #2 0.000'000'00

• User Token Partition

  ./abwallet wallet fees list \
  --partition tokens
  Example response:

  Partition: tokens
  Account #1 0.999'999'98
  Account #2 0.000'000'00

• EVM Partition

  ./abwallet wallet fees list \
  --partition evm
  Example response:

  Partition: evm
  Account #1 0.999'999'98
  Account #2 0.000'000'00

Next Steps

• Check out the User Token Partition tutorials to learn how to use the CLI wallet to create, mint and transfer your own fungible and non-fungible tokens.
• Learn how to use the Money Partition capabilities to make payments from one wallet to another, manage bills in your wallet, and swap smaller bills into one larger bill.
• Use the CLI wallet to deploy and execute smart contracts in Solidity on the Alphabill EVM Partition.