yearn-treasury 0.1.6__cp312-cp312-win32.whl

yearn_treasury/rules/other_income/airdrops.py

@@ -0,0 +1,30 @@
+from typing import Final
+
+from dao_treasury import TreasuryTx, other_income
+from y import Network
+
+
+airdrop: Final = other_income("Airdrop")
+
+_SAFE_AIRDROP_CONTRACTS: Final = (
+    "0xA0b937D5c8E32a80E3a8ed4227CD020221544ee6",
+    "0xC0fde70A65C7569Fe919bE57492228DEE8cDb585",
+)
+
+
+@airdrop("SAFE", Network.Mainnet)
+def is_safe_airdrop(tx: TreasuryTx) -> bool:
+    return tx.symbol == "SAFE" and tx.from_address.address in _SAFE_AIRDROP_CONTRACTS  # type: ignore [union-attr]
+
+
+@airdrop("Other", Network.Mainnet)
+def is_airdrop(tx: TreasuryTx) -> bool:
+    return tx.hash in {
+        "0x327684dab9e3ce61d125b36fe0b59cbfbc8aa5ac7a5b051125ab7cac3b93b90b",
+        "0x44f7d3b2030799ea45932baf6049528a059aabd6387f3128993d646d01c8e877",  # TKX
+        "0xf2dbe58dffd3bc1476755e9f74e2ae07531579d0a3ea9e2aaac2ef902e080c2a",  # TKX
+        "0x8079e9cae847da196dc5507561bc9d1434f765f05045bc1a82df735ec83bc6ec",  # MTV
+        # NOTE: this one was rec'd elsewhere, dumped, and WETH sent to treasury
+        "0xc12ded505ea158717890e4ae6e7ab5eb5cb61edbc13dfd125dd0e6f9b1af9477",  # Gnosis SAFE airdrop
+        "0x7c086a82b43b2f49db93b76a0698cf86a9c620b3bf924f0003175b04a17455ad",  # PRISMA
+    }

yearn_treasury/rules/other_income/match_on_hash.yaml

@@ -0,0 +1,21 @@
+1:
+  YFI Mint:
+    - "0x21a3007a2547a9d6f1bceb44cb9292b36079fcccd8f36f7ec1ca066db261e153"
+  yvUSDN Shutdown:
+    # The USDN vault was shut down but the pool was so rekt they coulnd't even swap for want. Trace amounts of yield sent to yChad.
+    - "0x12b3687f4bfbc73c11dccbd61d18c3f785e6f0f91cb46280d7df08143162ceed"
+  Portals Fees:
+    - "0x7181e4956fde34580be7ebecc6b4b60ad06676b5bb88598a2d35706995bf1289"
+    - "0x3fd8a5995bfe7aa6bb4f502e4bd7e93f491c12f6a72f39644d2809a6eab8b57d"
+  Lido Grant:
+    - "0x2193a2e98487894a30fc1fc9b913ac7a59e14f47ab72b0b53a02aede7d919795"
+    - "0x64d9e139ac2b1738f4e3c1b1c2f979fc90544c9b9eed5cc8bcd960c73fc19ac8"
+  Tessaract Refund:
+    - "0xe1558686856dc43ca9797f9fd7113151e51fc69be35f36db3555b9cefd74399a"
+  Dust from Positive Slippage:
+    - "0x084d318cc42ea80c19e2c9c321f60b3d6d67274a38eb1c1a58cf0fe4093e9ef8"
+  Other:
+    # Some tokens showed up and nobody knew where they came from. Lucky Yearn.
+    - "0x5be236c49e5c5481fc9169dbdd5759cb1542d5d8fe047083ecf2403584468e1a"
+    - "0x6fde3ebcdd3e4e176d3138a976a2382fe15e71922d0b9740f04d0a7be3d4d30f"
+    - "0xbd2a33818b9e755c78c159de5863e2a153164f526d12cfacc773139841d1e594"

yearn_treasury/rules/other_income/misc.py

