starknet 3.13.0 → 3.14.1

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [3.14.1](https://github.com/0xs34n/starknet.js/compare/v3.14.0...v3.14.1) (2022-06-15)
+
+### Bug Fixes
+
+- update api typings ([44796af](https://github.com/0xs34n/starknet.js/commit/44796af4849b6bab3d99065bb1e1948e4ea0b55e))
+
+# [3.14.0](https://github.com/0xs34n/starknet.js/compare/v3.13.1...v3.14.0) (2022-06-15)
+
+### Bug Fixes
+
+- remove redundant \_abi from declareContract() ([53d6578](https://github.com/0xs34n/starknet.js/commit/53d6578b932ed6046b5e0df83d748673d7efc3d5))
+
+### Features
+
+- support contract declaration API introduced at SN 0.9.0 ([ca6203f](https://github.com/0xs34n/starknet.js/commit/ca6203f93471d7fb421d580e07d6de7c183e40f3))
+
+## [3.13.1](https://github.com/0xs34n/starknet.js/compare/v3.13.0...v3.13.1) (2022-06-14)
+
+### Bug Fixes
+
+- account estimate fee interface ([51e8cf6](https://github.com/0xs34n/starknet.js/commit/51e8cf6858acd5aed003f8f1c4d755088684f134))
+
 # [3.13.0](https://github.com/0xs34n/starknet.js/compare/v3.12.3...v3.13.0) (2022-06-14)
 
 ### Bug Fixes

package/__tests__/provider.test.ts

@@ -1,6 +1,6 @@
 import { defaultProvider, stark } from '../src';
 import { toBN } from '../src/utils/number';
-import { compiledArgentAccount } from './fixtures';
+import { compiledArgentAccount, compiledErc20 } from './fixtures';
 
 const { compileCalldata } = stark;
 
@@ -85,20 +85,43 @@ describe('defaultProvider', () => {
         )
       ).resolves.not.toThrow();
     });
-    test('getTransaction()', async () => {
-      return expect(
-        defaultProvider.getTransaction(
-          '0x37013e1cb9c133e6fe51b4b371b76b317a480f56d80576730754c1662582348'
-        )
-      ).resolves.not.toThrow();
+
+    test('getTransaction() - successful transaction', async () => {
+      const transaction = await defaultProvider.getTransaction(
+        '0x37013e1cb9c133e6fe51b4b371b76b317a480f56d80576730754c1662582348'
+      );
+
+      expect(transaction).not.toHaveProperty('transaction_failure_reason');
+
+      expect(transaction.transaction).toHaveProperty('transaction_hash');
+
+      return expect(transaction.status).not.toEqual('REJECTED');
     });
 
-    test('getTransactionReceipt', async () => {
-      return expect(
-        defaultProvider.getTransactionReceipt(
-          '0x37013e1cb9c133e6fe51b4b371b76b317a480f56d80576730754c1662582348'
-        )
-      ).resolves.not.toThrow();
+    test('getTransaction() - failed transaction', async () => {
+      const transaction = await defaultProvider.getTransaction(
+        '0x698e60db2bae3ef8d5fafda10ff83b6ba634351aa1f4fcf8455ec0cffa738d9'
+      );
+
+      expect(transaction).toHaveProperty('transaction_failure_reason');
+
+      return expect(transaction.status).toEqual('REJECTED');
+    });
+
+    test('getTransactionReceipt() - successful transaction', async () => {
+      const transactionReceipt = await defaultProvider.getTransactionReceipt(
+        '0x18c49389193b40e178dfc9f2f595a7c79a7a55639e9951d956329f2ce6cfd4f'
+      );
+
+      return expect(transactionReceipt).toHaveProperty('actual_fee');
+    });
+
+    test('getTransactionReceipt() - failed transaction', async () => {
+      const transactionReceipt = await defaultProvider.getTransactionReceipt(
+        '0x698e60db2bae3ef8d5fafda10ff83b6ba634351aa1f4fcf8455ec0cffa738d9'
+      );
+
+      return expect(transactionReceipt).not.toHaveProperty('actual_fee');
     });
 
     test('callContract()', () => {
@@ -123,6 +146,16 @@ describe('defaultProvider', () => {
   });
 
   describe('addTransaction()', () => {
+    test('declareContract()', async () => {
+      const response = await defaultProvider.declareContract({
+        contract: compiledErc20,
+      });
+
+      expect(response.code).toBe('TRANSACTION_RECEIVED');
+      expect(response.transaction_hash).toBeDefined();
+      expect(response.class_hash).toBeDefined();
+    });
+
     test('deployContract()', async () => {
       const response = await defaultProvider.deployContract({
         contract: compiledArgentAccount,

package/account/default.d.ts

@@ -1,5 +1,4 @@
 import { Provider, ProviderInterface } from '../provider';
-import { BlockIdentifier } from '../provider/utils';
 import { SignerInterface } from '../signer';
 import {
   Abi,
@@ -10,7 +9,7 @@ import {
   Signature,
   Transaction,
 } from '../types';
-import { EstimateFee } from '../types/account';
+import { EstimateFee, EstimateFeeDetails } from '../types/account';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData';
 import { AccountInterface } from './interface';
@@ -25,13 +24,7 @@ export declare class Account extends Provider implements AccountInterface {
   getNonce(): Promise<string>;
   estimateFee(
     calls: Call | Call[],
-    {
-      nonce: providedNonce,
-      blockIdentifier,
-    }?: {
-      nonce?: BigNumberish;
-      blockIdentifier?: BlockIdentifier;
-    }
+    { nonce: providedNonce, blockIdentifier }?: EstimateFeeDetails
   ): Promise<EstimateFee>;
   /**
    * Invoke execute function in account contract

package/account/default.js

@@ -424,6 +424,7 @@ var Account = /** @class */ (function (_super) {
         switch (_a.label) {
           case 0:
             if (transaction.type === 'DEPLOY') throw new Error('No DEPLOYS');
+            if (transaction.type === 'DECLARE') throw new Error('No DECLARES');
             (0,
             minimalistic_assert_1.default)(!transaction.signature, "Adding signatures to a signer transaction currently isn't supported");
             if (!transaction.nonce) return [3 /*break*/, 1];

package/account/interface.d.ts

@@ -5,11 +5,10 @@ import {
   AddTransactionResponse,
   Call,
   DeployContractPayload,
-  Invocation,
   InvocationsDetails,
   Signature,
 } from '../types';
-import { EstimateFee } from '../types/account';
+import { EstimateFee, EstimateFeeDetails } from '../types/account';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData/types';
 export declare abstract class AccountInterface extends ProviderInterface {
@@ -40,7 +39,10 @@ export declare abstract class AccountInterface extends ProviderInterface {
    *
    * @returns response from addTransaction
    */
-  abstract estimateFee(invocation: Invocation): Promise<EstimateFee>;
+  abstract estimateFee(
+    calls: Call | Call[],
+    estimateFeeDetails?: EstimateFeeDetails
+  ): Promise<EstimateFee>;
   /**
    * Invoke execute function in account contract
    *

package/constants.d.ts

@@ -10,6 +10,7 @@ export declare enum StarknetChainId {
   TESTNET = '0x534e5f474f45524c49',
 }
 export declare enum TransactionHashPrefix {
+  DECLARE = '0x6465636c617265',
   DEPLOY = '0x6465706c6f79',
   INVOKE = '0x696e766f6b65',
   L1_HANDLER = '0x6c315f68616e646c6572',

package/constants.js

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

package/contract/default.d.ts

@@ -148,6 +148,6 @@ export declare class Contract implements ContractInterface {
       blockIdentifier?: BlockIdentifier;
     }
   ): Promise<Result>;
-  estimate(method: string, args?: Array<any>): Promise<import('../types/account').EstimateFee>;
+  estimate(method: string, args?: Array<any>): Promise<import('../types').EstimateFee>;
   populate(method: string, args?: Array<any>): Invocation;
 }

package/dist/account/default.d.ts

@@ -1,8 +1,7 @@
 import { Provider, ProviderInterface } from '../provider';
-import { BlockIdentifier } from '../provider/utils';
 import { SignerInterface } from '../signer';
 import { Abi, AddTransactionResponse, Call, InvocationsDetails, KeyPair, Signature, Transaction } from '../types';
-import { EstimateFee } from '../types/account';
+import { EstimateFee, EstimateFeeDetails } from '../types/account';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData';
 import { AccountInterface } from './interface';
@@ -11,10 +10,7 @@ export declare class Account extends Provider implements AccountInterface {
     signer: SignerInterface;
     constructor(provider: ProviderInterface, address: string, keyPairOrSigner: KeyPair | SignerInterface);
     getNonce(): Promise<string>;
-    estimateFee(calls: Call | Call[], { nonce: providedNonce, blockIdentifier, }?: {
-        nonce?: BigNumberish;
-        blockIdentifier?: BlockIdentifier;
-    }): Promise<EstimateFee>;
+    estimateFee(calls: Call | Call[], { nonce: providedNonce, blockIdentifier }?: EstimateFeeDetails): Promise<EstimateFee>;
     /**
      * Invoke execute function in account contract
      *

package/dist/account/default.js

@@ -267,6 +267,8 @@ var Account = /** @class */ (function (_super) {
                     case 0:
                         if (transaction.type === 'DEPLOY')
                             throw new Error('No DEPLOYS');
+                        if (transaction.type === 'DECLARE')
+                            throw new Error('No DECLARES');
                         (0, minimalistic_assert_1.default)(!transaction.signature, "Adding signatures to a signer transaction currently isn't supported");
                         if (!transaction.nonce) return [3 /*break*/, 1];
                         nonceBn = (0, number_1.toBN)(transaction.nonce);

package/dist/account/interface.d.ts

@@ -1,7 +1,7 @@
 import { ProviderInterface } from '../provider';
 import { SignerInterface } from '../signer';
-import { Abi, AddTransactionResponse, Call, DeployContractPayload, Invocation, InvocationsDetails, Signature } from '../types';
-import { EstimateFee } from '../types/account';
+import { Abi, AddTransactionResponse, Call, DeployContractPayload, InvocationsDetails, Signature } from '../types';
+import { EstimateFee, EstimateFeeDetails } from '../types/account';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData/types';
 export declare abstract class AccountInterface extends ProviderInterface {
@@ -29,7 +29,7 @@ export declare abstract class AccountInterface extends ProviderInterface {
      *
      * @returns response from addTransaction
      */
-    abstract estimateFee(invocation: Invocation): Promise<EstimateFee>;
+    abstract estimateFee(calls: Call | Call[], estimateFeeDetails?: EstimateFeeDetails): Promise<EstimateFee>;
     /**
      * Invoke execute function in account contract
      *

package/dist/constants.d.ts

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

package/dist/constants.js

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

package/dist/contract/default.d.ts

@@ -119,6 +119,6 @@ export declare class Contract implements ContractInterface {
     call(method: string, args?: Array<any>, { blockIdentifier, }?: {
         blockIdentifier?: BlockIdentifier;
     }): Promise<Result>;
-    estimate(method: string, args?: Array<any>): Promise<import("../types/account").EstimateFee>;
+    estimate(method: string, args?: Array<any>): Promise<import("../types").EstimateFee>;
     populate(method: string, args?: Array<any>): Invocation;
 }

package/dist/provider/default.d.ts

@@ -1,5 +1,5 @@
 import { StarknetChainId } from '../constants';
-import { Abi, AddTransactionResponse, Call, CallContractResponse, DeployContractPayload, Endpoints, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionResponse, GetTransactionStatusResponse, GetTransactionTraceResponse, Invocation, TransactionReceiptResponse } from '../types';
+import { Abi, AddTransactionResponse, Call, CallContractResponse, DeclareContractPayload, DeployContractPayload, Endpoints, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionResponse, GetTransactionStatusResponse, GetTransactionTraceResponse, Invocation, TransactionReceiptResponse } from '../types';
 import { BigNumberish } from '../utils/number';
 import { ProviderInterface } from './interface';
 import { BlockIdentifier } from './utils';
@@ -85,9 +85,9 @@ export declare class Provider implements ProviderInterface {
      */
     getTransactionStatus(txHash: BigNumberish): Promise<GetTransactionStatusResponse>;
     /**
-     * Gets the transaction receipt from a tx hash or tx id.
+     * Gets the transaction receipt from a tx hash.
      *
-     * [Reference] (https://github.com/starkware-libs/cairo-lang/blob/master/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L104-L111)
+     * [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
@@ -110,6 +110,13 @@ export declare class Provider implements ProviderInterface {
      * @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
      *

package/dist/provider/default.js

@@ -321,9 +321,9 @@ var Provider = /** @class */ (function () {
         });
     };
     /**
-     * Gets the transaction receipt from a tx hash or tx id.
+     * Gets the transaction receipt from a tx hash.
      *
-     * [Reference] (https://github.com/starkware-libs/cairo-lang/blob/master/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L104-L111)
+     * [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
@@ -370,6 +370,25 @@ var Provider = /** @class */ (function () {
             });
         });
     };
+    /**
+     * 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
+     */
+    Provider.prototype.declareContract = function (payload) {
+        var parsedContract = typeof payload.contract === 'string'
+            ? (0, json_1.parse)(payload.contract)
+            : payload.contract;
+        var contractDefinition = __assign(__assign({}, parsedContract), { program: (0, stark_1.compressProgram)(parsedContract.program) });
+        return this.fetchEndpoint('add_transaction', undefined, {
+            type: 'DECLARE',
+            contract_class: contractDefinition,
+            nonce: (0, number_1.toHex)(constants_1.ZERO),
+            signature: [],
+            sender_address: (0, number_1.toHex)(constants_1.ONE),
+        });
+    };
     /**
      * Deploys a given compiled contract (json) to starknet
      *

package/dist/provider/interface.d.ts

@@ -74,6 +74,14 @@ export declare abstract class ProviderInterface {
      * @returns the transacton object { transaction_id, status, transaction, block_number?, block_number?, transaction_index?, transaction_failure_reason? }
      */
     abstract getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
+    /**
+     * 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
+     */
     abstract getTransactionReceipt(txHash: BigNumberish): Promise<TransactionReceiptResponse>;
     /**
      * Deploys a given compiled contract (json) to starknet

package/dist/types/account.d.ts

@@ -1,5 +1,11 @@
 import BN from 'bn.js';
+import { BlockIdentifier } from '../provider/utils';
+import { BigNumberish } from '../utils/number';
 import { EstimateFeeResponse } from './api';
 export interface EstimateFee extends EstimateFeeResponse {
     suggestedMaxFee: BN;
 }
+export interface EstimateFeeDetails {
+    nonce?: BigNumberish;
+    blockIdentifier?: BlockIdentifier;
+}

package/dist/types/api.d.ts

@@ -84,6 +84,13 @@ export declare type GetContractAddressesResponse = {
     Starknet: string;
     GpsStatementVerifier: string;
 };
+export declare type DeclareTransaction = {
+    type: 'DECLARE';
+    contract_class: CompressedCompiledContract;
+    nonce: BigNumberish;
+    sender_address: BigNumberish;
+    signature: Signature;
+};
 export declare type DeployTransaction = {
     type: 'DEPLOY';
     contract_definition: CompressedCompiledContract;
@@ -122,12 +129,12 @@ export declare type ExecutionResources = {
         bitwise_builtin: number;
         output_builtin: number;
         ecdsa_builtin: number;
-        ec_op_builtin: number;
+        ec_op_builtin?: number;
     };
     n_memory_holes: number;
 };
 export declare type CallContractTransaction = Omit<InvokeFunctionTransaction, 'type' | 'entry_point_type' | 'nonce'>;
-export declare type Transaction = DeployTransaction | InvokeFunctionTransaction;
+export declare type Transaction = DeclareTransaction | DeployTransaction | InvokeFunctionTransaction;
 export declare type CallContractResponse = {
     result: string[];
 };
@@ -153,8 +160,9 @@ export declare type GetBlockResponse = {
             transaction_index: number;
         };
     };
-    previous_block_hash: string;
+    parent_block_hash: string;
     status: Status;
+    gas_price: string;
 };
 export declare type GetCodeResponse = {
     bytecode: string[];
@@ -162,9 +170,8 @@ export declare type GetCodeResponse = {
 };
 export declare type GetTransactionStatusResponse = {
     tx_status: Status;
-    block_hash: string;
+    block_hash?: string;
     tx_failure_reason?: {
-        tx_id: number;
         code: string;
         error_message: string;
     };
@@ -177,27 +184,36 @@ export declare type GetTransactionTraceResponse = {
         selector: string;
         calldata: RawArgs;
         result: Array<any>;
-        execution_resources: any;
+        execution_resources: ExecutionResources;
         internal_call: Array<any>;
         events: Array<any>;
         messages: Array<any>;
     };
     signature: Signature;
 };
-export declare type GetTransactionResponse = {
+export declare type SuccessfulTransactionResponse = {
     status: Status;
     transaction: Transaction;
     block_hash: string;
     block_number: BlockNumber;
     transaction_index: number;
-    transaction_hash: string;
 };
+export declare type FailedTransactionResponse = {
+    status: 'REJECTED';
+    transaction_failure_reason: {
+        code: string;
+        error_message: string;
+    };
+    transaction: Transaction;
+};
+export declare type GetTransactionResponse = SuccessfulTransactionResponse | FailedTransactionResponse;
 export declare type AddTransactionResponse = {
     code: TransactionStatus;
     transaction_hash: string;
     address?: string;
+    class_hash?: string;
 };
-export declare type TransactionReceiptResponse = {
+export declare type SuccessfulTransactionReceiptResponse = {
     status: Status;
     transaction_hash: string;
     transaction_index: number;
@@ -205,7 +221,20 @@ export declare type TransactionReceiptResponse = {
     block_number: BlockNumber;
     l2_to_l1_messages: string[];
     events: string[];
+    actual_fee: string;
+    execution_resources: ExecutionResources;
+};
+export declare type FailedTransactionReceiptResponse = {
+    status: 'REJECTED';
+    transaction_failure_reason: {
+        code: string;
+        error_message: string;
+    };
+    transaction_hash: string;
+    l2_to_l1_messages: string[];
+    events: string[];
 };
+export declare type TransactionReceiptResponse = SuccessfulTransactionReceiptResponse | FailedTransactionReceiptResponse;
 export declare type EstimateFeeResponse = {
     amount: BN;
     unit: string;

package/dist/types/index.d.ts

@@ -2,3 +2,4 @@ export * from './lib';
 export * from './api';
 export * from './signer';
 export * from './contract';
+export * from './account';

package/dist/types/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./lib"), exports);
 __exportStar(require("./api"), exports);
 __exportStar(require("./signer"), exports);
 __exportStar(require("./contract"), exports);
+__exportStar(require("./account"), exports);

package/dist/types/lib.d.ts

@@ -8,6 +8,9 @@ export declare type DeployContractPayload = {
     constructorCalldata?: RawCalldata;
     addressSalt?: BigNumberish;
 };
+export declare type DeclareContractPayload = {
+    contract: CompiledContract | string;
+};
 export declare type Invocation = {
     contractAddress: string;
     entrypoint: string;
@@ -22,7 +25,7 @@ export declare type 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 = 'DEPLOY' | 'INVOKE_FUNCTION';
+export declare type Type = 'DECLARE' | 'DEPLOY' | 'INVOKE_FUNCTION';
 export declare type EntryPointType = 'EXTERNAL';
 export declare type CompressedProgram = string;
 export declare type AbiEntry = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starknet",
-  "version": "3.13.0",
+  "version": "3.14.1",
   "description": "JavaScript library for StarkNet",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/provider/default.d.ts

@@ -4,6 +4,7 @@ import {
   AddTransactionResponse,
   Call,
   CallContractResponse,
+  DeclareContractPayload,
   DeployContractPayload,
   Endpoints,
   GetBlockResponse,
@@ -122,9 +123,9 @@ export declare class Provider implements ProviderInterface {
    */
   getTransactionStatus(txHash: BigNumberish): Promise<GetTransactionStatusResponse>;
   /**
-   * Gets the transaction receipt from a tx hash or tx id.
+   * Gets the transaction receipt from a tx hash.
    *
-   * [Reference] (https://github.com/starkware-libs/cairo-lang/blob/master/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L104-L111)
+   * [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
@@ -147,6 +148,13 @@ export declare class Provider implements ProviderInterface {
    * @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
    *

package/provider/default.js

@@ -478,9 +478,9 @@ var Provider = /** @class */ (function () {
     });
   };
   /**
-   * Gets the transaction receipt from a tx hash or tx id.
+   * Gets the transaction receipt from a tx hash.
    *
-   * [Reference] (https://github.com/starkware-libs/cairo-lang/blob/master/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L104-L111)
+   * [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
@@ -536,6 +536,26 @@ var Provider = /** @class */ (function () {
       });
     });
   };
+  /**
+   * 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
+   */
+  Provider.prototype.declareContract = function (payload) {
+    var parsedContract =
+      typeof payload.contract === 'string' ? (0, json_1.parse)(payload.contract) : payload.contract;
+    var contractDefinition = __assign(__assign({}, parsedContract), {
+      program: (0, stark_1.compressProgram)(parsedContract.program),
+    });
+    return this.fetchEndpoint('add_transaction', undefined, {
+      type: 'DECLARE',
+      contract_class: contractDefinition,
+      nonce: (0, number_1.toHex)(constants_1.ZERO),
+      signature: [],
+      sender_address: (0, number_1.toHex)(constants_1.ONE),
+    });
+  };
   /**
    * Deploys a given compiled contract (json) to starknet
    *

package/provider/interface.d.ts

@@ -96,6 +96,14 @@ export declare abstract class ProviderInterface {
    * @returns the transacton object { transaction_id, status, transaction, block_number?, block_number?, transaction_index?, transaction_failure_reason? }
    */
   abstract getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
+  /**
+   * 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
+   */
   abstract getTransactionReceipt(txHash: BigNumberish): Promise<TransactionReceiptResponse>;
   /**
    * Deploys a given compiled contract (json) to starknet

package/src/account/default.ts

@@ -2,7 +2,6 @@ import assert from 'minimalistic-assert';
 
 import { ZERO } from '../constants';
 import { Provider, ProviderInterface } from '../provider';
-import { BlockIdentifier } from '../provider/utils';
 import { Signer, SignerInterface } from '../signer';
 import {
   Abi,
@@ -15,7 +14,7 @@ import {
   Signature,
   Transaction,
 } from '../types';
-import { EstimateFee } from '../types/account';
+import { EstimateFee, EstimateFeeDetails } from '../types/account';
 import { sign } from '../utils/ellipticCurve';
 import {
   computeHashOnElements,
@@ -56,10 +55,7 @@ export class Account extends Provider implements AccountInterface {
 
   public async estimateFee(
     calls: Call | Call[],
-    {
-      nonce: providedNonce,
-      blockIdentifier = 'pending',
-    }: { nonce?: BigNumberish; blockIdentifier?: BlockIdentifier } = {}
+    { nonce: providedNonce, blockIdentifier = 'pending' }: EstimateFeeDetails = {}
   ): Promise<EstimateFee> {
     const transactions = Array.isArray(calls) ? calls : [calls];
     const nonce = providedNonce ?? (await this.getNonce());
@@ -147,6 +143,7 @@ export class Account extends Provider implements AccountInterface {
    */
   public async LEGACY_addTransaction(transaction: Transaction): Promise<AddTransactionResponse> {
     if (transaction.type === 'DEPLOY') throw new Error('No DEPLOYS');
+    if (transaction.type === 'DECLARE') throw new Error('No DECLARES');
 
     assert(
       !transaction.signature,

package/src/account/interface.ts

@@ -5,11 +5,10 @@ import {
   AddTransactionResponse,
   Call,
   DeployContractPayload,
-  Invocation,
   InvocationsDetails,
   Signature,
 } from '../types';
-import { EstimateFee } from '../types/account';
+import { EstimateFee, EstimateFeeDetails } from '../types/account';
 import { BigNumberish } from '../utils/number';
 import { TypedData } from '../utils/typedData/types';
 
@@ -44,7 +43,10 @@ export abstract class AccountInterface extends ProviderInterface {
    *
    * @returns response from addTransaction
    */
-  public abstract estimateFee(invocation: Invocation): Promise<EstimateFee>;
+  public abstract estimateFee(
+    calls: Call | Call[],
+    estimateFeeDetails?: EstimateFeeDetails
+  ): Promise<EstimateFee>;
 
   /**
    * Invoke execute function in account contract

package/src/constants.ts

@@ -13,6 +13,7 @@ export enum StarknetChainId {
   TESTNET = '0x534e5f474f45524c49', // encodeShortString('SN_GOERLI'),
 }
 export enum TransactionHashPrefix {
+  DECLARE = '0x6465636c617265', // encodeShortString('declare'),
   DEPLOY = '0x6465706c6f79', // encodeShortString('deploy'),
   INVOKE = '0x696e766f6b65', // encodeShortString('invoke'),
   L1_HANDLER = '0x6c315f68616e646c6572', // encodeShortString('l1_handler'),

package/src/provider/default.ts

@@ -1,13 +1,14 @@
 import fetch from 'cross-fetch';
 import urljoin from 'url-join';
 
-import { StarknetChainId } from '../constants';
+import { ONE, StarknetChainId, ZERO } from '../constants';
 import {
   Abi,
   AddTransactionResponse,
   Call,
   CallContractResponse,
   CompiledContract,
+  DeclareContractPayload,
   DeployContractPayload,
   Endpoints,
   GetBlockResponse,
@@ -272,14 +273,13 @@ export class Provider implements ProviderInterface {
   }
 
   /**
-   * Gets the transaction receipt from a tx hash or tx id.
+   * Gets the transaction receipt from a tx hash.
    *
-   * [Reference] (https://github.com/starkware-libs/cairo-lang/blob/master/src/starkware/starknet/services/api/feeder_gateway/feeder_gateway_client.py#L104-L111)
+   * [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
    */
-
   public async getTransactionReceipt(txHash: BigNumberish): Promise<TransactionReceiptResponse> {
     const txHashHex = toHex(toBN(txHash));
     return this.fetchEndpoint('get_transaction_receipt', { transactionHash: txHashHex });
@@ -310,6 +310,31 @@ export class Provider implements ProviderInterface {
     return this.fetchEndpoint('get_transaction_trace', { transactionHash: txHashHex });
   }
 
+  /**
+   * 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
+   */
+  public declareContract(payload: DeclareContractPayload): Promise<AddTransactionResponse> {
+    const parsedContract =
+      typeof payload.contract === 'string'
+        ? (parse(payload.contract) as CompiledContract)
+        : payload.contract;
+    const contractDefinition = {
+      ...parsedContract,
+      program: compressProgram(parsedContract.program),
+    };
+
+    return this.fetchEndpoint('add_transaction', undefined, {
+      type: 'DECLARE',
+      contract_class: contractDefinition,
+      nonce: toHex(ZERO),
+      signature: [],
+      sender_address: toHex(ONE),
+    });
+  }
+
   /**
    * Deploys a given compiled contract (json) to starknet
    *

package/src/provider/interface.ts

@@ -109,6 +109,14 @@ export abstract class ProviderInterface {
    */
   public abstract getTransaction(txHash: BigNumberish): Promise<GetTransactionResponse>;
 
+  /**
+   * 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
+   */
   public abstract getTransactionReceipt(txHash: BigNumberish): Promise<TransactionReceiptResponse>;
 
   /**

package/src/types/account.ts

@@ -1,7 +1,14 @@
 import BN from 'bn.js';
 
+import { BlockIdentifier } from '../provider/utils';
+import { BigNumberish } from '../utils/number';
 import { EstimateFeeResponse } from './api';
 
 export interface EstimateFee extends EstimateFeeResponse {
   suggestedMaxFee: BN;
 }
+
+export interface EstimateFeeDetails {
+  nonce?: BigNumberish;
+  blockIdentifier?: BlockIdentifier;
+}

package/src/types/api.ts

@@ -97,6 +97,14 @@ export type GetContractAddressesResponse = {
   GpsStatementVerifier: string;
 };
 
+export type DeclareTransaction = {
+  type: 'DECLARE';
+  contract_class: CompressedCompiledContract;
+  nonce: BigNumberish;
+  sender_address: BigNumberish;
+  signature: Signature;
+};
+
 export type DeployTransaction = {
   type: 'DEPLOY';
   contract_definition: CompressedCompiledContract;
@@ -138,7 +146,7 @@ export type ExecutionResources = {
     bitwise_builtin: number;
     output_builtin: number;
     ecdsa_builtin: number;
-    ec_op_builtin: number;
+    ec_op_builtin?: number;
   };
   n_memory_holes: number;
 };
@@ -148,7 +156,7 @@ export type CallContractTransaction = Omit<
   'type' | 'entry_point_type' | 'nonce'
 >;
 
-export type Transaction = DeployTransaction | InvokeFunctionTransaction;
+export type Transaction = DeclareTransaction | DeployTransaction | InvokeFunctionTransaction;
 
 export type CallContractResponse = {
   result: string[];
@@ -176,8 +184,9 @@ export type GetBlockResponse = {
       transaction_index: number;
     };
   };
-  previous_block_hash: string;
+  parent_block_hash: string;
   status: Status;
+  gas_price: string;
 };
 
 export type GetCodeResponse = {
@@ -187,9 +196,8 @@ export type GetCodeResponse = {
 
 export type GetTransactionStatusResponse = {
   tx_status: Status;
-  block_hash: string;
+  block_hash?: string;
   tx_failure_reason?: {
-    tx_id: number;
     code: string;
     error_message: string;
   };
@@ -203,7 +211,7 @@ export type GetTransactionTraceResponse = {
     selector: string;
     calldata: RawArgs;
     result: Array<any>;
-    execution_resources: any;
+    execution_resources: ExecutionResources;
     internal_call: Array<any>;
     events: Array<any>;
     messages: Array<any>;
@@ -211,22 +219,33 @@ export type GetTransactionTraceResponse = {
   signature: Signature;
 };
 
-export type GetTransactionResponse = {
+export type SuccessfulTransactionResponse = {
   status: Status;
   transaction: Transaction;
   block_hash: string;
   block_number: BlockNumber;
   transaction_index: number;
-  transaction_hash: string;
 };
 
+export type FailedTransactionResponse = {
+  status: 'REJECTED';
+  transaction_failure_reason: {
+    code: string;
+    error_message: string;
+  };
+  transaction: Transaction;
+};
+
+export type GetTransactionResponse = SuccessfulTransactionResponse | FailedTransactionResponse;
+
 export type AddTransactionResponse = {
   code: TransactionStatus;
   transaction_hash: string;
   address?: string;
+  class_hash?: string;
 };
 
-export type TransactionReceiptResponse = {
+export type SuccessfulTransactionReceiptResponse = {
   status: Status;
   transaction_hash: string;
   transaction_index: number;
@@ -234,8 +253,25 @@ export type TransactionReceiptResponse = {
   block_number: BlockNumber;
   l2_to_l1_messages: string[];
   events: string[];
+  actual_fee: string;
+  execution_resources: ExecutionResources;
 };
 
+export type FailedTransactionReceiptResponse = {
+  status: 'REJECTED';
+  transaction_failure_reason: {
+    code: string;
+    error_message: string;
+  };
+  transaction_hash: string;
+  l2_to_l1_messages: string[];
+  events: string[];
+};
+
+export type TransactionReceiptResponse =
+  | SuccessfulTransactionReceiptResponse
+  | FailedTransactionReceiptResponse;
+
 export type EstimateFeeResponse = {
   amount: BN;
   unit: string;

package/src/types/index.ts

@@ -2,3 +2,4 @@ export * from './lib';
 export * from './api';
 export * from './signer';
 export * from './contract';
+export * from './account';

package/src/types/lib.ts

@@ -12,6 +12,10 @@ export type DeployContractPayload = {
   addressSalt?: BigNumberish;
 };
 
+export type DeclareContractPayload = {
+  contract: CompiledContract | string;
+};
+
 export type Invocation = {
   contractAddress: string;
   entrypoint: string;
@@ -35,7 +39,7 @@ export type Status =
   | 'ACCEPTED_ON_L1'
   | 'REJECTED';
 export type TransactionStatus = 'TRANSACTION_RECEIVED';
-export type Type = 'DEPLOY' | 'INVOKE_FUNCTION';
+export type Type = 'DECLARE' | 'DEPLOY' | 'INVOKE_FUNCTION';
 export type EntryPointType = 'EXTERNAL';
 export type CompressedProgram = string;
 

package/types/account.d.ts

@@ -1,6 +1,12 @@
 import BN from 'bn.js';
 
+import { BlockIdentifier } from '../provider/utils';
+import { BigNumberish } from '../utils/number';
 import { EstimateFeeResponse } from './api';
 export interface EstimateFee extends EstimateFeeResponse {
   suggestedMaxFee: BN;
 }
+export interface EstimateFeeDetails {
+  nonce?: BigNumberish;
+  blockIdentifier?: BlockIdentifier;
+}

package/types/api.d.ts

@@ -94,6 +94,13 @@ export declare type GetContractAddressesResponse = {
   Starknet: string;
   GpsStatementVerifier: string;
 };
+export declare type DeclareTransaction = {
+  type: 'DECLARE';
+  contract_class: CompressedCompiledContract;
+  nonce: BigNumberish;
+  sender_address: BigNumberish;
+  signature: Signature;
+};
 export declare type DeployTransaction = {
   type: 'DEPLOY';
   contract_definition: CompressedCompiledContract;
@@ -132,7 +139,7 @@ export declare type ExecutionResources = {
     bitwise_builtin: number;
     output_builtin: number;
     ecdsa_builtin: number;
-    ec_op_builtin: number;
+    ec_op_builtin?: number;
   };
   n_memory_holes: number;
 };
@@ -140,7 +147,10 @@ export declare type CallContractTransaction = Omit<
   InvokeFunctionTransaction,
   'type' | 'entry_point_type' | 'nonce'
 >;
-export declare type Transaction = DeployTransaction | InvokeFunctionTransaction;
+export declare type Transaction =
+  | DeclareTransaction
+  | DeployTransaction
+  | InvokeFunctionTransaction;
 export declare type CallContractResponse = {
   result: string[];
 };
@@ -166,8 +176,9 @@ export declare type GetBlockResponse = {
       transaction_index: number;
     };
   };
-  previous_block_hash: string;
+  parent_block_hash: string;
   status: Status;
+  gas_price: string;
 };
 export declare type GetCodeResponse = {
   bytecode: string[];
@@ -175,9 +186,8 @@ export declare type GetCodeResponse = {
 };
 export declare type GetTransactionStatusResponse = {
   tx_status: Status;
-  block_hash: string;
+  block_hash?: string;
   tx_failure_reason?: {
-    tx_id: number;
     code: string;
     error_message: string;
   };
@@ -190,27 +200,38 @@ export declare type GetTransactionTraceResponse = {
     selector: string;
     calldata: RawArgs;
     result: Array<any>;
-    execution_resources: any;
+    execution_resources: ExecutionResources;
     internal_call: Array<any>;
     events: Array<any>;
     messages: Array<any>;
   };
   signature: Signature;
 };
-export declare type GetTransactionResponse = {
+export declare type SuccessfulTransactionResponse = {
   status: Status;
   transaction: Transaction;
   block_hash: string;
   block_number: BlockNumber;
   transaction_index: number;
-  transaction_hash: string;
 };
+export declare type FailedTransactionResponse = {
+  status: 'REJECTED';
+  transaction_failure_reason: {
+    code: string;
+    error_message: string;
+  };
+  transaction: Transaction;
+};
+export declare type GetTransactionResponse =
+  | SuccessfulTransactionResponse
+  | FailedTransactionResponse;
 export declare type AddTransactionResponse = {
   code: TransactionStatus;
   transaction_hash: string;
   address?: string;
+  class_hash?: string;
 };
-export declare type TransactionReceiptResponse = {
+export declare type SuccessfulTransactionReceiptResponse = {
   status: Status;
   transaction_hash: string;
   transaction_index: number;
@@ -218,7 +239,22 @@ export declare type TransactionReceiptResponse = {
   block_number: BlockNumber;
   l2_to_l1_messages: string[];
   events: string[];
+  actual_fee: string;
+  execution_resources: ExecutionResources;
+};
+export declare type FailedTransactionReceiptResponse = {
+  status: 'REJECTED';
+  transaction_failure_reason: {
+    code: string;
+    error_message: string;
+  };
+  transaction_hash: string;
+  l2_to_l1_messages: string[];
+  events: string[];
 };
+export declare type TransactionReceiptResponse =
+  | SuccessfulTransactionReceiptResponse
+  | FailedTransactionReceiptResponse;
 export declare type EstimateFeeResponse = {
   amount: BN;
   unit: string;

package/types/index.d.ts

@@ -2,3 +2,4 @@ export * from './lib';
 export * from './api';
 export * from './signer';
 export * from './contract';
+export * from './account';

package/types/index.js

@@ -31,3 +31,4 @@ __exportStar(require('./lib'), exports);
 __exportStar(require('./api'), exports);
 __exportStar(require('./signer'), exports);
 __exportStar(require('./contract'), exports);
+__exportStar(require('./account'), exports);

package/types/lib.d.ts

@@ -9,6 +9,9 @@ export declare type DeployContractPayload = {
   constructorCalldata?: RawCalldata;
   addressSalt?: BigNumberish;
 };
+export declare type DeclareContractPayload = {
+  contract: CompiledContract | string;
+};
 export declare type Invocation = {
   contractAddress: string;
   entrypoint: string;
@@ -29,7 +32,7 @@ export declare type Status =
   | 'ACCEPTED_ON_L1'
   | 'REJECTED';
 export declare type TransactionStatus = 'TRANSACTION_RECEIVED';
-export declare type Type = 'DEPLOY' | 'INVOKE_FUNCTION';
+export declare type Type = 'DECLARE' | 'DEPLOY' | 'INVOKE_FUNCTION';
 export declare type EntryPointType = 'EXTERNAL';
 export declare type CompressedProgram = string;
 export declare type AbiEntry = {

package/www/docs/API/provider.md

@@ -131,11 +131,11 @@ Gets the status of a transaction.
 
 <hr/>
 
-provider.**getTransactionReceipt**(txHash, txId) => _Promise < TransactionReceipt >_
+provider.**getTransactionReceipt**(txHash) => _Promise < TransactionReceiptResponse >_
 
 Gets the status of a transaction.
 
-###### _TransactionReceipt_
+###### _TransactionReceiptResponse_
 
 ```
 {
@@ -198,9 +198,26 @@ Gets the transaction trace from a tx hash.
 
 <hr/>
 
+provider.**declareContract**(payload) => _Promise < AddTransactionResponse >_
+
+Declares a contract on Starknet
+
+###### _AddTransactionResponse_
+
+```
+{
+  code: 'TRANSACTION_RECEIVED';
+  transaction_hash: string;
+  class_hash: string;
+};
+
+<hr/>
+
+```
+
 provider.**deployContract**(payload [ , abi ]) => _Promise < AddTransactionResponse >_
 
-Gets the transaction trace from a tx hash.
+Deploys a contract on Starknet
 
 ###### _AddTransactionResponse_