starknet 4.5.0 → 4.7.0

package/dist/types/api/rpc.d.ts

@@ -1,200 +1,43 @@
-import { StarknetChainId } from '../../constants';
-import { BlockIdentifier } from '../../provider/utils';
-import { Status } from '../lib';
-import { OPENRPC } from './openrpc';
+import { ADDRESS, FELT, OPENRPC } from './openrpc';
 export declare namespace RPC {
-    export type Response = {
+    type Response = {
         id: number;
-        result: any;
         jsonrpc: string;
+        result?: any;
         error?: {
             code: string;
             message: string;
         };
     };
-    export type AddTransactionResponse = {
-        transaction_hash: string;
-    };
-    export type GetClassResponse = {
-        program: string;
-        entry_point_by_type: any;
-    };
-    export type DeclareResponse = {
-        transaction_hash: string;
-        class_hash: string;
-    };
-    export type EstimateFeeResponse = {
-        overall_fee: number;
-        gas_consumed: number;
-        gas_price: number;
-    };
-    export type GetBlockWithTxHashesResponse = OPENRPC.GetBlockWithTxHashesResponse;
-    export type GetBlockWithTxs = OPENRPC.GetBlockWithTxs;
-    export type GetStorageAtResponse = OPENRPC.GetStorageAtResponse;
-    export type GetTransactionReceiptResponse = {
-        txn_hash: string;
-        actual_fee: string;
-        status: Status;
-        status_data: string;
-        messages_sent: Array<MessageToL1>;
-        l1_origin_message: MessageToL2;
-        events: Array<StarknetEvent>;
-    };
-    interface CommonTransactionProperties {
-        txn_hash: string;
-        max_fee: string;
-        version: string;
-        nonce: string;
-        signature: Array<string>;
-    }
-    export interface InvokeTransactionResponse extends CommonTransactionProperties {
-        contract_address?: string;
-        entry_point_selector?: string;
-        calldata?: Array<string>;
-    }
-    export interface DeclareTransactionResponse extends CommonTransactionProperties {
-        contract_class?: GetClassResponse;
-        sender_address?: string;
-    }
-    export type GetTransactionByHashResponse = OPENRPC.GetTransactionByHashResponse;
-    export type GetTransactionByBlockIdAndIndex = OPENRPC.GetTransactionByBlockIdAndIndex;
-    export type GetTransactionCountResponse = number;
-    export type GetBlockNumberResponse = number;
-    export type GetSyncingStatsResponse = {
-        starting_block_hash: string;
-        starting_block_num: string;
-        current_block_hash: string;
-        current_block_num: string;
-        highest_block_hash: string;
-        highest_block_num: string;
-    } | boolean;
-    export type EventFilter = {
-        fromBlock: BlockIdentifier;
-        toBlock: BlockIdentifier;
-        address: string;
-        keys: string[];
-        page_size: number;
-        page_number: number;
-    };
-    export type GetEventsResponse = {
-        events: StarknetEmittedEvent[];
-        page_number: number;
-        is_last_page: number;
-    };
-    export type DeployContractResponse = {
-        transaction_hash: string;
-        contract_address: string;
-    };
-    export type StarknetEvent = {
-        from_address: string;
-        keys: string[];
-        data: string[];
-    };
-    export type StarknetEmittedEvent = {
-        event: StarknetEvent;
-        block_hash: string;
-        block_number: number;
-        transaction_hash: string;
-    };
-    export type MessageToL1 = {
-        to_address: string;
-        payload: string[];
-    };
-    export type MessageToL2 = {
-        from_address: string;
-        payload: string[];
-    };
-    export type Methods = {
-        starknet_getBlockWithTxHashes: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetBlockWithTxHashesResponse;
-        };
-        starknet_getBlockWithTxs: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetBlockWithTxs;
-        };
-        starknet_getNonce: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: string;
-        };
-        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: GetTransactionReceiptResponse;
-        };
-        starknet_getBlockTransactionCount: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetTransactionCountResponse;
-        };
-        starknet_call: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: string[];
-        };
-        starknet_estimateFee: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: EstimateFeeResponse;
-        };
-        starknet_blockNumber: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetBlockNumberResponse;
-        };
-        starknet_chainId: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: StarknetChainId;
-        };
-        starknet_syncing: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetSyncingStatsResponse;
-        };
-        starknet_getEvents: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: GetEventsResponse;
-        };
-        starknet_addInvokeTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: AddTransactionResponse;
-        };
-        starknet_addDeployTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: DeployContractResponse;
-        };
-        starknet_addDeclareTransaction: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: DeclareResponse;
-        };
-        starknet_getClassAt: {
-            QUERY: never;
-            REQUEST: any[];
-            RESPONSE: any;
-        };
-    };
-    export {};
+    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;
+    type PendingTransactions = OPENRPC.PendingTransactions;
+    type TransactionHash = OPENRPC.TransactionHash;
+    type Trace = OPENRPC.Trace;
+    type Traces = OPENRPC.Traces;
+    type BlockHash = OPENRPC.BlockHash;
+    type BlockHashAndNumber = OPENRPC.BlockHashAndNumber;
+    type GetClassResponse = OPENRPC.ContractClass;
+    type EstimateFeeResponse = OPENRPC.EstimatedFee;
+    type GetBlockWithTxHashesResponse = OPENRPC.BlockWithTxHashes;
+    type GetBlockWithTxs = OPENRPC.BlockWithTxs;
+    type GetStorageAtResponse = OPENRPC.Storage;
+    type TransactionReceipt = OPENRPC.TransactionReceipt;
+    type GetTransactionByHashResponse = OPENRPC.Transaction;
+    type GetTransactionByBlockIdAndIndex = OPENRPC.Transaction;
+    type GetTransactionCountResponse = number;
+    type GetBlockNumberResponse = OPENRPC.BlockNumber;
+    type GetSyncingStatsResponse = OPENRPC.SyncingStatus;
+    type EventFilter = OPENRPC.EventFilter;
+    type GetEventsResponse = OPENRPC.Events;
+    type InvokedTransaction = OPENRPC.InvokedTransaction;
+    type DeclaredTransaction = OPENRPC.DeclaredTransaction;
+    type DeployedTransaction = OPENRPC.DeployedTransaction;
+    type Methods = OPENRPC.Methods;
 }

