@solana/rpc-spec 2.0.0-20241006045741

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/LICENSE ADDED
@@ -0,0 +1,20 @@
1
+ Copyright (c) 2023 Solana Labs, Inc
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining
4
+ a copy of this software and associated documentation files (the
5
+ "Software"), to deal in the Software without restriction, including
6
+ without limitation the rights to use, copy, modify, merge, publish,
7
+ distribute, sublicense, and/or sell copies of the Software, and to
8
+ permit persons to whom the Software is furnished to do so, subject to
9
+ the following conditions:
10
+
11
+ The above copyright notice and this permission notice shall be
12
+ included in all copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,151 @@
1
+ [![npm][npm-image]][npm-url]
2
+ [![npm-downloads][npm-downloads-image]][npm-url]
3
+ [![semantic-release][semantic-release-image]][semantic-release-url]
4
+ <br />
5
+ [![code-style-prettier][code-style-prettier-image]][code-style-prettier-url]
6
+
7
+ [code-style-prettier-image]: https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square
8
+ [code-style-prettier-url]: https://github.com/prettier/prettier
9
+ [npm-downloads-image]: https://img.shields.io/npm/dm/@solana/rpc-spec/rc.svg?style=flat
10
+ [npm-image]: https://img.shields.io/npm/v/@solana/rpc-spec/rc.svg?style=flat
11
+ [npm-url]: https://www.npmjs.com/package/@solana/rpc-spec/v/rc
12
+ [semantic-release-image]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
13
+ [semantic-release-url]: https://github.com/semantic-release/semantic-release
14
+
15
+ # @solana/rpc-spec
16
+
17
+ This package contains types that describe the implementation of the JSON RPC API, as well as methods to create one. It can be used standalone, but it is also exported as part of the Solana JavaScript SDK [`@solana/web3.js@rc`](https://github.com/solana-labs/solana-web3.js/tree/master/packages/library).
18
+
19
+ This API is designed to be used as follows:
20
+
21
+ ```ts
22
+ const rpc =
23
+ // Step 1 - Create an `Rpc` instance. This may be stateful.
24
+ createSolanaRpc(mainnet('https://api.mainnet-beta.solana.com'));
25
+ const response = await rpc
26
+ // Step 2 - Call supported methods on it to produce `PendingRpcRequest` objects.
27
+ .getLatestBlockhash({ commitment: 'confirmed' })
28
+ // Step 3 - Call the `send()` method on those pending requests to trigger them.
29
+ .send({ abortSignal: AbortSignal.timeout(10_000) });
30
+ ```
31
+
32
+ ## Types
33
+
34
+ ### `PendingRpcRequest<TResponse>`
35
+
36
+ Pending requests are the result of calling a supported method on an `Rpc` object. They encapsulate all of the information necessary to make the request without actually making it.
37
+
38
+ Calling the `send(options)` method on a `PendingRpcRequest` will trigger the request and return a promise for `TResponse`.
39
+
40
+ ### `Rpc<TRpcMethods, TRpcTransport>`
41
+
42
+ An object that exposes all of the functions described by `TRpcMethods`, and fulfils them using `TRpcTransport`. Calling each method returns a `PendingRpcRequest<TResponse>` where `TResponse` is that method's response type.
43
+
44
+ ### `RpcRequest`
45
+
46
+ An object that describes the elements of a JSON RPC request. It consists of the following properties:
47
+
48
+ - `methodName`: The name of the JSON RPC method to be called.
49
+ - `params`: The parameters to be passed to the JSON RPC method.
50
+
51
+ ### `RpcRequestTransformer`
52
+
53
+ A function that accepts an `RpcRequest` and returns another `RpcRequest`. This allows the `RpcApi` to transform the request before it is sent to the JSON RPC server.
54
+
55
+ ### `RpcResponse`
56
+
57
+ A type that represents the response from a JSON RPC server. This could be any sort of data which is why `RpcResponse` defaults to `unknown`. You may use a type parameter to specify the shape of the response — e.g. `RpcResponse<{ result: number }>`.
58
+
59
+ ### `RpcResponseTransformer`
60
+
61
+ A function that accepts an `RpcResponse` and returns another `RpcResponse`. This allows the `RpcApi` to transform the response before it is returned to the caller.
62
+
63
+ ### `RpcApi<TRpcMethods>`
64
+
65
+ For each of `TRpcMethods` this object exposes a method with the same name that maps between its input arguments and a `RpcApiRequestPlan<TResponse>` that describes how to prepare a JSON RPC request to fetch `TResponse`.
66
+
67
+ ### `RpcApiMethods`
68
+
69
+ This is a marker interface that all RPC method definitions must extend to be accepted for use with the `RpcApi` creator.
70
+
71
+ ### `RpcApiRequestPlan`
72
+
73
+ This type allows an `RpcApi` to describe how a particular request should be issued to the JSON RPC server. Given a function that was called on a `Rpc`, this object gives you the opportunity to:
74
+
75
+ - provide a `payload` from the requested method name and parameters.
76
+ - provide a function to transform the JSON RPC server's response, in case it does not match the `TResponse` specified by the `PendingRpcRequest<TResponse>` returned from that function.
77
+
78
+ ### `RpcSendOptions`
79
+
80
+ A configuration object consisting of the following properties:
81
+
82
+ - `abortSignal`: An optional signal that you can supply when triggering a `PendingRpcRequest` that you might later need to abort.
83
+
84
+ ### `RpcTransport`
85
+
86
+ Any function that implements this interface can act as a transport for an `Rpc`. It need only return a promise for a response given the following config:
87
+
88
+ - `payload`: A value of arbitrary type to be sent.
89
+ - `signal`: An optional `AbortSignal` on which the `'abort'` event will be fired if the request should be cancelled.
90
+
91
+ ## Functions
92
+
93
+ ### `createRpc(config)`
94
+
95
+ Creates an RPC instance given an `RpcApi<TRpcMethods>` and a `RpcTransport` capable of fulfilling them.
96
+
97
+ #### Arguments
98
+
99
+ A config object with the following properties:
100
+
101
+ - `api`: An instance of `RpcApi`
102
+ - `transport`: A function that implements the `RpcTransport` interface
103
+
104
+ ### `createJsonRpcApi(config)`
105
+
106
+ Creates a JavaScript proxy that converts _any_ function call called on it to a `RpcApiRequestPlan` by:
107
+
108
+ - setting `payload` to a JSON RPC v2 payload object with the requested `methodName` and `params` properties, optionally transformed by `config.requestTransformer`.
109
+ - setting `responseTransformer` to `config.responseTransformer`, if provided.
110
+
111
+ ```ts
112
+ // For example, given this `RpcApi`:
113
+ const rpcApi = createJsonRpcApi({
114
+ requestTransformer: (...rawParams) => rawParams.reverse(),
115
+ responseTransformer: response => response.result,
116
+ });
117
+
118
+ // ...the following function call:
119
+ rpcApi.foo('bar', { baz: 'bat' });
120
+
121
+ // ...will produce the following `RpcApiRequestPlan` object:
122
+ //
123
+ // {
124
+ // payload: { id: 1, jsonrpc: '2.0', method: 'foo', params: ['bar', { baz: 'bat' }] },
125
+ // responseTransformer: (response) => response.result,
126
+ // }
127
+ ```
128
+
129
+ #### Arguments
130
+
131
+ A config object with the following properties:
132
+
133
+ - `requestTransformer<T>(request: RpcRequest<T>): RpcRequest`: An optional function that transforms the `RpcRequest` before it is sent to the JSON RPC server.
134
+ - `responseTransformer<T>(response: RpcResponse, request: RpcRequest): RpcResponse<T>`: An optional function that transforms the `RpcResponse` before it is returned to the caller.
135
+
136
+ ### `isJsonRpcPayload(payload)`
137
+
138
+ A helper function that returns `true` if the given payload is a JSON RPC v2 payload. This means, the payload is an object such that:
139
+
140
+ - It has a `jsonrpc` property with a value of `'2.0'`.
141
+ - It has a `method` property that is a string.
142
+ - It has a `params` property of any type.
143
+
144
+ ```ts
145
+ import { isJsonRpcPayload } from '@solana/rpc-spec';
146
+
147
+ if (isJsonRpcPayload(payload)) {
148
+ const payloadMethod: string = payload.method;
149
+ const payloadParams: unknown = payload.params;
150
+ }
151
+ ```
@@ -0,0 +1,83 @@
1
+ 'use strict';
2
+
3
+ var errors = require('@solana/errors');
4
+ var rpcSpecTypes = require('@solana/rpc-spec-types');
5
+
6
+ // src/rpc.ts
7
+ function createRpc(rpcConfig) {
8
+ return makeProxy(rpcConfig);
9
+ }
10
+ function makeProxy(rpcConfig) {
11
+ return new Proxy(rpcConfig.api, {
12
+ defineProperty() {
13
+ return false;
14
+ },
15
+ deleteProperty() {
16
+ return false;
17
+ },
18
+ get(target, p, receiver) {
19
+ return function(...rawParams) {
20
+ const methodName = p.toString();
21
+ const getApiPlan = Reflect.get(target, methodName, receiver);
22
+ if (!getApiPlan) {
23
+ throw new errors.SolanaError(errors.SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {
24
+ method: methodName,
25
+ params: rawParams
26
+ });
27
+ }
28
+ const apiPlan = getApiPlan(...rawParams);
29
+ return createPendingRpcRequest(rpcConfig, apiPlan);
30
+ };
31
+ }
32
+ });
33
+ }
34
+ function createPendingRpcRequest(rpcConfig, apiPlan) {
35
+ return {
36
+ async send(options) {
37
+ const { payload, responseTransformer } = apiPlan;
38
+ const rawResponse = await rpcConfig.transport({ payload, signal: options?.abortSignal });
39
+ return responseTransformer ? responseTransformer(rawResponse) : rawResponse;
40
+ }
41
+ };
42
+ }
43
+ function createJsonRpcApi(config) {
44
+ return new Proxy({}, {
45
+ defineProperty() {
46
+ return false;
47
+ },
48
+ deleteProperty() {
49
+ return false;
50
+ },
51
+ get(...args) {
52
+ const [_, p] = args;
53
+ const methodName = p.toString();
54
+ return function(...rawParams) {
55
+ const rawRequest = Object.freeze({ methodName, params: rawParams });
56
+ const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;
57
+ return Object.freeze({
58
+ payload: rpcSpecTypes.createRpcMessage(request.methodName, request.params),
59
+ ...config?.responseTransformer ? {
60
+ responseTransformer: (response) => {
61
+ const configTransformer = config.responseTransformer;
62
+ return configTransformer(response, request);
63
+ }
64
+ } : {}
65
+ });
66
+ };
67
+ }
68
+ });
69
+ }
70
+
71
+ // src/rpc-transport.ts
72
+ function isJsonRpcPayload(payload) {
73
+ if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
74
+ return false;
75
+ }
76
+ return "jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && typeof payload.method === "string" && "params" in payload;
77
+ }
78
+
79
+ exports.createJsonRpcApi = createJsonRpcApi;
80
+ exports.createRpc = createRpc;
81
+ exports.isJsonRpcPayload = isJsonRpcPayload;
82
+ //# sourceMappingURL=index.browser.cjs.map
83
+ //# sourceMappingURL=index.browser.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rpc.ts","../src/rpc-api.ts","../src/rpc-transport.ts"],"names":["SolanaError","SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD","createRpcMessage"],"mappings":"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","file":"index.browser.cjs","sourcesContent":["import { SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, SolanaError } from '@solana/errors';\nimport { Callable, Flatten, OverloadImplementations, UnionToIntersection } from '@solana/rpc-spec-types';\n\nimport { RpcApi, RpcApiRequestPlan } from './rpc-api';\nimport { RpcTransport } from './rpc-transport';\n\nexport type RpcConfig<TRpcMethods, TRpcTransport extends RpcTransport> = Readonly<{\n api: RpcApi<TRpcMethods>;\n transport: TRpcTransport;\n}>;\n\nexport type Rpc<TRpcMethods> = {\n [TMethodName in keyof TRpcMethods]: PendingRpcRequestBuilder<OverloadImplementations<TRpcMethods, TMethodName>>;\n};\n\nexport type PendingRpcRequest<TResponse> = {\n send(options?: RpcSendOptions): Promise<TResponse>;\n};\n\nexport type RpcSendOptions = Readonly<{\n abortSignal?: AbortSignal;\n}>;\n\ntype PendingRpcRequestBuilder<TMethodImplementations> = UnionToIntersection<\n Flatten<{\n [P in keyof TMethodImplementations]: PendingRpcRequestReturnTypeMapper<TMethodImplementations[P]>;\n }>\n>;\n\ntype PendingRpcRequestReturnTypeMapper<TMethodImplementation> =\n // Check that this property of the TRpcMethods interface is, in fact, a function.\n TMethodImplementation extends Callable\n ? (...args: Parameters<TMethodImplementation>) => PendingRpcRequest<ReturnType<TMethodImplementation>>\n : never;\n\nexport function createRpc<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return makeProxy(rpcConfig) as Rpc<TRpcMethods>;\n}\n\nfunction makeProxy<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return new Proxy(rpcConfig.api, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get(target, p, receiver) {\n return function (...rawParams: unknown[]) {\n const methodName = p.toString();\n const getApiPlan = Reflect.get(target, methodName, receiver);\n if (!getApiPlan) {\n throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {\n method: methodName,\n params: rawParams,\n });\n }\n const apiPlan = getApiPlan(...rawParams);\n return createPendingRpcRequest(rpcConfig, apiPlan);\n };\n },\n }) as Rpc<TRpcMethods>;\n}\n\nfunction createPendingRpcRequest<TRpcMethods, TRpcTransport extends RpcTransport, TResponse>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n apiPlan: RpcApiRequestPlan<TResponse>,\n): PendingRpcRequest<TResponse> {\n return {\n async send(options?: RpcSendOptions): Promise<TResponse> {\n const { payload, responseTransformer } = apiPlan;\n const rawResponse = await rpcConfig.transport<TResponse>({ payload, signal: options?.abortSignal });\n return responseTransformer ? responseTransformer(rawResponse) : rawResponse;\n },\n };\n}\n","import { Callable, createRpcMessage } from '@solana/rpc-spec-types';\n\nimport { RpcRequestTransformer, RpcResponse, RpcResponseTransformer } from './rpc-shared';\n\nexport type RpcApiConfig = Readonly<{\n requestTransformer?: RpcRequestTransformer;\n responseTransformer?: RpcResponseTransformer;\n}>;\n\nexport type RpcApiRequestPlan<TResponse> = {\n payload: unknown;\n responseTransformer?: (response: RpcResponse) => RpcResponse<TResponse>;\n};\n\nexport type RpcApi<TRpcMethods> = {\n [MethodName in keyof TRpcMethods]: RpcReturnTypeMapper<TRpcMethods[MethodName]>;\n};\n\ntype RpcReturnTypeMapper<TRpcMethod> = TRpcMethod extends Callable\n ? (...rawParams: unknown[]) => RpcApiRequestPlan<ReturnType<TRpcMethod>>\n : never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RpcApiMethod = (...args: any) => any;\ninterface RpcApiMethods {\n [methodName: string]: RpcApiMethod;\n}\n\nexport function createJsonRpcApi<TRpcMethods extends RpcApiMethods>(config?: RpcApiConfig): RpcApi<TRpcMethods> {\n return new Proxy({} as RpcApi<TRpcMethods>, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get<TMethodName extends keyof RpcApi<TRpcMethods>>(\n ...args: Parameters<NonNullable<ProxyHandler<RpcApi<TRpcMethods>>['get']>>\n ) {\n const [_, p] = args;\n const methodName = p.toString() as keyof TRpcMethods as string;\n return function (\n ...rawParams: Parameters<\n TRpcMethods[TMethodName] extends CallableFunction ? TRpcMethods[TMethodName] : never\n >\n ): RpcApiRequestPlan<ReturnType<TRpcMethods[TMethodName]>> {\n const rawRequest = Object.freeze({ methodName, params: rawParams });\n const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;\n return Object.freeze({\n payload: createRpcMessage(request.methodName, request.params),\n ...(config?.responseTransformer\n ? {\n responseTransformer: (response: RpcResponse) => {\n const configTransformer = config.responseTransformer as RpcResponseTransformer<\n ReturnType<TRpcMethods[TMethodName]>\n >;\n return configTransformer(response, request);\n },\n }\n : {}),\n });\n };\n },\n });\n}\n","import { RpcResponse } from './rpc-shared';\n\ntype RpcTransportRequest = Readonly<{\n payload: unknown;\n signal?: AbortSignal;\n}>;\n\nexport type RpcTransport = {\n <TResponse>(request: RpcTransportRequest): Promise<RpcResponse<TResponse>>;\n};\n\nexport function isJsonRpcPayload(payload: unknown): payload is Readonly<{\n jsonrpc: '2.0';\n method: string;\n params: unknown;\n}> {\n if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n return false;\n }\n return (\n 'jsonrpc' in payload &&\n payload.jsonrpc === '2.0' &&\n 'method' in payload &&\n typeof payload.method === 'string' &&\n 'params' in payload\n );\n}\n"]}
@@ -0,0 +1,79 @@
1
+ import { SolanaError, SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD } from '@solana/errors';
2
+ import { createRpcMessage } from '@solana/rpc-spec-types';
3
+
4
+ // src/rpc.ts
5
+ function createRpc(rpcConfig) {
6
+ return makeProxy(rpcConfig);
7
+ }
8
+ function makeProxy(rpcConfig) {
9
+ return new Proxy(rpcConfig.api, {
10
+ defineProperty() {
11
+ return false;
12
+ },
13
+ deleteProperty() {
14
+ return false;
15
+ },
16
+ get(target, p, receiver) {
17
+ return function(...rawParams) {
18
+ const methodName = p.toString();
19
+ const getApiPlan = Reflect.get(target, methodName, receiver);
20
+ if (!getApiPlan) {
21
+ throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {
22
+ method: methodName,
23
+ params: rawParams
24
+ });
25
+ }
26
+ const apiPlan = getApiPlan(...rawParams);
27
+ return createPendingRpcRequest(rpcConfig, apiPlan);
28
+ };
29
+ }
30
+ });
31
+ }
32
+ function createPendingRpcRequest(rpcConfig, apiPlan) {
33
+ return {
34
+ async send(options) {
35
+ const { payload, responseTransformer } = apiPlan;
36
+ const rawResponse = await rpcConfig.transport({ payload, signal: options?.abortSignal });
37
+ return responseTransformer ? responseTransformer(rawResponse) : rawResponse;
38
+ }
39
+ };
40
+ }
41
+ function createJsonRpcApi(config) {
42
+ return new Proxy({}, {
43
+ defineProperty() {
44
+ return false;
45
+ },
46
+ deleteProperty() {
47
+ return false;
48
+ },
49
+ get(...args) {
50
+ const [_, p] = args;
51
+ const methodName = p.toString();
52
+ return function(...rawParams) {
53
+ const rawRequest = Object.freeze({ methodName, params: rawParams });
54
+ const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;
55
+ return Object.freeze({
56
+ payload: createRpcMessage(request.methodName, request.params),
57
+ ...config?.responseTransformer ? {
58
+ responseTransformer: (response) => {
59
+ const configTransformer = config.responseTransformer;
60
+ return configTransformer(response, request);
61
+ }
62
+ } : {}
63
+ });
64
+ };
65
+ }
66
+ });
67
+ }
68
+
69
+ // src/rpc-transport.ts
70
+ function isJsonRpcPayload(payload) {
71
+ if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
72
+ return false;
73
+ }
74
+ return "jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && typeof payload.method === "string" && "params" in payload;
75
+ }
76
+
77
+ export { createJsonRpcApi, createRpc, isJsonRpcPayload };
78
+ //# sourceMappingURL=index.browser.mjs.map
79
+ //# sourceMappingURL=index.browser.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rpc.ts","../src/rpc-api.ts","../src/rpc-transport.ts"],"names":[],"mappings":"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","file":"index.browser.mjs","sourcesContent":["import { SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, SolanaError } from '@solana/errors';\nimport { Callable, Flatten, OverloadImplementations, UnionToIntersection } from '@solana/rpc-spec-types';\n\nimport { RpcApi, RpcApiRequestPlan } from './rpc-api';\nimport { RpcTransport } from './rpc-transport';\n\nexport type RpcConfig<TRpcMethods, TRpcTransport extends RpcTransport> = Readonly<{\n api: RpcApi<TRpcMethods>;\n transport: TRpcTransport;\n}>;\n\nexport type Rpc<TRpcMethods> = {\n [TMethodName in keyof TRpcMethods]: PendingRpcRequestBuilder<OverloadImplementations<TRpcMethods, TMethodName>>;\n};\n\nexport type PendingRpcRequest<TResponse> = {\n send(options?: RpcSendOptions): Promise<TResponse>;\n};\n\nexport type RpcSendOptions = Readonly<{\n abortSignal?: AbortSignal;\n}>;\n\ntype PendingRpcRequestBuilder<TMethodImplementations> = UnionToIntersection<\n Flatten<{\n [P in keyof TMethodImplementations]: PendingRpcRequestReturnTypeMapper<TMethodImplementations[P]>;\n }>\n>;\n\ntype PendingRpcRequestReturnTypeMapper<TMethodImplementation> =\n // Check that this property of the TRpcMethods interface is, in fact, a function.\n TMethodImplementation extends Callable\n ? (...args: Parameters<TMethodImplementation>) => PendingRpcRequest<ReturnType<TMethodImplementation>>\n : never;\n\nexport function createRpc<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return makeProxy(rpcConfig) as Rpc<TRpcMethods>;\n}\n\nfunction makeProxy<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return new Proxy(rpcConfig.api, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get(target, p, receiver) {\n return function (...rawParams: unknown[]) {\n const methodName = p.toString();\n const getApiPlan = Reflect.get(target, methodName, receiver);\n if (!getApiPlan) {\n throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {\n method: methodName,\n params: rawParams,\n });\n }\n const apiPlan = getApiPlan(...rawParams);\n return createPendingRpcRequest(rpcConfig, apiPlan);\n };\n },\n }) as Rpc<TRpcMethods>;\n}\n\nfunction createPendingRpcRequest<TRpcMethods, TRpcTransport extends RpcTransport, TResponse>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n apiPlan: RpcApiRequestPlan<TResponse>,\n): PendingRpcRequest<TResponse> {\n return {\n async send(options?: RpcSendOptions): Promise<TResponse> {\n const { payload, responseTransformer } = apiPlan;\n const rawResponse = await rpcConfig.transport<TResponse>({ payload, signal: options?.abortSignal });\n return responseTransformer ? responseTransformer(rawResponse) : rawResponse;\n },\n };\n}\n","import { Callable, createRpcMessage } from '@solana/rpc-spec-types';\n\nimport { RpcRequestTransformer, RpcResponse, RpcResponseTransformer } from './rpc-shared';\n\nexport type RpcApiConfig = Readonly<{\n requestTransformer?: RpcRequestTransformer;\n responseTransformer?: RpcResponseTransformer;\n}>;\n\nexport type RpcApiRequestPlan<TResponse> = {\n payload: unknown;\n responseTransformer?: (response: RpcResponse) => RpcResponse<TResponse>;\n};\n\nexport type RpcApi<TRpcMethods> = {\n [MethodName in keyof TRpcMethods]: RpcReturnTypeMapper<TRpcMethods[MethodName]>;\n};\n\ntype RpcReturnTypeMapper<TRpcMethod> = TRpcMethod extends Callable\n ? (...rawParams: unknown[]) => RpcApiRequestPlan<ReturnType<TRpcMethod>>\n : never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RpcApiMethod = (...args: any) => any;\ninterface RpcApiMethods {\n [methodName: string]: RpcApiMethod;\n}\n\nexport function createJsonRpcApi<TRpcMethods extends RpcApiMethods>(config?: RpcApiConfig): RpcApi<TRpcMethods> {\n return new Proxy({} as RpcApi<TRpcMethods>, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get<TMethodName extends keyof RpcApi<TRpcMethods>>(\n ...args: Parameters<NonNullable<ProxyHandler<RpcApi<TRpcMethods>>['get']>>\n ) {\n const [_, p] = args;\n const methodName = p.toString() as keyof TRpcMethods as string;\n return function (\n ...rawParams: Parameters<\n TRpcMethods[TMethodName] extends CallableFunction ? TRpcMethods[TMethodName] : never\n >\n ): RpcApiRequestPlan<ReturnType<TRpcMethods[TMethodName]>> {\n const rawRequest = Object.freeze({ methodName, params: rawParams });\n const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;\n return Object.freeze({\n payload: createRpcMessage(request.methodName, request.params),\n ...(config?.responseTransformer\n ? {\n responseTransformer: (response: RpcResponse) => {\n const configTransformer = config.responseTransformer as RpcResponseTransformer<\n ReturnType<TRpcMethods[TMethodName]>\n >;\n return configTransformer(response, request);\n },\n }\n : {}),\n });\n };\n },\n });\n}\n","import { RpcResponse } from './rpc-shared';\n\ntype RpcTransportRequest = Readonly<{\n payload: unknown;\n signal?: AbortSignal;\n}>;\n\nexport type RpcTransport = {\n <TResponse>(request: RpcTransportRequest): Promise<RpcResponse<TResponse>>;\n};\n\nexport function isJsonRpcPayload(payload: unknown): payload is Readonly<{\n jsonrpc: '2.0';\n method: string;\n params: unknown;\n}> {\n if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n return false;\n }\n return (\n 'jsonrpc' in payload &&\n payload.jsonrpc === '2.0' &&\n 'method' in payload &&\n typeof payload.method === 'string' &&\n 'params' in payload\n );\n}\n"]}
@@ -0,0 +1,79 @@
1
+ import { SolanaError, SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD } from '@solana/errors';
2
+ import { createRpcMessage } from '@solana/rpc-spec-types';
3
+
4
+ // src/rpc.ts
5
+ function createRpc(rpcConfig) {
6
+ return makeProxy(rpcConfig);
7
+ }
8
+ function makeProxy(rpcConfig) {
9
+ return new Proxy(rpcConfig.api, {
10
+ defineProperty() {
11
+ return false;
12
+ },
13
+ deleteProperty() {
14
+ return false;
15
+ },
16
+ get(target, p, receiver) {
17
+ return function(...rawParams) {
18
+ const methodName = p.toString();
19
+ const getApiPlan = Reflect.get(target, methodName, receiver);
20
+ if (!getApiPlan) {
21
+ throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {
22
+ method: methodName,
23
+ params: rawParams
24
+ });
25
+ }
26
+ const apiPlan = getApiPlan(...rawParams);
27
+ return createPendingRpcRequest(rpcConfig, apiPlan);
28
+ };
29
+ }
30
+ });
31
+ }
32
+ function createPendingRpcRequest(rpcConfig, apiPlan) {
33
+ return {
34
+ async send(options) {
35
+ const { payload, responseTransformer } = apiPlan;
36
+ const rawResponse = await rpcConfig.transport({ payload, signal: options?.abortSignal });
37
+ return responseTransformer ? responseTransformer(rawResponse) : rawResponse;
38
+ }
39
+ };
40
+ }
41
+ function createJsonRpcApi(config) {
42
+ return new Proxy({}, {
43
+ defineProperty() {
44
+ return false;
45
+ },
46
+ deleteProperty() {
47
+ return false;
48
+ },
49
+ get(...args) {
50
+ const [_, p] = args;
51
+ const methodName = p.toString();
52
+ return function(...rawParams) {
53
+ const rawRequest = Object.freeze({ methodName, params: rawParams });
54
+ const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;
55
+ return Object.freeze({
56
+ payload: createRpcMessage(request.methodName, request.params),
57
+ ...config?.responseTransformer ? {
58
+ responseTransformer: (response) => {
59
+ const configTransformer = config.responseTransformer;
60
+ return configTransformer(response, request);
61
+ }
62
+ } : {}
63
+ });
64
+ };
65
+ }
66
+ });
67
+ }
68
+
69
+ // src/rpc-transport.ts
70
+ function isJsonRpcPayload(payload) {
71
+ if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
72
+ return false;
73
+ }
74
+ return "jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && typeof payload.method === "string" && "params" in payload;
75
+ }
76
+
77
+ export { createJsonRpcApi, createRpc, isJsonRpcPayload };
78
+ //# sourceMappingURL=index.native.mjs.map
79
+ //# sourceMappingURL=index.native.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rpc.ts","../src/rpc-api.ts","../src/rpc-transport.ts"],"names":[],"mappings":"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","file":"index.native.mjs","sourcesContent":["import { SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, SolanaError } from '@solana/errors';\nimport { Callable, Flatten, OverloadImplementations, UnionToIntersection } from '@solana/rpc-spec-types';\n\nimport { RpcApi, RpcApiRequestPlan } from './rpc-api';\nimport { RpcTransport } from './rpc-transport';\n\nexport type RpcConfig<TRpcMethods, TRpcTransport extends RpcTransport> = Readonly<{\n api: RpcApi<TRpcMethods>;\n transport: TRpcTransport;\n}>;\n\nexport type Rpc<TRpcMethods> = {\n [TMethodName in keyof TRpcMethods]: PendingRpcRequestBuilder<OverloadImplementations<TRpcMethods, TMethodName>>;\n};\n\nexport type PendingRpcRequest<TResponse> = {\n send(options?: RpcSendOptions): Promise<TResponse>;\n};\n\nexport type RpcSendOptions = Readonly<{\n abortSignal?: AbortSignal;\n}>;\n\ntype PendingRpcRequestBuilder<TMethodImplementations> = UnionToIntersection<\n Flatten<{\n [P in keyof TMethodImplementations]: PendingRpcRequestReturnTypeMapper<TMethodImplementations[P]>;\n }>\n>;\n\ntype PendingRpcRequestReturnTypeMapper<TMethodImplementation> =\n // Check that this property of the TRpcMethods interface is, in fact, a function.\n TMethodImplementation extends Callable\n ? (...args: Parameters<TMethodImplementation>) => PendingRpcRequest<ReturnType<TMethodImplementation>>\n : never;\n\nexport function createRpc<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return makeProxy(rpcConfig) as Rpc<TRpcMethods>;\n}\n\nfunction makeProxy<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return new Proxy(rpcConfig.api, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get(target, p, receiver) {\n return function (...rawParams: unknown[]) {\n const methodName = p.toString();\n const getApiPlan = Reflect.get(target, methodName, receiver);\n if (!getApiPlan) {\n throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {\n method: methodName,\n params: rawParams,\n });\n }\n const apiPlan = getApiPlan(...rawParams);\n return createPendingRpcRequest(rpcConfig, apiPlan);\n };\n },\n }) as Rpc<TRpcMethods>;\n}\n\nfunction createPendingRpcRequest<TRpcMethods, TRpcTransport extends RpcTransport, TResponse>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n apiPlan: RpcApiRequestPlan<TResponse>,\n): PendingRpcRequest<TResponse> {\n return {\n async send(options?: RpcSendOptions): Promise<TResponse> {\n const { payload, responseTransformer } = apiPlan;\n const rawResponse = await rpcConfig.transport<TResponse>({ payload, signal: options?.abortSignal });\n return responseTransformer ? responseTransformer(rawResponse) : rawResponse;\n },\n };\n}\n","import { Callable, createRpcMessage } from '@solana/rpc-spec-types';\n\nimport { RpcRequestTransformer, RpcResponse, RpcResponseTransformer } from './rpc-shared';\n\nexport type RpcApiConfig = Readonly<{\n requestTransformer?: RpcRequestTransformer;\n responseTransformer?: RpcResponseTransformer;\n}>;\n\nexport type RpcApiRequestPlan<TResponse> = {\n payload: unknown;\n responseTransformer?: (response: RpcResponse) => RpcResponse<TResponse>;\n};\n\nexport type RpcApi<TRpcMethods> = {\n [MethodName in keyof TRpcMethods]: RpcReturnTypeMapper<TRpcMethods[MethodName]>;\n};\n\ntype RpcReturnTypeMapper<TRpcMethod> = TRpcMethod extends Callable\n ? (...rawParams: unknown[]) => RpcApiRequestPlan<ReturnType<TRpcMethod>>\n : never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RpcApiMethod = (...args: any) => any;\ninterface RpcApiMethods {\n [methodName: string]: RpcApiMethod;\n}\n\nexport function createJsonRpcApi<TRpcMethods extends RpcApiMethods>(config?: RpcApiConfig): RpcApi<TRpcMethods> {\n return new Proxy({} as RpcApi<TRpcMethods>, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get<TMethodName extends keyof RpcApi<TRpcMethods>>(\n ...args: Parameters<NonNullable<ProxyHandler<RpcApi<TRpcMethods>>['get']>>\n ) {\n const [_, p] = args;\n const methodName = p.toString() as keyof TRpcMethods as string;\n return function (\n ...rawParams: Parameters<\n TRpcMethods[TMethodName] extends CallableFunction ? TRpcMethods[TMethodName] : never\n >\n ): RpcApiRequestPlan<ReturnType<TRpcMethods[TMethodName]>> {\n const rawRequest = Object.freeze({ methodName, params: rawParams });\n const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;\n return Object.freeze({\n payload: createRpcMessage(request.methodName, request.params),\n ...(config?.responseTransformer\n ? {\n responseTransformer: (response: RpcResponse) => {\n const configTransformer = config.responseTransformer as RpcResponseTransformer<\n ReturnType<TRpcMethods[TMethodName]>\n >;\n return configTransformer(response, request);\n },\n }\n : {}),\n });\n };\n },\n });\n}\n","import { RpcResponse } from './rpc-shared';\n\ntype RpcTransportRequest = Readonly<{\n payload: unknown;\n signal?: AbortSignal;\n}>;\n\nexport type RpcTransport = {\n <TResponse>(request: RpcTransportRequest): Promise<RpcResponse<TResponse>>;\n};\n\nexport function isJsonRpcPayload(payload: unknown): payload is Readonly<{\n jsonrpc: '2.0';\n method: string;\n params: unknown;\n}> {\n if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n return false;\n }\n return (\n 'jsonrpc' in payload &&\n payload.jsonrpc === '2.0' &&\n 'method' in payload &&\n typeof payload.method === 'string' &&\n 'params' in payload\n );\n}\n"]}
@@ -0,0 +1,83 @@
1
+ 'use strict';
2
+
3
+ var errors = require('@solana/errors');
4
+ var rpcSpecTypes = require('@solana/rpc-spec-types');
5
+
6
+ // src/rpc.ts
7
+ function createRpc(rpcConfig) {
8
+ return makeProxy(rpcConfig);
9
+ }
10
+ function makeProxy(rpcConfig) {
11
+ return new Proxy(rpcConfig.api, {
12
+ defineProperty() {
13
+ return false;
14
+ },
15
+ deleteProperty() {
16
+ return false;
17
+ },
18
+ get(target, p, receiver) {
19
+ return function(...rawParams) {
20
+ const methodName = p.toString();
21
+ const getApiPlan = Reflect.get(target, methodName, receiver);
22
+ if (!getApiPlan) {
23
+ throw new errors.SolanaError(errors.SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {
24
+ method: methodName,
25
+ params: rawParams
26
+ });
27
+ }
28
+ const apiPlan = getApiPlan(...rawParams);
29
+ return createPendingRpcRequest(rpcConfig, apiPlan);
30
+ };
31
+ }
32
+ });
33
+ }
34
+ function createPendingRpcRequest(rpcConfig, apiPlan) {
35
+ return {
36
+ async send(options) {
37
+ const { payload, responseTransformer } = apiPlan;
38
+ const rawResponse = await rpcConfig.transport({ payload, signal: options?.abortSignal });
39
+ return responseTransformer ? responseTransformer(rawResponse) : rawResponse;
40
+ }
41
+ };
42
+ }
43
+ function createJsonRpcApi(config) {
44
+ return new Proxy({}, {
45
+ defineProperty() {
46
+ return false;
47
+ },
48
+ deleteProperty() {
49
+ return false;
50
+ },
51
+ get(...args) {
52
+ const [_, p] = args;
53
+ const methodName = p.toString();
54
+ return function(...rawParams) {
55
+ const rawRequest = Object.freeze({ methodName, params: rawParams });
56
+ const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;
57
+ return Object.freeze({
58
+ payload: rpcSpecTypes.createRpcMessage(request.methodName, request.params),
59
+ ...config?.responseTransformer ? {
60
+ responseTransformer: (response) => {
61
+ const configTransformer = config.responseTransformer;
62
+ return configTransformer(response, request);
63
+ }
64
+ } : {}
65
+ });
66
+ };
67
+ }
68
+ });
69
+ }
70
+
71
+ // src/rpc-transport.ts
72
+ function isJsonRpcPayload(payload) {
73
+ if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
74
+ return false;
75
+ }
76
+ return "jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && typeof payload.method === "string" && "params" in payload;
77
+ }
78
+
79
+ exports.createJsonRpcApi = createJsonRpcApi;
80
+ exports.createRpc = createRpc;
81
+ exports.isJsonRpcPayload = isJsonRpcPayload;
82
+ //# sourceMappingURL=index.node.cjs.map
83
+ //# sourceMappingURL=index.node.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rpc.ts","../src/rpc-api.ts","../src/rpc-transport.ts"],"names":["SolanaError","SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD","createRpcMessage"],"mappings":"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","file":"index.node.cjs","sourcesContent":["import { SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, SolanaError } from '@solana/errors';\nimport { Callable, Flatten, OverloadImplementations, UnionToIntersection } from '@solana/rpc-spec-types';\n\nimport { RpcApi, RpcApiRequestPlan } from './rpc-api';\nimport { RpcTransport } from './rpc-transport';\n\nexport type RpcConfig<TRpcMethods, TRpcTransport extends RpcTransport> = Readonly<{\n api: RpcApi<TRpcMethods>;\n transport: TRpcTransport;\n}>;\n\nexport type Rpc<TRpcMethods> = {\n [TMethodName in keyof TRpcMethods]: PendingRpcRequestBuilder<OverloadImplementations<TRpcMethods, TMethodName>>;\n};\n\nexport type PendingRpcRequest<TResponse> = {\n send(options?: RpcSendOptions): Promise<TResponse>;\n};\n\nexport type RpcSendOptions = Readonly<{\n abortSignal?: AbortSignal;\n}>;\n\ntype PendingRpcRequestBuilder<TMethodImplementations> = UnionToIntersection<\n Flatten<{\n [P in keyof TMethodImplementations]: PendingRpcRequestReturnTypeMapper<TMethodImplementations[P]>;\n }>\n>;\n\ntype PendingRpcRequestReturnTypeMapper<TMethodImplementation> =\n // Check that this property of the TRpcMethods interface is, in fact, a function.\n TMethodImplementation extends Callable\n ? (...args: Parameters<TMethodImplementation>) => PendingRpcRequest<ReturnType<TMethodImplementation>>\n : never;\n\nexport function createRpc<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return makeProxy(rpcConfig) as Rpc<TRpcMethods>;\n}\n\nfunction makeProxy<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return new Proxy(rpcConfig.api, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get(target, p, receiver) {\n return function (...rawParams: unknown[]) {\n const methodName = p.toString();\n const getApiPlan = Reflect.get(target, methodName, receiver);\n if (!getApiPlan) {\n throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {\n method: methodName,\n params: rawParams,\n });\n }\n const apiPlan = getApiPlan(...rawParams);\n return createPendingRpcRequest(rpcConfig, apiPlan);\n };\n },\n }) as Rpc<TRpcMethods>;\n}\n\nfunction createPendingRpcRequest<TRpcMethods, TRpcTransport extends RpcTransport, TResponse>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n apiPlan: RpcApiRequestPlan<TResponse>,\n): PendingRpcRequest<TResponse> {\n return {\n async send(options?: RpcSendOptions): Promise<TResponse> {\n const { payload, responseTransformer } = apiPlan;\n const rawResponse = await rpcConfig.transport<TResponse>({ payload, signal: options?.abortSignal });\n return responseTransformer ? responseTransformer(rawResponse) : rawResponse;\n },\n };\n}\n","import { Callable, createRpcMessage } from '@solana/rpc-spec-types';\n\nimport { RpcRequestTransformer, RpcResponse, RpcResponseTransformer } from './rpc-shared';\n\nexport type RpcApiConfig = Readonly<{\n requestTransformer?: RpcRequestTransformer;\n responseTransformer?: RpcResponseTransformer;\n}>;\n\nexport type RpcApiRequestPlan<TResponse> = {\n payload: unknown;\n responseTransformer?: (response: RpcResponse) => RpcResponse<TResponse>;\n};\n\nexport type RpcApi<TRpcMethods> = {\n [MethodName in keyof TRpcMethods]: RpcReturnTypeMapper<TRpcMethods[MethodName]>;\n};\n\ntype RpcReturnTypeMapper<TRpcMethod> = TRpcMethod extends Callable\n ? (...rawParams: unknown[]) => RpcApiRequestPlan<ReturnType<TRpcMethod>>\n : never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RpcApiMethod = (...args: any) => any;\ninterface RpcApiMethods {\n [methodName: string]: RpcApiMethod;\n}\n\nexport function createJsonRpcApi<TRpcMethods extends RpcApiMethods>(config?: RpcApiConfig): RpcApi<TRpcMethods> {\n return new Proxy({} as RpcApi<TRpcMethods>, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get<TMethodName extends keyof RpcApi<TRpcMethods>>(\n ...args: Parameters<NonNullable<ProxyHandler<RpcApi<TRpcMethods>>['get']>>\n ) {\n const [_, p] = args;\n const methodName = p.toString() as keyof TRpcMethods as string;\n return function (\n ...rawParams: Parameters<\n TRpcMethods[TMethodName] extends CallableFunction ? TRpcMethods[TMethodName] : never\n >\n ): RpcApiRequestPlan<ReturnType<TRpcMethods[TMethodName]>> {\n const rawRequest = Object.freeze({ methodName, params: rawParams });\n const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;\n return Object.freeze({\n payload: createRpcMessage(request.methodName, request.params),\n ...(config?.responseTransformer\n ? {\n responseTransformer: (response: RpcResponse) => {\n const configTransformer = config.responseTransformer as RpcResponseTransformer<\n ReturnType<TRpcMethods[TMethodName]>\n >;\n return configTransformer(response, request);\n },\n }\n : {}),\n });\n };\n },\n });\n}\n","import { RpcResponse } from './rpc-shared';\n\ntype RpcTransportRequest = Readonly<{\n payload: unknown;\n signal?: AbortSignal;\n}>;\n\nexport type RpcTransport = {\n <TResponse>(request: RpcTransportRequest): Promise<RpcResponse<TResponse>>;\n};\n\nexport function isJsonRpcPayload(payload: unknown): payload is Readonly<{\n jsonrpc: '2.0';\n method: string;\n params: unknown;\n}> {\n if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n return false;\n }\n return (\n 'jsonrpc' in payload &&\n payload.jsonrpc === '2.0' &&\n 'method' in payload &&\n typeof payload.method === 'string' &&\n 'params' in payload\n );\n}\n"]}
@@ -0,0 +1,79 @@
1
+ import { SolanaError, SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD } from '@solana/errors';
2
+ import { createRpcMessage } from '@solana/rpc-spec-types';
3
+
4
+ // src/rpc.ts
5
+ function createRpc(rpcConfig) {
6
+ return makeProxy(rpcConfig);
7
+ }
8
+ function makeProxy(rpcConfig) {
9
+ return new Proxy(rpcConfig.api, {
10
+ defineProperty() {
11
+ return false;
12
+ },
13
+ deleteProperty() {
14
+ return false;
15
+ },
16
+ get(target, p, receiver) {
17
+ return function(...rawParams) {
18
+ const methodName = p.toString();
19
+ const getApiPlan = Reflect.get(target, methodName, receiver);
20
+ if (!getApiPlan) {
21
+ throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {
22
+ method: methodName,
23
+ params: rawParams
24
+ });
25
+ }
26
+ const apiPlan = getApiPlan(...rawParams);
27
+ return createPendingRpcRequest(rpcConfig, apiPlan);
28
+ };
29
+ }
30
+ });
31
+ }
32
+ function createPendingRpcRequest(rpcConfig, apiPlan) {
33
+ return {
34
+ async send(options) {
35
+ const { payload, responseTransformer } = apiPlan;
36
+ const rawResponse = await rpcConfig.transport({ payload, signal: options?.abortSignal });
37
+ return responseTransformer ? responseTransformer(rawResponse) : rawResponse;
38
+ }
39
+ };
40
+ }
41
+ function createJsonRpcApi(config) {
42
+ return new Proxy({}, {
43
+ defineProperty() {
44
+ return false;
45
+ },
46
+ deleteProperty() {
47
+ return false;
48
+ },
49
+ get(...args) {
50
+ const [_, p] = args;
51
+ const methodName = p.toString();
52
+ return function(...rawParams) {
53
+ const rawRequest = Object.freeze({ methodName, params: rawParams });
54
+ const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;
55
+ return Object.freeze({
56
+ payload: createRpcMessage(request.methodName, request.params),
57
+ ...config?.responseTransformer ? {
58
+ responseTransformer: (response) => {
59
+ const configTransformer = config.responseTransformer;
60
+ return configTransformer(response, request);
61
+ }
62
+ } : {}
63
+ });
64
+ };
65
+ }
66
+ });
67
+ }
68
+
69
+ // src/rpc-transport.ts
70
+ function isJsonRpcPayload(payload) {
71
+ if (payload == null || typeof payload !== "object" || Array.isArray(payload)) {
72
+ return false;
73
+ }
74
+ return "jsonrpc" in payload && payload.jsonrpc === "2.0" && "method" in payload && typeof payload.method === "string" && "params" in payload;
75
+ }
76
+
77
+ export { createJsonRpcApi, createRpc, isJsonRpcPayload };
78
+ //# sourceMappingURL=index.node.mjs.map
79
+ //# sourceMappingURL=index.node.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rpc.ts","../src/rpc-api.ts","../src/rpc-transport.ts"],"names":[],"mappings":"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","file":"index.node.mjs","sourcesContent":["import { SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, SolanaError } from '@solana/errors';\nimport { Callable, Flatten, OverloadImplementations, UnionToIntersection } from '@solana/rpc-spec-types';\n\nimport { RpcApi, RpcApiRequestPlan } from './rpc-api';\nimport { RpcTransport } from './rpc-transport';\n\nexport type RpcConfig<TRpcMethods, TRpcTransport extends RpcTransport> = Readonly<{\n api: RpcApi<TRpcMethods>;\n transport: TRpcTransport;\n}>;\n\nexport type Rpc<TRpcMethods> = {\n [TMethodName in keyof TRpcMethods]: PendingRpcRequestBuilder<OverloadImplementations<TRpcMethods, TMethodName>>;\n};\n\nexport type PendingRpcRequest<TResponse> = {\n send(options?: RpcSendOptions): Promise<TResponse>;\n};\n\nexport type RpcSendOptions = Readonly<{\n abortSignal?: AbortSignal;\n}>;\n\ntype PendingRpcRequestBuilder<TMethodImplementations> = UnionToIntersection<\n Flatten<{\n [P in keyof TMethodImplementations]: PendingRpcRequestReturnTypeMapper<TMethodImplementations[P]>;\n }>\n>;\n\ntype PendingRpcRequestReturnTypeMapper<TMethodImplementation> =\n // Check that this property of the TRpcMethods interface is, in fact, a function.\n TMethodImplementation extends Callable\n ? (...args: Parameters<TMethodImplementation>) => PendingRpcRequest<ReturnType<TMethodImplementation>>\n : never;\n\nexport function createRpc<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return makeProxy(rpcConfig) as Rpc<TRpcMethods>;\n}\n\nfunction makeProxy<TRpcMethods, TRpcTransport extends RpcTransport>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n): Rpc<TRpcMethods> {\n return new Proxy(rpcConfig.api, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get(target, p, receiver) {\n return function (...rawParams: unknown[]) {\n const methodName = p.toString();\n const getApiPlan = Reflect.get(target, methodName, receiver);\n if (!getApiPlan) {\n throw new SolanaError(SOLANA_ERROR__RPC__API_PLAN_MISSING_FOR_RPC_METHOD, {\n method: methodName,\n params: rawParams,\n });\n }\n const apiPlan = getApiPlan(...rawParams);\n return createPendingRpcRequest(rpcConfig, apiPlan);\n };\n },\n }) as Rpc<TRpcMethods>;\n}\n\nfunction createPendingRpcRequest<TRpcMethods, TRpcTransport extends RpcTransport, TResponse>(\n rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>,\n apiPlan: RpcApiRequestPlan<TResponse>,\n): PendingRpcRequest<TResponse> {\n return {\n async send(options?: RpcSendOptions): Promise<TResponse> {\n const { payload, responseTransformer } = apiPlan;\n const rawResponse = await rpcConfig.transport<TResponse>({ payload, signal: options?.abortSignal });\n return responseTransformer ? responseTransformer(rawResponse) : rawResponse;\n },\n };\n}\n","import { Callable, createRpcMessage } from '@solana/rpc-spec-types';\n\nimport { RpcRequestTransformer, RpcResponse, RpcResponseTransformer } from './rpc-shared';\n\nexport type RpcApiConfig = Readonly<{\n requestTransformer?: RpcRequestTransformer;\n responseTransformer?: RpcResponseTransformer;\n}>;\n\nexport type RpcApiRequestPlan<TResponse> = {\n payload: unknown;\n responseTransformer?: (response: RpcResponse) => RpcResponse<TResponse>;\n};\n\nexport type RpcApi<TRpcMethods> = {\n [MethodName in keyof TRpcMethods]: RpcReturnTypeMapper<TRpcMethods[MethodName]>;\n};\n\ntype RpcReturnTypeMapper<TRpcMethod> = TRpcMethod extends Callable\n ? (...rawParams: unknown[]) => RpcApiRequestPlan<ReturnType<TRpcMethod>>\n : never;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RpcApiMethod = (...args: any) => any;\ninterface RpcApiMethods {\n [methodName: string]: RpcApiMethod;\n}\n\nexport function createJsonRpcApi<TRpcMethods extends RpcApiMethods>(config?: RpcApiConfig): RpcApi<TRpcMethods> {\n return new Proxy({} as RpcApi<TRpcMethods>, {\n defineProperty() {\n return false;\n },\n deleteProperty() {\n return false;\n },\n get<TMethodName extends keyof RpcApi<TRpcMethods>>(\n ...args: Parameters<NonNullable<ProxyHandler<RpcApi<TRpcMethods>>['get']>>\n ) {\n const [_, p] = args;\n const methodName = p.toString() as keyof TRpcMethods as string;\n return function (\n ...rawParams: Parameters<\n TRpcMethods[TMethodName] extends CallableFunction ? TRpcMethods[TMethodName] : never\n >\n ): RpcApiRequestPlan<ReturnType<TRpcMethods[TMethodName]>> {\n const rawRequest = Object.freeze({ methodName, params: rawParams });\n const request = config?.requestTransformer ? config?.requestTransformer(rawRequest) : rawRequest;\n return Object.freeze({\n payload: createRpcMessage(request.methodName, request.params),\n ...(config?.responseTransformer\n ? {\n responseTransformer: (response: RpcResponse) => {\n const configTransformer = config.responseTransformer as RpcResponseTransformer<\n ReturnType<TRpcMethods[TMethodName]>\n >;\n return configTransformer(response, request);\n },\n }\n : {}),\n });\n };\n },\n });\n}\n","import { RpcResponse } from './rpc-shared';\n\ntype RpcTransportRequest = Readonly<{\n payload: unknown;\n signal?: AbortSignal;\n}>;\n\nexport type RpcTransport = {\n <TResponse>(request: RpcTransportRequest): Promise<RpcResponse<TResponse>>;\n};\n\nexport function isJsonRpcPayload(payload: unknown): payload is Readonly<{\n jsonrpc: '2.0';\n method: string;\n params: unknown;\n}> {\n if (payload == null || typeof payload !== 'object' || Array.isArray(payload)) {\n return false;\n }\n return (\n 'jsonrpc' in payload &&\n payload.jsonrpc === '2.0' &&\n 'method' in payload &&\n typeof payload.method === 'string' &&\n 'params' in payload\n );\n}\n"]}
@@ -0,0 +1,5 @@
1
+ export * from './rpc';
2
+ export * from './rpc-api';
3
+ export * from './rpc-shared';
4
+ export * from './rpc-transport';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
@@ -0,0 +1,21 @@
1
+ import { Callable } from '@solana/rpc-spec-types';
2
+ import { RpcRequestTransformer, RpcResponse, RpcResponseTransformer } from './rpc-shared';
3
+ export type RpcApiConfig = Readonly<{
4
+ requestTransformer?: RpcRequestTransformer;
5
+ responseTransformer?: RpcResponseTransformer;
6
+ }>;
7
+ export type RpcApiRequestPlan<TResponse> = {
8
+ payload: unknown;
9
+ responseTransformer?: (response: RpcResponse) => RpcResponse<TResponse>;
10
+ };
11
+ export type RpcApi<TRpcMethods> = {
12
+ [MethodName in keyof TRpcMethods]: RpcReturnTypeMapper<TRpcMethods[MethodName]>;
13
+ };
14
+ type RpcReturnTypeMapper<TRpcMethod> = TRpcMethod extends Callable ? (...rawParams: unknown[]) => RpcApiRequestPlan<ReturnType<TRpcMethod>> : never;
15
+ type RpcApiMethod = (...args: any) => any;
16
+ interface RpcApiMethods {
17
+ [methodName: string]: RpcApiMethod;
18
+ }
19
+ export declare function createJsonRpcApi<TRpcMethods extends RpcApiMethods>(config?: RpcApiConfig): RpcApi<TRpcMethods>;
20
+ export {};
21
+ //# sourceMappingURL=rpc-api.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpc-api.d.ts","sourceRoot":"","sources":["../../src/rpc-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE1F,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAChC,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAAC,SAAS,IAAI;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,WAAW,CAAC,SAAS,CAAC,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,WAAW,IAAI;KAC7B,UAAU,IAAI,MAAM,WAAW,GAAG,mBAAmB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;CAClF,CAAC;AAEF,KAAK,mBAAmB,CAAC,UAAU,IAAI,UAAU,SAAS,QAAQ,GAC5D,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,KAAK,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GACtE,KAAK,CAAC;AAGZ,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;AAC1C,UAAU,aAAa;IACnB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC;CACtC;AAED,wBAAgB,gBAAgB,CAAC,WAAW,SAAS,aAAa,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAoC9G"}
@@ -0,0 +1,12 @@
1
+ export type RpcRequest<TParams = unknown> = {
2
+ readonly methodName: string;
3
+ readonly params: TParams;
4
+ };
5
+ export type RpcResponse<TResponse = unknown> = TResponse;
6
+ export type RpcRequestTransformer = {
7
+ <TParams>(request: RpcRequest<TParams>): RpcRequest;
8
+ };
9
+ export type RpcResponseTransformer<TResponse = unknown> = {
10
+ (response: RpcResponse, request: RpcRequest): RpcResponse<TResponse>;
11
+ };
12
+ //# sourceMappingURL=rpc-shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpc-shared.d.ts","sourceRoot":"","sources":["../../src/rpc-shared.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,OAAO,GAAG,OAAO,IAAI;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,SAAS,GAAG,OAAO,IAAI,SAAS,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAAG;IAChC,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,SAAS,GAAG,OAAO,IAAI;IACtD,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;CACxE,CAAC"}
@@ -0,0 +1,15 @@
1
+ import { RpcResponse } from './rpc-shared';
2
+ type RpcTransportRequest = Readonly<{
3
+ payload: unknown;
4
+ signal?: AbortSignal;
5
+ }>;
6
+ export type RpcTransport = {
7
+ <TResponse>(request: RpcTransportRequest): Promise<RpcResponse<TResponse>>;
8
+ };
9
+ export declare function isJsonRpcPayload(payload: unknown): payload is Readonly<{
10
+ jsonrpc: '2.0';
11
+ method: string;
12
+ params: unknown;
13
+ }>;
14
+ export {};
15
+ //# sourceMappingURL=rpc-transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpc-transport.d.ts","sourceRoot":"","sources":["../../src/rpc-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,KAAK,mBAAmB,GAAG,QAAQ,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG;IACvB,CAAC,SAAS,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;CAC9E,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,CAAC;IACpE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC,CAWD"}
@@ -0,0 +1,23 @@
1
+ import { Callable, Flatten, OverloadImplementations, UnionToIntersection } from '@solana/rpc-spec-types';
2
+ import { RpcApi } from './rpc-api';
3
+ import { RpcTransport } from './rpc-transport';
4
+ export type RpcConfig<TRpcMethods, TRpcTransport extends RpcTransport> = Readonly<{
5
+ api: RpcApi<TRpcMethods>;
6
+ transport: TRpcTransport;
7
+ }>;
8
+ export type Rpc<TRpcMethods> = {
9
+ [TMethodName in keyof TRpcMethods]: PendingRpcRequestBuilder<OverloadImplementations<TRpcMethods, TMethodName>>;
10
+ };
11
+ export type PendingRpcRequest<TResponse> = {
12
+ send(options?: RpcSendOptions): Promise<TResponse>;
13
+ };
14
+ export type RpcSendOptions = Readonly<{
15
+ abortSignal?: AbortSignal;
16
+ }>;
17
+ type PendingRpcRequestBuilder<TMethodImplementations> = UnionToIntersection<Flatten<{
18
+ [P in keyof TMethodImplementations]: PendingRpcRequestReturnTypeMapper<TMethodImplementations[P]>;
19
+ }>>;
20
+ type PendingRpcRequestReturnTypeMapper<TMethodImplementation> = TMethodImplementation extends Callable ? (...args: Parameters<TMethodImplementation>) => PendingRpcRequest<ReturnType<TMethodImplementation>> : never;
21
+ export declare function createRpc<TRpcMethods, TRpcTransport extends RpcTransport>(rpcConfig: RpcConfig<TRpcMethods, TRpcTransport>): Rpc<TRpcMethods>;
22
+ export {};
23
+ //# sourceMappingURL=rpc.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEzG,OAAO,EAAE,MAAM,EAAqB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,MAAM,SAAS,CAAC,WAAW,EAAE,aAAa,SAAS,YAAY,IAAI,QAAQ,CAAC;IAC9E,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,WAAW,IAAI;KAC1B,WAAW,IAAI,MAAM,WAAW,GAAG,wBAAwB,CAAC,uBAAuB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;CAClH,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,SAAS,IAAI;IACvC,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC,CAAC;AAEH,KAAK,wBAAwB,CAAC,sBAAsB,IAAI,mBAAmB,CACvE,OAAO,CAAC;KACH,CAAC,IAAI,MAAM,sBAAsB,GAAG,iCAAiC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;CACpG,CAAC,CACL,CAAC;AAEF,KAAK,iCAAiC,CAAC,qBAAqB,IAExD,qBAAqB,SAAS,QAAQ,GAChC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,KAAK,iBAAiB,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC,GACpG,KAAK,CAAC;AAEhB,wBAAgB,SAAS,CAAC,WAAW,EAAE,aAAa,SAAS,YAAY,EACrE,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,GACjD,GAAG,CAAC,WAAW,CAAC,CAElB"}
package/package.json ADDED
@@ -0,0 +1,87 @@
1
+ {
2
+ "name": "@solana/rpc-spec",
3
+ "version": "2.0.0-20241006045741",
4
+ "description": "A generic implementation of JSON RPCs using proxies",
5
+ "exports": {
6
+ "edge-light": {
7
+ "import": "./dist/index.node.mjs",
8
+ "require": "./dist/index.node.cjs"
9
+ },
10
+ "workerd": {
11
+ "import": "./dist/index.node.mjs",
12
+ "require": "./dist/index.node.cjs"
13
+ },
14
+ "browser": {
15
+ "import": "./dist/index.browser.mjs",
16
+ "require": "./dist/index.browser.cjs"
17
+ },
18
+ "node": {
19
+ "import": "./dist/index.node.mjs",
20
+ "require": "./dist/index.node.cjs"
21
+ },
22
+ "react-native": "./dist/index.native.mjs",
23
+ "types": "./dist/types/index.d.ts"
24
+ },
25
+ "browser": {
26
+ "./dist/index.node.cjs": "./dist/index.browser.cjs",
27
+ "./dist/index.node.mjs": "./dist/index.browser.mjs"
28
+ },
29
+ "main": "./dist/index.node.cjs",
30
+ "module": "./dist/index.node.mjs",
31
+ "react-native": "./dist/index.native.mjs",
32
+ "types": "./dist/types/index.d.ts",
33
+ "type": "commonjs",
34
+ "files": [
35
+ "./dist/"
36
+ ],
37
+ "sideEffects": false,
38
+ "keywords": [
39
+ "blockchain",
40
+ "solana",
41
+ "web3"
42
+ ],
43
+ "author": "Solana Labs Maintainers <maintainers@solanalabs.com>",
44
+ "license": "MIT",
45
+ "repository": {
46
+ "type": "git",
47
+ "url": "https://github.com/solana-labs/solana-web3.js"
48
+ },
49
+ "bugs": {
50
+ "url": "http://github.com/solana-labs/solana-web3.js/issues"
51
+ },
52
+ "browserslist": [
53
+ "supports bigint and not dead",
54
+ "maintained node versions"
55
+ ],
56
+ "dependencies": {
57
+ "@solana/errors": "2.0.0-20241006045741",
58
+ "@solana/rpc-spec-types": "2.0.0-20241006045741"
59
+ },
60
+ "peerDependencies": {
61
+ "typescript": ">=5"
62
+ },
63
+ "bundlewatch": {
64
+ "defaultCompression": "gzip",
65
+ "files": [
66
+ {
67
+ "path": "./dist/index*.js"
68
+ }
69
+ ]
70
+ },
71
+ "scripts": {
72
+ "compile:js": "tsup --config build-scripts/tsup.config.package.ts",
73
+ "compile:typedefs": "tsc -p ./tsconfig.declarations.json",
74
+ "dev": "jest -c ../../node_modules/@solana/test-config/jest-dev.config.ts --rootDir . --watch",
75
+ "publish-impl": "npm view $npm_package_name@$npm_package_version > /dev/null 2>&1 || pnpm publish --tag ${PUBLISH_TAG:-canary} --access public --no-git-checks",
76
+ "publish-packages": "pnpm prepublishOnly && pnpm publish-impl",
77
+ "style:fix": "pnpm eslint --fix src && pnpm prettier --log-level warn --ignore-unknown --write ./*",
78
+ "test:lint": "TERM_OVERRIDE=\"${TURBO_HASH:+dumb}\" TERM=${TERM_OVERRIDE:-$TERM} jest -c ../../node_modules/@solana/test-config/jest-lint.config.ts --rootDir . --silent",
79
+ "test:prettier": "TERM_OVERRIDE=\"${TURBO_HASH:+dumb}\" TERM=${TERM_OVERRIDE:-$TERM} jest -c ../../node_modules/@solana/test-config/jest-prettier.config.ts --rootDir . --silent",
80
+ "test:treeshakability:browser": "agadoo dist/index.browser.mjs",
81
+ "test:treeshakability:native": "agadoo dist/index.native.mjs",
82
+ "test:treeshakability:node": "agadoo dist/index.node.mjs",
83
+ "test:typecheck": "tsc --noEmit",
84
+ "test:unit:browser": "TERM_OVERRIDE=\"${TURBO_HASH:+dumb}\" TERM=${TERM_OVERRIDE:-$TERM} jest -c ../../node_modules/@solana/test-config/jest-unit.config.browser.ts --rootDir . --silent",
85
+ "test:unit:node": "TERM_OVERRIDE=\"${TURBO_HASH:+dumb}\" TERM=${TERM_OVERRIDE:-$TERM} jest -c ../../node_modules/@solana/test-config/jest-unit.config.node.ts --rootDir . --silent"
86
+ }
87
+ }