near-jsonrpc-client 1.0.21__py3-none-any.whl → 1.0.23__py3-none-any.whl

near_jsonrpc_client/__init__.py

@@ -1,9 +1,9 @@
 from .client import NearClientAsync, NearClientSync
 from .transport import HttpTransportAsync, HttpTransportSync
 from .errors import (
-    ClientError,
-    TransportError,
-    HttpError,
+    RpcClientError,
+    RpcTransportError,
+    RpcHttpError,
     RpcError,
     RpcTimeoutError
 )
@@ -19,9 +19,9 @@ __all__ = [
     "HttpTransportSync",
 
     # Errors
-    "ClientError",
-    "TransportError",
-    "HttpError",
+    "RpcClientError",
+    "RpcTransportError",
+    "RpcHttpError",
     "RpcError",
     "RpcTimeoutError"
 ]

near_jsonrpc_client/base_client.py

@@ -7,11 +7,11 @@ from pydantic import BaseModel
 from typing import get_args
 
 from .errors import (
-    ClientError,
-    TransportError,
-    HttpError,
+    RpcClientError,
+    RpcTransportError,
+    RpcHttpError,
     RpcError,
-    RequestTimeoutError,
+    RpcTimeoutError,
 )
 from .transport import HttpTransportAsync, HttpTransportSync
 
@@ -19,13 +19,13 @@ from .transport import HttpTransportAsync, HttpTransportSync
 def _extract_method(request_model: Type[BaseModel]) -> str:
     field = request_model.model_fields.get("method")
     if field is None:
