Creditcoin is a network that enables cross-blockchain credit transaction and credit history building. Creditcoin uses blockchain technology to ensure the objectivity of its credit transaction history: each transaction on the network is distributed and verified by the network.
The Creditcoin protocol was created by Gluwa. Gluwa Creditcoin is the official implementation of the Creditcoin protocol by Gluwa.
For more information, see creditcoin.org, or read the original whitepaper.
First, you must complete the basic environment setup.
The provided cargo run command will launch a temporary node and its state will be discarded after
you terminate the process. After the project has been built, there are other ways to launch the
node.
cargo run --release -- --dev --tmpWARNING: running natively on Windows is unsupported.
Once the project has been built, the following command can be used to explore all parameters and subcommands:
./target/release/creditcoin-node -hA node can be configured to connect to different Creditcoin networks. Each network has different configurations and use cases.
| Devnet | Testnet | Mainnet | |
|---|---|---|---|
| Overview | Local/public development environment | Public testing environment | Live production environment |
| Users | Developers | Developers & testers | End users |
| Function | To develop new features & improvements | To test new features & improvements | To secure credit history on-chain |
| Tokens | Test tokens with no real world economic value | Test tokens with no real world economic value | Real tokens with economic value |
| Chain history | Wiped frequently | Wiped occasionally | Preserved |
The network configuration is specified using the --chain flag and the --bootnodes flag, which specifies the initial nodes to connect to. Currently, only the test network chain specs include bootnodes. The main and dev networks bootnodes must be specified manually.
Example:
./target/release/creditcoin-node --chain main --bootnodes "/dns4/bootnode.creditcoin.network/tcp/30333/p2p/12D3KooWAEgDL126EUFxFfdQKiUhmx3BJPdszQHu9PsYsLCuavhb"Creditcoin networks are configured using a ChainSpec. The ChainSpec is a JSON file that defines the initial configuration of the network. To use a ChainSpec, use the --chain flag when starting the node.
- Mainnet:
--chain main - Testnet:
--chain test - Devnet:
--chain dev
Bootnodes are nodes that are always on and can be used to bootstrap new nodes and discover other nodes in the network. To use a bootnode, use the --bootnodes flag when starting the node followed by the bootnode's address.
Mainnet bootnodes:
/dns4/bootnode.creditcoin.network/tcp/30333/p2p/12D3KooWAEgDL126EUFxFfdQKiUhmx3BJPdszQHu9PsYsLCuavhb/dns4/bootnode2.creditcoin.network/tcp/30333/p2p/12D3KooWSQye3uN3bZQRRC4oZbpiAZXkP2o5UZh6S8pqyh24bF3k/dns4/bootnode3.creditcoin.network/tcp/30333/p2p/12D3KooWFrsEZ2aSfiigAxs6ir2kU6en4BewotyCXPhrJ7T1AzjN
Testnet bootnodes:
/dns4/testnet-bootnode.creditcoin.network/tcp/30333/p2p/12D3KooWG3eEuYxo37LvU1g6SSESu4i9TQ8FrZmJcjvdys7eA3cH/dns4/testnet-bootnode2.creditcoin.network/tcp/30333/p2p/12D3KooWLq7wCMQS3qVMCNJ2Zm6rYuYh74cM99i9Tm8PMdqJPDzb/dns4/testnet-bootnode3.creditcoin.network/tcp/30333/p2p/12D3KooWAKUrvmchoLomoouoN1sKfF9kq8dYtCVFvtPuvqp7wFBS
Devnet bootnodes:
/dns4/devnet-bootnode.creditcoin.network/tcp/30333/p2p/12D3KooWMtJz2E3ENY66Sfoa1MDmV3ZATXRKUWdeZgtEjfme6iwS
This command will start the single-node development chain with persistent state:
./target/release/creditcoin-node --devPurge the development chain's state:
./target/release/creditcoin-node purge-chain --devStart the development chain with detailed logging:
RUST_BACKTRACE=1 ./target/release/creditcoin-node -ldebug --devOnce the node template is running locally, you can connect it with Polkadot-JS Apps front-end to interact with your chain. Click here connecting the Apps to your local node template.
If you want to see the multi-node consensus algorithm in action, refer to our Start a Private Network tutorial.
Removing collect_coins 08.03.24