@effect-blockchain/evm 0.1.0 → 0.3.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 (49) hide show
  1. package/dist/EvmFeeHistory.d.ts +26 -0
  2. package/dist/EvmFeeHistory.d.ts.map +1 -0
  3. package/dist/EvmFeeHistory.js +25 -0
  4. package/dist/EvmFeeHistory.js.map +1 -0
  5. package/dist/EvmIndexer.d.ts +45 -1
  6. package/dist/EvmIndexer.d.ts.map +1 -1
  7. package/dist/EvmIndexer.js +91 -26
  8. package/dist/EvmIndexer.js.map +1 -1
  9. package/dist/EvmNetwork.d.ts +6 -3
  10. package/dist/EvmNetwork.d.ts.map +1 -1
  11. package/dist/EvmNetwork.js +9 -3
  12. package/dist/EvmNetwork.js.map +1 -1
  13. package/dist/EvmRelayer.d.ts +200 -0
  14. package/dist/EvmRelayer.d.ts.map +1 -0
  15. package/dist/EvmRelayer.js +281 -0
  16. package/dist/EvmRelayer.js.map +1 -0
  17. package/dist/EvmRpc.d.ts +87 -3
  18. package/dist/EvmRpc.d.ts.map +1 -1
  19. package/dist/EvmRpc.js +29 -4
  20. package/dist/EvmRpc.js.map +1 -1
  21. package/dist/EvmSigner.d.ts +78 -0
  22. package/dist/EvmSigner.d.ts.map +1 -0
  23. package/dist/EvmSigner.js +98 -0
  24. package/dist/EvmSigner.js.map +1 -0
  25. package/dist/EvmTransaction.d.ts +65 -0
  26. package/dist/EvmTransaction.d.ts.map +1 -0
  27. package/dist/EvmTransaction.js +60 -0
  28. package/dist/EvmTransaction.js.map +1 -0
  29. package/dist/index.d.ts +16 -0
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +16 -0
  32. package/dist/index.js.map +1 -1
  33. package/dist/internal/confirmations.d.ts +2 -0
  34. package/dist/internal/confirmations.d.ts.map +1 -0
  35. package/dist/internal/confirmations.js +13 -0
  36. package/dist/internal/confirmations.js.map +1 -0
  37. package/dist/internal/rpcMethods.js +53 -0
  38. package/dist/internal/rpcMethods.js.map +1 -1
  39. package/package.json +1 -1
  40. package/src/EvmFeeHistory.ts +28 -0
  41. package/src/EvmIndexer.ts +136 -33
  42. package/src/EvmNetwork.ts +10 -3
  43. package/src/EvmRelayer.ts +361 -0
  44. package/src/EvmRpc.ts +105 -4
  45. package/src/EvmSigner.ts +128 -0
  46. package/src/EvmTransaction.ts +64 -0
  47. package/src/index.ts +20 -0
  48. package/src/internal/confirmations.ts +17 -0
  49. package/src/internal/rpcMethods.ts +63 -0