-        raise ClientError(
+        raise RpcClientError(
             f"{request_model.__name__} does not define a 'method' field"
         )
 
     args = get_args(field.annotation)
     if len(args) != 1 or not isinstance(args[0], str):
-        raise ClientError(
+        raise RpcClientError(
             f"Invalid JSON-RPC method definition in {request_model.__name__}"
         )
 
@@ -39,9 +39,9 @@ def _parse_response(response_model: Type[BaseModel], response_json: dict):
     except Exception as e:
 
         if response_json["result"]["error"] is not None:
-            raise ClientError(response_json["result"]["error"]) from e
+            raise RpcClientError(response_json["result"]["error"]) from e
 
-        raise ClientError("Invalid response format") from e
+        raise RpcClientError("Invalid response format") from e
 
     inner = parsed.root
     if hasattr(inner, "error") and inner.error is not None:
@@ -87,12 +87,12 @@ class NearBaseClientAsync:
                 print("⬅️ JSON-RPC Raw Response:", response.text)
 
         except httpx.TimeoutException as e:
-            raise RequestTimeoutError() from e
+            raise RpcTimeoutError() from e
         except httpx.RequestError as e:
-            raise TransportError(str(e)) from e
+            raise RpcTransportError(str(e)) from e
 
         if 500 <= response.status_code < 600:
-            raise HttpError(status_code=response.status_code, body=response.text)
+            raise RpcHttpError(status_code=response.status_code, body=response.text)
 
         return _parse_response(response_model, response.json())
 
@@ -139,12 +139,12 @@ class NearBaseClientSync:
 
         # handle sync transport exceptions (requests or httpx sync)
         except requests.Timeout as e:
-            raise RequestTimeoutError() from e
+            raise RpcTimeoutError() from e
         except requests.RequestException as e:
-            raise TransportError(str(e)) from e
+            raise RpcTransportError(str(e)) from e
 
         if 500 <= response.status_code < 600:
-            raise HttpError(status_code=response.status_code, body=response.text)
+            raise RpcHttpError(status_code=response.status_code, body=response.text)
 
         return _parse_response(response_model, response.json())
 

near_jsonrpc_client/errors.py

@@ -1,17 +1,17 @@
 from pydantic import BaseModel
 
 
-class ClientError(Exception):
+class RpcClientError(Exception):
     """Base error for all NEAR client related failures."""
     pass
 
 
-class TransportError(ClientError):
+class RpcTransportError(RpcClientError):
     """Network-level errors (timeout, DNS, connection, etc)."""
     pass
 
 
-class HttpError(ClientError):
+class RpcHttpError(RpcClientError):
     """Non-200 HTTP responses."""
 
     def __init__(self, status_code: int, body: str | None = None):
@@ -20,7 +20,7 @@ class HttpError(ClientError):
         super().__init__(f"HTTP error {status_code}")
 
 
-class RpcError(ClientError):
+class RpcError(RpcClientError):
     """JSON-RPC error object wrapping the Pydantic error model."""
 
     def __init__(self, error: BaseModel | str):
@@ -32,7 +32,7 @@ class RpcError(ClientError):
             super().__init__(error)
 
 
-class RpcTimeoutError(ClientError):
+class RpcTimeoutError(RpcClientError):
     """Timeout Error"""
 
     def __init__(self):

{near_jsonrpc_client-1.0.21.dist-info → near_jsonrpc_client-1.0.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: near-jsonrpc-client
-Version: 1.0.21
+Version: 1.0.23
 Summary: A typed Python client for the NEAR JSON-RPC API with Pydantic models and async HTTP support
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -174,24 +174,24 @@ print(response)
 The client raises structured exceptions:
 
 * `RpcError` – returned from NEAR JSON-RPC
-* `HttpError` – HTTP errors with status code and body
-* `RequestTimeoutError` – request timeout
-* `ClientError` – unexpected or invalid responses
+* `RpcHttpError` – HTTP errors with status code and body
+* `RpcTimeoutError` – request timeout
+* `RpcClientError` – unexpected or invalid responses
 
 Example:
 
 ```python
-from near_jsonrpc_client import RpcError, HttpError, RequestTimeoutError, ClientError
+from near_jsonrpc_client import RpcError, RpcHttpError, RpcTimeoutError, RpcClientError
 
 try:
     block = client.block(params=params)
 except RpcError as e:
     print(f"RPC error: {e.error}")
-except HttpError as e:
+except RpcHttpError as e:
     print(f"HTTP error: {e.status_code}, {e.body}")
-except RequestTimeoutError as e:
+except RpcTimeoutError as e:
     print("Request timed out")
-except ClientError as e:
+except RpcClientError as e:
     print("Invalid response", e)
 ```
 

{near_jsonrpc_client-1.0.21.dist-info → near_jsonrpc_client-1.0.23.dist-info}/RECORD

@@ -1,11 +1,11 @@
-near_jsonrpc_client/__init__.py,sha256=AFX_TCuWlM5KoNPbCyBXE8eXYOt_ToHMx4rXjU5a12g,481
+near_jsonrpc_client/__init__.py,sha256=Sf6Vun5j7BU_gfA-VvoOCvxVcJUMfS9GCTSe0mHE76o,499
 near_jsonrpc_client/api_methods_async.py,sha256=ELi7-hV3GugFlI7hLNhkjYStupO2LY3O1MxPysNJLmg,27606
 near_jsonrpc_client/api_methods_sync.py,sha256=XUtvoUmMeMRmq1XT-QNgvLWKEJ9mq1GAwM85j-xXE6g,27095
-near_jsonrpc_client/base_client.py,sha256=70KENuSAb7DN5zUM0uA_1pC2kVQ9n3Kt_R59m1c3j4w,4313
+near_jsonrpc_client/base_client.py,sha256=xd4_o8-Z1wWFpRmkveYTzo1xoqUeQgw-1_oZzFogSIg,4334
 near_jsonrpc_client/client.py,sha256=8gnY3tgUOGwUe4r8_mOedlLik8Zr6jxbNMVxwPlmHYo,453
-near_jsonrpc_client/errors.py,sha256=s0p8fDeith1WyuN9fERry9lMduFeaGmu8cXEqaEYvXM,957
+near_jsonrpc_client/errors.py,sha256=pfhIENT9KxjYXTrEsN7dfFpcbnQj2yTFuLMPtDANdeQ,978
 near_jsonrpc_client/transport.py,sha256=r92Zf7r_4ggU_fKp4pR9WyeaUOVOyLEW7xqz8Ny1buY,1012
-near_jsonrpc_client-1.0.21.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+near_jsonrpc_client-1.0.23.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
 near_jsonrpc_models/__init__.py,sha256=l7gDQiY4sNIibaz_KVMSS70kE5UrqVsjIrn9xNv-Hw4,225545
 near_jsonrpc_models/access_key.py,sha256=Yxb_imR1x07BdrtSifGDbhKHfuvD8HYYa0iaj3g0V84,918
 near_jsonrpc_models/access_key_creation_config_view.py,sha256=z3DIfoi6jojkk-S91Eyj15CM_0ZScyOOOmyWYqio4e0,466
@@ -67,7 +67,7 @@ near_jsonrpc_models/deterministic_state_init_action.py,sha256=zYRxiLHt3oLRkuO9-K
 near_jsonrpc_models/direction.py,sha256=IBTozgwUQ2VwESQc41VNj2BG8kSvhiLiFqy2Z5eF6d0,124
 near_jsonrpc_models/dump_config.py,sha256=lsvXa66JMOUMtLnX7IfQ0FBFME2mM0mhTzj5MVhik6M,905
 near_jsonrpc_models/duration_as_std_schema_provider.py,sha256=sQsSNAiZj61nVXe3SfCzXkJVQ7XQFpzoQPWa_KhU0M4,170
-near_jsonrpc_models/dynamic_resharding_config_view.py,sha256=rA6Hq2pb67LPm_NWj53Vy2PkO2dFBLFfBcoB8_BjZV8,908
+near_jsonrpc_models/dynamic_resharding_config_view.py,sha256=Srmi4HWILUTEEupmhqCV8SHbqNHRzT51_73eJb7EJ0Y,1033
 near_jsonrpc_models/epoch_id.py,sha256=PhzEnxhfsr4KF3PJYYk62iXRWUhoyNQvFOBwzTWACeg,238
 near_jsonrpc_models/epoch_sync_config.py,sha256=mvI-SS2IhWixV2wYciKJSQbTg235L8UQmlfPt14EpYY,1636
 near_jsonrpc_models/error_wrapper_for_genesis_config_error.py,sha256=Fy8v8wHg2qkmjfNaAr64XPWY8VHt3yJjkcMtJdv1rp8,985
@@ -303,7 +303,7 @@ near_jsonrpc_models/rpc_view_gas_key_response.py,sha256=Wnymph7cwmVIJITV-UgECT82
 near_jsonrpc_models/rpc_view_state_error.py,sha256=XM-6-poRLwcSdfqwbxVeXQRvevV-erHF8NCIvPYbjNw,1915
 near_jsonrpc_models/rpc_view_state_request.py,sha256=QZjrAJSaT5gc-oq3G-5HqKBcuiD4OMTpnnOhS4B1mC8,987
 near_jsonrpc_models/rpc_view_state_response.py,sha256=GgZv8V6m8lrx-lV7tbteHNrT9UiculhU2SNzOYQSnpE,432
-near_jsonrpc_models/runtime_config_view.py,sha256=oh5_sX_Z7yy3eDHpRHWjW7pgv6LWbZeq28NQSbWuAu8,1797
+near_jsonrpc_models/runtime_config_view.py,sha256=SZJklyVA7GjhIuPEAsJa3a4tvDjUKs_q-qY2LS5YzC4,1849
 near_jsonrpc_models/runtime_fees_config_view.py,sha256=stmMEjLjoEn87xiQ4Ois_BGSw_Nbkgrjpo2WjH5n57g,1581
 near_jsonrpc_models/shard_id.py,sha256=BGs5Po_GSyiHz9jfTNUc6gwMg1tcXH1AJ4IMz-1SMAc,572
 near_jsonrpc_models/shard_layout.py,sha256=cQn_buHJBpUINWXwYS1HbKo_vZvFECpRkyiLt3vc4vM,1371
@@ -351,7 +351,7 @@ near_jsonrpc_models/vmconfig_view.py,sha256=LiW1t0jqnCiSdb8uuUBMaGzGg2NAudUo9kcO
 near_jsonrpc_models/vmkind.py,sha256=tCxyZlDaGn3bz-lThkbUj0oO6qxoQP7lGANMusstpC8,252
 near_jsonrpc_models/wasm_trap.py,sha256=y0nay7ulaHOGpHPRnKIU0FWxHeWfwnrYiYvllLry3Mw,791
 near_jsonrpc_models/witness_config_view.py,sha256=kTeYTx1mtk0IT6ary63awFk5hIGn8mS8UlOCMaqhr2Q,912
-near_jsonrpc_client-1.0.21.dist-info/METADATA,sha256=HY7NBixxCffxIhmcqeP6b5DT2g7hJVtK_mlE-eK3z5Q,6303
-near_jsonrpc_client-1.0.21.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-near_jsonrpc_client-1.0.21.dist-info/top_level.txt,sha256=uMGb9-6Ckd8WvQ5-m1l9mVFmM5lCORE6YybUIOimSuc,40
-near_jsonrpc_client-1.0.21.dist-info/RECORD,,
+near_jsonrpc_client-1.0.23.dist-info/METADATA,sha256=7Dtm_XeYiNu4xcKbGqBD0ZCWbAe3759QeEheywnS0KI,6309
+near_jsonrpc_client-1.0.23.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+near_jsonrpc_client-1.0.23.dist-info/top_level.txt,sha256=uMGb9-6Ckd8WvQ5-m1l9mVFmM5lCORE6YybUIOimSuc,40
+near_jsonrpc_client-1.0.23.dist-info/RECORD,,

near_jsonrpc_models/dynamic_resharding_config_view.py

@@ -1,23 +1,22 @@
-"""Configuration for dynamic resharding feature"""
+"""Configuration for dynamic resharding feature
+See [`DynamicReshardingConfig`] for more details."""
 
+from near_jsonrpc_models.shard_id import ShardId
 from pydantic import BaseModel
 from pydantic import conint
+from typing import List
 
 
 class DynamicReshardingConfigView(BaseModel):
+    # Shards that should **not** be split even when they meet the regular split criteria.
+    block_split_shards: List[ShardId]
+    # Shards that should be split even when they don't meet the regular split criteria.
+    force_split_shards: List[ShardId]
     # Maximum number of shards in the network.
-    # 
-    # See [`CongestionControlConfig`] for more details.
     max_number_of_shards: conint(ge=0, le=18446744073709551615)
     # Memory threshold over which a shard is marked for a split.
-    # 
-    # See [`CongestionControlConfig`] for more details.
     memory_usage_threshold: conint(ge=0, le=18446744073709551615)
     # Minimum memory usage of a child shard.
-    # 
-    # See [`CongestionControlConfig`] for more details.
     min_child_memory_usage: conint(ge=0, le=18446744073709551615)
     # Minimum number of epochs until next resharding can be scheduled.
-    # 
-    # See [`CongestionControlConfig`] for more details.
     min_epochs_between_resharding: conint(ge=0, le=18446744073709551615)

near_jsonrpc_models/runtime_config_view.py

@@ -17,7 +17,7 @@ class RuntimeConfigView(BaseModel):
     # The configuration for congestion control.
     congestion_control_config: CongestionControlConfigView = None
     # Configuration for dynamic resharding feature.
-    dynamic_resharding_config: DynamicReshardingConfigView = Field(default_factory=lambda: DynamicReshardingConfigView(**{'max_number_of_shards': 999999999999999, 'memory_usage_threshold': 999999999999999, 'min_child_memory_usage': 999999999999999, 'min_epochs_between_resharding': 999999999999999}))
+    dynamic_resharding_config: DynamicReshardingConfigView = Field(default_factory=lambda: DynamicReshardingConfigView(**{'block_split_shards': [], 'force_split_shards': [], 'max_number_of_shards': 999999999999999, 'memory_usage_threshold': 999999999999999, 'min_child_memory_usage': 999999999999999, 'min_epochs_between_resharding': 999999999999999}))
     # Amount of yN per byte required to have on the account.  See
     # <https://nomicon.io/Economics/Economics.html#state-stake> for details.
     storage_amount_per_byte: NearToken = None