description
Introduction of THORChain, Midgard, ASGARDEX and the rest of the ecosystem.

Introduction

Technology

THORChain is a decentralised cross-chain liquidity protocol based on Tendermint & Cosmos-SDK and utilising Threshold Signature Schemes (TSS). It does not peg or wrap assets, it simply determines how to move them in response to user-actions.

THORChain observes incoming user deposits to vaults, executes business logic (swap, add/remove liquidity), and processes outbound transactions. THORChain is primarily a leaderless vault manager, ensuring that every stage of the process is byzantine-fault-tolerant.

THORChain's key objective is to be resistant to centralisation and capture whilst facilitating cross-chain liquidity. THORChain only secures the assets in its vaults, and has economic guarantees that those assets are safe.

You can learn how THORChain works here:

{% page-ref page="technology.md" %}

RUNE

RUNE is the asset which powers the THORChain ecosystem and provides the economic incentives required to secure the network. RUNE has four key roles which are described below.

1. Liquidity (as a settlement asset)
2. Security (as a sybil-resistant mechanism, and a means for driving economic behaviour)
3. Governance (signalling priority on-chain)
4. Incentives (paying out rewards, charging fees, subsidising gas)

Learn more here:

{% page-ref page="rune.md" %}

ROLES

There are four key roles in the system:

1. Liquidity providers who add liquidity to pools and earn fees and rewards
2. Swappers who use the liquidity to swap assets ad-hoc, paying fees
3. Traders who monitor pools and rebalance continually, paying fees but with the intent to earn a profit.
4. Node Operators who provide a bond and are paid to secure the system

{% page-ref page="roles/" %}

THORNodes

THORNodes service the THORChain network, of which there is intended to be initially 100, but can scale to 300. The design goal of THORChain is such that anyone can join the network with the required funds (permissionless) *and be anonymous*, yet still be secure. THORChain takes this a step further by having a VERY high churn schedule, kicking out nodes continuously. This high-churn network ensures that it is censorship-resistant, evades capture and resists centralisation.

Each THORNode is comprised of several independent servers in a cluster, which run full-nodes for each connected chain, a THORDaemon and a Midgard API. THORNodes should be anonymous, do not support delegation and are regularly churned out.

Developers

{% hint style="info" %} Users make signed transactions with a "memo" conveying intent into vaults, which is then picked up by THORChain and executed.
They do not need to hold RUNE, or even care that RUNE was used, or even connect directly with THORChain. This makes THORChain suitable to be integrated into almost any wallet/service/exchange-provider as the "backend" liquidity protocol. {% endhint %}

{% hint style="danger" %} THORChain churns vaults regularly to resist capture. Do not send transactions directly to THORChain vaults without first doing important safety checks. {% endhint %}

INTERFACES - (ASGARDEX/THORSwap/ASGARD/VANAHEIM)

Interfaces allow users to connect to wallets, read balances, query Midgard and broadcast transactions in both the web and desktop environment. Anyone can build their own interface, and several wallet libraries have been built to help developers with this.

API - MIDGARD

Midgard is run by every THORNode and provides a restful API & graphQL & websockets that any client can consume to display data. To connect to Midgard, the client (eg wallet) must first challenge a number of nodes to prevent being attacked or phished, since the security model of THORChain is strictly by-consensus. Or the interface team can run their own Midgard.

STATE MACHINE - THORChain

THORChain itself is a state machine that both settles external state, as well as transactions of THOR.RUNE - the network asset. THORChain could be called an app-chain, where the application is a decentralised exchange focussed on liquidity.

INTEGRATION

Developers build products that integrate with THORChain, such as wallets, exchanges and other services. Developers simply need to connect to Midgard, they do not need to run a node.

The order of integration is as follows:

1. Connect to THORChain via Midgard
2. Use data provided by Midgard to display (pools, assets)
3. Use xchain-crypto to manage keystores for your wallet
4. Use xchainjs packages to sign transactions and broadcast.

CONTRIBUTING

THORChain is a public project. Anyone can help contribute to the ecosystem. Start here to learn about the contribution process, as well as upgrading the chain:

1. Connecting to more chains
2. Adding more business logic to the chain (stablecoins, derivatives etc)
3. Upgrading the chain to be more robust