@metamask-previews/network-controller 36.0.0-preview-3866c0ff1 → 36.0.0-preview-e3275932a
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +0 -1
- package/dist/NetworkController-method-action-types.cjs +7 -0
- package/dist/NetworkController-method-action-types.cjs.map +1 -0
- package/dist/{NetworkController-method-action-types.d.ts → NetworkController-method-action-types.d.cts} +2 -2
- package/dist/NetworkController-method-action-types.d.cts.map +1 -0
- package/dist/NetworkController-method-action-types.d.mts +268 -0
- package/dist/NetworkController-method-action-types.d.mts.map +1 -0
- package/dist/{NetworkController-method-action-types.js → NetworkController-method-action-types.mjs} +1 -1
- package/dist/NetworkController-method-action-types.mjs.map +1 -0
- package/dist/NetworkController.cjs +1599 -0
- package/dist/NetworkController.cjs.map +1 -0
- package/dist/{NetworkController.d.ts → NetworkController.d.cts} +29 -37
- package/dist/NetworkController.d.cts.map +1 -0
- package/dist/NetworkController.d.mts +956 -0
- package/dist/NetworkController.d.mts.map +1 -0
- package/dist/{NetworkController.js → NetworkController.mjs} +612 -716
- package/dist/NetworkController.mjs.map +1 -0
- package/dist/constants.cjs +46 -0
- package/dist/constants.cjs.map +1 -0
- package/dist/{constants.d.ts → constants.d.cts} +1 -1
- package/dist/constants.d.cts.map +1 -0
- package/dist/constants.d.mts +42 -0
- package/dist/constants.d.mts.map +1 -0
- package/dist/{constants.js → constants.mjs} +1 -1
- package/dist/constants.mjs.map +1 -0
- package/dist/create-auto-managed-network-client.cjs +149 -0
- package/dist/create-auto-managed-network-client.cjs.map +1 -0
- package/dist/{create-auto-managed-network-client.d.ts → create-auto-managed-network-client.d.cts} +7 -7
- package/dist/create-auto-managed-network-client.d.cts.map +1 -0
- package/dist/create-auto-managed-network-client.d.mts +74 -0
- package/dist/create-auto-managed-network-client.d.mts.map +1 -0
- package/dist/{create-auto-managed-network-client.js → create-auto-managed-network-client.mjs} +4 -4
- package/dist/create-auto-managed-network-client.mjs.map +1 -0
- package/dist/create-network-client.cjs +439 -0
- package/dist/create-network-client.cjs.map +1 -0
- package/dist/{create-network-client.d.ts → create-network-client.d.cts} +7 -7
- package/dist/create-network-client.d.cts.map +1 -0
- package/dist/create-network-client.d.mts +60 -0
- package/dist/create-network-client.d.mts.map +1 -0
- package/dist/{create-network-client.js → create-network-client.mjs} +14 -15
- package/dist/create-network-client.mjs.map +1 -0
- package/dist/index.cjs +31 -0
- package/dist/index.cjs.map +1 -0
- package/dist/{index.d.ts → index.d.cts} +16 -16
- package/dist/index.d.cts.map +1 -0
- package/dist/index.d.mts +16 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +6 -0
- package/dist/index.mjs.map +1 -0
- package/dist/logger.cjs +7 -0
- package/dist/logger.cjs.map +1 -0
- package/dist/logger.d.cts +5 -0
- package/dist/logger.d.cts.map +1 -0
- package/dist/logger.d.mts +5 -0
- package/dist/logger.d.mts.map +1 -0
- package/dist/logger.mjs +4 -0
- package/dist/logger.mjs.map +1 -0
- package/dist/rpc-service/abstract-rpc-service.cjs +3 -0
- package/dist/rpc-service/abstract-rpc-service.cjs.map +1 -0
- package/dist/rpc-service/{abstract-rpc-service.d.ts → abstract-rpc-service.d.cts} +2 -2
- package/dist/rpc-service/abstract-rpc-service.d.cts.map +1 -0
- package/dist/rpc-service/abstract-rpc-service.d.mts +17 -0
- package/dist/rpc-service/abstract-rpc-service.d.mts.map +1 -0
- package/dist/rpc-service/abstract-rpc-service.mjs +2 -0
- package/dist/rpc-service/abstract-rpc-service.mjs.map +1 -0
- package/dist/rpc-service/rpc-service-chain.cjs +304 -0
- package/dist/rpc-service/rpc-service-chain.cjs.map +1 -0
- package/dist/rpc-service/{rpc-service-chain.d.ts → rpc-service-chain.d.cts} +6 -6
- package/dist/rpc-service/rpc-service-chain.d.cts.map +1 -0
- package/dist/rpc-service/rpc-service-chain.d.mts +169 -0
- package/dist/rpc-service/rpc-service-chain.d.mts.map +1 -0
- package/dist/rpc-service/{rpc-service-chain.js → rpc-service-chain.mjs} +70 -57
- package/dist/rpc-service/rpc-service-chain.mjs.map +1 -0
- package/dist/rpc-service/rpc-service-requestable.cjs +3 -0
- package/dist/rpc-service/rpc-service-requestable.cjs.map +1 -0
- package/dist/rpc-service/{rpc-service-requestable.d.ts → rpc-service-requestable.d.cts} +4 -4
- package/dist/rpc-service/rpc-service-requestable.d.cts.map +1 -0
- package/dist/rpc-service/rpc-service-requestable.d.mts +63 -0
- package/dist/rpc-service/rpc-service-requestable.d.mts.map +1 -0
- package/dist/rpc-service/rpc-service-requestable.mjs +2 -0
- package/dist/rpc-service/rpc-service-requestable.mjs.map +1 -0
- package/dist/rpc-service/rpc-service.cjs +540 -0
- package/dist/rpc-service/rpc-service.cjs.map +1 -0
- package/dist/rpc-service/{rpc-service.d.ts → rpc-service.d.cts} +6 -6
- package/dist/rpc-service/rpc-service.d.cts.map +1 -0
- package/dist/rpc-service/rpc-service.d.mts +247 -0
- package/dist/rpc-service/rpc-service.d.mts.map +1 -0
- package/dist/rpc-service/{rpc-service.js → rpc-service.mjs} +197 -206
- package/dist/rpc-service/rpc-service.mjs.map +1 -0
- package/dist/rpc-service/shared.cjs +3 -0
- package/dist/rpc-service/shared.cjs.map +1 -0
- package/dist/rpc-service/{shared.d.ts → shared.d.cts} +2 -2
- package/dist/rpc-service/shared.d.cts.map +1 -0
- package/dist/rpc-service/shared.d.mts +32 -0
- package/dist/rpc-service/shared.d.mts.map +1 -0
- package/dist/rpc-service/shared.mjs +2 -0
- package/dist/rpc-service/shared.mjs.map +1 -0
- package/dist/rpc-service-analytics.cjs +180 -0
- package/dist/rpc-service-analytics.cjs.map +1 -0
- package/dist/{rpc-service-analytics.d.ts → rpc-service-analytics.d.cts} +3 -3
- package/dist/rpc-service-analytics.d.cts.map +1 -0
- package/dist/rpc-service-analytics.d.mts +85 -0
- package/dist/rpc-service-analytics.d.mts.map +1 -0
- package/dist/{rpc-service-analytics.js → rpc-service-analytics.mjs} +4 -4
- package/dist/rpc-service-analytics.mjs.map +1 -0
- package/dist/selectors.cjs +16 -0
- package/dist/selectors.cjs.map +1 -0
- package/dist/{selectors.d.ts → selectors.d.cts} +2 -2
- package/dist/selectors.d.cts.map +1 -0
- package/dist/selectors.d.mts +22 -0
- package/dist/selectors.d.mts.map +1 -0
- package/dist/{selectors.js → selectors.mjs} +1 -1
- package/dist/selectors.mjs.map +1 -0
- package/dist/types.cjs +12 -0
- package/dist/types.cjs.map +1 -0
- package/dist/{types.d.ts → types.d.cts} +5 -5
- package/dist/types.d.cts.map +1 -0
- package/dist/types.d.mts +49 -0
- package/dist/types.d.mts.map +1 -0
- package/dist/{types.js → types.mjs} +1 -1
- package/dist/types.mjs.map +1 -0
- package/package.json +18 -14
- package/dist/NetworkController-method-action-types.d.ts.map +0 -1
- package/dist/NetworkController-method-action-types.js.map +0 -1
- package/dist/NetworkController.d.ts.map +0 -1
- package/dist/NetworkController.js.map +0 -1
- package/dist/constants.d.ts.map +0 -1
- package/dist/constants.js.map +0 -1
- package/dist/create-auto-managed-network-client.d.ts.map +0 -1
- package/dist/create-auto-managed-network-client.js.map +0 -1
- package/dist/create-network-client.d.ts.map +0 -1
- package/dist/create-network-client.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -6
- package/dist/index.js.map +0 -1
- package/dist/logger.d.ts +0 -4
- package/dist/logger.d.ts.map +0 -1
- package/dist/logger.js +0 -4
- package/dist/logger.js.map +0 -1
- package/dist/rpc-service/abstract-rpc-service.d.ts.map +0 -1
- package/dist/rpc-service/abstract-rpc-service.js +0 -2
- package/dist/rpc-service/abstract-rpc-service.js.map +0 -1
- package/dist/rpc-service/rpc-service-chain.d.ts.map +0 -1
- package/dist/rpc-service/rpc-service-chain.js.map +0 -1
- package/dist/rpc-service/rpc-service-requestable.d.ts.map +0 -1
- package/dist/rpc-service/rpc-service-requestable.js +0 -2
- package/dist/rpc-service/rpc-service-requestable.js.map +0 -1
- package/dist/rpc-service/rpc-service.d.ts.map +0 -1
- package/dist/rpc-service/rpc-service.js.map +0 -1
- package/dist/rpc-service/shared.d.ts.map +0 -1
- package/dist/rpc-service/shared.js +0 -2
- package/dist/rpc-service/shared.js.map +0 -1
- package/dist/rpc-service-analytics.d.ts.map +0 -1
- package/dist/rpc-service-analytics.js.map +0 -1
- package/dist/selectors.d.ts.map +0 -1
- package/dist/selectors.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
import type { CreateServicePolicyOptions, ServicePolicy } from "@metamask/controller-utils";
|
|
2
|
+
import type { Json, JsonRpcParams, JsonRpcRequest, JsonRpcResponse } from "@metamask/utils";
|
|
3
|
+
import { CircuitState } from "cockatiel";
|
|
4
|
+
import type { Logger } from "loglevel";
|
|
5
|
+
import type { CockatielEventToEventListenerWithData, ExcludeCockatielEventData, ExtendCockatielEventData, ExtractCockatielEventData, FetchOptions } from "./shared.mjs";
|
|
6
|
+
/**
|
|
7
|
+
* Options for the RpcService constructor with some properties omitted and made optional as they have defaults.
|
|
8
|
+
*/
|
|
9
|
+
export type RpcServiceOptionsWithDefaults = Omit<RpcServiceOptions, 'failoverService' | 'endpointUrl' | 'isOffline' | 'btoa' | 'fetch'> & Partial<Pick<RpcServiceOptions, 'isOffline' | 'btoa' | 'fetch'>>;
|
|
10
|
+
/**
|
|
11
|
+
* Options for the RpcService constructor.
|
|
12
|
+
*/
|
|
13
|
+
export type RpcServiceOptions = {
|
|
14
|
+
/**
|
|
15
|
+
* A function that can be used to convert a binary string into a
|
|
16
|
+
* base64-encoded ASCII string. Used to encode authorization credentials.
|
|
17
|
+
*/
|
|
18
|
+
btoa: typeof btoa;
|
|
19
|
+
/**
|
|
20
|
+
* The URL of the RPC endpoint to hit.
|
|
21
|
+
*/
|
|
22
|
+
endpointUrl: URL | string;
|
|
23
|
+
/**
|
|
24
|
+
* A function that can be used to make an HTTP request. If your JavaScript
|
|
25
|
+
* environment supports `fetch` natively, you'll probably want to pass that;
|
|
26
|
+
* otherwise you can pass an equivalent (such as `fetch` via `node-fetch`).
|
|
27
|
+
*/
|
|
28
|
+
fetch: typeof fetch;
|
|
29
|
+
/**
|
|
30
|
+
* A common set of options that will be used to make every request. Can be
|
|
31
|
+
* overridden on the request level (e.g. to add headers).
|
|
32
|
+
*/
|
|
33
|
+
fetchOptions?: FetchOptions;
|
|
34
|
+
/**
|
|
35
|
+
* A `loglevel` logger.
|
|
36
|
+
*/
|
|
37
|
+
logger?: Pick<Logger, 'warn'>;
|
|
38
|
+
/**
|
|
39
|
+
* Options to pass to `createServicePolicy`. Note that `retryFilterPolicy` and `isServiceFailure`
|
|
40
|
+
* are not accepted, as they are overwritten. See {@link createServicePolicy}.
|
|
41
|
+
*/
|
|
42
|
+
policyOptions?: Omit<CreateServicePolicyOptions, 'retryFilterPolicy' | 'isServiceFailure'>;
|
|
43
|
+
/**
|
|
44
|
+
* A function that checks if the user is currently offline. If it returns true,
|
|
45
|
+
* connection errors will not be retried, preventing degraded and break
|
|
46
|
+
* callbacks from being triggered.
|
|
47
|
+
*/
|
|
48
|
+
isOffline: () => boolean;
|
|
49
|
+
};
|
|
50
|
+
/**
|
|
51
|
+
* The maximum number of times that a failing service should be re-run before
|
|
52
|
+
* giving up.
|
|
53
|
+
*
|
|
54
|
+
* Note: This is not used in production and should be removed.
|
|
55
|
+
*/
|
|
56
|
+
export declare const DEFAULT_MAX_RETRIES = 4;
|
|
57
|
+
/**
|
|
58
|
+
* The maximum number of times that the service is allowed to fail before
|
|
59
|
+
* pausing further retries. This is set to a value such that if given a
|
|
60
|
+
* service that continually fails, the policy needs to be executed 3 times
|
|
61
|
+
* before further retries are paused.
|
|
62
|
+
*/
|
|
63
|
+
export declare const DEFAULT_MAX_CONSECUTIVE_FAILURES: number;
|
|
64
|
+
/**
|
|
65
|
+
* The list of error messages that represent a failure to connect to the network.
|
|
66
|
+
*
|
|
67
|
+
* This list was derived from Sindre Sorhus's `is-network-error` package:
|
|
68
|
+
* <https://github.com/sindresorhus/is-network-error/blob/7bbfa8be9482ce1427a21fbff60e3ee1650dd091/index.js>
|
|
69
|
+
*/
|
|
70
|
+
export declare const CONNECTION_ERRORS: {
|
|
71
|
+
constructorName: string;
|
|
72
|
+
pattern: RegExp;
|
|
73
|
+
}[];
|
|
74
|
+
/**
|
|
75
|
+
* Custom JSON-RPC error codes for specific cases.
|
|
76
|
+
*
|
|
77
|
+
* These should be moved to `@metamask/rpc-errors` eventually.
|
|
78
|
+
*/
|
|
79
|
+
export declare const CUSTOM_RPC_ERRORS: {
|
|
80
|
+
readonly unauthorized: -32006;
|
|
81
|
+
readonly httpClientError: -32080;
|
|
82
|
+
};
|
|
83
|
+
/**
|
|
84
|
+
* Determines whether the given error represents a failure to reach the network
|
|
85
|
+
* after request parameters have been validated.
|
|
86
|
+
*
|
|
87
|
+
* This is somewhat difficult to verify because JavaScript engines (and in
|
|
88
|
+
* some cases libraries) produce slightly different error messages for this
|
|
89
|
+
* particular scenario, and we need to account for this.
|
|
90
|
+
*
|
|
91
|
+
* @param error - The error.
|
|
92
|
+
* @returns True if the error indicates that the network cannot be connected to,
|
|
93
|
+
* and false otherwise.
|
|
94
|
+
*/
|
|
95
|
+
export declare function isConnectionError(error: unknown): boolean;
|
|
96
|
+
/**
|
|
97
|
+
* Determine whether the given error message indicates a failure to parse JSON.
|
|
98
|
+
*
|
|
99
|
+
* This is different in tests vs. implementation code because it may manifest as
|
|
100
|
+
* a FetchError or a SyntaxError.
|
|
101
|
+
*
|
|
102
|
+
* @param error - The error object to test.
|
|
103
|
+
* @returns True if the error indicates a JSON parse error, false otherwise.
|
|
104
|
+
*/
|
|
105
|
+
export declare function isJsonParseError(error: unknown): boolean;
|
|
106
|
+
/**
|
|
107
|
+
* Determines whether the given error represents a HTTP server error
|
|
108
|
+
* (502, 503, or 504) that should be retried.
|
|
109
|
+
*
|
|
110
|
+
* @param error - The error object to test.
|
|
111
|
+
* @returns True if the error has an httpStatus of 502, 503, or 504.
|
|
112
|
+
*/
|
|
113
|
+
export declare function isHttpServerError(error: Error): boolean;
|
|
114
|
+
/**
|
|
115
|
+
* Determines whether the given error has a `code` property of `ETIMEDOUT`.
|
|
116
|
+
*
|
|
117
|
+
* @param error - The error object to test.
|
|
118
|
+
* @returns True if the error code is `ETIMEDOUT`.
|
|
119
|
+
*/
|
|
120
|
+
export declare function isTimeoutError(error: Error): boolean;
|
|
121
|
+
/**
|
|
122
|
+
* Determines whether the given error has a `code` property of `ECONNRESET`.
|
|
123
|
+
*
|
|
124
|
+
* @param error - The error object to test.
|
|
125
|
+
* @returns True if the error code is `ECONNRESET`.
|
|
126
|
+
*/
|
|
127
|
+
export declare function isConnectionResetError(error: Error): boolean;
|
|
128
|
+
/**
|
|
129
|
+
* This class is responsible for making a request to an endpoint that implements
|
|
130
|
+
* the JSON-RPC protocol. It is designed to gracefully handle network and server
|
|
131
|
+
* failures, retrying requests using exponential backoff. It also offers a hook
|
|
132
|
+
* which can used to respond to slow requests.
|
|
133
|
+
*/
|
|
134
|
+
export declare class RpcService {
|
|
135
|
+
#private;
|
|
136
|
+
/**
|
|
137
|
+
* The URL of the RPC endpoint.
|
|
138
|
+
*/
|
|
139
|
+
readonly endpointUrl: URL;
|
|
140
|
+
/**
|
|
141
|
+
* The last error that the retry policy captured (or `undefined` if the last
|
|
142
|
+
* execution of the service was successful).
|
|
143
|
+
*/
|
|
144
|
+
lastError: Error | undefined;
|
|
145
|
+
/**
|
|
146
|
+
* Constructs a new RpcService object.
|
|
147
|
+
*
|
|
148
|
+
* @param options - The options. See {@link RpcServiceOptions}.
|
|
149
|
+
*/
|
|
150
|
+
constructor(options: RpcServiceOptions);
|
|
151
|
+
/**
|
|
152
|
+
* Resets the underlying composite Cockatiel policy.
|
|
153
|
+
*
|
|
154
|
+
* This is useful in a collection of RpcServices where some act as failovers
|
|
155
|
+
* for others where you effectively want to invalidate the failovers when the
|
|
156
|
+
* primary recovers.
|
|
157
|
+
*/
|
|
158
|
+
resetPolicy(): void;
|
|
159
|
+
/**
|
|
160
|
+
* @returns The state of the underlying circuit.
|
|
161
|
+
*/
|
|
162
|
+
getCircuitState(): CircuitState;
|
|
163
|
+
/**
|
|
164
|
+
* Listens for when the RPC service retries the request.
|
|
165
|
+
*
|
|
166
|
+
* @param listener - The callback to be called when the retry occurs.
|
|
167
|
+
* @returns What {@link ServicePolicy.onRetry} returns.
|
|
168
|
+
* @see {@link createServicePolicy}
|
|
169
|
+
*/
|
|
170
|
+
onRetry(listener: CockatielEventToEventListenerWithData<ServicePolicy['onRetry'], {
|
|
171
|
+
endpointUrl: string;
|
|
172
|
+
}>): ReturnType<ServicePolicy['onRetry']>;
|
|
173
|
+
/**
|
|
174
|
+
* Listens for when the RPC service retries the request too many times in a
|
|
175
|
+
* row, causing the underlying circuit to break.
|
|
176
|
+
*
|
|
177
|
+
* @param listener - The callback to be called when the circuit is broken.
|
|
178
|
+
* @returns What {@link ServicePolicy.onBreak} returns.
|
|
179
|
+
* @see {@link createServicePolicy}
|
|
180
|
+
*/
|
|
181
|
+
onBreak(listener: (data: ExcludeCockatielEventData<ExtendCockatielEventData<ExtractCockatielEventData<ServicePolicy['onBreak']>, {
|
|
182
|
+
endpointUrl: string;
|
|
183
|
+
}>, 'isolated'>) => void): ReturnType<ServicePolicy['onBreak']>;
|
|
184
|
+
/**
|
|
185
|
+
* Listens for when the policy underlying this RPC service detects a slow
|
|
186
|
+
* request.
|
|
187
|
+
*
|
|
188
|
+
* @param listener - The callback to be called when the request is slow.
|
|
189
|
+
* @returns What {@link ServicePolicy.onDegraded} returns.
|
|
190
|
+
* @see {@link createServicePolicy}
|
|
191
|
+
*/
|
|
192
|
+
onDegraded(listener: CockatielEventToEventListenerWithData<ServicePolicy['onDegraded'], {
|
|
193
|
+
duration?: number;
|
|
194
|
+
endpointUrl: string;
|
|
195
|
+
rpcMethodName: string;
|
|
196
|
+
traceId?: string;
|
|
197
|
+
}>): ReturnType<ServicePolicy['onDegraded']>;
|
|
198
|
+
/**
|
|
199
|
+
* Listens for when the policy underlying this RPC service is available.
|
|
200
|
+
*
|
|
201
|
+
* @param listener - The callback to be called when the request is available.
|
|
202
|
+
* @returns What {@link ServicePolicy.onAvailable} returns.
|
|
203
|
+
* @see {@link createServicePolicy}
|
|
204
|
+
*/
|
|
205
|
+
onAvailable(listener: CockatielEventToEventListenerWithData<ServicePolicy['onAvailable'], {
|
|
206
|
+
endpointUrl: string;
|
|
207
|
+
}>): ReturnType<ServicePolicy['onAvailable']>;
|
|
208
|
+
/**
|
|
209
|
+
* Makes a request to the RPC endpoint.
|
|
210
|
+
*
|
|
211
|
+
* This overload is specifically designed for `eth_getBlockByNumber`, which
|
|
212
|
+
* can return a `result` of `null` despite an expected `Result` being
|
|
213
|
+
* provided.
|
|
214
|
+
*
|
|
215
|
+
* @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.
|
|
216
|
+
* @param fetchOptions - An options bag for {@link fetch} which further
|
|
217
|
+
* specifies the request.
|
|
218
|
+
* @returns The decoded JSON-RPC response from the endpoint.
|
|
219
|
+
* @throws An "authorized" JSON-RPC error (code -32006) if the response HTTP status is 401.
|
|
220
|
+
* @throws A "rate limiting" JSON-RPC error (code -32005) if the response HTTP status is 429.
|
|
221
|
+
* @throws A "resource unavailable" JSON-RPC error (code -32002) if the response HTTP status is 402, 404, or any 5xx.
|
|
222
|
+
* @throws A generic HTTP client JSON-RPC error (code -32050) for any other 4xx HTTP status codes.
|
|
223
|
+
* @throws A "parse" JSON-RPC error (code -32700) if the response is not valid JSON.
|
|
224
|
+
*/
|
|
225
|
+
request<Params extends JsonRpcParams, Result extends Json>(jsonRpcRequest: JsonRpcRequest<Params> & {
|
|
226
|
+
method: 'eth_getBlockByNumber';
|
|
227
|
+
}, fetchOptions?: FetchOptions): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;
|
|
228
|
+
/**
|
|
229
|
+
* Makes a request to the RPC endpoint.
|
|
230
|
+
*
|
|
231
|
+
* This overload is designed for all RPC methods except for
|
|
232
|
+
* `eth_getBlockByNumber`, which are expected to return a `result` of the
|
|
233
|
+
* expected `Result`.
|
|
234
|
+
*
|
|
235
|
+
* @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.
|
|
236
|
+
* @param fetchOptions - An options bag for {@link fetch} which further
|
|
237
|
+
* specifies the request.
|
|
238
|
+
* @returns The decoded JSON-RPC response from the endpoint.
|
|
239
|
+
* @throws An "authorized" JSON-RPC error (code -32006) if the response HTTP status is 401.
|
|
240
|
+
* @throws A "rate limiting" JSON-RPC error (code -32005) if the response HTTP status is 429.
|
|
241
|
+
* @throws A "resource unavailable" JSON-RPC error (code -32002) if the response HTTP status is 402, 404, or any 5xx.
|
|
242
|
+
* @throws A generic HTTP client JSON-RPC error (code -32050) for any other 4xx HTTP status codes.
|
|
243
|
+
* @throws A "parse" JSON-RPC error (code -32700) if the response is not valid JSON.
|
|
244
|
+
*/
|
|
245
|
+
request<Params extends JsonRpcParams, Result extends Json>(jsonRpcRequest: JsonRpcRequest<Params>, fetchOptions?: FetchOptions): Promise<JsonRpcResponse<Result>>;
|
|
246
|
+
}
|
|
247
|
+
//# sourceMappingURL=rpc-service.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rpc-service.d.mts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service.ts"],"names":[],"mappings":"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"}
|