aio-mrr 0.1.0

Асинхронная библиотека для MiningRigRentals API v2

aio-mrr

Асинхронная библиотека для MiningRigRentals API v2

📖 Описание

aio-mrr — это асинхронный Python-клиент для MiningRigRentals API v2, построенный на основе aiohttp и pydantic. Библиотека предоставляет типизированный интерфейс ко всем методам API с автоматической обработкой ошибок, retry-логикой и HMAC-SHA1 аутентификацией.

✨ Особенности

• async/await — полностью асинхронный API
• Pydantic модели — автоматическая валидация и типизация ответов
• Retry-логика — автоматические повторные попытки при ошибках сети
• HMAC-SHA1 аутентификация — безопасная работа с API
• Connection pooling — эффективное управление соединениями
• Маскирование секретов — защита API-ключей при логировании

📦 Установка

pip install aio-mrr

Для разработки:

pip install -e ".[dev]"

🚀 Быстрый старт

import asyncio
from aio_mrr import MRRClient

async def main():
    api_key = "your_api_key"
    api_secret = "your_api_secret"
    
    async with MRRClient(api_key, api_secret) as client:
        # Проверка аутентификации
        response = await client.whoami()
        if response.success:
            print(f"Logged in as: {response.data['username']}")
        
        # Получение баланса
        balance = await client.account.get_balance()
        if balance.success:
            print(f"Balance: {balance.data}")

asyncio.run(main())

📚 Документация

Полная документация доступна на GitHub Pages:

• Установка и аутентификация
• Обработка ошибок
• Модели данных
• Справочник API

💡 Примеры

Примеры использования доступны в папке examples/:

• 01_quickstart.py — базовая инициализация и простой запрос
• 02_account_balance.py — работа с аккаунтом
• 03_manage_rigs.py — управление ригами
• 04_create_rental.py — создание аренд
• 05_rig_groups.py — управление группами ригов
• 06_info_and_pricing.py — информация и цены
• 07_error_handling_demo.py — обработка ошибок
• 08_advanced_search.py — продвинутый поиск
• 09_pool_management.py — управление пулами
• 10_profile_management.py — управление профилями

🔧 Требования

• Python 3.12+
• aiohttp >= 3.13.0
• pydantic >= 2.12.0
• tenacity >= 9.1.0
• loguru >= 0.7.0

📝 API Coverage

Библиотека покрывает все 55 публичных методов MiningRigRentals API v2:

Subclient	Методы	Описание
Client	1	Проверка аутентификации
AccountClient	16	Аккаунт, баланс, пулы, профили
InfoClient	4	Серверы, алгоритмы, валюты
PricingClient	1	Курсы конвертации и цены
RigClient	15	Управление ригами
RentalClient	12	Управление арендами
RigGroupClient	7	Группы ригов

🤝 Вклад

Приветствуются pull requests! Пожалуйста, создавайте issue для обсуждения изменений перед тем как делать PR.

📄 Лицензия

MIT License

---

---

aio-mrr is MIT licensed code.
Designed & built in Novosibirsk, Russia by SibNeuroTech
Contact: @GRinvest