> ## Documentation Index
> Fetch the complete documentation index at: https://docs.range.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Stablecoins and Tokens

> Monitor stablecoin supply events, issuer freezes, treasury issuer concentration, and peg deviations.

For issuers, treasuries, and anyone exposed to stablecoins, these rules track the
events that matter most: supply changes (mint / burn), issuer freezes, over-exposure
to a single issuer, and a stablecoin drifting off its peg.

## Summary

| Rule                                   | Account types                        | Status       |
| -------------------------------------- | ------------------------------------ | ------------ |
| Stablecoin Supply Change               | Token / mint (stablecoins) + holders | 🟢 Active    |
| Stablecoin Issuer Freeze and Blacklist | Token / mint + token accounts        | 🟢 Active    |
| Asset Price Deviation                  | Token / mint (stablecoins)           | 🟢 Active    |
| Stablecoin Issuer Concentration        | Treasury wallets; token / mint       | 🟢 Active    |
| SPL token lifecycle                    | Token / mint                         | ⚪ Deprecated |
| Asset metrics                          | Token / mint                         | ⚪ Deprecated |

## Rules

<AccordionGroup>
  <Accordion title="🟢 Stablecoin Supply Change">
    **Detects.** A supported stablecoin is minted or burned.

    |                   |                                                                                                                                                                       |
    | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Trigger**       | A `mintTo` / mint or burn of a supported stablecoin whose USD value exceeds a configurable threshold. Coverage spans a set of supported stablecoin mints / contracts. |
    | **Account types** | Token / mint (stablecoins) + holder addresses                                                                                                                         |
    | **Status**        | Active                                                                                                                                                                |
  </Accordion>

  <Accordion title="🟢 Stablecoin Issuer Freeze and Blacklist">
    **Detects.** A stablecoin issuer freezes (or blacklists) an address, or unfreezes
    it.

    |                   |                                                                                                                                                            |
    | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Trigger**       | A `freezeAccount` on a token account, or an address being added to / removed from a stablecoin blacklist, above a configurable threshold where applicable. |
    | **Account types** | Token / mint (stablecoins) + token accounts / blacklisted address                                                                                          |
    | **Status**        | Active                                                                                                                                                     |
  </Accordion>

  <Accordion title="🟢 Asset Price Deviation">
    **Detects.** A stablecoin's price drifts off its peg.

    |                   |                                                                                                                                                                                                |
    | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Trigger**       | Cross-checks aggregated pricing against an oracle for supported stablecoins; alerts escalate with the size of the deviation, and emit recovery events when the peg is restored. *(Scheduled.)* |
    | **Account types** | Token / mint (stablecoins)                                                                                                                                                                     |
    | **Status**        | Active                                                                                                                                                                                         |
  </Accordion>

  <Accordion title="🟢 Stablecoin Issuer Concentration">
    **Detects.** Too large a share of a treasury's stablecoin holdings sits with one
    issuer.

    |                   |                                                                                                                                                                                   |
    | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Trigger**       | The percentage of stablecoin holdings from a single issuer (e.g. Circle / USDC, Tether / USDT) across monitored treasury wallets exceeds a configurable threshold. *(Scheduled.)* |
    | **Account types** | Treasury wallets; token / mint (stablecoins)                                                                                                                                      |
    | **Status**        | Active                                                                                                                                                                            |
  </Accordion>
</AccordionGroup>

## Deprecated

<AccordionGroup>
  <Accordion title="⚪ Deprecated rules (migration context)">
    Retired from a previous runner, kept for completeness:

    * **SPL Token Mint / Burn / New / Freeze**: individual SPL token supply and freeze events (superseded by the stablecoin rules above).
    * **Large Memecoin Swap**: large memecoin swaps.
    * **HUGE Whale Dump**: a whale dumps a large amount of an asset.
    * **Total Asset Holders Change / Limit Crossed**: holder count changes by, or crosses, a threshold.
    * **Total Asset Marketcap Change / Limit Crossed**: marketcap changes by, or crosses, a threshold.
    * **Risky Total Asset Marketcap Limit Crossed**: a risky asset's marketcap crosses a threshold.
  </Accordion>
</AccordionGroup>