starknet 6.18.1 → 6.19.0

package/dist/index.global.js

@@ -12602,7 +12602,9 @@ var starknet = (() => {
     ETH_ADDRESS: () => ETH_ADDRESS,
     EntryPointType: () => EntryPointType,
     EthSigner: () => EthSigner,
-    LedgerSigner: () => LedgerSigner,
+    LedgerSigner: () => LedgerSigner111,
+    LedgerSigner111: () => LedgerSigner111,
+    LedgerSigner221: () => LedgerSigner221,
     LibraryError: () => LibraryError,
     Literal: () => Literal,
     NON_ZERO_PREFIX: () => NON_ZERO_PREFIX,
@@ -12655,7 +12657,9 @@ var starknet = (() => {
     fixStack: () => fixStack,
     getCalldata: () => getCalldata,
     getChecksumAddress: () => getChecksumAddress,
-    getLedgerPathBuffer: () => getLedgerPathBuffer,
+    getLedgerPathBuffer: () => getLedgerPathBuffer111,
+    getLedgerPathBuffer111: () => getLedgerPathBuffer111,
+    getLedgerPathBuffer221: () => getLedgerPathBuffer221,
     hash: () => hash_exports,
     isSierra: () => isSierra,
     json: () => json_exports,
@@ -12689,6 +12693,8 @@ var starknet = (() => {
     API_VERSION: () => API_VERSION,
     BaseUrl: () => BaseUrl,
     FeeMarginPercentage: () => FeeMarginPercentage,
+    HARDENING_4BYTES: () => HARDENING_4BYTES,
+    HARDENING_BYTE: () => HARDENING_BYTE,
     IS_BROWSER: () => IS_BROWSER,
     MASK_250: () => MASK_250,
     MASK_31: () => MASK_31,
@@ -13250,6 +13256,8 @@ var starknet = (() => {
   var OutsideExecutionCallerAny = "0x414e595f43414c4c4552";
   var SNIP9_V1_INTERFACE_ID = "0x68cfd18b92d1907b8ba3cc324900277f5a3622099431ea85dd8089255e4181";
   var SNIP9_V2_INTERFACE_ID = "0x1d1144bb2138366ff28d8e9ab57456b1d332ac42196230c3a602003c89872";
+  var HARDENING_BYTE = 128;
+  var HARDENING_4BYTES = 2147483648n;
 
   // src/channel/rpc_0_6.ts
   var rpc_0_6_exports = {};
@@ -18908,6 +18916,8 @@ var starknet = (() => {
     calculateDeployAccountTransactionHash: () => calculateDeployAccountTransactionHash2,
     calculateInvokeTransactionHash: () => calculateInvokeTransactionHash,
     calculateTransactionHashCommon: () => calculateTransactionHashCommon2,
+    encodeResourceBoundsL1: () => encodeResourceBoundsL1,
+    encodeResourceBoundsL2: () => encodeResourceBoundsL2,
     hashDAMode: () => hashDAMode,
     hashFeeField: () => hashFeeField
   });
@@ -18921,9 +18931,15 @@ var starknet = (() => {
   function hashDAMode(nonceDAMode, feeDAMode) {
     return (BigInt(nonceDAMode) << DATA_AVAILABILITY_MODE_BITS) + BigInt(feeDAMode);
   }
+  function encodeResourceBoundsL1(bounds) {
+    return (L1_GAS_NAME << RESOURCE_VALUE_OFFSET) + (BigInt(bounds.l1_gas.max_amount) << MAX_PRICE_PER_UNIT_BITS) + BigInt(bounds.l1_gas.max_price_per_unit);
+  }
+  function encodeResourceBoundsL2(bounds) {
+    return (L2_GAS_NAME << RESOURCE_VALUE_OFFSET) + (BigInt(bounds.l2_gas.max_amount) << MAX_PRICE_PER_UNIT_BITS) + BigInt(bounds.l2_gas.max_price_per_unit);
+  }
   function hashFeeField(tip, bounds) {
-    const L1Bound = (L1_GAS_NAME << RESOURCE_VALUE_OFFSET) + (BigInt(bounds.l1_gas.max_amount) << MAX_PRICE_PER_UNIT_BITS) + BigInt(bounds.l1_gas.max_price_per_unit);
-    const L2Bound = (L2_GAS_NAME << RESOURCE_VALUE_OFFSET) + (BigInt(bounds.l2_gas.max_amount) << MAX_PRICE_PER_UNIT_BITS) + BigInt(bounds.l2_gas.max_price_per_unit);
+    const L1Bound = encodeResourceBoundsL1(bounds);
+    const L2Bound = encodeResourceBoundsL2(bounds);
     return poseidonHashMany([BigInt(tip), L1Bound, L2Bound]);
   }
   function calculateTransactionHashCommon2(txHashPrefix, version, senderAddress, chainId, nonce, tip, paymasterData, nonceDataAvailabilityMode, feeDataAvailabilityMode, resourceBounds, additionalData = []) {
@@ -27068,8 +27084,8 @@ var starknet = (() => {
     }
   };
 
-  // src/signer/ledgerSigner.ts
-  var LedgerSigner = class {
+  // src/signer/ledgerSigner111.ts
+  var LedgerSigner111 = class {
     transporter;
     // this is a hack to allow the '@ledgerhq/hw-transport' type to be used as a dev dependency but not exposed in the production build
     _transporter;
@@ -27084,16 +27100,19 @@ var starknet = (() => {
      * @param {Transport} transport 5 transports are available to handle USB, bluetooth, Node, Web, Mobile.
      * See Guides for more details.
      * @param {number} accountID ID of Ledger Nano (can handle 2**31 accounts).
-     * @param {string} [eip2645application='LedgerW'] A wallet is defined by an ERC2645 derivation path (6 items).
-     * One item is the `application`. Default value is `LedgerW`.
+     * @param {string} [eip2645application='LedgerW'] A wallet is defined by an ERC2645 derivation path (6 items),
+     * and one item is the `application` and can be customized.
+     * Default value is `LedgerW`.
+     * @param {LedgerPathCalculation} [pathFunction=getLedgerPathBuffer111]
+     * defines the function that will calculate the path. By default `getLedgerPathBuffer111` is selected.
      * @example
      * ```typescript
      * import TransportNodeHid from "@ledgerhq/hw-transport-node-hid";
      * const myNodeTransport = await TransportNodeHid.create();
-     * const myLedgerSigner = new LedgerSigner(myNodeTransport, 0);
+     * const myLedgerSigner = new LedgerSigner111(myNodeTransport, 0);
      * ```
      */
-    constructor(transport, accountID, eip2645application = "LedgerW") {
+    constructor(transport, accountID, eip2645application = "LedgerW", pathFunction = getLedgerPathBuffer111) {
       assert(accountID >= 0, "Ledger account ID shall not be a negative number.");
       assert(accountID <= MASK_31, "Ledger account ID shall be < 2**31.");
       assert(!!eip2645application, "Ledger application name shall not be empty.");
@@ -27104,11 +27123,16 @@ var starknet = (() => {
       this.fullPubKey = "";
       this.eip2645applicationName = eip2645application;
       this.appVersion = "";
-      this.pathBuffer = getLedgerPathBuffer(this.accountID, this.eip2645applicationName);
+      this.pathBuffer = pathFunction(this.accountID, this.eip2645applicationName);
     }
     /**
      * provides the Starknet public key
      * @returns an hex string : 64 characters are Point X coordinate.
+     * @example
+     * ```typescript
+     * const result = await myLedgerSigner.getPubKey();
+     * // result= "0x03681417ba3e1f050dd3ccdceb8d22b5e44fa70ee7844d472c6a768bded5174e"
+     * ```
      */
     async getPubKey() {
       if (!this.pubKey) await this.getPublicKeys();
@@ -27117,6 +27141,11 @@ var starknet = (() => {
     /**
      * provides the full public key (with parity prefix)
      * @returns an hex string : 2 first characters are the parity, the 64 following characters are Point X coordinate. 64 last characters are Point Y coordinate.
+     * @example
+     * ```typescript
+     * const result = await myLedgerSigner.getFullPubKey();
+     * // result= "0x0403681417ba3e1f050dd3ccdceb8d22b5e44fa70ee7844d472c6a768bded5174e03cbc86f805dcfcb0c1922dd4daf181afa289d86223a18bc856276615bcc7787"
+     * ```
      */
     async getFullPubKey() {
       if (!this.fullPubKey) await this.getPublicKeys();
@@ -27138,10 +27167,58 @@ var starknet = (() => {
       }
       return this.appVersion;
     }
+    /**
+     * Sign a TypedData message (SNIP-12) in a Ledger.
+     * @param {typedDataToHash} typedDataToHash A TypedData message compatible with SNIP-12.
+     * @param {string} accountAddress Signer account address (Hex or num string)
+     * @returns {Signature} The signed message.
+     * @example
+     * ```typescript
+     * const result = myLedgerSigner.signMessage(snip12Message, account0.address);
+     * // result = Signature { r: 611475243393396148729326917410546146405234155928298353899191529090923298688n,
+     * // s: 798839819213540985856952481651392652149797817551686626114697493101433761982n,
+     * // recovery: 0}
+     * ```
+     */
     async signMessage(typedDataToHash, accountAddress) {
       const msgHash = getMessageHash(typedDataToHash, accountAddress);
       return this.signRaw(msgHash);
     }
+    /**
+     * Sign in a Ledger a V1 or a V3 transaction. This is a blind sign on the Ledger screen.
+     * @param {Call1[]} transactions An array of `Call` transactions (generated for example by `myContract.populate()`).
+     * @param {InvocationsSignerDetails} transactionsDetail An object that includes all the necessary inputs to hash the transaction. Can be `V2InvocationsSignerDetails` or `V3InvocationsSignerDetails` type.
+     * @returns {Signature} The signed transaction.
+     * @example
+     * ```typescript
+     * const txDetailsV3: V3InvocationsSignerDetails = {
+     * chainId: constants.StarknetChainId.SN_MAIN,
+     * nonce: "28",
+     * accountDeploymentData: [],
+     * paymasterData: [],
+     * cairoVersion: "1",
+     * feeDataAvailabilityMode: "L1",
+     * nonceDataAvailabilityMode: "L1",
+     * resourceBounds: {
+     *   l1_gas: {
+     *     max_amount: "0x2a00",
+     *     max_price_per_unit: "0x5c00000"
+     *   },
+     *   l2_gas: {
+     *     max_amount: "0x00",
+     *     max_price_per_unit: "0x00"
+     *   },
+     * },
+     * tip: 0,
+     * version: "0x3",
+     * walletAddress: account0.address
+     * }
+     * const result = myLedgerSigner.signTransaction([call0, call1], txDetailsV3);
+     * // result = Signature { r: 611475243393396148729326917410546146405234155928298353899191529090923298688n,
+     * // s: 798839819213540985856952481651392652149797817551686626114697493101433761982n,
+     * // recovery: 0}
+     * ```
+     */
     async signTransaction(transactions, transactionsDetail) {
       const compiledCalldata = getExecuteCalldata(transactions, transactionsDetail.cairoVersion);
       let msgHash;
@@ -27168,6 +27245,18 @@ var starknet = (() => {
       }
       return this.signRaw(msgHash);
     }
+    /**
+     * Sign in a Ledger the deployment of a new account. This is a blind sign on the Ledger screen.
+     * @param {DeployAccountSignerDetails} details An object that includes all necessary data to calculate the Hash. It can be `V2DeployAccountSignerDetails` or `V3DeployAccountSignerDetails` types.
+     * @returns {Signature} The deploy account signature.
+     * @example
+     * ```typescript
+     * const result = myLedgerSigner.signDeployAccountTransaction(details);
+     * // result = Signature { r: 611475243393396148729326917410546146405234155928298353899191529090923298688n,
+     * // s: 798839819213540985856952481651392652149797817551686626114697493101433761982n,
+     * // recovery: 0}
+     * ```
+     */
     async signDeployAccountTransaction(details) {
       const compiledConstructorCalldata = CallData.compile(details.constructorCalldata);
       let msgHash;
@@ -27194,6 +27283,18 @@ var starknet = (() => {
       }
       return this.signRaw(msgHash);
     }
+    /**
+     * Sign in a Ledger the declaration of a new class. This is a blind sign on the Ledger screen.
+     * @param {DeclareSignerDetails} details An object that includes all necessary data to calculate the Hash. It can be `V3DeclareSignerDetails` or `V2DeclareSignerDetails` types.
+     * @returns {Signature} The declare Signature.
+     * @example
+     * ```typescript
+     * const result = myLedgerSigner.signDeclareTransaction(details);
+     * // result = Signature { r: 611475243393396148729326917410546146405234155928298353899191529090923298688n,
+     * // s: 798839819213540985856952481651392652149797817551686626114697493101433761982n,
+     * // recovery: 0}
+     * ```
+     */
     async signDeclareTransaction(details) {
       let msgHash;
       if (Object.values(ETransactionVersion2).includes(details.version)) {
@@ -27215,6 +27316,10 @@ var starknet = (() => {
       }
       return this.signRaw(msgHash);
     }
+    /**
+     * Internal function to sign a hash in a Ledger Nano.
+     * This is a blind sign in the Ledger ; no display of what you are signing.
+     */
     async signRaw(msgHash) {
       addHexPrefix(
         buf2hex(await this._transporter.send(Number("0x5a"), 2, 0, 0, Buffer.from(this.pathBuffer)))
@@ -27231,6 +27336,7 @@ var starknet = (() => {
       const sign1 = sign0.addRecoveryBit(v);
       return sign1;
     }
+    /** internal function to get both the Starknet public key and the full public key */
     async getPublicKeys() {
       const pathBuff = this.pathBuffer;
       const respGetPublic = Uint8Array.from(
@@ -27240,7 +27346,7 @@ var starknet = (() => {
       this.fullPubKey = addHexPrefix(buf2hex(respGetPublic.subarray(0, 65)));
     }
   };
-  function getLedgerPathBuffer(accountId, applicationName) {
+  function getLedgerPathBuffer111(accountId, applicationName = "LedgerW") {
     const path0buff = new Uint8Array([128, 0, 10, 85]);
     const path1buff = new Uint8Array([71, 65, 233, 201]);
     const path2buff = applicationName === "LedgerW" ? new Uint8Array([43, 206, 231, 219]) : stringToSha256ToArrayBuff4(applicationName);
@@ -27260,6 +27366,548 @@ var starknet = (() => {
     return pathBuff;
   }
 
+  // src/utils/address.ts
+  function addAddressPadding(address) {
+    const hex = toHex(addHexPrefix(address.toString()));
+    const padded = removeHexPrefix(hex).padStart(64, "0");
+    return addHexPrefix(padded);
+  }
+  function validateAndParseAddress(address) {
+    const result = addAddressPadding(address);
+    if (!result.match(/^(0x)?[0-9a-fA-F]{64}$/)) {
+      throw new Error("Invalid Address Format");
+    }
+    assertInRange(result, ZERO, ADDR_BOUND - 1n, "Starknet Address");
+    return result;
+  }
+  function getChecksumAddress(address) {
+    const chars = removeHexPrefix(validateAndParseAddress(address)).toLowerCase().split("");
+    const hex = removeHexPrefix(keccakBn(address));
+    const hashed = hexToBytes(hex.padStart(64, "0"));
+    for (let i = 0; i < chars.length; i += 2) {
+      if (hashed[i >> 1] >> 4 >= 8) {
+        chars[i] = chars[i].toUpperCase();
+      }
+      if ((hashed[i >> 1] & 15) >= 8) {
+        chars[i + 1] = chars[i + 1].toUpperCase();
+      }
+    }
+    return addHexPrefix(chars.join(""));
+  }
+  function validateChecksumAddress(address) {
+    return getChecksumAddress(address) === address;
+  }
+
+  // src/signer/ledgerSigner221.ts
+  var LedgerSigner221 = class extends LedgerSigner111 {
+    /**
+     * constructor of the LedgerSigner class.
+     * @param {Transport} transport 5 transports are available to handle USB, bluetooth, Node, Web, Mobile.
+     * See Guides for more details.
+     * @param {number} accountID ID of Ledger Nano (can handle 2**31 accounts).
+     * @param {string} [eip2645application='LedgerW'] A wallet is defined by an ERC2645 derivation path (6 items).
+     * One item is called `application` and can be customized.
+     * Default value is `LedgerW`.
+     * @param {LedgerPathCalculation} [pathFunction=getLedgerPathBuffer221]
+     * defines the function that will calculate the path. By default `getLedgerPathBuffer221` is selected.
+     *
+     * If you are using APP v2.2.1 with an account created with the v1.1.1, you need to use :
+     * ```typescript
+     * const myLedgerSigner = new LedgerSigner211(myNodeTransport, 0, undefined, getLedgerPathBuffer111);
+     * ```
+     * @example
+     * ```typescript
+     * import TransportNodeHid from "@ledgerhq/hw-transport-node-hid";
+     * const myNodeTransport = await TransportNodeHid.create();
+     * const myLedgerSigner = new LedgerSigner211(myNodeTransport, 0);
+     * ```
+     */
+    constructor(transport, accountID, eip2645application = "LedgerW", pathFunction = getLedgerPathBuffer221) {
+      super(transport, accountID, eip2645application, pathFunction);
+    }
+    /**
+     * Sign in a Ledger a V1 or a V3 transaction. The details are displayed on the Ledger screen.
+     * @param {Call[]} transactions An array of `Call` transactions (generated for example by `myContract.populate()`).
+     * @param {InvocationsSignerDetails} transactionsDetail An object that includes all the necessary inputs to hash the transaction. Can be `V2InvocationsSignerDetails` or `V3InvocationsSignerDetails` type.
+     * @returns {Signature} The signed transaction.
+     * @example
+     * ```typescript
+     * const txDetailsV3: V3InvocationsSignerDetails = {
+     * chainId: constants.StarknetChainId.SN_MAIN,
+     * nonce: "28",
+     * accountDeploymentData: [],
+     * paymasterData: [],
+     * cairoVersion: "1",
+     * feeDataAvailabilityMode: "L1",
+     * nonceDataAvailabilityMode: "L1",
+     * resourceBounds: {
+     *   l1_gas: {
+     *     max_amount: "0x2a00",
+     *     max_price_per_unit: "0x5c00000"
+     *   },
+     *   l2_gas: {
+     *     max_amount: "0x00",
+     *     max_price_per_unit: "0x00"
+     *   },
+     * },
+     * tip: 0,
+     * version: "0x3",
+     * walletAddress: account0.address
+     * }
+     * const result = myLedgerSigner.signTransaction([call0, call1], txDetailsV3);
+     * // result = Signature { r: 611475243393396148729326917410546146405234155928298353899191529090923298688n,
+     * // s: 798839819213540985856952481651392652149797817551686626114697493101433761982n,
+     * // recovery: 0}
+     * ```
+     */
+    async signTransaction(transactions, transactionsDetail) {
+      const compiledCalldata = getExecuteCalldata(transactions, transactionsDetail.cairoVersion);
+      if (Object.values(ETransactionVersion2).includes(transactionsDetail.version)) {
+        const det = transactionsDetail;
+        const msgHash = calculateInvokeTransactionHash2({
+          ...det,
+          senderAddress: det.walletAddress,
+          compiledCalldata,
+          version: det.version
+        });
+        const ledgerResponse = await this.signTxV1(det, transactions);
+        assert(
+          toBigInt(msgHash) === ledgerResponse.hash,
+          "The transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
+        );
+        return ledgerResponse.signature;
+      }
+      if (Object.values(ETransactionVersion32).includes(transactionsDetail.version)) {
+        const det = transactionsDetail;
+        const msgHash = calculateInvokeTransactionHash2({
+          ...det,
+          senderAddress: det.walletAddress,
+          compiledCalldata,
+          version: det.version,
+          nonceDataAvailabilityMode: intDAM(det.nonceDataAvailabilityMode),
+          feeDataAvailabilityMode: intDAM(det.feeDataAvailabilityMode)
+        });
+        const ledgerResponse = await this.signTxV3(det, transactions);
+        assert(
+          toBigInt(msgHash) === ledgerResponse.hash,
+          "The transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
+        );
+        return ledgerResponse.signature;
+      }
+      throw Error("unsupported signTransaction version");
+    }
+    /**
+     * Sign in a Ledger the deployment of a new account. The details are displayed on the Ledger screen.
+     * @param {DeployAccountSignerDetails} details An object that includes all necessary data to calculate the Hash. It can be `V2DeployAccountSignerDetails` or `V3DeployAccountSignerDetails` types.
+     * @returns {Signature} The deploy account signature.
+     * @example
+     * ```typescript
+     * const result = myLedgerSigner.signDeployAccountTransaction(details);
+     * // result = Signature { r: 611475243393396148729326917410546146405234155928298353899191529090923298688n,
+     * // s: 798839819213540985856952481651392652149797817551686626114697493101433761982n,
+     * // recovery: 0}
+     * ```
+     */
+    async signDeployAccountTransaction(details) {
+      const compiledConstructorCalldata = CallData.compile(details.constructorCalldata);
+      let msgHash;
+      if (Object.values(ETransactionVersion2).includes(details.version)) {
+        const det = details;
+        msgHash = calculateDeployAccountTransactionHash3({
+          ...det,
+          salt: det.addressSalt,
+          constructorCalldata: compiledConstructorCalldata,
+          version: det.version
+        });
+        const ledgerResponse = await this.signDeployAccountV1(det);
+        assert(
+          toBigInt(msgHash) === ledgerResponse.hash,
+          "The transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
+        );
+        return ledgerResponse.signature;
+      }
+      if (Object.values(ETransactionVersion32).includes(details.version)) {
+        const det = details;
+        msgHash = calculateDeployAccountTransactionHash3({
+          ...det,
+          salt: det.addressSalt,
+          compiledConstructorCalldata,
+          version: det.version,
+          nonceDataAvailabilityMode: intDAM(det.nonceDataAvailabilityMode),
+          feeDataAvailabilityMode: intDAM(det.feeDataAvailabilityMode)
+        });
+        const ledgerResponse = await this.signDeployAccountV3(det);
+        assert(
+          toBigInt(msgHash) === ledgerResponse.hash,
+          "The transaction hash calculated by Starknet.js is different from the one calculated by the Ledger."
+        );
+        return ledgerResponse.signature;
+      }
+      throw Error("unsupported signDeployAccountTransaction version");
+    }
+    /**
+     * Internal function to convert a bigNumberish to an Uint8array of 256 bits
+     * @param {BigNumberish} input input value
+     * @returns {Uint8Array} a Uint8Array containing 32 bytes.
+     */
+    convertBnToLedger(input) {
+      return hexToBytes2(addAddressPadding(toHex(input)));
+    }
+    /**
+     * Internal function to decode the response of the Ledger signature
+     * @param {Uint8Array} respSign the Buffer response of the Ledger
+     * @returns { hash: bigint; signature: Signature } transaction hash & signature
+     */
+    decodeSignatureLedger(respSign) {
+      const h = BigInt(addHexPrefix(buf2hex(respSign.subarray(0, 32))));
+      const r = BigInt(addHexPrefix(buf2hex(respSign.subarray(33, 65))));
+      const s = BigInt(addHexPrefix(buf2hex(respSign.subarray(65, 97))));
+      const v = respSign[97];
+      const sign0 = new esm_exports3.Signature(r, s);
+      const sign1 = sign0.addRecoveryBit(v);
+      return { hash: h, signature: sign1 };
+    }
+    /** Internal function to convert a Call to an array of Uint8Array.
+     * @param {Call} call A Call to convert.
+     * @return {Uint8Array[]} Call encoded in an array of Uint8Array (each containing 7 u256).
+     */
+    encodeCall(call) {
+      const toBuf = this.convertBnToLedger(call.contractAddress);
+      const selectorBuf = hexToBytes2(addAddressPadding(getSelector(call.entrypoint)));
+      let calldataBuf = new Uint8Array([]);
+      if (call.calldata) {
+        const compiledCalldata = CallData.compile(call.calldata);
+        calldataBuf = concatenateArrayBuffer(
+          compiledCalldata.map((parameter) => {
+            const a = this.convertBnToLedger(parameter);
+            return a;
+          })
+        );
+      }
+      const callBuf = concatenateArrayBuffer([toBuf, selectorBuf, calldataBuf]);
+      const calldatas = [];
+      const chunkSize = 7 * 32;
+      for (let i = 0; i < callBuf.length; i += chunkSize)
+        calldatas.push(callBuf.subarray(i, i + chunkSize));
+      return calldatas;
+    }
+    /**
+     * Ask the Ledger Nano to display and sign a Starknet V1 transaction.
+     * @param {V2InvocationsSignerDetails} txDetails All the details needed for a txV1.
+     * @param {Call[]} calls array of Starknet invocations
+     * @returns an object including the transaction Hash and the signature
+     * @example
+     * ```typescript
+     * const calls: Call[] = [{contractAddress: "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+     *      entrypoint: "transfer",
+     *      calldata:["0x11f5fc2a92ac03434a7937fe982f5e5293b65ad438a989c5b78fb8f04a12016",
+     *        "0x9184e72a000", "0x0"]}];
+     * const txDet: V2InvocationsSignerDetails = {
+     *    walletAddress: txDetails.accountAddress,
+     *    chainId: constants.StarknetChainId.SN_MAIN,
+     *    cairoVersion: "1", maxFee: txDetails.max_fee,
+     *    nonce: txDetails.nonce, version: "0x1"
+     *  };
+     * const res = await myLedgerSigner.signTxV1(txDet, calls);
+     * // res = {hash:
+     * //   signature:
+     * // }
+     * ```
+     */
+    async signTxV1(txDetails, calls) {
+      await this._transporter.send(Number("0x5a"), 4, 0, 0, Buffer.from(this.pathBuffer));
+      const accountAddressBuf = this.convertBnToLedger(txDetails.walletAddress);
+      const maxFeeBuf = this.convertBnToLedger(txDetails.maxFee);
+      const chainIdBuf = this.convertBnToLedger(txDetails.chainId);
+      const nonceBuf = this.convertBnToLedger(txDetails.nonce);
+      const dataBuf = concatenateArrayBuffer([
+        accountAddressBuf,
+        maxFeeBuf,
+        chainIdBuf,
+        nonceBuf
+      ]);
+      await this._transporter.send(Number("0x5a"), 4, 1, 0, Buffer.from(dataBuf));
+      const nbCallsBuf = this.convertBnToLedger(calls.length);
+      await this._transporter.send(Number("0x5a"), 4, 2, 0, Buffer.from(nbCallsBuf));
+      let respSign = new Uint8Array(0);
+      for (const call of calls) {
+        const calldatas = this.encodeCall(call);
+        await this._transporter.send(Number("0x5a"), 4, 3, 0, Buffer.from(calldatas[0]));
+        if (calldatas.length > 1) {
+          calldatas.slice(1).forEach(async (part) => {
+            await this._transporter.send(Number("0x5a"), 4, 3, 1, Buffer.from(part));
+          });
+        }
+        respSign = await this._transporter.send(Number("0x5a"), 4, 3, 2);
+      }
+      return this.decodeSignatureLedger(respSign);
+    }
+    /**
+     * Ask to the Ledger Nano to display and sign a Starknet V3 transaction.
+     * @param {V3InvocationsSignerDetails} txDetails All the details needed for a txV3.
+     * @param {Call[]} calls array of Starknet invocations
+     * @returns an object including the transaction Hash and the signature
+     * @example
+     * ```typescript
+     * const calls: Call[] = [{contractAddress: "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+     *      entrypoint: "transfer",
+     *      calldata:["0x11f5fc2a92ac03434a7937fe982f5e5293b65ad438a989c5b78fb8f04a12016",
+     *        "0x9184e72a000", "0x0"]}];
+     * const txDetailsV3: V3InvocationsSignerDetails = {
+     *   chainId: constants.StarknetChainId.SN_MAIN,
+     *   nonce: "28", accountDeploymentData: [],
+     *   paymasterData: [], cairoVersion: "1",
+     *   feeDataAvailabilityMode: "L1", nonceDataAvailabilityMode: "L1",
+     *   resourceBounds: {
+     *     l1_gas: { max_amount: "0x2a00", max_price_per_unit: "0x5c00000"
+     *     },
+     *     l2_gas: { max_amount: "0x00", max_price_per_unit: "0x00"},
+     *   }, tip: 0, version: "0x3", walletAddress: account0.address
+     *  };
+     * const res = await myLedgerSigner.signTxV3(txDetailsV3, calls);
+     * // res = {hash:
+     * //   signature:
+     * // }
+     * ```
+     */
+    async signTxV3(txDetails, calls) {
+      assert(txDetails.paymasterData.length <= 7, "Paymaster data includes more than 7 items.");
+      assert(
+        txDetails.accountDeploymentData.length <= 7,
+        "accountDeploymentData includes more than 7 items"
+      );
+      await this._transporter.send(Number("0x5a"), 3, 0, 0, Buffer.from(this.pathBuffer));
+      const accountAddressBuf = this.convertBnToLedger(txDetails.walletAddress);
+      const tipBuf = this.convertBnToLedger(txDetails.tip);
+      const chainIdBuf = this.convertBnToLedger(txDetails.chainId);
+      const nonceBuf = this.convertBnToLedger(txDetails.nonce);
+      const dAModeHashBuf = this.convertBnToLedger(
+        hashDAMode(
+          txDetails.nonceDataAvailabilityMode === EDataAvailabilityMode2.L1 ? EDAMode2.L1 : EDAMode2.L2,
+          txDetails.feeDataAvailabilityMode === EDataAvailabilityMode2.L1 ? EDAMode2.L1 : EDAMode2.L2
+        )
+      );
+      const l1_gasBuf = this.convertBnToLedger(encodeResourceBoundsL1(txDetails.resourceBounds));
+      const l2_gasBuf = this.convertBnToLedger(encodeResourceBoundsL2(txDetails.resourceBounds));
+      const dataBuf = concatenateArrayBuffer([
+        accountAddressBuf,
+        tipBuf,
+        l1_gasBuf,
+        l2_gasBuf,
+        chainIdBuf,
+        nonceBuf,
+        dAModeHashBuf
+      ]);
+      await this._transporter.send(Number("0x5a"), 3, 1, 0, Buffer.from(dataBuf));
+      const paymasterBuf = concatenateArrayBuffer(
+        txDetails.paymasterData.map((value) => {
+          const a = this.convertBnToLedger(value);
+          return a;
+        })
+      );
+      await this._transporter.send(Number("0x5a"), 3, 2, 0, Buffer.from(paymasterBuf));
+      const accountDeployDataBuf = concatenateArrayBuffer(
+        txDetails.paymasterData.map((value) => {
+          const a = this.convertBnToLedger(value);
+          return a;
+        })
+      );
+      await this._transporter.send(Number("0x5a"), 3, 3, 0, Buffer.from(accountDeployDataBuf));
+      const nbCallsBuf = this.convertBnToLedger(calls.length);
+      await this._transporter.send(Number("0x5a"), 3, 4, 0, Buffer.from(nbCallsBuf));
+      let respSign = new Uint8Array(0);
+      for (const call of calls) {
+        const calldatas = this.encodeCall(call);
+        await this._transporter.send(Number("0x5a"), 3, 5, 0, Buffer.from(calldatas[0]));
+        if (calldatas.length > 1) {
+          calldatas.slice(1).forEach(async (part) => {
+            await this._transporter.send(Number("0x5a"), 3, 5, 1, Buffer.from(part));
+          });
+        }
+        respSign = await this._transporter.send(Number("0x5a"), 3, 5, 2);
+      }
+      return this.decodeSignatureLedger(respSign);
+    }
+    /**
+     * Ask the Ledger Nano to display and sign a Starknet V1 account deployment.
+     * @param {V2DeployAccountSignerDetails} deployAccountDetail All the details needed for a V1 deploy account.
+     * @returns an object including the transaction Hash and the signature
+     * @example
+     * ```typescript
+     * const deployData: V2DeployAccountSignerDetails =
+     * {
+     *  tip: 0, paymasterData: [], accountDeploymentData: [],
+     *  nonceDataAvailabilityMode: 'L1', feeDataAvailabilityMode: 'L1',
+     *  resourceBounds: {
+     *    l2_gas: { max_amount: '0x0', max_price_per_unit: '0x0' },
+     *    l1_gas: { max_amount: '0x0', max_price_per_unit: '0x0' }
+     *   },
+     *  classHash: '0x540d7f5ec7ecf317e68d48564934cb99259781b1ee3cedbbc37ec5337f8e688',
+     *  constructorCalldata: [
+     *    '89832696000889662999767022750851886674077821293893187900664573372145410755'
+     *  ],
+     *  contractAddress: '0x32c60fba64eb96831d064bbb2319375b7b7381543abe66da872e4344bcd72a0',
+     *  addressSalt: '0x0032d7efe2a9232f9b463e7206c68fdea4aeb13fec0cb308c6ba1d197d5922c3',
+     *  chainId: '0x534e5f5345504f4c4941', maxFee: 55050000000000n,
+     *  version: '0x1', nonce: 0n
+     *}
+     * const res = await myLedgerSigner.signDeployAccountV1(deployData);
+     * // res = {hash:
+     * //   signature:
+     * // }
+     * ```
+     */
+    async signDeployAccountV1(deployAccountDetail) {
+      await this._transporter.send(Number("0x5a"), 6, 0, 0, Buffer.from(this.pathBuffer));
+      const accountAddressBuf = this.convertBnToLedger(
+        deployAccountDetail.contractAddress
+      );
+      const classHashBuf = this.convertBnToLedger(deployAccountDetail.classHash);
+      const saltBuf = this.convertBnToLedger(deployAccountDetail.addressSalt);
+      const chainIdBuf = this.convertBnToLedger(deployAccountDetail.chainId);
+      const nonceBuf = this.convertBnToLedger(deployAccountDetail.nonce);
+      const dataBuf = concatenateArrayBuffer([
+        accountAddressBuf,
+        classHashBuf,
+        saltBuf,
+        chainIdBuf,
+        nonceBuf
+      ]);
+      await this._transporter.send(Number("0x5a"), 6, 1, 0, Buffer.from(dataBuf));
+      const maxFreeBuf = this.convertBnToLedger(deployAccountDetail.maxFee);
+      await this._transporter.send(Number("0x5a"), 6, 2, 0, Buffer.from(maxFreeBuf));
+      const compiledConstructor = CallData.compile(deployAccountDetail.constructorCalldata);
+      const constructorLengthBuf = this.convertBnToLedger(compiledConstructor.length);
+      await this._transporter.send(Number("0x5a"), 6, 3, 0, Buffer.from(constructorLengthBuf));
+      const constructorBuf = concatenateArrayBuffer(
+        compiledConstructor.map((parameter) => {
+          const a = this.convertBnToLedger(parameter);
+          return a;
+        })
+      );
+      const constructorChunks = [];
+      const chunkSize = 7 * 32;
+      for (let i = 0; i < constructorBuf.length; i += chunkSize)
+        constructorChunks.push(constructorBuf.subarray(i, i + chunkSize));
+      let respSign = new Uint8Array(0);
+      for (const chunk of constructorChunks) {
+        respSign = await this._transporter.send(Number("0x5a"), 6, 4, 0, Buffer.from(chunk));
+      }
+      return this.decodeSignatureLedger(respSign);
+    }
+    /**
+     *Ask the Ledger Nano to display and sign a Starknet V3 account deployment.
+     * @param {V3DeployAccountSignerDetails} deployAccountDetail All the details needed for a V3 deploy account.
+     * @returns an object including the transaction Hash and the signature
+     * @example
+     * ```typescript
+     * const deployData: V3DeployAccountSignerDetails =
+     * {
+     *  tip: 0, paymasterData: [], accountDeploymentData: [],
+     *  nonceDataAvailabilityMode: 'L1', feeDataAvailabilityMode: 'L1',
+     *  resourceBounds: {
+     *    l2_gas: { max_amount: '0x0', max_price_per_unit: '0x0' },
+     *    l1_gas: { max_amount: '0x226', max_price_per_unit: '0x22ecb25c00' }
+     *   },
+     *  classHash: '0x540d7f5ec7ecf317e68d48564934cb99259781b1ee3cedbbc37ec5337f8e688',
+     *  constructorCalldata: [
+     *    '3571125127744830445572285574469842579401255431821644822726857471463672199621'
+     *  ],
+     *  contractAddress: '0x4ca062add1cf12a107be1107af17981cf6e544a24d987693230ea481d3d5e34',
+     *  addressSalt: '0x07e52f68e3160e1ef698211cdf6d3792368fe347e7e2d4a8ace14d9b248f39c5',
+     *  chainId: '0x534e5f5345504f4c4941', maxFee: 0,
+     *  version: '0x3', nonce: 0n
+     *}
+     * const res = await myLedgerSigner.signDeployAccountV3(deployData);
+     * // res = {hash:
+     * //   signature:
+     * // }
+     * ```
+     */
+    async signDeployAccountV3(deployAccountDetail) {
+      await this._transporter.send(Number("0x5a"), 5, 0, 0, Buffer.from(this.pathBuffer));
+      const accountAddressBuf = this.convertBnToLedger(
+        deployAccountDetail.contractAddress
+      );
+      const chainIdBuf = this.convertBnToLedger(deployAccountDetail.chainId);
+      const nonceBuf = this.convertBnToLedger(deployAccountDetail.nonce);
+      const dAModeHashBuf = this.convertBnToLedger(
+        hashDAMode(
+          deployAccountDetail.nonceDataAvailabilityMode === EDataAvailabilityMode2.L1 ? EDAMode2.L1 : EDAMode2.L2,
+          deployAccountDetail.feeDataAvailabilityMode === EDataAvailabilityMode2.L1 ? EDAMode2.L1 : EDAMode2.L2
+        )
+      );
+      const classHashBuf = this.convertBnToLedger(deployAccountDetail.classHash);
+      const saltBuf = this.convertBnToLedger(deployAccountDetail.addressSalt);
+      const dataBuf = concatenateArrayBuffer([
+        accountAddressBuf,
+        chainIdBuf,
+        nonceBuf,
+        dAModeHashBuf,
+        classHashBuf,
+        saltBuf
+      ]);
+      await this._transporter.send(Number("0x5a"), 5, 1, 0, Buffer.from(dataBuf));
+      const tipBuf = this.convertBnToLedger(deployAccountDetail.tip);
+      const l1_gasBuf = this.convertBnToLedger(
+        encodeResourceBoundsL1(deployAccountDetail.resourceBounds)
+      );
+      const l2_gasBuf = this.convertBnToLedger(
+        encodeResourceBoundsL2(deployAccountDetail.resourceBounds)
+      );
+      const feeBuf = concatenateArrayBuffer([tipBuf, l1_gasBuf, l2_gasBuf]);
+      await this._transporter.send(Number("0x5a"), 5, 2, 0, Buffer.from(feeBuf));
+      const paymasterBuf = concatenateArrayBuffer(
+        deployAccountDetail.paymasterData.map((value) => {
+          const a = this.convertBnToLedger(value);
+          return a;
+        })
+      );
+      await this._transporter.send(Number("0x5a"), 5, 3, 0, Buffer.from(paymasterBuf));
+      const compiledConstructor = CallData.compile(deployAccountDetail.constructorCalldata);
+      const constructorLengthBuf = this.convertBnToLedger(compiledConstructor.length);
+      await this._transporter.send(Number("0x5a"), 5, 4, 0, Buffer.from(constructorLengthBuf));
+      const constructorBuf = concatenateArrayBuffer(
+        compiledConstructor.map((parameter) => {
+          const a = this.convertBnToLedger(parameter);
+          return a;
+        })
+      );
+      const constructorChunks = [];
+      const chunkSize = 7 * 32;
+      for (let i = 0; i < constructorBuf.length; i += chunkSize)
+        constructorChunks.push(constructorBuf.subarray(i, i + chunkSize));
+      let respSign = new Uint8Array(0);
+      for (const chunk of constructorChunks) {
+        respSign = await this._transporter.send(Number("0x5a"), 5, 5, 0, Buffer.from(chunk));
+      }
+      return this.decodeSignatureLedger(respSign);
+    }
+  };
+  function getLedgerPathBuffer221(accountId, applicationName = "LedgerW") {
+    const path0buff = new Uint8Array([HARDENING_BYTE, 0, 10, 85]);
+    const path1buff = new Uint8Array([71 | HARDENING_BYTE, 65, 233, 201]);
+    const path2Base = applicationName === "LedgerW" ? new Uint8Array([43, 206, 231, 219]) : stringToSha256ToArrayBuff4(applicationName);
+    const path2buff = concatenateArrayBuffer([
+      new Uint8Array([path2Base[0] | HARDENING_BYTE]),
+      path2Base.subarray(1)
+    ]);
+    const path3buff = new Uint8Array([HARDENING_BYTE, 0, 0, 0]);
+    const hex = toHex(BigInt(accountId) | HARDENING_4BYTES);
+    const padded = addHexPrefix(removeHexPrefix(hex).padStart(8, "0"));
+    const path4buff = hexToBytes2(padded);
+    const path5buff = new Uint8Array([0, 0, 0, 0]);
+    const pathBuff = concatenateArrayBuffer([
+      path0buff,
+      path1buff,
+      path2buff,
+      path3buff,
+      path4buff,
+      path5buff
+    ]);
+    return pathBuff;
+  }
+
   // src/utils/events/index.ts
   var events_exports = {};
   __export(events_exports, {
@@ -28749,38 +29397,6 @@ var starknet = (() => {
   var ResponseParser = class {
   };
 
-  // src/utils/address.ts
-  function addAddressPadding(address) {
-    const hex = toHex(addHexPrefix(address.toString()));
-    const padded = removeHexPrefix(hex).padStart(64, "0");
-    return addHexPrefix(padded);
-  }
-  function validateAndParseAddress(address) {
-    const result = addAddressPadding(address);
-    if (!result.match(/^(0x)?[0-9a-fA-F]{64}$/)) {
-      throw new Error("Invalid Address Format");
-    }
-    assertInRange(result, ZERO, ADDR_BOUND - 1n, "Starknet Address");
-    return result;
-  }
-  function getChecksumAddress(address) {
-    const chars = removeHexPrefix(validateAndParseAddress(address)).toLowerCase().split("");
-    const hex = removeHexPrefix(keccakBn(address));
-    const hashed = hexToBytes(hex.padStart(64, "0"));
-    for (let i = 0; i < chars.length; i += 2) {
-      if (hashed[i >> 1] >> 4 >= 8) {
-        chars[i] = chars[i].toUpperCase();
-      }
-      if ((hashed[i >> 1] & 15) >= 8) {
-        chars[i + 1] = chars[i + 1].toUpperCase();
-      }
-    }
-    return addHexPrefix(chars.join(""));
-  }
-  function validateChecksumAddress(address) {
-    return getChecksumAddress(address) === address;
-  }
-
   // src/index.ts
   var number2 = num_exports;
   return __toCommonJS(src_exports);