starknet 8.5.2 → 8.5.4

package/dist/index.mjs

@@ -1106,7 +1106,8 @@ var CairoFelt252 = class _CairoFelt252 {
   static abiSelector = "core::felt252";
   constructor(data) {
     _CairoFelt252.validate(data);
-    this.data = _CairoFelt252.__processData(data);
+    const processedData = _CairoFelt252.__processData(data);
+    this.data = processedData.subarray(processedData.findIndex((x) => x > 0));
   }
   static __processData(data) {
     if (isString(data)) {
@@ -1709,7 +1710,9 @@ var CairoBytes31 = class _CairoBytes31 {
   static abiSelector = "core::bytes_31::bytes31";
   constructor(data) {
     _CairoBytes31.validate(data);
-    this.data = _CairoBytes31.__processData(data);
+    const processedData = _CairoBytes31.__processData(data);
+    this.data = new Uint8Array(_CairoBytes31.MAX_BYTE_SIZE);
+    this.data.set(processedData, _CairoBytes31.MAX_BYTE_SIZE - processedData.length);
   }
   static __processData(data) {
     if (isString(data)) {
@@ -1730,11 +1733,16 @@ var CairoBytes31 = class _CairoBytes31 {
     return uint8ArrayToBigInt(this.data);
   }
   decodeUtf8() {
-    return new TextDecoder().decode(this.data);
+    const cutoff = this.data.findIndex((x) => x > 0);
+    const pruned = this.data.subarray(cutoff >= 0 ? cutoff : Infinity);
+    return new TextDecoder().decode(pruned);
   }
-  toHexString() {
-    const hexValue = this.data.length === 0 ? "0" : buf2hex(this.data);
-    return addHexPrefix(hexValue);
+  /**
+   * @param padded flag for including leading zeros
+   */
+  toHexString(padded) {
+    const hex = padded === "padded" ? buf2hex(this.data) : this.toBigInt().toString(16);
+    return addHexPrefix(hex);
   }
   static validate(data) {
     const byteLength = _CairoBytes31.__processData(data).length;
@@ -1792,10 +1800,13 @@ var errorCodes = {
   UNSUPPORTED_TX_VERSION: 61,
   UNSUPPORTED_CONTRACT_CLASS_VERSION: 62,
   UNEXPECTED_ERROR: 63,
+  REPLACEMENT_TRANSACTION_UNDERPRICED: 64,
+  FEE_BELOW_MINIMUM: 65,
   INVALID_SUBSCRIPTION_ID: 66,
   TOO_MANY_ADDRESSES_IN_FILTER: 67,
   TOO_MANY_BLOCKS_BACK: 68,
   COMPILATION_ERROR: 100,
+  //
   INVALID_ADDRESS: 150,
   TOKEN_NOT_SUPPORTED: 151,
   INVALID_SIGNATURE: 153,
@@ -2030,11 +2041,11 @@ var CairoByteArray = class _CairoByteArray {
     ]);
   }
   decodeUtf8() {
-    const allBytes = this.reconstructBytes();
+    const allBytes = concatenateArrayBuffer(this.toElements());
     return new TextDecoder().decode(allBytes);
   }
   toBigInt() {
-    const allBytes = this.reconstructBytes();
+    const allBytes = concatenateArrayBuffer(this.toElements());
     if (allBytes.length === 0) {
       return 0n;
     }
@@ -2045,15 +2056,39 @@ var CairoByteArray = class _CairoByteArray {
     return result;
   }
   toHexString() {
-    const allBytes = this.reconstructBytes();
+    const allBytes = concatenateArrayBuffer(this.toElements());
     const hexValue = allBytes.length === 0 ? "0" : buf2hex(allBytes);
     return addHexPrefix(hexValue);
   }
   toBuffer() {
-    this.assertInitialized();
-    const allBytes = this.reconstructBytes();
+    const allBytes = concatenateArrayBuffer(this.toElements());
     return buffer_default.from(allBytes);
   }
+  /**
+   * returns an array of all the data chunks and the pending word
+   * when concatenated, represents the original bytes sequence
+   */
+  toElements() {
+    this.assertInitialized();
+    const allChunks = this.data.flatMap((chunk) => chunk.data);
+    const pendingLen = Number(this.pending_word_len.toBigInt());
+    if (pendingLen) {
+      const pending = new Uint8Array(pendingLen);
+      const paddingDifference = pendingLen - this.pending_word.data.length;
+      pending.set(this.pending_word.data, paddingDifference);
+      allChunks.push(pending);
+    }
+    return allChunks;
+  }
+  /**
+   * Private helper to check if the CairoByteArray is properly initialized
+   */
+  assertInitialized() {
+    assert(
+      this.data && this.pending_word !== void 0 && this.pending_word_len !== void 0,
+      "CairoByteArray is not properly initialized"
+    );
+  }
   static validate(data) {
     assert(data !== null && data !== void 0, "Invalid input: null or undefined");
     assert(
@@ -2101,30 +2136,6 @@ var CairoByteArray = class _CairoByteArray {
   static isAbiType(abiType) {
     return abiType === _CairoByteArray.abiSelector;
   }
-  /**
-   * Private helper to check if the CairoByteArray is properly initialized
-   */
-  assertInitialized() {
-    assert(
-      this.data && this.pending_word !== void 0 && this.pending_word_len !== void 0,
-      "CairoByteArray is not properly initialized"
-    );
-  }
-  /**
-   * Private helper to reconstruct the full byte sequence from chunks and pending word
-   */
-  reconstructBytes() {
-    this.assertInitialized();
-    const allChunks = this.data.flatMap((chunk) => chunk.data);
-    const pendingLen = Number(this.pending_word_len.toBigInt());
-    if (pendingLen) {
-      const pending = new Uint8Array(pendingLen);
-      const paddingDifference = pendingLen - this.pending_word.data.length;
-      pending.set(this.pending_word.data, paddingDifference);
-      allChunks.push(pending);
-    }
-    return concatenateArrayBuffer(allChunks);
-  }
   static factoryFromApiResponse(responseIterator) {
     const data = Array.from(
       { length: Number(getNext(responseIterator)) },
@@ -5699,7 +5710,7 @@ var RpcChannel = class {
   }
   /**
    * fetch rpc node specVersion
-   * @example this.specVersion = "0.7.1"
+   * @example this.specVersion = "0.8.1"
    */
   getSpecVersion() {
     return this.fetchEndpoint("starknet_specVersion");
@@ -5850,21 +5861,22 @@ var RpcChannel = class {
   }
   async waitForTransaction(txHash, options) {
     const transactionHash = toHex(txHash);
-    let { retries } = this;
+    let retries = options?.retries ?? this.retries;
+    let lifeCycleRetries = options?.lifeCycleRetries ?? 3;
     let onchain = false;
     let isErrorState = false;
     const retryInterval = options?.retryInterval ?? this.transactionRetryIntervalDefault;
-    const errorStates = options?.errorStates ?? [
-      RPCSPEC08.ETransactionStatus.REJECTED
-      // TODO: commented out to preserve the long-standing behavior of "reverted" not being treated as an error by default
-      // should decide which behavior to keep in the future
-      // RPC.ETransactionExecutionStatus.REVERTED,
-    ];
+    const errorStates = options?.errorStates ?? [RPCSPEC08.ETransactionStatus.REJECTED];
     const successStates = options?.successStates ?? [
       // RPC.ETransactionExecutionStatus.SUCCEEDED, Starknet 0.14.0 this one can have incomplete events
       RPCSPEC08.ETransactionStatus.ACCEPTED_ON_L2,
       RPCSPEC08.ETransactionStatus.ACCEPTED_ON_L1
     ];
+    const LifeCycleErrorMessages = {
+      [RPCSPEC09.ETransactionStatus.RECEIVED]: SYSTEM_MESSAGES.txEvictedFromMempool,
+      [RPCSPEC09.ETransactionStatus.PRE_CONFIRMED]: SYSTEM_MESSAGES.consensusFailed,
+      [RPCSPEC09.ETransactionStatus.CANDIDATE]: SYSTEM_MESSAGES.txFailsBlockBuildingValidation
+    };
     const txLife = [];
     let txStatus;
     while (!onchain) {
@@ -5893,15 +5905,11 @@ var RpcChannel = class {
         }
         if (error instanceof RpcError && error.isType("TXN_HASH_NOT_FOUND")) {
           logger.info("txLife: ", txLife);
-          const errorMessages = {
-            [RPCSPEC09.ETransactionStatus.RECEIVED]: SYSTEM_MESSAGES.txEvictedFromMempool,
-            [RPCSPEC09.ETransactionStatus.PRE_CONFIRMED]: SYSTEM_MESSAGES.consensusFailed,
-            [RPCSPEC09.ETransactionStatus.CANDIDATE]: SYSTEM_MESSAGES.txFailsBlockBuildingValidation
-          };
-          const errorMessage = errorMessages[txLife.at(-1)];
-          if (errorMessage) {
+          const errorMessage = LifeCycleErrorMessages[txLife.at(-1)];
+          if (errorMessage && lifeCycleRetries <= 0) {
             throw new Error(errorMessage);
           }
+          lifeCycleRetries -= 1;
         }
         if (retries <= 0) {
           throw new Error(`waitForTransaction timed-out with retries ${this.retries}`);
@@ -6291,14 +6299,14 @@ var RpcChannel2 = class {
   }
   /**
    * fetch rpc node specVersion
-   * @example this.specVersion = "0.7.1"
+   * @example this.specVersion = "0.9.0"
    */
   getSpecVersion() {
     return this.fetchEndpoint("starknet_specVersion");
   }
   /**
    * fetch if undefined else just return this.specVersion
-   * @example this.specVersion = "0.8.1"
+   * @example this.specVersion = "0.9.0"
    */
   async setUpSpecVersion() {
     if (!this.specVersion) {
@@ -6442,7 +6450,8 @@ var RpcChannel2 = class {
   }
   async waitForTransaction(txHash, options) {
     const transactionHash = toHex(txHash);
-    let { retries } = this;
+    let retries = options?.retries ?? this.retries;
+    let lifeCycleRetries = options?.lifeCycleRetries ?? 3;
     let onchain = false;
     let isErrorState = false;
     const retryInterval = options?.retryInterval ?? this.transactionRetryIntervalDefault;
@@ -6452,6 +6461,11 @@ var RpcChannel2 = class {
       RPCSPEC09.ETransactionFinalityStatus.ACCEPTED_ON_L2,
       RPCSPEC09.ETransactionFinalityStatus.ACCEPTED_ON_L1
     ];
+    const errorMessages = {
+      [RPCSPEC09.ETransactionStatus.RECEIVED]: SYSTEM_MESSAGES.txEvictedFromMempool,
+      [RPCSPEC09.ETransactionStatus.PRE_CONFIRMED]: SYSTEM_MESSAGES.consensusFailed,
+      [RPCSPEC09.ETransactionStatus.CANDIDATE]: SYSTEM_MESSAGES.txFailsBlockBuildingValidation
+    };
     const txLife = [];
     let txStatus;
     while (!onchain) {
@@ -6480,15 +6494,11 @@ var RpcChannel2 = class {
         }
         if (error instanceof RpcError && error.isType("TXN_HASH_NOT_FOUND")) {
           logger.info("txLife: ", txLife);
-          const errorMessages = {
-            [RPCSPEC09.ETransactionStatus.RECEIVED]: SYSTEM_MESSAGES.txEvictedFromMempool,
-            [RPCSPEC09.ETransactionStatus.PRE_CONFIRMED]: SYSTEM_MESSAGES.consensusFailed,
-            [RPCSPEC09.ETransactionStatus.CANDIDATE]: SYSTEM_MESSAGES.txFailsBlockBuildingValidation
-          };
           const errorMessage = errorMessages[txLife.at(-1)];
-          if (errorMessage) {
+          if (errorMessage && lifeCycleRetries <= 0) {
             throw new Error(errorMessage);
           }
+          lifeCycleRetries -= 1;
         }
         if (retries <= 0) {
           throw new Error(`waitForTransaction timed-out with retries ${this.retries}`);
@@ -7675,12 +7685,15 @@ function createTransactionReceipt(receipt) {
       match(callbacks) {
         return statusReceipt in callbacks ? callbacks[statusReceipt](value) : callbacks._();
       },
+      // @ts-ignore - docs
       isSuccess() {
         return statusReceipt === "SUCCEEDED";
       },
+      // @ts-ignore - docs
       isReverted() {
         return statusReceipt === "REVERTED";
       },
+      // @ts-ignore - docs
       isError() {
         return false;
       }
@@ -7693,12 +7706,15 @@ function createTransactionReceipt(receipt) {
       match(callbacks) {
         return "ERROR" in callbacks ? callbacks.ERROR(errorValue) : callbacks._();
       },
+      // @ts-ignore - docs
       isSuccess() {
         return false;
       },
+      // @ts-ignore - docs
       isReverted() {
         return false;
       },
+      // @ts-ignore - docs
       isError() {
         return true;
       }