@solana/rpc-transport-http 2.0.0-experimental.2df278c → 2.0.0-experimental.356279e
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/README.md +1 -204
- package/dist/index.browser.cjs +4 -20
- package/dist/index.browser.cjs.map +1 -1
- package/dist/index.browser.js +4 -20
- package/dist/index.browser.js.map +1 -1
- package/dist/index.native.js +4 -20
- package/dist/index.native.js.map +1 -1
- package/dist/index.node.cjs +8 -16
- package/dist/index.node.cjs.map +1 -1
- package/dist/index.node.js +8 -16
- package/dist/index.node.js.map +1 -1
- package/dist/types/http-transport-headers.d.ts +1 -1
- package/dist/types/http-transport-headers.d.ts.map +1 -1
- package/dist/types/http-transport.d.ts +1 -3
- package/dist/types/http-transport.d.ts.map +1 -1
- package/package.json +2 -3
package/README.md
CHANGED
|
@@ -14,207 +14,4 @@
|
|
|
14
14
|
|
|
15
15
|
# @solana/rpc-transport-http
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
## Functions
|
|
20
|
-
|
|
21
|
-
### `createHttpTransport()`
|
|
22
|
-
|
|
23
|
-
Call this to create a function that conforms to the `RpcTransport` interface (see `@solana/rpc-spec`). You can use that function in your programs to make `POST` requests with headers suitable for sending JSON data to a server.
|
|
24
|
-
|
|
25
|
-
```ts
|
|
26
|
-
import { createHttpTransport } from '@solana/rpc-transport-http';
|
|
27
|
-
|
|
28
|
-
const transport = createHttpTransport({ url: 'https://api.mainnet-beta.solana.com' });
|
|
29
|
-
const response = await transport({
|
|
30
|
-
payload: { id: 1, jsonrpc: '2.0', method: 'getSlot' },
|
|
31
|
-
});
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
#### Config
|
|
35
|
-
|
|
36
|
-
##### `dispatcher_NODE_ONLY`
|
|
37
|
-
|
|
38
|
-
In Node environments you can tune how requests are dispatched to the network. Use this config parameter to install a [`undici.Dispatcher`](https://undici.nodejs.org/#/docs/api/Agent) in your transport.
|
|
39
|
-
|
|
40
|
-
```ts
|
|
41
|
-
import { createHttpTransport } from '@solana/rpc-transport-http';
|
|
42
|
-
import { Agent, BalancedPool } from 'undici';
|
|
43
|
-
|
|
44
|
-
// Create a dispatcher that, when called with a special URL, creates a round-robin pool of RPCs.
|
|
45
|
-
const dispatcher = new Agent({
|
|
46
|
-
factory(origin, opts) {
|
|
47
|
-
if (origin === 'https://mypool') {
|
|
48
|
-
const upstreams = [
|
|
49
|
-
'https://api.mainnet-beta.solana.com',
|
|
50
|
-
'https://mainnet.helius-rpc.com',
|
|
51
|
-
'https://several-neat-iguana.quiknode.pro',
|
|
52
|
-
];
|
|
53
|
-
return new BalancedPool(upstreams, {
|
|
54
|
-
...opts,
|
|
55
|
-
bodyTimeout: 60e3,
|
|
56
|
-
headersTimeout: 5e3,
|
|
57
|
-
keepAliveTimeout: 19e3,
|
|
58
|
-
});
|
|
59
|
-
} else {
|
|
60
|
-
return new Pool(origin, opts);
|
|
61
|
-
}
|
|
62
|
-
},
|
|
63
|
-
});
|
|
64
|
-
const transport = createHttpTransport({
|
|
65
|
-
dispatcher_NODE_ONLY: dispatcher,
|
|
66
|
-
url: 'https://mypool',
|
|
67
|
-
});
|
|
68
|
-
let id = 0;
|
|
69
|
-
const balances = await Promise.allSettled(
|
|
70
|
-
accounts.map(account =>
|
|
71
|
-
transport({
|
|
72
|
-
payload: {
|
|
73
|
-
id: ++id,
|
|
74
|
-
jsonrpc: '2.0',
|
|
75
|
-
method: 'getBalance',
|
|
76
|
-
params: [account],
|
|
77
|
-
},
|
|
78
|
-
}),
|
|
79
|
-
),
|
|
80
|
-
);
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
##### `headers`
|
|
84
|
-
|
|
85
|
-
An object of headers to set on the request. Avoid [forbidden headers](https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name). Additionally, the headers `Accept`, `Content-Length`, and `Content-Type` are disallowed.
|
|
86
|
-
|
|
87
|
-
```ts
|
|
88
|
-
import { createHttpTransport } from '@solana/rpc-transport-http';
|
|
89
|
-
|
|
90
|
-
const transport = createHttpTransport({
|
|
91
|
-
headers: {
|
|
92
|
-
// Authorize with the RPC using a bearer token
|
|
93
|
-
Authorization: `Bearer ${process.env.RPC_AUTH_TOKEN}`,
|
|
94
|
-
},
|
|
95
|
-
url: 'https://several-neat-iguana.quiknode.pro',
|
|
96
|
-
});
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
##### `url`
|
|
100
|
-
|
|
101
|
-
A string representing the target endpoint. In Node, it must be an absolute URL using the `http` or `https` protocol.
|
|
102
|
-
|
|
103
|
-
## Augmenting Transports
|
|
104
|
-
|
|
105
|
-
Using this core transport, you can implement specialized functionality for leveraging multiple transports, attempting/handling retries, and more.
|
|
106
|
-
|
|
107
|
-
### Round Robin
|
|
108
|
-
|
|
109
|
-
Here’s an example of how someone might implement a “round robin” approach to distribute requests to multiple transports:
|
|
110
|
-
|
|
111
|
-
```ts
|
|
112
|
-
import { RpcTransport } from '@solana/rpc-spec';
|
|
113
|
-
import { createHttpTransport } from '@solana/rpc-transport-http';
|
|
114
|
-
|
|
115
|
-
// Create a transport for each RPC server
|
|
116
|
-
const transports = [
|
|
117
|
-
createHttpTransport({ url: 'https://mainnet-beta.my-server-1.com' }),
|
|
118
|
-
createHttpTransport({ url: 'https://mainnet-beta.my-server-2.com' }),
|
|
119
|
-
createHttpTransport({ url: 'https://mainnet-beta.my-server-3.com' }),
|
|
120
|
-
];
|
|
121
|
-
|
|
122
|
-
// Create a wrapper transport that distributes requests to them
|
|
123
|
-
let nextTransport = 0;
|
|
124
|
-
async function roundRobinTransport<TResponse>(...args: Parameters<RpcTransport>): Promise<TResponse> {
|
|
125
|
-
const transport = transports[nextTransport];
|
|
126
|
-
nextTransport = (nextTransport + 1) % transports.length;
|
|
127
|
-
return await transport(...args);
|
|
128
|
-
}
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
### Sharding
|
|
132
|
-
|
|
133
|
-
Another example of a possible customization for a transport is to shard requests deterministically among a set of servers. Here’s an example:
|
|
134
|
-
|
|
135
|
-
Perhaps your application needs to make a large number of requests, or needs to fan request for different methods out to different servers. Here’s an example of an implementation that does the latter:
|
|
136
|
-
|
|
137
|
-
```ts
|
|
138
|
-
import { RpcTransport } from '@solana/rpc-spec';
|
|
139
|
-
import { createHttpTransport } from '@solana/rpc-transport-http';
|
|
140
|
-
|
|
141
|
-
// Create multiple transports
|
|
142
|
-
const transportA = createHttpTransport({ url: 'https://mainnet-beta.my-server-1.com' });
|
|
143
|
-
const transportB = createHttpTransport({ url: 'https://mainnet-beta.my-server-2.com' });
|
|
144
|
-
const transportC = createHttpTransport({ url: 'https://mainnet-beta.my-server-3.com' });
|
|
145
|
-
const transportD = createHttpTransport({ url: 'https://mainnet-beta.my-server-4.com' });
|
|
146
|
-
|
|
147
|
-
// Function to determine which shard to use based on the request method
|
|
148
|
-
function selectShard(method: string): RpcTransport {
|
|
149
|
-
switch (method) {
|
|
150
|
-
case 'getAccountInfo':
|
|
151
|
-
case 'getBalance':
|
|
152
|
-
return transportA;
|
|
153
|
-
case 'getTransaction':
|
|
154
|
-
case 'getRecentBlockhash':
|
|
155
|
-
return transportB;
|
|
156
|
-
case 'sendTransaction':
|
|
157
|
-
return transportC;
|
|
158
|
-
default:
|
|
159
|
-
return transportD;
|
|
160
|
-
}
|
|
161
|
-
}
|
|
162
|
-
|
|
163
|
-
async function shardingTransport<TResponse>(...args: Parameters<RpcTransport>): Promise<TResponse> {
|
|
164
|
-
const payload = args[0].payload as { method: string };
|
|
165
|
-
const selectedTransport = selectShard(payload.method);
|
|
166
|
-
return await selectedTransport(...args);
|
|
167
|
-
}
|
|
168
|
-
```
|
|
169
|
-
|
|
170
|
-
### Retry Logic
|
|
171
|
-
|
|
172
|
-
The transport library can also be used to implement custom retry logic on any request:
|
|
173
|
-
|
|
174
|
-
```ts
|
|
175
|
-
import { RpcTransport } from '@solana/rpc-spec';
|
|
176
|
-
import { createHttpTransport } from '@solana/rpc-transport-http';
|
|
177
|
-
|
|
178
|
-
// Set the maximum number of attempts to retry a request
|
|
179
|
-
const MAX_ATTEMPTS = 4;
|
|
180
|
-
|
|
181
|
-
// Create the default transport
|
|
182
|
-
const defaultTransport = createHttpTransport({ url: 'https://mainnet-beta.my-server-1.com' });
|
|
183
|
-
|
|
184
|
-
// Sleep function to wait for a given number of milliseconds
|
|
185
|
-
function sleep(ms: number): Promise<void> {
|
|
186
|
-
return new Promise(resolve => setTimeout(resolve, ms));
|
|
187
|
-
}
|
|
188
|
-
|
|
189
|
-
// Calculate the delay for a given attempt
|
|
190
|
-
function calculateRetryDelay(attempt: number): number {
|
|
191
|
-
// Exponential backoff with a maximum of 1.5 seconds
|
|
192
|
-
return Math.min(100 * Math.pow(2, attempt), 1500);
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
// A retrying transport that will retry up to `MAX_ATTEMPTS` times before failing
|
|
196
|
-
async function retryingTransport<TResponse>(...args: Parameters<RpcTransport>): Promise<TResponse> {
|
|
197
|
-
let requestError;
|
|
198
|
-
for (let attempts = 0; attempts < MAX_ATTEMPTS; attempts++) {
|
|
199
|
-
try {
|
|
200
|
-
return await defaultTransport(...args);
|
|
201
|
-
} catch (err) {
|
|
202
|
-
requestError = err;
|
|
203
|
-
// Only sleep if we have more attempts remaining
|
|
204
|
-
if (attempts < MAX_ATTEMPTS - 1) {
|
|
205
|
-
const retryDelay = calculateRetryDelay(attempts);
|
|
206
|
-
await sleep(retryDelay);
|
|
207
|
-
}
|
|
208
|
-
}
|
|
209
|
-
}
|
|
210
|
-
throw requestError;
|
|
211
|
-
}
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
### Failover
|
|
215
|
-
|
|
216
|
-
Here’s an example of some failover logic integrated into a transport:
|
|
217
|
-
|
|
218
|
-
```ts
|
|
219
|
-
// TODO: Your turn; send us a pull request with an example.
|
|
220
|
-
```
|
|
17
|
+
TODO
|
package/dist/index.browser.cjs
CHANGED
|
@@ -40,9 +40,9 @@ var FORBIDDEN_HEADERS = {
|
|
|
40
40
|
"keep-alive": true,
|
|
41
41
|
origin: true,
|
|
42
42
|
"permissions-policy": true,
|
|
43
|
-
//
|
|
44
|
-
// 'proxy-':
|
|
45
|
-
// 'sec-':
|
|
43
|
+
// No currently available Typescript technique allows you to match on a prefix.
|
|
44
|
+
// 'proxy-':true,
|
|
45
|
+
// 'sec-':true,
|
|
46
46
|
referer: true,
|
|
47
47
|
te: true,
|
|
48
48
|
trailer: true,
|
|
@@ -70,25 +70,10 @@ function normalizeHeaders(headers) {
|
|
|
70
70
|
}
|
|
71
71
|
|
|
72
72
|
// src/http-transport.ts
|
|
73
|
-
|
|
74
|
-
function warnDispatcherWasSuppliedInNonNodeEnvironment() {
|
|
75
|
-
if (didWarnDispatcherWasSuppliedInNonNodeEnvironment) {
|
|
76
|
-
return;
|
|
77
|
-
}
|
|
78
|
-
didWarnDispatcherWasSuppliedInNonNodeEnvironment = true;
|
|
79
|
-
console.warn(
|
|
80
|
-
"You have supplied a `Dispatcher` to `createHttpTransport()`. It has been ignored because Undici dispatchers only work in Node environments. To eliminate this warning, omit the `dispatcher_NODE_ONLY` property from your config when running in a non-Node environment."
|
|
81
|
-
);
|
|
82
|
-
}
|
|
83
|
-
function createHttpTransport(config) {
|
|
84
|
-
if (__DEV__ && true && "dispatcher_NODE_ONLY" in config) {
|
|
85
|
-
warnDispatcherWasSuppliedInNonNodeEnvironment();
|
|
86
|
-
}
|
|
87
|
-
const { headers, url } = config;
|
|
73
|
+
function createHttpTransport({ headers, url }) {
|
|
88
74
|
if (__DEV__ && headers) {
|
|
89
75
|
assertIsAllowedHttpRequestHeaders(headers);
|
|
90
76
|
}
|
|
91
|
-
let dispatcherConfig;
|
|
92
77
|
const customHeaders = headers && normalizeHeaders(headers);
|
|
93
78
|
return async function makeHttpRequest({
|
|
94
79
|
payload,
|
|
@@ -96,7 +81,6 @@ function createHttpTransport(config) {
|
|
|
96
81
|
}) {
|
|
97
82
|
const body = JSON.stringify(payload);
|
|
98
83
|
const requestInfo = {
|
|
99
|
-
...dispatcherConfig,
|
|
100
84
|
body,
|
|
101
85
|
headers: {
|
|
102
86
|
...customHeaders,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.browser.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_browser_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,IAAOA,IAAQ,WAAW;;;ACKnB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;
|
|
1
|
+
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.browser.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_browser_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,IAAOA,IAAQ,WAAW;;;ACKnB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;AC2BA,IAAM,qBAA8C;AAAA,EAChD,QAAQ;AAAA,EACR,kBAAkB;AAAA,EAClB,gBAAgB;AACpB;AAEA,IAAM,oBAA6C;AAAA,EAC/C,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,kCAAkC;AAAA,EAClC,iCAAiC;AAAA,EACjC,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,sBAAsB;AAAA;AAAA;AAAA;AAAA,EAItB,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AACT;AAEO,SAAS,kCACZ,SAC4C;AAC5C,QAAM,aAAa,OAAO,KAAK,OAAO,EAAE,OAAO,gBAAc;AACzD,UAAM,sBAAsB,WAAW,YAAY;AACnD,WACI,mBAAmB,WAAW,YAAY,CAAC,MAAM,QACjD,kBAAkB,WAAW,YAAY,CAAC,MAAM,QAChD,oBAAoB,WAAW,QAAQ,KACvC,oBAAoB,WAAW,MAAM;AAAA,EAE7C,CAAC;AACD,MAAI,WAAW,SAAS,GAAG;AACvB,UAAM,IAAI;AAAA,MACN,GAAG,WAAW,SAAS,IAAI,sBAAsB,gBAAgB,iBACxD,WAAW,KAAK,MAAM,CAAC;AAAA,IAEpC;AAAA,EACJ;AACJ;AAMO,SAAS,iBACZ,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;;;AC5FO,SAAS,oBAAoB,EAAE,SAAS,IAAI,GAAyB;AACxE,MAAI,WAAW,SAAS;AACpB,sCAAkC,OAAO;AAAA,EAC7C;AACA,QAAM,gBAAgB,WAAW,iBAAiB,OAAO;AACzD,SAAO,eAAe,gBAA2B;AAAA,IAC7C;AAAA,IACA;AAAA,EACJ,GAAoD;AAChD,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,cAAc;AAAA,MAChB;AAAA,MACA,SAAS;AAAA,QACL,GAAG;AAAA;AAAA,QAEH,QAAQ;AAAA,QACR,kBAAkB,KAAK,OAAO,SAAS;AAAA,QACvC,gBAAgB;AAAA,MACpB;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,IACJ;AACA,UAAM,WAAW,MAAM,EAAU,KAAK,WAAW;AACjD,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,IAAI,gBAAgB;AAAA,QACtB,SAAS,SAAS;AAAA,QAClB,YAAY,SAAS;AAAA,MACzB,CAAC;AAAA,IACL;AACA,WAAQ,MAAM,SAAS,KAAK;AAAA,EAChC;AACJ","sourcesContent":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","export default globalThis.fetch;\n","type SolanaHttpErrorDetails = Readonly<{\n statusCode: number;\n message: string;\n}>;\n\nexport class SolanaHttpError extends Error {\n readonly statusCode: number;\n constructor(details: SolanaHttpErrorDetails) {\n super(`HTTP error (${details.statusCode}): ${details.message}`);\n Error.captureStackTrace(this, this.constructor);\n this.statusCode = details.statusCode;\n }\n get name() {\n return 'SolanaHttpError';\n }\n}\n","export type AllowedHttpRequestHeaders = Readonly<\n { [headerName: string]: string } & {\n // Someone can still sneak a forbidden header past Typescript if they do something like\n // fOo-BaR, but at that point they deserve the runtime failure.\n [K in DisallowedHeaders | ForbiddenHeaders as\n | K // `Foo-Bar`\n | Capitalize<Lowercase<K>> // `Foo-bar`\n | Lowercase<K> // `foo-bar`\n | Uncapitalize<K> // `foo-Bar`\n // `FOO-BAR`\n | Uppercase<K>]?: never;\n }\n>;\n// These are headers that we simply don't allow the developer to override because they're\n// fundamental to the operation of the JSON-RPC transport.\ntype DisallowedHeaders = 'Accept' | 'Content-Length' | 'Content-Type' | 'Solana-Client';\ntype ForbiddenHeaders =\n | 'Accept-Charset'\n | 'Accept-Encoding'\n | 'Access-Control-Request-Headers'\n | 'Access-Control-Request-Method'\n | 'Connection'\n | 'Content-Length'\n | 'Cookie'\n | 'Date'\n | 'DNT'\n | 'Expect'\n | 'Host'\n | 'Keep-Alive'\n | 'Origin'\n | 'Permissions-Policy'\n // No currently available Typescript technique allows you to match on a prefix.\n // | 'Proxy-'\n // | 'Sec-'\n | 'Referer'\n | 'TE'\n | 'Trailer'\n | 'Transfer-Encoding'\n | 'Upgrade'\n | 'Via';\n\n// These are headers which are fundamental to the JSON-RPC transport, and must not be modified.\nconst DISALLOWED_HEADERS: Record<string, boolean> = {\n accept: true,\n 'content-length': true,\n 'content-type': true,\n};\n// https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name\nconst FORBIDDEN_HEADERS: Record<string, boolean> = {\n 'accept-charset': true,\n 'accept-encoding': true,\n 'access-control-request-headers': true,\n 'access-control-request-method': true,\n connection: true,\n 'content-length': true,\n cookie: true,\n date: true,\n dnt: true,\n expect: true,\n host: true,\n 'keep-alive': true,\n origin: true,\n 'permissions-policy': true,\n // No currently available Typescript technique allows you to match on a prefix.\n // 'proxy-':true,\n // 'sec-':true,\n referer: true,\n te: true,\n trailer: true,\n 'transfer-encoding': true,\n upgrade: true,\n via: true,\n};\n\nexport function assertIsAllowedHttpRequestHeaders(\n headers: Record<string, string>,\n): asserts headers is AllowedHttpRequestHeaders {\n const badHeaders = Object.keys(headers).filter(headerName => {\n const lowercaseHeaderName = headerName.toLowerCase();\n return (\n DISALLOWED_HEADERS[headerName.toLowerCase()] === true ||\n FORBIDDEN_HEADERS[headerName.toLowerCase()] === true ||\n lowercaseHeaderName.startsWith('proxy-') ||\n lowercaseHeaderName.startsWith('sec-')\n );\n });\n if (badHeaders.length > 0) {\n throw new Error(\n `${badHeaders.length > 1 ? 'These headers are' : 'This header is'} forbidden: ` +\n `\\`${badHeaders.join('`, `')}\\`. Learn more at ` +\n 'https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name.',\n );\n }\n}\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers, such as those defined\n * in the `DisallowedHeaders` type.\n */\nexport function normalizeHeaders<T extends Record<string, string>>(\n headers: T,\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n const out: Record<string, string> = {};\n for (const headerName in headers) {\n out[headerName.toLowerCase()] = headers[headerName];\n }\n return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n","import fetchImpl from '@solana/fetch-impl';\nimport { RpcTransport } from '@solana/rpc-spec';\n\nimport { SolanaHttpError } from './http-transport-errors';\nimport {\n AllowedHttpRequestHeaders,\n assertIsAllowedHttpRequestHeaders,\n normalizeHeaders,\n} from './http-transport-headers';\n\ntype Config = Readonly<{\n headers?: AllowedHttpRequestHeaders;\n url: string;\n}>;\n\nexport function createHttpTransport({ headers, url }: Config): RpcTransport {\n if (__DEV__ && headers) {\n assertIsAllowedHttpRequestHeaders(headers);\n }\n const customHeaders = headers && normalizeHeaders(headers);\n return async function makeHttpRequest<TResponse>({\n payload,\n signal,\n }: Parameters<RpcTransport>[0]): Promise<TResponse> {\n const body = JSON.stringify(payload);\n const requestInfo = {\n body,\n headers: {\n ...customHeaders,\n // Keep these headers lowercase so they will override any user-supplied headers above.\n accept: 'application/json',\n 'content-length': body.length.toString(),\n 'content-type': 'application/json; charset=utf-8',\n },\n method: 'POST',\n signal,\n };\n const response = await fetchImpl(url, requestInfo);\n if (!response.ok) {\n throw new SolanaHttpError({\n message: response.statusText,\n statusCode: response.status,\n });\n }\n return (await response.json()) as TResponse;\n };\n}\n"]}
|
package/dist/index.browser.js
CHANGED
|
@@ -38,9 +38,9 @@ var FORBIDDEN_HEADERS = {
|
|
|
38
38
|
"keep-alive": true,
|
|
39
39
|
origin: true,
|
|
40
40
|
"permissions-policy": true,
|
|
41
|
-
//
|
|
42
|
-
// 'proxy-':
|
|
43
|
-
// 'sec-':
|
|
41
|
+
// No currently available Typescript technique allows you to match on a prefix.
|
|
42
|
+
// 'proxy-':true,
|
|
43
|
+
// 'sec-':true,
|
|
44
44
|
referer: true,
|
|
45
45
|
te: true,
|
|
46
46
|
trailer: true,
|
|
@@ -68,25 +68,10 @@ function normalizeHeaders(headers) {
|
|
|
68
68
|
}
|
|
69
69
|
|
|
70
70
|
// src/http-transport.ts
|
|
71
|
-
|
|
72
|
-
function warnDispatcherWasSuppliedInNonNodeEnvironment() {
|
|
73
|
-
if (didWarnDispatcherWasSuppliedInNonNodeEnvironment) {
|
|
74
|
-
return;
|
|
75
|
-
}
|
|
76
|
-
didWarnDispatcherWasSuppliedInNonNodeEnvironment = true;
|
|
77
|
-
console.warn(
|
|
78
|
-
"You have supplied a `Dispatcher` to `createHttpTransport()`. It has been ignored because Undici dispatchers only work in Node environments. To eliminate this warning, omit the `dispatcher_NODE_ONLY` property from your config when running in a non-Node environment."
|
|
79
|
-
);
|
|
80
|
-
}
|
|
81
|
-
function createHttpTransport(config) {
|
|
82
|
-
if (__DEV__ && true && "dispatcher_NODE_ONLY" in config) {
|
|
83
|
-
warnDispatcherWasSuppliedInNonNodeEnvironment();
|
|
84
|
-
}
|
|
85
|
-
const { headers, url } = config;
|
|
71
|
+
function createHttpTransport({ headers, url }) {
|
|
86
72
|
if (__DEV__ && headers) {
|
|
87
73
|
assertIsAllowedHttpRequestHeaders(headers);
|
|
88
74
|
}
|
|
89
|
-
let dispatcherConfig;
|
|
90
75
|
const customHeaders = headers && normalizeHeaders(headers);
|
|
91
76
|
return async function makeHttpRequest({
|
|
92
77
|
payload,
|
|
@@ -94,7 +79,6 @@ function createHttpTransport(config) {
|
|
|
94
79
|
}) {
|
|
95
80
|
const body = JSON.stringify(payload);
|
|
96
81
|
const requestInfo = {
|
|
97
|
-
...dispatcherConfig,
|
|
98
82
|
body,
|
|
99
83
|
headers: {
|
|
100
84
|
...customHeaders,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.browser.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_browser_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,IAAOA,IAAQ,WAAW;;;ACKnB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;
|
|
1
|
+
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.browser.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_browser_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,IAAOA,IAAQ,WAAW;;;ACKnB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;AC2BA,IAAM,qBAA8C;AAAA,EAChD,QAAQ;AAAA,EACR,kBAAkB;AAAA,EAClB,gBAAgB;AACpB;AAEA,IAAM,oBAA6C;AAAA,EAC/C,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,kCAAkC;AAAA,EAClC,iCAAiC;AAAA,EACjC,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,sBAAsB;AAAA;AAAA;AAAA;AAAA,EAItB,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AACT;AAEO,SAAS,kCACZ,SAC4C;AAC5C,QAAM,aAAa,OAAO,KAAK,OAAO,EAAE,OAAO,gBAAc;AACzD,UAAM,sBAAsB,WAAW,YAAY;AACnD,WACI,mBAAmB,WAAW,YAAY,CAAC,MAAM,QACjD,kBAAkB,WAAW,YAAY,CAAC,MAAM,QAChD,oBAAoB,WAAW,QAAQ,KACvC,oBAAoB,WAAW,MAAM;AAAA,EAE7C,CAAC;AACD,MAAI,WAAW,SAAS,GAAG;AACvB,UAAM,IAAI;AAAA,MACN,GAAG,WAAW,SAAS,IAAI,sBAAsB,gBAAgB,iBACxD,WAAW,KAAK,MAAM,CAAC;AAAA,IAEpC;AAAA,EACJ;AACJ;AAMO,SAAS,iBACZ,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;;;AC5FO,SAAS,oBAAoB,EAAE,SAAS,IAAI,GAAyB;AACxE,MAAI,WAAW,SAAS;AACpB,sCAAkC,OAAO;AAAA,EAC7C;AACA,QAAM,gBAAgB,WAAW,iBAAiB,OAAO;AACzD,SAAO,eAAe,gBAA2B;AAAA,IAC7C;AAAA,IACA;AAAA,EACJ,GAAoD;AAChD,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,cAAc;AAAA,MAChB;AAAA,MACA,SAAS;AAAA,QACL,GAAG;AAAA;AAAA,QAEH,QAAQ;AAAA,QACR,kBAAkB,KAAK,OAAO,SAAS;AAAA,QACvC,gBAAgB;AAAA,MACpB;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,IACJ;AACA,UAAM,WAAW,MAAM,EAAU,KAAK,WAAW;AACjD,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,IAAI,gBAAgB;AAAA,QACtB,SAAS,SAAS;AAAA,QAClB,YAAY,SAAS;AAAA,MACzB,CAAC;AAAA,IACL;AACA,WAAQ,MAAM,SAAS,KAAK;AAAA,EAChC;AACJ","sourcesContent":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","export default globalThis.fetch;\n","type SolanaHttpErrorDetails = Readonly<{\n statusCode: number;\n message: string;\n}>;\n\nexport class SolanaHttpError extends Error {\n readonly statusCode: number;\n constructor(details: SolanaHttpErrorDetails) {\n super(`HTTP error (${details.statusCode}): ${details.message}`);\n Error.captureStackTrace(this, this.constructor);\n this.statusCode = details.statusCode;\n }\n get name() {\n return 'SolanaHttpError';\n }\n}\n","export type AllowedHttpRequestHeaders = Readonly<\n { [headerName: string]: string } & {\n // Someone can still sneak a forbidden header past Typescript if they do something like\n // fOo-BaR, but at that point they deserve the runtime failure.\n [K in DisallowedHeaders | ForbiddenHeaders as\n | K // `Foo-Bar`\n | Capitalize<Lowercase<K>> // `Foo-bar`\n | Lowercase<K> // `foo-bar`\n | Uncapitalize<K> // `foo-Bar`\n // `FOO-BAR`\n | Uppercase<K>]?: never;\n }\n>;\n// These are headers that we simply don't allow the developer to override because they're\n// fundamental to the operation of the JSON-RPC transport.\ntype DisallowedHeaders = 'Accept' | 'Content-Length' | 'Content-Type' | 'Solana-Client';\ntype ForbiddenHeaders =\n | 'Accept-Charset'\n | 'Accept-Encoding'\n | 'Access-Control-Request-Headers'\n | 'Access-Control-Request-Method'\n | 'Connection'\n | 'Content-Length'\n | 'Cookie'\n | 'Date'\n | 'DNT'\n | 'Expect'\n | 'Host'\n | 'Keep-Alive'\n | 'Origin'\n | 'Permissions-Policy'\n // No currently available Typescript technique allows you to match on a prefix.\n // | 'Proxy-'\n // | 'Sec-'\n | 'Referer'\n | 'TE'\n | 'Trailer'\n | 'Transfer-Encoding'\n | 'Upgrade'\n | 'Via';\n\n// These are headers which are fundamental to the JSON-RPC transport, and must not be modified.\nconst DISALLOWED_HEADERS: Record<string, boolean> = {\n accept: true,\n 'content-length': true,\n 'content-type': true,\n};\n// https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name\nconst FORBIDDEN_HEADERS: Record<string, boolean> = {\n 'accept-charset': true,\n 'accept-encoding': true,\n 'access-control-request-headers': true,\n 'access-control-request-method': true,\n connection: true,\n 'content-length': true,\n cookie: true,\n date: true,\n dnt: true,\n expect: true,\n host: true,\n 'keep-alive': true,\n origin: true,\n 'permissions-policy': true,\n // No currently available Typescript technique allows you to match on a prefix.\n // 'proxy-':true,\n // 'sec-':true,\n referer: true,\n te: true,\n trailer: true,\n 'transfer-encoding': true,\n upgrade: true,\n via: true,\n};\n\nexport function assertIsAllowedHttpRequestHeaders(\n headers: Record<string, string>,\n): asserts headers is AllowedHttpRequestHeaders {\n const badHeaders = Object.keys(headers).filter(headerName => {\n const lowercaseHeaderName = headerName.toLowerCase();\n return (\n DISALLOWED_HEADERS[headerName.toLowerCase()] === true ||\n FORBIDDEN_HEADERS[headerName.toLowerCase()] === true ||\n lowercaseHeaderName.startsWith('proxy-') ||\n lowercaseHeaderName.startsWith('sec-')\n );\n });\n if (badHeaders.length > 0) {\n throw new Error(\n `${badHeaders.length > 1 ? 'These headers are' : 'This header is'} forbidden: ` +\n `\\`${badHeaders.join('`, `')}\\`. Learn more at ` +\n 'https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name.',\n );\n }\n}\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers, such as those defined\n * in the `DisallowedHeaders` type.\n */\nexport function normalizeHeaders<T extends Record<string, string>>(\n headers: T,\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n const out: Record<string, string> = {};\n for (const headerName in headers) {\n out[headerName.toLowerCase()] = headers[headerName];\n }\n return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n","import fetchImpl from '@solana/fetch-impl';\nimport { RpcTransport } from '@solana/rpc-spec';\n\nimport { SolanaHttpError } from './http-transport-errors';\nimport {\n AllowedHttpRequestHeaders,\n assertIsAllowedHttpRequestHeaders,\n normalizeHeaders,\n} from './http-transport-headers';\n\ntype Config = Readonly<{\n headers?: AllowedHttpRequestHeaders;\n url: string;\n}>;\n\nexport function createHttpTransport({ headers, url }: Config): RpcTransport {\n if (__DEV__ && headers) {\n assertIsAllowedHttpRequestHeaders(headers);\n }\n const customHeaders = headers && normalizeHeaders(headers);\n return async function makeHttpRequest<TResponse>({\n payload,\n signal,\n }: Parameters<RpcTransport>[0]): Promise<TResponse> {\n const body = JSON.stringify(payload);\n const requestInfo = {\n body,\n headers: {\n ...customHeaders,\n // Keep these headers lowercase so they will override any user-supplied headers above.\n accept: 'application/json',\n 'content-length': body.length.toString(),\n 'content-type': 'application/json; charset=utf-8',\n },\n method: 'POST',\n signal,\n };\n const response = await fetchImpl(url, requestInfo);\n if (!response.ok) {\n throw new SolanaHttpError({\n message: response.statusText,\n statusCode: response.status,\n });\n }\n return (await response.json()) as TResponse;\n };\n}\n"]}
|
package/dist/index.native.js
CHANGED
|
@@ -38,9 +38,9 @@ var FORBIDDEN_HEADERS = {
|
|
|
38
38
|
"keep-alive": true,
|
|
39
39
|
origin: true,
|
|
40
40
|
"permissions-policy": true,
|
|
41
|
-
//
|
|
42
|
-
// 'proxy-':
|
|
43
|
-
// 'sec-':
|
|
41
|
+
// No currently available Typescript technique allows you to match on a prefix.
|
|
42
|
+
// 'proxy-':true,
|
|
43
|
+
// 'sec-':true,
|
|
44
44
|
referer: true,
|
|
45
45
|
te: true,
|
|
46
46
|
trailer: true,
|
|
@@ -68,25 +68,10 @@ function normalizeHeaders(headers) {
|
|
|
68
68
|
}
|
|
69
69
|
|
|
70
70
|
// src/http-transport.ts
|
|
71
|
-
|
|
72
|
-
function warnDispatcherWasSuppliedInNonNodeEnvironment() {
|
|
73
|
-
if (didWarnDispatcherWasSuppliedInNonNodeEnvironment) {
|
|
74
|
-
return;
|
|
75
|
-
}
|
|
76
|
-
didWarnDispatcherWasSuppliedInNonNodeEnvironment = true;
|
|
77
|
-
console.warn(
|
|
78
|
-
"You have supplied a `Dispatcher` to `createHttpTransport()`. It has been ignored because Undici dispatchers only work in Node environments. To eliminate this warning, omit the `dispatcher_NODE_ONLY` property from your config when running in a non-Node environment."
|
|
79
|
-
);
|
|
80
|
-
}
|
|
81
|
-
function createHttpTransport(config) {
|
|
82
|
-
if (__DEV__ && true && "dispatcher_NODE_ONLY" in config) {
|
|
83
|
-
warnDispatcherWasSuppliedInNonNodeEnvironment();
|
|
84
|
-
}
|
|
85
|
-
const { headers, url } = config;
|
|
71
|
+
function createHttpTransport({ headers, url }) {
|
|
86
72
|
if (__DEV__ && headers) {
|
|
87
73
|
assertIsAllowedHttpRequestHeaders(headers);
|
|
88
74
|
}
|
|
89
|
-
let dispatcherConfig;
|
|
90
75
|
const customHeaders = headers && normalizeHeaders(headers);
|
|
91
76
|
return async function makeHttpRequest({
|
|
92
77
|
payload,
|
|
@@ -94,7 +79,6 @@ function createHttpTransport(config) {
|
|
|
94
79
|
}) {
|
|
95
80
|
const body = JSON.stringify(payload);
|
|
96
81
|
const requestInfo = {
|
|
97
|
-
...dispatcherConfig,
|
|
98
82
|
body,
|
|
99
83
|
headers: {
|
|
100
84
|
...customHeaders,
|
package/dist/index.native.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.browser.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_browser_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,IAAOA,IAAQ,WAAW;;;ACKnB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;
|
|
1
|
+
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.browser.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_browser_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACDvG,IAAOA,IAAQ,WAAW;;;ACKnB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;AC2BA,IAAM,qBAA8C;AAAA,EAChD,QAAQ;AAAA,EACR,kBAAkB;AAAA,EAClB,gBAAgB;AACpB;AAEA,IAAM,oBAA6C;AAAA,EAC/C,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,kCAAkC;AAAA,EAClC,iCAAiC;AAAA,EACjC,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,sBAAsB;AAAA;AAAA;AAAA;AAAA,EAItB,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AACT;AAEO,SAAS,kCACZ,SAC4C;AAC5C,QAAM,aAAa,OAAO,KAAK,OAAO,EAAE,OAAO,gBAAc;AACzD,UAAM,sBAAsB,WAAW,YAAY;AACnD,WACI,mBAAmB,WAAW,YAAY,CAAC,MAAM,QACjD,kBAAkB,WAAW,YAAY,CAAC,MAAM,QAChD,oBAAoB,WAAW,QAAQ,KACvC,oBAAoB,WAAW,MAAM;AAAA,EAE7C,CAAC;AACD,MAAI,WAAW,SAAS,GAAG;AACvB,UAAM,IAAI;AAAA,MACN,GAAG,WAAW,SAAS,IAAI,sBAAsB,gBAAgB,iBACxD,WAAW,KAAK,MAAM,CAAC;AAAA,IAEpC;AAAA,EACJ;AACJ;AAMO,SAAS,iBACZ,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;;;AC5FO,SAAS,oBAAoB,EAAE,SAAS,IAAI,GAAyB;AACxE,MAAI,WAAW,SAAS;AACpB,sCAAkC,OAAO;AAAA,EAC7C;AACA,QAAM,gBAAgB,WAAW,iBAAiB,OAAO;AACzD,SAAO,eAAe,gBAA2B;AAAA,IAC7C;AAAA,IACA;AAAA,EACJ,GAAoD;AAChD,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,cAAc;AAAA,MAChB;AAAA,MACA,SAAS;AAAA,QACL,GAAG;AAAA;AAAA,QAEH,QAAQ;AAAA,QACR,kBAAkB,KAAK,OAAO,SAAS;AAAA,QACvC,gBAAgB;AAAA,MACpB;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,IACJ;AACA,UAAM,WAAW,MAAM,EAAU,KAAK,WAAW;AACjD,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,IAAI,gBAAgB;AAAA,QACtB,SAAS,SAAS;AAAA,QAClB,YAAY,SAAS;AAAA,MACzB,CAAC;AAAA,IACL;AACA,WAAQ,MAAM,SAAS,KAAK;AAAA,EAChC;AACJ","sourcesContent":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","export default globalThis.fetch;\n","type SolanaHttpErrorDetails = Readonly<{\n statusCode: number;\n message: string;\n}>;\n\nexport class SolanaHttpError extends Error {\n readonly statusCode: number;\n constructor(details: SolanaHttpErrorDetails) {\n super(`HTTP error (${details.statusCode}): ${details.message}`);\n Error.captureStackTrace(this, this.constructor);\n this.statusCode = details.statusCode;\n }\n get name() {\n return 'SolanaHttpError';\n }\n}\n","export type AllowedHttpRequestHeaders = Readonly<\n { [headerName: string]: string } & {\n // Someone can still sneak a forbidden header past Typescript if they do something like\n // fOo-BaR, but at that point they deserve the runtime failure.\n [K in DisallowedHeaders | ForbiddenHeaders as\n | K // `Foo-Bar`\n | Capitalize<Lowercase<K>> // `Foo-bar`\n | Lowercase<K> // `foo-bar`\n | Uncapitalize<K> // `foo-Bar`\n // `FOO-BAR`\n | Uppercase<K>]?: never;\n }\n>;\n// These are headers that we simply don't allow the developer to override because they're\n// fundamental to the operation of the JSON-RPC transport.\ntype DisallowedHeaders = 'Accept' | 'Content-Length' | 'Content-Type' | 'Solana-Client';\ntype ForbiddenHeaders =\n | 'Accept-Charset'\n | 'Accept-Encoding'\n | 'Access-Control-Request-Headers'\n | 'Access-Control-Request-Method'\n | 'Connection'\n | 'Content-Length'\n | 'Cookie'\n | 'Date'\n | 'DNT'\n | 'Expect'\n | 'Host'\n | 'Keep-Alive'\n | 'Origin'\n | 'Permissions-Policy'\n // No currently available Typescript technique allows you to match on a prefix.\n // | 'Proxy-'\n // | 'Sec-'\n | 'Referer'\n | 'TE'\n | 'Trailer'\n | 'Transfer-Encoding'\n | 'Upgrade'\n | 'Via';\n\n// These are headers which are fundamental to the JSON-RPC transport, and must not be modified.\nconst DISALLOWED_HEADERS: Record<string, boolean> = {\n accept: true,\n 'content-length': true,\n 'content-type': true,\n};\n// https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name\nconst FORBIDDEN_HEADERS: Record<string, boolean> = {\n 'accept-charset': true,\n 'accept-encoding': true,\n 'access-control-request-headers': true,\n 'access-control-request-method': true,\n connection: true,\n 'content-length': true,\n cookie: true,\n date: true,\n dnt: true,\n expect: true,\n host: true,\n 'keep-alive': true,\n origin: true,\n 'permissions-policy': true,\n // No currently available Typescript technique allows you to match on a prefix.\n // 'proxy-':true,\n // 'sec-':true,\n referer: true,\n te: true,\n trailer: true,\n 'transfer-encoding': true,\n upgrade: true,\n via: true,\n};\n\nexport function assertIsAllowedHttpRequestHeaders(\n headers: Record<string, string>,\n): asserts headers is AllowedHttpRequestHeaders {\n const badHeaders = Object.keys(headers).filter(headerName => {\n const lowercaseHeaderName = headerName.toLowerCase();\n return (\n DISALLOWED_HEADERS[headerName.toLowerCase()] === true ||\n FORBIDDEN_HEADERS[headerName.toLowerCase()] === true ||\n lowercaseHeaderName.startsWith('proxy-') ||\n lowercaseHeaderName.startsWith('sec-')\n );\n });\n if (badHeaders.length > 0) {\n throw new Error(\n `${badHeaders.length > 1 ? 'These headers are' : 'This header is'} forbidden: ` +\n `\\`${badHeaders.join('`, `')}\\`. Learn more at ` +\n 'https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name.',\n );\n }\n}\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers, such as those defined\n * in the `DisallowedHeaders` type.\n */\nexport function normalizeHeaders<T extends Record<string, string>>(\n headers: T,\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n const out: Record<string, string> = {};\n for (const headerName in headers) {\n out[headerName.toLowerCase()] = headers[headerName];\n }\n return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n","import fetchImpl from '@solana/fetch-impl';\nimport { RpcTransport } from '@solana/rpc-spec';\n\nimport { SolanaHttpError } from './http-transport-errors';\nimport {\n AllowedHttpRequestHeaders,\n assertIsAllowedHttpRequestHeaders,\n normalizeHeaders,\n} from './http-transport-headers';\n\ntype Config = Readonly<{\n headers?: AllowedHttpRequestHeaders;\n url: string;\n}>;\n\nexport function createHttpTransport({ headers, url }: Config): RpcTransport {\n if (__DEV__ && headers) {\n assertIsAllowedHttpRequestHeaders(headers);\n }\n const customHeaders = headers && normalizeHeaders(headers);\n return async function makeHttpRequest<TResponse>({\n payload,\n signal,\n }: Parameters<RpcTransport>[0]): Promise<TResponse> {\n const body = JSON.stringify(payload);\n const requestInfo = {\n body,\n headers: {\n ...customHeaders,\n // Keep these headers lowercase so they will override any user-supplied headers above.\n accept: 'application/json',\n 'content-length': body.length.toString(),\n 'content-type': 'application/json; charset=utf-8',\n },\n method: 'POST',\n signal,\n };\n const response = await fetchImpl(url, requestInfo);\n if (!response.ok) {\n throw new SolanaHttpError({\n message: response.statusText,\n statusCode: response.status,\n });\n }\n return (await response.json()) as TResponse;\n };\n}\n"]}
|
package/dist/index.node.cjs
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var undici = require('undici');
|
|
4
|
-
|
|
5
3
|
// ../build-scripts/env-shim.ts
|
|
6
4
|
var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
|
|
7
5
|
|
|
6
|
+
// ../fetch-impl/dist/index.node.js
|
|
7
|
+
var e = globalThis.fetch;
|
|
8
|
+
|
|
8
9
|
// src/http-transport-errors.ts
|
|
9
10
|
var SolanaHttpError = class extends Error {
|
|
10
11
|
statusCode;
|
|
@@ -39,9 +40,9 @@ var FORBIDDEN_HEADERS = {
|
|
|
39
40
|
"keep-alive": true,
|
|
40
41
|
origin: true,
|
|
41
42
|
"permissions-policy": true,
|
|
42
|
-
//
|
|
43
|
-
// 'proxy-':
|
|
44
|
-
// 'sec-':
|
|
43
|
+
// No currently available Typescript technique allows you to match on a prefix.
|
|
44
|
+
// 'proxy-':true,
|
|
45
|
+
// 'sec-':true,
|
|
45
46
|
referer: true,
|
|
46
47
|
te: true,
|
|
47
48
|
trailer: true,
|
|
@@ -69,18 +70,10 @@ function normalizeHeaders(headers) {
|
|
|
69
70
|
}
|
|
70
71
|
|
|
71
72
|
// src/http-transport.ts
|
|
72
|
-
function createHttpTransport(
|
|
73
|
-
if (__DEV__ && false) {
|
|
74
|
-
warnDispatcherWasSuppliedInNonNodeEnvironment();
|
|
75
|
-
}
|
|
76
|
-
const { headers, url } = config;
|
|
73
|
+
function createHttpTransport({ headers, url }) {
|
|
77
74
|
if (__DEV__ && headers) {
|
|
78
75
|
assertIsAllowedHttpRequestHeaders(headers);
|
|
79
76
|
}
|
|
80
|
-
let dispatcherConfig;
|
|
81
|
-
if ("dispatcher_NODE_ONLY" in config) {
|
|
82
|
-
dispatcherConfig = { dispatcher: config.dispatcher_NODE_ONLY };
|
|
83
|
-
}
|
|
84
77
|
const customHeaders = headers && normalizeHeaders(headers);
|
|
85
78
|
return async function makeHttpRequest({
|
|
86
79
|
payload,
|
|
@@ -88,7 +81,6 @@ function createHttpTransport(config) {
|
|
|
88
81
|
}) {
|
|
89
82
|
const body = JSON.stringify(payload);
|
|
90
83
|
const requestInfo = {
|
|
91
|
-
...dispatcherConfig,
|
|
92
84
|
body,
|
|
93
85
|
headers: {
|
|
94
86
|
...customHeaders,
|
|
@@ -100,7 +92,7 @@ function createHttpTransport(config) {
|
|
|
100
92
|
method: "POST",
|
|
101
93
|
signal
|
|
102
94
|
};
|
|
103
|
-
const response = await
|
|
95
|
+
const response = await e(url, requestInfo);
|
|
104
96
|
if (!response.ok) {
|
|
105
97
|
throw new SolanaHttpError({
|
|
106
98
|
message: response.statusText,
|
package/dist/index.node.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.node.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["
|
|
1
|
+
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.node.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_node_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACAvG,IAAOA,IAAQ,WAAW;;;ACInB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;AC2BA,IAAM,qBAA8C;AAAA,EAChD,QAAQ;AAAA,EACR,kBAAkB;AAAA,EAClB,gBAAgB;AACpB;AAEA,IAAM,oBAA6C;AAAA,EAC/C,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,kCAAkC;AAAA,EAClC,iCAAiC;AAAA,EACjC,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,sBAAsB;AAAA;AAAA;AAAA;AAAA,EAItB,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AACT;AAEO,SAAS,kCACZ,SAC4C;AAC5C,QAAM,aAAa,OAAO,KAAK,OAAO,EAAE,OAAO,gBAAc;AACzD,UAAM,sBAAsB,WAAW,YAAY;AACnD,WACI,mBAAmB,WAAW,YAAY,CAAC,MAAM,QACjD,kBAAkB,WAAW,YAAY,CAAC,MAAM,QAChD,oBAAoB,WAAW,QAAQ,KACvC,oBAAoB,WAAW,MAAM;AAAA,EAE7C,CAAC;AACD,MAAI,WAAW,SAAS,GAAG;AACvB,UAAM,IAAI;AAAA,MACN,GAAG,WAAW,SAAS,IAAI,sBAAsB,gBAAgB,iBACxD,WAAW,KAAK,MAAM,CAAC;AAAA,IAEpC;AAAA,EACJ;AACJ;AAMO,SAAS,iBACZ,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;;;AC5FO,SAAS,oBAAoB,EAAE,SAAS,IAAI,GAAyB;AACxE,MAAI,WAAW,SAAS;AACpB,sCAAkC,OAAO;AAAA,EAC7C;AACA,QAAM,gBAAgB,WAAW,iBAAiB,OAAO;AACzD,SAAO,eAAe,gBAA2B;AAAA,IAC7C;AAAA,IACA;AAAA,EACJ,GAAoD;AAChD,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,cAAc;AAAA,MAChB;AAAA,MACA,SAAS;AAAA,QACL,GAAG;AAAA;AAAA,QAEH,QAAQ;AAAA,QACR,kBAAkB,KAAK,OAAO,SAAS;AAAA,QACvC,gBAAgB;AAAA,MACpB;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,IACJ;AACA,UAAM,WAAW,MAAM,EAAU,KAAK,WAAW;AACjD,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,IAAI,gBAAgB;AAAA,QACtB,SAAS,SAAS;AAAA,QAClB,YAAY,SAAS;AAAA,MACzB,CAAC;AAAA,IACL;AACA,WAAQ,MAAM,SAAS,KAAK;AAAA,EAChC;AACJ","sourcesContent":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","// TODO(https://github.com/solana-labs/solana-web3.js/issues/1787) Write HTTP/2 implementation.\nexport default globalThis.fetch; // The Fetch API is supported natively in Node 18+.\n","type SolanaHttpErrorDetails = Readonly<{\n statusCode: number;\n message: string;\n}>;\n\nexport class SolanaHttpError extends Error {\n readonly statusCode: number;\n constructor(details: SolanaHttpErrorDetails) {\n super(`HTTP error (${details.statusCode}): ${details.message}`);\n Error.captureStackTrace(this, this.constructor);\n this.statusCode = details.statusCode;\n }\n get name() {\n return 'SolanaHttpError';\n }\n}\n","export type AllowedHttpRequestHeaders = Readonly<\n { [headerName: string]: string } & {\n // Someone can still sneak a forbidden header past Typescript if they do something like\n // fOo-BaR, but at that point they deserve the runtime failure.\n [K in DisallowedHeaders | ForbiddenHeaders as\n | K // `Foo-Bar`\n | Capitalize<Lowercase<K>> // `Foo-bar`\n | Lowercase<K> // `foo-bar`\n | Uncapitalize<K> // `foo-Bar`\n // `FOO-BAR`\n | Uppercase<K>]?: never;\n }\n>;\n// These are headers that we simply don't allow the developer to override because they're\n// fundamental to the operation of the JSON-RPC transport.\ntype DisallowedHeaders = 'Accept' | 'Content-Length' | 'Content-Type' | 'Solana-Client';\ntype ForbiddenHeaders =\n | 'Accept-Charset'\n | 'Accept-Encoding'\n | 'Access-Control-Request-Headers'\n | 'Access-Control-Request-Method'\n | 'Connection'\n | 'Content-Length'\n | 'Cookie'\n | 'Date'\n | 'DNT'\n | 'Expect'\n | 'Host'\n | 'Keep-Alive'\n | 'Origin'\n | 'Permissions-Policy'\n // No currently available Typescript technique allows you to match on a prefix.\n // | 'Proxy-'\n // | 'Sec-'\n | 'Referer'\n | 'TE'\n | 'Trailer'\n | 'Transfer-Encoding'\n | 'Upgrade'\n | 'Via';\n\n// These are headers which are fundamental to the JSON-RPC transport, and must not be modified.\nconst DISALLOWED_HEADERS: Record<string, boolean> = {\n accept: true,\n 'content-length': true,\n 'content-type': true,\n};\n// https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name\nconst FORBIDDEN_HEADERS: Record<string, boolean> = {\n 'accept-charset': true,\n 'accept-encoding': true,\n 'access-control-request-headers': true,\n 'access-control-request-method': true,\n connection: true,\n 'content-length': true,\n cookie: true,\n date: true,\n dnt: true,\n expect: true,\n host: true,\n 'keep-alive': true,\n origin: true,\n 'permissions-policy': true,\n // No currently available Typescript technique allows you to match on a prefix.\n // 'proxy-':true,\n // 'sec-':true,\n referer: true,\n te: true,\n trailer: true,\n 'transfer-encoding': true,\n upgrade: true,\n via: true,\n};\n\nexport function assertIsAllowedHttpRequestHeaders(\n headers: Record<string, string>,\n): asserts headers is AllowedHttpRequestHeaders {\n const badHeaders = Object.keys(headers).filter(headerName => {\n const lowercaseHeaderName = headerName.toLowerCase();\n return (\n DISALLOWED_HEADERS[headerName.toLowerCase()] === true ||\n FORBIDDEN_HEADERS[headerName.toLowerCase()] === true ||\n lowercaseHeaderName.startsWith('proxy-') ||\n lowercaseHeaderName.startsWith('sec-')\n );\n });\n if (badHeaders.length > 0) {\n throw new Error(\n `${badHeaders.length > 1 ? 'These headers are' : 'This header is'} forbidden: ` +\n `\\`${badHeaders.join('`, `')}\\`. Learn more at ` +\n 'https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name.',\n );\n }\n}\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers, such as those defined\n * in the `DisallowedHeaders` type.\n */\nexport function normalizeHeaders<T extends Record<string, string>>(\n headers: T,\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n const out: Record<string, string> = {};\n for (const headerName in headers) {\n out[headerName.toLowerCase()] = headers[headerName];\n }\n return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n","import fetchImpl from '@solana/fetch-impl';\nimport { RpcTransport } from '@solana/rpc-spec';\n\nimport { SolanaHttpError } from './http-transport-errors';\nimport {\n AllowedHttpRequestHeaders,\n assertIsAllowedHttpRequestHeaders,\n normalizeHeaders,\n} from './http-transport-headers';\n\ntype Config = Readonly<{\n headers?: AllowedHttpRequestHeaders;\n url: string;\n}>;\n\nexport function createHttpTransport({ headers, url }: Config): RpcTransport {\n if (__DEV__ && headers) {\n assertIsAllowedHttpRequestHeaders(headers);\n }\n const customHeaders = headers && normalizeHeaders(headers);\n return async function makeHttpRequest<TResponse>({\n payload,\n signal,\n }: Parameters<RpcTransport>[0]): Promise<TResponse> {\n const body = JSON.stringify(payload);\n const requestInfo = {\n body,\n headers: {\n ...customHeaders,\n // Keep these headers lowercase so they will override any user-supplied headers above.\n accept: 'application/json',\n 'content-length': body.length.toString(),\n 'content-type': 'application/json; charset=utf-8',\n },\n method: 'POST',\n signal,\n };\n const response = await fetchImpl(url, requestInfo);\n if (!response.ok) {\n throw new SolanaHttpError({\n message: response.statusText,\n statusCode: response.status,\n });\n }\n return (await response.json()) as TResponse;\n };\n}\n"]}
|
package/dist/index.node.js
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
|
-
import { fetch } from 'undici';
|
|
2
|
-
|
|
3
1
|
// ../build-scripts/env-shim.ts
|
|
4
2
|
var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
|
|
5
3
|
|
|
4
|
+
// ../fetch-impl/dist/index.node.js
|
|
5
|
+
var e = globalThis.fetch;
|
|
6
|
+
|
|
6
7
|
// src/http-transport-errors.ts
|
|
7
8
|
var SolanaHttpError = class extends Error {
|
|
8
9
|
statusCode;
|
|
@@ -37,9 +38,9 @@ var FORBIDDEN_HEADERS = {
|
|
|
37
38
|
"keep-alive": true,
|
|
38
39
|
origin: true,
|
|
39
40
|
"permissions-policy": true,
|
|
40
|
-
//
|
|
41
|
-
// 'proxy-':
|
|
42
|
-
// 'sec-':
|
|
41
|
+
// No currently available Typescript technique allows you to match on a prefix.
|
|
42
|
+
// 'proxy-':true,
|
|
43
|
+
// 'sec-':true,
|
|
43
44
|
referer: true,
|
|
44
45
|
te: true,
|
|
45
46
|
trailer: true,
|
|
@@ -67,18 +68,10 @@ function normalizeHeaders(headers) {
|
|
|
67
68
|
}
|
|
68
69
|
|
|
69
70
|
// src/http-transport.ts
|
|
70
|
-
function createHttpTransport(
|
|
71
|
-
if (__DEV__ && false) {
|
|
72
|
-
warnDispatcherWasSuppliedInNonNodeEnvironment();
|
|
73
|
-
}
|
|
74
|
-
const { headers, url } = config;
|
|
71
|
+
function createHttpTransport({ headers, url }) {
|
|
75
72
|
if (__DEV__ && headers) {
|
|
76
73
|
assertIsAllowedHttpRequestHeaders(headers);
|
|
77
74
|
}
|
|
78
|
-
let dispatcherConfig;
|
|
79
|
-
if ("dispatcher_NODE_ONLY" in config) {
|
|
80
|
-
dispatcherConfig = { dispatcher: config.dispatcher_NODE_ONLY };
|
|
81
|
-
}
|
|
82
75
|
const customHeaders = headers && normalizeHeaders(headers);
|
|
83
76
|
return async function makeHttpRequest({
|
|
84
77
|
payload,
|
|
@@ -86,7 +79,6 @@ function createHttpTransport(config) {
|
|
|
86
79
|
}) {
|
|
87
80
|
const body = JSON.stringify(payload);
|
|
88
81
|
const requestInfo = {
|
|
89
|
-
...dispatcherConfig,
|
|
90
82
|
body,
|
|
91
83
|
headers: {
|
|
92
84
|
...customHeaders,
|
|
@@ -98,7 +90,7 @@ function createHttpTransport(config) {
|
|
|
98
90
|
method: "POST",
|
|
99
91
|
signal
|
|
100
92
|
};
|
|
101
|
-
const response = await
|
|
93
|
+
const response = await e(url, requestInfo);
|
|
102
94
|
if (!response.ok) {
|
|
103
95
|
throw new SolanaHttpError({
|
|
104
96
|
message: response.statusText,
|
package/dist/index.node.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.node.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["
|
|
1
|
+
{"version":3,"sources":["../../build-scripts/env-shim.ts","../../fetch-impl/src/index.node.ts","../src/http-transport-errors.ts","../src/http-transport-headers.ts","../src/http-transport.ts"],"names":["index_node_default"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACAvG,IAAOA,IAAQ,WAAW;;;ACInB,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAC9B;AAAA,EACT,YAAY,SAAiC;AACzC,UAAM,eAAe,QAAQ,UAAU,MAAM,QAAQ,OAAO,EAAE;AAC9D,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAC9C,SAAK,aAAa,QAAQ;AAAA,EAC9B;AAAA,EACA,IAAI,OAAO;AACP,WAAO;AAAA,EACX;AACJ;;;AC2BA,IAAM,qBAA8C;AAAA,EAChD,QAAQ;AAAA,EACR,kBAAkB;AAAA,EAClB,gBAAgB;AACpB;AAEA,IAAM,oBAA6C;AAAA,EAC/C,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,kCAAkC;AAAA,EAClC,iCAAiC;AAAA,EACjC,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,sBAAsB;AAAA;AAAA;AAAA;AAAA,EAItB,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,qBAAqB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AACT;AAEO,SAAS,kCACZ,SAC4C;AAC5C,QAAM,aAAa,OAAO,KAAK,OAAO,EAAE,OAAO,gBAAc;AACzD,UAAM,sBAAsB,WAAW,YAAY;AACnD,WACI,mBAAmB,WAAW,YAAY,CAAC,MAAM,QACjD,kBAAkB,WAAW,YAAY,CAAC,MAAM,QAChD,oBAAoB,WAAW,QAAQ,KACvC,oBAAoB,WAAW,MAAM;AAAA,EAE7C,CAAC;AACD,MAAI,WAAW,SAAS,GAAG;AACvB,UAAM,IAAI;AAAA,MACN,GAAG,WAAW,SAAS,IAAI,sBAAsB,gBAAgB,iBACxD,WAAW,KAAK,MAAM,CAAC;AAAA,IAEpC;AAAA,EACJ;AACJ;AAMO,SAAS,iBACZ,SACiD;AACjD,QAAM,MAA8B,CAAC;AACrC,aAAW,cAAc,SAAS;AAC9B,QAAI,WAAW,YAAY,CAAC,IAAI,QAAQ,UAAU;AAAA,EACtD;AACA,SAAO;AACX;;;AC5FO,SAAS,oBAAoB,EAAE,SAAS,IAAI,GAAyB;AACxE,MAAI,WAAW,SAAS;AACpB,sCAAkC,OAAO;AAAA,EAC7C;AACA,QAAM,gBAAgB,WAAW,iBAAiB,OAAO;AACzD,SAAO,eAAe,gBAA2B;AAAA,IAC7C;AAAA,IACA;AAAA,EACJ,GAAoD;AAChD,UAAM,OAAO,KAAK,UAAU,OAAO;AACnC,UAAM,cAAc;AAAA,MAChB;AAAA,MACA,SAAS;AAAA,QACL,GAAG;AAAA;AAAA,QAEH,QAAQ;AAAA,QACR,kBAAkB,KAAK,OAAO,SAAS;AAAA,QACvC,gBAAgB;AAAA,MACpB;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,IACJ;AACA,UAAM,WAAW,MAAM,EAAU,KAAK,WAAW;AACjD,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,IAAI,gBAAgB;AAAA,QACtB,SAAS,SAAS;AAAA,QAClB,YAAY,SAAS;AAAA,MACzB,CAAC;AAAA,IACL;AACA,WAAQ,MAAM,SAAS,KAAK;AAAA,EAChC;AACJ","sourcesContent":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","// TODO(https://github.com/solana-labs/solana-web3.js/issues/1787) Write HTTP/2 implementation.\nexport default globalThis.fetch; // The Fetch API is supported natively in Node 18+.\n","type SolanaHttpErrorDetails = Readonly<{\n statusCode: number;\n message: string;\n}>;\n\nexport class SolanaHttpError extends Error {\n readonly statusCode: number;\n constructor(details: SolanaHttpErrorDetails) {\n super(`HTTP error (${details.statusCode}): ${details.message}`);\n Error.captureStackTrace(this, this.constructor);\n this.statusCode = details.statusCode;\n }\n get name() {\n return 'SolanaHttpError';\n }\n}\n","export type AllowedHttpRequestHeaders = Readonly<\n { [headerName: string]: string } & {\n // Someone can still sneak a forbidden header past Typescript if they do something like\n // fOo-BaR, but at that point they deserve the runtime failure.\n [K in DisallowedHeaders | ForbiddenHeaders as\n | K // `Foo-Bar`\n | Capitalize<Lowercase<K>> // `Foo-bar`\n | Lowercase<K> // `foo-bar`\n | Uncapitalize<K> // `foo-Bar`\n // `FOO-BAR`\n | Uppercase<K>]?: never;\n }\n>;\n// These are headers that we simply don't allow the developer to override because they're\n// fundamental to the operation of the JSON-RPC transport.\ntype DisallowedHeaders = 'Accept' | 'Content-Length' | 'Content-Type' | 'Solana-Client';\ntype ForbiddenHeaders =\n | 'Accept-Charset'\n | 'Accept-Encoding'\n | 'Access-Control-Request-Headers'\n | 'Access-Control-Request-Method'\n | 'Connection'\n | 'Content-Length'\n | 'Cookie'\n | 'Date'\n | 'DNT'\n | 'Expect'\n | 'Host'\n | 'Keep-Alive'\n | 'Origin'\n | 'Permissions-Policy'\n // No currently available Typescript technique allows you to match on a prefix.\n // | 'Proxy-'\n // | 'Sec-'\n | 'Referer'\n | 'TE'\n | 'Trailer'\n | 'Transfer-Encoding'\n | 'Upgrade'\n | 'Via';\n\n// These are headers which are fundamental to the JSON-RPC transport, and must not be modified.\nconst DISALLOWED_HEADERS: Record<string, boolean> = {\n accept: true,\n 'content-length': true,\n 'content-type': true,\n};\n// https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name\nconst FORBIDDEN_HEADERS: Record<string, boolean> = {\n 'accept-charset': true,\n 'accept-encoding': true,\n 'access-control-request-headers': true,\n 'access-control-request-method': true,\n connection: true,\n 'content-length': true,\n cookie: true,\n date: true,\n dnt: true,\n expect: true,\n host: true,\n 'keep-alive': true,\n origin: true,\n 'permissions-policy': true,\n // No currently available Typescript technique allows you to match on a prefix.\n // 'proxy-':true,\n // 'sec-':true,\n referer: true,\n te: true,\n trailer: true,\n 'transfer-encoding': true,\n upgrade: true,\n via: true,\n};\n\nexport function assertIsAllowedHttpRequestHeaders(\n headers: Record<string, string>,\n): asserts headers is AllowedHttpRequestHeaders {\n const badHeaders = Object.keys(headers).filter(headerName => {\n const lowercaseHeaderName = headerName.toLowerCase();\n return (\n DISALLOWED_HEADERS[headerName.toLowerCase()] === true ||\n FORBIDDEN_HEADERS[headerName.toLowerCase()] === true ||\n lowercaseHeaderName.startsWith('proxy-') ||\n lowercaseHeaderName.startsWith('sec-')\n );\n });\n if (badHeaders.length > 0) {\n throw new Error(\n `${badHeaders.length > 1 ? 'These headers are' : 'This header is'} forbidden: ` +\n `\\`${badHeaders.join('`, `')}\\`. Learn more at ` +\n 'https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name.',\n );\n }\n}\n\n/**\n * Lowercasing header names makes it easier to override user-supplied headers, such as those defined\n * in the `DisallowedHeaders` type.\n */\nexport function normalizeHeaders<T extends Record<string, string>>(\n headers: T,\n): { [K in keyof T & string as Lowercase<K>]: T[K] } {\n const out: Record<string, string> = {};\n for (const headerName in headers) {\n out[headerName.toLowerCase()] = headers[headerName];\n }\n return out as { [K in keyof T & string as Lowercase<K>]: T[K] };\n}\n","import fetchImpl from '@solana/fetch-impl';\nimport { RpcTransport } from '@solana/rpc-spec';\n\nimport { SolanaHttpError } from './http-transport-errors';\nimport {\n AllowedHttpRequestHeaders,\n assertIsAllowedHttpRequestHeaders,\n normalizeHeaders,\n} from './http-transport-headers';\n\ntype Config = Readonly<{\n headers?: AllowedHttpRequestHeaders;\n url: string;\n}>;\n\nexport function createHttpTransport({ headers, url }: Config): RpcTransport {\n if (__DEV__ && headers) {\n assertIsAllowedHttpRequestHeaders(headers);\n }\n const customHeaders = headers && normalizeHeaders(headers);\n return async function makeHttpRequest<TResponse>({\n payload,\n signal,\n }: Parameters<RpcTransport>[0]): Promise<TResponse> {\n const body = JSON.stringify(payload);\n const requestInfo = {\n body,\n headers: {\n ...customHeaders,\n // Keep these headers lowercase so they will override any user-supplied headers above.\n accept: 'application/json',\n 'content-length': body.length.toString(),\n 'content-type': 'application/json; charset=utf-8',\n },\n method: 'POST',\n signal,\n };\n const response = await fetchImpl(url, requestInfo);\n if (!response.ok) {\n throw new SolanaHttpError({\n message: response.statusText,\n statusCode: response.status,\n });\n }\n return (await response.json()) as TResponse;\n };\n}\n"]}
|
|
@@ -4,7 +4,7 @@ export type AllowedHttpRequestHeaders = Readonly<{
|
|
|
4
4
|
[K in DisallowedHeaders | ForbiddenHeaders as K | Capitalize<Lowercase<K>> | Lowercase<K> | Uncapitalize<K> | Uppercase<K>]?: never;
|
|
5
5
|
}>;
|
|
6
6
|
type DisallowedHeaders = 'Accept' | 'Content-Length' | 'Content-Type' | 'Solana-Client';
|
|
7
|
-
type ForbiddenHeaders = 'Accept-Charset' | 'Accept-Encoding' | 'Access-Control-Request-Headers' | 'Access-Control-Request-Method' | 'Connection' | 'Content-Length' | 'Cookie' | 'Date' | 'DNT' | 'Expect' | 'Host' | 'Keep-Alive' | 'Origin' | 'Permissions-Policy' |
|
|
7
|
+
type ForbiddenHeaders = 'Accept-Charset' | 'Accept-Encoding' | 'Access-Control-Request-Headers' | 'Access-Control-Request-Method' | 'Connection' | 'Content-Length' | 'Cookie' | 'Date' | 'DNT' | 'Expect' | 'Host' | 'Keep-Alive' | 'Origin' | 'Permissions-Policy' | 'Referer' | 'TE' | 'Trailer' | 'Transfer-Encoding' | 'Upgrade' | 'Via';
|
|
8
8
|
export declare function assertIsAllowedHttpRequestHeaders(headers: Record<string, string>): asserts headers is AllowedHttpRequestHeaders;
|
|
9
9
|
/**
|
|
10
10
|
* Lowercasing header names makes it easier to override user-supplied headers, such as those defined
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http-transport-headers.d.ts","sourceRoot":"","sources":["../../src/http-transport-headers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAC5C;IAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG;KAG9B,CAAC,IAAI,iBAAiB,GAAG,gBAAgB,IACpC,CAAC,GACD,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,CAAC,CAAC,GACZ,YAAY,CAAC,CAAC,CAAC,GAEf,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK;CAC9B,CACJ,CAAC;AAGF,KAAK,iBAAiB,GAAG,QAAQ,GAAG,gBAAgB,GAAG,cAAc,GAAG,eAAe,CAAC;AACxF,KAAK,gBAAgB,GACf,gBAAgB,GAChB,iBAAiB,GACjB,gCAAgC,GAChC,+BAA+B,GAC/B,YAAY,GACZ,gBAAgB,GAChB,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,oBAAoB,
|
|
1
|
+
{"version":3,"file":"http-transport-headers.d.ts","sourceRoot":"","sources":["../../src/http-transport-headers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAC5C;IAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG;KAG9B,CAAC,IAAI,iBAAiB,GAAG,gBAAgB,IACpC,CAAC,GACD,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,CAAC,CAAC,GACZ,YAAY,CAAC,CAAC,CAAC,GAEf,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK;CAC9B,CACJ,CAAC;AAGF,KAAK,iBAAiB,GAAG,QAAQ,GAAG,gBAAgB,GAAG,cAAc,GAAG,eAAe,CAAC;AACxF,KAAK,gBAAgB,GACf,gBAAgB,GAChB,iBAAiB,GACjB,gCAAgC,GAChC,+BAA+B,GAC/B,YAAY,GACZ,gBAAgB,GAChB,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,oBAAoB,GAIpB,SAAS,GACT,IAAI,GACJ,SAAS,GACT,mBAAmB,GACnB,SAAS,GACT,KAAK,CAAC;AAmCZ,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,OAAO,IAAI,yBAAyB,CAiB9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7D,OAAO,EAAE,CAAC,GACX;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAMnD"}
|
|
@@ -1,11 +1,9 @@
|
|
|
1
1
|
import { RpcTransport } from '@solana/rpc-spec';
|
|
2
|
-
import type Dispatcher from 'undici/types/dispatcher';
|
|
3
2
|
import { AllowedHttpRequestHeaders } from './http-transport-headers.js';
|
|
4
3
|
type Config = Readonly<{
|
|
5
|
-
dispatcher_NODE_ONLY?: Dispatcher;
|
|
6
4
|
headers?: AllowedHttpRequestHeaders;
|
|
7
5
|
url: string;
|
|
8
6
|
}>;
|
|
9
|
-
export declare function createHttpTransport(
|
|
7
|
+
export declare function createHttpTransport({ headers, url }: Config): RpcTransport;
|
|
10
8
|
export {};
|
|
11
9
|
//# sourceMappingURL=http-transport.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/http-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/http-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EACH,yBAAyB,EAG5B,MAAM,0BAA0B,CAAC;AAElC,KAAK,MAAM,GAAG,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,GAAG,YAAY,CA+B1E"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@solana/rpc-transport-http",
|
|
3
|
-
"version": "2.0.0-experimental.
|
|
3
|
+
"version": "2.0.0-experimental.356279e",
|
|
4
4
|
"description": "An RPC transport that uses HTTP requests",
|
|
5
5
|
"exports": {
|
|
6
6
|
"browser": {
|
|
@@ -46,8 +46,7 @@
|
|
|
46
46
|
"maintained node versions"
|
|
47
47
|
],
|
|
48
48
|
"dependencies": {
|
|
49
|
-
"
|
|
50
|
-
"@solana/rpc-spec": "2.0.0-experimental.2df278c"
|
|
49
|
+
"@solana/rpc-spec": "2.0.0-experimental.356279e"
|
|
51
50
|
},
|
|
52
51
|
"bundlewatch": {
|
|
53
52
|
"defaultCompression": "gzip",
|