@@ -0,0 +1,80 @@
+# mypy: disable-error-code="union-attr"
+from decimal import Decimal
+from typing import Final, Optional
+
+from dao_treasury import TreasuryTx, other_income
+from y import Contract, ContractNotVerified, ERC20, Network  # type: ignore [attr-defined]
+
+from yearn_treasury.rules.constants import ZERO_ADDRESS
+
+
+_POINT_ONE: Final = Decimal("0.1")
+
+
+@other_income("aToken Yield", Network.Mainnet)
+def is_atoken_yield(tx: TreasuryTx) -> bool:
+    return (
+        tx.symbol in ("aLEND", "aLINK")
+        and tx.from_address.address == ZERO_ADDRESS
+        and tx.to_nickname in ("Yearn Treasury", "Yearn Treasury V1")
+    )
+
+
+@other_income("RoboVault Thank You", Network.Fantom)
+async def is_robovault_share(tx: TreasuryTx) -> bool:
+    """
+    After Yearn devs helped robovault with a vulnerability, robovault committed to sending Yearn a portion of their fees.
+    """
+    if not tx.symbol.startswith("rv") and tx.from_address.is_contract:
+        return False
+
+    try:
+        strat = await tx.from_address.contract_coro
+    except ContractNotVerified:
+        return False
+    else:
+        vault: Optional[Contract] = getattr(strat, "vault", None)
+
+    if vault is None:
+        return False
+
+    if await vault.coroutine(block_identifier=tx.block) == tx.token:
+        return True
+
+    return (
+        tx.from_nickname == "Contract: Strategy"
+        and tx.symbol == "rv3USDCc"
+        and await ERC20(  # type: ignore [call-overload]
+            await vault.coroutine(block_identifier=tx.block),
+            asynchronous=True,
+        ).symbol
+        == "rv3USDCb"
+    )
+
+
+@other_income("Cowswap Gas Reimbursement", Network.Mainnet)
+def is_cowswap_gas_reimbursement(tx: TreasuryTx) -> bool:
+    return (
+        tx.symbol == "ETH"
+        and tx.from_nickname == "Cowswap Multisig"
+        and tx.to_nickname == "yMechs Multisig"
+    )
+
+
+@other_income("USDS Referral Code", Network.Mainnet)
+def is_usds_referral_code(tx: TreasuryTx) -> bool:
+    """Yearn earns some USDS for referring deposits to Maker"""
+    return (
+        tx.symbol == "USDS"
+        and tx.from_address.address == "0x3C5142F28567E6a0F172fd0BaaF1f2847f49D02F"
+    )
+
+
+@other_income("yETH Application Fee", Network.Mainnet)
+def is_yeth_application_fee(tx: TreasuryTx) -> bool:
+    return tx.symbol == "yETH" and tx.to_nickname == "Yearn Treasury" and tx.amount == _POINT_ONE
+
+
+@other_income("yPRISMA Fees", Network.Mainnet)
+def is_yprisma_fees(tx: TreasuryTx) -> bool:
+    return tx.symbol == "yvmkUSD-A" and tx.from_nickname == "Contract: YPrismaFeeDistributor"

yearn_treasury/rules/revenue/__init__.py

@@ -0,0 +1,6 @@
+from yearn_treasury.rules.revenue.bribes import *
+from yearn_treasury.rules.revenue.farming import *
+from yearn_treasury.rules.revenue.keepcoins import *
+from yearn_treasury.rules.revenue.seasolver import *
+from yearn_treasury.rules.revenue.vaults import *
+from yearn_treasury.rules.revenue.yteams import *

yearn_treasury/rules/revenue/bribes.py

@@ -0,0 +1,26 @@
+from typing import Final
+
+from dao_treasury import TreasuryTx, revenue
+
+
+bribes: Final = revenue("Bribes")
+
+
+@bribes("yCRV Bribes")
+def is_ycrv_bribe(tx: TreasuryTx) -> bool:
+    return (
+        tx.from_nickname
+        in [
+            # OLD
+            "Contract: BribeSplitter",
+            # NEW
+            "Contract: YCRVSplitter",
+            # done manually during migration
+        ]
+        or tx.hash == "0x3c635388812bed82845c0df3531583399fdf736ccfb95837b362379766955f2d"
+    )
+
+
+@bribes("yBribe Fees")
+def is_ybribe_fees(tx: TreasuryTx) -> bool:
+    return False

yearn_treasury/rules/revenue/farming.py

