# Vietnam blockchain ecosystem design

This document is created as a mutual understanding on the design. The right understanding on design is crucial to successful delivery, eliminating misunderstanding and assumptions. The document will be written in English for correct expression of many native blockchain terms, not yet available in Vietnamese.

## I. The vision

"To control on-chain activities in Vietnam"
* Kiểm soát (control): kiểm tra (check), rà soát (review). Control means checking and reviewing in Vietnamese.
* On-chain activities: activities originated from a blockchain infrastructure
* In Vietnam: any on-chain activities that pass the digital border of Vietnam

## II. The design


The core of the system will be the Government router chain. Routers should be as simple in logic as possible to minimize being a chokehold and future design-breaking changes.
* To check effectively, all transactions should go through these routers for basic checks.
* To extend arbitrary checking rules, routers can forward transactions to more specialized chains for further checking.
* To adapt with different transaction formats, routers should support various transaction decoding/encoding schemes.

Government router chain role:
1. Any transactions between global ecosystems (Bitcoin, Etherum, Solana, ...) and Vietnam legal-compliant ecosystems will be routed through Government router chain.
2. Any transactions among Vietnam legal-compliant ecosystems will be routed through Government router chain.

Banking chains serve as the on-chain balance sheet of the system where all Vietnamese on-chain balance history is recorded and verified. It is not yet known exactly how banks want to engage with blockchain: separate chains or a joint chain.

There will be various legal-compliant chains connected to the government router chain. On Vietnam legal-compliant chains, experiments can be conducted freely only with prior notice of consequences. It is not yet known exactly how legal-compliant chains will be designed.

### II. 1. Gov router chain
1. Adaptor logic:
* allow various decoding/encoding schemes for different ecosystem transaction
* extracting special transaction header from decoded transaction data

2. Routing logic:
* allow registering/removing chains
* routing arbitrary transactions to/from registered chains
* querying registered chains

3. Checking logic:
* allow registering/removing transaction header rules (Ex: KYC information)
* checking transaction header rules
* querying transaction header rule details

4. Parallel processing:
* Transactions can be checked and forwarded independently of one another, thus allowing for massive parallelization

### II. 2. Banking chains
Banking chains can only accept cross - chain transactions routed from Gov router chains

### II. 3. Legal-compliant chains
Legal-compliant chains can only accept cross - chain transactions routed from Gov router chains

## III. For considerations
1. As more throughputs are needed, there maybe a need to build more router chains
2. It would save a lot of maintenance cost by using the same chain framework for all chains in Vietnamese blockchain ecosystem
3. Database bloating is a very real danger as it complicates changing chain logic and syncing