starknet 3.18.2 → 3.19.0

package/dist/contract/default.js

@@ -592,6 +592,8 @@ var Contract = /** @class */ (function () {
                 nonce: options.nonce,
             });
         }
+        // eslint-disable-next-line no-console
+        console.warn("Invoking ".concat(method, " without an account. This will not work on a public node."));
         return this.providerOrAccount.invokeFunction(__assign(__assign({}, invocation), { signature: options.signature || [] }));
     };
     Contract.prototype.call = function (method, args, _a) {
@@ -612,7 +614,7 @@ var Contract = /** @class */ (function () {
                         contractAddress: this.address,
                         calldata: calldata,
                         entrypoint: method,
-                    }, { blockIdentifier: blockIdentifier })
+                    }, blockIdentifier)
                         .then(function (x) { return _this.parseResponse(method, x.result); })];
             });
         });
@@ -623,7 +625,6 @@ var Contract = /** @class */ (function () {
             var invocation;
             var _a;
             return __generator(this, function (_b) {
-                //  TODO; remove error as soon as estimate fees are supported
                 // ensure contract is connected
                 (0, minimalistic_assert_1.default)(this.address !== null, 'contract isnt connected to an address');
                 // validate method and args

package/dist/contract/interface.d.ts

@@ -1,7 +1,7 @@
 import { AccountInterface } from '../account';
 import { ProviderInterface } from '../provider';
 import { BlockIdentifier } from '../provider/utils';
-import { Abi, AddTransactionResponse, AsyncContractFunction, ContractFunction, Invocation, Overrides, Result } from '../types';
+import { Abi, AsyncContractFunction, ContractFunction, Invocation, InvokeFunctionResponse, Overrides, Result } from '../types';
 export declare abstract class ContractInterface {
     abstract abi: Abi;
     abstract address: string;
@@ -56,7 +56,7 @@ export declare abstract class ContractInterface {
      * @param args Array of the arguments for the invoke
      * @returns Add Transaction Response
      */
-    abstract invoke(method: string, args?: Array<any>, options?: Overrides): Promise<AddTransactionResponse>;
+    abstract invoke(method: string, args?: Array<any>, options?: Overrides): Promise<InvokeFunctionResponse>;
     /**
      * Calls a method on a contract
      *

package/dist/provider/default.d.ts

@@ -1,143 +1,27 @@
 import { StarknetChainId } from '../constants';
-import { Abi, AddTransactionResponse, Call, CallContractResponse, DeclareContractPayload, DeployContractPayload, Endpoints, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionResponse, GetTransactionStatusResponse, GetTransactionTraceResponse, Invocation, TransactionReceiptResponse } from '../types';
+import { BlockTag, Call, CallContractResponse, ContractClass, DeclareContractPayload, DeclareContractResponse, DeployContractPayload, DeployContractResponse, EstimateFeeResponse, GetBlockResponse, GetTransactionReceiptResponse, GetTransactionResponse, Invocation, InvocationsDetails, InvokeFunctionResponse } from '../types';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
+import { RpcProviderOptions } from './rpc';
+import { SequencerProviderOptions } from './sequencer';
 import { BlockIdentifier } from './utils';
-declare type NetworkName = 'mainnet-alpha' | 'goerli-alpha';
-declare type ProviderOptions = {
-    network: NetworkName;
-} | {
-    baseUrl: string;
-};
+export interface ProviderOptions {
+    sequencer?: SequencerProviderOptions;
+    rpc?: RpcProviderOptions;
+}
 export declare class Provider implements ProviderInterface {
-    baseUrl: string;
-    feederGatewayUrl: string;
-    gatewayUrl: string;
-    chainId: StarknetChainId;
-    constructor(optionsOrProvider?: ProviderOptions | ProviderInterface);
-    protected static getNetworkFromName(name: NetworkName): "https://alpha-mainnet.starknet.io" | "https://alpha4.starknet.io";
-    protected static getChainIdFromBaseUrl(baseUrl: string): StarknetChainId;
-    private getFetchUrl;
-    private getFetchMethod;
-    private getQueryString;
-    private getHeaders;
-    protected fetchEndpoint<T extends keyof Endpoints>(endpoint: T, ...[query, request]: Endpoints[T]['QUERY'] extends never ? Endpoints[T]['REQUEST'] extends never ? [] : [undefined, Endpoints[T]['REQUEST']] : Endpoints[T]['REQUEST'] extends never ? [Endpoints[T]['QUERY']] : [Endpoints[T]['QUERY'], Endpoints[T]['REQUEST']]): Promise<Endpoints[T]['RESPONSE']>;
-    /**
-     * Gets the smart contract address on the goerli testnet.
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L13-L15)
-     * @returns starknet smart contract addresses
-     */
-    getContractAddresses(): Promise<GetContractAddressesResponse>;
-    /**
-     * Calls a function on the StarkNet contract.
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L25-L39)
-     *
-     * @param invokeTransaction - transaction to be invoked
-     * @param blockHash
-     * @param blockNumber
-     * @returns the result of the function on the smart contract.
-     */
-    callContract({ contractAddress, entrypoint, calldata }: Call, { blockIdentifier }?: {
-        blockIdentifier?: BlockIdentifier;
-    }): Promise<CallContractResponse>;
-    /**
-     * Gets the block information
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L41-L53)
-     *
-     * @param blockHash
-     * @param blockNumber
-     * @returns the block object { block_number, previous_block_number, state_root, status, timestamp, transaction_receipts, transactions }
-     */
+    private provider;
+    constructor(providerOrOptions?: ProviderOptions | ProviderInterface);
+    get chainId(): StarknetChainId;
     getBlock(blockIdentifier?: BlockIdentifier): Promise<GetBlockResponse>;
-    /**
-     * Gets the code of the deployed contract.
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L55-L68)
-     *
-     * @param contractAddress
-     * @param blockHash
-     * @param blockNumber
-     * @returns Bytecode and ABI of compiled contract
-     */
-    getCode(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<GetCodeResponse>;
-    /**
-     * Gets the contract's storage variable at a specific key.
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/fc97bdd8322a7df043c87c371634b26c15ed6cee/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L70-L85)
-     *
-     * @param contractAddress
-     * @param key - from getStorageVarAddress('<STORAGE_VARIABLE_NAME>') (WIP)
-     * @param blockHash
-     * @param blockNumber
-     * @returns the value of the storage variable
-     */
-    getStorageAt(contractAddress: string, key: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<object>;
-    /**
-     * Gets the status of a transaction.
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L48-L52)
-     *
-     * @param txHash
-     * @returns the transaction status object { block_number, tx_status: NOT_RECEIVED | RECEIVED | PENDING | REJECTED | ACCEPTED_ONCHAIN }
-     */
-    getTransactionStatus(txHash: BigNumberish): Promise<GetTransactionStatusResponse>;
-    /**
-     * Gets the transaction receipt from a tx hash.
-     *
-     * [Reference] (https://github.com/starkware-libs/cairo-lang/blob/167b28bcd940fd25ea3816204fa882a0b0a49603/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L183)
-     *
-     * @param txHash
-     * @returns the transaction receipt object
-     */
-    getTransactionReceipt(txHash: BigNumberish): Promise<TransactionReceiptResponse>;
-    /**
-     * Gets the transaction information from a tx id.
-     *
-     * [Reference](https://github.com/starkware-libs/cairo-lang/blob/f464ec4797361b6be8989e36e02ec690e74ef285/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L54-L58)
-     *
-     * @param txHash
-     * @returns the transacton object { transaction_id, status, transaction, block_number?, block_number?, transaction_index?, transaction_failure_reason? }
-     */
+    getClassAt(contractAddress: string, blockIdentifier?: BlockIdentifier): Promise<ContractClass>;
+    getEstimateFee(invocation: Invocation, blockIdentifier?: BlockIdentifier, invocationDetails?: InvocationsDetails): Promise<EstimateFeeResponse>;
+    getStorageAt(contractAddress: string, key: BigNumberish, blockTagOrHash?: BlockTag | BigNumberish): Promise<BigNumberish>;
     getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
-    /**
-     * Gets the transaction trace from a tx id.
-     *
-     *
-     * @param txHash
-     * @returns the transaction trace
-     */
-    getTransactionTrace(txHash: BigNumberish): Promise<GetTransactionTraceResponse>;
-    /**
-     * Declare a given compiled contract (json) on starknet
-     *
-     * @param contract - a json object containing the compiled contract
-     * @returns a confirmation of sending a transaction on the starknet contract
-     */
-    declareContract(payload: DeclareContractPayload): Promise<AddTransactionResponse>;
-    /**
-     * Deploys a given compiled contract (json) to starknet
-     *
-     * @param contract - a json object containing the compiled contract
-     * @param address - (optional, defaults to a random address) the address where the contract should be deployed (alpha)
-     * @returns a confirmation of sending a transaction on the starknet contract
-     */
-    deployContract(payload: DeployContractPayload, _abi?: Abi): Promise<AddTransactionResponse>;
-    /**
-     * Invokes a function on starknet
-     * @deprecated This method wont be supported as soon as fees are mandatory
-     *
-     * @param invocation
-     * @param _abi - (optional) signature to send along
-     * @returns response from addTransaction
-     */
-    invokeFunction(invocation: Invocation, _abi?: Abi): Promise<AddTransactionResponse>;
+    getTransactionReceipt(txHash: BigNumberish): Promise<GetTransactionReceiptResponse>;
+    callContract(request: Call, blockIdentifier?: BlockIdentifier): Promise<CallContractResponse>;
+    invokeFunction(functionInvocation: Invocation, details: InvocationsDetails): Promise<InvokeFunctionResponse>;
+    deployContract(payload: DeployContractPayload): Promise<DeployContractResponse>;
+    declareContract(payload: DeclareContractPayload): Promise<DeclareContractResponse>;
     waitForTransaction(txHash: BigNumberish, retryInterval?: number): Promise<void>;
-    /**
-     * @deprecated use `waitForTransaction` instead
-     */
-    waitForTx(txHash: BigNumberish, retryInterval?: number): Promise<void>;
 }
-export {};