||6 days ago|
|bin||1 month ago|
|blockstore||5 months ago|
|build||2 months ago|
|dist||5 months ago|
|genesis||1 month ago|
|keys||3 months ago|
|log||4 months ago|
|src||6 days ago|
|state||3 months ago|
|test||6 days ago|
|.editorconfig||5 months ago|
|.eslintrc.json||4 months ago|
|.gitignore||5 months ago|
|.mocharc.json||4 months ago|
|.nycrc.json||4 months ago|
|.prettierrc.json||5 months ago|
|CODE_OF_CONDUCT.md||5 months ago|
|Dockerfile||1 month ago|
|LICENSE||5 months ago|
|README.md||6 days ago|
|package-lock.json||6 days ago|
|package.json||6 days ago|
|tsconfig.json||2 months ago|
A blockchain implementation using Practical Byzantine Fault Tolerance (PBFT) in combination with Proof-of-Stake (PoS) as a consensus algorithm. It is therefore a "Weighted Practical Byzantine Fault Tolerance" consensus.
This is a fully anonymous ("Privacy-By-Design"), very lightweight, fast, low-energy and permissionless blockchain.
The load of the PBFT consensus is very much network bound. The chain gets built by "communication" instead of "computation". Therefore lots of messages are crossing the network.
The peers in the network communicate via websockets. The peers build the tunnels between each other using a secure and efficient "Challenge/Auth" process based on regular asymmetric keys (public/private keys). "Sodium" gets used as the single crypto library - so all crypto-related code is based on solid, very well tested and proven code.
Architecture / Flow
The network itself is permission- and leaderless. Each peer in the network represents a round-based state machine. Each round produces a block. The blocks do have a variable size and blocks are produced on demand.
- New block proposal: each peer in the network may anytime propose a bundle of transactions, by transmitting 1-n own signed transactions to the network.
- Each peer receiving such a proposal may transmit its vote to the network. If a peer also has own transactions it adds his own transactions to the proposal first and re-transmits the proposal to the network. Per round, each peer can only add one stack of own transactions.
- As soon as a peer in the network detects that 2/3 of the whole network have voted for a specific proposal, it issues a commit message and broadcasts it to the network.
- As soon as 2/3 of the network have issued commit messages, peers starting to issue confirm messages. The new block gets written to the chain.
- A new round starts.
Create Your Local Environment
To create a docker based local environment use the project https://codeberg.org/diva.exchange/diva-dockerized.
The configuration can be controlled using environment variables.
URL to a entrypoint in the network, like http://diva.i2p. Default: (empty)
Maximum number of blocks kept in memory.
Between 7 and 64 peers.
Between 2 minutes and 10 minutes (120'000ms and 600'000ms).
Interval, in milliseconds, to refresh the network (connect to peers, if needed).
Default: 5 * NETWORK_REFRESH_INTERVAL_MS
Timeout, in milliseconds, after authorisation fails.
Interval, in milliseconds, to ping the peers in the network.
Default: 5 * NETWORK_PING_INTERVAL_MS
Interval, in milliseconds, to clean up the network environment (like gossiping data).
Number of pings from a stale peer until synchronization gets triggered.
Default: 10 Maximum number of blocks of synchronization message might contain. Must not exceed BLOCKCHAIN_MAX_BLOCKS_IN_MEMORY.
Whether to log all network traffic (very verbose). Set to 1 to enable verbose logging.
Interval, in milliseconds, to check whether the block pool is stale.
Quering the Blockchain
Optional query parameters:
- limit, integer, > 0
- gte, integer, > 0
- lte, integer, > 0
/blocks?lte=1will return the genesis block
/blocks?limit=1will return the latest block
/blocks?limit=5will return the latest 5 blocks
/blocks?gte=42<e=42will return block on height 42
/blocks?gte=42<e=43will return blocks 42 and 43
Optional query parameters:
- size, integer, > 0
Joining and Leaving the Network
How to Run Unit Tests
Unit tests can be executed using:
npm run test
Unit tests contain functional tests and will create some blocks within the local storage. The underlying network (like I2P) must be configured properly (the configuration is Work-In-Progress).
To lint the code, use
npm run lint
Contact the Developers
On DIVA.EXCHANGE you'll find various options to get in touch with the team.
Talk to us via Telegram https://t.me/diva_exchange_chat_de (English or German).
Your donation goes entirely to the project. Your donation makes the development of DIVA.EXCHANGE faster.
Awesome, thank you!