hotstuff-python-sdk 0.0.1b1__py3-none-any.whl

hotstuff/utils/__init__.py

@@ -0,0 +1,13 @@
+"""Utilities package."""
+from hotstuff.utils.endpoints import ENDPOINTS_URLS
+from hotstuff.utils.nonce import NonceManager
+from hotstuff.utils.signing import sign_action
+from hotstuff.methods.exchange.op_codes import EXCHANGE_OP_CODES
+
+__all__ = [
+    "ENDPOINTS_URLS",
+    "NonceManager",
+    "sign_action",
+    "EXCHANGE_OP_CODES",
+]
+

hotstuff/utils/address.py

@@ -0,0 +1,37 @@
+"""Ethereum address validation utilities."""
+from typing import Annotated
+from pydantic import Field, field_validator
+from eth_utils import is_address, to_checksum_address
+
+
+def validate_ethereum_address(value: str) -> str:
+    """
+    Validate and normalize an Ethereum address.
+    
+    Args:
+        value: The address string to validate
+        
+    Returns:
+        Checksummed address string
+        
+    Raises:
+        ValueError: If the address is invalid
+    """
+    if not isinstance(value, str):
+        raise ValueError(f"Address must be a string, got {type(value)}")
+    
+    if not is_address(value):
+        raise ValueError(f"Invalid Ethereum address: {value}")
+    
+    return to_checksum_address(value)
+
+
+EthereumAddress = Annotated[
+    str,
+    Field(
+        ...,
+        description="Ethereum address (validated and checksummed)",
+        examples=["0x1234567890123456789012345678901234567890"],
+    ),
+    field_validator('*', mode='before')(validate_ethereum_address),
+]

hotstuff/utils/endpoints.py

@@ -0,0 +1,15 @@
+"""Endpoint URLs configuration."""
+
+ENDPOINTS_URLS = {
+    "mainnet": {
+        "api": "https://testnet-api.hotstuff.trade/",
+        "rpc": "https://rpc.hotstuff.trade/",
+        "ws": "wss://testnet-api.hotstuff.trade/ws/",
+    },
+    "testnet": {
+        "api": "https://testnet-api.hotstuff.trade/",
+        "rpc": "https://testnet-api.hotstuff.trade/",
+        "ws": "wss://testnet-api.hotstuff.trade/ws/",
+    },
+}
+

hotstuff/utils/nonce.py

@@ -0,0 +1,25 @@
+"""Nonce management utility."""
+import time
+
+
+class NonceManager:
+    """Manages nonces for transactions."""
+    
+    def __init__(self):
+        """Initialize the nonce manager."""
+        self._last_nonce = 0
+    
+    async def get_nonce(self) -> int:
+        """
+        Get a new nonce.
+        
+        Returns:
+            int: A new nonce value
+        """
+        current_time = int(time.time() * 1000)
+        if current_time <= self._last_nonce:
+            self._last_nonce += 1
+        else:
+            self._last_nonce = current_time
+        return self._last_nonce
+

hotstuff/utils/signing.py

@@ -0,0 +1,76 @@
+"""Signing utilities for EIP-712 typed data."""
+import msgpack
+from eth_account import Account
+from eth_account.messages import encode_structured_data
+from eth_utils import keccak
+from hotstuff.methods.exchange.op_codes import EXCHANGE_OP_CODES
+
+
+async def sign_action(
+    wallet: Account,
+    action: dict,
+    tx_type: int,
+    is_testnet: bool = False
+) -> str:
+    """
+    Sign an action using EIP-712.
+    
+    Args:
+        wallet: The account to sign with
+        action: The action data
+        tx_type: The transaction type code
+        is_testnet: Whether this is for testnet
+        
+    Returns:
+        str: The signature
+    """
+    # Encode action to msgpack
+    action_bytes = msgpack.packb(action)
+    
+    # Hash the payload
+    payload_hash = keccak(action_bytes)
+    
+    # EIP-712 domain
+    domain = {
+        "name": "HotstuffCore",
+        "version": "1",
+        "chainId": 1,
+        "verifyingContract": "0x1234567890123456789012345678901234567890",
+    }
+    
+    # EIP-712 types
+    types = {
+        "EIP712Domain": [
+            {"name": "name", "type": "string"},
+            {"name": "version", "type": "string"},
+            {"name": "chainId", "type": "uint256"},
+            {"name": "verifyingContract", "type": "address"},
+        ],
+        "Action": [
+            {"name": "source", "type": "string"},
+            {"name": "hash", "type": "bytes32"},
+            {"name": "txType", "type": "uint16"},
+        ],
+    }
+    
+    # Message
+    message = {
+        "source": "Testnet" if is_testnet else "Mainnet",
+        "hash": payload_hash,
+        "txType": tx_type,
+    }
+    
+    # Create structured data
+    structured_data = {
+        "types": types,
+        "primaryType": "Action",
+        "domain": domain,
+        "message": message,
+    }
+    
+    # Encode and sign
+    encoded_data = encode_structured_data(structured_data)
+    signed_message = wallet.sign_message(encoded_data)
+    
+    return signed_message.signature.hex()
+

hotstuff_python_sdk-0.0.1b1.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hotstuff Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.