@pioneer-platform/pioneer-sdk 8.15.33 → 8.15.38

package/dist/index.cjs

@@ -436,6 +436,17 @@ function processPortfolioBalance(balance, primaryAddress, context, blockchains)
       console.log(tag2, `Calculated price from value/balance: ${calculatedPrice} for ${balance.caip}`);
     }
   }
+  const decimals = assetInfo?.decimals ?? assetInfo?.decimal ?? balance.decimals ?? balance.decimal;
+  if (decimals === undefined || decimals === null) {
+    throw new Error(`CRITICAL: Asset ${balance.caip} (${assetInfo?.symbol || balance.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({
+      caip: balance.caip,
+      symbol: assetInfo?.symbol || balance.symbol,
+      hasAssetInfoDecimals: !!assetInfo?.decimals,
+      hasAssetInfoDecimal: !!assetInfo?.decimal,
+      hasBalanceDecimals: !!balance.decimals,
+      hasBalanceDecimal: !!balance.decimal
+    })}`);
+  }
   const chartBalance = {
     context,
     chart: "pioneer",
@@ -452,7 +463,9 @@ function processPortfolioBalance(balance, primaryAddress, context, blockchains)
     symbol: assetInfo?.symbol || balance.symbol || "UNK",
     type: balanceType,
     token: isToken,
-    decimal: assetInfo?.decimal || balance.decimal,
+    decimal: decimals,
+    decimals,
+    precision: decimals,
     balance: balance.balance.toString(),
     price: calculatedPrice,
     priceUsd: calculatedPrice,
@@ -483,6 +496,17 @@ function processPortfolioToken(token, primaryAddress, context, blockchains) {
   }
   const tokenAssetInfo = hydrateAssetData(token.assetCaip);
   const tokenPubkey = token.pubkey || primaryAddress;
+  const tokenDecimals = tokenAssetInfo?.decimals ?? tokenAssetInfo?.decimal ?? token.token?.decimals ?? token.token?.decimal;
+  if (tokenDecimals === undefined || tokenDecimals === null) {
+    throw new Error(`CRITICAL: Token ${token.assetCaip} (${tokenAssetInfo?.symbol || token.token?.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Token data: ${JSON.stringify({
+      caip: token.assetCaip,
+      symbol: tokenAssetInfo?.symbol || token.token?.symbol,
+      hasAssetInfoDecimals: !!tokenAssetInfo?.decimals,
+      hasAssetInfoDecimal: !!tokenAssetInfo?.decimal,
+      hasTokenDecimals: !!token.token?.decimals,
+      hasTokenDecimal: !!token.token?.decimal
+    })}`);
+  }
   const chartBalance = {
     context,
     chart: "pioneer",
@@ -498,7 +522,9 @@ function processPortfolioToken(token, primaryAddress, context, blockchains) {
     symbol: tokenAssetInfo?.symbol || token.token?.symbol || "UNK",
     type: tokenAssetInfo?.type || "token",
     token: true,
-    decimal: tokenAssetInfo?.decimal || token.token?.decimal,
+    decimal: tokenDecimals,
+    decimals: tokenDecimals,
+    precision: tokenDecimals,
     balance: token.token?.balance?.toString() || "0",
     priceUsd: token.token?.price || 0,
     valueUsd: token.token?.balanceUSD || 0,
@@ -605,6 +631,17 @@ async function getMayaCharts(params, existingBalances) {
       }
       const mayaAssetInfo = hydrateAssetData(mayaBalance.caip);
       const isToken = mayaBalance.caip.includes("/denom:") && !mayaBalance.caip.endsWith("/denom:cacao");
+      const decimals = mayaAssetInfo?.decimals ?? mayaAssetInfo?.decimal ?? mayaBalance.decimals ?? mayaBalance.decimal;
+      if (decimals === undefined || decimals === null) {
+        throw new Error(`CRITICAL: Asset ${mayaBalance.caip} (${mayaAssetInfo?.symbol || "MAYA"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({
+          caip: mayaBalance.caip,
+          symbol: mayaAssetInfo?.symbol,
+          hasAssetInfoDecimals: !!mayaAssetInfo?.decimals,
+          hasAssetInfoDecimal: !!mayaAssetInfo?.decimal,
+          hasBalanceDecimals: !!mayaBalance.decimals,
+          hasBalanceDecimal: !!mayaBalance.decimal
+        })}`);
+      }
       const mayaTokenBalance = {
         context,
         chart: "pioneer",
@@ -620,7 +657,9 @@ async function getMayaCharts(params, existingBalances) {
         symbol: mayaAssetInfo?.symbol || "MAYA",
         type: mayaAssetInfo?.type || "token",
         token: isToken,
-        decimal: mayaAssetInfo?.decimal,
+        decimal: decimals,
+        decimals,
+        precision: decimals,
         balance: mayaBalance.balance?.toString() || "0",
         priceUsd: parseFloat(mayaBalance.priceUsd) || 0,
         valueUsd: parseFloat(mayaBalance.valueUsd) || 0,
@@ -4404,6 +4443,10 @@ function enrichBalancesWithAssetInfo(balances, assetsMap, caipToNetworkId7) {
     const explorerUrls = EXPLORER_BASE_URLS[networkId];
     const explorerAddressLink = explorerUrls && balance.pubkey ? explorerUrls.address + balance.pubkey : undefined;
     const explorerTxLink = explorerUrls?.tx;
+    const decimals = assetInfo.decimals ?? balance.decimals;
+    if (decimals === undefined || decimals === null) {
+      throw new Error(`CRITICAL: Asset ${balance.caip} (${assetInfo.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `AssetInfo is incomplete. This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({ caip: balance.caip, symbol: assetInfo.symbol, hasDecimals: !!assetInfo.decimals })}`);
+    }
     Object.assign(balance, assetInfo, {
       type: balance.type || assetInfo.type,
       isNative: balance.isNative ?? assetInfo.isNative,
@@ -4412,7 +4455,8 @@ function enrichBalancesWithAssetInfo(balances, assetsMap, caipToNetworkId7) {
       identifier: `${balance.caip}:${balance.pubkey}`,
       updated: Date.now(),
       color: assetInfo.color,
-      decimals: assetInfo.decimals || balance.decimals || 8,
+      decimals,
+      precision: decimals,
       explorerAddressLink,
       explorerTxLink,
       explorer: explorerUrls?.address,
@@ -4793,14 +4837,17 @@ class SDK {
     this.getUnifiedPortfolio = async function() {
       const tag6 = `${TAG12} | getUnifiedPortfolio | `;
       try {
+        console.log(tag6, " checkpoint 4.0 - getUnifiedPortfolio start");
         const startTime = performance.now();
         try {
           const baseUrl = this.keepkeyEndpoint?.baseUrl || "kkapi://";
           const portfolioUrl = `${baseUrl}/api/portfolio`;
+          console.log(tag6, " checkpoint 4.1 - Fetching portfolio from:", portfolioUrl);
           const portfolioResponse = await fetch(portfolioUrl, {
             method: "GET",
             signal: AbortSignal.timeout(2000)
           });
+          console.log(tag6, " checkpoint 4.2 - Portfolio fetch returned, status:", portfolioResponse.status);
           if (!portfolioResponse.ok) {
             console.warn(tag6, "Portfolio endpoint returned", portfolioResponse.status);
             return null;
@@ -4913,7 +4960,9 @@ class SDK {
               };
               console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
               const keepKeySdk = await import_keepkey_sdk.KeepKeySdk.create(configKeepKey);
+              console.log(tag6, " checkpoint 1.1 - KeepKeySdk created");
               const features = await keepKeySdk.system.info.getFeatures();
+              console.log(tag6, " checkpoint 1.2 - features retrieved:", features);
               this.keepkeyApiKey = configKeepKey.apiKey;
               this.keepKeySdk = keepKeySdk;
               this.context = "keepkey:" + features.label + ".json";
@@ -4927,14 +4976,18 @@ class SDK {
           console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping vault endpoint detection");
           this.keepkeyEndpoint = null;
         }
+        console.log(tag6, " checkpoint 2 - Starting WebSocket initialization");
         let configWss = {
           username: this.username,
           queryKey: this.queryKey,
           wss: this.wss
         };
         let clientEvents = new import_pioneer_events.Events(configWss);
+        console.log(tag6, " checkpoint 2.1 - Events created, calling init()");
         await clientEvents.init();
+        console.log(tag6, " checkpoint 2.2 - Events init complete, setting username");
         await clientEvents.setUsername(this.username);
+        console.log(tag6, " checkpoint 2.3 - Username set, WebSocket ready");
         clientEvents.events.on("message", (request) => {
           this.events.emit("message", request);
         });
@@ -5000,11 +5053,14 @@ class SDK {
           }
         });
         this.events.emit("SET_STATUS", "init");
+        console.log(tag6, " checkpoint 3 - Starting fast portfolio check");
         if (this.keepKeySdk && !skipSync) {
           console.log("⚡ [FAST PORTFOLIO] Attempting fast load...");
+          console.log(tag6, " checkpoint 3.1 - Calling getUnifiedPortfolio()");
           const fastStart = performance.now();
           try {
             const unifiedResult = await this.getUnifiedPortfolio();
+            console.log(tag6, " checkpoint 3.2 - getUnifiedPortfolio() returned");
             console.log("unifiedResult: ", unifiedResult);
             if (unifiedResult && unifiedResult.cached && unifiedResult.totalValueUsd > 0) {
               console.log(`✅ [FAST PORTFOLIO] Loaded in ${(performance.now() - fastStart).toFixed(0)}ms`);
@@ -5935,7 +5991,16 @@ class SDK {
           const networkId2 = import_pioneer_caip8.caipToNetworkId(asset.caip || asset.networkId);
           const currentContextValid = this.pubkeyContext?.networks?.includes(networkId2);
           if (!this.pubkeyContext || !currentContextValid) {
-            this.pubkeyContext = assetPubkeys[0];
+            let preferredPubkey = assetPubkeys[0];
+            const isBitcoin = networkId2?.includes("bip122:000000000019d6689c085ae165831e93") || asset.symbol === "BTC" || asset.name?.toLowerCase().includes("bitcoin");
+            if (isBitcoin) {
+              const nativeSegwitPubkey = assetPubkeys.find((pk) => pk.script_type === "p2wpkh" || pk.scriptType === "p2wpkh" || pk.note?.toLowerCase().includes("native") && pk.note?.toLowerCase().includes("segwit") || pk.pathMaster?.includes("84'"));
+              if (nativeSegwitPubkey) {
+                preferredPubkey = nativeSegwitPubkey;
+                console.log(tag6, "Preferring Native Segwit (Bech32) for Bitcoin");
+              }
+            }
+            this.pubkeyContext = preferredPubkey;
             console.log(tag6, "Auto-set pubkey context for network:", this.pubkeyContext.address || this.pubkeyContext.pubkey);
           } else {
             console.log(tag6, "Preserving existing pubkey context for network:", this.pubkeyContext.address || this.pubkeyContext.pubkey, `(addressNList: [${(this.pubkeyContext.addressNList || this.pubkeyContext.addressNListMaster).join(", ")}])`);

package/dist/index.es.js

@@ -427,6 +427,17 @@ function processPortfolioBalance(balance, primaryAddress, context, blockchains)
       console.log(tag2, `Calculated price from value/balance: ${calculatedPrice} for ${balance.caip}`);
     }
   }
+  const decimals = assetInfo?.decimals ?? assetInfo?.decimal ?? balance.decimals ?? balance.decimal;
+  if (decimals === undefined || decimals === null) {
+    throw new Error(`CRITICAL: Asset ${balance.caip} (${assetInfo?.symbol || balance.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({
+      caip: balance.caip,
+      symbol: assetInfo?.symbol || balance.symbol,
+      hasAssetInfoDecimals: !!assetInfo?.decimals,
+      hasAssetInfoDecimal: !!assetInfo?.decimal,
+      hasBalanceDecimals: !!balance.decimals,
+      hasBalanceDecimal: !!balance.decimal
+    })}`);
+  }
   const chartBalance = {
     context,
     chart: "pioneer",
@@ -443,7 +454,9 @@ function processPortfolioBalance(balance, primaryAddress, context, blockchains)
     symbol: assetInfo?.symbol || balance.symbol || "UNK",
     type: balanceType,
     token: isToken,
-    decimal: assetInfo?.decimal || balance.decimal,
+    decimal: decimals,
+    decimals,
+    precision: decimals,
     balance: balance.balance.toString(),
     price: calculatedPrice,
     priceUsd: calculatedPrice,
@@ -474,6 +487,17 @@ function processPortfolioToken(token, primaryAddress, context, blockchains) {
   }
   const tokenAssetInfo = hydrateAssetData(token.assetCaip);
   const tokenPubkey = token.pubkey || primaryAddress;
+  const tokenDecimals = tokenAssetInfo?.decimals ?? tokenAssetInfo?.decimal ?? token.token?.decimals ?? token.token?.decimal;
+  if (tokenDecimals === undefined || tokenDecimals === null) {
+    throw new Error(`CRITICAL: Token ${token.assetCaip} (${tokenAssetInfo?.symbol || token.token?.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Token data: ${JSON.stringify({
+      caip: token.assetCaip,
+      symbol: tokenAssetInfo?.symbol || token.token?.symbol,
+      hasAssetInfoDecimals: !!tokenAssetInfo?.decimals,
+      hasAssetInfoDecimal: !!tokenAssetInfo?.decimal,
+      hasTokenDecimals: !!token.token?.decimals,
+      hasTokenDecimal: !!token.token?.decimal
+    })}`);
+  }
   const chartBalance = {
     context,
     chart: "pioneer",
@@ -489,7 +513,9 @@ function processPortfolioToken(token, primaryAddress, context, blockchains) {
     symbol: tokenAssetInfo?.symbol || token.token?.symbol || "UNK",
     type: tokenAssetInfo?.type || "token",
     token: true,
-    decimal: tokenAssetInfo?.decimal || token.token?.decimal,
+    decimal: tokenDecimals,
+    decimals: tokenDecimals,
+    precision: tokenDecimals,
     balance: token.token?.balance?.toString() || "0",
     priceUsd: token.token?.price || 0,
     valueUsd: token.token?.balanceUSD || 0,
@@ -596,6 +622,17 @@ async function getMayaCharts(params, existingBalances) {
       }
       const mayaAssetInfo = hydrateAssetData(mayaBalance.caip);
       const isToken = mayaBalance.caip.includes("/denom:") && !mayaBalance.caip.endsWith("/denom:cacao");
+      const decimals = mayaAssetInfo?.decimals ?? mayaAssetInfo?.decimal ?? mayaBalance.decimals ?? mayaBalance.decimal;
+      if (decimals === undefined || decimals === null) {
+        throw new Error(`CRITICAL: Asset ${mayaBalance.caip} (${mayaAssetInfo?.symbol || "MAYA"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({
+          caip: mayaBalance.caip,
+          symbol: mayaAssetInfo?.symbol,
+          hasAssetInfoDecimals: !!mayaAssetInfo?.decimals,
+          hasAssetInfoDecimal: !!mayaAssetInfo?.decimal,
+          hasBalanceDecimals: !!mayaBalance.decimals,
+          hasBalanceDecimal: !!mayaBalance.decimal
+        })}`);
+      }
       const mayaTokenBalance = {
         context,
         chart: "pioneer",
@@ -611,7 +648,9 @@ async function getMayaCharts(params, existingBalances) {
         symbol: mayaAssetInfo?.symbol || "MAYA",
         type: mayaAssetInfo?.type || "token",
         token: isToken,
-        decimal: mayaAssetInfo?.decimal,
+        decimal: decimals,
+        decimals,
+        precision: decimals,
         balance: mayaBalance.balance?.toString() || "0",
         priceUsd: parseFloat(mayaBalance.priceUsd) || 0,
         valueUsd: parseFloat(mayaBalance.valueUsd) || 0,
@@ -4588,6 +4627,10 @@ function enrichBalancesWithAssetInfo(balances, assetsMap, caipToNetworkId7) {
     const explorerUrls = EXPLORER_BASE_URLS[networkId];
     const explorerAddressLink = explorerUrls && balance.pubkey ? explorerUrls.address + balance.pubkey : undefined;
     const explorerTxLink = explorerUrls?.tx;
+    const decimals = assetInfo.decimals ?? balance.decimals;
+    if (decimals === undefined || decimals === null) {
+      throw new Error(`CRITICAL: Asset ${balance.caip} (${assetInfo.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `AssetInfo is incomplete. This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({ caip: balance.caip, symbol: assetInfo.symbol, hasDecimals: !!assetInfo.decimals })}`);
+    }
     Object.assign(balance, assetInfo, {
       type: balance.type || assetInfo.type,
       isNative: balance.isNative ?? assetInfo.isNative,
@@ -4596,7 +4639,8 @@ function enrichBalancesWithAssetInfo(balances, assetsMap, caipToNetworkId7) {
       identifier: `${balance.caip}:${balance.pubkey}`,
       updated: Date.now(),
       color: assetInfo.color,
-      decimals: assetInfo.decimals || balance.decimals || 8,
+      decimals,
+      precision: decimals,
       explorerAddressLink,
       explorerTxLink,
       explorer: explorerUrls?.address,
@@ -4977,14 +5021,17 @@ class SDK {
     this.getUnifiedPortfolio = async function() {
       const tag6 = `${TAG12} | getUnifiedPortfolio | `;
       try {
+        console.log(tag6, " checkpoint 4.0 - getUnifiedPortfolio start");
         const startTime = performance.now();
         try {
           const baseUrl = this.keepkeyEndpoint?.baseUrl || "kkapi://";
           const portfolioUrl = `${baseUrl}/api/portfolio`;
+          console.log(tag6, " checkpoint 4.1 - Fetching portfolio from:", portfolioUrl);
           const portfolioResponse = await fetch(portfolioUrl, {
             method: "GET",
             signal: AbortSignal.timeout(2000)
           });
+          console.log(tag6, " checkpoint 4.2 - Portfolio fetch returned, status:", portfolioResponse.status);
           if (!portfolioResponse.ok) {
             console.warn(tag6, "Portfolio endpoint returned", portfolioResponse.status);
             return null;
@@ -5097,7 +5144,9 @@ class SDK {
               };
               console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
               const keepKeySdk = await KeepKeySdk.create(configKeepKey);
+              console.log(tag6, " checkpoint 1.1 - KeepKeySdk created");
               const features = await keepKeySdk.system.info.getFeatures();
+              console.log(tag6, " checkpoint 1.2 - features retrieved:", features);
               this.keepkeyApiKey = configKeepKey.apiKey;
               this.keepKeySdk = keepKeySdk;
               this.context = "keepkey:" + features.label + ".json";
@@ -5111,14 +5160,18 @@ class SDK {
           console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping vault endpoint detection");
           this.keepkeyEndpoint = null;
         }
+        console.log(tag6, " checkpoint 2 - Starting WebSocket initialization");
         let configWss = {
           username: this.username,
           queryKey: this.queryKey,
           wss: this.wss
         };
         let clientEvents = new Events(configWss);
+        console.log(tag6, " checkpoint 2.1 - Events created, calling init()");
         await clientEvents.init();
+        console.log(tag6, " checkpoint 2.2 - Events init complete, setting username");
         await clientEvents.setUsername(this.username);
+        console.log(tag6, " checkpoint 2.3 - Username set, WebSocket ready");
         clientEvents.events.on("message", (request) => {
           this.events.emit("message", request);
         });
@@ -5184,11 +5237,14 @@ class SDK {
           }
         });
         this.events.emit("SET_STATUS", "init");
+        console.log(tag6, " checkpoint 3 - Starting fast portfolio check");
         if (this.keepKeySdk && !skipSync) {
           console.log("⚡ [FAST PORTFOLIO] Attempting fast load...");
+          console.log(tag6, " checkpoint 3.1 - Calling getUnifiedPortfolio()");
           const fastStart = performance.now();
           try {
             const unifiedResult = await this.getUnifiedPortfolio();
+            console.log(tag6, " checkpoint 3.2 - getUnifiedPortfolio() returned");
             console.log("unifiedResult: ", unifiedResult);
             if (unifiedResult && unifiedResult.cached && unifiedResult.totalValueUsd > 0) {
               console.log(`✅ [FAST PORTFOLIO] Loaded in ${(performance.now() - fastStart).toFixed(0)}ms`);
@@ -6119,7 +6175,16 @@ class SDK {
           const networkId2 = caipToNetworkId7(asset.caip || asset.networkId);
           const currentContextValid = this.pubkeyContext?.networks?.includes(networkId2);
           if (!this.pubkeyContext || !currentContextValid) {
-            this.pubkeyContext = assetPubkeys[0];
+            let preferredPubkey = assetPubkeys[0];
+            const isBitcoin = networkId2?.includes("bip122:000000000019d6689c085ae165831e93") || asset.symbol === "BTC" || asset.name?.toLowerCase().includes("bitcoin");
+            if (isBitcoin) {
+              const nativeSegwitPubkey = assetPubkeys.find((pk) => pk.script_type === "p2wpkh" || pk.scriptType === "p2wpkh" || pk.note?.toLowerCase().includes("native") && pk.note?.toLowerCase().includes("segwit") || pk.pathMaster?.includes("84'"));
+              if (nativeSegwitPubkey) {
+                preferredPubkey = nativeSegwitPubkey;
+                console.log(tag6, "Preferring Native Segwit (Bech32) for Bitcoin");
+              }
+            }
+            this.pubkeyContext = preferredPubkey;
             console.log(tag6, "Auto-set pubkey context for network:", this.pubkeyContext.address || this.pubkeyContext.pubkey);
           } else {
             console.log(tag6, "Preserving existing pubkey context for network:", this.pubkeyContext.address || this.pubkeyContext.pubkey, `(addressNList: [${(this.pubkeyContext.addressNList || this.pubkeyContext.addressNListMaster).join(", ")}])`);

package/dist/index.js

@@ -427,6 +427,17 @@ function processPortfolioBalance(balance, primaryAddress, context, blockchains)
       console.log(tag2, `Calculated price from value/balance: ${calculatedPrice} for ${balance.caip}`);
     }
   }
+  const decimals = assetInfo?.decimals ?? assetInfo?.decimal ?? balance.decimals ?? balance.decimal;
+  if (decimals === undefined || decimals === null) {
+    throw new Error(`CRITICAL: Asset ${balance.caip} (${assetInfo?.symbol || balance.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({
+      caip: balance.caip,
+      symbol: assetInfo?.symbol || balance.symbol,
+      hasAssetInfoDecimals: !!assetInfo?.decimals,
+      hasAssetInfoDecimal: !!assetInfo?.decimal,
+      hasBalanceDecimals: !!balance.decimals,
+      hasBalanceDecimal: !!balance.decimal
+    })}`);
+  }
   const chartBalance = {
     context,
     chart: "pioneer",
@@ -443,7 +454,9 @@ function processPortfolioBalance(balance, primaryAddress, context, blockchains)
     symbol: assetInfo?.symbol || balance.symbol || "UNK",
     type: balanceType,
     token: isToken,
-    decimal: assetInfo?.decimal || balance.decimal,
+    decimal: decimals,
+    decimals,
+    precision: decimals,
     balance: balance.balance.toString(),
     price: calculatedPrice,
     priceUsd: calculatedPrice,
@@ -474,6 +487,17 @@ function processPortfolioToken(token, primaryAddress, context, blockchains) {
   }
   const tokenAssetInfo = hydrateAssetData(token.assetCaip);
   const tokenPubkey = token.pubkey || primaryAddress;
+  const tokenDecimals = tokenAssetInfo?.decimals ?? tokenAssetInfo?.decimal ?? token.token?.decimals ?? token.token?.decimal;
+  if (tokenDecimals === undefined || tokenDecimals === null) {
+    throw new Error(`CRITICAL: Token ${token.assetCaip} (${tokenAssetInfo?.symbol || token.token?.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Token data: ${JSON.stringify({
+      caip: token.assetCaip,
+      symbol: tokenAssetInfo?.symbol || token.token?.symbol,
+      hasAssetInfoDecimals: !!tokenAssetInfo?.decimals,
+      hasAssetInfoDecimal: !!tokenAssetInfo?.decimal,
+      hasTokenDecimals: !!token.token?.decimals,
+      hasTokenDecimal: !!token.token?.decimal
+    })}`);
+  }
   const chartBalance = {
     context,
     chart: "pioneer",
@@ -489,7 +513,9 @@ function processPortfolioToken(token, primaryAddress, context, blockchains) {
     symbol: tokenAssetInfo?.symbol || token.token?.symbol || "UNK",
     type: tokenAssetInfo?.type || "token",
     token: true,
-    decimal: tokenAssetInfo?.decimal || token.token?.decimal,
+    decimal: tokenDecimals,
+    decimals: tokenDecimals,
+    precision: tokenDecimals,
     balance: token.token?.balance?.toString() || "0",
     priceUsd: token.token?.price || 0,
     valueUsd: token.token?.balanceUSD || 0,
@@ -596,6 +622,17 @@ async function getMayaCharts(params, existingBalances) {
       }
       const mayaAssetInfo = hydrateAssetData(mayaBalance.caip);
       const isToken = mayaBalance.caip.includes("/denom:") && !mayaBalance.caip.endsWith("/denom:cacao");
+      const decimals = mayaAssetInfo?.decimals ?? mayaAssetInfo?.decimal ?? mayaBalance.decimals ?? mayaBalance.decimal;
+      if (decimals === undefined || decimals === null) {
+        throw new Error(`CRITICAL: Asset ${mayaBalance.caip} (${mayaAssetInfo?.symbol || "MAYA"}) has NO decimals/precision! ` + `This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({
+          caip: mayaBalance.caip,
+          symbol: mayaAssetInfo?.symbol,
+          hasAssetInfoDecimals: !!mayaAssetInfo?.decimals,
+          hasAssetInfoDecimal: !!mayaAssetInfo?.decimal,
+          hasBalanceDecimals: !!mayaBalance.decimals,
+          hasBalanceDecimal: !!mayaBalance.decimal
+        })}`);
+      }
       const mayaTokenBalance = {
         context,
         chart: "pioneer",
@@ -611,7 +648,9 @@ async function getMayaCharts(params, existingBalances) {
         symbol: mayaAssetInfo?.symbol || "MAYA",
         type: mayaAssetInfo?.type || "token",
         token: isToken,
-        decimal: mayaAssetInfo?.decimal,
+        decimal: decimals,
+        decimals,
+        precision: decimals,
         balance: mayaBalance.balance?.toString() || "0",
         priceUsd: parseFloat(mayaBalance.priceUsd) || 0,
         valueUsd: parseFloat(mayaBalance.valueUsd) || 0,
@@ -4588,6 +4627,10 @@ function enrichBalancesWithAssetInfo(balances, assetsMap, caipToNetworkId7) {
     const explorerUrls = EXPLORER_BASE_URLS[networkId];
     const explorerAddressLink = explorerUrls && balance.pubkey ? explorerUrls.address + balance.pubkey : undefined;
     const explorerTxLink = explorerUrls?.tx;
+    const decimals = assetInfo.decimals ?? balance.decimals;
+    if (decimals === undefined || decimals === null) {
+      throw new Error(`CRITICAL: Asset ${balance.caip} (${assetInfo.symbol || "UNKNOWN"}) has NO decimals/precision! ` + `AssetInfo is incomplete. This would cause incorrect balance calculations. ` + `Asset data: ${JSON.stringify({ caip: balance.caip, symbol: assetInfo.symbol, hasDecimals: !!assetInfo.decimals })}`);
+    }
     Object.assign(balance, assetInfo, {
       type: balance.type || assetInfo.type,
       isNative: balance.isNative ?? assetInfo.isNative,
@@ -4596,7 +4639,8 @@ function enrichBalancesWithAssetInfo(balances, assetsMap, caipToNetworkId7) {
       identifier: `${balance.caip}:${balance.pubkey}`,
       updated: Date.now(),
       color: assetInfo.color,
-      decimals: assetInfo.decimals || balance.decimals || 8,
+      decimals,
+      precision: decimals,
       explorerAddressLink,
       explorerTxLink,
       explorer: explorerUrls?.address,
@@ -4977,14 +5021,17 @@ class SDK {
     this.getUnifiedPortfolio = async function() {
       const tag6 = `${TAG12} | getUnifiedPortfolio | `;
       try {
+        console.log(tag6, " checkpoint 4.0 - getUnifiedPortfolio start");
         const startTime = performance.now();
         try {
           const baseUrl = this.keepkeyEndpoint?.baseUrl || "kkapi://";
           const portfolioUrl = `${baseUrl}/api/portfolio`;
+          console.log(tag6, " checkpoint 4.1 - Fetching portfolio from:", portfolioUrl);
           const portfolioResponse = await fetch(portfolioUrl, {
             method: "GET",
             signal: AbortSignal.timeout(2000)
           });
+          console.log(tag6, " checkpoint 4.2 - Portfolio fetch returned, status:", portfolioResponse.status);
           if (!portfolioResponse.ok) {
             console.warn(tag6, "Portfolio endpoint returned", portfolioResponse.status);
             return null;
@@ -5097,7 +5144,9 @@ class SDK {
               };
               console.log("\uD83D\uDD11 [INIT] Initializing KeepKey SDK...");
               const keepKeySdk = await KeepKeySdk.create(configKeepKey);
+              console.log(tag6, " checkpoint 1.1 - KeepKeySdk created");
               const features = await keepKeySdk.system.info.getFeatures();
+              console.log(tag6, " checkpoint 1.2 - features retrieved:", features);
               this.keepkeyApiKey = configKeepKey.apiKey;
               this.keepKeySdk = keepKeySdk;
               this.context = "keepkey:" + features.label + ".json";
@@ -5111,14 +5160,18 @@ class SDK {
           console.log("\uD83D\uDC41️ [VIEW-ONLY] Skipping vault endpoint detection");
           this.keepkeyEndpoint = null;
         }
+        console.log(tag6, " checkpoint 2 - Starting WebSocket initialization");
         let configWss = {
           username: this.username,
           queryKey: this.queryKey,
           wss: this.wss
         };
         let clientEvents = new Events(configWss);
+        console.log(tag6, " checkpoint 2.1 - Events created, calling init()");
         await clientEvents.init();
+        console.log(tag6, " checkpoint 2.2 - Events init complete, setting username");
         await clientEvents.setUsername(this.username);
+        console.log(tag6, " checkpoint 2.3 - Username set, WebSocket ready");
         clientEvents.events.on("message", (request) => {
           this.events.emit("message", request);
         });
@@ -5184,11 +5237,14 @@ class SDK {
           }
         });
         this.events.emit("SET_STATUS", "init");
+        console.log(tag6, " checkpoint 3 - Starting fast portfolio check");
         if (this.keepKeySdk && !skipSync) {
           console.log("⚡ [FAST PORTFOLIO] Attempting fast load...");
+          console.log(tag6, " checkpoint 3.1 - Calling getUnifiedPortfolio()");
           const fastStart = performance.now();
           try {
             const unifiedResult = await this.getUnifiedPortfolio();
+            console.log(tag6, " checkpoint 3.2 - getUnifiedPortfolio() returned");
             console.log("unifiedResult: ", unifiedResult);
             if (unifiedResult && unifiedResult.cached && unifiedResult.totalValueUsd > 0) {
               console.log(`✅ [FAST PORTFOLIO] Loaded in ${(performance.now() - fastStart).toFixed(0)}ms`);
@@ -6119,7 +6175,16 @@ class SDK {
           const networkId2 = caipToNetworkId7(asset.caip || asset.networkId);
           const currentContextValid = this.pubkeyContext?.networks?.includes(networkId2);
           if (!this.pubkeyContext || !currentContextValid) {
-            this.pubkeyContext = assetPubkeys[0];
+            let preferredPubkey = assetPubkeys[0];
+            const isBitcoin = networkId2?.includes("bip122:000000000019d6689c085ae165831e93") || asset.symbol === "BTC" || asset.name?.toLowerCase().includes("bitcoin");
+            if (isBitcoin) {
+              const nativeSegwitPubkey = assetPubkeys.find((pk) => pk.script_type === "p2wpkh" || pk.scriptType === "p2wpkh" || pk.note?.toLowerCase().includes("native") && pk.note?.toLowerCase().includes("segwit") || pk.pathMaster?.includes("84'"));
+              if (nativeSegwitPubkey) {
+                preferredPubkey = nativeSegwitPubkey;
+                console.log(tag6, "Preferring Native Segwit (Bech32) for Bitcoin");
+              }
+            }
+            this.pubkeyContext = preferredPubkey;
             console.log(tag6, "Auto-set pubkey context for network:", this.pubkeyContext.address || this.pubkeyContext.pubkey);
           } else {
             console.log(tag6, "Preserving existing pubkey context for network:", this.pubkeyContext.address || this.pubkeyContext.pubkey, `(addressNList: [${(this.pubkeyContext.addressNList || this.pubkeyContext.addressNListMaster).join(", ")}])`);

package/package.json

@@ -1,14 +1,14 @@
 {
   "author": "highlander",
   "name": "@pioneer-platform/pioneer-sdk",
-  "version": "8.15.33",
+  "version": "8.15.38",
   "dependencies": {
     "@keepkey/keepkey-sdk": "^0.2.62",
-    "@pioneer-platform/pioneer-caip": "^9.10.10",
-    "@pioneer-platform/pioneer-client": "^9.10.16",
-    "@pioneer-platform/pioneer-coins": "^9.11.10",
-    "@pioneer-platform/pioneer-discovery": "^8.15.33",
-    "@pioneer-platform/pioneer-events": "^8.12.5",
+    "@pioneer-platform/pioneer-caip": "^9.10.15",
+    "@pioneer-platform/pioneer-client": "^9.10.21",
+    "@pioneer-platform/pioneer-coins": "^9.11.15",
+    "@pioneer-platform/pioneer-discovery": "^8.15.38",
+    "@pioneer-platform/pioneer-events": "^8.12.10",
     "coinselect": "^3.1.13",
     "eventemitter3": "^5.0.1",
     "neotraverse": "^0.6.8",

package/src/charts/evm.ts

@@ -178,6 +178,25 @@ function processPortfolioBalance(
     }
   }
 
+  // CRITICAL: FAIL FAST if decimals/precision is missing
+  // Extract decimals from multiple possible sources (assetInfo, balance API response)
+  const decimals = assetInfo?.decimals ?? assetInfo?.decimal ?? balance.decimals ?? balance.decimal;
+
+  if (decimals === undefined || decimals === null) {
+    throw new Error(
+      `CRITICAL: Asset ${balance.caip} (${assetInfo?.symbol || balance.symbol || 'UNKNOWN'}) has NO decimals/precision! ` +
+      `This would cause incorrect balance calculations. ` +
+      `Asset data: ${JSON.stringify({
+        caip: balance.caip,
+        symbol: assetInfo?.symbol || balance.symbol,
+        hasAssetInfoDecimals: !!assetInfo?.decimals,
+        hasAssetInfoDecimal: !!assetInfo?.decimal,
+        hasBalanceDecimals: !!balance.decimals,
+        hasBalanceDecimal: !!balance.decimal
+      })}`
+    );
+  }
+
   const chartBalance: ChartBalance = {
     context,
     chart: 'pioneer',
@@ -194,7 +213,10 @@ function processPortfolioBalance(
     symbol: assetInfo?.symbol || balance.symbol || 'UNK',
     type: balanceType,
     token: isToken,
-    decimal: assetInfo?.decimal || balance.decimal,
+    // CRITICAL: Set BOTH decimal (legacy) and decimals/precision (new standard)
+    decimal: decimals,
+    decimals: decimals,
+    precision: decimals,
     balance: balance.balance.toString(),
     price: calculatedPrice,
     priceUsd: calculatedPrice,
@@ -244,10 +266,28 @@ function processPortfolioToken(
 
   // Hydrate token with assetData
   const tokenAssetInfo = hydrateAssetData(token.assetCaip);
-  
+
   // CRITICAL FIX: Use consistent pubkey for tokens too
   const tokenPubkey = token.pubkey || primaryAddress;
 
+  // CRITICAL: FAIL FAST if decimals/precision is missing for tokens
+  const tokenDecimals = tokenAssetInfo?.decimals ?? tokenAssetInfo?.decimal ?? token.token?.decimals ?? token.token?.decimal;
+
+  if (tokenDecimals === undefined || tokenDecimals === null) {
+    throw new Error(
+      `CRITICAL: Token ${token.assetCaip} (${tokenAssetInfo?.symbol || token.token?.symbol || 'UNKNOWN'}) has NO decimals/precision! ` +
+      `This would cause incorrect balance calculations. ` +
+      `Token data: ${JSON.stringify({
+        caip: token.assetCaip,
+        symbol: tokenAssetInfo?.symbol || token.token?.symbol,
+        hasAssetInfoDecimals: !!tokenAssetInfo?.decimals,
+        hasAssetInfoDecimal: !!tokenAssetInfo?.decimal,
+        hasTokenDecimals: !!token.token?.decimals,
+        hasTokenDecimal: !!token.token?.decimal
+      })}`
+    );
+  }
+
   const chartBalance: ChartBalance = {
     context,
     chart: 'pioneer',
@@ -263,7 +303,10 @@ function processPortfolioToken(
     symbol: tokenAssetInfo?.symbol || token.token?.symbol || 'UNK',
     type: tokenAssetInfo?.type || 'token',
     token: true,  // Tokens from portfolio.tokens are always tokens
-    decimal: tokenAssetInfo?.decimal || token.token?.decimal,
+    // CRITICAL: Set ALL decimal fields for compatibility
+    decimal: tokenDecimals,
+    decimals: tokenDecimals,
+    precision: tokenDecimals,
     balance: token.token?.balance?.toString() || '0',
     priceUsd: token.token?.price || 0,
     valueUsd: token.token?.balanceUSD || 0,

package/src/charts/maya.ts

@@ -79,7 +79,26 @@ export async function getMayaCharts(
 
       // CACAO is the native asset, MAYA is a token on the Maya chain
       const isToken = mayaBalance.caip.includes('/denom:') && !mayaBalance.caip.endsWith('/denom:cacao');
-      
+
+      // CRITICAL: FAIL FAST if decimals/precision is missing
+      // Extract decimals from multiple possible sources (assetInfo, balance API response)
+      const decimals = mayaAssetInfo?.decimals ?? mayaAssetInfo?.decimal ?? mayaBalance.decimals ?? mayaBalance.decimal;
+
+      if (decimals === undefined || decimals === null) {
+        throw new Error(
+          `CRITICAL: Asset ${mayaBalance.caip} (${mayaAssetInfo?.symbol || 'MAYA'}) has NO decimals/precision! ` +
+          `This would cause incorrect balance calculations. ` +
+          `Asset data: ${JSON.stringify({
+            caip: mayaBalance.caip,
+            symbol: mayaAssetInfo?.symbol,
+            hasAssetInfoDecimals: !!mayaAssetInfo?.decimals,
+            hasAssetInfoDecimal: !!mayaAssetInfo?.decimal,
+            hasBalanceDecimals: !!mayaBalance.decimals,
+            hasBalanceDecimal: !!mayaBalance.decimal
+          })}`
+        );
+      }
+
       const mayaTokenBalance: ChartBalance = {
         context,
         chart: 'pioneer',
@@ -95,7 +114,10 @@ export async function getMayaCharts(
         symbol: mayaAssetInfo?.symbol || 'MAYA',
         type: mayaAssetInfo?.type || 'token',
         token: isToken,  // MAYA is a token, CACAO is the native asset
-        decimal: mayaAssetInfo?.decimal,
+        // CRITICAL: Set BOTH decimal (legacy) and decimals/precision (new standard)
+        decimal: decimals,
+        decimals: decimals,
+        precision: decimals,
         balance: mayaBalance.balance?.toString() || '0',
         priceUsd: parseFloat(mayaBalance.priceUsd) || 0,
         valueUsd: parseFloat(mayaBalance.valueUsd) || 0,

package/src/index.ts

@@ -333,6 +333,7 @@ export class SDK {
     this.getUnifiedPortfolio = async function () {
       const tag = `${TAG} | getUnifiedPortfolio | `;
       try {
+        console.log(tag,' checkpoint 4.0 - getUnifiedPortfolio start')
         const startTime = performance.now();
 
         // Check if kkapi is available and use the detected endpoint
@@ -340,11 +341,13 @@ export class SDK {
           // Use the detected endpoint instead of hardcoded kkapi://
           const baseUrl = this.keepkeyEndpoint?.baseUrl || 'kkapi://';
           const portfolioUrl = `${baseUrl}/api/portfolio`;
+          console.log(tag,' checkpoint 4.1 - Fetching portfolio from:', portfolioUrl)
 
           const portfolioResponse = await fetch(portfolioUrl, {
             method: 'GET',
             signal: AbortSignal.timeout(2000), // 2 second timeout
           });
+          console.log(tag,' checkpoint 4.2 - Portfolio fetch returned, status:', portfolioResponse.status)
 
           if (!portfolioResponse.ok) {
             console.warn(tag, 'Portfolio endpoint returned', portfolioResponse.status);
@@ -495,8 +498,9 @@ export class SDK {
 
               console.log('🔑 [INIT] Initializing KeepKey SDK...');
               const keepKeySdk = await KeepKeySdk.create(configKeepKey);
+              console.log(tag,' checkpoint 1.1 - KeepKeySdk created')
               const features = await keepKeySdk.system.info.getFeatures();
-
+              console.log(tag,' checkpoint 1.2 - features retrieved:', features)
               this.keepkeyApiKey = configKeepKey.apiKey;
               this.keepKeySdk = keepKeySdk;
               this.context = 'keepkey:' + features.label + '.json';
@@ -512,6 +516,7 @@ export class SDK {
         }
 
         // Initialize WebSocket events
+        console.log(tag,' checkpoint 2 - Starting WebSocket initialization')
         let configWss = {
           username: this.username,
           queryKey: this.queryKey,
@@ -519,8 +524,11 @@ export class SDK {
         };
 
         let clientEvents = new Events(configWss);
+        console.log(tag,' checkpoint 2.1 - Events created, calling init()')
         await clientEvents.init();
+        console.log(tag,' checkpoint 2.2 - Events init complete, setting username')
         await clientEvents.setUsername(this.username);
+        console.log(tag,' checkpoint 2.3 - Username set, WebSocket ready')
 
         clientEvents.events.on('message', (request) => {
           this.events.emit('message', request);
@@ -620,12 +628,15 @@ export class SDK {
         this.events.emit('SET_STATUS', 'init');
 
         // Fast Portfolio Pattern: Try unified portfolio first, then sync if needed
+        console.log(tag,' checkpoint 3 - Starting fast portfolio check')
         if (this.keepKeySdk && !skipSync) {
           console.log('⚡ [FAST PORTFOLIO] Attempting fast load...');
+          console.log(tag,' checkpoint 3.1 - Calling getUnifiedPortfolio()')
           const fastStart = performance.now();
 
           try {
             const unifiedResult = await this.getUnifiedPortfolio();
+            console.log(tag,' checkpoint 3.2 - getUnifiedPortfolio() returned')
             console.log('unifiedResult: ', unifiedResult);
 
             if (unifiedResult && unifiedResult.cached && unifiedResult.totalValueUsd > 0) {
@@ -1976,8 +1987,30 @@ export class SDK {
           const currentContextValid = this.pubkeyContext?.networks?.includes(networkId);
 
           if (!this.pubkeyContext || !currentContextValid) {
-            // No context or wrong network - auto-set to first matching pubkey
-            this.pubkeyContext = assetPubkeys[0];
+            // No context or wrong network - auto-set to preferred pubkey
+            // For Bitcoin, prefer Native Segwit (Bech32) over legacy
+            let preferredPubkey = assetPubkeys[0];
+
+            const isBitcoin = networkId?.includes('bip122:000000000019d6689c085ae165831e93') ||
+                             asset.symbol === 'BTC' ||
+                             asset.name?.toLowerCase().includes('bitcoin');
+
+            if (isBitcoin) {
+              // Find Native Segwit pubkey (script_type: 'p2wpkh', path includes 84')
+              const nativeSegwitPubkey = assetPubkeys.find((pk: any) =>
+                pk.script_type === 'p2wpkh' ||
+                pk.scriptType === 'p2wpkh' ||
+                (pk.note?.toLowerCase().includes('native') && pk.note?.toLowerCase().includes('segwit')) ||
+                pk.pathMaster?.includes("84'")
+              );
+
+              if (nativeSegwitPubkey) {
+                preferredPubkey = nativeSegwitPubkey;
+                console.log(tag, 'Preferring Native Segwit (Bech32) for Bitcoin');
+              }
+            }
+
+            this.pubkeyContext = preferredPubkey;
             console.log(
               tag,
               'Auto-set pubkey context for network:',

package/src/utils/portfolio-helpers.ts

@@ -345,6 +345,17 @@ export function enrichBalancesWithAssetInfo(
 
     const explorerTxLink = explorerUrls?.tx; // Base URL for txs, actual txid added later
 
+    // CRITICAL: NEVER default decimals to 8 - this causes incorrect balance calculations
+    // If decimals is missing, the asset data is incomplete and we should FAIL FAST
+    const decimals = assetInfo.decimals ?? balance.decimals;
+    if (decimals === undefined || decimals === null) {
+      throw new Error(
+        `CRITICAL: Asset ${balance.caip} (${assetInfo.symbol || 'UNKNOWN'}) has NO decimals/precision! ` +
+        `AssetInfo is incomplete. This would cause incorrect balance calculations. ` +
+        `Asset data: ${JSON.stringify({ caip: balance.caip, symbol: assetInfo.symbol, hasDecimals: !!assetInfo.decimals })}`
+      );
+    }
+
     Object.assign(balance, assetInfo, {
       type: balance.type || assetInfo.type,
       isNative: balance.isNative ?? assetInfo.isNative,
@@ -353,8 +364,9 @@ export function enrichBalancesWithAssetInfo(
       identifier: `${balance.caip}:${balance.pubkey}`,
       updated: Date.now(),
       color: assetInfo.color,
-      // CRITICAL: Always use decimals from assetInfo if available
-      decimals: assetInfo.decimals || balance.decimals || 8,
+      // CRITICAL: Use validated decimals
+      decimals,
+      precision: decimals, // Also set precision for compatibility
       // Add explorer links
       explorerAddressLink,
       explorerTxLink,