THORChain Dev Docs
Search…
⌃K

Introduction

Overview of THORChain and links to frontend guides.

Overview

THORChain is a decentralised cross-chain liquidity protocol that allows users to add liquidity or swap over that liquidity. It does not peg or wrap assets. Swaps are processed as easy as making a single on-chain transaction.
THORChain works by observing transactions to its vaults across all the chains it supports. When the majority of nodes observe funds flowing into the system, they agree on the user's intent (usually expressed through a memo within a transaction) and take the appropriate action.
For more information see Understanding THORChain, Technology or Concepts.
For wallets/interfaces to interact with THORChain, they need to:
  1. 1.
    Connect to THORChain to obtain information from one or more endpoints.
  2. 2.
    Construct transactions with the correct memos.
  3. 3.
    Send the transactions to THORChain Inbound Vaults.
Front-end guides have been developed for fast and simple implementation.

Connecting to THORChain

THORChain has several APIs with Swagger documentation, see here for a full list.
See Connecting to THORChain for more information.

Quote Interfaces

Several endpoints have been created within Thornode allowing easy implementation for front-end developers. See the Quote section within Thornode documentation and examples within theFront-end Development Guides.

Support and Questions

Join the THORChain Dev Discord for any questions or assistance.

Front-end Development Guides

Native Swaps Guide

Frontend developers can use THORChain to access decentralised layer1 swaps between BTC, ETH, BNB, ATOM and more.

Native Savings Guide

THORChain offers a Savings product, which earns yield from Swap fees. Deposit Layer1 Assets to earn in-kind yield. No lockups, penalties, impermanent loss, minimums, maximums or KYC.

Aggregators

Aggregators can deploy contracts that use custom swapIn and swapOut cross-chain aggregation to perform swaps before and after THORChain.
Eg, swap from an asset on Sushiswap, then THORChain, then an asset on TraderJoe in one transaction.

Concepts

In-depth guides to understand THORChain's implementation have been created.

Libraries

Several libraries exist to allow for rapid integration. xchainjs has seen the most development is recommended.
Eg, swap from layer 1 ETH to BTC and back.

Analytics

Analysts can build on Midgard or Flipside to access cross-chain metrics and analytics.
Eg, gather information on cross-chain liquidity