@pioneer-platform/pioneer-sdk 8.12.8 → 8.13.0

package/dist/index.cjs

@@ -1098,7 +1098,15 @@ async function createUnsignedEvmTx(caip, to, amount, memo, pubkeys, pioneer, pub
           amountWei = balance - gasFee - buffer;
           console.log(tag, "isMax calculation - balance:", balance.toString(), "gasFee:", gasFee.toString(), "buffer:", buffer.toString(), "amountWei:", amountWei.toString());
         } else {
-          amountWei = BigInt(Math.round(amount * 1000000000000000000));
+          const amountNum = typeof amount === "string" ? parseFloat(amount) : amount;
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(`Invalid amount for native gas transfer: "${amount}" (type: ${typeof amount}). ` + `Amount must be a valid positive number.`);
+          }
+          const amountCalculation = amountNum * 1000000000000000000;
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(`Invalid amount calculation for native gas transfer. ` + `Input: ${amountNum}`);
+          }
+          amountWei = BigInt(Math.round(amountCalculation));
           const totalNeeded = amountWei + gasFee;
           if (totalNeeded > balance) {
             const availableForSwap = balance > gasFee ? balance - gasFee : 0n;
@@ -1257,11 +1265,22 @@ async function createUnsignedEvmTx(caip, to, amount, memo, pubkeys, pioneer, pub
           const tokenBalance = BigInt(Math.round(tokenBalanceData.data * Number(tokenMultiplier)));
           amountWei = tokenBalance;
         } else {
-          amountWei = BigInt(Math.round(amount * Number(tokenMultiplier)));
+          const amountNum = typeof amount === "string" ? parseFloat(amount) : amount;
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(`Invalid amount for ERC20 transfer: "${amount}" (type: ${typeof amount}). ` + `Amount must be a valid positive number.`);
+          }
+          const amountCalculation = amountNum * Number(tokenMultiplier);
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(`Invalid amount calculation for ERC20 transfer. ` + `Input: ${amountNum}, Decimals: ${tokenDecimals}, Multiplier: ${tokenMultiplier}`);
+          }
+          amountWei = BigInt(Math.round(amountCalculation));
           console.log(tag, "Token amount calculation:", {
             inputAmount: amount,
+            inputType: typeof amount,
+            parsedAmount: amountNum,
             decimals: tokenDecimals,
-            multiplier: tokenMultiplier,
+            multiplier: tokenMultiplier.toString(),
+            calculation: amountCalculation,
             resultWei: amountWei.toString()
           });
         }
