ParallelChain Mainnet Runtime is a State Transition Function to transit from an input state of the blockchain to next state. It is also the sole system component to handle Smart Contract that is primarily built from Rust code by using ParallelChain F Smart Contract Development Kit (SDK).
f(WS, BD, TX) -> (WS', R)
WS = World state represented by set of key-value pairs
BD = Blockchain Data
TX = Transaction, which is essentially a sequence of Commands
R = Receipt, which is a sequence of Command Receipts correspondingly.
High level description on implementation of pchain-runtime can refer to Parallelchain Protocol.
Data types related to blockchain that are frequently used can be found on the crate ParallelChain Types.
Blockchain State model (World State) can refer to the crate ParallelChain World State.
The mentioned Smart Contract Development Kit can refer to the crate ParallelChain Smart Contract SDK.
Major modules of this repository are organized as following:
Execution:
transition: Entry point of state transition function.execution: Implementation of execution process.wasmer: Implementation of components to use wasmer as Smart Contract Execution Runtime.contract: Implementation of components related Smart Contract, such as instantiation, host/guess function interface, etc.
Types and Data Model:
types: General data types used in Runtime.read_write_set: Implementation of data read-write operations to World State.
Constants:
formulas: General constants and equations used in Runtime.gas: Specific to gas calculation functions and constants.
The version of this library reflects the version of the ParallelChain Protocol which it implements. For example, the current version is 0.4.4, and this implements protocol version 0.4. Patch version increases are not guaranteed to be non-breaking.
Open an issue in GitHub if you:
- Have a feature request / feature idea,
- Have any questions (particularly software related questions),
- Think you may have discovered a bug.
Please try to label your issues appropriately.