Quick Start Guide

CredaCash Software Quick Start Guide

The following steps should help get the CredaCash software quickly running:

1. Download the Windows executable files at https://credacash.com/software/, then extract the contents to any convenient directory.

2. Optionally, start a full node. The wallet can use this node to access the network, or it can use a public node running in the cloud (for that reason, this step is optional). If desired, start a full node by opening a command prompt window, and “cd” to the directory containing the executable files. The network node program generates output (stdout) that can be directed to a log file, as follows:

     ccnode > ccnode.log

The node program connects to the network via tor, and it may take 2-5 minutes to establish a connection. Once a connection is established, new block announcements will appear on the console (stderr). The node can be used by a wallet when it is fully sync’ed to the blockchain.

3. Open a new command prompt window, and “cd” to the directory containing the executable files. Then initialize a new wallet using the command:

     ccwallet --create-wallet

The wallet will prompt for a password for its master secret.

4. The wallet needs to connect to a full node with transaction services enabled. There are four options:

  • A node running on the same computer. If a full node has been started on the same computer and has sync’ed to the blockchain, the wallet can connect to this server using its default settings:

         ccwallet --interactive

  • Connect directly to a public node in the cloud. This is the quickest and easiest option (if the cloud node is not overloaded):

         ccwallet --interactive --transact-host=3.209.36.253

  • Connect to a public node in the cloud via the tor network. It can take 2-5 minutes for the tor network to initialize and establish a connection:

         ccwallet --interactive --transact-tor=1

  • Connect to a public node in the cloud via tor, and for increased privacy, create a new connection for each query:

         ccwallet --interactive --transact-tor=1 --transact-tor-single-query=1

5. Test the connection using the ping command. This command will report the server response time in seconds:

     ping

6. Mint a new billet. Currency can be freely minted on the test network using the command:

     cc.mint

7. Check the wallet balance. The new billet will be added to the wallet balance after it has cleared:

     getbalance

8. Create a new transaction destination:

     getnewaddress

9. Send a transaction back to the wallet. In place of <destination>, copy and paste the destination returned by the “getnewaddress” command:

     sendtoaddress <destination> 12.3

10. The wallet balance should immediately decrease by the amount of the transaction witness donation:

     getbalance

11. Open a new command prompt window, “cd” to the directory containing the wallet executable files, and create a second wallet using one of the following commands:

     ccwallet --interactive --datadir=wallet2 --create-wallet
         or
     ccwallet --interactive --datadir=wallet2 --transact-host=3.209.36.253 --create-wallet
         or
     ccwallet --interactive --datadir=wallet2 --transact-tor=1 --create-wallet
         or
     ccwallet --interactive --datadir=wallet2 --transact-tor=1 --transact-tor-single-query=1 --create-wallet

12. Create a new transaction destination for the second wallet:

     getnewaddress

14. Return to the command prompt for the first wallet, and send a transaction to the second wallet:

     sendtoaddress <second_wallet_destination> 23.4

15. Return to the command prompt for the second wallet, and check the balance until the incoming payment clears:

     getbalance

16. The wallet also accepts several other bitcoin commands, such as “listtransactions” and “listsinceblock”. For a full list, use the command:

     help

17. To shutdown the wallet (not the node to which it is connected), use the command:

     stop

18. The wallet can also be accessed via its JSON-RPC interface. Start the wallet using one of the following commands:

     ccwallet --wallet-rpc=1 --wallet-rpc-password=pwd
         or
     ccwallet --wallet-rpc=1 --wallet-rpc-password=pwd --transact-host=3.209.36.253
         or
     ccwallet --wallet-rpc=1 --wallet-rpc-password=pwd --transact-tor=1
         or
     ccwallet --wallet-rpc=1 --wallet-rpc-password=pwd --transact-tor=1 --transact-tor-single-query=1

Note that for better security, the RPC password can be placed in the wallet.conf file instead of the command line, and a future version of the wallet will automatically generate a “cookie” file if no password is provided.

19. If the “curl” utility is installed, it can be run from a different command prompt window to access the wallet’s JSON-RPC interface as follows:

     curl -u rpc:pwd 127.0.0.1:9423 --data-binary {\"method\":\"getbalance\",\"params\":[]}

In this release, the wallet only supports the basic commands to send and receive transactions. All the features of CredaCash such as completely private escrow transactions and completely private cross-chain swaps can be accessed via the transaction library. It is hoped that in the future, the wallet will also support these features.