starknet 4.10.0 → 4.12.0

package/provider/interface.d.ts

@@ -1,6 +1,6 @@
 import { StarknetChainId } from '../constants';
 import type { Call, CallContractResponse, ContractClass, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetailsWithNonce, InvokeFunctionResponse } from '../types';
-import { DeclareContractTransaction, DeployAccountContractPayload, DeployAccountContractTransaction } from '../types/lib';
+import { DeclareContractTransaction, DeployAccountContractPayload, DeployAccountContractTransaction, InvocationsDetails } from '../types/lib';
 import type { BigNumberish } from '../utils/number';
 import { BlockIdentifier } from './utils';
 export declare abstract class ProviderInterface {
@@ -38,6 +38,21 @@ export declare abstract class ProviderInterface {
      * @returns Contract class of compiled contract
      */
     abstract getClassAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<ContractClass>;
+    /**
+     * Returns the class hash deployed under the given address.
+     *
+     * @param contractAddress - contract address
+     * @param blockIdentifier - block identifier
+     * @returns Class hash
+     */
+    abstract getClassHashAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<string>;
+    /**
+     * Returns the contract class deployed under the given class hash.
+     *
+     * @param classHash - class hash
+     * @returns Contract class of compiled contract
+     */
+    abstract getClassByHash(classHash: string): Promise<ContractClass>;
     /**
      * Gets the nonce of a contract with respect to a specific block
      *
@@ -53,7 +68,7 @@ export declare abstract class ProviderInterface {
      * @param blockIdentifier - block identifier
      * @returns the value of the storage variable
      */
-    abstract getStorageAt(contractAddress: string, key: BigNumberish, blockIdentifier: BlockIdentifier): Promise<BigNumberish>;
+    abstract getStorageAt(contractAddress: string, key: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
     /**
      * Gets the transaction information from a tx id.
      *
@@ -77,7 +92,7 @@ export declare abstract class ProviderInterface {
      * - address salt
      * @returns a confirmation of sending a transaction on the starknet contract
      */
-    abstract deployContract(payload: DeployContractPayload): Promise<DeployContractResponse>;
+    abstract deployContract(payload: DeployContractPayload, details?: InvocationsDetails): Promise<DeployContractResponse>;
     /**
      * Deploys a given compiled Account contract (json) to starknet
      *

package/provider/rpc.d.ts

@@ -1,7 +1,7 @@
 import { StarknetChainId } from '../constants';
-import { Call, CallContractResponse, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetailsWithNonce, InvokeFunctionResponse } from '../types';
+import { Call, CallContractResponse, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetCodeResponse, GetTransactionResponse, Invocation, InvocationsDetailsWithNonce, InvokeFunctionResponse } from '../types';
 import { RPC } from '../types/api';
-import { DeclareContractTransaction, DeployAccountContractPayload, DeployAccountContractTransaction } from '../types/lib';
+import { DeclareContractTransaction, DeployAccountContractTransaction, InvocationsDetails } from '../types/lib';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { BlockIdentifier } from './utils';
@@ -25,17 +25,18 @@ export declare class RpcProvider implements ProviderInterface {
     getBlockHashAndNumber(): Promise<RPC.BlockHashAndNumber>;
     getBlockWithTxHashes(blockIdentifier?: BlockIdentifier): Promise<RPC.GetBlockWithTxHashesResponse>;
     getBlockWithTxs(blockIdentifier?: BlockIdentifier): Promise<RPC.GetBlockWithTxs>;
-    getClassHashAt(blockIdentifier: BlockIdentifier, contractAddress: RPC.ContractAddress): Promise<RPC.Felt>;
+    getClassHashAt(contractAddress: RPC.ContractAddress, blockIdentifier?: BlockIdentifier): Promise<RPC.Felt>;
     getNonce(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<RPC.Nonce>;
     getPendingTransactions(): Promise<RPC.PendingTransactions>;
     getProtocolVersion(): Promise<Error>;
-    getStateUpdate(blockIdentifier: BlockIdentifier): Promise<RPC.StateUpdate>;
+    getStateUpdate(blockIdentifier?: BlockIdentifier): Promise<RPC.StateUpdate>;
     getStorageAt(contractAddress: string, key: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
     getTransaction(txHash: string): Promise<GetTransactionResponse>;
     getTransactionByHash(txHash: string): Promise<RPC.GetTransactionByHashResponse>;
     getTransactionByBlockIdAndIndex(blockIdentifier: BlockIdentifier, index: number): Promise<RPC.GetTransactionByBlockIdAndIndex>;
-    getTransactionReceipt(txHash: string): Promise<GetTransactionReceiptResponse>;
-    getClass(classHash: RPC.Felt): Promise<RPC.ContractClass>;
+    getTransactionReceipt(txHash: string): Promise<RPC.TransactionReceipt>;
+    getClassByHash(classHash: RPC.Felt): Promise<RPC.ContractClass>;
+    getClass(classHash: RPC.Felt, blockIdentifier?: BlockIdentifier): 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>;
@@ -43,8 +44,11 @@ export declare class RpcProvider implements ProviderInterface {
     getDeclareEstimateFee({ senderAddress, contractDefinition, signature }: DeclareContractTransaction, details: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<EstimateFeeResponse>;
     getDeployAccountEstimateFee({ classHash, constructorCalldata, addressSalt, signature }: DeployAccountContractTransaction, details: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<EstimateFeeResponse>;
     declareContract({ contractDefinition, signature, senderAddress }: DeclareContractTransaction, details: InvocationsDetailsWithNonce): Promise<DeclareContractResponse>;
-    deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
-    deployAccountContract({ classHash, constructorCalldata, addressSalt, }: DeployAccountContractPayload): Promise<DeployContractResponse>;
+    /**
+     * @deprecated This method wont be supported soon, use Account.deploy instead
+     */
+    deployContract({ contract, constructorCalldata, addressSalt }: DeployContractPayload, details?: InvocationsDetails): Promise<DeployContractResponse>;
+    deployAccountContract({ classHash, constructorCalldata, addressSalt, signature }: DeployAccountContractTransaction, details: InvocationsDetailsWithNonce): Promise<DeployContractResponse>;
     invokeFunction(functionInvocation: Invocation, details: InvocationsDetailsWithNonce): Promise<InvokeFunctionResponse>;
     callContract(call: Call, blockIdentifier?: BlockIdentifier): Promise<CallContractResponse>;
     traceTransaction(transactionHash: RPC.TransactionHash): Promise<RPC.Trace>;
@@ -57,7 +61,7 @@ export declare class RpcProvider implements ProviderInterface {
      * @param blockIdentifier
      * @returns Number of transactions
      */
-    getTransactionCount(blockIdentifier: BlockIdentifier): Promise<RPC.GetTransactionCountResponse>;
+    getTransactionCount(blockIdentifier?: BlockIdentifier): Promise<RPC.GetTransactionCountResponse>;
     /**
      * Gets the latest block number
      *

package/provider/rpc.js

@@ -72,7 +72,7 @@ var RpcProvider = /** @class */ (function () {
         });
     }
     RpcProvider.prototype.fetch = function (method, params) {
-        return (0, fetchPonyfill_1.default)(this.nodeUrl, {
+        return (0, fetchPonyfill_1.default)("".concat(this.nodeUrl, "/rpc/v0.2"), {
             method: 'POST',
             body: (0, json_1.stringify)({ method: method, jsonrpc: '2.0', params: params, id: 0 }),
             headers: this.headers,
@@ -153,7 +153,8 @@ var RpcProvider = /** @class */ (function () {
             });
         });
     };
-    RpcProvider.prototype.getClassHashAt = function (blockIdentifier, contractAddress) {
+    RpcProvider.prototype.getClassHashAt = function (contractAddress, blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
         return __awaiter(this, void 0, void 0, function () {
             var block_id;
             return __generator(this, function (_a) {
@@ -193,6 +194,7 @@ var RpcProvider = /** @class */ (function () {
         });
     };
     RpcProvider.prototype.getStateUpdate = function (blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
         return __awaiter(this, void 0, void 0, function () {
             var block_id;
             return __generator(this, function (_a) {
@@ -247,10 +249,20 @@ var RpcProvider = /** @class */ (function () {
             });
         });
     };
-    RpcProvider.prototype.getClass = function (classHash) {
+    RpcProvider.prototype.getClassByHash = function (classHash) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                return [2 /*return*/, this.fetchEndpoint('starknet_getClass', { class_hash: classHash })];
+                return [2 /*return*/, this.getClass(classHash)];
+            });
+        });
+    };
+    RpcProvider.prototype.getClass = function (classHash, blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
+        return __awaiter(this, void 0, void 0, function () {
+            var block_id;
+            return __generator(this, function (_a) {
+                block_id = new utils_1.Block(blockIdentifier).identifier;
+                return [2 /*return*/, this.fetchEndpoint('starknet_getClass', { class_hash: classHash, block_id: block_id })];
             });
         });
     };
@@ -270,7 +282,7 @@ var RpcProvider = /** @class */ (function () {
     RpcProvider.prototype.getCode = function (_contractAddress, _blockIdentifier) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                throw new Error('RPC 0.1.0 does not implement getCode function');
+                throw new Error('RPC does not implement getCode function');
             });
         });
     };
@@ -359,46 +371,61 @@ var RpcProvider = /** @class */ (function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_b) {
                 return [2 /*return*/, this.fetchEndpoint('starknet_addDeclareTransaction', {
-                        contract_class: {
-                            program: contractDefinition.program,
-                            entry_points_by_type: contractDefinition.entry_points_by_type,
-                            abi: contractDefinition.abi, // rpc 2.0
+                        declare_transaction: {
+                            contract_class: {
+                                program: contractDefinition.program,
+                                entry_points_by_type: contractDefinition.entry_points_by_type,
+                                abi: contractDefinition.abi, // rpc 2.0
+                            },
+                            type: 'DECLARE',
+                            version: (0, number_1.toHex)((0, number_1.toBN)(details.version || 0)),
+                            max_fee: (0, number_1.toHex)((0, number_1.toBN)(details.maxFee || 0)),
+                            signature: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(signature || []),
+                            sender_address: senderAddress,
+                            nonce: (0, number_1.toHex)((0, number_1.toBN)(details.nonce)),
                         },
-                        version: (0, number_1.toHex)((0, number_1.toBN)(details.version || 0)),
-                        max_fee: (0, number_1.toHex)((0, number_1.toBN)(details.maxFee || 0)),
-                        signature: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(signature || []),
-                        sender_address: senderAddress,
-                        nonce: (0, number_1.toHex)((0, number_1.toBN)(details.nonce)),
                     })];
             });
         });
     };
-    RpcProvider.prototype.deployContract = function (_a) {
+    /**
+     * @deprecated This method wont be supported soon, use Account.deploy instead
+     */
+    RpcProvider.prototype.deployContract = function (_a, details) {
         var contract = _a.contract, constructorCalldata = _a.constructorCalldata, addressSalt = _a.addressSalt;
         return __awaiter(this, void 0, void 0, function () {
             var contractDefinition;
             return __generator(this, function (_b) {
                 contractDefinition = (0, provider_1.parseContract)(contract);
                 return [2 /*return*/, this.fetchEndpoint('starknet_addDeployTransaction', {
-                        contract_address_salt: addressSalt !== null && addressSalt !== void 0 ? addressSalt : (0, stark_1.randomAddress)(),
-                        constructor_calldata: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(constructorCalldata !== null && constructorCalldata !== void 0 ? constructorCalldata : []),
-                        contract_definition: {
-                            program: contractDefinition.program,
-                            entry_points_by_type: contractDefinition.entry_points_by_type,
-                            abi: contractDefinition.abi, // rpc 2.0
+                        deploy_transaction: {
+                            contract_address_salt: addressSalt !== null && addressSalt !== void 0 ? addressSalt : (0, stark_1.randomAddress)(),
+                            constructor_calldata: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(constructorCalldata !== null && constructorCalldata !== void 0 ? constructorCalldata : []),
+                            contract_class: {
+                                program: contractDefinition.program,
+                                entry_points_by_type: contractDefinition.entry_points_by_type,
+                                abi: contractDefinition.abi,
+                            },
+                            type: 'DEPLOY',
+                            version: (0, number_1.toHex)((0, number_1.toBN)((details === null || details === void 0 ? void 0 : details.version) || 0)),
                         },
                     })];
             });
         });
     };
-    RpcProvider.prototype.deployAccountContract = function (_a) {
-        var classHash = _a.classHash, constructorCalldata = _a.constructorCalldata, addressSalt = _a.addressSalt;
+    RpcProvider.prototype.deployAccountContract = function (_a, details) {
+        var classHash = _a.classHash, constructorCalldata = _a.constructorCalldata, addressSalt = _a.addressSalt, signature = _a.signature;
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_b) {
                 return [2 /*return*/, this.fetchEndpoint('starknet_addDeployAccountTransaction', {
                         constructor_calldata: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(constructorCalldata || []),
                         class_hash: (0, number_1.toHex)((0, number_1.toBN)(classHash)),
                         contract_address_salt: (0, number_1.toHex)((0, number_1.toBN)(addressSalt || 0)),
+                        type: 'DEPLOY',
+                        max_fee: (0, number_1.toHex)((0, number_1.toBN)(details.maxFee || 0)),
+                        version: (0, number_1.toHex)((0, number_1.toBN)(details.version || 0)),
+                        signature: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(signature || []),
+                        nonce: (0, number_1.toHex)((0, number_1.toBN)(details.nonce)),
                     })];
             });
         });
@@ -407,13 +434,15 @@ var RpcProvider = /** @class */ (function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 return [2 /*return*/, this.fetchEndpoint('starknet_addInvokeTransaction', {
-                        function_invocation: {
-                            contract_address: functionInvocation.contractAddress,
+                        invoke_transaction: {
+                            sender_address: functionInvocation.contractAddress,
                             calldata: (0, provider_1.parseCalldata)(functionInvocation.calldata),
+                            type: 'INVOKE',
+                            max_fee: (0, number_1.toHex)((0, number_1.toBN)(details.maxFee || 0)),
+                            version: (0, number_1.toHex)((0, number_1.toBN)(details.version || 0)),
+                            signature: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(functionInvocation.signature || []),
+                            nonce: (0, number_1.toHex)((0, number_1.toBN)(details.nonce)),
                         },
-                        signature: (0, number_1.bigNumberishArrayToHexadecimalStringArray)(functionInvocation.signature || []),
-                        max_fee: (0, number_1.toHex)((0, number_1.toBN)(details.maxFee || 0)),
-                        version: (0, number_1.toHex)((0, number_1.toBN)(details.version || 0)),
                     })];
             });
         });
