starknet 4.8.0 → 4.10.0

package/account/default.js

@@ -61,6 +61,31 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Account = void 0;
 var constants_1 = require("../constants");
@@ -68,6 +93,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 +113,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 +153,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 +162,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 +290,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 +301,140 @@ 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.deploy = function (_a, additionalCalls, // support multicall
+    transactionsDetail) {
+        var classHash = _a.classHash, salt = _a.salt, _b = _a.unique, unique = _b === void 0 ? true : _b, _c = _a.constructorCalldata, constructorCalldata = _c === void 0 ? [] : _c, _d = _a.isDevnet, isDevnet = _d === void 0 ? false : _d;
+        if (additionalCalls === void 0) { additionalCalls = []; }
+        if (transactionsDetail === void 0) { transactionsDetail = {}; }
+        return __awaiter(this, void 0, void 0, function () {
+            var compiledConstructorCallData, callsArray;
+            return __generator(this, function (_e) {
+                compiledConstructorCallData = (0, stark_1.compileCalldata)(constructorCalldata);
+                callsArray = Array.isArray(additionalCalls) ? additionalCalls : [additionalCalls];
+                return [2 /*return*/, this.execute(__spreadArray([
+                        {
+                            contractAddress: isDevnet ? constants_1.UDC.ADDRESS_DEVNET : constants_1.UDC.ADDRESS,
+                            entrypoint: constants_1.UDC.ENTRYPOINT,
+                            calldata: __spreadArray([
+                                classHash,
+                                salt,
+                                (0, number_1.toCairoBool)(unique),
+                                compiledConstructorCallData.length
+                            ], __read(compiledConstructorCallData), false),
+                        }
+                    ], __read(callsArray), false), undefined, transactionsDetail)];
+            });
+        });
+    };
+    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 +442,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 +449,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 +475,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 +488,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, UniversalDeployerContractPayload } 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 deployed
+     * - 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,49 @@ 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>;
+    /**
+     * @param deployContractPayload containing
+     * - classHash: computed class hash of compiled contract
+     * - salt: address salt
+     * - unique: bool if true ensure unique salt
+     * - calldata: constructor calldata
+     * @param additionalCalls - optional additional calls array to support multicall
+     * @param transactionsDetail Invocation Details containing:
+     *  - optional nonce
+     *  - optional version
+     *  - optional maxFee
+     */
+    abstract deploy(deployContractPayload: UniversalDeployerContractPayload, additionalCalls?: AllowArray<Call>, transactionsDetail?: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    /**
+     * Deploy the account on Starknet
+     *
+     * @param contractPayload transaction payload to be deployed containing:
+    - classHash: computed class hash of compiled contract
+    - optional constructor calldata
+    - optional address salt
+    - optional contractAddress
+     * @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
@@ -53,7 +127,7 @@ export declare abstract class AccountInterface extends ProviderInterface {
     /**
      * Verify a signature of a JSON object
      *
-     * @param json - JSON object to be verified
+     * @param typedData - 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
@@ -69,5 +143,19 @@ 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

@@ -7,14 +7,21 @@ export declare const MASK_250: import("bn.js");
 export declare const MASK_251: import("bn.js");
 export declare enum StarknetChainId {
     MAINNET = "0x534e5f4d41494e",
-    TESTNET = "0x534e5f474f45524c49"
+    TESTNET = "0x534e5f474f45524c49",
+    TESTNET2 = "0x534e5f474f45524c4932"
 }
 export declare enum TransactionHashPrefix {
     DECLARE = "0x6465636c617265",
     DEPLOY = "0x6465706c6f79",
+    DEPLOY_ACCOUNT = "0x6465706c6f795f6163636f756e74",
     INVOKE = "0x696e766f6b65",
     L1_HANDLER = "0x6c315f68616e646c6572"
 }
+export declare const UDC: {
+    ADDRESS: string;
+    ENTRYPOINT: string;
+    ADDRESS_DEVNET: string;
+};
 /**
  * The following is taken from https://github.com/starkware-libs/starkex-resources/blob/master/crypto/starkware/crypto/signature/pedersen_params.json but converted to hex, because JS is very bad handling big integers by default
  * Please do not edit until the JSON changes.

package/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONSTANT_POINTS = exports.MAX_ECDSA_VAL = exports.BETA = exports.ALPHA = exports.EC_ORDER = exports.FIELD_SIZE = exports.FIELD_GEN = exports.FIELD_PRIME = exports.TransactionHashPrefix = exports.StarknetChainId = exports.MASK_251 = exports.MASK_250 = exports.TWO = exports.ONE = exports.ZERO = exports.IS_BROWSER = void 0;
+exports.CONSTANT_POINTS = exports.MAX_ECDSA_VAL = exports.BETA = exports.ALPHA = exports.EC_ORDER = exports.FIELD_SIZE = exports.FIELD_GEN = exports.FIELD_PRIME = exports.UDC = exports.TransactionHashPrefix = exports.StarknetChainId = exports.MASK_251 = exports.MASK_250 = exports.TWO = exports.ONE = exports.ZERO = exports.IS_BROWSER = void 0;
 var number_1 = require("./utils/number");
 var encode_1 = require("./utils/encode");
 Object.defineProperty(exports, "IS_BROWSER", { enumerable: true, get: function () { return encode_1.IS_BROWSER; } });
@@ -13,14 +13,21 @@ var StarknetChainId;
 (function (StarknetChainId) {
     StarknetChainId["MAINNET"] = "0x534e5f4d41494e";
     StarknetChainId["TESTNET"] = "0x534e5f474f45524c49";
+    StarknetChainId["TESTNET2"] = "0x534e5f474f45524c4932";
 })(StarknetChainId = exports.StarknetChainId || (exports.StarknetChainId = {}));
 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 = {}));
+exports.UDC = {
+    ADDRESS: '0x041a78e741e5af2fec34b695679bc6891742439f7afb8484ecd7766661ad02bf',
+    ENTRYPOINT: 'deployContract',
+    ADDRESS_DEVNET: '0x25fcb74260022bd8ed7e8d542408941826b53345e478b8303d6f31744838a36',
+};
 /**
  * The following is taken from https://github.com/starkware-libs/starkex-resources/blob/master/crypto/starkware/crypto/signature/pedersen_params.json but converted to hex, because JS is very bad handling big integers by default
  * Please do not edit until the JSON changes.