@oobe-protocol-labs/synapse-sap-sdk 0.10.1 → 0.12.5

package/src/modules/staking.ts

@@ -17,6 +17,10 @@ import { BN } from "@coral-xyz/anchor";
 import { BaseModule } from "./base";
 import { deriveAgent, deriveStake } from "../pda";
 import type { AgentStakeData } from "../types";
+import {
+  MIN_AGENT_STAKE_LAMPORTS,
+  computeRequiredStakeLamports,
+} from "../constants/payments";
 
 /**
  * @name StakingModule
@@ -119,4 +123,35 @@ export class StakingModule extends BaseModule {
   async fetchByPda(stakePda: PublicKey): Promise<AgentStakeData> {
     return this.fetchAccount<AgentStakeData>("agentStake", stakePda);
   }
+
+  // ── v0.11 helpers ────────────────────────────────────────────
+
+  /**
+   * Compute the maximum amount that can be requested via `requestUnstake`
+   * without breaching the on-chain {@link MIN_AGENT_STAKE_LAMPORTS} floor.
+   *
+   * Returns 0 if the agent is already at (or below) the floor.
+   *
+   * @since v0.11.0
+   */
+  getMaxUnstakeLamports(stake: AgentStakeData): bigint {
+    const staked = BigInt(stake.stakedAmount.toString());
+    if (staked <= MIN_AGENT_STAKE_LAMPORTS) return 0n;
+    return staked - MIN_AGENT_STAKE_LAMPORTS;
+  }
+
+  /**
+   * Returns the lamport delta the agent must `deposit` to satisfy the
+   * per-escrow stake-coverage requirement for `escrowLamports`. 0 if already
+   * sufficient. Useful for a UI "top up to open this escrow" button.
+   *
+   * Mirrors the on-chain check in `create_escrow_v2` (v0.11 H-1).
+   *
+   * @since v0.11.0
+   */
+  getRequiredTopUp(stake: AgentStakeData, escrowLamports: bigint): bigint {
+    const required = computeRequiredStakeLamports(escrowLamports);
+    const have = BigInt(stake.stakedAmount.toString());
+    return have >= required ? 0n : required - have;
+  }
 }