@effect-blockchain/solana 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.
@@ -7,8 +7,8 @@ import * as Schedule from "effect/Schedule";
7
7
  import type * as Schema from "effect/Schema";
8
8
  import * as Stream from "effect/Stream";
9
9
  import type { SolanaAddress } from "./SolanaAddress.ts";
10
- import type { SolanaRpcError, SolanaTransactionEncoding, SolanaTransactionInfo } from "./SolanaRpc.ts";
11
- import { SolanaRpc } from "./SolanaRpc.ts";
10
+ import type { SolanaTransactionEncoding, SolanaTransactionInfo } from "./SolanaRpc.ts";
11
+ import { SolanaRpc, SolanaRpcError } from "./SolanaRpc.ts";
12
12
  import type { SolanaTransactionHash } from "./SolanaTransactionHash.ts";
13
13
  /**
14
14
  * A transaction touching the indexed address, kept raw: the `getTransaction` result with its `signature` and the
@@ -72,6 +72,33 @@ export interface SolanaIndexerStreamOptions {
72
72
  */
73
73
  readonly retry?: Schedule.Schedule<unknown, SolanaRpcError> | undefined;
74
74
  }
75
+ /**
76
+ * The lamports of an address at the end of slot `block`, emitted by {@link SolanaIndexer.Service.streamNativeBalance}.
77
+ *
78
+ * @since 0.2.0
79
+ * @category models
80
+ */
81
+ export interface SolanaNativeBalance {
82
+ readonly block: bigint;
83
+ readonly balance: bigint;
84
+ }
85
+ /**
86
+ * The {@link SolanaIndexer.Service.streamNativeBalance} options: a sample of the balance of `address` at `fromBlock`,
87
+ * `fromBlock + step`, `fromBlock + 2 * step`... `poll` and `retry` behave as in {@link SolanaIndexerStreamOptions}.
88
+ *
89
+ * @since 0.2.0
90
+ * @category models
91
+ */
92
+ export interface SolanaIndexerNativeBalanceOptions {
93
+ readonly address: SolanaAddress;
94
+ readonly fromBlock: bigint;
95
+ /** The stream ends after the last sample not above it, and is empty when `fromBlock > toBlock`. */
96
+ readonly toBlock?: bigint | undefined;
97
+ /** The slots between two samples, a positive safe integer. */
98
+ readonly step: number;
99
+ readonly poll?: Schedule.Schedule<unknown> | undefined;
100
+ readonly retry?: Schedule.Schedule<unknown, SolanaRpcError> | undefined;
101
+ }
75
102
  declare const SolanaIndexer_base: Context.ServiceClass<SolanaIndexer, "@effect-blockchain/solana/SolanaIndexer", {
76
103
  /** The `finalized` slot minus the confirmations, never below 0. */
77
104
  readonly lastConfirmedBlock: Effect.Effect<bigint, SolanaRpcError>;
@@ -99,6 +126,21 @@ declare const SolanaIndexer_base: Context.ServiceClass<SolanaIndexer, "@effect-b
99
126
  readonly encoding: Encoding;
100
127
  }): Stream.Stream<SolanaIndexerBatch<Encoding>, SolanaRpcError>;
101
128
  };
129
+ /**
130
+ * The lamports of `address` at the end of slot `block`: the `postBalances` of its newest transaction at or before
131
+ * `block`, else the `preBalances` of its first one after. At or above the confirmed head with no newer transaction,
132
+ * its `getBalance`: an address without any transaction reads its current balance there and 0 below.
133
+ */
134
+ readonly fetchNativeBalance: (options: {
135
+ readonly address: SolanaAddress;
136
+ readonly block: bigint;
137
+ }) => Effect.Effect<bigint, SolanaRpcError>;
138
+ /**
139
+ * The lamports of `address` at every `step` slots from `fromBlock`, following the confirmed head. A sample only
140
+ * reads the meta of the newest transaction since the previous one, so epoch rewards, which change a balance without
141
+ * a transaction, show from the next transaction on.
142
+ */
143
+ readonly streamNativeBalance: (options: SolanaIndexerNativeBalanceOptions) => Stream.Stream<SolanaNativeBalance, SolanaRpcError>;
102
144
  }>;
