Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/opentron/opentron
OpenTron is the first fully independent implementation of the Tron protocol, written in Rust.
https://github.com/opentron/opentron
blockchain tron tron-protocol
Last synced: 3 months ago
JSON representation
OpenTron is the first fully independent implementation of the Tron protocol, written in Rust.
- Host: GitHub
- URL: https://github.com/opentron/opentron
- Owner: opentron
- License: apache-2.0
- Created: 2020-07-31T20:04:00.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-13T17:19:43.000Z (over 1 year ago)
- Last Synced: 2024-07-28T18:35:55.335Z (4 months ago)
- Topics: blockchain, tron, tron-protocol
- Language: Rust
- Homepage: https://medium.com/@oikoscash/announcing-opentron-753b344e2a4c
- Size: 2.65 MB
- Stars: 65
- Watchers: 7
- Forks: 20
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
[](https://t.me/opentron)
OpenTron is an implementation of the Tron blockchain written in Rust. This project is under active development and is
not ready for general use.
- [Rationale](#rationale)
- [Roadmap](#roadmap)
- [TODOs](#todos)
- [Quickstart](#quickstart)
- [License](#license)
- [Contribution](#contribution)
## Rationale
1. Decentralised
The Tron network currently has [one and only implementation](https://github.com/tronprotocol/java-tron). This
has lead to some criticism of Tron being too centralized. We want to change that by providing an alternative
implementation and independent development team.
2. High performance
API calls to java-tron nodes often results in CPU timeouts and other "out of resource" related errors. This is partly
due to java-tron being written in Java, a garbage collected language that runs on a virtual machine. OpenTron is
written in Rust, a modern compiled language that is increasingly adopted for blockchain and systems development due
to its high performance, safety and modern design.
3. Modern codebase
Java-tron was forked a few years ago from a Java Ethereum implementation. It has accumulated a lot of technical debt
over the years and has a lot of inconsistent or missing documentation. We believe that a greenfield implementation
will enable us to produce a cleaner code base that is easier to understand, improve and extend. In addition, since
Rust has first class support for WebAssembly, it will be possible to re-use its code for creating web based clients,
wallets, explorers, etc.
## Roadmap
- [x] Block data sync, only blocks (raw transactions), without transaction info and any other state data. Handle chain fork and block Merkle tree verification.
- [ ] Simple transaction broadcast, without much verification, just broadcast transactions to the network as quickly as possible(an airdrop tool can be made from it)
- [x] Handle transaction verification. all state data will be available. (difficult, EVM engine, resource consumption mode, witness/vote/proposal, chain parameter are all handled at this stage, to make the state data identical as java-tron )
- [x] Build a query API layer upon state data. json-rpc.
- [ ] Build a event API layer upon state data.
- [ ] block mining logic (difficult, DPoS mining, need resource to become an SR)
### TODOs
- [ ] Full Tron Protocol implementation
- [x] proto2: refactor the protobuf
- [x] primitives
- [x] use primitive-types
- [x] keys: Address, PublicKey, PrivateKey, Signature
- [x] config file
- [x] genesis block parsing
- [x] toml config file parsing
- [x] reorganize chain parameters
- [x] chain-db
- [x] Block / Transaction
- [x] state-db
- [x] discover protocol
- [ ] channel protocol
- [x] demo works
- [x] sync
- [ ] TODO: minor bug fix, timeout error
- [ ] integrate with state-db
- [ ] mempool - block producing
- [x] governance
- [x] witness schedule
- [x] voting
- [x] proposal
- [ ] block reward - still has minor bug
- [x] executor/actuator
- [x] account
- [x] trx/trc10 assets
- [x] witness and voting
- [x] proposal
- [x] resource freeze/unfreeze
- [x] exchange
- [x] smart contract
- [ ] market (4.1)
- [ ] EVM / TVM
- [x] 3.7 TVM and `tvm` crate
- [x] 4.0 TVM with zksnark: `ztron` crate
- [x] shielded trc20 transaction - ztron
- [x] integration
- [x] 4.1 TVM
- [x] CREATE2
- [ ] massive tests against resource usage, exit_reason
- [ ] RPC API replacement
- will not support gRPC
- might have json-rpc support
- [x] GraphQL API for chain query and state query
- [ ] GraphQL API to broadcast transaction
## Quickstart
See [INSTALL.md](./INSTALL.md) for more detailed information.
```console
> # Install rust-nightly
> curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly
> rustup component add rustfmt
> # Install protoc
> brew install protobuf # macOS
> sudo pacman -S protobuf # ArchLinux
> sudo apt install protobuf-compiler libprotobuf-dev # Ubuntu / Debian
> # Get code
> git clone https://github.com/opentron/opentron.git
> # Compile opentron
> cd ./opentron/
> cargo build
> cargo run -- --config etc/conf.nile.toml
```
### Local Testnet
```sh
./target/release/opentron --config ./etc/conf.local-test.toml
```
Then open and play with the GraphQL APIs.
## License
Licensed under either of
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or )
- MIT license ([LICENSE-MIT](LICENSE-MIT) or )
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any
additional terms or conditions.