@@ -459,7 +488,7 @@ var RpcProvider = /** @class */ (function () {
     RpcProvider.prototype.waitForTransaction = function (txHash, retryInterval) {
         if (retryInterval === void 0) { retryInterval = 8000; }
         return __awaiter(this, void 0, void 0, function () {
-            var retries, onchain, successStates, errorStates, res, message, error, error_2;
+            var retries, onchain, successStates, errorStates, res, error, message, error, error_2;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -481,6 +510,10 @@ var RpcProvider = /** @class */ (function () {
                         return [4 /*yield*/, this.getTransactionReceipt(txHash)];
                     case 4:
                         res = _a.sent();
+                        if (!('status' in res)) {
+                            error = new Error('pending transaction');
+                            throw error;
+                        }
                         if (res.status && successStates.includes(res.status)) {
                             onchain = true;
                         }
@@ -519,6 +552,7 @@ var RpcProvider = /** @class */ (function () {
      * @returns Number of transactions
      */
     RpcProvider.prototype.getTransactionCount = function (blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
         return __awaiter(this, void 0, void 0, function () {
             var block_id;
             return __generator(this, function (_a) {

package/provider/sequencer.d.ts

@@ -38,6 +38,8 @@ export declare class SequencerProvider implements ProviderInterface {
     getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
     getTransactionReceipt(txHash: BigNumberish): Promise<GetTransactionReceiptResponse>;
     getClassAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<ContractClass>;
+    getClassHashAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<string>;
+    getClassByHash(classHash: string): Promise<ContractClass>;
     invokeFunction(functionInvocation: Invocation, details: InvocationsDetailsWithNonce): Promise<InvokeFunctionResponse>;
     deployContract({ contract, constructorCalldata, addressSalt, }: DeployContractPayload): Promise<DeployContractResponse>;
     deployAccountContract({ classHash, constructorCalldata, addressSalt, signature }: DeployAccountContractTransaction, details: InvocationsDetailsWithNonce): Promise<DeployContractResponse>;

package/provider/sequencer.js

@@ -326,6 +326,21 @@ var SequencerProvider = /** @class */ (function () {
             });
         });
     };
+    SequencerProvider.prototype.getClassHashAt = function (contractAddress, blockIdentifier) {
+        if (blockIdentifier === void 0) { blockIdentifier = 'pending'; }
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.fetchEndpoint('get_class_hash_at', { blockIdentifier: blockIdentifier, contractAddress: contractAddress })];
+            });
+        });
+    };
+    SequencerProvider.prototype.getClassByHash = function (classHash) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.fetchEndpoint('get_class_by_hash', { classHash: classHash }).then(provider_1.parseContract)];
+            });
+        });
+    };
     SequencerProvider.prototype.invokeFunction = function (functionInvocation, details) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function () {

package/src/account/default.ts

@@ -22,7 +22,11 @@ import {
   DeployAccountContractPayload,
   UniversalDeployerContractPayload,
 } from '../types/lib';
-import { calculateContractAddressFromHash, transactionVersion } from '../utils/hash';
+import {
+  calculateContractAddressFromHash,
+  feeTransactionVersion,
+  transactionVersion,
+} from '../utils/hash';
 import { BigNumberish, toBN, toCairoBool } from '../utils/number';
 import { parseContract } from '../utils/provider';
 import { compileCalldata, estimatedFeeToMaxFee } from '../utils/stark';
@@ -63,7 +67,7 @@ export class Account extends Provider implements AccountInterface {
   ): Promise<EstimateFee> {
     const transactions = Array.isArray(calls) ? calls : [calls];
     const nonce = toBN(providedNonce ?? (await this.getNonce()));
-    const version = toBN(transactionVersion);
+    const version = toBN(feeTransactionVersion);
     const chainId = await this.getChainId();
 
     const signerDetails: InvocationsSignerDetails = {
@@ -96,7 +100,7 @@ export class Account extends Provider implements AccountInterface {
     { blockIdentifier, nonce: providedNonce }: EstimateFeeDetails = {}
   ): Promise<EstimateFee> {
     const nonce = toBN(providedNonce ?? (await this.getNonce()));
-    const version = toBN(transactionVersion);
+    const version = toBN(feeTransactionVersion);
     const chainId = await this.getChainId();
     const contractDefinition = parseContract(contract);
 
@@ -132,7 +136,7 @@ export class Account extends Provider implements AccountInterface {
     { blockIdentifier, nonce: providedNonce }: EstimateFeeDetails = {}
   ): Promise<EstimateFee> {
     const nonce = toBN(providedNonce ?? (await this.getNonce()));
-    const version = toBN(transactionVersion);
+    const version = toBN(feeTransactionVersion);
     const chainId = await this.getChainId();
     const contractAddress =
       providedContractAddress ??

package/src/provider/default.ts

@@ -15,7 +15,11 @@ import {
   InvocationsDetailsWithNonce,
   InvokeFunctionResponse,
 } from '../types';
-import { DeclareContractTransaction, DeployAccountContractTransaction } from '../types/lib';
+import {
+  DeclareContractTransaction,
+  DeployAccountContractTransaction,
+  InvocationsDetails,
+} from '../types/lib';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { RpcProvider, RpcProviderOptions } from './rpc';
@@ -61,6 +65,17 @@ export class Provider implements ProviderInterface {
     return this.provider.getClassAt(contractAddress, blockIdentifier);
   }
 
+  public async getClassHashAt(
+    contractAddress: string,
+    blockIdentifier: BlockIdentifier = 'pending'
+  ): Promise<string> {
+    return this.provider.getClassHashAt(contractAddress, blockIdentifier);
+  }
+
+  public getClassByHash(classHash: string): Promise<ContractClass> {
+    return this.provider.getClassByHash(classHash);
+  }
+
   public async getEstimateFee(
     invocationWithTxType: Invocation,
     invocationDetails: InvocationsDetailsWithNonce,
@@ -118,8 +133,11 @@ export class Provider implements ProviderInterface {
     return this.provider.invokeFunction(functionInvocation, details);
   }
 
-  public async deployContract(payload: DeployContractPayload): Promise<DeployContractResponse> {
-    return this.provider.deployContract(payload);
+  public async deployContract(
+    payload: DeployContractPayload,
+    details: InvocationsDetails
+  ): Promise<DeployContractResponse> {
+    return this.provider.deployContract(payload, details);
   }
 
   public async deployAccountContract(

package/src/provider/interface.ts

@@ -19,6 +19,7 @@ import {
   DeclareContractTransaction,
   DeployAccountContractPayload,
   DeployAccountContractTransaction,
+  InvocationsDetails,
 } from '../types/lib';
 import type { BigNumberish } from '../utils/number';
 import { BlockIdentifier } from './utils';
@@ -73,6 +74,26 @@ export abstract class ProviderInterface {
     blockIdentifier?: BlockIdentifier
   ): Promise<ContractClass>;
 
+  /**
+   * Returns the class hash deployed under the given address.
+   *
+   * @param contractAddress - contract address
+   * @param blockIdentifier - block identifier
+   * @returns Class hash
+   */
+  public abstract getClassHashAt(
+    contractAddress: string,
+    blockIdentifier?: BlockIdentifier
+  ): Promise<string>;
+
+  /**
+   * Returns the contract class deployed under the given class hash.
+   *
+   * @param classHash - class hash
+   * @returns Contract class of compiled contract
+   */
+  public abstract getClassByHash(classHash: string): Promise<ContractClass>;
+
   /**
    * Gets the nonce of a contract with respect to a specific block
    *
@@ -95,7 +116,7 @@ export abstract class ProviderInterface {
   public abstract getStorageAt(
     contractAddress: string,
     key: BigNumberish,
-    blockIdentifier: BlockIdentifier
+    blockIdentifier?: BlockIdentifier
   ): Promise<BigNumberish>;
 
   /**
@@ -125,7 +146,10 @@ export abstract class ProviderInterface {
    * - address salt
    * @returns a confirmation of sending a transaction on the starknet contract
    */
-  public abstract deployContract(payload: DeployContractPayload): Promise<DeployContractResponse>;
+  public abstract deployContract(
+    payload: DeployContractPayload,
+    details?: InvocationsDetails
+  ): Promise<DeployContractResponse>;
 
   /**
    * Deploys a given compiled Account contract (json) to starknet