poly-web3 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

poly_web3/signature/build.py

@@ -1,113 +1,113 @@
-# -*- coding = utf-8 -*-
-# @Time: 2025/12/21 19:45
-# @Author: PinBar
-# @Site:
-# @File: build.py
-# @Software: PyCharm
-from typing import Union, Optional
-
-
-def string_to_bytes(value: str, size: Optional[int] = None) -> bytes:
-    data = value.encode("utf-8")
-    if size is None:
-        return data
-    if len(data) > size:
-        raise ValueError(f"Size overflow: given {len(data)}, max {size}")
-    return data + b"\x00" * (size - len(data))
-
-
-def keccak256(data: bytes) -> bytes:
-    try:
-        from eth_hash.auto import keccak
-
-        return keccak(data)
-    except Exception:
-        try:
-            import sha3  # pysha3
-
-            k = sha3.keccak_256()
-        except Exception:
-            from Crypto.Hash import keccak  # pycryptodome
-
-            k = keccak.new(digest_bits=256)
-        k.update(data)
-        return k.digest()
-
-
-def to_checksum_address(addr_bytes: bytes) -> str:
-    hex_addr = addr_bytes.hex()
-    hash_hex = keccak256(hex_addr.encode()).hex()
-    checksum = "".join(
-        ch.upper() if int(hash_hex[i], 16) >= 8 else ch for i, ch in enumerate(hex_addr)
-    )
-    return "0x" + checksum
-
-
-def derive_proxy_wallet(address: str, proxy_factory: str, bytecode_hash: str) -> str:
-    addr_bytes = bytes.fromhex(address[2:] if address.startswith("0x") else address)
-    factory_bytes = bytes.fromhex(
-        proxy_factory[2:] if proxy_factory.startswith("0x") else proxy_factory
-    )
-    bytecode_bytes = bytes.fromhex(
-        bytecode_hash[2:] if bytecode_hash.startswith("0x") else bytecode_hash
-    )
-    salt = keccak256(
-        addr_bytes
-    )  # equivalent to keccak256(encodePacked(["address"], [address]))
-    data = b"\xff" + factory_bytes + salt + bytecode_bytes
-    create2_hash = keccak256(data)
-    return to_checksum_address(create2_hash[12:])  # last 20 bytes
-
-
-HexLike = Union[str, bytes, int]
-
-
-def create_struct_hash(
-    from_addr: str,
-    to: str,
-    data: str,
-    tx_fee: HexLike,
-    gas_price: HexLike,
-    gas_limit: HexLike,
-    nonce: HexLike,
-    relay_hub_address: str,
-    relay_address: str,
-) -> str:
-    def to_bytes(hex_like: HexLike, size: int | None = None) -> bytes:
-        if isinstance(hex_like, int):
-            length = (
-                size if size is not None else max(1, (hex_like.bit_length() + 7) // 8)
-            )
-            return hex_like.to_bytes(length, "big")
-        if isinstance(hex_like, bytes):
-            return hex_like.rjust(size, b"\x00") if size else hex_like
-        if isinstance(hex_like, str):
-            if hex_like.startswith("0x"):
-                raw = bytes.fromhex(hex_like[2:])
-                return raw.rjust(size, b"\x00") if size else raw
-            if hex_like.isdigit():  # numeric string -> int
-                num = int(hex_like)
-                length = (
-                    size if size is not None else max(1, (num.bit_length() + 7) // 8)
-                )
-                return num.to_bytes(length, "big")
-            raw = hex_like.encode()  # fallback ascii
-            return raw.rjust(size, b"\x00") if size else raw
-        raise TypeError("Unsupported type for to_bytes")
-
-    relay_hub_prefix = to_bytes("rlx:")
-    data_to_hash = b"".join(
-        [
-            relay_hub_prefix,
-            to_bytes(from_addr),
-            to_bytes(to),
-            to_bytes(data),
-            to_bytes(tx_fee, size=32),
-            to_bytes(gas_price, size=32),
-            to_bytes(gas_limit, size=32),
-            to_bytes(nonce, size=32),
-            to_bytes(relay_hub_address),
-            to_bytes(relay_address),
-        ]
-    )
-    return "0x" + keccak256(data_to_hash).hex()
+# -*- coding = utf-8 -*-
+# @Time: 2025/12/21 19:45
+# @Author: PinBar
+# @Site:
+# @File: build.py
+# @Software: PyCharm
+from typing import Union, Optional
+
+
+def string_to_bytes(value: str, size: Optional[int] = None) -> bytes:
+    data = value.encode("utf-8")
+    if size is None:
+        return data
+    if len(data) > size:
+        raise ValueError(f"Size overflow: given {len(data)}, max {size}")
+    return data + b"\x00" * (size - len(data))
+
+
+def keccak256(data: bytes) -> bytes:
+    try:
+        from eth_hash.auto import keccak
+
+        return keccak(data)
+    except Exception:
+        try:
+            import sha3  # pysha3
+
+            k = sha3.keccak_256()
+        except Exception:
+            from Crypto.Hash import keccak  # pycryptodome
+
+            k = keccak.new(digest_bits=256)
+        k.update(data)
+        return k.digest()
+
+
+def to_checksum_address(addr_bytes: bytes) -> str:
+    hex_addr = addr_bytes.hex()
+    hash_hex = keccak256(hex_addr.encode()).hex()
+    checksum = "".join(
+        ch.upper() if int(hash_hex[i], 16) >= 8 else ch for i, ch in enumerate(hex_addr)
+    )
+    return "0x" + checksum
+
+
+def derive_proxy_wallet(address: str, proxy_factory: str, bytecode_hash: str) -> str:
+    addr_bytes = bytes.fromhex(address[2:] if address.startswith("0x") else address)
+    factory_bytes = bytes.fromhex(
+        proxy_factory[2:] if proxy_factory.startswith("0x") else proxy_factory
+    )
+    bytecode_bytes = bytes.fromhex(
+        bytecode_hash[2:] if bytecode_hash.startswith("0x") else bytecode_hash
+    )
+    salt = keccak256(
+        addr_bytes
+    )  # equivalent to keccak256(encodePacked(["address"], [address]))
+    data = b"\xff" + factory_bytes + salt + bytecode_bytes
+    create2_hash = keccak256(data)
+    return to_checksum_address(create2_hash[12:])  # last 20 bytes
+
+
+HexLike = Union[str, bytes, int]
+
+
+def create_struct_hash(
+    from_addr: str,
+    to: str,
+    data: str,
+    tx_fee: HexLike,
+    gas_price: HexLike,
+    gas_limit: HexLike,
+    nonce: HexLike,
+    relay_hub_address: str,
+    relay_address: str,
+) -> str:
+    def to_bytes(hex_like: HexLike, size: int | None = None) -> bytes:
+        if isinstance(hex_like, int):
+            length = (
+                size if size is not None else max(1, (hex_like.bit_length() + 7) // 8)
+            )
+            return hex_like.to_bytes(length, "big")
+        if isinstance(hex_like, bytes):
+            return hex_like.rjust(size, b"\x00") if size else hex_like
+        if isinstance(hex_like, str):
+            if hex_like.startswith("0x"):
+                raw = bytes.fromhex(hex_like[2:])
+                return raw.rjust(size, b"\x00") if size else raw
+            if hex_like.isdigit():  # numeric string -> int
+                num = int(hex_like)
+                length = (
+                    size if size is not None else max(1, (num.bit_length() + 7) // 8)
+                )
+                return num.to_bytes(length, "big")
+            raw = hex_like.encode()  # fallback ascii
+            return raw.rjust(size, b"\x00") if size else raw
+        raise TypeError("Unsupported type for to_bytes")
+
+    relay_hub_prefix = to_bytes("rlx:")
+    data_to_hash = b"".join(
+        [
+            relay_hub_prefix,
+            to_bytes(from_addr),
+            to_bytes(to),
+            to_bytes(data),
+            to_bytes(tx_fee, size=32),
+            to_bytes(gas_price, size=32),
+            to_bytes(gas_limit, size=32),
+            to_bytes(nonce, size=32),
+            to_bytes(relay_hub_address),
+            to_bytes(relay_address),
+        ]
+    )
+    return "0x" + keccak256(data_to_hash).hex()

poly_web3/signature/hash_message.py

@@ -1,48 +1,48 @@
-# -*- coding = utf-8 -*-
-# @Time: 2025/12/21 19:43
-# @Author: PinBar
-# @Site:
-# @File: hash_message.py
-# @Software: PyCharm
-from eth_hash.auto import keccak
-
-
-def _is_hex(s: str) -> bool:
-    return isinstance(s, str) and s.startswith("0x")
-
-
-def _hex_to_bytes(h: str) -> bytes:
-    # 假设是 0x 前缀
-    return bytes.fromhex(h[2:])
-
-
-def _size_of_message(value) -> int:
-    # 对齐 viem: hex -> (len-2)/2 向上取整, bytes -> len
-    if _is_hex(value):
-        return (len(value) - 2 + 1) // 2
-    return len(value)
-
-
-def _to_prefixed_message(message) -> bytes:
-    if isinstance(message, str):
-        msg_bytes = message.encode("utf-8")
-    elif isinstance(message, dict) and "raw" in message:
-        raw = message["raw"]
-        if isinstance(raw, str):
-            # viem 这里直接当作 hex 字符串使用
-            msg_bytes = _hex_to_bytes(raw)
-        else:
-            # raw 可以是 list[int], bytes, bytearray
-            msg_bytes = bytes(raw)
-    else:
-        raise TypeError("Unsupported SignableMessage")
-
-    prefix = f"\x19Ethereum Signed Message:\n{len(msg_bytes)}".encode("utf-8")
-    return prefix + msg_bytes
-
-
-def hash_message(message, to: str = "hex"):
-    digest = keccak(_to_prefixed_message(message))
-    if to == "bytes":
-        return digest
-    return "0x" + digest.hex()
+# -*- coding = utf-8 -*-
+# @Time: 2025/12/21 19:43
+# @Author: PinBar
+# @Site:
+# @File: hash_message.py
+# @Software: PyCharm
+from eth_hash.auto import keccak
+
+
+def _is_hex(s: str) -> bool:
+    return isinstance(s, str) and s.startswith("0x")
+
+
+def _hex_to_bytes(h: str) -> bytes:
+    # 假设是 0x 前缀
+    return bytes.fromhex(h[2:])
+
+
+def _size_of_message(value) -> int:
+    # 对齐 viem: hex -> (len-2)/2 向上取整, bytes -> len
+    if _is_hex(value):
+        return (len(value) - 2 + 1) // 2
+    return len(value)
+
+
+def _to_prefixed_message(message) -> bytes:
+    if isinstance(message, str):
+        msg_bytes = message.encode("utf-8")
+    elif isinstance(message, dict) and "raw" in message:
+        raw = message["raw"]
+        if isinstance(raw, str):
+            # viem 这里直接当作 hex 字符串使用
+            msg_bytes = _hex_to_bytes(raw)
+        else:
+            # raw 可以是 list[int], bytes, bytearray
+            msg_bytes = bytes(raw)
+    else:
+        raise TypeError("Unsupported SignableMessage")
+
+    prefix = f"\x19Ethereum Signed Message:\n{len(msg_bytes)}".encode("utf-8")
+    return prefix + msg_bytes
+
+
+def hash_message(message, to: str = "hex"):
+    digest = keccak(_to_prefixed_message(message))
+    if to == "bytes":
+        return digest
+    return "0x" + digest.hex()

poly_web3/signature/secp256k1.py

@@ -1,57 +1,57 @@
-# -*- coding = utf-8 -*-
-# @Time: 2025/12/21 19:44
-# @Author: PinBar
-# @Site:
-# @File: secp256k1.py
-# @Software: PyCharm
-from eth_keys import keys
-from eth_utils import decode_hex
-
-SECP256K1_N = int(
-    "0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141", 16
-)
-HALF_N = SECP256K1_N // 2
-
-
-def sign(hash_hex: str, priv_hex: str):
-    msg = decode_hex(hash_hex)
-    priv = keys.PrivateKey(decode_hex(priv_hex))
-    sig = priv.sign_msg_hash(msg)
-    r, s, v = sig.r, sig.s, sig.v
-
-    if s > HALF_N:
-        s = SECP256K1_N - s
-        # Ethereum recovery id flips when s is negated
-        v ^= 1
-
-    return r, s, v
-
-
-def int_to_hex(n: int, size: int = 32) -> str:
-    # size 是字节数，32 字节 -> 64 个 hex 字符
-    return "0x" + n.to_bytes(size, "big").hex()
-
-
-def hex_to_int(h: str) -> int:
-    return int(h, 16)
-
-
-def serialize_signature(r: str, s: str, v=None, yParity=None, to="hex"):
-    # 计算 yParity_
-    if yParity in (0, 1):
-        yParity_ = yParity
-    elif v is not None and (v in (27, 28) or v >= 35):
-        yParity_ = 1 if (v % 2 == 0) else 0
-    else:
-        raise ValueError("Invalid `v` or `yParity` value")
-
-    # toCompactHex: r||s (各 32 字节)
-    r_int = hex_to_int(r)
-    s_int = hex_to_int(s)
-    compact = r_int.to_bytes(32, "big").hex() + s_int.to_bytes(32, "big").hex()
-
-    signature_hex = "0x" + compact + ("1b" if yParity_ == 0 else "1c")
-
-    if to == "hex":
-        return signature_hex
-    return bytes.fromhex(signature_hex[2:])
+# -*- coding = utf-8 -*-
+# @Time: 2025/12/21 19:44
+# @Author: PinBar
+# @Site:
+# @File: secp256k1.py
+# @Software: PyCharm
+from eth_keys import keys
+from eth_utils import decode_hex
+
+SECP256K1_N = int(
+    "0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141", 16
+)
+HALF_N = SECP256K1_N // 2
+
+
+def sign(hash_hex: str, priv_hex: str):
+    msg = decode_hex(hash_hex)
+    priv = keys.PrivateKey(decode_hex(priv_hex))
+    sig = priv.sign_msg_hash(msg)
+    r, s, v = sig.r, sig.s, sig.v
+
+    if s > HALF_N:
+        s = SECP256K1_N - s
+        # Ethereum recovery id flips when s is negated
+        v ^= 1
+
+    return r, s, v
+
+
+def int_to_hex(n: int, size: int = 32) -> str:
+    # size 是字节数，32 字节 -> 64 个 hex 字符
+    return "0x" + n.to_bytes(size, "big").hex()
+
+
+def hex_to_int(h: str) -> int:
+    return int(h, 16)
+
+
+def serialize_signature(r: str, s: str, v=None, yParity=None, to="hex"):
+    # 计算 yParity_
+    if yParity in (0, 1):
+        yParity_ = yParity
+    elif v is not None and (v in (27, 28) or v >= 35):
+        yParity_ = 1 if (v % 2 == 0) else 0
+    else:
+        raise ValueError("Invalid `v` or `yParity` value")
+
+    # toCompactHex: r||s (各 32 字节)
+    r_int = hex_to_int(r)
+    s_int = hex_to_int(s)
+    compact = r_int.to_bytes(32, "big").hex() + s_int.to_bytes(32, "big").hex()
+
+    signature_hex = "0x" + compact + ("1b" if yParity_ == 0 else "1c")
+
+    if to == "hex":
+        return signature_hex
+    return bytes.fromhex(signature_hex[2:])

poly_web3/web3_service/__init__.py

@@ -1,9 +1,9 @@
-# -*- coding = utf-8 -*-
-# @Time: 2025-12-27 16:07:53
-# @Author: PinBar
-# @Site:
-# @File: __init__.py
-# @Software: PyCharm
-from poly_web3.web3_service.eoa_service import EOAWeb3Service
-from poly_web3.web3_service.proxy_service import ProxyWeb3Service
-from poly_web3.web3_service.safe_service import SafeWeb3Service
+# -*- coding = utf-8 -*-
+# @Time: 2025-12-27 16:07:53
+# @Author: PinBar
+# @Site:
+# @File: __init__.py
+# @Software: PyCharm
+from poly_web3.web3_service.eoa_service import EOAWeb3Service
+from poly_web3.web3_service.proxy_service import ProxyWeb3Service
+from poly_web3.web3_service.safe_service import SafeWeb3Service