@@ -0,0 +1,56 @@
+from typing import Final
+
+from dao_treasury import TreasuryTx, revenue
+from y import Contract, Network
+
+from yearn_treasury.rules.constants import ZERO_ADDRESS
+
+
+farming: Final = revenue("Treasury Farming")
+
+
+@farming("COMP Farming", Network.Mainnet)
+async def is_comp_rewards(tx: TreasuryTx) -> bool:
+    return tx.symbol == "COMP" and await _is_generic_comp_rewards(tx)
+
+
+@farming("SCREAM Farming", Network.Fantom)
+async def is_scream_rewards(tx: TreasuryTx) -> bool:
+    return tx.symbol == "SCREAM" and await _is_generic_comp_rewards(tx)
+
+
+@farming("SEX Farming", Network.Fantom)
+def is_sex(tx: TreasuryTx) -> bool:
+    return tx.symbol == "SEX" and tx.from_address in (
+        ZERO_ADDRESS,
+        "0x7FcE87e203501C3a035CbBc5f0Ee72661976D6E1",  # StakingRewards
+    )
+
+
+@farming("SOLID Farming", Network.Fantom)
+def is_solid(tx: TreasuryTx) -> bool:
+    return tx.symbol == "SOLID" and tx.from_address in (
+        "0x7FcE87e203501C3a035CbBc5f0Ee72661976D6E1",  # StakingRewards
+        "0x26E1A0d851CF28E697870e1b7F053B605C8b060F",  # LpDepositor
+    )
+
+
+@farming("SOLIDsex Farming", Network.Fantom)
+def is_solidsex(tx: TreasuryTx) -> bool:
+    return tx.symbol == "SOLIDsex" and tx.from_address in (
+        "0x7FcE87e203501C3a035CbBc5f0Ee72661976D6E1",  # StakingRewards
+        "0xA5e76B97e12567bbA2e822aC68842097034C55e7",  # FeeDistributor
+    )
+
+
+async def _is_generic_comp_rewards(tx: TreasuryTx) -> bool:
+    for event in tx.get_events("DistributedSupplierComp"):
+        if (
+            tx.from_address == event.address
+            and "supplier" in event
+            and tx.to_address == event["supplier"]
+        ):
+            troller = await Contract.coroutine(event.address)
+            if hasattr(troller, "getCompAddress") and tx.token == await troller.getCompAddress:
+                return True
+    return False

yearn_treasury/rules/revenue/keepcoins.py

@@ -0,0 +1,63 @@
+# keepCOINS: excludes keepCRV as the CRV are locked forever.
+from typing import Final, Tuple
+
+from y import Network
+from y.constants import CHAINID
+
+from dao_treasury import TreasuryTx, revenue
+
+
+keepcoins: Final = revenue("keepCOINS")
+
+angle_strats_with_non_specific_names: Final[Tuple[str, ...]] = {  # type: ignore [call-overload]
+    Network.Mainnet: (
+        "0x2CB390212b0e5091a3c0D0331669c1419165CF80",
+        "0x7C2b9DB2Ae5aCC6fAC2Fd6cE9b01A5EB4bDD1309",
+    ),
+}.get(CHAINID, ())
+
+
+@keepcoins("KeepANGLE")
+def is_keep_angle(tx: TreasuryTx) -> bool:
+    return tx.symbol == "ANGLE" and (
+        tx.from_nickname == "Contract: StrategyAngleUSDC"
+        or tx.from_address in angle_strats_with_non_specific_names
+    )
+
+
+@keepcoins("KeepBAL")
+def is_keep_bal(tx: TreasuryTx) -> bool:
+    # This particular tx is pass-thru
+    if (
+        tx.symbol != "BAL"
+        or tx.hash == "0xf4677cce1a08ecd54272cdc1b23bc64693450f8bb5d6de59b8e58e288ec3b2a7"
+    ):
+        return False
+
+    return tx.from_nickname in [
+        "Contract: SSBv3 DAI staBAL3",
+        "Contract: SSBv3 USDC staBAL3",
+        "Contract: SSBv3 USDT staBAL3",
+        "Contract: SSBv3 WETH B-stETH-STABLE",
+        "Contract: SSBv3 WBTC staBAL3-BTC",
+    ] or tx.from_address in [
+        # Contract: Strategy (unhelpful name, we can use address though)
+        "0x960818b3F08dADca90b840298721FE7B419fBE12",
+        "0x074620e389B5715f7ba51Fc062D8fFaf973c7E02",
+        "0xB0F8b341951233BF08A5F15a838A1a85B016aEf9",
+        "0x034d775615d50D870D742caA1e539fC8d97955c2",
+        "0xe614f717b3e8273f38Ed7e0536DfBA60AD021c85",
+    ]
+
+
+@keepcoins("KeepBEETS")
+def is_keep_beets(tx: TreasuryTx) -> bool:
+    return (
+        tx.symbol == "BEETS"
+        and tx.hash != "0x1e997aa8c79ece76face8deb8fe7df4cea4f6a1ef7cd28501013ed30dfbe238f"
+    )
+
+
+@keepcoins("KeepPOOL")
+def is_keep_pool(tx: TreasuryTx) -> bool:
+    return tx.symbol == "POOL" and tx.from_nickname == "Contract: StrategyPoolTogether"

