Skip to content

docs: update outbound throttling to reference Mimir parameters #113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
familiarcow wants to merge 2 commits into
base: master
Choose a base branch
from
Open

docs: update outbound throttling to reference Mimir parameters #113

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
10c78a2
fix(docs): correct TxOutDelayMax from 720 to 17,280 blocks
familiarcow Feb 2, 2026
aaa240a
fix(docs): update outbound throttling to reference Mimir parameters
familiarcow Feb 2, 2026
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
4 changes: 2 additions & 2 deletions technical-deep-dive/security.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@ See more full details [here](https://dev.thorchain.org/bifrost/how-bifrost-works

## Outbound Transaction Throttling

To prevent large amounts of funds from leaving the network in an instant, large outbound transactions are throttled from immediately leaving the network. Each block has an outbound value limit (currently 1000 RUNE worth) and each outbound transaction has a maximum time limit that it can be processed. This has three effects:
To prevent large amounts of funds from leaving the network in an instant, large outbound transactions are throttled from immediately leaving the network. Each block has an outbound value limit controlled by `MinTxOutVolumeThreshold` and each outbound transaction has a maximum time limit that it can be processed. This has three effects:

- Each outbound transaction to compete for the next outbound block, else, it will be processed in the following block, effectively throttling the total outbound capacity of the network. This is independent of [conf-counting](https://docs.thorchain.org/chain-clients/overview#confirmation-counting).
- Large outbounds to spread across multiple blocks, up to 720 blocks (approx one hour).
- Large outbounds to spread across multiple blocks. The initial delay is capped by `MaxTxOutOffset`, then the network searches for an available slot up to `TxOutDelayMax` if blocks are full.
- Ensures one large outbound request of $1,000,000 is handled the same as one million $1 outbound requests.

This feature is controlled by several [Mimir](constants-and-mimir.md#outbound-transactions) values that can be changed by Node Operators as required. [Relevant PR](https://gitlab.com/thorchain/thornode/-/merge_requests/1844).
Expand Down