@effect-blockchain/evm 0.3.0 → 0.4.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.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # `@effect-blockchain/evm`
2
2
 
3
- EVM blockchain toolkit for Effect.
3
+ EVM blockchain toolkit for Effect: RPC methods with endpoint fallback, an indexer, a relayer and signers.
4
4
 
5
5
  ## Installation
6
6
 
@@ -8,6 +8,84 @@ EVM blockchain toolkit for Effect.
8
8
  pnpm add @effect-blockchain/evm effect viem
9
9
  ```
10
10
 
11
+ `viem` is a required peer dependency: every module uses it, including `EvmRpc` and `EvmIndexer` through the address and hash schemas.
12
+
13
+ ## Reading the chain
14
+
15
+ `EvmRpc` exposes the RPC methods over an ordered list of endpoints, and `EvmIndexer` reads confirmed blocks on top of it.
16
+
17
+ ```ts
18
+ import * as EvmIndexer from "@effect-blockchain/evm/EvmIndexer"
19
+ import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
20
+ import * as Config from "effect/Config"
21
+ import * as Effect from "effect/Effect"
22
+ import * as FetchHttpClient from "effect/http/FetchHttpClient"
23
+ import * as Layer from "effect/Layer"
24
+ import * as Stream from "effect/Stream"
25
+
26
+ declare const filter: Omit<EvmIndexer.EvmIndexerFilter, "fromBlock" | "toBlock">
27
+ declare const cursor: bigint
28
+ declare const save: (block: bigint) => Effect.Effect<void>
29
+
30
+ const program = Effect.gen(function*() {
31
+ const rpc = yield* EvmRpc.EvmRpc
32
+ const indexer = yield* EvmIndexer.EvmIndexer
33
+ yield* Effect.log(`head: ${yield* rpc.blockNumber}`)
34
+ yield* indexer.streamLogs({ filter, fromBlock: cursor + BigInt(1) }).pipe(
35
+ Stream.runForEach((batch) => save(batch.toBlock))
36
+ )
37
+ })
38
+
39
+ const RpcLive = EvmRpc.layerConfig({
40
+ network: Config.succeed("Ethereum"),
41
+ endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("ETHEREUM_RPC_URL") })])
42
+ })
43
+
44
+ const main = program.pipe(
45
+ Effect.provide(EvmIndexer.layer().pipe(Layer.provideMerge(RpcLive), Layer.provide(FetchHttpClient.layer)))
46
+ )
47
+ ```
48
+
49
+ ## Sending a transaction
50
+
51
+ `EvmRelayer` signs a transaction, broadcasts it and follows it until it is final. `EvmSigner.fromPrivateKey({ key })` builds a signer from a `Redacted` private key, and `EvmSigner.fromHashSigner` adapts a custody API that signs a hash.
52
+
53
+ ```ts
54
+ import type { EvmAddress } from "@effect-blockchain/evm/EvmAddress"
55
+ import * as EvmRelayer from "@effect-blockchain/evm/EvmRelayer"
56
+ import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
57
+ import type { EvmSigner } from "@effect-blockchain/evm/EvmSigner"
58
+ import type { EvmTransactionHash } from "@effect-blockchain/evm/EvmTransactionHash"
59
+ import * as Config from "effect/Config"
60
+ import * as Effect from "effect/Effect"
61
+ import * as FetchHttpClient from "effect/http/FetchHttpClient"
62
+ import * as Layer from "effect/Layer"
63
+
64
+ declare const signer: EvmSigner
65
+ declare const to: EvmAddress
66
+ declare const store: (hash: EvmTransactionHash, nonce: bigint) => Effect.Effect<void>
67
+
68
+ const program = Effect.gen(function*() {
69
+ const relayer = yield* EvmRelayer.EvmRelayer
70
+ const { hash, nonce, signed } = yield* relayer.sign({ signer, to, value: BigInt(1) })
71
+ yield* store(hash, nonce)
72
+ yield* relayer.broadcast({ signed })
73
+ // `NotFound` keeps polling: the timeout bounds the wait
74
+ return yield* relayer.awaitConfirmation({ hash }).pipe(Effect.timeout("10 minutes"))
75
+ })
76
+
77
+ const RpcLive = EvmRpc.layerConfig({
78
+ network: Config.succeed("Ethereum"),
79
+ endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("ETHEREUM_RPC_URL") })])
80
+ })
81
+
82
+ const main = program.pipe(
83
+ Effect.provide(EvmRelayer.layer().pipe(Layer.provide(RpcLive), Layer.provide(FetchHttpClient.layer)))
84
+ )
85
+ ```
86
+
87
+ Endpoint fallback, the error reasons, the transaction statuses and confirmations are described in [Concepts](https://github.com/spiko-tech/effect-blockchain/blob/main/docs/concepts.md).
88
+
11
89
  ## License
12
90
 
13
91
  MIT
@@ -1,6 +1,6 @@
1
1
  import * as Config from "effect/Config";
2
2
  import * as Context from "effect/Context";
3
- import * as Duration from "effect/Duration";
3
+ import type * as Duration from "effect/Duration";
4
4
  import * as Effect from "effect/Effect";
5
5
  import * as Layer from "effect/Layer";
6
6
  import * as Schedule from "effect/Schedule";
@@ -32,7 +32,8 @@ export interface EvmIndexerBatch {
32
32
  readonly logs: ReadonlyArray<EvmLog>;
33
33
  }
34
34
  /**
35
- * The {@link EvmIndexer.Service.streamLogs} options.
35
+ * The {@link EvmIndexer.Service.streamLogs} options. `toBlock`, `poll` and `retry` are described in
36
+ * [Concepts](https://github.com/spiko-tech/effect-blockchain/blob/main/docs/concepts.md#indexer-streams).
36
37
  *
37
38
  * @since 0.1.0
38
39
  * @category models
@@ -40,14 +41,8 @@ export interface EvmIndexerBatch {
40
41
  export interface EvmIndexerStreamOptions {
41
42
  readonly filter: Omit<EvmIndexerFilter, "fromBlock" | "toBlock">;
42
43
  readonly fromBlock: bigint;
43
- /** The stream ends after the batch reaching it, and is empty when `fromBlock > toBlock`. */
44
44
  readonly toBlock?: bigint | undefined;
45
- /**
46
- * When to read the head again once caught up, `Schedule.spaced(DEFAULT_POLL_INTERVAL)` by default. It restarts after
47
- * each batch, and its end ends the stream: `Schedule.recurs(0)` drains to the head and stops.
48
- */
49
45
  readonly poll?: Schedule.Schedule<unknown> | undefined;
50
- /** Retries a step failing with a transient reason ({@link JsonRpc.isTransient}) at the same block. Off by default. */
51
46
  readonly retry?: Schedule.Schedule<unknown, EvmRpc.EvmRpcError> | undefined;
52
47
  }
53
48
  /**
@@ -71,7 +66,6 @@ export interface EvmNativeBalance {
71
66
  export interface EvmIndexerNativeBalanceOptions {
72
67
  readonly address: EvmAddress;
73
68
  readonly fromBlock: bigint;
74
- /** The stream ends after the last sample not above it, and is empty when `fromBlock > toBlock`. */
75
69
  readonly toBlock?: bigint | undefined;
76
70
  readonly step: number;
77
71
  readonly poll?: Schedule.Schedule<unknown> | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"EvmIndexer.d.ts","sourceRoot":"","sources":["../src/EvmIndexer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"EvmIndexer.d.ts","sourceRoot":"","sources":["../src/EvmIndexer.ts"],"names":[],"mappings":"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"}
@@ -1,66 +1,59 @@
1
1
  /**
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.
2
+ * Reads the logs of a set of contracts and the native balance of an address over confirmed blocks, on top of
3
+ * {@link EvmRpc.EvmRpc}, once or as a stream following the confirmed head. The stream options are described in
4
+ * [Concepts](https://github.com/spiko-tech/effect-blockchain/blob/main/docs/concepts.md#indexer-streams).
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. A balance is one
7
- * `eth_getBalance` per sample.
6
+ * A log range is split into ranges of at most `maxBlockRange` blocks, with one `eth_getLogs` each. A failing range
7
+ * fails the whole call, and the caller retries the same range.
8
8
  *
9
9
  * @example
10
10
  * ```ts
