token-network 0.4.4__tar.gz → 0.4.6__tar.gz

{token_network-0.4.4 → token_network-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-network
-Version: 0.4.4
+Version: 0.4.6
 Summary: Validate input and return token network config (e.g. network.bitcoin, network.bsc.usdt)
 License: MIT
 Keywords: blockchain,tokens,networks,crypto,config
@@ -49,10 +49,36 @@ bitcoin = network("bitcoin")
 
 bitcoin.decimal               # 8  (base token decimals)
 bitcoin.confirmation_number    # 2  (required confirmations)
+bitcoin.wallet_address_regex   # wallet validation regex for this network
+bitcoin.approximate_confirmation_time # 1200  (approx. seconds to confirm)
 bitcoin.config                # NetworkConfigDto (Pydantic)
 bitcoin.__dict__()            # Full data: {"config": {...}, "tokens": [...]}
 ```
 
+### Wallet address validation
+
+Each network includes a `wallet_address_regex` pattern in its config. Use it to validate addresses for that chain:
+
+```python
+from token_network import network, get_network, validate_wallet_address
+
+# Direct property (same style as .decimal / .confirmation_number)
+network("ethereum").wallet_address_regex
+# ^(0x)[0-9A-Fa-f]{40}$
+
+# Via config
+network("ethereum").config.wallet_address_regex
+get_network("bitcoin").config.wallet_address_regex
+
+# In full network dict
+network("ethereum").to_dict()["config"]["wallet_address_regex"]
+
+# Validate an address
+validate_wallet_address("ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7")  # True
+validate_wallet_address("ethereum", "0x123")  # False
+```
+
+
 ### List tokens on a network
 
 ```python
@@ -151,7 +177,9 @@ except TokenNetworkError as e:
 | What you want | How |
 |---------------|-----|
 | Network by name | `network("bitcoin")` or `network.bitcoin` |
-| Base decimals / confirmations | `network("bitcoin").decimal`, `.confirmation_number` |
+| Base decimals / confirmations | `network("bitcoin").decimal`, `.confirmation_number`, `.approximate_confirmation_time` |
+| Wallet address regex | `network("ethereum").wallet_address_regex` or `.config.wallet_address_regex` |
+| Validate wallet address | `validate_wallet_address("ethereum", "0x...")` → `True` / `False` |
 | Full network data as dict | `network("bitcoin").__dict__()` or `.to_dict()` |
 | Tokens on a network | `network("ethereum").tokens` → list of `TokenOnNetworkDto` |
 | One token on a network | `get_token_on_network(network="ethereum", token_abbr="USDT")` or `network.ethereum.usdt` |
@@ -164,7 +192,7 @@ All identifiers are **case-insensitive**. Unknown network/token raises `TokenNet
 ## Pydantic models
 
 - **`TokenDto`** — Token definition (slug, symbol, name, precision, factor). From `get_token()`.
-- **`NetworkConfigDto`** — Chain config (slug, name, network_type, base_token_decimal, confirmation_number, …). From `network("x").config` and inside `TokenOnNetworkDto.network`.
+- **`NetworkConfigDto`** — Chain config (slug, name, network_type, base_token_decimal, confirmation_number, wallet_address_regex, …). From `network("x").config` and inside `TokenOnNetworkDto.network`.
 - **`TokenOnNetworkDto`** — Token on a network (network, token, contract_address, decimal, native, type). From `get_token_on_network()`, `get_token_network()`, `network.ethereum.usdt`.
 - **`NetworkDataDto`** — Result of `get_network()`: `config` + `tokens` (list of `TokenOnNetworkDto`).
 
@@ -174,7 +202,7 @@ Use `.model_dump()` to export any model as a dict.
 
 YAML under `token_network/data/`:
 
-- `networks.yaml` — chain config
+- `networks.yaml` — chain config (including `wallet_address_regex` per network)
 - `tokens.yaml` — token definitions
 - `token_networks.yaml` — mainnet bindings (token + network → contract, decimals)
 - `token_networks_testnet.yaml` — testnet bindings (used with `NetworkAccessor(testnet=True)`)

{token_network-0.4.4 → token_network-0.4.6}/README.md

@@ -26,10 +26,36 @@ bitcoin = network("bitcoin")
 
 bitcoin.decimal               # 8  (base token decimals)
 bitcoin.confirmation_number    # 2  (required confirmations)
+bitcoin.wallet_address_regex   # wallet validation regex for this network
+bitcoin.approximate_confirmation_time # 1200  (approx. seconds to confirm)
 bitcoin.config                # NetworkConfigDto (Pydantic)
 bitcoin.__dict__()            # Full data: {"config": {...}, "tokens": [...]}
 ```
 
+### Wallet address validation
+
+Each network includes a `wallet_address_regex` pattern in its config. Use it to validate addresses for that chain:
+
+```python
+from token_network import network, get_network, validate_wallet_address
+
+# Direct property (same style as .decimal / .confirmation_number)
+network("ethereum").wallet_address_regex
+# ^(0x)[0-9A-Fa-f]{40}$
+
+# Via config
+network("ethereum").config.wallet_address_regex
+get_network("bitcoin").config.wallet_address_regex
+
+# In full network dict
+network("ethereum").to_dict()["config"]["wallet_address_regex"]
+
+# Validate an address
+validate_wallet_address("ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7")  # True
+validate_wallet_address("ethereum", "0x123")  # False
+```
+
+
 ### List tokens on a network
 
 ```python
@@ -128,7 +154,9 @@ except TokenNetworkError as e:
 | What you want | How |
 |---------------|-----|
 | Network by name | `network("bitcoin")` or `network.bitcoin` |
-| Base decimals / confirmations | `network("bitcoin").decimal`, `.confirmation_number` |
+| Base decimals / confirmations | `network("bitcoin").decimal`, `.confirmation_number`, `.approximate_confirmation_time` |
+| Wallet address regex | `network("ethereum").wallet_address_regex` or `.config.wallet_address_regex` |
+| Validate wallet address | `validate_wallet_address("ethereum", "0x...")` → `True` / `False` |
 | Full network data as dict | `network("bitcoin").__dict__()` or `.to_dict()` |
 | Tokens on a network | `network("ethereum").tokens` → list of `TokenOnNetworkDto` |
 | One token on a network | `get_token_on_network(network="ethereum", token_abbr="USDT")` or `network.ethereum.usdt` |
@@ -141,7 +169,7 @@ All identifiers are **case-insensitive**. Unknown network/token raises `TokenNet
 ## Pydantic models
 
 - **`TokenDto`** — Token definition (slug, symbol, name, precision, factor). From `get_token()`.
-- **`NetworkConfigDto`** — Chain config (slug, name, network_type, base_token_decimal, confirmation_number, …). From `network("x").config` and inside `TokenOnNetworkDto.network`.
+- **`NetworkConfigDto`** — Chain config (slug, name, network_type, base_token_decimal, confirmation_number, wallet_address_regex, …). From `network("x").config` and inside `TokenOnNetworkDto.network`.
 - **`TokenOnNetworkDto`** — Token on a network (network, token, contract_address, decimal, native, type). From `get_token_on_network()`, `get_token_network()`, `network.ethereum.usdt`.
 - **`NetworkDataDto`** — Result of `get_network()`: `config` + `tokens` (list of `TokenOnNetworkDto`).
 
@@ -151,7 +179,7 @@ Use `.model_dump()` to export any model as a dict.
 
 YAML under `token_network/data/`:
 
-- `networks.yaml` — chain config
+- `networks.yaml` — chain config (including `wallet_address_regex` per network)
 - `tokens.yaml` — token definitions
 - `token_networks.yaml` — mainnet bindings (token + network → contract, decimals)
 - `token_networks_testnet.yaml` — testnet bindings (used with `NetworkAccessor(testnet=True)`)

{token_network-0.4.4 → token_network-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "token-network"
-version = "0.4.4"
+version = "0.4.6"
 description = "Validate input and return token network config (e.g. network.bitcoin, network.bsc.usdt)"
 readme = "README.md"
 requires-python = ">=3.8"

{token_network-0.4.4 → token_network-0.4.6}/setup.py

@@ -7,7 +7,7 @@ long_description = _readme.read_text(encoding="utf-8") if _readme.exists() else
 
 setup(
     name="token-network",
-    version="0.4.4",
+    version="0.4.6",
     description="Validate input and return token network config (e.g. network.bitcoin, network.bsc.usdt)",
     long_description=long_description or None,
     long_description_content_type="text/markdown" if long_description else None,

{token_network-0.4.4 → token_network-0.4.6}/tests/test_network.py

@@ -66,6 +66,8 @@ def test_network_callable():
     bitcoin = network("bitcoin")
     assert bitcoin.decimal == 8
     assert bitcoin.confirmation_number == 2
+    assert bitcoin.approximate_confirmation_time == 1200
+    assert bitcoin.config.approximate_confirmation_time == 1200
     assert "config" in bitcoin.__dict__()
     assert bitcoin.config == network.bitcoin.config
 
@@ -90,3 +92,41 @@ def test_get_token_on_network():
     assert isinstance(ton, TokenOnNetworkDto)
     assert ton.contract_address == "0xdAC17F958D2ee523a2206206994597C13D831ec7"
     assert ton.__dict__()["contract_address"] == ton.contract_address
+
+
+@pytest.mark.parametrize(
+    "network_id,address,expected",
+    [
+        ("ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7", True),
+        ("ethereum", "0x123", False),
+        ("bsc", "0x55d398326f99059fF775485246999027B3197955", True),
+        ("polygon", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0", True),
+        ("tron", "TExample123456789012345678901234567890", False),
+        ("tron", "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb", True),
+        ("solana", "7EqQdE8L7Q1RqJqYqYqYqYqYqYqYqYqYqYqYqYqYqYq", True),
+        ("solana", "0", False),
+        ("bitcoin", "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", True),
+        ("bitcoin", "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", True),
+        ("bitcoin", "invalid", False),
+        ("ripple", "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH", True),
+        ("ripple", "xN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH", False),
+        ("dogecoin", "D7Y55LJ4f4M4M4M4M4M4M4M4M4M4M4M4M4M", True),
+        ("dogecoin", "B7Y55LJ4f4M4M4M4M4M4M4M4M4M4M4M4M4M", False),
+    ],
+)
+def test_validate_wallet_address(network_id, address, expected):
+    from token_network import validate_wallet_address
+
+    assert validate_wallet_address(network_id, address) is expected
+
+
+def test_network_config_exposes_wallet_address_regex():
+    cfg = network.ethereum.config
+    assert cfg.wallet_address_regex == r"^(0x)[0-9A-Fa-f]{40}$"
+
+
+def test_network_details_include_wallet_address_regex():
+    eth = network("ethereum")
+    assert eth.wallet_address_regex == r"^(0x)[0-9A-Fa-f]{40}$"
+    assert eth.__dict__()["config"]["wallet_address_regex"] == r"^(0x)[0-9A-Fa-f]{40}$"
+    assert eth.to_dict()["config"]["wallet_address_regex"] == r"^(0x)[0-9A-Fa-f]{40}$"

{token_network-0.4.4 → token_network-0.4.6}/token_network/__init__.py

@@ -8,6 +8,7 @@ Usage:
     bitcoin = network("bitcoin")
     bitcoin.decimal              # 8 (base token decimals)
     bitcoin.confirmation_number  # 2
+    bitcoin.wallet_address_regex # wallet validation regex for this network
     bitcoin.__dict__()           # all network data: {"config": {...}, "tokens": [...]}
     bitcoin.config
     bitcoin.tokens               # list of TokenOnNetwork objects
@@ -80,6 +81,16 @@ def get_token_network(token_identifier: str, network_identifier: str) -> TokenOn
     return _network.get_token_network(token_identifier, network_identifier)
 
 
+def validate_wallet_address(network_identifier: str, address: str) -> bool:
+    """
+    Validate a wallet address against the network's wallet_address_regex pattern.
+
+    Example:
+        validate_wallet_address("ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7")  # True
+    """
+    return _network.validate_wallet_address(network_identifier, address)
+
+
 def get_token_on_network(*, network: str, token_abbr: str) -> TokenOnNetworkDto:
     """
     Get token-on-network object by network and token symbol/slug (e.g. USDT).
@@ -101,6 +112,7 @@ __all__ = [
     "get_network",
     "get_token_network",
     "get_token_on_network",
+    "validate_wallet_address",
     "TokenNetworkError",
     "NetworkAccessor",
     "TokenOnNetworkDto",

{token_network-0.4.4 → token_network-0.4.6}/token_network/_accessor.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import re
 from typing import Any
 
 from ._loader import load_all
@@ -62,6 +63,16 @@ class _NetworkNode:
         """Required number of confirmations for this network."""
         return self.config.confirmation_number
 
+    @property
+    def wallet_address_regex(self) -> str:
+        """Regex pattern for validating wallet addresses on this network."""
+        return self.config.wallet_address_regex
+
+    @property
+    def approximate_confirmation_time(self) -> int:
+        """Approximate time (in seconds) to reach the required confirmations."""
+        return self.config.approximate_confirmation_time
+
     @property
     def tokens(self) -> list[TokenOnNetworkDto]:
         """List of token objects on this network (Pydantic TokenOnNetwork models)."""
@@ -231,5 +242,14 @@ class NetworkAccessor:
         return self.get_token_network(token_abbr, network)
 
 
+    def validate_wallet_address(self, network_identifier: str, address: str) -> bool:
+        """Return True if address matches the network's wallet_address_regex."""
+        config = self.get_network(network_identifier).config
+        pattern = (config.wallet_address_regex or "").strip()
+        if not pattern:
+            return False
+        return re.fullmatch(pattern, (address or "").strip()) is not None
+
+
 # Singleton used as `network`
 network = NetworkAccessor()

{token_network-0.4.4 → token_network-0.4.6}/token_network/_models.py

@@ -7,6 +7,21 @@ from typing import Any
 from pydantic import BaseModel, ConfigDict, computed_field
 
 
+class _CallableFieldDict(dict):
+    """
+    A dict subclass that doubles as the pydantic field storage and is also
+    callable, so that ``model.__dict__()`` returns the fully serialized data.
+    """
+
+    _model: "BaseModel | None" = None
+
+    def __call__(self) -> dict[str, Any]:
+        model = self._model
+        if model is not None:
+            return model.model_dump()
+        return dict(self)
+
+
 class TokenDto(BaseModel):
     """Token definition (from tokens.yaml): slug, symbol, name, precision, factor."""
 
@@ -44,9 +59,11 @@ class NetworkConfigDto(BaseModel):
     base_token_decimal: int = 0
     confirmation_number: int = 0
     confirmation_check_time: int = 0
+    approximate_confirmation_time: int = 0
     resource_providing_amount: float = 0.0
     resource_providing_below_threshold: float = 0.0
     is_tag_based: bool = False
+    wallet_address_regex: str = ""
 
     def __getitem__(self, key: str) -> Any:
         """Dict-like access (e.g. config['network_type'])."""
@@ -71,6 +88,12 @@ class TokenOnNetworkDto(BaseModel):
         """Alias for decimal."""
         return self.decimal
 
+    def model_post_init(self, __context: Any) -> None:
+        """Wrap field storage so ``obj.__dict__()`` returns the full serialized dict."""
+        callable_dict = _CallableFieldDict(self.__dict__)
+        callable_dict._model = self
+        object.__setattr__(self, "__dict__", callable_dict)
+
     def to_dict(self) -> dict[str, Any]:
         """Return all token-on-network data as a dict."""
         return self.model_dump()

{token_network-0.4.4 → token_network-0.4.6}/token_network/data/networks.yaml

@@ -2,96 +2,112 @@ networks:
   ethereum:
     slug: ethereum
     name: Ethereum
+    wallet_address_regex: "^(0x)[0-9A-Fa-f]{40}$"
     network_type: EVM
     token_standard: ERC20
     base_token: ETH
     base_token_decimal: 18
     confirmation_number: 10
     confirmation_check_time: 2
+    approximate_confirmation_time: 120
     resource_providing_amount: 0.0005
     resource_providing_below_threshold: 0.0001
     is_tag_based: false
   polygon:
     slug: polygon
     name: Polygon
+    wallet_address_regex: "^(0x)[0-9A-Fa-f]{40}$"
     network_type: EVM
     token_standard: ERC20
     base_token: POL
     base_token_decimal: 18
     confirmation_number: 128
     confirmation_check_time: 1
+    approximate_confirmation_time: 120
     resource_providing_amount: 1
     resource_providing_below_threshold: 0.5
     is_tag_based: false
   bsc:
     slug: bsc
     name: BNB Smart Chain
+    wallet_address_regex: "^(0x)[0-9A-Fa-f]{40}$"
     network_type: EVM
     token_standard: ERC20  # BEP20
     base_token: BNB
     base_token_decimal: 18
     confirmation_number: 10
     confirmation_check_time: 1
+    approximate_confirmation_time: 60
     resource_providing_amount: 0.0005
     resource_providing_below_threshold: 0.0001
     is_tag_based: false
   tron:
     slug: tron
     name: Tron
+    wallet_address_regex: "^T[1-9A-HJ-NP-Za-km-z]{33}$"
     network_type: TVM
     token_standard: TRC20
     base_token: TRX
     base_token_decimal: 6
     confirmation_number: 20
     confirmation_check_time: 1
+    approximate_confirmation_time: 60
     resource_providing_amount: 10
     resource_providing_below_threshold: 7
     is_tag_based: false
   solana:
     slug: solana
     name: Solana
+    wallet_address_regex: "^[1-9A-HJ-NP-Za-km-z]{32,44}$"
     network_type: SOLANA
     token_standard: SPL
     base_token: SOL
     base_token_decimal: 9
     confirmation_number: 5
     confirmation_check_time: 1
+    approximate_confirmation_time: 30
     resource_providing_amount: 0.005
     resource_providing_below_threshold: 0.001
     is_tag_based: false
   bitcoin:
     slug: bitcoin
     name: Bitcoin
+    wallet_address_regex: "^[13][a-km-zA-HJ-NP-Z1-9]{25,34}$|^(bc1)[0-9A-Za-z]{39,59}$"
     network_type: UTXO
     token_standard: BTC
     base_token: BTC
     base_token_decimal: 8
     confirmation_number: 2
     confirmation_check_time: 2
+    approximate_confirmation_time: 1200
     resource_providing_amount: 0
     resource_providing_below_threshold: 0
     is_tag_based: false
   ripple:
     slug: ripple
     name: XRP Ledger
+    wallet_address_regex: "^r[1-9A-HJ-NP-Za-km-z]{25,34}$"
     network_type: XRPL
     token_standard: XRP
     base_token: XRP
     base_token_decimal: 6
     confirmation_number: 1
     confirmation_check_time: 1
+    approximate_confirmation_time: 30
     resource_providing_amount: 0
     resource_providing_below_threshold: 0
     is_tag_based: true
   dogecoin:
     slug: dogecoin
     name: Dogecoin
+    wallet_address_regex: "^(D|A|9)[a-km-zA-HJ-NP-Z1-9]{33,34}$"
     network_type: UTXO
     token_standard: DOGE
     base_token: DOGE
     base_token_decimal: 8
     confirmation_number: 6
     confirmation_check_time: 5
+    approximate_confirmation_time: 300
     resource_providing_amount: 0
     resource_providing_below_threshold: 0
     is_tag_based: false

{token_network-0.4.4 → token_network-0.4.6}/token_network.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-network
-Version: 0.4.4
+Version: 0.4.6
 Summary: Validate input and return token network config (e.g. network.bitcoin, network.bsc.usdt)
 License: MIT
 Keywords: blockchain,tokens,networks,crypto,config
@@ -49,10 +49,36 @@ bitcoin = network("bitcoin")
 
 bitcoin.decimal               # 8  (base token decimals)
 bitcoin.confirmation_number    # 2  (required confirmations)
+bitcoin.wallet_address_regex   # wallet validation regex for this network
+bitcoin.approximate_confirmation_time # 1200  (approx. seconds to confirm)
 bitcoin.config                # NetworkConfigDto (Pydantic)
 bitcoin.__dict__()            # Full data: {"config": {...}, "tokens": [...]}
 ```
 
+### Wallet address validation
+
+Each network includes a `wallet_address_regex` pattern in its config. Use it to validate addresses for that chain:
+
+```python
+from token_network import network, get_network, validate_wallet_address
+
+# Direct property (same style as .decimal / .confirmation_number)
+network("ethereum").wallet_address_regex
+# ^(0x)[0-9A-Fa-f]{40}$
+
+# Via config
+network("ethereum").config.wallet_address_regex
+get_network("bitcoin").config.wallet_address_regex
+
+# In full network dict
+network("ethereum").to_dict()["config"]["wallet_address_regex"]
+
+# Validate an address
+validate_wallet_address("ethereum", "0xdAC17F958D2ee523a2206206994597C13D831ec7")  # True
+validate_wallet_address("ethereum", "0x123")  # False
+```
+
+
 ### List tokens on a network
 
 ```python
@@ -151,7 +177,9 @@ except TokenNetworkError as e:
 | What you want | How |
 |---------------|-----|
 | Network by name | `network("bitcoin")` or `network.bitcoin` |
-| Base decimals / confirmations | `network("bitcoin").decimal`, `.confirmation_number` |
+| Base decimals / confirmations | `network("bitcoin").decimal`, `.confirmation_number`, `.approximate_confirmation_time` |
+| Wallet address regex | `network("ethereum").wallet_address_regex` or `.config.wallet_address_regex` |
+| Validate wallet address | `validate_wallet_address("ethereum", "0x...")` → `True` / `False` |
 | Full network data as dict | `network("bitcoin").__dict__()` or `.to_dict()` |
 | Tokens on a network | `network("ethereum").tokens` → list of `TokenOnNetworkDto` |
 | One token on a network | `get_token_on_network(network="ethereum", token_abbr="USDT")` or `network.ethereum.usdt` |
@@ -164,7 +192,7 @@ All identifiers are **case-insensitive**. Unknown network/token raises `TokenNet
 ## Pydantic models
 
 - **`TokenDto`** — Token definition (slug, symbol, name, precision, factor). From `get_token()`.
-- **`NetworkConfigDto`** — Chain config (slug, name, network_type, base_token_decimal, confirmation_number, …). From `network("x").config` and inside `TokenOnNetworkDto.network`.
+- **`NetworkConfigDto`** — Chain config (slug, name, network_type, base_token_decimal, confirmation_number, wallet_address_regex, …). From `network("x").config` and inside `TokenOnNetworkDto.network`.
 - **`TokenOnNetworkDto`** — Token on a network (network, token, contract_address, decimal, native, type). From `get_token_on_network()`, `get_token_network()`, `network.ethereum.usdt`.
 - **`NetworkDataDto`** — Result of `get_network()`: `config` + `tokens` (list of `TokenOnNetworkDto`).
 
@@ -174,7 +202,7 @@ Use `.model_dump()` to export any model as a dict.
 
 YAML under `token_network/data/`:
 
-- `networks.yaml` — chain config
+- `networks.yaml` — chain config (including `wallet_address_regex` per network)
 - `tokens.yaml` — token definitions
 - `token_networks.yaml` — mainnet bindings (token + network → contract, decimals)
 - `token_networks_testnet.yaml` — testnet bindings (used with `NetworkAccessor(testnet=True)`)