@@ -0,0 +1,26 @@
1
+ /**
2
+ * EVM fee history, as returned by `eth_feeHistory`.
3
+ *
4
+ * @since 0.3.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ /**
8
+ * The fees of a range of blocks starting at `oldestBlock`, in wei per gas. `baseFeePerGas` has one more entry than
9
+ * the range: the base fee of the block after it. `reward` holds, per block, the priority fee at each requested
10
+ * percentile, and is absent when none was requested.
11
+ *
12
+ * @since 0.3.0
13
+ * @category schemas
14
+ */
15
+ export declare const EvmFeeHistory: Schema.Struct<{
16
+ readonly oldestBlock: Schema.decodeTo<Schema.BigInt, Schema.String, never, never>;
17
+ readonly baseFeePerGas: Schema.NonEmptyArray<Schema.decodeTo<Schema.BigInt, Schema.String, never, never>>;
18
+ readonly gasUsedRatio: Schema.$Array<Schema.Number>;
19
+ readonly reward: Schema.optionalKey<Schema.$Array<Schema.$Array<Schema.decodeTo<Schema.BigInt, Schema.String, never, never>>>>;
20
+ }>;
21
+ /**
22
+ * @since 0.3.0
23
+ * @category models
24
+ */
25
+ export type EvmFeeHistory = typeof EvmFeeHistory.Type;
26
+ //# sourceMappingURL=EvmFeeHistory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EvmFeeHistory.d.ts","sourceRoot":"","sources":["../src/EvmFeeHistory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;EAK4C,CAAA;AAEtE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * EVM fee history, as returned by `eth_feeHistory`.
3
+ *
4
+ * @since 0.3.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ import { QuantityFromHex } from "./internal/QuantityFromHex.js";
8
+ /**
9
+ * The fees of a range of blocks starting at `oldestBlock`, in wei per gas. `baseFeePerGas` has one more entry than
10
+ * the range: the base fee of the block after it. `reward` holds, per block, the priority fee at each requested
11
+ * percentile, and is absent when none was requested.
12
+ *
13
+ * @since 0.3.0
14
+ * @category schemas
15
+ */
16
+ export const EvmFeeHistory = /*#__PURE__*/Schema.Struct({
17
+ oldestBlock: QuantityFromHex,
18
+ baseFeePerGas: Schema.NonEmptyArray(QuantityFromHex),
19
+ gasUsedRatio: Schema.Array(Schema.Number),
20
+ reward: Schema.optionalKey(Schema.Array(Schema.Array(QuantityFromHex)))
21
+ }).annotate({
22
+ identifier: "EvmFeeHistory",
23
+ title: "EVM fee history"
24
+ });
25
+ //# sourceMappingURL=EvmFeeHistory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EvmFeeHistory.js","names":[],"sources":["../src/EvmFeeHistory.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,SAAS,eAAe,QAAQ,+BAA+B;AAE/D;;;;;;;;AAQA,OAAO,MAAM,aAAa,gBAAG,MAAM,CAAC,MAAM,CAAC;EACzC,WAAW,EAAE,eAAe;EAC5B,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC;EACpD,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;EACzC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;CACvE,CAAC,CAAC,QAAQ,CAAC;EAAE,UAAU,EAAE,eAAe;EAAE,KAAK,EAAE;AAAiB,CAAE,CAAC","ignoreList":[]}
@@ -5,6 +5,7 @@ import * as Effect from "effect/Effect";
5
5
  import * as Layer from "effect/Layer";
6
6
  import * as Schedule from "effect/Schedule";
7
7
  import * as Stream from "effect/Stream";
8
+ import type { EvmAddress } from "./EvmAddress.ts";
8
9
  import type { EvmLog } from "./EvmLog.ts";
9
10
  import * as EvmRpc from "./EvmRpc.ts";
10
11
  /**
@@ -49,6 +50,33 @@ export interface EvmIndexerStreamOptions {
49
50
  /** Retries a step failing with a transient reason ({@link JsonRpc.isTransient}) at the same block. Off by default. */
50
51
  readonly retry?: Schedule.Schedule<unknown, EvmRpc.EvmRpcError> | undefined;
51
52
  }
53
+ /**
54
+ * The native balance of an address in wei at the end of `block`, emitted by
55
+ * {@link EvmIndexer.Service.streamNativeBalance}.
56
+ *
57
+ * @since 0.3.0
58
+ * @category models
59
+ */
60
+ export interface EvmNativeBalance {
61
+ readonly block: bigint;
62
+ readonly balance: bigint;
63
+ }
64
+ /**
65
+ * The {@link EvmIndexer.Service.streamNativeBalance} options: one sample at `fromBlock`, then every `step` blocks.
66
+ * `step` is a positive safe integer, `poll` and `retry` work as in {@link EvmIndexerStreamOptions}.
67
+ *
68
+ * @since 0.3.0
69
+ * @category models
70
+ */
71
+ export interface EvmIndexerNativeBalanceOptions {
72
+ readonly address: EvmAddress;
73
+ readonly fromBlock: bigint;
74
+ /** The stream ends after the last sample not above it, and is empty when `fromBlock > toBlock`. */
75
+ readonly toBlock?: bigint | undefined;
76
+ readonly step: number;
77
+ readonly poll?: Schedule.Schedule<unknown> | undefined;
78
+ readonly retry?: Schedule.Schedule<unknown, EvmRpc.EvmRpcError> | undefined;
79
+ }
52
80
  declare const EvmIndexer_base: Context.ServiceClass<EvmIndexer, "@effect-blockchain/evm/EvmIndexer", {
53
81
  /** The head block number minus the confirmations, never below 0. */
54
82
  readonly lastConfirmedBlock: Effect.Effect<bigint, EvmRpc.EvmRpcError>;
@@ -62,6 +90,22 @@ declare const EvmIndexer_base: Context.ServiceClass<EvmIndexer, "@effect-blockch
62
90
  * the confirmed head.
63
91
  */
64
92
  readonly streamLogs: (options: EvmIndexerStreamOptions) => Stream.Stream<EvmIndexerBatch, EvmRpc.EvmRpcError>;
93
+ /**
94
+ * The native balance of `address` in wei at the end of `block`, which needs an archive endpoint for an old block.
95
+ *
96
+ * @since 0.3.0
97
+ */
98
+ readonly fetchNativeBalance: (options: {
99
+ readonly address: EvmAddress;
100
+ readonly block: bigint;
101
+ }) => Effect.Effect<bigint, EvmRpc.EvmRpcError>;
102
+ /**
103
+ * The native balance of `address` at `fromBlock`, `fromBlock + step`, ... (a sample at every step, changed or not),
104
+ * each read once its block is confirmed, following the confirmed head.
105
+ *
106
+ * @since 0.3.0
107
+ */
108
+ readonly streamNativeBalance: (options: EvmIndexerNativeBalanceOptions) => Stream.Stream<EvmNativeBalance, EvmRpc.EvmRpcError>;
65
109
  }>;
