@onekeyfe/hd-core 1.2.0-alpha.36 → 1.2.0-alpha.39

package/dist/index.js

@@ -8,9 +8,9 @@ var hdShared = require('@onekeyfe/hd-shared');
 var axios = require('axios');
 var lodash = require('lodash');
 var ByteBuffer = require('bytebuffer');
-var BigNumber = require('bignumber.js');
-var utils = require('@noble/hashes/utils');
 var blake2s = require('@noble/hashes/blake2s');
+var utils = require('@noble/hashes/utils');
+var BigNumber = require('bignumber.js');
 var sha256 = require('@noble/hashes/sha256');
 var JSZip = require('jszip');
 var sha3 = require('@noble/hashes/sha3');
@@ -146,6 +146,7 @@ const createCoreApi = (call) => ({
     deviceReboot: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'deviceReboot' })),
     deviceGetOnboardingStatus: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'deviceGetOnboardingStatus' })),
     deviceUploadWallpaper: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'deviceUploadWallpaper' })),
+    deviceUploadNft: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'deviceUploadNft' })),
     uploadPortfolio: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'uploadPortfolio' })),
     deviceRecovery: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'deviceRecovery' })),
     deviceReset: (connectId, params) => call(Object.assign(Object.assign({}, params), { connectId, method: 'deviceReset' })),
@@ -26271,6 +26272,7 @@ var nested = {
 			MessageType_DeviceSessionAskPin: 61202,
 			MessageType_DeviceSessionAskPassphrase: 61203,
 			MessageType_PortfolioUpdate: 61400,
+			MessageType_NftUpdate: 61500,
 			MessageType_OnboardingStatusGet: 61600,
 			MessageType_OnboardingStatus: 61601
 		},
@@ -38049,26 +38051,11 @@ var nested = {
 			DeviceSessionError_Busy: 5
 		}
 	},
-	DeviceSessionSeedDomain: {
-		values: {
-			SeedDomain_Standard: 1,
-			SeedDomain_Cardano: 2
-		}
-	},
 	DeviceSessionGet: {
 		fields: {
 			session_id: {
 				type: "bytes",
 				id: 1
-			},
-			btc_test_address: {
-				type: "string",
-				id: 2
-			},
-			seed_domains: {
-				rule: "repeated",
-				type: "DeviceSessionSeedDomain",
-				id: 3
 			}
 		}
 	},
@@ -38404,6 +38391,15 @@ var nested = {
 			}
 		}
 	},
+	NftUpdate: {
+		fields: {
+			file_name_no_ext: {
+				rule: "required",
+				type: "string",
+				id: 1
+			}
+		}
+	},
 	OnboardingStep: {
 		values: {
 			ONBOARDING_STEP_UNKNOWN: 0,
@@ -39982,6 +39978,7 @@ const LogBlockEvent = new Set([
 ]);
 const LogLabelMethod = new Set([
     'openWalletSession',
+    'deviceUploadNft',
     'deviceUploadWallpaper',
     'uploadPortfolio',
     'fileWrite',
@@ -40103,41 +40100,15 @@ function refreshProtocolV2DeviceStatus(device) {
         return device.updateProtocolV2Status(status);
     });
 }
-function ensureProtocolV2WalletSessionUnlocked(device) {
-    var _a, _b, _c;
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!device.isProtocolV2() || ((_a = device.isBootloader) === null || _a === void 0 ? void 0 : _a.call(device)) || ((_b = device.isRomloader) === null || _b === void 0 ? void 0 : _b.call(device))) {
-            return false;
-        }
-        yield refreshProtocolV2DeviceStatus(device);
-        if (((_c = device.state) === null || _c === void 0 ? void 0 : _c.status.unlocked) !== false) {
-            return false;
-        }
-        yield device.unlockDevice(hdTransport.DeviceSessionPinType.Main, {
-            source: 'unlock-coordinator',
-            reason: 'device-locked',
-            deviceOnly: true,
-        });
-        return true;
-    });
-}
 const negotiateEventlessWalletSession = (device) => __awaiter(void 0, void 0, void 0, function* () {
     yield device.ensureProtocolV2RuntimeContext();
 });
-const getDeviceSession = (device, request, deriveCardano) => __awaiter(void 0, void 0, void 0, function* () {
-    const payload = deriveCardano === undefined
-        ? request
-        : Object.assign(Object.assign({}, request), { seed_domains: [
-                hdTransport.DeviceSessionSeedDomain.SeedDomain_Standard,
-                ...(deriveCardano ? [hdTransport.DeviceSessionSeedDomain.SeedDomain_Cardano] : []),
-            ] });
-    return device.commands.typedCall('DeviceSessionGet', 'DeviceSession', payload);
-});
+const getDeviceSession = (device, request) => __awaiter(void 0, void 0, void 0, function* () { return device.commands.typedCall('DeviceSessionGet', 'DeviceSession', request); });
 const askDevicePassphrase = (device, requestPayload) => __awaiter(void 0, void 0, void 0, function* () {
     yield device.commands.typedCall('DeviceSessionAskPassphrase', 'Success', requestPayload);
     yield refreshProtocolV2DeviceStatus(device);
 });
-const selectDeviceSession = (device, expectedPassphraseState, deriveCardano) => __awaiter(void 0, void 0, void 0, function* () {
+const selectDeviceSession = (device, expectedPassphraseState) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b, _c;
     const existsAttachPinUser = ((_a = device.features) === null || _a === void 0 ? void 0 : _a.attachToPinEnabled) === true;
     const metadata = Object.assign({ source: 'wallet-session-coordinator', reason: expectedPassphraseState ? 'session-recovery' : 'open-wallet' }, (expectedPassphraseState ? { expectedPassphraseState } : {}));
@@ -40170,18 +40141,18 @@ const selectDeviceSession = (device, expectedPassphraseState, deriveCardano) =>
             emitUiEvent: false,
             interaction: attachPinInteraction,
         });
-        return getDeviceSession(device, {}, deriveCardano);
+        return getDeviceSession(device, {});
     }
     if (hasHostPassphrase) {
         yield askDevicePassphrase(device, {
             passphrase: hostPassphrase,
             on_device: false,
         });
-        return getDeviceSession(device, {}, deriveCardano);
+        return getDeviceSession(device, {});
     }
     device.emit(DEVICE.PASSPHRASE_ON_DEVICE, device, Object.assign(Object.assign({}, metadata), (passphraseInteraction ? { interaction: passphraseInteraction } : {})));
     yield askDevicePassphrase(device, { on_device: true });