11
- * import type { EvmIndexerFilter } from "@effect-blockchain/evm/EvmIndexer"
12
- * import { EvmIndexer } from "@effect-blockchain/evm/EvmIndexer"
11
+ * import * as EvmIndexer from "@effect-blockchain/evm/EvmIndexer"
12
+ * import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
13
+ * import * as Config from "effect/Config"
13
14
  * import * as Effect from "effect/Effect"
14
- * import * as Schedule from "effect/Schedule"
15
+ * import * as FetchHttpClient from "effect/http/FetchHttpClient"
16
+ * import * as Layer from "effect/Layer"
15
17
  * import * as Stream from "effect/Stream"
16
18
  *
17
- * declare const filter: Omit<EvmIndexerFilter, "fromBlock" | "toBlock">
19
+ * declare const filter: Omit<EvmIndexer.EvmIndexerFilter, "fromBlock" | "toBlock">
18
20
  * declare const cursor: bigint
19
21
  * declare const save: (block: bigint) => Effect.Effect<void>
20
22
  *
21
23
  * const program = Effect.gen(function*() {
22
- * const indexer = yield* EvmIndexer
23
- * // once caught up, read the head after 1 s, 2 s, 4 s... at most every minute
24
- * const poll = Schedule.min([Schedule.exponential("1 second"), Schedule.spaced("1 minute")])
25
- * yield* indexer.streamLogs({ filter, fromBlock: cursor + BigInt(1), poll }).pipe(
24
+ * const rpc = yield* EvmRpc.EvmRpc
25
+ * const indexer = yield* EvmIndexer.EvmIndexer
26
+ * yield* Effect.log(`head: ${yield* rpc.blockNumber}`)
27
+ * yield* indexer.streamLogs({ filter, fromBlock: cursor + BigInt(1) }).pipe(
26
28
  * Stream.runForEach((batch) => save(batch.toBlock))
27
29
  * )
28
30
  * })
29
- * ```
30
31
  *
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
- * )
32
+ * const RpcLive = EvmRpc.layerConfig({
33
+ * network: Config.succeed("Ethereum"),
34
+ * endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("ETHEREUM_RPC_URL") })])
46
35
  * })
36
+ *
37
+ * const main = program.pipe(
38
+ * Effect.provide(EvmIndexer.layer().pipe(Layer.provideMerge(RpcLive), Layer.provide(FetchHttpClient.layer)))
39
+ * )
47
40
  * ```
48
41
  *
49
42
  * @since 0.1.0
50
43
  */
44
+ import * as Confirmations from "@effect-blockchain/core/Confirmations";
51
45
  import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
52
46
  import * as Arr from "effect/Array";
53
47
  import * as BigInt_ from "effect/BigInt";
54
48
  import * as Config from "effect/Config";
55
49
  import * as Context from "effect/Context";
56
- import * as Duration from "effect/Duration";
57
50
  import * as Effect from "effect/Effect";
58
51
  import * as Layer from "effect/Layer";
59
52
  import * as Option from "effect/Option";
60
53
  import * as Schedule from "effect/Schedule";
61
54
  import * as Stream from "effect/Stream";
55
+ import * as EvmNetwork from "./EvmNetwork.js";
62
56
  import * as EvmRpc from "./EvmRpc.js";
63
- import * as Confirmations from "./internal/confirmations.js";
64
57
  /**
65
58
  * @since 0.1.0
66
59
  * @category services
@@ -79,7 +72,7 @@ export const DEFAULT_MAX_BLOCK_RANGE = 1000;
79
72
  * @since 0.1.0
80
73
  * @category constants
81
74
  */
82
- export const DEFAULT_POLL_INTERVAL = /*#__PURE__*/Duration.seconds(10);
75
+ export const DEFAULT_POLL_INTERVAL = Confirmations.DEFAULT_POLL_INTERVAL;
83
76
  /**
84
77
  * Builds an {@link EvmIndexer} reading through the provided {@link EvmRpc.EvmRpc}.
85
78
  *
@@ -96,7 +89,8 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
96
89
  return yield* Effect.die(new RangeError(`maxBlockRange must be a positive integer, got ${maxBlockRange}`));
97
90
  }
98
91
  const size = BigInt(maxBlockRange);
99
- const lastConfirmedBlock = Confirmations.lastConfirmedBlock(rpc, options.confirmations).pipe(Effect.withSpan("EvmIndexer.lastConfirmedBlock"));
92
+ const confirmations = options.confirmations ?? EvmNetwork.defaultConfirmations(rpc.network);
93
+ const lastConfirmedBlock = rpc.blockNumber.pipe(Effect.map(head => Confirmations.lastConfirmedBlock(head, confirmations)), Effect.withSpan("EvmIndexer.lastConfirmedBlock"));
100
94
  // the head last read is reused while it covers `next` (the confirmed head only moves forward), else polled
101
95
  const confirmedHead = (poll, {
102
96
  head,
@@ -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":[]}
@@ -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;;;;;;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"}
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;AAuCpH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,UAAU,KAAG,MAAgC,CAAA"}
@@ -86,10 +86,11 @@ export const fromChainId = chainId => Option.fromNullishOr(networks.find(network
86
86
  export const isTestnet = network => testnets.includes(network);
87
87
  // testnets reuse their mainnet value: same consensus and block time
88
88
  const confirmations = {
89
- // 2 epochs, Kraken credits at finalization "typically after 64-96": https://support.kraken.com/articles/203325283
89
+ // finalized after 2 epochs of 32 slots: https://ethereum.org/en/developers/docs/consensus-mechanisms/pos/#finality
90
90
  Ethereum: 64,
91
91
  Sepolia: 64,
92
- // milestones finalize in 2-5s since Heimdall v2: https://docs.polygon.technology/pos/concepts/finality/finality/
92
+ // milestones finalize a block within 2 to 5 s, 1 to 3 blocks of 2 s. 32 blocks keep a margin for a late milestone,
93
+ // when a block only has probabilistic finality: https://docs.polygon.technology/pos/concepts/finality/finality/
93
94
  Polygon: 32,
94
95
  PolygonAmoy: 32,
95
96
  // ~1 min of 2s blocks against sequencer reorgs: https://docs.optimism.io/stack/transactions/transaction-finality
@@ -101,18 +102,19 @@ const confirmations = {
101
102
  // confirmed on Tezos L1 in ~6s: https://docs.etherlink.com
102
103
  Etherlink: 20,
103
104
  EtherlinkTestnet: 20,
104
- // Pionex uses 27 for Optimism: https://intercom.help/pionex/en/articles/14700793-what-is-block-confirmation
105
+ // OP Stack, as Base: https://docs.optimism.io/stack/transactions/transaction-finality
105
106
  Optimism: 30,
106
107
  OptimismSepolia: 30,
107
- // Snowman finality is irreversible, Circle uses 1: https://developers.circle.com/circle-mint/blockchain-confirmations
108
+ // Snowman acceptance is final: https://build.avax.network/docs/primary-network/avalanche-consensus
108
109
  Avalanche: 1,
109
110
  AvalancheFuji: 1,
110
- // Kraken uses 50 (fast finality in 2 blocks): https://support.kraken.com/articles/203325283
111
+ // fast finality finalizes a block once its child is justified. 50 blocks keep a margin for when no block is
112
+ // justified and finality is probabilistic again: https://github.com/bnb-chain/BEPs/blob/master/BEPs/BEP126.md
111
113
  BnbSmartChain: 50,
112
114
  BnbSmartChainTestnet: 50,
113
115
  // 2 epochs of 16 slots: https://docs.gnosischain.com/about/specs/consensus/
114
116
  Gnosis: 32,
115
- // ~1 min of 2s blocks, Circle Fast Transfer uses 1: https://developers.circle.com/cctp/required-block-confirmations
117
+ // ~1 min of 2s blocks against sequencer reorgs: https://docs.linea.build/protocol/transaction-lifecycle
116
118
  Linea: 30,
117
119
  LineaSepolia: 30,
118
120
  // local node mines instantly and never reorgs: https://getfoundry.sh/anvil/overview
@@ -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":[]}
@@ -1,7 +1,9 @@
1
+ import * as Config from "effect/Config";
1
2
  import * as Context from "effect/Context";
3
+ import type * as Duration from "effect/Duration";
2
4
  import * as Effect from "effect/Effect";
3
5
  import * as Layer from "effect/Layer";
4
- import * as Schedule from "effect/Schedule";
6
+ import type * as Schedule from "effect/Schedule";
5
7
  import * as Schema from "effect/Schema";
6
8
  import type { EvmAddress } from "./EvmAddress.ts";
7
9
  import type { EvmHexData } from "./EvmHexData.ts";
@@ -9,8 +11,8 @@ import * as EvmRpc from "./EvmRpc.ts";
9
11
  import type { EvmSigner, EvmSignerError } from "./EvmSigner.ts";
10
12
  import { EvmTransactionHash } from "./EvmTransactionHash.ts";
11
13
  /**
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
+ * Where a transaction stands, by `_tag`: see the module's table. `block` is the block holding it. `reason` is always
15
+ * `undefined`: a receipt does not carry the revert data.
14
16
  *
15
17
  * @since 0.3.0
16
18
  * @category models
@@ -26,10 +28,19 @@ export type EvmTransactionStatus = {
26
28
  } | {
27
29
  readonly _tag: "Failed";
28
30
  readonly block: bigint;
29
- readonly reason: EvmHexData | undefined;
31
+ readonly reason: undefined;
30
32
  } | {
31
33
  readonly _tag: "NotFound";
32
34
  };
35
+ /**
36
+ * The transaction to look up: its `hash`.
37
+ *
38
+ * @since 0.4.0
39
+ * @category models
40
+ */
41
+ export interface EvmTransactionStatusOptions {
42
+ readonly hash: EvmTransactionHash;
43
+ }
33
44
  /**
34
45
  * 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
46
  * block producer above the base fee.
@@ -65,15 +76,39 @@ export interface EvmSignedTransaction {
65
76
  readonly signed: EvmHexData;
66
77
  readonly nonce: bigint;
67
78
  }
68
- declare const NonceTooLow_base: Schema.Class<NonceTooLow, Schema.TaggedStruct<"NonceTooLow", {}>, import("effect/Cause").YieldableError>;
79
+ declare const SimulationFailed_base: Schema.Class<SimulationFailed, Schema.TaggedStruct<"SimulationFailed", {
80
+ readonly error: Schema.String;
81
+ }>, import("effect/Cause").YieldableError>;
82
+ /**
83
+ * The simulation of the call failed: `error` is the node's message, with the revert reason when the node gives it.
84
+ *
85
+ * @since 0.4.0
86
+ * @category reasons
87
+ */
88
+ export declare class SimulationFailed extends SimulationFailed_base {
89
+ }
90
+ declare const EvmSimulationError_base: Schema.Class<EvmSimulationError, Schema.TaggedStruct<"EvmSimulationError", {
91
+ readonly reason: Schema.Union<readonly [typeof SimulationFailed]>;
92
+ readonly cause: Schema.Defect;
93
+ }>, import("effect/Cause").YieldableError>;
94
+ /**
95
+ * A transaction could not be prepared for signing, for a `reason` matched with `Effect.catchReason`: `cause` is the
96
+ * {@link EvmRpc.EvmRpcError} of the refused `eth_estimateGas`.
97
+ *
98
+ * @since 0.4.0
99
+ * @category errors
100
+ */
101
+ export declare class EvmSimulationError extends EvmSimulationError_base {
102
+ }
103
+ declare const InvalidNonce_base: Schema.Class<InvalidNonce, Schema.TaggedStruct<"InvalidNonce", {}>, import("effect/Cause").YieldableError>;
69
104
  /**
70
105
  * The sender's nonce is already used by a transaction in a block, and the node does not know this one: another
71
106
  * transaction took its place.
72
107
  *
73
- * @since 0.3.0
108
+ * @since 0.4.0
74
109
  * @category reasons
75
110
  */
76
- export declare class NonceTooLow extends NonceTooLow_base {
111
+ export declare class InvalidNonce extends InvalidNonce_base {
77
112
  }
78
113
  declare const ReplacementUnderpriced_base: Schema.Class<ReplacementUnderpriced, Schema.TaggedStruct<"ReplacementUnderpriced", {}>, import("effect/Cause").YieldableError>;
79
114
  /**
@@ -108,14 +143,14 @@ export declare class InsufficientFunds extends InsufficientFunds_base {
108
143
  * @since 0.3.0
109
144
  * @category reasons
110
145
  */
111
- export declare const EvmBroadcastReason: Schema.Union<readonly [typeof NonceTooLow, typeof ReplacementUnderpriced, typeof FeeTooLow, typeof InsufficientFunds]>;
146
+ export declare const EvmBroadcastReason: Schema.Union<readonly [typeof InvalidNonce, typeof ReplacementUnderpriced, typeof FeeTooLow, typeof InsufficientFunds]>;
112
147
  /**
113
148
  * @since 0.3.0
114
149
  * @category reasons
115
150
  */
116
151
  export type EvmBroadcastReason = typeof EvmBroadcastReason.Type;
117
152
  declare const EvmBroadcastError_base: Schema.Class<EvmBroadcastError, Schema.TaggedStruct<"EvmBroadcastError", {
118
- readonly reason: Schema.Union<readonly [typeof NonceTooLow, typeof ReplacementUnderpriced, typeof FeeTooLow, typeof InsufficientFunds]>;
153
+ readonly reason: Schema.Union<readonly [typeof InvalidNonce, typeof ReplacementUnderpriced, typeof FeeTooLow, typeof InsufficientFunds]>;
119
154
  readonly cause: Schema.Defect;
120
155
  }>, import("effect/Cause").YieldableError>;
121
156
  /**
@@ -130,8 +165,9 @@ export declare class EvmBroadcastError extends EvmBroadcastError_base {
130
165
  declare const EvmRelayer_base: Context.ServiceClass<EvmRelayer, "@effect-blockchain/evm/EvmRelayer", {
131
166
  /**
132
167
  * 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.
168
+ * transaction count, a missing `gas` is `eth_estimateGas` times the layer's `gasMultiplier` (a call the node
169
+ * refuses to estimate, as one that reverts, fails with an {@link EvmSimulationError}), and missing `fees` come from
170
+ * the layer's fee strategy.
135
171
  */
136
172
  readonly sign: (options: {
137
173
  readonly signer: EvmSigner;
@@ -141,7 +177,7 @@ declare const EvmRelayer_base: Context.ServiceClass<EvmRelayer, "@effect-blockch
141
177
  readonly nonce?: bigint | undefined;
142
178
  readonly gas?: bigint | undefined;
143
179
  readonly fees?: EvmFees | undefined;
144
- }) => Effect.Effect<EvmSignedTransaction, EvmRpc.EvmRpcError | EvmSignerError>;
180
+ }) => Effect.Effect<EvmSignedTransaction, EvmRpc.EvmRpcError | EvmSignerError | EvmSimulationError>;
145
181
  /**
146
182
  * Sends a signed transaction with `eth_sendRawTransaction` and returns its hash. Sending the same bytes again is
147
183
  * safe: a node answering that it already has the transaction, or that the nonce is used while it knows this hash,
@@ -154,16 +190,13 @@ declare const EvmRelayer_base: Context.ServiceClass<EvmRelayer, "@effect-blockch
154
190
  * The status of the transaction as the answering endpoint sees it. An endpoint behind the head, or one that never
155
191
  * received the transaction, answers `Pending` or `NotFound` for a transaction another one has in a block.
156
192
  */