66
110
  /**
67
111
  * @since 0.1.0
@@ -86,7 +130,7 @@ export declare const DEFAULT_POLL_INTERVAL: Duration.Duration;
86
130
  /**
87
131
  * Builds an {@link EvmIndexer} reading through the provided {@link EvmRpc.EvmRpc}.
88
132
  *
89
- * - `confirmations` overrides {@link EvmNetwork.defaultConfirmations} for the RPC's network.
133
+ * - `confirmations` overrides `EvmNetwork.defaultConfirmations` for the RPC's network.
90
134
  * - `maxBlockRange`, a positive integer, defaults to {@link DEFAULT_MAX_BLOCK_RANGE}.
91
135
  *
92
136
  * @since 0.1.0
@@ -1 +1 @@
1
- {"version":3,"file":"EvmIndexer.d.ts","sourceRoot":"","sources":["../src/EvmIndexer.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,CAAA;AAEnD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,SAAS,CAAC,CAAA;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;IACtD,sHAAsH;IACtH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,SAAS,CAAA;CAC5E;;IAOC,oEAAoE;iCACvC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;IACtE;;;OAGG;wBACiB,CAAC,MAAM,EAAE,gBAAgB,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC1G;;;OAGG;yBACkB,CAAC,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC;;AAhB/G;;;GAGG;AACH,qBAAa,UAAW,SAAQ,eAaS;CAAG;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,QAA+B,CAAA;AAQ5E;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,aAAa;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5C,KAAQ,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CA2DlD,CAAA;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,YACb,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAC7D,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAA4D,CAAA"}
1
+ {"version":3,"file":"EvmIndexer.d.ts","sourceRoot":"","sources":["../src/EvmIndexer.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,10 @@
1
1
  /**
2
- * EVM log indexing on top of {@link EvmRpc.EvmRpc}: the last confirmed block, the logs of a set of contracts over a
3
- * block range, and a stream of them following the confirmed head.
2
+ * EVM indexing on top of {@link EvmRpc.EvmRpc}: the last confirmed block, the logs of a set of contracts over a block
3
+ * range, the native balance of an address at a block, and streams of both following the confirmed head.
4
4
  *
5
5
  * A range is split into ranges of at most `maxBlockRange` blocks, one `eth_getLogs` after another. A failing range
6
- * fails the whole call and drops the logs already read: the caller retries the same range.
6
+ * fails the whole call and drops the logs already read: the caller retries the same range. A balance is one
7
+ * `eth_getBalance` per sample.
7
8
  *
8
9
  * @example
9
10
  * ```ts
@@ -27,6 +28,24 @@
27
28
  * })
28
29
  * ```
29
30
  *
31
+ * @example
32
+ * ```ts
33
+ * import type { EvmAddress } from "@effect-blockchain/evm/EvmAddress"
34
+ * import { EvmIndexer } from "@effect-blockchain/evm/EvmIndexer"
35
+ * import * as Effect from "effect/Effect"
36
+ * import * as Stream from "effect/Stream"
37
+ *
38
+ * declare const address: EvmAddress
39
+ *
40
+ * // the balance in wei every 7200 blocks (about a day on Ethereum) up to the head, then every new 7200 blocks
41
+ * const daily = Effect.gen(function*() {
42
+ * const indexer = yield* EvmIndexer
43
+ * return indexer.streamNativeBalance({ address, fromBlock: BigInt(21_000_000), step: 7200 }).pipe(
44
+ * Stream.tap(({ balance, block }) => Effect.log(`${block}: ${balance} wei`))
45
+ * )
46
+ * })
47
+ * ```
48
+ *
30
49
  * @since 0.1.0
31
50
  */
32
51
  import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
