rango-basic-sdk 0.0.7__tar.gz → 0.0.8__tar.gz

{rango_basic_sdk-0.0.7 → rango_basic_sdk-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: rango-basic-sdk
-Version: 0.0.7
+Version: 0.0.8
 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

{rango_basic_sdk-0.0.7 → rango_basic_sdk-0.0.8}/pyproject.toml

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

{rango_basic_sdk-0.0.7 → rango_basic_sdk-0.0.8}/rango_basic_sdk/__init__.py

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

{rango_basic_sdk-0.0.7 → rango_basic_sdk-0.0.8}/rango_basic_sdk/client.py

@@ -515,6 +515,7 @@ class RoutingOperations:
         referrer_fee: Optional[float] = None,
         avoid_native_fee: Optional[bool] = None,
         enable_centralized_swappers: Optional[bool] = None,
+        deposit_transaction: Optional[bool] = None,
         header_x_rango_id: Optional[str] = None,
     ) -> Optional[models.BasicApiQuoteResponse]:
         """
@@ -579,6 +580,13 @@ class RoutingOperations:
                                                           false (exclude) Wire name
                                                           ``enableCentralizedSwappers``
                                                           (query).
+            deposit_transaction (Optional[bool]): The transaction execution type the
+                                                  client supports. Sending DEPOSIT
+                                                  limits routing to routes that are
+                                                  executable with a single plain
+                                                  transfer to a deposit address. Default
+                                                  is REGULAR Wire name
+                                                  ``depositTransaction`` (query).
             header_x_rango_id (Optional[str]): A unique client generated Id, better use
                                                UUID Wire name ``X-Rango-Id`` (header).
 
@@ -625,6 +633,8 @@ class RoutingOperations:
             params["avoidNativeFee"] = avoid_native_fee
         if enable_centralized_swappers is not None:
             params["enableCentralizedSwappers"] = enable_centralized_swappers
+        if deposit_transaction is not None:
+            params["depositTransaction"] = deposit_transaction
         req_headers: Dict[str, str] = {}
         if header_x_rango_id is not None:
             req_headers["X-Rango-Id"] = str(header_x_rango_id)
@@ -746,7 +756,7 @@ class TransactionOperations:
         """
         Check TX Status
 
-        Check if the user swapp has succeeded or not. When a user signs the swap
+        Check if the user swap has succeeded or not. When a user signs the swap
         transaction on his/her wallet, you should call this endpoint periodically to see
         the swap status.
 
@@ -808,6 +818,7 @@ class TransactionOperations:
         avoid_native_fee: Optional[bool] = None,
         enable_centralized_swappers: Optional[bool] = None,
         use_max_native_token_balance: Optional[bool] = None,
+        deposit_transaction: Optional[bool] = None,
         header_x_rango_id: Optional[str] = None,
     ) -> Optional[models.BasicApiSwapResponse]:
         """
@@ -896,6 +907,13 @@ class TransactionOperations:
                                                            insufficient. Wire name
                                                            ``useMaxNativeTokenBalance``
                                                            (query).
+            deposit_transaction (Optional[bool]): The transaction execution type the
+                                                  client supports. Sending DEPOSIT
+                                                  limits routing to routes that are
+                                                  executable with a single plain
+                                                  transfer to a deposit address. Default
+                                                  is REGULAR Wire name
+                                                  ``depositTransaction`` (query).
             header_x_rango_id (Optional[str]): A unique client generated Id, better use
                                                UUID Wire name ``X-Rango-Id`` (header).
 
@@ -951,6 +969,8 @@ class TransactionOperations:
             params["enableCentralizedSwappers"] = enable_centralized_swappers
         if use_max_native_token_balance is not None:
             params["useMaxNativeTokenBalance"] = use_max_native_token_balance
+        if deposit_transaction is not None:
+            params["depositTransaction"] = deposit_transaction
         req_headers: Dict[str, str] = {}
         if header_x_rango_id is not None:
             req_headers["X-Rango-Id"] = str(header_x_rango_id)
@@ -1470,6 +1490,7 @@ class AsyncRoutingOperations:
         referrer_fee: Optional[float] = None,
         avoid_native_fee: Optional[bool] = None,
         enable_centralized_swappers: Optional[bool] = None,
+        deposit_transaction: Optional[bool] = None,
         header_x_rango_id: Optional[str] = None,
     ) -> Optional[models.BasicApiQuoteResponse]:
         """
