starknet 5.5.0 → 5.6.1

package/dist/index.js

@@ -48,6 +48,7 @@ __export(src_exports, {
   TransactionType: () => TransactionType,
   addAddressPadding: () => addAddressPadding,
   buildUrl: () => buildUrl,
+  cairo: () => cairo_exports,
   constants: () => constants_exports,
   defaultProvider: () => defaultProvider,
   ec: () => ec_exports,
@@ -2296,6 +2297,27 @@ var CONSTANT_POINTS = [
   ]
 ];
 
+// src/utils/calldata/cairo.ts
+var cairo_exports = {};
+__export(cairo_exports, {
+  Uint: () => Uint,
+  felt: () => felt,
+  getArrayType: () => getArrayType,
+  isCairo1Type: () => isCairo1Type,
+  isLen: () => isLen,
+  isTypeArray: () => isTypeArray,
+  isTypeBool: () => isTypeBool,
+  isTypeContractAddress: () => isTypeContractAddress,
+  isTypeFelt: () => isTypeFelt,
+  isTypeNamedTuple: () => isTypeNamedTuple,
+  isTypeStruct: () => isTypeStruct,
+  isTypeTuple: () => isTypeTuple,
+  isTypeUint: () => isTypeUint,
+  isTypeUint256: () => isTypeUint256,
+  tuple: () => tuple,
+  uint256: () => uint256
+});
+
 // src/utils/num.ts
 var num_exports = {};
 __export(num_exports, {
@@ -2452,8 +2474,8 @@ __export(uint256_exports, {
   isUint256: () => isUint256,
   uint256ToBN: () => uint256ToBN
 });
-function uint256ToBN(uint256) {
-  return (toBigInt(uint256.high) << 128n) + toBigInt(uint256.low);
+function uint256ToBN(uint2562) {
+  return (toBigInt(uint2562.high) << 128n) + toBigInt(uint2562.low);
 }
 var UINT_128_MAX = (1n << 128n) - 1n;
 var UINT_256_MAX = (1n << 256n) - 1n;
@@ -2471,13 +2493,42 @@ function bnToUint256(bignumber) {
 }
 
 // src/utils/calldata/cairo.ts
+var Uint = /* @__PURE__ */ ((Uint2) => {
+  Uint2["u8"] = "core::integer::u8";
+  Uint2["u16"] = "core::integer::u16";
+  Uint2["u32"] = "core::integer::u32";
+  Uint2["u64"] = "core::integer::u64";
+  Uint2["u128"] = "core::integer::u128";
+  Uint2["u256"] = "core::integer::u256";
+  return Uint2;
+})(Uint || {});
 var isLen = (name) => /_len$/.test(name);
-var isTypeFelt = (type) => type === "felt";
-var isTypeFeltArray = (type) => type === "felt*";
-var isTypeArray = (type) => /\*/.test(type);
+var isTypeFelt = (type) => type === "felt" || type === "core::felt252";
+var isTypeArray = (type) => /\*/.test(type) || type.includes("core::array::Array::");
 var isTypeTuple = (type) => /^\(.*\)$/i.test(type);
 var isTypeNamedTuple = (type) => /\(.*\)/i.test(type) && type.includes(":");
 var isTypeStruct = (type, structs) => type in structs;
+var isTypeUint = (type) => Object.values(Uint).includes(type);
+var isTypeUint256 = (type) => type === "core::integer::u256";
+var isTypeBool = (type) => type === "core::bool";
+var isTypeContractAddress = (type) => type === "core::starknet::contract_address::ContractAddress";
+var isCairo1Type = (type) => type.includes("core::");
+var getArrayType = (type) => {
+  if (isCairo1Type(type)) {
+    return type.substring(type.indexOf("<") + 1, type.indexOf(">"));
+  }
+  return type.replace("*", "");
+};
+var uint256 = (it) => {
+  const bn = BigInt(it);
+  if (!isUint256(bn))
+    throw new Error("Number is too large");
+  return {
+    low: (bn & UINT_128_MAX).toString(10),
+    high: (bn >> 128n).toString(10)
+  };
+};
+var tuple = (...args) => ({ ...args });
 function felt(it) {
   if (isBigInt(it) || typeof it === "number" && Number.isInteger(it)) {
     return it.toString();
@@ -3748,10 +3799,11 @@ var SequencerProvider = class {
     const url = buildUrl(this.baseUrl, "", endpoint);
     const method = (options == null ? void 0 : options.method) ?? "GET";
     const headers = this.getHeaders(method);
+    const body = stringify2(options == null ? void 0 : options.body);
     try {
       const response = await fetchPonyfill_default(url, {
         method,
-        body: stringify2(options == null ? void 0 : options.body),
+        body,
         headers
       });
       const textResponse = await response.text();
@@ -4268,7 +4320,7 @@ function parseSubTuple(s) {
     result
   };
 }
-function extractTupleMemberTypes(type) {
+function extractCairo0Tuple(type) {
   const cleanType = type.replace(/\s/g, "").slice(1, -1);
   const { subTuple, result } = parseSubTuple(cleanType);
   let recomposed = result.split(",").map((it) => {
@@ -4281,6 +4333,16 @@ function extractTupleMemberTypes(type) {
   }
   return recomposed;
 }
+function extractCairo1Tuple(type) {
+  const cleanType = type.replace(/\s/g, "").slice(1, -1);
+  return cleanType.split(",");
+}
+function extractTupleMemberTypes(type) {
+  if (isCairo1Type(type)) {
+    return extractCairo1Tuple(type);
+  }
+  return extractCairo0Tuple(type);
+}
 
 // src/utils/calldata/requestParser.ts
 function parseTuple(element, typeStr) {
@@ -4307,6 +4369,10 @@ function parseCalldataValue(element, type, structs) {
   if (Array.isArray(element)) {
     throw Error(`Array inside array (nD) are not supported by cairo. Element: ${element} ${type}`);
   }
+  if (isTypeUint256(type)) {
+    const el_uint256 = uint256(element);
+    return [felt(el_uint256.low), felt(el_uint256.high)];
+  }
   if (structs[type] && structs[type].members.length) {
     const { members } = structs[type];
     const subElement = element;
@@ -4339,16 +4405,21 @@ function parseCalldataField(argsIterator, input, structs) {
       }
       const result = [];
       result.push(felt(value.length));
+      const arrayType = getArrayType(input.type);
       return value.reduce((acc, el) => {
-        if (isTypeFeltArray(type)) {
+        if (isTypeFelt(arrayType) || isTypeUint(arrayType) || isTypeContractAddress(arrayType)) {
           acc.push(felt(el));
+        } else if (isTypeBool(arrayType) && typeof el === "boolean") {
+          acc.push(el.toString());
         } else {
-          acc.push(...parseCalldataValue(el, type.replace("*", ""), structs));
+          acc.push(...parseCalldataValue(el, arrayType, structs));
         }
         return acc;
       }, result);
-    case (isTypeStruct(type, structs) || isTypeTuple(type)):
+    case (isTypeStruct(type, structs) || isTypeTuple(type) || isTypeUint256(type)):
       return parseCalldataValue(value, type, structs);
+    case isTypeBool(type):
+      return `${+value}`;
     default:
       return felt(value);
   }
@@ -4381,8 +4452,24 @@ function responseParser(responseIterator, output, structs, parsedResult) {
     case isLen(name):
       temp = responseIterator.next().value;
       return BigInt(temp);
+    case isTypeBool(type):
+      temp = responseIterator.next().value;
+      return Boolean(BigInt(temp));
+    case isTypeUint256(type):
+      const low = responseIterator.next().value;
+      const high = responseIterator.next().value;
+      return uint256ToBN({ low, high });
     case isTypeArray(type):
       const parsedDataArr = [];
+      if (isCairo1Type(type)) {
+        responseIterator.next();
+        let it = responseIterator.next();
+        while (!it.done) {
+          parsedDataArr.push(BigInt(it.value));
+          it = responseIterator.next();
+        }
+        return parsedDataArr;
+      }
       if (parsedResult && parsedResult[`${name}_len`]) {
         const arrLen = parsedResult[`${name}_len`];
         while (parsedDataArr.length < arrLen) {
@@ -4404,7 +4491,66 @@ function responseParser(responseIterator, output, structs, parsedResult) {
 var validateFelt = (parameter, input) => {
   assert(
     typeof parameter === "string" || typeof parameter === "number" || typeof parameter === "bigint",
-    `Validate: arg ${input.name} should be a felt (string, number, BigNumber)`
+    `Validate: arg ${input.name} should be a felt typed as (String, Number or BigInt)`
+  );
+};
+var validateUint = (parameter, input) => {
+  if (typeof parameter === "number") {
+    assert(
+      parameter <= Number.MAX_SAFE_INTEGER,
+      `Validation: Parameter is to large to be typed as Number use (BigInt or String)`
+    );
+  }
+  assert(
+    typeof parameter === "string" || typeof parameter === "number" || typeof parameter === "bigint",
+    `Validate: arg ${input.name} of cairo type ${input.type} should be type (String, Number or BigInt)`
+  );
+  const param = toBigInt(parameter);
+  switch (input.type) {
+    case "core::integer::u8" /* u8 */:
+      assert(
+        param >= 0n && param <= 255n,
+        `Validate: arg ${input.name} cairo typed ${input.type} should be in range [0 - 255]`
+      );
+      break;
+    case "core::integer::u16" /* u16 */:
+      assert(
+        param >= 0n && param <= 65535n,
+        `Validate: arg ${input.name} cairo typed ${input.type} should be in range [0, 65535]`
+      );
+      break;
+    case "core::integer::u32" /* u32 */:
+      assert(
+        param >= 0n && param <= 4294967295n,
+        `Validate: arg ${input.name} cairo typed ${input.type} should be in range [0, 4294967295]`
+      );
+      break;
+    case "core::integer::u64" /* u64 */:
+      assert(
+        param >= 0n && param <= 2n ** 64n - 1n,
+        `Validate: arg ${input.name} cairo typed ${input.type} should be in range [0, 2^64-1]`
+      );
+      break;
+    case "core::integer::u128" /* u128 */:
+      assert(
+        param >= 0n && param <= 2n ** 128n - 1n,
+        `Validate: arg ${input.name} cairo typed ${input.type} should be in range [0, 2^128-1]`
+      );
+      break;
+    case "core::integer::u256" /* u256 */:
+      assert(
+        param >= 0n && param <= 2n ** 256n - 1n,
+        `Validate: arg ${input.name} is ${input.type} 0 - 2^256-1`
+      );
+      break;
+    default:
+      break;
+  }
+};
+var validateBool = (parameter, input) => {
+  assert(
+    typeof parameter === "boolean",
+    `Validate: arg ${input.name} of cairo type ${input.type} should be type (Boolean)`
   );
 };
 var validateStruct = (parameter, input, structs) => {
@@ -4426,7 +4572,7 @@ var validateTuple = (parameter, input) => {
   );
 };
 var validateArray = (parameter, input, structs) => {
-  const baseType = input.type.replace("*", "");
+  const baseType = getArrayType(input.type);
   if (isTypeFelt(baseType) && isLongText(parameter))
     return;
   assert(Array.isArray(parameter), `Validate: arg ${input.name} should be an Array`);
@@ -4442,6 +4588,12 @@ var validateArray = (parameter, input, structs) => {
         (it) => validateStruct(it, { name: input.name, type: baseType }, structs)
       );
       break;
+    case isTypeUint(baseType):
+      parameter.forEach((param) => validateUint(param, input));
+      break;
+    case isTypeBool(baseType):
+      parameter.forEach((param) => validateBool(param, input));
+      break;
     default:
       throw new Error(
         `Validate Unhandled: argument ${input.name}, type ${input.type}, value ${parameter}`
@@ -4457,6 +4609,14 @@ function validateFields(abiMethod, args, structs) {
       case isTypeFelt(input.type):
         validateFelt(parameter, input);
         break;
+      case isTypeUint(input.type):
+        validateUint(parameter, input);
+        break;
+      case isTypeBool(input.type):
+        validateBool(parameter, input);
+        break;
+      case isTypeContractAddress(input.type):
+        break;
       case isTypeStruct(input.type, structs):
         validateStruct(parameter, input, structs);
         break;
@@ -4545,13 +4705,15 @@ var CallData = class {
   parse(method, response) {
     const { outputs } = this.abi.find((abi) => abi.name === method);
     const responseIterator = response.flat()[Symbol.iterator]();
-    return outputs.flat().reduce((acc, output) => {
-      acc[output.name] = responseParser(responseIterator, output, this.structs, acc);
-      if (acc[output.name] && acc[`${output.name}_len`]) {
-        delete acc[`${output.name}_len`];
+    const parsed = outputs.flat().reduce((acc, output, idx) => {
+      const propName = output.name ?? idx;
+      acc[propName] = responseParser(responseIterator, output, this.structs, acc);
+      if (acc[propName] && acc[`${propName}_len`]) {
+        delete acc[`${propName}_len`];
       }
       return acc;
     }, {});
+    return Object.keys(parsed).length === 1 && 0 in parsed ? parsed[0] : parsed;
   }
   format(method, response, format) {
     const parsed = this.parse(method, response);
@@ -4623,13 +4785,20 @@ function buildEstimate(contract, functionAbi) {
     return contract.estimate(functionAbi.name, args);
   };
 }
+var detectCairoVersion = (abi) => {
+  if (!abi)
+    return "0";
+  return abi.find((it) => "state_mutability" in it) ? "1" : "0";
+};
 var Contract = class {
-  constructor(abi, address, providerOrAccount = defaultProvider) {
+  constructor(abi, address, providerOrAccount = defaultProvider, cairoVersion = detectCairoVersion(abi)) {
+    this.version = "0";
     this.address = address && address.toLowerCase();
     this.providerOrAccount = providerOrAccount;
     this.callData = new CallData(abi);
     this.structs = CallData.getAbiStruct(abi);
     this.abi = abi;
+    this.version = cairoVersion;
     const options = { enumerable: true, value: {}, writable: false };
     Object.defineProperties(this, {
       functions: { enumerable: true, value: {}, writable: false },
@@ -4687,11 +4856,10 @@ var Contract = class {
     return this;
   }
   async call(method, args = [], options = { parseRequest: true, parseResponse: true, formatResponse: void 0 }) {
-    var _a;
     assert(this.address !== null, "contract is not connected to an address");
     const blockIdentifier = (options == null ? void 0 : options.blockIdentifier) || void 0;
-    let calldata = args[0];
-    if (options.parseRequest && !((_a = args[0]) == null ? void 0 : _a.compiled)) {
+    let calldata = "compiled" in args ? args : args[0];
+    if (options.parseRequest && !(calldata == null ? void 0 : calldata.compiled)) {
       const { inputs } = this.abi.find((abi) => abi.name === method);
       this.callData.validate("CALL", method, args);
       calldata = this.callData.compile(args, inputs);
@@ -4717,7 +4885,7 @@ var Contract = class {
     parseRequest: true
   }) {
     assert(this.address !== null, "contract is not connected to an address");
-    let calldata = args == null ? void 0 : args[0];
+    let calldata = "compiled" in args ? args : args[0];
     if (options.parseRequest && !(calldata == null ? void 0 : calldata.compiled)) {
       const { inputs } = this.abi.find((abi) => abi.name === method);
       this.callData.validate("INVOKE", method, args);
@@ -5732,6 +5900,7 @@ var number = num_exports;
   TransactionType,
   addAddressPadding,
   buildUrl,
+  cairo,
   constants,
   defaultProvider,
   ec,