yearn_treasury/rules/revenue/match_on_hash.yaml

@@ -0,0 +1,4 @@
+1:
+  Dinobots:
+    - "0xf1ce47dc8a44fc37ffc580960f22bbe23896cf31bb0484f0cd5d23fc53c4d5fe"
+    - "0xa09e8ed14967023a672d332eb620204b20d63c574bc1b7575fc710cdfb794271"

yearn_treasury/rules/revenue/seasolver.py

@@ -0,0 +1,23 @@
+from typing import Final
+from dao_treasury import TreasuryTx, revenue
+from y import Network
+
+
+seasolver: Final = revenue("Seasolver", Network.Mainnet)
+
+
+@seasolver("Positive Slippage")
+def is_seasolver_slippage_revenue(tx: TreasuryTx) -> bool:
+    # TODO: check this earlier, probably in dao-treasury internals
+    # After may 1 2023 ymechs wallet separated from yearn treasury
+    return (
+        tx.block <= 17162286
+        and tx.from_nickname == "Contract: TradeHandler"
+        and tx.to_nickname == "yMechs Multisig"
+    )
+
+
+@seasolver("CowSwap Incentives")
+def is_cowswap_incentive(tx: TreasuryTx) -> bool:
+    """Incentives for swapping on CowSwap"""
+    return tx.symbol == "COW" and tx.from_address == "0xA03be496e67Ec29bC62F01a428683D7F9c204930"

yearn_treasury/rules/revenue/vaults.py

