@perena/bankineco-sdk 1.0.145 → 1.0.147

package/README.md

@@ -78,7 +78,7 @@ const usdStarPrice = await getLatestUsdStarUiPrice(rpcUrl, "prod");
 ### Get Quote
 
 ```typescript
-const vault = this.getVault(USDC_MINT);
+const vault = client.getVault(USDC_MINT);
 
 // Calculate the amount of USD* you will get from the USDC provided
 const { amount: usdStarOutput, details: mintDetails } =
@@ -92,6 +92,38 @@ const { amount: usdcOutput, details: burnDetails } =
   );
 ```
 
+**Junior unstake fee quote (`fetchUnstakeFee`):** pass the number of **junior shares** as `amount` (same raw units as `requestUnstakeJuniorTx` / `instantUnstakeJuniorTx`). Use `early: true` when the user will pay the early fee (instant unstake, or fulfilling a queue before lockup expires); use `early: false` for a standard queued unstake after lockup.
+
+- **Junior → USD\* (bank mint / senior):** do not set `targetMint`. `feeAmount`, `amountAfterFee`, and `burningFeeAmount` are denominated in **USD\*** (bank mint) raw units; `burningFeeBps` stays zero because there is no vault burn on that path.
+
+- **Junior → yielding mint (e.g. USDC):** set `targetMint` to the yielding mint for an **idle vault the client supports** (the same mint you would pass to `requestUnstakeJuniorTx`). The SDK values the redemption in that mint and includes the vault **burn** fee, so `feeAmount` and `amountAfterFee` are in **that mint’s** raw units. Check `burningFeeBps` / `burningFeeAmount` for the burn portion.
+
+```typescript
+// Junior → USD* — standard vs early unstake fee only (amounts in USD* raw units)
+const juniorToUsdStar = await client.fetchUnstakeFee({
+  amount: fromUiAmount(5, USD_STAR_DECIMALS),
+  early: false,
+});
+
+const juniorToUsdStarEarly = await client.fetchUnstakeFee({
+  amount: fromUiAmount(5, USD_STAR_DECIMALS),
+  early: true,
+});
+
+// Junior → USDC — unstake fee + burn fee (amounts in USDC raw units)
+const juniorToUsdc = await client.fetchUnstakeFee({
+  amount: fromUiAmount(5, USD_STAR_DECIMALS),
+  early: false,
+  targetMint: USDC_MINT,
+});
+
+const juniorToUsdcEarly = await client.fetchUnstakeFee({
+  amount: fromUiAmount(5, USD_STAR_DECIMALS),
+  early: true,
+  targetMint: USDC_MINT,
+});
+```
+
 ### Staking (Junior Tranche)
 
 Stake USD\* into the junior tranche to earn leveraged yield. Staked tokens are represented by junior share tokens.
@@ -148,6 +180,29 @@ const { transaction: fulfillTx } = await client.fulfillUnstakeJuniorTx({
 const transaction = new Transaction().add(requestTx, fulfillTx);
 ```
 
+### Instant unstake (Junior) — `instantUnstakeJuniorTx`
+
+To exit the junior tranche in **one transaction** without using the withdrawal queue, use `instantUnstakeJuniorTx`. The program always applies the **early unstake fee** (same idea as fulfilling a queued request before lockup expires). Use `fetchUnstakeFee` with `early: true` if you want a fee quote first.
+
+```typescript
+const { transaction, lookupTables } = await client.instantUnstakeJuniorTx({
+  shares: fromUiAmount(5, USD_STAR_DECIMALS),
+  user: anchorWallet.publicKey,
+});
+```
+
+To receive a yielding asset (e.g. USDC) instead of USD\*, set `targetMint`. For vaults that need extra accounts on redeem (for example marginfi), pass `remainingAccounts` as you would for `requestUnstakeJuniorTx`.
+
+```typescript
+const { transaction, lookupTables } = await client.instantUnstakeJuniorTx({
+  shares: fromUiAmount(5, USD_STAR_DECIMALS),
+  targetMint: USDC_MINT,
+  user: anchorWallet.publicKey,
+});
+```
+
+The returned `transaction` should be signed and sent like other client helpers; attach `lookupTables` when building/sending the versioned transaction if your stack requires it.
+
 ### Reading Withdrawal Queues
 
 After requesting an unstake, you can fetch all withdrawal queue entries for a given owner to check amounts awaiting unstake and how much time remains until each lockup expires.

package/dist/utils/glowUtils.d.ts

@@ -36,8 +36,8 @@ export declare function fetchGlowUsdtTokenPrice(): Promise<number>;
  */
 export declare function getGlowUsdtShareHolderAta(owner: PublicKey): PublicKey;
 /**
- * Fetches the USDT value owed by the Glow usdt vault position (share balance × share price).
- * Used for uncollateralized external yield oracle: report this as pending yield in USDT base units.
+ * Fetches the USDT value of the Glow usdt vault position (share balance × share price).
+ * For oracle pending yield, subtract the vault's `external_yielding_amount` principal (see Kamino/MarginFi oracles).
  */
 export declare function fetchGlowUsdtOwed(connection: Connection, shareHolder: PublicKey): Promise<BN>;
 export declare function createGlowUsdtDepositTransaction(args: CreateGlowUsdtDepositTransactionArgs): Promise<CreateGlowUsdtTransactionResponse>;

package/dist/utils/glowUtils.js

@@ -95,8 +95,8 @@ function getGlowUsdtShareHolderAta(owner) {
     return deriveAta(constants_1.GLOW_USDT_SHARE_MINT, spl_token_1.TOKEN_2022_PROGRAM_ID, vaultUser);
 }
 /**
- * Fetches the USDT value owed by the Glow usdt vault position (share balance × share price).
- * Used for uncollateralized external yield oracle: report this as pending yield in USDT base units.
+ * Fetches the USDT value of the Glow usdt vault position (share balance × share price).
+ * For oracle pending yield, subtract the vault's `external_yielding_amount` principal (see Kamino/MarginFi oracles).
  */
 async function fetchGlowUsdtOwed(connection, shareHolder) {
     const sharePrice = await fetchGlowUsdtTokenPrice();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perena/bankineco-sdk",
-  "version": "1.0.145",
+  "version": "1.0.147",
   "description": "SDK for interacting with Bankineco program on Solana.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,7 +22,7 @@
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json",
     "deploy": "npm publish --access public --userconfig ~/.npmrc.perena",
-    "set-latest": "npm --userconfig ~/.npmrc.perena dist-tag add @perena/bankineco-sdk@1.0.120 latest"
+    "set-latest": "npm --userconfig ~/.npmrc.perena dist-tag add @perena/bankineco-sdk@1.0.147 latest"
   },
   "dependencies": {
     "@coral-xyz/anchor": "=0.30.1",