@@ -1534,6 +1555,13 @@ class AsyncRoutingOperations:
                                                           false (exclude) Wire name
                                                           ``enableCentralizedSwappers``
                                                           (query).
+            deposit_transaction (Optional[bool]): The transaction execution type the
+                                                  client supports. Sending DEPOSIT
+                                                  limits routing to routes that are
+                                                  executable with a single plain
+                                                  transfer to a deposit address. Default
+                                                  is REGULAR Wire name
+                                                  ``depositTransaction`` (query).
             header_x_rango_id (Optional[str]): A unique client generated Id, better use
                                                UUID Wire name ``X-Rango-Id`` (header).
 
@@ -1580,6 +1608,8 @@ class AsyncRoutingOperations:
             params["avoidNativeFee"] = avoid_native_fee
         if enable_centralized_swappers is not None:
             params["enableCentralizedSwappers"] = enable_centralized_swappers
+        if deposit_transaction is not None:
+            params["depositTransaction"] = deposit_transaction
         req_headers: Dict[str, str] = {}
         if header_x_rango_id is not None:
             req_headers["X-Rango-Id"] = str(header_x_rango_id)
@@ -1701,7 +1731,7 @@ class AsyncTransactionOperations:
         """
         Check TX Status
 
-        Check if the user swapp has succeeded or not. When a user signs the swap
+        Check if the user swap has succeeded or not. When a user signs the swap
         transaction on his/her wallet, you should call this endpoint periodically to see
         the swap status.
 
@@ -1763,6 +1793,7 @@ class AsyncTransactionOperations:
         avoid_native_fee: Optional[bool] = None,
         enable_centralized_swappers: Optional[bool] = None,
         use_max_native_token_balance: Optional[bool] = None,
+        deposit_transaction: Optional[bool] = None,
         header_x_rango_id: Optional[str] = None,
     ) -> Optional[models.BasicApiSwapResponse]:
         """
@@ -1851,6 +1882,13 @@ class AsyncTransactionOperations:
                                                            insufficient. Wire name
                                                            ``useMaxNativeTokenBalance``
                                                            (query).
+            deposit_transaction (Optional[bool]): The transaction execution type the
+                                                  client supports. Sending DEPOSIT
+                                                  limits routing to routes that are
+                                                  executable with a single plain
+                                                  transfer to a deposit address. Default
+                                                  is REGULAR Wire name
+                                                  ``depositTransaction`` (query).
             header_x_rango_id (Optional[str]): A unique client generated Id, better use
                                                UUID Wire name ``X-Rango-Id`` (header).
 
@@ -1906,6 +1944,8 @@ class AsyncTransactionOperations:
             params["enableCentralizedSwappers"] = enable_centralized_swappers
         if use_max_native_token_balance is not None:
             params["useMaxNativeTokenBalance"] = use_max_native_token_balance
+        if deposit_transaction is not None:
+            params["depositTransaction"] = deposit_transaction
         req_headers: Dict[str, str] = {}
         if header_x_rango_id is not None:
             req_headers["X-Rango-Id"] = str(header_x_rango_id)

rango_basic_sdk-0.0.8/rango_basic_sdk/helpers.py

@@ -0,0 +1,14 @@
+from rango_basic_sdk.models import BasicApiEvmTransaction
+
+from web3 import Web3
+from web3.types import TxParams
+
+
+def evm_transaction_to_tx_params(evm_transaction: BasicApiEvmTransaction) -> TxParams:
+    return {
+        'chainId': evm_transaction.block_chain.chain_id,
+        'data': evm_transaction.tx_data,
+        'from': evm_transaction.from_,
+        'to': evm_transaction.tx_to,
+        'value': evm_transaction.value,
+    }

{rango_basic_sdk-0.0.7 → rango_basic_sdk-0.0.8}/rango_basic_sdk/models.py

@@ -175,6 +175,8 @@ class Blockchain(_WireStrEnum):
     SEPOLIA_ARBITRUM = "SEPOLIA_ARBITRUM"
     SEPOLIA_OPTIMISM = "SEPOLIA_OPTIMISM"
     HYPERLIQUID = "HYPERLIQUID"
+    ROBINHOOD = "ROBINHOOD"
+    ARC = "ARC"
 
 
 class CheckApprovalResponseTxStatus(_WireStrEnum):
@@ -199,6 +201,7 @@ class GenericTransactionPrerequisiteType(_WireStrEnum):
     """Transaction Prerequisite type. e.g. StellarTrustLine"""
 
     EVM_APPROVE = "EVM_APPROVE"
