yearn-treasury 0.1.5__tar.gz

yearn_treasury-0.1.5/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include yearn_treasury *.yaml

yearn_treasury-0.1.5/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: yearn_treasury
+Version: 0.1.5
+Summary: This WIP library runs the eth-portfolio and dao-treasury exporters for the Yearn Finance treasury.
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10,<3.13
+Description-Content-Type: text/markdown
+Requires-Dist: dao-treasury==0.1.7
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+This WIP library runs the [dao-treasury](https://github.com/BobTheBuidler/dao-treasury) exporter for the [Yearn Finance](https://yearn.fi/) treasury.
+
+## Installation
+
+- **pip:**
+  ```bash
+   pip install yearn-treasury
+  ```
+
+- **From Source:**  
+  ```bash
+  git clone https://github.com/BobTheBuidler/yearn-treasury
+  cd yearn-treasury
+  poetry install
+  ```
+
+## Requirements
+- Python 3.10 or higher.
+- At least 16GB of RAM.
+- All dependencies installed as specified in the project’s pyproject.toml file.
+
+## Prerequisites
+
+- First, you will need to bring your own archive node. This can be one you run yourself, or one from one of the common providers (Tenderly, Alchemy, QuickNode, etc.). Your archive node must have tracing enabled (free-tier Alchemy nodes do not support this option).
+- You must configure a [brownie network](https://eth-brownie.readthedocs.io/en/stable/network-management.html) to use your RPC.
+- You will need an auth token for [Etherscan](https://etherscan.io/)'s API. Follow their [guide](https://docs.etherscan.io/etherscan-v2/getting-an-api-key) to get your key, and set env var `ETHERSCAN_TOKEN` with its value.
+- You'll also need [Docker](https://www.docker.com/get-started/) installed on your system. If on MacOS, you will need to leave Docker Desktop open while Yearn Treasury is running.
+
+## Usage
+
+Run the treasury export tool:
+
+```bash
+# For pip installations:
+yearn-treasury --network mainnet --interval 12h
+```
+
+For local development (from source installation), use:
+```bash
+poetry run yearn-treasury --network mainnet --interval 12h
+```
+
+**CLI Options:**
+- `--network`: The id of the brownie network the exporter will connect to (default: mainnet)
+- `--interval`: The time interval between each data snapshot (default: 12h)
+- `--daemon`: Run the export process in the background (default: False) (NOTE: currently unsupported)
+- `--grafana-port`: Set the port for the Grafana dashboard where you can view data (default: 3004)
+- `--renderer-port`: Set the port for the report rendering service (default: 8080)
+- `--victoria-port`: Set the port for the Victoria metrics reporting endpoint (default: 8430)
+
+After running the command, the export script will run continuously until you close your terminal.
+To access the dashboard, open your browser and navigate to [http://localhost:3004](http://localhost:3004) for the [dao-treasury](https://github.com/BobTheBuidler/dao-treasury) dashboard.
+
+Enjoy!
+
+## Screenshots
+
+#### [Transactions Dashboard](https://bobthebuidler.github.io/yearn-treasury/transactions.html)
+
+![image](https://github.com/user-attachments/assets/4293b62d-827a-4bae-af4f-014c99511f99)

yearn_treasury-0.1.5/README.md

@@ -0,0 +1,60 @@
+This WIP library runs the [dao-treasury](https://github.com/BobTheBuidler/dao-treasury) exporter for the [Yearn Finance](https://yearn.fi/) treasury.
+
+## Installation
+
+- **pip:**
+  ```bash
+   pip install yearn-treasury
+  ```
+
+- **From Source:**  
+  ```bash
+  git clone https://github.com/BobTheBuidler/yearn-treasury
+  cd yearn-treasury
+  poetry install
+  ```
+
+## Requirements
+- Python 3.10 or higher.
+- At least 16GB of RAM.
+- All dependencies installed as specified in the project’s pyproject.toml file.
+
+## Prerequisites
+
+- First, you will need to bring your own archive node. This can be one you run yourself, or one from one of the common providers (Tenderly, Alchemy, QuickNode, etc.). Your archive node must have tracing enabled (free-tier Alchemy nodes do not support this option).
+- You must configure a [brownie network](https://eth-brownie.readthedocs.io/en/stable/network-management.html) to use your RPC.
+- You will need an auth token for [Etherscan](https://etherscan.io/)'s API. Follow their [guide](https://docs.etherscan.io/etherscan-v2/getting-an-api-key) to get your key, and set env var `ETHERSCAN_TOKEN` with its value.
+- You'll also need [Docker](https://www.docker.com/get-started/) installed on your system. If on MacOS, you will need to leave Docker Desktop open while Yearn Treasury is running.
+
+## Usage
+
+Run the treasury export tool:
+
+```bash
+# For pip installations:
+yearn-treasury --network mainnet --interval 12h
+```
+
+For local development (from source installation), use:
+```bash
+poetry run yearn-treasury --network mainnet --interval 12h
+```
+
+**CLI Options:**
+- `--network`: The id of the brownie network the exporter will connect to (default: mainnet)
+- `--interval`: The time interval between each data snapshot (default: 12h)
+- `--daemon`: Run the export process in the background (default: False) (NOTE: currently unsupported)
+- `--grafana-port`: Set the port for the Grafana dashboard where you can view data (default: 3004)
+- `--renderer-port`: Set the port for the report rendering service (default: 8080)
+- `--victoria-port`: Set the port for the Victoria metrics reporting endpoint (default: 8430)
+
+After running the command, the export script will run continuously until you close your terminal.
+To access the dashboard, open your browser and navigate to [http://localhost:3004](http://localhost:3004) for the [dao-treasury](https://github.com/BobTheBuidler/dao-treasury) dashboard.
+
+Enjoy!
+
+## Screenshots
+
+#### [Transactions Dashboard](https://bobthebuidler.github.io/yearn-treasury/transactions.html)
+
+![image](https://github.com/user-attachments/assets/4293b62d-827a-4bae-af4f-014c99511f99)

yearn_treasury-0.1.5/pyproject.toml

@@ -0,0 +1,57 @@
+[tool.poetry]
+name = "yearn-treasury"
+version = "0.1.5"
+description = "This WIP library runs the eth-portfolio and dao-treasury exporters for the Yearn Finance treasury."
+authors = ["Bob The Buidler <you@example.com>"]
+packages = [{ include = "yearn_treasury/*" }]
+
+[build-system]
+requires = [
+    "setuptools",
+    "wheel",
+    "mypy[mypyc]==1.19.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+    "types-requests",
+    "dao-treasury==0.1.7; platform_system == 'Linux' and platform_machine != 'i686'",
+    "eth-brownie==1.22.0.dev0; platform_system == 'Linux'",
+    "eth-typing==5.2.1",
+]
+build-backend = "setuptools.build_meta"
+
+[tool.poetry.scripts]
+yearn-treasury = "yearn_treasury.main:main"
+
+[tool.poetry.dependencies]
+python = ">=3.10,<3.13"
+dao-treasury = "==0.1.7"
+
+[tool.poetry.group.dev.dependencies]
+mypy = "1.19.0"
+types-requests = "*"
+
+[tool.poetry.group.docs.dependencies]
+sphinx = "*"
+sphinx-rtd-theme = "*"
+myst-parser = "*"
+
+[tool.mypy]
+exclude = ["build/","cache/","env/", "tests/", "setup.py"]
+ignore_missing_imports = true
+check_untyped_defs = true
+
+[tool.black]
+line-length = 100
+target-version = ['py310']
+include = '\.pyi?$'
+exclude = '''
+/(
+    \.git
+  | \.hypothesis
+  | \.mypy_cache
+  | \.pytest_cache
+  | \.venv
+  | cache
+  | dist
+  | env
+)/
+'''

yearn_treasury-0.1.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yearn_treasury-0.1.5/setup.py

@@ -0,0 +1,221 @@
+from pathlib import Path
+from setuptools import find_packages, setup
+
+try:
+    from mypyc.build import mypycify
+except ImportError:
+    ext_modules = []
+else:
+    ext_modules = mypycify(
+        [
+            "yearn_treasury/budget",
+            "yearn_treasury/rules/constants.py",
+            "yearn_treasury/rules/cost_of_revenue/gas.py",
+            "yearn_treasury/rules/expense",
+            # "yearn_treasury/rules/ignore",
+            "yearn_treasury/rules/ignore/swaps/conversion_factory.py",
+            "yearn_treasury/rules/ignore/swaps/auctions.py",
+            # "yearn_treasury/rules/ignore/swaps/curve.py",  enable with brownie 1.22.0
+            "yearn_treasury/rules/ignore/swaps/gearbox.py",
+            "yearn_treasury/rules/ignore/swaps/iearn.py",
+            "yearn_treasury/rules/ignore/swaps/otc.py",
+            "yearn_treasury/rules/ignore/swaps/pooltogether.py",
+            "yearn_treasury/rules/ignore/swaps/synthetix.py",
+            "yearn_treasury/rules/ignore/swaps/unwrapper.py",
+            "yearn_treasury/rules/ignore/swaps/vaults.py",
+            "yearn_treasury/rules/ignore/swaps/woofy.py",
+            "yearn_treasury/rules/ignore/swaps/yfi.py",
+            "yearn_treasury/rules/ignore/swaps/yla.py",
+            "yearn_treasury/rules/ignore/general.py",
+            "yearn_treasury/rules/ignore/unit.py",
+            "yearn_treasury/rules/ignore/weth.py",
+            "yearn_treasury/rules/ignore/ygov.py",
+            "yearn_treasury/rules/other_expense",
+            "yearn_treasury/rules/other_income",
+            "yearn_treasury/rules/revenue/bribes.py",
+            "yearn_treasury/rules/revenue/farming.py",
+            "yearn_treasury/rules/revenue/keepcoins.py",
+            "yearn_treasury/rules/revenue/seasolver.py",
+            # "yearn_treasury/rules/revenue/vaults.py",  enable with brownie 1.22.0
+            "yearn_treasury/rules/revenue/yteams.py",
+            "yearn_treasury/_db.py",
+            "yearn_treasury/_ens.py",
+            "yearn_treasury/_logging.py",
+            "yearn_treasury/vaults.py",
+            "--strict",
+            "--pretty",
+            "--disable-error-code=unused-ignore",
+            "--disable-error-code=union-attr",
+            "--disable-error-code=no-any-return",
+            "--disable-error-code=untyped-decorator",
+            "--disable-error-code=misc",  # TODO: drop support for 32bit systems
+        ],
+        group_name="yearn_treasury",
+    )
+
+
+try:
+    import tomllib  # Python 3.11+
+except ModuleNotFoundError:
+    import tomli as tomllib  # Older Python
+
+
+with Path("pyproject.toml").open("rb") as f:
+    pyproject_data = tomllib.load(f)
+    poetry_config = pyproject_data["tool"]["poetry"]
+
+
+def poetry_dependencies_to_install_requires(poetry_deps):
+    """
+    Reads [tool.poetry.dependencies] in pyproject.toml and converts them
+    into a list of valid PEP 508–compatible dependency strings for setuptools.
+    """
+    if not poetry_deps:
+        return []
+
+    install_requires = []
+    for name, spec in poetry_deps.items():
+        # Poetry often puts a 'python' key for the project's own Python requirement:
+        #   [tool.poetry.dependencies]
+        #   python = "^3.7"
+        # We'll skip that, because it's not an actual package dep.
+        if name.lower() == "python":
+            continue
+
+        if pep508_str := poetry_dep_to_pep508_string(name, spec):
+            install_requires.append(pep508_str)
+
+    return install_requires
+
+
+def poetry_dep_to_pep508_string(package_name, spec):
+    """
+    Convert a Poetry-style dependency spec into a single string usable by
+    setuptools (PEP 508). Handles "version", "markers", "extras", and "python".
+
+    Examples of 'spec':
+      ">=1.0"                  (just a string)
+      { version=">=1.0,<2.0" }
+      { version=">=1.0", markers="python_version < '3.9'", python=">=3.7,<3.10" }
+      { extras=["some_extra"], version=">=2.0" }
+    """
+    if isinstance(spec, str):
+        # e.g. ">=1.0" or "*"
+        if spec.strip() == "*":
+            # "*" means "any version," so just return the package name alone.
+            return package_name
+        return f"{package_name}{format_version_part(spec)}"
+
+    if isinstance(spec, dict):
+        return poetry_dep_dict_to_pep508_string(spec, package_name)
+    # If it's unrecognized, just return the package name as a fallback:
+    return str(package_name)
+
+
+# TODO Rename this here and in `poetry_dep_to_pep508_string`
+def poetry_dep_dict_to_pep508_string(spec, package_name):
+    version_part = spec.get("version", "")
+    markers_part = spec.get("markers", "")
+    python_part = spec.get("python", "")
+    extras = spec.get("extras", [])
+
+    # If version == "*", treat it as no version
+    if version_part.strip() == "*":
+        version_part = ""
+
+        # Turn extras into a "pkg[extra1,extra2]" form if there are any
+    pkg_with_extras = f"{package_name}[{','.join(extras)}]" if extras else package_name
+    # Build up a Python-version marker if "python" is given
+    # e.g., python=">=3.7,<3.9" => "python_version >= '3.7' and python_version < '3.9'"
+    py_marker = convert_python_spec_to_marker(python_part) if python_part else ""
+
+    # Combine any existing spec markers with this python marker.
+    # If both exist, we'll join them with " and ".
+    combined_markers = combine_markers(markers_part, py_marker)
+
+    # Build final requirement:
+    #   pkg[extras]>1.0 ; (python_version >= '3.7' and <some_other_marker>)
+    # If there's no combined_markers, we omit the semicolon part entirely.
+    requirement = pkg_with_extras + format_version_part(version_part)
+    if combined_markers:
+        requirement += f" ; {combined_markers}"
+
+    return requirement
+
+
+def format_version_part(version_spec):
+    """
+    If version_spec starts with an operator, prepend a space
+    so it looks like "mypkg >=1.0.0" instead of "mypkg>=1.0.0".
+    """
+    return f" {version_spec}" if version_spec else ""
+
+
+def convert_python_spec_to_marker(python_spec):
+    """
+    Very basic converter for something like ">=3.7,<3.10"
+    into "python_version >= '3.7' and python_version < '3.10'".
+    It doesn't handle ^ or ~ operators. If needed, expand this logic.
+    """
+    if not python_spec:
+        return ""
+
+    parts = [p.strip() for p in python_spec.split(",")]
+    marker_clauses = []
+    for part in parts:
+        for op in [">=", "<=", "==", "!=", ">", "<"]:
+            if part.startswith(op):
+                version_val = part[len(op) :].strip()
+                marker_clauses.append(f"python_version {op} '{version_val}'")
+                break
+        else:
+            # If we didn't break, we didn't find a known operator
+            # fallback to "=="
+            if part:
+                marker_clauses.append(f"python_version == '{part}'")
+
+    return " and ".join(marker_clauses)
+
+
+def combine_markers(a, b):
+    """
+    Combine two marker expressions (a and b) with "and" if both are non-empty.
+    If one is empty, return the other.
+    """
+    a = a.strip()
+    b = b.strip()
+    return f"({a}) and ({b})" if a and b else a or b
+
+
+with open("README.md", "r", encoding="utf-8") as readme:
+    long_description = readme.read()
+
+
+setup(
+    name=poetry_config["name"].replace("-", "_"),
+    version=poetry_config["version"],
+    python_requires=">=3.10,<3.13",
+    packages=find_packages(),
+    package_data={"yearn_treasury": ["py.typed"]},
+    include_package_data=True,
+    description=poetry_config["description"],
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    entry_points={"console_scripts": ["yearn-treasury=yearn_treasury.main:main"]},
+    install_requires=poetry_dependencies_to_install_requires(poetry_config["dependencies"]),
+    ext_modules=ext_modules,
+    zip_safe=False,
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "Intended Audience :: Science/Research",
+        "Intended Audience :: End Users/Desktop",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: Implementation :: CPython",
+        "Operating System :: OS Independent",
+        "Topic :: Software Development :: Libraries",
+    ],
+)

yearn_treasury-0.1.5/yearn_treasury/__init__.py

@@ -0,0 +1,20 @@
+import warnings
+
+from yearn_treasury import budget
+from yearn_treasury._db import prepare_db
+from yearn_treasury._logging import setup_eth_portfolio_logging
+
+
+prepare_db()
+setup_eth_portfolio_logging()
+
+
+warnings.filterwarnings(
+    "ignore",
+    message=".Event log does not contain enough topics for the given ABI.",
+    category=UserWarning,
+    module="brownie.network.event",
+)
+
+
+__all__ = ["budget"]

yearn_treasury-0.1.5/yearn_treasury/_db.py

@@ -0,0 +1,51 @@
+"""
+Database labeling utility for Yearn Treasury.
+
+This module provides a helper function to set up address nicknames
+in the database, mapping key Yearn Treasury addresses to human-readable
+labels. It is used during database preparation to ensure that wallet
+addresses are clearly labeled in analytics and reporting.
+
+When Yearn Treasury is imported, this module maps important addresses
+to descriptive nicknames within the DAO Treasury database entity system
+for improved data clarity and prettification of reports.
+"""
+
+# mypy: disable-error-code="arg-type"
+import time
+
+import dao_treasury._docker
+from dao_treasury.db import Address, init_db
+from y import Network
+from y.constants import CHAINID
+
+from yearn_treasury import constants
+
+
+def prepare_db() -> None:
+    """
+    Set up address nicknames in the Yearn Treasury database.
+
+    Maps key Yearn Treasury addresses to human-readable labels for improved
+    clarity in analytics and reporting. This function is typically called
+    during database preparation to ensure wallet addresses are labeled
+    within the DAO Treasury database entity system.
+    """
+    # We need to start the postgres container earlier than dao-treasury does
+    dao_treasury._docker.up("postgres")
+
+    time.sleep(5)
+
+    init_db()
+
+    chad = {Network.Mainnet: "y", Network.Fantom: "f"}[CHAINID]  # type: ignore [index]
+
+    labels = {
+        constants.TREASURY_MULTISIG: "Yearn Treasury",
+        constants.YCHAD_MULTISIG: f"Yearn {chad}Chad Multisig",
+        # constants.STRATEGIST_MULTISIG: "Yearn Strategist Multisig",
+        # This wallet is an EOA that has been used to assist in bridging tokens across chains.
+        "0x5FcdC32DfC361a32e9d5AB9A384b890C62D0b8AC": "Bridge Assistooor EOA",
+    }
+
+    Address.set_nicknames(labels)

yearn_treasury-0.1.5/yearn_treasury/_ens.py

@@ -0,0 +1,31 @@
+"""
+ENS resolver and event topic utilities for Yearn Treasury.
+
+This module defines the ENS resolver contract and event topic set
+used for dynamic vault discovery and event processing. It supports
+vault mapping and analytics by enabling on-chain lookups and event
+filtering for Yearn vaults.
+
+Key Responsibilities:
+    - Provide the ENS resolver contract for vault registry lookups.
+    - Construct event topic sets for AddressChanged events.
+    - Used by vault discovery, analytics, and reporting modules.
+"""
+
+from typing import Final
+
+from brownie import web3
+from web3._utils.abi import filter_by_name
+from web3._utils.events import construct_event_topic_set
+from y import Contract
+
+
+resolver: Final[Contract] = Contract("0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41")
+
+topics: Final = construct_event_topic_set(
+    filter_by_name("AddressChanged", resolver.abi)[0],  # type: ignore [arg-type]
+    web3.codec,
+    {"node": web3.ens.namehash("v2.registry.ychad.eth")},  # type: ignore [union-attr]
+)
+
+__all__ = ["resolver", "topics"]

yearn_treasury-0.1.5/yearn_treasury/_logging.py

@@ -0,0 +1,43 @@
+# mypy: disable-error-code="list-item"
+"""
+Error log suppression utilities for the Yearn Treasury exporter.
+
+This module suppresses noisy or irrelevant eth-portfolio error logs for specific
+token addresses that are known to be deprecated or otherwise unpricable.
+
+To suppress logs for additional tokens, add their addresses to the
+`suppress_logs_for[Network.<chain>]` mapping. The rest will be done
+automatically on package import.
+"""
+
+from typing import Dict, Final, List
+
+from cchecksum import to_checksum_address
+from eth_portfolio._utils import SUPPRESS_ERROR_LOGS
+from eth_typing import HexAddress
+from y import Network
+
+from yearn_treasury.constants import CHAINID
+
+
+suppress_logs_for: Final[Dict[Network, List[HexAddress]]] = {
+    Network.Mainnet: [
+        "0xBF7AA989192b020a8d3e1C65a558e123834325cA",  # unpriceable yvWBTC - This vault had a bug and does not have a pricePerShare
+        "0x5aFE3855358E112B5647B952709E6165e1c1eEEe",  # SAFE - This was not tradeable at the time of the first airdrops
+        "0x718AbE90777F5B778B52D553a5aBaa148DD0dc5D",  # yvCurve-alETH - The underlying curve pool had an issue and is unpriceable
+        "0x3819f64f282bf135d62168C1e513280dAF905e06",  # HDRN
+        "0x5fAa989Af96Af85384b8a938c2EdE4A7378D9875",  # GAL
+    ],
+}
+
+
+def setup_eth_portfolio_logging() -> None:
+    """
+    Suppress eth-portfolio error logs for specific tokens on the current chain.
+
+    Appends token addresses from the suppress_logs_for mapping (for the current
+    CHAINID) to the SUPPRESS_ERROR_LOGS list, preventing error logs for these
+    tokens from being emitted during analytics and reporting.
+    """
+    for token in suppress_logs_for.get(CHAINID, []):  # type: ignore [call-overload]
+        SUPPRESS_ERROR_LOGS.append(to_checksum_address(token))

yearn_treasury-0.1.5/yearn_treasury/address_labels.yaml

@@ -0,0 +1,39 @@
+1:
+  Yearn Treasury V1:
+    - "0xb99a40fcE04cb740EB79fC04976CA15aF69AaaaE"
+  Yearn Strategist Multisig: # refactor this to do from python from constants file
+    - "0x16388463d60FFE0661Cf7F1f31a7D658aC790ff7"
+  yMechs Multisig:
+    - "0x2C01B4AD51a67E2d8F02208F54dF9aC4c0B778B6"
+  ySwap Multisig:
+    - "0x7d2aB9CA511EBD6F03971Fb417d3492aA82513f0"
+  Yearn KP3R Wallet:
+    - "0x8d12a197cb00d4747a1fe03395095ce2a5cc6819"
+  Token Dumper Multisig:
+    - "0xC001d00d425Fa92C4F840baA8f1e0c27c4297a0B"
+  Cowswap Multisig:
+    - "0xA03be496e67Ec29bC62F01a428683D7F9c204930"
+  dYFI Redemption Contract:
+    - "0x7dC3A74F0684fc026f9163C6D5c3C99fda2cf60a"
+  Yearn veFarming Multisig:
+    - "0x4fc1b14cD213e7B6212145Ba4f180C3d53d1A11e"
+  CRV Buyer Contract (DAI):
+    - "0x0000000000007F150Bd6f54c40A34d7C3d5e9f56"
+  CRV Buyer Contract (USDT):
+    - "0x0000000000005117Dd3A72E64a705198753FDD54"
+  YFI Buyer Contract:
+    - "0x0000000000884A0E1fB44F9E24Fa3BDB19514fAE"
+    - "0x0000000000051666BBfBB42925C3eE5d50cF6B10"
+  Multichain Fantom Bridge:
+    - "0xC564EE9f21Ed8A2d8E7e76c085740d5e4c5FaFbE"
+  yLockers Multisig:
+    - "0x4444AAAACDBa5580282365e25b16309Bd770ce4a"
+  yRoboTreasury Treasury Contract:
+    - "0xEf77cc176c748d291EfB6CdC982c5744fC7211c8"
+  yRoboTreasury Stables Reserve:
+    - "0x278374fFb10B7D16E7633444c13e6E565EA57c28"
+  yearn.fi Dutch Auctions:
+    - "0x861fE45742f70054917B65bE18904662bD0dBd30"
+250:
+  Yearn Strategist Multisig:
+    - "0x72a34AbafAB09b15E7191822A679f28E067C4a16"

yearn_treasury-0.1.5/yearn_treasury/budget/__init__.py

@@ -0,0 +1,6 @@
+from yearn_treasury.budget._request import BudgetRequest
+from yearn_treasury.budget._requests import approved_requests, budget_requests, rejected_requests
+
+# TODO test
+
+__all__ = ["BudgetRequest", "budget_requests", "approved_requests", "rejected_requests"]

yearn_treasury-0.1.5/yearn_treasury/budget/_request.py

@@ -0,0 +1,44 @@
+"""
+Budget request data model for Yearn Treasury.
+
+This module defines the BudgetRequest dataclass, which models a single
+budget request and its state. It provides methods for checking approval,
+rejection, streaming, vesting, and payment status.
+"""
+
+from dataclasses import dataclass
+from logging import getLogger
+from typing import Final, Optional, Set, final
+
+
+logger: Final = getLogger(__name__)
+
+
+@final
+@dataclass(frozen=True)
+class BudgetRequest:
+    id: int
+    number: int
+    title: str
+    state: str
+    url: str
+    created_at: str
+    updated_at: str
+    closed_at: Optional[str]
+    body: Optional[str]
+    labels: Set[str]
+
+    def is_approved(self) -> bool:
+        return "approved" in self.labels
+
+    def is_rejected(self) -> bool:
+        return "rejected" in self.labels
+
+    def is_stream(self) -> bool:
+        return "stream" in self.labels
+
+    def is_vesting(self) -> bool:
+        return "vesting" in self.labels
+
+    def is_paid(self) -> bool:
+        return "paid" in self.labels