starknet 4.19.1 → 4.19.3

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [4.19.3](https://github.com/0xs34n/starknet.js/compare/v4.19.2...v4.19.3) (2023-01-12)
+
+### Bug Fixes
+
+- remove any type in simulateTransaction ([a94db18](https://github.com/0xs34n/starknet.js/commit/a94db1887c9fee676ac9b313190453abd5ea2554))
+- update account.simulateTransaction return type ([3c3d397](https://github.com/0xs34n/starknet.js/commit/3c3d397a4fb1042c7358f70f50df0a4ce2893220))
+
+## [4.19.2](https://github.com/0xs34n/starknet.js/compare/v4.19.1...v4.19.2) (2023-01-11)
+
+### Bug Fixes
+
+- repair and unify transaction retrieval error ([ea5e646](https://github.com/0xs34n/starknet.js/commit/ea5e64651bf47824b254ae73ed8aa88998a5be44))
+
 ## [4.19.1](https://github.com/0xs34n/starknet.js/compare/v4.19.0...v4.19.1) (2023-01-10)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -971,139 +971,6 @@ interface Result extends Array<any> {
 
 declare type BlockIdentifier = BlockNumber | BigNumberish;
 
-/**
- * Common interface response
- * Intersection (sequencer response ∩ (∪ rpc responses))
- */
-
-interface GetBlockResponse {
-    timestamp: number;
-    block_hash: string;
-    block_number: number;
-    new_root: string;
-    parent_hash: string;
-    status: Status;
-    transactions: Array<string>;
-    gas_price?: string;
-    sequencer_address?: string;
-    starknet_version?: string;
-    transaction_receipts?: any;
-}
-interface GetCodeResponse {
-    bytecode: string[];
-}
-declare type GetTransactionResponse = InvokeTransactionResponse & DeclareTransactionResponse;
-interface CommonTransactionResponse {
-    transaction_hash?: string;
-    version?: string;
-    signature?: Signature;
-    max_fee?: string;
-    nonce?: string;
-}
-interface InvokeTransactionResponse extends CommonTransactionResponse {
-    contract_address?: string;
-    entry_point_selector?: string;
-    calldata: RawCalldata;
-}
-interface ContractEntryPoint {
-    offset: string;
-    selector: string;
-}
-interface DeclareTransactionResponse extends CommonTransactionResponse {
-    contract_class?: any;
-    sender_address?: string;
-}
-declare type GetTransactionReceiptResponse = InvokeTransactionReceiptResponse | DeclareTransactionReceiptResponse;
-interface CommonTransactionReceiptResponse {
-    transaction_hash: string;
-    status?: Status;
-    actual_fee?: string;
-    status_data?: string;
-}
-interface MessageToL1 {
-    to_address: string;
-    payload: Array<string>;
-}
-interface Event {
-    from_address: string;
-    keys: Array<string>;
-    data: Array<string>;
-}
-interface MessageToL2 {
-    from_address: string;
-    payload: Array<string>;
-}
-interface InvokeTransactionReceiptResponse extends CommonTransactionReceiptResponse {
-    /** @deprecated Use l2_to_l1_messages */
-    messages_sent?: Array<MessageToL1>;
-    events?: Array<Event>;
-    l1_origin_message?: MessageToL2;
-}
-declare type DeclareTransactionReceiptResponse = CommonTransactionReceiptResponse;
-interface EstimateFeeResponse {
-    overall_fee: BN__default;
-    gas_consumed?: BN__default;
-    gas_price?: BN__default;
-}
-interface InvokeFunctionResponse {
-    transaction_hash: string;
-}
-interface DeclareContractResponse {
-    transaction_hash: string;
-    class_hash: string;
-}
-declare type CallContractResponse = {
-    result: Array<string>;
-};
-declare type EstimateFeeAction = {
-    type: 'INVOKE';
-    payload: AllowArray<Call>;
-} | {
-    type: 'DECLARE';
-    payload: DeclareContractPayload;
-} | {
-    type: 'DEPLOY_ACCOUNT';
-    payload: DeployAccountContractPayload;
-} | {
-    type: 'DEPLOY';
-    payload: UniversalDeployerContractPayload;
-};
-declare type EstimateFeeResponseBulk = Array<EstimateFeeResponse>;
-
-interface EstimateFee extends EstimateFeeResponse {
-    suggestedMaxFee: BN__default;
-}
-declare type EstimateFeeBulk = Array<EstimateFee>;
-interface EstimateFeeDetails {
-    nonce?: BigNumberish;
-    blockIdentifier?: BlockIdentifier;
-}
-interface DeployContractResponse {
-    contract_address: string;
-    transaction_hash: string;
-}
-declare type MultiDeployContractResponse = {
-    contract_address: Array<string>;
-    transaction_hash: string;
-};
-declare type DeployContractUDCResponse = {
-    contract_address: string;
-    transaction_hash: string;
-    address: string;
-    deployer: string;
-    unique: string;
-    classHash: string;
-    calldata_len: string;
-    calldata: Array<string>;
-    salt: string;
-};
-declare type DeclareDeployUDCResponse = {
-    declare: {
-        class_hash: BigNumberish;
-    } & DeclareTransactionReceiptResponse;
-    deploy: DeployContractUDCResponse;
-};
-
 declare type GetTransactionStatusResponse = {
     tx_status: Status;
     block_hash?: string;
@@ -1437,6 +1304,146 @@ declare namespace Sequencer {
     };
 }
 
+/**
+ * Common interface response
+ * Intersection (sequencer response ∩ (∪ rpc responses))
+ */
+
+interface GetBlockResponse {
+    timestamp: number;
+    block_hash: string;
+    block_number: number;
+    new_root: string;
+    parent_hash: string;
+    status: Status;
+    transactions: Array<string>;
+    gas_price?: string;
+    sequencer_address?: string;
+    starknet_version?: string;
+    transaction_receipts?: any;
+}
+interface GetCodeResponse {
+    bytecode: string[];
+}
+declare type GetTransactionResponse = InvokeTransactionResponse & DeclareTransactionResponse;
+interface CommonTransactionResponse {
+    transaction_hash?: string;
+    version?: string;
+    signature?: Signature;
+    max_fee?: string;
+    nonce?: string;
+}
+interface InvokeTransactionResponse extends CommonTransactionResponse {
+    contract_address?: string;
+    entry_point_selector?: string;
+    calldata: RawCalldata;
+}
+interface ContractEntryPoint {
+    offset: string;
+    selector: string;
+}
+interface DeclareTransactionResponse extends CommonTransactionResponse {
+    contract_class?: any;
+    sender_address?: string;
+}
+declare type GetTransactionReceiptResponse = InvokeTransactionReceiptResponse | DeclareTransactionReceiptResponse;
+interface CommonTransactionReceiptResponse {
+    transaction_hash: string;
+    status?: Status;
+    actual_fee?: string;
+    status_data?: string;
+}
+interface MessageToL1 {
+    to_address: string;
+    payload: Array<string>;
+}
+interface Event {
+    from_address: string;
+    keys: Array<string>;
+    data: Array<string>;
+}
+interface MessageToL2 {
+    from_address: string;
+    payload: Array<string>;
+}
+interface InvokeTransactionReceiptResponse extends CommonTransactionReceiptResponse {
+    /** @deprecated Use l2_to_l1_messages */
+    messages_sent?: Array<MessageToL1>;
+    events?: Array<Event>;
+    l1_origin_message?: MessageToL2;
+}
+declare type DeclareTransactionReceiptResponse = CommonTransactionReceiptResponse;
+interface EstimateFeeResponse {
+    overall_fee: BN__default;
+    gas_consumed?: BN__default;
+    gas_price?: BN__default;
+}
+interface InvokeFunctionResponse {
+    transaction_hash: string;
+}
+interface DeclareContractResponse {
+    transaction_hash: string;
+    class_hash: string;
+}
+declare type CallContractResponse = {
+    result: Array<string>;
+};
+declare type EstimateFeeAction = {
+    type: 'INVOKE';
+    payload: AllowArray<Call>;
+} | {
+    type: 'DECLARE';
+    payload: DeclareContractPayload;
+} | {
+    type: 'DEPLOY_ACCOUNT';
+    payload: DeployAccountContractPayload;
+} | {
+    type: 'DEPLOY';
+    payload: UniversalDeployerContractPayload;
+};
+declare type EstimateFeeResponseBulk = Array<EstimateFeeResponse>;
+interface TransactionSimulationResponse {
+    trace: TransactionTraceResponse;
+    fee_estimation: EstimateFeeResponse;
+}
+
+interface EstimateFee extends EstimateFeeResponse {
+    suggestedMaxFee: BN__default;
+}
+declare type EstimateFeeBulk = Array<EstimateFee>;
+interface EstimateFeeDetails {
+    nonce?: BigNumberish;
+    blockIdentifier?: BlockIdentifier;
+}
+interface DeployContractResponse {
+    contract_address: string;
+    transaction_hash: string;
+}
+declare type MultiDeployContractResponse = {
+    contract_address: Array<string>;
+    transaction_hash: string;
+};
+declare type DeployContractUDCResponse = {
+    contract_address: string;
+    transaction_hash: string;
+    address: string;
+    deployer: string;
+    unique: string;
+    classHash: string;
+    calldata_len: string;
+    calldata: Array<string>;
+    salt: string;
+};
+declare type DeclareDeployUDCResponse = {
+    declare: {
+        class_hash: BigNumberish;
+    } & DeclareTransactionReceiptResponse;
+    deploy: DeployContractUDCResponse;
+};
+interface TransactionSimulation extends TransactionSimulationResponse {
+    fee_estimation: EstimateFee;
+}
+
 declare abstract class ProviderInterface {
     abstract chainId: StarknetChainId;
     /**
@@ -1638,6 +1645,21 @@ declare abstract class ProviderInterface {
      * @return GetTransactionReceiptResponse
      */
     abstract waitForTransaction(txHash: BigNumberish, retryInterval?: number, successStates?: Array<Status>): Promise<GetTransactionReceiptResponse>;
+    /**
+     * Simulates the transaction and returns the transaction trace and estimated fee.
+     *
+     * @param invocation 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
+     * @param details - optional details containing:
+     * - nonce - optional nonce
+     * - version - optional version
+     * @param blockIdentifier - block identifier
+     * @returns the transaction trace and estimated fee
+     */
+    abstract getSimulateTransaction(invocation: Invocation, invocationDetails: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<TransactionSimulationResponse>;
 }
 
 declare type RpcProviderOptions = {
@@ -1717,6 +1739,7 @@ declare class RpcProvider implements ProviderInterface {
      * @returns events and the pagination of the events
      */
     getEvents(eventFilter: RPC.EventFilter): Promise<RPC.GetEventsResponse>;
+    getSimulateTransaction(_invocation: Invocation, _invocationDetails: InvocationsDetailsWithNonce, _blockIdentifier?: BlockIdentifier): Promise<TransactionSimulationResponse>;
 }
 
 declare type NetworkName = 'mainnet-alpha' | 'goerli-alpha' | 'goerli-alpha-2';
@@ -1792,7 +1815,7 @@ declare class SequencerProvider implements ProviderInterface {
      */
     getTransactionTrace(txHash: BigNumberish): Promise<TransactionTraceResponse>;
     estimateMessageFee({ from_address, to_address, entry_point_selector, payload }: CallL1Handler, blockIdentifier?: BlockIdentifier): Promise<Sequencer.EstimateFeeResponse>;
-    simulateTransaction(invocation: Invocation, invocationDetails: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<Sequencer.TransactionSimulationResponse>;
+    getSimulateTransaction(invocation: Invocation, invocationDetails: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<TransactionSimulationResponse>;
 }
 
 interface ProviderOptions {
@@ -1823,13 +1846,16 @@ declare class Provider implements ProviderInterface {
     getDeployAccountEstimateFee(transaction: DeployAccountContractTransaction, details: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<EstimateFeeResponse>;
     getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number, successStates?: Array<Status>): Promise<GetTransactionReceiptResponse>;
+    getSimulateTransaction(invocation: Invocation, invocationDetails: InvocationsDetailsWithNonce, blockIdentifier?: BlockIdentifier): Promise<TransactionSimulationResponse>;
 }
 
-declare class GatewayError extends CustomError {
+declare class LibraryError extends CustomError {
+}
+declare class GatewayError extends LibraryError {
     errorCode: string;
     constructor(message: string, errorCode: string);
 }
-declare class HttpError extends CustomError {
+declare class HttpError extends LibraryError {
     errorCode: number;
     constructor(message: string, errorCode: number);
 }
@@ -2278,6 +2304,17 @@ declare abstract class AccountInterface extends ProviderInterface {
      * @returns suggestedMaxFee
      */
     abstract getSuggestedMaxFee(estimateFeeAction: EstimateFeeAction, details: EstimateFeeDetails): Promise<BigNumberish>;
+    /**
+     * Simulates the transaction and returns the transaction trace and estimated fee.
+     *
+     * @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 simulateTransaction(calls: AllowArray<Call>, estimateFeeDetails?: EstimateFeeDetails): Promise<TransactionSimulation>;
 }
 
 declare class Account extends Provider implements AccountInterface {
@@ -2308,6 +2345,7 @@ declare class Account extends Provider implements AccountInterface {
     buildDeclarePayload({ classHash, contract }: DeclareContractPayload, { nonce, chainId, version, walletAddress, maxFee }: InvocationsSignerDetails): Promise<DeclareContractTransaction>;
     buildAccountDeployPayload({ classHash, addressSalt, constructorCalldata, contractAddress: providedContractAddress, }: DeployAccountContractPayload, { nonce, chainId, version, maxFee }: InvocationsSignerDetails): Promise<DeployAccountContractTransaction>;
     buildUDCContractPayload(payload: UniversalDeployerContractPayload | UniversalDeployerContractPayload[]): Call[];
+    simulateTransaction(calls: AllowArray<Call>, { nonce: providedNonce, blockIdentifier }?: EstimateFeeDetails): Promise<TransactionSimulation>;
 }
 
 declare type CallOptions = {
@@ -2767,4 +2805,4 @@ declare function validateChecksumAddress(address: string): boolean;
 declare function isUrl(s?: string): boolean;
 declare function buildUrl(baseUrl: string, defaultPath: string, urlOrPath?: string): string;
 
-export { Abi, AbiEntry, Account, AccountInterface, AllowArray, Args, AsyncContractFunction, BlockNumber, BlockTag, Call, CallContractResponse, CallDetails, CallL1Handler, CallOptions, Calldata, CommonTransactionReceiptResponse, CommonTransactionResponse, CompiledContract, CompressedCompiledContract, CompressedProgram, Contract, ContractClass, ContractEntryPoint, ContractFactory, ContractFunction, ContractInterface, DeclareContractPayload, DeclareContractResponse, DeclareContractTransaction, DeclareDeployContractPayload, DeclareDeployUDCResponse, DeclareSignerDetails, DeclareTransactionReceiptResponse, DeclareTransactionResponse, DeployAccountContractPayload, DeployAccountContractTransaction, DeployAccountSignerDetails, DeployContractPayload, DeployContractResponse, DeployContractUDCResponse, EntryPointType, EntryPointsByType, EstimateFee, EstimateFeeAction, EstimateFeeBulk, EstimateFeeDetails, EstimateFeeResponse, EstimateFeeResponseBulk, Event, ExecutionResources, FunctionAbi, FunctionInvocation, GatewayError, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionReceiptResponse, GetTransactionResponse, GetTransactionStatusResponse, HttpError, Invocation, InvocationBulk, InvocationsDetails, InvocationsDetailsWithNonce, InvocationsSignerDetails, InvokeFunctionResponse, InvokeTransactionReceiptResponse, InvokeTransactionResponse, KeyPair, MessageToL1, MessageToL2, MultiDeployContractResponse, Overrides, ParsedStruct, Program, Provider, ProviderInterface, ProviderOptions, RPC, RawArgs, RawCalldata, Result, RpcProvider, RpcProviderOptions, Sequencer, SequencerProvider, SequencerProviderOptions, Signature, Signer, SignerInterface, Status, Struct, StructAbi, TransactionBulk, TransactionStatus, TransactionTraceResponse, TransactionType, UniversalDeployerContractPayload, addAddressPadding, buildUrl, constants, defaultProvider, ellipticCurve as ec, encode, getChecksumAddress, hash, isUrl, json, merkle, number, shortString, stark, transaction, index as typedData, uint256, validateAndParseAddress, validateChecksumAddress };
+export { Abi, AbiEntry, Account, AccountInterface, AllowArray, Args, AsyncContractFunction, BlockNumber, BlockTag, Call, CallContractResponse, CallDetails, CallL1Handler, CallOptions, Calldata, CommonTransactionReceiptResponse, CommonTransactionResponse, CompiledContract, CompressedCompiledContract, CompressedProgram, Contract, ContractClass, ContractEntryPoint, ContractFactory, ContractFunction, ContractInterface, DeclareContractPayload, DeclareContractResponse, DeclareContractTransaction, DeclareDeployContractPayload, DeclareDeployUDCResponse, DeclareSignerDetails, DeclareTransactionReceiptResponse, DeclareTransactionResponse, DeployAccountContractPayload, DeployAccountContractTransaction, DeployAccountSignerDetails, DeployContractPayload, DeployContractResponse, DeployContractUDCResponse, EntryPointType, EntryPointsByType, EstimateFee, EstimateFeeAction, EstimateFeeBulk, EstimateFeeDetails, EstimateFeeResponse, EstimateFeeResponseBulk, Event, ExecutionResources, FunctionAbi, FunctionInvocation, GatewayError, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionReceiptResponse, GetTransactionResponse, GetTransactionStatusResponse, HttpError, Invocation, InvocationBulk, InvocationsDetails, InvocationsDetailsWithNonce, InvocationsSignerDetails, InvokeFunctionResponse, InvokeTransactionReceiptResponse, InvokeTransactionResponse, KeyPair, LibraryError, MessageToL1, MessageToL2, MultiDeployContractResponse, Overrides, ParsedStruct, Program, Provider, ProviderInterface, ProviderOptions, RPC, RawArgs, RawCalldata, Result, RpcProvider, RpcProviderOptions, Sequencer, SequencerProvider, SequencerProviderOptions, Signature, Signer, SignerInterface, Status, Struct, StructAbi, TransactionBulk, TransactionSimulation, TransactionSimulationResponse, TransactionStatus, TransactionTraceResponse, TransactionType, UniversalDeployerContractPayload, addAddressPadding, buildUrl, constants, defaultProvider, ellipticCurve as ec, encode, getChecksumAddress, hash, isUrl, json, merkle, number, shortString, stark, transaction, index as typedData, uint256, validateAndParseAddress, validateChecksumAddress };