starknet 4.7.0 → 4.9.0

package/types/api/sequencer.d.ts

@@ -1,8 +1,7 @@
 import BN from 'bn.js';
 import { BlockIdentifier } from '../../provider/utils';
 import { BigNumberish } from '../../utils/number';
-import { Abi, BlockNumber, EntryPointType, RawCalldata, Signature, Status, TransactionStatus } from '../lib';
-import { ContractClass } from '../provider';
+import { Abi, BlockNumber, ContractClass, EntryPointType, RawCalldata, Signature, Status, TransactionStatus } from '../lib';
 export declare type GetTransactionStatusResponse = {
     tx_status: Status;
     block_hash?: string;
@@ -15,15 +14,17 @@ export declare type GetContractAddressesResponse = {
     Starknet: string;
     GpsStatementVerifier: string;
 };
-export declare type InvokeFunctionTrace = {
+export declare type FunctionInvocation = {
     caller_address: string;
     contract_address: string;
-    code_address: string;
-    selector: string;
     calldata: RawCalldata;
+    call_type?: string;
+    class_hash?: string;
+    selector?: string;
+    entry_point_type?: EntryPointType;
     result: Array<any>;
     execution_resources: ExecutionResources;
-    internal_call: Array<InvokeFunctionTrace>;
+    internal_calls: Array<FunctionInvocation>;
     events: Array<any>;
     messages: Array<any>;
 };
@@ -40,18 +41,9 @@ export declare type ExecutionResources = {
     n_memory_holes: number;
 };
 export declare type GetTransactionTraceResponse = {
-    function_invocation: {
-        caller_address: string;
-        contract_address: string;
-        code_address: string;
-        selector: string;
-        calldata: RawArgs;
-        result: Array<any>;
-        execution_resources: ExecutionResources;
-        internal_call: Array<any>;
-        events: Array<any>;
-        messages: Array<any>;
-    };
+    validate_invocation?: FunctionInvocation;
+    function_invocation?: FunctionInvocation;
+    fee_transfer_invocation?: FunctionInvocation;
     signature: Signature;
 };
 export declare type RawArgs = {
@@ -60,13 +52,21 @@ export declare type RawArgs = {
         [k: string]: BigNumberish;
     };
 };
+export declare type CallL1Handler = {
+    from_address: string;
+    to_address: string;
+    entry_point_selector: string;
+    payload: Array<string>;
+};
 export declare namespace Sequencer {
     type DeclareTransaction = {
         type: 'DECLARE';
+        sender_address: string;
         contract_class: ContractClass;
+        signature?: Signature;
         nonce: BigNumberish;
-        sender_address: BigNumberish;
-        signature: Signature;
+        max_fee?: BigNumberish;
+        version?: BigNumberish;
     };
     type DeployTransaction = {
         type: 'DEPLOY';
@@ -75,6 +75,16 @@ export declare namespace Sequencer {
         constructor_calldata: string[];
         nonce?: BigNumberish;
     };
+    type DeployAccountTransaction = {
+        type: 'DEPLOY_ACCOUNT';
+        class_hash: string;
+        contract_address_salt: BigNumberish;
+        constructor_calldata: string[];
+        signature?: Signature;
+        max_fee?: BigNumberish;
+        version?: BigNumberish;
+        nonce?: BigNumberish;
+    };
     type InvokeFunctionTransaction = {
         type: 'INVOKE_FUNCTION';
         contract_address: string;
@@ -85,7 +95,7 @@ export declare namespace Sequencer {
         max_fee?: BigNumberish;
         version?: BigNumberish;
     };
-    type Transaction = DeclareTransaction | DeployTransaction | InvokeFunctionTransaction;
+    type Transaction = DeclareTransaction | DeployTransaction | InvokeFunctionTransaction | DeployAccountTransaction;
     type AddTransactionResponse = {
         transaction_hash: string;
         code?: TransactionStatus;
@@ -165,6 +175,7 @@ export declare namespace Sequencer {
         status: Status;
         gas_price: string;
         sequencer_address: string;
+        starknet_version: string;
     };
     type CallContractTransaction = Omit<InvokeFunctionTransaction, 'type' | 'entry_point_type' | 'nonce'> & {
         entry_point_selector: string;
@@ -172,7 +183,11 @@ export declare namespace Sequencer {
     type CallContractResponse = {
         result: string[];
     };
-    type EstimateFeeTransaction = Omit<InvokeFunctionTransaction, 'max_fee' | 'entry_point_type'>;
+    type InvokeEstimateFee = Omit<InvokeFunctionTransaction, 'max_fee' | 'entry_point_type'>;
+    type DeclareEstimateFee = Omit<DeclareTransaction, 'max_fee'>;
+    type DeployAccountEstimateFee = Omit<DeployAccountTransaction, 'max_fee'>;
+    type DeployEstimateFee = DeployTransaction;
+    type EstimateFeeRequest = InvokeEstimateFee | DeclareEstimateFee | DeployEstimateFee | DeployAccountEstimateFee;
     type EstimateFeeResponse = {
         overall_fee: number;
         gas_price: number;
@@ -263,7 +278,7 @@ export declare namespace Sequencer {
             QUERY: {
                 blockIdentifier: BlockIdentifier;
             };
-            REQUEST: EstimateFeeTransaction;
+            REQUEST: EstimateFeeRequest;
             RESPONSE: EstimateFeeResponse;
         };
         get_class_by_hash: {
@@ -296,5 +311,10 @@ export declare namespace Sequencer {
             REQUEST: never;
             RESPONSE: any;
         };
+        estimate_message_fee: {
+            QUERY: any;
+            REQUEST: any;
+            RESPONSE: EstimateFeeResponse;
+        };
     };
 }

package/types/lib.d.ts

@@ -1,16 +1,37 @@
 import type { ec as EC } from 'elliptic';
 import type { BigNumberish } from '../utils/number';
+import { RPC } from './api/rpc';
 export declare type KeyPair = EC.KeyPair;
 export declare type Signature = string[];
 export declare type RawCalldata = BigNumberish[];
+export declare type AllowArray<T> = T | T[];
+export interface ContractClass {
+    program: CompressedProgram;
+    entry_points_by_type: RPC.ContractClass['entry_points_by_type'];
+    abi?: Abi;
+}
 export declare type DeployContractPayload = {
     contract: CompiledContract | string;
     constructorCalldata?: RawCalldata;
     addressSalt?: string;
 };
+export declare type DeployAccountContractPayload = {
+    classHash: BigNumberish;
+    constructorCalldata?: RawCalldata;
+    addressSalt?: BigNumberish;
+    contractAddress?: string;
+};
+export declare type DeployAccountContractTransaction = Omit<DeployAccountContractPayload, 'contractAddress'> & {
+    signature?: Signature;
+};
 export declare type DeclareContractPayload = {
     contract: CompiledContract | string;
-    version?: BigNumberish;
+    classHash: BigNumberish;
+};
+export declare type DeclareContractTransaction = {
+    contractDefinition: ContractClass;
+    senderAddress: string;
+    signature?: Signature;
 };
 export declare type CallDetails = {
     contractAddress: string;
@@ -32,7 +53,7 @@ export declare type InvocationsDetailsWithNonce = InvocationsDetails & {
 };
 export declare type Status = 'NOT_RECEIVED' | 'RECEIVED' | 'PENDING' | 'ACCEPTED_ON_L2' | 'ACCEPTED_ON_L1' | 'REJECTED';
 export declare type TransactionStatus = 'TRANSACTION_RECEIVED';
-export declare type Type = 'DECLARE' | 'DEPLOY' | 'INVOKE_FUNCTION';
+export declare type TransactionType = 'DECLARE' | 'DEPLOY' | 'INVOKE_FUNCTION' | 'DEPLOY_ACCOUNT';
 export declare type EntryPointType = 'EXTERNAL';
 export declare type CompressedProgram = string;
 export declare type AbiEntry = {

package/types/provider.d.ts

@@ -3,8 +3,7 @@
  * Intersection (sequencer response ∩ (∪ rpc responses))
  */
 import BN from 'bn.js';
-import { RPC } from './api/rpc';
-import { Abi, CompressedProgram, RawCalldata, Signature, Status } from './lib';
+import { AllowArray, Call, DeclareContractPayload, DeployAccountContractPayload, RawCalldata, Signature, Status } from './lib';
 export interface GetBlockResponse {
     timestamp: number;
     block_hash: string;
@@ -13,6 +12,10 @@ export interface GetBlockResponse {
     parent_hash: string;
     status: Status;
     transactions: Array<string>;
+    gas_price?: string;
+    sequencer_address?: string;
+    starknet_version?: string;
+    transaction_receipts?: any;
 }
 export interface GetCodeResponse {
     bytecode: string[];
@@ -34,11 +37,6 @@ export interface ContractEntryPoint {
     offset: string;
     selector: string;
 }
-export interface ContractClass {
-    program: CompressedProgram;
-    entry_points_by_type: RPC.ContractClass['entry_points_by_type'];
-    abi?: Abi;
-}
 export interface DeclareTransactionResponse extends CommonTransactionResponse {
     contract_class?: any;
     sender_address?: string;
@@ -46,7 +44,7 @@ export interface DeclareTransactionResponse extends CommonTransactionResponse {
 export declare type GetTransactionReceiptResponse = InvokeTransactionReceiptResponse | DeclareTransactionReceiptResponse;
 export interface CommonTransactionReceiptResponse {
     transaction_hash: string;
-    status: Status;
+    status?: Status;
     actual_fee?: string;
     status_data?: string;
 }
@@ -64,8 +62,9 @@ export interface MessageToL2 {
     payload: Array<string>;
 }
 export interface InvokeTransactionReceiptResponse extends CommonTransactionReceiptResponse {
-    messages_sent: Array<MessageToL1>;
-    events: Array<Event>;
+    /** @deprecated Use l2_to_l1_messages */
+    messages_sent?: Array<MessageToL1>;
+    events?: Array<Event>;
     l1_origin_message?: MessageToL2;
 }
 export declare type DeclareTransactionReceiptResponse = CommonTransactionReceiptResponse;
@@ -88,3 +87,13 @@ export interface DeclareContractResponse {
 export declare type CallContractResponse = {
     result: Array<string>;
 };
+export declare type EstimateFeeAction = {
+    type: 'INVOKE';
+    payload: AllowArray<Call>;
+} | {
+    type: 'DECLARE';
+    payload: DeclareContractPayload;
+} | {
+    type: 'DEPLOY_ACCOUNT';
+    payload: DeployAccountContractPayload;
+};

package/types/signer.d.ts

@@ -1,6 +1,19 @@
 import { StarknetChainId } from '../constants';
-import { InvocationsDetails } from './lib';
+import { BigNumberish } from '../utils/number';
+import { DeployAccountContractPayload, InvocationsDetails } from './lib';
 export interface InvocationsSignerDetails extends Required<InvocationsDetails> {
     walletAddress: string;
     chainId: StarknetChainId;
 }
+export interface DeclareSignerDetails {
+    classHash: BigNumberish;
+    senderAddress: BigNumberish;
+    chainId: StarknetChainId;
+    maxFee: BigNumberish;
+    version: BigNumberish;
+    nonce: BigNumberish;
+}
+export declare type DeployAccountSignerDetails = Required<DeployAccountContractPayload> & Required<InvocationsDetails> & {
+    contractAddress: BigNumberish;
+    chainId: StarknetChainId;
+};

package/utils/hash.d.ts

@@ -21,9 +21,17 @@ export declare function starknetKeccak(value: string): BN;
  * @returns hex selector of given abi function name
  */
 export declare function getSelectorFromName(funcName: string): string;
+/**
+ * Function to get hex selector from function name, decimal string or hex string
+ * @param value hex string | decimal string | string
+ * @returns Hex selector
+ */
+export declare function getSelector(value: string): string;
 export declare function pedersen(input: [BigNumberish, BigNumberish]): string;
 export declare function computeHashOnElements(data: BigNumberish[]): string;
 export declare function calculateTransactionHashCommon(txHashPrefix: TransactionHashPrefix, version: BigNumberish, contractAddress: BigNumberish, entryPointSelector: BigNumberish, calldata: BigNumberish[], maxFee: BigNumberish, chainId: StarknetChainId, additionalData?: BigNumberish[]): string;
 export declare function calculateDeployTransactionHash(contractAddress: BigNumberish, constructorCalldata: BigNumberish[], version: BigNumberish, chainId: StarknetChainId): string;
+export declare function calculateDeclareTransactionHash(classHash: BigNumberish, senderAddress: BigNumberish, version: BigNumberish, maxFee: BigNumberish, chainId: StarknetChainId, nonce: BigNumberish): string;
+export declare function calculateDeployAccountTransactionHash(contractAddress: BigNumberish, classHash: BigNumberish, constructorCalldata: BigNumberish[], salt: BigNumberish, version: BigNumberish, maxFee: BigNumberish, chainId: StarknetChainId, nonce: BigNumberish): string;
 export declare function calculateTransactionHash(contractAddress: BigNumberish, version: BigNumberish, calldata: BigNumberish[], maxFee: BigNumberish, chainId: StarknetChainId, nonce: BigNumberish): string;
 export declare function calculateContractAddressFromHash(salt: BigNumberish, classHash: BigNumberish, constructorCalldata: RawCalldata, deployerAddress: BigNumberish): string;

package/utils/hash.js

@@ -28,7 +28,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateContractAddressFromHash = exports.calculateTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelectorFromName = exports.starknetKeccak = exports.keccakBn = exports.feeTransactionVersion = exports.transactionVersion = void 0;
+exports.calculateContractAddressFromHash = exports.calculateTransactionHash = exports.calculateDeployAccountTransactionHash = exports.calculateDeclareTransactionHash = exports.calculateDeployTransactionHash = exports.calculateTransactionHashCommon = exports.computeHashOnElements = exports.pedersen = exports.getSelector = exports.getSelectorFromName = exports.starknetKeccak = exports.keccakBn = exports.feeTransactionVersion = exports.transactionVersion = void 0;
 var keccak_1 = require("ethereum-cryptography/keccak");
 var utils_1 = require("ethereum-cryptography/utils");
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
@@ -66,10 +66,25 @@ exports.starknetKeccak = starknetKeccak;
  * @returns hex selector of given abi function name
  */
 function getSelectorFromName(funcName) {
-    // sometimes BigInteger pads the hex string with zeros, which isnt allowed in the starknet api
+    // sometimes BigInteger pads the hex string with zeros, which is not allowed in the starknet api
     return (0, number_1.toHex)(starknetKeccak(funcName));
 }
 exports.getSelectorFromName = getSelectorFromName;
+/**
+ * Function to get hex selector from function name, decimal string or hex string
+ * @param value hex string | decimal string | string
+ * @returns Hex selector
+ */
+function getSelector(value) {
+    if ((0, number_1.isHex)(value)) {
+        return value;
+    }
+    if ((0, number_1.isStringWholeNumber)(value)) {
+        return (0, number_1.toHexString)(value);
+    }
+    return getSelectorFromName(value);
+}
+exports.getSelector = getSelector;
 var constantPoints = constants_1.CONSTANT_POINTS.map(function (coords) {
     return ellipticCurve_1.ec.curve.point(coords[0], coords[1]);
 });
@@ -117,6 +132,17 @@ function calculateDeployTransactionHash(contractAddress, constructorCalldata, ve
     return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.DEPLOY, version, contractAddress, getSelectorFromName('constructor'), constructorCalldata, constants_1.ZERO, chainId);
 }
 exports.calculateDeployTransactionHash = calculateDeployTransactionHash;
+function calculateDeclareTransactionHash(
+// contractClass: ContractClass, // Should be used once class hash is present in ContractClass
+classHash, senderAddress, version, maxFee, chainId, nonce) {
+    return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.DECLARE, version, senderAddress, 0, [classHash], maxFee, chainId, [nonce]);
+}
+exports.calculateDeclareTransactionHash = calculateDeclareTransactionHash;
+function calculateDeployAccountTransactionHash(contractAddress, classHash, constructorCalldata, salt, version, maxFee, chainId, nonce) {
+    var calldata = __spreadArray([classHash, salt], __read(constructorCalldata), false);
+    return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.DEPLOY_ACCOUNT, version, contractAddress, 0, calldata, maxFee, chainId, [nonce]);
+}
+exports.calculateDeployAccountTransactionHash = calculateDeployAccountTransactionHash;
 function calculateTransactionHash(contractAddress, version, calldata, maxFee, chainId, nonce) {
     return calculateTransactionHashCommon(constants_1.TransactionHashPrefix.INVOKE, version, contractAddress, 0, calldata, maxFee, chainId, [nonce]);
 }

package/utils/merkle.js

@@ -27,6 +27,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.proofMerklePath = exports.MerkleTree = void 0;
 var hash_1 = require("./hash");
+var number_1 = require("./number");
 var MerkleTree = /** @class */ (function () {
     function MerkleTree(leafHashes) {
         this.branches = [];
@@ -43,7 +44,7 @@ var MerkleTree = /** @class */ (function () {
         var newLeaves = [];
         for (var i = 0; i < leaves.length; i += 2) {
             if (i + 1 === leaves.length) {
-                newLeaves.push(leaves[i]);
+                newLeaves.push(MerkleTree.hash(leaves[i], '0x0'));
             }
             else {
                 newLeaves.push(MerkleTree.hash(leaves[i], leaves[i + 1]));
@@ -52,7 +53,7 @@ var MerkleTree = /** @class */ (function () {
         return this.build(newLeaves);
     };
     MerkleTree.hash = function (a, b) {
-        var _a = __read([a, b].sort(), 2), aSorted = _a[0], bSorted = _a[1];
+        var _a = __read([(0, number_1.toBN)(a), (0, number_1.toBN)(b)].sort(function (x, y) { return (x.gte(y) ? 1 : -1); }), 2), aSorted = _a[0], bSorted = _a[1];
         return (0, hash_1.pedersen)([aSorted, bSorted]);
     };
     MerkleTree.prototype.getProof = function (leaf, branch, hashPath) {
@@ -73,9 +74,7 @@ var MerkleTree = /** @class */ (function () {
             ? -1
             : this.branches.findIndex(function (b) { return b.length === branch.length; });
         var nextBranch = (_b = this.branches[currentBranchLevelIndex + 1]) !== null && _b !== void 0 ? _b : [this.root];
-        return this.getProof(neededBranch === '0x0'
-            ? leaf
-            : MerkleTree.hash(isLeft ? leaf : neededBranch, isLeft ? neededBranch : leaf), nextBranch, newHashPath);
+        return this.getProof(MerkleTree.hash(isLeft ? leaf : neededBranch, isLeft ? neededBranch : leaf), nextBranch, newHashPath);
     };
     return MerkleTree;
 }());

package/utils/number.d.ts

@@ -8,3 +8,8 @@ export declare function toFelt(num: BigNumberish): string;
 export declare function assertInRange(input: BigNumberish, lowerBound: BigNumberish, upperBound: BigNumberish, inputName?: string): void;
 export declare function bigNumberishArrayToDecimalStringArray(rawCalldata: BigNumberish[]): string[];
 export declare function bigNumberishArrayToHexadecimalStringArray(rawCalldata: BigNumberish[]): string[];
+export declare const isStringWholeNumber: (value: string) => boolean;
+export declare const toHexString: (value: string) => string;
+export declare function getDecimalString(value: string): string;
+export declare function getHexString(value: string): string;
+export declare function getHexStringArray(value: Array<string>): string[];

package/utils/number.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bigNumberishArrayToHexadecimalStringArray = exports.bigNumberishArrayToDecimalStringArray = exports.assertInRange = exports.toFelt = exports.hexToDecimalString = exports.toHex = exports.toBN = exports.isHex = void 0;
+exports.getHexStringArray = exports.getHexString = exports.getDecimalString = exports.toHexString = exports.isStringWholeNumber = exports.bigNumberishArrayToHexadecimalStringArray = exports.bigNumberishArrayToDecimalStringArray = exports.assertInRange = exports.toFelt = exports.hexToDecimalString = exports.toHex = exports.toBN = exports.isHex = void 0;
 var bn_js_1 = __importStar(require("bn.js"));
 var minimalistic_assert_1 = __importDefault(require("minimalistic-assert"));
 var encode_1 = require("./encode");
@@ -80,3 +80,31 @@ function bigNumberishArrayToHexadecimalStringArray(rawCalldata) {
     return rawCalldata.map(function (x) { return toHex(toBN(x)); });
 }
 exports.bigNumberishArrayToHexadecimalStringArray = bigNumberishArrayToHexadecimalStringArray;
+var isStringWholeNumber = function (value) { return /^\d+$/.test(value); };
+exports.isStringWholeNumber = isStringWholeNumber;
+var toHexString = function (value) { return toHex(toBN(value)); };
+exports.toHexString = toHexString;
+function getDecimalString(value) {
+    if (isHex(value)) {
+        return hexToDecimalString(value);
+    }
+    if ((0, exports.isStringWholeNumber)(value)) {
+        return value;
+    }
+    throw new Error("".concat(value, " need to be hex-string or whole-number-string"));
+}
+exports.getDecimalString = getDecimalString;
+function getHexString(value) {
+    if (isHex(value)) {
+        return value;
+    }
+    if ((0, exports.isStringWholeNumber)(value)) {
+        return (0, exports.toHexString)(value);
+    }
+    throw new Error("".concat(value, " need to be hex-string or whole-number-string"));
+}
+exports.getHexString = getHexString;
+function getHexStringArray(value) {
+    return value.map(function (el) { return getHexString(el); });
+}
+exports.getHexStringArray = getHexStringArray;

package/utils/responseParser/rpc.d.ts

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

package/utils/responseParser/rpc.js

@@ -27,17 +27,6 @@ var RPCResponseParser = /** @class */ (function () {
             version: res.version,
         };
     };
-    RPCResponseParser.prototype.parseGetTransactionReceiptResponse = function (res) {
-        return {
-            transaction_hash: res.transaction_hash,
-            actual_fee: res.actual_fee,
-            status: res.status,
-            status_data: res.status_data,
-            messages_sent: res.messages_sent,
-            l1_origin_message: res.l1_origin_message,
-            events: res.events,
-        };
-    };
     RPCResponseParser.prototype.parseFeeEstimateResponse = function (res) {
         return {
             overall_fee: (0, number_1.toBN)(res.overall_fee),

package/utils/responseParser/sequencer.js

@@ -35,46 +35,24 @@ var SequencerAPIResponseParser = /** @class */ (function (_super) {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     SequencerAPIResponseParser.prototype.parseGetBlockResponse = function (res) {
-        return {
-            timestamp: res.timestamp,
-            block_hash: res.block_hash,
-            block_number: res.block_number,
-            new_root: res.state_root,
-            parent_hash: res.parent_block_hash,
-            status: res.status,
-            transactions: Object.values(res.transactions)
+        return __assign(__assign({}, res), { new_root: res.state_root, parent_hash: res.parent_block_hash, transactions: Object.values(res.transactions)
                 .map(function (value) { return 'transaction_hash' in value && value.transaction_hash; })
-                .filter(Boolean),
-        };
+                .filter(Boolean) });
     };
     SequencerAPIResponseParser.prototype.parseGetTransactionResponse = function (res) {
-        return {
-            calldata: 'calldata' in res.transaction ? res.transaction.calldata : [],
-            contract_address: 'contract_address' in res.transaction ? res.transaction.contract_address : undefined,
-            contract_class: 'contract_class' in res.transaction ? res.transaction.contract_class : undefined,
-            entry_point_selector: 'entry_point_selector' in res.transaction
+        return __assign(__assign({}, res), { calldata: 'calldata' in res.transaction ? res.transaction.calldata : [], contract_address: 'contract_address' in res.transaction ? res.transaction.contract_address : undefined, contract_class: 'contract_class' in res.transaction ? res.transaction.contract_class : undefined, entry_point_selector: 'entry_point_selector' in res.transaction
                 ? res.transaction.entry_point_selector
-                : undefined,
-            max_fee: 'max_fee' in res.transaction ? res.transaction.max_fee : undefined,
-            nonce: res.transaction.nonce,
-            sender_address: 'sender_address' in res.transaction
+                : undefined, max_fee: 'max_fee' in res.transaction ? res.transaction.max_fee : undefined, nonce: res.transaction.nonce, sender_address: 'sender_address' in res.transaction
                 ? res.transaction.sender_address
-                : undefined,
-            signature: 'signature' in res.transaction ? res.transaction.signature : undefined,
-            transaction_hash: 'transaction_hash' in res.transaction ? res.transaction.transaction_hash : undefined,
-            version: 'version' in res.transaction ? res.transaction.version : undefined,
-        };
+                : undefined, signature: 'signature' in res.transaction ? res.transaction.signature : undefined, transaction_hash: 'transaction_hash' in res.transaction ? res.transaction.transaction_hash : undefined, version: 'version' in res.transaction ? res.transaction.version : undefined });
     };
     SequencerAPIResponseParser.prototype.parseGetTransactionReceiptResponse = function (res) {
-        return {
-            transaction_hash: res.transaction_hash,
-            actual_fee: 'actual_fee' in res ? res.actual_fee : undefined,
-            status: res.status,
-            status_data: undefined,
-            messages_sent: res.l2_to_l1_messages,
-            events: res.events,
-            l1_origin_message: undefined,
-        };
+        return __assign(__assign(__assign(__assign(__assign(__assign(__assign({ transaction_hash: res.transaction_hash, status: res.status, messages_sent: res.l2_to_l1_messages, events: res.events }, ('block_hash' in res && { block_hash: res.block_hash })), ('block_number' in res && { block_number: res.block_number })), ('actual_fee' in res && { actual_fee: res.actual_fee })), ('transaction_index' in res && { transaction_index: res.transaction_index })), ('execution_resources' in res && { execution_resources: res.execution_resources })), ('l1_to_l2_consumed_message' in res && {
+            // eslint-disable-next-line @typescript-eslint/dot-notation
+            l1_to_l2_consumed_message: res['l1_to_l2_consumed_message'],
+        })), ('transaction_failure_reason' in res && {
+            transaction_failure_reason: res.transaction_failure_reason,
+        }));
     };
     SequencerAPIResponseParser.prototype.parseFeeEstimateResponse = function (res) {
         if ('overall_fee' in res) {

package/www/docs/API/account.md

@@ -30,7 +30,7 @@ Gets the new Nonce of the connected account for the next transaction.
 
 <hr />
 
-account.**estimateFee**(calls [ , options ]) => _Promise < EstimateFeeResponse >_
+account.**estimateInvokeFee**(calls [ , options ]) => _Promise < EstimateFeeResponse >_
 
 Gets the estimated fee for the call(s).
 
@@ -51,6 +51,27 @@ The _options_ object may include any of:
 
 <hr />
 
+account.**estimateDeclareFee**(contractPayload [ , options ]) => _Promise < EstimateFeeResponse >_
+
+Gets the estimated fee for the declare transaction.
+
+The _options_ object may include any of:
+
+- options.**blockIdentifier** - Block Identifier for the transaction
+- options.**nonce** - Nonce for the transaction
+
+###### _EstimateFeeResponse_
+
+```typescript
+{
+  overall_fee: BN;
+  gas_consumed?: BN;
+  gas_price?: BN;
+}
+```
+
+<hr />
+
 account.**execute**(calls [ , abi , transactionsDetail ]) => _Promise < AddTransactionResponse >_
 
 Executes one or multiple calls using the account contract.
@@ -71,6 +92,44 @@ The _transactionsDetail_ object may include any of:
 
 <hr />
 
+account.**declare**(payload [ , transactionsDetail ]) => _Promise < DeclareContractResponse >_
+
+The _payload_ object consists of:
+
+- payload.**contract** - The compiled contract
+- payload.**classHash** - Hash of the compiled contract
+
+The _transactionsDetail_ object may include any of:
+
+- transactionsDetail.**maxFee** - Max Fee that that will be used to execute the call(s)
+- transactionsDetail.**nonce** - Nonce for the transaction
+- transactionsDetail.**version** - Version for the transaction (default is 1)
+
+Declares a contract on Starknet.
+
+> _Note:_ Once the classHash is included in CompiledContract, this parameter can be removed. Currently it can be pre-computed from starknet-cli.
+
+Example:
+
+```typescript
+const declareTx = await account.declare({
+  contract: compiledErc20,
+  // classHash is pre-computed from starknet-cli
+  classHash: '0x54328a1075b8820eb43caf0caa233923148c983742402dcfc38541dd843d01a',
+});
+```
+
+###### _DeclareContractResponse_
+
+```typescript
+{
+  transaction_hash: string;
+  class_hash: string;
+};
+```
+
+<hr/>
+
 account.**signMessage**(typedData) => _Promise < Signature >_
 
 Creates a signature from the passed data.