starknet 4.7.0 → 4.9.0

package/account/default.js

@@ -68,6 +68,7 @@ var default_1 = require("../provider/default");
 var signer_1 = require("../signer");
 var hash_1 = require("../utils/hash");
 var number_1 = require("../utils/number");
+var provider_1 = require("../utils/provider");
 var stark_1 = require("../utils/stark");
 var transaction_1 = require("../utils/transaction");
 var typedData_1 = require("../utils/typedData");
@@ -87,7 +88,14 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
-    Account.prototype.estimateFee = function (calls, _a) {
+    Account.prototype.estimateFee = function (calls, estimateFeeDetails) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.estimateInvokeFee(calls, estimateFeeDetails)];
+            });
+        });
+    };
+    Account.prototype.estimateInvokeFee = function (calls, _a) {
         var _b = _a === void 0 ? {} : _a, providedNonce = _b.nonce, blockIdentifier = _b.blockIdentifier;
         return __awaiter(this, void 0, void 0, function () {
             var transactions, nonce, _c, _d, version, chainId, signerDetails, signature, calldata, response, suggestedMaxFee;
@@ -120,7 +128,7 @@ var Account = /** @class */ (function (_super) {
                     case 5:
                         signature = _e.sent();
                         calldata = (0, transaction_1.fromCallsToExecuteCalldata)(transactions);
-                        return [4 /*yield*/, _super.prototype.getEstimateFee.call(this, { contractAddress: this.address, calldata: calldata, signature: signature }, { version: version, nonce: nonce }, blockIdentifier)];
+                        return [4 /*yield*/, _super.prototype.getInvokeEstimateFee.call(this, { contractAddress: this.address, calldata: calldata, signature: signature }, { version: version, nonce: nonce }, blockIdentifier)];
                     case 6:
                         response = _e.sent();
                         suggestedMaxFee = (0, stark_1.estimatedFeeToMaxFee)(response.overall_fee);
@@ -129,50 +137,125 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
-    /**
-     * Invoke execute function in account contract
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/gateway/gateway_client.py#L13-L17)
-     *
-     * @param calls - one or more calls to be executed
-     * @param abis - one or more abis which can be used to display the calls
-     * @param transactionsDetail - optional transaction details
-     * @returns a confirmation of invoking a function on the starknet contract
-     */
+    Account.prototype.estimateDeclareFee = function (_a, _b) {
+        var classHash = _a.classHash, contract = _a.contract;
+        var _c = _b === void 0 ? {} : _b, blockIdentifier = _c.blockIdentifier, providedNonce = _c.nonce;
+        return __awaiter(this, void 0, void 0, function () {
+            var nonce, _d, _e, version, chainId, contractDefinition, signature, response, suggestedMaxFee;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _d = number_1.toBN;
+                        if (!(providedNonce !== null && providedNonce !== void 0)) return [3 /*break*/, 1];
+                        _e = providedNonce;
+                        return [3 /*break*/, 3];
+                    case 1: return [4 /*yield*/, this.getNonce()];
+                    case 2:
+                        _e = (_f.sent());
+                        _f.label = 3;
+                    case 3:
+                        nonce = _d.apply(void 0, [_e]);
+                        version = (0, number_1.toBN)(hash_1.transactionVersion);
+                        return [4 /*yield*/, this.getChainId()];
+                    case 4:
+                        chainId = _f.sent();
+                        contractDefinition = (0, provider_1.parseContract)(contract);
+                        return [4 /*yield*/, this.signer.signDeclareTransaction({
+                                classHash: classHash,
+                                senderAddress: this.address,
+                                chainId: chainId,
+                                maxFee: constants_1.ZERO,
+                                version: version,
+                                nonce: nonce,
+                            })];
+                    case 5:
+                        signature = _f.sent();
+                        return [4 /*yield*/, _super.prototype.getDeclareEstimateFee.call(this, { senderAddress: this.address, signature: signature, contractDefinition: contractDefinition }, { version: version, nonce: nonce }, blockIdentifier)];
+                    case 6:
+                        response = _f.sent();
+                        suggestedMaxFee = (0, stark_1.estimatedFeeToMaxFee)(response.overall_fee);
+                        return [2 /*return*/, __assign(__assign({}, response), { suggestedMaxFee: suggestedMaxFee })];
+                }
+            });
+        });
+    };
+    Account.prototype.estimateAccountDeployFee = function (_a, _b) {
+        var classHash = _a.classHash, _c = _a.addressSalt, addressSalt = _c === void 0 ? 0 : _c, _d = _a.constructorCalldata, constructorCalldata = _d === void 0 ? [] : _d, providedContractAddress = _a.contractAddress;
+        var _e = _b === void 0 ? {} : _b, blockIdentifier = _e.blockIdentifier, providedNonce = _e.nonce;
+        return __awaiter(this, void 0, void 0, function () {
+            var nonce, _f, _g, version, chainId, contractAddress, signature, response, suggestedMaxFee;
+            return __generator(this, function (_h) {
+                switch (_h.label) {
+                    case 0:
+                        _f = number_1.toBN;
+                        if (!(providedNonce !== null && providedNonce !== void 0)) return [3 /*break*/, 1];
+                        _g = providedNonce;
+                        return [3 /*break*/, 3];
+                    case 1: return [4 /*yield*/, this.getNonce()];
+                    case 2:
+                        _g = (_h.sent());
+                        _h.label = 3;
+                    case 3:
+                        nonce = _f.apply(void 0, [_g]);
+                        version = (0, number_1.toBN)(hash_1.transactionVersion);
+                        return [4 /*yield*/, this.getChainId()];
+                    case 4:
+                        chainId = _h.sent();
+                        contractAddress = providedContractAddress !== null && providedContractAddress !== void 0 ? providedContractAddress : (0, hash_1.calculateContractAddressFromHash)(addressSalt, classHash, constructorCalldata, 0);
+                        return [4 /*yield*/, this.signer.signDeployAccountTransaction({
+                                classHash: classHash,
+                                contractAddress: contractAddress,
+                                chainId: chainId,
+                                maxFee: constants_1.ZERO,
+                                version: version,
+                                nonce: nonce,
+                                addressSalt: addressSalt,
+                                constructorCalldata: constructorCalldata,
+                            })];
+                    case 5:
+                        signature = _h.sent();
+                        return [4 /*yield*/, _super.prototype.getDeployAccountEstimateFee.call(this, { classHash: classHash, addressSalt: addressSalt, constructorCalldata: constructorCalldata, signature: signature }, { version: version, nonce: nonce }, blockIdentifier)];
+                    case 6:
+                        response = _h.sent();
+                        suggestedMaxFee = (0, stark_1.estimatedFeeToMaxFee)(response.overall_fee);
+                        return [2 /*return*/, __assign(__assign({}, response), { suggestedMaxFee: suggestedMaxFee })];
+                }
+            });
+        });
+    };
     Account.prototype.execute = function (calls, abis, transactionsDetail) {
-        var _a;
+        var _a, _b;
         if (abis === void 0) { abis = undefined; }
         if (transactionsDetail === void 0) { transactionsDetail = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var transactions, nonce, _b, _c, maxFee, suggestedMaxFee, version, chainId, signerDetails, signature, calldata;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
+            var transactions, nonce, _c, _d, maxFee, _e, version, chainId, signerDetails, signature, calldata;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
                     case 0:
                         transactions = Array.isArray(calls) ? calls : [calls];
-                        _b = number_1.toBN;
+                        _c = number_1.toBN;
                         if (!((_a = transactionsDetail.nonce) !== null && _a !== void 0)) return [3 /*break*/, 1];
-                        _c = _a;
+                        _d = _a;
                         return [3 /*break*/, 3];
                     case 1: return [4 /*yield*/, this.getNonce()];
                     case 2:
-                        _c = (_d.sent());
-                        _d.label = 3;
+                        _d = (_f.sent());
+                        _f.label = 3;
                     case 3:
-                        nonce = _b.apply(void 0, [_c]);
-                        maxFee = '0';
-                        if (!(transactionsDetail.maxFee || transactionsDetail.maxFee === 0)) return [3 /*break*/, 4];
-                        maxFee = transactionsDetail.maxFee;
+                        nonce = _c.apply(void 0, [_d]);
+                        if (!((_b = transactionsDetail.maxFee) !== null && _b !== void 0)) return [3 /*break*/, 4];
+                        _e = _b;
                         return [3 /*break*/, 6];
-                    case 4: return [4 /*yield*/, this.estimateFee(transactions, { nonce: nonce })];
+                    case 4: return [4 /*yield*/, this.getSuggestedMaxFee({ type: 'INVOKE', payload: calls }, transactionsDetail)];
                     case 5:
-                        suggestedMaxFee = (_d.sent()).suggestedMaxFee;
-                        maxFee = suggestedMaxFee.toString();
-                        _d.label = 6;
+                        _e = (_f.sent());
+                        _f.label = 6;
                     case 6:
+                        maxFee = _e;
                         version = (0, number_1.toBN)(hash_1.transactionVersion);
                         return [4 /*yield*/, this.getChainId()];
                     case 7:
-                        chainId = _d.sent();
+                        chainId = _f.sent();
                         signerDetails = {
                             walletAddress: this.address,
                             nonce: nonce,
@@ -182,7 +265,7 @@ var Account = /** @class */ (function (_super) {
                         };
                         return [4 /*yield*/, this.signer.signTransaction(transactions, signerDetails, abis)];
                     case 8:
-                        signature = _d.sent();
+                        signature = _f.sent();
                         calldata = (0, transaction_1.fromCallsToExecuteCalldata)(transactions);
                         return [2 /*return*/, this.invokeFunction({ contractAddress: this.address, calldata: calldata, signature: signature }, {
                                 nonce: nonce,
@@ -193,13 +276,115 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
-    /**
-     * Sign an JSON object with the starknet private key and return the signature
-     *
-     * @param json - JSON object to be signed
-     * @returns the signature of the JSON object
-     * @throws {Error} if the JSON object is not a valid JSON
-     */
+    Account.prototype.declare = function (_a, transactionsDetail) {
+        var _b, _c;
+        var classHash = _a.classHash, contract = _a.contract;
+        if (transactionsDetail === void 0) { transactionsDetail = {}; }
+        return __awaiter(this, void 0, void 0, function () {
+            var nonce, _d, _e, maxFee, _f, version, chainId, signature, contractDefinition;
+            return __generator(this, function (_g) {
+                switch (_g.label) {
+                    case 0:
+                        _d = number_1.toBN;
+                        if (!((_b = transactionsDetail.nonce) !== null && _b !== void 0)) return [3 /*break*/, 1];
+                        _e = _b;
+                        return [3 /*break*/, 3];
+                    case 1: return [4 /*yield*/, this.getNonce()];
+                    case 2:
+                        _e = (_g.sent());
+                        _g.label = 3;
+                    case 3:
+                        nonce = _d.apply(void 0, [_e]);
+                        if (!((_c = transactionsDetail.maxFee) !== null && _c !== void 0)) return [3 /*break*/, 4];
+                        _f = _c;
+                        return [3 /*break*/, 6];
+                    case 4: return [4 /*yield*/, this.getSuggestedMaxFee({ type: 'DECLARE', payload: { classHash: classHash, contract: contract } }, transactionsDetail)];
+                    case 5:
+                        _f = (_g.sent());
+                        _g.label = 6;
+                    case 6:
+                        maxFee = _f;
+                        version = (0, number_1.toBN)(hash_1.transactionVersion);
+                        return [4 /*yield*/, this.getChainId()];
+                    case 7:
+                        chainId = _g.sent();
+                        return [4 /*yield*/, this.signer.signDeclareTransaction({
+                                classHash: classHash,
+                                senderAddress: this.address,
+                                chainId: chainId,
+                                maxFee: maxFee,
+                                version: version,
+                                nonce: nonce,
+                            })];
+                    case 8:
+                        signature = _g.sent();
+                        contractDefinition = (0, provider_1.parseContract)(contract);
+                        return [2 /*return*/, this.declareContract({ contractDefinition: contractDefinition, senderAddress: this.address, signature: signature }, {
+                                nonce: nonce,
+                                maxFee: maxFee,
+                                version: version,
+                            })];
+                }
+            });
+        });
+    };
+    Account.prototype.deployAccount = function (_a, transactionsDetail) {
+        var _b, _c;
+        var classHash = _a.classHash, _d = _a.constructorCalldata, constructorCalldata = _d === void 0 ? [] : _d, _e = _a.addressSalt, addressSalt = _e === void 0 ? 0 : _e, providedContractAddress = _a.contractAddress;
+        if (transactionsDetail === void 0) { transactionsDetail = {}; }
+        return __awaiter(this, void 0, void 0, function () {
+            var nonce, _f, _g, version, chainId, contractAddress, maxFee, _h, signature;
+            return __generator(this, function (_j) {
+                switch (_j.label) {
+                    case 0:
+                        _f = number_1.toBN;
+                        if (!((_b = transactionsDetail.nonce) !== null && _b !== void 0)) return [3 /*break*/, 1];
+                        _g = _b;
+                        return [3 /*break*/, 3];
+                    case 1: return [4 /*yield*/, this.getNonce()];
+                    case 2:
+                        _g = (_j.sent());
+                        _j.label = 3;
+                    case 3:
+                        nonce = _f.apply(void 0, [_g]);
+                        version = (0, number_1.toBN)(hash_1.transactionVersion);
+                        return [4 /*yield*/, this.getChainId()];
+                    case 4:
+                        chainId = _j.sent();
+                        contractAddress = providedContractAddress !== null && providedContractAddress !== void 0 ? providedContractAddress : (0, hash_1.calculateContractAddressFromHash)(addressSalt, classHash, constructorCalldata, 0);
+                        if (!((_c = transactionsDetail.maxFee) !== null && _c !== void 0)) return [3 /*break*/, 5];
+                        _h = _c;
+                        return [3 /*break*/, 7];
+                    case 5: return [4 /*yield*/, this.getSuggestedMaxFee({
+                            type: 'DEPLOY_ACCOUNT',
+                            payload: { classHash: classHash, constructorCalldata: constructorCalldata, addressSalt: addressSalt, contractAddress: contractAddress },
+                        }, transactionsDetail)];
+                    case 6:
+                        _h = (_j.sent());
+                        _j.label = 7;
+                    case 7:
+                        maxFee = _h;
+                        return [4 /*yield*/, this.signer.signDeployAccountTransaction({
+                                classHash: classHash,
+                                constructorCalldata: constructorCalldata,
+                                contractAddress: contractAddress,
+                                addressSalt: addressSalt,
+                                chainId: chainId,
+                                maxFee: maxFee,
+                                version: version,
+                                nonce: nonce,
+                            })];
+                    case 8:
+                        signature = _j.sent();
+                        return [2 /*return*/, this.deployAccountContract({ classHash: classHash, addressSalt: addressSalt, constructorCalldata: constructorCalldata, signature: signature }, {
+                                nonce: nonce,
+                                maxFee: maxFee,
+                                version: version,
+                            })];
+                }
+            });
+        });
+    };
     Account.prototype.signMessage = function (typedData) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -207,13 +392,6 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
-    /**
-     * Hash a JSON object with pederson hash and return the hash
-     *
-     * @param json - JSON object to be hashed
-     * @returns the hash of the JSON object
-     * @throws {Error} if the JSON object is not a valid JSON
-     */
     Account.prototype.hashMessage = function (typedData) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -221,15 +399,6 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
-    /**
-     * Verify a signature of a given hash
-     * @warning This method is not recommended, use verifyMessage instead
-     *
-     * @param hash - JSON object to be verified
-     * @param signature - signature of the JSON object
-     * @returns true if the signature is valid, false otherwise
-     * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
-     */
     Account.prototype.verifyMessageHash = function (hash, signature) {
         return __awaiter(this, void 0, void 0, function () {
             var _a;
@@ -256,14 +425,6 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
-    /**
-     * Verify a signature of a JSON object
-     *
-     * @param hash - hash to be verified
-     * @param signature - signature of the hash
-     * @returns true if the signature is valid, false otherwise
-     * @throws {Error} if the signature is not a valid signature
-     */
     Account.prototype.verifyMessage = function (typedData, signature) {
         return __awaiter(this, void 0, void 0, function () {
             var hash;
@@ -277,6 +438,39 @@ var Account = /** @class */ (function (_super) {
             });
         });
     };
+    Account.prototype.getSuggestedMaxFee = function (estimateFeeAction, details) {
+        return __awaiter(this, void 0, void 0, function () {
+            var feeEstimate, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = estimateFeeAction.type;
+                        switch (_a) {
+                            case 'INVOKE': return [3 /*break*/, 1];
+                            case 'DECLARE': return [3 /*break*/, 3];
+                            case 'DEPLOY_ACCOUNT': return [3 /*break*/, 5];
+                        }
+                        return [3 /*break*/, 7];
+                    case 1: return [4 /*yield*/, this.estimateInvokeFee(estimateFeeAction.payload, details)];
+                    case 2:
+                        feeEstimate = _b.sent();
+                        return [3 /*break*/, 8];
+                    case 3: return [4 /*yield*/, this.estimateDeclareFee(estimateFeeAction.payload, details)];
+                    case 4:
+                        feeEstimate = _b.sent();
+                        return [3 /*break*/, 8];
+                    case 5: return [4 /*yield*/, this.estimateAccountDeployFee(estimateFeeAction.payload, details)];
+                    case 6:
+                        feeEstimate = _b.sent();
+                        return [3 /*break*/, 8];
+                    case 7:
+                        feeEstimate = { suggestedMaxFee: constants_1.ZERO, overall_fee: constants_1.ZERO };
+                        return [3 /*break*/, 8];
+                    case 8: return [2 /*return*/, feeEstimate.suggestedMaxFee.toString()];
+                }
+            });
+        });
+    };
     return Account;
 }(default_1.Provider));
 exports.Account = Account;

package/account/interface.d.ts

@@ -1,24 +1,56 @@
 import { ProviderInterface } from '../provider';
 import { BlockIdentifier } from '../provider/utils';
 import { SignerInterface } from '../signer';
-import { Abi, Call, EstimateFeeDetails, EstimateFeeResponse, InvocationsDetails, InvokeFunctionResponse, Signature } from '../types';
+import { Abi, Call, DeclareContractResponse, DeployContractResponse, EstimateFeeAction, EstimateFeeDetails, EstimateFeeResponse, InvocationsDetails, InvokeFunctionResponse, Signature } from '../types';
+import { AllowArray, DeclareContractPayload, DeployAccountContractPayload } from '../types/lib';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData/types';
 export declare abstract class AccountInterface extends ProviderInterface {
     abstract address: string;
     abstract signer: SignerInterface;
     /**
-     * Estimate Fee for a method on starknet
+     * @deprecated Use estimateInvokeFee or estimateDeclareFee instead
+     * Estimate Fee for executing an INVOKE transaction on starknet
      *
-     * @param invocation the invocation object containing:
+     * @param calls the invocation object containing:
      * - contractAddress - the address of the contract
      * - entrypoint - the entrypoint of the contract
      * - calldata - (defaults to []) the calldata
-     * - signature - (defaults to []) the signature
      *
-     * @returns response from addTransaction
+     * @returns response from estimate_fee
+     */
+    abstract estimateFee(calls: AllowArray<Call>, estimateFeeDetails?: EstimateFeeDetails): Promise<EstimateFeeResponse>;
+    /**
+     * Estimate Fee for executing an INVOKE transaction on starknet
+     *
+     * @param calls the invocation object containing:
+     * - contractAddress - the address of the contract
+     * - entrypoint - the entrypoint of the contract
+     * - calldata - (defaults to []) the calldata
+     *
+     * @returns response from estimate_fee
+     */
+    abstract estimateInvokeFee(calls: AllowArray<Call>, estimateFeeDetails?: EstimateFeeDetails): Promise<EstimateFeeResponse>;
+    /**
+     * Estimate Fee for executing a DECLARE transaction on starknet
+     *
+     * @param contractPayload the payload object containing:
+     * - contract - the compiled contract to be declared
+     * - classHash - the class hash of the compiled contract. This can be obtained by using starknet-cli.
+     *
+     * @returns response from estimate_fee
      */
-    abstract estimateFee(calls: Call | Call[], estimateFeeDetails?: EstimateFeeDetails): Promise<EstimateFeeResponse>;
+    abstract estimateDeclareFee(contractPayload: DeclareContractPayload, estimateFeeDetails?: EstimateFeeDetails): Promise<EstimateFeeResponse>;
+    /**
+     * Estimate Fee for executing a DEPLOY_ACCOUNT transaction on starknet
+     *
+     * @param contractPayload the payload object containing:
+     * - contract - the compiled contract to be declared
+     * - classHash - the class hash of the compiled contract. This can be obtained by using starknet-cli.
+     *
+     * @returns response from estimate_fee
+     */
+    abstract estimateAccountDeployFee(contractPayload: DeployAccountContractPayload, estimateFeeDetails?: EstimateFeeDetails): Promise<EstimateFeeResponse>;
     /**
      * Invoke execute function in account contract
      *
@@ -31,7 +63,34 @@ export declare abstract class AccountInterface extends ProviderInterface {
      *
      * @returns response from addTransaction
      */
-    abstract execute(transactions: Call | Call[], abis?: Abi[], transactionsDetail?: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    abstract execute(transactions: AllowArray<Call>, abis?: Abi[], transactionsDetail?: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    /**
+     * Declares a given compiled contract (json) to starknet
+     * @param contractPayload transaction payload to be deployed containing:
+    - contract: compiled contract code
+    - classHash: computed class hash of compiled contract
+    - signature
+     * @param transactionsDetail Invocation Details containing:
+    - optional nonce
+    - optional version
+    - optional maxFee
+     * @returns a confirmation of sending a transaction on the starknet contract
+     */
+    abstract declare(contractPayload: DeclareContractPayload, transactionsDetail?: InvocationsDetails): Promise<DeclareContractResponse>;
+    /**
+     * Deploy the account on Starknet
+     * @param contractPayload transaction payload to be deployed containing:
+     * - classHash: computed class hash of compiled contract
+     * - constructor calldata
+     * - address salt
+    - signature
+     * @param transactionsDetail Invocation Details containing:
+    - optional nonce
+    - optional version
+    - optional maxFee
+     * @returns a confirmation of sending a transaction on the starknet contract
+     */
+    abstract deployAccount(contractPayload: DeployAccountContractPayload, transactionsDetail?: InvocationsDetails): Promise<DeployContractResponse>;
     /**
      * Sign an JSON object for off-chain usage with the starknet private key and return the signature
      * This adds a message prefix so it cant be interchanged with transactions
@@ -69,5 +128,17 @@ export declare abstract class AccountInterface extends ProviderInterface {
      * @throws {Error} if the signature is not a valid signature
      */
     abstract verifyMessageHash(hash: BigNumberish, signature: Signature): Promise<boolean>;
+    /**
+     * Gets the nonce of the account with respect to a specific block
+     * @param  {BlockIdentifier} blockIdentifier - optional blockIdentifier. Defaults to 'pending'
+     * @returns nonce of the account
+     */
     abstract getNonce(blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
+    /**
+     * Gets Suggested Max Fee based on the transaction type
+     * @param  {EstimateFeeAction} estimateFeeAction
+     * @param  {EstimateFeeDetails} details
+     * @returns suggestedMaxFee
+     */
+    abstract getSuggestedMaxFee(estimateFeeAction: EstimateFeeAction, details: EstimateFeeDetails): Promise<BigNumberish>;
 }

package/constants.d.ts

@@ -12,6 +12,7 @@ export declare enum StarknetChainId {
 export declare enum TransactionHashPrefix {
     DECLARE = "0x6465636c617265",
     DEPLOY = "0x6465706c6f79",
+    DEPLOY_ACCOUNT = "0x6465706c6f795f6163636f756e74",
     INVOKE = "0x696e766f6b65",
     L1_HANDLER = "0x6c315f68616e646c6572"
 }

package/constants.js

@@ -18,6 +18,7 @@ var TransactionHashPrefix;
 (function (TransactionHashPrefix) {
     TransactionHashPrefix["DECLARE"] = "0x6465636c617265";
     TransactionHashPrefix["DEPLOY"] = "0x6465706c6f79";
+    TransactionHashPrefix["DEPLOY_ACCOUNT"] = "0x6465706c6f795f6163636f756e74";
     TransactionHashPrefix["INVOKE"] = "0x696e766f6b65";
     TransactionHashPrefix["L1_HANDLER"] = "0x6c315f68616e646c6572";
 })(TransactionHashPrefix = exports.TransactionHashPrefix || (exports.TransactionHashPrefix = {}));

package/contract/default.js

@@ -181,7 +181,7 @@ var Contract = /** @class */ (function () {
     function Contract(abi, address, providerOrAccount) {
         if (providerOrAccount === void 0) { providerOrAccount = provider_1.defaultProvider; }
         var _this = this;
-        this.address = address.toLowerCase();
+        this.address = address && address.toLowerCase();
         this.providerOrAccount = providerOrAccount;
         this.abi = abi;
         this.structs = abi
@@ -566,7 +566,7 @@ var Contract = /** @class */ (function () {
         if (args === void 0) { args = []; }
         if (options === void 0) { options = {}; }
         // ensure contract is connected
-        (0, minimalistic_assert_1.default)(this.address !== null, 'contract isnt connected to an address');
+        (0, minimalistic_assert_1.default)(this.address !== null, 'contract is not connected to an address');
         // validate method and args
         this.validateMethodAndArgs('INVOKE', method, args);
         var inputs = this.abi.find(function (abi) { return abi.name === method; }).inputs;
@@ -609,7 +609,7 @@ var Contract = /** @class */ (function () {
             var _this = this;
             return __generator(this, function (_d) {
                 // ensure contract is connected
-                (0, minimalistic_assert_1.default)(this.address !== null, 'contract isnt connected to an address');
+                (0, minimalistic_assert_1.default)(this.address !== null, 'contract is not connected to an address');
                 // validate method and args
                 this.validateMethodAndArgs('CALL', method, args);
                 inputs = this.abi.find(function (abi) { return abi.name === method; }).inputs;
@@ -631,12 +631,12 @@ var Contract = /** @class */ (function () {
             var _a;
             return __generator(this, function (_b) {
                 // ensure contract is connected
-                (0, minimalistic_assert_1.default)(this.address !== null, 'contract isnt connected to an address');
+                (0, minimalistic_assert_1.default)(this.address !== null, 'contract is not connected to an address');
                 // validate method and args
                 this.validateMethodAndArgs('INVOKE', method, args);
                 invocation = (_a = this.populateTransaction)[method].apply(_a, __spreadArray([], __read(args), false));
-                if ('estimateFee' in this.providerOrAccount) {
-                    return [2 /*return*/, this.providerOrAccount.estimateFee(invocation)];
+                if ('estimateInvokeFee' in this.providerOrAccount) {
+                    return [2 /*return*/, this.providerOrAccount.estimateInvokeFee(invocation)];
                 }
                 throw Error('Contract must be connected to the account contract to estimate');
             });

package/dist/account/default.d.ts

@@ -2,8 +2,9 @@ import { ProviderInterface, ProviderOptions } from '../provider';
 import { Provider } from '../provider/default';
 import { BlockIdentifier } from '../provider/utils';
 import { SignerInterface } from '../signer';
-import { Abi, Call, InvocationsDetails, InvokeFunctionResponse, KeyPair, Signature } from '../types';
+import { Abi, Call, DeclareContractResponse, DeployContractResponse, EstimateFeeAction, InvocationsDetails, InvokeFunctionResponse, KeyPair, Signature } from '../types';
 import { EstimateFee, EstimateFeeDetails } from '../types/account';
+import { AllowArray, DeclareContractPayload, DeployAccountContractPayload } from '../types/lib';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData';
 import { AccountInterface } from './interface';
@@ -12,51 +13,16 @@ export declare class Account extends Provider implements AccountInterface {
     address: string;
     constructor(providerOrOptions: ProviderOptions | ProviderInterface, address: string, keyPairOrSigner: KeyPair | SignerInterface);
     getNonce(blockIdentifier?: BlockIdentifier): Promise<BigNumberish>;
-    estimateFee(calls: Call | Call[], { nonce: providedNonce, blockIdentifier }?: EstimateFeeDetails): Promise<EstimateFee>;
-    /**
-     * Invoke execute function in account contract
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/gateway/gateway_client.py#L13-L17)
-     *
-     * @param calls - one or more calls to be executed
-     * @param abis - one or more abis which can be used to display the calls
-     * @param transactionsDetail - optional transaction details
-     * @returns a confirmation of invoking a function on the starknet contract
-     */
-    execute(calls: Call | Call[], abis?: Abi[] | undefined, transactionsDetail?: InvocationsDetails): Promise<InvokeFunctionResponse>;
-    /**
-     * Sign an JSON object with the starknet private key and return the signature
-     *
-     * @param json - JSON object to be signed
-     * @returns the signature of the JSON object
-     * @throws {Error} if the JSON object is not a valid JSON
-     */
+    estimateFee(calls: AllowArray<Call>, estimateFeeDetails?: EstimateFeeDetails | undefined): Promise<EstimateFee>;
+    estimateInvokeFee(calls: AllowArray<Call>, { nonce: providedNonce, blockIdentifier }?: EstimateFeeDetails): Promise<EstimateFee>;
+    estimateDeclareFee({ classHash, contract }: DeclareContractPayload, { blockIdentifier, nonce: providedNonce }?: EstimateFeeDetails): Promise<EstimateFee>;
+    estimateAccountDeployFee({ classHash, addressSalt, constructorCalldata, contractAddress: providedContractAddress, }: DeployAccountContractPayload, { blockIdentifier, nonce: providedNonce }?: EstimateFeeDetails): Promise<EstimateFee>;
+    execute(calls: AllowArray<Call>, abis?: Abi[] | undefined, transactionsDetail?: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    declare({ classHash, contract }: DeclareContractPayload, transactionsDetail?: InvocationsDetails): Promise<DeclareContractResponse>;
+    deployAccount({ classHash, constructorCalldata, addressSalt, contractAddress: providedContractAddress, }: DeployAccountContractPayload, transactionsDetail?: InvocationsDetails): Promise<DeployContractResponse>;
     signMessage(typedData: TypedData): Promise<Signature>;
-    /**
-     * Hash a JSON object with pederson hash and return the hash
-     *
-     * @param json - JSON object to be hashed
-     * @returns the hash of the JSON object
-     * @throws {Error} if the JSON object is not a valid JSON
-     */
     hashMessage(typedData: TypedData): Promise<string>;
-    /**
-     * Verify a signature of a given hash
-     * @warning This method is not recommended, use verifyMessage instead
-     *
-     * @param hash - JSON object to be verified
-     * @param signature - signature of the JSON object
-     * @returns true if the signature is valid, false otherwise
-     * @throws {Error} if the JSON object is not a valid JSON or the signature is not a valid signature
-     */
     verifyMessageHash(hash: BigNumberish, signature: Signature): Promise<boolean>;
-    /**
-     * Verify a signature of a JSON object
-     *
-     * @param hash - hash to be verified
-     * @param signature - signature of the hash
-     * @returns true if the signature is valid, false otherwise
-     * @throws {Error} if the signature is not a valid signature
-     */
     verifyMessage(typedData: TypedData, signature: Signature): Promise<boolean>;
+    getSuggestedMaxFee(estimateFeeAction: EstimateFeeAction, details: EstimateFeeDetails): Promise<string>;
 }