starknet 8.5.4 → 8.6.0

package/dist/index.mjs

@@ -130,7 +130,7 @@ function buf2hex(buffer) {
   return buffer.reduce((r, x) => r + x.toString(16).padStart(2, "0"), "");
 }
 function removeHexPrefix(hex) {
-  return hex.replace(/^0x/i, "");
+  return hex.startsWith("0x") || hex.startsWith("0X") ? hex.slice(2) : hex;
 }
 function addHexPrefix(hex) {
   return `0x${removeHexPrefix(hex)}`;
@@ -172,11 +172,10 @@ function concatenateArrayBuffer(uint8arrays) {
   return result;
 }
 function hexStringToUint8Array(hex) {
-  const cleanHex2 = hex.startsWith("0x") ? hex.slice(2) : hex;
-  if (cleanHex2.length > 0 && !/^[0-9a-fA-F]+$/.test(cleanHex2)) {
-    throw new Error(`Invalid hex string: "${hex}" contains non-hexadecimal characters`);
+  if (!isHexString(addHexPrefix(hex))) {
+    throw new Error(`Invalid hex string: "${hex}"`);
   }
-  const paddedHex = cleanHex2.length % 2 !== 0 ? `0${cleanHex2}` : cleanHex2;
+  const paddedHex = removeHexPrefix(sanitizeHex(hex));
   const bytes = new Uint8Array(paddedHex.length / 2);
   for (let i = 0; i < paddedHex.length; i += 2) {
     bytes[i / 2] = parseInt(paddedHex.substring(i, i + 2), 16);
@@ -316,7 +315,8 @@ var DEFAULT_GLOBAL_CONFIG = {
   defaultTipType: "recommendedTip",
   fetch: void 0,
   websocket: void 0,
-  buffer: void 0
+  buffer: void 0,
+  blake: void 0
 };
 var RPC_DEFAULT_NODES = {
   SN_MAIN: [`https://starknet-mainnet.public.blastapi.io/rpc/`],
@@ -817,6 +817,9 @@ function toHex(value) {
   return addHexPrefix(toBigInt(value).toString(16));
 }
 var toHexString = toHex;
+function cleanHex(hex) {
+  return toHex(hex);
+}
 function toStorageKey(number) {
   return addHexPrefix(toBigInt(number).toString(16).padStart(64, "0"));
 }
@@ -828,9 +831,6 @@ function toHex64(number) {
 function hexToDecimalString(hex) {
   return BigInt(addHexPrefix(hex)).toString(10);
 }
-function cleanHex(hex) {
-  return hex.toLowerCase().replace(/^(0x)0+/, "$1");
-}
 function assertInRange(input, lowerBound, upperBound, inputName = "") {
   const messageSuffix = inputName === "" ? "invalid length" : `invalid ${inputName} length`;
   const inputBigInt = BigInt(input);
@@ -4613,12 +4613,16 @@ var CallData = class _CallData {
 // src/utils/hash/index.ts
 var hash_exports = {};
 __export(hash_exports, {
+  COMPILED_CLASS_VERSION: () => COMPILED_CLASS_VERSION,
+  blake2sHashMany: () => blake2sHashMany,
   calculateContractAddressFromHash: () => calculateContractAddressFromHash,
   calculateDeclareTransactionHash: () => calculateDeclareTransactionHash3,
   calculateDeployAccountTransactionHash: () => calculateDeployAccountTransactionHash3,
   calculateInvokeTransactionHash: () => calculateInvokeTransactionHash2,
   calculateL2MessageTxHash: () => calculateL2MessageTxHash,
   computeCompiledClassHash: () => computeCompiledClassHash,
+  computeCompiledClassHashBlake: () => computeCompiledClassHashBlake,
+  computeCompiledClassHashPoseidon: () => computeCompiledClassHashPoseidon,
   computeContractClassHash: () => computeContractClassHash,
   computeHashOnElements: () => computeHashOnElements2,
   computeHintedClassHash: () => computeHintedClassHash,
@@ -4628,13 +4632,17 @@ __export(hash_exports, {
   computePoseidonHash: () => computePoseidonHash,
   computePoseidonHashOnElements: () => computePoseidonHashOnElements,
   computeSierraContractClassHash: () => computeSierraContractClassHash,
+  encodeBuiltins: () => encodeBuiltins,
+  flattenEntryPointData: () => flattenEntryPointData,
   formatSpaces: () => formatSpaces,
   getL1MessageHash: () => getL1MessageHash,
   getL2MessageHash: () => getL2MessageHash,
   getSelector: () => getSelector,
   getSelectorFromName: () => getSelectorFromName,
   hashByteCodeSegments: () => hashByteCodeSegments,
+  hashByteCodeSegmentsBlake: () => hashByteCodeSegmentsBlake,
   keccakBn: () => keccakBn,
+  nullSkipReplacer: () => nullSkipReplacer,
   poseidon: () => poseidon,
   solidityUint256PackedKeccak256: () => solidityUint256PackedKeccak256,
   starknetKeccak: () => starknetKeccak
@@ -4899,21 +4907,51 @@ function calculateDeployAccountTransactionHash3(args) {
   throw new Error("Invalid Tx version for hash calculation");
 }
 
-// src/utils/hash/classHash.ts
-import { poseidonHashMany as poseidonHashMany2 } from "@scure/starknet";
+// src/utils/hash/classHash/util.ts
+var COMPILED_CLASS_VERSION = "COMPILED_CLASS_V1";
+function formatSpaces(json2) {
+  let insideQuotes = false;
+  const newString = [];
+  for (const char of json2) {
+    if (char === '"' && (newString.length > 0 && newString.slice(-1)[0] === "\\") === false) {
+      insideQuotes = !insideQuotes;
+    }
+    if (insideQuotes) {
+      newString.push(char);
+    } else {
+      newString.push(char === ":" ? ": " : char === "," ? ", " : char);
+    }
+  }
+  return newString.join("");
+}
+function nullSkipReplacer(key, value) {
+  if (key === "attributes" || key === "accessible_scopes") {
+    return Array.isArray(value) && value.length === 0 ? void 0 : value;
+  }
+  if (key === "debug_info") {
+    return null;
+  }
+  return value === null ? void 0 : value;
+}
+function encodeBuiltins(builtins) {
+  return builtins.map((it) => BigInt(encodeShortString(it)));
+}
+function flattenEntryPointData(data, encodedBuiltinsArray) {
+  return data.flatMap((it, index) => [
+    BigInt(it.selector),
+    BigInt(it.offset),
+    ...encodedBuiltinsArray[index]
+  ]);
+}
+
+// src/utils/hash/classHash/pedersen.ts
 function computePedersenHash(a, b) {
   return starkCurve.pedersen(BigInt(a), BigInt(b));
 }
-function computePoseidonHash(a, b) {
-  return toHex(starkCurve.poseidonHash(BigInt(a), BigInt(b)));
-}
 function computeHashOnElements2(data) {
   return [...data, data.length].reduce((x, y) => starkCurve.pedersen(BigInt(x), BigInt(y)), 0).toString();
 }
 var computePedersenHashOnElements = computeHashOnElements2;
-function computePoseidonHashOnElements(data) {
-  return toHex(poseidonHashMany2(data.map((x) => BigInt(x))));
-}
 function calculateContractAddressFromHash(salt, classHash, constructorCalldata, deployerAddress) {
   const compiledCalldata = CallData.compile(constructorCalldata);
   const constructorCalldataHash = computeHashOnElements2(compiledCalldata);
@@ -4927,30 +4965,6 @@ function calculateContractAddressFromHash(salt, classHash, constructorCalldata,
   ]);
   return toHex(BigInt(hash) % ADDR_BOUND);
 }
-function nullSkipReplacer(key, value) {
-  if (key === "attributes" || key === "accessible_scopes") {
-    return Array.isArray(value) && value.length === 0 ? void 0 : value;
-  }
-  if (key === "debug_info") {
-    return null;
-  }
-  return value === null ? void 0 : value;
-}
-function formatSpaces(json2) {
-  let insideQuotes = false;
-  const newString = [];
-  for (const char of json2) {
-    if (char === '"' && (newString.length > 0 && newString.slice(-1)[0] === "\\") === false) {
-      insideQuotes = !insideQuotes;
-    }
-    if (insideQuotes) {
-      newString.push(char);
-    } else {
-      newString.push(char === ":" ? ": " : char === "," ? ", " : char);
-    }
-  }
-  return newString.join("");
-}
 function computeHintedClassHash(compiledContract) {
   const { abi, program } = compiledContract;
   const contractClass = { abi, program };
@@ -4984,12 +4998,17 @@ function computeLegacyContractClassHash(contract) {
     dataHash
   ]);
 }
+
+// src/utils/hash/classHash/poseidon.ts
+import { poseidonHashMany as poseidonHashMany2 } from "@scure/starknet";
+function computePoseidonHash(a, b) {
+  return toHex(starkCurve.poseidonHash(BigInt(a), BigInt(b)));
+}
+function computePoseidonHashOnElements(data) {
+  return toHex(poseidonHashMany2(data.map((x) => BigInt(x))));
+}
 function hashBuiltins(builtins) {
-  return poseidonHashMany2(
-    builtins.flatMap((it) => {
-      return BigInt(encodeShortString(it));
-    })
-  );
+  return poseidonHashMany2(encodeBuiltins(builtins));
 }
 function hashEntryPoint(data) {
   const base = data.flatMap((it) => {
@@ -5007,8 +5026,7 @@ function hashByteCodeSegments(casm) {
   });
   return 1n + poseidonHashMany2(hashLeaves);
 }
-function computeCompiledClassHash(casm) {
-  const COMPILED_CLASS_VERSION = "COMPILED_CLASS_V1";
+function computeCompiledClassHashPoseidon(casm) {
   const compiledClassVersion = BigInt(encodeShortString(COMPILED_CLASS_VERSION));
   const externalEntryPointsHash = hashEntryPoint(casm.entry_points_by_type.EXTERNAL);
   const l1Handlers = hashEntryPoint(casm.entry_points_by_type.L1_HANDLER);
@@ -5053,6 +5071,161 @@ function computeSierraContractClassHash(sierra) {
     ])
   );
 }
+
+// src/utils/connect/blake.ts
+import { blake2s } from "@noble/hashes/blake2s";
+function blakeHash(uint8Array) {
+  return config.get("blake")?.(uint8Array) || blake2s(uint8Array, { dkLen: 32 });
+}
+
+// src/utils/hash/classHash/blake.ts
+function blake2sHashMany(data) {
+  const SMALL_THRESHOLD = 0x8000000000000000n;
+  const BIG_MARKER = 2147483648;
+  const u32Words = [];
+  const buf = new ArrayBuffer(32);
+  const feltView = new DataView(buf);
+  for (const felt2 of data) {
+    const u64_0 = felt2 & 0xffffffffffffffffn;
+    const u64_1 = (felt2 & 0xffffffffffffffff0000000000000000n) >> 64n;
+    const u64_2 = (felt2 & 0xffffffffffffffff00000000000000000000000000000000n) >> 128n;
+    const u64_3 = (felt2 & 0xffffffffffffffff000000000000000000000000000000000000000000000000n) >> 192n;
+    feltView.setBigUint64(0, u64_3, false);
+    feltView.setBigUint64(8, u64_2, false);
+    feltView.setBigUint64(16, u64_1, false);
+    feltView.setBigUint64(24, u64_0, false);
+    if (felt2 < SMALL_THRESHOLD) {
+      const hi0 = feltView.getUint32(24, false);
+      const lo0 = feltView.getUint32(28, false);
+      u32Words.push(hi0, lo0);
+    } else {
+      const word0 = feltView.getUint32(0, false) | BIG_MARKER;
+      const word1 = feltView.getUint32(4, false);
+      const word2 = feltView.getUint32(8, false);
+      const word3 = feltView.getUint32(12, false);
+      const word4 = feltView.getUint32(16, false);
+      const word5 = feltView.getUint32(20, false);
+      const word6 = feltView.getUint32(24, false);
+      const word7 = feltView.getUint32(28, false);
+      u32Words.push(word0, word1, word2, word3, word4, word5, word6, word7);
+    }
+  }
+  const bytes = new ArrayBuffer(u32Words.length * 4);
+  const bytesView = new DataView(bytes);
+  for (let i = 0; i < u32Words.length; i++) {
+    bytesView.setUint32(i * 4, u32Words[i], true);
+  }
+  const hash = blakeHash(new Uint8Array(bytes));
+  let hashBigInt = 0n;
+  for (let i = 0; i < 32; i++) {
+    hashBigInt |= BigInt(hash[i]) << BigInt(i * 8);
+  }
+  return hashBigInt % PRIME;
+}
+function hashBuiltinsBlake(builtins) {
+  return blake2sHashMany(encodeBuiltins(builtins));
+}
+function hashEntryPointBlake(data) {
+  const base = data.flatMap((it) => {
+    return [BigInt(it.selector), BigInt(it.offset), hashBuiltinsBlake(it.builtins)];
+  });
+  return blake2sHashMany(base);
+}
+function bytecodeHashNodeBlake(iter, node) {
+  if (typeof node === "number") {
+    const data = [];
+    for (let i = 0; i < node; i++) {
+      const next = iter.next();
+      if (next.done) throw new Error("Bytecode length mismatch");
+      data.push(next.value);
+    }
+    return [node, blake2sHashMany(data)];
+  }
+  const innerNodes = node.map((child) => bytecodeHashNodeBlake(iter, child));
+  const flatData = innerNodes.flatMap(([len, hash2]) => [BigInt(len), hash2]);
+  const hash = blake2sHashMany(flatData) + 1n;
+  const totalLen = innerNodes.reduce((sum, [len]) => sum + len, 0);
+  return [totalLen, hash];
+}
+function hashByteCodeSegmentsBlake(casm) {
+  const byteCode = casm.bytecode.map((n) => BigInt(n));
+  const bytecodeSegmentLengths = casm.bytecode_segment_lengths;
+  if (!bytecodeSegmentLengths) {
+    return blake2sHashMany(byteCode);
+  }
+  const iter = byteCode[Symbol.iterator]();
+  const [len, hash] = bytecodeHashNodeBlake(iter, bytecodeSegmentLengths);
+  if (len !== byteCode.length) {
+    throw new Error(`Bytecode length mismatch: expected ${byteCode.length}, got ${len}`);
+  }
+  return hash;
+}
+function computeCompiledClassHashBlake(casm) {
+  const compiledClassVersion = BigInt(encodeShortString(COMPILED_CLASS_VERSION));
+  const externalEntryPointsHash = hashEntryPointBlake(casm.entry_points_by_type.EXTERNAL);
+  const l1Handlers = hashEntryPointBlake(casm.entry_points_by_type.L1_HANDLER);
+  const constructor = hashEntryPointBlake(casm.entry_points_by_type.CONSTRUCTOR);
+  const bytecode = hashByteCodeSegmentsBlake(casm);
+  return toHex(
+    blake2sHashMany([
+      compiledClassVersion,
+      externalEntryPointsHash,
+      l1Handlers,
+      constructor,
+      bytecode
+    ])
+  );
+}
+
+// src/utils/resolve.ts
+function isV3Tx(details) {
+  const version = details.version ? toHex(details.version) : ETransactionVersion2.V3;
+  return version === ETransactionVersion2.V3 || version === ETransactionVersion2.F3;
+}
+function isVersion(expected, provided) {
+  const expectedParts = expected.split(".");
+  const providedParts = provided.split(".");
+  return expectedParts.every((part, index) => part === "*" || part === providedParts[index]);
+}
+function isSupportedSpecVersion(version, options = { allowAnyPatchVersion: false }) {
+  return Object.values(_SupportedRpcVersion).some(
+    (v) => isVersion(options.allowAnyPatchVersion ? toAnyPatchVersion(v) : v, version)
+  );
+}
+function toAnyPatchVersion(version) {
+  const parts = version.split(".");
+  if (parts.length < 3) {
+    return version;
+  }
+  return `${parts[0]}.${parts[1]}.*`;
+}
+function toApiVersion(version) {
+  const [major, minor] = version.replace(/^v/, "").split(".");
+  return `v${major}_${minor}`;
+}
+function compareVersions(a, b) {
+  const aParts = a.split(".").map(Number);
+  const bParts = b.split(".").map(Number);
+  const maxLen = Math.max(aParts.length, bParts.length);
+  for (let i = 0; i < maxLen; i += 1) {
+    const aNum = aParts[i] || 0;
+    const bNum = bParts[i] || 0;
+    if (aNum > bNum) return 1;
+    if (aNum < bNum) return -1;
+  }
+  return 0;
+}
+function isPendingBlock(response) {
+  return response.status === "PENDING";
+}
+function isPendingTransaction(response) {
+  return !("block_hash" in response);
+}
+function isPendingStateUpdate(response) {
+  return !("block_hash" in response);
+}
+
+// src/utils/hash/classHash/index.ts
 function computeContractClassHash(contract) {
   const compiledContract = isString(contract) ? parse2(contract) : contract;
   if ("sierra_program" in compiledContract) {
@@ -5060,6 +5233,12 @@ function computeContractClassHash(contract) {
   }
   return computeLegacyContractClassHash(compiledContract);
 }
+function computeCompiledClassHash(casm, specVersion) {
+  if (specVersion && compareVersions(specVersion, "0.10.0") >= 0) {
+    return computeCompiledClassHashBlake(casm);
+  }
+  return computeCompiledClassHashPoseidon(casm);
+}
 
 // src/utils/stark/index.ts
 var stark_exports = {};
@@ -5265,11 +5444,11 @@ function isSierra(contract) {
   const compiledContract = isString(contract) ? parse2(contract) : contract;
   return "sierra_program" in compiledContract;
 }
-function extractContractHashes(payload) {
+function extractContractHashes(payload, specVersion) {
   const response = { ...payload };
   if (isSierra(payload.contract)) {
     if (!payload.compiledClassHash && payload.casm) {
-      response.compiledClassHash = computeCompiledClassHash(payload.casm);
+      response.compiledClassHash = computeCompiledClassHash(payload.casm, specVersion);
     }
     if (!response.compiledClassHash)
       throw new Error(
@@ -5326,44 +5505,6 @@ __export(provider_exports, {
   validBlockTags: () => validBlockTags,
   wait: () => wait
 });
-
-// src/utils/resolve.ts
-function isV3Tx(details) {
-  const version = details.version ? toHex(details.version) : ETransactionVersion2.V3;
-  return version === ETransactionVersion2.V3 || version === ETransactionVersion2.F3;
-}
-function isVersion(expected, provided) {
-  const expectedParts = expected.split(".");
-  const providedParts = provided.split(".");
-  return expectedParts.every((part, index) => part === "*" || part === providedParts[index]);
-}
-function isSupportedSpecVersion(version, options = { allowAnyPatchVersion: false }) {
-  return Object.values(_SupportedRpcVersion).some(
-    (v) => isVersion(options.allowAnyPatchVersion ? toAnyPatchVersion(v) : v, version)
-  );
-}
-function toAnyPatchVersion(version) {
-  const parts = version.split(".");
-  if (parts.length < 3) {
-    return version;
-  }
-  return `${parts[0]}.${parts[1]}.*`;
-}
-function toApiVersion(version) {
-  const [major, minor] = version.replace(/^v/, "").split(".");
-  return `v${major}_${minor}`;
-}
-function isPendingBlock(response) {
-  return response.status === "PENDING";
-}
-function isPendingTransaction(response) {
-  return !("block_hash" in response);
-}
-function isPendingStateUpdate(response) {
-  return !("block_hash" in response);
-}
-
-// src/utils/provider.ts
 function wait(delay) {
   return new Promise((res) => {
     setTimeout(res, delay);
@@ -8537,7 +8678,10 @@ var RpcProvider = class {
   async isClassDeclared(contractClassIdentifier, blockIdentifier) {
     let classHash;
     if (!contractClassIdentifier.classHash && "contract" in contractClassIdentifier) {
-      const hashes = extractContractHashes(contractClassIdentifier);
+      const hashes = extractContractHashes(
+        contractClassIdentifier,
+        await this.channel.setUpSpecVersion()
+      );
       classHash = hashes.classHash;
     } else if (contractClassIdentifier.classHash) {
       classHash = contractClassIdentifier.classHash;
@@ -10808,7 +10952,7 @@ var Deployer = class {
       throw new Error("Deployer emitted event is empty");
     }
     const event = txReceipt.events.find(
-      (it) => cleanHex(it.from_address) === cleanHex(toHex(this.address))
+      (it) => toHex(it.from_address) === toHex(this.address)
     ) || {
       data: []
     };
@@ -10908,7 +11052,10 @@ var Account = class extends RpcProvider2 {
       "Declare fee estimation is not supported for Cairo0 contracts"
     );
     const invocations = [
-      { type: api_exports.ETransactionType.DECLARE, payload: extractContractHashes(payload) }
+      {
+        type: api_exports.ETransactionType.DECLARE,
+        payload: extractContractHashes(payload, await this.channel.setUpSpecVersion())
+      }
     ];
     const estimateBulk = await this.estimateFeeBulk(invocations, details);
     return estimateBulk[0];
@@ -11071,7 +11218,10 @@ var Account = class extends RpcProvider2 {
    * @param transactionsDetail (optional)
    */
   async declareIfNot(payload, transactionsDetail = {}) {
-    const declareContractPayload = extractContractHashes(payload);
+    const declareContractPayload = extractContractHashes(
+      payload,
+      await this.channel.setUpSpecVersion()
+    );
     try {
       await this.getClassByHash(declareContractPayload.classHash);
     } catch (error) {
@@ -11084,7 +11234,10 @@ var Account = class extends RpcProvider2 {
   }
   async declare(payload, details = {}) {
     assert(isSierra(payload.contract), SYSTEM_MESSAGES.declareNonSierra);
-    const declareContractPayload = extractContractHashes(payload);
+    const declareContractPayload = extractContractHashes(
+      payload,
+      await this.channel.setUpSpecVersion()
+    );
     const detailsWithTip = await this.resolveDetailsWithTip(details);
     const { resourceBounds: providedResourceBounds } = details;
     let resourceBounds = providedResourceBounds;
@@ -11391,7 +11544,10 @@ var Account = class extends RpcProvider2 {
     };
   }
   async buildDeclarePayload(payload, details) {
-    const { classHash, contract, compiledClassHash } = extractContractHashes(payload);
+    const { classHash, contract, compiledClassHash } = extractContractHashes(
+      payload,
+      await this.channel.setUpSpecVersion()
+    );
     const compressedCompiledContract = parseContract(contract);
     assert(
       !isUndefined(compiledClassHash) && (details.version === ETransactionVersion3.F3 || details.version === ETransactionVersion3.V3),
@@ -11737,8 +11893,11 @@ var WalletAccount = class _WalletAccount extends Account {
     };
     return addInvokeTransaction(this.walletProvider, params);
   }
-  declare(payload) {
-    const declareContractPayload = extractContractHashes(payload);
+  async declare(payload) {
+    const declareContractPayload = extractContractHashes(
+      payload,
+      await this.channel.setUpSpecVersion()
+    );
     const pContract = payload.contract;
     const cairo1Contract = {
       ...pContract,
@@ -12155,7 +12314,7 @@ var Contract = class _Contract {
             transaction_hash: txR.transaction_hash,
             ...event
           };
-        }).filter((event) => cleanHex(event.from_address) === cleanHex(this.address), []) || [];
+        }).filter((event) => toHex(event.from_address) === toHex(this.address), []) || [];
         parsed = parseEvents(
           emittedEvents,
           this.events,
@@ -12450,6 +12609,7 @@ export {
   addAddressPadding,
   byteArray_exports as byteArray,
   cairo_exports as cairo,
+  compareVersions,
   config,
   constants_exports as constants,
   contractClassResponseToLegacyCompiledContract,