@@ -40,8 +59,8 @@ import * as Layer from "effect/Layer";
40
59
  import * as Option from "effect/Option";
41
60
  import * as Schedule from "effect/Schedule";
42
61
  import * as Stream from "effect/Stream";
43
- import * as EvmNetwork from "./EvmNetwork.js";
44
62
  import * as EvmRpc from "./EvmRpc.js";
63
+ import * as Confirmations from "./internal/confirmations.js";
45
64
  /**
46
65
  * @since 0.1.0
47
66
  * @category services
@@ -64,7 +83,7 @@ export const DEFAULT_POLL_INTERVAL = /*#__PURE__*/Duration.seconds(10);
64
83
  /**
65
84
  * Builds an {@link EvmIndexer} reading through the provided {@link EvmRpc.EvmRpc}.
66
85
  *
67
- * - `confirmations` overrides {@link EvmNetwork.defaultConfirmations} for the RPC's network.
86
+ * - `confirmations` overrides `EvmNetwork.defaultConfirmations` for the RPC's network.
68
87
  * - `maxBlockRange`, a positive integer, defaults to {@link DEFAULT_MAX_BLOCK_RANGE}.
69
88
  *
70
89
  * @since 0.1.0
@@ -76,9 +95,25 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
76
95
  if (!Number.isSafeInteger(maxBlockRange) || maxBlockRange < 1) {
77
96
  return yield* Effect.die(new RangeError(`maxBlockRange must be a positive integer, got ${maxBlockRange}`));
78
97
  }
79
- const confirmations = BigInt(options.confirmations ?? EvmNetwork.defaultConfirmations(rpc.network));
80
98
  const size = BigInt(maxBlockRange);
81
- const lastConfirmedBlock = rpc.blockNumber.pipe(Effect.map(head => BigInt_.max(head - confirmations, BigInt(0))), Effect.withSpan("EvmIndexer.lastConfirmedBlock"));
99
+ const lastConfirmedBlock = Confirmations.lastConfirmedBlock(rpc, options.confirmations).pipe(Effect.withSpan("EvmIndexer.lastConfirmedBlock"));
100
+ // the head last read is reused while it covers `next` (the confirmed head only moves forward), else polled
101
+ const confirmedHead = (poll, {
102
+ head,
103
+ next
104
+ }) => next <= head ? Effect.succeed(head) : lastConfirmedBlock.pipe(Effect.repeat({
105
+ schedule: poll,
106
+ until: confirmed => confirmed >= next
107
+ }));
108
+ const paginate = (start, retry, step) => Stream.paginate(
109
+ // a head below `start`: the first step reads it
110
+ {
111
+ next: start,
112
+ head: start - BigInt(1)
113
+ }, retry === undefined ? step : position => Effect.retry(step(position), {
114
+ schedule: retry,
115
+ while: error => JsonRpc.isTransient(error.reason)
116
+ }));
82
117
  const fetchLogs = Effect.fn("EvmIndexer.fetchLogs")(filter => {
83
118
  if (filter.fromBlock > filter.toBlock) return Effect.succeed([]);
84
119
  const count = Number((filter.toBlock - filter.fromBlock) / size) + 1;
@@ -88,6 +123,13 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
88
123
  toBlock: BigInt_.min(fromBlock + size - BigInt(1), filter.toBlock)
89
124
  })).pipe(Effect.map(Arr.flatten));
90
125
  });
126
+ const fetchNativeBalance = Effect.fn("EvmIndexer.fetchNativeBalance")(({
127
+ address,
128
+ block
129
+ }) => rpc.getBalance({
130
+ address,
131
+ blockNumber: block
132
+ }));
91
133
  return EvmIndexer.of({
92
134
  lastConfirmedBlock,
93
135
  fetchLogs,
@@ -99,16 +141,14 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
99
141
  toBlock
100
142
  }) => {
101
143
  if (toBlock !== undefined && fromBlock > toBlock) return Stream.empty;
102
- // the head last read is reused while it covers `next` (the confirmed head only moves forward), else polled
103
- const step = ({
104
- head,
105
- next
106
- }) => (next <= head ? Effect.succeed(head) : lastConfirmedBlock.pipe(Effect.repeat({
107
- schedule: poll,
108
- until: confirmed => confirmed >= next
109
- }))).pipe(Effect.flatMap(confirmed => {
144
+ return paginate(fromBlock, retry, position => confirmedHead(poll, position).pipe(Effect.flatMap(confirmed => {
145
+ const {
146
+ next
147
+ } = position;
110
148
  const cap = toBlock === undefined ? confirmed : BigInt_.min(confirmed, toBlock);
111
- if (next > cap) return Effect.succeed([[], Option.none()]);
149
+ if (next > cap) {
150
+ return Effect.succeed([[], Option.none()]);
151
+ }
112
152
  const end = BigInt_.min(next + size - BigInt(1), cap);
113
153
  return fetchLogs({
114
154
  ...filter,
@@ -122,16 +162,41 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
122
162
  next: end + BigInt(1),
123
163
  head: confirmed
124
164
  })]));
125
- }));
126
- return Stream.paginate(
127
- // a head below `fromBlock`: the first step reads it
128
- {
129
- next: fromBlock,
130
- head: fromBlock - BigInt(1)
131
- }, retry === undefined ? step : remaining => Effect.retry(step(remaining), {
132
- schedule: retry,
133
- while: error => JsonRpc.isTransient(error.reason)
134
- }));
165
+ })));
166
+ },
167
+ fetchNativeBalance,
168
+ streamNativeBalance: ({
169
+ address,
170
+ fromBlock,
171
+ poll = Schedule.spaced(DEFAULT_POLL_INTERVAL),
172
+ retry,
173
+ step,
174
+ toBlock
175
+ }) => {
176
+ if (!Number.isSafeInteger(step) || step < 1) {
177
+ return Stream.die(new RangeError(`step must be a positive safe integer, got ${step}`));
178
+ }
179
+ if (toBlock !== undefined && fromBlock > toBlock) {
180
+ return Stream.empty;
181
+ }
182
+ const stride = BigInt(step);
183
+ return paginate(fromBlock, retry, position => confirmedHead(poll, position).pipe(Effect.flatMap(confirmed => {
184
+ const block = position.next;
185
+ if (block > confirmed) {
186
+ return Effect.succeed([[], Option.none()]);
187
+ }
188
+ const next = block + stride;
189
+ return fetchNativeBalance({
190
+ address,
191
+ block
192
+ }).pipe(Effect.map(balance => [[{
193
+ block,
194
+ balance
195
+ }], toBlock !== undefined && next > toBlock ? Option.none() : Option.some({
196
+ next,
197
+ head: confirmed
198
+ })]));
199
+ })));
135
200
  }
136
201
  });
137
202
  }));
@@ -1 +1 @@
1
- {"version":3,"file":"EvmIndexer.js","names":[],"sources":["../src/EvmIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"file":"EvmIndexer.js","names":[],"sources":["../src/EvmIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
@@ -11,22 +11,25 @@ import * as Schema from "effect/Schema";
11
11
  */
