@effect-blockchain/starknet 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/dist/StarknetIndexer.d.ts +40 -2
  2. package/dist/StarknetIndexer.d.ts.map +1 -1
  3. package/dist/StarknetIndexer.js +89 -14
  4. package/dist/StarknetIndexer.js.map +1 -1
  5. package/dist/StarknetNetwork.d.ts +9 -0
  6. package/dist/StarknetNetwork.d.ts.map +1 -1
  7. package/dist/StarknetNetwork.js +9 -0
  8. package/dist/StarknetNetwork.js.map +1 -1
  9. package/dist/StarknetRelayer.d.ts +273 -0
  10. package/dist/StarknetRelayer.d.ts.map +1 -0
  11. package/dist/StarknetRelayer.js +352 -0
  12. package/dist/StarknetRelayer.js.map +1 -0
  13. package/dist/StarknetRpc.d.ts +107 -5
  14. package/dist/StarknetRpc.d.ts.map +1 -1
  15. package/dist/StarknetRpc.js +83 -5
  16. package/dist/StarknetRpc.js.map +1 -1
  17. package/dist/StarknetSigner.d.ts +75 -0
  18. package/dist/StarknetSigner.d.ts.map +1 -0
  19. package/dist/StarknetSigner.js +84 -0
  20. package/dist/StarknetSigner.js.map +1 -0
  21. package/dist/StarknetTransaction.d.ts +74 -0
  22. package/dist/StarknetTransaction.d.ts.map +1 -0
  23. package/dist/StarknetTransaction.js +2 -0
  24. package/dist/StarknetTransaction.js.map +1 -0
  25. package/dist/index.d.ts +12 -0
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +12 -0
  28. package/dist/index.js.map +1 -1
  29. package/dist/internal/confirmations.d.ts +2 -0
  30. package/dist/internal/confirmations.d.ts.map +1 -0
  31. package/dist/internal/confirmations.js +13 -0
  32. package/dist/internal/confirmations.js.map +1 -0
  33. package/dist/internal/rpcMethods.js +135 -0
  34. package/dist/internal/rpcMethods.js.map +1 -1
  35. package/dist/internal/transactionHash.d.ts +2 -0
  36. package/dist/internal/transactionHash.d.ts.map +1 -0
  37. package/dist/internal/transactionHash.js +60 -0
  38. package/dist/internal/transactionHash.js.map +1 -0
  39. package/package.json +1 -1
  40. package/src/StarknetIndexer.ts +141 -26
  41. package/src/StarknetNetwork.ts +12 -0
  42. package/src/StarknetRelayer.ts +437 -0
  43. package/src/StarknetRpc.ts +198 -6
  44. package/src/StarknetSigner.ts +115 -0
  45. package/src/StarknetTransaction.ts +68 -0
  46. package/src/index.ts +15 -0
  47. package/src/internal/confirmations.ts +17 -0
  48. package/src/internal/rpcMethods.ts +136 -0
  49. package/src/internal/transactionHash.ts +64 -0
@@ -5,9 +5,10 @@ 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 { StarknetAddress } from "./StarknetAddress.ts";
8
9
  import type { StarknetEvent } from "./StarknetEvent.ts";
9
- import type { StarknetEventsFilter, StarknetRpcError } from "./StarknetRpc.ts";
10
- import { StarknetRpc } from "./StarknetRpc.ts";
10
+ import type { StarknetEventsFilter } from "./StarknetRpc.ts";
11
+ import { StarknetRpc, StarknetRpcError } from "./StarknetRpc.ts";
11
12
  /**
12
13
  * A {@link StarknetIndexer} `fetchEvents` filter: a `starknet_getEvents` filter without its paging fields, over the
13
14
  * inclusive block range `[fromBlock, toBlock]`.
@@ -58,6 +59,33 @@ export interface StarknetIndexerStreamOptions {
58
59
  /** Retries a step failing with a transient reason ({@link JsonRpc.isTransient}) at the same block. Off by default. */
59
60
  readonly retry?: Schedule.Schedule<unknown, StarknetRpcError> | undefined;
60
61
  }
