@effect-blockchain/evm 0.2.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 +79 -1
- package/dist/EvmFeeHistory.d.ts +26 -0
- package/dist/EvmFeeHistory.d.ts.map +1 -0
- package/dist/EvmFeeHistory.js +25 -0
- package/dist/EvmFeeHistory.js.map +1 -0
- package/dist/EvmIndexer.d.ts +47 -9
- package/dist/EvmIndexer.d.ts.map +1 -1
- package/dist/EvmIndexer.js +95 -36
- package/dist/EvmIndexer.js.map +1 -1
- package/dist/EvmNetwork.d.ts.map +1 -1
- package/dist/EvmNetwork.js +8 -6
- package/dist/EvmNetwork.js.map +1 -1
- package/dist/EvmRelayer.d.ts +256 -0
- package/dist/EvmRelayer.d.ts.map +1 -0
- package/dist/EvmRelayer.js +330 -0
- package/dist/EvmRelayer.js.map +1 -0
- package/dist/EvmRpc.d.ts +88 -8
- package/dist/EvmRpc.d.ts.map +1 -1
- package/dist/EvmRpc.js +30 -9
- package/dist/EvmRpc.js.map +1 -1
- package/dist/EvmSigner.d.ts +78 -0
- package/dist/EvmSigner.d.ts.map +1 -0
- package/dist/EvmSigner.js +96 -0
- package/dist/EvmSigner.js.map +1 -0
- package/dist/EvmTransaction.d.ts +65 -0
- package/dist/EvmTransaction.d.ts.map +1 -0
- package/dist/EvmTransaction.js +60 -0
- package/dist/EvmTransaction.js.map +1 -0
- package/dist/index.d.ts +16 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +16 -0
- package/dist/index.js.map +1 -1
- package/dist/internal/rpcMethods.js +57 -5
- package/dist/internal/rpcMethods.js.map +1 -1
- package/package.json +2 -2
- package/src/EvmFeeHistory.ts +28 -0
- package/src/EvmIndexer.ts +142 -49
- package/src/EvmNetwork.ts +8 -6
- package/src/EvmRelayer.ts +425 -0
- package/src/EvmRpc.ts +106 -9
- package/src/EvmSigner.ts +128 -0
- package/src/EvmTransaction.ts +64 -0
- package/src/index.ts +20 -0
- package/src/internal/rpcMethods.ts +67 -6
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
|
|
@@ -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":[]}
|
package/dist/EvmIndexer.d.ts
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
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";
|
|
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
|
/**
|
|
@@ -31,7 +32,8 @@ export interface EvmIndexerBatch {
|
|
|
31
32
|
readonly logs: ReadonlyArray<EvmLog>;
|
|
32
33
|
}
|
|
33
34
|
/**
|
|
34
|
-
* 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).
|
|
35
37
|
*
|
|
36
38
|
* @since 0.1.0
|
|
37
39
|
* @category models
|
|
@@ -39,14 +41,34 @@ export interface EvmIndexerBatch {
|
|
|
39
41
|
export interface EvmIndexerStreamOptions {
|
|
40
42
|
readonly filter: Omit<EvmIndexerFilter, "fromBlock" | "toBlock">;
|
|
41
43
|
readonly fromBlock: bigint;
|
|
42
|
-
/** The stream ends after the batch reaching it, and is empty when `fromBlock > toBlock`. */
|
|
43
44
|
readonly toBlock?: bigint | undefined;
|
|
44
|
-
/**
|
|
45
|
-
* When to read the head again once caught up, `Schedule.spaced(DEFAULT_POLL_INTERVAL)` by default. It restarts after
|
|
46
|
-
* each batch, and its end ends the stream: `Schedule.recurs(0)` drains to the head and stops.
|
|
47
|
-
*/
|
|
48
45
|
readonly poll?: Schedule.Schedule<unknown> | undefined;
|
|
49
|
-
|
|
46
|
+
readonly retry?: Schedule.Schedule<unknown, EvmRpc.EvmRpcError> | undefined;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* The native balance of an address in wei at the end of `block`, emitted by
|
|
50
|
+
* {@link EvmIndexer.Service.streamNativeBalance}.
|
|
51
|
+
*
|
|
52
|
+
* @since 0.3.0
|
|
53
|
+
* @category models
|
|
54
|
+
*/
|
|
55
|
+
export interface EvmNativeBalance {
|
|
56
|
+
readonly block: bigint;
|
|
57
|
+
readonly balance: bigint;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* The {@link EvmIndexer.Service.streamNativeBalance} options: one sample at `fromBlock`, then every `step` blocks.
|
|
61
|
+
* `step` is a positive safe integer, `poll` and `retry` work as in {@link EvmIndexerStreamOptions}.
|
|
62
|
+
*
|
|
63
|
+
* @since 0.3.0
|
|
64
|
+
* @category models
|
|
65
|
+
*/
|
|
66
|
+
export interface EvmIndexerNativeBalanceOptions {
|
|
67
|
+
readonly address: EvmAddress;
|
|
68
|
+
readonly fromBlock: bigint;
|
|
69
|
+
readonly toBlock?: bigint | undefined;
|
|
70
|
+
readonly step: number;
|
|
71
|
+
readonly poll?: Schedule.Schedule<unknown> | undefined;
|
|
50
72
|
readonly retry?: Schedule.Schedule<unknown, EvmRpc.EvmRpcError> | undefined;
|
|
51
73
|
}
|
|
52
74
|
declare const EvmIndexer_base: Context.ServiceClass<EvmIndexer, "@effect-blockchain/evm/EvmIndexer", {
|
|
@@ -62,6 +84,22 @@ declare const EvmIndexer_base: Context.ServiceClass<EvmIndexer, "@effect-blockch
|
|
|
62
84
|
* the confirmed head.
|
|
63
85
|
*/
|
|
64
86
|
readonly streamLogs: (options: EvmIndexerStreamOptions) => Stream.Stream<EvmIndexerBatch, EvmRpc.EvmRpcError>;
|
|
87
|
+
/**
|
|
88
|
+
* The native balance of `address` in wei at the end of `block`, which needs an archive endpoint for an old block.
|
|
89
|
+
*
|
|
90
|
+
* @since 0.3.0
|
|
91
|
+
*/
|
|
92
|
+
readonly fetchNativeBalance: (options: {
|
|
93
|
+
readonly address: EvmAddress;
|
|
94
|
+
readonly block: bigint;
|
|
95
|
+
}) => Effect.Effect<bigint, EvmRpc.EvmRpcError>;
|
|
96
|
+
/**
|
|
97
|
+
* The native balance of `address` at `fromBlock`, `fromBlock + step`, ... (a sample at every step, changed or not),
|
|
98
|
+
* each read once its block is confirmed, following the confirmed head.
|
|
99
|
+
*
|
|
100
|
+
* @since 0.3.0
|
|
101
|
+
*/
|
|
102
|
+
readonly streamNativeBalance: (options: EvmIndexerNativeBalanceOptions) => Stream.Stream<EvmNativeBalance, EvmRpc.EvmRpcError>;
|
|
65
103
|
}>;
|
|
66
104
|
/**
|
|
67
105
|
* @since 0.1.0
|
|
@@ -86,7 +124,7 @@ export declare const DEFAULT_POLL_INTERVAL: Duration.Duration;
|
|
|
86
124
|
/**
|
|
87
125
|
* Builds an {@link EvmIndexer} reading through the provided {@link EvmRpc.EvmRpc}.
|
|
88
126
|
*
|
|
89
|
-
* - `confirmations` overrides
|
|
127
|
+
* - `confirmations` overrides `EvmNetwork.defaultConfirmations` for the RPC's network.
|
|
90
128
|
* - `maxBlockRange`, a positive integer, defaults to {@link DEFAULT_MAX_BLOCK_RANGE}.
|
|
91
129
|
*
|
|
92
130
|
* @since 0.1.0
|
package/dist/EvmIndexer.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"EvmIndexer.d.ts","sourceRoot":"","sources":["../src/EvmIndexer.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"EvmIndexer.d.ts","sourceRoot":"","sources":["../src/EvmIndexer.ts"],"names":[],"mappings":"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"}
|
package/dist/EvmIndexer.js
CHANGED
|
@@ -1,40 +1,52 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
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`
|
|
6
|
-
* fails the whole call and
|
|
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.
|
|
7
8
|
*
|
|
8
9
|
* @example
|
|
9
10
|
* ```ts
|
|
10
|
-
* import
|
|
11
|
-
* import
|
|
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"
|
|
12
14
|
* import * as Effect from "effect/Effect"
|
|
13
|
-
* import * as
|
|
15
|
+
* import * as FetchHttpClient from "effect/http/FetchHttpClient"
|
|
16
|
+
* import * as Layer from "effect/Layer"
|
|
14
17
|
* import * as Stream from "effect/Stream"
|
|
15
18
|
*
|
|
16
|
-
* declare const filter: Omit<EvmIndexerFilter, "fromBlock" | "toBlock">
|
|
19
|
+
* declare const filter: Omit<EvmIndexer.EvmIndexerFilter, "fromBlock" | "toBlock">
|
|
17
20
|
* declare const cursor: bigint
|
|
18
21
|
* declare const save: (block: bigint) => Effect.Effect<void>
|
|
19
22
|
*
|
|
20
23
|
* const program = Effect.gen(function*() {
|
|
21
|
-
* const
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
* yield* indexer.streamLogs({ filter, fromBlock: cursor + BigInt(1)
|
|
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(
|
|
25
28
|
* Stream.runForEach((batch) => save(batch.toBlock))
|
|
26
29
|
* )
|
|
27
30
|
* })
|
|
31
|
+
*
|
|
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") })])
|
|
35
|
+
* })
|
|
36
|
+
*
|
|
37
|
+
* const main = program.pipe(
|
|
38
|
+
* Effect.provide(EvmIndexer.layer().pipe(Layer.provideMerge(RpcLive), Layer.provide(FetchHttpClient.layer)))
|
|
39
|
+
* )
|
|
28
40
|
* ```
|
|
29
41
|
*
|
|
30
42
|
* @since 0.1.0
|
|
31
43
|
*/
|
|
44
|
+
import * as Confirmations from "@effect-blockchain/core/Confirmations";
|
|
32
45
|
import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
|
|
33
46
|
import * as Arr from "effect/Array";
|
|
34
47
|
import * as BigInt_ from "effect/BigInt";
|
|
35
48
|
import * as Config from "effect/Config";
|
|
36
49
|
import * as Context from "effect/Context";
|
|
37
|
-
import * as Duration from "effect/Duration";
|
|
38
50
|
import * as Effect from "effect/Effect";
|
|
39
51
|
import * as Layer from "effect/Layer";
|
|
40
52
|
import * as Option from "effect/Option";
|
|
@@ -60,11 +72,11 @@ export const DEFAULT_MAX_BLOCK_RANGE = 1000;
|
|
|
60
72
|
* @since 0.1.0
|
|
61
73
|
* @category constants
|
|
62
74
|
*/
|
|
63
|
-
export const DEFAULT_POLL_INTERVAL =
|
|
75
|
+
export const DEFAULT_POLL_INTERVAL = Confirmations.DEFAULT_POLL_INTERVAL;
|
|
64
76
|
/**
|
|
65
77
|
* Builds an {@link EvmIndexer} reading through the provided {@link EvmRpc.EvmRpc}.
|
|
66
78
|
*
|
|
67
|
-
* - `confirmations` overrides
|
|
79
|
+
* - `confirmations` overrides `EvmNetwork.defaultConfirmations` for the RPC's network.
|
|
68
80
|
* - `maxBlockRange`, a positive integer, defaults to {@link DEFAULT_MAX_BLOCK_RANGE}.
|
|
69
81
|
*
|
|
70
82
|
* @since 0.1.0
|
|
@@ -76,9 +88,26 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
|
|
|
76
88
|
if (!Number.isSafeInteger(maxBlockRange) || maxBlockRange < 1) {
|
|
77
89
|
return yield* Effect.die(new RangeError(`maxBlockRange must be a positive integer, got ${maxBlockRange}`));
|
|
78
90
|
}
|
|
79
|
-
const confirmations = BigInt(options.confirmations ?? EvmNetwork.defaultConfirmations(rpc.network));
|
|
80
91
|
const size = BigInt(maxBlockRange);
|
|
81
|
-
const
|
|
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"));
|
|
94
|
+
// the head last read is reused while it covers `next` (the confirmed head only moves forward), else polled
|
|
95
|
+
const confirmedHead = (poll, {
|
|
96
|
+
head,
|
|
97
|
+
next
|
|
98
|
+
}) => next <= head ? Effect.succeed(head) : lastConfirmedBlock.pipe(Effect.repeat({
|
|
99
|
+
schedule: poll,
|
|
100
|
+
until: confirmed => confirmed >= next
|
|
101
|
+
}));
|
|
102
|
+
const paginate = (start, retry, step) => Stream.paginate(
|
|
103
|
+
// a head below `start`: the first step reads it
|
|
104
|
+
{
|
|
105
|
+
next: start,
|
|
106
|
+
head: start - BigInt(1)
|
|
107
|
+
}, retry === undefined ? step : position => Effect.retry(step(position), {
|
|
108
|
+
schedule: retry,
|
|
109
|
+
while: error => JsonRpc.isTransient(error.reason)
|
|
110
|
+
}));
|
|
82
111
|
const fetchLogs = Effect.fn("EvmIndexer.fetchLogs")(filter => {
|
|
83
112
|
if (filter.fromBlock > filter.toBlock) return Effect.succeed([]);
|
|
84
113
|
const count = Number((filter.toBlock - filter.fromBlock) / size) + 1;
|
|
@@ -88,6 +117,13 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
|
|
|
88
117
|
toBlock: BigInt_.min(fromBlock + size - BigInt(1), filter.toBlock)
|
|
89
118
|
})).pipe(Effect.map(Arr.flatten));
|
|
90
119
|
});
|
|
120
|
+
const fetchNativeBalance = Effect.fn("EvmIndexer.fetchNativeBalance")(({
|
|
121
|
+
address,
|
|
122
|
+
block
|
|
123
|
+
}) => rpc.getBalance({
|
|
124
|
+
address,
|
|
125
|
+
blockNumber: block
|
|
126
|
+
}));
|
|
91
127
|
return EvmIndexer.of({
|
|
92
128
|
lastConfirmedBlock,
|
|
93
129
|
fetchLogs,
|
|
@@ -99,16 +135,14 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
|
|
|
99
135
|
toBlock
|
|
100
136
|
}) => {
|
|
101
137
|
if (toBlock !== undefined && fromBlock > toBlock) return Stream.empty;
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
}) => (next <= head ? Effect.succeed(head) : lastConfirmedBlock.pipe(Effect.repeat({
|
|
107
|
-
schedule: poll,
|
|
108
|
-
until: confirmed => confirmed >= next
|
|
109
|
-
}))).pipe(Effect.flatMap(confirmed => {
|
|
138
|
+
return paginate(fromBlock, retry, position => confirmedHead(poll, position).pipe(Effect.flatMap(confirmed => {
|
|
139
|
+
const {
|
|
140
|
+
next
|
|
141
|
+
} = position;
|
|
110
142
|
const cap = toBlock === undefined ? confirmed : BigInt_.min(confirmed, toBlock);
|
|
111
|
-
if (next > cap)
|
|
143
|
+
if (next > cap) {
|
|
144
|
+
return Effect.succeed([[], Option.none()]);
|
|
145
|
+
}
|
|
112
146
|
const end = BigInt_.min(next + size - BigInt(1), cap);
|
|
113
147
|
return fetchLogs({
|
|
114
148
|
...filter,
|
|
@@ -122,16 +156,41 @@ export const layer = (options = {}) => Layer.effect(EvmIndexer, Effect.gen(funct
|
|
|
122
156
|
next: end + BigInt(1),
|
|
123
157
|
head: confirmed
|
|
124
158
|
})]));
|
|
125
|
-
}));
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
159
|
+
})));
|
|
160
|
+
},
|
|
161
|
+
fetchNativeBalance,
|
|
162
|
+
streamNativeBalance: ({
|
|
163
|
+
address,
|
|
164
|
+
fromBlock,
|
|
165
|
+
poll = Schedule.spaced(DEFAULT_POLL_INTERVAL),
|
|
166
|
+
retry,
|
|
167
|
+
step,
|
|
168
|
+
toBlock
|
|
169
|
+
}) => {
|
|
170
|
+
if (!Number.isSafeInteger(step) || step < 1) {
|
|
171
|
+
return Stream.die(new RangeError(`step must be a positive safe integer, got ${step}`));
|
|
172
|
+
}
|
|
173
|
+
if (toBlock !== undefined && fromBlock > toBlock) {
|
|
174
|
+
return Stream.empty;
|
|
175
|
+
}
|
|
176
|
+
const stride = BigInt(step);
|
|
177
|
+
return paginate(fromBlock, retry, position => confirmedHead(poll, position).pipe(Effect.flatMap(confirmed => {
|
|
178
|
+
const block = position.next;
|
|
179
|
+
if (block > confirmed) {
|
|
180
|
+
return Effect.succeed([[], Option.none()]);
|
|
181
|
+
}
|
|
182
|
+
const next = block + stride;
|
|
183
|
+
return fetchNativeBalance({
|
|
184
|
+
address,
|
|
185
|
+
block
|
|
186
|
+
}).pipe(Effect.map(balance => [[{
|
|
187
|
+
block,
|
|
188
|
+
balance
|
|
189
|
+
}], toBlock !== undefined && next > toBlock ? Option.none() : Option.some({
|
|
190
|
+
next,
|
|
191
|
+
head: confirmed
|
|
192
|
+
})]));
|
|
193
|
+
})));
|
|
135
194
|
}
|
|
136
195
|
});
|
|
137
196
|
}));
|
package/dist/EvmIndexer.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"EvmIndexer.js","names":[],"sources":["../src/EvmIndexer.ts"],"sourcesContent":[null],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"EvmIndexer.js","names":[],"sources":["../src/EvmIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
|
package/dist/EvmNetwork.d.ts.map
CHANGED
|
@@ -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;
|
|
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"}
|
package/dist/EvmNetwork.js
CHANGED
|
@@ -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
|
|
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
|
|
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
|
-
//
|
|
105
|
+
// OP Stack, as Base: https://docs.optimism.io/stack/transactions/transaction-finality
|
|
105
106
|
Optimism: 30,
|
|
106
107
|
OptimismSepolia: 30,
|
|
107
|
-
// Snowman
|
|
108
|
+
// Snowman acceptance is final: https://build.avax.network/docs/primary-network/avalanche-consensus
|
|
108
109
|
Avalanche: 1,
|
|
109
110
|
AvalancheFuji: 1,
|
|
110
|
-
//
|
|
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
|
|
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
|
package/dist/EvmNetwork.js.map
CHANGED
|
@@ -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":[]}
|