12
12
  export declare const mainnets: readonly ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea"];
13
13
  /**
14
+ * `Anvil` is the local Foundry node with its default chain ID 31337: a node started with another `--chain-id` must use
15
+ * the network matching that ID, since the network check compares chain IDs.
16
+ *
14
17
  * @since 0.1.0
15
18
  * @category constants
16
19
  */
17
- export declare const testnets: readonly ["Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia"];
20
+ export declare const testnets: readonly ["Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia", "Anvil"];
18
21
  /**
19
22
  * Every supported network, mainnets first.
20
23
  *
21
24
  * @since 0.1.0
22
25
  * @category constants
23
26
  */
24
- export declare const networks: readonly ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea", "Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia"];
27
+ export declare const networks: readonly ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea", "Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia", "Anvil"];
25
28
  /**
26
29
  * @since 0.1.0
27
30
  * @category schemas
28
31
  */
29
- export declare const EvmNetwork: Schema.Literals<readonly ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea", "Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia"]>;
32
+ export declare const EvmNetwork: Schema.Literals<readonly ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea", "Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia", "Anvil"]>;
30
33
  /**
31
34
  * @since 0.1.0
32
35
  * @category models
@@ -1 +1 @@
1
- {"version":3,"file":"EvmNetwork.d.ts","sourceRoot":"","sources":["../src/EvmNetwork.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,QAAQ,YACnB,UAAU,EACV,SAAS,EACT,MAAM,EACN,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,QAAQ,EACR,OAAO,CACC,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,QAAQ,YACnB,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,cAAc,CACN,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,4RAAsC,CAAA;AAE3D;;;GAGG;AACH,eAAO,MAAM,UAAU,6SAIrB,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,wCAOtB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAwB/C;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,UAAU,KAAG,UAAgD,CAAA;AAEhG;;;;;GAKG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CACW,CAAA;AAEjF;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,UAAU,KAAG,OAAoE,CAAA;AAmCpH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,UAAU,KAAG,MAAgC,CAAA"}
1
+ {"version":3,"file":"EvmNetwork.d.ts","sourceRoot":"","sources":["../src/EvmNetwork.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,QAAQ,YACnB,UAAU,EACV,SAAS,EACT,MAAM,EACN,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,QAAQ,EACR,OAAO,CACC,CAAA;AAEV;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,YACnB,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,OAAO,CACC,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,qSAAsC,CAAA;AAE3D;;;GAGG;AACH,eAAO,MAAM,UAAU,sTAIrB,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,wCAOtB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAyB/C;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,UAAU,KAAG,UAAgD,CAAA;AAEhG;;;;;GAKG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CACW,CAAA;AAEjF;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,UAAU,KAAG,OAAoE,CAAA;AAqCpH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,UAAU,KAAG,MAAgC,CAAA"}
@@ -11,10 +11,13 @@ import * as Schema from "effect/Schema";
11
11
  */