62
+ /**
63
+ * The STRK balance of an address in fri at the end of `block`, emitted by
64
+ * {@link StarknetIndexer.Service.streamNativeBalance}.
65
+ *
66
+ * @since 0.2.0
67
+ * @category models
68
+ */
69
+ export interface StarknetNativeBalance {
70
+ readonly block: bigint;
71
+ readonly balance: bigint;
72
+ }
73
+ /**
74
+ * The {@link StarknetIndexer.Service.streamNativeBalance} options: one sample every `step` blocks from `fromBlock`.
75
+ * `step` is a positive integer, `poll` and `retry` behave as in {@link StarknetIndexerStreamOptions}.
76
+ *
77
+ * @since 0.2.0
78
+ * @category models
79
+ */
80
+ export interface StarknetIndexerNativeBalanceOptions {
81
+ readonly address: StarknetAddress;
82
+ readonly fromBlock: bigint;
83
+ /** The stream ends after the last sample at or below it, and is empty when `fromBlock > toBlock`. */
84
+ readonly toBlock?: bigint | undefined;
85
+ readonly step: number;
86
+ readonly poll?: Schedule.Schedule<unknown> | undefined;
87
+ readonly retry?: Schedule.Schedule<unknown, StarknetRpcError> | undefined;
88
+ }
61
89
  declare const StarknetIndexer_base: Context.ServiceClass<StarknetIndexer, "@effect-blockchain/starknet/StarknetIndexer", {
62
90
  /** The latest block with at least `confirmations` blocks on top of it, never below 0. */
63
91
  readonly lastConfirmedBlock: Effect.Effect<bigint, StarknetRpcError>;
@@ -71,6 +99,16 @@ declare const StarknetIndexer_base: Context.ServiceClass<StarknetIndexer, "@effe
71
99
  * the confirmed head.
72
100
  */
73
101
  readonly streamEvents: (options: StarknetIndexerStreamOptions) => Stream.Stream<StarknetIndexerBatch, StarknetRpcError>;
102
+ /** The STRK balance of `address` in fri at the end of `block`. A `block` above `lastConfirmedBlock` is accepted. */
103
+ readonly fetchNativeBalance: (options: {
104
+ readonly address: StarknetAddress;
105
+ readonly block: bigint;
106
+ }) => Effect.Effect<bigint, StarknetRpcError>;
107
+ /**
108
+ * The STRK balance of `address` at `fromBlock`, `fromBlock + step`, `fromBlock + 2 * step`... one sample per step
109
+ * even when unchanged, following the confirmed head.
110
+ */
111
+ readonly streamNativeBalance: (options: StarknetIndexerNativeBalanceOptions) => Stream.Stream<StarknetNativeBalance, StarknetRpcError>;
74
112
  }>;
75
113
  /**
76
114
  * @since 0.1.0
@@ -1 +1 @@
1
- {"version":3,"file":"StarknetIndexer.d.ts","sourceRoot":"","sources":["../src/StarknetIndexer.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,EAAwB,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,oBAAoB,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAA;AAEtF;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CAC9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,SAAS,CAAC,CAAA;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;IACtD,sHAAsH;IACtH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,GAAG,SAAS,CAAA;CAC1E;;IAOC,yFAAyF;iCAC5D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACpE;;;OAGG;0BACmB,CAAC,MAAM,EAAE,qBAAqB,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACtH;;;OAGG;2BACoB,CACrB,OAAO,EAAE,4BAA4B,KAClC,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;;AAlB5D;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,oBAec;CAAG;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,QAA+B,CAAA;AAQ5E;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK,aAAa;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC,KAAQ,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,CA4ErD,CAAA;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,YACb,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAC7D,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CACN,CAAA"}
1
+ {"version":3,"file":"StarknetIndexer.d.ts","sourceRoot":"","sources":["../src/StarknetIndexer.ts"],"names":[],"mappings":"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"}
@@ -29,6 +29,29 @@
29
29
  * })
30
30
  * ```
31
31
  *
32
+ * The STRK balance of an address, in fri, is read at one block or sampled every `step` blocks:
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * import type { StarknetAddress } from "@effect-blockchain/starknet/StarknetAddress"
37
+ * import { StarknetIndexer } from "@effect-blockchain/starknet/StarknetIndexer"
38
+ * import * as Effect from "effect/Effect"
39
+ * import * as Stream from "effect/Stream"
40
+ *
41
+ * declare const address: StarknetAddress
42
+ *
43
+ * // the balance every 1000 blocks from block 1000000 to 1010000
44
+ * const balances = Effect.gen(function*() {
45
+ * const indexer = yield* StarknetIndexer
46
+ * return yield* indexer.streamNativeBalance({
47
+ * address,
48
+ * fromBlock: BigInt(1_000_000),
49
+ * toBlock: BigInt(1_010_000),
50
+ * step: 1000
51
+ * }).pipe(Stream.runCollect)
52
+ * })
53
+ * ```
54
+ *
32
55
  * @since 0.1.0
33
56
  */
34
57
  import * as JsonRpc from "@effect-blockchain/core/JsonRpc";
@@ -42,8 +65,9 @@ import * as Layer from "effect/Layer";
42
65
  import * as Option from "effect/Option";
43
66
  import * as Schedule from "effect/Schedule";
44
67
  import * as Stream from "effect/Stream";
68
+ import * as Confirmations from "./internal/confirmations.js";
45
69
  import * as StarknetNetwork from "./StarknetNetwork.js";
