starknet 5.14.0 → 5.14.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [5.14.1](https://github.com/0xs34n/starknet.js/compare/v5.14.0...v5.14.1) (2023-06-26)
+
+### Bug Fixes
+
+- export utils provider,selector, contract, events. Simulate dev import on tests ([00b7bdf](https://github.com/0xs34n/starknet.js/commit/00b7bdf756c516a1905ce1ecc9036472800989af))
+- redeclare contract ([10da77e](https://github.com/0xs34n/starknet.js/commit/10da77efc6a5e1896af089508e4c403726e9cbf4))
+
 # [5.14.0](https://github.com/0xs34n/starknet.js/compare/v5.13.2...v5.14.0) (2023-06-21)
 
 ### Features

package/dist/index.d.ts

@@ -228,7 +228,7 @@ type CairoAssembly = {
  */
 type CompiledSierra = {
     sierra_program: ByteCode;
-    sierra_program_debug_info: SierraProgramDebugInfo;
+    sierra_program_debug_info?: SierraProgramDebugInfo;
     contract_class_version: string;
     entry_points_by_type: SierraEntryPointsByType;
     abi: Abi;
@@ -269,6 +269,9 @@ type ContractClass = LegacyContractClass | SierraContractClass;
  * format produced after compile .cairo to .json
  */
 type CompiledContract = LegacyCompiledContract | CompiledSierra;
+/**
+ * Compressed or decompressed Cairo0 or Cairo1 Contract
+ */
 type CairoContract = ContractClass | CompiledContract;
 declare enum EntryPointType {
     EXTERNAL = "EXTERNAL",
@@ -1738,9 +1741,13 @@ interface StateUpdateResponse {
         deprecated_declared_classes?: RPC.DeprecatedDeclaredClasses;
     };
 }
-type ContractClassResponse = Omit<ContractClass, 'abi'> & {
-    abi?: Abi;
-};
+/**
+ * Standardized type
+ * Cairo0 program compressed and Cairo1 sierra_program decompressed
+ * abi Abi
+ * CompiledSierra without '.sierra_program_debug_info'
+ */
+type ContractClassResponse = LegacyContractClass | Omit<CompiledSierra, 'sierra_program_debug_info'>;
 
 interface EstimateFee extends EstimateFeeResponse {
     suggestedMaxFee: bigint;
@@ -3140,6 +3147,19 @@ declare function getSelectorFromName(funcName: string): string;
  */
 declare function getSelector(value: string): string;
 
+declare const selector_getSelector: typeof getSelector;
+declare const selector_getSelectorFromName: typeof getSelectorFromName;
+declare const selector_keccakBn: typeof keccakBn;
+declare const selector_starknetKeccak: typeof starknetKeccak;
+declare namespace selector {
+  export {
+    selector_getSelector as getSelector,
+    selector_getSelectorFromName as getSelectorFromName,
+    selector_keccakBn as keccakBn,
+    selector_starknetKeccak as starknetKeccak,
+  };
+}
+
 declare const transactionVersion = 1n;
 declare const transactionVersion_2 = 2n;
 declare const feeTransactionVersion: bigint;
@@ -3643,6 +3663,21 @@ declare namespace starknetId {
   };
 }
 
+declare function wait(delay: number): Promise<unknown>;
+declare function createSierraContractClass(contract: CompiledSierra): SierraContractClass;
+declare function parseContract(contract: CompiledContract | string): ContractClass;
+
+declare const provider_createSierraContractClass: typeof createSierraContractClass;
+declare const provider_parseContract: typeof parseContract;
+declare const provider_wait: typeof wait;
+declare namespace provider {
+  export {
+    provider_createSierraContractClass as createSierraContractClass,
+    provider_parseContract as parseContract,
+    provider_wait as wait,
+  };
+}
+
 declare function addAddressPadding(address: BigNumberish): string;
 declare function validateAndParseAddress(address: BigNumberish): string;
 declare function getChecksumAddress(address: BigNumberish): string;
@@ -3818,6 +3853,34 @@ declare class CallData {
     static toHex(raw?: RawArgs): HexCalldata;
 }
 
+declare function isSierra(contract: CairoContract | string): contract is SierraContractClass | CompiledSierra;
+declare function extractContractHashes(payload: DeclareContractPayload): CompleteDeclareContractPayload;
+/**
+ * Helper to redeclare response Cairo0 contract
+ * @param ccr ContractClassResponse
+ * @returns LegacyCompiledContract
+ */
+declare function contractClassResponseToLegacyCompiledContract(ccr: ContractClassResponse): LegacyCompiledContract;
+
+/**
+ * Parse Transaction Receipt Event from UDC invoke transaction and
+ * create DeployContractResponse compatibile response with adition of UDC Event data
+ *
+ * @param txReceipt
+ * @returns DeployContractResponse | UDC Event Response data
+ */
+declare function parseUDCEvent(txReceipt: InvokeTransactionReceiptResponse): {
+    transaction_hash: string;
+    contract_address: string;
+    address: string;
+    deployer: string;
+    unique: string;
+    classHash: string;
+    calldata_len: string;
+    calldata: string[];
+    salt: string;
+};
+
 /**
  * Main
  */
@@ -3825,4 +3888,4 @@ declare class CallData {
 /** @deprecated prefer the 'num' naming */
 declare const number: typeof num;
 
-export { Abi, AbiEntry, AbiStructs, Account, AccountInterface, AccountInvocationItem, AccountInvocations, AccountInvocationsFactoryDetails, AllowArray, Args, ArgsOrCalldata, ArgsOrCalldataWithOptions, ArraySignatureType, AsyncContractFunction, BigNumberish, BlockIdentifier, BlockNumber, BlockTag, Builtins, ByteCode, CairoAssembly, CairoContract, CairoVersion, Call, CallContractResponse, CallData, CallDetails, CallL1Handler, CallOptions, CallStruct, Calldata, CommonTransactionReceiptResponse, CommonTransactionResponse, CompiledContract, CompiledSierra, CompiledSierraCasm, CompleteDeclareContractPayload, CompressedProgram, Contract, ContractClass, ContractClassResponse, ContractEntryPoint, ContractEntryPointFields, ContractFactory, ContractFunction, ContractInterface, ContractOptions, CustomError, DeclareAndDeployContractPayload, DeclareContractPayload, DeclareContractResponse, DeclareContractTransaction, DeclareDeployUDCResponse, DeclareSignerDetails, DeclareTransactionReceiptResponse, DeclareTransactionResponse, DeployAccountContractPayload, DeployAccountContractTransaction, DeployAccountSignerDetails, DeployContractPayload, DeployContractResponse, DeployContractUDCResponse, DeployedContractItem, Details, EntryPointType, EntryPointsByType, EstimateFee, EstimateFeeAction, EstimateFeeBulk, EstimateFeeDetails, EstimateFeeResponse, EstimateFeeResponseBulk, Event, ExecutionResources, FunctionAbi, FunctionInvocation, GatewayError, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionReceiptResponse, GetTransactionResponse, GetTransactionStatusResponse, HexCalldata, HttpError, Invocation, Invocations, InvocationsDetails, InvocationsDetailsWithNonce, InvocationsSignerDetails, InvokeFunctionResponse, InvokeOptions, InvokeTransactionReceiptResponse, InvokeTransactionResponse, LegacyCompiledContract, LegacyContractClass, LibraryError, MessageToL1, MessageToL2, MultiDeployContractResponse, MultiType, Nonce, OptionalPayload, ParsedStruct, Program, Provider, ProviderInterface, ProviderOptions, PythonicHints, RPC, RawArgs, RawArgsArray, RawArgsObject, RawCalldata, Result, RpcProvider, RpcProviderOptions, SIMULATION_FLAG, Sequencer, SequencerHttpMethod, SequencerIdentifier, SequencerProvider, SequencerProviderOptions, SierraContractClass, SierraContractEntryPointFields, SierraEntryPointsByType, SierraProgramDebugInfo, Signature, Signer, SignerInterface, SimulateTransactionDetails, SimulateTransactionResponse, SimulatedTransaction, SimulationFlags, StarkNetDomain, StarkNetMerkleType, StarkNetType, StateUpdateResponse, Status, Storage, Struct, StructAbi, TransactionStatus, TransactionType, Tupled, TypedData, Uint256, UniversalDeployerContractPayload, WeierstrassSignatureType, addAddressPadding, buildUrl, cairo, constants, defaultProvider, ec, encode, fixProto, fixStack, getCalldata, getChecksumAddress, getEstimateFeeBulkOptions, getSimulateTransactionOptions, hash, isUrl, json, merkle, num, number, shortString, splitArgsAndOptions, stark, starknetId, transaction, typedData, index as types, uint256$1 as uint256, validateAndParseAddress, validateChecksumAddress, waitForTransactionOptions };
+export { Abi, AbiEntry, AbiStructs, Account, AccountInterface, AccountInvocationItem, AccountInvocations, AccountInvocationsFactoryDetails, AllowArray, Args, ArgsOrCalldata, ArgsOrCalldataWithOptions, ArraySignatureType, AsyncContractFunction, BigNumberish, BlockIdentifier, BlockNumber, BlockTag, Builtins, ByteCode, CairoAssembly, CairoContract, CairoVersion, Call, CallContractResponse, CallData, CallDetails, CallL1Handler, CallOptions, CallStruct, Calldata, CommonTransactionReceiptResponse, CommonTransactionResponse, CompiledContract, CompiledSierra, CompiledSierraCasm, CompleteDeclareContractPayload, CompressedProgram, Contract, ContractClass, ContractClassResponse, ContractEntryPoint, ContractEntryPointFields, ContractFactory, ContractFunction, ContractInterface, ContractOptions, CustomError, DeclareAndDeployContractPayload, DeclareContractPayload, DeclareContractResponse, DeclareContractTransaction, DeclareDeployUDCResponse, DeclareSignerDetails, DeclareTransactionReceiptResponse, DeclareTransactionResponse, DeployAccountContractPayload, DeployAccountContractTransaction, DeployAccountSignerDetails, DeployContractPayload, DeployContractResponse, DeployContractUDCResponse, DeployedContractItem, Details, EntryPointType, EntryPointsByType, EstimateFee, EstimateFeeAction, EstimateFeeBulk, EstimateFeeDetails, EstimateFeeResponse, EstimateFeeResponseBulk, Event, ExecutionResources, FunctionAbi, FunctionInvocation, GatewayError, GetBlockResponse, GetCodeResponse, GetContractAddressesResponse, GetTransactionReceiptResponse, GetTransactionResponse, GetTransactionStatusResponse, HexCalldata, HttpError, Invocation, Invocations, InvocationsDetails, InvocationsDetailsWithNonce, InvocationsSignerDetails, InvokeFunctionResponse, InvokeOptions, InvokeTransactionReceiptResponse, InvokeTransactionResponse, LegacyCompiledContract, LegacyContractClass, LibraryError, MessageToL1, MessageToL2, MultiDeployContractResponse, MultiType, Nonce, OptionalPayload, ParsedStruct, Program, Provider, ProviderInterface, ProviderOptions, PythonicHints, RPC, RawArgs, RawArgsArray, RawArgsObject, RawCalldata, Result, RpcProvider, RpcProviderOptions, SIMULATION_FLAG, Sequencer, SequencerHttpMethod, SequencerIdentifier, SequencerProvider, SequencerProviderOptions, SierraContractClass, SierraContractEntryPointFields, SierraEntryPointsByType, SierraProgramDebugInfo, Signature, Signer, SignerInterface, SimulateTransactionDetails, SimulateTransactionResponse, SimulatedTransaction, SimulationFlags, StarkNetDomain, StarkNetMerkleType, StarkNetType, StateUpdateResponse, Status, Storage, Struct, StructAbi, TransactionStatus, TransactionType, Tupled, TypedData, Uint256, UniversalDeployerContractPayload, WeierstrassSignatureType, addAddressPadding, buildUrl, cairo, constants, contractClassResponseToLegacyCompiledContract, defaultProvider, ec, encode, extractContractHashes, fixProto, fixStack, getCalldata, getChecksumAddress, getEstimateFeeBulkOptions, getSimulateTransactionOptions, hash, isSierra, isUrl, json, merkle, num, number, parseUDCEvent, provider, selector, shortString, splitArgsAndOptions, stark, starknetId, transaction, typedData, index as types, uint256$1 as uint256, validateAndParseAddress, validateChecksumAddress, waitForTransactionOptions };

package/dist/index.global.js

@@ -637,19 +637,25 @@ var starknet = (() => {
     buildUrl: () => buildUrl,
     cairo: () => cairo_exports,
     constants: () => constants_exports,
+    contractClassResponseToLegacyCompiledContract: () => contractClassResponseToLegacyCompiledContract,
     defaultProvider: () => defaultProvider,
     ec: () => ec_exports,
     encode: () => encode_exports,
+    extractContractHashes: () => extractContractHashes,
     fixProto: () => fixProto,
     fixStack: () => fixStack,
     getCalldata: () => getCalldata,
     getChecksumAddress: () => getChecksumAddress,
     hash: () => hash_exports,
+    isSierra: () => isSierra,
     isUrl: () => isUrl,
     json: () => json_exports,
     merkle: () => merkle_exports,
     num: () => num_exports,
     number: () => number2,
+    parseUDCEvent: () => parseUDCEvent,
+    provider: () => provider_exports,
+    selector: () => selector_exports,
     shortString: () => shortString_exports,
     splitArgsAndOptions: () => splitArgsAndOptions,
     stark: () => stark_exports,
@@ -3185,6 +3191,15 @@ var starknet = (() => {
     return hexToBytes(adaptedValue);
   }
 
+  // src/utils/selector.ts
+  var selector_exports = {};
+  __export(selector_exports, {
+    getSelector: () => getSelector,
+    getSelectorFromName: () => getSelectorFromName,
+    keccakBn: () => keccakBn,
+    starknetKeccak: () => starknetKeccak
+  });
+
   // node_modules/micro-starknet/lib/esm/index.js
   var esm_exports = {};
   __export(esm_exports, {
@@ -7401,34 +7416,6 @@ var starknet = (() => {
     return computeLegacyContractClassHash(compiledContract);
   }
 
-  // src/utils/contract.ts
-  function isSierra(contract) {
-    const compiledContract = typeof contract === "string" ? parse2(contract) : contract;
-    return "sierra_program" in compiledContract;
-  }
-  function extractContractHashes(payload) {
-    const response = { ...payload };
-    if (isSierra(payload.contract)) {
-      if (!payload.compiledClassHash && payload.casm) {
-        response.compiledClassHash = computeCompiledClassHash(payload.casm);
-      }
-      if (!response.compiledClassHash)
-        throw new Error(
-          "Extract compiledClassHash failed, provide (CairoAssembly).casm file or compiledClassHash"
-        );
-    }
-    response.classHash = payload.classHash ?? computeContractClassHash(payload.contract);
-    if (!response.classHash)
-      throw new Error("Extract classHash failed, provide (CompiledContract).json file or classHash");
-    return response;
-  }
-
-  // src/utils/fetchPonyfill.ts
-  var import_isomorphic_fetch = __toESM(require_fetch_npm_browserify());
-  var fetchPonyfill_default = typeof window !== "undefined" && window.fetch || // use buildin fetch in browser if available
-  typeof global !== "undefined" && global.fetch || // use buildin fetch in node, react-native and service worker if available
-  import_isomorphic_fetch.default;
-
   // src/utils/stark.ts
   var stark_exports = {};
   __export(stark_exports, {
@@ -11648,7 +11635,48 @@ var starknet = (() => {
     return toBigInt(estimatedFee) * toBigInt(overHeadPercent) / 100n;
   }
 
+  // src/utils/contract.ts
+  function isSierra(contract) {
+    const compiledContract = typeof contract === "string" ? parse2(contract) : contract;
+    return "sierra_program" in compiledContract;
+  }
+  function extractContractHashes(payload) {
+    const response = { ...payload };
+    if (isSierra(payload.contract)) {
+      if (!payload.compiledClassHash && payload.casm) {
+        response.compiledClassHash = computeCompiledClassHash(payload.casm);
+      }
+      if (!response.compiledClassHash)
+        throw new Error(
+          "Extract compiledClassHash failed, provide (CairoAssembly).casm file or compiledClassHash"
+        );
+    }
+    response.classHash = payload.classHash ?? computeContractClassHash(payload.contract);
+    if (!response.classHash)
+      throw new Error("Extract classHash failed, provide (CompiledContract).json file or classHash");
+    return response;
+  }
+  function contractClassResponseToLegacyCompiledContract(ccr) {
+    if (isSierra(ccr)) {
+      throw Error("ContractClassResponse need to be LegacyContractClass (cairo0 response class)");
+    }
+    const contract = ccr;
+    return { ...contract, program: decompressProgram(contract.program) };
+  }
+
+  // src/utils/fetchPonyfill.ts
+  var import_isomorphic_fetch = __toESM(require_fetch_npm_browserify());
+  var fetchPonyfill_default = typeof window !== "undefined" && window.fetch || // use buildin fetch in browser if available
+  typeof global !== "undefined" && global.fetch || // use buildin fetch in node, react-native and service worker if available
+  import_isomorphic_fetch.default;
+
   // src/utils/provider.ts
+  var provider_exports = {};
+  __export(provider_exports, {
+    createSierraContractClass: () => createSierraContractClass,
+    parseContract: () => parseContract,
+    wait: () => wait
+  });
   function wait(delay) {
     return new Promise((res) => {
       setTimeout(res, delay);
@@ -11667,7 +11695,6 @@ var starknet = (() => {
     if (!isSierra(contract)) {
       return {
         ...parsedContract,
-        // TODO: Why do we gzip program object?
         ..."program" in parsedContract && { program: compressProgram(parsedContract.program) }
       };
     }
@@ -12159,14 +12186,13 @@ var starknet = (() => {
     }
     async declareContract({ contract, signature, senderAddress, compiledClassHash }, details) {
       if (!isSierra(contract)) {
-        const legacyContract = contract;
         return this.fetchEndpoint("starknet_addDeclareTransaction", {
           declare_transaction: {
             type: RPC.TransactionType.DECLARE,
             contract_class: {
-              program: legacyContract.program,
-              entry_points_by_type: legacyContract.entry_points_by_type,
-              abi: legacyContract.abi
+              program: contract.program,
+              entry_points_by_type: contract.entry_points_by_type,
+              abi: contract.abi
             },
             version: toHex(transactionVersion),
             max_fee: toHex(details.maxFee || 0),
@@ -12176,15 +12202,14 @@ var starknet = (() => {
           }
         });
       }
-      const sierraContract = contract;
       return this.fetchEndpoint("starknet_addDeclareTransaction", {
         declare_transaction: {
           type: RPC.TransactionType.DECLARE,
           contract_class: {
-            sierra_program: decompressProgram(sierraContract.sierra_program),
-            contract_class_version: sierraContract.contract_class_version,
-            entry_points_by_type: sierraContract.entry_points_by_type,
-            abi: sierraContract.abi
+            sierra_program: decompressProgram(contract.sierra_program),
+            contract_class_version: contract.contract_class_version,
+            entry_points_by_type: contract.entry_points_by_type,
+            abi: contract.abi
           },
           compiled_class_hash: compiledClassHash || "",
           version: toHex(transactionVersion_2),