@effect-blockchain/starknet 0.0.0-stage → 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 (78) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +12 -2
  3. package/dist/StarknetAddress.d.ts +29 -0
  4. package/dist/StarknetAddress.d.ts.map +1 -0
  5. package/dist/StarknetAddress.js +29 -0
  6. package/dist/StarknetAddress.js.map +1 -0
  7. package/dist/StarknetBlock.d.ts +49 -0
  8. package/dist/StarknetBlock.d.ts.map +1 -0
  9. package/dist/StarknetBlock.js +52 -0
  10. package/dist/StarknetBlock.js.map +1 -0
  11. package/dist/StarknetEvent.d.ts +34 -0
  12. package/dist/StarknetEvent.d.ts.map +1 -0
  13. package/dist/StarknetEvent.js +39 -0
  14. package/dist/StarknetEvent.js.map +1 -0
  15. package/dist/StarknetIndexer.d.ts +157 -0
  16. package/dist/StarknetIndexer.d.ts.map +1 -0
  17. package/dist/StarknetIndexer.js +245 -0
  18. package/dist/StarknetIndexer.js.map +1 -0
  19. package/dist/StarknetNetwork.d.ts +72 -0
  20. package/dist/StarknetNetwork.d.ts.map +1 -0
  21. package/dist/StarknetNetwork.js +83 -0
  22. package/dist/StarknetNetwork.js.map +1 -0
  23. package/dist/StarknetRelayer.d.ts +273 -0
  24. package/dist/StarknetRelayer.d.ts.map +1 -0
  25. package/dist/StarknetRelayer.js +352 -0
  26. package/dist/StarknetRelayer.js.map +1 -0
  27. package/dist/StarknetRpc.d.ts +306 -0
  28. package/dist/StarknetRpc.d.ts.map +1 -0
  29. package/dist/StarknetRpc.js +281 -0
  30. package/dist/StarknetRpc.js.map +1 -0
  31. package/dist/StarknetSigner.d.ts +75 -0
  32. package/dist/StarknetSigner.d.ts.map +1 -0
  33. package/dist/StarknetSigner.js +84 -0
  34. package/dist/StarknetSigner.js.map +1 -0
  35. package/dist/StarknetTransaction.d.ts +74 -0
  36. package/dist/StarknetTransaction.d.ts.map +1 -0
  37. package/dist/StarknetTransaction.js +2 -0
  38. package/dist/StarknetTransaction.js.map +1 -0
  39. package/dist/StarknetTransactionHash.d.ts +22 -0
  40. package/dist/StarknetTransactionHash.d.ts.map +1 -0
  41. package/dist/StarknetTransactionHash.js +22 -0
  42. package/dist/StarknetTransactionHash.js.map +1 -0
  43. package/dist/index.d.ts +44 -0
  44. package/dist/index.d.ts.map +1 -0
  45. package/dist/index.js +45 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/internal/PaddedFelt.d.ts +2 -0
  48. package/dist/internal/PaddedFelt.d.ts.map +1 -0
  49. package/dist/internal/PaddedFelt.js +15 -0
  50. package/dist/internal/PaddedFelt.js.map +1 -0
  51. package/dist/internal/confirmations.d.ts +2 -0
  52. package/dist/internal/confirmations.d.ts.map +1 -0
  53. package/dist/internal/confirmations.js +13 -0
  54. package/dist/internal/confirmations.js.map +1 -0
  55. package/dist/internal/rpcMethods.d.ts +2 -0
  56. package/dist/internal/rpcMethods.d.ts.map +1 -0
  57. package/dist/internal/rpcMethods.js +225 -0
  58. package/dist/internal/rpcMethods.js.map +1 -0
  59. package/dist/internal/transactionHash.d.ts +2 -0
  60. package/dist/internal/transactionHash.d.ts.map +1 -0
  61. package/dist/internal/transactionHash.js +60 -0
  62. package/dist/internal/transactionHash.js.map +1 -0
  63. package/package.json +66 -3
  64. package/src/StarknetAddress.ts +42 -0
  65. package/src/StarknetBlock.ts +54 -0
  66. package/src/StarknetEvent.ts +45 -0
  67. package/src/StarknetIndexer.ts +363 -0
  68. package/src/StarknetNetwork.ts +107 -0
  69. package/src/StarknetRelayer.ts +437 -0
  70. package/src/StarknetRpc.ts +524 -0
  71. package/src/StarknetSigner.ts +115 -0
  72. package/src/StarknetTransaction.ts +68 -0
  73. package/src/StarknetTransactionHash.ts +31 -0
  74. package/src/index.ts +55 -0
  75. package/src/internal/PaddedFelt.ts +18 -0
  76. package/src/internal/confirmations.ts +17 -0
  77. package/src/internal/rpcMethods.ts +224 -0
  78. package/src/internal/transactionHash.ts +64 -0
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Signers of Starknet transactions: a local private key, or a custody API that only signs a hash.
3
+ *
4
+ * A signer is a value and receives the whole transaction, never a hash chosen by its caller: signing an opaque hash
5
+ * hides what is being authorised, and custody policy engines and hardware wallets refuse it. Only V3 `INVOKE` and
6
+ * `DEPLOY_ACCOUNT` transactions are signed.
7
+ *
8
+ * A Starknet signature is whatever the account contract at `address` validates, so a signer returns felts and the
9
+ * address is given, not derived from the key: `[r, s]` on the Stark curve for OpenZeppelin and Argent accounts.
10
+ *
11
+ * @since 0.2.0
12
+ */
13
+ import * as Effect from "effect/Effect";
14
+ import * as Redacted from "effect/Redacted";
15
+ import * as Schema from "effect/Schema";
16
+ import type { StarknetAddress } from "./StarknetAddress.ts";
17
+ import type { StarknetDeployAccountTransaction, StarknetInvokeTransaction } from "./StarknetTransaction.ts";
18
+ import type { StarknetTransactionHash } from "./StarknetTransactionHash.ts";
19
+ declare const StarknetSignerError_base: Schema.Class<StarknetSignerError, Schema.TaggedStruct<"StarknetSignerError", {
20
+ readonly cause: Schema.Defect;
21
+ }>, import("effect/Cause").YieldableError>;
22
+ /**
23
+ * A signature could not be produced: `cause` is the signer's own failure, or why its signature was refused. It never
24
+ * holds a private key.
25
+ *
26
+ * @since 0.2.0
27
+ * @category errors
28
+ */
29
+ export declare class StarknetSignerError extends StarknetSignerError_base {
30
+ }
31
+ /**
32
+ * A V3 transaction before its signature.
33
+ *
34
+ * @since 0.2.0
35
+ * @category models
36
+ */
37
+ export type StarknetUnsignedTransaction = Omit<StarknetInvokeTransaction, "signature"> | Omit<StarknetDeployAccountTransaction, "signature">;
38
+ /**
39
+ * Signs transactions sent from the account contract at `address`. `signTransaction` returns the signature felts, in
40
+ * the format that account contract validates.
41
+ *
42
+ * @since 0.2.0
43
+ * @category models
44
+ */
45
+ export interface StarknetSigner {
46
+ readonly address: StarknetAddress;
47
+ readonly signTransaction: (transaction: StarknetUnsignedTransaction) => Effect.Effect<ReadonlyArray<string>, StarknetSignerError>;
48
+ }
49
+ /**
50
+ * A signer for a key held elsewhere (a custody API, an HSM) that only signs a hash. `signHash` receives the V3
51
+ * transaction hash and returns the signature felts of the account at `address`, `[r, s]` for OpenZeppelin and Argent
52
+ * accounts. A failure of `signHash` or a signature that is not 0x-prefixed felts fails with a
53
+ * {@link StarknetSignerError}; the signature itself is only checked by the account contract.
54
+ *
55
+ * @since 0.2.0
56
+ * @category constructors
57
+ */
58
+ export declare const fromHashSigner: <E>(options: {
59
+ readonly address: StarknetAddress;
60
+ readonly signHash: (hash: StarknetTransactionHash) => Effect.Effect<ReadonlyArray<string>, E>;
61
+ }) => StarknetSigner;
62
+ /**
63
+ * A signer holding the Stark curve private key (hex) of the account at `address` in memory, signing
64
+ * `[r, s]` as OpenZeppelin and Argent accounts validate. An invalid key fails with a {@link StarknetSignerError} that
65
+ * does not repeat it.
66
+ *
67
+ * @since 0.2.0
68
+ * @category constructors
69
+ */
70
+ export declare const fromPrivateKey: (options: {
71
+ readonly address: StarknetAddress;
72
+ readonly key: Redacted.Redacted<string>;
73
+ }) => Effect.Effect<StarknetSigner, StarknetSignerError>;
74
+ export {};
75
+ //# sourceMappingURL=StarknetSigner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetSigner.d.ts","sourceRoot":"","sources":["../src/StarknetSigner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAC3G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;;;;AAE3E;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,wBAEvC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GACnC,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC,GAC5C,IAAI,CAAC,gCAAgC,EAAE,WAAW,CAAC,CAAA;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,CACxB,WAAW,EAAE,2BAA2B,KACrC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAA;CAC/D;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,WAAW;IACzC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;CAC9F,KAAG,cAQF,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,YAAa;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;CACxC,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAqBjD,CAAA"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * Signers of Starknet transactions: a local private key, or a custody API that only signs a hash.
3
+ *
4
+ * A signer is a value and receives the whole transaction, never a hash chosen by its caller: signing an opaque hash
5
+ * hides what is being authorised, and custody policy engines and hardware wallets refuse it. Only V3 `INVOKE` and
6
+ * `DEPLOY_ACCOUNT` transactions are signed.
7
+ *
8
+ * A Starknet signature is whatever the account contract at `address` validates, so a signer returns felts and the
9
+ * address is given, not derived from the key: `[r, s]` on the Stark curve for OpenZeppelin and Argent accounts.
10
+ *
11
+ * @since 0.2.0
12
+ */
13
+ import * as Effect from "effect/Effect";
14
+ import * as Redacted from "effect/Redacted";
15
+ import * as Schema from "effect/Schema";
16
+ import { ec, num } from "starknet";
17
+ import { transactionHash } from "./internal/transactionHash.js";
18
+ /**
19
+ * A signature could not be produced: `cause` is the signer's own failure, or why its signature was refused. It never
20
+ * holds a private key.
21
+ *
22
+ * @since 0.2.0
23
+ * @category errors
24
+ */
25
+ export class StarknetSignerError extends /*#__PURE__*/Schema.TaggedError()("StarknetSignerError", {
26
+ cause: /*#__PURE__*/Schema.Defect()
27
+ }) {}
28
+ const toError = cause => cause instanceof StarknetSignerError ? cause : new StarknetSignerError({
29
+ cause
30
+ });
31
+ const isFelts = /*#__PURE__*/Schema.is(/*#__PURE__*/Schema.Array(/*#__PURE__*/Schema.String.check(/*#__PURE__*/Schema.isPattern(/^0x[0-9a-fA-F]{1,64}$/))));
32
+ /**
33
+ * A signer for a key held elsewhere (a custody API, an HSM) that only signs a hash. `signHash` receives the V3
34
+ * transaction hash and returns the signature felts of the account at `address`, `[r, s]` for OpenZeppelin and Argent
35
+ * accounts. A failure of `signHash` or a signature that is not 0x-prefixed felts fails with a
36
+ * {@link StarknetSignerError}; the signature itself is only checked by the account contract.
37
+ *
38
+ * @since 0.2.0
39
+ * @category constructors
40
+ */
41
+ export const fromHashSigner = options => ({
42
+ address: options.address,
43
+ signTransaction: Effect.fnUntraced(function* (transaction) {
44
+ const hash = yield* Effect.try({
45
+ try: () => transactionHash(transaction),
46
+ catch: toError
47
+ });
48
+ const signature = yield* Effect.mapError(options.signHash(hash), toError);
49
+ if (!isFelts(signature)) return yield* toError(new Error("the signature is not an array of 0x-prefixed felts"));
50
+ return signature;
51
+ })
52
+ });
53
+ /**
54
+ * A signer holding the Stark curve private key (hex) of the account at `address` in memory, signing
55
+ * `[r, s]` as OpenZeppelin and Argent accounts validate. An invalid key fails with a {@link StarknetSignerError} that
56
+ * does not repeat it.
57
+ *
58
+ * @since 0.2.0
59
+ * @category constructors
60
+ */
61
+ export const fromPrivateKey = options => Effect.try({
62
+ try: () => {
63
+ const key = Redacted.value(options.key);
64
+ ec.starkCurve.getStarkKey(key);
65
+ return key;
66
+ },
67
+ // the thrown error can quote the key
68
+ catch: () => new StarknetSignerError({
69
+ cause: new Error("invalid private key")
70
+ })
71
+ }).pipe(Effect.map(key => fromHashSigner({
72
+ address: options.address,
73
+ signHash: hash => Effect.try({
74
+ try: () => {
75
+ const {
76
+ r,
77
+ s
78
+ } = ec.starkCurve.sign(hash, key);
79
+ return [num.toHex(r), num.toHex(s)];
80
+ },
81
+ catch: toError
82
+ })
83
+ })));
84
+ //# sourceMappingURL=StarknetSigner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetSigner.js","names":[],"sources":["../src/StarknetSigner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;AAYA,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,SAAS,EAAE,EAAE,GAAG,QAAQ,UAAU;AAClC,SAAS,eAAe,QAAQ,+BAA+B;AAK/D;;;;;;;AAOA,OAAM,MAAO,mBAAoB,sBAAQ,MAAM,CAAC,WAAW,EAAuB,CAAC,qBAAqB,EAAE;EACxG,KAAK,eAAE,MAAM,CAAC,MAAM;CACrB,CAAC;AA0BF,MAAM,OAAO,GAAI,KAAc,IAAK,KAAK,YAAY,mBAAmB,GAAG,KAAK,GAAG,IAAI,mBAAmB,CAAC;EAAE;AAAK,CAAE,CAAC;AAErH,MAAM,OAAO,gBAAG,MAAM,CAAC,EAAE,cAAC,MAAM,CAAC,KAAK,cAAC,MAAM,CAAC,MAAM,CAAC,KAAK,cAAC,MAAM,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAEvG;;;;;;;;;AASA,OAAO,MAAM,cAAc,GAAO,OAGjC,KAAsB;EACrB,OAAO,EAAE,OAAO,CAAC,OAAO;EACxB,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,WAAU,WAAW;IACtD,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,GAAG,CAAC;MAAE,GAAG,EAAE,MAAM,eAAe,CAAC,WAAW,CAAC;MAAE,KAAK,EAAE;IAAO,CAAE,CAAC;IAC3F,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACzE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,OAAO,OAAO,CAAC,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC/G,OAAO,SAAS;EAClB,CAAC;CACF,CAAC;AAEF;;;;;;;;AAQA,OAAO,MAAM,cAAc,GAAI,OAG9B,IACC,MAAM,CAAC,GAAG,CAAC;EACT,GAAG,EAAE,MAAK;IACR,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;IACvC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC;IAC9B,OAAO,GAAG;EACZ,CAAC;EACD;EACA,KAAK,EAAE,MAAM,IAAI,mBAAmB,CAAC;IAAE,KAAK,EAAE,IAAI,KAAK,CAAC,qBAAqB;EAAC,CAAE;CACjF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAE,GAAG,IACrB,cAAc,CAAC;EACb,OAAO,EAAE,OAAO,CAAC,OAAO;EACxB,QAAQ,EAAG,IAAI,IACb,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,MAAK;MACR,MAAM;QAAE,CAAC;QAAE;MAAC,CAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;MAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,KAAK,EAAE;GACR;CACJ,CAAC,CACH,CAAC","ignoreList":[]}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * The Starknet V3 transactions an account sends: an `INVOKE` of its `__execute__` entrypoint and the `DEPLOY_ACCOUNT`
3
+ * of its own contract.
4
+ *
5
+ * Fees are paid in STRK. Nonce and fee data availability modes are `L1`, and paymaster and account deployment data
6
+ * are empty: these are the only values the protocol accepts. Felts are 0x-prefixed hexadecimal strings.
7
+ *
8
+ * @since 0.2.0
9
+ */
10
+ import type { StarknetAddress } from "./StarknetAddress.ts";
11
+ import type { StarknetChainId } from "./StarknetNetwork.ts";
12
+ /**
13
+ * The most a V3 transaction pays for each resource: `maxAmount` units at `maxPricePerUnit` FRI (10^-18 STRK) at most.
14
+ *
15
+ * @since 0.2.0
16
+ * @category models
17
+ */
18
+ export interface StarknetResourceBounds {
19
+ readonly l1Gas: {
20
+ readonly maxAmount: bigint;
21
+ readonly maxPricePerUnit: bigint;
22
+ };
23
+ readonly l1DataGas: {
24
+ readonly maxAmount: bigint;
25
+ readonly maxPricePerUnit: bigint;
26
+ };
27
+ readonly l2Gas: {
28
+ readonly maxAmount: bigint;
29
+ readonly maxPricePerUnit: bigint;
30
+ };
31
+ }
32
+ /**
33
+ * An `INVOKE` V3 transaction: `calldata` is the calldata of the `__execute__` entrypoint of `senderAddress`, and
34
+ * `signature` the felts its `__validate__` entrypoint checks.
35
+ *
36
+ * @since 0.2.0
37
+ * @category models
38
+ */
39
+ export interface StarknetInvokeTransaction {
40
+ readonly type: "INVOKE";
41
+ readonly chainId: StarknetChainId;
42
+ readonly senderAddress: StarknetAddress;
43
+ readonly calldata: ReadonlyArray<string>;
44
+ readonly nonce: bigint;
45
+ readonly resourceBounds: StarknetResourceBounds;
46
+ readonly tip: bigint;
47
+ readonly signature: ReadonlyArray<string>;
48
+ }
49
+ /**
50
+ * A `DEPLOY_ACCOUNT` V3 transaction: deploys the account contract of class `classHash` at the address its class hash,
51
+ * salt and constructor calldata determine. That address pays the fee, so it holds STRK before the deployment.
52
+ *
53
+ * @since 0.2.0
54
+ * @category models
55
+ */
56
+ export interface StarknetDeployAccountTransaction {
57
+ readonly type: "DEPLOY_ACCOUNT";
58
+ readonly chainId: StarknetChainId;
59
+ readonly classHash: string;
60
+ readonly contractAddressSalt: string;
61
+ readonly constructorCalldata: ReadonlyArray<string>;
62
+ readonly nonce: bigint;
63
+ readonly resourceBounds: StarknetResourceBounds;
64
+ readonly tip: bigint;
65
+ readonly signature: ReadonlyArray<string>;
66
+ }
67
+ /**
68
+ * A signed transaction, as `starknet_addInvokeTransaction` and `starknet_addDeployAccountTransaction` take it.
69
+ *
70
+ * @since 0.2.0
71
+ * @category models
72
+ */
73
+ export type StarknetTransaction = StarknetInvokeTransaction | StarknetDeployAccountTransaction;
74
+ //# sourceMappingURL=StarknetTransaction.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetTransaction.d.ts","sourceRoot":"","sources":["../src/StarknetTransaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAA;IAChF,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAA;IACpF,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAA;CACjF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAA;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAA;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC1C;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG,gCAAgC,CAAA"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=StarknetTransaction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetTransaction.js","names":[],"sources":["../src/StarknetTransaction.ts"],"sourcesContent":[null],"mappings":"","ignoreList":[]}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Starknet transaction hashes.
3
+ *
4
+ * @since 0.1.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ /**
8
+ * A Starknet transaction hash: `0x` followed by 64 lowercase hex digits.
9
+ *
10
+ * Decoding lowercases the input and left-pads it with zeros, so `"0xc9"` decodes
11
+ * to `"0x00…00c9"`.
12
+ *
13
+ * @since 0.1.0
14
+ * @category schemas
15
+ */
16
+ export declare const StarknetTransactionHash: Schema.brand<Schema.decodeTo<Schema.String, Schema.decodeTo<Schema.String, Schema.String, never, never>, never, never>, "StarknetTransactionHash">;
17
+ /**
18
+ * @since 0.1.0
19
+ * @category models
20
+ */
21
+ export type StarknetTransactionHash = typeof StarknetTransactionHash.Type;
22
+ //# sourceMappingURL=StarknetTransactionHash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetTransactionHash.d.ts","sourceRoot":"","sources":["../src/StarknetTransactionHash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,oJAOnC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Starknet transaction hashes.
3
+ *
4
+ * @since 0.1.0
5
+ */
6
+ import * as Schema from "effect/Schema";
7
+ import { PaddedFelt } from "./internal/PaddedFelt.js";
8
+ /**
9
+ * A Starknet transaction hash: `0x` followed by 64 lowercase hex digits.
10
+ *
11
+ * Decoding lowercases the input and left-pads it with zeros, so `"0xc9"` decodes
12
+ * to `"0x00…00c9"`.
13
+ *
14
+ * @since 0.1.0
15
+ * @category schemas
16
+ */
17
+ export const StarknetTransactionHash = /*#__PURE__*/PaddedFelt.pipe(/*#__PURE__*/Schema.brand("StarknetTransactionHash"), /*#__PURE__*/Schema.annotate({
18
+ identifier: "StarknetTransactionHash",
19
+ title: "Starknet transaction hash",
20
+ description: "a valid Starknet transaction hash, starting with 0x and followed by 64 hexadecimal characters"
21
+ }));
22
+ //# sourceMappingURL=StarknetTransactionHash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StarknetTransactionHash.js","names":[],"sources":["../src/StarknetTransactionHash.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,SAAS,UAAU,QAAQ,0BAA0B;AAErD;;;;;;;;;AASA,OAAO,MAAM,uBAAuB,gBAAG,UAAU,CAAC,IAAI,cACpD,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,eACvC,MAAM,CAAC,QAAQ,CAAC;EACd,UAAU,EAAE,yBAAyB;EACrC,KAAK,EAAE,2BAA2B;EAClC,WAAW,EAAE;CACd,CAAC,CACH","ignoreList":[]}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * @since 0.1.0
3
+ */
4
+ /**
5
+ * @since 0.1.0
6
+ */
7
+ export * as StarknetAddress from "./StarknetAddress.ts";
8
+ /**
9
+ * @since 0.1.0
10
+ */
11
+ export * as StarknetBlock from "./StarknetBlock.ts";
12
+ /**
13
+ * @since 0.1.0
14
+ */
15
+ export * as StarknetEvent from "./StarknetEvent.ts";
16
+ /**
17
+ * @since 0.1.0
18
+ */
19
+ export * as StarknetIndexer from "./StarknetIndexer.ts";
20
+ /**
21
+ * @since 0.1.0
22
+ */
23
+ export * as StarknetNetwork from "./StarknetNetwork.ts";
24
+ /**
25
+ * @since 0.2.0
26
+ */
27
+ export * as StarknetRelayer from "./StarknetRelayer.ts";
28
+ /**
29
+ * @since 0.1.0
30
+ */
31
+ export * as StarknetRpc from "./StarknetRpc.ts";
32
+ /**
33
+ * @since 0.2.0
34
+ */
35
+ export * as StarknetSigner from "./StarknetSigner.ts";
36
+ /**
37
+ * @since 0.2.0
38
+ */
39
+ export * as StarknetTransaction from "./StarknetTransaction.ts";
40
+ /**
41
+ * @since 0.1.0
42
+ */
43
+ export * as StarknetTransactionHash from "./StarknetTransactionHash.ts";
44
+ //# 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,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAA;AAE/D;;GAEG;AACH,OAAO,KAAK,uBAAuB,MAAM,8BAA8B,CAAA"}
package/dist/index.js ADDED
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @since 0.1.0
3
+ */
4
+ // @barrel: Auto-generated exports. Do not edit manually.
5
+ /**
6
+ * @since 0.1.0
7
+ */
8
+ export * as StarknetAddress from "./StarknetAddress.js";
9
+ /**
10
+ * @since 0.1.0
11
+ */
12
+ export * as StarknetBlock from "./StarknetBlock.js";
13
+ /**
14
+ * @since 0.1.0
15
+ */
16
+ export * as StarknetEvent from "./StarknetEvent.js";
17
+ /**
18
+ * @since 0.1.0
19
+ */
20
+ export * as StarknetIndexer from "./StarknetIndexer.js";
21
+ /**
22
+ * @since 0.1.0
23
+ */
24
+ export * as StarknetNetwork from "./StarknetNetwork.js";
25
+ /**
26
+ * @since 0.2.0
27
+ */
28
+ export * as StarknetRelayer from "./StarknetRelayer.js";
29
+ /**
30
+ * @since 0.1.0
31
+ */
32
+ export * as StarknetRpc from "./StarknetRpc.js";
33
+ /**
34
+ * @since 0.2.0
35
+ */
36
+ export * as StarknetSigner from "./StarknetSigner.js";
37
+ /**
38
+ * @since 0.2.0
39
+ */
40
+ export * as StarknetTransaction from "./StarknetTransaction.js";
41
+ /**
42
+ * @since 0.1.0
43
+ */
44
+ export * as StarknetTransactionHash from "./StarknetTransactionHash.js";
45
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAIA;AAEA;;;AAGA,OAAO,KAAK,eAAe,MAAM,sBAAsB;AAEvD;;;AAGA,OAAO,KAAK,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAK,aAAa,MAAM,oBAAoB;AAEnD;;;AAGA,OAAO,KAAK,eAAe,MAAM,sBAAsB;AAEvD;;;AAGA,OAAO,KAAK,eAAe,MAAM,sBAAsB;AAEvD;;;AAGA,OAAO,KAAK,eAAe,MAAM,sBAAsB;AAEvD;;;AAGA,OAAO,KAAK,WAAW,MAAM,kBAAkB;AAE/C;;;AAGA,OAAO,KAAK,cAAc,MAAM,qBAAqB;AAErD;;;AAGA,OAAO,KAAK,mBAAmB,MAAM,0BAA0B;AAE/D;;;AAGA,OAAO,KAAK,uBAAuB,MAAM,8BAA8B","ignoreList":[]}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=PaddedFelt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PaddedFelt.d.ts","sourceRoot":"","sources":["../../src/internal/PaddedFelt.ts"],"names":[],"mappings":""}
@@ -0,0 +1,15 @@
1
+ import { identity } from "effect/Function";
2
+ import * as Schema from "effect/Schema";
3
+ import * as SchemaTransformation from "effect/SchemaTransformation";
4
+ const padFelt = hex => `0x${(hex.startsWith("0x") ? hex.slice(2) : hex).padStart(64, "0")}`;
5
+ /**
6
+ * A field element as a hex string: accepts 1 to 64 hex digits with an optional
7
+ * `0x` prefix in any case, decodes to `0x` + 64 lowercase hex digits.
8
+ *
9
+ * @internal
10
+ */
11
+ export const PaddedFelt = /*#__PURE__*/Schema.String.pipe(/*#__PURE__*/Schema.check(/*#__PURE__*/Schema.isPattern(/^(0x)?[0-9a-fA-F]{1,64}$/u)), /*#__PURE__*/Schema.decodeTo(Schema.String, /*#__PURE__*/SchemaTransformation.toLowerCase()), /*#__PURE__*/Schema.decodeTo(Schema.String, /*#__PURE__*/SchemaTransformation.transform({
12
+ decode: padFelt,
13
+ encode: identity
14
+ })), /*#__PURE__*/Schema.check(/*#__PURE__*/Schema.isPattern(/^0x[0-9a-f]{64}$/u)));
15
+ //# sourceMappingURL=PaddedFelt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PaddedFelt.js","names":[],"sources":["../../src/internal/PaddedFelt.ts"],"sourcesContent":[null],"mappings":"AAAA,SAAS,QAAQ,QAAQ,iBAAiB;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,OAAO,KAAK,oBAAoB,MAAM,6BAA6B;AAEnE,MAAM,OAAO,GAAI,GAAW,IAAa,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE;AAE7G;;;;;;AAMA,OAAO,MAAM,UAAU,gBAAG,MAAM,CAAC,MAAM,CAAC,IAAI,cAC1C,MAAM,CAAC,KAAK,cAAC,MAAM,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC,eAC3D,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,eAAE,oBAAoB,CAAC,WAAW,EAAE,CAAC,eAClE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,eAAE,oBAAoB,CAAC,SAAS,CAAC;EAAE,MAAM,EAAE,OAAO;EAAE,MAAM,EAAE;AAAQ,CAAE,CAAC,CAAC,eACrG,MAAM,CAAC,KAAK,cAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CACpD","ignoreList":[]}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=confirmations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"confirmations.d.ts","sourceRoot":"","sources":["../../src/internal/confirmations.ts"],"names":[],"mappings":""}
@@ -0,0 +1,13 @@
1
+ import * as BigInt_ from "effect/BigInt";
2
+ import * as Effect from "effect/Effect";
3
+ import * as StarknetNetwork from "../StarknetNetwork.js";
4
+ /**
5
+ * The head block number minus `confirmations` (the network's default when unset), never below 0.
6
+ *
7
+ * @internal
8
+ */
9
+ export const lastConfirmedBlock = (rpc, confirmations) => {
10
+ const depth = BigInt(confirmations ?? StarknetNetwork.defaultConfirmations(rpc.network));
11
+ return Effect.map(rpc.blockNumber, head => BigInt_.max(head - depth, BigInt(0)));
12
+ };
13
+ //# sourceMappingURL=confirmations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"confirmations.js","names":[],"sources":["../../src/internal/confirmations.ts"],"sourcesContent":[null],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,eAAe;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe;AACvC,OAAO,KAAK,eAAe,MAAM,uBAAuB;AAGxD;;;;;AAKA,OAAO,MAAM,kBAAkB,GAAG,CAChC,GAAuC,EACvC,aAAiC,KACsB;EACvD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,IAAI,eAAe,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;EACxF,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAG,IAAI,IAAK,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC","ignoreList":[]}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rpcMethods.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpcMethods.d.ts","sourceRoot":"","sources":["../../src/internal/rpcMethods.ts"],"names":[],"mappings":""}