12
12
  export const mainnets = ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea"];
13
13
  /**
14
+ * `Anvil` is the local Foundry node with its default chain ID 31337: a node started with another `--chain-id` must use
15
+ * the network matching that ID, since the network check compares chain IDs.
16
+ *
14
17
  * @since 0.1.0
15
18
  * @category constants
16
19
  */
17
- export const testnets = ["Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia"];
20
+ export const testnets = ["Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia", "Anvil"];
18
21
  /**
19
22
  * Every supported network, mainnets first.
20
23
  *
@@ -61,7 +64,8 @@ const chainIds = {
61
64
  BnbSmartChainTestnet: 97,
62
65
  Gnosis: 100,
63
66
  Linea: 59144,
64
- LineaSepolia: 59141
67
+ LineaSepolia: 59141,
68
+ Anvil: 31337
65
69
  };
66
70
  /**
67
71
  * @since 0.1.0
@@ -110,7 +114,9 @@ const confirmations = {
110
114
  Gnosis: 32,
111
115
  // ~1 min of 2s blocks, Circle Fast Transfer uses 1: https://developers.circle.com/cctp/required-block-confirmations
112
116
  Linea: 30,
113
- LineaSepolia: 30
117
+ LineaSepolia: 30,
118
+ // local node mines instantly and never reorgs: https://getfoundry.sh/anvil/overview
119
+ Anvil: 0
114
120
  };
115
121
  /**
116
122
  * The number of blocks behind the head after which a block is treated as final by default.
@@ -1 +1 @@
1
- {"version":3,"file":"EvmNetwork.js","names":[],"sources":["../src/EvmNetwork.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"file":"EvmNetwork.js","names":[],"sources":["../src/EvmNetwork.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,200 @@
1
+ import * as Context from "effect/Context";
2
+ import * as Effect from "effect/Effect";
3
+ import * as Layer from "effect/Layer";
4
+ import * as Schedule from "effect/Schedule";
5
+ import * as Schema from "effect/Schema";
6
+ import type { EvmAddress } from "./EvmAddress.ts";
7
+ import type { EvmHexData } from "./EvmHexData.ts";
8
+ import * as EvmRpc from "./EvmRpc.ts";
9
+ import type { EvmSigner, EvmSignerError } from "./EvmSigner.ts";
10
+ import { EvmTransactionHash } from "./EvmTransactionHash.ts";
11
+ /**
12
+ * Where a transaction stands, by `_tag`: see the module's table. `block` is the block holding it, and `reason` the
13
+ * revert data, `undefined` when it is not available: a receipt does not carry it.
14
+ *
15
+ * @since 0.3.0
16
+ * @category models
17
+ */
18
+ export type EvmTransactionStatus = {
19
+ readonly _tag: "Pending";
20
+ } | {
21
+ readonly _tag: "Included";
22
+ readonly block: bigint;
23
+ } | {
24
+ readonly _tag: "Confirmed";
25
+ readonly block: bigint;
26
+ } | {
27
+ readonly _tag: "Failed";
28
+ readonly block: bigint;
29
+ readonly reason: EvmHexData | undefined;
30
+ } | {
31
+ readonly _tag: "NotFound";
32
+ };
33
+ /**
34
+ * The fees of an EIP-1559 transaction, in wei per gas: the most it pays in total, and the part of it offered to the
35
+ * block producer above the base fee.
36
+ *
37
+ * @since 0.3.0
38
+ * @category models
39
+ */
40
+ export interface EvmFees {
41
+ readonly maxFeePerGas: bigint;
42
+ readonly maxPriorityFeePerGas: bigint;
43
+ }
44
+ /**
45
+ * What a fee strategy decides from, read with `eth_feeHistory` over the last 10 blocks: `baseFeePerGas` is the base
46
+ * fee of the next block and `rewards` holds, per block from the oldest, the priority fee paid at the 25th, 50th and
47
+ * 75th percentiles of its gas. A node may return fewer blocks or no `rewards`, and an empty block reports zeros.
48
+ *
49
+ * @since 0.3.0
50
+ * @category models
51
+ */
52
+ export interface EvmFeeEstimate {
53
+ readonly baseFeePerGas: bigint;
54
+ readonly rewards: ReadonlyArray<ReadonlyArray<bigint>>;
55
+ }
56
+ /**
57
+ * A transaction signed by {@link EvmRelayer.sign}: `signed` is what `broadcast` takes, `hash` its transaction hash
58
+ * and `nonce` the nonce it uses.
59
+ *
60
+ * @since 0.3.0
61
+ * @category models
62
+ */
63
+ export interface EvmSignedTransaction {
64
+ readonly hash: EvmTransactionHash;
65
+ readonly signed: EvmHexData;
66
+ readonly nonce: bigint;
67
+ }
68
+ declare const NonceTooLow_base: Schema.Class<NonceTooLow, Schema.TaggedStruct<"NonceTooLow", {}>, import("effect/Cause").YieldableError>;
69
+ /**
70
+ * The sender's nonce is already used by a transaction in a block, and the node does not know this one: another
71
+ * transaction took its place.
72
+ *
73
+ * @since 0.3.0
74
+ * @category reasons
75
+ */
76
+ export declare class NonceTooLow extends NonceTooLow_base {
77
+ }
78
+ declare const ReplacementUnderpriced_base: Schema.Class<ReplacementUnderpriced, Schema.TaggedStruct<"ReplacementUnderpriced", {}>, import("effect/Cause").YieldableError>;
79
+ /**
80
+ * The node's pool holds another transaction at this nonce and the fees do not exceed its fees enough to replace it.
81
+ *
82
+ * @since 0.3.0
83
+ * @category reasons
84
+ */
85
+ export declare class ReplacementUnderpriced extends ReplacementUnderpriced_base {
86
+ }
87
+ declare const FeeTooLow_base: Schema.Class<FeeTooLow, Schema.TaggedStruct<"FeeTooLow", {}>, import("effect/Cause").YieldableError>;
88
+ /**
89
+ * The fees are below what the node accepts: `maxFeePerGas` under the base fee, or a priority fee under its minimum.
90
+ *
91
+ * @since 0.3.0
92
+ * @category reasons
93
+ */
94
+ export declare class FeeTooLow extends FeeTooLow_base {
95
+ }
96
+ declare const InsufficientFunds_base: Schema.Class<InsufficientFunds, Schema.TaggedStruct<"InsufficientFunds", {}>, import("effect/Cause").YieldableError>;
97
+ /**
98
+ * The sender's balance does not cover `value` plus `gas` times `maxFeePerGas`.
99
+ *
100
+ * @since 0.3.0
101
+ * @category reasons
102
+ */
103
+ export declare class InsufficientFunds extends InsufficientFunds_base {
104
+ }
105
+ /**
106
+ * Why a node refused a transaction, the `reason` of an {@link EvmBroadcastError}, matched with `Effect.catchReason`.
107
+ *
108
+ * @since 0.3.0
109
+ * @category reasons
110
+ */
111
+ export declare const EvmBroadcastReason: Schema.Union<readonly [typeof NonceTooLow, typeof ReplacementUnderpriced, typeof FeeTooLow, typeof InsufficientFunds]>;
112
+ /**
113
+ * @since 0.3.0
114
+ * @category reasons
115
+ */
116
+ export type EvmBroadcastReason = typeof EvmBroadcastReason.Type;
117
+ declare const EvmBroadcastError_base: Schema.Class<EvmBroadcastError, Schema.TaggedStruct<"EvmBroadcastError", {
118
+ readonly reason: Schema.Union<readonly [typeof NonceTooLow, typeof ReplacementUnderpriced, typeof FeeTooLow, typeof InsufficientFunds]>;
119
+ readonly cause: Schema.Defect;
120
+ }>, import("effect/Cause").YieldableError>;
121
+ /**
122
+ * A node refused the transaction for a `reason` the sender can act on: `cause` is the {@link EvmRpc.EvmRpcError}
123
+ * holding the node's message. Any other refusal stays an `EvmRpcError`.
124
+ *
125
+ * @since 0.3.0
126
+ * @category errors
127
+ */
128
+ export declare class EvmBroadcastError extends EvmBroadcastError_base {
129
+ }
130
+ declare const EvmRelayer_base: Context.ServiceClass<EvmRelayer, "@effect-blockchain/evm/EvmRelayer", {
131
+ /**
132
+ * Signs an EIP-1559 call of `to` from `signer.address` without sending it. A missing `nonce` is the sender's pending
133
+ * transaction count, a missing `gas` is `eth_estimateGas` times the layer's `gasMultiplier` (a call that reverts
134
+ * fails with `Rejected`), and missing `fees` come from the layer's fee strategy.
135
+ */
136
+ readonly sign: (options: {
137
+ readonly signer: EvmSigner;
138
+ readonly to: EvmAddress;
139
+ readonly data?: EvmHexData | undefined;
140
+ readonly value?: bigint | undefined;
141
+ readonly nonce?: bigint | undefined;
142
+ readonly gas?: bigint | undefined;
143
+ readonly fees?: EvmFees | undefined;
144
+ }) => Effect.Effect<EvmSignedTransaction, EvmRpc.EvmRpcError | EvmSignerError>;
145
+ /**
146
+ * Sends a signed transaction with `eth_sendRawTransaction` and returns its hash. Sending the same bytes again is
147
+ * safe: a node answering that it already has the transaction, or that the nonce is used while it knows this hash,
148
+ * is a success.
149
+ */
150
+ readonly broadcast: (options: {
151
+ readonly signed: EvmHexData;
152
+ }) => Effect.Effect<EvmTransactionHash, EvmBroadcastError | EvmRpc.EvmRpcError>;
153
+ /**
154
+ * The status of the transaction as the answering endpoint sees it. An endpoint behind the head, or one that never
155
+ * received the transaction, answers `Pending` or `NotFound` for a transaction another one has in a block.
156
+ */
157
+ readonly fetchTransactionStatus: (options: {
158
+ readonly hash: EvmTransactionHash;
159
+ }) => Effect.Effect<EvmTransactionStatus, EvmRpc.EvmRpcError>;
160
+ /**
161
+ * Reads {@link fetchTransactionStatus} on `poll` (`Schedule.spaced(EvmIndexer.DEFAULT_POLL_INTERVAL)` by default) until it is
162
+ * `Confirmed` or `Failed`, and returns it. `NotFound` keeps polling, so bound the wait with a timeout. A `poll` that
163
+ * ends first returns the last status read.
164
+ */
165
+ readonly awaitConfirmation: (options: {
166
+ readonly hash: EvmTransactionHash;
167
+ readonly poll?: Schedule.Schedule<unknown> | undefined;
168
+ }) => Effect.Effect<EvmTransactionStatus, EvmRpc.EvmRpcError>;
169
+ }>;
170
+ /**
171
+ * @since 0.3.0
172
+ * @category services
173
+ */
174
+ export declare class EvmRelayer extends EvmRelayer_base {
175
+ }
176
+ /**
177
+ * The library's fee strategy: the priority fee is the median over the blocks of their 50th percentile reward, at
178
+ * least 0.001 gwei, and `maxFeePerGas` is twice the next base fee plus that priority fee. Doubling the base fee keeps
179
+ * the transaction includable through 5 full blocks in a row, each raising the base fee by 12.5%.
180
+ *
181
+ * @since 0.3.0
182
+ * @category fees
183
+ */
184
+ export declare const defaultFees: (estimate: EvmFeeEstimate) => EvmFees;
185
+ /**
186
+ * Builds an {@link EvmRelayer} over the provided {@link EvmRpc.EvmRpc}. `confirmations` overrides the network's
187
+ * default, as in `EvmIndexer.layer`: both agree on the last confirmed block. `fees` (default {@link defaultFees})
188
+ * prices the transactions signed without explicit fees, and `gasMultiplier` (default 1.2) is the margin applied to
189
+ * an estimated gas limit.
190
+ *
191
+ * @since 0.3.0
192
+ * @category layers
193
+ */
194
+ export declare const layer: (options?: {
195
+ readonly confirmations?: number | undefined;
196
+ readonly fees?: ((estimate: EvmFeeEstimate) => EvmFees) | undefined;
197
+ readonly gasMultiplier?: number | undefined;
198
+ }) => Layer.Layer<EvmRelayer, never, EvmRpc.EvmRpc>;
199
+ export {};
200
+ //# sourceMappingURL=EvmRelayer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EvmRelayer.d.ts","sourceRoot":"","sources":["../src/EvmRelayer.ts"],"names":[],"mappings":"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"}