starknet 4.6.0 → 4.8.0

package/src/utils/responseParser/sequencer.ts

@@ -19,12 +19,9 @@ import { ResponseParser } from '.';
 export class SequencerAPIResponseParser extends ResponseParser {
   public parseGetBlockResponse(res: Sequencer.GetBlockResponse): GetBlockResponse {
     return {
-      timestamp: res.timestamp,
-      block_hash: res.block_hash,
-      block_number: res.block_number,
+      ...res,
       new_root: res.state_root,
       parent_hash: res.parent_block_hash,
-      status: res.status,
       transactions: Object.values(res.transactions)
         .map((value) => 'transaction_hash' in value && value.transaction_hash)
         .filter(Boolean) as Array<string>,
@@ -62,12 +59,20 @@ export class SequencerAPIResponseParser extends ResponseParser {
   ): GetTransactionReceiptResponse {
     return {
       transaction_hash: res.transaction_hash,
-      actual_fee: 'actual_fee' in res ? res.actual_fee : undefined,
       status: res.status,
-      status_data: undefined,
       messages_sent: res.l2_to_l1_messages as any, // TODO: parse
       events: res.events as any,
-      l1_origin_message: undefined,
+      ...('block_hash' in res && { block_hash: res.block_hash }),
+      ...('block_number' in res && { block_number: res.block_number }),
+      ...('actual_fee' in res && { actual_fee: res.actual_fee }),
+      ...('transaction_index' in res && { transaction_index: res.transaction_index }),
+      ...('execution_resources' in res && { execution_resources: res.execution_resources }),
+      ...('l1_to_l2_consumed_message' in res && {
+        l1_to_l2_consumed_message: res['l1_to_l2_consumed_message'],
+      }),
+      ...('transaction_failure_reason' in res && {
+        transaction_failure_reason: res.transaction_failure_reason,
+      }),
     };
   }
 

package/types/api/openrpc.d.ts

@@ -7,26 +7,14 @@
  *
  * TypeScript Representation of OpenRpc protocol types
  */
-/**
- * "type": "string",
- * "title": "Field element",
- * "$comment": "A field element, represented as a string of hex digits",
- * "description": "A field element. Represented as up to 63 hex digits and leading 4 bits zeroed.",
- * "pattern": "^0x0[a-fA-F0-9]{1,63}$"
- */
 export declare type FELT = string;
 export declare type ADDRESS = FELT;
-/**
- * "title": "An integer number in hex format (0x...)",
- * "pattern": "^0x[a-fA-F0-9]+$"
- */
 declare type NUM_AS_HEX = string;
 declare type SIGNATURE = Array<FELT>;
 declare type ETH_ADDRESS = string;
 declare type BLOCK_NUMBER = number;
 declare type BLOCK_HASH = FELT;
 declare type TXN_HASH = FELT;
-declare type CHAIN_ID = string;
 declare type PROTOCOL_VERSION = string;
 declare type TXN_STATUS = 'PENDING' | 'ACCEPTED_ON_L2' | 'ACCEPTED_ON_L1' | 'REJECTED';
 declare type TXN_TYPE = 'DECLARE' | 'DEPLOY' | 'INVOKE' | 'L1_HANDLER';
@@ -96,17 +84,17 @@ declare type PENDING_BLOCK_WITH_TX_HASHES = BLOCK_BODY_WITH_TX_HASHES & {
     parent_hash: BLOCK_HASH;
 };
 declare type COMMON_TXN_PROPERTIES = {
-    transaction_hash: TXN_HASH;
+    transaction_hash?: TXN_HASH;
     max_fee: FELT;
     version: NUM_AS_HEX;
     signature: SIGNATURE;
-    nonce: FELT;
-    type: TXN_TYPE;
+    nonce?: FELT;
+    type?: TXN_TYPE;
 };
 declare type FUNCTION_CALL = {
-    contract_address: ADDRESS;
-    entry_point_selector: FELT;
-    calldata: Array<FELT>;
+    contract_address?: ADDRESS;
+    entry_point_selector?: FELT;
+    calldata?: Array<FELT>;
 };
 declare type INVOKE_TXN = COMMON_TXN_PROPERTIES & FUNCTION_CALL;
 declare type DECLARE_TXN = COMMON_TXN_PROPERTIES & {
@@ -228,6 +216,7 @@ declare type TRACE_ROOT = {
     function_invocation: FUNCTION_INVOCATION;
 };
 export declare namespace OPENRPC {
+    type Nonce = FELT;
     type BlockWithTxHashes = BLOCK_WITH_TX_HASHES | PENDING_BLOCK_WITH_TX_HASHES;
     type BlockWithTxs = BLOCK_WITH_TXS | PENDING_BLOCK_WITH_TXS;
     type StateUpdate = STATE_UPDATE;
@@ -242,7 +231,7 @@ export declare namespace OPENRPC {
         block_hash: BLOCK_HASH;
         block_number: BLOCK_NUMBER;
     };
-    type ChainId = CHAIN_ID;
+    type CHAIN_ID = string;
     type PendingTransactions = Array<TXN>;
     type ProtocolVersion = PROTOCOL_VERSION;
     type SyncingStatus = false | SYNC_STATUS;
@@ -251,7 +240,6 @@ export declare namespace OPENRPC {
         page_number: number;
         is_last_page: boolean;
     };
-    type Nonce = FELT;
     type Trace = TRACE_ROOT;
     type Traces = Array<{
         transaction_hash: FELT;
@@ -259,7 +247,7 @@ export declare namespace OPENRPC {
     }>;
     type TransactionHash = TXN_HASH;
     type BlockHash = BLOCK_HASH;
-    type EventFilter = EVENT_FILTER;
+    type EventFilter = EVENT_FILTER & RESULT_PAGE_REQUEST;
     type InvokedTransaction = {
         transaction_hash: TXN_HASH;
     };
@@ -371,36 +359,38 @@ export declare namespace OPENRPC {
             errors: Errors.CONTRACT_NOT_FOUND | Errors.INVALID_MESSAGE_SELECTOR | Errors.INVALID_CALL_DATA | Errors.CONTRACT_ERROR | Errors.INVALID_BLOCK_ID;
         };
         starknet_blockNumber: {
+            params: {};
             result: BLOCK_NUMBER;
             errors: Errors.NO_BLOCKS;
         };
         starknet_blockHashAndNumber: {
+            params: {};
             result: BLOCK_HASH & BLOCK_NUMBER;
             errors: Errors.NO_BLOCKS;
         };
         starknet_chainId: {
+            params: {};
             result: CHAIN_ID;
         };
         starknet_pendingTransactions: {
+            params: {};
             result: PendingTransactions;
         };
         starknet_syncing: {
+            params: {};
             result: SyncingStatus;
         };
         starknet_getEvents: {
             params: {
                 filter: EVENT_FILTER & RESULT_PAGE_REQUEST;
             };
-            result: {
-                events: EMITTED_EVENT;
-                page_number: number;
-                is_last_page: boolean;
-            };
+            result: Events;
             errors: Errors.PAGE_SIZE_TOO_BIG;
         };
         starknet_getNonce: {
             params: {
                 contract_address: ADDRESS;
+                block_id: BLOCK_ID;
             };
             result: FELT;
             errors: Errors.CONTRACT_NOT_FOUND;
@@ -425,7 +415,7 @@ export declare namespace OPENRPC {
         starknet_addDeployTransaction: {
             params: {
                 contract_address_salt: FELT;
-                constructor_calldata: FELT;
+                constructor_calldata: Array<FELT>;
                 contract_definition: CONTRACT_CLASS;
             };
             result: DeployedTransaction;

package/types/api/rpc.d.ts

@@ -9,9 +9,11 @@ export declare namespace RPC {
             message: string;
         };
     };
-    type ChainId = OPENRPC.ChainId;
+    type ChainId = OPENRPC.CHAIN_ID;
+    type CallResponse = OPENRPC.CallResponse;
     type ContractAddress = ADDRESS;
     type Felt = FELT;
+    type Nonce = OPENRPC.Nonce;
     type ContractClass = OPENRPC.ContractClass;
     type StateUpdate = OPENRPC.StateUpdate;
     type Transaction = OPENRPC.Transaction;
@@ -37,131 +39,5 @@ export declare namespace RPC {
     type InvokedTransaction = OPENRPC.InvokedTransaction;
     type DeclaredTransaction = OPENRPC.DeclaredTransaction;
     type DeployedTransaction = OPENRPC.DeployedTransaction;
-    type Methods = {
-        starknet_pendingTransactions: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: PendingTransactions;
-        };
-        starknet_blockHashAndNumber: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: BlockHashAndNumber;
-        };
-        starknet_getClassHashAt: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: Felt;
-        };
-        starknet_getStateUpdate: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.StateUpdate;
-        };
-        starknet_getClass: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.ContractClass;
-        };
-        starknet_getBlockWithTxHashes: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetBlockWithTxHashesResponse;
-        };
-        starknet_getBlockWithTxs: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetBlockWithTxs;
-        };
-        starknet_getNonce: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.Nonce;
-        };
-        starknet_getStorageAt: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetStorageAtResponse;
-        };
-        starknet_getTransactionByHash: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetTransactionByHashResponse;
-        };
-        starknet_getTransactionByBlockIdAndIndex: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetTransactionByBlockIdAndIndex;
-        };
-        starknet_getTransactionReceipt: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: TransactionReceipt;
-        };
-        starknet_getBlockTransactionCount: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetTransactionCountResponse;
-        };
-        starknet_call: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: string[];
-        };
-        starknet_estimateFee: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.EstimatedFee;
-        };
-        starknet_blockNumber: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetBlockNumberResponse;
-        };
-        starknet_chainId: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.ChainId;
-        };
-        starknet_syncing: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetSyncingStatsResponse;
-        };
-        starknet_getEvents: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetEventsResponse;
-        };
-        starknet_addInvokeTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.InvokedTransaction;
-        };
-        starknet_addDeployTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.DeployedTransaction;
-        };
-        starknet_addDeclareTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: OPENRPC.DeclaredTransaction;
-        };
-        starknet_getClassAt: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: any;
-        };
-        starknet_traceTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: any;
-        };
-        starknet_traceBlockTransactions: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: any;
-        };
-    };
+    type Methods = OPENRPC.Methods;
 }