46
- import { StarknetRpc } from "./StarknetRpc.js";
70
+ import { StarknetRpc, StarknetRpcError } from "./StarknetRpc.js";
47
71
  /**
48
72
  * The default `maxBlockRange`. Starknet nodes do not limit the block range of `starknet_getEvents` (they cap the page
49
73
  * size), so a range only bounds the work a restart redoes: 10000 blocks is a few hours of mainnet.
@@ -64,6 +88,8 @@ export class StarknetIndexer extends /*#__PURE__*/Context.Service()("@effect-blo
64
88
  * @category constants
65
89
  */
66
90
  export const DEFAULT_POLL_INTERVAL = /*#__PURE__*/Duration.seconds(10);
91
+ // sn_keccak("balanceOf"), the ERC-20 entry point selector
92
+ const BALANCE_OF = "0x02e4263afad30923c891518314c3c95dbe830a16874e8abc5777a9a20b54c76e";
67
93
  /**
68
94
  * Builds a {@link StarknetIndexer} over the provided {@link StarknetRpc}.
69
95
  *
@@ -80,9 +106,8 @@ export const layer = (options = {}) => Layer.effect(StarknetIndexer, Effect.gen(
80
106
  if (!Number.isSafeInteger(maxBlockRange) || maxBlockRange < 1) {
81
107
  return yield* Effect.die(new RangeError(`maxBlockRange must be a positive integer, got ${maxBlockRange}`));
82
108
  }
83
- const confirmations = BigInt(options.confirmations ?? StarknetNetwork.defaultConfirmations(rpc.network));
84
109
  const size = BigInt(maxBlockRange);
85
- const lastConfirmedBlock = rpc.blockNumber.pipe(Effect.map(head => BigInt_.max(head - confirmations, BigInt(0))), Effect.withSpan("StarknetIndexer.lastConfirmedBlock"));
110
+ const lastConfirmedBlock = Confirmations.lastConfirmedBlock(rpc, options.confirmations).pipe(Effect.withSpan("StarknetIndexer.lastConfirmedBlock"));
86
111
  const fetchEvents = Effect.fn("StarknetIndexer.fetchEvents")(filter => Effect.forEach(filter.fromBlock > filter.toBlock ? [] : Arr.makeBy(Number((filter.toBlock - filter.fromBlock) / size) + 1, i => filter.fromBlock + BigInt(i) * size), fromBlock => {
87
112
  const toBlock = BigInt_.min(fromBlock + size - BigInt(1), filter.toBlock);
88
113
  const range = {
@@ -105,9 +130,67 @@ export const layer = (options = {}) => Layer.effect(StarknetIndexer, Effect.gen(
105
130
  while: error => "cursorPage" in error
106
131
  }), Effect.mapError(error => "cursorPage" in error ? error.cursorPage : error));
107
132
  }).pipe(Effect.map(Arr.flatten)));
133
+ // the head last read is reused while it covers `next` (the confirmed head only moves forward), else polled
134
+ const confirmedFor = (next, head, poll) => next <= head ? Effect.succeed(head) : lastConfirmedBlock.pipe(Effect.repeat({
135
+ schedule: poll,
136
+ until: confirmed => confirmed >= next
137
+ }));
138
+ const retrying = (step, retry) => retry === undefined ? step : state => Effect.retry(step(state), {
139
+ schedule: retry,
140
+ while: error => JsonRpc.isTransient(error.reason)
141
+ });
142
+ const fetchNativeBalance = Effect.fn("StarknetIndexer.fetchNativeBalance")(({
143
+ address,
144
+ block
145
+ }) => rpc.call({
146
+ contractAddress: StarknetNetwork.STRK_TOKEN_ADDRESS,
147
+ entryPointSelector: BALANCE_OF,
148
+ calldata: [address],
149
+ blockNumber: block
150
+ }).pipe(Effect.flatMap(felts => felts.length === 2 ? Effect.succeed(BigInt(felts[0]) + (BigInt(felts[1]) << BigInt(128))) : Effect.fail(new StarknetRpcError({
151
+ reason: new JsonRpc.InvalidResponse(),
152
+ method: "starknet_call",
153
+ endpoint: "StarknetIndexer",
154
+ cause: new Error(`balanceOf returned ${felts.length} felts, expected a u256 (low, high)`)
155
+ })))));
108
156
  return StarknetIndexer.of({
109
157
  lastConfirmedBlock,
110
158
  fetchEvents,
159
+ fetchNativeBalance,
160
+ streamNativeBalance: ({
161
+ address,
162
+ fromBlock,
163
+ poll = Schedule.spaced(DEFAULT_POLL_INTERVAL),
164
+ retry,
165
+ step,
166
+ toBlock
167
+ }) => {
168
+ if (!Number.isSafeInteger(step) || step < 1) {
169
+ return Stream.die(new RangeError(`step must be a positive integer, got ${step}`));
170
+ }
171
+ if (toBlock !== undefined && fromBlock > toBlock) return Stream.empty;
172
+ const size = BigInt(step);
173
+ const sample = ({
174
+ head,
175
+ next
176
+ }) => confirmedFor(next, head, poll).pipe(Effect.flatMap(confirmed => {
177
+ if (next > confirmed) return Effect.succeed([[], Option.none()]);
178
+ return fetchNativeBalance({
179
+ address,
180
+ block: next
181
+ }).pipe(Effect.map(balance => [[{
182
+ block: next,
183
+ balance
184
+ }], toBlock !== undefined && next + size > toBlock ? Option.none() : Option.some({
185
+ next: next + size,
186
+ head: confirmed
187
+ })]));
188
+ }));
189
+ return Stream.paginate({
190
+ next: fromBlock,
191
+ head: fromBlock - BigInt(1)
192
+ }, retrying(sample, retry));
193
+ },
111
194
  streamEvents: ({
112
195
  filter,
113
196
  fromBlock,
@@ -116,14 +199,10 @@ export const layer = (options = {}) => Layer.effect(StarknetIndexer, Effect.gen(
116
199
  toBlock
117
200
  }) => {
118
201
  if (toBlock !== undefined && fromBlock > toBlock) return Stream.empty;
119
- // the head last read is reused while it covers `next` (the confirmed head only moves forward), else polled
120
202
  const step = ({
121
203
  head,
122
204
  next
123
- }) => (next <= head ? Effect.succeed(head) : lastConfirmedBlock.pipe(Effect.repeat({
124
- schedule: poll,
125
- until: confirmed => confirmed >= next
126
- }))).pipe(Effect.flatMap(confirmed => {
205
+ }) => confirmedFor(next, head, poll).pipe(Effect.flatMap(confirmed => {
127
206
  const cap = toBlock === undefined ? confirmed : BigInt_.min(confirmed, toBlock);
128
207
  if (next > cap) return Effect.succeed([[], Option.none()]);
129
208
  const end = BigInt_.min(next + size - BigInt(1), cap);
@@ -140,15 +219,11 @@ export const layer = (options = {}) => Layer.effect(StarknetIndexer, Effect.gen(
140
219
  head: confirmed
141
220
  })]));
142
221
  }));
143
- return Stream.paginate(
144
222
  // a head below `fromBlock`: the first step reads it
145
- {
223
+ return Stream.paginate({
146
224
  next: fromBlock,
147
225
  head: fromBlock - BigInt(1)
148
- }, retry === undefined ? step : remaining => Effect.retry(step(remaining), {
149
- schedule: retry,
150
- while: error => JsonRpc.isTransient(error.reason)
151
- }));
226
+ }, retrying(step, retry));
152
227
  }
153
228
  });
154
229
  }));
@@ -1 +1 @@
1
- {"version":3,"file":"StarknetIndexer.js","names":[],"sources":["../src/StarknetIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"file":"StarknetIndexer.js","names":[],"sources":["../src/StarknetIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
@@ -4,6 +4,7 @@
4
4
  * @since 0.1.0
5
5
  */
6
6
  import * as Schema from "effect/Schema";
7
+ import { StarknetAddress } from "./StarknetAddress.ts";
7
8
  /**
8
9
  * @since 0.1.0
9
10
  * @category constants
@@ -55,6 +56,14 @@ export declare const toChainId: (network: StarknetNetwork) => StarknetChainId;
55
56
  * @category getters
56
57
  */
57
58
  export declare const defaultConfirmations: (network: StarknetNetwork) => number;
59
+ /**
60
+ * The STRK token contract, the token Starknet fees are paid in, counted in fri (10^-18 STRK). The same address on
61
+ * mainnet and Sepolia: https://docs.starknet.io/resources/chain-info
62
+ *
63
+ * @since 0.2.0
64
+ * @category constants
65
+ */
66
+ export declare const STRK_TOKEN_ADDRESS: StarknetAddress;
58
67
  /**
59
68
  * @since 0.1.0
60
69
  * @category predicates
@@ -1 +1 @@
1
- {"version":3,"file":"StarknetNetwork.d.ts","sourceRoot":"","sources":["../src/StarknetNetwork.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,QAAQ,YAAI,UAAU,CAAU,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,QAAQ,YAAI,iBAAiB,CAAU,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,0CAAsC,CAAA;AAE3D;;;GAGG;AACH,eAAO,MAAM,eAAe,2DAI1B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,qDAI1B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAOzD;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,eAAe,KAAG,eAAoC,CAAA;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,eAAe,KAAG,MAS/D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,eAAe,KAAG,OACW,CAAA"}
1
+ {"version":3,"file":"StarknetNetwork.d.ts","sourceRoot":"","sources":["../src/StarknetNetwork.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,QAAQ,YAAI,UAAU,CAAU,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,QAAQ,YAAI,iBAAiB,CAAU,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,0CAAsC,CAAA;AAE3D;;;GAGG;AACH,eAAO,MAAM,eAAe,2DAI1B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,qDAI1B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAOzD;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,eAAe,KAAG,eAAoC,CAAA;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,eAAe,KAAG,MAS/D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAEhC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,YAAa,eAAe,KAAG,OACW,CAAA"}
@@ -4,6 +4,7 @@
4
4
  * @since 0.1.0
5
5
  */
6
6
  import * as Schema from "effect/Schema";
7
+ import { StarknetAddress } from "./StarknetAddress.js";
7
8
  /**
8
9
  * @since 0.1.0
9
10
  * @category constants
@@ -66,6 +67,14 @@ export const defaultConfirmations = network => {
66
67
  return 0;
67
68
  }
68
69
  };
70
+ /**
71
+ * The STRK token contract, the token Starknet fees are paid in, counted in fri (10^-18 STRK). The same address on
72
+ * mainnet and Sepolia: https://docs.starknet.io/resources/chain-info
73
+ *
74
+ * @since 0.2.0
75
+ * @category constants
76
+ */
77
+ export const STRK_TOKEN_ADDRESS = /*#__PURE__*/StarknetAddress.make("0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d");
69
78
  /**
70
79
  * @since 0.1.0
71
80
  * @category predicates
@@ -1 +1 @@
1
- {"version":3,"file":"StarknetNetwork.js","names":[],"sources":["../src/StarknetNetwork.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AAEvC;;;;AAIA,OAAO,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAU;AAE7C;;;;AAIA,OAAO,MAAM,QAAQ,GAAG,CAAC,iBAAiB,CAAU;AAEpD;;;;;;AAMA,OAAO,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAU;AAE3D;;;;AAIA,OAAO,MAAM,eAAe,gBAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;EAChE,UAAU,EAAE,iBAAiB;EAC7B,KAAK,EAAE,kBAAkB;EACzB,WAAW,EAAE;CACd,CAAC;AAQF;;;;;;AAMA,OAAO,MAAM,eAAe,gBAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;EACjF,UAAU,EAAE,iBAAiB;EAC7B,KAAK,EAAE,mBAAmB;EAC1B,WAAW,EAAE;CACd,CAAC;AAQF,MAAM,QAAQ,GAA6C;EACzD,QAAQ,EAAE,SAAS;EACnB,eAAe,EAAE;CAClB;AAED;;;;AAIA,OAAO,MAAM,SAAS,GAAI,OAAwB,IAAsB,QAAQ,CAAC,OAAO,CAAC;AAEzF;;;;;;AAMA,OAAO,MAAM,oBAAoB,GAAI,OAAwB,IAAY;EACvE,QAAQ,OAAO;IACb;IACA,KAAK,UAAU;MACb,OAAO,CAAC;IACV;IACA,KAAK,iBAAiB;MACpB,OAAO,CAAC;EACZ;AACF,CAAC;AAED;;;;AAIA,OAAO,MAAM,SAAS,GAAI,OAAwB,IAC/C,QAA2C,CAAC,QAAQ,CAAC,OAAO,CAAC","ignoreList":[]}
1
+ {"version":3,"file":"StarknetNetwork.js","names":[],"sources":["../src/StarknetNetwork.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,SAAS,eAAe,QAAQ,sBAAsB;AAEtD;;;;AAIA,OAAO,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAU;AAE7C;;;;AAIA,OAAO,MAAM,QAAQ,GAAG,CAAC,iBAAiB,CAAU;AAEpD;;;;;;AAMA,OAAO,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAU;AAE3D;;;;AAIA,OAAO,MAAM,eAAe,gBAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;EAChE,UAAU,EAAE,iBAAiB;EAC7B,KAAK,EAAE,kBAAkB;EACzB,WAAW,EAAE;CACd,CAAC;AAQF;;;;;;AAMA,OAAO,MAAM,eAAe,gBAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;EACjF,UAAU,EAAE,iBAAiB;EAC7B,KAAK,EAAE,mBAAmB;EAC1B,WAAW,EAAE;CACd,CAAC;AAQF,MAAM,QAAQ,GAA6C;EACzD,QAAQ,EAAE,SAAS;EACnB,eAAe,EAAE;CAClB;AAED;;;;AAIA,OAAO,MAAM,SAAS,GAAI,OAAwB,IAAsB,QAAQ,CAAC,OAAO,CAAC;AAEzF;;;;;;AAMA,OAAO,MAAM,oBAAoB,GAAI,OAAwB,IAAY;EACvE,QAAQ,OAAO;IACb;IACA,KAAK,UAAU;MACb,OAAO,CAAC;IACV;IACA,KAAK,iBAAiB;MACpB,OAAO,CAAC;EACZ;AACF,CAAC;AAED;;;;;;;AAOA,OAAO,MAAM,kBAAkB,gBAAoB,eAAe,CAAC,IAAI,CACrE,oEAAoE,CACrE;AAED;;;;AAIA,OAAO,MAAM,SAAS,GAAI,OAAwB,IAC/C,QAA2C,CAAC,QAAQ,CAAC,OAAO,CAAC","ignoreList":[]}
@@ -0,0 +1,273 @@
1
+ /**
2
+ * Starknet transaction relaying on top of {@link StarknetRpc.StarknetRpc}: signing a transaction, broadcasting it and
3
+ * following it until it is final.
4
+ *
5
+ * A relayer here sends an account's own transactions and manages their nonces and fees, as OpenZeppelin Relayer does.
6
+ * It is not a meta-transaction relayer (a paymaster, SNIP-9 outside execution) paying for someone else's transaction.
7
+ * It keeps no state: storing hashes and nonces, deciding when to resend and holding keys belong to the application.
8
+ * Senders sharing an account must each pass their own nonce, as the node's nonce does not count a transaction that is
9
+ * signed and not yet in a pre-confirmed block, and two concurrent `sign` calls read the same one.
10
+ *
11
+ * Only V3 transactions are sent: an `INVOKE` running calls through the `__execute__` entrypoint of a Cairo 1 account
12
+ * (SNIP-6), and the `DEPLOY_ACCOUNT` of the signer's own account. `sign` and `signDeployAccount` return the
13
+ * transaction hash before anything is broadcast, so it can be stored first, and `broadcast` can be repeated with the
14
+ * same transaction.
15
+ *
16
+ * Resource bounds come from `starknet_estimateFee` (see {@link defaultFees}) unless `sign` receives them. The
17
+ * transaction is estimated unsigned, with `SKIP_VALIDATE`, so that a custody signer signs once: the estimate leaves
18
+ * out the account's validation, which the default strategy adds back. The account must hold the bounds in STRK, each
19
+ * `maxAmount` times its `maxPricePerUnit`, though it only pays what the transaction uses. The tip is 0 unless given.
20
+ *
21
+ * A transaction is in one {@link StarknetTransactionStatus}:
22
+ *
23
+ * | status | meaning | final |
24
+ * |---|---|---|
25
+ * | `Pending` | known to the node, not in an accepted block: received, candidate or pre-confirmed | no |
26
+ * | `Included` | in the accepted block `block`, above the last confirmed block | no |
27
+ * | `Confirmed` | succeeded in `block`, at or below the last confirmed block | yes |
28
+ * | `Failed` | reverted in `block`, at or below the last confirmed block | yes |
29
+ * | `NotFound` | unknown to the node: dropped, not propagated yet, or never sent | no |
30
+ *
31
+ * The last confirmed block is the one of `StarknetIndexer`: with the default of 0 confirmations, a transaction is
32
+ * final as soon as its block is accepted on L2, and `Included` only shows while the head read is behind that block.
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * import type { StarknetAddress } from "@effect-blockchain/starknet/StarknetAddress"
37
+ * import { StarknetRelayer } from "@effect-blockchain/starknet/StarknetRelayer"
38
+ * import type { StarknetSigner } from "@effect-blockchain/starknet/StarknetSigner"
39
+ * import type { StarknetTransactionHash } from "@effect-blockchain/starknet/StarknetTransactionHash"
40
+ * import * as Effect from "effect/Effect"
41
+ *
42
+ * declare const signer: StarknetSigner
43
+ * declare const token: StarknetAddress
44
+ * declare const to: StarknetAddress
45
+ * declare const store: (hash: StarknetTransactionHash, nonce: bigint) => Effect.Effect<void>
46
+ *
47
+ * const program = Effect.gen(function*() {
48
+ * const relayer = yield* StarknetRelayer
49
+ * // an ERC-20 `transfer(recipient, amount)`, the amount being a u256 as two felts
50
+ * const calls = [{ contractAddress: token, entrypoint: "transfer", calldata: [to, "0x1", "0x0"] }]
51
+ * const { hash, nonce, signed } = yield* relayer.sign({ signer, calls })
52
+ * // stored before the broadcast: a crash in between leaves a hash to look up, never an unknown transaction
53
+ * yield* store(hash, nonce)
54
+ * yield* relayer.broadcast({ signed })
55
+ * // a transaction the node never sees stays `NotFound`: the timeout bounds the wait
56
+ * const status = yield* relayer.awaitConfirmation({ hash }).pipe(Effect.timeout("10 minutes"))
57
+ * if (status._tag === "Failed") {
58
+ * yield* Effect.logError(`reverted in block ${status.block}: ${status.reason}`)
59
+ * }
60
+ * })
61
+ * ```
62
+ *
63
+ * @since 0.2.0
64
+ */
65
+ import * as Context from "effect/Context";
66
+ import * as Effect from "effect/Effect";
67
+ import * as Layer from "effect/Layer";
68
+ import * as Schedule from "effect/Schedule";
69
+ import * as Schema from "effect/Schema";
70
+ import type { StarknetAddress } from "./StarknetAddress.ts";
71
+ import * as StarknetRpc from "./StarknetRpc.ts";
72
+ import { type StarknetSigner, StarknetSignerError } from "./StarknetSigner.ts";
73
+ import type { StarknetResourceBounds, StarknetTransaction } from "./StarknetTransaction.ts";
74
+ import type { StarknetTransactionHash } from "./StarknetTransactionHash.ts";
75
+ /**
76
+ * Where a transaction stands, by `_tag`: see the module's table. `block` is the number of the accepted block holding
77
+ * it, and `reason` the node's revert message, `undefined` when the node gives none.
78
+ *
79
+ * @since 0.2.0
80
+ * @category models
81
+ */
82
+ export type StarknetTransactionStatus = {
83
+ readonly _tag: "Pending";
84
+ } | {
85
+ readonly _tag: "Included";
86
+ readonly block: bigint;
87
+ } | {
88
+ readonly _tag: "Confirmed";
89
+ readonly block: bigint;
90
+ } | {
91
+ readonly _tag: "Failed";
92
+ readonly block: bigint;
93
+ readonly reason: string | undefined;
94
+ } | {
95
+ readonly _tag: "NotFound";
96
+ };
97
+ /**
98
+ * One call of an `INVOKE` transaction: the `entrypoint` name of `contractAddress` and its calldata felts.
99
+ *
100
+ * @since 0.2.0
101
+ * @category models
102
+ */
103
+ export interface StarknetCall {
104
+ readonly contractAddress: StarknetAddress;
105
+ readonly entrypoint: string;
106
+ readonly calldata: ReadonlyArray<string>;
107
+ }
108
+ /**
109
+ * A transaction signed by {@link StarknetRelayer}: `signed` is what `broadcast` takes, `hash` its transaction hash
110
+ * and `nonce` the nonce it uses.
111
+ *
112
+ * @since 0.2.0
113
+ * @category models
114
+ */
115
+ export interface StarknetSignedTransaction {
116
+ readonly hash: StarknetTransactionHash;
117
+ readonly signed: StarknetTransaction;
118
+ readonly nonce: bigint;
119
+ }
120
+ declare const InvalidNonce_base: Schema.Class<InvalidNonce, Schema.TaggedStruct<"InvalidNonce", {}>, import("effect/Cause").YieldableError>;
121
+ /**
122
+ * The nonce is not the account's next one: it is already used, or too far ahead of it (`INVALID_TRANSACTION_NONCE`).
123
+ *
124
+ * @since 0.2.0
125
+ * @category reasons
126
+ */
127
+ export declare class InvalidNonce extends InvalidNonce_base {
128
+ }
129
+ declare const InsufficientBalance_base: Schema.Class<InsufficientBalance, Schema.TaggedStruct<"InsufficientBalance", {}>, import("effect/Cause").YieldableError>;
130
+ /**
131
+ * The account's STRK balance does not cover the resource bounds (`INSUFFICIENT_ACCOUNT_BALANCE`).
132
+ *
133
+ * @since 0.2.0
134
+ * @category reasons
135
+ */
136
+ export declare class InsufficientBalance extends InsufficientBalance_base {
137
+ }
138
+ declare const InsufficientResources_base: Schema.Class<InsufficientResources, Schema.TaggedStruct<"InsufficientResources", {}>, import("effect/Cause").YieldableError>;
139
+ /**
140
+ * The resource bounds are below what validating the transaction needs or below the current prices
141
+ * (`INSUFFICIENT_RESOURCES_FOR_VALIDATE`), or the fee is below the node's minimum (`FEE_BELOW_MINIMUM`).
142
+ *
143
+ * @since 0.2.0
144
+ * @category reasons
145
+ */
146
+ export declare class InsufficientResources extends InsufficientResources_base {
147
+ }
148
+ declare const ValidationFailure_base: Schema.Class<ValidationFailure, Schema.TaggedStruct<"ValidationFailure", {}>, import("effect/Cause").YieldableError>;
149
+ /**
150
+ * The account contract refused the transaction, usually for its signature (`VALIDATION_FAILURE`).
151
+ *
152
+ * @since 0.2.0
153
+ * @category reasons
154
+ */
155
+ export declare class ValidationFailure extends ValidationFailure_base {
156
+ }
157
+ declare const ReplacementUnderpriced_base: Schema.Class<ReplacementUnderpriced, Schema.TaggedStruct<"ReplacementUnderpriced", {}>, import("effect/Cause").YieldableError>;
158
+ /**
159
+ * The node's mempool holds another transaction at this nonce and the tip does not exceed its tip enough to replace it
160
+ * (`REPLACEMENT_TRANSACTION_UNDERPRICED`).
161
+ *
162
+ * @since 0.2.0
163
+ * @category reasons
164
+ */
165
+ export declare class ReplacementUnderpriced extends ReplacementUnderpriced_base {
166
+ }
167
+ /**
168
+ * Why a node refused a transaction, the `reason` of a {@link StarknetBroadcastError}, matched with
169
+ * `Effect.catchReason`.
170
+ *
171
+ * @since 0.2.0
172
+ * @category reasons
173
+ */
174
+ export declare const StarknetBroadcastReason: Schema.Union<readonly [typeof InvalidNonce, typeof InsufficientBalance, typeof InsufficientResources, typeof ValidationFailure, typeof ReplacementUnderpriced]>;
175
+ /**
176
+ * @since 0.2.0
177
+ * @category reasons
178
+ */
179
+ export type StarknetBroadcastReason = typeof StarknetBroadcastReason.Type;
180
+ declare const StarknetBroadcastError_base: Schema.Class<StarknetBroadcastError, Schema.TaggedStruct<"StarknetBroadcastError", {
181
+ readonly reason: Schema.Union<readonly [typeof InvalidNonce, typeof InsufficientBalance, typeof InsufficientResources, typeof ValidationFailure, typeof ReplacementUnderpriced]>;
182
+ readonly cause: Schema.Defect;
183
+ }>, import("effect/Cause").YieldableError>;
184
+ /**
185
+ * A node refused the transaction for a `reason` the sender can act on: `cause` is the
186
+ * {@link StarknetRpc.StarknetRpcError} holding the node's error code and message. Any other refusal stays a
187
+ * `StarknetRpcError`.
188
+ *
189
+ * @since 0.2.0
190
+ * @category errors
191
+ */
192
+ export declare class StarknetBroadcastError extends StarknetBroadcastError_base {
193
+ }
194
+ declare const StarknetRelayer_base: Context.ServiceClass<StarknetRelayer, "@effect-blockchain/starknet/StarknetRelayer", {
195
+ /**
196
+ * Signs an `INVOKE` running `calls` in order from the account at `signer.address`, without sending it. A missing
197
+ * `nonce` is the account's nonce at the pre-confirmed block, missing `resourceBounds` come from the layer's fee
198
+ * strategy over `starknet_estimateFee` (calls that revert fail with `Rejected`), and a missing `tip` is 0.
199
+ */
200
+ readonly sign: (options: {
201
+ readonly signer: StarknetSigner;
202
+ readonly calls: ReadonlyArray<StarknetCall>;
203
+ readonly nonce?: bigint | undefined;
204
+ readonly resourceBounds?: StarknetResourceBounds | undefined;
205
+ readonly tip?: bigint | undefined;
206
+ }) => Effect.Effect<StarknetSignedTransaction, StarknetRpc.StarknetRpcError | StarknetSignerError>;
207
+ /**
208
+ * Signs the `DEPLOY_ACCOUNT` of the signer's own account contract, without sending it: its nonce is 0. The address
209
+ * that `classHash`, `salt` and `constructorCalldata` deploy to must be `signer.address`, or it fails with a
210
+ * `StarknetSignerError`, and must hold STRK for the fee before the broadcast.
211
+ */
212
+ readonly signDeployAccount: (options: {
213
+ readonly signer: StarknetSigner;
214
+ readonly classHash: string;
215
+ readonly salt: string;
216
+ readonly constructorCalldata: ReadonlyArray<string>;
217
+ readonly resourceBounds?: StarknetResourceBounds | undefined;
218
+ readonly tip?: bigint | undefined;
219
+ }) => Effect.Effect<StarknetSignedTransaction, StarknetRpc.StarknetRpcError | StarknetSignerError>;
220
+ /**
221
+ * Sends a signed transaction and returns its hash. Sending the same transaction again is safe: a node answering
222
+ * `DUPLICATE_TX`, or that the nonce is invalid while it knows this hash, is a success.
223
+ */
224
+ readonly broadcast: (options: {
225
+ readonly signed: StarknetTransaction;
226
+ }) => Effect.Effect<StarknetTransactionHash, StarknetBroadcastError | StarknetRpc.StarknetRpcError>;
227
+ /**
228
+ * The status of the transaction as the answering endpoint sees it. An endpoint behind the head answers `Pending` or
229
+ * `Included` for a transaction another one has in a confirmed block, and `NotFound` means that the last endpoint
230
+ * tried does not know it.
231
+ */
232
+ readonly fetchTransactionStatus: (options: {
233
+ readonly hash: StarknetTransactionHash;
234
+ }) => Effect.Effect<StarknetTransactionStatus, StarknetRpc.StarknetRpcError>;
235
+ /**
236
+ * Reads {@link fetchTransactionStatus} on `poll` (`Schedule.spaced(StarknetIndexer.DEFAULT_POLL_INTERVAL)` by
237
+ * default) until it is `Confirmed` or `Failed`, and returns it. `NotFound` keeps polling, so bound the wait with a
238
+ * timeout. A `poll` that ends first returns the last status read.
239
+ */
240
+ readonly awaitConfirmation: (options: {
241
+ readonly hash: StarknetTransactionHash;
242
+ readonly poll?: Schedule.Schedule<unknown> | undefined;
243
+ }) => Effect.Effect<StarknetTransactionStatus, StarknetRpc.StarknetRpcError>;
244
+ }>;
245
+ /**
246
+ * @since 0.2.0
247
+ * @category services
248
+ */
249
+ export declare class StarknetRelayer extends StarknetRelayer_base {
250
+ }
251
+ /**
252
+ * The library's fee strategy: each resource is bounded by 1.5 times its estimated amount at 1.5 times its estimated
253
+ * price, which keeps the transaction includable while prices rise. The L2 gas amount first gains 300,000 for the
254
+ * account's validation, which the estimate leaves out: over twice what a single signature check uses.
255
+ *
256
+ * @since 0.2.0
257
+ * @category fees
258
+ */
259
+ export declare const defaultFees: (estimate: StarknetRpc.StarknetFeeEstimate) => StarknetResourceBounds;
260
+ /**
261
+ * Builds a {@link StarknetRelayer} over the provided {@link StarknetRpc.StarknetRpc}. `confirmations` overrides the
262
+ * network's default, as in `StarknetIndexer.layer`: both agree on the last confirmed block. `fees` (default
263
+ * {@link defaultFees}) bounds the resources of the transactions signed without explicit bounds.
264
+ *
265
+ * @since 0.2.0
266
+ * @category layers
267
+ */
268
+ export declare const layer: (options?: {
269
+ readonly confirmations?: number | undefined;
270
+ readonly fees?: ((estimate: StarknetRpc.StarknetFeeEstimate) => StarknetResourceBounds) | undefined;
271
+ }) => Layer.Layer<StarknetRelayer, never, StarknetRpc.StarknetRpc>;
272
+ export {};
273
+ //# sourceMappingURL=StarknetRelayer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetRelayer.d.ts","sourceRoot":"","sources":["../src/StarknetRelayer.ts"],"names":[],"mappings":"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"}