package/dist/types/api/sequencer.d.ts

@@ -80,9 +80,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 +98,7 @@ export declare namespace Sequencer {
     };
     interface InvokeFunctionTransactionResponse extends InvokeFunctionTransaction {
         transaction_hash: string;
+        entry_point_selector: string;
     }
     type TransactionResponse = DeclareTransaction | DeployTransaction | InvokeFunctionTransactionResponse;
     type SuccessfulTransactionResponse = {
@@ -166,10 +166,13 @@ export declare namespace Sequencer {
         gas_price: string;
         sequencer_address: string;
     };
-    type CallContractTransaction = Omit<InvokeFunctionTransaction, 'type' | 'entry_point_type' | 'nonce'>;
+    type CallContractTransaction = Omit<InvokeFunctionTransaction, 'type' | 'entry_point_type' | 'nonce'> & {
+        entry_point_selector: string;
+    };
     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: {

package/dist/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/dist/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;
@@ -35,7 +36,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/dist/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;
 /**
@@ -25,5 +25,5 @@ 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/dist/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.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)));
@@ -117,10 +117,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/dist/utils/responseParser/rpc.d.ts

@@ -2,7 +2,7 @@
  * Map RPC Response to common interface response
  * Intersection (sequencer response ∩ (∪ rpc responses))
  */
-import { CallContractResponse, DeclareContractResponse, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse, InvokeFunctionResponse } from '../../types';
+import { CallContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse } from '../../types';
 import { RPC } from '../../types/api';
 import { ResponseParser } from '.';
 declare type RpcGetBlockResponse = RPC.GetBlockWithTxHashesResponse & {
@@ -11,14 +11,14 @@ declare type RpcGetBlockResponse = RPC.GetBlockWithTxHashesResponse & {
 declare type GetTransactionByHashResponse = RPC.GetTransactionByHashResponse & {
     [key: string]: any;
 };
-export declare class RPCResponseParser extends ResponseParser {
+declare type TransactionReceipt = RPC.TransactionReceipt & {
+    [key: string]: any;
+};
+export declare class RPCResponseParser implements Omit<ResponseParser, 'parseDeclareContractResponse' | 'parseDeployContractResponse' | 'parseInvokeFunctionResponse'> {
     parseGetBlockResponse(res: RpcGetBlockResponse): GetBlockResponse;
     parseGetTransactionResponse(res: GetTransactionByHashResponse): GetTransactionResponse;
-    parseGetTransactionReceiptResponse(res: RPC.GetTransactionReceiptResponse): GetTransactionReceiptResponse;
+    parseGetTransactionReceiptResponse(res: TransactionReceipt): GetTransactionReceiptResponse;
     parseFeeEstimateResponse(res: RPC.EstimateFeeResponse): EstimateFeeResponse;
     parseCallContractResponse(res: Array<string>): CallContractResponse;
-    parseInvokeFunctionResponse(res: RPC.AddTransactionResponse): InvokeFunctionResponse;
-    parseDeployContractResponse(res: RPC.DeployContractResponse): DeployContractResponse;
-    parseDeclareContractResponse(res: RPC.DeclareResponse): DeclareContractResponse;
 }
 export {};

package/dist/utils/responseParser/rpc.js

@@ -1,27 +1,9 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RPCResponseParser = void 0;
 var number_1 = require("../number");
-var _1 = require(".");
-var RPCResponseParser = /** @class */ (function (_super) {
-    __extends(RPCResponseParser, _super);
+var RPCResponseParser = /** @class */ (function () {
     function RPCResponseParser() {
-        return _super !== null && _super.apply(this, arguments) || this;
     }
     RPCResponseParser.prototype.parseGetBlockResponse = function (res) {
         return {
@@ -38,7 +20,6 @@ var RPCResponseParser = /** @class */ (function (_super) {
         return {
             calldata: res.calldata || [],
             contract_address: res.contract_address,
-            entry_point_selector: res.entry_point_selector,
             max_fee: res.max_fee,
             nonce: res.nonce,
             signature: res.signature || [],
@@ -48,7 +29,7 @@ var RPCResponseParser = /** @class */ (function (_super) {
     };
     RPCResponseParser.prototype.parseGetTransactionReceiptResponse = function (res) {
         return {
-            transaction_hash: res.txn_hash,
+            transaction_hash: res.transaction_hash,
             actual_fee: res.actual_fee,
             status: res.status,
             status_data: res.status_data,
@@ -69,23 +50,6 @@ var RPCResponseParser = /** @class */ (function (_super) {
             result: res,
         };
     };
-    RPCResponseParser.prototype.parseInvokeFunctionResponse = function (res) {
-        return {
-            transaction_hash: res.transaction_hash,
-        };
-    };
-    RPCResponseParser.prototype.parseDeployContractResponse = function (res) {
-        return {
-            transaction_hash: res.transaction_hash,
-            contract_address: res.contract_address,
-        };
-    };
-    RPCResponseParser.prototype.parseDeclareContractResponse = function (res) {
-        return {
-            transaction_hash: res.transaction_hash,
-            class_hash: res.class_hash,
-        };
-    };
     return RPCResponseParser;
-}(_1.ResponseParser));
+}());
 exports.RPCResponseParser = RPCResponseParser;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starknet",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "description": "JavaScript library for StarkNet",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/provider/default.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import { Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import { Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetailsWithNonce, InvokeFunctionResponse } from '../types';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { RpcProviderOptions } from './rpc';
@@ -16,12 +16,13 @@ export declare class Provider implements ProviderInterface {
     getChainId(): Promise<StarknetChainId>;
     getBlock(blockIdentifier?: BlockIdentifier): Promise<GetBlockResponse>;
     getClassAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<ContractClass>;
-    getEstimateFee(invocation: Invocation, blockIdentifier?: BlockIdentifier, invocationDetails?: InvocationsDetails): Promise<EstimateFeeResponse>;
+    getEstimateFee(invocation: Invocation, invocationDetails: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<EstimateFeeResponse>;
+    getNonce(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
     getStorageAt(contractAddress: string, key: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
     getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
     getTransactionReceipt(txHash: BigNumberish): Promise<GetTransactionReceiptResponse>;
     callContract(request: Call, blockIdentifier?: BlockIdentifier): Promise<CallContractResponse>;
-    invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    invokeFunction(functionInvocation: Invocation, details: InvocationsDetailsWithNonce): Promise<InvokeFunctionResponse>;
     deployContract(payload: DeployContractPayload): Promise<DeployContractResponse>;
     declareContract(payload: DeclareContractPayload): Promise<DeclareContractResponse>;
     getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;

package/provider/default.js

@@ -84,12 +84,18 @@ var Provider = /** @class */ (function () {
             });
         });
     };
-    Provider.prototype.getEstimateFee = function (invocation, blockIdentifier, invocationDetails) {
+    Provider.prototype.getEstimateFee = function (invocation, invocationDetails, blockIdentifier) {
         if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
-        if (invocationDetails === void 0) { invocationDetails = {}; }
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                return [2 /*return*/, this.provider.getEstimateFee(invocation, blockIdentifier, invocationDetails)];
+                return [2 /*return*/, this.provider.getEstimateFee(invocation, invocationDetails, blockIdentifier)];
+            });
+        });
+    };
+    Provider.prototype.getNonce = function (contractAddress, blockIdentifier) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.provider.getNonce(contractAddress, blockIdentifier)];
             });
         });
     };

package/provider/interface.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import type { Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import type { Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetailsWithNonce, InvokeFunctionResponse } from '../types';
 import type { BigNumberish } from '../utils/number';
 import { BlockIdentifier } from './utils';
 export declare abstract class ProviderInterface {
@@ -37,6 +37,13 @@ export declare abstract class ProviderInterface {
      * @returns Contract class of compiled contract
      */
     abstract getClassAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<ContractClass>;
+    /**
+     * Gets the nonce of a contract with respect to a specific block
+     *
+     * @param contractAddress - contract address
+     * @returns the hex nonce
+     */
+    abstract getNonce(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
     /**
      * Gets the contract's storage variable at a specific key.
      *
@@ -94,7 +101,7 @@ export declare abstract class ProviderInterface {
      * - maxFee - optional maxFee
      * @returns response from addTransaction
      */
-    abstract invokeFunction(invocation: Invocation, details?: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    abstract invokeFunction(invocation: Invocation, details: InvocationsDetailsWithNonce): Promise<InvokeFunctionResponse>;
     /**
      * Estimates the fee for a given transaction
      *
@@ -109,7 +116,7 @@ export declare abstract class ProviderInterface {
      * - version - optional version
      * @returns the estimated fee
      */
-    abstract getEstimateFee(invocation: Invocation, blockIdentifier: BlockIdentifier, details?: InvocationsDetails): Promise<EstimateFeeResponse>;
+    abstract getEstimateFee(invocation: Invocation, details: InvocationsDetailsWithNonce, blockIdentifier: BlockIdentifier): Promise<EstimateFeeResponse>;
     /**
      * Wait for the transaction to be accepted
      * @param txHash - transaction hash

package/provider/rpc.d.ts

@@ -1,36 +1,48 @@
 import { StarknetChainId } from '../constants';
-import { Call, CallContractResponse, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
+import { Call, CallContractResponse, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetailsWithNonce, InvokeFunctionResponse } from '../types';
 import { RPC } from '../types/api';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { BlockIdentifier } from './utils';
 export declare type RpcProviderOptions = {
     nodeUrl: string;
+    retries?: number;
 };
 export declare class RpcProvider implements ProviderInterface {
     nodeUrl: string;
     chainId: StarknetChainId;
     private responseParser;
+    private retries;
     constructor(optionsOrProvider: RpcProviderOptions);
-    protected fetchEndpoint<T extends keyof RPC.Methods>(method: T, request?: RPC.Methods[T]['REQUEST']): Promise<RPC.Methods[T]['RESPONSE']>;
-    getChainId(): Promise<StarknetChainId>;
+    fetch(method: any, params: any): Promise<any>;
+    protected errorHandler(error: any): void;
+    protected fetchEndpoint<T extends keyof RPC.Methods>(method: T, params?: RPC.Methods[T]['params']): Promise<RPC.Methods[T]['result']>;
+    getChainId(): Promise<any>;
     getBlock(blockIdentifier?: BlockIdentifier): Promise<GetBlockResponse>;
+    getBlockHashAndNumber(): Promise<RPC.BlockHashAndNumber>;
     getBlockWithTxHashes(blockIdentifier?: BlockIdentifier): Promise<RPC.GetBlockWithTxHashesResponse>;
     getBlockWithTxs(blockIdentifier?: BlockIdentifier): Promise<RPC.GetBlockWithTxs>;
-    getNonce(contractAddress: string): Promise<any>;
+    getClassHashAt(blockIdentifier: BlockIdentifier, contractAddress: RPC.ContractAddress): Promise<RPC.Felt>;
+    getNonce(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<RPC.Nonce>;
+    getPendingTransactions(): Promise<RPC.PendingTransactions>;
+    getProtocolVersion(): Promise<Error>;
+    getStateUpdate(blockIdentifier: BlockIdentifier): Promise<RPC.StateUpdate>;
     getStorageAt(contractAddress: string, key: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
-    getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
-    getTransactionByHash(txHash: BigNumberish): Promise<RPC.GetTransactionByHashResponse>;
+    getTransaction(txHash: string): Promise<GetTransactionResponse>;
+    getTransactionByHash(txHash: string): Promise<RPC.GetTransactionByHashResponse>;
     getTransactionByBlockIdAndIndex(blockIdentifier: BlockIdentifier, index: number): Promise<RPC.GetTransactionByBlockIdAndIndex>;
-    getTransactionReceipt(txHash: BigNumberish): Promise<GetTransactionReceiptResponse>;
-    getClassAt(contractAddress: string, blockIdentifier: BlockIdentifier): Promise<any>;
-    getEstimateFee(invocation: Invocation, blockIdentifier?: BlockIdentifier, invocationDetails?: InvocationsDetails): Promise<EstimateFeeResponse>;
+    getTransactionReceipt(txHash: string): Promise<GetTransactionReceiptResponse>;
+    getClass(classHash: RPC.Felt): Promise<RPC.ContractClass>;
+    getClassAt(contractAddress: string, blockIdentifier: BlockIdentifier): Promise<RPC.ContractClass>;
+    getCode(_contractAddress: string, _blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
+    getEstimateFee(invocation: Invocation, invocationDetails: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<EstimateFeeResponse>;
     declareContract({ contract, version, }: DeclareContractPayload): Promise<DeclareContractResponse>;
     deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
-    invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    invokeFunction(functionInvocation: Invocation, details: InvocationsDetailsWithNonce): Promise<InvokeFunctionResponse>;
     callContract(call: Call, blockIdentifier?: BlockIdentifier): Promise<CallContractResponse>;
-    getCode(_contractAddress: string, _blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
-    waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
+    traceTransaction(transactionHash: RPC.TransactionHash): Promise<RPC.Trace>;
+    traceBlockTransactions(blockHash: RPC.BlockHash): Promise<RPC.Traces>;
+    waitForTransaction(txHash: string, retryInterval?: number): Promise<void>;
     /**
      * Gets the transaction count from a block.
      *