Mantrachain is a global real-world assets platform built on blockchain technology. It leverages advanced blockchain features to facilitate the tokenization and trading of real-world assets.

• Overview
• Features
• Joining the Mainnet
• Getting Started
• Development
• Architecture
• Modules
• Security

Mantrachain is designed to bridge the gap between traditional assets and the blockchain world. By enabling the tokenization of real-world assets, it opens up new possibilities for asset management, trading, and financial innovation.

• Real-world asset tokenization
• Advanced blockchain technology integration
• Multi-token support for transaction fees
• Custom fee market implementation
• Cosmos SDK-based architecture

Please visit the official instructions on how to join the Mainnet here.

To get started with Mantrachain, you'll need to set up your development environment.

• Go 1.23 or later

1. Clone the repository:

   git clone https://github.com/MANTRA-Chain/mantrachain.git
   cd mantrachain

2. Build the project:

   make install

make test-unit

For the first time, run the following command to build image and run e2e tests:

make test-e2e

If you already have the image built, you can run the e2e tests directly:

cd test/e2e && go test -v -timeout 30m

Use same golangci-lint version as used in CI/CD pipeline to ensure consistency.

docker run -t --rm -v $(pwd):/app -w /app golangci/golangci-lint:v1.64.8 golangci-lint run

docker run -t --rm -v $(pwd):/app -w /app golangci/golangci-lint:v1.64.8 golangci-lint run --fix

Mantrachain follows the Cosmos SDK architecture and implements several custom modules to achieve its functionality. The project uses Architecture Decision Records (ADRs) to document important architectural decisions.

For more information on the architecture and design decisions, please refer to the ADR directory.

Mantrachain includes several custom modules:

• x/sanction: Blacklisting of addresses to prevent transactions from sanctioned entities.
• x/tokenfactory: Allows for the creation and management of new tokens (based on Neutron's implementation).
• x/tax: Handles tax-related operations within the chain.

For detailed information on each module, please refer to their respective README files in the x/ directory.

We take security seriously. If you discover a security issue, please bring it to our attention right away!

Please refer to our Security Policy for more details on reporting vulnerabilities.

For more detailed information, please check the documentation in the respective directories and files within the repository.