Repository files navigation

Miraland is inspired by Solana and initial code base is derived/forked from Solana.

$ curl https://sh.rustup.rs -sSf| sh$source$HOME/.cargo/env$ rustup component add rustfmt

When building the master branch, please make sure you are using the latest stable rust version by running:

$ rustup update

When building a specific release branch, you should check the rust version inci/rust-version.sh and if necessary, install that version by running:

$ rustup install VERSION

Note that if this is not the latest rust version on your machine, cargo commands may require anoverride in order to use the correct version.

On Linux systems you may need to install libssl-dev, pkg-config, zlib1g-dev, protobuf etc.

On Ubuntu:

$ sudo apt-get update$ sudo apt-get install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang cmake make libprotobuf-dev protobuf-compiler

On Fedora:

$ sudo dnf install openssl-devel systemd-devel pkg-config zlib-devel llvm clang cmake make protobuf-devel protobuf-compiler perl-core

$ git clone https://github.com/miraland-labs/miraland.git$cd miraland

$ ./cargo build

Run the test suite:

$ ./cargotest

Start your own testnet locally, instructions are in theonline docs.

• devnet - stable public cluster for development accessible viadevnet-mln.miraland.com. Runs 24/7. Learn more about thepublic clusters

First, install the nightly build of rustc.cargo bench requires the use of theunstable features only available in the nightly build.

$ rustup install nightly

Run the benchmarks:

$ cargo +nightly bench

The release process for this project is describedhere.

To generate code coverage statistics:

$ scripts/coverage.sh$ open target/cov/lcov-local/index.html

Why coverage? While most see coverage as a code quality metric, we see it primarily as a developerproductivity metric. When a developer makes a change to the codebase, presumably it's asolution tosome problem. Our unit-test suite is how we encode the set ofproblems the codebase solves. Runningthe test suite should indicate that your change didn'tinfringe on anyone else's solutions. Adding atestprotects your solution from future changes. Say you don't understand why a line of code exists,try deleting it and running the unit-tests. The nearest test failure should tell you what problemwas solved by that code. If no test fails, go ahead and submit a Pull Request that asks, "whatproblem is solved by this code?" On the other hand, if a test does fail and you can think of abetter way to solve the same problem, a Pull Request with your solution would most certainly bewelcome! Likewise, if rewriting a test can better communicate what code it's protecting, pleasesend us that patch!

All claims, content, designs, algorithms, estimates, roadmaps,specifications, and performance measurements described in this projectare done with the Miraland Labs (“ML”) good faith efforts. It is up tothe reader to check and validate their accuracy and truthfulness.Furthermore, nothing in this project constitutes a solicitation forinvestment.

Any content produced by ML or developer resources that ML provides arefor educational and inspirational purposes only. ML does not encourage,induce or sanction the deployment, integration or use of any suchapplications (including the code comprising the Miraland blockchainprotocol) in violation of applicable laws or regulations and herebyprohibits any such deployment, integration or use. This includes the use ofany such applications by the reader (a) in violation of export controlor sanctions laws of the United States or any other applicablejurisdiction, (b) if the reader is located in or ordinarily resident ina country or territory subject to comprehensive sanctions administeredby the U.S. Office of Foreign Assets Control (OFAC), or (c) if thereader is or is working on behalf of a Specially Designated National(SDN) or a person subject to similar blocking or denied partyprohibitions.

The reader should be aware that U.S. export control and sanctions laws prohibitU.S. persons (and other persons that are subject to such laws) from transactingwith persons in certain countries and territories or that are on the SDN list.Accordingly, there is a risk to individuals that other persons using any of thecode contained in this repo, or a derivation thereof, may be sanctioned personsand that transactions with such persons would be a violation of U.S. exportcontrols and sanctions law.

https://x.com/miracleland6 (X - Formerly Twitter)

We greatly appreciate any donation to help support Miraland blockchain development. We worked out of passion and kindness for the world, we believe this technology must exist and be free for all to use. Miraland is dedicated to freedom and individual sovereignty and we are doing our best to make it a reality.

BTC: bc1plh7wnl0v0xfemmk395tvsu73jtt0s8l28lhhznafzrj5jwu4dy9qx2rpda

SOL: 9h9TXFtSsDAiL5kpCRZuKUxPE4Nv3W56fcSyUC3zmQip