@pioneer-platform/pioneer-sdk 8.11.8 → 8.11.9

package/dist/index.cjs

@@ -3705,6 +3705,22 @@ async function syncMarket(balances, pioneer) {
 
 // src/index.ts
 var TAG9 = " | Pioneer-sdk | ";
+var ASSET_COLORS = {
+  "bip122:000000000019d6689c085ae165831e93/slip44:0": "#FF9800",
+  "eip155:1/slip44:60": "#627EEA",
+  "eip155:137/slip44:60": "#8247E5",
+  "eip155:8453/slip44:60": "#0052FF",
+  "eip155:56/slip44:60": "#F3BA2F",
+  "bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2": "#BFBBBB",
+  "bip122:00000000001a91e3dace36e2be3bf030/slip44:3": "#C2A633",
+  "bip122:000000000000000000651ef99cb9fcbe/slip44:145": "#8DC351",
+  "bip122:000007d91d1254d60e2dd1ae58038307/slip44:5": "#008CE7",
+  "cosmos:cosmoshub-4/slip44:118": "#2E3148",
+  "cosmos:osmosis-1/slip44:118": "#9B1FD7",
+  "ripple:4109c6f2045fc7eff4cde8f9905d19c2/slip44:144": "#23292F",
+  "cosmos:mayachain-mainnet-v1/slip44:931": "#00D4AA",
+  "cosmos:thorchain-mainnet-v1/slip44:931": "#00CCFF"
+};
 
 class SDK {
   status;
@@ -3725,6 +3741,7 @@ class SDK {
   outboundBlockchainContext;
   outboundPubkeyContext;
   buildDashboardFromBalances;
+  syncState;
   pioneer;
   charts;
   paths;
@@ -3767,6 +3784,8 @@ class SDK {
   estimateTransactionFee;
   getCharts;
   keepKeySdk;
+  getSyncState;
+  isSynced;
   getGasAssets;
   transactions;
   transfer;
@@ -3826,6 +3845,16 @@ class SDK {
     this.utxoApiKey = config.utxoApiKey;
     this.walletConnectProjectId = config.walletConnectProjectId;
     this.contextType = "";
+    this.syncState = {
+      isSynced: false,
+      isInitialSync: true,
+      cacheAge: 0,
+      syncProgress: 0,
+      syncedChains: 0,
+      totalChains: this.blockchains.length,
+      lastSyncTime: null,
+      syncSource: "none"
+    };
     this.offlineClient = config.offlineFirst ? new OfflineClient({
       vaultUrl: config.vaultUrl || "kkapi://",
       timeout: 1000,
@@ -3960,6 +3989,18 @@ class SDK {
             };
             this.dashboard = dashboardData;
             this.events.emit("SET_DASHBOARD", this.dashboard);
+            const cacheAge = portfolioData.lastUpdated ? Math.floor((Date.now() - portfolioData.lastUpdated) / 1000) : 0;
+            this.syncState = {
+              isSynced: true,
+              isInitialSync: false,
+              cacheAge,
+              syncProgress: 100,
+              syncedChains: this.blockchains.length,
+              totalChains: this.blockchains.length,
+              lastSyncTime: portfolioData.lastUpdated || Date.now(),
+              syncSource: "cache"
+            };
+            this.events.emit("SYNC_STATE_CHANGED", this.syncState);
           } else {
             console.warn("[CACHE VALIDATION] ❌ Cache data corrupted, building dashboard from cached balances");
             const dashboardData = this.buildDashboardFromBalances();
@@ -3986,6 +4027,12 @@ class SDK {
         return null;
       }
     };
+    this.getSyncState = function() {
+      return this.syncState;
+    };
+    this.isSynced = function() {
+      return this.syncState.isSynced;
+    };
     this.init = async function(walletsVerbose, setup) {
       const tag6 = `${TAG9} | init | `;
       try {
@@ -4042,6 +4089,53 @@ class SDK {
         clientEvents.events.on("message", (request) => {
           this.events.emit("message", request);
         });
+        clientEvents.events.on("balance:update", (data) => {
+          const tag7 = TAG9 + " | balance:update | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            const balance = payload.balance;
+            console.log(tag7, "Received balance update:", balance.caip);
+            const exists = this.balances.find((b) => b.caip === balance.caip && b.pubkey === balance.pubkey);
+            if (!exists) {
+              this.balances.push(balance);
+            } else {
+              const index = this.balances.findIndex((b) => b.caip === balance.caip && b.pubkey === balance.pubkey);
+              this.balances[index] = balance;
+            }
+            this.events.emit("BALANCE_UPDATE", balance);
+          } catch (e) {
+            console.error(tag7, "Error processing balance update:", e);
+          }
+        });
+        clientEvents.events.on("sync:progress", (data) => {
+          const tag7 = TAG9 + " | sync:progress | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            console.log(tag7, `Sync progress: ${payload.percentage}%`);
+            this.syncState.syncProgress = payload.percentage;
+            this.syncState.syncedChains = payload.completed;
+            this.syncState.totalChains = payload.total;
+            this.events.emit("SYNC_PROGRESS", this.syncState);
+          } catch (e) {
+            console.error(tag7, "Error processing sync progress:", e);
+          }
+        });
+        clientEvents.events.on("sync:complete", (data) => {
+          const tag7 = TAG9 + " | sync:complete | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            console.log(tag7, `Sync complete: ${payload.balances} balances in ${payload.duration}ms`);
+            this.syncState.isSynced = true;
+            this.syncState.isInitialSync = false;
+            this.syncState.syncProgress = 100;
+            this.syncState.lastSyncTime = Date.now();
+            this.syncState.syncSource = "fresh";
+            this.events.emit("SYNC_COMPLETE", this.syncState);
+            this.events.emit("SYNC_STATE_CHANGED", this.syncState);
+          } catch (e) {
+            console.error(tag7, "Error processing sync complete:", e);
+          }
+        });
         this.events.emit("SET_STATUS", "init");
         if (this.keepKeySdk && !skipSync) {
           console.log("⚡ [FAST PORTFOLIO] Attempting fast load...");
@@ -4200,6 +4294,18 @@ class SDK {
           percentage: totalPortfolioValue > 0 ? Number((network.totalValueUsd / totalPortfolioValue * 100).toFixed(2)) : 0
         })).filter((entry) => entry.percentage > 0);
         this.dashboard = dashboardData;
+        this.syncState = {
+          isSynced: true,
+          isInitialSync: false,
+          cacheAge: 0,
+          syncProgress: 100,
+          syncedChains: this.blockchains.length,
+          totalChains: this.blockchains.length,
+          lastSyncTime: Date.now(),
+          syncSource: "fresh"
+        };
+        this.events.emit("SYNC_STATE_CHANGED", this.syncState);
+        this.events.emit("SYNC_COMPLETE", this.syncState);
         return true;
       } catch (e) {
         console.error(tag6, "Error in sync:", e);
@@ -4788,14 +4894,16 @@ class SDK {
           console.timeEnd("GetPortfolioBalances Response Time");
           let balances = marketInfo.data;
           for (let balance of balances) {
-            const assetInfo = this.assetsMap.get(balance.caip);
+            const assetInfo = this.assetsMap.get(balance.caip.toLowerCase()) || this.assetsMap.get(balance.caip);
             if (!assetInfo)
               continue;
+            const color = ASSET_COLORS[balance.caip] || assetInfo.color;
             Object.assign(balance, assetInfo, {
               networkId: import_pioneer_caip8.caipToNetworkId(balance.caip),
               icon: assetInfo.icon || "https://pioneers.dev/coins/etherum.png",
               identifier: `${balance.caip}:${balance.pubkey}`,
-              updated: Date.now()
+              updated: Date.now(),
+              color
             });
           }
           this.balances = balances;

package/dist/index.es.js

@@ -3881,6 +3881,22 @@ async function syncMarket(balances, pioneer) {
 
 // src/index.ts
 var TAG9 = " | Pioneer-sdk | ";
+var ASSET_COLORS = {
+  "bip122:000000000019d6689c085ae165831e93/slip44:0": "#FF9800",
+  "eip155:1/slip44:60": "#627EEA",
+  "eip155:137/slip44:60": "#8247E5",
+  "eip155:8453/slip44:60": "#0052FF",
+  "eip155:56/slip44:60": "#F3BA2F",
+  "bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2": "#BFBBBB",
+  "bip122:00000000001a91e3dace36e2be3bf030/slip44:3": "#C2A633",
+  "bip122:000000000000000000651ef99cb9fcbe/slip44:145": "#8DC351",
+  "bip122:000007d91d1254d60e2dd1ae58038307/slip44:5": "#008CE7",
+  "cosmos:cosmoshub-4/slip44:118": "#2E3148",
+  "cosmos:osmosis-1/slip44:118": "#9B1FD7",
+  "ripple:4109c6f2045fc7eff4cde8f9905d19c2/slip44:144": "#23292F",
+  "cosmos:mayachain-mainnet-v1/slip44:931": "#00D4AA",
+  "cosmos:thorchain-mainnet-v1/slip44:931": "#00CCFF"
+};
 
 class SDK {
   status;
@@ -3901,6 +3917,7 @@ class SDK {
   outboundBlockchainContext;
   outboundPubkeyContext;
   buildDashboardFromBalances;
+  syncState;
   pioneer;
   charts;
   paths;
@@ -3943,6 +3960,8 @@ class SDK {
   estimateTransactionFee;
   getCharts;
   keepKeySdk;
+  getSyncState;
+  isSynced;
   getGasAssets;
   transactions;
   transfer;
@@ -4002,6 +4021,16 @@ class SDK {
     this.utxoApiKey = config.utxoApiKey;
     this.walletConnectProjectId = config.walletConnectProjectId;
     this.contextType = "";
+    this.syncState = {
+      isSynced: false,
+      isInitialSync: true,
+      cacheAge: 0,
+      syncProgress: 0,
+      syncedChains: 0,
+      totalChains: this.blockchains.length,
+      lastSyncTime: null,
+      syncSource: "none"
+    };
     this.offlineClient = config.offlineFirst ? new OfflineClient({
       vaultUrl: config.vaultUrl || "kkapi://",
       timeout: 1000,
@@ -4136,6 +4165,18 @@ class SDK {
             };
             this.dashboard = dashboardData;
             this.events.emit("SET_DASHBOARD", this.dashboard);
+            const cacheAge = portfolioData.lastUpdated ? Math.floor((Date.now() - portfolioData.lastUpdated) / 1000) : 0;
+            this.syncState = {
+              isSynced: true,
+              isInitialSync: false,
+              cacheAge,
+              syncProgress: 100,
+              syncedChains: this.blockchains.length,
+              totalChains: this.blockchains.length,
+              lastSyncTime: portfolioData.lastUpdated || Date.now(),
+              syncSource: "cache"
+            };
+            this.events.emit("SYNC_STATE_CHANGED", this.syncState);
           } else {
             console.warn("[CACHE VALIDATION] ❌ Cache data corrupted, building dashboard from cached balances");
             const dashboardData = this.buildDashboardFromBalances();
@@ -4162,6 +4203,12 @@ class SDK {
         return null;
       }
     };
+    this.getSyncState = function() {
+      return this.syncState;
+    };
+    this.isSynced = function() {
+      return this.syncState.isSynced;
+    };
     this.init = async function(walletsVerbose, setup) {
       const tag6 = `${TAG9} | init | `;
       try {
@@ -4218,6 +4265,53 @@ class SDK {
         clientEvents.events.on("message", (request) => {
           this.events.emit("message", request);
         });
+        clientEvents.events.on("balance:update", (data) => {
+          const tag7 = TAG9 + " | balance:update | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            const balance = payload.balance;
+            console.log(tag7, "Received balance update:", balance.caip);
+            const exists = this.balances.find((b2) => b2.caip === balance.caip && b2.pubkey === balance.pubkey);
+            if (!exists) {
+              this.balances.push(balance);
+            } else {
+              const index = this.balances.findIndex((b2) => b2.caip === balance.caip && b2.pubkey === balance.pubkey);
+              this.balances[index] = balance;
+            }
+            this.events.emit("BALANCE_UPDATE", balance);
+          } catch (e) {
+            console.error(tag7, "Error processing balance update:", e);
+          }
+        });
+        clientEvents.events.on("sync:progress", (data) => {
+          const tag7 = TAG9 + " | sync:progress | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            console.log(tag7, `Sync progress: ${payload.percentage}%`);
+            this.syncState.syncProgress = payload.percentage;
+            this.syncState.syncedChains = payload.completed;
+            this.syncState.totalChains = payload.total;
+            this.events.emit("SYNC_PROGRESS", this.syncState);
+          } catch (e) {
+            console.error(tag7, "Error processing sync progress:", e);
+          }
+        });
+        clientEvents.events.on("sync:complete", (data) => {
+          const tag7 = TAG9 + " | sync:complete | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            console.log(tag7, `Sync complete: ${payload.balances} balances in ${payload.duration}ms`);
+            this.syncState.isSynced = true;
+            this.syncState.isInitialSync = false;
+            this.syncState.syncProgress = 100;
+            this.syncState.lastSyncTime = Date.now();
+            this.syncState.syncSource = "fresh";
+            this.events.emit("SYNC_COMPLETE", this.syncState);
+            this.events.emit("SYNC_STATE_CHANGED", this.syncState);
+          } catch (e) {
+            console.error(tag7, "Error processing sync complete:", e);
+          }
+        });
         this.events.emit("SET_STATUS", "init");
         if (this.keepKeySdk && !skipSync) {
           console.log("⚡ [FAST PORTFOLIO] Attempting fast load...");
@@ -4376,6 +4470,18 @@ class SDK {
           percentage: totalPortfolioValue > 0 ? Number((network.totalValueUsd / totalPortfolioValue * 100).toFixed(2)) : 0
         })).filter((entry) => entry.percentage > 0);
         this.dashboard = dashboardData;
+        this.syncState = {
+          isSynced: true,
+          isInitialSync: false,
+          cacheAge: 0,
+          syncProgress: 100,
+          syncedChains: this.blockchains.length,
+          totalChains: this.blockchains.length,
+          lastSyncTime: Date.now(),
+          syncSource: "fresh"
+        };
+        this.events.emit("SYNC_STATE_CHANGED", this.syncState);
+        this.events.emit("SYNC_COMPLETE", this.syncState);
         return true;
       } catch (e) {
         console.error(tag6, "Error in sync:", e);
@@ -4964,14 +5070,16 @@ class SDK {
           console.timeEnd("GetPortfolioBalances Response Time");
           let balances = marketInfo.data;
           for (let balance of balances) {
-            const assetInfo = this.assetsMap.get(balance.caip);
+            const assetInfo = this.assetsMap.get(balance.caip.toLowerCase()) || this.assetsMap.get(balance.caip);
             if (!assetInfo)
               continue;
+            const color = ASSET_COLORS[balance.caip] || assetInfo.color;
             Object.assign(balance, assetInfo, {
               networkId: caipToNetworkId7(balance.caip),
               icon: assetInfo.icon || "https://pioneers.dev/coins/etherum.png",
               identifier: `${balance.caip}:${balance.pubkey}`,
-              updated: Date.now()
+              updated: Date.now(),
+              color
             });
           }
           this.balances = balances;

package/dist/index.js

@@ -3881,6 +3881,22 @@ async function syncMarket(balances, pioneer) {
 
 // src/index.ts
 var TAG9 = " | Pioneer-sdk | ";
+var ASSET_COLORS = {
+  "bip122:000000000019d6689c085ae165831e93/slip44:0": "#FF9800",
+  "eip155:1/slip44:60": "#627EEA",
+  "eip155:137/slip44:60": "#8247E5",
+  "eip155:8453/slip44:60": "#0052FF",
+  "eip155:56/slip44:60": "#F3BA2F",
+  "bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2": "#BFBBBB",
+  "bip122:00000000001a91e3dace36e2be3bf030/slip44:3": "#C2A633",
+  "bip122:000000000000000000651ef99cb9fcbe/slip44:145": "#8DC351",
+  "bip122:000007d91d1254d60e2dd1ae58038307/slip44:5": "#008CE7",
+  "cosmos:cosmoshub-4/slip44:118": "#2E3148",
+  "cosmos:osmosis-1/slip44:118": "#9B1FD7",
+  "ripple:4109c6f2045fc7eff4cde8f9905d19c2/slip44:144": "#23292F",
+  "cosmos:mayachain-mainnet-v1/slip44:931": "#00D4AA",
+  "cosmos:thorchain-mainnet-v1/slip44:931": "#00CCFF"
+};
 
 class SDK {
   status;
@@ -3901,6 +3917,7 @@ class SDK {
   outboundBlockchainContext;
   outboundPubkeyContext;
   buildDashboardFromBalances;
+  syncState;
   pioneer;
   charts;
   paths;
@@ -3943,6 +3960,8 @@ class SDK {
   estimateTransactionFee;
   getCharts;
   keepKeySdk;
+  getSyncState;
+  isSynced;
   getGasAssets;
   transactions;
   transfer;
@@ -4002,6 +4021,16 @@ class SDK {
     this.utxoApiKey = config.utxoApiKey;
     this.walletConnectProjectId = config.walletConnectProjectId;
     this.contextType = "";
+    this.syncState = {
+      isSynced: false,
+      isInitialSync: true,
+      cacheAge: 0,
+      syncProgress: 0,
+      syncedChains: 0,
+      totalChains: this.blockchains.length,
+      lastSyncTime: null,
+      syncSource: "none"
+    };
     this.offlineClient = config.offlineFirst ? new OfflineClient({
       vaultUrl: config.vaultUrl || "kkapi://",
       timeout: 1000,
@@ -4136,6 +4165,18 @@ class SDK {
             };
             this.dashboard = dashboardData;
             this.events.emit("SET_DASHBOARD", this.dashboard);
+            const cacheAge = portfolioData.lastUpdated ? Math.floor((Date.now() - portfolioData.lastUpdated) / 1000) : 0;
+            this.syncState = {
+              isSynced: true,
+              isInitialSync: false,
+              cacheAge,
+              syncProgress: 100,
+              syncedChains: this.blockchains.length,
+              totalChains: this.blockchains.length,
+              lastSyncTime: portfolioData.lastUpdated || Date.now(),
+              syncSource: "cache"
+            };
+            this.events.emit("SYNC_STATE_CHANGED", this.syncState);
           } else {
             console.warn("[CACHE VALIDATION] ❌ Cache data corrupted, building dashboard from cached balances");
             const dashboardData = this.buildDashboardFromBalances();
@@ -4162,6 +4203,12 @@ class SDK {
         return null;
       }
     };
+    this.getSyncState = function() {
+      return this.syncState;
+    };
+    this.isSynced = function() {
+      return this.syncState.isSynced;
+    };
     this.init = async function(walletsVerbose, setup) {
       const tag6 = `${TAG9} | init | `;
       try {
@@ -4218,6 +4265,53 @@ class SDK {
         clientEvents.events.on("message", (request) => {
           this.events.emit("message", request);
         });
+        clientEvents.events.on("balance:update", (data) => {
+          const tag7 = TAG9 + " | balance:update | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            const balance = payload.balance;
+            console.log(tag7, "Received balance update:", balance.caip);
+            const exists = this.balances.find((b2) => b2.caip === balance.caip && b2.pubkey === balance.pubkey);
+            if (!exists) {
+              this.balances.push(balance);
+            } else {
+              const index = this.balances.findIndex((b2) => b2.caip === balance.caip && b2.pubkey === balance.pubkey);
+              this.balances[index] = balance;
+            }
+            this.events.emit("BALANCE_UPDATE", balance);
+          } catch (e) {
+            console.error(tag7, "Error processing balance update:", e);
+          }
+        });
+        clientEvents.events.on("sync:progress", (data) => {
+          const tag7 = TAG9 + " | sync:progress | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            console.log(tag7, `Sync progress: ${payload.percentage}%`);
+            this.syncState.syncProgress = payload.percentage;
+            this.syncState.syncedChains = payload.completed;
+            this.syncState.totalChains = payload.total;
+            this.events.emit("SYNC_PROGRESS", this.syncState);
+          } catch (e) {
+            console.error(tag7, "Error processing sync progress:", e);
+          }
+        });
+        clientEvents.events.on("sync:complete", (data) => {
+          const tag7 = TAG9 + " | sync:complete | ";
+          try {
+            const payload = typeof data === "string" ? JSON.parse(data) : data;
+            console.log(tag7, `Sync complete: ${payload.balances} balances in ${payload.duration}ms`);
+            this.syncState.isSynced = true;
+            this.syncState.isInitialSync = false;
+            this.syncState.syncProgress = 100;
+            this.syncState.lastSyncTime = Date.now();
+            this.syncState.syncSource = "fresh";
+            this.events.emit("SYNC_COMPLETE", this.syncState);
+            this.events.emit("SYNC_STATE_CHANGED", this.syncState);
+          } catch (e) {
+            console.error(tag7, "Error processing sync complete:", e);
+          }
+        });
         this.events.emit("SET_STATUS", "init");
         if (this.keepKeySdk && !skipSync) {
           console.log("⚡ [FAST PORTFOLIO] Attempting fast load...");
@@ -4376,6 +4470,18 @@ class SDK {
           percentage: totalPortfolioValue > 0 ? Number((network.totalValueUsd / totalPortfolioValue * 100).toFixed(2)) : 0
         })).filter((entry) => entry.percentage > 0);
         this.dashboard = dashboardData;
+        this.syncState = {
+          isSynced: true,
+          isInitialSync: false,
+          cacheAge: 0,
+          syncProgress: 100,
+          syncedChains: this.blockchains.length,
+          totalChains: this.blockchains.length,
+          lastSyncTime: Date.now(),
+          syncSource: "fresh"
+        };
+        this.events.emit("SYNC_STATE_CHANGED", this.syncState);
+        this.events.emit("SYNC_COMPLETE", this.syncState);
         return true;
       } catch (e) {
         console.error(tag6, "Error in sync:", e);
@@ -4964,14 +5070,16 @@ class SDK {
           console.timeEnd("GetPortfolioBalances Response Time");
           let balances = marketInfo.data;
           for (let balance of balances) {
-            const assetInfo = this.assetsMap.get(balance.caip);
+            const assetInfo = this.assetsMap.get(balance.caip.toLowerCase()) || this.assetsMap.get(balance.caip);
             if (!assetInfo)
               continue;
+            const color = ASSET_COLORS[balance.caip] || assetInfo.color;
             Object.assign(balance, assetInfo, {
               networkId: caipToNetworkId7(balance.caip),
               icon: assetInfo.icon || "https://pioneers.dev/coins/etherum.png",
               identifier: `${balance.caip}:${balance.pubkey}`,
-              updated: Date.now()
+              updated: Date.now(),
+              color
             });
           }
           this.balances = balances;

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "highlander",
   "name": "@pioneer-platform/pioneer-sdk",
-  "version": "8.11.8",
+  "version": "8.11.9",
   "dependencies": {
     "@keepkey/keepkey-sdk": "^0.2.62",
     "@pioneer-platform/loggerdog": "^8.11.0",
@@ -12,7 +12,8 @@
     "@pioneer-platform/pioneer-events": "^8.11.0",
     "coinselect": "^3.1.13",
     "eventemitter3": "^5.0.1",
-    "neotraverse": "^0.6.8"
+    "neotraverse": "^0.6.8",
+    "socket.io-client": "^4.7.2"
   },
   "description": "Pioneer Core SDK",
   "devDependencies": {

package/src/index.ts

@@ -23,6 +23,37 @@ import { syncMarket } from './utils/sync-market.js';
 
 const TAG = ' | Pioneer-sdk | ';
 
+// Color mappings for major assets (until pioneer-discovery includes colors)
+const ASSET_COLORS: Record<string, string> = {
+  // Bitcoin
+  'bip122:000000000019d6689c085ae165831e93/slip44:0': '#FF9800',
+  // Ethereum
+  'eip155:1/slip44:60': '#627EEA',
+  // Polygon
+  'eip155:137/slip44:60': '#8247E5',
+  // Base
+  'eip155:8453/slip44:60': '#0052FF',
+  // BNB
+  'eip155:56/slip44:60': '#F3BA2F',
+  // Litecoin
+  'bip122:12a765e31ffd4059bada1e25190f6e98/slip44:2': '#BFBBBB',
+  // Dogecoin
+  'bip122:00000000001a91e3dace36e2be3bf030/slip44:3': '#C2A633',
+  // Bitcoin Cash
+  'bip122:000000000000000000651ef99cb9fcbe/slip44:145': '#8DC351',
+  // Dash
+  'bip122:000007d91d1254d60e2dd1ae58038307/slip44:5': '#008CE7',
+  // Cosmos
+  'cosmos:cosmoshub-4/slip44:118': '#2E3148',
+  // Osmosis
+  'cosmos:osmosis-1/slip44:118': '#9B1FD7',
+  // XRP
+  'ripple:4109c6f2045fc7eff4cde8f9905d19c2/slip44:144': '#23292F',
+  // Maya/CACAO
+  'cosmos:mayachain-mainnet-v1/slip44:931': '#00D4AA',
+  // Thorchain/RUNE
+  'cosmos:thorchain-mainnet-v1/slip44:931': '#00CCFF',
+};
 
 export interface PioneerSDKConfig {
   appName: string;
@@ -46,6 +77,17 @@ export interface PioneerSDKConfig {
   forceLocalhost?: boolean;
 }
 
+export interface SyncState {
+  isSynced: boolean;              // Has fresh data from full sync?
+  isInitialSync: boolean;          // First sync (no cache)?
+  cacheAge: number;                // Seconds since last cache update
+  syncProgress: number;            // 0-100 percentage of completion
+  syncedChains: number;            // Number of chains synced
+  totalChains: number;             // Total chains to sync
+  lastSyncTime: number | null;    // Timestamp of last successful sync
+  syncSource: 'cache' | 'fresh' | 'none';  // Where data came from
+}
+
 
 export class SDK {
   public status: string;
@@ -66,6 +108,7 @@ export class SDK {
   public outboundBlockchainContext: any;
   public outboundPubkeyContext: any;
   public buildDashboardFromBalances: any;
+  public syncState: SyncState;
   // public swapKit: any | null;
   public pioneer: any;
   public charts: any[];
@@ -131,6 +174,8 @@ export class SDK {
   public estimateTransactionFee: (feeRate: string, unit: string, networkType: string, txSize?: number) => FeeEstimate;
   public getCharts: () => Promise<any>;
   public keepKeySdk: any;
+  public getSyncState: () => SyncState;
+  public isSynced: () => boolean;
   private getGasAssets: () => Promise<any>;
   private transactions: any;
   private transfer: (sendPayload: any) => Promise<any>;
@@ -210,6 +255,18 @@ export class SDK {
     this.walletConnectProjectId = config.walletConnectProjectId;
     this.contextType = '';
 
+    // Initialize sync state
+    this.syncState = {
+      isSynced: false,
+      isInitialSync: true,
+      cacheAge: 0,
+      syncProgress: 0,
+      syncedChains: 0,
+      totalChains: this.blockchains.length,
+      lastSyncTime: null,
+      syncSource: 'none'
+    };
+
     // Initialize offline client if offline-first mode is enabled
     this.offlineClient = config.offlineFirst
       ? new OfflineClient({
@@ -409,6 +466,23 @@ export class SDK {
 
             this.dashboard = dashboardData;
             this.events.emit('SET_DASHBOARD', this.dashboard);
+
+            // Update sync state - cache hit
+            const cacheAge = portfolioData.lastUpdated
+              ? Math.floor((Date.now() - portfolioData.lastUpdated) / 1000)
+              : 0;
+
+            this.syncState = {
+              isSynced: true,
+              isInitialSync: false,
+              cacheAge,
+              syncProgress: 100,
+              syncedChains: this.blockchains.length,
+              totalChains: this.blockchains.length,
+              lastSyncTime: portfolioData.lastUpdated || Date.now(),
+              syncSource: 'cache'
+            };
+            this.events.emit('SYNC_STATE_CHANGED', this.syncState);
           } else {
             console.warn(
               '[CACHE VALIDATION] ❌ Cache data corrupted, building dashboard from cached balances',
@@ -443,6 +517,16 @@ export class SDK {
       }
     };
 
+    // Get current sync state
+    this.getSyncState = function (): SyncState {
+      return this.syncState;
+    };
+
+    // Check if SDK has synced data (either from cache or fresh sync)
+    this.isSynced = function (): boolean {
+      return this.syncState.isSynced;
+    };
+
     this.init = async function (walletsVerbose: any, setup: any) {
       const tag = `${TAG} | init | `;
       try {
@@ -515,6 +599,78 @@ export class SDK {
           this.events.emit('message', request);
         });
 
+        // Listen for balance streaming events (Phase 2b)
+        clientEvents.events.on('balance:update', (data: any) => {
+          const tag = TAG + ' | balance:update | ';
+          try {
+            const payload = typeof data === 'string' ? JSON.parse(data) : data;
+            const balance = payload.balance;
+
+            console.log(tag, 'Received balance update:', balance.caip);
+
+            // Add balance to balances array if not already present
+            const exists = this.balances.find((b: any) =>
+              b.caip === balance.caip && b.pubkey === balance.pubkey
+            );
+
+            if (!exists) {
+              this.balances.push(balance);
+            } else {
+              // Update existing balance
+              const index = this.balances.findIndex((b: any) =>
+                b.caip === balance.caip && b.pubkey === balance.pubkey
+              );
+              this.balances[index] = balance;
+            }
+
+            // Emit SDK event for UI updates
+            this.events.emit('BALANCE_UPDATE', balance);
+          } catch (e) {
+            console.error(tag, 'Error processing balance update:', e);
+          }
+        });
+
+        clientEvents.events.on('sync:progress', (data: any) => {
+          const tag = TAG + ' | sync:progress | ';
+          try {
+            const payload = typeof data === 'string' ? JSON.parse(data) : data;
+
+            console.log(tag, `Sync progress: ${payload.percentage}%`);
+
+            // Update sync state
+            this.syncState.syncProgress = payload.percentage;
+            this.syncState.syncedChains = payload.completed;
+            this.syncState.totalChains = payload.total;
+
+            // Emit SDK event
+            this.events.emit('SYNC_PROGRESS', this.syncState);
+          } catch (e) {
+            console.error(tag, 'Error processing sync progress:', e);
+          }
+        });
+
+        clientEvents.events.on('sync:complete', (data: any) => {
+          const tag = TAG + ' | sync:complete | ';
+          try {
+            const payload = typeof data === 'string' ? JSON.parse(data) : data;
+
+            console.log(tag, `Sync complete: ${payload.balances} balances in ${payload.duration}ms`);
+
+            // Update sync state
+            this.syncState.isSynced = true;
+            this.syncState.isInitialSync = false;
+            this.syncState.syncProgress = 100;
+            this.syncState.lastSyncTime = Date.now();
+            this.syncState.syncSource = 'fresh';
+
+            // Emit SDK events
+            this.events.emit('SYNC_COMPLETE', this.syncState);
+            this.events.emit('SYNC_STATE_CHANGED', this.syncState);
+          } catch (e) {
+            console.error(tag, 'Error processing sync complete:', e);
+          }
+        });
+
         this.events.emit('SET_STATUS', 'init');
 
         // Fast Portfolio Pattern: Try unified portfolio first, then sync if needed
@@ -786,6 +942,20 @@ export class SDK {
 
         this.dashboard = dashboardData;
 
+        // Update sync state - fresh sync complete
+        this.syncState = {
+          isSynced: true,
+          isInitialSync: false,
+          cacheAge: 0,
+          syncProgress: 100,
+          syncedChains: this.blockchains.length,
+          totalChains: this.blockchains.length,
+          lastSyncTime: Date.now(),
+          syncSource: 'fresh'
+        };
+        this.events.emit('SYNC_STATE_CHANGED', this.syncState);
+        this.events.emit('SYNC_COMPLETE', this.syncState);
+
         return true;
       } catch (e) {
         console.error(tag, 'Error in sync:', e);
@@ -1567,14 +1737,18 @@ export class SDK {
 
           // Enrich balances with asset info
           for (let balance of balances) {
-            const assetInfo = this.assetsMap.get(balance.caip);
+            const assetInfo = this.assetsMap.get(balance.caip.toLowerCase()) || this.assetsMap.get(balance.caip);
             if (!assetInfo) continue;
 
+            // Get color from mapping (fallback to assetInfo.color if it exists)
+            const color = ASSET_COLORS[balance.caip] || assetInfo.color;
+
             Object.assign(balance, assetInfo, {
               networkId: caipToNetworkId(balance.caip),
               icon: assetInfo.icon || 'https://pioneers.dev/coins/etherum.png',
               identifier: `${balance.caip}:${balance.pubkey}`,
               updated: Date.now(), // Add timestamp for worker validation
+              color, // Add color from mapping
             });
           }
           this.balances = balances;