@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.
- package/LICENSE +21 -0
- package/README.md +12 -2
- package/dist/StarknetAddress.d.ts +29 -0
- package/dist/StarknetAddress.d.ts.map +1 -0
- package/dist/StarknetAddress.js +29 -0
- package/dist/StarknetAddress.js.map +1 -0
- package/dist/StarknetBlock.d.ts +49 -0
- package/dist/StarknetBlock.d.ts.map +1 -0
- package/dist/StarknetBlock.js +52 -0
- package/dist/StarknetBlock.js.map +1 -0
- package/dist/StarknetEvent.d.ts +34 -0
- package/dist/StarknetEvent.d.ts.map +1 -0
- package/dist/StarknetEvent.js +39 -0
- package/dist/StarknetEvent.js.map +1 -0
- package/dist/StarknetIndexer.d.ts +157 -0
- package/dist/StarknetIndexer.d.ts.map +1 -0
- package/dist/StarknetIndexer.js +245 -0
- package/dist/StarknetIndexer.js.map +1 -0
- package/dist/StarknetNetwork.d.ts +72 -0
- package/dist/StarknetNetwork.d.ts.map +1 -0
- package/dist/StarknetNetwork.js +83 -0
- package/dist/StarknetNetwork.js.map +1 -0
- package/dist/StarknetRelayer.d.ts +273 -0
- package/dist/StarknetRelayer.d.ts.map +1 -0
- package/dist/StarknetRelayer.js +352 -0
- package/dist/StarknetRelayer.js.map +1 -0
- package/dist/StarknetRpc.d.ts +306 -0
- package/dist/StarknetRpc.d.ts.map +1 -0
- package/dist/StarknetRpc.js +281 -0
- package/dist/StarknetRpc.js.map +1 -0
- package/dist/StarknetSigner.d.ts +75 -0
- package/dist/StarknetSigner.d.ts.map +1 -0
- package/dist/StarknetSigner.js +84 -0
- package/dist/StarknetSigner.js.map +1 -0
- package/dist/StarknetTransaction.d.ts +74 -0
- package/dist/StarknetTransaction.d.ts.map +1 -0
- package/dist/StarknetTransaction.js +2 -0
- package/dist/StarknetTransaction.js.map +1 -0
- package/dist/StarknetTransactionHash.d.ts +22 -0
- package/dist/StarknetTransactionHash.d.ts.map +1 -0
- package/dist/StarknetTransactionHash.js +22 -0
- package/dist/StarknetTransactionHash.js.map +1 -0
- package/dist/index.d.ts +44 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +45 -0
- package/dist/index.js.map +1 -0
- package/dist/internal/PaddedFelt.d.ts +2 -0
- package/dist/internal/PaddedFelt.d.ts.map +1 -0
- package/dist/internal/PaddedFelt.js +15 -0
- package/dist/internal/PaddedFelt.js.map +1 -0
- package/dist/internal/confirmations.d.ts +2 -0
- package/dist/internal/confirmations.d.ts.map +1 -0
- package/dist/internal/confirmations.js +13 -0
- package/dist/internal/confirmations.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 +225 -0
- package/dist/internal/rpcMethods.js.map +1 -0
- package/dist/internal/transactionHash.d.ts +2 -0
- package/dist/internal/transactionHash.d.ts.map +1 -0
- package/dist/internal/transactionHash.js +60 -0
- package/dist/internal/transactionHash.js.map +1 -0
- package/package.json +66 -3
- package/src/StarknetAddress.ts +42 -0
- package/src/StarknetBlock.ts +54 -0
- package/src/StarknetEvent.ts +45 -0
- package/src/StarknetIndexer.ts +363 -0
- package/src/StarknetNetwork.ts +107 -0
- package/src/StarknetRelayer.ts +437 -0
- package/src/StarknetRpc.ts +524 -0
- package/src/StarknetSigner.ts +115 -0
- package/src/StarknetTransaction.ts +68 -0
- package/src/StarknetTransactionHash.ts +31 -0
- package/src/index.ts +55 -0
- package/src/internal/PaddedFelt.ts +18 -0
- package/src/internal/confirmations.ts +17 -0
- package/src/internal/rpcMethods.ts +224 -0
- 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 @@
|
|
|
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":[]}
|
package/dist/index.d.ts
ADDED
|
@@ -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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
1
|
+
{"version":3,"file":"rpcMethods.d.ts","sourceRoot":"","sources":["../../src/internal/rpcMethods.ts"],"names":[],"mappings":""}
|