103
145
  /**
104
146
  * @since 0.1.0
@@ -124,7 +166,7 @@ export declare const DEFAULT_POLL_INTERVAL: Duration.Duration;
124
166
  /**
125
167
  * Builds a {@link SolanaIndexer} on the provided {@link SolanaRpc}.
126
168
  *
127
- * - `confirmations` defaults to {@link SolanaNetwork.defaultConfirmations} for the RPC's network.
169
+ * - `confirmations` defaults to `SolanaNetwork.defaultConfirmations` for the RPC's network.
128
170
  * - `maxBatchSize`, a positive integer, the signatures per `streamTransactions` batch, defaults to
129
171
  * {@link DEFAULT_MAX_BATCH_SIZE}.
130
172
  *
@@ -1 +1 @@
1
- {"version":3,"file":"SolanaIndexer.d.ts","sourceRoot":"","sources":["../src/SolanaIndexer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"SolanaIndexer.d.ts","sourceRoot":"","sources":["../src/SolanaIndexer.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  /**
2
2
  * Solana transaction indexing on top of {@link SolanaRpc}: the last confirmed slot, the transactions touching an
3
- * address over a slot range, and a stream of them following the confirmed head. Blocks are slots.
3
+ * address over a slot range, its lamport balance at a slot, and streams of both following the confirmed head. Blocks
4
+ * are slots.
4
5
  *
5
6
  * Everything is read at `finalized` commitment. `getSignaturesForAddress` has no slot range, so a range is paged from
6
7
  * the head backwards until it passes `fromBlock`: the cost grows with the address's history since `fromBlock`, then
@@ -9,6 +10,7 @@
9
10
  *
10
11
  * @example
11
12
  * ```ts
13
+ * import type { SolanaAddress } from "@effect-blockchain/solana/SolanaAddress"
12
14
  * import type { SolanaIndexerFilter } from "@effect-blockchain/solana/SolanaIndexer"
13
15
  * import { SolanaIndexer } from "@effect-blockchain/solana/SolanaIndexer"
14
16
  * import * as Effect from "effect/Effect"
@@ -27,6 +29,16 @@
27
29
  * Stream.runForEach((batch) => save(batch.toBlock))
28
30
  * )
29
31
  * })
32
+ *
33
+ * declare const address: SolanaAddress
34
+ *
35
+ * // the lamports of `address` every 9000 slots (about an hour) from slot 400000000
36
+ * const balances = Effect.gen(function*() {
37
+ * const indexer = yield* SolanaIndexer
38
+ * yield* indexer.streamNativeBalance({ address, fromBlock: BigInt(400000000), step: 9000 }).pipe(
39
+ * Stream.runForEach(({ balance, block }) => Effect.log(`${block}: ${balance}`))
40
+ * )
41
+ * })
30
42
  * ```
31
43
  *
32
44
  * @since 0.1.0
@@ -42,8 +54,8 @@ import * as Layer from "effect/Layer";
42
54
  import * as Option from "effect/Option";
43
55
  import * as Schedule from "effect/Schedule";
44
56
  import * as Stream from "effect/Stream";
45
- import * as SolanaNetwork from "./SolanaNetwork.js";
46
- import { SolanaRpc } from "./SolanaRpc.js";
57
+ import * as Confirmations from "./internal/confirmations.js";
58
+ import { SolanaRpc, SolanaRpcError } from "./SolanaRpc.js";
47
59
  /**
48
60
  * @since 0.1.0
49
61
  * @category services
@@ -76,10 +88,31 @@ const groupBySlot = (signatures, max) => {
76
88
  }
77
89
  return groups;
78
90
  };
91
+ // the lamports of `address` before and after `transaction`, none when it is not one of its accounts. An account's
92
+ // index runs over the static account keys, then the addresses loaded from lookup tables, writable then readonly
93
+ // (https://solana.com/docs/advanced/versions)
94
+ const balanceChange = ({
95
+ meta,
96
+ transaction
97
+ }, address) => {
98
+ if (meta === null) return Option.none();
99
+ const index = [...transaction.message.accountKeys, ...(meta.loadedAddresses?.writable ?? []), ...(meta.loadedAddresses?.readonly ?? [])].indexOf(address);
100
+ const pre = meta.preBalances[index];
101
+ const post = meta.postBalances[index];
102
+ return pre === undefined || post === undefined ? Option.none() : Option.some({
103
+ pre,
104
+ post
105
+ });
106
+ };
107
+ // retries a stream step failing with a transient reason at the same position
108
+ const withRetry = (retry, step) => retry === undefined ? step : position => Effect.retry(step(position), {
109
+ schedule: retry,
110
+ while: error => JsonRpc.isTransient(error.reason)
111
+ });
79
112
  /**
80
113
  * Builds a {@link SolanaIndexer} on the provided {@link SolanaRpc}.
81
114
  *
82
- * - `confirmations` defaults to {@link SolanaNetwork.defaultConfirmations} for the RPC's network.
115
+ * - `confirmations` defaults to `SolanaNetwork.defaultConfirmations` for the RPC's network.
83
116
  * - `maxBatchSize`, a positive integer, the signatures per `streamTransactions` batch, defaults to
84
117
  * {@link DEFAULT_MAX_BATCH_SIZE}.
85
118
  *
@@ -94,27 +127,28 @@ export const layer = (options = {}) => Layer.effect(SolanaIndexer, Effect.gen(fu
94
127
  if (!Number.isSafeInteger(maxBatchSize) || maxBatchSize < 1) {
95
128
  return yield* Effect.die(new RangeError(`maxBatchSize must be a positive integer, got ${maxBatchSize}`));
96
129
  }
97
- const confirmations = BigInt(options.confirmations ?? SolanaNetwork.defaultConfirmations(rpc.network));
98
- const lastConfirmedBlock = rpc.getSlot({
99
- commitment: COMMITMENT
100
- }).pipe(Effect.map(slot => BigInt_.max(slot - confirmations, BigInt(0))), Effect.withSpan("SolanaIndexer.lastConfirmedBlock"));
101
- // the signatures of `[fromBlock, toBlock]` in chain order, paged from the head back to the first short page or
102
- // the first page reaching below `fromBlock`
103
- const fetchSignatures = filter => Stream.paginate(Option.none(), before => rpc.getSignaturesForAddress({
104
- address: filter.address,
130
+ const lastConfirmedBlock = Confirmations.lastConfirmedBlock(rpc, options.confirmations).pipe(Effect.withSpan("SolanaIndexer.lastConfirmedBlock"));
131
+ // the signatures of `address`, newest first, a page read only when the previous one is consumed
132
+ const signatures = (address, minContextSlot) => Stream.paginate(Option.none(), before => rpc.getSignaturesForAddress({
133
+ address,
105
134
  before: Option.getOrUndefined(before),
106
135
  limit: PAGE_SIZE,
107
136
  commitment: COMMITMENT,
108
- minContextSlot: filter.toBlock
137
+ minContextSlot
109
138
  }).pipe(Effect.map(page => {
110
139
  const last = page.at(-1);
111
- return [page, last === undefined || page.length < PAGE_SIZE || last.slot < filter.fromBlock ? Option.none() : Option.some(Option.some(last.signature))];
112
- }))).pipe(Stream.runCollect,
140
+ return [page, last === undefined || page.length < PAGE_SIZE ? Option.none() : Option.some(Option.some(last.signature))];
141
+ })));
142
+ // the signatures of `[fromBlock, toBlock]` in chain order, paged from the head back to the first short page or
143
+ // the first page reaching below `fromBlock`
144
+ const fetchSignatures = filter => signatures(filter.address, filter.toBlock).pipe(Stream.takeWhile(({
145
+ slot
146
+ }) => slot >= filter.fromBlock), Stream.runCollect,
113
147
  // newest first, so reversed slots ascend. The order within a slot is undocumented: reversing it is a best
114
148
  // guess at execution order (`transactionIndex`, which some providers add, is not in the RPC model)
115
149
  Effect.map(signatures => Arr.reverse(Arr.filter(signatures, ({
116
150
  slot
117
- }) => slot >= filter.fromBlock && slot <= filter.toBlock))));
151
+ }) => slot <= filter.toBlock))));
118
152
  const fetchEach = (signatures, encoding) => Effect.forEach(signatures, ({
119
153
  err,
120
154
  signature
@@ -198,15 +232,98 @@ export const layer = (options = {}) => Layer.effect(SolanaIndexer, Effect.gen(fu
198
232
  next: fromBlock,
199
233
  cap: fromBlock,
200
234
  groups: []
201
- }, retry === undefined ? step : position => Effect.retry(step(position), {
202
- schedule: retry,
203
- while: error => JsonRpc.isTransient(error.reason)
204
- }));
235
+ }, withRetry(retry, step));
205
236
  }
237
+ const balanceOf = (address, signature, side) => rpc.getTransaction({
238
+ signature,
239
+ commitment: COMMITMENT,
240
+ encoding: "json"
241
+ }).pipe(Effect.flatMap(tx => Option.match(balanceChange(tx, address), {
242
+ onSome: change => Effect.succeed(change[side]),
243
+ onNone: () => Effect.fail(new SolanaRpcError({
244
+ reason: new JsonRpc.InvalidResponse(),
245
+ method: "getTransaction",
246
+ endpoint: "SolanaIndexer",
247
+ cause: new Error(`transaction ${signature} has no balance for ${address}`)
248
+ }))
249
+ })));
250
+ // the balance at the end of `block`, at or below `confirmed`, given the sample before it when there is one
251
+ const balanceAt = Effect.fnUntraced(function* (address, block, confirmed, previous) {
252
+ // read before the signatures, so that a transaction landing in between is listed
253
+ const current = Option.isNone(previous) && block >= confirmed ? Option.some(yield* rpc.getBalance({
254
+ address
255
+ })) : Option.none();
256
+ // the newest signature, and the newest at or before `block` or else the oldest
257
+ const {
258
+ last,
259
+ newest
260
+ } = yield* signatures(address, BigInt_.min(block, confirmed)).pipe(Stream.takeUntil(({
261
+ slot
262
+ }) => slot <= block), Stream.runFold(() => ({
263
+ newest: Option.none(),
264
+ last: Option.none()
265
+ }), (acc, info) => ({
266
+ newest: Option.orElseSome(acc.newest, () => info),
267
+ last: Option.some(info)
268
+ })));
269
+ if (Option.isSome(current) && Option.match(newest, {
270
+ onNone: () => true,
271
+ onSome: ({
272
+ slot
273
+ }) => slot <= BigInt_.min(block, current.value.slot)
274
+ })) {
275
+ return current.value.value;
276
+ }
277
+ if (Option.isSome(last) && last.value.slot <= block) {
278
+ return Option.isSome(previous) && last.value.slot <= previous.value.block ? previous.value.balance : yield* balanceOf(address, last.value.signature, "post");
279
+ }
280
+ if (Option.isSome(previous)) return previous.value.balance;
281
+ return Option.isSome(last) ? yield* balanceOf(address, last.value.signature, "pre") : BigInt(0);
282
+ });
283
+ const fetchNativeBalance = Effect.fn("SolanaIndexer.fetchNativeBalance")(function* ({
284
+ address,
285
+ block
286
+ }) {
287
+ return yield* balanceAt(address, block, yield* lastConfirmedBlock, Option.none());
288
+ });
289
+ const streamNativeBalance = ({
290
+ address,
291
+ fromBlock,
292
+ poll = Schedule.spaced(DEFAULT_POLL_INTERVAL),
293
+ retry,
294
+ step,
295
+ toBlock
296
+ }) => {
297
+ if (!Number.isSafeInteger(step) || step < 1) {
298
+ return Stream.die(new RangeError(`step must be a positive safe integer, got ${step}`));
299
+ }
300
+ if (toBlock !== undefined && fromBlock > toBlock) {
301
+ return Stream.empty;
302
+ }
303
+ const sample = previous => {
304
+ const block = Option.match(previous, {
305
+ onNone: () => fromBlock,
306
+ onSome: p => p.block + BigInt(step)
307
+ });
308
+ return lastConfirmedBlock.pipe(Effect.repeat({
309
+ schedule: poll,
310
+ until: confirmed => confirmed >= block
311
+ }), Effect.flatMap(confirmed => confirmed < block ? Effect.succeed([[], Option.none()]) : balanceAt(address, block, confirmed, previous).pipe(Effect.map(balance => {
312
+ const current = {
313
+ block,
314
+ balance
315
+ };
316
+ return [[current], toBlock !== undefined && block + BigInt(step) > toBlock ? Option.none() : Option.some(Option.some(current))];
317
+ }))), Effect.withSpan("SolanaIndexer.streamNativeBalance.sample"));
318
+ };
319
+ return Stream.paginate(Option.none(), withRetry(retry, sample));
320
+ };
206
321
  return SolanaIndexer.of({
207
322
  lastConfirmedBlock,
208
323
  fetchTransactions,
209
- streamTransactions
324
+ streamTransactions,
325
+ fetchNativeBalance,
326
+ streamNativeBalance
210
327
  });
211
328
  }));
212
329
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"SolanaIndexer.js","names":[],"sources":["../src/SolanaIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"file":"SolanaIndexer.js","names":[],"sources":["../src/SolanaIndexer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
@@ -0,0 +1,207 @@
1
+ import * as Context from "effect/Context";
2
+ import * as Effect from "effect/Effect";
3
+ import * as Layer from "effect/Layer";
4
+ import * as Schedule from "effect/Schedule";
5
+ import * as Schema from "effect/Schema";
6
+ import { SolanaAddress } from "./SolanaAddress.ts";
7
+ import * as SolanaRpc from "./SolanaRpc.ts";
8
+ import { type SolanaSigner, SolanaSignerError } from "./SolanaSigner.ts";
9
+ import { SolanaTransactionHash } from "./SolanaTransactionHash.ts";
10
+ /**
11
+ * Where a transaction stands, by `_tag`: see the module's table. `block` is the slot holding it, and `reason` the
12
+ * transaction error as the node returns it.
13
+ *
14
+ * @since 0.2.0
15
+ * @category models
16
+ */
17
+ export type SolanaTransactionStatus = {
18
+ readonly _tag: "Pending";
19
+ } | {
20
+ readonly _tag: "Included";
21
+ readonly block: bigint;
22
+ } | {
23
+ readonly _tag: "Confirmed";
24
+ readonly block: bigint;
25
+ } | {
26
+ readonly _tag: "Failed";
27
+ readonly block: bigint;
28
+ readonly reason: SolanaRpc.SolanaTransactionError;
29
+ } | {
30
+ readonly _tag: "Expired";
31
+ } | {
32
+ readonly _tag: "NotFound";
33
+ };
34
+ /**
35
+ * The transaction to look up: its `hash` (its first signature) and the `lastValidBlockHeight` returned with its
36
+ * recent blockhash. Without `lastValidBlockHeight`, an unknown transaction is `NotFound`, never `Expired`.
37
+ *
38
+ * @since 0.2.0
39
+ * @category models
40
+ */
41
+ export interface SolanaTransactionStatusOptions {
42
+ readonly hash: SolanaTransactionHash;
43
+ readonly lastValidBlockHeight?: bigint | undefined;
44
+ }
45
+ /**
46
+ * An account an instruction reads, `writable` when the instruction changes it and `signer` when it must sign the
47
+ * transaction.
48
+ *
49
+ * @since 0.2.0
50
+ * @category models
51
+ */
52
+ export interface SolanaAccountMeta {
53
+ readonly address: SolanaAddress;
54
+ readonly signer?: boolean | undefined;
55
+ readonly writable?: boolean | undefined;
56
+ }
57
+ /**
58
+ * An instruction of a transaction: the program to call, the accounts it takes, in the program's order, and its `data`
59
+ * as the program encodes it.
60
+ *
61
+ * @since 0.2.0
62
+ * @category models
63
+ */
64
+ export interface SolanaInstruction {
65
+ readonly programAddress: SolanaAddress;
66
+ readonly accounts?: ReadonlyArray<SolanaAccountMeta> | undefined;
67
+ readonly data?: Uint8Array | undefined;
68
+ }
69
+ /**
70
+ * A transaction signed by {@link SolanaRelayer.sign}: `signed` is the base64 wire transaction `broadcast` takes,
71
+ * `hash` the fee payer's signature and `lastValidBlockHeight` the last block height it can land at.
72
+ *
73
+ * @since 0.2.0
74
+ * @category models
75
+ */
76
+ export interface SolanaSignedTransaction {
77
+ readonly hash: SolanaTransactionHash;
78
+ readonly signed: string;
79
+ readonly lastValidBlockHeight: bigint;
80
+ }
81
+ declare const BlockhashNotFound_base: Schema.Class<BlockhashNotFound, Schema.TaggedStruct<"BlockhashNotFound", {}>, import("effect/Cause").YieldableError>;
82
+ /**
83
+ * The node does not know the transaction's blockhash: it has expired, or the node is behind the one that returned
84
+ * it. Past `lastValidBlockHeight`, sign the transaction again.
85
+ *
86
+ * @since 0.2.0
87
+ * @category reasons
88
+ */
89
+ export declare class BlockhashNotFound extends BlockhashNotFound_base {
90
+ }
91
+ declare const InsufficientFundsForFee_base: Schema.Class<InsufficientFundsForFee, Schema.TaggedStruct<"InsufficientFundsForFee", {}>, import("effect/Cause").YieldableError>;
92
+ /**
93
+ * The fee payer cannot pay the transaction fee: its balance is too low, or it holds no account.
94
+ *
95
+ * @since 0.2.0
96
+ * @category reasons
97
+ */
98
+ export declare class InsufficientFundsForFee extends InsufficientFundsForFee_base {
99
+ }
100
+ declare const SimulationFailed_base: Schema.Class<SimulationFailed, Schema.TaggedStruct<"SimulationFailed", {
101
+ readonly error: Schema.Codec<SolanaRpc.SolanaTransactionError, SolanaRpc.SolanaTransactionError, never, never>;
102
+ readonly logs: Schema.$Array<Schema.String>;
103
+ }>, import("effect/Cause").YieldableError>;
104
+ /**
105
+ * The node simulated the transaction and it failed: `error` is the transaction error and `logs` the program logs up
106
+ * to it. {@link SolanaRelayer.sign} fails with it when it estimates the compute unit limit.
107
+ *
108
+ * @since 0.2.0
109
+ * @category reasons
110
+ */
111
+ export declare class SimulationFailed extends SimulationFailed_base {
112
+ }
113
+ /**
114
+ * Why a node refused a transaction, the `reason` of a {@link SolanaBroadcastError}, matched with `Effect.catchReason`.
115
+ *
116
+ * @since 0.2.0
117
+ * @category reasons
118
+ */
119
+ export declare const SolanaBroadcastReason: Schema.Union<readonly [typeof BlockhashNotFound, typeof InsufficientFundsForFee, typeof SimulationFailed]>;
120
+ /**
121
+ * @since 0.2.0
122
+ * @category reasons
123
+ */
124
+ export type SolanaBroadcastReason = typeof SolanaBroadcastReason.Type;
125
+ declare const SolanaBroadcastError_base: Schema.Class<SolanaBroadcastError, Schema.TaggedStruct<"SolanaBroadcastError", {
126
+ readonly reason: Schema.Union<readonly [typeof BlockhashNotFound, typeof InsufficientFundsForFee, typeof SimulationFailed]>;
127
+ readonly cause: Schema.Defect;
128
+ }>, import("effect/Cause").YieldableError>;
129
+ /**
130
+ * A node refused the transaction at its preflight simulation for a `reason` the sender can act on: `cause` is the
131
+ * {@link SolanaRpc.SolanaRpcError} holding the node's message. Any other refusal stays a `SolanaRpcError`.
132
+ *
133
+ * @since 0.2.0
134
+ * @category errors
135
+ */
136
+ export declare class SolanaBroadcastError extends SolanaBroadcastError_base {
137
+ }
138
+ declare const SolanaRelayer_base: Context.ServiceClass<SolanaRelayer, "@effect-blockchain/solana/SolanaRelayer", {
139
+ /**
140
+ * Signs a v0 transaction of `instructions` paid by `feePayer` without sending it. `signers` are the other accounts
141
+ * the instructions mark as signer. A missing `blockhash` is the latest one at `confirmed` commitment, a missing
142
+ * `computeUnitLimit` is the units a simulation consumed times the layer's `computeUnitMultiplier` (a transaction
143
+ * that would fail fails with `SimulationFailed`), and a missing `computeUnitPrice`, in micro-lamports, comes from
144
+ * the layer's fee strategy.
145
+ */
146
+ readonly sign: (options: {
147
+ readonly feePayer: SolanaSigner;
148
+ readonly signers?: ReadonlyArray<SolanaSigner> | undefined;
149
+ readonly instructions: ReadonlyArray<SolanaInstruction>;
150
+ readonly blockhash?: Pick<SolanaRpc.SolanaLatestBlockhash, "blockhash" | "lastValidBlockHeight"> | undefined;
151
+ readonly computeUnitLimit?: number | undefined;
152
+ readonly computeUnitPrice?: bigint | undefined;
153
+ }) => Effect.Effect<SolanaSignedTransaction, SolanaRpc.SolanaRpcError | SolanaSignerError | SimulationFailed>;
154
+ /**
155
+ * Sends a signed transaction with `sendTransaction` and returns its hash. The node simulates it first at
156
+ * `confirmed` commitment, then rebroadcasts it to the leaders until its blockhash expires (the node's default
157
+ * `maxRetries`). Sending the same bytes again is safe: a node answering that it has already processed the
158
+ * transaction is a success.
159
+ */
160
+ readonly broadcast: (options: {
161
+ readonly signed: string;
162
+ }) => Effect.Effect<SolanaTransactionHash, SolanaBroadcastError | SolanaRpc.SolanaRpcError>;
163
+ /**
164
+ * The status of the transaction as the answering endpoint sees it. An endpoint behind the head, or one that never
165
+ * received the transaction, answers `NotFound`, or `Expired` when `lastValidBlockHeight` has passed, for a
166
+ * transaction another one has in a block.
167
+ */
168
+ readonly fetchTransactionStatus: (options: SolanaTransactionStatusOptions) => Effect.Effect<SolanaTransactionStatus, SolanaRpc.SolanaRpcError>;
169
+ /**
170
+ * Reads {@link fetchTransactionStatus} on `poll` (`Schedule.spaced(SolanaIndexer.DEFAULT_POLL_INTERVAL)` by
171
+ * default) until it is `Confirmed`, `Failed` or `Expired`, and returns it. `NotFound` keeps polling, so bound the
172
+ * wait with a timeout. A `poll` that ends first returns the last status read.
173
+ */
174
+ readonly awaitConfirmation: (options: SolanaTransactionStatusOptions & {
175
+ readonly poll?: Schedule.Schedule<unknown> | undefined;
176
+ }) => Effect.Effect<SolanaTransactionStatus, SolanaRpc.SolanaRpcError>;
177
+ }>;
178
+ /**
179
+ * @since 0.2.0
180
+ * @category services
181
+ */
182
+ export declare class SolanaRelayer extends SolanaRelayer_base {
183
+ }
184
+ /**
185
+ * The library's fee strategy: the compute unit price is the 75th percentile of the recent slots' prioritization fees,
186
+ * at least 1 micro-lamport.
187
+ *
188
+ * @since 0.2.0
189
+ * @category fees
190
+ */
191
+ export declare const defaultFees: (fees: ReadonlyArray<SolanaRpc.SolanaPrioritizationFee>) => bigint;
192
+ /**
193
+ * Builds a {@link SolanaRelayer} over the provided {@link SolanaRpc.SolanaRpc}. `confirmations` overrides the
194
+ * network's default, as in `SolanaIndexer.layer`: both agree on the last confirmed slot. `fees` (default
195
+ * {@link defaultFees}) prices the transactions signed without a compute unit price, and `computeUnitMultiplier`
196
+ * (default 1.2) is the margin applied to a simulated compute unit limit.
197
+ *
198
+ * @since 0.2.0
199
+ * @category layers
200
+ */
201
+ export declare const layer: (options?: {
202
+ readonly confirmations?: number | undefined;
203
+ readonly fees?: ((fees: ReadonlyArray<SolanaRpc.SolanaPrioritizationFee>) => bigint) | undefined;
204
+ readonly computeUnitMultiplier?: number | undefined;
205
+ }) => Layer.Layer<SolanaRelayer, never, SolanaRpc.SolanaRpc>;
206
+ export {};
207
+ //# sourceMappingURL=SolanaRelayer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SolanaRelayer.d.ts","sourceRoot":"","sources":["../src/SolanaRelayer.ts"],"names":[],"mappings":"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"}