@@ -0,0 +1,172 @@
+from decimal import Decimal
+from logging import getLogger
+from typing import Final, Optional, cast
+
+from dao_treasury import TreasuryTx, revenue
+from eth_typing import ChecksumAddress
+from faster_async_lru import alru_cache
+from y import Contract, Network
+
+from yearn_treasury.vaults import v1, v2
+
+
+logger: Final = getLogger(__name__)
+
+fees: Final = revenue("Fees")
+
+
+# v1 helpers
+def _is_single_sided(tx: TreasuryTx) -> bool:
+    """Fees from single-sided strategies are not denominated in `vault.token`."""
+    symbol = tx.symbol
+    from_nickname = tx.from_nickname
+    return _is_y3crv(symbol, from_nickname) or _is_ypool(symbol, from_nickname)
+
+
+def _is_y3crv(symbol: str, from_nickname: str) -> bool:
+    return (
+        symbol == "y3Crv"
+        and from_nickname.startswith("Contract: Strategy")
+        and from_nickname.endswith("3pool")
+    )
+
+
+def _is_ypool(symbol: str, from_nickname: str) -> bool:
+    return (
+        symbol == "yyDAI+yUSDC+yUSDT+yTUSD"
+        and from_nickname.startswith("Contract: Strategy")
+        and from_nickname.endswith("ypool")
+    )
+
+
+@alru_cache(maxsize=1000)
+async def _get_rewards(controller: Contract, block: int) -> Optional[ChecksumAddress]:
+    try:
+        return await controller.rewards.coroutine(block_identifier=block)  # type: ignore [no-any-return]
+    except ValueError as e:
+        if str(e) == "No data was returned - the call likely reverted":
+            return None
+        raise
+
+
+@alru_cache(maxsize=None)
+async def _get_controller(vault: Contract) -> Contract:
+    return await Contract.coroutine(await vault.controller)  # type: ignore [return-value]
+
+
+@fees("Vaults V1", Network.Mainnet)
+async def is_v1_vault_fees(tx: TreasuryTx) -> bool:
+    token = tx.token_address
+
+    # Fees from single-sided strategies are not denominated in `vault.token` but everything else is
+    is_single_sided = _is_single_sided(tx)
+
+    for vault, underlying in v1.items():
+        if token != underlying and not is_single_sided:
+            continue
+
+        controller = await _get_controller(vault)
+        rewards = await _get_rewards(controller, tx.block)
+        if tx.to_address != rewards:
+            logger.debug(
+                "to address %s doesnt match rewards address %s", tx.to_address.address, rewards
+            )
+            continue
+        strategy: ChecksumAddress = await controller.strategies.coroutine(
+            underlying, block_identifier=tx.block
+        )
+        if tx.from_address == strategy:
+            return True
+        logger.debug(
+            "from address %s doesnt match strategy %s set on controller %s",
+            tx.from_address.address,
+            strategy,
+            controller,
+        )
+    return False
+
+
+def is_inverse_fees_from_stash_contract(
+    from_address: ChecksumAddress, to_nickname: str | None
+) -> bool:
+    return (
+        from_address == "0xE376e8e8E3B0793CD61C6F1283bA18548b726C2e"
+        and to_nickname == "Token: Curve stETH Pool yVault"
+    )
+
+
+@fees("Vaults V2")
+async def is_v2_vault_fees(tx: TreasuryTx) -> bool:
+    token = tx.token_address
+    from_address = cast(ChecksumAddress, tx.from_address.address)
+    if (
+        from_address == token
+        and (vault := v2.get(from_address))
+        and tx.to_address == await vault.rewards.coroutine(block_identifier=tx.block)
+    ):
+        return True
+
+    if is_inverse_fees_from_stash_contract(from_address, tx.to_nickname):
+        value_usd = cast(Decimal, tx.value_usd)
+        if value_usd > 0:
+            tx.value_usd = -value_usd
+        return True
+
+    return False
+
+
+@fees("Vaults V3")
+def is_v3_vault_fees(tx: TreasuryTx) -> bool:
+    # TODO: fill me in too
+    return False
+
+
+@fees("YearnFed", Network.Mainnet)
+def is_yearn_fed_fees(tx: TreasuryTx) -> bool:
+    symbol = tx.symbol
+    from_address = tx.from_address
+    # New version
+    if (
+        symbol in ["yvCurve-DOLA-U", "CRV"]
+        and from_address == "0x64e4fC597C70B26102464B7F70B1F00C77352910"
+    ):
+        return True
+    # Old versions
+    if symbol in ["yvCurve-DOLA-U", "yveCRV-DAO"] and from_address in [
+        "0x09F61718474e2FFB884f438275C0405E3D3559d3",
+        "0x7928becDda70755B9ABD5eE7c7D5E267F1412042",
+    ]:
+        return True
+    if (
+        symbol == "INV"
+        and tx.from_nickname == "Inverse Treasury"
+        and tx.to_nickname == "ySwap Multisig"
+    ):
+        return True
+    if (
+        from_address == "0x9D5Df30F475CEA915b1ed4C0CCa59255C897b61B"
+        and tx.to_nickname == "ySwap Multisig"
+    ):
+        return True
+    return False
+
+
+@fees("DOLAFRAXBP", Network.Mainnet)
+def is_dolafraxbp_fees(tx: TreasuryTx) -> bool:
+    return (
+        tx.from_nickname == "Contract: StrategyConvexFraxBpRewardsClonable"
+        and tx.to_nickname == "Yearn yChad Multisig"
+        and tx.symbol == "yvCurve-DOLA-FRAXBP-U"
+    )
+
+
+@fees("TempleDAO Private Vault", Network.Mainnet)
+def is_temple(tx: TreasuryTx) -> bool:
+    if tx.to_nickname in ["Yearn Treasury", "Yearn yChad Multisig"]:  # fees have been sent to both
+        from_nickname = tx.from_nickname
+        symbol = tx.symbol
+        if from_nickname == "Contract: StrategyConvexCrvCvxPairsClonable" and symbol == "CRV":
+            return True
+        elif from_nickname == "Contract: Splitter" and symbol in ["yveCRV-DAO", "CRV"]:
+            return True
+    return False

