> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.