near-jsonrpc-client 1.0.5__py3-none-any.whl

near_jsonrpc_client/api_methods_sync.py

@@ -0,0 +1,450 @@
+"""Auto-generated API mixin (generated by ApiGenerator).
+
+This file contains APIMixinSync which provides generated API methods.
+The runtime provides a NearBaseClientSync implementation (located in 'base_client')
+that exposes `_call(...)`.
+"""
+
+
+from .base_client import NearBaseClientSync
+
+import near_jsonrpc_models
+
+
+class APIMixinSync:
+
+
+    def experimental_call_function(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcCallFunctionRequest) -> near_jsonrpc_models.RpcCallFunctionResponse:
+        """
+        Calls a view function on a contract and returns the result.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalCallFunction,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcCallFunctionResponseAndRpcCallFunctionError,
+            params=params,
+        )
+
+    def experimental_changes(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcStateChangesInBlockByTypeRequest) -> near_jsonrpc_models.RpcStateChangesInBlockResponse:
+        """
+        [Deprecated] Returns changes for a given account, contract or contract code for given block height or hash. Consider using changes instead.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalChanges,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcStateChangesInBlockResponseAndRpcStateChangesError,
+            params=params,
+        )
+
+    def experimental_changes_in_block(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcStateChangesInBlockRequest) -> near_jsonrpc_models.RpcStateChangesInBlockByTypeResponse:
+        """
+        [Deprecated] Returns changes in block for given block height or hash over all transactions for all the types. Includes changes like account_touched, access_key_touched, data_touched, contract_code_touched. Consider using block_effects instead
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalChangesInBlock,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcStateChangesInBlockByTypeResponseAndRpcStateChangesError,
+            params=params,
+        )
+
+    def experimental_congestion_level(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcCongestionLevelRequest) -> near_jsonrpc_models.RpcCongestionLevelResponse:
+        """
+        Queries the congestion level of a shard. More info about congestion [here](https://near.github.io/nearcore/architecture/how/receipt-congestion.html?highlight=congestion#receipt-congestion)
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalCongestionLevel,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcCongestionLevelResponseAndRpcChunkError,
+            params=params,
+        )
+
+    def experimental_genesis_config(self: NearBaseClientSync) -> near_jsonrpc_models.GenesisConfig:
+        """
+        [Deprecated] Get initial state and parameters for the genesis block. Consider genesis_config instead.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        params = near_jsonrpc_models.GenesisConfigRequest.model_validate(None)
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalGenesisConfig,
+            response_model=near_jsonrpc_models.JsonRpcResponseForGenesisConfigAndGenesisConfigError,
+            params=params,
+        )
+
+    def experimental_light_client_block_proof(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcLightClientBlockProofRequest) -> near_jsonrpc_models.RpcLightClientBlockProofResponse:
+        """
+        Returns the proofs for a transaction execution.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalLightClientBlockProof,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcLightClientBlockProofResponseAndRpcLightClientProofError,
+            params=params,
+        )
+
+    def experimental_light_client_proof(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcLightClientExecutionProofRequest) -> near_jsonrpc_models.RpcLightClientExecutionProofResponse:
+        """
+        Returns the proofs for a transaction execution.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalLightClientProof,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcLightClientExecutionProofResponseAndRpcLightClientProofError,
+            params=params,
+        )
+
+    def experimental_maintenance_windows(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcMaintenanceWindowsRequest) -> near_jsonrpc_models.JsonRpcResponseForArrayOfRangeOfUint64AndRpcMaintenanceWindowsError:
+        """
+        [Deprecated] Returns the future windows for maintenance in current epoch for the specified account. In the maintenance windows, the node will not be block producer or chunk producer. Consider using maintenance_windows instead.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalMaintenanceWindows,
+            response_model=near_jsonrpc_models.JsonRpcResponseForArrayOfRangeOfUint64AndRpcMaintenanceWindowsError,
+            params=params,
+        )
+
+    def experimental_protocol_config(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcProtocolConfigRequest) -> near_jsonrpc_models.RpcProtocolConfigResponse:
+        """
+        A configuration that defines the protocol-level parameters such as gas/storage costs, limits, feature flags, other settings
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalProtocolConfig,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcProtocolConfigResponseAndRpcProtocolConfigError,
+            params=params,
+        )
+
+    def experimental_receipt(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcReceiptRequest) -> near_jsonrpc_models.RpcReceiptResponse:
+        """
+        Fetches a receipt by its ID (as is, without a status or execution outcome)
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalReceipt,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcReceiptResponseAndRpcReceiptError,
+            params=params,
+        )
+
+    def experimental_split_storage_info(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcSplitStorageInfoRequest) -> near_jsonrpc_models.RpcSplitStorageInfoResponse:
+        """
+        Contains the split storage information. More info on split storage [here](https://near-nodes.io/archival/split-storage-archival)
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalSplitStorageInfo,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcSplitStorageInfoResponseAndRpcSplitStorageInfoError,
+            params=params,
+        )
+
+    def experimental_tx_status(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcTransactionStatusRequest) -> near_jsonrpc_models.RpcTransactionResponse:
+        """
+        Queries status of a transaction by hash, returning the final transaction result and details of all receipts.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalTxStatus,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcTransactionResponseAndRpcTransactionError,
+            params=params,
+        )
+
+    def experimental_validators_ordered(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcValidatorsOrderedRequest) -> near_jsonrpc_models.JsonRpcResponseForArrayOfValidatorStakeViewAndRpcValidatorError:
+        """
+        Returns the current epoch validators ordered in the block producer order with repetition. This endpoint is solely used for bridge currently and is not intended for other external use cases.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalValidatorsOrdered,
+            response_model=near_jsonrpc_models.JsonRpcResponseForArrayOfValidatorStakeViewAndRpcValidatorError,
+            params=params,
+        )
+
+    def experimental_view_access_key(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewAccessKeyRequest) -> near_jsonrpc_models.RpcViewAccessKeyResponse:
+        """
+        Returns information about a single access key for given account.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewAccessKey,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewAccessKeyResponseAndRpcViewAccessKeyError,
+            params=params,
+        )
+
+    def experimental_view_access_key_list(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewAccessKeyListRequest) -> near_jsonrpc_models.RpcViewAccessKeyListResponse:
+        """
+        Returns all access keys for a given account.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewAccessKeyList,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewAccessKeyListResponseAndRpcViewAccessKeyListError,
+            params=params,
+        )
+
+    def experimental_view_account(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewAccountRequest) -> near_jsonrpc_models.RpcViewAccountResponse:
+        """
+        Returns information about an account for given account_id.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewAccount,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewAccountResponseAndRpcViewAccountError,
+            params=params,
+        )
+
+    def experimental_view_code(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewCodeRequest) -> near_jsonrpc_models.RpcViewCodeResponse:
+        """
+        Returns the contract code (Wasm binary) deployed to the account.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewCode,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewCodeResponseAndRpcViewCodeError,
+            params=params,
+        )
+
+    def experimental_view_gas_key(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewGasKeyRequest) -> near_jsonrpc_models.RpcViewGasKeyResponse:
+        """
+        Returns information about a single gas key for given account.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewGasKey,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewGasKeyResponseAndRpcViewGasKeyError,
+            params=params,
+        )
+
+    def experimental_view_gas_key_list(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewGasKeyListRequest) -> near_jsonrpc_models.RpcViewGasKeyListResponse:
+        """
+        Returns all gas keys for a given account.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewGasKeyList,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewGasKeyListResponseAndRpcViewGasKeyListError,
+            params=params,
+        )
+
+    def experimental_view_state(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcViewStateRequest) -> near_jsonrpc_models.RpcViewStateResponse:
+        """
+        Returns the state (key-value pairs) of a contract based on the key prefix.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForExperimentalViewState,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcViewStateResponseAndRpcViewStateError,
+            params=params,
+        )
+
+    def block(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcBlockRequest) -> near_jsonrpc_models.RpcBlockResponse:
+        """
+        Returns block details for given height or hash
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForBlock,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcBlockResponseAndRpcBlockError,
+            params=params,
+        )
+
+    def block_effects(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcStateChangesInBlockRequest) -> near_jsonrpc_models.RpcStateChangesInBlockByTypeResponse:
+        """
+        Returns changes in block for given block height or hash over all transactions for all the types. Includes changes like account_touched, access_key_touched, data_touched, contract_code_touched.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForBlockEffects,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcStateChangesInBlockByTypeResponseAndRpcStateChangesError,
+            params=params,
+        )
+
+    def broadcast_tx_async(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcSendTransactionRequest) -> near_jsonrpc_models.CryptoHash:
+        """
+        [Deprecated] Sends a transaction and immediately returns transaction hash. Consider using send_tx instead.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForBroadcastTxAsync,
+            response_model=near_jsonrpc_models.JsonRpcResponseForCryptoHashAndRpcTransactionError,
+            params=params,
+        )
+
+    def broadcast_tx_commit(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcSendTransactionRequest) -> near_jsonrpc_models.RpcTransactionResponse:
+        """
+        [Deprecated] Sends a transaction and waits until transaction is fully complete. (Has a 10 second timeout). Consider using send_tx instead.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForBroadcastTxCommit,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcTransactionResponseAndRpcTransactionError,
+            params=params,
+        )
+
+    def changes(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcStateChangesInBlockByTypeRequest) -> near_jsonrpc_models.RpcStateChangesInBlockResponse:
+        """
+        Returns changes for a given account, contract or contract code for given block height or hash.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForChanges,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcStateChangesInBlockResponseAndRpcStateChangesError,
+            params=params,
+        )
+
+    def chunk(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcChunkRequest) -> near_jsonrpc_models.RpcChunkResponse:
+        """
+        Returns details of a specific chunk. You can run a block details query to get a valid chunk hash.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForChunk,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcChunkResponseAndRpcChunkError,
+            params=params,
+        )
+
+    def client_config(self: NearBaseClientSync) -> near_jsonrpc_models.RpcClientConfigResponse:
+        """
+        Queries client node configuration
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        params = near_jsonrpc_models.RpcClientConfigRequest.model_validate(None)
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForClientConfig,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcClientConfigResponseAndRpcClientConfigError,
+            params=params,
+        )
+
+    def gas_price(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcGasPriceRequest) -> near_jsonrpc_models.RpcGasPriceResponse:
+        """
+        Returns gas price for a specific block_height or block_hash. Using [null] will return the most recent block's gas price.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForGasPrice,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcGasPriceResponseAndRpcGasPriceError,
+            params=params,
+        )
+
+    def genesis_config(self: NearBaseClientSync) -> near_jsonrpc_models.GenesisConfig:
+        """
+        Get initial state and parameters for the genesis block
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        params = near_jsonrpc_models.GenesisConfigRequest.model_validate(None)
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForGenesisConfig,
+            response_model=near_jsonrpc_models.JsonRpcResponseForGenesisConfigAndGenesisConfigError,
+            params=params,
+        )
+
+    def health(self: NearBaseClientSync) -> near_jsonrpc_models.JsonRpcResponseForNullableRpcHealthResponseAndRpcStatusError:
+        """
+        Returns the current health status of the RPC node the client connects to.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        params = near_jsonrpc_models.RpcHealthRequest.model_validate(None)
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForHealth,
+            response_model=near_jsonrpc_models.JsonRpcResponseForNullableRpcHealthResponseAndRpcStatusError,
+            params=params,
+        )
+
+    def light_client_proof(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcLightClientExecutionProofRequest) -> near_jsonrpc_models.RpcLightClientExecutionProofResponse:
+        """
+        Returns the proofs for a transaction execution.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForLightClientProof,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcLightClientExecutionProofResponseAndRpcLightClientProofError,
+            params=params,
+        )
+
+    def maintenance_windows(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcMaintenanceWindowsRequest) -> near_jsonrpc_models.JsonRpcResponseForArrayOfRangeOfUint64AndRpcMaintenanceWindowsError:
+        """
+        Returns the future windows for maintenance in current epoch for the specified account. In the maintenance windows, the node will not be block producer or chunk producer.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForMaintenanceWindows,
+            response_model=near_jsonrpc_models.JsonRpcResponseForArrayOfRangeOfUint64AndRpcMaintenanceWindowsError,
+            params=params,
+        )
+
+    def network_info(self: NearBaseClientSync) -> near_jsonrpc_models.RpcNetworkInfoResponse:
+        """
+        Queries the current state of node network connections. This includes information about active peers, transmitted data, known producers, etc.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        params = near_jsonrpc_models.RpcNetworkInfoRequest.model_validate(None)
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForNetworkInfo,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcNetworkInfoResponseAndRpcNetworkInfoError,
+            params=params,
+        )
+
+    def next_light_client_block(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcLightClientNextBlockRequest) -> near_jsonrpc_models.RpcLightClientNextBlockResponse:
+        """
+        Returns the next light client block.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForNextLightClientBlock,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcLightClientNextBlockResponseAndRpcLightClientNextBlockError,
+            params=params,
+        )
+
+    def query(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcQueryRequest) -> near_jsonrpc_models.RpcQueryResponse:
+        """
+        This module allows you to make generic requests to the network.  The `RpcQueryRequest` struct takes in a [`BlockReference`](https://docs.rs/near-primitives/0.12.0/near_primitives/types/enum.BlockReference.html) and a [`QueryRequest`](https://docs.rs/near-primitives/0.12.0/near_primitives/views/enum.QueryRequest.html).  The `BlockReference` enum allows you to specify a block by `Finality`, `BlockId` or `SyncCheckpoint`.  The `QueryRequest` enum provides multiple variants for performing the following actions:  - View an account's details  - View a contract's code  - View the state of an account  - View the `AccessKey` of an account  - View the `AccessKeyList` of an account  - Call a function in a contract deployed on the network.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForQuery,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcQueryResponseAndRpcQueryError,
+            params=params,
+        )
+
+    def send_tx(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcSendTransactionRequest) -> near_jsonrpc_models.RpcTransactionResponse:
+        """
+        Sends transaction. Returns the guaranteed execution status and the results the blockchain can provide at the moment.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForSendTx,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcTransactionResponseAndRpcTransactionError,
+            params=params,
+        )
+
+    def status(self: NearBaseClientSync) -> near_jsonrpc_models.RpcStatusResponse:
+        """
+        Requests the status of the connected RPC node. This includes information about sync status, nearcore node version, protocol version, the current set of validators, etc.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        params = near_jsonrpc_models.RpcStatusRequest.model_validate(None)
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForStatus,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcStatusResponseAndRpcStatusError,
+            params=params,
+        )
+
+    def tx(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcTransactionStatusRequest) -> near_jsonrpc_models.RpcTransactionResponse:
+        """
+        Queries status of a transaction by hash and returns the final transaction result.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForTx,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcTransactionResponseAndRpcTransactionError,
+            params=params,
+        )
+
+    def validators(self: NearBaseClientSync, *, params: near_jsonrpc_models.RpcValidatorRequest) -> near_jsonrpc_models.RpcValidatorResponse:
+        """
+        Queries active validators on the network. Returns details and the state of validation on the blockchain.
+        High-level method: returns the result model or raises NearClientError/NearRpcError/NearHttpError.
+        """
+        return self._call(
+            request_model=near_jsonrpc_models.JsonRpcRequestForValidators,
+            response_model=near_jsonrpc_models.JsonRpcResponseForRpcValidatorResponseAndRpcValidatorError,
+            params=params,
+        )

