Money Partition

In this tutorial, you will 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.

info

This walkthrough addresses the local devnet flow. To sync transactions with the public testnet, use the --alphabill-api-uri flag and the following REST API endpoint with wallet commands:

https://money-backend.testnet.alphabill.org

The same backend service is used by the browser wallet. Swagger documentation for the money backend service is available from:

• Money Partition of the public testnet: https://money-backend.testnet.alphabill.org/api/v1/swagger/
• Money Partition when running a local denvet: http://localhost:9654/api/v1/swagger/

Prerequisites

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

• CLI wallet set up and additional wallet created.
• Local devnet set up and running on your machine.
• Devnet funds deposited into your wallet.
• Funds added to fee credit balance for managing fees on Money Partition.

Transfer Bills

Start by transferring some ALPHA from your default wallet to your second wallet. In this example, the second wallet is located at ~/.alphabill/wallet2.

1. List the public key of your second wallet:

   ./alphabill wallet get-pubkeys \
   --wallet-location ~/.alphabill/wallet2
   Example response:

   #1 0x022b621b40c0b8a404a56a364fad84c74408a9f9880c979ab96c7ae651ec96670a

   The output of this command will be referred as INSERT_YOUR_WALLET_2_PUBKEY in the commands below.

2. Transfer a bill worth of 1 ALPHA to your second wallet:

   ./alphabill wallet send \
   --address INSERT_YOUR_WALLET_2_PUBKEY \
   --amount 1
   info

   The default --alphabill-api-uri flag value is used here. Each wallet subcommand requires a connection to the indexing backend, which in case of the money backend is started on localhost:9654.

   You should see output like in the example below:

   Example response:

   Successfully confirmed transaction(s)
   Paid 0.000'000'01 fees for transaction(s).

3. Confirm both wallet balances:

   • Default wallet:

     ./alphabill wallet get-balance
     Example response:

     #1 9'999'999'997.999'999'97
     Total 9'999'999'997.999'999'97

   • Second wallet:

     ./alphabill wallet get-balance \
     --wallet-location ~/.alphabill/wallet2
     Example response:

     #1 1.000'000'00
     Total 1.000'000'00

4. Prior to the next step, you need to send some additional bills to the second wallet. In fact, you should run the following two commands a total of five more times:

   ./alphabill wallet send \
   --address INSERT_YOUR_WALLET_2_PUBKEY \
   --amount 1

   This will have the effect of sending five additional 1 ALPHA bills from your default wallet to the second wallet, for a total of six bills, each with a denomination of 1 ALPHA.

Check Bills

Before consolidating all these small bills into one larger bill, run the wallet bills list command to inspect bill IDs and values in both wallets:

• Default wallet:

  ./alphabill wallet bills list
  Example response:

  Account #1
  #1 0x5E0823D5F1B1C34B4B1DE355C5B20903CAC86B56DF67E49723A3F2114B6D74E100 9'999'999'997.999'993'96
  

  The output shows that the wallet contains one bill worth 9'999'999'997.999'993'96 ALPHA.

• Second wallet:

  ./alphabill wallet bills list \
  --wallet-location ~/.alphabill/wallet2
  Example response:

  Account #1
  #1 0x5E0823D5F1B1C34B4B1DE355C5B20903CAC86B56DF67E49723A3F2114B6D74E100 1.000'000'00
  #2 0x66D0DDFE22EBC1962D9C00F006CFB96FDF62533A6EB98F20F1153ECAAACD65AB00 1.000'000'00
  #3 0x9FBD4B5E2E81654443F709FA23E2B70B04D420965E30B7C35AAF95C03ED92C3600 1.000'000'00
  #4 0xB9CD290DC5C42CB8DD79EAC66138B68621FC1D383883643E5FACE0A9F42AD64F00 1.000'000'00
  #5 0xBE138C62FE7A275EFFDB558C134848CE59FDE694F81C9E8BCA2FF18B4F9C859F00 1.000'000'00
  #6 0xC40647AD6ADE55FAB671D4B254AA8B5E45CA41DC250DDF6DF2B4602D331C708700 1.000'000'00

  The output shows that the wallet contains six bills, each worth 1.000'000'00 ALPHA.

Consolidate Bills

You can swap your six 1 ALPHA bills for one larger bill with a denomination of 6 ALPHA. This is called "dust collection", where smaller bills are replaced by a single bill having the same total value. It's like making change in reverse. Alphabill uses an inbuilt swap mechanism to allow users to reduce the number of bills their wallet needs to hold. This reduces the amount of dust in the system, which translates into better performance for the network, and also reduces the amount of space used by user wallets.

1. Before you can consolidate these small bills, add some fee credit to your second wallet:

   ./alphabill wallet fees add \
   --wallet-location ~/.alphabill/wallet2 \
   --amount 0.000'000'06
   Example response:

   Successfully created 0.00000006 fee credits on money partition.
   Paid 0.000'000'01 fee for transferFC transaction from wallet balance.
   Paid 0.000'000'01 fee for addFC transaction from fee credit balance.

2. Now you can swap these smaller bills for a larger one:

   ./alphabill wallet collect-dust \
   --wallet-location ~/.alphabill/wallet2

   The log output should contain some information like in the example below:

   Example response:

   Dust collection finished successfully.

3. Finally, confirm that your second wallet contains now only a single bill with a denomination of 6 ALPHA:

   ./alphabill wallet bills list \
   --wallet-location ~/.alphabill/wallet2
   Example response:

   Account #1
   #1 0x5E0823D5F1B1C34B4B1DE355C5B20903CAC86B56DF67E49723A3F2114B6D74E100 6.000'000'00

Next Steps

For more information about Money Partition, see Alphabill core papers and FAQ.