Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion native-cross-chain-swaps.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Each blockchain has its own vault, operated collectively by THORChain's node net
<!-- trunk-ignore(markdownlint/MD033) -->
<div align="center">
<!-- trunk-ignore(markdownlint/MD033) -->
<img src=".gitbook/assets/liqudity-pools-with-rune.png" alt="Liquidity pools with RUNE showing how different cryptocurrencies connect through RUNE as the settlement asset" width="500" />
<img src=".gitbook/assets/liquidity-pools-with-rune.png" alt="Liquidity pools with RUNE showing how different cryptocurrencies connect through RUNE as the settlement asset" width="500" />
</div>

## Example: Swapping BTC to ETH
Expand Down
2 changes: 1 addition & 1 deletion network-security-governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The network relies on several mechanisms to ensure security, decentralization, a
- **Securing liquidity pools**: Bonded RUNE secures the assets held in liquidity pools and acts as an economic deposit. If a validator attempts to steal funds, their bond is slashed - making dishonest behavior highly unprofitable
- **Economic target**: The network aims to maintain a ratio where the total bonded RUNE is approximately twice the value of all non-RUNE assets in the liquidity pools. This makes attacks extremely costly and impractical

Note: Network paramaters can override this ratio and is controlled by the nodes. See the [Technical Documentation](https://dev.thorchain.org) for more information.
Note: Network parameters can override this ratio and are controlled by the nodes. See the [Technical Documentation](https://dev.thorchain.org) for more information.

## TSS – Threshold Signature Scheme

Expand Down
71 changes: 0 additions & 71 deletions overview.md

This file was deleted.

10 changes: 6 additions & 4 deletions technical-deep-dive/economic-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,17 @@ Detailed documentation on the Incentive Pendulum can be found in the [developer

### Token Distribution

There are a maximum of 500M RUNE. All supply was created at genesis and distributed as follows:
There are a maximum of **~360M RUNE** (reduced from 500M per [ADR-023](https://dev.thorchain.org/architecture/adr-023-rune-supply-restructure.html)). Exact max and circulating supply change with burns — use [rune.tools/supply](https://rune.tools/supply) for live figures, or the [Economic Model](https://dev.thorchain.org/concepts/economic-model.html) for protocol detail.

All supply was created at genesis and originally distributed as follows:

- 5% (SEED) and 16% (IDO) sold for capital to start the network and give it value.
- 10% allocated to early developers who worked since 2018.
- 24% given to users who participated in network bootstrapping.
- 44% placed in the Protocol Reserve to pay out to nodes and LPs for the next 10+ years.

{% hint style="success" %}
All vesting has been completed.
All vesting has been completed. ADR-023 later burned most of the Reserve and capped max supply near total supply.
{% endhint %}

The [Reserve module](https://runescan.io/address/thor1dheycdevq39qlkxs2a6wuuzyn4aqxhve4qxtxt) and [other modules](https://runescan.io/addresses) can be viewed on RuneScan.
Expand All @@ -46,9 +48,9 @@ The [Reserve module](https://runescan.io/address/thor1dheycdevq39qlkxs2a6wuuzyn4
Block rewards are calculated as:

$$
blockReward = \frac{ \frac{reserve}{emissionCurve}}{blocksPerYear} = \frac{ \frac{180,000,000}{8}}{5256000} = 4.28
blockReward = \frac{ \frac{reserve}{emissionCurve}}{blocksPerYear}
$$

{% hint style="info" %}
The [emission curve](https://dev.thorchain.org/mimir.html#economics) is currently set to 100,000, meaning block rewards are minimal, approx. 720 RUNE per year.
The [emission curve](https://dev.thorchain.org/mimir.html#economics) is currently set to 100,000, so block rewards are minimal (on the order of hundreds of RUNE per year). Live values: [Mimir](https://gateway.liquify.com/chain/thorchain_api/thorchain/mimir).
{% endhint %}
8 changes: 4 additions & 4 deletions technical-deep-dive/fees.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Fees in THORChain serve three purposes:

- Spam/dust resistance: minimums and slip floors make abuse economically costly.
- Stable UX expectations: users see predictable fee components rather than raw external gas volatility.
- Long-term sustainability: fee design reduces reliance on emissions alone. See [Incentive Pendulum](https://docs.thorchain.org/thorchain-finance/incentive-pendulum) for how fees and rewards adjust to balance liquidity and security.
- Long-term sustainability: fee design reduces reliance on emissions alone. See [Incentive Pendulum](economic-model.md#incentive-pendulum) for how fees and rewards adjust to balance liquidity and security.

## Fee overview

Expand All @@ -28,7 +28,7 @@ Fees in THORChain serve three purposes:
| Outbound Fee | Destination-chain gas × dynamic multiplier (OFM ~1–3×), which also covers protocol overhead | Deducted from the swap output; includes the THORChain network component |

{% hint style="info" %}
Transactions on the THORChain chain itself (e.g., native RUNE or trade-asset transfers) incur the Native Transaction Fee of 0.02 RUNE. See [Fees dev docs](https://dev.thorchain.org/concepts/fees.html#3-network-fee).
Transactions on the THORChain chain itself (e.g., native RUNE or trade-asset transfers) incur the Native Transaction Fee of 0.02 RUNE. See [Fees dev docs](https://dev.thorchain.org/concepts/fees.html).
{% endhint %}

## Inbound Fee
Expand All @@ -42,11 +42,11 @@ THORChain’s CLP model applies a slip-based fee that scales with the amount of
- [Streaming Swaps](https://dev.thorchain.org/swap-guide/streaming-swaps.html): large swaps are split over time to reduce single-block pressure and improve execution for patient swappers.
- [`L1SlipMinBps` (Mimir)](https://dev.thorchain.org/mimir.html#swapping): enforces a minimum fee in basis points per swap, ensuring a floor even when pools are very deep.

For the slip math and derivations, see the [Fees dev docs](https://dev.thorchain.org/concepts/fees.html) and [Continuous Liquidity Pools](https://docs.thorchain.org/thorchain-finance/continuous-liquidity-pools).
For the slip math and derivations, see the [Fees dev docs](https://dev.thorchain.org/concepts/fees.html) and [Continuous Liquidity Pools](../thorchain-finance/continuous-liquidity-pools.md).

## Affiliate Fee

Interfaces can include an optional affiliate fee (in basis points) that’s collected via a registered THORName. See the [Affiliate Fee dev docs](https://dev.thorchain.org/concepts/fees.html#affiliate-fee) for information, and how to configure preferred payout assets.
Interfaces can include an optional affiliate fee (in basis points) that’s collected via a registered THORName. See the [Affiliate Fee dev docs](https://dev.thorchain.org/concepts/fees.html#3-affiliate-fee) for information, and how to configure preferred payout assets.

## Outbound Fee

Expand Down
2 changes: 1 addition & 1 deletion technology/cosmwasm.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,4 +39,4 @@ The App Layer is **sandboxed** from the base layer:

- [THORChain Developer Documentation](https://dev.thorchain.org/)
- [CosmWasm Documentation](https://docs.cosmwasm.com/docs/)
- ADR-020: App Layer (full design and security details)
- [ADR-020: App Layer](https://dev.thorchain.org/architecture/adr-020-app-layer.html)
2 changes: 1 addition & 1 deletion thornodes/leaving.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ To leave the system, send the following transaction from your original bond addr
⏱ _Wait a few minutes, verify you have received your bond back_ 👀 - `make status` should show `BOND 0.00` and your wallet should get the full Bond back.

{% hint style="info" %}
View your node's status on [Runescan](https://runescan.io) or the [THORNode API](https://thornode.thorchain.info/thorchain/nodes).
View your node's status on [Runescan](https://runescan.io) or the [THORNode API](https://gateway.liquify.com/chain/thorchain_api/thorchain/nodes).
{% endhint %}

_🔥 Commence destroying your node 🔥_
Expand Down
16 changes: 8 additions & 8 deletions thornodes/overview/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: Overview of THORNodes

## Overview

THORNodes service the THORChain network. Each THORNode is comprised of several independent servers in a cluster. All THORNodes communicate and operate in cooperation to create a cross-chain swapping network. Running a node is a serious undertaking. While Node Operators are well [compensated ](./#compensation)for running a node, there are also [risks](risks-costs-and-rewards.md), [skills required](./#skillsets) and [costs](risks-costs-and-rewards.md#costs).
THORNodes service the THORChain network. Each THORNode is comprised of several independent servers in a cluster. All THORNodes communicate and operate in cooperation to create a cross-chain swapping network. Running a node is a serious undertaking. While Node Operators are well [compensated](risks-costs-and-rewards.md#compensation) for running a node, there are also [risks](risks-costs-and-rewards.md), [skills required](./#skillsets) and [costs](risks-costs-and-rewards.md#costs).

See the [Node Operator 101 Video](https://youtu.be/XXYXNAolPEU) to learn more before running a node.

Expand Down Expand Up @@ -43,11 +43,11 @@ Running a THORNode is no simple task. As an operator, you will need to run/maint

If the answer is no, it’s probably best that you do not run a node and participate in the network in other ways, such as a [RUNEPool participant](../../thorchain-finance/runepool.md)or a [bond provider.](../pooled-thornodes.md) The following skill sets are required to be an effective node operator.

* Advanced knowledge of Linux server administration and security
* Advanced knowledge of Kubernetes
* Advanced experience running a host of nodes on a hosted platform such as AWS, Google Cloud, Digital Ocean, etc
* Knowledge of running full nodes for other chains such as Bitcoin and Ethereum.
* Willingness to be “on call” at all times to respond to issues when/if your node becomes unavailable
- Advanced knowledge of Linux server administration and security
- Advanced knowledge of Kubernetes
- Advanced experience running a host of nodes on a hosted platform such as AWS, Google Cloud, Digital Ocean, etc
- Knowledge of running full nodes for other chains such as Bitcoin and Ethereum.
- Willingness to be “on call” at all times to respond to issues when/if your node becomes unavailable

## Creating a Node

Expand All @@ -68,7 +68,7 @@ Once created, follow the [Deploying](../deploying.md), [Joining](../joining.md)

## Node Voting

THORNodes have the ability to vote on [Mimir](https://midgard.thorchain.info/v2/thorchain/mimir) settings. This is important when voting for [ADRs](https://dev.thorchain.org/architecture/index.html) and important network changes.
THORNodes have the ability to vote on [Mimir](https://gateway.liquify.com/chain/thorchain_api/thorchain/mimir) settings. This is important when voting for [ADRs](https://dev.thorchain.org/architecture/index.html) and important network changes.

Mimir settings have specific [abilities](https://gitlab.com/thorchain/thornode/-/blob/develop/docs/mimir.md). The process for voting from a node is:

Expand All @@ -78,7 +78,7 @@ Make mimir
=> Enter THORNode Mimir value: <value>
```

1. Mimir keys and values are listed in the [Mimir endpoint](https://midgard.thorswap.net/v2/thorchain/mimir).
1. Mimir keys and values are listed in the [Mimir endpoint](https://gateway.liquify.com/chain/thorchain_api/thorchain/mimir).
2. A node can vote at any time on any key value.
3. A node's vote is valid as long as they are active (and removed if they are not).
4. 2/3rds of active nodes need to agree for the change to happen
Expand Down
8 changes: 4 additions & 4 deletions tokenomics-rune-tcy.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ RUNE is the native utility token of the THORChain ecosystem, and it sits at the

## RUNE Tokenomics

- **Total Supply:** ~425M RUNE (reduced daily through the burn mechanism)
- **Circulating Supply:** ~350M RUNE
- **Reserve:** ~75M RUNE
- **Latest numbers:** [rune.tools/supply](https://rune.tools/supply)
- **Maximum supply:** ~360M RUNE ([ADR-023](https://dev.thorchain.org/architecture/adr-023-rune-supply-restructure.html))
- **Circulating / total supply:** decreases with burns — see [rune.tools/supply](https://rune.tools/supply) for exact figures
- **Reserve:** reduced under ADR-023; current balance on [RuneScan](https://runescan.io/address/thor1dheycdevq39qlkxs2a6wuuzyn4aqxhve4qxtxt)
- **Protocol detail:** [Economic Model](technical-deep-dive/economic-model.md)

All RUNE tokens have been released – there are no vesting schedules or locked allocations.

Expand Down
2 changes: 1 addition & 1 deletion what-is-thorchain-and-rune.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Unlike centralized exchanges:
- You don't have to trust a company to hold your funds

Example:
If you own Bitcoin and want Ethereum, you just send Bitcoin from your wallet and receive Ethereum back in a single transaction, osmos Hub (ATOM)no exchange accounts, no middlemen.
If you own Bitcoin and want Ethereum, you just send Bitcoin from your wallet and receive Ethereum back in a single transactionno exchange accounts, no middlemen.

<!-- trunk-ignore(markdownlint/MD033) -->
<div align="center">
Expand Down