+    TRON_APPROVE = "TRON_APPROVE"
     STELLAR_CHANGE_TRUSTLINE = "STELLAR_CHANGE_TRUSTLINE"
     XRPL_CHANGE_TRUSTLINE = "XRPL_CHANGE_TRUSTLINE"
 
@@ -219,6 +222,7 @@ class GenericTransactionType(_WireStrEnum):
     STELLAR = "STELLAR"
     XRPL = "XRPL"
     HYPERLIQUID = "HYPERLIQUID"
+    DEPOSIT = "DEPOSIT"
 
 
 class ParamMessagingProtocolsItem(_WireStrEnum):
@@ -264,6 +268,7 @@ class AbstractBlockchainMetaInfo(BaseClientModel):
     address_url: str = Field(alias="addressUrl")
     block_explorer_urls: List[str] = Field(alias="blockExplorerUrls")
     info_type: str = Field(alias="infoType")
+    token_url: Optional[str] = Field(default=None, alias="tokenUrl")
     transaction_url: str = Field(alias="transactionUrl")
 
 
@@ -444,7 +449,7 @@ class CheckApprovalResponse(BaseClientModel):
         default=None,
         alias="currentApprovedAmount",
         description="current approved amount",
-        examples=[Decimal("8.0")],
+        examples=[Decimal("8")],
     )
     is_approved: bool = Field(
         alias="isApproved",
@@ -455,7 +460,7 @@ class CheckApprovalResponse(BaseClientModel):
         default=None,
         alias="requiredApprovedAmount",
         description="required approve amount",
-        examples=[Decimal("10.0")],
+        examples=[Decimal("10")],
     )
     tx_status: Optional[CheckApprovalResponseTxStatus] = Field(
         default=None,
@@ -636,7 +641,7 @@ class StellarTransactionPreconditionsTimeBounds(BaseClientModel):
 
     max_time: int = Field(
         alias="maxTime",
-        description="Unix timestamped constraint for minimum time of transaction validity",
+        description="Unix timestamped constraint for maximum time of transaction validity",
     )
     min_time: int = Field(
         alias="minTime",
@@ -714,6 +719,10 @@ class TronTransaction(BaseClientModel):
     type_: str = Field(alias="type")
 
 
+class TrxContractWrapperParameterValue(BaseClientModel):
+    type_: str = Field(alias="type")
+
+
 class AssetBalance(BaseClientModel):
     """Balance of Asset in specified wallet"""
 
@@ -1055,20 +1064,30 @@ class TonMetaInfo(AbstractBlockchainMetaInfo):
     pass
 
 
+class TransferContract(TrxContractWrapperParameterValue):
+    amount: Optional[int] = Field(default=None, alias="amount")
+    owner_address: str = Field(alias="owner_address")
+    to_address: str = Field(alias="to_address")
+
+
 class TransferMetaInfo(AbstractBlockchainMetaInfo):
     pass
 
 
-class TrxRawData(BaseClientModel):
-    """Raw data of TrxTransaction"""
+class TriggerSmartContract(TrxContractWrapperParameterValue):
+    call_value: Optional[int] = Field(default=None, alias="call_value")
+    contract_address: str = Field(alias="contract_address")
+    data: str = Field(alias="data")
+    owner_address: str = Field(alias="owner_address")
 
-    contract: List[Any] = Field(alias="contract")
-    data: Optional[str] = Field(default=None, alias="data")
-    expiration: int = Field(alias="expiration")
-    fee_limit: Optional[int] = Field(default=None, alias="fee_limit")
-    ref_block_bytes: str = Field(alias="ref_block_bytes")
-    ref_block_hash: str = Field(alias="ref_block_hash")
-    timestamp: int = Field(alias="timestamp")
+
+class TrxContractWrapperParameter(BaseClientModel):
+    """Wrapper parameter of contract of Trx transaction's raw data"""
+
+    type_url: Optional[str] = Field(default=None, alias="type_url")
+    value: Optional[TrxContractWrapperParameterValue] = Field(
+        default=None, alias="value"
+    )
 
 
 class XRPLMetaInfo(AbstractBlockchainMetaInfo):
@@ -1084,10 +1103,10 @@ class XrplChangeTrustLinePrerequisite(GenericTransactionPrerequisite):
         description="Xrpl Asset Issuer",
         examples=["rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De"],
     )
-    value: str = Field(
+    value: Decimal = Field(
         alias="value",
         description="Minimum expected limit value of trust",
-        examples=["1000000000"],
+        examples=[Decimal("1000000000")],
     )
     wallet: str = Field(
         alias="wallet", description="User's wallet address", examples=["r....."]
@@ -1245,6 +1264,14 @@ class StellarTransactionData(BaseClientModel):
     )
 
 
+class TrxContractWrapper(BaseClientModel):
+    parameter: TrxContractWrapperParameter = Field(
+        alias="parameter",
+        description="Wrapper parameter of contract of Trx transaction's raw data",
+    )
+    type_: str = Field(alias="type")
+
+
 class WalletDetails(BaseClientModel):
     """A wallet's details"""
 
@@ -1332,14 +1359,6 @@ class BasicApiEvmTransaction(GenericTransaction):
                     validator
                     """),
     )
-    priority_gas_price: Optional[int] = Field(
-        default=None,
-        alias="priorityGasPrice",
-        description=("""
-                    The maximum price of the consumed gas to be included as a tip to the
-                    validator
-                    """),
-    )
     tx_data: Optional[str] = Field(
         default=None,
         alias="txData",
@@ -1456,54 +1475,6 @@ class BasicApiStarkNetTransaction(GenericTransaction):
     )
 
 
-class BasicApiTrxTransaction(GenericTransaction):
-    payload: Optional[Any] = Field(
-        default=None,
-        alias="__payload__",
-        description="the payload data for transaction",
-    )
-    approve_tx_id: Optional[str] = Field(
-        default=None,
-        alias="approveTxID",
-        description="the txID data for approve transaction",
-    )
-    approve_visible: Optional[bool] = Field(
-        default=None,
-        alias="approveVisible",
-        description="the visible data for approve transaction",
-    )
-    approve_payload: Optional[Any] = Field(
-        default=None,
-        alias="approve_payload",
-        description="the payload data for approve transaction",
-    )
-    approve_raw_data: Optional[TrxRawData] = Field(
-        default=None, alias="approve_raw_data", description="Raw data of TrxTransaction"
-    )
-    approve_raw_data_hex: Optional[str] = Field(
-        default=None,
-        alias="approve_raw_data_hex",
-        description="The hex data for approve transaction",
-    )
-    block_chain: BasicApiBlockchainMetaSummary = Field(
-        alias="blockChain", description="Blockchain metadata"
-    )
-    raw_data: Optional[TrxRawData] = Field(
-        default=None, alias="raw_data", description="Raw data of TrxTransaction"
-    )
-    raw_data_hex: Optional[str] = Field(
-        default=None,
-        alias="raw_data_hex",
-        description="The hex data for smart contract call",
-    )
-    tx_id: str = Field(
-        alias="txID", description="the txID data for smart contract call"
-    )
-    visible: bool = Field(
-        alias="visible", description="the visible data for smart contract call"
-    )
-
-
 class CosmosTransaction(GenericTransaction):
     block_chain: Blockchain = Field(
         alias="blockChain",
@@ -1537,6 +1508,38 @@ class CosmosTransaction(GenericTransaction):
     )
 
 
+class DepositTransaction(GenericTransaction):
+    amount: int = Field(
+        alias="amount",
+        description="The machine-readable amount to deposit",
+        examples=[1000000000000000000],
+    )
+    block_chain: Blockchain = Field(
+        alias="blockChain",
+        description="The blockchain that this deposit must be executed on",
+    )
+    deposit_address: str = Field(
+        alias="depositAddress",
+        description="The deposit address that the funds must be transferred to",
+    )
+    from_: str = Field(
+        alias="from", description="User's wallet address that must send the deposit"
+    )
+    memo: Optional[str] = Field(
+        default=None,
+        alias="memo",
+        description="The memo that must be attached to the deposit if non-null",
+    )
+    token_address: Optional[str] = Field(
+        default=None,
+        alias="tokenAddress",
+        description=("""
+                    Contract address of the asset to deposit, null means the blockchain's
+                    native asset
+                    """),
+    )
+
+
 class HyperliquidTransaction(GenericTransaction):
     action: HyperliquidTransactionActionMessage = Field(
         alias="action", description="hyperliquid action to send"
@@ -1680,6 +1683,18 @@ class TransferTransaction(GenericTransaction):
     )
 
 
+class TrxRawData(BaseClientModel):
+    """Raw data of TrxTransaction"""
+
+    contract: List[TrxContractWrapper] = Field(alias="contract")
+    data: Optional[str] = Field(default=None, alias="data")
+    expiration: int = Field(alias="expiration")
+    fee_limit: Optional[int] = Field(default=None, alias="fee_limit")
+    ref_block_bytes: str = Field(alias="ref_block_bytes")
+    ref_block_hash: str = Field(alias="ref_block_hash")
+    timestamp: int = Field(alias="timestamp")
+
+
 class WalletDetailsResponse(BaseClientModel):
     """A list of wallets details"""
 
@@ -1732,6 +1747,54 @@ class BasicApiQuoteResponse(BaseClientModel):
     )
 
 
+class BasicApiTrxTransaction(GenericTransaction):
+    payload: Optional[Any] = Field(
+        default=None,
+        alias="__payload__",
+        description="the payload data for transaction",
+    )
+    approve_tx_id: Optional[str] = Field(
+        default=None,
+        alias="approveTxID",
+        description="the txID data for approve transaction",
+    )
+    approve_visible: Optional[bool] = Field(
+        default=None,
+        alias="approveVisible",
+        description="the visible data for approve transaction",
+    )
+    approve_payload: Optional[Any] = Field(
+        default=None,
+        alias="approve_payload",
+        description="the payload data for approve transaction",
+    )
+    approve_raw_data: Optional[TrxRawData] = Field(
+        default=None, alias="approve_raw_data", description="Raw data of TrxTransaction"
+    )
+    approve_raw_data_hex: Optional[str] = Field(
+        default=None,
+        alias="approve_raw_data_hex",
+        description="The hex data for approve transaction",
+    )
+    block_chain: BasicApiBlockchainMetaSummary = Field(
+        alias="blockChain", description="Blockchain metadata"
+    )
+    raw_data: Optional[TrxRawData] = Field(
+        default=None, alias="raw_data", description="Raw data of TrxTransaction"
+    )
+    raw_data_hex: Optional[str] = Field(
+        default=None,
+        alias="raw_data_hex",
+        description="The hex data for smart contract call",
+    )
+    tx_id: str = Field(
+        alias="txID", description="the txID data for smart contract call"
+    )
+    visible: bool = Field(
+        alias="visible", description="the visible data for smart contract call"
+    )
+
+
 class BasicApiSwapResponse(BaseClientModel):
     """Swap response"""
 
@@ -1749,6 +1812,7 @@ class BasicApiSwapResponse(BaseClientModel):
             BasicApiStarkNetTransaction,
             BasicApiTrxTransaction,
             CosmosTransaction,
+            DepositTransaction,
             HyperliquidTransaction,
             SolanaTransaction,
             StellarTransaction,

{rango_basic_sdk-0.0.7 → rango_basic_sdk-0.0.8}/ttt.py

@@ -7,20 +7,21 @@ from rango_basic_sdk.models import Blockchain, XrplChangeTrustLinePrerequisite
 if __name__ == '__main__':
     async def _main():
         _rango = RangoClient(
-            base_url='http://localhost:8080',
-            api_key='4a624ab5-16ff-4f96-90b7-ab00ddfc342c',
-            log_http_debug=True,
+            # base_url='http://localhost:8080',
+            api_key='c6381a79-2817-4602-83bf-6a641a409e32',
+            # log_http_debug=True,
         )
 
-        from_ = 'XRPL.XRP'
-        to_ = 'XRPL.RLUSD--RLUSD-rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De'
-        amount_mr = 1500000
+        from_ = 'LTC.LTC'
+        to_ = 'ETH.ETH'
+        amount_mr = 100000000
 
         quote = await _rango.routing.quote(
             from_=from_,
             to=to_,
             amount=amount_mr,
             slippage=3.0,
+            enable_centralized_swappers=True
         )
         print('quote')
         print(quote)
@@ -32,8 +33,9 @@ if __name__ == '__main__':
             to=to_,
             amount=amount_mr,
             slippage=3.0,
-            from_address='rPWrVmZQ3kBhxiBMdk9zqnkpF2MUhobi8x',
-            to_address='rPWrVmZQ3kBhxiBMdk9zqnkpF2MUhobi8x',
+            enable_centralized_swappers=True,
+            from_address='MQd1fJwqBJvwLuyhr17PhEFx1swiqDbPQS',
+            to_address='0x84e37f0A37f4c1dEd6A13fbC4f16537F2479Bf67',
             disable_estimate=True,
             # swappers=['NearIntent'],
             # swappers_exclude=True,
@@ -45,7 +47,9 @@ if __name__ == '__main__':
         print(swap.tx)
         print('type of swap.tx')
         print(type(swap.tx))
+        print(swap.tx.psbt)
 
+        return
 
     import asyncio