Skip to content

Latest commit

 

History

History
214 lines (136 loc) · 20.3 KB

README.md

File metadata and controls

214 lines (136 loc) · 20.3 KB

 

AndromedaOS is a revolutionary software layer that provides a massively abstracted environment and user experience for the next generation of blockchain innovators to create, develop and get paid.

Introduction to AndromedaOS

Mission

Andromeda Protocol is a rapid development framework and a next-generation user interface that brings an Easier, Better, and Faster capability to Web 3.0, and the blockchain industry.

What is a blockchain operating system?

In short, a blockchain operating system provides an environment filled with ready to use tooling, common interfaces for applications and features familiar to modern computer users. As Andromeda is the first true operating system designed to run on distributed computing frameworks, the details are quite technical.

AndromedaOS, or aOS for short, is comprised of several interoperating systems that work together to bring clarity and ease of use to the user. It's important to understand the basic concepts and architecture of the system to develop.

A quick description of each of the components that make up the aOS:

It's important to note that each of these systems exist 100% on-chain. All logic, interactions, objects, economics, etc. are deployed on-chain.

Powered by the Cosmos Ecosystem

The power and performance of the Rust/CosmWasm combo is what allowed this breakthrough in interoperability and complexity.

Infinite Reach Through IBC

Just like an operating system that can be seamlessly installed on any device, the AndromedaOS transcends limitations tied to the Andromeda chain. It is designed for universal compatibility and can be effortlessly deployed on any chain within the expansive Cosmos ecosystem.

The operating system can be employed for local development on the chain, yet its true potential shines through Inter-Blockchain Communication (IBC). This capability allows the creation of Apps that extend seamlessly across multiple interconnected chains.

Here is a visual representation of how this system is connected.

 

As we can see, each of the Cosmos chains has AndromedaOS deployed . Since AndromedaOS can communicate using IBC, then users can build Applications that span accross many chains taking advantage of all the benefits that come along.

For example, a user can build an NFT collection on Stargaze selling the NFTs using one of our ADOs and then using a splitter to send part of the funds to Terra to leverage some protocol and another part to Injective to leverage some functionality there. The user's imagination is the only limit to what can be built using the aOS.

Note: IBC functionality is being slowly introduced into the system. Not all features mentioned above are currently available.

What is the benefit of using aOS

  • For Projects:

Before Andromeda, projects would need to hire a full development teams in order to build their projects and custom smart contracts. Andromeda eliminates this need by providing a very large amount of custom smart contracts that upcoming projects can pick and chose from to achieve their desired utility. These projects can then use our No-Code-Builder to build their projects in a matter of minutes on any of the chains that Andromeda is deployed on.

  • For Developers:

Developers can use our Andromeda Logic Library (ALL) which contains all our contracts to build from. Similar to how cw-plus contracts are used as a base for production quality builds, the ALL will act as a base for all developers to create their own ADOs that use the superior interoperable system.

As it stands, the ALL contains around 25 ADOs which is the tip of the iceberg. More and more ADOs are being added by the Andromeda team, and as we continue building, the ALL will eventually reach a state with thousands of ADOs where every use case imagined can be built using it.

Furthermore, developers are incentivized for their contributions and the ADOs they create. This incentive system operates through our economic engine, enabling developers to set custom fees on their ADOs when it is published. Users utilizing these ADOs pay these fees, which are then returned to the developer responsible for their creation.

  • For Chains:

AndromedaOS provides a whole suite of tooling that can be quickly installed on any chain in the Cosmos ecosystem. Installing the aOS would instantly give a chain and its users access to the following:

  1. A large number of production ready ADOs to be used.
  2. The best no-code-builder in Cosmos and perhaps the entire blockchain industry.
  3. IBC capable applications.
  4. An incredible all in one CLI that is easy to use and manage.
  5. Exposure to the chain, as users on any chain that implements the aOS will be able to to see where aOS is also deployed and might consider building applications on said chain.

Andromeda Core Repo

A monorepository containing all the contracts and packages related to Andromeda Protocol. Full documentation for all the contracts can be found here.

ADO Categories

The contracts are classified based on their functionality. Currently we have 7 different contract categories.

