Official Golang implementation of the Mechain Blockchain. It uses cometbft for consensus and build on cosmos-sdk.
Mechain aims to facilitate the decentralized data economy by simplifying the process of storing and managing data access, as well as linking data ownership with the massive DeFi context of the other EVM-compatible blockchains.
Mechain operates through three core components, which distinguish it from existing centralized and decentralized storage systems:
- It enables ethereum-compatible addresses to create and manage data and token assets seamlessly.
- It provides similar API primitives and performance as popular existing Web2 cloud storage systems.
These features offer a novel and innovative approach to decentralized data management and ownership in the DeFi space. Overall, Mechain presents a promising solution for bringing greater flexibility, control, and efficiency to users in the decentralized data economy.
The software and related documentation are under active development, all subject to potential future change without notification and not ready for production use. The code and security audit have not been fully completed and not ready for any bug bounty. We advise you to be careful and experiment on the network at your own risk. Stay safe out there.
The center of Mechain are two layers:
- A new storage-oriented blockchain, and
- network composed of "storage providers".
This repo is the official implementation of Mechain blockchain.
The blockchain of Mechain serves a dual purpose of maintaining the ledger for users as well as the storage metadata as common blockchain state data. The blockchain has its native token, ZKME, and is utilized for gas and governance functionalities. Governance is further enabled through the staking logic that is unique to the Mechain blockchain.
The Mechain blockchain has two categories of states that are stored on-chain:
-
The ledger of accounts and their ZKME balance.
-
The metadata of the object storage system and service providers, along with the metadata of the objects stored on the storage system, permission and billing information pertaining to the storage system.
Transactions on the Mechain blockchain have the ability to modify the aforementioned on-chain states. These states and the transactions that affect them are at the core of the economic data on the Mechain platform.
Users looking to create or access data on Mechain may do so by engaging with the Mechain Core Infrastructure through decentralized applications known as Mechain dApps. These dApps provide a user-friendly interface for interacting with the platform, enabling users to create and manipulate data in a secure and decentralized environment.
Visit our official documentation site for more info.
More advanced script and command line usage, please refer to the Tutorial.
x/evm: bridges Ethereum's smart contract capabilities with Cosmos' cross-chain functionality and governance systems.x/challenge: generate random data challenge events or accept user's data challenge requests.x/payment: handle the billing and payment of the storage module. User fees are paid through "Stream" on Mechain, with a constant rate of payment from users to Storage Providers (SP) with charges applied every second of usage.x/sp: manage the various storage providers within the network.x/storage: users can manage their storage data through this module, like create/delete bucket, create/delete storage object.x/permission: user can manage its resource permission through this module, like put/delete policy for storage object.
And the following modules are in cosmos-sdk:
x/crosschain: manage the cross chain packages, like store/query/update the cross chain package, channels, sequences.x/gashub: provide a governable and predictable fee charge mechanism.x/oracle: provide a secure runtime for cross chain packages.x/staking: based on the Proof-of-Stake logic. The elected validators are responsible for the security of the mechain blockchain. They get involved in the governance and staking of the blockchain.
Refer to the docs to dive deep into these modules.
- mechain-Contract: the cross chain contract for Mechain that deployed on ethereum-compatible network.
- mechain-Storage-Provider: the storage service infrastructures provided by either organizations or individuals.
- mechain-relayer: the service that relay cross chain package to both chains.
- mechain-cmd: the most powerful command line to interact with Mechain system.
- Awesome Cosmos: Collection of Cosmos related resources which also fits Mechain.
Thank you for expressing your willingness to contribute to the Mechain source code. We deeply appreciate any help, no matter how small the fix. We welcome contributions from anyone on the internet, and we value your input.
If you're interested in contributing to Mechain, please follow these steps:
- Fork the project on GitHub.
- Fix the issue.
- Commit the changes.
- Send a pull request for the maintainers to review and merge into the main codebase.
If you're planning to submit more complex changes, we kindly suggest that you reach out to the core developers first. This could be done through a GitHub issue or our upcoming Discord channel. By doing so, you could ensure that your changes are aligned with the project's general philosophy, and you can receive valuable feedback that will make your efforts lighter as well as our review and merge procedures quick and simple.
Once again, thank you for your willingness to contribute to the Mechain project. We look forward to working with you!
The mechain library (i.e. all code outside the cmd directory) is licensed under the
GNU Lesser General Public License v3.0,
also included in our repository in the COPYING.LESSER file.
The mechain binaries (i.e. all code inside the cmd directory) is licensed under the
GNU Affero General Public License v3.0, also
included in our repository in the COPYING file.
This project is fork from:
Significant changes have been made to adapt the project for specific use cases, but much of the core functionality comes from the original project.