@effect-blockchain/starknet 0.0.0-stage → 0.2.0

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.
Files changed (78) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +12 -2
  3. package/dist/StarknetAddress.d.ts +29 -0
  4. package/dist/StarknetAddress.d.ts.map +1 -0
  5. package/dist/StarknetAddress.js +29 -0
  6. package/dist/StarknetAddress.js.map +1 -0
  7. package/dist/StarknetBlock.d.ts +49 -0
  8. package/dist/StarknetBlock.d.ts.map +1 -0
  9. package/dist/StarknetBlock.js +52 -0
  10. package/dist/StarknetBlock.js.map +1 -0
  11. package/dist/StarknetEvent.d.ts +34 -0
  12. package/dist/StarknetEvent.d.ts.map +1 -0
  13. package/dist/StarknetEvent.js +39 -0
  14. package/dist/StarknetEvent.js.map +1 -0
  15. package/dist/StarknetIndexer.d.ts +157 -0
  16. package/dist/StarknetIndexer.d.ts.map +1 -0
  17. package/dist/StarknetIndexer.js +245 -0
  18. package/dist/StarknetIndexer.js.map +1 -0
  19. package/dist/StarknetNetwork.d.ts +72 -0
  20. package/dist/StarknetNetwork.d.ts.map +1 -0
  21. package/dist/StarknetNetwork.js +83 -0
  22. package/dist/StarknetNetwork.js.map +1 -0
  23. package/dist/StarknetRelayer.d.ts +273 -0
  24. package/dist/StarknetRelayer.d.ts.map +1 -0
  25. package/dist/StarknetRelayer.js +352 -0
  26. package/dist/StarknetRelayer.js.map +1 -0
  27. package/dist/StarknetRpc.d.ts +306 -0
  28. package/dist/StarknetRpc.d.ts.map +1 -0
  29. package/dist/StarknetRpc.js +281 -0
  30. package/dist/StarknetRpc.js.map +1 -0
  31. package/dist/StarknetSigner.d.ts +75 -0
  32. package/dist/StarknetSigner.d.ts.map +1 -0
  33. package/dist/StarknetSigner.js +84 -0
  34. package/dist/StarknetSigner.js.map +1 -0
  35. package/dist/StarknetTransaction.d.ts +74 -0
  36. package/dist/StarknetTransaction.d.ts.map +1 -0
  37. package/dist/StarknetTransaction.js +2 -0
  38. package/dist/StarknetTransaction.js.map +1 -0
  39. package/dist/StarknetTransactionHash.d.ts +22 -0
  40. package/dist/StarknetTransactionHash.d.ts.map +1 -0
  41. package/dist/StarknetTransactionHash.js +22 -0
  42. package/dist/StarknetTransactionHash.js.map +1 -0
  43. package/dist/index.d.ts +44 -0
  44. package/dist/index.d.ts.map +1 -0
  45. package/dist/index.js +45 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/internal/PaddedFelt.d.ts +2 -0
  48. package/dist/internal/PaddedFelt.d.ts.map +1 -0
  49. package/dist/internal/PaddedFelt.js +15 -0
  50. package/dist/internal/PaddedFelt.js.map +1 -0
  51. package/dist/internal/confirmations.d.ts +2 -0
  52. package/dist/internal/confirmations.d.ts.map +1 -0
  53. package/dist/internal/confirmations.js +13 -0
  54. package/dist/internal/confirmations.js.map +1 -0
  55. package/dist/internal/rpcMethods.d.ts +2 -0
  56. package/dist/internal/rpcMethods.d.ts.map +1 -0
  57. package/dist/internal/rpcMethods.js +225 -0
  58. package/dist/internal/rpcMethods.js.map +1 -0
  59. package/dist/internal/transactionHash.d.ts +2 -0
  60. package/dist/internal/transactionHash.d.ts.map +1 -0
  61. package/dist/internal/transactionHash.js +60 -0
  62. package/dist/internal/transactionHash.js.map +1 -0
  63. package/package.json +66 -3
  64. package/src/StarknetAddress.ts +42 -0
  65. package/src/StarknetBlock.ts +54 -0
  66. package/src/StarknetEvent.ts +45 -0
  67. package/src/StarknetIndexer.ts +363 -0
  68. package/src/StarknetNetwork.ts +107 -0
  69. package/src/StarknetRelayer.ts +437 -0
  70. package/src/StarknetRpc.ts +524 -0
  71. package/src/StarknetSigner.ts +115 -0
  72. package/src/StarknetTransaction.ts +68 -0
  73. package/src/StarknetTransactionHash.ts +31 -0
  74. package/src/index.ts +55 -0
  75. package/src/internal/PaddedFelt.ts +18 -0
  76. package/src/internal/confirmations.ts +17 -0
  77. package/src/internal/rpcMethods.ts +224 -0
  78. package/src/internal/transactionHash.ts +64 -0