yearn_treasury/rules/revenue/yteams.py

@@ -0,0 +1,17 @@
+from typing import Final
+
+from dao_treasury import TreasuryTx, revenue
+from y import Network
+
+
+OXSPLIT_CONTRACT: Final = "0x2ed6c4B5dA6378c7897AC67Ba9e43102Feb694EE"
+SPLITS_WAREHOUSE_CONTRACT: Final = "0x8fb66F38cF86A3d5e8768f8F1754A24A6c661Fb8"
+
+
+@revenue("yTeam Rev Share", Network.Mainnet)
+def is_yteam_rev_share(tx: TreasuryTx) -> bool:
+    return tx.from_address in [OXSPLIT_CONTRACT, SPLITS_WAREHOUSE_CONTRACT] or tx.hash in [
+        # These predate the split implementation and must be accounted for separately
+        # yAudit
+        "0x6e4f4405bd0970d42a48795a5219c14c763705f6ea9879affea652438758c065",
+    ]

yearn_treasury/shitcoins.py

@@ -0,0 +1,144 @@
+"""
+List of "shitcoins" (but like, actual shit shitcoins) to ignore in all
+Yearn Treasury analytics.
+
+This module defines, for each blockchain network, a set of token addresses
+known to be unpricable, considered as spam, or otherwise unwanted for
+reporting and analytics. These tokens are passed in to :mod:`eth-portfolio`,
+which contains the logic that prevents these shitcoins from being included in
+any Yearn Treasury outputs.
+
+Since these tokens do nothing but add noise to the outputs, transactions
+involving them are excluded from treasury calculations, reports, and dashboards.
+"""
+
+from typing import Final
+
+from y import Network, convert
+from y.constants import CHAINID
+
+
+_SHITCOINS: Final = {
+    Network.Mainnet: (
+        "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",  # UNI-V3 NFT, not shitcoin but not pricable
+        "0x0329b631464C43f4e8132df7B4ac29a2D89FFdC7",
+        "0xa191021599f60E2fDE1bc8c8d1a07e9BD663c4a9",
+        "0xD1E5b0FF1287aA9f9A268759062E4Ab08b9Dacbe",  # .crypto domain NFT
+        "0x0B39Bb088f03b0baeA1AAC64AaEAb85E714c76e2",
+        "0x6cC759B8cE30e719511B6a897CfE449A19f64a92",
+        "0xD7aBCFd05a9ba3ACbc164624402fB2E95eC41be6",
+        "0xeaaa790591c646b0436f02f63e8Ca56209FEDE4E",
+        "0x1e988ba4692e52Bc50b375bcC8585b95c48AaD77",
+        "0xeF81c2C98cb9718003A89908e6bd1a5fA8A098A3",
+        "0x174Cd3359C6a4E6B64D2995Da4E2E4631379526E",
+        "0x1d41cf24dF81E3134319BC11c308c5589A486166",
+        "0x437a6B880d4b3Be9ed93BD66D6B7f872fc0f5b5E",
+        "0x53fFFB19BAcD44b82e204d036D579E86097E5D09",
+        "0x9694EED198C1b7aB81ADdaf36255Ea58acf13Fab",
+        "0x1AbBaC88B8F47D46a3d822eFA75F64A15C25966f",
+        "0x195EC13Ef52c30CEb4019A055e7938DAfAE21B6a",
+        "0xde32436e18c6946ED3559B925e3340Bf6D80B67A",
+        "0x2Fe158f89F32C9C5E6C7082487DBB26e42071512",
+        "0x9017201ae20f0940dB37723Cd704e80BcaA1347c",
+        "0x5C3509b1BeB81aC9621AEd482a77038Ef1fD1f5D",
+        "0x34D0f1Cb08D47dC1333657A0A84Df2462e806656",
+        "0x799dc7a6017BC623A4fef6828FA49b5661ed53fb",
+        "0xA00C7A61BcBb3F0ABCafACD149A3008A153b2DAb",
+        "0x11068577AE36897fFaB0024F010247B9129459E6",
+        "0x57b9d10157f66D8C00a815B5E289a152DeDBE7ed",
+        "0x01234567bac6fF94d7E4f0EE23119CF848F93245",
+        "0xe5868468Cb6Dd5d6D7056bd93f084816c6eF075f",
+        "0x0a24Bb4842c301276c65086B5d78D5C872993c72",
+        "0x63125c0d5Cd9071de9A1ac84c400982f41C697AE",
+        "0x4d22921215cF37e8d49e2Ac6d1F5e9672f63A7c6",
+        "0xe2549E429B78458fa60BC7B1b284d4411E1D5105",
+        "0xCfdD747d041397bcE08B0Fe6ebF7Ef65E9F46795",
+        "0x9745969171a38B40db05c506fe2DA2C36f317627",
+        "0x6051C1354Ccc51b4d561e43b02735DEaE64768B8",
+        "0xf0814d0E47F2390a8082C4a1BD819FDDe50f9bFc",
+        "0x2DBd330bC9B7f3A822a9173aB52172BdDDcAcE2A",
+        "0x1368452Bfb5Cd127971C8DE22C58fBE89D35A6BF",  # JNTR/e
+        # just andre tinkering
+        "0x5cB5e2d7Ab9Fd32021dF8F1D3E5269bD437Ec3Bf",
+        # these arent shitcoins per se but we can't price them and dont expect to in the future, lets save cpu cycles
+        "0x9d45DAb69f1309F1F55A7280b1f6a2699ec918E8",  # yFamily NFT <3
+        "0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85",  # ENS
+        "0xD057B63f5E69CF1B929b356b579Cba08D7688048",  # vCOW
+        "0x4c1317326fD8EFDeBdBE5e1cd052010D97723bd6",  # deprecated yCRV
+        "0x8a0889d47f9Aa0Fac1cC718ba34E26b867437880",  # deprecated st-yCRV
+        "0x55a290f08Bb4CAe8DcF1Ea5635A3FCfd4Da60456",  # BITTO
+        "0x4770F3186225b1A6879983BD88C669CA55463886",  # 69XMins
+        "0x05bAdF8A8e7fE5b43fae112108E26f2f663Bf1a2",  # INUNOMICS
+        "0x3EF9181c9b96BAAafb3717A553E808Ccc72be37D",  # MEMEPEPE
+        "0x5D22c8b4E3c90ca633e1377e6ca280a395fc61C0",  # XMEME
+        "0x57f19E7e1A9066a741f59484481C4D2E9150e9E2",  # MOCO
+        "0xb092D8E13Ba50963D57bEcB17a037728D883D02d",  # BABYLABUBU
+        "0x4E51960bd33A6edA71a8B24A76311834BD98DD9f",  # AICC
+        "0xB85485421d8a41C4648AB80bE1A725fA6b5Bc86d",  # MEGA
+        "0x46D0Fb47b1e91130D53498EbeE7A968e7e6599f9",  # Ghibli
+        "0x4FbB350052Bca5417566f188eB2EBCE5b19BC964",  # GRG
+        "0x1f6DEb07E1a19bAfF90EC4075447eeF6eb96c0BA",  # BABYMANYU
+        "0xD10EFABA11A51237fa120b15153DD432958bbDE3",  # JIFFPOM
+        "0xCd9594cd25ED2a166362b6F76c523da08c4Ef2e5",  # ESTHER
+        "0x16B907b5d1208Ae6086dE983a5EF45E7890eF272",  # JUNFOX
+        "0xdE56173463d6461001B0891bC90DB224965f5762",  # MAGNUS
+        "0x922824A5b3B3D5f4485fF52F4Ab7Cba5eA491874",  # POSEIDON
+        "0x84F7D2f6FB447Bb11d3E7Ce64D83e1c02c2F3078",  # VIRTUAL
+        "0x5C6Ed14E1017cf75C237A4A4b93Ce1D2f83EB002",  # GRVT
+        "0xf76E6eFf109258fd5F52823d9F9feE7c90C97251",  # wkeyDAO
+        "0x1BA4b447d0dF64DA64024e5Ec47dA94458C1e97f",  # Hegic V8888 Options Token
+        # test token?
+        "0x372d5d02c6b4075bd58892f80300cA590e92d29E",  # tOUSG
+        # dETH? don't think this is needed
+        "0x3d1E5Cf16077F349e999d6b21A4f646e83Cd90c5",
+        # ai shitcoin spam
+        "0xaf80B7dbeBbb5d9a4d33C453FcbF3d054DA53b25",  # NODEPAY AI
+        "0xf960AbF9ccC883970BEa3E79f65027E27278e1A5",  # ASK AI
+        "0xc136Eb8Abc892723aE87F355d12Cb721C4324D54",  # Grok3
+        "0xc68bCEE3604F163f183Cf8B9a26E610E5961b037",  # TESLA AI
+        "0xa65D56f8e074E773142205cD065FD0796B9aa483",  # MASSIVE AI
+        "0x4e6c80aa486aF0ba20943Fbc067a5557DBcf5458",  # SUNO AI
+        "0xC91223F844772dCdc2c6394585C8c30B3c1BE5C0",  # SEND AI
+        "0x64b3336D1aDC6D3579e356760F53D3b018Cb11Bc",  # ALC AI
+        "0x1495Ac869433698cCD2946c1e62D37bA766294A9",  # NVIDIA AI PC
+        "0x8c0DF275c38092cd90Ae4d6147d8e619B3A24637",  # COLLE AI
+        "0xe38f71fc2Ca5f5761cE21F39Fff2cE70662FA54c",  # CHAINOPERA AI
+        "0xD2F89F59fBC7125b406e3F60A992DFa9FdB76524",  # MISTRAL AI
+        "0xa0CCdBCeB5Da30F9d62F7A727F2B35C69dF08760",  # CHUNK AI
+        "0x7CE31075d7450Aff4A9a82DdDF69D451B1e0C4E9",  # DEEPSEEK AI
+        "0xf0f9C021AF9B6431FA59DAB75C8e6cB80c0dEa37",  # TESLA AI
+        "0x635eeC65a7Ef10dCF96Bfe051D8A6e5960efe180",  # KLING AI
+        "0xa3Efa0929569c15c20f89B591931899Fb05B4663",  # GPT-5
+        "0x0A953979fdCfD82B08C77dB29705327BeC39ff13",  # GROK4 AI
+        "0xc83377b9eE3CEe4Cc03CCd58AfdE1FB12864aEE3",  # E AI
+        "0x927402ab67c0CDA3c187E9DFE34554AC581441f2",  # SAITABIT
+        "0x691539810DF6e879A377C24CfEE130BBE92708d8",  # NVIDIA AI
+        "0xdC82aC0A89197854cb2240FaBF7E7760a4fF4d9e",  # NVIDIA
+        "0x5Fba8ea5A559CF5c99BA6dd884Ae17C1d621fE5B",  # OSCAR AI
+        "0x57b055656460055192c8EAf616F90Ab76a32CC20",  # Openx
+        # matt furry spam
+        "0x73228b3D33cC71cB721Fc62950577bE63bd9c8C9",  # Maskman by Matt Furie
+        "0x7c28e66436C93BB9F657dDF2BA0eeeCf61369b92",  # Bloodboy by Matt Furie
+        "0x70c5e1124569f17B1Be71E15833EaF1331f8727F",  # Pac-hat by Matt Furie
+        "0xBd6555eC87C8A9a2280dCD6df45b9b074fC93Df2",  # Bork by Matt Furie
+        # test token
+        "0x2F375Ce83EE85e505150d24E85A1742fd03cA593",  # TEST
+    ),
+}
+"""
+Mapping of blockchain networks to tuples of token addresses that should be
+ignored in Yearn Treasury analytics. These tokens are considered unpricable,
+spam, or otherwise unwanted for reporting and analytics purposes.
+
+Each tuple contains token contract addresses that will be excluded from
+treasury calculations, reports, and dashboards for the corresponding network.
+"""
+
+
+SHITCOINS: Final = {convert.to_address(shitcoin) for shitcoin in _SHITCOINS.get(CHAINID, ())}  # type: ignore [call-overload]
+"""Set of checksummed token addresses to ignore for the current chain.
+
+This set is derived from the _SHITCOINS mapping for the current CHAINID,
+and is used to filter out unpricable, spam, or otherwise unwanted tokens
+from all Yearn Treasury analytics and reporting.
+"""