@psalomo/jsonrpc-client 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,241 @@
+export { JsonRpcErrorSchema, JsonRpcRequestSchema, JsonRpcResponseSchema, RPC_METHODS } from '@near-js/jsonrpc-types';
+
+interface ClientConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retries?: number;
+    validateResponses?: boolean;
+}
+interface JsonRpcRequest<T = unknown> {
+    jsonrpc: '2.0';
+    id: string;
+    method: string;
+    params?: T;
+}
+interface JsonRpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    id: string;
+    result?: T;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare class JsonRpcClientError extends Error {
+    code?: number | undefined;
+    data?: unknown | undefined;
+    constructor(message: string, code?: number | undefined, data?: unknown | undefined);
+}
+declare class JsonRpcNetworkError extends Error {
+    originalError: Error;
+    constructor(message: string, originalError: Error);
+}
+declare class NearRpcClient {
+    private endpoint;
+    private headers;
+    private timeout;
+    private retries;
+    private validateResponses;
+    private requestIdCounter;
+    constructor(config: string | ClientConfig);
+    /**
+     * Generate a unique request ID
+     */
+    private generateRequestId;
+    /**
+     * Make a raw JSON-RPC call
+     */
+    private call;
+    /**
+     * Get node status
+     */
+    status(): Promise<any>;
+    /**
+     * Get block information
+     */
+    block(params?: {
+        blockId?: string | number;
+        finality?: 'final' | 'near-final' | 'optimistic';
+    }): Promise<any>;
+    /**
+     * Get current gas price
+     */
+    gasPrice(params?: {
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get chunk information
+     */
+    chunk(params: {
+        chunkId: string;
+    } | {
+        blockId: string | number;
+        shardId: number;
+    }): Promise<any>;
+    /**
+     * Health check
+     */
+    health(): Promise<any>;
+    /**
+     * Get network information
+     */
+    networkInfo(): Promise<any>;
+    /**
+     * Get current validators
+     */
+    validators(params?: {
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get client configuration
+     */
+    clientConfig(): Promise<any>;
+    /**
+     * Broadcast transaction asynchronously
+     */
+    broadcastTxAsync(params: {
+        signedTxBase64: string;
+    }): Promise<any>;
+    /**
+     * Broadcast transaction and wait for commit
+     */
+    broadcastTxCommit(params: {
+        signedTxBase64: string;
+    }): Promise<any>;
+    /**
+     * Send transaction
+     */
+    sendTx(params: {
+        signedTxBase64: string;
+    }): Promise<any>;
+    /**
+     * Get transaction status
+     */
+    tx(params: {
+        txHash: string;
+        senderAccountId: string;
+    }): Promise<any>;
+    /**
+     * Query account/contract state
+     */
+    query(params: {
+        requestType: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+        accountId?: string;
+        methodName?: string;
+        argsBase64?: string;
+        publicKey?: string;
+        keyType?: string;
+    }): Promise<any>;
+    /**
+     * View account information (convenience method)
+     */
+    viewAccount(params: {
+        accountId: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * View function call (convenience method)
+     */
+    viewFunction(params: {
+        accountId: string;
+        methodName: string;
+        argsBase64?: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * View access key (convenience method)
+     */
+    viewAccessKey(params: {
+        accountId: string;
+        publicKey: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get light client proof
+     */
+    lightClientProof(params: {
+        type: string;
+        lightClientHead: string;
+        transactionHash?: string;
+        senderId?: string;
+        receiptId?: string;
+    }): Promise<any>;
+    /**
+     * Get state changes (experimental)
+     */
+    experimentalChanges(params: {
+        changesType: string;
+        accountIds?: string[];
+        keyPrefixBase64?: string;
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get state changes in block (experimental)
+     */
+    experimentalChangesInBlock(params: {
+        blockId: string | number;
+    }): Promise<any>;
+    /**
+     * Get ordered validators (experimental)
+     */
+    experimentalValidatorsOrdered(params?: {
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get protocol configuration (experimental)
+     */
+    experimentalProtocolConfig(params?: {
+        blockId?: string | number;
+        finality?: 'final' | 'near-final' | 'optimistic';
+    }): Promise<any>;
+    /**
+     * Get genesis configuration (experimental)
+     */
+    experimentalGenesisConfig(): Promise<any>;
+    /**
+     * Get receipt information (experimental)
+     */
+    experimentalReceipt(params: {
+        receiptId: string;
+    }): Promise<any>;
+    /**
+     * Get transaction status (experimental)
+     */
+    experimentalTxStatus(params: {
+        txHash: string;
+        senderAccountId: string;
+    }): Promise<any>;
+}
+
+interface RpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params: unknown;
+}
+interface RpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: T;
+    error?: RpcError;
+}
+interface RpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare class NearRpcError extends Error {
+    code: number;
+    data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+}
+
+export { type ClientConfig, JsonRpcClientError, type JsonRpcError, JsonRpcNetworkError, type JsonRpcRequest, type JsonRpcResponse, NearRpcClient, NearRpcError, type RpcError, type RpcRequest, type RpcResponse, NearRpcClient as default };

package/dist/index.d.ts

@@ -0,0 +1,241 @@
+export { JsonRpcErrorSchema, JsonRpcRequestSchema, JsonRpcResponseSchema, RPC_METHODS } from '@near-js/jsonrpc-types';
+
+interface ClientConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retries?: number;
+    validateResponses?: boolean;
+}
+interface JsonRpcRequest<T = unknown> {
+    jsonrpc: '2.0';
+    id: string;
+    method: string;
+    params?: T;
+}
+interface JsonRpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    id: string;
+    result?: T;
+    error?: JsonRpcError;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare class JsonRpcClientError extends Error {
+    code?: number | undefined;
+    data?: unknown | undefined;
+    constructor(message: string, code?: number | undefined, data?: unknown | undefined);
+}
+declare class JsonRpcNetworkError extends Error {
+    originalError: Error;
+    constructor(message: string, originalError: Error);
+}
+declare class NearRpcClient {
+    private endpoint;
+    private headers;
+    private timeout;
+    private retries;
+    private validateResponses;
+    private requestIdCounter;
+    constructor(config: string | ClientConfig);
+    /**
+     * Generate a unique request ID
+     */
+    private generateRequestId;
+    /**
+     * Make a raw JSON-RPC call
+     */
+    private call;
+    /**
+     * Get node status
+     */
+    status(): Promise<any>;
+    /**
+     * Get block information
+     */
+    block(params?: {
+        blockId?: string | number;
+        finality?: 'final' | 'near-final' | 'optimistic';
+    }): Promise<any>;
+    /**
+     * Get current gas price
+     */
+    gasPrice(params?: {
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get chunk information
+     */
+    chunk(params: {
+        chunkId: string;
+    } | {
+        blockId: string | number;
+        shardId: number;
+    }): Promise<any>;
+    /**
+     * Health check
+     */
+    health(): Promise<any>;
+    /**
+     * Get network information
+     */
+    networkInfo(): Promise<any>;
+    /**
+     * Get current validators
+     */
+    validators(params?: {
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get client configuration
+     */
+    clientConfig(): Promise<any>;
+    /**
+     * Broadcast transaction asynchronously
+     */
+    broadcastTxAsync(params: {
+        signedTxBase64: string;
+    }): Promise<any>;
+    /**
+     * Broadcast transaction and wait for commit
+     */
+    broadcastTxCommit(params: {
+        signedTxBase64: string;
+    }): Promise<any>;
+    /**
+     * Send transaction
+     */
+    sendTx(params: {
+        signedTxBase64: string;
+    }): Promise<any>;
+    /**
+     * Get transaction status
+     */
+    tx(params: {
+        txHash: string;
+        senderAccountId: string;
+    }): Promise<any>;
+    /**
+     * Query account/contract state
+     */
+    query(params: {
+        requestType: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+        accountId?: string;
+        methodName?: string;
+        argsBase64?: string;
+        publicKey?: string;
+        keyType?: string;
+    }): Promise<any>;
+    /**
+     * View account information (convenience method)
+     */
+    viewAccount(params: {
+        accountId: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * View function call (convenience method)
+     */
+    viewFunction(params: {
+        accountId: string;
+        methodName: string;
+        argsBase64?: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * View access key (convenience method)
+     */
+    viewAccessKey(params: {
+        accountId: string;
+        publicKey: string;
+        finality?: 'final' | 'near-final' | 'optimistic';
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get light client proof
+     */
+    lightClientProof(params: {
+        type: string;
+        lightClientHead: string;
+        transactionHash?: string;
+        senderId?: string;
+        receiptId?: string;
+    }): Promise<any>;
+    /**
+     * Get state changes (experimental)
+     */
+    experimentalChanges(params: {
+        changesType: string;
+        accountIds?: string[];
+        keyPrefixBase64?: string;
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get state changes in block (experimental)
+     */
+    experimentalChangesInBlock(params: {
+        blockId: string | number;
+    }): Promise<any>;
+    /**
+     * Get ordered validators (experimental)
+     */
+    experimentalValidatorsOrdered(params?: {
+        blockId?: string | number;
+    }): Promise<any>;
+    /**
+     * Get protocol configuration (experimental)
+     */
+    experimentalProtocolConfig(params?: {
+        blockId?: string | number;
+        finality?: 'final' | 'near-final' | 'optimistic';
+    }): Promise<any>;
+    /**
+     * Get genesis configuration (experimental)
+     */
+    experimentalGenesisConfig(): Promise<any>;
+    /**
+     * Get receipt information (experimental)
+     */
+    experimentalReceipt(params: {
+        receiptId: string;
+    }): Promise<any>;
+    /**
+     * Get transaction status (experimental)
+     */
+    experimentalTxStatus(params: {
+        txHash: string;
+        senderAccountId: string;
+    }): Promise<any>;
+}
+
+interface RpcRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params: unknown;
+}
+interface RpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: T;
+    error?: RpcError;
+}
+interface RpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare class NearRpcError extends Error {
+    code: number;
+    data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+}
+
+export { type ClientConfig, JsonRpcClientError, type JsonRpcError, JsonRpcNetworkError, type JsonRpcRequest, type JsonRpcResponse, NearRpcClient, NearRpcError, type RpcError, type RpcRequest, type RpcResponse, NearRpcClient as default };