@@ -0,0 +1,306 @@
1
+ /**
2
+ * Typed Starknet JSON-RPC methods over an ordered list of endpoints with fallback.
3
+ *
4
+ * A call starts at the first endpoint and moves to the next one on failure, except on `WrongNetwork`. Each endpoint
5
+ * is checked once to serve the configured network (`starknet_chainId`). Every method but `addInvokeTransaction`
6
+ * and `addDeployAccountTransaction` is a read, so retries and fallback are safe; these two document their own case.
7
+ * Methods are named after the JSON-RPC method without its namespace (`starknet_getEvents` is `getEvents`). A
8
+ * `getEvents` page cursor is only sent to the endpoint that issued it, with no fallback.
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import type { StarknetAddress } from "@effect-blockchain/starknet/StarknetAddress"
13
+ * import type { StarknetEvent } from "@effect-blockchain/starknet/StarknetEvent"
14
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
15
+ * import * as Effect from "effect/Effect"
16
+ *
17
+ * declare const address: StarknetAddress
18
+ *
19
+ * // every event of `address` in blocks 100 to 200, page by page
20
+ * const events = Effect.gen(function*() {
21
+ * const rpc = yield* StarknetRpc.StarknetRpc
22
+ * const all: Array<StarknetEvent> = []
23
+ * let cursor: StarknetRpc.StarknetEventsCursor | undefined
24
+ * do {
25
+ * const page = yield* rpc.getEvents({ address, fromBlock: BigInt(100), toBlock: BigInt(200), cursor })
26
+ * all.push(...page.events)
27
+ * cursor = page.cursor
28
+ * } while (cursor !== undefined)
29
+ * return all
30
+ * })
31
+ * ```
32
+ *
33
+ * @since 0.1.0
34
+ */
35
+ import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
36
+ import * as Arr from "effect/Array";
37
+ import * as Config from "effect/Config";
38
+ import * as Context from "effect/Context";
39
+ import type * as Duration from "effect/Duration";
40
+ import * as Effect from "effect/Effect";
41
+ import type * as HttpClient from "effect/http/HttpClient";
42
+ import * as Layer from "effect/Layer";
43
+ import type * as Redacted from "effect/Redacted";
44
+ import * as Schema from "effect/Schema";
45
+ import type { StarknetAddress } from "./StarknetAddress.ts";
46
+ import type { StarknetBlock } from "./StarknetBlock.ts";
47
+ import type { StarknetEvent } from "./StarknetEvent.ts";
48
+ import * as StarknetNetwork from "./StarknetNetwork.ts";
49
+ import type { StarknetDeployAccountTransaction, StarknetInvokeTransaction, StarknetTransaction } from "./StarknetTransaction.ts";
50
+ import type { StarknetTransactionHash } from "./StarknetTransactionHash.ts";
51
+ /**
52
+ * A JSON-RPC endpoint. The `name` is shown in errors and spans, the `url` is never logged.
53
+ *
54
+ * @since 0.1.0
55
+ * @category models
56
+ */
57
+ export interface StarknetRpcEndpoint {
58
+ readonly name: string;
59
+ readonly url: Redacted.Redacted<string>;
60
+ }
61
+ declare const StarknetRpcError_base: Schema.Class<StarknetRpcError, Schema.TaggedStruct<"StarknetRpcError", {
62
+ readonly reason: Schema.Union<readonly [typeof JsonRpc.Unavailable, typeof JsonRpc.InvalidResponse, typeof JsonRpc.Lagging, typeof JsonRpc.Pruned, typeof JsonRpc.Rejected, typeof JsonRpc.WrongNetwork]>;
63
+ readonly method: Schema.String;
64
+ readonly endpoint: Schema.String;
65
+ readonly code: Schema.optional<Schema.Number>;
66
+ readonly cause: Schema.Defect;
67
+ }>, import("effect/Cause").YieldableError>;
68
+ /**
69
+ * A failed call: its `reason` (a {@link JsonRpc.Reason}, matched with `Effect.catchReason`), the JSON-RPC error code or
70
+ * HTTP status as `code`, and a `cause` without the endpoint URL. After several endpoints, the error is the last one
71
+ * and `cause` is an `AggregateError` of each endpoint's error, in order.
72
+ *
73
+ * On Starknet, `Unavailable` includes the codes 63 (`UNEXPECTED_ERROR`), -32603, -32005 and 429, `InvalidResponse` an
74
+ * event outside the `getEvents` filter, and `Lagging` a head below the requested block, `BLOCK_NOT_FOUND` (24) and
75
+ * `TXN_HASH_NOT_FOUND` (29).
76
+ *
77
+ * @since 0.1.0
78
+ * @category errors
79
+ */
80
+ export declare class StarknetRpcError extends StarknetRpcError_base {
81
+ /**
82
+ * @since 0.1.0
83
+ */
84
+ get message(): string;
85
+ }
86
+ /**
87
+ * Where to continue a `starknet_getEvents` range: the provider's continuation token and the endpoint that issued it.
88
+ * Opaque: only pass it back to {@link StarknetRpc} `getEvents` with the same filter.
89
+ *
90
+ * @since 0.1.0
91
+ * @category schemas
92
+ */
93
+ export declare const StarknetEventsCursor: Schema.brand<Schema.Struct<{
94
+ readonly endpoint: Schema.String;
95
+ readonly cursor: Schema.String;
96
+ }>, "StarknetEventsCursor">;
97
+ /**
98
+ * @since 0.1.0
99
+ * @category models
100
+ */
101
+ export type StarknetEventsCursor = typeof StarknetEventsCursor.Type;
102
+ /**
103
+ * A `starknet_getEvents` filter over the inclusive block range `[fromBlock, toBlock]`.
104
+ *
105
+ * - `keys` filters by position, an empty position matches any key.
106
+ * - `chunkSize` is the page size, default 1000 (providers commonly cap it at 1024).
107
+ * - `cursor` continues the range from a previous page.
108
+ *
109
+ * @since 0.1.0
110
+ * @category models
111
+ */
112
+ export interface StarknetEventsFilter {
113
+ readonly address: StarknetAddress;
114
+ readonly fromBlock: bigint;
115
+ readonly toBlock: bigint;
116
+ readonly keys?: ReadonlyArray<ReadonlyArray<string>> | undefined;
117
+ readonly chunkSize?: number | undefined;
118
+ readonly cursor?: StarknetEventsCursor | undefined;
119
+ }
120
+ /**
121
+ * One page of events. `cursor` is `undefined` when the range is done.
122
+ *
123
+ * @since 0.1.0
124
+ * @category models
125
+ */
126
+ export interface StarknetEventsPage {
127
+ readonly events: ReadonlyArray<StarknetEvent>;
128
+ readonly cursor: StarknetEventsCursor | undefined;
129
+ }
130
+ /**
131
+ * The part of a confirmed transaction receipt an indexer needs. `events` are in emission order.
132
+ *
133
+ * @since 0.1.0
134
+ * @category models
135
+ */
136
+ export interface StarknetTransactionReceipt {
137
+ readonly transactionHash: StarknetTransactionHash;
138
+ readonly blockNumber: bigint;
139
+ readonly blockHash: string;
140
+ readonly events: ReadonlyArray<Pick<StarknetEvent, "fromAddress" | "keys" | "data">>;
141
+ }
142
+ /**
143
+ * The `starknet_getTransactionStatus` result of the JSON-RPC spec v0.9. `executionStatus` is absent until the
144
+ * transaction is executed (`RECEIVED`, `CANDIDATE`), and `failureReason` is the node's revert message of a `REVERTED`
145
+ * transaction.
146
+ *
147
+ * @since 0.2.0
148
+ * @category models
149
+ */
150
+ export interface StarknetTransactionStatusResult {
151
+ readonly finalityStatus: "RECEIVED" | "CANDIDATE" | "PRE_CONFIRMED" | "ACCEPTED_ON_L2" | "ACCEPTED_ON_L1";
152
+ readonly executionStatus?: "SUCCEEDED" | "REVERTED" | undefined;
153
+ readonly failureReason?: string | undefined;
154
+ }
155
+ /**
156
+ * The block a state read is made at: the latest accepted block, or the pre-confirmed block being built on top of it.
157
+ *
158
+ * @since 0.2.0
159
+ * @category models
160
+ */
161
+ export type StarknetBlockTag = "latest" | "pre_confirmed";
162
+ /**
163
+ * One `starknet_estimateFee` result: the amount of each resource a transaction consumes and its price, in FRI (10^-18
164
+ * STRK) per unit. `overallFee` is their total.
165
+ *
166
+ * @since 0.2.0
167
+ * @category models
168
+ */
169
+ export interface StarknetFeeEstimate {
170
+ readonly l1GasConsumed: bigint;
171
+ readonly l1GasPrice: bigint;
172
+ readonly l1DataGasConsumed: bigint;
173
+ readonly l1DataGasPrice: bigint;
174
+ readonly l2GasConsumed: bigint;
175
+ readonly l2GasPrice: bigint;
176
+ readonly overallFee: bigint;
177
+ }
178
+ declare const StarknetRpc_base: Context.ServiceClass<StarknetRpc, "@effect-blockchain/starknet/StarknetRpc", {
179
+ readonly network: StarknetNetwork.StarknetNetwork;
180
+ /** `starknet_chainId`, verified against `network` once per endpoint then served from that check. */
181
+ readonly chainId: Effect.Effect<StarknetNetwork.StarknetChainId, StarknetRpcError>;
182
+ /** `starknet_blockNumber` */
183
+ readonly blockNumber: Effect.Effect<bigint, StarknetRpcError>;
184
+ /**
185
+ * `starknet_getBlockWithTxHashes`, only answered by an endpoint whose head has reached `blockNumber`. A pre-confirmed
186
+ * block fails with `InvalidResponse`.
187
+ */
188
+ readonly getBlockWithTxHashes: (options: {
189
+ readonly blockNumber: bigint;
190
+ }) => Effect.Effect<StarknetBlock, StarknetRpcError>;
191
+ /**
192
+ * `starknet_getEvents`, one page, only answered by an endpoint whose head has reached `toBlock`. Events keep the
193
+ * provider's order, which is chain order (`event_index` is not always returned to sort them). A pre-confirmed or
194
+ * out-of-filter event fails with `InvalidResponse`, and an empty range returns no events.
195
+ */
196
+ readonly getEvents: (filter: StarknetEventsFilter) => Effect.Effect<StarknetEventsPage, StarknetRpcError>;
197
+ /**
198
+ * `starknet_call`, the raw felts a view function returns at the end of `blockNumber`, only answered by an endpoint
199
+ * whose head has reached `blockNumber`.
200
+ */
201
+ readonly call: (options: {
202
+ readonly contractAddress: StarknetAddress;
203
+ readonly entryPointSelector: string;
204
+ readonly calldata: ReadonlyArray<string>;
205
+ readonly blockNumber: bigint;
206
+ }) => Effect.Effect<ReadonlyArray<string>, StarknetRpcError>;
207
+ /** `starknet_getTransactionReceipt`. A pre-confirmed receipt fails with `InvalidResponse`. */
208
+ readonly getTransactionReceipt: (options: {
209
+ readonly transactionHash: StarknetTransactionHash;
210
+ }) => Effect.Effect<StarknetTransactionReceipt, StarknetRpcError>;
211
+ /**
212
+ * `starknet_getTransactionStatus`, `null` when the last endpoint tried answers `TXN_HASH_NOT_FOUND` (29): an endpoint
213
+ * that does not know the transaction falls back to the next one first.
214
+ */
215
+ readonly getTransactionStatus: (options: {
216
+ readonly transactionHash: StarknetTransactionHash;
217
+ }) => Effect.Effect<StarknetTransactionStatusResult | null, StarknetRpcError>;
218
+ /**
219
+ * `starknet_getNonce`: the nonce of the next transaction of the account at `address`. `pre_confirmed` counts the
220
+ * transactions of the block being built, not the ones still waiting in the mempool. An address without a contract
221
+ * is `Rejected` with the code 20 (`CONTRACT_NOT_FOUND`).
222
+ *
223
+ * @since 0.2.0
224
+ */
225
+ readonly getNonce: (options: {
226
+ readonly address: StarknetAddress;
227
+ readonly blockTag: StarknetBlockTag;
228
+ }) => Effect.Effect<bigint, StarknetRpcError>;
229
+ /**
230
+ * `starknet_estimateFee`: one estimate per transaction, each executed on top of the previous ones at `blockTag`
231
+ * (a reply without an estimate is an `InvalidResponse`).
232
+ * `skipValidate` sends the `SKIP_VALIDATE` flag, which accepts unsigned transactions. A transaction that fails is
233
+ * `Rejected` with the code 41 (`TRANSACTION_EXECUTION_ERROR`) and the node's message in `cause`.
234
+ *
235
+ * @since 0.2.0
236
+ */
237
+ readonly estimateFee: (options: {
238
+ readonly transactions: Arr.NonEmptyReadonlyArray<StarknetTransaction>;
239
+ readonly skipValidate?: boolean | undefined;
240
+ readonly blockTag: StarknetBlockTag;
241
+ }) => Effect.Effect<Arr.NonEmptyReadonlyArray<StarknetFeeEstimate>, StarknetRpcError>;
242
+ /**
243
+ * `starknet_addInvokeTransaction`: submits a signed `INVOKE` transaction and returns its hash. A retry or a fallback
244
+ * sends the same transaction, so it never creates a second one, but a node that already has it refuses the second
245
+ * copy. A refusal (`DUPLICATE_TX`, `INVALID_TRANSACTION_NONCE`, `INSUFFICIENT_ACCOUNT_BALANCE`...) is `Rejected`,
246
+ * with the spec's error code as `code`.
247
+ *
248
+ * @since 0.2.0
249
+ */
250
+ readonly addInvokeTransaction: (options: {
251
+ readonly transaction: StarknetInvokeTransaction;
252
+ }) => Effect.Effect<StarknetTransactionHash, StarknetRpcError>;
253
+ /**
254
+ * `starknet_addDeployAccountTransaction`: submits a signed `DEPLOY_ACCOUNT` transaction and returns its hash and
255
+ * the address of the account. Retries, fallback and refusals are those of `addInvokeTransaction`.
256
+ *
257
+ * @since 0.2.0
258
+ */
259
+ readonly addDeployAccountTransaction: (options: {
260
+ readonly transaction: StarknetDeployAccountTransaction;
261
+ }) => Effect.Effect<{
262
+ readonly transactionHash: StarknetTransactionHash;
263
+ readonly contractAddress: StarknetAddress;
264
+ }, StarknetRpcError>;
265
+ }>;
266
+ /**
267
+ * @since 0.1.0
268
+ * @category services
269
+ */
270
+ export declare class StarknetRpc extends StarknetRpc_base {
271
+ }
272
+ /**
273
+ * Builds a {@link StarknetRpc} over `endpoints`, tried in order, sending requests with the provided `HttpClient`
274
+ * (e.g. `FetchHttpClient.layer`). `timeout` (default 30 seconds) bounds each attempt, `retries` (default 3) and
275
+ * `retryDelay` (default 500 millis) set the backoff before falling back: see {@link JsonRpc.Unavailable}.
276
+ *
277
+ * @since 0.1.0
278
+ * @category layers
279
+ */
280
+ export declare const layer: (options: {
281
+ readonly network: StarknetNetwork.StarknetNetwork;
282
+ readonly endpoints: Arr.NonEmptyReadonlyArray<StarknetRpcEndpoint>;
283
+ readonly timeout?: Duration.Input | undefined;
284
+ readonly retries?: number | undefined;
285
+ readonly retryDelay?: Duration.Input | undefined;
286
+ }) => Layer.Layer<StarknetRpc, never, HttpClient.HttpClient>;
287
+ /**
288
+ * Builds an {@link StarknetRpc} like {@link layer}, reading the options from `Config`. Endpoint URLs stay `Redacted`.
289
+ *
290
+ * @example
291
+ * ```ts
292
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
293
+ * import * as Config from "effect/Config"
294
+ *
295
+ * const RpcLive = StarknetRpc.layerConfig({
296
+ * network: Config.succeed("Starknet"),
297
+ * endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("STARKNET_RPC_URL") })])
298
+ * })
299
+ * ```
300
+ *
301
+ * @since 0.1.0
302
+ * @category layers
303
+ */
304
+ export declare const layerConfig: (options: Config.Wrap<Parameters<typeof layer>[0]>) => Layer.Layer<StarknetRpc, Config.ConfigError, HttpClient.HttpClient>;
305
+ export {};
306
+ //# sourceMappingURL=StarknetRpc.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetRpc.d.ts","sourceRoot":"","sources":["../src/StarknetRpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,OAAO,MAAM,iCAAiC,CAAA;AAC1D,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EACV,gCAAgC,EAChC,yBAAyB,EAEzB,mBAAmB,EACpB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;CACxC;;;;;;;;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,qBAMpC;IACA;;OAEG;IACH,IAAa,OAAO,IAAI,MAAM,CAI7B;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;2BAGY,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAA;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IAC7C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAA;CAClD;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAA;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,CAAA;CACrF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;IACzG,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,eAAe,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;;sBAOmB,eAAe,CAAC,eAAe;IACjD,oGAAoG;sBAClF,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAClF,6BAA6B;0BACP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAC7D;;;OAGG;mCAC4B,CAC7B,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KACtC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACnD;;;;OAIG;wBACiB,CAAC,MAAM,EAAE,oBAAoB,KAAK,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;IACzG;;;OAGG;mBACY,CAAC,OAAO,EAAE;QACvB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;QACzC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;QACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;QACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAC7B,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC5D,8FAA8F;oCAC9D,CAC9B,OAAO,EAAE;QAAE,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAA;KAAE,KAC3D,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,gBAAgB,CAAC;IAChE;;;OAGG;mCAC4B,CAC7B,OAAO,EAAE;QAAE,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAA;KAAE,KAC3D,MAAM,CAAC,MAAM,CAAC,+BAA+B,GAAG,IAAI,EAAE,gBAAgB,CAAC;IAC5E;;;;;;OAMG;uBACgB,CAAC,OAAO,EAAE;QAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;QACjC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;KACpC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAC7C;;;;;;;OAOG;0BACmB,CAAC,OAAO,EAAE;QAC9B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAA;QACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC3C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;KACpC,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;IACrF;;;;;;;OAOG;mCAC4B,CAAC,OAAO,EAAE;QACvC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAA;KAChD,KAAK,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,gBAAgB,CAAC;IAC9D;;;;;OAKG;0CACmC,CAAC,OAAO,EAAE;QAC9C,QAAQ,CAAC,WAAW,EAAE,gCAAgC,CAAA;KACvD,KAAK,MAAM,CAAC,MAAM,CACjB;QAAE,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;KAAE,EAChG,gBAAgB,CACjB;;AA1FH;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAuFc;CAAG;AAoDlD;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,YAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,eAAe,CAAA;IACjD,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAA;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CACjD,KAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAkJtD,CAAA;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,YACb,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAChD,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,UAAU,CACZ,CAAA"}
@@ -0,0 +1,281 @@
1
+ /**
2
+ * Typed Starknet JSON-RPC methods over an ordered list of endpoints with fallback.
3
+ *
4
+ * A call starts at the first endpoint and moves to the next one on failure, except on `WrongNetwork`. Each endpoint
5
+ * is checked once to serve the configured network (`starknet_chainId`). Every method but `addInvokeTransaction`
6
+ * and `addDeployAccountTransaction` is a read, so retries and fallback are safe; these two document their own case.
7
+ * Methods are named after the JSON-RPC method without its namespace (`starknet_getEvents` is `getEvents`). A
8
+ * `getEvents` page cursor is only sent to the endpoint that issued it, with no fallback.
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import type { StarknetAddress } from "@effect-blockchain/starknet/StarknetAddress"
13
+ * import type { StarknetEvent } from "@effect-blockchain/starknet/StarknetEvent"
14
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
15
+ * import * as Effect from "effect/Effect"
16
+ *
17
+ * declare const address: StarknetAddress
18
+ *
19
+ * // every event of `address` in blocks 100 to 200, page by page
20
+ * const events = Effect.gen(function*() {
21
+ * const rpc = yield* StarknetRpc.StarknetRpc
22
+ * const all: Array<StarknetEvent> = []
23
+ * let cursor: StarknetRpc.StarknetEventsCursor | undefined
24
+ * do {
25
+ * const page = yield* rpc.getEvents({ address, fromBlock: BigInt(100), toBlock: BigInt(200), cursor })
26
+ * all.push(...page.events)
27
+ * cursor = page.cursor
28
+ * } while (cursor !== undefined)
29
+ * return all
30
+ * })
31
+ * ```
32
+ *
33
+ * @since 0.1.0
34
+ */
35
+ import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
36
+ import * as Arr from "effect/Array";
37
+ import * as Config from "effect/Config";
38
+ import * as Context from "effect/Context";
39
+ import * as Effect from "effect/Effect";
40
+ import * as Layer from "effect/Layer";
41
+ import * as Ref from "effect/Ref";
42
+ import * as Schema from "effect/Schema";
43
+ import * as RpcMethods from "./internal/rpcMethods.js";
44
+ import * as StarknetNetwork from "./StarknetNetwork.js";
45
+ /**
46
+ * A failed call: its `reason` (a {@link JsonRpc.Reason}, matched with `Effect.catchReason`), the JSON-RPC error code or
47
+ * HTTP status as `code`, and a `cause` without the endpoint URL. After several endpoints, the error is the last one
48
+ * and `cause` is an `AggregateError` of each endpoint's error, in order.
49
+ *
50
+ * On Starknet, `Unavailable` includes the codes 63 (`UNEXPECTED_ERROR`), -32603, -32005 and 429, `InvalidResponse` an
51
+ * event outside the `getEvents` filter, and `Lagging` a head below the requested block, `BLOCK_NOT_FOUND` (24) and
52
+ * `TXN_HASH_NOT_FOUND` (29).
53
+ *
54
+ * @since 0.1.0
55
+ * @category errors
56
+ */
57
+ export class StarknetRpcError extends /*#__PURE__*/Schema.TaggedError()("StarknetRpcError", {
58
+ reason: JsonRpc.Reason,
59
+ method: Schema.String,
60
+ endpoint: Schema.String,
61
+ code: /*#__PURE__*/Schema.optional(Schema.Number),
62
+ cause: /*#__PURE__*/Schema.Defect()
63
+ }) {
64
+ /**
65
+ * @since 0.1.0
66
+ */
67
+ get message() {
68
+ return `${this.method} failed on ${this.endpoint}: ${this.reason._tag}${this.code === undefined ? "" : ` (${this.code})`}`;
69
+ }
70
+ }
71
+ /**
72
+ * Where to continue a `starknet_getEvents` range: the provider's continuation token and the endpoint that issued it.
73
+ * Opaque: only pass it back to {@link StarknetRpc} `getEvents` with the same filter.
74
+ *
75
+ * @since 0.1.0
76
+ * @category schemas
77
+ */
78
+ export const StarknetEventsCursor = /*#__PURE__*/Schema.Struct({
79
+ endpoint: Schema.String,
80
+ cursor: Schema.String
81
+ }).pipe(/*#__PURE__*/Schema.brand("StarknetEventsCursor"));
82
+ /**
83
+ * @since 0.1.0
84
+ * @category services
85
+ */
86
+ export class StarknetRpc extends /*#__PURE__*/Context.Service()("@effect-blockchain/starknet/StarknetRpc") {}
87
+ const TXN_HASH_NOT_FOUND = 29;
88
+ // error codes from the Starknet JSON-RPC spec v0.9 (starknet_api_openrpc.json), plus the common provider ones
89
+ const codes = /*#__PURE__*/new Map([
90
+ // UNEXPECTED_ERROR, JSON-RPC internal error and provider rate limits: the endpoint is struggling, retry then fall back
91
+ [63, "Unavailable"], [-32603, "Unavailable"], [-32005, "Unavailable"], [429, "Unavailable"],
92
+ // BLOCK_NOT_FOUND, TXN_HASH_NOT_FOUND: another endpoint may be further ahead
93
+ [24, "Lagging"], [TXN_HASH_NOT_FOUND, "Lagging"]]);
94
+ const bound = bound => ({
95
+ max_amount: bound.maxAmount,
96
+ max_price_per_unit: bound.maxPricePerUnit
97
+ });
98
+ const v3 = transaction => ({
99
+ version: "0x3",
100
+ signature: transaction.signature,
101
+ nonce: transaction.nonce,
102
+ resource_bounds: {
103
+ l1_gas: bound(transaction.resourceBounds.l1Gas),
104
+ l2_gas: bound(transaction.resourceBounds.l2Gas),
105
+ l1_data_gas: bound(transaction.resourceBounds.l1DataGas)
106
+ },
107
+ tip: transaction.tip,
108
+ paymaster_data: [],
109
+ nonce_data_availability_mode: "L1",
110
+ fee_data_availability_mode: "L1"
111
+ });
112
+ const invoke = transaction => ({
113
+ type: transaction.type,
114
+ sender_address: transaction.senderAddress,
115
+ calldata: transaction.calldata,
116
+ account_deployment_data: [],
117
+ ...v3(transaction)
118
+ });
119
+ const deployAccount = transaction => ({
120
+ type: transaction.type,
121
+ class_hash: transaction.classHash,
122
+ contract_address_salt: transaction.contractAddressSalt,
123
+ constructor_calldata: transaction.constructorCalldata,
124
+ ...v3(transaction)
125
+ });
126
+ /**
127
+ * Builds a {@link StarknetRpc} over `endpoints`, tried in order, sending requests with the provided `HttpClient`
128
+ * (e.g. `FetchHttpClient.layer`). `timeout` (default 30 seconds) bounds each attempt, `retries` (default 3) and
129
+ * `retryDelay` (default 500 millis) set the backoff before falling back: see {@link JsonRpc.Unavailable}.
130
+ *
131
+ * @since 0.1.0
132
+ * @category layers
133
+ */
134
+ export const layer = options => Layer.effect(StarknetRpc, Effect.gen(function* () {
135
+ const {
136
+ network
137
+ } = options;
138
+ const expectedChainId = StarknetNetwork.toChainId(network);
139
+ const rpc = yield* JsonRpc.make({
140
+ spanPrefix: "StarknetRpc",
141
+ network,
142
+ endpoints: options.endpoints,
143
+ timeout: options.timeout,
144
+ retries: options.retries,
145
+ retryDelay: options.retryDelay,
146
+ codes,
147
+ checkNetwork: (send, endpoint) => send(RpcMethods.chainId, {}).pipe(Effect.flatMap(chainId => chainId === expectedChainId ? Effect.succeed(expectedChainId) : Effect.fail(new StarknetRpcError({
148
+ reason: new JsonRpc.WrongNetwork({
149
+ expected: expectedChainId,
150
+ actual: chainId
151
+ }),
152
+ method: RpcMethods.chainId.name,
153
+ endpoint,
154
+ cause: new Error(`expected chain ID ${expectedChainId} for ${network}, got ${chainId}`)
155
+ })))),
156
+ makeError: fields => new StarknetRpcError(fields)
157
+ });
158
+ const blockNumberOn = endpoint => rpc.call(endpoint, RpcMethods.blockNumber, {}).pipe(Effect.tap(head => Ref.update(endpoint.head, known => head > known ? head : known)));
159
+ const getEventsOn = (endpoint, filter) => Effect.gen(function* () {
160
+ const method = RpcMethods.getEvents.name;
161
+ yield* rpc.requireHead(endpoint, method, filter.toBlock, blockNumberOn(endpoint));
162
+ const page = yield* rpc.call(endpoint, RpcMethods.getEvents, {
163
+ filter: {
164
+ address: filter.address,
165
+ from_block: {
166
+ block_number: filter.fromBlock
167
+ },
168
+ to_block: {
169
+ block_number: filter.toBlock
170
+ },
171
+ ...(filter.keys !== undefined && {
172
+ keys: filter.keys
173
+ }),
174
+ chunk_size: filter.chunkSize ?? 1000,
175
+ ...(filter.cursor !== undefined && {
176
+ continuation_token: filter.cursor.cursor
177
+ })
178
+ }
179
+ });
180
+ const invalid = page.events.find(event => event.blockNumber < filter.fromBlock || event.blockNumber > filter.toBlock || event.fromAddress !== filter.address);
181
+ if (invalid !== undefined) {
182
+ return yield* rpc.fail(endpoint, method, new JsonRpc.InvalidResponse(), new Error(`event of ${invalid.transactionHash} in block ${invalid.blockNumber} is outside the filter`));
183
+ }
184
+ return {
185
+ events: page.events,
186
+ cursor: page.continuation_token === undefined ? undefined : StarknetEventsCursor.make({
187
+ endpoint: endpoint.name,
188
+ cursor: page.continuation_token
189
+ })
190
+ };
191
+ });
192
+ const getEvents = filter => {
193
+ if (filter.fromBlock > filter.toBlock) return Effect.succeed({
194
+ events: [],
195
+ cursor: undefined
196
+ });
197
+ if (filter.cursor === undefined) return rpc.withFallback(endpoint => getEventsOn(endpoint, filter));
198
+ // a cursor only means something to the endpoint that issued it
199
+ return rpc.endpointOf(RpcMethods.getEvents.name, filter.cursor).pipe(Effect.flatMap(endpoint => getEventsOn(endpoint, filter)));
200
+ };
201
+ return StarknetRpc.of({
202
+ network,
203
+ chainId: rpc.withFallback(rpc.checkNetwork),
204
+ blockNumber: rpc.withFallback(blockNumberOn),
205
+ getBlockWithTxHashes: ({
206
+ blockNumber
207
+ }) => rpc.withFallback(endpoint => rpc.requireHead(endpoint, RpcMethods.getBlockWithTxHashes.name, blockNumber, blockNumberOn(endpoint)).pipe(Effect.andThen(rpc.call(endpoint, RpcMethods.getBlockWithTxHashes, {
208
+ block_id: {
209
+ block_number: blockNumber
210
+ }
211
+ })))),
212
+ getEvents,
213
+ call: options => rpc.withFallback(endpoint => rpc.requireHead(endpoint, RpcMethods.call.name, options.blockNumber, blockNumberOn(endpoint)).pipe(Effect.andThen(rpc.call(endpoint, RpcMethods.call, {
214
+ request: {
215
+ contract_address: options.contractAddress,
216
+ entry_point_selector: options.entryPointSelector,
217
+ calldata: options.calldata
218
+ },
219
+ block_id: {
220
+ block_number: options.blockNumber
221
+ }
222
+ })))),
223
+ getTransactionReceipt: ({
224
+ transactionHash
225
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.getTransactionReceipt, {
226
+ transaction_hash: transactionHash
227
+ })),
228
+ getTransactionStatus: ({
229
+ transactionHash
230
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.getTransactionStatus, {
231
+ transaction_hash: transactionHash
232
+ })).pipe(Effect.catchIf(error => error.code === TXN_HASH_NOT_FOUND, () => Effect.succeed(null))),
233
+ getNonce: ({
234
+ address,
235
+ blockTag
236
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.getNonce, {
237
+ block_id: blockTag,
238
+ contract_address: address
239
+ })),
240
+ estimateFee: ({
241
+ blockTag,
242
+ skipValidate,
243
+ transactions
244
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.estimateFee, {
245
+ request: Arr.map(transactions, transaction => transaction.type === "INVOKE" ? invoke(transaction) : deployAccount(transaction)),
246
+ simulation_flags: skipValidate === true ? ["SKIP_VALIDATE"] : [],
247
+ block_id: blockTag
248
+ })),
249
+ addInvokeTransaction: ({
250
+ transaction
251
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.addInvokeTransaction, {
252
+ invoke_transaction: invoke(transaction)
253
+ })).pipe(Effect.map(({
254
+ transactionHash
255
+ }) => transactionHash)),
256
+ addDeployAccountTransaction: ({
257
+ transaction
258
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.addDeployAccountTransaction, {
259
+ deploy_account_transaction: deployAccount(transaction)
260
+ }))
261
+ });
262
+ }));
263
+ /**
264
+ * Builds an {@link StarknetRpc} like {@link layer}, reading the options from `Config`. Endpoint URLs stay `Redacted`.
265
+ *
266
+ * @example
267
+ * ```ts
268
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
269
+ * import * as Config from "effect/Config"
270
+ *
271
+ * const RpcLive = StarknetRpc.layerConfig({
272
+ * network: Config.succeed("Starknet"),
273
+ * endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("STARKNET_RPC_URL") })])
274
+ * })
275
+ * ```
276
+ *
277
+ * @since 0.1.0
278
+ * @category layers
279
+ */
280
+ export const layerConfig = options => Layer.unwrap(Effect.map(Config.unwrap(options), layer));
281
+ //# sourceMappingURL=StarknetRpc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetRpc.js","names":[],"sources":["../src/StarknetRpc.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}