@effect-blockchain/starknet 0.0.0-stage → 0.1.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 (53) 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 +119 -0
  16. package/dist/StarknetIndexer.d.ts.map +1 -0
  17. package/dist/StarknetIndexer.js +170 -0
  18. package/dist/StarknetIndexer.js.map +1 -0
  19. package/dist/StarknetNetwork.d.ts +63 -0
  20. package/dist/StarknetNetwork.d.ts.map +1 -0
  21. package/dist/StarknetNetwork.js +74 -0
  22. package/dist/StarknetNetwork.js.map +1 -0
  23. package/dist/StarknetRpc.d.ts +204 -0
  24. package/dist/StarknetRpc.d.ts.map +1 -0
  25. package/dist/StarknetRpc.js +203 -0
  26. package/dist/StarknetRpc.js.map +1 -0
  27. package/dist/StarknetTransactionHash.d.ts +22 -0
  28. package/dist/StarknetTransactionHash.d.ts.map +1 -0
  29. package/dist/StarknetTransactionHash.js +22 -0
  30. package/dist/StarknetTransactionHash.js.map +1 -0
  31. package/dist/index.d.ts +32 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +33 -0
  34. package/dist/index.js.map +1 -0
  35. package/dist/internal/PaddedFelt.d.ts +2 -0
  36. package/dist/internal/PaddedFelt.d.ts.map +1 -0
  37. package/dist/internal/PaddedFelt.js +15 -0
  38. package/dist/internal/PaddedFelt.js.map +1 -0
  39. package/dist/internal/rpcMethods.d.ts +2 -0
  40. package/dist/internal/rpcMethods.d.ts.map +1 -0
  41. package/dist/internal/rpcMethods.js +90 -0
  42. package/dist/internal/rpcMethods.js.map +1 -0
  43. package/package.json +66 -3
  44. package/src/StarknetAddress.ts +42 -0
  45. package/src/StarknetBlock.ts +54 -0
  46. package/src/StarknetEvent.ts +45 -0
  47. package/src/StarknetIndexer.ts +248 -0
  48. package/src/StarknetNetwork.ts +95 -0
  49. package/src/StarknetRpc.ts +332 -0
  50. package/src/StarknetTransactionHash.ts +31 -0
  51. package/src/index.ts +40 -0
  52. package/src/internal/PaddedFelt.ts +18 -0
  53. package/src/internal/rpcMethods.ts +88 -0
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Named Starknet networks and their chain IDs.
3
+ *
4
+ * @since 0.1.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ /**
8
+ * @since 0.1.0
9
+ * @category constants
10
+ */
11
+ export declare const mainnets: readonly ["Starknet"];
12
+ /**
13
+ * @since 0.1.0
14
+ * @category constants
15
+ */
16
+ export declare const testnets: readonly ["StarknetSepolia"];
17
+ /**
18
+ * Every supported network, mainnets first.
19
+ *
20
+ * @since 0.1.0
21
+ * @category constants
22
+ */
23
+ export declare const networks: readonly ["Starknet", "StarknetSepolia"];
24
+ /**
25
+ * @since 0.1.0
26
+ * @category schemas
27
+ */
28
+ export declare const StarknetNetwork: Schema.Literals<readonly ["Starknet", "StarknetSepolia"]>;
29
+ /**
30
+ * @since 0.1.0
31
+ * @category models
32
+ */
33
+ export type StarknetNetwork = typeof StarknetNetwork.Type;
34
+ /**
35
+ * A Starknet chain ID, the short string `starknet_chainId` returns.
36
+ *
37
+ * @since 0.1.0
38
+ * @category schemas
39
+ */
40
+ export declare const StarknetChainId: Schema.Literals<readonly ["SN_MAIN", "SN_SEPOLIA"]>;
41
+ /**
42
+ * @since 0.1.0
43
+ * @category models
44
+ */
45
+ export type StarknetChainId = typeof StarknetChainId.Type;
46
+ /**
47
+ * @since 0.1.0
48
+ * @category conversions
49
+ */
50
+ export declare const toChainId: (network: StarknetNetwork) => StarknetChainId;
51
+ /**
52
+ * Default number of confirmations an indexer waits for on each network, on top of the latest accepted block.
53
+ *
54
+ * @since 0.1.0
55
+ * @category getters
56
+ */
57
+ export declare const defaultConfirmations: (network: StarknetNetwork) => number;
58
+ /**
59
+ * @since 0.1.0
60
+ * @category predicates
61
+ */
62
+ export declare const isTestnet: (network: StarknetNetwork) => boolean;
63
+ //# sourceMappingURL=StarknetNetwork.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetNetwork.d.ts","sourceRoot":"","sources":["../src/StarknetNetwork.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,QAAQ,YAAI,UAAU,CAAU,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,QAAQ,YAAI,iBAAiB,CAAU,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,0CAAsC,CAAA;AAE3D;;;GAGG;AACH,eAAO,MAAM,eAAe,2DAI1B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,qDAI1B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAOzD;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,eAAe,KAAG,eAAoC,CAAA;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,eAAe,KAAG,MAS/D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,eAAe,KAAG,OACW,CAAA"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Named Starknet networks and their chain IDs.
3
+ *
4
+ * @since 0.1.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ /**
8
+ * @since 0.1.0
9
+ * @category constants
10
+ */
11
+ export const mainnets = ["Starknet"];
12
+ /**
13
+ * @since 0.1.0
14
+ * @category constants
15
+ */
16
+ export const testnets = ["StarknetSepolia"];
17
+ /**
18
+ * Every supported network, mainnets first.
19
+ *
20
+ * @since 0.1.0
21
+ * @category constants
22
+ */
23
+ export const networks = [...mainnets, ...testnets];
24
+ /**
25
+ * @since 0.1.0
26
+ * @category schemas
27
+ */
28
+ export const StarknetNetwork = /*#__PURE__*/Schema.Literals(networks).annotate({
29
+ identifier: "StarknetNetwork",
30
+ title: "Starknet network",
31
+ description: "a Starknet network name: \"Starknet\" (mainnet) or \"StarknetSepolia\" (testnet)"
32
+ });
33
+ /**
34
+ * A Starknet chain ID, the short string `starknet_chainId` returns.
35
+ *
36
+ * @since 0.1.0
37
+ * @category schemas
38
+ */
39
+ export const StarknetChainId = /*#__PURE__*/Schema.Literals(["SN_MAIN", "SN_SEPOLIA"]).annotate({
40
+ identifier: "StarknetChainId",
41
+ title: "Starknet chain ID",
42
+ description: "a Starknet chain ID as a short string: \"SN_MAIN\" or \"SN_SEPOLIA\""
43
+ });
44
+ const chainIds = {
45
+ Starknet: "SN_MAIN",
46
+ StarknetSepolia: "SN_SEPOLIA"
47
+ };
48
+ /**
49
+ * @since 0.1.0
50
+ * @category conversions
51
+ */
52
+ export const toChainId = network => chainIds[network];
53
+ /**
54
+ * Default number of confirmations an indexer waits for on each network, on top of the latest accepted block.
55
+ *
56
+ * @since 0.1.0
57
+ * @category getters
58
+ */
59
+ export const defaultConfirmations = network => {
60
+ switch (network) {
61
+ // ACCEPTED_ON_L2 blocks are "finalized by the consensus protocol": https://docs.starknet.io/learn/protocol/transactions
62
+ case "Starknet":
63
+ return 0;
64
+ // same protocol and finality rules as mainnet: https://docs.starknet.io/learn/protocol/transactions
65
+ case "StarknetSepolia":
66
+ return 0;
67
+ }
68
+ };
69
+ /**
70
+ * @since 0.1.0
71
+ * @category predicates
72
+ */
73
+ export const isTestnet = network => testnets.includes(network);
74
+ //# sourceMappingURL=StarknetNetwork.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetNetwork.js","names":[],"sources":["../src/StarknetNetwork.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AAEvC;;;;AAIA,OAAO,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAU;AAE7C;;;;AAIA,OAAO,MAAM,QAAQ,GAAG,CAAC,iBAAiB,CAAU;AAEpD;;;;;;AAMA,OAAO,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAU;AAE3D;;;;AAIA,OAAO,MAAM,eAAe,gBAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;EAChE,UAAU,EAAE,iBAAiB;EAC7B,KAAK,EAAE,kBAAkB;EACzB,WAAW,EAAE;CACd,CAAC;AAQF;;;;;;AAMA,OAAO,MAAM,eAAe,gBAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;EACjF,UAAU,EAAE,iBAAiB;EAC7B,KAAK,EAAE,mBAAmB;EAC1B,WAAW,EAAE;CACd,CAAC;AAQF,MAAM,QAAQ,GAA6C;EACzD,QAAQ,EAAE,SAAS;EACnB,eAAe,EAAE;CAClB;AAED;;;;AAIA,OAAO,MAAM,SAAS,GAAI,OAAwB,IAAsB,QAAQ,CAAC,OAAO,CAAC;AAEzF;;;;;;AAMA,OAAO,MAAM,oBAAoB,GAAI,OAAwB,IAAY;EACvE,QAAQ,OAAO;IACb;IACA,KAAK,UAAU;MACb,OAAO,CAAC;IACV;IACA,KAAK,iBAAiB;MACpB,OAAO,CAAC;EACZ;AACF,CAAC;AAED;;;;AAIA,OAAO,MAAM,SAAS,GAAI,OAAwB,IAC/C,QAA2C,CAAC,QAAQ,CAAC,OAAO,CAAC","ignoreList":[]}
@@ -0,0 +1,204 @@
1
+ /**
2
+ * Typed, read-only 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 is a read, so retries and
6
+ * fallback are safe. Methods are named after the JSON-RPC method without its namespace (`starknet_getEvents` is
7
+ * `getEvents`). A `getEvents` page cursor is only sent to the endpoint that issued it, with no fallback.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * import type { StarknetAddress } from "@effect-blockchain/starknet/StarknetAddress"
12
+ * import type { StarknetEvent } from "@effect-blockchain/starknet/StarknetEvent"
13
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
14
+ * import * as Effect from "effect/Effect"
15
+ *
16
+ * declare const address: StarknetAddress
17
+ *
18
+ * // every event of `address` in blocks 100 to 200, page by page
19
+ * const events = Effect.gen(function*() {
20
+ * const rpc = yield* StarknetRpc.StarknetRpc
21
+ * const all: Array<StarknetEvent> = []
22
+ * let cursor: StarknetRpc.StarknetEventsCursor | undefined
23
+ * do {
24
+ * const page = yield* rpc.getEvents({ address, fromBlock: BigInt(100), toBlock: BigInt(200), cursor })
25
+ * all.push(...page.events)
26
+ * cursor = page.cursor
27
+ * } while (cursor !== undefined)
28
+ * return all
29
+ * })
30
+ * ```
31
+ *
32
+ * @since 0.1.0
33
+ */
34
+ import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
35
+ import type * as Arr from "effect/Array";
36
+ import * as Config from "effect/Config";
37
+ import * as Context from "effect/Context";
38
+ import type * as Duration from "effect/Duration";
39
+ import * as Effect from "effect/Effect";
40
+ import type * as HttpClient from "effect/http/HttpClient";
41
+ import * as Layer from "effect/Layer";
42
+ import type * as Redacted from "effect/Redacted";
43
+ import * as Schema from "effect/Schema";
44
+ import type { StarknetAddress } from "./StarknetAddress.ts";
45
+ import type { StarknetBlock } from "./StarknetBlock.ts";
46
+ import type { StarknetEvent } from "./StarknetEvent.ts";
47
+ import * as StarknetNetwork from "./StarknetNetwork.ts";
48
+ import type { StarknetTransactionHash } from "./StarknetTransactionHash.ts";
49
+ /**
50
+ * A JSON-RPC endpoint. The `name` is shown in errors and spans, the `url` is never logged.
51
+ *
52
+ * @since 0.1.0
53
+ * @category models
54
+ */
55
+ export interface StarknetRpcEndpoint {
56
+ readonly name: string;
57
+ readonly url: Redacted.Redacted<string>;
58
+ }
59
+ declare const StarknetRpcError_base: Schema.Class<StarknetRpcError, Schema.TaggedStruct<"StarknetRpcError", {
60
+ readonly reason: Schema.Union<readonly [typeof JsonRpc.Unavailable, typeof JsonRpc.InvalidResponse, typeof JsonRpc.Lagging, typeof JsonRpc.Pruned, typeof JsonRpc.Rejected, typeof JsonRpc.WrongNetwork]>;
61
+ readonly method: Schema.String;
62
+ readonly endpoint: Schema.String;
63
+ readonly code: Schema.optional<Schema.Number>;
64
+ readonly cause: Schema.Defect;
65
+ }>, import("effect/Cause").YieldableError>;
66
+ /**
67
+ * A failed call: its `reason` (a {@link JsonRpc.Reason}, matched with `Effect.catchReason`), the JSON-RPC error code or
68
+ * HTTP status as `code`, and a `cause` without the endpoint URL. After several endpoints, the error is the last one
69
+ * and `cause` is an `AggregateError` of each endpoint's error, in order.
70
+ *
71
+ * On Starknet, `Unavailable` includes the codes 63 (`UNEXPECTED_ERROR`), -32603, -32005 and 429, `InvalidResponse` an
72
+ * event outside the `getEvents` filter, and `Lagging` a head below the requested block, `BLOCK_NOT_FOUND` (24) and
73
+ * `TXN_HASH_NOT_FOUND` (29).
74
+ *
75
+ * @since 0.1.0
76
+ * @category errors
77
+ */
78
+ export declare class StarknetRpcError extends StarknetRpcError_base {
79
+ /**
80
+ * @since 0.1.0
81
+ */
82
+ get message(): string;
83
+ }
84
+ /**
85
+ * Where to continue a `starknet_getEvents` range: the provider's continuation token and the endpoint that issued it.
86
+ * Opaque: only pass it back to {@link StarknetRpc} `getEvents` with the same filter.
87
+ *
88
+ * @since 0.1.0
89
+ * @category schemas
90
+ */
91
+ export declare const StarknetEventsCursor: Schema.brand<Schema.Struct<{
92
+ readonly endpoint: Schema.String;
93
+ readonly cursor: Schema.String;
94
+ }>, "StarknetEventsCursor">;
95
+ /**
96
+ * @since 0.1.0
97
+ * @category models
98
+ */
99
+ export type StarknetEventsCursor = typeof StarknetEventsCursor.Type;
100
+ /**
101
+ * A `starknet_getEvents` filter over the inclusive block range `[fromBlock, toBlock]`.
102
+ *
103
+ * - `keys` filters by position, an empty position matches any key.
104
+ * - `chunkSize` is the page size, default 1000 (providers commonly cap it at 1024).
105
+ * - `cursor` continues the range from a previous page.
106
+ *
107
+ * @since 0.1.0
108
+ * @category models
109
+ */
110
+ export interface StarknetEventsFilter {
111
+ readonly address: StarknetAddress;
112
+ readonly fromBlock: bigint;
113
+ readonly toBlock: bigint;
114
+ readonly keys?: ReadonlyArray<ReadonlyArray<string>> | undefined;
115
+ readonly chunkSize?: number | undefined;
116
+ readonly cursor?: StarknetEventsCursor | undefined;
117
+ }
118
+ /**
119
+ * One page of events. `cursor` is `undefined` when the range is done.
120
+ *
121
+ * @since 0.1.0
122
+ * @category models
123
+ */
124
+ export interface StarknetEventsPage {
125
+ readonly events: ReadonlyArray<StarknetEvent>;
126
+ readonly cursor: StarknetEventsCursor | undefined;
127
+ }
128
+ /**
129
+ * The part of a confirmed transaction receipt an indexer needs. `events` are in emission order.
130
+ *
131
+ * @since 0.1.0
132
+ * @category models
133
+ */
134
+ export interface StarknetTransactionReceipt {
135
+ readonly transactionHash: StarknetTransactionHash;
136
+ readonly blockNumber: bigint;
137
+ readonly blockHash: string;
138
+ readonly events: ReadonlyArray<Pick<StarknetEvent, "fromAddress" | "keys" | "data">>;
139
+ }
140
+ declare const StarknetRpc_base: Context.ServiceClass<StarknetRpc, "@effect-blockchain/starknet/StarknetRpc", {
141
+ readonly network: StarknetNetwork.StarknetNetwork;
142
+ /** `starknet_chainId`, verified against `network` once per endpoint then served from that check. */
143
+ readonly chainId: Effect.Effect<StarknetNetwork.StarknetChainId, StarknetRpcError>;
144
+ /** `starknet_blockNumber` */
145
+ readonly blockNumber: Effect.Effect<bigint, StarknetRpcError>;
146
+ /**
147
+ * `starknet_getBlockWithTxHashes`, only answered by an endpoint whose head has reached `blockNumber`. A pre-confirmed
148
+ * block fails with `InvalidResponse`.
149
+ */
150
+ readonly getBlockWithTxHashes: (options: {
151
+ readonly blockNumber: bigint;
152
+ }) => Effect.Effect<StarknetBlock, StarknetRpcError>;
153
+ /**
154
+ * `starknet_getEvents`, one page, only answered by an endpoint whose head has reached `toBlock`. Events keep the
155
+ * provider's order, which is chain order (`event_index` is not always returned to sort them). A pre-confirmed or
156
+ * out-of-filter event fails with `InvalidResponse`, and an empty range returns no events.
157
+ */
158
+ readonly getEvents: (filter: StarknetEventsFilter) => Effect.Effect<StarknetEventsPage, StarknetRpcError>;
159
+ /** `starknet_getTransactionReceipt`. A pre-confirmed receipt fails with `InvalidResponse`. */
160
+ readonly getTransactionReceipt: (options: {
161
+ readonly transactionHash: StarknetTransactionHash;
162
+ }) => Effect.Effect<StarknetTransactionReceipt, StarknetRpcError>;
163
+ }>;
164
+ /**
165
+ * @since 0.1.0
166
+ * @category services
167
+ */
168
+ export declare class StarknetRpc extends StarknetRpc_base {
169
+ }
170
+ /**
171
+ * Builds a {@link StarknetRpc} over `endpoints`, tried in order, sending requests with the provided `HttpClient`
172
+ * (e.g. `FetchHttpClient.layer`). `timeout` (default 30 seconds) bounds each attempt, `retries` (default 3) and
173
+ * `retryDelay` (default 500 millis) set the backoff before falling back: see {@link JsonRpc.Unavailable}.
174
+ *
175
+ * @since 0.1.0
176
+ * @category layers
177
+ */
178
+ export declare const layer: (options: {
179
+ readonly network: StarknetNetwork.StarknetNetwork;
180
+ readonly endpoints: Arr.NonEmptyReadonlyArray<StarknetRpcEndpoint>;
181
+ readonly timeout?: Duration.Input | undefined;
182
+ readonly retries?: number | undefined;
183
+ readonly retryDelay?: Duration.Input | undefined;
184
+ }) => Layer.Layer<StarknetRpc, never, HttpClient.HttpClient>;
185
+ /**
186
+ * Builds an {@link StarknetRpc} like {@link layer}, reading the options from `Config`. Endpoint URLs stay `Redacted`.
187
+ *
188
+ * @example
189
+ * ```ts
190
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
191
+ * import * as Config from "effect/Config"
192
+ *
193
+ * const RpcLive = StarknetRpc.layerConfig({
194
+ * network: Config.succeed("Starknet"),
195
+ * endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("STARKNET_RPC_URL") })])
196
+ * })
197
+ * ```
198
+ *
199
+ * @since 0.1.0
200
+ * @category layers
201
+ */
202
+ export declare const layerConfig: (options: Config.Wrap<Parameters<typeof layer>[0]>) => Layer.Layer<StarknetRpc, Config.ConfigError, HttpClient.HttpClient>;
203
+ export {};
204
+ //# sourceMappingURL=StarknetRpc.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetRpc.d.ts","sourceRoot":"","sources":["../src/StarknetRpc.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,203 @@
1
+ /**
2
+ * Typed, read-only 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 is a read, so retries and
6
+ * fallback are safe. Methods are named after the JSON-RPC method without its namespace (`starknet_getEvents` is
7
+ * `getEvents`). A `getEvents` page cursor is only sent to the endpoint that issued it, with no fallback.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * import type { StarknetAddress } from "@effect-blockchain/starknet/StarknetAddress"
12
+ * import type { StarknetEvent } from "@effect-blockchain/starknet/StarknetEvent"
13
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
14
+ * import * as Effect from "effect/Effect"
15
+ *
16
+ * declare const address: StarknetAddress
17
+ *
18
+ * // every event of `address` in blocks 100 to 200, page by page
19
+ * const events = Effect.gen(function*() {
20
+ * const rpc = yield* StarknetRpc.StarknetRpc
21
+ * const all: Array<StarknetEvent> = []
22
+ * let cursor: StarknetRpc.StarknetEventsCursor | undefined
23
+ * do {
24
+ * const page = yield* rpc.getEvents({ address, fromBlock: BigInt(100), toBlock: BigInt(200), cursor })
25
+ * all.push(...page.events)
26
+ * cursor = page.cursor
27
+ * } while (cursor !== undefined)
28
+ * return all
29
+ * })
30
+ * ```
31
+ *
32
+ * @since 0.1.0
33
+ */
34
+ import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
35
+ import * as Config from "effect/Config";
36
+ import * as Context from "effect/Context";
37
+ import * as Effect from "effect/Effect";
38
+ import * as Layer from "effect/Layer";
39
+ import * as Ref from "effect/Ref";
40
+ import * as Schema from "effect/Schema";
41
+ import * as RpcMethods from "./internal/rpcMethods.js";
42
+ import * as StarknetNetwork from "./StarknetNetwork.js";
43
+ /**
44
+ * A failed call: its `reason` (a {@link JsonRpc.Reason}, matched with `Effect.catchReason`), the JSON-RPC error code or
45
+ * HTTP status as `code`, and a `cause` without the endpoint URL. After several endpoints, the error is the last one
46
+ * and `cause` is an `AggregateError` of each endpoint's error, in order.
47
+ *
48
+ * On Starknet, `Unavailable` includes the codes 63 (`UNEXPECTED_ERROR`), -32603, -32005 and 429, `InvalidResponse` an
49
+ * event outside the `getEvents` filter, and `Lagging` a head below the requested block, `BLOCK_NOT_FOUND` (24) and
50
+ * `TXN_HASH_NOT_FOUND` (29).
51
+ *
52
+ * @since 0.1.0
53
+ * @category errors
54
+ */
55
+ export class StarknetRpcError extends /*#__PURE__*/Schema.TaggedError()("StarknetRpcError", {
56
+ reason: JsonRpc.Reason,
57
+ method: Schema.String,
58
+ endpoint: Schema.String,
59
+ code: /*#__PURE__*/Schema.optional(Schema.Number),
60
+ cause: /*#__PURE__*/Schema.Defect()
61
+ }) {
62
+ /**
63
+ * @since 0.1.0
64
+ */
65
+ get message() {
66
+ return `${this.method} failed on ${this.endpoint}: ${this.reason._tag}${this.code === undefined ? "" : ` (${this.code})`}`;
67
+ }
68
+ }
69
+ /**
70
+ * Where to continue a `starknet_getEvents` range: the provider's continuation token and the endpoint that issued it.
71
+ * Opaque: only pass it back to {@link StarknetRpc} `getEvents` with the same filter.
72
+ *
73
+ * @since 0.1.0
74
+ * @category schemas
75
+ */
76
+ export const StarknetEventsCursor = /*#__PURE__*/Schema.Struct({
77
+ endpoint: Schema.String,
78
+ cursor: Schema.String
79
+ }).pipe(/*#__PURE__*/Schema.brand("StarknetEventsCursor"));
80
+ /**
81
+ * @since 0.1.0
82
+ * @category services
83
+ */
84
+ export class StarknetRpc extends /*#__PURE__*/Context.Service()("@effect-blockchain/starknet/StarknetRpc") {}
85
+ // error codes from the Starknet JSON-RPC spec v0.9 (starknet_api_openrpc.json), plus the common provider ones
86
+ const codes = /*#__PURE__*/new Map([
87
+ // UNEXPECTED_ERROR, JSON-RPC internal error and provider rate limits: the endpoint is struggling, retry then fall back
88
+ [63, "Unavailable"], [-32603, "Unavailable"], [-32005, "Unavailable"], [429, "Unavailable"],
89
+ // BLOCK_NOT_FOUND, TXN_HASH_NOT_FOUND: another endpoint may be further ahead
90
+ [24, "Lagging"], [29, "Lagging"]]);
91
+ /**
92
+ * Builds a {@link StarknetRpc} over `endpoints`, tried in order, sending requests with the provided `HttpClient`
93
+ * (e.g. `FetchHttpClient.layer`). `timeout` (default 30 seconds) bounds each attempt, `retries` (default 3) and
94
+ * `retryDelay` (default 500 millis) set the backoff before falling back: see {@link JsonRpc.Unavailable}.
95
+ *
96
+ * @since 0.1.0
97
+ * @category layers
98
+ */
99
+ export const layer = options => Layer.effect(StarknetRpc, Effect.gen(function* () {
100
+ const {
101
+ network
102
+ } = options;
103
+ const expectedChainId = StarknetNetwork.toChainId(network);
104
+ const rpc = yield* JsonRpc.make({
105
+ spanPrefix: "StarknetRpc",
106
+ network,
107
+ endpoints: options.endpoints,
108
+ timeout: options.timeout,
109
+ retries: options.retries,
110
+ retryDelay: options.retryDelay,
111
+ codes,
112
+ checkNetwork: (send, endpoint) => send(RpcMethods.chainId, {}).pipe(Effect.flatMap(chainId => chainId === expectedChainId ? Effect.succeed(expectedChainId) : Effect.fail(new StarknetRpcError({
113
+ reason: new JsonRpc.WrongNetwork({
114
+ expected: expectedChainId,
115
+ actual: chainId
116
+ }),
117
+ method: RpcMethods.chainId.name,
118
+ endpoint,
119
+ cause: new Error(`expected chain ID ${expectedChainId} for ${network}, got ${chainId}`)
120
+ })))),
121
+ makeError: fields => new StarknetRpcError(fields)
122
+ });
123
+ const blockNumberOn = endpoint => rpc.call(endpoint, RpcMethods.blockNumber, {}).pipe(Effect.tap(head => Ref.update(endpoint.head, known => head > known ? head : known)));
124
+ const getEventsOn = (endpoint, filter) => Effect.gen(function* () {
125
+ const method = RpcMethods.getEvents.name;
126
+ yield* rpc.requireHead(endpoint, method, filter.toBlock, blockNumberOn(endpoint));
127
+ const page = yield* rpc.call(endpoint, RpcMethods.getEvents, {
128
+ filter: {
129
+ address: filter.address,
130
+ from_block: {
131
+ block_number: filter.fromBlock
132
+ },
133
+ to_block: {
134
+ block_number: filter.toBlock
135
+ },
136
+ ...(filter.keys !== undefined && {
137
+ keys: filter.keys
138
+ }),
139
+ chunk_size: filter.chunkSize ?? 1000,
140
+ ...(filter.cursor !== undefined && {
141
+ continuation_token: filter.cursor.cursor
142
+ })
143
+ }
144
+ });
145
+ const invalid = page.events.find(event => event.blockNumber < filter.fromBlock || event.blockNumber > filter.toBlock || event.fromAddress !== filter.address);
146
+ if (invalid !== undefined) {
147
+ return yield* rpc.fail(endpoint, method, new JsonRpc.InvalidResponse(), new Error(`event of ${invalid.transactionHash} in block ${invalid.blockNumber} is outside the filter`));
148
+ }
149
+ return {
150
+ events: page.events,
151
+ cursor: page.continuation_token === undefined ? undefined : StarknetEventsCursor.make({
152
+ endpoint: endpoint.name,
153
+ cursor: page.continuation_token
154
+ })
155
+ };
156
+ });
157
+ const getEvents = filter => {
158
+ if (filter.fromBlock > filter.toBlock) return Effect.succeed({
159
+ events: [],
160
+ cursor: undefined
161
+ });
162
+ if (filter.cursor === undefined) return rpc.withFallback(endpoint => getEventsOn(endpoint, filter));
163
+ // a cursor only means something to the endpoint that issued it
164
+ return rpc.endpointOf(RpcMethods.getEvents.name, filter.cursor).pipe(Effect.flatMap(endpoint => getEventsOn(endpoint, filter)));
165
+ };
166
+ return StarknetRpc.of({
167
+ network,
168
+ chainId: rpc.withFallback(rpc.checkNetwork),
169
+ blockNumber: rpc.withFallback(blockNumberOn),
170
+ getBlockWithTxHashes: ({
171
+ blockNumber
172
+ }) => rpc.withFallback(endpoint => rpc.requireHead(endpoint, RpcMethods.getBlockWithTxHashes.name, blockNumber, blockNumberOn(endpoint)).pipe(Effect.andThen(rpc.call(endpoint, RpcMethods.getBlockWithTxHashes, {
173
+ block_id: {
174
+ block_number: blockNumber
175
+ }
176
+ })))),
177
+ getEvents,
178
+ getTransactionReceipt: ({
179
+ transactionHash
180
+ }) => rpc.withFallback(endpoint => rpc.call(endpoint, RpcMethods.getTransactionReceipt, {
181
+ transaction_hash: transactionHash
182
+ }))
183
+ });
184
+ }));
185
+ /**
186
+ * Builds an {@link StarknetRpc} like {@link layer}, reading the options from `Config`. Endpoint URLs stay `Redacted`.
187
+ *
188
+ * @example
189
+ * ```ts
190
+ * import * as StarknetRpc from "@effect-blockchain/starknet/StarknetRpc"
191
+ * import * as Config from "effect/Config"
192
+ *
193
+ * const RpcLive = StarknetRpc.layerConfig({
194
+ * network: Config.succeed("Starknet"),
195
+ * endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("STARKNET_RPC_URL") })])
196
+ * })
197
+ * ```
198
+ *
199
+ * @since 0.1.0
200
+ * @category layers
201
+ */
202
+ export const layerConfig = options => Layer.unwrap(Effect.map(Config.unwrap(options), layer));
203
+ //# 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":[]}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Starknet transaction hashes.
3
+ *
4
+ * @since 0.1.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ /**
8
+ * A Starknet transaction hash: `0x` followed by 64 lowercase hex digits.
9
+ *
10
+ * Decoding lowercases the input and left-pads it with zeros, so `"0xc9"` decodes
11
+ * to `"0x00…00c9"`.
12
+ *
13
+ * @since 0.1.0
14
+ * @category schemas
15
+ */
16
+ export declare const StarknetTransactionHash: Schema.brand<Schema.decodeTo<Schema.String, Schema.decodeTo<Schema.String, Schema.String, never, never>, never, never>, "StarknetTransactionHash">;
17
+ /**
18
+ * @since 0.1.0
19
+ * @category models
20
+ */
21
+ export type StarknetTransactionHash = typeof StarknetTransactionHash.Type;
22
+ //# sourceMappingURL=StarknetTransactionHash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetTransactionHash.d.ts","sourceRoot":"","sources":["../src/StarknetTransactionHash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,oJAOnC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Starknet transaction hashes.
3
+ *
4
+ * @since 0.1.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ import { PaddedFelt } from "./internal/PaddedFelt.js";
8
+ /**
9
+ * A Starknet transaction hash: `0x` followed by 64 lowercase hex digits.
10
+ *
11
+ * Decoding lowercases the input and left-pads it with zeros, so `"0xc9"` decodes
12
+ * to `"0x00…00c9"`.
13
+ *
14
+ * @since 0.1.0
15
+ * @category schemas
16
+ */
17
+ export const StarknetTransactionHash = /*#__PURE__*/PaddedFelt.pipe(/*#__PURE__*/Schema.brand("StarknetTransactionHash"), /*#__PURE__*/Schema.annotate({
18
+ identifier: "StarknetTransactionHash",
19
+ title: "Starknet transaction hash",
20
+ description: "a valid Starknet transaction hash, starting with 0x and followed by 64 hexadecimal characters"
21
+ }));
22
+ //# sourceMappingURL=StarknetTransactionHash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetTransactionHash.js","names":[],"sources":["../src/StarknetTransactionHash.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,SAAS,UAAU,QAAQ,0BAA0B;AAErD;;;;;;;;;AASA,OAAO,MAAM,uBAAuB,gBAAG,UAAU,CAAC,IAAI,cACpD,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,eACvC,MAAM,CAAC,QAAQ,CAAC;EACd,UAAU,EAAE,yBAAyB;EACrC,KAAK,EAAE,2BAA2B;EAClC,WAAW,EAAE;CACd,CAAC,CACH","ignoreList":[]}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * @since 0.1.0
3
+ */
4
+ /**
5
+ * @since 0.1.0
6
+ */
7
+ export * as StarknetAddress from "./StarknetAddress.ts";
8
+ /**
9
+ * @since 0.1.0
10
+ */
11
+ export * as StarknetBlock from "./StarknetBlock.ts";
12
+ /**
13
+ * @since 0.1.0
14
+ */
15
+ export * as StarknetEvent from "./StarknetEvent.ts";
16
+ /**
17
+ * @since 0.1.0
18
+ */
19
+ export * as StarknetIndexer from "./StarknetIndexer.ts";
20
+ /**
21
+ * @since 0.1.0
22
+ */
23
+ export * as StarknetNetwork from "./StarknetNetwork.ts";
24
+ /**
25
+ * @since 0.1.0
26
+ */
27
+ export * as StarknetRpc from "./StarknetRpc.ts";
28
+ /**
29
+ * @since 0.1.0
30
+ */
31
+ export * as StarknetTransactionHash from "./StarknetTransactionHash.ts";
32
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,uBAAuB,MAAM,8BAA8B,CAAA"}