# The Commercio.network Blockchain Documentation
Commercio.network is an Open Source Blockchain (opens new window) that allows people to create:
- eID electronic identities
- eSignatures electronic signature
- eDelivery certified delivery
Anyone can exchange electronic documents in a legally binding way thanks to our eIDAS Compliance.
# What is a blockchain ?
A blockchain is a big distributed database. Think of it as a huge spreadsheet runned simultaneously on millions of worldwide computers. It’s a peer to peer network of nodes where you can settle transactions without the need of any trusted third party.
A node is a computer that is running the Commercio.network node software it is connected to other computers on the same network and there are two kind of nodes:
Full node Full nodes are nodes that stores the whole transaction history. They connect to the blockchain and each time a new block is finalized, they write it on their hard disk. This means that being a full node you will be able to read the whole chain transaction history, you will need to have a large hard disk space if you want to keep it running.
Validator node Validator nodes are full nodes with the added ability of validating new transactions that should be added to the chain. In order to do so, they possess a private key with which they sign the transactions marking them as valid. In exchange of their work, they get a reward that is given to them each time a new block is created.
# What is the the software that allow this blockchain to exist ?
cn
is the name of the Commercio.network (opens new window) blockchain application.
It is shipped with commercionetworkd
: The Commercio.network software provided daemon to run a full-node of the cn
application and the command-line interface, which enables interaction with a Commercio.network full-node.
cn
is built on top of the Cosmos SDK (opens new window) using the following modules:
x/auth
: Accounts and signatures.x/bank
: Tokens transfers.x/staking
: Staking logic.x/distribution
: Fee distribution logic.x/slashing
: Slashing logic.x/params
: Handles app-level parameters.x/ibc
: (wip).x/wasm
: (wip).
On top of that cn
comes with the following custom modules:
x/ante
: Custom fees.x/documents
: Documents sharing.x/did
: Self sovereign identities creation.x/government
: On-chain government.x/commerciokyc
: Invite new members and get ABR rewards.x/commerciomint
: Mint CCCs.x/vbr
: Run Validator nodes and get VBR rewards
# Can I run this cn
Node software ?
Sure. Please follow the step by step instructions on Running Nodes
# How can I develop an app on commercio.Network ?
API
The EASY WAY is to signup to commercio.app (opens new window) and use the CommercioAPI. You can start developing blockchain solutions in minutes with the programming language you are most familiar.
The CommercioAPI removes the complexity and the security of managing your users' wallets.
SDK
If you want to move forward the develop of the follow packages you can fork them and pull request upgrades.
We have released SDK in 4 main languages
Dart/Flutter | Kotlin/Java | C#/Dot.net | GoLang | |
---|---|---|---|---|
Sacco | Repo (opens new window) | Repo (opens new window) | Repo (opens new window) | Repo (opens new window) |
CommercioSDK | Repo (opens new window) | Repo (opens new window) | Repo (opens new window) | Later |
Actual Sdks available are deprecated e no longer mantained.
Basic procedure for sending autonomusly a message is decribed here Create, sign and send a transaction
# What is eIDAS Compliance ?
The eIDAS directive (Electronic Identification, Authentication and Trust Services) is an EU regulation on electronic identification and trust services for electronic transactions in the European Single Market.
The eIDAS org oversees electronic identification and trust services for electronic transactions in the European Union's internal market. It regulates electronic signatures, electronic transactions, involved bodies, and their embedding processes to provide a safe way for users to conduct business online like electronic funds transfer or transactions with public services. Both the signatory and the recipient can have more convenience and security. Instead of relying on traditional methods, such as appearing in person to submit paper-based documents, they may now perform transactions across borders.
# The advantage of using a eIDAS Compliant blockchain
According to Article 25.1 of the eIDAS Regulation, a standard electronic signature may not be denied legal effect and admissibility as evidence in legal proceedings solely on the grounds that it is in an electronic form or that it does not meet the requirements for qualified electronic signatures.
# The Commercio Token (COM)
Commercio.network is a sovereign network that has its own native crypto currency which serves for:
- Incentivize users to manage the nodes of this network
- Incentivize users to grow this network by inviting other users.
Through this Token all active participants can benefit from the growth of the network.
The Commercio Token (COM) in not inflationary since it has a 60 million limited supply
- The main purpose of the Token is to be a unit of value that can be placed on stake to secure the network of Commercio.network by the validators nodes It is a STAKING TOKEN (utility Token)
- The price is VARIABLE and is determined according supply and demand by the market
# The Commercio Cash Credit (CCC)
Commercio.network is an Enterprise-grade third generation blockchain that removes some complexity problems of second generation blockchain like BitCoin or Ethereum:
Any transaction Cost on our chain is defined in EURO and it costs €0.01 which makes it maybe the first StableChain in history.
Through this Token all active participants can benefit from the growth of the network.
The Commercio Cash Credit (CCC) ha an unlimited supply and can be minted only by freezing the COM Token
- The main purpose of the Token is to be a unit of value that can be used to perform transactions on chain. It is a FEE TOKEN (utility Token)
- The price is FIXED and is 1 EURO/CCC + VAT
NB: transaction fees could be paid with COM, but the cost is fixed to 0.01 COM.
# Main-net Vs Test-net
# The Main-net
Mainnet is the main blockchain of Commercio.network. If someone says Commercio mainnet, it means the real Commercio.network blockchain.
Unlike testnet which is an open network for testing purposes, mainnet is the real deal. Tokens on the Commercio.network mainnet have real economic value, be careful.
A view of the status of mainnet is possible throught the Explorer, a Webapp named Almerico (whose code is Opensource and available here ) that query the mainnet chain.
Main-net Almerico: mainnet.commercio.network (opens new window)
# The Test-net
Testnet, as the name suggests, is an alternative network for the developers for testing purposes. It's a playground. You can use testnet as a demo network for experimenting. It’s like the beta stage of a blockchain network. A testnet is a blockchain made available for developers. It allows anyone to conduct experiments without wasting real tokens. A testnet is like a demo network where tokens do not have any value. You can easily test out any app on a testnet because it provides you a sandbox environment separate from the main blockchain.
# Faucet
In the testnet a tool that allows to recharge a wallet (with COM token) is available.
A destination address (addr
) and the amount to be recharged with (amount
expressed in ucommercio) must be provided to the faucet endpoint (https://faucet-testnet.commercio.network/give).
Example
Suppose you want to recharge with 10 COM
your wallet address did:com:1fjqvugs6dfwtax3k4zzh46pswmwryc8ff7f0mv
This is the request you need to make:
https://faucet-testnet.commercio.network/give?addr=did:com:1tq5mvp7j4vtew08htaswsyjugzewe4jyph20qr&amount=10000000
Limits
amount
: There is a limit in the amount value of 100000000 ucommercio
ATTENTION : A faucet
for CCC is not available. The Buy function (coming soon
) in the dev.commercio.app must be used
Test-net Almerico: testnet.commercio.network (opens new window)
# Tools
# Explorer Almerico
Is an online Web app that enables you to search for real-time and historical information about Commercio blockchain, including data related to blocks, transactions, addresses, and more.
Main-net Almerico: mainnet.commercio.network (opens new window)
Test-net Almerico: testnet.commercio.network (opens new window)
# Keplr wallet extension
Keplr is a Chrome
browser extension wallet for the Cosmos
interchain ecosystem.
Is possible to connect your Keplr wallet to Almerico explorer and perform some action such as delegate, claim, undelegate, redelegate, vote message.
Connecting keplr is easy throught a simple function button.

More details avaialble here
# Commercio Wallet App
Is a Mobile app available in the store that provide a wallet to the user and permit to interact with the blockchain for some specific function such as send tokens, delegate, claim, undelegate, redelegate messages
The wallet app can connect both to main-net and test-net
# LCD
Light Client Daemon (LCD REST Server) is a piece of software that connects to a full node to interact with the blockchain
Thus you can also query the Commercio blockchain through LCD rest API available at specific endpoint
# Commercio app
Is a hosted wallet platform that permit to interact with the blockchain throught its API : documentation available here
# Support
In order to suppor the community feel free to suggest enhancement or report bugs opening specific issues on the following Repository
- Present documentation (opens new window)
- Explorer - Almerico (opens new window)
- Commercio Wallet App (opens new window)
- Commercio App (opens new window)
Support could be also asked to the community subscribing into our Discord (opens new window)
Keep in touch with us throught our socialmedia channels available on top menu