@toon-protocol/client 0.14.10 → 0.14.11

package/dist/index.d.ts

@@ -1264,6 +1264,21 @@ declare class ToonClient {
     }>;
     /** Where a tracked channel sits in the withdraw journey. */
     getChannelCloseState(channelId: string): 'open' | 'closing' | 'settleable' | 'settled';
+    getSettleableAt(channelId: string): bigint | undefined;
+    /**
+     * Re-hydrate a RESUMED channel's on-chain deposit. Persisted channel state
+     * omits `depositTotal`, so after a daemon restart the tracked deposit is `0`
+     * and the wallet shows 0 spendable even though real collateral is locked
+     * on-chain. Read the participant's `deposit` from the `participants` mapping
+     * and update the tracked total so `depositTotal - cumulativeAmount` is right.
+     * Best-effort by caller (await + catch); returns the on-chain deposit, or
+     * `undefined` when it can't be read (no channel manager / on-chain client /
+     * EVM address).
+     */
+    rehydrateChannelDeposit(channelId: string, opts: {
+        chain: string;
+        tokenNetworkAddress: string;
+    }): Promise<bigint | undefined>;
     /**
      * Read the on-chain settlement-token balance of this client's OWN wallet on
      * each configured chain (EVM token, Solana SPL, native MINA). A free read — no
@@ -2238,6 +2253,23 @@ declare class OnChainChannelClient implements ConnectorChannelClient {
     }>;
     /** Read + destructure the EVM `channels(bytes32)` view. */
     private readEvmChannel;
+    /**
+     * Read a participant's on-chain channel state — `deposit` (locked collateral),
+     * `nonce`, and `transferredAmount` — straight from the `participants` mapping.
+     * Takes the chain + token-network explicitly so it works for a channel that
+     * was RESUMED from disk (no in-memory `channelContext` yet), which is exactly
+     * when the daemon needs to re-hydrate the deposit it doesn't persist.
+     */
+    readEvmParticipantState(opts: {
+        chain: string;
+        tokenNetworkAddress: string;
+        channelId: string;
+        participant: string;
+    }): Promise<{
+        deposit: bigint;
+        nonce: bigint;
+        transferredAmount: bigint;
+    }>;
     /**
      * Opens a REAL on-chain Solana payment channel.
      *

package/dist/index.js

@@ -2300,6 +2300,17 @@ var TOKEN_NETWORK_ABI = [
       { name: "participant2", type: "address" }
     ]
   },
+  {
+    name: "participants",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ type: "bytes32" }, { type: "address" }],
+    outputs: [
+      { name: "deposit", type: "uint256" },
+      { name: "nonce", type: "uint256" },
+      { name: "transferredAmount", type: "uint256" }
+    ]
+  },
   {
     name: "ChannelOpened",
     type: "event",
@@ -2631,6 +2642,23 @@ var OnChainChannelClient = class {
     });
     return { settlementTimeout: res[0], state: Number(res[1]), closedAt: res[2] };
   }
+  /**
+   * Read a participant's on-chain channel state — `deposit` (locked collateral),
+   * `nonce`, and `transferredAmount` — straight from the `participants` mapping.
+   * Takes the chain + token-network explicitly so it works for a channel that
+   * was RESUMED from disk (no in-memory `channelContext` yet), which is exactly
+   * when the daemon needs to re-hydrate the deposit it doesn't persist.
+   */
+  async readEvmParticipantState(opts) {
+    const { publicClient } = this.createClients(opts.chain);
+    const res = await publicClient.readContract({
+      address: opts.tokenNetworkAddress,
+      abi: TOKEN_NETWORK_ABI,
+      functionName: "participants",
+      args: [opts.channelId, opts.participant]
+    });
+    return { deposit: res[0], nonce: res[1], transferredAmount: res[2] };
+  }
   /**
    * Opens a REAL on-chain Solana payment channel.
    *
@@ -5010,6 +5038,33 @@ var ToonClient = class {
     if (!this.channelManager) throw new Error("ChannelManager not initialized");
     return this.channelManager.getChannelCloseState(channelId);
   }
+  getSettleableAt(channelId) {
+    if (!this.channelManager) throw new Error("ChannelManager not initialized");
+    return this.channelManager.getSettleableAt(channelId);
+  }
+  /**
+   * Re-hydrate a RESUMED channel's on-chain deposit. Persisted channel state
+   * omits `depositTotal`, so after a daemon restart the tracked deposit is `0`
+   * and the wallet shows 0 spendable even though real collateral is locked
+   * on-chain. Read the participant's `deposit` from the `participants` mapping
+   * and update the tracked total so `depositTotal - cumulativeAmount` is right.
+   * Best-effort by caller (await + catch); returns the on-chain deposit, or
+   * `undefined` when it can't be read (no channel manager / on-chain client /
+   * EVM address).
+   */
+  async rehydrateChannelDeposit(channelId, opts) {
+    if (!this.channelManager || !this.onChainChannelClient) return void 0;
+    const participant = this.getEvmAddress();
+    if (!participant) return void 0;
+    const { deposit } = await this.onChainChannelClient.readEvmParticipantState({
+      chain: opts.chain,
+      tokenNetworkAddress: opts.tokenNetworkAddress,
+      channelId,
+      participant
+    });
+    this.channelManager.setDepositTotal(channelId, deposit);
+    return deposit;
+  }
   /**
    * Read the on-chain settlement-token balance of this client's OWN wallet on
    * each configured chain (EVM token, Solana SPL, native MINA). A free read — no