Category Description
app Contracts used for building Andromeda apps.
ecosystem Contracts that are allow interaction with different ecosystem protocols.
finance Contracts used by fungible tokens to perform defi operations.
fungible tokens Contracts that integrate with fungible tokens (CW-20 tokens).
non-fungible-tokens Contacts that integrate with non-funible toknes (NFTs). Includes a standard CW721 contract with some custom features.
os Contacts that make up the aOS architecture

Audited ADOs

The list of ADOs that have been audited and are available on our web-application.

Contract Category Description Documentation
andromeda-app-contract app Contract used to create Andromeda Apps. Gitbook
andromeda-rate-limiting-withdrawals finance Contract that puts restrictions on the withdrawal of funds by users. Gitbook
andromeda-splitter finance Contract used to split any sent funds amongst defined addresses. Gitbook
andromeda-timelock finance Contract used to store funds until a condition has been satisfied before being released, similar to Escrow. Gitbook
andromeda-cw20 fungible tokens Contract to create standard CW20 tokens. Gitbook
andromeda-cw20-staking fungible tokens Contract that allows the staking of CW20 tokens for rewards. Gitbook
andromeda-cw20-exchange fungible tokens Contract that allows the exchanging native tokens for a specified CW20 Gitbook
andromeda-lockdrop fungible tokens Contract that allows users to deposit a netive token in exchange for the project's cw-20 token Gitbook
andromeda-merkle-airdrop fungible tokens Contract used to perform a merkle airdrop on cw20-tokens Gitbook
andromeda-auction non-fungible-tokens Contract that can receive an NFT and run an auction on it. Gitbook
andromeda-marketplace non-fungible-tokens Contract that can receive an NFT and run an a sale on it. Gitbook
andromeda-crowdfund non-fungible-tokens Contracts used to perform a crowdfund by selling NFTs. Gitbook
andromeda-cw721 non-fungible-tokens Contract used to create CW721 standard NFTs. Has a custom message that allows selling the NFTs. Gitbook
andromeda-adodb os The ADO database responsible for publishing new ADOs into the aOS Gitbook
andromeda-economics os The contract responsible for handling ADO fees Gitbook
andromeda-kernel os The contract responsible for handling communication between ADOs Gitbook
andromeda-vfs os The contract responsible for managing the usernames and paths of ADOs and users in the aOs Gitbook

Note: Other ADOs can be found in our repo, but they have not gone through the auditing process yet.

Packages

Contract Description
andromeda_protocol Package used to define message types and various utility methods used by Andromeda ADO Contracts.

ADO Base

The packages also includes the ado_base. Since all our ADOs are built using the same architecture, redundency was inevitable. So we decided to bundle up all the functions/messages/structures that are used by all ADOs into the ado_base which can be referenced by any new ADOs.

Development

Andromeda Template and Crate

A starting template for ADO development can be found here. The andromeda-std crate can be found here.

Integration Tests

Check out our cw-multi-test based testing library to setup custom ADO integration tests.

Testing

All tests can be run using:

cargo test --workspace

Building

All contracts and packages can be built by running the build script:

./build_all.sh

This will build all contract .wasm files in to the artifacts directory at the project root.

To build a single contract, you need to have wasm-opt Then run:

./build.sh [contract name] or ./build.sh [catogory name]

Examples:

./build.sh andromda vault to build the vault contract. or ./build.sh finance to build all contracts under the finance category.

They can also be chained to build multiple directories at the same time:

./build.sh andromeda_app non-fungible-tokens to build the app contract and all contracts under the non-fungible-tokens category.

Formatting

Make sure you run rustfmt before creating a PR to the repo. You need to install the nightly version of rustfmt.

rustup toolchain install nightly

To run rustfmt,

cargo fmt

Linting

You should run clippy also. This is a lint tool for rust. It suggests more efficient/readable code. You can see the clippy document for more information. You need to install nightly version of clippy.

Install

rustup toolchain install nightly

Run

cargo clippy --all --all-targets -- -D warnings

Creating and Interacting with ADOs

Andromeda is deployed on many of the Cosmos chains. Usually this will require you to set up an environment for each chain. Luckily, Andromeda has built the Andromeda CLI, an all in one tool to build, interact, and manage ADOs and wallets for any of the chains. The CLI documentation can be found here.

Andromeda JS

Andromeda.js is a JavaScript SDK for writing applications that interact with ADOs on any of the blockchains that Andromeda is deployed on. More on the AndromedaJS can be found here.

Licensing

Terms and Conditions