starknet 9.4.0 → 9.4.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.4.1](https://github.com/starknet-io/starknet.js/compare/v9.4.0...v9.4.1) (2026-03-02)
+
+### Bug Fixes
+
+- implement requested modifications ([d1e4a19](https://github.com/starknet-io/starknet.js/commit/d1e4a1900886d27e41855f22e320ce174129bb1b))
+
 # [9.4.0](https://github.com/starknet-io/starknet.js/compare/v9.3.0...v9.4.0) (2026-02-06)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -6788,6 +6788,20 @@ declare function signatureToDecimalArray(sig?: Signature): ArraySignatureType;
  * ```
  */
 declare function signatureToHexArray(sig?: Signature): ArraySignatureType;
+/**
+ * Calculate the shared secret using ECDH key agreement protocol with a given private key and a full public key.
+ * @param {BigNumberish} privateKey - a Starknet 252 bits private key.
+ * @param {BigNumberish} fullPublicKey - a 520 bit number, representing the full public key related to `privateKey`, which can be obtained by `getFullPublicKey` function. This number needs to start with '0x04' to indicate that it's a full public key, and the remaining 128 bytes represent the x and y coordinates of the public key point on the elliptic curve (64 bytes for x and 64 bytes for y).
+ * @returns {string} an hex string of a 256 bit number, representing the shared secret calculated by ECDH key agreement protocol using `privateKey` and `fullPublicKey`.
+ * @example
+ * ```typescript
+ * const myPrivateKey = "0x67d0bd238e266b6defbb1ad4de4cf1dde2dc55b3518596e0bae29e439165596";
+ * const bobFullPublicKey = "0x0402d6b3ff569186d67a2ff0b8548328798d3500c16191f6c021f929134d48a15405f9fc5a11467b96a59b8fce3c0c919c337f11337c815bb9d0dc42bac7ac42a9";
+ * const result = stark.getSharedSecret(myPrivateKey, bobFullPublicKey);
+ * // result = "0x020619d1a277a5bc51aac6ab0c22d97e414d4bee9711a2d0aa421997f5efd68bab"
+ * ```
+ */
+declare function getSharedSecret(privateKey: BigNumberish, fullPublicKey: BigNumberish): string;
 /**
  * Returns a resource bounds with zero values and no overhead.
  * @returns {ResourceBoundsBN} A resource bounds with zero values and no overhead.
@@ -6970,6 +6984,7 @@ declare const index$1_compressProgram: typeof compressProgram;
 declare const index$1_decompressProgram: typeof decompressProgram;
 declare const index$1_formatSignature: typeof formatSignature;
 declare const index$1_getFullPublicKey: typeof getFullPublicKey;
+declare const index$1_getSharedSecret: typeof getSharedSecret;
 declare const index$1_intDAM: typeof intDAM;
 declare const index$1_randomAddress: typeof randomAddress;
 declare const index$1_resourceBoundsToBigInt: typeof resourceBoundsToBigInt;
@@ -6984,7 +6999,7 @@ declare const index$1_toTransactionVersion: typeof toTransactionVersion;
 declare const index$1_v3Details: typeof v3Details;
 declare const index$1_zeroResourceBounds: typeof zeroResourceBounds;
 declare namespace index$1 {
-  export { index$1_ZeroFeeEstimate as ZeroFeeEstimate, index$1_compressProgram as compressProgram, index$1_decompressProgram as decompressProgram, index$1_formatSignature as formatSignature, index$1_getFullPublicKey as getFullPublicKey, index$1_intDAM as intDAM, index$1_randomAddress as randomAddress, index$1_resourceBoundsToBigInt as resourceBoundsToBigInt, index$1_resourceBoundsToEstimateFeeResponse as resourceBoundsToEstimateFeeResponse, index$1_resourceBoundsToHexString as resourceBoundsToHexString, index$1_signatureToDecimalArray as signatureToDecimalArray, index$1_signatureToHexArray as signatureToHexArray, index$1_toFeeVersion as toFeeVersion, index$1_toOverheadOverallFee as toOverheadOverallFee, index$1_toOverheadResourceBounds as toOverheadResourceBounds, index$1_toTransactionVersion as toTransactionVersion, index$1_v3Details as v3Details, index$1_zeroResourceBounds as zeroResourceBounds };
+  export { index$1_ZeroFeeEstimate as ZeroFeeEstimate, index$1_compressProgram as compressProgram, index$1_decompressProgram as decompressProgram, index$1_formatSignature as formatSignature, index$1_getFullPublicKey as getFullPublicKey, index$1_getSharedSecret as getSharedSecret, index$1_intDAM as intDAM, index$1_randomAddress as randomAddress, index$1_resourceBoundsToBigInt as resourceBoundsToBigInt, index$1_resourceBoundsToEstimateFeeResponse as resourceBoundsToEstimateFeeResponse, index$1_resourceBoundsToHexString as resourceBoundsToHexString, index$1_signatureToDecimalArray as signatureToDecimalArray, index$1_signatureToHexArray as signatureToHexArray, index$1_toFeeVersion as toFeeVersion, index$1_toOverheadOverallFee as toOverheadOverallFee, index$1_toOverheadResourceBounds as toOverheadResourceBounds, index$1_toTransactionVersion as toTransactionVersion, index$1_v3Details as v3Details, index$1_zeroResourceBounds as zeroResourceBounds };
 }
 
 /**

package/dist/index.global.js

@@ -4648,7 +4648,7 @@ ${indent}}` : "}";
         return true;
       return false;
     }
-    function getSharedSecret2(privateA, publicB, isCompressed = true) {
+    function getSharedSecret3(privateA, publicB, isCompressed = true) {
       if (isProbPub(privateA))
         throw new Error("first arg must be private key");
       if (!isProbPub(publicB))
@@ -4776,7 +4776,7 @@ ${indent}}` : "}";
     return {
       CURVE: CURVE2,
       getPublicKey: getPublicKey2,
-      getSharedSecret: getSharedSecret2,
+      getSharedSecret: getSharedSecret3,
       sign: sign2,
       verify: verify2,
       ProjectivePoint: Point2,
@@ -10063,6 +10063,7 @@ ${indent}}` : "}";
     decompressProgram: () => decompressProgram,
     formatSignature: () => formatSignature,
     getFullPublicKey: () => getFullPublicKey,
+    getSharedSecret: () => getSharedSecret2,
     intDAM: () => intDAM,
     randomAddress: () => randomAddress,
     resourceBoundsToBigInt: () => resourceBoundsToBigInt,
@@ -14286,6 +14287,17 @@ ${indent}}` : "}";
   function signatureToHexArray(sig) {
     return bigNumberishArrayToHexadecimalStringArray(formatSignature(sig));
   }
+  function getSharedSecret2(privateKey, fullPublicKey) {
+    const privK = toHex(privateKey);
+    const fullPubKHex = removeHexPrefix(toHex(fullPublicKey)).padStart(130, "0");
+    if (fullPubKHex.length !== 130 || !fullPubKHex.startsWith("04")) {
+      throw new Error(
+        "fullPublicKey must be an uncompressed public key (starting with 04, 65 bytes total)"
+      );
+    }
+    const sharedSecret = buf2hex(esm_exports4.getSharedSecret(privK, fullPubKHex));
+    return addHexPrefix(sharedSecret);
+  }
   function zeroResourceBounds() {
     return toOverheadResourceBounds(ZeroFeeEstimate(), false);
   }