@viwoapp/sdk 0.1.7 → 0.1.8

package/README.md

@@ -5,7 +5,40 @@
 
 TypeScript SDK for VCoin Protocol Integration on Solana.
 
-**Version:** 0.1.7 (Bug Fixes)
+**Version:** 0.1.8 (Bug Fixes)
+
+## What's New in v0.1.8 (Bug Fixes)
+
+This release addresses 4 SDK issues identified during code review:
+
+| Finding | Severity | Fix |
+|---------|----------|-----|
+| #2 | Medium | VCoin balance now correctly filters by mint address |
+| #5 | Medium | ViLink batch now uses deterministic nonce PDA |
+| #8 | High | Gasless config byte offsets corrected |
+| #9 | Low | Error handling improved with console warnings |
+
+### Changes
+
+- **VCoin Mint Filter (Finding #2):** `getVCoinBalance()` now filters by VCoin mint address instead of summing all Token-2022 accounts. Set `programIds.vcoinMint` in your config.
+- **Gasless Config Fix (Finding #8):** All byte offsets in `gasless.getConfig()` corrected to match on-chain struct after H-02 security fix added `pending_authority`.
+- **ViLink Config Fix:** ViLink config byte offsets also corrected for H-02 compatibility.
+- **Error Logging (Finding #9):** Silent `catch { return null }` blocks replaced with `console.warn('[ViWoSDK] ...')` for easier debugging.
+- **Batch Nonce (Finding #5):** Added `batchNonce` to `UserActionStatsExtended` for deterministic batch PDA derivation.
+- **New Fields:** `GaslessConfig` now includes `feeVault`, `sscreProgram`, `sscreDeductionBps`, `maxSubsidizedPerUser`, `totalSolSpent`, `currentDay`, `daySpent`.
+
+### Configuration Update Required
+
+```typescript
+const client = new ViWoClient({
+  connection: { endpoint: "https://api.devnet.solana.com" },
+  wallet: walletAdapter,
+  programIds: {
+    // IMPORTANT: Set your VCoin mint address for accurate balance queries
+    vcoinMint: new PublicKey("YOUR_VCOIN_MINT_ADDRESS"),
+  },
+});
+```
 
 ## What's New in v0.1.7
 
@@ -17,7 +50,7 @@ TypeScript SDK for VCoin Protocol Integration on Solana.
 - **Updated Methods:** `getAction()`, `isActionValid()`, `buildExecuteTipAction()` now use nonce
 - **Deprecated:** `getActionByTimestamp()` - use `getAction()` with nonce instead
 
-### Breaking Change
+### Breaking Change (v0.1.7)
 
 ViLink action PDA derivation changed from timestamp to nonce:
 ```typescript

package/dist/index.d.mts

@@ -14,6 +14,16 @@ declare const PROGRAM_IDS: {
     sscreProtocol: PublicKey;
     vilinkProtocol: PublicKey;
     gaslessProtocol: PublicKey;
+    /**
+     * VCoin Token Mint Address (Token-2022)
+     *
+     * NOTE: This is a placeholder. Override via ViWoClient config.programIds.vcoinMint
+     * after deploying your VCoin mint on devnet/mainnet.
+     *
+     * Finding #2 Fix: SDK now filters token accounts by mint address to prevent
+     * summing balances from other Token-2022 tokens.
+     */
+    vcoinMint: PublicKey;
 };
 declare const SEEDS: {
     vcoinConfig: string;
@@ -433,8 +443,13 @@ declare enum ActionType {
     Delegate = 6,
     Vote = 7
 }
+/**
+ * ViLinkConfig - Updated with H-02 pending authority field
+ */
 interface ViLinkConfig extends PendingAuthorityFields {
     authority: PublicKey;
+    /** H-02: Pending authority for two-step transfer */
+    pendingAuthority?: PublicKey;
     vcoinMint: PublicKey;
     treasury: PublicKey;
     enabledActions: number;
@@ -442,6 +457,7 @@ interface ViLinkConfig extends PendingAuthorityFields {
     totalActionsExecuted: BN;
     totalTipVolume: BN;
     paused: boolean;
+    /** M-02: Platform fee in basis points, bounded 10-1000 (0.1%-10%) */
     platformFeeBps: number;
 }
 interface ViLinkAction {
@@ -472,7 +488,7 @@ interface CreateActionParams {
      */
     nonce?: BN;
 }
-/** M-04: User action statistics with nonce tracking */
+/** M-04 + Finding #5: User action statistics with nonce tracking */
 interface UserActionStatsExtended {
     user: PublicKey;
     actionsCreated: BN;
@@ -487,22 +503,47 @@ interface UserActionStatsExtended {
     lastActionAt: BN;
     /** M-04: Next nonce to use when creating an action */
     actionNonce: BN;
+    /** Finding #5: Next nonce to use when creating a batch (prevents timestamp collisions) */
+    batchNonce: BN;
 }
 declare enum FeeMethod {
     PlatformSubsidized = 0,
     VCoinDeduction = 1,
     SSCREDeduction = 2
 }
+/**
+ * GaslessConfig - Finding #8 Fix
+ *
+ * Updated to include all fields from on-chain GaslessConfig struct.
+ * Previous version was missing fields added after H-02 security fix.
+ */
 interface GaslessConfig extends PendingAuthorityFields {
     authority: PublicKey;
+    /** H-02: Pending authority for two-step transfer */
+    pendingAuthority?: PublicKey;
     feePayer: PublicKey;
     vcoinMint: PublicKey;
+    /** Fee vault for VCoin fee collection */
+    feeVault?: PublicKey;
+    /** SSCRE program for reward deduction integration */
+    sscreProgram?: PublicKey;
     dailySubsidyBudget: BN;
     solFeePerTx: BN;
     vcoinFeeMultiplier: BN;
+    /** SSCRE deduction rate in basis points */
+    sscreDeductionBps?: number;
+    /** Maximum subsidized transactions per user per day */
+    maxSubsidizedPerUser?: number;
     totalSubsidizedTx: BN;
+    /** Total SOL spent on subsidies */
+    totalSolSpent?: BN;
     totalVcoinCollected: BN;
     paused: boolean;
+    /** Current day number for daily budget reset */
+    currentDay?: number;
+    /** Today's spent budget */
+    daySpent?: BN;
+    /** L-03: Maximum fee slippage in basis points (default 500 = 5%) */
     maxSlippageBps?: number;
 }
 interface SessionKey {
@@ -856,6 +897,9 @@ declare class ViLinkClient {
     constructor(client: ViWoClient);
     /**
      * Get ViLink configuration
+     *
+     * Finding #8 (related): Corrected byte offsets to match on-chain ViLinkConfig struct.
+     * Added pending_authority field that was missing after H-02 security fix.
      */
     getConfig(): Promise<ViLinkConfig | null>;
     /**
@@ -977,6 +1021,10 @@ declare class GaslessClient {
     constructor(client: ViWoClient);
     /**
      * Get gasless configuration
+     *
+     * Finding #8 Fix: Corrected byte offsets to match on-chain GaslessConfig struct.
+     * Added missing fields: pendingAuthority, feeVault, sscreProgram, sscreDeductionBps,
+     * maxSubsidizedPerUser, totalSolSpent, currentDay, daySpent, maxSlippageBps.
      */
     getConfig(): Promise<GaslessConfig | null>;
     /**
@@ -1304,6 +1352,9 @@ declare class ViWoClient {
     sendTransaction(tx: Transaction): Promise<string>;
     /**
      * Get VCoin balance
+     *
+     * Finding #2 Fix: Now filters by VCoin mint address instead of summing all Token-2022 accounts.
+     * Make sure to set programIds.vcoinMint in your ViWoClient config.
      */
     getVCoinBalance(user?: PublicKey): Promise<BN>;
     /**

package/dist/index.d.ts

@@ -14,6 +14,16 @@ declare const PROGRAM_IDS: {
     sscreProtocol: PublicKey;
     vilinkProtocol: PublicKey;
     gaslessProtocol: PublicKey;
+    /**
+     * VCoin Token Mint Address (Token-2022)
+     *
+     * NOTE: This is a placeholder. Override via ViWoClient config.programIds.vcoinMint
+     * after deploying your VCoin mint on devnet/mainnet.
+     *
+     * Finding #2 Fix: SDK now filters token accounts by mint address to prevent
+     * summing balances from other Token-2022 tokens.
+     */
+    vcoinMint: PublicKey;
 };
 declare const SEEDS: {
     vcoinConfig: string;
@@ -433,8 +443,13 @@ declare enum ActionType {
     Delegate = 6,
     Vote = 7
 }
+/**
+ * ViLinkConfig - Updated with H-02 pending authority field
+ */
 interface ViLinkConfig extends PendingAuthorityFields {
     authority: PublicKey;
+    /** H-02: Pending authority for two-step transfer */
+    pendingAuthority?: PublicKey;
     vcoinMint: PublicKey;
     treasury: PublicKey;
     enabledActions: number;
@@ -442,6 +457,7 @@ interface ViLinkConfig extends PendingAuthorityFields {
     totalActionsExecuted: BN;
     totalTipVolume: BN;
     paused: boolean;
+    /** M-02: Platform fee in basis points, bounded 10-1000 (0.1%-10%) */
     platformFeeBps: number;
 }
 interface ViLinkAction {
@@ -472,7 +488,7 @@ interface CreateActionParams {
      */
     nonce?: BN;
 }
-/** M-04: User action statistics with nonce tracking */
+/** M-04 + Finding #5: User action statistics with nonce tracking */
 interface UserActionStatsExtended {
     user: PublicKey;
     actionsCreated: BN;
@@ -487,22 +503,47 @@ interface UserActionStatsExtended {
     lastActionAt: BN;
     /** M-04: Next nonce to use when creating an action */
     actionNonce: BN;
+    /** Finding #5: Next nonce to use when creating a batch (prevents timestamp collisions) */
+    batchNonce: BN;
 }
 declare enum FeeMethod {
     PlatformSubsidized = 0,
     VCoinDeduction = 1,
     SSCREDeduction = 2
 }
+/**
+ * GaslessConfig - Finding #8 Fix
+ *
+ * Updated to include all fields from on-chain GaslessConfig struct.
+ * Previous version was missing fields added after H-02 security fix.
+ */
 interface GaslessConfig extends PendingAuthorityFields {
     authority: PublicKey;
+    /** H-02: Pending authority for two-step transfer */
+    pendingAuthority?: PublicKey;
     feePayer: PublicKey;
     vcoinMint: PublicKey;
+    /** Fee vault for VCoin fee collection */
+    feeVault?: PublicKey;
+    /** SSCRE program for reward deduction integration */
+    sscreProgram?: PublicKey;
     dailySubsidyBudget: BN;
     solFeePerTx: BN;
     vcoinFeeMultiplier: BN;
+    /** SSCRE deduction rate in basis points */
+    sscreDeductionBps?: number;
+    /** Maximum subsidized transactions per user per day */
+    maxSubsidizedPerUser?: number;
     totalSubsidizedTx: BN;
+    /** Total SOL spent on subsidies */
+    totalSolSpent?: BN;
     totalVcoinCollected: BN;
     paused: boolean;
+    /** Current day number for daily budget reset */
+    currentDay?: number;
+    /** Today's spent budget */
+    daySpent?: BN;
+    /** L-03: Maximum fee slippage in basis points (default 500 = 5%) */
     maxSlippageBps?: number;
 }
 interface SessionKey {
@@ -856,6 +897,9 @@ declare class ViLinkClient {
     constructor(client: ViWoClient);
     /**
      * Get ViLink configuration
+     *
+     * Finding #8 (related): Corrected byte offsets to match on-chain ViLinkConfig struct.
+     * Added pending_authority field that was missing after H-02 security fix.
      */
     getConfig(): Promise<ViLinkConfig | null>;
     /**
@@ -977,6 +1021,10 @@ declare class GaslessClient {
     constructor(client: ViWoClient);
     /**
      * Get gasless configuration
+     *
+     * Finding #8 Fix: Corrected byte offsets to match on-chain GaslessConfig struct.
+     * Added missing fields: pendingAuthority, feeVault, sscreProgram, sscreDeductionBps,
+     * maxSubsidizedPerUser, totalSolSpent, currentDay, daySpent, maxSlippageBps.
      */
     getConfig(): Promise<GaslessConfig | null>;
     /**
@@ -1304,6 +1352,9 @@ declare class ViWoClient {
     sendTransaction(tx: Transaction): Promise<string>;
     /**
      * Get VCoin balance
+     *
+     * Finding #2 Fix: Now filters by VCoin mint address instead of summing all Token-2022 accounts.
+     * Make sure to set programIds.vcoinMint in your ViWoClient config.
      */
     getVCoinBalance(user?: PublicKey): Promise<BN>;
     /**

package/dist/index.js

@@ -88,7 +88,18 @@ var PROGRAM_IDS = {
   governanceProtocol: new import_web3.PublicKey("3R256kBN9iXozjypQFRAmegBhd6HJqXWqdNG7Th78HYe"),
   sscreProtocol: new import_web3.PublicKey("6AJNcQSfoiE2UAeUDyJUBumS9SBwhAdSznoAeYpXrxXZ"),
   vilinkProtocol: new import_web3.PublicKey("CFGXTS2MueQwTYTMMTBQbRWzJtSTC2p4ZRuKPpLDmrv7"),
-  gaslessProtocol: new import_web3.PublicKey("FcXJAjzJs8eVY2WTRFXynQBpC7WZUqKZppyp9xS6PaB3")
+  gaslessProtocol: new import_web3.PublicKey("FcXJAjzJs8eVY2WTRFXynQBpC7WZUqKZppyp9xS6PaB3"),
+  /**
+   * VCoin Token Mint Address (Token-2022)
+   * 
+   * NOTE: This is a placeholder. Override via ViWoClient config.programIds.vcoinMint
+   * after deploying your VCoin mint on devnet/mainnet.
+   * 
+   * Finding #2 Fix: SDK now filters token accounts by mint address to prevent
+   * summing balances from other Token-2022 tokens.
+   */
+  vcoinMint: new import_web3.PublicKey("11111111111111111111111111111111")
+  // Placeholder - override in config
 };
 var SEEDS = {
   // VCoin
@@ -1280,6 +1291,9 @@ var ViLinkClient = class {
   }
   /**
    * Get ViLink configuration
+   * 
+   * Finding #8 (related): Corrected byte offsets to match on-chain ViLinkConfig struct.
+   * Added pending_authority field that was missing after H-02 security fix.
    */
   async getConfig() {
     try {
@@ -1291,16 +1305,18 @@ var ViLinkClient = class {
       const data = accountInfo.data;
       return {
         authority: new import_web36.PublicKey(data.slice(8, 40)),
-        vcoinMint: new import_web36.PublicKey(data.slice(40, 72)),
-        treasury: new import_web36.PublicKey(data.slice(72, 104)),
-        enabledActions: data[200],
-        totalActionsCreated: new import_anchor5.BN(data.slice(201, 209), "le"),
-        totalActionsExecuted: new import_anchor5.BN(data.slice(209, 217), "le"),
-        totalTipVolume: new import_anchor5.BN(data.slice(217, 225), "le"),
-        paused: data[225] !== 0,
-        platformFeeBps: data.readUInt16LE(226)
+        pendingAuthority: new import_web36.PublicKey(data.slice(40, 72)),
+        vcoinMint: new import_web36.PublicKey(data.slice(72, 104)),
+        treasury: new import_web36.PublicKey(data.slice(104, 136)),
+        enabledActions: data[296],
+        totalActionsCreated: new import_anchor5.BN(data.slice(297, 305), "le"),
+        totalActionsExecuted: new import_anchor5.BN(data.slice(305, 313), "le"),
+        totalTipVolume: new import_anchor5.BN(data.slice(313, 321), "le"),
+        paused: data[321] !== 0,
+        platformFeeBps: data.readUInt16LE(322)
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] vilink.getConfig failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1330,7 +1346,8 @@ var ViLinkClient = class {
         actionNonce: nonce
         // M-04: Store nonce for reference
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] vilink.getAction failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1364,7 +1381,8 @@ var ViLinkClient = class {
         vcoinSent: new import_anchor5.BN(data.slice(72, 80), "le"),
         vcoinReceived: new import_anchor5.BN(data.slice(80, 88), "le")
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] vilink.getUserStats failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1538,6 +1556,10 @@ var GaslessClient = class {
   }
   /**
    * Get gasless configuration
+   * 
+   * Finding #8 Fix: Corrected byte offsets to match on-chain GaslessConfig struct.
+   * Added missing fields: pendingAuthority, feeVault, sscreProgram, sscreDeductionBps,
+   * maxSubsidizedPerUser, totalSolSpent, currentDay, daySpent, maxSlippageBps.
    */
   async getConfig() {
     try {
@@ -1549,16 +1571,26 @@ var GaslessClient = class {
       const data = accountInfo.data;
       return {
         authority: new import_web37.PublicKey(data.slice(8, 40)),
-        feePayer: new import_web37.PublicKey(data.slice(40, 72)),
-        vcoinMint: new import_web37.PublicKey(data.slice(72, 104)),
-        dailySubsidyBudget: new import_anchor6.BN(data.slice(136, 144), "le"),
-        solFeePerTx: new import_anchor6.BN(data.slice(144, 152), "le"),
-        vcoinFeeMultiplier: new import_anchor6.BN(data.slice(152, 160), "le"),
-        totalSubsidizedTx: new import_anchor6.BN(data.slice(168, 176), "le"),
-        totalVcoinCollected: new import_anchor6.BN(data.slice(184, 192), "le"),
-        paused: data[192] !== 0
+        pendingAuthority: new import_web37.PublicKey(data.slice(40, 72)),
+        feePayer: new import_web37.PublicKey(data.slice(72, 104)),
+        vcoinMint: new import_web37.PublicKey(data.slice(104, 136)),
+        feeVault: new import_web37.PublicKey(data.slice(136, 168)),
+        sscreProgram: new import_web37.PublicKey(data.slice(168, 200)),
+        dailySubsidyBudget: new import_anchor6.BN(data.slice(200, 208), "le"),
+        solFeePerTx: new import_anchor6.BN(data.slice(208, 216), "le"),
+        vcoinFeeMultiplier: new import_anchor6.BN(data.slice(216, 224), "le"),
+        sscreDeductionBps: data.readUInt16LE(224),
+        maxSubsidizedPerUser: data.readUInt32LE(226),
+        totalSubsidizedTx: new import_anchor6.BN(data.slice(230, 238), "le"),
+        totalSolSpent: new import_anchor6.BN(data.slice(238, 246), "le"),
+        totalVcoinCollected: new import_anchor6.BN(data.slice(246, 254), "le"),
+        paused: data[254] !== 0,
+        currentDay: data.readUInt32LE(255),
+        daySpent: new import_anchor6.BN(data.slice(259, 267), "le"),
+        maxSlippageBps: data.readUInt16LE(267)
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] gasless.getConfig failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1586,7 +1618,8 @@ var GaslessClient = class {
         isRevoked: data[114] !== 0,
         feeMethod: data[123]
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] gasless.getSessionKey failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1613,7 +1646,8 @@ var GaslessClient = class {
         sessionsCreated: data.readUInt32LE(72),
         activeSession: new import_web37.PublicKey(data.slice(76, 108))
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] gasless.getUserStats failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -2388,6 +2422,9 @@ var ViWoClient = class {
   }
   /**
    * Get VCoin balance
+   * 
+   * Finding #2 Fix: Now filters by VCoin mint address instead of summing all Token-2022 accounts.
+   * Make sure to set programIds.vcoinMint in your ViWoClient config.
    */
   async getVCoinBalance(user) {
     const target = user || this.publicKey;
@@ -2397,7 +2434,7 @@ var ViWoClient = class {
     try {
       const tokenAccounts = await this.connection.connection.getTokenAccountsByOwner(
         target,
-        { programId: import_spl_token.TOKEN_2022_PROGRAM_ID }
+        { mint: this.programIds.vcoinMint, programId: import_spl_token.TOKEN_2022_PROGRAM_ID }
       );
       let balance = new import_anchor10.BN(0);
       for (const { account } of tokenAccounts.value) {
@@ -2406,7 +2443,8 @@ var ViWoClient = class {
         balance = balance.add(new import_anchor10.BN(amount, "le"));
       }
       return balance;
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] getVCoinBalance failed:", error instanceof Error ? error.message : error);
       return new import_anchor10.BN(0);
     }
   }
@@ -2421,7 +2459,8 @@ var ViWoClient = class {
     try {
       const stakeData = await this.staking.getUserStake(target);
       return stakeData?.vevcoinBalance || new import_anchor10.BN(0);
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] getVeVCoinBalance failed:", error instanceof Error ? error.message : error);
       return new import_anchor10.BN(0);
     }
   }
@@ -2436,7 +2475,8 @@ var ViWoClient = class {
       ]);
       const blockTime = await this.connection.getBlockTime();
       return { connected, slot, blockTime };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] healthCheck failed:", error instanceof Error ? error.message : error);
       return { connected: false, slot: null, blockTime: null };
     }
   }

package/dist/index.mjs

@@ -19,7 +19,18 @@ var PROGRAM_IDS = {
   governanceProtocol: new PublicKey("3R256kBN9iXozjypQFRAmegBhd6HJqXWqdNG7Th78HYe"),
   sscreProtocol: new PublicKey("6AJNcQSfoiE2UAeUDyJUBumS9SBwhAdSznoAeYpXrxXZ"),
   vilinkProtocol: new PublicKey("CFGXTS2MueQwTYTMMTBQbRWzJtSTC2p4ZRuKPpLDmrv7"),
-  gaslessProtocol: new PublicKey("FcXJAjzJs8eVY2WTRFXynQBpC7WZUqKZppyp9xS6PaB3")
+  gaslessProtocol: new PublicKey("FcXJAjzJs8eVY2WTRFXynQBpC7WZUqKZppyp9xS6PaB3"),
+  /**
+   * VCoin Token Mint Address (Token-2022)
+   * 
+   * NOTE: This is a placeholder. Override via ViWoClient config.programIds.vcoinMint
+   * after deploying your VCoin mint on devnet/mainnet.
+   * 
+   * Finding #2 Fix: SDK now filters token accounts by mint address to prevent
+   * summing balances from other Token-2022 tokens.
+   */
+  vcoinMint: new PublicKey("11111111111111111111111111111111")
+  // Placeholder - override in config
 };
 var SEEDS = {
   // VCoin
@@ -1211,6 +1222,9 @@ var ViLinkClient = class {
   }
   /**
    * Get ViLink configuration
+   * 
+   * Finding #8 (related): Corrected byte offsets to match on-chain ViLinkConfig struct.
+   * Added pending_authority field that was missing after H-02 security fix.
    */
   async getConfig() {
     try {
@@ -1222,16 +1236,18 @@ var ViLinkClient = class {
       const data = accountInfo.data;
       return {
         authority: new PublicKey6(data.slice(8, 40)),
-        vcoinMint: new PublicKey6(data.slice(40, 72)),
-        treasury: new PublicKey6(data.slice(72, 104)),
-        enabledActions: data[200],
-        totalActionsCreated: new BN5(data.slice(201, 209), "le"),
-        totalActionsExecuted: new BN5(data.slice(209, 217), "le"),
-        totalTipVolume: new BN5(data.slice(217, 225), "le"),
-        paused: data[225] !== 0,
-        platformFeeBps: data.readUInt16LE(226)
+        pendingAuthority: new PublicKey6(data.slice(40, 72)),
+        vcoinMint: new PublicKey6(data.slice(72, 104)),
+        treasury: new PublicKey6(data.slice(104, 136)),
+        enabledActions: data[296],
+        totalActionsCreated: new BN5(data.slice(297, 305), "le"),
+        totalActionsExecuted: new BN5(data.slice(305, 313), "le"),
+        totalTipVolume: new BN5(data.slice(313, 321), "le"),
+        paused: data[321] !== 0,
+        platformFeeBps: data.readUInt16LE(322)
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] vilink.getConfig failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1261,7 +1277,8 @@ var ViLinkClient = class {
         actionNonce: nonce
         // M-04: Store nonce for reference
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] vilink.getAction failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1295,7 +1312,8 @@ var ViLinkClient = class {
         vcoinSent: new BN5(data.slice(72, 80), "le"),
         vcoinReceived: new BN5(data.slice(80, 88), "le")
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] vilink.getUserStats failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1469,6 +1487,10 @@ var GaslessClient = class {
   }
   /**
    * Get gasless configuration
+   * 
+   * Finding #8 Fix: Corrected byte offsets to match on-chain GaslessConfig struct.
+   * Added missing fields: pendingAuthority, feeVault, sscreProgram, sscreDeductionBps,
+   * maxSubsidizedPerUser, totalSolSpent, currentDay, daySpent, maxSlippageBps.
    */
   async getConfig() {
     try {
@@ -1480,16 +1502,26 @@ var GaslessClient = class {
       const data = accountInfo.data;
       return {
         authority: new PublicKey7(data.slice(8, 40)),
-        feePayer: new PublicKey7(data.slice(40, 72)),
-        vcoinMint: new PublicKey7(data.slice(72, 104)),
-        dailySubsidyBudget: new BN6(data.slice(136, 144), "le"),
-        solFeePerTx: new BN6(data.slice(144, 152), "le"),
-        vcoinFeeMultiplier: new BN6(data.slice(152, 160), "le"),
-        totalSubsidizedTx: new BN6(data.slice(168, 176), "le"),
-        totalVcoinCollected: new BN6(data.slice(184, 192), "le"),
-        paused: data[192] !== 0
+        pendingAuthority: new PublicKey7(data.slice(40, 72)),
+        feePayer: new PublicKey7(data.slice(72, 104)),
+        vcoinMint: new PublicKey7(data.slice(104, 136)),
+        feeVault: new PublicKey7(data.slice(136, 168)),
+        sscreProgram: new PublicKey7(data.slice(168, 200)),
+        dailySubsidyBudget: new BN6(data.slice(200, 208), "le"),
+        solFeePerTx: new BN6(data.slice(208, 216), "le"),
+        vcoinFeeMultiplier: new BN6(data.slice(216, 224), "le"),
+        sscreDeductionBps: data.readUInt16LE(224),
+        maxSubsidizedPerUser: data.readUInt32LE(226),
+        totalSubsidizedTx: new BN6(data.slice(230, 238), "le"),
+        totalSolSpent: new BN6(data.slice(238, 246), "le"),
+        totalVcoinCollected: new BN6(data.slice(246, 254), "le"),
+        paused: data[254] !== 0,
+        currentDay: data.readUInt32LE(255),
+        daySpent: new BN6(data.slice(259, 267), "le"),
+        maxSlippageBps: data.readUInt16LE(267)
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] gasless.getConfig failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1517,7 +1549,8 @@ var GaslessClient = class {
         isRevoked: data[114] !== 0,
         feeMethod: data[123]
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] gasless.getSessionKey failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -1544,7 +1577,8 @@ var GaslessClient = class {
         sessionsCreated: data.readUInt32LE(72),
         activeSession: new PublicKey7(data.slice(76, 108))
       };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] gasless.getUserStats failed:", error instanceof Error ? error.message : error);
       return null;
     }
   }
@@ -2319,6 +2353,9 @@ var ViWoClient = class {
   }
   /**
    * Get VCoin balance
+   * 
+   * Finding #2 Fix: Now filters by VCoin mint address instead of summing all Token-2022 accounts.
+   * Make sure to set programIds.vcoinMint in your ViWoClient config.
    */
   async getVCoinBalance(user) {
     const target = user || this.publicKey;
@@ -2328,7 +2365,7 @@ var ViWoClient = class {
     try {
       const tokenAccounts = await this.connection.connection.getTokenAccountsByOwner(
         target,
-        { programId: TOKEN_2022_PROGRAM_ID }
+        { mint: this.programIds.vcoinMint, programId: TOKEN_2022_PROGRAM_ID }
       );
       let balance = new BN10(0);
       for (const { account } of tokenAccounts.value) {
@@ -2337,7 +2374,8 @@ var ViWoClient = class {
         balance = balance.add(new BN10(amount, "le"));
       }
       return balance;
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] getVCoinBalance failed:", error instanceof Error ? error.message : error);
       return new BN10(0);
     }
   }
@@ -2352,7 +2390,8 @@ var ViWoClient = class {
     try {
       const stakeData = await this.staking.getUserStake(target);
       return stakeData?.vevcoinBalance || new BN10(0);
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] getVeVCoinBalance failed:", error instanceof Error ? error.message : error);
       return new BN10(0);
     }
   }
@@ -2367,7 +2406,8 @@ var ViWoClient = class {
       ]);
       const blockTime = await this.connection.getBlockTime();
       return { connected, slot, blockTime };
-    } catch {
+    } catch (error) {
+      console.warn("[ViWoSDK] healthCheck failed:", error instanceof Error ? error.message : error);
       return { connected: false, slot: null, blockTime: null };
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viwoapp/sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "ViWoApp SDK - TypeScript SDK for VCoin Protocol Integration",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -80,4 +80,3 @@
     }
   }
 }
-