157
- readonly fetchTransactionStatus: (options: {
158
- readonly hash: EvmTransactionHash;
159
- }) => Effect.Effect<EvmTransactionStatus, EvmRpc.EvmRpcError>;
193
+ readonly fetchTransactionStatus: (options: EvmTransactionStatusOptions) => Effect.Effect<EvmTransactionStatus, EvmRpc.EvmRpcError>;
160
194
  /**
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.
195
+ * Reads {@link fetchTransactionStatus} on `poll` until it is `Confirmed` or `Failed`, and returns it. `NotFound`
196
+ * keeps polling, so bound the wait with a timeout. `poll` and errors work as in
197
+ * {@link Confirmations.awaitConfirmation}.
164
198
  */
165
- readonly awaitConfirmation: (options: {
166
- readonly hash: EvmTransactionHash;
199
+ readonly awaitConfirmation: (options: EvmTransactionStatusOptions & {
167
200
  readonly poll?: Schedule.Schedule<unknown> | undefined;
168
201
  }) => Effect.Effect<EvmTransactionStatus, EvmRpc.EvmRpcError>;
169
202
  }>;
@@ -173,6 +206,13 @@ declare const EvmRelayer_base: Context.ServiceClass<EvmRelayer, "@effect-blockch
173
206
  */
174
207
  export declare class EvmRelayer extends EvmRelayer_base {
175
208
  }
209
+ /**
210
+ * The default `poll` spacing of {@link EvmRelayer.Service.awaitConfirmation}: 10 seconds.
211
+ *
212
+ * @since 0.4.0
213
+ * @category constants
214
+ */
215
+ export declare const DEFAULT_POLL_INTERVAL: Duration.Duration;
176
216
  /**
177
217
  * The library's fee strategy: the priority fee is the median over the blocks of their 50th percentile reward, at
178
218
  * least 0.001 gwei, and `maxFeePerGas` is twice the next base fee plus that priority fee. Doubling the base fee keeps
@@ -196,5 +236,21 @@ export declare const layer: (options?: {
196
236
  readonly fees?: ((estimate: EvmFeeEstimate) => EvmFees) | undefined;
197
237
  readonly gasMultiplier?: number | undefined;
198
238
  }) => Layer.Layer<EvmRelayer, never, EvmRpc.EvmRpc>;
239
+ /**
240
+ * Builds an {@link EvmRelayer} like {@link layer}, reading `confirmations` and `gasMultiplier` from `Config`. The fee
241
+ * strategy is {@link defaultFees}.
242
+ *
243
+ * @example
244
+ * ```ts
245
+ * import * as EvmRelayer from "@effect-blockchain/evm/EvmRelayer"
246
+ * import * as Config from "effect/Config"
247
+ *
248
+ * const RelayerLive = EvmRelayer.layerConfig({ confirmations: Config.Int("ETHEREUM_CONFIRMATIONS") })
249
+ * ```
250
+ *
251
+ * @since 0.4.0
252
+ * @category layers
253
+ */
254
+ export declare const layerConfig: (options: Config.Wrap<Omit<NonNullable<Parameters<typeof layer>[0]>, "fees">>) => Layer.Layer<EvmRelayer, Config.ConfigError, EvmRpc.EvmRpc>;
199
255
  export {};
200
256
  //# sourceMappingURL=EvmRelayer.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"EvmRelayer.d.ts","sourceRoot":"","sources":["../src/EvmRelayer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"EvmRelayer.d.ts","sourceRoot":"","sources":["../src/EvmRelayer.ts"],"names":[],"mappings":"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"}