package/types/api/sequencer.d.ts

@@ -15,15 +15,17 @@ export declare type GetContractAddressesResponse = {
     Starknet: string;
     GpsStatementVerifier: string;
 };
-export declare type InvokeFunctionTrace = {
+export declare type FunctionInvocation = {
     caller_address: string;
     contract_address: string;
-    code_address: string;
-    selector: string;
     calldata: RawCalldata;
+    call_type?: string;
+    class_hash?: string;
+    selector?: string;
+    entry_point_type?: EntryPointType;
     result: Array<any>;
     execution_resources: ExecutionResources;
-    internal_call: Array<InvokeFunctionTrace>;
+    internal_calls: Array<FunctionInvocation>;
     events: Array<any>;
     messages: Array<any>;
 };
@@ -40,18 +42,9 @@ export declare type ExecutionResources = {
     n_memory_holes: number;
 };
 export declare type GetTransactionTraceResponse = {
-    function_invocation: {
-        caller_address: string;
-        contract_address: string;
-        code_address: string;
-        selector: string;
-        calldata: RawArgs;
-        result: Array<any>;
-        execution_resources: ExecutionResources;
-        internal_call: Array<any>;
-        events: Array<any>;
-        messages: Array<any>;
-    };
+    validate_invocation?: FunctionInvocation;
+    function_invocation?: FunctionInvocation;
+    fee_transfer_invocation?: FunctionInvocation;
     signature: Signature;
 };
 export declare type RawArgs = {
@@ -60,6 +53,12 @@ export declare type RawArgs = {
         [k: string]: BigNumberish;
     };
 };
+export declare type CallL1Handler = {
+    from_address: string;
+    to_address: string;
+    entry_point_selector: string;
+    payload: Array<string>;
+};
 export declare namespace Sequencer {
     type DeclareTransaction = {
         type: 'DECLARE';
@@ -80,9 +79,8 @@ export declare namespace Sequencer {
         contract_address: string;
         signature?: Signature;
         entry_point_type?: EntryPointType;
-        entry_point_selector: string;
         calldata?: RawCalldata;
-        nonce?: BigNumberish;
+        nonce: BigNumberish;
         max_fee?: BigNumberish;
         version?: BigNumberish;
     };
@@ -99,6 +97,7 @@ export declare namespace Sequencer {
     };
     interface InvokeFunctionTransactionResponse extends InvokeFunctionTransaction {
         transaction_hash: string;
+        entry_point_selector: string;
     }
     type TransactionResponse = DeclareTransaction | DeployTransaction | InvokeFunctionTransactionResponse;
     type SuccessfulTransactionResponse = {
@@ -165,11 +164,15 @@ export declare namespace Sequencer {
         status: Status;
         gas_price: string;
         sequencer_address: string;
+        starknet_version: string;
+    };
+    type CallContractTransaction = Omit<InvokeFunctionTransaction, 'type' | 'entry_point_type' | 'nonce'> & {
+        entry_point_selector: string;
     };
-    type CallContractTransaction = Omit<InvokeFunctionTransaction, 'type' | 'entry_point_type' | 'nonce'>;
     type CallContractResponse = {
         result: string[];
     };
+    type EstimateFeeTransaction = Omit<InvokeFunctionTransaction, 'max_fee' | 'entry_point_type'>;
     type EstimateFeeResponse = {
         overall_fee: number;
         gas_price: number;
@@ -217,6 +220,14 @@ export declare namespace Sequencer {
             REQUEST: never;
             RESPONSE: TransactionReceiptResponse;
         };
+        get_nonce: {
+            QUERY: {
+                contractAddress: string;
+                blockIdentifier: BlockIdentifier;
+            };
+            REQUEST: never;
+            RESPONSE: BigNumberish;
+        };
         get_storage_at: {
             QUERY: {
                 contractAddress: string;
@@ -252,7 +263,7 @@ export declare namespace Sequencer {
             QUERY: {
                 blockIdentifier: BlockIdentifier;
             };
-            REQUEST: CallContractTransaction;
+            REQUEST: EstimateFeeTransaction;
             RESPONSE: EstimateFeeResponse;
         };
         get_class_by_hash: {
@@ -285,5 +296,10 @@ export declare namespace Sequencer {
             REQUEST: never;
             RESPONSE: any;
         };
+        estimate_message_fee: {
+            QUERY: any;
+            REQUEST: any;
+            RESPONSE: EstimateFeeResponse;
+        };
     };
 }

package/types/lib.d.ts

@@ -6,24 +6,30 @@ export declare type RawCalldata = BigNumberish[];
 export declare type DeployContractPayload = {
     contract: CompiledContract | string;
     constructorCalldata?: RawCalldata;
-    addressSalt?: BigNumberish;
+    addressSalt?: string;
 };
 export declare type DeclareContractPayload = {
     contract: CompiledContract | string;
     version?: BigNumberish;
 };
-export declare type Invocation = {
+export declare type CallDetails = {
     contractAddress: string;
-    entrypoint: string;
     calldata?: RawCalldata;
+};
+export declare type Invocation = CallDetails & {
     signature?: Signature;
 };
-export declare type Call = Omit<Invocation, 'signature'>;
+export declare type Call = CallDetails & {
+    entrypoint: string;
+};
 export declare type InvocationsDetails = {
     nonce?: BigNumberish;
     maxFee?: BigNumberish;
     version?: BigNumberish;
 };
+export declare type InvocationsDetailsWithNonce = InvocationsDetails & {
+    nonce: BigNumberish;
+};
 export declare type Status = 'NOT_RECEIVED' | 'RECEIVED' | 'PENDING' | 'ACCEPTED_ON_L2' | 'ACCEPTED_ON_L1' | 'REJECTED';
 export declare type TransactionStatus = 'TRANSACTION_RECEIVED';
 export declare type Type = 'DECLARE' | 'DEPLOY' | 'INVOKE_FUNCTION';

package/types/provider.d.ts

@@ -3,7 +3,8 @@
  * Intersection (sequencer response ∩ (∪ rpc responses))
  */
 import BN from 'bn.js';
-import { Abi, CompressedProgram, EntryPointsByType, RawCalldata, Signature, Status } from './lib';
+import { RPC } from './api/rpc';
+import { Abi, CompressedProgram, RawCalldata, Signature, Status } from './lib';
 export interface GetBlockResponse {
     timestamp: number;
     block_hash: string;
@@ -12,6 +13,10 @@ export interface GetBlockResponse {
     parent_hash: string;
     status: Status;
     transactions: Array<string>;
+    gas_price?: string;
+    sequencer_address?: string;
+    starknet_version?: string;
+    transaction_receipts?: any;
 }
 export interface GetCodeResponse {
     bytecode: string[];
@@ -35,7 +40,7 @@ export interface ContractEntryPoint {
 }
 export interface ContractClass {
     program: CompressedProgram;
-    entry_points_by_type: EntryPointsByType;
+    entry_points_by_type: RPC.ContractClass['entry_points_by_type'];
     abi?: Abi;
 }
 export interface DeclareTransactionResponse extends CommonTransactionResponse {

package/utils/hash.d.ts

@@ -2,7 +2,7 @@ import BN from 'bn.js';
 import { StarknetChainId, TransactionHashPrefix } from '../constants';
 import { RawCalldata } from '../types/lib';
 import { BigNumberish } from './number';
-export declare const transactionVersion = 0;
+export declare const transactionVersion = 1;
 export declare const feeTransactionVersion: BN;
 export declare function keccakBn(value: BigNumberish): string;
 /**
@@ -21,9 +21,15 @@ export declare function starknetKeccak(value: string): BN;
  * @returns hex selector of given abi function name
  */
 export declare function getSelectorFromName(funcName: string): string;
+/**
+ * Function to get hex selector from function name, decimal string or hex string
+ * @param value hex string | decimal string | string
+ * @returns Hex selector
+ */
+export declare function getSelector(value: string): string;
 export declare function pedersen(input: [BigNumberish, BigNumberish]): string;
 export declare function computeHashOnElements(data: BigNumberish[]): string;
 export declare function calculateTransactionHashCommon(txHashPrefix: TransactionHashPrefix, version: BigNumberish, contractAddress: BigNumberish, entryPointSelector: BigNumberish, calldata: BigNumberish[], maxFee: BigNumberish, chainId: StarknetChainId, additionalData?: BigNumberish[]): string;
 export declare function calculateDeployTransactionHash(contractAddress: BigNumberish, constructorCalldata: BigNumberish[], version: BigNumberish, chainId: StarknetChainId): string;
-export declare function calculcateTransactionHash(contractAddress: BigNumberish, version: BigNumberish, entryPointSelector: BigNumberish, calldata: BigNumberish[], maxFee: BigNumberish, chainId: StarknetChainId): string;
+export declare function calculateTransactionHash(contractAddress: BigNumberish, version: BigNumberish, calldata: BigNumberish[], maxFee: BigNumberish, chainId: StarknetChainId, nonce: BigNumberish): string;
 export declare function calculateContractAddressFromHash(salt: BigNumberish, classHash: BigNumberish, constructorCalldata: RawCalldata, deployerAddress: BigNumberish): string;

package/utils/hash.js

@@ -28,7 +28,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateContractAddressFromHash = exports.calculcateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelectorFromName = exports.starknetKeccak = exports.keccakBn = exports.feeTransactionVersion = exports.transactionVersion = void 0;
+exports.calculateContractAddressFromHash = exports.calculateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelector = exports.getSelectorFromName = exports.starknetKeccak = exports.keccakBn = exports.feeTransactionVersion = exports.transactionVersion = void 0;
 var keccak_1 = require("ethereum-cryptography/keccak");
 var utils_1 = require("ethereum-cryptography/utils");
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
@@ -36,7 +36,7 @@ var constants_1 = require("../constants");
 var ellipticCurve_1 = require("./ellipticCurve");
 var encode_1 = require("./encode");
 var number_1 = require("./number");
-exports.transactionVersion = 0;
+exports.transactionVersion = 1;
 exports.feeTransactionVersion = (0, number_1.toBN)(2).pow((0, number_1.toBN)(128)).add((0, number_1.toBN)(exports.transactionVersion));
 function keccakBn(value) {
     var hexWithoutPrefix = (0, encode_1.removeHexPrefix)((0, number_1.toHex)((0, number_1.toBN)(value)));
@@ -70,6 +70,21 @@ function getSelectorFromName(funcName) {
     return (0, number_1.toHex)(starknetKeccak(funcName));
 }
 exports.getSelectorFromName = getSelectorFromName;
+/**
+ * Function to get hex selector from function name, decimal string or hex string
+ * @param value hex string | decimal string | string
+ * @returns Hex selector
+ */
+function getSelector(value) {
+    if ((0, number_1.isHex)(value)) {
+        return value;
+    }
+    if ((0, number_1.isStringWholeNumber)(value)) {
+        return (0, number_1.toHexString)(value);
+    }
+    return getSelectorFromName(value);
+}
+exports.getSelector = getSelector;
 var constantPoints = constants_1.CONSTANT_POINTS.map(function (coords) {
     return ellipticCurve_1.ec.curve.point(coords[0], coords[1]);
 });
@@ -117,10 +132,10 @@ function calculateDeployTransactionHash(contractAddress, constructorCalldata, ve
     return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.DEPLOY, version, contractAddress, getSelectorFromName('constructor'), constructorCalldata, constants_1.ZERO, chainId);
 }
 exports.calculateDeployTransactionHash = calculateDeployTransactionHash;
-function calculcateTransactionHash(contractAddress, version, entryPointSelector, calldata, maxFee, chainId) {
-    return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.INVOKE, version, contractAddress, entryPointSelector, calldata, maxFee, chainId);
+function calculateTransactionHash(contractAddress, version, calldata, maxFee, chainId, nonce) {
+    return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.INVOKE, version, contractAddress, 0, calldata, maxFee, chainId, [nonce]);
 }
-exports.calculcateTransactionHash = calculcateTransactionHash;
+exports.calculateTransactionHash = calculateTransactionHash;
 function calculateContractAddressFromHash(salt, classHash, constructorCalldata, deployerAddress) {
     var constructorCalldataHash = computeHashOnElements(constructorCalldata);
     var CONTRACT_ADDRESS_PREFIX = (0, number_1.toFelt)('0x535441524b4e45545f434f4e54524143545f41444452455353'); // Equivalent to 'STARKNET_CONTRACT_ADDRESS'

package/utils/merkle.js

@@ -27,6 +27,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.proofMerklePath = exports.MerkleTree = void 0;
 var hash_1 = require("./hash");
+var number_1 = require("./number");
 var MerkleTree = /** @class */ (function () {
     function MerkleTree(leafHashes) {
         this.branches = [];
@@ -52,7 +53,7 @@ var MerkleTree = /** @class */ (function () {
         return this.build(newLeaves);
     };
     MerkleTree.hash = function (a, b) {
-        var _a = __read([a, b].sort(), 2), aSorted = _a[0], bSorted = _a[1];
+        var _a = __read([(0, number_1.toBN)(a), (0, number_1.toBN)(b)].sort(function (x, y) { return (x.gte(y) ? 1 : -1); }), 2), aSorted = _a[0], bSorted = _a[1];
         return (0, hash_1.pedersen)([aSorted, bSorted]);
     };
     MerkleTree.prototype.getProof = function (leaf, branch, hashPath) {

package/utils/number.d.ts

@@ -8,3 +8,8 @@ export declare function toFelt(num: BigNumberish): string;
 export declare function assertInRange(input: BigNumberish, lowerBound: BigNumberish, upperBound: BigNumberish, inputName?: string): void;
 export declare function bigNumberishArrayToDecimalStringArray(rawCalldata: BigNumberish[]): string[];
 export declare function bigNumberishArrayToHexadecimalStringArray(rawCalldata: BigNumberish[]): string[];
+export declare const isStringWholeNumber: (value: string) => boolean;
+export declare const toHexString: (value: string) => string;
+export declare function getDecimalString(value: string): string;
+export declare function getHexString(value: string): string;
+export declare function getHexStringArray(value: Array<string>): string[];

package/utils/number.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bigNumberishArrayToHexadecimalStringArray = exports.bigNumberishArrayToDecimalStringArray = exports.assertInRange = exports.toFelt = exports.hexToDecimalString = exports.toHex = exports.toBN = exports.isHex = void 0;
+exports.getHexStringArray = exports.getHexString = exports.getDecimalString = exports.toHexString = exports.isStringWholeNumber = exports.bigNumberishArrayToHexadecimalStringArray = exports.bigNumberishArrayToDecimalStringArray = exports.assertInRange = exports.toFelt = exports.hexToDecimalString = exports.toHex = exports.toBN = exports.isHex = void 0;
 var bn_js_1 = __importStar(require("bn.js"));
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
 var encode_1 = require("./encode");
@@ -80,3 +80,31 @@ function bigNumberishArrayToHexadecimalStringArray(rawCalldata) {
     return rawCalldata.map(function (x) { return toHex(toBN(x)); });
 }
 exports.bigNumberishArrayToHexadecimalStringArray = bigNumberishArrayToHexadecimalStringArray;
+var isStringWholeNumber = function (value) { return /^\d+$/.test(value); };
+exports.isStringWholeNumber = isStringWholeNumber;
+var toHexString = function (value) { return toHex(toBN(value)); };
+exports.toHexString = toHexString;
+function getDecimalString(value) {
+    if (isHex(value)) {
+        return hexToDecimalString(value);
+    }
+    if ((0, exports.isStringWholeNumber)(value)) {
+        return value;
+    }
+    throw new Error("".concat(value, " need to be hex-string or whole-number-string"));
+}
+exports.getDecimalString = getDecimalString;
+function getHexString(value) {
+    if (isHex(value)) {
+        return value;
+    }
+    if ((0, exports.isStringWholeNumber)(value)) {
+        return (0, exports.toHexString)(value);
+    }
+    throw new Error("".concat(value, " need to be hex-string or whole-number-string"));
+}
+exports.getHexString = getHexString;
+function getHexStringArray(value) {
+    return value.map(function (el) { return getHexString(el); });
+}
+exports.getHexStringArray = getHexStringArray;