rango-basic-sdk 0.0.2__tar.gz → 0.0.4__tar.gz

{rango_basic_sdk-0.0.2 → rango_basic_sdk-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rango-basic-sdk
-Version: 0.0.2
+Version: 0.0.4
 Summary: Python bindings for Rango Exchange Basic API
 Project-URL: Home, https://github.com/rango-exchange/rango-python-basic
 Project-URL: Contact, https://t.me/rangoexchange
@@ -64,7 +64,7 @@ python -m pip install -e .
 from rango_basic_sdk import Client
 
 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
 ```
 
 Endpoints are nested under attributes (see `client.py`):
@@ -84,7 +84,7 @@ from rango_basic_sdk import AsyncClient
 
 async def main() -> None:
     async with AsyncClient(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-        result = await client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+        result = await client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
 
 asyncio.run(main())
 ```
@@ -143,7 +143,7 @@ Get the best route to perform a cross-chain or same-chain swap
 from rango_basic_sdk import Client
 
 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
     print(result)
 ```
 
@@ -158,7 +158,7 @@ Creates a transaction to be signed by user's wallet and broadcasted to the netwo
 from rango_basic_sdk import Client
 
 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-    result = client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False, referrer_fee=0.3, referrer_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3")
+    result = client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False)
     print(result)
 ```
 
@@ -184,3 +184,25 @@ Additional samples for all endpoints live under the **[`examples/`](examples/)**
 ## Advanced Examples
 
 For more advanced walkthroughs, step-by-step guides and custom samples, check the **[Advanced Examples](examples/advanced/)** folder.
+
+## HTTP debug logging
+
+To print each HTTP request and response (method, URL, status, headers, and bodies) after the response is received, pass **`log_http_debug=True`** to `Client` or `AsyncClient`, and set the **`rango_basic_sdk.client`** logger to **DEBUG** so those messages are emitted.
+
+Bodies are truncated after 16 KiB per direction. **Do not use this in production or with real secrets:** debug output can include credentials (e.g. `Authorization`, API keys, cookies).
+
+```python
+import logging
+
+from rango_basic_sdk import Client
+
+logging.getLogger("rango_basic_sdk.client").setLevel(logging.DEBUG)
+if not logging.root.handlers:
+    logging.basicConfig(level=logging.DEBUG)
+
+with Client(log_http_debug=True) as client:
+    # …
+    pass
+```
+
+For `AsyncClient`, use the same logging setup and `AsyncClient(log_http_debug=True, ...)`.

{rango_basic_sdk-0.0.2 → rango_basic_sdk-0.0.4}/README.md

@@ -36,7 +36,7 @@ python -m pip install -e .
 from rango_basic_sdk import Client
 
 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
 ```
 
 Endpoints are nested under attributes (see `client.py`):
@@ -56,7 +56,7 @@ from rango_basic_sdk import AsyncClient
 
 async def main() -> None:
     async with AsyncClient(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-        result = await client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+        result = await client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
 
 asyncio.run(main())
 ```
@@ -115,7 +115,7 @@ Get the best route to perform a cross-chain or same-chain swap
 from rango_basic_sdk import Client
 
 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
     print(result)
 ```
 
@@ -130,7 +130,7 @@ Creates a transaction to be signed by user's wallet and broadcasted to the netwo
 from rango_basic_sdk import Client
 
 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-    result = client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False, referrer_fee=0.3, referrer_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3")
+    result = client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False)
     print(result)
 ```
 
@@ -156,3 +156,25 @@ Additional samples for all endpoints live under the **[`examples/`](examples/)**
 ## Advanced Examples
 
 For more advanced walkthroughs, step-by-step guides and custom samples, check the **[Advanced Examples](examples/advanced/)** folder.
+
+## HTTP debug logging
+
+To print each HTTP request and response (method, URL, status, headers, and bodies) after the response is received, pass **`log_http_debug=True`** to `Client` or `AsyncClient`, and set the **`rango_basic_sdk.client`** logger to **DEBUG** so those messages are emitted.
+
+Bodies are truncated after 16 KiB per direction. **Do not use this in production or with real secrets:** debug output can include credentials (e.g. `Authorization`, API keys, cookies).
+
+```python
+import logging
+
+from rango_basic_sdk import Client
+
+logging.getLogger("rango_basic_sdk.client").setLevel(logging.DEBUG)
+if not logging.root.handlers:
+    logging.basicConfig(level=logging.DEBUG)
+
+with Client(log_http_debug=True) as client:
+    # …
+    pass
+```
+
+For `AsyncClient`, use the same logging setup and `AsyncClient(log_http_debug=True, ...)`.

{rango_basic_sdk-0.0.2 → rango_basic_sdk-0.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rango-basic-sdk"
-version = "0.0.2"
+version = "0.0.4"
 description = "Python bindings for Rango Exchange Basic API"
 readme = "README.md"
 license-files = ["LICENSE"]

{rango_basic_sdk-0.0.2 → rango_basic_sdk-0.0.4}/rango_basic_sdk/__init__.py

@@ -1,6 +1,6 @@
 """Python SDK for Rango Exchange Basic API."""
 
-__version__ = "0.0.2"
+__version__ = "0.0.4"
 
 from .client import AsyncClient, Client
 from .models import *

{rango_basic_sdk-0.0.2 → rango_basic_sdk-0.0.4}/rango_basic_sdk/client.py

@@ -12,7 +12,7 @@ import logging
 from . import models
 
 # First ``servers`` URL from the OpenAPI document (``None`` if the spec defines none).
-DEFAULT_SERVER_URL: Optional[str] = "https://api.rango.exchange"
+DEFAULT_SERVER_URL: Optional[str] = "https://public-api.rango.exchange"
 
 _log = logging.getLogger(__name__)
 _MAX_HTTP_DEBUG_BODY = 16_384
@@ -589,7 +589,7 @@ class RoutingOperations:
 
         Examples:
                 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-                    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+                    result = client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
                     print(result)
         """
         url = f"/basic/quote"
@@ -713,7 +713,7 @@ class TransactionOperations:
 
         Examples:
                 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-                    result = client.transaction.report_tx(body=models.BasicApiReportTransactionRequest(request_id="688b308e-a06b-4a4e-a837-220d458b8642", event_type=models.BasicApiReportTransactionRequestEventType.USER_REJECT))
+                    result = client.transaction.report_tx(body=models.BasicApiReportTransactionRequest(event_type=models.BasicApiReportTransactionRequestEventType.USER_REJECT, request_id="688b308e-a06b-4a4e-a837-220d458b8642"))
                     print(result)
         """
         url = f"/basic/report-tx"
@@ -872,9 +872,10 @@ class TransactionOperations:
             contract_call (Optional[bool]): set this parameter to `true` if you wants to
                                             send transactions through a contract Wire
                                             name ``contractCall`` (query).
-            referrer_fee (Optional[float]): Referrer fee in percent Wire name
+            referrer_fee (Optional[float]): Referrer fee in percent, e.g. 0.3 Wire name
                                             ``referrerFee`` (query).
-            referrer_address (Optional[str]): Referrer wallet address Wire name
+            referrer_address (Optional[str]): Referrer wallet address on source asset
+                                              (from) blockchain Wire name
                                               ``referrerAddress`` (query).
             referrer_code (Optional[str]): Referrer code Wire name ``referrerCode``
                                            (query).
@@ -905,7 +906,7 @@ class TransactionOperations:
 
         Examples:
                 with Client(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-                    result = client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False, referrer_fee=0.3, referrer_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3")
+                    result = client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False)
                     print(result)
         """
         url = f"/basic/swap"
@@ -1543,7 +1544,7 @@ class AsyncRoutingOperations:
 
         Examples:
                 async with AsyncClient(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-                    result = await client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5)
+                    result = await client.routing.quote(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5)
                     print(result)
         """
         url = f"/basic/quote"
@@ -1667,7 +1668,7 @@ class AsyncTransactionOperations:
 
         Examples:
                 async with AsyncClient(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-                    result = await client.transaction.report_tx(body=models.BasicApiReportTransactionRequest(request_id="688b308e-a06b-4a4e-a837-220d458b8642", event_type=models.BasicApiReportTransactionRequestEventType.USER_REJECT))
+                    result = await client.transaction.report_tx(body=models.BasicApiReportTransactionRequest(event_type=models.BasicApiReportTransactionRequestEventType.USER_REJECT, request_id="688b308e-a06b-4a4e-a837-220d458b8642"))
                     print(result)
         """
         url = f"/basic/report-tx"
@@ -1826,9 +1827,10 @@ class AsyncTransactionOperations:
             contract_call (Optional[bool]): set this parameter to `true` if you wants to
                                             send transactions through a contract Wire
                                             name ``contractCall`` (query).
-            referrer_fee (Optional[float]): Referrer fee in percent Wire name
+            referrer_fee (Optional[float]): Referrer fee in percent, e.g. 0.3 Wire name
                                             ``referrerFee`` (query).
-            referrer_address (Optional[str]): Referrer wallet address Wire name
+            referrer_address (Optional[str]): Referrer wallet address on source asset
+                                              (from) blockchain Wire name
                                               ``referrerAddress`` (query).
             referrer_code (Optional[str]): Referrer code Wire name ``referrerCode``
                                            (query).
@@ -1859,7 +1861,7 @@ class AsyncTransactionOperations:
 
         Examples:
                 async with AsyncClient(api_key='c6381a79-2817-4602-83bf-6a641a409e32') as client:
-                    result = await client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=100000000000000000, slippage=8.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False, referrer_fee=0.3, referrer_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3")
+                    result = await client.transaction.swap(from_="BSC.BNB", to="AVAX_CCHAIN.USDT.E--0xc7198437980c041c805a1edcba50c1ce5db95118", amount=10000000000000000, slippage=3.5, from_address="0x9F8cCdaFCc39F3c7D6EBf637c9151673CBc36b88", to_address="0x6f33bb1763eebead07cf8815a62fcd7b30311fa3", disable_estimate=False, infinite_approve=False)
                     print(result)
         """
         url = f"/basic/swap"