Creditcoin Miner's Manual

This guide will walk you through connecting to the Creditcoin blockchain and running your own Server and Client.
Prerequisites
Before connecting to the Creditcoin blockchain, you will need to set up the following:
An Ethereum private key
An Ethereum RPC mainnet node
A 256 bit SECP256K1 ECDSA private key
Docker Desktop
Get an Ethereum private key
This section is for new Ethereum users who need to create a wallet. We recommend creating a wallet using MetaMask. Refer to How to Export an Account Private Key on the Metamask Support site for more information on how to obtain your private key.
Set up an Ethereum RPC mainnet node
This section will cover how to set up an Ethereum RPC mainnet node using infura.io Alternatively, you can set up your own private RPC mainnet node.
Go onto infura.io, create a new account and confirm your email address.
In your infura account dashboard page, click on 'Create New Project' and name it accordingly.
Click on 'View Project' and you will have access to your mainnet node (aka Endpoint).
Click on the clipboard to the right on the https endpoint (highlighted above) to copy the endpoint URI
Get a 256 bit SECP256K1 ECDSA key
You have two options here, depending on whether you'd like to share the same wallet between your miner and client, or have separate ones.
1. Share your wallet between your miner and client.
See the steps under the Get your miner key section of the document for information on how this is done.
2. You can use this ECDSA sample generator:
Click on 'generate EC pair'
Use the generated 'EC private key'
Configure Docker Desktop
Running a container launches your software with private resources, securely isolated from the rest of your machine.
​Create a Docker account and confirm your email address.
Download Docker Desktop and install it.
Once docker is installed, log in using your newly created account.
Click on the Docker icon in your task bar and select 'Settings'
Under the 'Shared Drives' tab, make sure you have the drive where the Creditcoin containers will be running
Creditcoin Miner
To configure the Creditcoin Miner files, you will need the following:
An Ethereum private key
Your Ethereum RPC mainnet node
A 256 bit SECP256K1 ECDSA key
​Your public IP address​
Firstly, download the Creditcoin files. Afterwards, extract the files in a directory of your choice. You will need to configure the following:
Server/gatewayConfig.json
Server/creditcoin-with-gateway.yaml
You can edit those files by opening them with your preferred text editor.
Server/gatewayConfig.json
{
  "bindIP": "0.0.0.0",
  "bitcoin": {
    "rpc": "<bitcoin_rpc_node_url>",
    "credential": "<rpc_username:rpc_password>"
  },
  "ethereum": {
    "creditcoinContract": "0xa3ee21c306a700e682abcdfe9baa6a08f3820419",
    "creditcoinContractAbi": "[{'constant':false,'inputs':[{'name':'tokenHolders','type':'address[]'},{'name':'amounts','type':'uint256[]'}],'name':'recordSales730Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[],'name':'VestingStartDate','outputs':[{'name':'','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[],'name':'name','outputs':[{'name':'','type':'string'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'spender','type':'address'},{'name':'value','type':'uint256'}],'name':'approve','outputs':[{'name':'success','type':'bool'}],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'vestedBalanceOf','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[],'name':'totalSupply','outputs':[{'name':'amount','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'purchasedBalanceOf365Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'value','type':'uint256'},{'name':'sighash','type':'string'}],'name':'exchange','outputs':[{'name':'success','type':'bool'}],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'from','type':'address'},{'name':'to','type':'address'},{'name':'value','type':'uint256'}],'name':'transferFrom','outputs':[{'name':'success','type':'bool'}],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'vestedBalanceOf183Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[],'name':'decimals','outputs':[{'name':'','type':'uint8'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolders','type':'address[]'},{'name':'amounts','type':'uint256[]'}],'name':'recordSales1095Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'vestedBalanceOf365Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'value','type':'uint256'}],'name':'burn','outputs':[{'name':'success','type':'bool'}],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'purchasedBalanceOf2190Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolders','type':'address[]'},{'name':'amounts','type':'uint256[]'}],'name':'recordSales183Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolder','type':'address'},{'name':'numCoins','type':'uint256'}],'name':'recordSale365Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'vestedBalanceOf730Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'purchasedBalanceOf','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[{'name':'owner','type':'address'}],'name':'balanceOf','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[],'name':'finalizeSales','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'from','type':'address'},{'name':'value','type':'uint256'}],'name':'burnFrom','outputs':[{'name':'success','type':'bool'}],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'vestedBalanceOf2190Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'purchasedBalanceOf730Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[],'name':'symbol','outputs':[{'name':'','type':'string'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolder','type':'address'},{'name':'numCoins','type':'uint256'}],'name':'recordSale183Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'to','type':'address'},{'name':'value','type':'uint256'}],'name':'transfer','outputs':[{'name':'success','type':'bool'}],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[],'name':'creditcoinSalesLimit','outputs':[{'name':'','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'vestedBalanceOf1095Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[],'name':'creditcoinLimitInFrac','outputs':[{'name':'','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolder','type':'address'},{'name':'numCoins','type':'uint256'}],'name':'recordSale2190Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolder','type':'address'},{'name':'numCoins','type':'uint256'}],'name':'recordSale730Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'purchasedBalanceOf1095Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[{'name':'owner','type':'address'},{'name':'spender','type':'address'}],'name':'allowance','outputs':[{'name':'remaining','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[],'name':'startVesting','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolders','type':'address[]'},{'name':'amounts','type':'uint256[]'}],'name':'recordSales2190Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':true,'inputs':[{'name':'tokenHolder','type':'address'}],'name':'purchasedBalanceOf183Days','outputs':[{'name':'balance','type':'uint256'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':true,'inputs':[],'name':'IsSalesFinalized','outputs':[{'name':'','type':'bool'}],'payable':false,'stateMutability':'view','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolders','type':'address[]'},{'name':'amounts','type':'uint256[]'}],'name':'recordSales365Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'constant':false,'inputs':[{'name':'tokenHolder','type':'address'},{'name':'numCoins','type':'uint256'}],'name':'recordSale1095Days','outputs':[],'payable':false,'stateMutability':'nonpayable','type':'function'},{'inputs':[{'name':'creditcoinFoundation','type':'address'},{'name':'devCost','type':'address'}],'payable':false,'stateMutability':'nonpayable','type':'constructor'},{'payable':true,'stateMutability':'payable','type':'fallback'},{'anonymous':false,'inputs':[{'indexed':true,'name':'from','type':'address'},{'indexed':false,'name':'value','type':'uint256'},{'indexed':true,'name':'sighash','type':'string'}],'name':'Exchange','type':'event'},{'anonymous':false,'inputs':[{'indexed':true,'name':'from','type':'address'},{'indexed':false,'name':'value','type':'uint256'}],'name':'Burnt','type':'event'},{'anonymous':false,'inputs':[{'indexed':true,'name':'from','type':'address'},{'indexed':true,'name':'to','type':'address'},{'indexed':false,'name':'value','type':'uint256'}],'name':'Transfer','type':'event'},{'anonymous':false,'inputs':[{'indexed':true,'name':'owner','type':'address'},{'indexed':true,'name':'spender','type':'address'},{'indexed':false,'name':'value','type':'uint256'}],'name':'Approval','type':'event'}]",
    "rpc": "<ethereum_node_url>"
  },
  "ethless" : {
    "rpc": "<ethereum_node_url>"
  },
  "erc20": {
    "rpc": "<ethereum_node_url>"
  }
}
You need to edit the following elements in each section:
rpc: RPC mainnet node (e.g. https://mainnet.infura.io/v3/xxxxxxxxxxxx) or your own personal mainnet node (e.g. http://localhost:8545 )
Server/creditcoin-with-gateway.yaml
--endpoint tcp://<insert.your.ip>:8800 \
Replace <insert.your.ip> on lines 51 and 61 with your public IP address. Do not include the < > signs. For example:
--endpoint tcp://13.93.178.197:8800 \
To allow others to access your node, the port used in the above line (e.g. 8800) should be opened in your firewall and forwarded in your router.
Connecting to the Creditcoin Blockchain
Now that you've got Docker Desktop installed and you've updated your Creditcoin configuration files, you're ready to start the Miner's Docker containers and get connected to the Creditcoin Blockchain!
Opening Command Prompt on Windows
Open a PowerShell by right-clicking the icon and pressing 'Run as administrator'.
Change the directory to the folder containing the Creditcoin documentation.
Set-location "C:/My Folder"
Opening Command Prompt on Mac OS X
Open Terminal by pressing cmd + spacebar and searching for 'Terminal'.
Change the directory to the folder containing the Creditcoin documentation.
cd ~/Documents
Start the Creditcoin Miner
Run the command:
docker-compose -f Server/creditcoin-with-gateway.yaml up
Upon running the above command, the blockchain will start downloading and messages such as the following will be displayed:
sawtooth-validator | [2020-01-01 11:22:33.444 DEBUG    permission_verifier] Chain head is not set yet. Permit all.
sawtooth-validator | [2020-01-01 11:22:33.444 DEBUG    completer] Request missing predecessor
Get your miner sighash and balance
You will firstly need to get your miner key and edit the clientConfig.json file in order to retrieve your miner balance and sighash.
Get your miner key
Run the Server
While the shell window is populated with messages, open a new instance of the command prompt / terminal  
In the new command prompt window, get the validator private key by running the following command:
docker exec sawtooth-validator-default cat /etc/sawtooth/keys/validator.priv
Copy the outputted key of the above
Open the Client/clientConfig.json file
Paste the copied key into the signer value 
Set the creditcoinRestApiURL as follows:
creditcoinRestApiURL: ''
Retrieve your miner sighash and balance
Start the Creditcoin client:
docker-compose -f Client/creditcoin-client.yaml up -d
Access the Creditcoin Client bash by running the following command: docker exec -it creditcoin-client bash
Get your sighash by running the following command: ./ccclient sighash
Check your balance by running the following command: ./ccclient show Balance 0
Check your balance on the Creditcoin Explorer website
You can check your miner balance by following the link below and replacing the {insert_sighash} with your miner sighash. This is useful for checking your balance without having to run any Docker containers or start the Creditcoin client.
​ https://www.creditcoinexplorer.com/address-detail?address={sighash_here}
If upon running command to check your balance you are getting error 404, then the address has not mined any blocks yet and there are no records in the blockchain API relating to that address.
Stop the Creditcoin Miner
Run the command:
docker-compose -f Server/creditcoin-with-gateway.yaml down
Block successfully mined
Upon successfully mining a block, the following message will be displayed:
sawtooth-validator | [2020-01-01 12:34:56.789 INFO     publisher] Claimed Block: [block id] (block_num:[block number], state:[state id], previous_block_id:[previous block id])
Creditcoin Client
Creditcoin Client Configuration File
To set-up the Creditcoin Client configuration, you will need the following:
An Ethereum private key
Your Ethereum RPC mainnet node
A 256 bit SECP256K1 ECDSA key
Firstly, download the Creditcoin files (If you did this step for the Creditcoin Miner, you already have these files).
Afterwards, extract the files in a directory of your choice. You will need to configure the following:
Client/clientConfig.json
You can edit this file by opening it with your preferred text editor
{
  "signer": "<256_bit_key_secp256k1_ECDSA>",
  "creditcoinRestApiURL": "",
  "ethereum": {
    "creditcoinContract": "0xa3ee21c306a700e682abcdfe9baa6a08f3820419",
    "creditcoinContractAbi": "<creditcoinContractAbi",
    "rpc": "<ethereum_node_url>",
    "secret": "<ethereum_private_key_no_0x>",
    "gasPriceInGwei":  "<set_to_override_gas_price>"
  },
  "ethless" : {
    "rpc": "<ethereum_node_url>"
  },
  "erc20": {
    "rpc": "<ethereum_node_url>"
  },
  "bitcoin": {
    "secret": "<bitcoin_private_key>",
    "rpc": "<bitcoin_rpc_node_url>",
    "credential": "<rpc_username:rpc_password>",
    "fee": "10000"
  },
}
You will need to edit the following elements:
signer: Your 256 bit SECP256K1 ECDSA key
ethereum/ethless/erc20:
rpc:  RPC mainnet node (e.g. https://mainnet.infura.io/v3/xxxxxxxxxxxx) or your own personal mainnet node (e.g. http://localhost:8545 )
secret: Your ethereum private key without the 0x prefix
You can use the Bitcoin section to loan/fundraise Bitcoin. Otherwise, you can leave it blank.
Start the Creditcoin Client
Start client client docker container:
docker-compose -f Client/creditcoin-client.yaml up -d
Get your Client sighash:
docker exec -it creditcoin-client bash
Get your Client sighash
Get your client sighash by typing ./ccclient sighash into the Creditcoin Client bash  
Stop the Creditcoin Client
Run the command:
docker-compose -f Client/creditcoin-client.yaml down
Troubleshooting
Recovering from an incorrectly formatted command
From time-to-time, the Creditcoin client may get ‘stuck’ on an improperly formatted command line. To recover from this run the command rm plugins/progress.txt, then retype the command correctly.
The purpose of progress.txt is to rerun an interrupted command. For example while waiting for sufficient confirmation on Ethereum network, a user can stop the Creditcoin Client, then later run the Creditcoin Client command (./ccclient) again without parameters. Here we're removing the invalid command to prevent it from automatically rerunning.
What is Creditcoin
Miner FAQ
Last updated 2 months ago