@aptos-labs/ts-sdk 7.0.0 → 7.1.0

package/dist/internal/transaction.js

@@ -148,6 +148,17 @@ export async function waitForTransaction(args) {
     let lastError;
     let backoffIntervalMs = 200;
     const backoffMultiplier = 1.5;
+    // A response is "settled" when the fullnode has populated the execution result.
+    // There is a window where `type` flips to a committed variant (e.g. User) before
+    // `success`/`vm_status` are filled in — during that window we must keep polling,
+    // not treat the partial response as a failure.
+    function isUnsettled(txn) {
+        if (txn === undefined)
+            return true;
+        if (txn.type === TransactionResponseType.Pending)
+            return true;
+        return txn.success === undefined;
+    }
     /**
      * Handles API errors by throwing the last error or a timeout error for a failed transaction.
      *
@@ -170,7 +181,7 @@ export async function waitForTransaction(args) {
     // check to see if the txn is already on the blockchain
     try {
         lastTxn = await getTransactionByHash({ aptosConfig, transactionHash });
-        isPending = lastTxn.type === TransactionResponseType.Pending;
+        isPending = isUnsettled(lastTxn);
     }
     catch (e) {
         handleAPIError(e);
@@ -180,7 +191,7 @@ export async function waitForTransaction(args) {
         const startTime = Date.now();
         try {
             lastTxn = await longWaitForTransaction({ aptosConfig, transactionHash });
-            isPending = lastTxn.type === TransactionResponseType.Pending;
+            isPending = isUnsettled(lastTxn);
         }
         catch (e) {
             handleAPIError(e);
@@ -194,7 +205,7 @@ export async function waitForTransaction(args) {
         }
         try {
             lastTxn = await getTransactionByHash({ aptosConfig, transactionHash });
-            isPending = lastTxn.type === TransactionResponseType.Pending;
+            isPending = isUnsettled(lastTxn);
             if (!isPending) {
                 break;
             }
@@ -218,6 +229,12 @@ export async function waitForTransaction(args) {
     if (lastTxn.type === TransactionResponseType.Pending) {
         throw new WaitForTransactionError(`Transaction ${transactionHash} timed out in pending state after ${timeoutSecs} seconds`, lastTxn);
     }
+    // If we exited the loop with a committed-shaped response that hasn't been
+    // fully populated yet (success/vm_status still undefined), this is the
+    // indexer-lag race — surface it as a timeout, not as a failed transaction.
+    if (lastTxn.success === undefined) {
+        throw new WaitForTransactionError(`Transaction ${transactionHash} did not finish indexing within ${timeoutSecs} seconds`, lastTxn);
+    }
     if (!checkSuccess) {
         return lastTxn;
     }

package/dist/internal/transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/internal/transaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/internal/transaction.ts"],"names":[],"mappings":"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"}

package/dist/transactions/transactionBuilder/encryptPayload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encryptPayload.d.ts","sourceRoot":"","sources":["../../../src/transactions/transactionBuilder/encryptPayload.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAkB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAa1E,OAAO,EAML,kCAAkC,EAEnC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,6BAA6B,EAA6B,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAuJxH;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,6BAA6B,CAAC;IACvC,OAAO,EAAE,+BAA+B,CAAC;IACzC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,wBAAwB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAyC9C"}
+{"version":3,"file":"encryptPayload.d.ts","sourceRoot":"","sources":["../../../src/transactions/transactionBuilder/encryptPayload.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAkB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAa1E,OAAO,EAML,kCAAkC,EAEnC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,6BAA6B,EAA6B,+BAA+B,EAAE,MAAM,aAAa,CAAC;AA6JxH;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,6BAA6B,CAAC;IACvC,OAAO,EAAE,+BAA+B,CAAC;IACzC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,wBAAwB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,kCAAkC,CAAC,CA0C9C"}

package/dist/transactions/transactionBuilder/encryptPayload.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { AccountAddress } from "../../core/index.js";
 import { AuthenticationKey } from "../../core/authenticationKey.js";
-import { AccountPublicKey } from "../../core/crypto/index.js";
+import { fetchAndCacheAuthKeyForAddress } from "../../internal/account.js";
 import { fetchAndCacheEncryptionKey } from "../../internal/encryptionKey.js";
 import { ClaimedEntryFunction, DECRYPTION_NONCE_LENGTH, DecryptedPlaintext, PayloadAssociatedData, } from "../instances/encryptedPayload.js";
 import { Identifier } from "../instances/identifier.js";
@@ -48,9 +48,11 @@ function payloadHasMultisigAddress(payload) {
 }
 function resolveClaimedEntryFun(args) {
     const { payload, feePayerAddress, options } = args;
-    // Match `buildSignerAuthKeys`: a zero-address fee payer is not a real sponsor, so it should not
-    // force a `claimed_entry_fun` to be exposed/validated.
-    const hasFeePayer = feePayerAddress !== undefined && !AccountAddress.from(feePayerAddress).equals(AccountAddress.ZERO);
+    // Unlike buildSignerAuthKeys, we treat a zero feePayerAddress (deferred gas-station sponsor) the
+    // same as a real one: a fee payer *will* sign, so include claimed_entry_fun so they can inspect
+    // the payload without decrypting it. The zero check in buildSignerAuthKeys is different — adding
+    // a placeholder zero auth key to the cryptographic AAD would corrupt it.
+    const hasFeePayer = feePayerAddress !== undefined;
     if (!hasFeePayer && !payloadHasMultisigAddress(payload)) {
         return undefined;
     }
@@ -66,56 +68,54 @@ function resolveClaimedEntryFun(args) {
     return undefined;
 }
 function resolveAuthKey(input) {
-    if (input instanceof AccountPublicKey) {
-        return input.authKey();
+    if (input instanceof AuthenticationKey) {
+        return input;
     }
     return new AuthenticationKey({ data: input });
 }
 /**
- * Validates auth-key options and assembles `(address, authenticationKey)` pairs in
- * `TransactionAuthenticator::all_signer_auth_keys` order: sender, secondaries, fee payer last.
+ * Assembles `(address, authenticationKey)` pairs in `TransactionAuthenticator::all_signer_auth_keys` order
+ * (sender, secondaries, fee payer last). Auth keys not supplied in `options` are fetched from chain via
+ * `fetchAndCacheAuthKeyForAddress`, which caches per `(network, address)` for ~1 hour.
  */
-function buildSignerAuthKeys(args) {
-    const { sender, options, feePayerAddress, secondarySignerAddresses } = args;
-    if (options.authenticationKey === undefined) {
-        throw new Error("options.authenticationKey is required when options.encrypted is true. " +
-            "Pass the sender's AccountPublicKey or a raw 32-byte auth key hex string.");
-    }
+async function buildSignerAuthKeys(args) {
+    const { aptosConfig, sender, options, feePayerAddress, secondarySignerAddresses } = args;
     const secondaryAddrs = secondarySignerAddresses ?? [];
-    const secondaryAuthHex = options.secondarySignerAuthenticationKeys;
-    if (secondaryAddrs.length > 0) {
-        if (!secondaryAuthHex || secondaryAuthHex.length !== secondaryAddrs.length) {
-            throw new Error("Encrypted multi-agent transactions require options.secondarySignerAuthenticationKeys with one entry per secondarySignerAddresses entry, in the same order. " +
-                "Each entry may be an AccountPublicKey or a raw 32-byte auth key hex string.");
-        }
-    }
-    else if (secondaryAuthHex !== undefined && secondaryAuthHex.length > 0) {
+    const secondaryAuthInputs = options.secondarySignerAuthenticationKeys;
+    if (secondaryAddrs.length === 0 && secondaryAuthInputs !== undefined && secondaryAuthInputs.length > 0) {
         throw new Error("options.secondarySignerAuthenticationKeys was set but no secondarySignerAddresses were provided to generateRawTransaction.");
     }
+    if (secondaryAddrs.length > 0 &&
+        secondaryAuthInputs !== undefined &&
+        secondaryAuthInputs.length !== secondaryAddrs.length) {
+        throw new Error("Encrypted multi-agent transactions require options.secondarySignerAuthenticationKeys (when provided) to have one entry per secondarySignerAddresses entry, in the same order. " +
+            "Leave individual entries undefined to fetch them from chain.");
+    }
     const feePayerAddr = feePayerAddress !== undefined ? AccountAddress.from(feePayerAddress) : undefined;
     const hasNonZeroFeePayer = feePayerAddr !== undefined && !feePayerAddr.equals(AccountAddress.ZERO);
-    if (hasNonZeroFeePayer && options.feePayerAuthenticationKey === undefined) {
-        throw new Error("options.feePayerAuthenticationKey is required when options.encrypted is true and feePayerAddress is a non-zero sponsor. " +
-            "Must match the fee payer authenticator; AAD order is sender, then secondaries, then fee payer (aptos-core `all_signer_auth_keys`).");
-    }
     if (options.feePayerAuthenticationKey !== undefined && !hasNonZeroFeePayer) {
         throw new Error("options.feePayerAuthenticationKey was set but feePayerAddress is missing or the zero address (no on-chain fee payer for AAD).");
     }
-    const senderPair = {
-        address: sender,
-        authenticationKey: resolveAuthKey(options.authenticationKey),
+    const resolveFor = async (address, input) => {
+        if (input !== undefined) {
+            return resolveAuthKey(input);
+        }
+        return fetchAndCacheAuthKeyForAddress({ aptosConfig, accountAddress: address });
     };
-    const additional = secondaryAddrs.length > 0 && secondaryAuthHex
-        ? secondaryAddrs.map((addr, i) => ({
-            address: AccountAddress.from(addr),
-            authenticationKey: resolveAuthKey(secondaryAuthHex[i]),
-        }))
-        : [];
-    if (hasNonZeroFeePayer && options.feePayerAuthenticationKey !== undefined) {
-        additional.push({
-            address: feePayerAddr,
-            authenticationKey: resolveAuthKey(options.feePayerAuthenticationKey),
-        });
+    const secondaryPairsPromise = Promise.all(secondaryAddrs.map(async (addr, i) => {
+        const address = AccountAddress.from(addr);
+        const authenticationKey = await resolveFor(address, secondaryAuthInputs?.[i]);
+        return { address, authenticationKey };
+    }));
+    const [senderAuthKey, secondaryPairs, feePayerAuthKey] = await Promise.all([
+        resolveFor(sender, options.senderAuthenticationKey),
+        secondaryPairsPromise,
+        hasNonZeroFeePayer ? resolveFor(feePayerAddr, options.feePayerAuthenticationKey) : Promise.resolve(undefined),
+    ]);
+    const senderPair = { address: sender, authenticationKey: senderAuthKey };
+    const additional = [...secondaryPairs];
+    if (hasNonZeroFeePayer && feePayerAuthKey !== undefined) {
+        additional.push({ address: feePayerAddr, authenticationKey: feePayerAuthKey });
     }
     return { sender: senderPair, additional: additional.length > 0 ? additional : undefined };
 }
@@ -129,7 +129,8 @@ function buildSignerAuthKeys(args) {
 export async function buildEncryptedPayload(args) {
     const { aptosConfig, sender, payload, options, feePayerAddress, secondarySignerAddresses, replayProtectionNonce } = args;
     const senderAddr = AccountAddress.from(sender);
-    const { sender: senderPair, additional } = buildSignerAuthKeys({
+    const { sender: senderPair, additional } = await buildSignerAuthKeys({
+        aptosConfig,
         sender: senderAddr,
         options,
         feePayerAddress,

package/dist/transactions/transactionBuilder/encryptPayload.js.map

@@ -1 +1 @@
-{"version":3,"file":"encryptPayload.js","sourceRoot":"","sources":["../../../src/transactions/transactionBuilder/encryptPayload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"encryptPayload.js","sourceRoot":"","sources":["../../../src/transactions/transactionBuilder/encryptPayload.ts"],"names":[],"mappings":"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"}

package/dist/transactions/types.d.ts

@@ -2,8 +2,8 @@ import { AptosConfig } from "../api/aptosConfig.js";
 import { MoveOption, MoveString, MoveVector } from "../bcs/serializable/moveStructs.js";
 import { Bool, I128, I16, I256, I32, I64, I8, U128, U16, U256, U32, U64, U8 } from "../bcs/serializable/movePrimitives.js";
 import { FixedBytes } from "../bcs/serializable/fixedBytes.js";
-import { AccountAddress, AccountAddressInput } from "../core/index.js";
-import { AccountPublicKey, PublicKey } from "../core/crypto/index.js";
+import { AccountAddress, AccountAddressInput, AuthenticationKey } from "../core/index.js";
+import { PublicKey } from "../core/crypto/index.js";
 import { MultiAgentRawTransaction, FeePayerRawTransaction, RawTransaction, TransactionPayloadEntryFunction, TransactionPayloadMultiSig, TransactionPayloadScript, TransactionInnerPayload, TransactionPayloadEncryptedPayload } from "./instances/index.js";
 import { AnyNumber, HexInput, MoveFunctionGenericTypeParam, MoveFunctionId, MoveModuleId, MoveStructId, MoveValue, TransactionSubmitter } from "../types/index.js";
 import type { ClaimedEntryFunction } from "./instances/encryptedPayload.js";
@@ -88,23 +88,27 @@ export type InputEncryptedTransactionBuildOptions = {
      */
     encrypted?: boolean;
     /**
-     * Authentication key for the primary sender. Required when `encrypted` is true.
-     * Accept either an `AccountPublicKey` (auth key is derived automatically via `.authKey()`) or a raw 32-byte hex
-     * string. Must match the on-chain authenticator identity (aptos-core `PayloadAssociatedData::V1.signer_auth_keys`).
+     * Authentication key for the primary sender. Optional: when omitted (and `encrypted` is true), the SDK fetches
+     * the sender's `authentication_key` from the fullnode and caches it for ~1 hour. Pass it explicitly to skip the
+     * lookup (useful right after a key rotation). Accepts an `AuthenticationKey` or a raw 32-byte hex string /
+     * `Uint8Array`. Must match the on-chain authenticator identity (aptos-core
+     * `PayloadAssociatedData::V1.signer_auth_keys`).
      */
-    authenticationKey?: HexInput | AccountPublicKey;
+    senderAuthenticationKey?: AuthenticationKey | HexInput;
     /**
      * For encrypted **multi-agent** transactions: each secondary signer's authentication key, in the same order
-     * as `secondarySignerAddresses` on the transaction build input. Accepts `AccountPublicKey` or raw 32-byte hex.
+     * as `secondarySignerAddresses` on the transaction build input. Any entry left undefined (or the entire array
+     * omitted) will be fetched from chain and cached. Accepts `AuthenticationKey` or a raw 32-byte hex string /
+     * `Uint8Array`.
      */
-    secondarySignerAuthenticationKeys?: (HexInput | AccountPublicKey)[];
+    secondarySignerAuthenticationKeys?: (AuthenticationKey | HexInput | undefined)[];
     /**
-     * For encrypted **fee-payer** transactions: the fee payer's authentication key. Required when `encrypted` is true
-     * and `feePayerAddress` is set to a **non-zero** sponsor address. Appended **last** in AAD `signer_auth_keys`,
-     * matching aptos-core `TransactionAuthenticator::all_signer_auth_keys` (after sender and secondaries).
-     * Accepts `AccountPublicKey` or raw 32-byte hex.
+     * For encrypted **fee-payer** transactions: the fee payer's authentication key. Optional when `feePayerAddress`
+     * is a **non-zero** sponsor — omitted values are fetched from chain and cached. Appended **last** in AAD
+     * `signer_auth_keys`, matching aptos-core `TransactionAuthenticator::all_signer_auth_keys` (after sender and
+     * secondaries). Accepts `AuthenticationKey` or a raw 32-byte hex string / `Uint8Array`.
      */
-    feePayerAuthenticationKey?: HexInput | AccountPublicKey;
+    feePayerAuthenticationKey?: AuthenticationKey | HexInput;
     /**
      * Overrides `claimed_entry_fun` for encrypted transactions when a fee payer is set, the payload is multisig, or the
      * payload is `TransactionInnerPayload` with a multisig address in `TransactionExtraConfigV1`.

package/dist/transactions/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transactions/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transactions/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/helpers.d.ts

@@ -1,5 +1,21 @@
 import { MoveFunctionId, MoveStructId } from "../types/index.js";
 import { AccountAddress } from "../core/accountAddress.js";
+/**
+ * Narrows a u64 (`bigint`) into a JS `number` with an explicit safety check.
+ *
+ * The `deserializeU64` reader returns `bigint`, but several keyless code
+ * paths historically narrowed the value with `Number(value)` to fit existing
+ * `number`-typed fields (expiry timestamps, expiry horizons). For values
+ * larger than `Number.MAX_SAFE_INTEGER` (~9 × 10^15), `Number(bigint)`
+ * silently loses precision — comparisons against `Date.now() / 1000` then
+ * return wrong results.
+ *
+ * Real-world expiry values are far below the unsafe range (year ~285 million
+ * AD as a Unix timestamp), so this check is effectively a guard against
+ * corrupted or malicious BCS data rather than a precision concern in normal
+ * operation. Throwing is correct behavior at the BCS/JSON boundary.
+ */
+export declare function u64ToNumberSafe(value: bigint, fieldName: string): number;
 /**
  * Checks if the current runtime environment is Bun.
  * This is useful for detecting Bun-specific compatibility issues.

package/dist/utils/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAI3D;;;;;;;GAOG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAO/B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAavD;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAsC,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAmBlE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAY9D;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uCAAuC,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,WAA0B,CAAC;AAEjH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uCAAuC,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,WAA0B,CAAC;AAoBjH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAW;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,KAAG,YAKH,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,GAAG,KACb,SAAS,IAAI;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CAUqB,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,cAAc;;;;EAS3D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,GAAG,GAAE,MAAU,UAElF;AAsBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,EAAE,GAAG,cAAc,CAOrG"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAU3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAO/B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAavD;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAsC,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAmBlE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAY9D;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uCAAuC,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,WAA0B,CAAC;AAEjH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uCAAuC,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,WAA0B,CAAC;AAoBjH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAW;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,KAAG,YAKH,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,GAAG,KACb,SAAS,IAAI;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CAUqB,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,cAAc;;;;EAS3D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,GAAG,GAAE,MAAU,UAElF;AAsBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,EAAE,GAAG,cAAc,CAOrG"}

package/dist/utils/helpers.js

@@ -3,6 +3,35 @@
 import { AccountAddress } from "../core/accountAddress.js";
 import { createObjectAddress } from "../core/account/utils/address.js";
 import { TEXT_ENCODER } from "./const.js";
+/**
+ * Maximum bigint value that can be losslessly converted to a JS `number`.
+ * Equal to `BigInt(Number.MAX_SAFE_INTEGER)` (2^53 - 1).
+ */
+const MAX_SAFE_U64 = BigInt(Number.MAX_SAFE_INTEGER);
+/**
+ * Narrows a u64 (`bigint`) into a JS `number` with an explicit safety check.
+ *
+ * The `deserializeU64` reader returns `bigint`, but several keyless code
+ * paths historically narrowed the value with `Number(value)` to fit existing
+ * `number`-typed fields (expiry timestamps, expiry horizons). For values
+ * larger than `Number.MAX_SAFE_INTEGER` (~9 × 10^15), `Number(bigint)`
+ * silently loses precision — comparisons against `Date.now() / 1000` then
+ * return wrong results.
+ *
+ * Real-world expiry values are far below the unsafe range (year ~285 million
+ * AD as a Unix timestamp), so this check is effectively a guard against
+ * corrupted or malicious BCS data rather than a precision concern in normal
+ * operation. Throwing is correct behavior at the BCS/JSON boundary.
+ */
+export function u64ToNumberSafe(value, fieldName) {
+    if (value < 0n) {
+        throw new RangeError(`${fieldName} is negative (${value}); expected an unsigned u64`);
+    }
+    if (value > MAX_SAFE_U64) {
+        throw new RangeError(`${fieldName} (${value}) exceeds Number.MAX_SAFE_INTEGER (${MAX_SAFE_U64}); refusing to silently lose precision`);
+    }
+    return Number(value);
+}
 /**
  * Checks if the current runtime environment is Bun.
  * This is useful for detecting Bun-specific compatibility issues.

package/dist/utils/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -3,5 +3,5 @@
  *
  * hardcoded for now, we would want to have it injected dynamically
  */
-export declare const VERSION = "7.0.0";
+export declare const VERSION = "7.1.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -5,5 +5,5 @@
  *
  * hardcoded for now, we would want to have it injected dynamically
  */
-export const VERSION = "7.0.0";
+export const VERSION = "7.1.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -92,7 +92,7 @@
   ],
   "dependencies": {
     "@aptos-labs/aptos-cli": "^3.0.0",
-    "@aptos-labs/aptos-client": "^4.0.0",
+    "@aptos-labs/aptos-client": "^4.1.0",
     "@noble/ciphers": "2.2.0",
     "@noble/curves": "2.2.0",
     "@noble/hashes": "2.2.0",
@@ -122,7 +122,7 @@
     "vite": "^7.3.2",
     "vitest": "^4.1.4"
   },
-  "version": "7.0.0",
+  "version": "7.1.0",
   "scripts": {
     "build:clean": "rm -rf dist",
     "build": "pnpm build:clean && tsc -p tsconfig.build.json",
@@ -133,6 +133,7 @@
     "check": "biome check",
     "test": "vitest run",
     "unit-test": "vitest run --config vitest.config.unit.ts",
+    "test:coverage:unit": "vitest run --coverage --config vitest.config.unit.ts",
     "e2e-test": "vitest run tests/e2e",
     "e2e-encrypted": "vitest run tests/e2e/transaction/encryptedTransaction.test.ts --config vitest.config.e2e-devnet.ts",
     "indexer-codegen": "graphql-codegen --config ./src/types/codegen.yaml && pnpm fmt",

package/src/account/AbstractKeylessAccount.ts

@@ -347,6 +347,9 @@ export abstract class AbstractKeylessAccount extends Serializable implements Key
         type: KeylessErrorType.ASYNC_PROOF_FETCH_FAILED,
       });
     }
+    // SECURITY: jwtDecode does NOT verify the JWT signature; we only read the
+    // `kid` header to compare against the verification key hash. JWT signature
+    // verification is performed on-chain by the keyless verifier.
     const header = jwtDecode(this.jwt, { header: true });
     if (header.kid === undefined) {
       throw KeylessError.fromErrorType({

package/src/account/EphemeralKeyPair.ts

@@ -10,7 +10,7 @@ import { PrivateKey } from "../core/crypto/privateKey.js";
 import { Hex } from "../core/hex.js";
 import { EphemeralPublicKeyVariant, HexInput } from "../types/index.js";
 import { Deserializer, Serializable, Serializer } from "../bcs/index.js";
-import { floorToWholeHour, nowInSeconds } from "../utils/helpers.js";
+import { floorToWholeHour, nowInSeconds, u64ToNumberSafe } from "../utils/helpers.js";
 
 const TWO_WEEKS_IN_SECONDS = 1_209_600;
 
@@ -42,8 +42,20 @@ export class EphemeralKeyPair extends Serializable {
   readonly expiryDateSecs: number;
 
   /**
-   * The value passed to the IdP when the user authenticates.  It consists of a hash of the
-   * ephemeral public key, expiry date, and blinder.
+   * The value passed to the IdP when the user authenticates. It consists of a
+   * hash of the ephemeral public key, expiry date, and blinder.
+   *
+   * SECURITY: This value is NOT secret. It is sent to the IdP in the OIDC
+   * redirect URL, embedded in the returned JWT, and packed into the proof
+   * inputs sent to the prover service. The `clear()` lifecycle hook does
+   * NOT zero this field — it is an immutable JS string and JavaScript
+   * provides no API to overwrite string memory. A memory-read attacker who
+   * dumps the process after `clear()` could correlate the surviving `nonce`
+   * against IdP logs or on-chain activity. This is acceptable given that
+   * the nonce was always public to begin with; it just means the privacy
+   * benefit of `clear()` does not extend to unlinking the (already public)
+   * nonce from any later forensic snapshot.
+   *
    * @group Implementation
    * @category Account (On-Chain Model)
    */
@@ -122,11 +134,22 @@ export class EphemeralKeyPair extends Serializable {
   }
 
   /**
-   * Clears the ephemeral private key from memory by overwriting it with random bytes.
-   * After calling this method, the ephemeral key pair can no longer be used for signing.
+   * Overwrites the ephemeral private key and blinder byte buffers with random
+   * bytes and then zeros. After calling this method the key pair can no
+   * longer sign transactions.
+   *
+   * SECURITY: This is a best-effort window-narrowing tool, NOT a true
+   * zeroization guarantee. See `Ed25519PrivateKey.clear()` for the full
+   * enumeration of JavaScript-level limits (immutable string copies, noble
+   * `BigInt` intermediates, JIT register/stack residue, GC-relocated
+   * copies).
    *
-   * Note: Due to JavaScript's memory management, this cannot guarantee complete removal of
-   * sensitive data from memory, but it significantly reduces the window of exposure.
+   * SPECIFIC TO `EphemeralKeyPair`: the `nonce` field is NOT cleared by
+   * this method. It is the OIDC nonce — already public (it appears in the
+   * IdP redirect URL, the returned JWT, and the proof inputs) — and is
+   * stored as an immutable JS string that the language provides no API to
+   * overwrite. See the `nonce` field JSDoc for the narrow
+   * forensic-correlation consequence.
    *
    * @group Implementation
    * @category Account (On-Chain Model)
@@ -199,7 +222,11 @@ export class EphemeralKeyPair extends Serializable {
     }
     const expiryDateSecs = deserializer.deserializeU64();
     const blinder = deserializer.deserializeFixedBytes(31);
-    return new EphemeralKeyPair({ privateKey, expiryDateSecs: Number(expiryDateSecs), blinder });
+    return new EphemeralKeyPair({
+      privateKey,
+      expiryDateSecs: u64ToNumberSafe(expiryDateSecs, "EphemeralKeyPair.expiryDateSecs"),
+      blinder,
+    });
   }
 
   /**