near_jsonrpc_client/base_client.py

@@ -0,0 +1,148 @@
+from typing import Type
+from uuid import uuid4
+
+import httpx
+import requests
+from pydantic import BaseModel
+from typing import get_args
+
+from .errors import (
+    ClientError,
+    TransportError,
+    HttpError,
+    RpcError,
+    RequestTimeoutError,
+)
+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(
+            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(
+            f"Invalid JSON-RPC method definition in {request_model.__name__}"
+        )
+
+    return args[0]
+
+
+def _parse_response(response_model: Type[BaseModel], response_json: dict):
+    """Shared response parsing and error handling."""
+    try:
+        parsed = response_model.model_validate(response_json)
+    except Exception as e:
+        raise ClientError("Invalid response format") from e
+
+    inner = parsed.root
+    if hasattr(inner, "error") and inner.error is not None:
+        raise RpcError(inner)
+    return inner.result
+
+
+# ===================== Async Client =====================
+class NearBaseClientAsync:
+    def __init__(
+        self,
+        *,
+        base_url: str,
+        timeout: float = 10.0,
+        headers: dict[str, str] | None = None,
+    ):
+        self._transport = HttpTransportAsync(
+            base_url=base_url, timeout=timeout, headers=headers
+        )
+
+    async def _call(
+        self,
+        *,
+        request_model: Type[BaseModel],
+        response_model: Type[BaseModel],
+        params: BaseModel,
+        debug=False
+    ):
+        request = request_model(
+            jsonrpc="2.0",
+            id=str(uuid4()),
+            method=_extract_method(request_model),
+            params=params,
+        )
+
+        payload = request.model_dump(by_alias=True)
+        if debug:
+            print("➡️ JSON-RPC Request payload:", payload)
+
+        try:
+            response = await self._transport.post(json=payload)
+            if debug:
+                print("⬅️ JSON-RPC Raw Response:", response.text)
+
+        except httpx.TimeoutException as e:
+            raise RequestTimeoutError() from e
+        except httpx.RequestError as e:
+            raise TransportError(str(e)) from e
+
+        if 500 <= response.status_code < 600:
+            raise HttpError(status_code=response.status_code, body=response.text)
+
+        return _parse_response(response_model, response.json())
+
+    async def close(self):
+        await self._transport.close()
+
+
+# ===================== Sync Client =====================
+class NearBaseClientSync:
+    def __init__(
+        self,
+        *,
+        base_url: str,
+        timeout: float = 10.0,
+        headers: dict[str, str] | None = None,
+    ):
+        self._transport = HttpTransportSync(
+            base_url=base_url, timeout=timeout, headers=headers
+        )
+
+    def _call(
+        self,
+        *,
+        request_model: Type[BaseModel],
+        response_model: Type[BaseModel],
+        params: BaseModel,
+        debug=False
+    ):
+        request = request_model(
+            jsonrpc="2.0",
+            id=str(uuid4()),
+            method=_extract_method(request_model),
+            params=params,
+        )
+
+        payload = request.model_dump(by_alias=True)
+        if debug:
+            print("➡️ JSON-RPC Request payload:", payload)
+
+        try:
+            response = self._transport.post(json=payload)
+            if debug:
+                print("⬅️ JSON-RPC Raw Response:", response.text)
+
+        # handle sync transport exceptions (requests or httpx sync)
+        except requests.Timeout as e:
+            raise RequestTimeoutError() from e
+        except requests.RequestException as e:
+            raise TransportError(str(e)) from e
+
+        if 500 <= response.status_code < 600:
+            raise HttpError(status_code=response.status_code, body=response.text)
+
+        return _parse_response(response_model, response.json())
+
+    def close(self):
+        self._transport.close()

near_jsonrpc_client/client.py

@@ -0,0 +1,13 @@
+from near_jsonrpc_client.api_methods_async import APIMixinAsync
+from near_jsonrpc_client.api_methods_sync import APIMixinSync
+from .base_client import NearBaseClientAsync, NearBaseClientSync
+
+
+class NearClientAsync(NearBaseClientAsync, APIMixinAsync):
+    """NearClientAsync with generated API methods mixed in."""
+    pass
+
+
+class NearClientSync(NearBaseClientSync, APIMixinSync):
+    """NearClientSync with generated API methods mixed in."""
+    pass

near_jsonrpc_client/errors.py

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