Skip to content

Protocol Overview

THORChain is a decentralized cross-chain liquidity protocol for native asset swaps without wrapped assets or centralized custody.

Page Source Posture

CuratedChecked 2026-07-14·Review due 2026-08-14·
THORChain Docs
retrieval details
Source retrieved 2026-07-05Official documentation root used for curated protocol background; it still describes GG20 at review time, but current safety and migration state require dated incident and release sources.
+9 sources
THORChain Dev Docs
retrieval details
Source retrieved 2026-07-05Official developer documentation root used for API and integration concepts; pair with live endpoints for current state.
THORChain Swap Guide
retrieval details
Source retrieved 2026-07-05Official quote, expiry, streaming swap, refund-address, and swap error-handling guidance.
THORChain transaction memos
retrieval details
Source retrieved 2026-07-05Official memo format, memo-size, dust-threshold, and swap parameter guidance.
THORChain Streaming Swaps
retrieval details
Source retrieved 2026-07-14Official advanced-queue streaming behavior, interval and quantity semantics, partial execution, refund behavior, and live Mimir-controlled limits.
THORChain Network Halts
retrieval details
Source retrieved 2026-07-05Official halt-control reference; live Mimir and inbound-address reads still own current availability.
THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-05Current-only chain availability, router, halt, and inbound-address snapshot; not durable uptime proof.
THORChain Exploit Report #2
retrieval details
Source retrieved 2026-07-04Official root-cause report for the May 2026 GG20/TSS vault exploit, patched v3.19.1 recovery, and still-planned migration away from GG20.
Protocol Upgrade v3.19.0
retrieval details
Source retrieved 2026-07-04Official v3.19.0 release summary for post-exploit restart controls, including TSS patches, compromised-vault exclusion, temporary KeyVerify, and pause safety.
THORChain Exploit Report #1
retrieval details
Source retrieved 2026-07-05Official initial May 2026 exploit timeline and then-pending ADR-028 recovery framing; use Report #2 and the accepted ADR for later root-cause and conciliation status.

Architecture, swaps, TSS, Bifrost, Mimir, halts, app layer, and supported chains.

Use This Page For

  • Architecture concepts, swap lifecycle, Bifrost, TSS, Mimir, and supported-chain context.
  • Dated educational framing for how THORChain components fit together.

Verify Elsewhere Before Claiming

  • Current halt, signing, inbound-address, gas-rate, or Mimir state.
  • Exact live constants, minimum bond, slash settings, or current chain availability.

Move from the protocol overview into the right deeper read or live-source check before making an availability, implementation, or developer claim.

claim path

Protocol Claim Checks

Start with the claim type. The overview explains how the system fits together; current availability, vault safety, and developer behavior need stronger source paths.

concept

Architecture explanation

Use For
Cosmos app-chain, Bifrost observation, vaults, pools, Mimir, and swap lifecycle structure.
Verify
Use the New to THORChain path or the relevant deep dive before turning this into implementation detail.
Do Not Claim
Do not treat architecture cards as proof that a chain, route, or action is currently available.
Read the beginner path
live state

Current availability claim

Use For
Whether swaps, signing, inbound addresses, LP actions, secured assets, or app-layer controls are open now.
Verify
Use Network diagnostics and current source-map guidance before presenting availability as live.
Do Not Claim
Do not infer live state from supported-chain listings, old docs, or a missing halt mention.
Check live diagnostics
security

Security or vault claim

Use For
TSS, vault signing, churn, Bifrost observation, slash exposure, and post-exploit migration language.
Verify
Use the Network Security path plus dated incident or upgrade reports before describing current safety.
Do Not Claim
Do not convert a dated exploit report or migration discussion into present-day safety proof.
Read security path
developer

Developer integration claim

Use For
Memos, asset notation, constants, Mimir keys, inbound-address fields, quote behavior, and API usage.
Verify
Use official developer docs and live endpoint evidence before giving transaction or implementation guidance.
Do Not Claim
Do not use wiki summaries as send instructions, wallet guidance, or complete API contracts.
Open build/query guide

Architecture

Cosmos SDK

THORChain runs its own app-chain with Tendermint-style consensus and protocol modules for swaps, pools, vaults, and Mimir.

Map source families

TSS Vaults

Threshold Signature Schemes distribute vault control across node operators. Current cryptography details should be tied to dated protocol sources.

Read TSS details

Bifrost

Nodes observe external-chain transactions and report them into the THORChain state machine.

Read Bifrost details

Midgard + THORNode

Midgard serves analytics and history. THORNode is the source for live operational state such as Mimir, constants, and inbound addresses.

Choose the right API

Current-State Controls

Mimir

Mimir parameters can pause trading, signing, LP actions, churning, TCY claims, RUNEPool, and other protocol behavior. Display these as current-only live data.

Interpret Mimir controls

Network Halts

Halts can be chain-specific or global. Interfaces should monitor halt flags before presenting swaps, LP actions, or signing state as available.

Check live halts

Inbound Addresses

Routers, gas rates, chain pause flags, and inbound availability are live THORNode facts, not static wiki facts.

Review inbound usage

Constants vs Overrides

Constants describe defaults; Mimir can override them. Current minimum bond or slash settings require reading both sources.

Verify override posture

Swap Lifecycle

Inbound

Request a fresh quote immediately before submission, then use its inbound address, memo, expiry, dust threshold, and recommended minimum rather than cached transaction inputs.

Check quote timing

Execution

The state machine prices the swap through RUNE-paired pools. Under the advanced queue, market swaps can auto-stream; the quote and memo own limits, interval, and quantity while live controls own availability.

