strideutils 0.2.8__tar.gz → 0.2.10__tar.gz

{strideutils-0.2.8 → strideutils-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: strideutils
-Version: 0.2.8
+Version: 0.2.10
 Summary: 
 Author: Your Name
 Author-email: you@example.com

{strideutils-0.2.8 → strideutils-0.2.10}/pyproject.toml

@@ -1,9 +1,10 @@
 [tool.poetry]
 name = "strideutils"
-version = "0.2.8"
+version = "0.2.10"
 description = ""
 authors = ["Your Name <you@example.com>"]
 readme = "README.md"
+include = ["strideutils", "strideutils-stubs"]
 
 [tool.poetry.dependencies]
 python = ">=3.9"
@@ -24,9 +25,18 @@ pyyaml = ">=6.0.1"
 python-dateutil = ">=2.8.2"
 pycryptodome = ">=3.20.0"
 
-
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.1.1"
+mypy = "^1.10.0"
+flake8 = "^7.0.0"
+black = "^24.4.1"
+types-pyyaml = "^6.0.12.20240311"
+twilio-stubs = "^0.2.0"
+pandas-stubs = "^2.2.1.240316"
+types-tabulate = "^0.9.0.20240106"
+types-openpyxl = "^3.1.0.20240408"
+types-python-dateutil = "^2.9.0.20240316"
+types-requests = "^2.31.0.20240406"
 
 [build-system]
 requires = ["poetry-core"]

{strideutils-0.2.8 → strideutils-0.2.10}/strideutils/stride_requests.py

@@ -22,6 +22,8 @@ ACCOUNT_DELEGATIONS_QUERY = "cosmos/staking/v1beta1/delegations/{delegator_addre
 ACCOUNT_UNBONDINGS_QUERY = "cosmos/staking/v1beta1/delegators/{delegator_address}/unbonding_delegations"
 MODULE_ACCOUNTS_QUERY = "cosmos/auth/v1beta1/module_accounts"
 SUPPLY_QUERY = "cosmos/bank/v1beta1/supply/by_denom"
+VALIDATORS_QUERY = "cosmos/staking/v1beta1/validators"
+VALIDATOR_SLASHES_QUERY = "cosmos/distribution/v1beta1/validators/{validator_address}/slashes"
 
 CONNECTION_QUERY = "ibc/core/connection/v1/connections/{connection_id}"
 CHANNELS_QUERY = "ibc/core/channel/v1/connections/{connection_id}/channels"
@@ -101,6 +103,7 @@ def query_list_with_pagination(
     rel_key: str,
     block_height: int = 0,
     max_pages: int = 50,
+    params: Union[dict, List[Tuple[str, str]]] = {},
 ) -> List[Dict]:
     """
     Query a list with pagination
@@ -111,7 +114,7 @@ def query_list_with_pagination(
     query_count = 0
 
     while True:
-        res = request(url=query_url, block_height=block_height)
+        res = request(url=query_url, block_height=block_height, params=params)
         data += res[rel_key]
 
         query_count += 1
@@ -393,16 +396,25 @@ def get_rate_limits(**kwargs):
     return host_zone
 
 
-def get_validators(
-    api_endpoint: str = config.stride.api_endpoint,
-) -> List[Dict[str, Any]]:
+def get_validators(api_endpoint: str = config.stride.api_endpoint) -> List[Dict[str, Any]]:
     """
     Queries the list of validators from a chain
     """
-    url = f"{api_endpoint}/cosmos/staking/v1beta1/validators"
+    url = f"{api_endpoint}/{VALIDATORS_QUERY}"
     return query_list_with_pagination(url, rel_key="validators")
 
 
+def get_validator_slashes(api_endpoint: str, validator_address: str) -> List[Dict[str, str]]:
+    """
+    Queries the list of all slashes for a particular validator
+    The start and end heights are required with the query
+    An arbitrarily large end height to get all slashes
+    """
+    url = f"{api_endpoint}/{VALIDATOR_SLASHES_QUERY.format(validator_address=validator_address)}"
+    params = {"starting_height": "0", "ending_height": "10000000000000000"}
+    return query_list_with_pagination(url, rel_key="slashes", params=params)
+
+
 def get_redemption_rate(token: str) -> float:
     """
     Queries the redemption rate for a particular token

strideutils-0.2.10/strideutils-stubs/coingecko.pyi

@@ -0,0 +1,7 @@
+from strideutils import stride_requests as stride_requests
+from strideutils.stride_config import config as config
+
+COINGECKO_ENDPOINT: str
+COINGECKO_PRICE_QUERY: str
+
+def get_token_price(ticker: str, api_token: str = ..., cache_response: bool = False): ...

strideutils-0.2.10/strideutils-stubs/cryptography.pyi

@@ -0,0 +1,2 @@
+def encrypt_message(message: str, key: bytes) -> tuple[str, str]: ...
+def decrypt_message(encrypted: str, iv: str, key: bytes) -> str: ...

strideutils-0.2.10/strideutils-stubs/exec_tx.pyi

@@ -0,0 +1,15 @@
+from dataclasses import dataclass
+from strideutils import stride_requests as stride_requests
+from strideutils.stride_config import config as config
+
+@dataclass
+class TxResponse:
+    stdout: str
+    stderr: str
+    tx_response: dict | None = ...
+    tx_hash: str | None = ...
+    success: bool = ...
+    raw_log: str | None = ...
+    def __init__(self, stdout, stderr, tx_response=..., tx_hash=..., success=..., raw_log=...) -> None: ...
+
+def execute_tx(command: str, api_endpoint: str = ...) -> TxResponse: ...

strideutils-0.2.10/strideutils-stubs/invariant_helpers.pyi

@@ -0,0 +1,5 @@
+import pandas as pd
+from strideutils import stride_requests as stride_requests
+from strideutils.stride_config import config as config
+
+def check_slack_on_mainnet(str_output: bool = True, verbose: bool = False) -> pd.DataFrame | str: ...

strideutils-0.2.10/strideutils-stubs/run_safely.pyi

@@ -0,0 +1,5 @@
+from strideutils import slack_connector as slack_connector
+from strideutils.stride_config import config as config
+from typing import Callable
+
+def try_and_log_with_status(*functions: Callable, slack_channel: str = 'alerts-status', job_name: str = 'alerts', botname: str | None = None): ...

strideutils-0.2.10/strideutils-stubs/sheets_connector.pyi

@@ -0,0 +1,13 @@
+import gspread
+import pandas as pd
+from _typeshed import Incomplete
+from strideutils.stride_config import config as config
+from typing import Any
+
+SCOPES: Incomplete
+
+def get_auth(scopes: tuple[str, ...] = ..., service: str = 'sheets', version: str = 'v4'): ...
+def grab_sheet(sheet_id: str, sheet_name: str, columns_labeled: bool = True, worksheet: gspread.Worksheet | None = None, scopes: tuple[str, ...] = ..., _cache: dict[str, Any] = {}) -> pd.DataFrame: ...
+def write_sheet(df: pd.DataFrame, sheet_id: str, sheet_name: str, worksheet: gspread.Worksheet | None = None, scopes: tuple[str, ...] = ...): ...
+def reorder_sheet(sheet_id: str, sheet_name: str, new_location: int = 0, scopes: tuple[str, ...] = ...): ...
+def get_sheet_names(sheet_id: str, scopes: tuple[str, ...] = ...) -> list[str]: ...

strideutils-0.2.10/strideutils-stubs/slack_connector.pyi

@@ -0,0 +1,3 @@
+from strideutils.stride_config import config as config
+
+def post_msg(txt: str | list[str], channel: str, token: str = ..., botname: str | None = None, unfurl_links: bool = False, unfurl_media: bool = False, thread_ts: str | None = None): ...

strideutils-0.2.10/strideutils-stubs/stride_alerts.pyi

@@ -0,0 +1,19 @@
+import pandas as pd
+from enum import Enum
+from strideutils import slack_connector as slack_connector, twilio_connector as twilio_connector
+from strideutils.stride_config import config as config
+from typing import Callable, Iterable
+
+class AlertType(Enum):
+    DEBUG: str
+    INFO: str
+    WARNING: str
+    CRITICAL: str
+
+def get_tags(individuals: str | Iterable[str]) -> str: ...
+def df_to_message_body(df: pd.DataFrame) -> str: ...
+def wrap_in_code_block(message: str) -> str: ...
+def notify(msgs: str | list[str], urgency, tag: str | Iterable[str] | None = None, call: str | Iterable[str] | None = None, beta_alert: bool = False, debug_readme_section: str = '') -> None: ...
+def raise_alert(urgency: AlertType | str, tag: str | Iterable[str] | None = None, call: str | Iterable[str] | None = None, beta_alert: bool = False, debug_readme_section: str = '') -> Callable: ...
+def run_daily(utc_hour_or_alert: int | Callable) -> Callable: ...
+def run_epochly(f: Callable) -> Callable: ...

strideutils-0.2.10/strideutils-stubs/stride_config.pyi

@@ -0,0 +1,109 @@
+import yaml
+from _typeshed import Incomplete
+from collections.abc import Generator
+from dataclasses import dataclass
+
+MISSING_CONFIG_MSG: str
+ENV: Incomplete
+
+class ConfigObj:
+    def __getattr__(self, name) -> None: ...
+    def __getattribute__(self, name): ...
+    def __iter__(self): ...
+
+class ConfigDict(dict):
+    def __getitem__(self, key): ...
+
+class Loader(yaml.FullLoader):
+    def construct_yaml_map(self, node) -> Generator[Incomplete, None, None]: ...
+
+@dataclass(repr=False)
+class ChainConfig(ConfigObj):
+    name: str = ...
+    id: str = ...
+    coingecko_name: str = ...
+    denom: str = ...
+    denom_decimals: int = ...
+    inflation_frequency_hours: int = ...
+    ticker: str = ...
+    stride_token_hash: str = ...
+    api_endpoint: str = ...
+    rpc_endpoint: str = ...
+    library_api: str = ...
+    library_rpc: str = ...
+    def __init__(self, name=..., id=..., coingecko_name=..., denom=..., denom_decimals=..., inflation_frequency_hours=..., ticker=..., stride_token_hash=..., api_endpoint=..., rpc_endpoint=..., library_api=..., library_rpc=...) -> None: ...
+
+@dataclass(repr=False)
+class HostZoneChainConfig(ConfigObj):
+    cosmoshub: ChainConfig = ...
+    osmosis: ChainConfig = ...
+    evmos: ChainConfig = ...
+    injective: ChainConfig = ...
+    juno: ChainConfig = ...
+    stargaze: ChainConfig = ...
+    terra: ChainConfig = ...
+    umee: ChainConfig = ...
+    comdex: ChainConfig = ...
+    sommelier: ChainConfig = ...
+    dydx: ChainConfig = ...
+    saga: ChainConfig = ...
+    def __init__(self, cosmoshub=..., osmosis=..., evmos=..., injective=..., juno=..., stargaze=..., terra=..., umee=..., comdex=..., sommelier=..., dydx=..., saga=...) -> None: ...
+
+@dataclass(repr=False)
+class AppConfig(ConfigObj):
+    neutron: ChainConfig = ...
+    kava: ChainConfig = ...
+    iris: ChainConfig = ...
+    akash: ChainConfig = ...
+    sentinel: ChainConfig = ...
+    persistence: ChainConfig = ...
+    cryptoorg: ChainConfig = ...
+    kichain: ChainConfig = ...
+    bitcanna: ChainConfig = ...
+    regen: ChainConfig = ...
+    gravity: ChainConfig = ...
+    desmos: ChainConfig = ...
+    chihuahua: ChainConfig = ...
+    secret: ChainConfig = ...
+    axelar: ChainConfig = ...
+    crescent: ChainConfig = ...
+    mantle: ChainConfig = ...
+    mars: ChainConfig = ...
+    canto: ChainConfig = ...
+    agoric: ChainConfig = ...
+    celestia: ChainConfig = ...
+    dymension: ChainConfig = ...
+    def __init__(self, neutron=..., kava=..., iris=..., akash=..., sentinel=..., persistence=..., cryptoorg=..., kichain=..., bitcanna=..., regen=..., gravity=..., desmos=..., chihuahua=..., secret=..., axelar=..., crescent=..., mantle=..., mars=..., canto=..., agoric=..., celestia=..., dymension=...) -> None: ...
+
+@dataclass(repr=False)
+class Config(ConfigObj):
+    ENV: str
+    timezone: str = ...
+    TWILIO_ALERTS_NUMBER: str = ...
+    TWILIO_ACCOUNT_ID: str = ...
+    TWILIO_API_TOKEN: str = ...
+    PHONE_NUMBERS: ConfigDict = ...
+    STRIDEBOT_API_TOKEN: str = ...
+    PUBLICSHEETS_AUTH: str | ConfigDict = ...
+    COINGECKO_API_TOKEN: str = ...
+    PROTOCOL_STAKING_API_TOKEN: str = ...
+    alerts_playbook: str = ...
+    slack_channels: ConfigDict = ...
+    UPSTASH_PUBLIC_PASSWORD: str = ...
+    UPSTASH_STRIDE_FRONTEND_PASSWORD: str = ...
+    UPSTASH_STRIDE_BACKEND_PASSWORD: str = ...
+    UPSTASH_STRIDE_DYDX_PUBLIC_PASSWORD: str = ...
+    SLACK_BEARER_TOKEN: str = ...
+    SLACK_SUCCESS_CHANNEL_ID: str = ...
+    SLACK_INVARIANT_FAILURE_CHANNEL_ID: str = ...
+    SLACK_PACKET_FAILURE_CHANNEL_ID: str = ...
+    NUMIA_API_TOKEN: str = ...
+    founders: list[str] = ...
+    stride: ChainConfig = ...
+    host_zones: HostZoneChainConfig = ...
+    app_chains: AppConfig = ...
+    def __post_init__(self) -> None: ...
+    def get_chain(self, name: str | None = None, id: str | None = None, ticker: str | None = None, denom: str | None = None, stride_token_hash: str | None = None) -> ChainConfig: ...
+    def __init__(self, ENV, timezone=..., TWILIO_ALERTS_NUMBER=..., TWILIO_ACCOUNT_ID=..., TWILIO_API_TOKEN=..., PHONE_NUMBERS=..., STRIDEBOT_API_TOKEN=..., PUBLICSHEETS_AUTH=..., COINGECKO_API_TOKEN=..., PROTOCOL_STAKING_API_TOKEN=..., alerts_playbook=..., slack_channels=..., UPSTASH_PUBLIC_PASSWORD=..., UPSTASH_STRIDE_FRONTEND_PASSWORD=..., UPSTASH_STRIDE_BACKEND_PASSWORD=..., UPSTASH_STRIDE_DYDX_PUBLIC_PASSWORD=..., SLACK_BEARER_TOKEN=..., SLACK_SUCCESS_CHANNEL_ID=..., SLACK_INVARIANT_FAILURE_CHANNEL_ID=..., SLACK_PACKET_FAILURE_CHANNEL_ID=..., NUMIA_API_TOKEN=..., founders=..., stride=..., host_zones=..., app_chains=...) -> None: ...
+
+config: Config

strideutils-0.2.10/strideutils-stubs/stride_requests.pyi

@@ -0,0 +1,66 @@
+import datetime
+import pandas as pd
+from _typeshed import Incomplete
+from strideutils import stride_upstash as stride_upstash
+from strideutils.stride_config import config as config
+from typing import Any
+
+ACCOUNT_QUERY: str
+ACCOUNT_BALANCE_QUERY: str
+ACCOUNT_DELEGATIONS_QUERY: str
+ACCOUNT_UNBONDINGS_QUERY: str
+MODULE_ACCOUNTS_QUERY: str
+SUPPLY_QUERY: str
+CONNECTION_QUERY: str
+CHANNELS_QUERY: str
+CHANNEL_QUERY: str
+TXS_QUERY: str
+TX_BY_ACCOUNT_EVENT: str
+HOST_ZONE_QUERY: str
+EPOCHS_QUERY: str
+RATE_LIMIT_QUERY: str
+STAKETIA: str
+STAKEDYM: str
+MULTISIG_HOST_ZONE_QUERY: str
+MULTISIG_DELEGATION_RECORDS_QUERY: str
+MULTISIG_UNBONDING_RECORDS_QUERY: str
+MULTISIG_REDEMPTION_RECORDS_QUERY: str
+COSMWASM_CONTRACT_QUERY: str
+requests_session: Incomplete
+retries: Incomplete
+
+def request(url: str, headers: dict = {}, params: dict | list[tuple[str, str]] = {}, block_height: int = 0, cache_response: bool = False, _cache: dict[str, Any] = {}): ...
+def query_list_with_pagination(endpoint: str, rel_key: str, block_height: int = 0, max_pages: int = 50) -> list[dict]: ...
+def get_all_host_zones() -> list[dict]: ...
+def get_host_zone_json(zone_id: str, cast_types: bool = True, **kwargs) -> dict[str, Any]: ...
+def get_celestia_host_zone(cast_types: bool = True) -> dict[str, Any]: ...
+def get_dymension_host_zone(cast_types: bool = True) -> dict[str, Any]: ...
+def get_multisig_delegation_records(module: str, include_archived: bool = False) -> list[dict]: ...
+def get_multisig_unbonding_records(module: str, include_archived: bool = False) -> list[dict]: ...
+def get_multisig_redemption_records(module: str, address: str | None = None, unbonding_record_id: int | None = None) -> list[dict]: ...
+def get_rate_limits(**kwargs): ...
+def get_validators(api_endpoint: str = ...) -> list[dict[str, Any]]: ...
+def get_redemption_rate(token: str) -> float: ...
+def get_tvl_in_utokens(host_zone_id: str) -> float: ...
+def get_latest_block(rpc_endpoint: str = ...) -> int: ...
+def convert_cosmos_address(address: str, new_prefix: str) -> str: ...
+def get_balances(address: str, block_height: int = 0, api_endpoint: str = ..., cache_response: bool = False) -> dict[str, int]: ...
+def get_balance(address: str, denom: str, block_height: int = 0, api_endpoint: str = ..., cache_response: bool = False) -> int: ...
+def get_supply(denom: str, block_height: int = 0, api_endpoint: str = ..., cache_response: bool = False) -> int: ...
+def get_block_time(height: int, rpc_endpoint: str = ...) -> datetime.datetime: ...
+def get_icns_name(address: str) -> str: ...
+def get_account_info(address: str, api_endpoint: str = ...): ...
+def get_txs(event_filters: list[str], api_endpoint: str = ..., limit: Incomplete | None = None) -> dict: ...
+def get_tx_info(address: str, sequence: str | int, api_endpoint: str = ...) -> dict: ...
+def generate_vesting_account(start_time_in_local_tz: str, total_tokens: int, seconds_in_period: int = 3600, number_of_days: int = 30, output_file: str = 'vesting_account.json') -> str: ...
+def get_block_height_in_past(time_in_past: datetime.timedelta = ..., max_acceptable_error_seconds: int = ..., seconds_per_block: int = 6, prev_time: str | None = None, verbose: bool = False, rpc_endpoint: str = ...) -> int: ...
+def get_block_height_one_day_ago(verbose: bool = False) -> int: ...
+def get_sttoken_apr(token: str) -> float | None: ...
+def get_delegated_tokens_on_address(delegator_address: str, api_endpoint: str = ...) -> dict[str, int]: ...
+def get_unbonding_tokens_on_address(delegator_address: str, api_endpoint: str = ...) -> dict[str, int]: ...
+def get_host_zone_delegations(host_zone_id: str, ground_truth_included: bool = True) -> pd.DataFrame: ...
+def get_epochs() -> list[dict]: ...
+def get_day_epoch() -> int: ...
+def query_wasm_contract(contract_address: str, query_msg: dict, api_endpoint: str, block_height: int = 0) -> dict: ...
+def get_module_accounts(api_endpoint: str = ...) -> list[dict]: ...
+def get_empirical_annual_fees(ticker: str) -> float: ...

strideutils-0.2.10/strideutils-stubs/stride_upstash.pyi

@@ -0,0 +1,10 @@
+import redis
+from _typeshed import Incomplete
+from strideutils.stride_config import config as config
+
+redis_dbs: Incomplete
+
+def get_redis_db(redis_db_name: str) -> redis.Redis: ...
+def get(redis_key: str, db_name: str = 'frontend') -> str | None: ...
+def set(redis_key: str, redis_val: str, db_name: str = 'frontend'): ...
+def set_keys(dict_to_upload: dict[str, str], db_name: str = 'frontend', prefix: str = ''): ...

strideutils-0.2.10/strideutils-stubs/twilio_connector.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from strideutils.stride_config import config as config
+from typing import Iterable
+
+_: Incomplete
+CALL_TEMPLATE: str
+client: Incomplete
+
+def send_calls(msg: str, to: str | Iterable[str] | list[str]) -> None: ...