@effect-blockchain/evm 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +12 -2
- package/dist/EvmAddress.d.ts +33 -0
- package/dist/EvmAddress.d.ts.map +1 -0
- package/dist/EvmAddress.js +43 -0
- package/dist/EvmAddress.js.map +1 -0
- package/dist/EvmBlock.d.ts +25 -0
- package/dist/EvmBlock.d.ts.map +1 -0
- package/dist/EvmBlock.js +25 -0
- package/dist/EvmBlock.js.map +1 -0
- package/dist/EvmHexData.d.ts +19 -0
- package/dist/EvmHexData.d.ts.map +1 -0
- package/dist/EvmHexData.js +31 -0
- package/dist/EvmHexData.js.map +1 -0
- package/dist/EvmIndexer.d.ts +115 -0
- package/dist/EvmIndexer.d.ts.map +1 -0
- package/dist/EvmIndexer.js +153 -0
- package/dist/EvmIndexer.js.map +1 -0
- package/dist/EvmLog.d.ts +32 -0
- package/dist/EvmLog.d.ts.map +1 -0
- package/dist/EvmLog.js +34 -0
- package/dist/EvmLog.js.map +1 -0
- package/dist/EvmNetwork.d.ts +71 -0
- package/dist/EvmNetwork.d.ts.map +1 -0
- package/dist/EvmNetwork.js +122 -0
- package/dist/EvmNetwork.js.map +1 -0
- package/dist/EvmRpc.d.ts +154 -0
- package/dist/EvmRpc.d.ts.map +1 -0
- package/dist/EvmRpc.js +174 -0
- package/dist/EvmRpc.js.map +1 -0
- package/dist/EvmTransactionHash.d.ts +19 -0
- package/dist/EvmTransactionHash.d.ts.map +1 -0
- package/dist/EvmTransactionHash.js +29 -0
- package/dist/EvmTransactionHash.js.map +1 -0
- package/dist/index.d.ts +36 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +37 -0
- package/dist/index.js.map +1 -0
- package/dist/internal/QuantityFromHex.d.ts +2 -0
- package/dist/internal/QuantityFromHex.d.ts.map +1 -0
- package/dist/internal/QuantityFromHex.js +23 -0
- package/dist/internal/QuantityFromHex.js.map +1 -0
- package/dist/internal/rpcMethods.d.ts +2 -0
- package/dist/internal/rpcMethods.d.ts.map +1 -0
- package/dist/internal/rpcMethods.js +46 -0
- package/dist/internal/rpcMethods.js.map +1 -0
- package/package.json +70 -3
- package/src/EvmAddress.ts +53 -0
- package/src/EvmBlock.ts +28 -0
- package/src/EvmHexData.ts +39 -0
- package/src/EvmIndexer.ts +222 -0
- package/src/EvmLog.ts +37 -0
- package/src/EvmNetwork.ts +169 -0
- package/src/EvmRpc.ts +272 -0
- package/src/EvmTransactionHash.ts +36 -0
- package/src/index.ts +45 -0
- package/src/internal/QuantityFromHex.ts +24 -0
- package/src/internal/rpcMethods.ts +43 -0
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Named EVM networks and their chain IDs.
|
|
3
|
+
*
|
|
4
|
+
* @since 0.1.0
|
|
5
|
+
*/
|
|
6
|
+
import * as Option from "effect/Option";
|
|
7
|
+
import * as Schema from "effect/Schema";
|
|
8
|
+
/**
|
|
9
|
+
* @since 0.1.0
|
|
10
|
+
* @category constants
|
|
11
|
+
*/
|
|
12
|
+
export declare const mainnets: readonly ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea"];
|
|
13
|
+
/**
|
|
14
|
+
* @since 0.1.0
|
|
15
|
+
* @category constants
|
|
16
|
+
*/
|
|
17
|
+
export declare const testnets: readonly ["Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia"];
|
|
18
|
+
/**
|
|
19
|
+
* Every supported network, mainnets first.
|
|
20
|
+
*
|
|
21
|
+
* @since 0.1.0
|
|
22
|
+
* @category constants
|
|
23
|
+
*/
|
|
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"];
|
|
25
|
+
/**
|
|
26
|
+
* @since 0.1.0
|
|
27
|
+
* @category schemas
|
|
28
|
+
*/
|
|
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"]>;
|
|
30
|
+
/**
|
|
31
|
+
* @since 0.1.0
|
|
32
|
+
* @category models
|
|
33
|
+
*/
|
|
34
|
+
export type EvmNetwork = typeof EvmNetwork.Type;
|
|
35
|
+
/**
|
|
36
|
+
* An EIP-155 chain ID: a positive integer.
|
|
37
|
+
*
|
|
38
|
+
* @since 0.1.0
|
|
39
|
+
* @category schemas
|
|
40
|
+
*/
|
|
41
|
+
export declare const EvmChainId: Schema.brand<Schema.Int, "EvmChainId">;
|
|
42
|
+
/**
|
|
43
|
+
* @since 0.1.0
|
|
44
|
+
* @category models
|
|
45
|
+
*/
|
|
46
|
+
export type EvmChainId = typeof EvmChainId.Type;
|
|
47
|
+
/**
|
|
48
|
+
* @since 0.1.0
|
|
49
|
+
* @category conversions
|
|
50
|
+
*/
|
|
51
|
+
export declare const toChainId: (network: EvmNetwork) => EvmChainId;
|
|
52
|
+
/**
|
|
53
|
+
* Returns the named network for a chain ID, or `None` when the chain is not in {@link networks}.
|
|
54
|
+
*
|
|
55
|
+
* @since 0.1.0
|
|
56
|
+
* @category conversions
|
|
57
|
+
*/
|
|
58
|
+
export declare const fromChainId: (chainId: number) => Option.Option<EvmNetwork>;
|
|
59
|
+
/**
|
|
60
|
+
* @since 0.1.0
|
|
61
|
+
* @category predicates
|
|
62
|
+
*/
|
|
63
|
+
export declare const isTestnet: (network: EvmNetwork) => boolean;
|
|
64
|
+
/**
|
|
65
|
+
* The number of blocks behind the head after which a block is treated as final by default.
|
|
66
|
+
*
|
|
67
|
+
* @since 0.1.0
|
|
68
|
+
* @category getters
|
|
69
|
+
*/
|
|
70
|
+
export declare const defaultConfirmations: (network: EvmNetwork) => number;
|
|
71
|
+
//# sourceMappingURL=EvmNetwork.d.ts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Named EVM networks and their chain IDs.
|
|
3
|
+
*
|
|
4
|
+
* @since 0.1.0
|
|
5
|
+
*/
|
|
6
|
+
import * as Option from "effect/Option";
|
|
7
|
+
import * as Schema from "effect/Schema";
|
|
8
|
+
/**
|
|
9
|
+
* @since 0.1.0
|
|
10
|
+
* @category constants
|
|
11
|
+
*/
|
|
12
|
+
export const mainnets = ["Ethereum", "Polygon", "Base", "Arbitrum", "Etherlink", "Optimism", "Avalanche", "BnbSmartChain", "Gnosis", "Linea"];
|
|
13
|
+
/**
|
|
14
|
+
* @since 0.1.0
|
|
15
|
+
* @category constants
|
|
16
|
+
*/
|
|
17
|
+
export const testnets = ["Sepolia", "PolygonAmoy", "BaseSepolia", "ArbitrumSepolia", "EtherlinkTestnet", "OptimismSepolia", "AvalancheFuji", "BnbSmartChainTestnet", "LineaSepolia"];
|
|
18
|
+
/**
|
|
19
|
+
* Every supported network, mainnets first.
|
|
20
|
+
*
|
|
21
|
+
* @since 0.1.0
|
|
22
|
+
* @category constants
|
|
23
|
+
*/
|
|
24
|
+
export const networks = [...mainnets, ...testnets];
|
|
25
|
+
/**
|
|
26
|
+
* @since 0.1.0
|
|
27
|
+
* @category schemas
|
|
28
|
+
*/
|
|
29
|
+
export const EvmNetwork = /*#__PURE__*/Schema.Literals(networks).annotate({
|
|
30
|
+
identifier: "EvmNetwork",
|
|
31
|
+
title: "EVM network",
|
|
32
|
+
description: "a named EVM network e.g. \"Ethereum\", \"Polygon\", \"Arbitrum\""
|
|
33
|
+
});
|
|
34
|
+
/**
|
|
35
|
+
* An EIP-155 chain ID: a positive integer.
|
|
36
|
+
*
|
|
37
|
+
* @since 0.1.0
|
|
38
|
+
* @category schemas
|
|
39
|
+
*/
|
|
40
|
+
export const EvmChainId = /*#__PURE__*/Schema.Int.check(Schema.isGreaterThan(0)).pipe(/*#__PURE__*/Schema.brand("EvmChainId"), /*#__PURE__*/Schema.annotate({
|
|
41
|
+
identifier: "EvmChainId",
|
|
42
|
+
title: "EVM chain ID",
|
|
43
|
+
description: "an EIP-155 chain ID, a positive integer e.g. 1 for Ethereum"
|
|
44
|
+
}));
|
|
45
|
+
const chainIds = {
|
|
46
|
+
Ethereum: 1,
|
|
47
|
+
Sepolia: 11155111,
|
|
48
|
+
Polygon: 137,
|
|
49
|
+
PolygonAmoy: 80002,
|
|
50
|
+
Base: 8453,
|
|
51
|
+
BaseSepolia: 84532,
|
|
52
|
+
Arbitrum: 42161,
|
|
53
|
+
ArbitrumSepolia: 421614,
|
|
54
|
+
Etherlink: 42793,
|
|
55
|
+
EtherlinkTestnet: 128123,
|
|
56
|
+
Optimism: 10,
|
|
57
|
+
OptimismSepolia: 11155420,
|
|
58
|
+
Avalanche: 43114,
|
|
59
|
+
AvalancheFuji: 43113,
|
|
60
|
+
BnbSmartChain: 56,
|
|
61
|
+
BnbSmartChainTestnet: 97,
|
|
62
|
+
Gnosis: 100,
|
|
63
|
+
Linea: 59144,
|
|
64
|
+
LineaSepolia: 59141
|
|
65
|
+
};
|
|
66
|
+
/**
|
|
67
|
+
* @since 0.1.0
|
|
68
|
+
* @category conversions
|
|
69
|
+
*/
|
|
70
|
+
export const toChainId = network => EvmChainId.make(chainIds[network]);
|
|
71
|
+
/**
|
|
72
|
+
* Returns the named network for a chain ID, or `None` when the chain is not in {@link networks}.
|
|
73
|
+
*
|
|
74
|
+
* @since 0.1.0
|
|
75
|
+
* @category conversions
|
|
76
|
+
*/
|
|
77
|
+
export const fromChainId = chainId => Option.fromNullishOr(networks.find(network => chainIds[network] === chainId));
|
|
78
|
+
/**
|
|
79
|
+
* @since 0.1.0
|
|
80
|
+
* @category predicates
|
|
81
|
+
*/
|
|
82
|
+
export const isTestnet = network => testnets.includes(network);
|
|
83
|
+
// testnets reuse their mainnet value: same consensus and block time
|
|
84
|
+
const confirmations = {
|
|
85
|
+
// 2 epochs, Kraken credits at finalization "typically after 64-96": https://support.kraken.com/articles/203325283
|
|
86
|
+
Ethereum: 64,
|
|
87
|
+
Sepolia: 64,
|
|
88
|
+
// milestones finalize in 2-5s since Heimdall v2: https://docs.polygon.technology/pos/concepts/finality/finality/
|
|
89
|
+
Polygon: 32,
|
|
90
|
+
PolygonAmoy: 32,
|
|
91
|
+
// ~1 min of 2s blocks against sequencer reorgs: https://docs.optimism.io/stack/transactions/transaction-finality
|
|
92
|
+
Base: 30,
|
|
93
|
+
BaseSepolia: 30,
|
|
94
|
+
// ~1 min of 0.25s blocks: https://docs.arbitrum.io/how-arbitrum-works/reference/finality-and-reorgs
|
|
95
|
+
Arbitrum: 240,
|
|
96
|
+
ArbitrumSepolia: 240,
|
|
97
|
+
// confirmed on Tezos L1 in ~6s: https://docs.etherlink.com
|
|
98
|
+
Etherlink: 20,
|
|
99
|
+
EtherlinkTestnet: 20,
|
|
100
|
+
// Pionex uses 27 for Optimism: https://intercom.help/pionex/en/articles/14700793-what-is-block-confirmation
|
|
101
|
+
Optimism: 30,
|
|
102
|
+
OptimismSepolia: 30,
|
|
103
|
+
// Snowman finality is irreversible, Circle uses 1: https://developers.circle.com/circle-mint/blockchain-confirmations
|
|
104
|
+
Avalanche: 1,
|
|
105
|
+
AvalancheFuji: 1,
|
|
106
|
+
// Kraken uses 50 (fast finality in 2 blocks): https://support.kraken.com/articles/203325283
|
|
107
|
+
BnbSmartChain: 50,
|
|
108
|
+
BnbSmartChainTestnet: 50,
|
|
109
|
+
// 2 epochs of 16 slots: https://docs.gnosischain.com/about/specs/consensus/
|
|
110
|
+
Gnosis: 32,
|
|
111
|
+
// ~1 min of 2s blocks, Circle Fast Transfer uses 1: https://developers.circle.com/cctp/required-block-confirmations
|
|
112
|
+
Linea: 30,
|
|
113
|
+
LineaSepolia: 30
|
|
114
|
+
};
|
|
115
|
+
/**
|
|
116
|
+
* The number of blocks behind the head after which a block is treated as final by default.
|
|
117
|
+
*
|
|
118
|
+
* @since 0.1.0
|
|
119
|
+
* @category getters
|
|
120
|
+
*/
|
|
121
|
+
export const defaultConfirmations = network => confirmations[network];
|
|
122
|
+
//# sourceMappingURL=EvmNetwork.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EvmNetwork.js","names":[],"sources":["../src/EvmNetwork.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
|
package/dist/EvmRpc.d.ts
ADDED
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Typed, read-only EVM JSON-RPC methods over an ordered list of endpoints with fallback.
|
|
3
|
+
*
|
|
4
|
+
* A call starts at the first endpoint and moves to the next one on failure, except on `WrongNetwork`. Each endpoint
|
|
5
|
+
* is checked once to serve the configured network (`eth_chainId`). Every method is a read, so retries and fallback
|
|
6
|
+
* are safe. Methods are named after the JSON-RPC method without its namespace (`eth_getLogs` is `getLogs`).
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
9
|
+
* ```ts
|
|
10
|
+
* import type { EvmLog } from "@effect-blockchain/evm/EvmLog"
|
|
11
|
+
* import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
|
|
12
|
+
* import * as Effect from "effect/Effect"
|
|
13
|
+
*
|
|
14
|
+
* // dates logs with one `eth_getBlockByNumber` per distinct block
|
|
15
|
+
* const withTimestamps = (logs: ReadonlyArray<EvmLog>) =>
|
|
16
|
+
* Effect.gen(function*() {
|
|
17
|
+
* const rpc = yield* EvmRpc.EvmRpc
|
|
18
|
+
* const blocks = yield* Effect.forEach(
|
|
19
|
+
* new Set(logs.map((log) => log.blockNumber)),
|
|
20
|
+
* (blockNumber) => rpc.getBlockByNumber({ blockNumber }),
|
|
21
|
+
* { concurrency: 4 }
|
|
22
|
+
* )
|
|
23
|
+
* const timestamps = new Map(blocks.map((block) => [block.number, block.timestamp]))
|
|
24
|
+
* return logs.map((log) => ({ ...log, timestamp: timestamps.get(log.blockNumber) }))
|
|
25
|
+
* })
|
|
26
|
+
* ```
|
|
27
|
+
*
|
|
28
|
+
* @since 0.1.0
|
|
29
|
+
*/
|
|
30
|
+
import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
|
|
31
|
+
import * as Arr from "effect/Array";
|
|
32
|
+
import * as Config from "effect/Config";
|
|
33
|
+
import * as Context from "effect/Context";
|
|
34
|
+
import type * as Duration from "effect/Duration";
|
|
35
|
+
import * as Effect from "effect/Effect";
|
|
36
|
+
import type * as HttpClient from "effect/http/HttpClient";
|
|
37
|
+
import * as Layer from "effect/Layer";
|
|
38
|
+
import type * as Redacted from "effect/Redacted";
|
|
39
|
+
import * as Schema from "effect/Schema";
|
|
40
|
+
import type { EvmAddress } from "./EvmAddress.ts";
|
|
41
|
+
import type { EvmBlock } from "./EvmBlock.ts";
|
|
42
|
+
import type { EvmHexData } from "./EvmHexData.ts";
|
|
43
|
+
import type { EvmLog } from "./EvmLog.ts";
|
|
44
|
+
import * as EvmNetwork from "./EvmNetwork.ts";
|
|
45
|
+
/**
|
|
46
|
+
* A JSON-RPC endpoint. The `name` is shown in errors and spans, the `url` is never logged.
|
|
47
|
+
*
|
|
48
|
+
* @since 0.1.0
|
|
49
|
+
* @category models
|
|
50
|
+
*/
|
|
51
|
+
export interface EvmRpcEndpoint {
|
|
52
|
+
readonly name: string;
|
|
53
|
+
readonly url: Redacted.Redacted<string>;
|
|
54
|
+
}
|
|
55
|
+
declare const EvmRpcError_base: Schema.Class<EvmRpcError, Schema.TaggedStruct<"EvmRpcError", {
|
|
56
|
+
readonly reason: Schema.Union<readonly [typeof JsonRpc.Unavailable, typeof JsonRpc.InvalidResponse, typeof JsonRpc.Lagging, typeof JsonRpc.Pruned, typeof JsonRpc.Rejected, typeof JsonRpc.WrongNetwork]>;
|
|
57
|
+
readonly method: Schema.String;
|
|
58
|
+
readonly endpoint: Schema.String;
|
|
59
|
+
readonly code: Schema.optional<Schema.Number>;
|
|
60
|
+
readonly cause: Schema.Defect;
|
|
61
|
+
}>, import("effect/Cause").YieldableError>;
|
|
62
|
+
/**
|
|
63
|
+
* A failed call: its `reason` (a {@link JsonRpc.Reason}, matched with `Effect.catchReason`), the JSON-RPC error code or
|
|
64
|
+
* HTTP status as `code`, and a `cause` without the endpoint URL. After several endpoints, the error is the last one
|
|
65
|
+
* and `cause` is an `AggregateError` of each endpoint's error, in order.
|
|
66
|
+
*
|
|
67
|
+
* On EVM, `Unavailable` includes the codes -32005, -32603, -32007, -1 and 429, `InvalidResponse` a log outside the
|
|
68
|
+
* `getLogs` filter, and `Lagging` a head below the requested block.
|
|
69
|
+
*
|
|
70
|
+
* @since 0.1.0
|
|
71
|
+
* @category errors
|
|
72
|
+
*/
|
|
73
|
+
export declare class EvmRpcError extends EvmRpcError_base {
|
|
74
|
+
/**
|
|
75
|
+
* @since 0.1.0
|
|
76
|
+
*/
|
|
77
|
+
get message(): string;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* An `eth_getLogs` filter over the inclusive block range `[fromBlock, toBlock]`, matching the logs of any of
|
|
81
|
+
* `addresses`. The addresses are always sent as the JSON-RPC `address` array.
|
|
82
|
+
*
|
|
83
|
+
* @since 0.1.0
|
|
84
|
+
* @category models
|
|
85
|
+
*/
|
|
86
|
+
export interface EvmLogsFilter {
|
|
87
|
+
readonly addresses: Arr.NonEmptyReadonlyArray<EvmAddress>;
|
|
88
|
+
readonly fromBlock: bigint;
|
|
89
|
+
readonly toBlock: bigint;
|
|
90
|
+
readonly topics?: ReadonlyArray<EvmHexData | ReadonlyArray<EvmHexData> | null> | undefined;
|
|
91
|
+
}
|
|
92
|
+
declare const EvmRpc_base: Context.ServiceClass<EvmRpc, "@effect-blockchain/evm/EvmRpc", {
|
|
93
|
+
readonly network: EvmNetwork.EvmNetwork;
|
|
94
|
+
/** `eth_chainId`, verified against `network` once per endpoint then served from that check. */
|
|
95
|
+
readonly chainId: Effect.Effect<EvmNetwork.EvmChainId, EvmRpcError>;
|
|
96
|
+
/** `eth_blockNumber` */
|
|
97
|
+
readonly blockNumber: Effect.Effect<bigint, EvmRpcError>;
|
|
98
|
+
/**
|
|
99
|
+
* `eth_getBlockByNumber` without the transactions, only answered by an endpoint whose head has reached
|
|
100
|
+
* `blockNumber`. A block unknown to an endpoint past it (`null`) fails with `Lagging`: every node keeps the headers
|
|
101
|
+
* of its chain, so the reply came from a backend node behind the provider's head. A block whose `number` is not the
|
|
102
|
+
* requested one fails with `InvalidResponse`.
|
|
103
|
+
*/
|
|
104
|
+
readonly getBlockByNumber: (options: {
|
|
105
|
+
readonly blockNumber: bigint;
|
|
106
|
+
}) => Effect.Effect<EvmBlock, EvmRpcError>;
|
|
107
|
+
/**
|
|
108
|
+
* `eth_getLogs`, only answered by an endpoint whose head has reached `toBlock`. Logs are returned in chain order:
|
|
109
|
+
* sorted by block then log index. A removed, pending or out-of-filter log fails with `InvalidResponse`. An empty
|
|
110
|
+
* range returns `[]`.
|
|
111
|
+
*/
|
|
112
|
+
readonly getLogs: (filter: EvmLogsFilter) => Effect.Effect<ReadonlyArray<EvmLog>, EvmRpcError>;
|
|
113
|
+
}>;
|
|
114
|
+
/**
|
|
115
|
+
* @since 0.1.0
|
|
116
|
+
* @category services
|
|
117
|
+
*/
|
|
118
|
+
export declare class EvmRpc extends EvmRpc_base {
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Builds an {@link EvmRpc} over `endpoints`, tried in order, sending requests with the provided `HttpClient`
|
|
122
|
+
* (e.g. `FetchHttpClient.layer`). `timeout` (default 30 seconds) bounds each attempt, `retries` (default 3) and
|
|
123
|
+
* `retryDelay` (default 500 millis) set the backoff before falling back: see {@link JsonRpc.Unavailable}.
|
|
124
|
+
*
|
|
125
|
+
* @since 0.1.0
|
|
126
|
+
* @category layers
|
|
127
|
+
*/
|
|
128
|
+
export declare const layer: (options: {
|
|
129
|
+
readonly network: EvmNetwork.EvmNetwork;
|
|
130
|
+
readonly endpoints: Arr.NonEmptyReadonlyArray<EvmRpcEndpoint>;
|
|
131
|
+
readonly timeout?: Duration.Input | undefined;
|
|
132
|
+
readonly retries?: number | undefined;
|
|
133
|
+
readonly retryDelay?: Duration.Input | undefined;
|
|
134
|
+
}) => Layer.Layer<EvmRpc, never, HttpClient.HttpClient>;
|
|
135
|
+
/**
|
|
136
|
+
* Builds an {@link EvmRpc} like {@link layer}, reading the options from `Config`. Endpoint URLs stay `Redacted`.
|
|
137
|
+
*
|
|
138
|
+
* @example
|
|
139
|
+
* ```ts
|
|
140
|
+
* import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
|
|
141
|
+
* import * as Config from "effect/Config"
|
|
142
|
+
*
|
|
143
|
+
* const RpcLive = EvmRpc.layerConfig({
|
|
144
|
+
* network: Config.succeed("Ethereum"),
|
|
145
|
+
* endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("ETHEREUM_RPC_URL") })])
|
|
146
|
+
* })
|
|
147
|
+
* ```
|
|
148
|
+
*
|
|
149
|
+
* @since 0.1.0
|
|
150
|
+
* @category layers
|
|
151
|
+
*/
|
|
152
|
+
export declare const layerConfig: (options: Config.Wrap<Parameters<typeof layer>[0]>) => Layer.Layer<EvmRpc, Config.ConfigError, HttpClient.HttpClient>;
|
|
153
|
+
export {};
|
|
154
|
+
//# sourceMappingURL=EvmRpc.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EvmRpc.d.ts","sourceRoot":"","sources":["../src/EvmRpc.ts"],"names":[],"mappings":"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"}
|
package/dist/EvmRpc.js
ADDED
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Typed, read-only EVM JSON-RPC methods over an ordered list of endpoints with fallback.
|
|
3
|
+
*
|
|
4
|
+
* A call starts at the first endpoint and moves to the next one on failure, except on `WrongNetwork`. Each endpoint
|
|
5
|
+
* is checked once to serve the configured network (`eth_chainId`). Every method is a read, so retries and fallback
|
|
6
|
+
* are safe. Methods are named after the JSON-RPC method without its namespace (`eth_getLogs` is `getLogs`).
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
9
|
+
* ```ts
|
|
10
|
+
* import type { EvmLog } from "@effect-blockchain/evm/EvmLog"
|
|
11
|
+
* import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
|
|
12
|
+
* import * as Effect from "effect/Effect"
|
|
13
|
+
*
|
|
14
|
+
* // dates logs with one `eth_getBlockByNumber` per distinct block
|
|
15
|
+
* const withTimestamps = (logs: ReadonlyArray<EvmLog>) =>
|
|
16
|
+
* Effect.gen(function*() {
|
|
17
|
+
* const rpc = yield* EvmRpc.EvmRpc
|
|
18
|
+
* const blocks = yield* Effect.forEach(
|
|
19
|
+
* new Set(logs.map((log) => log.blockNumber)),
|
|
20
|
+
* (blockNumber) => rpc.getBlockByNumber({ blockNumber }),
|
|
21
|
+
* { concurrency: 4 }
|
|
22
|
+
* )
|
|
23
|
+
* const timestamps = new Map(blocks.map((block) => [block.number, block.timestamp]))
|
|
24
|
+
* return logs.map((log) => ({ ...log, timestamp: timestamps.get(log.blockNumber) }))
|
|
25
|
+
* })
|
|
26
|
+
* ```
|
|
27
|
+
*
|
|
28
|
+
* @since 0.1.0
|
|
29
|
+
*/
|
|
30
|
+
import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
|
|
31
|
+
import * as Arr from "effect/Array";
|
|
32
|
+
import * as BigInt_ from "effect/BigInt";
|
|
33
|
+
import * as Config from "effect/Config";
|
|
34
|
+
import * as Context from "effect/Context";
|
|
35
|
+
import * as Effect from "effect/Effect";
|
|
36
|
+
import * as Layer from "effect/Layer";
|
|
37
|
+
import * as Order from "effect/Order";
|
|
38
|
+
import * as Ref from "effect/Ref";
|
|
39
|
+
import * as Schema from "effect/Schema";
|
|
40
|
+
import * as EvmNetwork from "./EvmNetwork.js";
|
|
41
|
+
import * as RpcMethods from "./internal/rpcMethods.js";
|
|
42
|
+
/**
|
|
43
|
+
* A failed call: its `reason` (a {@link JsonRpc.Reason}, matched with `Effect.catchReason`), the JSON-RPC error code or
|
|
44
|
+
* HTTP status as `code`, and a `cause` without the endpoint URL. After several endpoints, the error is the last one
|
|
45
|
+
* and `cause` is an `AggregateError` of each endpoint's error, in order.
|
|
46
|
+
*
|
|
47
|
+
* On EVM, `Unavailable` includes the codes -32005, -32603, -32007, -1 and 429, `InvalidResponse` a log outside the
|
|
48
|
+
* `getLogs` filter, and `Lagging` a head below the requested block.
|
|
49
|
+
*
|
|
50
|
+
* @since 0.1.0
|
|
51
|
+
* @category errors
|
|
52
|
+
*/
|
|
53
|
+
export class EvmRpcError extends /*#__PURE__*/Schema.TaggedError()("EvmRpcError", {
|
|
54
|
+
reason: JsonRpc.Reason,
|
|
55
|
+
method: Schema.String,
|
|
56
|
+
endpoint: Schema.String,
|
|
57
|
+
code: /*#__PURE__*/Schema.optional(Schema.Number),
|
|
58
|
+
cause: /*#__PURE__*/Schema.Defect()
|
|
59
|
+
}) {
|
|
60
|
+
/**
|
|
61
|
+
* @since 0.1.0
|
|
62
|
+
*/
|
|
63
|
+
get message() {
|
|
64
|
+
return `${this.method} failed on ${this.endpoint}: ${this.reason._tag}${this.code === undefined ? "" : ` (${this.code})`}`;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* @since 0.1.0
|
|
69
|
+
* @category services
|
|
70
|
+
*/
|
|
71
|
+
export class EvmRpc extends /*#__PURE__*/Context.Service()("@effect-blockchain/evm/EvmRpc") {}
|
|
72
|
+
// the JSON-RPC codes viem 2.57.11 retries (`utils/buildRequest.ts`, `shouldRetry`): limit exceeded, internal error,
|
|
73
|
+
// QuickNode rate limit, unknown error and Alchemy's batch rate limit. The endpoint is struggling: retry then fall back
|
|
74
|
+
const codes = /*#__PURE__*/new Map(/*#__PURE__*/[-32005, -32603, -32007, -1, 429].map(code => [code, "Unavailable"]));
|
|
75
|
+
const byBlockThenIndex = /*#__PURE__*/Order.combine(/*#__PURE__*/Order.mapInput(Order.BigInt, log => log.blockNumber), /*#__PURE__*/Order.mapInput(Order.Number, log => log.logIndex));
|
|
76
|
+
/**
|
|
77
|
+
* Builds an {@link EvmRpc} over `endpoints`, tried in order, sending requests with the provided `HttpClient`
|
|
78
|
+
* (e.g. `FetchHttpClient.layer`). `timeout` (default 30 seconds) bounds each attempt, `retries` (default 3) and
|
|
79
|
+
* `retryDelay` (default 500 millis) set the backoff before falling back: see {@link JsonRpc.Unavailable}.
|
|
80
|
+
*
|
|
81
|
+
* @since 0.1.0
|
|
82
|
+
* @category layers
|
|
83
|
+
*/
|
|
84
|
+
export const layer = options => Layer.effect(EvmRpc, Effect.gen(function* () {
|
|
85
|
+
const {
|
|
86
|
+
network
|
|
87
|
+
} = options;
|
|
88
|
+
const expectedChainId = EvmNetwork.toChainId(network);
|
|
89
|
+
const rpc = yield* JsonRpc.make({
|
|
90
|
+
spanPrefix: "EvmRpc",
|
|
91
|
+
network,
|
|
92
|
+
endpoints: options.endpoints,
|
|
93
|
+
timeout: options.timeout,
|
|
94
|
+
retries: options.retries,
|
|
95
|
+
retryDelay: options.retryDelay,
|
|
96
|
+
codes,
|
|
97
|
+
checkNetwork: (send, endpoint) => send(RpcMethods.chainId, []).pipe(Effect.flatMap(chainId => chainId === expectedChainId ? Effect.succeed(expectedChainId) : Effect.fail(new EvmRpcError({
|
|
98
|
+
reason: new JsonRpc.WrongNetwork({
|
|
99
|
+
expected: String(expectedChainId),
|
|
100
|
+
actual: String(chainId)
|
|
101
|
+
}),
|
|
102
|
+
method: RpcMethods.chainId.name,
|
|
103
|
+
endpoint,
|
|
104
|
+
cause: new Error(`expected chain ID ${expectedChainId} for ${network}, got ${chainId}`)
|
|
105
|
+
})))),
|
|
106
|
+
makeError: fields => new EvmRpcError(fields)
|
|
107
|
+
});
|
|
108
|
+
const blockNumberOn = endpoint => rpc.call(endpoint, RpcMethods.blockNumber, []).pipe(Effect.tap(head => Ref.update(endpoint.head, BigInt_.max(head))));
|
|
109
|
+
const getBlockByNumberOn = (endpoint, blockNumber) => Effect.gen(function* () {
|
|
110
|
+
const method = RpcMethods.getBlockByNumber.name;
|
|
111
|
+
yield* rpc.requireHead(endpoint, method, blockNumber, blockNumberOn(endpoint));
|
|
112
|
+
const block = yield* rpc.call(endpoint, RpcMethods.getBlockByNumber, [blockNumber, false]);
|
|
113
|
+
if (block === null) {
|
|
114
|
+
const head = yield* Ref.get(endpoint.head);
|
|
115
|
+
return yield* rpc.fail(endpoint, method, new JsonRpc.Lagging({
|
|
116
|
+
head,
|
|
117
|
+
toBlock: blockNumber
|
|
118
|
+
}), new Error(`block ${blockNumber} is unknown below head ${head}`));
|
|
119
|
+
}
|
|
120
|
+
if (block.number !== blockNumber) {
|
|
121
|
+
return yield* rpc.fail(endpoint, method, new JsonRpc.InvalidResponse(), new Error(`block ${block.number} answered for block ${blockNumber}`));
|
|
122
|
+
}
|
|
123
|
+
return block;
|
|
124
|
+
});
|
|
125
|
+
const getLogsOn = (endpoint, filter) => Effect.gen(function* () {
|
|
126
|
+
const method = RpcMethods.getLogs.name;
|
|
127
|
+
yield* rpc.requireHead(endpoint, method, filter.toBlock, blockNumberOn(endpoint));
|
|
128
|
+
const {
|
|
129
|
+
addresses,
|
|
130
|
+
...range
|
|
131
|
+
} = filter;
|
|
132
|
+
const logs = yield* rpc.call(endpoint, RpcMethods.getLogs, [{
|
|
133
|
+
...range,
|
|
134
|
+
address: addresses
|
|
135
|
+
}]);
|
|
136
|
+
const allowed = new Set(addresses);
|
|
137
|
+
const invalid = logs.find(log => log.blockNumber < filter.fromBlock || log.blockNumber > filter.toBlock || !allowed.has(log.address));
|
|
138
|
+
if (invalid !== undefined) {
|
|
139
|
+
return yield* rpc.fail(endpoint, method, new JsonRpc.InvalidResponse(), new Error(`log ${invalid.transactionHash}#${invalid.logIndex} is outside the filter`));
|
|
140
|
+
}
|
|
141
|
+
return Arr.sort(logs.map(({
|
|
142
|
+
removed: _removed,
|
|
143
|
+
...log
|
|
144
|
+
}) => log), byBlockThenIndex);
|
|
145
|
+
});
|
|
146
|
+
return EvmRpc.of({
|
|
147
|
+
network,
|
|
148
|
+
chainId: rpc.withFallback(rpc.checkNetwork),
|
|
149
|
+
blockNumber: rpc.withFallback(blockNumberOn),
|
|
150
|
+
getBlockByNumber: ({
|
|
151
|
+
blockNumber
|
|
152
|
+
}) => rpc.withFallback(endpoint => getBlockByNumberOn(endpoint, blockNumber)),
|
|
153
|
+
getLogs: filter => filter.fromBlock > filter.toBlock ? Effect.succeed([]) : rpc.withFallback(endpoint => getLogsOn(endpoint, filter))
|
|
154
|
+
});
|
|
155
|
+
}));
|
|
156
|
+
/**
|
|
157
|
+
* Builds an {@link EvmRpc} like {@link layer}, reading the options from `Config`. Endpoint URLs stay `Redacted`.
|
|
158
|
+
*
|
|
159
|
+
* @example
|
|
160
|
+
* ```ts
|
|
161
|
+
* import * as EvmRpc from "@effect-blockchain/evm/EvmRpc"
|
|
162
|
+
* import * as Config from "effect/Config"
|
|
163
|
+
*
|
|
164
|
+
* const RpcLive = EvmRpc.layerConfig({
|
|
165
|
+
* network: Config.succeed("Ethereum"),
|
|
166
|
+
* endpoints: Config.all([Config.all({ name: Config.succeed("main"), url: Config.Redacted("ETHEREUM_RPC_URL") })])
|
|
167
|
+
* })
|
|
168
|
+
* ```
|
|
169
|
+
*
|
|
170
|
+
* @since 0.1.0
|
|
171
|
+
* @category layers
|
|
172
|
+
*/
|
|
173
|
+
export const layerConfig = options => Layer.unwrap(Effect.map(Config.unwrap(options), layer));
|
|
174
|
+
//# sourceMappingURL=EvmRpc.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EvmRpc.js","names":[],"sources":["../src/EvmRpc.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* EVM transaction hashes.
|
|
3
|
+
*
|
|
4
|
+
* @since 0.1.0
|
|
5
|
+
*/
|
|
6
|
+
import * as Schema from "effect/Schema";
|
|
7
|
+
/**
|
|
8
|
+
* An EVM transaction hash (0x followed by 64 hexadecimal characters), stored lowercase.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.1.0
|
|
11
|
+
* @category schemas
|
|
12
|
+
*/
|
|
13
|
+
export declare const EvmTransactionHash: Schema.brand<Schema.refine<`0x${string}`, Schema.decodeTo<Schema.String, Schema.String, never, never>>, "EvmTransactionHash">;
|
|
14
|
+
/**
|
|
15
|
+
* @since 0.1.0
|
|
16
|
+
* @category models
|
|
17
|
+
*/
|
|
18
|
+
export type EvmTransactionHash = typeof EvmTransactionHash.Type;
|
|
19
|
+
//# sourceMappingURL=EvmTransactionHash.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EvmTransactionHash.d.ts","sourceRoot":"","sources":["../src/EvmTransactionHash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAMvC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,+HAY9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* EVM transaction hashes.
|
|
3
|
+
*
|
|
4
|
+
* @since 0.1.0
|
|
5
|
+
*/
|
|
6
|
+
import * as Schema from "effect/Schema";
|
|
7
|
+
import * as SchemaTransformation from "effect/SchemaTransformation";
|
|
8
|
+
import { isHash } from "viem";
|
|
9
|
+
const evmTransactionHashRegex = /^0x[a-f0-9]{64}$/;
|
|
10
|
+
/**
|
|
11
|
+
* An EVM transaction hash (0x followed by 64 hexadecimal characters), stored lowercase.
|
|
12
|
+
*
|
|
13
|
+
* @since 0.1.0
|
|
14
|
+
* @category schemas
|
|
15
|
+
*/
|
|
16
|
+
export const EvmTransactionHash = /*#__PURE__*/Schema.String.pipe(/*#__PURE__*/Schema.decodeTo(/*#__PURE__*/Schema.String.check(/*#__PURE__*/Schema.isLowercased()), /*#__PURE__*/SchemaTransformation.toLowerCase()), /*#__PURE__*/Schema.refine(hash => isHash(hash), {
|
|
17
|
+
expected: "a valid EVM transaction hash",
|
|
18
|
+
arbitraryConstraint: {
|
|
19
|
+
patterns: [{
|
|
20
|
+
source: evmTransactionHashRegex.source,
|
|
21
|
+
flags: ""
|
|
22
|
+
}]
|
|
23
|
+
}
|
|
24
|
+
}), /*#__PURE__*/Schema.brand("EvmTransactionHash"), /*#__PURE__*/Schema.annotate({
|
|
25
|
+
identifier: "EvmTransactionHash",
|
|
26
|
+
title: "EVM transaction hash",
|
|
27
|
+
description: "a valid EVM transaction hash, starting with 0x and followed by 64 hexadecimal characters"
|
|
28
|
+
}));
|
|
29
|
+
//# sourceMappingURL=EvmTransactionHash.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EvmTransactionHash.js","names":[],"sources":["../src/EvmTransactionHash.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,OAAO,KAAK,oBAAoB,MAAM,6BAA6B;AACnE,SAAS,MAAM,QAAQ,MAAM;AAE7B,MAAM,uBAAuB,GAAG,kBAAkB;AAElD;;;;;;AAMA,OAAO,MAAM,kBAAkB,gBAAG,MAAM,CAAC,MAAM,CAAC,IAAI,cAClD,MAAM,CAAC,QAAQ,cAAC,MAAM,CAAC,MAAM,CAAC,KAAK,cAAC,MAAM,CAAC,YAAY,EAAE,CAAC,eAAE,oBAAoB,CAAC,WAAW,EAAE,CAAC,eAC/F,MAAM,CAAC,MAAM,CAAE,IAAY,IAA4B,MAAM,CAAC,IAAI,CAAC,EAAE;EACnE,QAAQ,EAAE,8BAA8B;EACxC,mBAAmB,EAAE;IAAE,QAAQ,EAAE,CAAC;MAAE,MAAM,EAAE,uBAAuB,CAAC,MAAM;MAAE,KAAK,EAAE;IAAE,CAAE;EAAC;CACzF,CAAC,eACF,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,eAClC,MAAM,CAAC,QAAQ,CAAC;EACd,UAAU,EAAE,oBAAoB;EAChC,KAAK,EAAE,sBAAsB;EAC7B,WAAW,EAAE;CACd,CAAC,CACH","ignoreList":[]}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @since 0.1.0
|
|
3
|
+
*/
|
|
4
|
+
/**
|
|
5
|
+
* @since 0.1.0
|
|
6
|
+
*/
|
|
7
|
+
export * as EvmAddress from "./EvmAddress.ts";
|
|
8
|
+
/**
|
|
9
|
+
* @since 0.1.0
|
|
10
|
+
*/
|
|
11
|
+
export * as EvmBlock from "./EvmBlock.ts";
|
|
12
|
+
/**
|
|
13
|
+
* @since 0.1.0
|
|
14
|
+
*/
|
|
15
|
+
export * as EvmHexData from "./EvmHexData.ts";
|
|
16
|
+
/**
|
|
17
|
+
* @since 0.1.0
|
|
18
|
+
*/
|
|
19
|
+
export * as EvmIndexer from "./EvmIndexer.ts";
|
|
20
|
+
/**
|
|
21
|
+
* @since 0.1.0
|
|
22
|
+
*/
|
|
23
|
+
export * as EvmLog from "./EvmLog.ts";
|
|
24
|
+
/**
|
|
25
|
+
* @since 0.1.0
|
|
26
|
+
*/
|
|
27
|
+
export * as EvmNetwork from "./EvmNetwork.ts";
|
|
28
|
+
/**
|
|
29
|
+
* @since 0.1.0
|
|
30
|
+
*/
|
|
31
|
+
export * as EvmRpc from "./EvmRpc.ts";
|
|
32
|
+
/**
|
|
33
|
+
* @since 0.1.0
|
|
34
|
+
*/
|
|
35
|
+
export * as EvmTransactionHash from "./EvmTransactionHash.ts";
|
|
36
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;GAEG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA"}
|