Check a live route

Outbound or Refund

Nodes sign the outbound transaction when signing is available; invalid or impossible transactions can refund according to protocol rules.

Read refund conditions

Key Concepts

RUNE Settlement

Every external-asset swap routes through RUNE liquidity, making RUNE the common settlement and bond asset.

Read settlement details

Continuous Liquidity Pools

Slip-based pricing makes larger trades pay proportionally more, protecting liquidity providers from depth-consuming trades.

Read CLP mechanics

App Layer and CosmWasm

Permissioned CosmWasm contracts add application behavior; secured assets and trade accounts are separate protocol concepts that need their own live checks.

Read app-layer scope

Minimal Governance

Node operators and Mimir handle operational parameters; ADRs/TIPs document changes. Avoid saying ordinary RUNE holders directly govern every protocol decision.

Check governance framing

Supported Chains

This curated list mirrors chains observed in live inbound-address sources at the 2026-07-14 chain-catalog review. Availability, routing, signing, LP actions, and pause state remain live/current-only.

Before Reading The Chain Grid

Treat this as a catalog boundary, not a current availability dashboard. Move to the matching live check before telling a user a chain, action, or route is usable now.

catalog is not availability
static boundary

Catalog Listed

Can Prove
The chain appears in the curated supported-chain catalog refreshed from inbound-address evidence.
Does Not Prove
Swaps, LP actions, signing, gas, outbound availability, or route quoteability right now.
Check source boundary
live state

Operational Now

Can Prove
Current chain, trading, signing, LP, pool-deposit, and source-warning status at the checked block.
Does Not Prove
Future uptime or that every asset pair on the chain can route.
Open diagnostics
quote check

Specific Route

Can Prove
Whether THORNode can currently quote the selected from/to asset and amount.
Does Not Prove
Wallet support, final execution after quote expiry, or safe recipient/memo handling.
Check a route
builder path

Implementation Use

Can Prove
Which endpoint family and source posture should be used for product or dashboard code.
Does Not Prove
A complete transaction builder, wallet UX, or production integration contract by itself.
Open query plan

Supported Chain Finder

Showing 12 of 12 catalog chain records from the 2026-07-14 review.

Search by chain, code, asset notation, address format, source/freshness text, or review note. Live dust thresholds and availability belong in current THORNode evidence.

Bitcoin

BTC

catalog listed
Address Formats
P2WSH (preferred)P2WPKHP2PKHP2SHP2TR
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

Use the live inbound-address dust threshold and halt fields before constructing or describing a BTC transaction.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Ethereum

ETH

catalog listed
Address Formats
EIP-55
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

Router/inbound status is live-state dependent.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

BNB Chain

BSC

catalog listed
Address Formats
EIP-55
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

No special review note is attached to this catalog entry.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Avalanche

AVAX

catalog listed
Address Formats
EIP-55
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

No special review note is attached to this catalog entry.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Cosmos Hub

GAIA

catalog listed
Address Formats
Bech32 (Secp256k1 or Ed25519)
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

No special review note is attached to this catalog entry.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Dogecoin

DOGE

catalog listed
Address Formats
Bech32P2PKH
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

No special review note is attached to this catalog entry.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Litecoin

LTC

catalog listed
Address Formats
Bech32P2PKH
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

MWEB addresses are not supported by the official address-format guide.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Bitcoin Cash

BCH

catalog listed
Address Formats
CashAddrP2PKH
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

The official guide labels BCH as Bech32; current inbound addresses use CashAddr, which is Bech32-inspired but not BIP-173 Bech32.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Tron

TRON

catalog listed
Address Formats
Base58
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

No special review note is attached to this catalog entry.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Base

BASE

catalog listed
Address Formats
EIP-55
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

No special review note is attached to this catalog entry.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.

Solana

SOL

catalog listed
Address Formats
Base58
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

Live inbound and chain-client sources include SOL even though the high-level supported-blockchains overview omitted it at review time. SOL uses EdDSA signing; Exploit Report #2 says EdDSA chains such as Solana were not exposed to the GG20/Paillier attack path.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+4 sources
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.
THORChain supported blockchains overview
retrieval details
Source retrieved 2026-07-14Official high-level list contained eleven chains and omitted Solana at review time; use live inbound-address evidence and the chain-client reference for the current catalog boundary.
THORChain Chain Clients
retrieval details
Source retrieved 2026-07-14Official Bifrost chain-client reference showing the current client families, including the Solana client and its EdDSA Base58 address derivation.
THORChain Exploit Report #2
retrieval details
Source retrieved 2026-07-04Official root-cause report for the May 2026 GG20/TSS vault exploit, patched v3.19.1 recovery, and still-planned migration away from GG20.

XRP Ledger

XRP

catalog listed
Address Formats
Classic Base58
Dust Threshold
Live inbound_addresses only

Catalog Boundary

Listed means this chain was present in the curated inbound-address catalog. It does not prove swaps, signing, LP actions, gas, or a route are open now.

Use a destination tag only when the receiving wallet requires it. The official guide lists Classic Base58 and does not list X-address as a supported format.

Official sourceChecked 2026-07-14·Review due 2026-08-14·
Liquify THORNode inbound_addresses
retrieval details
Source retrieved 2026-07-14Current-only review at THORChain height 26994861 confirmed this record in the 12-chain inbound-address set. Presence is not swap, signing, LP-action, or route-availability proof.
+1 source
Querying THORChain
retrieval details
Source retrieved 2026-07-14Official address-format guidance. Dust thresholds, gas rates, routers, and halt fields remain live inbound-address values and are intentionally not copied into this static catalog.