starknet 4.6.0 → 4.7.0

package/dist/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/dist/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/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 & {
@@ -14,14 +14,11 @@ declare type GetTransactionByHashResponse = RPC.GetTransactionByHashResponse & {
 declare type TransactionReceipt = RPC.TransactionReceipt & {
     [key: string]: any;
 };
-export declare class RPCResponseParser extends ResponseParser {
+export declare class RPCResponseParser implements Omit<ResponseParser, 'parseDeclareContractResponse' | 'parseDeployContractResponse' | 'parseInvokeFunctionResponse'> {
     parseGetBlockResponse(res: RpcGetBlockResponse): GetBlockResponse;
     parseGetTransactionResponse(res: GetTransactionByHashResponse): GetTransactionResponse;
     parseGetTransactionReceiptResponse(res: TransactionReceipt): GetTransactionReceiptResponse;
     parseFeeEstimateResponse(res: RPC.EstimateFeeResponse): EstimateFeeResponse;
     parseCallContractResponse(res: Array<string>): CallContractResponse;
-    parseInvokeFunctionResponse(res: RPC.InvokedTransaction): InvokeFunctionResponse;
-    parseDeployContractResponse(res: RPC.DeployedTransaction): DeployContractResponse;
-    parseDeclareContractResponse(res: RPC.DeclaredTransaction): 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 || [],
@@ -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.6.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