@@ -3423,6 +3442,9 @@ class SDK {
   isPioneer;
   keepkeyEndpoint;
   forceLocalhost;
+  viewOnlyMode;
+  skipDevicePairing;
+  skipKeeperEndpoint;
   getPubkeys;
   getBalances;
   blockchains;
@@ -3479,6 +3501,9 @@ class SDK {
     this.keepkeyEndpoint = null;
     this.forceLocalhost = config.forceLocalhost || false;
     this.paths = config.paths || [];
+    this.viewOnlyMode = config.viewOnlyMode || false;
+    this.skipDevicePairing = config.skipDevicePairing || config.viewOnlyMode || false;
+    this.skipKeeperEndpoint = config.skipKeeperEndpoint || config.viewOnlyMode || false;
     this.blockchains = config.blockchains ? [...new Set(config.blockchains)] : [];
     if (config.blockchains && config.blockchains.length !== this.blockchains.length) {
     }
@@ -3519,7 +3544,20 @@ class SDK {
       fallbackToRemote: true
     }) : null;
     this.pairWallet = async (options) => {
-      return Promise.resolve({});
+      const tag = TAG9 + " | pairWallet | ";
+      if (this.viewOnlyMode || this.skipDevicePairing) {
+        console.log(tag, "\uD83D\uDC41️ [VIEW-ONLY] Skipping device pairing");
+        return {
+          success: false,
+          reason: "view-only-mode",
+          message: "Device pairing skipped in view-only mode"
+        };
+      }
+      return Promise.resolve({
+        success: false,
+        reason: "not-implemented",
+        message: "Device pairing not yet implemented"
+      });
     };
     this.getPubkeyKey = (pubkey) => {
       return `${pubkey.pubkey}_${pubkey.pathMaster}`;
@@ -3565,6 +3603,15 @@ class SDK {
       this.pubkeys = [];
       this.pubkeySet.clear();
     }
+    this.isViewOnlyMode = () => {
+      return this.viewOnlyMode;
+    };
+    this.canSignTransactions = () => {
+      return !this.viewOnlyMode && !!this.keepKeySdk;
+    };
+    this.isVaultAvailable = () => {
+      return !!this.keepkeyEndpoint && this.keepkeyEndpoint.isAvailable;
+    };
     this.getUnifiedPortfolio = async function() {
       const tag = `${TAG9} | getUnifiedPortfolio | `;
       try {
@@ -3715,26 +3762,35 @@ class SDK {
           throw Error("Failed to init pioneer server!");
         this.paths.concat(import_pioneer_coins4.getPaths(this.blockchains));
         await this.getGasAssets();
-        this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
-        const keepkeyEndpoint = this.keepkeyEndpoint;
-        try {
-          const configKeepKey = {
-            apiKey: this.keepkeyApiKey || "keepkey-api-key",
-            pairingInfo: {
-              name: "KeepKey SDK Demo App",
-              imageUrl: "https://pioneers.dev/coins/keepkey.png",
-              basePath: keepkeyEndpoint.basePath,
-              url: keepkeyEndpoint.baseUrl
+        if (!this.skipKeeperEndpoint) {
+          this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
+          const keepkeyEndpoint = this.keepkeyEndpoint;
+          if (!this.skipDevicePairing) {
+            try {
+              const configKeepKey = {
+                apiKey: this.keepkeyApiKey || "keepkey-api-key",
+                pairingInfo: {
+                  name: "KeepKey SDK Demo App",
+                  imageUrl: "https://pioneers.dev/coins/keepkey.png",
+                  basePath: keepkeyEndpoint.basePath,
+                  url: keepkeyEndpoint.baseUrl
+                }
+              };
+              console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
+              const keepKeySdk = await import_keepkey_sdk.KeepKeySdk.create(configKeepKey);
+              const features = await keepKeySdk.system.info.getFeatures();
+              this.keepkeyApiKey = configKeepKey.apiKey;
+              this.keepKeySdk = keepKeySdk;
+              this.context = "keepkey:" + features.label + ".json";
+            } catch (e) {
+              console.error("⚠️ [INIT] KeepKey SDK initialization failed:", e);
             }
-          };
-          console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
-          const keepKeySdk = await import_keepkey_sdk.KeepKeySdk.create(configKeepKey);
-          const features = await keepKeySdk.system.info.getFeatures();
-          this.keepkeyApiKey = configKeepKey.apiKey;
-          this.keepKeySdk = keepKeySdk;
-          this.context = "keepkey:" + features.label + ".json";
-        } catch (e) {
-          console.error("⚠️ [INIT] KeepKey SDK initialization failed:", e);
+          } else {
+            console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping KeepKey SDK initialization");
+          }
+        } else {
+          console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping vault endpoint detection");
+          this.keepkeyEndpoint = null;
         }
         let configWss = {
           username: this.username,
@@ -4764,11 +4820,16 @@ class SDK {
           }
         }
         console.log(tag, `Calling batch GetCharts with ${pubkeysForBatch.length} pubkeys`);
-        const chartsResponse = await this.pioneer.GetCharts({
-          pubkeys: pubkeysForBatch
-        });
-        const newBalances = chartsResponse?.data?.balances || [];
-        console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        let newBalances = [];
+        try {
+          const chartsResponse = await this.pioneer.GetCharts({
+            pubkeys: pubkeysForBatch
+          });
+          newBalances = chartsResponse?.data?.balances || [];
+          console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        } catch (chartsError) {
+          console.warn(tag, `GetCharts API not available (${chartsError.message}), continuing without charts data`);
+        }
         const uniqueBalances = new Map([...this.balances, ...newBalances].map((balance) => [
           balance.identifier || `${balance.caip}:${balance.pubkey}`,
           {

package/dist/index.es.js

@@ -1274,7 +1274,15 @@ async function createUnsignedEvmTx(caip, to, amount, memo, pubkeys, pioneer, pub
           amountWei = balance - gasFee - buffer;
           console.log(tag, "isMax calculation - balance:", balance.toString(), "gasFee:", gasFee.toString(), "buffer:", buffer.toString(), "amountWei:", amountWei.toString());
         } else {
-          amountWei = BigInt(Math.round(amount * 1000000000000000000));
+          const amountNum = typeof amount === "string" ? parseFloat(amount) : amount;
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(`Invalid amount for native gas transfer: "${amount}" (type: ${typeof amount}). ` + `Amount must be a valid positive number.`);
+          }
+          const amountCalculation = amountNum * 1000000000000000000;
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(`Invalid amount calculation for native gas transfer. ` + `Input: ${amountNum}`);
+          }
+          amountWei = BigInt(Math.round(amountCalculation));
           const totalNeeded = amountWei + gasFee;
           if (totalNeeded > balance) {
             const availableForSwap = balance > gasFee ? balance - gasFee : 0n;
@@ -1433,11 +1441,22 @@ async function createUnsignedEvmTx(caip, to, amount, memo, pubkeys, pioneer, pub
           const tokenBalance = BigInt(Math.round(tokenBalanceData.data * Number(tokenMultiplier)));
           amountWei = tokenBalance;
         } else {
-          amountWei = BigInt(Math.round(amount * Number(tokenMultiplier)));
+          const amountNum = typeof amount === "string" ? parseFloat(amount) : amount;
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(`Invalid amount for ERC20 transfer: "${amount}" (type: ${typeof amount}). ` + `Amount must be a valid positive number.`);
+          }
+          const amountCalculation = amountNum * Number(tokenMultiplier);
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(`Invalid amount calculation for ERC20 transfer. ` + `Input: ${amountNum}, Decimals: ${tokenDecimals}, Multiplier: ${tokenMultiplier}`);
+          }
+          amountWei = BigInt(Math.round(amountCalculation));
           console.log(tag, "Token amount calculation:", {
             inputAmount: amount,
+            inputType: typeof amount,
+            parsedAmount: amountNum,
             decimals: tokenDecimals,
-            multiplier: tokenMultiplier,
+            multiplier: tokenMultiplier.toString(),
+            calculation: amountCalculation,
             resultWei: amountWei.toString()
           });
         }
@@ -3599,6 +3618,9 @@ class SDK {
   isPioneer;
   keepkeyEndpoint;
   forceLocalhost;
+  viewOnlyMode;
+  skipDevicePairing;
+  skipKeeperEndpoint;
   getPubkeys;
   getBalances;
   blockchains;
@@ -3655,6 +3677,9 @@ class SDK {
     this.keepkeyEndpoint = null;
     this.forceLocalhost = config.forceLocalhost || false;
     this.paths = config.paths || [];
+    this.viewOnlyMode = config.viewOnlyMode || false;
+    this.skipDevicePairing = config.skipDevicePairing || config.viewOnlyMode || false;
+    this.skipKeeperEndpoint = config.skipKeeperEndpoint || config.viewOnlyMode || false;
     this.blockchains = config.blockchains ? [...new Set(config.blockchains)] : [];
     if (config.blockchains && config.blockchains.length !== this.blockchains.length) {
     }
@@ -3695,7 +3720,20 @@ class SDK {
       fallbackToRemote: true
     }) : null;
     this.pairWallet = async (options) => {
-      return Promise.resolve({});
+      const tag = TAG9 + " | pairWallet | ";
+      if (this.viewOnlyMode || this.skipDevicePairing) {
+        console.log(tag, "\uD83D\uDC41️ [VIEW-ONLY] Skipping device pairing");
+        return {
+          success: false,
+          reason: "view-only-mode",
+          message: "Device pairing skipped in view-only mode"
+        };
+      }
+      return Promise.resolve({
+        success: false,
+        reason: "not-implemented",
+        message: "Device pairing not yet implemented"
+      });
     };
     this.getPubkeyKey = (pubkey) => {
       return `${pubkey.pubkey}_${pubkey.pathMaster}`;
@@ -3741,6 +3779,15 @@ class SDK {
       this.pubkeys = [];
       this.pubkeySet.clear();
     }
+    this.isViewOnlyMode = () => {
+      return this.viewOnlyMode;
+    };
+    this.canSignTransactions = () => {
+      return !this.viewOnlyMode && !!this.keepKeySdk;
+    };
+    this.isVaultAvailable = () => {
+      return !!this.keepkeyEndpoint && this.keepkeyEndpoint.isAvailable;
+    };
     this.getUnifiedPortfolio = async function() {
       const tag = `${TAG9} | getUnifiedPortfolio | `;
       try {
@@ -3891,26 +3938,35 @@ class SDK {
           throw Error("Failed to init pioneer server!");
         this.paths.concat(getPaths(this.blockchains));
         await this.getGasAssets();
-        this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
-        const keepkeyEndpoint = this.keepkeyEndpoint;
-        try {
-          const configKeepKey = {
-            apiKey: this.keepkeyApiKey || "keepkey-api-key",
-            pairingInfo: {
-              name: "KeepKey SDK Demo App",
-              imageUrl: "https://pioneers.dev/coins/keepkey.png",
-              basePath: keepkeyEndpoint.basePath,
-              url: keepkeyEndpoint.baseUrl
+        if (!this.skipKeeperEndpoint) {
+          this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
+          const keepkeyEndpoint = this.keepkeyEndpoint;
+          if (!this.skipDevicePairing) {
+            try {
+              const configKeepKey = {
+                apiKey: this.keepkeyApiKey || "keepkey-api-key",
+                pairingInfo: {
+                  name: "KeepKey SDK Demo App",
+                  imageUrl: "https://pioneers.dev/coins/keepkey.png",
+                  basePath: keepkeyEndpoint.basePath,
+                  url: keepkeyEndpoint.baseUrl
+                }
+              };
+              console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
+              const keepKeySdk = await KeepKeySdk.create(configKeepKey);
+              const features = await keepKeySdk.system.info.getFeatures();
+              this.keepkeyApiKey = configKeepKey.apiKey;
+              this.keepKeySdk = keepKeySdk;
+              this.context = "keepkey:" + features.label + ".json";
+            } catch (e) {
+              console.error("⚠️ [INIT] KeepKey SDK initialization failed:", e);
             }
-          };
-          console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
-          const keepKeySdk = await KeepKeySdk.create(configKeepKey);
-          const features = await keepKeySdk.system.info.getFeatures();
-          this.keepkeyApiKey = configKeepKey.apiKey;
-          this.keepKeySdk = keepKeySdk;
-          this.context = "keepkey:" + features.label + ".json";
-        } catch (e) {
-          console.error("⚠️ [INIT] KeepKey SDK initialization failed:", e);
+          } else {
+            console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping KeepKey SDK initialization");
+          }
+        } else {
+          console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping vault endpoint detection");
+          this.keepkeyEndpoint = null;
         }
         let configWss = {
           username: this.username,
@@ -4940,11 +4996,16 @@ class SDK {
           }
         }
         console.log(tag, `Calling batch GetCharts with ${pubkeysForBatch.length} pubkeys`);
-        const chartsResponse = await this.pioneer.GetCharts({
-          pubkeys: pubkeysForBatch
-        });
-        const newBalances = chartsResponse?.data?.balances || [];
-        console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        let newBalances = [];
+        try {
+          const chartsResponse = await this.pioneer.GetCharts({
+            pubkeys: pubkeysForBatch
+          });
+          newBalances = chartsResponse?.data?.balances || [];
+          console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        } catch (chartsError) {
+          console.warn(tag, `GetCharts API not available (${chartsError.message}), continuing without charts data`);
+        }
         const uniqueBalances = new Map([...this.balances, ...newBalances].map((balance) => [
           balance.identifier || `${balance.caip}:${balance.pubkey}`,
           {

package/dist/index.js

@@ -1274,7 +1274,15 @@ async function createUnsignedEvmTx(caip, to, amount, memo, pubkeys, pioneer, pub
           amountWei = balance - gasFee - buffer;
           console.log(tag, "isMax calculation - balance:", balance.toString(), "gasFee:", gasFee.toString(), "buffer:", buffer.toString(), "amountWei:", amountWei.toString());
         } else {
-          amountWei = BigInt(Math.round(amount * 1000000000000000000));
+          const amountNum = typeof amount === "string" ? parseFloat(amount) : amount;
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(`Invalid amount for native gas transfer: "${amount}" (type: ${typeof amount}). ` + `Amount must be a valid positive number.`);
+          }
+          const amountCalculation = amountNum * 1000000000000000000;
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(`Invalid amount calculation for native gas transfer. ` + `Input: ${amountNum}`);
+          }
+          amountWei = BigInt(Math.round(amountCalculation));
           const totalNeeded = amountWei + gasFee;
           if (totalNeeded > balance) {
             const availableForSwap = balance > gasFee ? balance - gasFee : 0n;
@@ -1433,11 +1441,22 @@ async function createUnsignedEvmTx(caip, to, amount, memo, pubkeys, pioneer, pub
           const tokenBalance = BigInt(Math.round(tokenBalanceData.data * Number(tokenMultiplier)));
           amountWei = tokenBalance;
         } else {
-          amountWei = BigInt(Math.round(amount * Number(tokenMultiplier)));
+          const amountNum = typeof amount === "string" ? parseFloat(amount) : amount;
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(`Invalid amount for ERC20 transfer: "${amount}" (type: ${typeof amount}). ` + `Amount must be a valid positive number.`);
+          }
+          const amountCalculation = amountNum * Number(tokenMultiplier);
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(`Invalid amount calculation for ERC20 transfer. ` + `Input: ${amountNum}, Decimals: ${tokenDecimals}, Multiplier: ${tokenMultiplier}`);
+          }
+          amountWei = BigInt(Math.round(amountCalculation));
           console.log(tag, "Token amount calculation:", {
             inputAmount: amount,
+            inputType: typeof amount,
+            parsedAmount: amountNum,
             decimals: tokenDecimals,
-            multiplier: tokenMultiplier,
+            multiplier: tokenMultiplier.toString(),
+            calculation: amountCalculation,
             resultWei: amountWei.toString()
           });
         }
@@ -3599,6 +3618,9 @@ class SDK {
   isPioneer;
   keepkeyEndpoint;
   forceLocalhost;
+  viewOnlyMode;
+  skipDevicePairing;
+  skipKeeperEndpoint;
   getPubkeys;
   getBalances;
   blockchains;
@@ -3655,6 +3677,9 @@ class SDK {
     this.keepkeyEndpoint = null;
     this.forceLocalhost = config.forceLocalhost || false;
     this.paths = config.paths || [];
+    this.viewOnlyMode = config.viewOnlyMode || false;
+    this.skipDevicePairing = config.skipDevicePairing || config.viewOnlyMode || false;
+    this.skipKeeperEndpoint = config.skipKeeperEndpoint || config.viewOnlyMode || false;
     this.blockchains = config.blockchains ? [...new Set(config.blockchains)] : [];
     if (config.blockchains && config.blockchains.length !== this.blockchains.length) {
     }
@@ -3695,7 +3720,20 @@ class SDK {
       fallbackToRemote: true
     }) : null;
     this.pairWallet = async (options) => {
-      return Promise.resolve({});
+      const tag = TAG9 + " | pairWallet | ";
+      if (this.viewOnlyMode || this.skipDevicePairing) {
+        console.log(tag, "\uD83D\uDC41️ [VIEW-ONLY] Skipping device pairing");
+        return {
+          success: false,
+          reason: "view-only-mode",
+          message: "Device pairing skipped in view-only mode"
+        };
+      }
+      return Promise.resolve({
+        success: false,
+        reason: "not-implemented",
+        message: "Device pairing not yet implemented"
+      });
     };
     this.getPubkeyKey = (pubkey) => {
       return `${pubkey.pubkey}_${pubkey.pathMaster}`;
@@ -3741,6 +3779,15 @@ class SDK {
       this.pubkeys = [];
       this.pubkeySet.clear();
     }
+    this.isViewOnlyMode = () => {
+      return this.viewOnlyMode;
+    };
+    this.canSignTransactions = () => {
+      return !this.viewOnlyMode && !!this.keepKeySdk;
+    };
+    this.isVaultAvailable = () => {
+      return !!this.keepkeyEndpoint && this.keepkeyEndpoint.isAvailable;
+    };
     this.getUnifiedPortfolio = async function() {
       const tag = `${TAG9} | getUnifiedPortfolio | `;
       try {
@@ -3891,26 +3938,35 @@ class SDK {
           throw Error("Failed to init pioneer server!");
         this.paths.concat(getPaths(this.blockchains));
         await this.getGasAssets();
-        this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
-        const keepkeyEndpoint = this.keepkeyEndpoint;
-        try {
-          const configKeepKey = {
-            apiKey: this.keepkeyApiKey || "keepkey-api-key",
-            pairingInfo: {
-              name: "KeepKey SDK Demo App",
-              imageUrl: "https://pioneers.dev/coins/keepkey.png",
-              basePath: keepkeyEndpoint.basePath,
-              url: keepkeyEndpoint.baseUrl
+        if (!this.skipKeeperEndpoint) {
+          this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
+          const keepkeyEndpoint = this.keepkeyEndpoint;
+          if (!this.skipDevicePairing) {
+            try {
+              const configKeepKey = {
+                apiKey: this.keepkeyApiKey || "keepkey-api-key",
+                pairingInfo: {
+                  name: "KeepKey SDK Demo App",
+                  imageUrl: "https://pioneers.dev/coins/keepkey.png",
+                  basePath: keepkeyEndpoint.basePath,
+                  url: keepkeyEndpoint.baseUrl
+                }
+              };
+              console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
+              const keepKeySdk = await KeepKeySdk.create(configKeepKey);
+              const features = await keepKeySdk.system.info.getFeatures();
+              this.keepkeyApiKey = configKeepKey.apiKey;
+              this.keepKeySdk = keepKeySdk;
+              this.context = "keepkey:" + features.label + ".json";
+            } catch (e) {
+              console.error("⚠️ [INIT] KeepKey SDK initialization failed:", e);
             }
-          };
-          console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
-          const keepKeySdk = await KeepKeySdk.create(configKeepKey);
-          const features = await keepKeySdk.system.info.getFeatures();
-          this.keepkeyApiKey = configKeepKey.apiKey;
-          this.keepKeySdk = keepKeySdk;
-          this.context = "keepkey:" + features.label + ".json";
-        } catch (e) {
-          console.error("⚠️ [INIT] KeepKey SDK initialization failed:", e);
+          } else {
+            console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping KeepKey SDK initialization");
+          }
+        } else {
+          console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping vault endpoint detection");
+          this.keepkeyEndpoint = null;
         }
         let configWss = {
           username: this.username,
@@ -4940,11 +4996,16 @@ class SDK {
           }
         }
         console.log(tag, `Calling batch GetCharts with ${pubkeysForBatch.length} pubkeys`);
-        const chartsResponse = await this.pioneer.GetCharts({
-          pubkeys: pubkeysForBatch
-        });
-        const newBalances = chartsResponse?.data?.balances || [];
-        console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        let newBalances = [];
+        try {
+          const chartsResponse = await this.pioneer.GetCharts({
+            pubkeys: pubkeysForBatch
+          });
+          newBalances = chartsResponse?.data?.balances || [];
+          console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        } catch (chartsError) {
+          console.warn(tag, `GetCharts API not available (${chartsError.message}), continuing without charts data`);
+        }
         const uniqueBalances = new Map([...this.balances, ...newBalances].map((balance) => [
           balance.identifier || `${balance.caip}:${balance.pubkey}`,
           {

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "highlander",
   "name": "@pioneer-platform/pioneer-sdk",
-  "version": "8.12.8",
+  "version": "8.13.0",
   "dependencies": {
     "@keepkey/keepkey-sdk": "^0.2.62",
     "@pioneer-platform/loggerdog": "^8.11.0",

package/src/index.ts

@@ -76,6 +76,10 @@ export interface PioneerSDKConfig {
   offlineFirst?: boolean;
   vaultUrl?: string;
   forceLocalhost?: boolean;
+  // View-only mode configuration
+  viewOnlyMode?: boolean;           // Enable view-only mode (no device/vault required)
+  skipDevicePairing?: boolean;      // Skip KeepKey device pairing
+  skipKeeperEndpoint?: boolean;     // Skip vault endpoint detection
 }
 
 export interface SyncState {
@@ -140,6 +144,10 @@ export class SDK {
   public isPioneer: string | null;
   public keepkeyEndpoint: { isAvailable: boolean; baseUrl: string; basePath: string } | null;
   public forceLocalhost: boolean;
+  // View-only mode properties
+  public viewOnlyMode: boolean;
+  public skipDevicePairing: boolean;
+  public skipKeeperEndpoint: boolean;
   // public loadPubkeyCache: (pubkeys: any) => Promise<void>;
   public getPubkeys: (wallets?: string[]) => Promise<any[]>;
   public getBalances: (filter?: any) => Promise<any[]>;
@@ -229,6 +237,11 @@ export class SDK {
     this.forceLocalhost = config.forceLocalhost || false;
     this.paths = config.paths || [];
 
+    // View-only mode initialization
+    this.viewOnlyMode = config.viewOnlyMode || false;
+    this.skipDevicePairing = config.skipDevicePairing || config.viewOnlyMode || false;
+    this.skipKeeperEndpoint = config.skipKeeperEndpoint || config.viewOnlyMode || false;
+
     // Deduplicate blockchains to prevent duplicate dashboard calculations
     this.blockchains = config.blockchains ? [...new Set(config.blockchains)] : [];
     if (config.blockchains && config.blockchains.length !== this.blockchains.length) {
@@ -278,8 +291,25 @@ export class SDK {
       : null;
 
     this.pairWallet = async (options: any) => {
-      // Implementation will be added later
-      return Promise.resolve({});
+      const tag = TAG + ' | pairWallet | ';
+
+      // Skip device pairing in view-only mode
+      if (this.viewOnlyMode || this.skipDevicePairing) {
+        console.log(tag, '👁️ [VIEW-ONLY] Skipping device pairing');
+        return {
+          success: false,
+          reason: 'view-only-mode',
+          message: 'Device pairing skipped in view-only mode'
+        };
+      }
+
+      // Normal device pairing logic would go here
+      // For now, return placeholder
+      return Promise.resolve({
+        success: false,
+        reason: 'not-implemented',
+        message: 'Device pairing not yet implemented'
+      });
     };
 
     // Helper method to generate unique key for a pubkey
@@ -347,6 +377,19 @@ export class SDK {
       this.pubkeySet.clear();
     }
 
+    // View-only mode helper methods
+    this.isViewOnlyMode = (): boolean => {
+      return this.viewOnlyMode;
+    };
+
+    this.canSignTransactions = (): boolean => {
+      return !this.viewOnlyMode && !!this.keepKeySdk;
+    };
+
+    this.isVaultAvailable = (): boolean => {
+      return !!this.keepkeyEndpoint && this.keepkeyEndpoint.isAvailable;
+    };
+
     // Fast portfolio loading from kkapi:// cache
     this.getUnifiedPortfolio = async function () {
       const tag = `${TAG} | getUnifiedPortfolio | `;
@@ -558,31 +601,40 @@ export class SDK {
         // Get gas assets (needed for asset map)
         await this.getGasAssets();
 
-        // Detect KeepKey endpoint
-        this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
-        const keepkeyEndpoint = this.keepkeyEndpoint;
+        // Detect KeepKey endpoint (skip if view-only mode)
+        if (!this.skipKeeperEndpoint) {
+          this.keepkeyEndpoint = await detectKkApiAvailability(this.forceLocalhost);
+          const keepkeyEndpoint = this.keepkeyEndpoint;
 
-        // Initialize KeepKey SDK if available
-        try {
-          const configKeepKey = {
-            apiKey: this.keepkeyApiKey || 'keepkey-api-key',
-            pairingInfo: {
-              name: 'KeepKey SDK Demo App',
-              imageUrl: 'https://pioneers.dev/coins/keepkey.png',
-              basePath: keepkeyEndpoint.basePath,
-              url: keepkeyEndpoint.baseUrl,
-            },
-          };
-
-          console.log('🔑 [INIT] Initializing KeepKey SDK...');
-          const keepKeySdk = await KeepKeySdk.create(configKeepKey);
-          const features = await keepKeySdk.system.info.getFeatures();
-
-          this.keepkeyApiKey = configKeepKey.apiKey;
-          this.keepKeySdk = keepKeySdk;
-          this.context = 'keepkey:' + features.label + '.json';
-        } catch (e) {
-          console.error('⚠️ [INIT] KeepKey SDK initialization failed:', e);
+          // Initialize KeepKey SDK if available and not skipping device pairing
+          if (!this.skipDevicePairing) {
+            try {
+              const configKeepKey = {
+                apiKey: this.keepkeyApiKey || 'keepkey-api-key',
+                pairingInfo: {
+                  name: 'KeepKey SDK Demo App',
+                  imageUrl: 'https://pioneers.dev/coins/keepkey.png',
+                  basePath: keepkeyEndpoint.basePath,
+                  url: keepkeyEndpoint.baseUrl,
+                },
+              };
+
+              console.log('🔑 [INIT] Initializing KeepKey SDK...');
+              const keepKeySdk = await KeepKeySdk.create(configKeepKey);
+              const features = await keepKeySdk.system.info.getFeatures();
+
+              this.keepkeyApiKey = configKeepKey.apiKey;
+              this.keepKeySdk = keepKeySdk;
+              this.context = 'keepkey:' + features.label + '.json';
+            } catch (e) {
+              console.error('⚠️ [INIT] KeepKey SDK initialization failed:', e);
+            }
+          } else {
+            console.log('👁️ [VIEW-ONLY] Skipping KeepKey SDK initialization');
+          }
+        } else {
+          console.log('👁️ [VIEW-ONLY] Skipping vault endpoint detection');
+          this.keepkeyEndpoint = null;
         }
 
         // Initialize WebSocket events
@@ -1934,7 +1986,7 @@ export class SDK {
         console.time('GetPortfolioBalances Response Time');
 
         try {
-          // FIX: Wrap assetQuery in object with pubkeys field to match server API
+          // Wrap assetQuery in object with pubkeys field (API expects { pubkeys: [...] })
           let marketInfo = await this.pioneer.GetPortfolioBalances({ pubkeys: assetQuery });
           const apiCallTime = performance.now() - apiCallStart;
           console.timeEnd('GetPortfolioBalances Response Time');
@@ -2088,12 +2140,17 @@ export class SDK {
         console.log(tag, `Calling batch GetCharts with ${pubkeysForBatch.length} pubkeys`);
 
         // Single batch call to get ALL charts data
-        const chartsResponse = await this.pioneer.GetCharts({
-          pubkeys: pubkeysForBatch
-        });
-
-        const newBalances = chartsResponse?.data?.balances || [];
-        console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        let newBalances = [];
+        try {
+          const chartsResponse = await this.pioneer.GetCharts({
+            pubkeys: pubkeysForBatch
+          });
+          newBalances = chartsResponse?.data?.balances || [];
+          console.log(tag, `Received ${newBalances.length} balances from batch endpoint`);
+        } catch (chartsError: any) {
+          // GetCharts API may not be available - gracefully continue without charts data
+          console.warn(tag, `GetCharts API not available (${chartsError.message}), continuing without charts data`);
+        }
 
         // Deduplicate balances using a Map with `identifier` as the key
         const uniqueBalances = new Map(

package/src/txbuilder/createUnsignedEvmTx.ts

@@ -330,7 +330,29 @@ export async function createUnsignedEvmTx(
           amountWei = balance - gasFee - buffer;
           console.log(tag, 'isMax calculation - balance:', balance.toString(), 'gasFee:', gasFee.toString(), 'buffer:', buffer.toString(), 'amountWei:', amountWei.toString());
         } else {
-          amountWei = BigInt(Math.round(amount * 1e18));
+          // Validate and convert amount to number
+          // Handle both string and number inputs
+          const amountNum = typeof amount === 'string' ? parseFloat(amount) : amount;
+
+          // Validate amount is a valid number
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(
+              `Invalid amount for native gas transfer: "${amount}" (type: ${typeof amount}). ` +
+              `Amount must be a valid positive number.`
+            );
+          }
+
+          const amountCalculation = amountNum * 1e18;
+
+          // Validate calculation result before BigInt conversion
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(
+              `Invalid amount calculation for native gas transfer. ` +
+              `Input: ${amountNum}`
+            );
+          }
+
+          amountWei = BigInt(Math.round(amountCalculation));
           const totalNeeded = amountWei + gasFee;
 
           if (totalNeeded > balance) {
@@ -578,12 +600,37 @@ export async function createUnsignedEvmTx(
           const tokenBalance = BigInt(Math.round(tokenBalanceData.data * Number(tokenMultiplier)));
           amountWei = tokenBalance;
         } else {
+          // Validate and convert amount to number
+          // Handle both string and number inputs
+          const amountNum = typeof amount === 'string' ? parseFloat(amount) : amount;
+
+          // Validate amount is a valid number
+          if (isNaN(amountNum) || !isFinite(amountNum) || amountNum <= 0) {
+            throw new Error(
+              `Invalid amount for ERC20 transfer: "${amount}" (type: ${typeof amount}). ` +
+              `Amount must be a valid positive number.`
+            );
+          }
+
           // Use BigInt math to avoid precision loss
-          amountWei = BigInt(Math.round(amount * Number(tokenMultiplier)));
+          const amountCalculation = amountNum * Number(tokenMultiplier);
+
+          // Validate calculation result before BigInt conversion
+          if (isNaN(amountCalculation) || !isFinite(amountCalculation)) {
+            throw new Error(
+              `Invalid amount calculation for ERC20 transfer. ` +
+              `Input: ${amountNum}, Decimals: ${tokenDecimals}, Multiplier: ${tokenMultiplier}`
+            );
+          }
+
+          amountWei = BigInt(Math.round(amountCalculation));
           console.log(tag, 'Token amount calculation:', {
             inputAmount: amount,
+            inputType: typeof amount,
+            parsedAmount: amountNum,
             decimals: tokenDecimals,
-            multiplier: tokenMultiplier,
+            multiplier: tokenMultiplier.toString(),
+            calculation: amountCalculation,
             resultWei: amountWei.toString(),
           });
         }