python-rucaptcha 6.4.0__tar.gz → 6.6.0__tar.gz

python_rucaptcha-6.6.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: python-rucaptcha
+Version: 6.6.0
+Summary: Python 3.9+ RuCaptcha library with AIO module.
+Author-email: AndreiDrang <python-captcha@pm.me>
+License-Expression: MIT
+Project-URL: Homepage, https://andreidrang.github.io/python-rucaptcha/
+Project-URL: Documentation, https://andreidrang.github.io/python-rucaptcha/
+Project-URL: Repository, https://github.com/AndreiDrang/python-rucaptcha
+Project-URL: Issues, https://github.com/AndreiDrang/python-rucaptcha/issues
+Project-URL: Changelog, https://github.com/AndreiDrang/python-rucaptcha/releases
+Keywords: captcha,rucaptcha,2captcha,deathbycaptcha,recaptcha,geetest,hcaptcha,capypuzzle,rotatecaptcha,funcaptcha,keycaptcha,python3,recaptcha,captcha,security,tencent,atb_captcha,python-library,python-rucaptcha,rucaptcha-client,yandex,turnstile,amazon,amazon_waf,vk-captcha,fox-captcha,temu-captcha,friendly-captcha,binance-captcha
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: AsyncIO
+Classifier: Operating System :: Unix
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.21.0
+Requires-Dist: aiohttp>=3.9.2
+Requires-Dist: msgspec<0.21,>=0.18
+Requires-Dist: tenacity<10,>=8
+Dynamic: license-file
+
+# python-rucaptcha
+
+[![PyPI version](https://badge.fury.io/py/python-rucaptcha.svg)](https://badge.fury.io/py/python-rucaptcha)
+[![Python versions](https://img.shields.io/pypi/pyversions/python-rucaptcha.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python-rucaptcha)
+[![Downloads](https://static.pepy.tech/badge/python-rucaptcha/month)](https://pepy.tech/project/python-rucaptcha)
+[![Documentation](https://img.shields.io/badge/docs-Sphinx-green)](https://andreidrang.github.io/python-rucaptcha/)
+
+**Python 3.9+ library to solve CAPTCHAs automatically using RuCaptcha, 2Captcha, or DeathByCaptcha services.**
+
+## What is this?
+
+This library automates CAPTCHA solving by connecting to third-party services. When your code encounters a CAPTCHA, python-rucaptcha sends it to the service, waits for a human to solve it, and returns the solution to your application.
+
+**Supports 30+ CAPTCHA types:**
+- reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile
+- Image captchas, Audio captchas
+- GeeTest, KeyCaptcha, Amazon WAF, Tencent
+- And many more...
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install python-rucaptcha
+```
+
+### 2. Get an API Key
+
+Sign up at [RuCaptcha](https://rucaptcha.com) or [2Captcha](https://2captcha.com), then copy your API key from the dashboard.
+
+### 3. Solve a CAPTCHA
+
+```python
+from python_rucaptcha import HCaptcha
+
+# Your API key
+key = "your_api_key_here"
+
+# Solve hCaptcha
+result = HCaptcha(aptcha_key=key).captcha_handler(site_url="https://example.com", site_key="abc123")
+
+if result['code'] == 0:
+    print(f"Solved! Token: {result['token']}")
+else:
+    print(f"Error: {result['message']}")
+```
+
+### Solving Different CAPTCHA Types
+
+**reCAPTCHA v2:**
+```python
+from python_rucaptcha import ReCaptcha
+
+result = ReCaptcha(api_key).captcha_handler(
+    site_url="https://example.com",
+    site_key="your_site_key"
+)
+```
+
+**Image CAPTCHA:**
+```python
+from python_rucaptcha import ImageCaptcha
+
+result = ImageCaptcha(api_key).captcha_handler(
+    image_link="https://example.com/captcha.jpg"
+)
+```
+
+**ALTCHA:**
+```python
+from python_rucaptcha import AltchaCaptcha
+from python_rucaptcha.core.enums import AltchaEnm
+
+result = AltchaCaptcha(
+    rucaptcha_key=api_key,
+    websiteURL="https://example.com",
+    challengeURL="https://example.com/altcha/challenge",
+    method=AltchaEnm.AltchaTaskProxyless,
+).captcha_handler()
+```
+
+**Using async:**
+```python
+import asyncio
+from python_rucaptcha import HCaptcha
+
+async def solve():
+    result = await HCaptcha(api_key).aio_captcha_handler(
+        site_url="https://example.com",
+        site_key="abc123"
+    )
+    return result
+
+token = asyncio.run(solve())
+```
+
+## Supported CAPTCHA Types
+
+| CAPTCHA | Module | Description |
+|---------|--------|-------------|
+| reCAPTCHA v2/v3 | `ReCaptcha` | Google reCAPTCHA |
+| hCaptcha | `HCaptcha` | hCaptcha challenge |
+| Cloudflare Turnstile | `Turnstile` | Cloudflare protection |
+| Image | `ImageCaptcha` | Type the text from image |
+| Audio | `AudioCaptcha` | Listen and type audio |
+| GeeTest | `GeeTest` | Chinese geetest puzzles |
+| KeyCaptcha | `KeyCaptcha` | KeyCAPTCHA service |
+| Amazon WAF | `AmazonWaf` | AWS WAF challenge |
+| ALTCHA | `AltchaCaptcha` | ALTCHA challenge |
+| Binance | `BinanceCaptcha` | Token-based Binance challenge |
+| Grid | `GridCaptcha` | Select grid cells |
+| Coordinates | `CoordinatesCaptcha` | Click on coordinates |
+| And 20+ more | ... | See [full docs](https://andreidrang.github.io/python-rucaptcha/) |
+
+## Switching Services
+
+Use the same code with different services:
+
+```python
+from python_rucaptcha import HCaptcha
+from python_rucaptcha.core.enums import ServiceEnm
+
+# Use 2Captcha (default)
+result = HCaptcha("2captcha_key").captcha_handler(...)
+
+# Use RuCaptcha
+result = HCaptcha("rucaptcha_key", service_type=ServiceEnm.RuCaptcha).captcha_handler(...)
+
+# Use DeathByCaptcha
+result = HCaptcha("dbc_user:dbc_pass", service_type=ServiceEnm.DeathByCaptcha).captcha_handler(...)
+```
+
+## Testing
+
+```bash
+# Set your API key
+export RUCAPTCHA_KEY="your_key_here"
+
+# Run tests
+make tests
+```
+
+## Documentation
+
+For advanced usage, configuration options, and all CAPTCHA types, see the [full documentation](https://andreidrang.github.io/python-rucaptcha/).
+
+## Support
+
+- **Telegram:** [pythoncaptcha](https://t.me/pythoncaptcha)
+- **Email:** python-captcha@pm.me
+- **Issues:** [GitHub Issues](https://github.com/AndreiDrang/python-rucaptcha/issues)
+
+## Changelog
+
+See [Releases](https://github.com/AndreiDrang/python-rucaptcha/releases) for full changelog.
+
+- **v6.0** - Refactored to use msgspec (faster), API v2, dropped Python 3.8
+- **v5.3** - Added DeathByCaptcha support
+- **v5.2** - Added audio CAPTCHA solving

python_rucaptcha-6.6.0/README.md

@@ -0,0 +1,160 @@
+# python-rucaptcha
+
+[![PyPI version](https://badge.fury.io/py/python-rucaptcha.svg)](https://badge.fury.io/py/python-rucaptcha)
+[![Python versions](https://img.shields.io/pypi/pyversions/python-rucaptcha.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python-rucaptcha)
+[![Downloads](https://static.pepy.tech/badge/python-rucaptcha/month)](https://pepy.tech/project/python-rucaptcha)
+[![Documentation](https://img.shields.io/badge/docs-Sphinx-green)](https://andreidrang.github.io/python-rucaptcha/)
+
+**Python 3.9+ library to solve CAPTCHAs automatically using RuCaptcha, 2Captcha, or DeathByCaptcha services.**
+
+## What is this?
+
+This library automates CAPTCHA solving by connecting to third-party services. When your code encounters a CAPTCHA, python-rucaptcha sends it to the service, waits for a human to solve it, and returns the solution to your application.
+
+**Supports 30+ CAPTCHA types:**
+- reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile
+- Image captchas, Audio captchas
+- GeeTest, KeyCaptcha, Amazon WAF, Tencent
+- And many more...
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install python-rucaptcha
+```
+
+### 2. Get an API Key
+
+Sign up at [RuCaptcha](https://rucaptcha.com) or [2Captcha](https://2captcha.com), then copy your API key from the dashboard.
+
+### 3. Solve a CAPTCHA
+
+```python
+from python_rucaptcha import HCaptcha
+
+# Your API key
+key = "your_api_key_here"
+
+# Solve hCaptcha
+result = HCaptcha(aptcha_key=key).captcha_handler(site_url="https://example.com", site_key="abc123")
+
+if result['code'] == 0:
+    print(f"Solved! Token: {result['token']}")
+else:
+    print(f"Error: {result['message']}")
+```
+
+### Solving Different CAPTCHA Types
+
+**reCAPTCHA v2:**
+```python
+from python_rucaptcha import ReCaptcha
+
+result = ReCaptcha(api_key).captcha_handler(
+    site_url="https://example.com",
+    site_key="your_site_key"
+)
+```
+
+**Image CAPTCHA:**
+```python
+from python_rucaptcha import ImageCaptcha
+
+result = ImageCaptcha(api_key).captcha_handler(
+    image_link="https://example.com/captcha.jpg"
+)
+```
+
+**ALTCHA:**
+```python
+from python_rucaptcha import AltchaCaptcha
+from python_rucaptcha.core.enums import AltchaEnm
+
+result = AltchaCaptcha(
+    rucaptcha_key=api_key,
+    websiteURL="https://example.com",
+    challengeURL="https://example.com/altcha/challenge",
+    method=AltchaEnm.AltchaTaskProxyless,
+).captcha_handler()
+```
+
+**Using async:**
+```python
+import asyncio
+from python_rucaptcha import HCaptcha
+
+async def solve():
+    result = await HCaptcha(api_key).aio_captcha_handler(
+        site_url="https://example.com",
+        site_key="abc123"
+    )
+    return result
+
+token = asyncio.run(solve())
+```
+
+## Supported CAPTCHA Types
+
+| CAPTCHA | Module | Description |
+|---------|--------|-------------|
+| reCAPTCHA v2/v3 | `ReCaptcha` | Google reCAPTCHA |
+| hCaptcha | `HCaptcha` | hCaptcha challenge |
+| Cloudflare Turnstile | `Turnstile` | Cloudflare protection |
+| Image | `ImageCaptcha` | Type the text from image |
+| Audio | `AudioCaptcha` | Listen and type audio |
+| GeeTest | `GeeTest` | Chinese geetest puzzles |
+| KeyCaptcha | `KeyCaptcha` | KeyCAPTCHA service |
+| Amazon WAF | `AmazonWaf` | AWS WAF challenge |
+| ALTCHA | `AltchaCaptcha` | ALTCHA challenge |
+| Binance | `BinanceCaptcha` | Token-based Binance challenge |
+| Grid | `GridCaptcha` | Select grid cells |
+| Coordinates | `CoordinatesCaptcha` | Click on coordinates |
+| And 20+ more | ... | See [full docs](https://andreidrang.github.io/python-rucaptcha/) |
+
+## Switching Services
+
+Use the same code with different services:
+
+```python
+from python_rucaptcha import HCaptcha
+from python_rucaptcha.core.enums import ServiceEnm
+
+# Use 2Captcha (default)
+result = HCaptcha("2captcha_key").captcha_handler(...)
+
+# Use RuCaptcha
+result = HCaptcha("rucaptcha_key", service_type=ServiceEnm.RuCaptcha).captcha_handler(...)
+
+# Use DeathByCaptcha
+result = HCaptcha("dbc_user:dbc_pass", service_type=ServiceEnm.DeathByCaptcha).captcha_handler(...)
+```
+
+## Testing
+
+```bash
+# Set your API key
+export RUCAPTCHA_KEY="your_key_here"
+
+# Run tests
+make tests
+```
+
+## Documentation
+
+For advanced usage, configuration options, and all CAPTCHA types, see the [full documentation](https://andreidrang.github.io/python-rucaptcha/).
+
+## Support
+
+- **Telegram:** [pythoncaptcha](https://t.me/pythoncaptcha)
+- **Email:** python-captcha@pm.me
+- **Issues:** [GitHub Issues](https://github.com/AndreiDrang/python-rucaptcha/issues)
+
+## Changelog
+
+See [Releases](https://github.com/AndreiDrang/python-rucaptcha/releases) for full changelog.
+
+- **v6.0** - Refactored to use msgspec (faster), API v2, dropped Python 3.8
+- **v5.3** - Added DeathByCaptcha support
+- **v5.2** - Added audio CAPTCHA solving

{python_rucaptcha-6.4.0 → python_rucaptcha-6.6.0}/pyproject.toml

@@ -66,7 +66,11 @@ keywords = [    "captcha",
 				"turnstile",
 				"amazon",
 				"amazon_waf",
-				"friendly-captcha"
+				"vk-captcha",
+				"fox-captcha",
+				"temu-captcha",
+				"friendly-captcha",
+				"binance-captcha"
             ]
 license = "MIT"
 classifiers = [
@@ -78,6 +82,7 @@ classifiers = [
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
         "Framework :: AsyncIO",
         "Operating System :: Unix",
         "Operating System :: Microsoft :: Windows",
@@ -86,7 +91,7 @@ classifiers = [
 dependencies = [
     "requests>=2.21.0",
     "aiohttp>=3.9.2",
-    "msgspec>=0.18,<0.20",
+    "msgspec>=0.18,<0.21",
     "tenacity>=8,<10"
 ]
 

python_rucaptcha-6.6.0/src/python_rucaptcha/__version__.py

@@ -0,0 +1 @@
+__version__ = "6.6.0"

python_rucaptcha-6.6.0/src/python_rucaptcha/altcha_captcha.py

@@ -0,0 +1,152 @@
+from typing import Union, Optional
+
+from .core.base import BaseCaptcha
+from .core.enums import AltchaEnm
+
+
+class AltchaCaptcha(BaseCaptcha):
+    def __init__(
+        self,
+        websiteURL: str,
+        method: Union[str, AltchaEnm] = AltchaEnm.AltchaTaskProxyless,
+        challengeURL: Optional[str] = None,
+        challengeJSON: Optional[str] = None,
+        proxyType: Optional[str] = None,
+        proxyAddress: Optional[str] = None,
+        proxyPort: Optional[int] = None,
+        proxyLogin: Optional[str] = None,
+        proxyPassword: Optional[str] = None,
+        *args,
+        **kwargs,
+    ):
+        """
+        The class is used to work with ALTCHA captcha.
+
+        Args:
+            rucaptcha_key: User API key
+            websiteURL: Full URL of the captcha page
+            method: Captcha type
+            challengeURL: Full URL of the page that contains ALTCHA challenge
+            challengeJSON: JSON-encoded ALTCHA challenge data
+            proxyType: Proxy type (http, https, socks4, socks5)
+            proxyAddress: Proxy IP address or hostname
+            proxyPort: Proxy port
+            proxyLogin: Proxy login
+            proxyPassword: Proxy password
+            kwargs: Not required params for task creation request
+
+        Examples:
+            >>> AltchaCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
+            ...             websiteURL="https://example.com",
+            ...             challengeURL="https://example.com/altcha/challenge.js",
+            ...             method=AltchaEnm.AltchaTaskProxyless.value,
+            ...             ).captcha_handler()
+            {
+               "errorId":0,
+               "status":"ready",
+               "solution":{
+                  "token":"..."
+               },
+               "cost":"0.00145",
+               "ip":"1.2.3.4",
+               "createTime":1692863536,
+               "endTime":1692863556,
+               "solveCount":1,
+               "taskId": 73243152973,
+            }
+
+            >>> await AltchaCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
+            ...             websiteURL="https://example.com",
+            ...             challengeJSON='{"挑战数据"}',
+            ...             method=AltchaEnm.AltchaTask.value,
+            ...             proxyType="http",
+            ...             proxyAddress="1.2.3.4",
+            ...             proxyPort=8080,
+            ...             ).aio_captcha_handler()
+            {
+               "errorId":0,
+               "status":"ready",
+               "solution":{
+                  "token":"..."
+               },
+               "cost":"0.00145",
+               "ip":"1.2.3.4",
+               "createTime":1692863536,
+               "endTime":1692863556,
+               "solveCount":1,
+               "taskId": 73243152973,
+            }
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            https://rucaptcha.com/api-docs/altcha
+        """
+
+        super().__init__(method=method, *args, **kwargs)
+
+        # XOR validation: exactly one of challengeURL or challengeJSON must be provided
+        if not (bool(challengeURL) ^ bool(challengeJSON)):
+            raise ValueError(
+                "Exactly one of 'challengeURL' or 'challengeJSON' must be provided, not both or neither"
+            )
+
+        # Validate method
+        if method not in AltchaEnm.list_values():
+            raise ValueError(f"Invalid method parameter set, available - {AltchaEnm.list_values()}")
+
+        # Build task payload
+        task_data = {"websiteURL": websiteURL}
+
+        if challengeURL:
+            task_data["challengeURL"] = challengeURL
+
+        if challengeJSON:
+            task_data["challengeJSON"] = challengeJSON
+
+        # Add proxy params only for non-proxyless methods
+        if method == AltchaEnm.AltchaTask.value:
+            if not all([proxyType, proxyAddress, proxyPort]):
+                raise ValueError(
+                    "Proxy parameters (proxyType, proxyAddress, proxyPort) are required for AltchaTask"
+                )
+            task_data.update(
+                {
+                    "proxyType": proxyType,
+                    "proxyAddress": proxyAddress,
+                    "proxyPort": proxyPort,
+                }
+            )
+            if proxyLogin and proxyPassword:
+                task_data["proxyLogin"] = proxyLogin
+                task_data["proxyPassword"] = proxyPassword
+
+        self.create_task_payload["task"].update(task_data)
+
+    def captcha_handler(self, **kwargs) -> dict:
+        """
+        Sync solving method
+
+        Args:
+            kwargs: Parameters for the `requests` library
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstirng for more info
+        """
+        return self._processing_response(**kwargs)
+
+    async def aio_captcha_handler(self) -> dict:
+        """
+        Async solving method
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstirng for more info
+        """
+        return await self._aio_processing_response()

python_rucaptcha-6.6.0/src/python_rucaptcha/binance_captcha.py

@@ -0,0 +1,155 @@
+from typing import Union, Optional
+
+from .core.base import BaseCaptcha
+from .core.enums import BinanceCaptchaEnm
+
+
+class BinanceCaptcha(BaseCaptcha):
+    def __init__(
+        self,
+        websiteURL: str,
+        websiteKey: str,
+        validateId: str,
+        method: Union[str, BinanceCaptchaEnm] = BinanceCaptchaEnm.BinanceTaskProxyless,
+        userAgent: Optional[str] = None,
+        proxyType: Optional[str] = None,
+        proxyAddress: Optional[str] = None,
+        proxyPort: Optional[int] = None,
+        proxyLogin: Optional[str] = None,
+        proxyPassword: Optional[str] = None,
+        *args,
+        **kwargs,
+    ):
+        """
+        The class is used to work with Binance CAPTCHA.
+
+        Args:
+            rucaptcha_key: User API key
+            websiteURL: Full URL of the page where the captcha is loaded
+            websiteKey: Value of bizId, bizType, or bizCode from page requests
+            validateId: Dynamic value of validateId, securityId, or securityCheckResponseValidateId
+            method: Captcha type
+            userAgent: User-Agent string to be used when solving the captcha
+            proxyType: Proxy type (http, https, socks4, socks5)
+            proxyAddress: Proxy IP address or hostname
+            proxyPort: Proxy port
+            proxyLogin: Proxy login
+            proxyPassword: Proxy password
+
+        Examples:
+            >>> BinanceCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
+            ...             websiteURL="https://example.com/page-with-binance",
+            ...             websiteKey="login",
+            ...             validateId="cb0bfefa598...e54ecd57b",
+            ...             userAgent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+            ...                        "(KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+            ...             method=BinanceCaptchaEnm.BinanceTaskProxyless.value,
+            ...             ).captcha_handler()
+            {
+               "errorId":0,
+               "status":"ready",
+               "solution":{
+                  "token":"captcha#09ba4905a79f44f...kc99maS943qIsquNP9D77",
+                  "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
+               },
+               "cost":"0.00299",
+               "ip":"1.2.3.4",
+               "createTime":1692863536,
+               "endTime":1692863556,
+               "solveCount":1,
+               "taskId": 73243152973,
+            }
+
+            >>> await BinanceCaptcha(rucaptcha_key="aa9011f31111181111168611f1151122",
+            ...             websiteURL="https://example.com/page-with-binance",
+            ...             websiteKey="login",
+            ...             validateId="cb0bfefa598...e54ecd57b",
+            ...             method=BinanceCaptchaEnm.BinanceTask.value,
+            ...             proxyType="http",
+            ...             proxyAddress="1.2.3.4",
+            ...             proxyPort=8080,
+            ...             ).aio_captcha_handler()
+            {
+               "errorId":0,
+               "status":"ready",
+               "solution":{
+                  "token":"captcha#09ba4905a79f44f...kc99maS943qIsquNP9D77",
+                  "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
+               },
+               "cost":"0.00299",
+               "ip":"1.2.3.4",
+               "createTime":1692863536,
+               "endTime":1692863556,
+               "solveCount":1,
+               "taskId": 73243152973,
+            }
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            https://2captcha.com/api-docs/binance-captcha
+
+            https://rucaptcha.com/api-docs/binance-captcha
+        """
+        super().__init__(method=method, *args, **kwargs)
+
+        # Validate method
+        if method not in BinanceCaptchaEnm.list_values():
+            raise ValueError(f"Invalid method parameter set, available - {BinanceCaptchaEnm.list_values()}")
+
+        # Build task payload
+        task_data = {
+            "websiteURL": websiteURL,
+            "websiteKey": websiteKey,
+            "validateId": validateId,
+        }
+
+        if userAgent:
+            task_data["userAgent"] = userAgent
+
+        # Add proxy params only for non-proxyless methods
+        if method == BinanceCaptchaEnm.BinanceTask.value:
+            if not all([proxyType, proxyAddress, proxyPort]):
+                raise ValueError(
+                    "Proxy parameters (proxyType, proxyAddress, proxyPort) are required for BinanceTask"
+                )
+            task_data.update(
+                {
+                    "proxyType": proxyType,
+                    "proxyAddress": proxyAddress,
+                    "proxyPort": proxyPort,
+                }
+            )
+            if proxyLogin and proxyPassword:
+                task_data["proxyLogin"] = proxyLogin
+                task_data["proxyPassword"] = proxyPassword
+
+        self.create_task_payload["task"].update(task_data)
+
+    def captcha_handler(self, **kwargs) -> dict:
+        """
+        Sync solving method
+
+        Args:
+            kwargs: Parameters for the `requests` library
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstirng for more info
+        """
+        return self._processing_response(**kwargs)
+
+    async def aio_captcha_handler(self) -> dict:
+        """
+        Async solving method
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstirng for more info
+        """
+        return await self._aio_processing_response()