-    return getDeviceSession(device, {}, deriveCardano);
+    return getDeviceSession(device, {});
 });
 function getProtocolV2WalletSession(device, options) {
     var _a, _b, _c, _d, _e, _f, _g;
@@ -40253,8 +40224,7 @@ function getProtocolV2WalletSession(device, options) {
                     }
                     response = yield getDeviceSession(device, {
                         session_id: cachedStandardSession.sessionId,
-                        btc_test_address: cachedStandardSession.passphraseState,
-                    }, options === null || options === void 0 ? void 0 : options.deriveCardano);
+                    });
                     resumed = true;
                 }
                 catch (error) {
@@ -40267,15 +40237,14 @@ function getProtocolV2WalletSession(device, options) {
             }
             if (!response) {
                 yield selectMainWallet();
-                response = yield getDeviceSession(device, {}, options === null || options === void 0 ? void 0 : options.deriveCardano);
+                response = yield getDeviceSession(device, {});
             }
         }
         else if (cachedSessionId && expectedPassphraseState) {
             try {
                 response = yield getDeviceSession(device, {
                     session_id: cachedSessionId,
-                    btc_test_address: expectedPassphraseState,
-                }, options === null || options === void 0 ? void 0 : options.deriveCardano);
+                });
                 resumed = true;
             }
             catch (error) {
@@ -40288,7 +40257,7 @@ function getProtocolV2WalletSession(device, options) {
         }
         else if (expectedPassphraseState) {
             try {
-                response = yield getDeviceSession(device, { btc_test_address: expectedPassphraseState }, options === null || options === void 0 ? void 0 : options.deriveCardano);
+                response = yield getDeviceSession(device, {});
             }
             catch (error) {
                 if ((options === null || options === void 0 ? void 0 : options.resumeOnly) || !isWalletSessionInvalidError(error)) {
@@ -40301,7 +40270,7 @@ function getProtocolV2WalletSession(device, options) {
                 device.clearInternalState();
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.WalletSessionInvalid);
             }
-            response = yield selectDeviceSession(device, expectedPassphraseState, options === null || options === void 0 ? void 0 : options.deriveCardano);
+            response = yield selectDeviceSession(device, expectedPassphraseState);
         }
         let { message } = response;
         try {
@@ -40326,11 +40295,11 @@ function getProtocolV2WalletSession(device, options) {
             if (options === null || options === void 0 ? void 0 : options.onlyMainPin) {
                 (_f = device.clearStandardInternalState) === null || _f === void 0 ? void 0 : _f.call(device);
                 yield selectMainWallet(true);
-                response = yield getDeviceSession(device, {}, options === null || options === void 0 ? void 0 : options.deriveCardano);
+                response = yield getDeviceSession(device, {});
             }
             else {
                 device.clearInternalState();
-                response = yield selectDeviceSession(device, expectedPassphraseState, options === null || options === void 0 ? void 0 : options.deriveCardano);
+                response = yield selectDeviceSession(device, expectedPassphraseState);
             }
             message = response.message;
             try {
@@ -40372,15 +40341,6 @@ function getProtocolV2WalletSession(device, options) {
         };
     });
 }
-function restoreProtocolV2WalletSession(device, expectedPassphraseState, deriveCardano) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return getProtocolV2WalletSession(device, {
-            expectedPassphraseState,
-            resumeOnly: true,
-            deriveCardano,
-        });
-    });
-}
 
 const getSupportProtocolV1MessageSchema = (features) => {
     var _a;
@@ -40980,7 +40940,8 @@ function asBytes(rgba) {
 function align(value, boundary) {
     return Math.ceil(value / boundary) * boundary;
 }
-function encodePro2Wallpaper(options) {
+function encodePro2Image(options) {
+    var _a;
     const { width, height } = options;
     if (!Number.isInteger(width) || width <= 0 || width > 0xffff) {
         throw invalidParameter$2('Wallpaper width must be an integer between 1 and 65535.');
@@ -40993,11 +40954,14 @@ function encodePro2Wallpaper(options) {
     if (rgba.byteLength !== expectedLength) {
         throw invalidParameter$2(`Wallpaper RGBA data length must be ${expectedLength} bytes, received ${rgba.byteLength}.`);
     }
+    const alphaMode = (_a = options.alphaMode) !== null && _a !== void 0 ? _a : 'preserve';
     let hasTransparency = false;
-    for (let index = 3; index < rgba.length; index += 4) {
-        if (rgba[index] !== 0xff) {
-            hasTransparency = true;
-            break;
+    if (alphaMode === 'preserve') {
+        for (let index = 3; index < rgba.length; index += 4) {
+            if (rgba[index] !== 0xff) {
+                hasTransparency = true;
+                break;
+            }
         }
     }
     const colorFormat = hasTransparency ? 'RGB565A8' : 'RGB565';
@@ -41018,9 +40982,19 @@ function encodePro2Wallpaper(options) {
         for (let x = 0; x < width; x += 1) {
             const sourceOffset = (y * width + x) * 4;
             const thresholdIndex = ((y & 7) << 3) + (x & 7);
-            const red = Math.min(rgba[sourceOffset] + RED_THRESHOLD[thresholdIndex], 0xff) & 0xf8;
-            const green = Math.min(rgba[sourceOffset + 1] + GREEN_THRESHOLD[thresholdIndex], 0xff) & 0xfc;
-            const blue = Math.min(rgba[sourceOffset + 2] + BLUE_THRESHOLD[thresholdIndex], 0xff) & 0xf8;
+            const alpha = rgba[sourceOffset + 3];
+            const redChannel = alphaMode === 'black-background'
+                ? Math.round((rgba[sourceOffset] * alpha) / 0xff)
+                : rgba[sourceOffset];
+            const greenChannel = alphaMode === 'black-background'
+                ? Math.round((rgba[sourceOffset + 1] * alpha) / 0xff)
+                : rgba[sourceOffset + 1];
+            const blueChannel = alphaMode === 'black-background'
+                ? Math.round((rgba[sourceOffset + 2] * alpha) / 0xff)
+                : rgba[sourceOffset + 2];
+            const red = Math.min(redChannel + RED_THRESHOLD[thresholdIndex], 0xff) & 0xf8;
+            const green = Math.min(greenChannel + GREEN_THRESHOLD[thresholdIndex], 0xff) & 0xfc;
+            const blue = Math.min(blueChannel + BLUE_THRESHOLD[thresholdIndex], 0xff) & 0xf8;
             const rgb565 = ((red >> 3) << 11) | ((green >> 2) << 5) | (blue >> 3);
             const rgbOffset = 12 + y * stride + x * 2;
             data[rgbOffset] = rgb565 & 0xff;
@@ -41032,6 +41006,148 @@ function encodePro2Wallpaper(options) {
     }
     return { data, colorFormat };
 }
+function encodePro2Wallpaper(options) {
+    return encodePro2Image(options);
+}
+
+const invalidParameter$1 = (message) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodInvalidParameter, message);
+function validateNonEmptyString(value, name) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw invalidParameter$1(`Parameter [${name}] is required and must be a non-empty string.`);
+    }
+    return value;
+}
+const PROTOCOL_V2_FILESYSTEM_VOLUMES = new Set(['vol0', 'vol1']);
+const MAX_PROTOCOL_V2_FILESYSTEM_PATH_BYTES = 127;
+function getUtf8ByteLength$1(value) {
+    return Array.from(value).reduce((length, character) => {
+        var _a;
+        const codePoint = (_a = character.codePointAt(0)) !== null && _a !== void 0 ? _a : 0;
+        if (codePoint <= 0x7f)
+            return length + 1;
+        if (codePoint <= 0x7ff)
+            return length + 2;
+        if (codePoint <= 0xffff)
+            return length + 3;
+        return length + 4;
+    }, 0);
+}
+function validateProtocolV2FilesystemPath(value, name, options = {}) {
+    const rawPath = validateNonEmptyString(value, name).trim();
+    const containsUnsupportedCharacter = Array.from(rawPath).some(character => {
+        const codePoint = character.charCodeAt(0);
+        return codePoint <= 0x1f || codePoint === 0x7f || character === '\\';
+    });
+    if (containsUnsupportedCharacter) {
+        throw invalidParameter$1(`Parameter [${name}] contains unsupported path characters.`);
+    }
+    const match = /^([a-zA-Z0-9]+):(.*)$/.exec(rawPath);
+    if (!match) {
+        throw invalidParameter$1(`Parameter [${name}] must use a supported Protocol V2 filesystem volume.`);
+    }
+    const volume = match[1].toLowerCase();
+    if (!PROTOCOL_V2_FILESYSTEM_VOLUMES.has(volume)) {
+        throw invalidParameter$1(`Parameter [${name}] uses an unsupported filesystem volume.`);
+    }
+    const rawSuffix = match[2];
+    if (rawSuffix.length === 0) {
+        if (options.allowVolumeRoot)
+            return `${volume}:`;
+        throw invalidParameter$1(`Parameter [${name}] must identify a filesystem entry.`);
+    }
+    const suffix = rawSuffix.startsWith('/') ? rawSuffix : `/${rawSuffix}`;
+    const segments = suffix.slice(1).split('/');
+    if (segments.some(segment => segment.length === 0 || segment === '.' || segment === '..')) {
+        throw invalidParameter$1(`Parameter [${name}] contains an invalid path segment.`);
+    }
+    const canonicalPath = `${volume}:${rawSuffix.startsWith('/') ? '/' : ''}${segments.join('/')}`;
+    if (getUtf8ByteLength$1(canonicalPath) > MAX_PROTOCOL_V2_FILESYSTEM_PATH_BYTES) {
+        throw invalidParameter$1(`Parameter [${name}] exceeds the maximum filesystem path length.`);
+    }
+    return canonicalPath;
+}
+function validateNonNegativeInteger(value, name, defaultValue) {
+    if (value === undefined || value === null) {
+        if (defaultValue !== undefined)
+            return defaultValue;
+        throw invalidParameter$1(`Missing required parameter: ${name}`);
+    }
+    const numeric = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+    if (typeof numeric !== 'number' || !Number.isSafeInteger(numeric) || numeric < 0) {
+        throw invalidParameter$1(`Parameter [${name}] must be a non-negative integer.`);
+    }
+    return numeric;
+}
+function validateOptionalNonNegativeInteger(value, name) {
+    if (value === undefined || value === null)
+        return undefined;
+    return validateNonNegativeInteger(value, name);
+}
+function validateOptionalPercentage(value, name) {
+    const numeric = validateOptionalNonNegativeInteger(value, name);
+    if (numeric === undefined)
+        return undefined;
+    if (numeric > 100) {
+        throw invalidParameter$1(`Parameter [${name}] must be between 0 and 100.`);
+    }
+    return numeric;
+}
+function validateRequiredData(value, name) {
+    if (value === undefined || value === null) {
+        throw invalidParameter$1(`Missing required parameter: ${name}`);
+    }
+}
+
+const PRO2_NFT_IMAGE_WIDTH = 540;
+const PRO2_NFT_IMAGE_HEIGHT = 540;
+const PRO2_NFT_THUMBNAIL_WIDTH = 263;
+const PRO2_NFT_THUMBNAIL_HEIGHT = 263;
+const PRO2_NFT_DIRECTORY = 'vol1:/nft';
+const PRO2_NFT_DEFAULT_CHUNK_SIZE = 512;
+const PRO2_NFT_DEFAULT_PACE_MS = 20;
+const PRO2_NFT_DEFAULT_TIMEOUT_MS = 15000;
+const PRO2_NFT_MIN_CHUNK_SIZE = 64;
+const PRO2_NFT_MAX_CHUNK_SIZE = 2048;
+function utf8Length(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+function assertImage(name, image, expectedWidth, expectedHeight) {
+    if (image.width !== expectedWidth || image.height !== expectedHeight) {
+        throw invalidParameter$1(`Pro2 NFT ${name} dimensions must be ${expectedWidth}x${expectedHeight}.`);
+    }
+    if (!(image.rgba instanceof ArrayBuffer) && !ArrayBuffer.isView(image.rgba)) {
+        throw invalidParameter$1(`Parameter [${name}.rgba] must be an ArrayBuffer or Uint8Array.`);
+    }
+}
+function buildPro2NftBundle(options) {
+    const { image, thumbnail, title, subtitle, timestampMs } = options;
+    assertImage('image', image, PRO2_NFT_IMAGE_WIDTH, PRO2_NFT_IMAGE_HEIGHT);
+    assertImage('thumbnail', thumbnail, PRO2_NFT_THUMBNAIL_WIDTH, PRO2_NFT_THUMBNAIL_HEIGHT);
+    const titleLength = typeof title === 'string' ? utf8Length(title) : 0;
+    const subtitleLength = typeof subtitle === 'string' ? utf8Length(subtitle) : Number.POSITIVE_INFINITY;
+    if (titleLength < 1 || titleLength > 63) {
+        throw invalidParameter$1('Pro2 NFT title must contain 1 to 63 UTF-8 bytes.');
+    }
+    if (subtitleLength > 95) {
+        throw invalidParameter$1('Pro2 NFT subtitle must contain at most 95 UTF-8 bytes.');
+    }
+    if (!Number.isSafeInteger(timestampMs) || timestampMs <= 0) {
+        throw invalidParameter$1('Parameter [timestampMs] must be a positive safe integer.');
+    }
+    const encodedImage = encodePro2Image(Object.assign(Object.assign({}, image), { alphaMode: 'black-background' })).data;
+    const encodedThumbnail = encodePro2Image(Object.assign(Object.assign({}, thumbnail), { alphaMode: 'black-background' })).data;
+    const metadata = new TextEncoder().encode(JSON.stringify({ title, subtitle }));
+    if (metadata.byteLength === 0 || metadata.byteLength > 512) {
+        throw invalidParameter$1('Pro2 NFT metadata must contain 1 to 512 UTF-8 bytes.');
+    }
+    const hash8 = utils.bytesToHex(blake2s.blake2s(encodedImage)).slice(0, 8);
+    return {
+        basename: `nft-${hash8}-${timestampMs}`,
+        image: encodedImage,
+        thumbnail: encodedThumbnail,
+        metadata,
+    };
+}
 
 const getT1Data = () => ({
     default: {
@@ -41315,14 +41431,27 @@ const getHomeScreenDefaultList = (features) => {
     }
     return Object.keys(data);
 };
+const getNftSize = ({ deviceType, thumbnail, }) => {
+    var _a;
+    const sizes = {
+        touch: {
+            full: { width: 480, height: 800 },
+            thumbnail: { width: 238, height: 238 },
+        },
+        pro: {
+            full: { width: 480, height: 800 },
+            thumbnail: { width: 226, height: 226, radius: 40 },
+        },
+        pro2: {
+            full: { width: PRO2_NFT_IMAGE_WIDTH, height: PRO2_NFT_IMAGE_HEIGHT },
+            thumbnail: { width: PRO2_NFT_THUMBNAIL_WIDTH, height: PRO2_NFT_THUMBNAIL_HEIGHT },
+        },
+    };
+    return (_a = sizes[deviceType]) === null || _a === void 0 ? void 0 : _a[thumbnail ? 'thumbnail' : 'full'];
+};
 const getHomeScreenSize = ({ deviceType, homeScreenType, thumbnail, }) => {
     if (deviceType === hdShared.EDeviceType.Pro2) {
-        return thumbnail
-            ? undefined
-            : {
-                width: PRO2_WALLPAPER_WIDTH,
-                height: PRO2_WALLPAPER_HEIGHT,
-            };
+        return thumbnail ? undefined : { width: PRO2_WALLPAPER_WIDTH, height: PRO2_WALLPAPER_HEIGHT };
     }
     const sizes = {
         touch: {
@@ -44537,101 +44666,6 @@ const getBootloaderReleaseInfo = ({ features, willUpdateFirmwareVersion, firmwar
     };
 };
 
-const PROTOCOL_V2_RETRY_ON_LOCKED_METHODS = [
-    'cipherKeyValue',
-    'allNetworkGetAddress',
-    'allNetworkGetAddressByLoop',
-    'btcGetAddress',
-    'btcGetPublicKey',
-    'btcSignMessage',
-    'btcSignPsbt',
-    'btcSignTransaction',
-    'btcVerifyMessage',
-    'confluxGetAddress',
-    'confluxSignMessage',
-    'confluxSignTransaction',
-    'evmGetAddress',
-    'evmGetPublicKey',
-    'evmSignMessage',
-    'evmSignTransaction',
-    'evmSignTypedData',
-    'evmVerifyMessage',
-    'starcoinGetAddress',
-    'starcoinGetPublicKey',
-    'starcoinSignMessage',
-    'starcoinSignTransaction',
-    'starcoinVerifyMessage',
-    'nemGetAddress',
-    'nemSignTransaction',
-    'solGetAddress',
-    'solSignTransaction',
-    'solSignOffchainMessage',
-    'solSignMessage',
-    'stellarGetAddress',
-    'stellarSignTransaction',
-    'tronGetAddress',
-    'tronSignMessage',
-    'tronSignTransaction',
-    'nearGetAddress',
-    'nearSignTransaction',
-    'aptosGetAddress',
-    'aptosGetPublicKey',
-    'aptosSignTransaction',
-    'aptosSignMessage',
-    'aptosSignInMessage',
-    'algoGetAddress',
-    'algoSignTransaction',
-    'cosmosGetAddress',
-    'cosmosGetPublicKey',
-    'cosmosSignTransaction',
-    'xrpGetAddress',
-    'xrpSignTransaction',
-    'suiGetAddress',
-    'suiGetPublicKey',
-    'suiSignMessage',
-    'suiSignTransaction',
-    'cardanoGetAddress',
-    'cardanoGetPublicKey',
-    'cardanoSignTransaction',
-    'cardanoSignMessage',
-    'filecoinGetAddress',
-    'filecoinSignTransaction',
-    'polkadotGetAddress',
-    'polkadotSignTransaction',
-    'kaspaGetAddress',
-    'kaspaSignTransaction',
-    'nexaGetAddress',
-    'nexaSignTransaction',
-    'nostrGetPublicKey',
-    'nostrSignEvent',
-    'nostrEncryptMessage',
-    'nostrDecryptMessage',
-    'nostrSignSchnorr',
-    'lnurlAuth',
-    'nervosGetAddress',
-    'nervosSignTransaction',
-    'dnxGetAddress',
-    'dnxSignTransaction',
-    'tonGetAddress',
-    'tonSignMessage',
-    'tonSignProof',
-    'tonSignData',
-    'scdoGetAddress',
-    'scdoSignTransaction',
-    'scdoSignMessage',
-    'alephiumGetAddress',
-    'alephiumSignTransaction',
-    'alephiumSignMessage',
-    'benfenGetAddress',
-    'benfenGetPublicKey',
-    'benfenSignMessage',
-    'benfenSignTransaction',
-    'neoGetAddress',
-    'neoSignTransaction',
-];
-const retryOnLockedMethods = new Set(PROTOCOL_V2_RETRY_ON_LOCKED_METHODS);
-const getProtocolV2UnlockPolicy = (methodName) => retryOnLockedMethods.has(methodName) ? 'retry-on-locked' : 'none';
-
 const Log$d = getLogger(exports.LoggerNames.Method);
 const isEvmLedgerLegacyPathWithHighIndex = (path) => {
     let addressN;
@@ -44709,7 +44743,6 @@ class BaseMethod {
         this.useDevice = true;
         this.allowDeviceMode = [UI_REQUEST.NOT_INITIALIZE];
         this.requireDeviceMode = [];
-        this.unlockPolicy = getProtocolV2UnlockPolicy(this.name);
     }
     getVersionRange() {
         return {};
@@ -44847,7 +44880,7 @@ class TestInitializeDeviceDuration extends BaseMethod {
 }
 
 const PROTOCOL_V2_PING_MAX_MESSAGE_BYTES = 63;
-const getUtf8ByteLength$1 = (value) => Array.from(value).reduce((length, character) => {
+const getUtf8ByteLength = (value) => Array.from(value).reduce((length, character) => {
     var _a;
     const codePoint = (_a = character.codePointAt(0)) !== null && _a !== void 0 ? _a : 0;
     if (codePoint <= 0x7f)
@@ -44863,7 +44896,7 @@ function validateProtocolV2PingMessage(value) {
         throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodInvalidParameter, 'Protocol V2 Ping message must be a string.');
     }
     const message = value !== null && value !== void 0 ? value : '';
-    if (getUtf8ByteLength$1(message) > PROTOCOL_V2_PING_MAX_MESSAGE_BYTES) {
+    if (getUtf8ByteLength(message) > PROTOCOL_V2_PING_MAX_MESSAGE_BYTES) {
         throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodInvalidParameter, `Protocol V2 Ping message must not exceed ${PROTOCOL_V2_PING_MAX_MESSAGE_BYTES} UTF-8 bytes.`);
     }
     return message;
@@ -45183,37 +45216,37 @@ function parseChainId(chainId) {
     throw new Error(`Invalid chainId ${chainId}`);
 }
 
-const invalidParameter$1 = (message) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodInvalidParameter, message);
+const invalidParameter = (message) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodInvalidParameter, message);
 const invalidResponse = (message) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodError, message);
 const validateParams = (values, fields) => {
     fields.forEach(field => {
         const existsProp = Object.prototype.hasOwnProperty.call(values, field.name);
         if (!existsProp && field.required) {
-            throw invalidParameter$1(`Missing required parameter: ${field.name}`);
+            throw invalidParameter(`Missing required parameter: ${field.name}`);
         }
         const value = values[field.name];
         if (value && field.type) {
             switch (field.type) {
                 case 'array':
                     if (!Array.isArray(value)) {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
                     }
                     else if (!field.allowEmpty && value.length < 1) {
-                        throw invalidParameter$1(`Parameter "${field.name}" is empty.`);
+                        throw invalidParameter(`Parameter "${field.name}" is empty.`);
                     }
                     break;
                 case 'uint':
                     if (typeof value !== 'string' && typeof value !== 'number') {
-                        throw invalidParameter$1(`Parameter [${field.name}] has invalid type. "string|number" expected.`);
+                        throw invalidParameter(`Parameter [${field.name}] has invalid type. "string|number" expected.`);
                     }
                     if ((typeof value === 'number' && !Number.isSafeInteger(value)) ||
                         !/^(?:[1-9]\d*|\d)$/.test(value.toString().replace(/^-/, field.allowNegative ? '' : '-'))) {
-                        throw invalidParameter$1(`Parameter [${field.name}] has invalid value "${value}". Integer representation expected.`);
+                        throw invalidParameter(`Parameter [${field.name}] has invalid value "${value}". Integer representation expected.`);
                     }
                     break;
                 case 'bigNumber':
                     if (typeof value !== 'string') {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [string].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [string].`);
                     }
                     try {
                         const bn = new BigNumber__default["default"](value);
@@ -45222,12 +45255,12 @@ const validateParams = (values, fields) => {
                         }
                     }
                     catch (error) {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
                     }
                     break;
                 case 'buffer': {
                     if (typeof value === 'undefined' || value === null) {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [buffer].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [buffer].`);
                     }
                     const isNodeBuffer = typeof Buffer !== 'undefined' &&
                         typeof Buffer.isBuffer === 'function' &&
@@ -45240,18 +45273,18 @@ const validateParams = (values, fields) => {
                         typeof ArrayBuffer.isView === 'function' &&
                         ArrayBuffer.isView(value);
                     if (!isNodeBuffer && !isCustomBuffer && !isArrayBuffer && !isArrayBufferView) {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [buffer].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [buffer].`);
                     }
                     break;
                 }
                 case 'hexString':
                     if (typeof value !== 'string' || !isHexString(addHexPrefix(value))) {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
                     }
                     break;
                 default:
                     if (typeof value !== field.type) {
-                        throw invalidParameter$1(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
+                        throw invalidParameter(`Parameter [${field.name}] is of type invalid and should be [${field.type}].`);
                     }
                     break;
             }
@@ -45285,10 +45318,10 @@ function validateResult(result, nonNullableFields, options) {
 
 const requiredString = (value, name) => {
     if (value === undefined || value === null) {
-        throw invalidParameter$1(`Missing required parameter: ${name}`);
+        throw invalidParameter(`Missing required parameter: ${name}`);
     }
     if (typeof value !== 'string' || !value.trim()) {
-        throw invalidParameter$1(`Parameter [${name}] must be a non-empty string.`);
+        throw invalidParameter(`Parameter [${name}] must be a non-empty string.`);
     }
     return value.trim();
 };
@@ -45306,20 +45339,20 @@ const requireHiddenWalletResponse = (session) => {
 };
 const normalizeParams = (payload) => {
     if (payload.mode === undefined) {
-        throw invalidParameter$1('Parameter [mode] is required.');
+        throw invalidParameter('Parameter [mode] is required.');
     }
     if (payload.mode !== OpenWalletSessionMode.Standard &&
         payload.mode !== OpenWalletSessionMode.SelectHidden &&
         payload.mode !== OpenWalletSessionMode.ResumeHidden) {
-        throw invalidParameter$1('Parameter [mode] must be one of standard, select-hidden, or resume-hidden.');
+        throw invalidParameter('Parameter [mode] must be one of standard, select-hidden, or resume-hidden.');
     }
     if (payload.useEmptyPassphrase !== undefined || payload.initSession !== undefined) {
-        throw invalidParameter$1('Legacy parameters [useEmptyPassphrase] and [initSession] are not supported by openWalletSession.');
+        throw invalidParameter('Legacy parameters [useEmptyPassphrase] and [initSession] are not supported by openWalletSession.');
     }
     if (payload.mode === OpenWalletSessionMode.Standard ||
         payload.mode === OpenWalletSessionMode.SelectHidden) {
         if (payload.deviceId !== undefined || payload.passphraseState !== undefined) {
-            throw invalidParameter$1('Parameters [deviceId] and [passphraseState] are only allowed with mode [resume-hidden].');
+            throw invalidParameter('Parameters [deviceId] and [passphraseState] are only allowed with mode [resume-hidden].');
         }
         return { mode: payload.mode };
     }
@@ -45342,28 +45375,39 @@ class OpenWalletSession extends BaseMethod {
     run() {
         return __awaiter(this, void 0, void 0, function* () {
             const isProtocolV2 = this.device.isProtocolV2();
-            const state = yield this.device.getDeviceState({ refreshSections: ['status'] });
+            let state = yield this.device.getDeviceState({ refreshSections: ['status'] });
             let currentDeviceId = state.identity.deviceId;
+            const hasAuthoritativeProtocolV2WalletStatus = (candidate) => candidate.status.unlocked === true &&
+                typeof candidate.status.passphraseProtection === 'boolean' &&
+                typeof candidate.status.unlockedAttachPin === 'boolean';
+            const requireAuthoritativeProtocolV2WalletStatus = (candidate) => {
+                if (!hasAuthoritativeProtocolV2WalletStatus(candidate)) {
+                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceInitializeFailed);
+                }
+                return candidate;
+            };
             const requireDeviceId = () => {
                 if (!currentDeviceId) {
                     throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceInitializeFailed);
                 }
                 return currentDeviceId;
             };
-            const refreshProtocolV2DeviceId = () => __awaiter(this, void 0, void 0, function* () {
-                const refreshedState = yield this.device.getDeviceState({ refreshSections: ['status'] });
-                currentDeviceId = refreshedState.identity.deviceId;
-                return requireDeviceId();
+            const refreshProtocolV2DeviceState = () => __awaiter(this, void 0, void 0, function* () {
+                state = yield this.device.getDeviceState({ refreshSections: ['status'] });
+                currentDeviceId = state.identity.deviceId;
+                return state;
             });
-            const unlockProtocolV2IfLocked = () => __awaiter(this, void 0, void 0, function* () {
-                if (isProtocolV2 && state.status.unlocked === false) {
+            const ensureProtocolV2WalletStatus = () => __awaiter(this, void 0, void 0, function* () {
+                if (isProtocolV2 && !hasAuthoritativeProtocolV2WalletStatus(state)) {
                     yield this.device.unlockDevice(hdTransport.DeviceSessionPinType.Main, {
                         source: 'unlock-coordinator',
                         reason: 'device-locked',
                         deviceOnly: true,
                         method: 'openWalletSession',
                     });
+                    requireAuthoritativeProtocolV2WalletStatus(yield refreshProtocolV2DeviceState());
                 }
+                return state;
             });
             const protocol = isProtocolV2 ? 'V2' : 'V1';
             if (this.params.mode === OpenWalletSessionMode.Standard) {
@@ -45372,14 +45416,19 @@ class OpenWalletSession extends BaseMethod {
                     ? yield getProtocolV2WalletSession(this.device, {
                         onlyMainPin: true,
                         deriveCardano: this.payload.deriveCardano,
-                        selectMainWalletBeforeRestore: state.status.unlocked === false || state.status.unlockedAttachPin === true,
+                        selectMainWalletBeforeRestore: !hasAuthoritativeProtocolV2WalletStatus(state) ||
+                            state.status.unlockedAttachPin === true,
                     })
                     : yield getPassphraseStateWithRefreshDeviceInfo(this.device, {
                         onlyMainPin: true,
                         initSession: this.payload.initSession,
                     });
-                const deviceId = isProtocolV2 ? yield refreshProtocolV2DeviceId() : requireDeviceId();
-                if (session.unlockedAttachPin) {
+                const refreshedState = isProtocolV2
+                    ? requireAuthoritativeProtocolV2WalletStatus(yield refreshProtocolV2DeviceState())
+                    : state;
+                const deviceId = requireDeviceId();
+                if (session.unlockedAttachPin ||
+                    (isProtocolV2 && refreshedState.status.unlockedAttachPin === true)) {
                     try {
                         yield this.device.lockDevice();
                     }
@@ -45398,8 +45447,8 @@ class OpenWalletSession extends BaseMethod {
             }
             if (this.params.mode === OpenWalletSessionMode.ResumeHidden) {
                 if (isProtocolV2) {
-                    yield unlockProtocolV2IfLocked();
-                    const refreshedDeviceId = yield refreshProtocolV2DeviceId();
+                    yield ensureProtocolV2WalletStatus();
+                    const refreshedDeviceId = requireDeviceId();
                     if (refreshedDeviceId !== this.params.deviceId) {
                         deviceWalletSessionStore.delete(this.params.deviceId, this.params.passphraseState);
                         throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckDeviceIdError);
@@ -45435,15 +45484,18 @@ class OpenWalletSession extends BaseMethod {
                 return Object.assign(Object.assign({ protocol, walletType: 'hidden', deviceId }, requireHiddenWalletResponse(session)), { resumed: wasResumed(session) || (!isProtocolV2 && session.newSession === cachedSessionId) });
             }
             this.device.passphraseState = undefined;
-            yield unlockProtocolV2IfLocked();
+            yield ensureProtocolV2WalletStatus();
             const session = isProtocolV2
                 ? yield getProtocolV2WalletSession(this.device, {
                     forceWalletSelection: true,
                     deriveCardano: this.payload.deriveCardano,
                 })
                 : yield getPassphraseStateWithRefreshDeviceInfo(this.device, { initSession: true });
-            const deviceId = isProtocolV2 ? yield refreshProtocolV2DeviceId() : requireDeviceId();
-            if (isProtocolV2 && this.device.getCurrentPassphraseProtection() !== true) {
+            const refreshedState = isProtocolV2
+                ? requireAuthoritativeProtocolV2WalletStatus(yield refreshProtocolV2DeviceState())
+                : state;
+            const deviceId = requireDeviceId();
+            if (isProtocolV2 && refreshedState.status.passphraseProtection !== true) {
                 this.device.clearInternalState();
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotOpenedPassphrase);
             }
@@ -45487,7 +45539,7 @@ class GetLogs extends BaseMethod {
 class ClearSessionCache extends BaseMethod {
     init() {
         if (this.payload.passphraseState !== undefined && !this.payload.deviceId) {
-            throw invalidParameter$1('Parameter [deviceId] is required with [passphraseState].');
+            throw invalidParameter('Parameter [deviceId] is required with [passphraseState].');
         }
         this.useDevice = false;
         this.useDevicePassphraseState = false;
@@ -45977,94 +46029,6 @@ class DeviceBackup extends BaseMethod {
     }
 }
 
-const invalidParameter = (message) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.CallMethodInvalidParameter, message);
-function validateNonEmptyString(value, name) {
-    if (typeof value !== 'string' || value.trim().length === 0) {
-        throw invalidParameter(`Parameter [${name}] is required and must be a non-empty string.`);
-    }
-    return value;
-}
-const PROTOCOL_V2_FILESYSTEM_VOLUMES = new Set(['vol0', 'vol1']);
-const MAX_PROTOCOL_V2_FILESYSTEM_PATH_BYTES = 127;
-function getUtf8ByteLength(value) {
-    return Array.from(value).reduce((length, character) => {
-        var _a;
-        const codePoint = (_a = character.codePointAt(0)) !== null && _a !== void 0 ? _a : 0;
-        if (codePoint <= 0x7f)
-            return length + 1;
-        if (codePoint <= 0x7ff)
-            return length + 2;
-        if (codePoint <= 0xffff)
-            return length + 3;
-        return length + 4;
-    }, 0);
-}
-function validateProtocolV2FilesystemPath(value, name, options = {}) {
-    const rawPath = validateNonEmptyString(value, name).trim();
-    const containsUnsupportedCharacter = Array.from(rawPath).some(character => {
-        const codePoint = character.charCodeAt(0);
-        return codePoint <= 0x1f || codePoint === 0x7f || character === '\\';
-    });
-    if (containsUnsupportedCharacter) {
-        throw invalidParameter(`Parameter [${name}] contains unsupported path characters.`);
-    }
-    const match = /^([a-zA-Z0-9]+):(.*)$/.exec(rawPath);
-    if (!match) {
-        throw invalidParameter(`Parameter [${name}] must use a supported Protocol V2 filesystem volume.`);
-    }
-    const volume = match[1].toLowerCase();
-    if (!PROTOCOL_V2_FILESYSTEM_VOLUMES.has(volume)) {
-        throw invalidParameter(`Parameter [${name}] uses an unsupported filesystem volume.`);
-    }
-    const rawSuffix = match[2];
-    if (rawSuffix.length === 0) {
-        if (options.allowVolumeRoot)
-            return `${volume}:`;
-        throw invalidParameter(`Parameter [${name}] must identify a filesystem entry.`);
-    }
-    const suffix = rawSuffix.startsWith('/') ? rawSuffix : `/${rawSuffix}`;
-    const segments = suffix.slice(1).split('/');
-    if (segments.some(segment => segment.length === 0 || segment === '.' || segment === '..')) {
-        throw invalidParameter(`Parameter [${name}] contains an invalid path segment.`);
-    }
-    const canonicalPath = `${volume}:${rawSuffix.startsWith('/') ? '/' : ''}${segments.join('/')}`;
-    if (getUtf8ByteLength(canonicalPath) > MAX_PROTOCOL_V2_FILESYSTEM_PATH_BYTES) {
-        throw invalidParameter(`Parameter [${name}] exceeds the maximum filesystem path length.`);
-    }
-    return canonicalPath;
-}
-function validateNonNegativeInteger(value, name, defaultValue) {
-    if (value === undefined || value === null) {
-        if (defaultValue !== undefined)
-            return defaultValue;
-        throw invalidParameter(`Missing required parameter: ${name}`);
-    }
-    const numeric = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
-    if (typeof numeric !== 'number' || !Number.isSafeInteger(numeric) || numeric < 0) {
-        throw invalidParameter(`Parameter [${name}] must be a non-negative integer.`);
-    }
-    return numeric;
-}
-function validateOptionalNonNegativeInteger(value, name) {
-    if (value === undefined || value === null)
-        return undefined;
-    return validateNonNegativeInteger(value, name);
-}
-function validateOptionalPercentage(value, name) {
-    const numeric = validateOptionalNonNegativeInteger(value, name);
-    if (numeric === undefined)
-        return undefined;
-    if (numeric > 100) {
-        throw invalidParameter(`Parameter [${name}] must be between 0 and 100.`);
-    }
-    return numeric;
-}
-function validateRequiredData(value, name) {
-    if (value === undefined || value === null) {
-        throw invalidParameter(`Missing required parameter: ${name}`);
-    }
-}
-
 class DeviceChangePin extends BaseMethod {
     getSupportedProtocols() {
         return ['V1', 'V2'];
@@ -46089,7 +46053,7 @@ class DeviceChangePin extends BaseMethod {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.device.isProtocolV2()) {
                 if (this.params.remove) {
-                    throw invalidParameter('Parameter [remove=true] is not supported by the Pro2 device PIN page.');
+                    throw invalidParameter$1('Parameter [remove=true] is not supported by the Pro2 device PIN page.');
                 }
                 const res = yield this.device.commands.typedCall('DeviceSettingsPageShow', 'Success', {
                     page: hdTransport.DeviceSettingsPage.DevicePinChange,
@@ -46298,7 +46262,7 @@ const getProtocolV2SettingsBehavior = (operation) => {
 const assertSettingsSupported = (payload, unsupported, protocol) => {
     const provided = unsupported.filter(key => payload[key] !== undefined);
     if (provided.length > 0) {
-        throw invalidParameter(`${protocol} does not support settings: ${provided.join(', ')}.`);
+        throw invalidParameter$1(`${protocol} does not support settings: ${provided.join(', ')}.`);
     }
 };
 const assertProtocolV2SettingValues = (payload, capabilities) => {
@@ -46306,7 +46270,7 @@ const assertProtocolV2SettingValues = (payload, capabilities) => {
     if (payload.brightness !== undefined &&
         brightnessRange &&
         (payload.brightness < brightnessRange.min || payload.brightness > brightnessRange.max)) {
-        throw invalidParameter(`Protocol V2 brightness must be between ${brightnessRange.min} and ${brightnessRange.max}.`);
+        throw invalidParameter$1(`Protocol V2 brightness must be between ${brightnessRange.min} and ${brightnessRange.max}.`);
     }
     const delayFields = [
         ['autoLockDelayMs', capabilities.autoLockDelayOptions],
@@ -46315,7 +46279,7 @@ const assertProtocolV2SettingValues = (payload, capabilities) => {
     delayFields.forEach(([field, options]) => {
         const value = payload[field];
         if (value !== undefined && !options.some(option => option.valueMs === value)) {
-            throw invalidParameter(`Protocol V2 ${field} must be one of: ${options.map(option => option.valueMs).join(', ')}.`);
+            throw invalidParameter$1(`Protocol V2 ${field} must be one of: ${options.map(option => option.valueMs).join(', ')}.`);
         }
     });
 };
@@ -46403,10 +46367,10 @@ class DeviceSettings extends BaseMethod {
                     const hasPassphrasePage = requestedPassphrase !== undefined;
                     const hasAirgapPage = requestedAirgap !== undefined;
                     if (hasPassphrasePage && hasAirgapPage) {
-                        throw invalidParameter('Protocol V2 passphrase and air-gap settings must be changed in separate calls.');
+                        throw invalidParameter$1('Protocol V2 passphrase and air-gap settings must be changed in separate calls.');
                     }
                     if ((hasPassphrasePage || hasAirgapPage) && Object.keys(settings).length > 0) {
-                        throw invalidParameter('Protocol V2 on-device settings must not be combined with direct settings.');
+                        throw invalidParameter$1('Protocol V2 on-device settings must not be combined with direct settings.');
                     }
                     if (requestedPassphrase !== undefined) {
                         const current = yield this.device.getDeviceState({ refreshSections: ['status'] });
@@ -46441,7 +46405,7 @@ class DeviceSettings extends BaseMethod {
                         return res.message;
                     }
                     if (Object.keys(settings).length === 0) {
-                        throw invalidParameter('No Protocol V2 compatible setting provided.');
+                        throw invalidParameter$1('No Protocol V2 compatible setting provided.');
                     }
                     const res = yield this.device.commands.typedCall('DeviceSettingsSet', 'Success', {
                         settings,
@@ -46453,7 +46417,7 @@ class DeviceSettings extends BaseMethod {
                 const capabilities = getDeviceSettingsCapabilities(this.device.getCurrentDeviceType(), 'V1');
                 if (this.payload.safetyChecks !== undefined &&
                     !capabilities.safetyCheckOptions.some(option => option.value === this.payload.safetyChecks)) {
-                    throw invalidParameter(`Protocol V1 safetyChecks must be one of: ${capabilities.safetyCheckOptions
+                    throw invalidParameter$1(`Protocol V1 safetyChecks must be one of: ${capabilities.safetyCheckOptions
                         .map(option => option.value)
                         .join(', ')}.`);
                 }
@@ -47228,35 +47192,6 @@ class DeviceFullyUploadResource extends BaseMethod {
     }
 }
 
-const DEFAULT_FIRMWARE_PROGRESS_INTERVAL_MS = 250;
-const createFirmwareProgressThrottle = (intervalMs = DEFAULT_FIRMWARE_PROGRESS_INTERVAL_MS) => {
-    const stateByType = new Map();
-    return (progress, progressType) => {
-        if (progressType !== 'transferData') {
-            return true;
-        }
-        const normalizedProgress = Math.max(0, Math.min(100, Math.floor(progress)));
-        if (normalizedProgress === 0 || normalizedProgress === 100) {
-            stateByType.set(progressType, {
-                lastEmittedAt: Date.now(),
-                lastProgress: normalizedProgress,
-            });
-            return true;
-        }
-        const now = Date.now();
-        const state = stateByType.get(progressType);
-        if (state &&
-            (state.lastProgress === normalizedProgress || now - state.lastEmittedAt < intervalMs)) {
-            return false;
-        }
-        stateByType.set(progressType, {
-            lastEmittedAt: now,
-            lastProgress: normalizedProgress,
-        });
-        return true;
-    };
-};
-
 const Log$9 = getLogger(exports.LoggerNames.Method);
 const SESSION_ERROR$1 = 'session not found';
 const FIRMWARE_UPDATE_CONFIRM = 'Firmware install confirmed';
@@ -47270,7 +47205,6 @@ class FirmwareUpdateBaseMethod extends BaseMethod {
     constructor() {
         super(...arguments);
         this.checkPromise = null;
-        this.shouldPostFirmwareProgress = createFirmwareProgressThrottle();
         this.postTipMessage = (message) => {
             this.postMessage(createUiMessage(UI_REQUEST.FIRMWARE_TIP, {
                 device: this.device.toMessageObject(),
@@ -47285,9 +47219,6 @@ class FirmwareUpdateBaseMethod extends BaseMethod {
             }));
         };
         this.postProgressMessage = (progress, progressType) => {
-            if (!this.shouldPostFirmwareProgress(progress, progressType)) {
-                return;
-            }
             this.postMessage(createUiMessage(UI_REQUEST.FIRMWARE_PROGRESS, {
                 device: this.device.toMessageObject(),
                 progress,
@@ -50118,14 +50049,15 @@ class DeviceGetOnboardingStatus extends BaseMethod {
 }
 
 const MIN_FILE_CHUNK_SIZE = 64;
-function isRetryableFileWriteTimeout(error) {
+function isProtocolV2ResponseTimeout(error) {
     var _a, _b;
     if (!error || typeof error !== 'object')
         return false;
     const candidate = error;
     const code = (_a = candidate.errorCode) !== null && _a !== void 0 ? _a : candidate.code;
     return (code === hdShared.HardwareErrorCode.BleTimeoutError ||
-        /Lowlevel response timeout/i.test((_b = candidate.message) !== null && _b !== void 0 ? _b : ''));
+        code === 'response-timeout' ||
+        /(?:BLE|Lowlevel|Protocol V2) response timeout/i.test((_b = candidate.message) !== null && _b !== void 0 ? _b : ''));
 }
 function getProtocolV2FileChunkLimit() {
     const env = DataManager.getSettings('env');
@@ -50212,7 +50144,7 @@ function writeProtocolV2File(options) {
                     isWritePending = false;
                 }
                 catch (error) {
-                    if (retryCount >= maxChunkRetries || !isRetryableFileWriteTimeout(error))
+                    if (retryCount >= maxChunkRetries || !isProtocolV2ResponseTimeout(error))
                         throw error;
                     retryCount += 1;
                     (_h = options.throwIfAborted) === null || _h === void 0 ? void 0 : _h.call(options);
@@ -50243,6 +50175,11 @@ function writeProtocolV2File(options) {
                 rateBytesPerSecond: elapsedMs > 0 ? Math.round((transferredBytes / elapsedMs) * 1000) : undefined,
                 elapsedMs,
             });
+            if (options.paceMs && options.paceMs > 0) {
+                yield new Promise(resolve => {
+                    setTimeout(resolve, options.paceMs);
+                });
+            }
         }
         return Object.assign(Object.assign({}, lastMessage), { path: options.path, offset: startOffset, total_size: totalSize, processed_byte: startOffset + written, chunks });
     });
@@ -50252,7 +50189,7 @@ const WALLPAPER_DIRECTORY = 'vol1:/wallpapers';
 const SAFE_FILE_NAME = /^[A-Za-z0-9_-]+(?:\.bin)?$/;
 function normalizeFileName(fileName, data) {
     if (fileName !== undefined && (!fileName || !SAFE_FILE_NAME.test(fileName))) {
-        throw invalidParameter('Parameter [fileName] may only contain letters, numbers, underscores, hyphens and an optional .bin suffix.');
+        throw invalidParameter$1('Parameter [fileName] may only contain letters, numbers, underscores, hyphens and an optional .bin suffix.');
     }
     const baseName = fileName !== null && fileName !== void 0 ? fileName : `wallpaper-${utils.bytesToHex(blake2s.blake2s(data)).slice(0, 12)}`;
     return baseName.endsWith('.bin') ? baseName : `${baseName}.bin`;
@@ -50270,13 +50207,13 @@ class DeviceUploadWallpaper extends BaseMethod {
     init() {
         const { width, height, rgba, fileName, chunkSize } = this.payload;
         if (width !== PRO2_WALLPAPER_WIDTH || height !== PRO2_WALLPAPER_HEIGHT) {
-            throw invalidParameter(`Pro2 wallpaper dimensions must be ${PRO2_WALLPAPER_WIDTH}x${PRO2_WALLPAPER_HEIGHT}.`);
+            throw invalidParameter$1(`Pro2 wallpaper dimensions must be ${PRO2_WALLPAPER_WIDTH}x${PRO2_WALLPAPER_HEIGHT}.`);
         }
         if (!(rgba instanceof ArrayBuffer) && !ArrayBuffer.isView(rgba)) {
-            throw invalidParameter('Parameter [rgba] must be an ArrayBuffer or Uint8Array.');
+            throw invalidParameter$1('Parameter [rgba] must be an ArrayBuffer or Uint8Array.');
         }
         if (chunkSize !== undefined && (!Number.isInteger(chunkSize) || chunkSize <= 0)) {
-            throw invalidParameter('Parameter [chunkSize] must be a positive integer.');
+            throw invalidParameter$1('Parameter [chunkSize] must be a positive integer.');
         }
         const rgbaBytes = rgba instanceof ArrayBuffer
             ? rgba
@@ -50311,7 +50248,7 @@ class DeviceUploadWallpaper extends BaseMethod {
                 return;
             const { encoded } = this;
             if (!encoded)
-                throw invalidParameter('Wallpaper data has not been initialized.');
+                throw invalidParameter$1('Wallpaper data has not been initialized.');
             yield writeProtocolV2File({
                 commands: this.device.commands,
                 path: this.path,
@@ -50336,7 +50273,7 @@ class DeviceUploadWallpaper extends BaseMethod {
         return __awaiter(this, void 0, void 0, function* () {
             const { encoded } = this;
             if (!encoded)
-                throw invalidParameter('Wallpaper data has not been initialized.');
+                throw invalidParameter$1('Wallpaper data has not been initialized.');
             yield this.ensureDirectory();
             yield this.upload();
             const response = yield this.device.commands.typedCall('DeviceSettingsSet', 'Success', {
@@ -50352,6 +50289,108 @@ class DeviceUploadWallpaper extends BaseMethod {
     }
 }
 
+const FILESYSTEM_FILE_WRITE_MESSAGE_TYPE = 60805;
+const NFT_UPDATE_MESSAGE_TYPE = 61500;
+class DeviceUploadNft extends BaseMethod {
+    getSupportedProtocols() {
+        return ['V2'];
+    }
+    init() {
+        const { image, thumbnail, title, subtitle, timestampMs = Date.now(), chunkSize = PRO2_NFT_DEFAULT_CHUNK_SIZE, paceMs = PRO2_NFT_DEFAULT_PACE_MS, timeoutMs = PRO2_NFT_DEFAULT_TIMEOUT_MS, } = this.payload;
+        if (!Number.isInteger(chunkSize) ||
+            chunkSize < PRO2_NFT_MIN_CHUNK_SIZE ||
+            chunkSize > PRO2_NFT_MAX_CHUNK_SIZE) {
+            throw invalidParameter$1(`Parameter [chunkSize] must be an integer between ${PRO2_NFT_MIN_CHUNK_SIZE} and ${PRO2_NFT_MAX_CHUNK_SIZE}.`);
+        }
+        if (!Number.isInteger(paceMs) || paceMs < 0) {
+            throw invalidParameter$1('Parameter [paceMs] must be a non-negative integer.');
+        }
+        if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
+            throw invalidParameter$1('Parameter [timeoutMs] must be a positive integer.');
+        }
+        this.bundle = buildPro2NftBundle({ image, thumbnail, title, subtitle, timestampMs });
+        this.params = { image, thumbnail, title, subtitle, timestampMs, chunkSize, paceMs, timeoutMs };
+        this.unlockPolicy = 'none';
+        this.skipForceUpdateCheck = true;
+        this.useDevicePassphraseState = false;
+    }
+    assertCapabilities() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const protocolInfo = yield this.device.ensureProtocolV2RuntimeContext();
+            const hasFileWrite = supportsProtocolV2Message(protocolInfo, FILESYSTEM_FILE_WRITE_MESSAGE_TYPE);
+            const hasNftUpdate = supportsProtocolV2Message(protocolInfo, NFT_UPDATE_MESSAGE_TYPE);
+            if (!hasFileWrite || !hasNftUpdate) {
+                throw hdShared.createDeviceNotSupportMethodError(this.name, this.device.getCurrentFirmwareType());
+            }
+        });
+    }
+    updateNft(basename) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = { file_name_no_ext: basename };
+            const options = { timeoutMs: this.params.timeoutMs };
+            try {
+                return yield this.device.commands.typedCall('NftUpdate', 'Success', params, options);
+            }
+            catch (error) {
+                if (!isProtocolV2ResponseTimeout(error)) {
+                    throw error;
+                }
+                this.throwIfAborted();
+                return this.device.commands.typedCall('NftUpdate', 'Success', params, options);
+            }
+        });
+    }
+    run() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const { bundle } = this;
+            if (!bundle)
+                throw invalidParameter$1('NFT data has not been initialized.');
+            yield this.assertCapabilities();
+            const files = [
+                { path: `${PRO2_NFT_DIRECTORY}/${bundle.basename}.bin`, data: bundle.image },
+                { path: `${PRO2_NFT_DIRECTORY}/${bundle.basename}_m.bin`, data: bundle.thumbnail },
+                { path: `${PRO2_NFT_DIRECTORY}/${bundle.basename}.json`, data: bundle.metadata },
+            ];
+            const totalSize = files.reduce((sum, file) => sum + file.data.byteLength, 0);
+            let transferredBeforeFile = 0;
+            for (const file of files) {
+                const transferredAtFileStart = transferredBeforeFile;
+                yield writeProtocolV2File({
+                    commands: this.device.commands,
+                    path: file.path,
+                    data: file.data,
+                    totalSize: file.data.byteLength,
+                    chunkSize: this.params.chunkSize,
+                    timeoutMs: this.params.timeoutMs,
+                    paceMs: this.params.paceMs,
+                    overwrite: true,
+                    append: false,
+                    throwIfAborted: () => this.throwIfAborted(),
+                    onProgress: progress => {
+                        if (typeof this.postMessage !== 'function')
+                            return;
+                        const transferredBytes = transferredAtFileStart + progress.transferredBytes;
+                        this.postMessage(createUiMessage(UI_REQUEST.DEVICE_PROGRESS, Object.assign(Object.assign({}, progress), { progress: Math.floor((transferredBytes / totalSize) * 100), transferredBytes, totalBytes: totalSize })));
+                    },
+                });
+                transferredBeforeFile += file.data.byteLength;
+            }
+            this.throwIfAborted();
+            const response = yield this.updateNft(bundle.basename);
+            return {
+                basename: bundle.basename,
+                imagePath: files[0].path,
+                thumbnailPath: files[1].path,
+                metadataPath: files[2].path,
+                totalSize,
+                nftUpdated: true,
+                message: (_a = response.message) === null || _a === void 0 ? void 0 : _a.message,
+            };
+        });
+    }
+}
+
 class FileWrite extends BaseMethod {
     getSupportedProtocols() {
         return ['V2'];
@@ -50476,13 +50515,6 @@ class CipherKeyValue extends BaseMethod {
     }
 }
 
-function isDeviceLockedError(error) {
-    return (typeof error === 'object' &&
-        error !== null &&
-        'errorCode' in error &&
-        error.errorCode === hdShared.HardwareErrorCode.DeviceLocked);
-}
-
 const isProtocolV2UiEnabled = (method) => method.protocolV2UiMode !== 'none';
 const getDisplayState = (value) => {
     const visited = new Set();
@@ -50607,93 +50639,51 @@ class ProtocolV2UiInteractionCoordinator {
 }
 
 const Log$3 = getLogger(exports.LoggerNames.Core);
-const restoreExpectedWalletSessionAfterUnlock = (method, device) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c;
-    const expectedPassphraseState = ((_a = method.payload) === null || _a === void 0 ? void 0 : _a.useEmptyPassphrase)
-        ? undefined
-        : (_c = (_b = method.payload) === null || _b === void 0 ? void 0 : _b.passphraseState) !== null && _c !== void 0 ? _c : device.passphraseState;
-    if (!method.useDevicePassphraseState ||
-        typeof expectedPassphraseState !== 'string' ||
-        expectedPassphraseState.length === 0) {
-        return;
-    }
-    yield restoreProtocolV2WalletSession(device, expectedPassphraseState);
-    Log$3.debug('Protocol V2 wallet session restored after unlock', { method: method.name });
+const createProtocolV2UnlockContext = () => ({
+    preflightCompleted: false,
 });
-function runMethodWithUnlockRetry(method, device, uiCoordinator) {
-    var _a, _b, _c, _d, _e;
+function runMethodWithUnlockPolicy(method, device, options = {}) {
+    var _a, _b;
     return __awaiter(this, void 0, void 0, function* () {
+        const { context = createProtocolV2UnlockContext(), uiCoordinator, afterStatusBeforeUnlock, prepare, run: configuredRun, } = options;
+        const run = configuredRun !== null && configuredRun !== void 0 ? configuredRun : (() => method.run());
+        method.protocolV2UnlockContext = context;
         const shouldEmitUi = isProtocolV2UiEnabled(method);
         const shouldCoordinateUi = shouldEmitUi && uiCoordinator !== undefined;
-        const isProtocolV2 = device.isProtocolV2();
-        const requiresFreshStatus = isProtocolV2 &&
-            method.unlockPolicy === 'unlock-before-run' &&
+        const requiresPreUnlock = device.isProtocolV2() &&
+            (method.useDevicePassphraseState || method.unlockPolicy === 'unlock-before-run') &&
             !((_a = device.isBootloader) === null || _a === void 0 ? void 0 : _a.call(device)) &&
             !((_b = device.isRomloader) === null || _b === void 0 ? void 0 : _b.call(device));
-        if (requiresFreshStatus) {
-            yield refreshProtocolV2DeviceStatus(device);
-        }
-        const shouldUnlockBeforeRun = isProtocolV2 &&
-            method.unlockPolicy !== 'none' &&
-            !((_c = device.isBootloader) === null || _c === void 0 ? void 0 : _c.call(device)) &&
-            !((_d = device.isRomloader) === null || _d === void 0 ? void 0 : _d.call(device)) &&
-            ((_e = device.features) === null || _e === void 0 ? void 0 : _e.unlocked) === false;
-        if (shouldUnlockBeforeRun) {
-            const unlockInteraction = shouldCoordinateUi
-                ? uiCoordinator === null || uiCoordinator === void 0 ? void 0 : uiCoordinator.enterUnlockInteraction(method.name)
-                : undefined;
-            yield device.unlockDevice(undefined, shouldCoordinateUi
-                ? { emitUiEvent: false, interaction: unlockInteraction }
-                : {
-                    source: 'unlock-coordinator',
-                    reason: 'device-locked',
-                    deviceOnly: true,
-                    method: method.name,
-                });
-            Log$3.debug('Protocol V2 pre-unlock completed', { method: method.name });
-            yield restoreExpectedWalletSessionAfterUnlock(method, device);
-            if (shouldCoordinateUi) {
-                uiCoordinator === null || uiCoordinator === void 0 ? void 0 : uiCoordinator.enterMethodInteraction(resolveProtocolV2UiInteraction(method));
+        if (requiresPreUnlock && !context.preflightCompleted) {
+            const status = yield refreshProtocolV2DeviceStatus(device);
+            if (typeof (status === null || status === void 0 ? void 0 : status.unlocked) !== 'boolean') {
+                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'Protocol V2 DeviceStatus did not report an explicit unlock state.');
+            }
+            yield (afterStatusBeforeUnlock === null || afterStatusBeforeUnlock === void 0 ? void 0 : afterStatusBeforeUnlock());
+            if (!status.unlocked) {
+                const unlockInteraction = shouldCoordinateUi
+                    ? uiCoordinator.enterUnlockInteraction(method.name)
+                    : undefined;
+                const unlockedStatus = yield device.unlockDevice(undefined, shouldCoordinateUi
+                    ? { emitUiEvent: false, interaction: unlockInteraction }
+                    : {
+                        source: 'unlock-coordinator',
+                        reason: 'device-locked',
+                        deviceOnly: true,
+                        method: method.name,
+                    });
+                if ((unlockedStatus === null || unlockedStatus === void 0 ? void 0 : unlockedStatus.unlocked) !== true) {
+                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'Protocol V2 device remained locked after the unlock flow.');
+                }
+                Log$3.debug('Protocol V2 pre-unlock completed', { method: method.name });
             }
-            return method.run();
+            context.preflightCompleted = true;
         }
+        yield (prepare === null || prepare === void 0 ? void 0 : prepare());
         if (shouldCoordinateUi) {
-            uiCoordinator === null || uiCoordinator === void 0 ? void 0 : uiCoordinator.enterMethodInteraction(resolveProtocolV2UiInteraction(method));
-        }
-        try {
-            return yield method.run();
-        }
-        catch (error) {
-            if (!isProtocolV2 || method.unlockPolicy !== 'retry-on-locked' || !isDeviceLockedError(error)) {
-                throw error;
-            }
-            Log$3.debug('Protocol V2 unlock retry triggered', { method: method.name });
-            const unlockInteraction = shouldCoordinateUi
-                ? uiCoordinator === null || uiCoordinator === void 0 ? void 0 : uiCoordinator.enterUnlockInteraction(method.name)
-                : undefined;
-            yield device.unlockDevice(undefined, shouldCoordinateUi
-                ? { emitUiEvent: false, interaction: unlockInteraction }
-                : {
-                    source: 'unlock-coordinator',
-                    reason: 'device-locked',
-                    deviceOnly: true,
-                    method: method.name,
-                });
-            Log$3.debug('Protocol V2 unlock completed', { method: method.name });
-            yield restoreExpectedWalletSessionAfterUnlock(method, device);
-            if (shouldCoordinateUi) {
-                uiCoordinator === null || uiCoordinator === void 0 ? void 0 : uiCoordinator.resumeMethodInteraction();
-            }
-            try {
-                const response = yield method.run();
-                Log$3.debug('Protocol V2 method retry completed', { method: method.name, success: true });
-                return response;
-            }
-            catch (retryError) {
-                Log$3.debug('Protocol V2 method retry completed', { method: method.name, success: false });
-                throw retryError;
-            }
+            uiCoordinator.enterMethodInteraction(resolveProtocolV2UiInteraction(method));
         }
+        return run();
     });
 }
 
@@ -50972,25 +50962,26 @@ class AllNetworkGetAddressBase extends BaseMethod {
                 this.device.on(DEVICE.PIN, onSignalAbort);
                 this.device.on(DEVICE.PASSPHRASE, onSignalAbort);
                 preCheckDeviceSupport(this.device, method);
-                if (this.temporarySafetyCheckPrompted) {
-                    method.temporarySafetyCheckPrompted = true;
-                }
-                else {
-                    const appliedTemporarySafetyCheck = yield method.checkSafetyLevelOnTestNet();
-                    if (appliedTemporarySafetyCheck) {
-                        this.temporarySafetyCheckPrompted = true;
-                    }
-                }
-                if (this.device.isProtocolV2() && this.payload.passphraseState) {
-                    yield ensureProtocolV2WalletSessionUnlocked(this.device);
-                    const passphraseStateSafety = yield this.device.checkPassphraseStateSafety(this.payload.passphraseState, false, this.payload.skipPassphraseCheck);
-                    if (!passphraseStateSafety) {
-                        throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckPassphraseStateError);
-                    }
-                }
-                const response = this.device.isProtocolV2()
-                    ? yield runMethodWithUnlockRetry(method, this.device)
-                    : yield method.run();
+                const response = yield runMethodWithUnlockPolicy(method, this.device, {
+                    context: this.protocolV2UnlockContext,
+                    prepare: () => __awaiter(this, void 0, void 0, function* () {
+                        if (this.temporarySafetyCheckPrompted) {
+                            method.temporarySafetyCheckPrompted = true;
+                        }
+                        else {
+                            const appliedTemporarySafetyCheck = yield method.checkSafetyLevelOnTestNet();
+                            if (appliedTemporarySafetyCheck) {
+                                this.temporarySafetyCheckPrompted = true;
+                            }
+                        }
+                        if (this.device.isProtocolV2() && this.payload.passphraseState) {
+                            const passphraseStateSafety = yield this.device.checkPassphraseStateSafety(this.payload.passphraseState, false, this.payload.skipPassphraseCheck);
+                            if (!passphraseStateSafety) {
+                                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckPassphraseStateError);
+                            }
+                        }
+                    }),
+                });
                 if (!Array.isArray(response) || response.length === 0) {
                     throw new Error('No response');
                 }
@@ -60235,6 +60226,7 @@ var ApiMethods = /*#__PURE__*/Object.freeze({
     deviceReboot: DeviceReboot,
     deviceGetOnboardingStatus: DeviceGetOnboardingStatus,
     deviceUploadWallpaper: DeviceUploadWallpaper,
+    deviceUploadNft: DeviceUploadNft,
     uploadPortfolio: UploadPortfolio,
     cipherKeyValue: CipherKeyValue,
     allNetworkGetAddress: AllNetworkGetAddress,
@@ -60619,6 +60611,44 @@ const getSynchronize = (mutex) => {
     return (action, lockId) => lock(lockId).then(unlock => Promise.resolve().then(action).finally(unlock));
 };
 
+const DEFAULT_UI_PROGRESS_INTERVAL_MS = 250;
+const normalizeProgress = (progress) => {
+    if (typeof progress !== 'number' || !Number.isFinite(progress)) {
+        return undefined;
+    }
+    return Math.max(0, Math.min(100, Math.floor(progress)));
+};
+const createUiProgressMessageFilter = (intervalMs = DEFAULT_UI_PROGRESS_INTERVAL_MS, now = Date.now) => {
+    const stateByType = new Map();
+    return (message) => {
+        if (!('event' in message) ||
+            message.event !== UI_EVENT ||
+            (message.type !== UI_REQUEST.DEVICE_PROGRESS && message.type !== UI_REQUEST.FIRMWARE_PROGRESS)) {
+            return true;
+        }
+        const key = message.type === UI_REQUEST.FIRMWARE_PROGRESS
+            ? `${message.type}:${message.payload.progressType}`
+            : message.type;
+        const progress = normalizeProgress(message.payload.progress);
+        const currentTime = now();
+        const state = stateByType.get(key);
+        if (!state) {
+            stateByType.set(key, { lastEmittedAt: currentTime, lastProgress: progress });
+            return true;
+        }
+        const isBoundary = progress === 0 || progress === 100;
+        if (isBoundary && progress === state.lastProgress) {
+            return false;
+        }
+        const startsNewPhase = progress !== undefined && state.lastProgress !== undefined && progress < state.lastProgress;
+        if (!isBoundary && !startsNewPhase && currentTime - state.lastEmittedAt < intervalMs) {
+            return false;
+        }
+        stateByType.set(key, { lastEmittedAt: currentTime, lastProgress: progress });
+        return true;
+    };
+};
+
 const Log = getLogger(exports.LoggerNames.Core);
 const PRE_INITIALIZE_TTL_MS = 60 * 1000;
 const preWarmInflight = new Map();
@@ -60684,7 +60714,12 @@ const callAPI = (context, message) => __awaiter(void 0, void 0, void 0, function
     try {
         method = findMethod(message);
         method.connector = _connector;
-        method.postMessage = postMessage;
+        const shouldPostMessage = createUiProgressMessageFilter();
+        method.postMessage = event => {
+            if (shouldPostMessage(event)) {
+                postMessage(event);
+            }
+        };
         (_a = method.setContext) === null || _a === void 0 ? void 0 : _a.call(method, context);
         method.requestContext = createRequestContext(method.responseID, method.name, {
             sdkInstanceId: context.sdkInstanceId,
@@ -60871,7 +60906,7 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
         }
         yield waitForPendingPromise(getPrePendingCallPromise, setPrePendingCallPromise);
         const inner = () => __awaiter(void 0, void 0, void 0, function* () {
-            var _j, _k, _l, _m, _o, _p, _q;
+            var _j, _k;
             method.assertProtocolSupported(device.getProtocol(), device.getCurrentFirmwareType());
             const versionRange = device.getCurrentMethodVersionRange(type => method.getVersionRange()[type]);
             const currentFirmwareVersion = (_j = device.getCurrentFirmwareVersionString()) !== null && _j !== void 0 ? _j : '0.0.0';
@@ -60940,48 +60975,60 @@ const onCallDevice = (context, message, method) => __awaiter(void 0, void 0, voi
                 }
                 return Promise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceUnexpectedMode, unexpectedMode));
             }
-            if (method.deviceId && method.checkDeviceId) {
-                const isSameDeviceID = yield checkLiveDeviceId(device, method.deviceId);
-                if (!isSameDeviceID) {
-                    return Promise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckDeviceIdError));
-                }
-            }
-            method.checkFirmwareRelease();
-            method.checkDeviceSupportFeature();
-            if (_deviceList && device.features && !device.isProtocolV2()) {
-                yield TransportManager.reconfigure(device.features);
-            }
-            checkPassphraseEnableState(method, device.features);
-            if (shouldCheckPassphraseState(method, device)) {
-                const support = device.supportNewPassphrase();
-                if (!support.support) {
-                    return Promise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotSupportPassphrase, `Device not support passphrase, please update to ${support.require}`, {
-                        require: support.require,
-                    }));
-                }
-                yield ensureProtocolV2WalletSessionUnlocked(device);
-                const passphraseStateSafety = yield device.checkPassphraseStateSafety((_l = method.payload) === null || _l === void 0 ? void 0 : _l.passphraseState, (_m = method.payload) === null || _m === void 0 ? void 0 : _m.useEmptyPassphrase, (_o = method.payload) === null || _o === void 0 ? void 0 : _o.skipPassphraseCheck, hasDeriveCardano(method));
-                checkPassphraseEnableState(method, device.features);
-                if (!passphraseStateSafety) {
-                    DevicePool.clearDeviceCache(method.payload.connectId);
-                    return Promise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckPassphraseStateError));
-                }
-                if (!device.isProtocolV2()) {
-                    postMessage(createUiMessage(UI_REQUEST.CLOSE_UI_PIN_WINDOW));
-                }
-            }
-            try {
-                yield method.checkSafetyLevelOnTestNet();
-            }
-            catch (e) {
-                const error = e instanceof hdShared.HardwareError
-                    ? e
-                    : hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'open safety check failed.');
-                throw error;
-            }
-            (_q = (_p = method.device) === null || _p === void 0 ? void 0 : _p.commands) === null || _q === void 0 ? void 0 : _q.checkDisposed();
             try {
-                const response = yield runMethodWithUnlockRetry(method, device, protocolV2UiCoordinator);
+                let deviceIdCheckedDuringUnlockPreflight = false;
+                const response = yield runMethodWithUnlockPolicy(method, device, {
+                    uiCoordinator: protocolV2UiCoordinator,
+                    afterStatusBeforeUnlock: () => {
+                        if (method.deviceId && method.checkDeviceId) {
+                            if (!device.checkDeviceId(method.deviceId)) {
+                                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckDeviceIdError);
+                            }
+                            deviceIdCheckedDuringUnlockPreflight = true;
+                        }
+                    },
+                    prepare: () => __awaiter(void 0, void 0, void 0, function* () {
+                        var _l, _m, _o, _p, _q;
+                        if (method.deviceId && method.checkDeviceId && !deviceIdCheckedDuringUnlockPreflight) {
+                            const isSameDeviceID = yield checkLiveDeviceId(device, method.deviceId);
+                            if (!isSameDeviceID) {
+                                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckDeviceIdError);
+                            }
+                        }
+                        method.checkFirmwareRelease();
+                        method.checkDeviceSupportFeature();
+                        if (_deviceList && device.features && !device.isProtocolV2()) {
+                            yield TransportManager.reconfigure(device.features);
+                        }
+                        checkPassphraseEnableState(method, device.features);
+                        if (shouldCheckPassphraseState(method, device)) {
+                            const support = device.supportNewPassphrase();
+                            if (!support.support) {
+                                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotSupportPassphrase, `Device not support passphrase, please update to ${support.require}`, {
+                                    require: support.require,
+                                });
+                            }
+                            const passphraseStateSafety = yield device.checkPassphraseStateSafety((_l = method.payload) === null || _l === void 0 ? void 0 : _l.passphraseState, (_m = method.payload) === null || _m === void 0 ? void 0 : _m.useEmptyPassphrase, (_o = method.payload) === null || _o === void 0 ? void 0 : _o.skipPassphraseCheck, hasDeriveCardano(method));
+                            checkPassphraseEnableState(method, device.features);
+                            if (!passphraseStateSafety) {
+                                DevicePool.clearDeviceCache(method.payload.connectId);
+                                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceCheckPassphraseStateError);
+                            }
+                            if (!device.isProtocolV2()) {
+                                postMessage(createUiMessage(UI_REQUEST.CLOSE_UI_PIN_WINDOW));
+                            }
+                        }
+                        try {
+                            yield method.checkSafetyLevelOnTestNet();
+                        }
+                        catch (e) {
+                            throw e instanceof hdShared.HardwareError
+                                ? e
+                                : hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'open safety check failed.');
+                        }
+                        (_q = (_p = method.device) === null || _p === void 0 ? void 0 : _p.commands) === null || _q === void 0 ? void 0 : _q.checkDisposed();
+                    }),
+                });
                 messageResponse = createResponseMessage(method.responseID, true, response);
                 requestQueue.resolveRequest(method.responseID, messageResponse);
                 completeMethodRequestContext(method);
@@ -61820,6 +61867,7 @@ exports.getLog = getLog;
 exports.getLogBlockLabel = getLogBlockLabel;
 exports.getLogger = getLogger;
 exports.getMethodVersionRange = getMethodVersionRange;
+exports.getNftSize = getNftSize;
 exports.getOutputScriptType = getOutputScriptType;
 exports.getSDKVersion = getSDKVersion;
 exports.getSafeLogPayload = getSafeLogPayload;