@elemental-stv-core/sdk 0.7.0 → 0.8.0

package/dist/common/ata.d.ts

@@ -1,4 +1,4 @@
-import { PublicKey } from "@solana/web3.js";
+import { PublicKey, TransactionInstruction } from "@solana/web3.js";
 /**
  * Derive an Associated Token Account (ATA) address.
  *
@@ -12,3 +12,15 @@ import { PublicKey } from "@solana/web3.js";
  * @param tokenProgram - Token program ID (SPL Token or Token-2022)
  */
 export declare function findAta(mint: PublicKey, owner: PublicKey, tokenProgram: PublicKey): PublicKey;
+/**
+ * Build an Associated Token Account `CreateIdempotent` instruction.
+ *
+ * Idempotent — safe to include on every tx; the ATA program no-ops if the
+ * account already exists. Works for both SPL Token and Token-2022.
+ *
+ * @param payer - Wallet paying rent + signing the tx
+ * @param mint - Token mint the ATA will hold
+ * @param owner - ATA owner (wallet or PDA)
+ * @param tokenProgram - SPL Token or Token-2022 program id
+ */
+export declare function createIdempotentAtaIx(payer: PublicKey, mint: PublicKey, owner: PublicKey, tokenProgram: PublicKey): TransactionInstruction;

package/dist/common/ata.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findAta = findAta;
+exports.createIdempotentAtaIx = createIdempotentAtaIx;
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 /**
@@ -19,3 +20,29 @@ function findAta(mint, owner, tokenProgram) {
     const [ata] = web3_js_1.PublicKey.findProgramAddressSync([owner.toBuffer(), tokenProgram.toBuffer(), mint.toBuffer()], spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
     return ata;
 }
+/**
+ * Build an Associated Token Account `CreateIdempotent` instruction.
+ *
+ * Idempotent — safe to include on every tx; the ATA program no-ops if the
+ * account already exists. Works for both SPL Token and Token-2022.
+ *
+ * @param payer - Wallet paying rent + signing the tx
+ * @param mint - Token mint the ATA will hold
+ * @param owner - ATA owner (wallet or PDA)
+ * @param tokenProgram - SPL Token or Token-2022 program id
+ */
+function createIdempotentAtaIx(payer, mint, owner, tokenProgram) {
+    const ata = findAta(mint, owner, tokenProgram);
+    return new web3_js_1.TransactionInstruction({
+        keys: [
+            { pubkey: payer, isSigner: true, isWritable: true },
+            { pubkey: ata, isSigner: false, isWritable: true },
+            { pubkey: owner, isSigner: false, isWritable: false },
+            { pubkey: mint, isSigner: false, isWritable: false },
+            { pubkey: web3_js_1.SystemProgram.programId, isSigner: false, isWritable: false },
+            { pubkey: tokenProgram, isSigner: false, isWritable: false },
+        ],
+        programId: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        data: Buffer.from([1]), // CreateIdempotent
+    });
+}

package/dist/common/index.d.ts

@@ -3,4 +3,4 @@ export { PPS_DECIMALS, BPS_DENOMINATOR, SECONDS_PER_YEAR, STALENESS_THRESHOLD, D
 export type { SolanaConnection } from "./connection";
 export type { StrategyStateHeader, StvPosition, } from "./strategy-interface";
 export { deserializeStrategyStateHeader, deserializeStvPosition, } from "./strategy-interface";
-export { findAta } from "./ata";
+export { findAta, createIdempotentAtaIx } from "./ata";

package/dist/common/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findAta = exports.deserializeStvPosition = exports.deserializeStrategyStateHeader = exports.DISC_MANAGER_ROLE = exports.DISC_STV_POSITION = exports.DISC_STRATEGY_STATE = exports.STALENESS_THRESHOLD = exports.SECONDS_PER_YEAR = exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.writeOptionalU16 = exports.writeOptionalU32 = exports.writeOptionalU64 = exports.writeOptionalPubkey = exports.writeU64 = exports.readU8 = exports.readU16 = exports.readU32 = exports.readU64 = exports.readPubkey = void 0;
+exports.createIdempotentAtaIx = exports.findAta = exports.deserializeStvPosition = exports.deserializeStrategyStateHeader = exports.DISC_MANAGER_ROLE = exports.DISC_STV_POSITION = exports.DISC_STRATEGY_STATE = exports.STALENESS_THRESHOLD = exports.SECONDS_PER_YEAR = exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.writeOptionalU16 = exports.writeOptionalU32 = exports.writeOptionalU64 = exports.writeOptionalPubkey = exports.writeU64 = exports.readU8 = exports.readU16 = exports.readU32 = exports.readU64 = exports.readPubkey = void 0;
 var buffer_1 = require("./buffer");
 Object.defineProperty(exports, "readPubkey", { enumerable: true, get: function () { return buffer_1.readPubkey; } });
 Object.defineProperty(exports, "readU64", { enumerable: true, get: function () { return buffer_1.readU64; } });
@@ -25,3 +25,4 @@ Object.defineProperty(exports, "deserializeStrategyStateHeader", { enumerable: t
 Object.defineProperty(exports, "deserializeStvPosition", { enumerable: true, get: function () { return strategy_interface_1.deserializeStvPosition; } });
 var ata_1 = require("./ata");
 Object.defineProperty(exports, "findAta", { enumerable: true, get: function () { return ata_1.findAta; } });
+Object.defineProperty(exports, "createIdempotentAtaIx", { enumerable: true, get: function () { return ata_1.createIdempotentAtaIx; } });

package/dist/p-stv-core/accounts.d.ts

@@ -28,7 +28,7 @@ export declare function deserializeGlobalConfig(data: Buffer): GlobalConfig;
  *   [168..248]  childVaults[10]               [u64; 10]  (allocator child vault IDs)
  *   [248..256]  vaultId                       u64
  *   [256..264]  reservedBase                  u64      (base reserved for pending claims)
- *   [264..272]  requestedBase                 u64      (base requested via request_withdraw)
+ *   [264..272]  requestedShares               u64      (shares pending in escrow — multiply × PPS to estimate base)
  *   [272..280]  vaultCapacity                 u64      (0 = uncapped)
  *   [280..288]  minDeposit                    u64
  *   [288..296]  hwm                           u64      (high-water mark for perf fees)

package/dist/p-stv-core/accounts.js

@@ -66,7 +66,7 @@ function deserializeGlobalConfig(data) {
  *   [168..248]  childVaults[10]               [u64; 10]  (allocator child vault IDs)
  *   [248..256]  vaultId                       u64
  *   [256..264]  reservedBase                  u64      (base reserved for pending claims)
- *   [264..272]  requestedBase                 u64      (base requested via request_withdraw)
+ *   [264..272]  requestedShares               u64      (shares pending in escrow — multiply × PPS to estimate base)
  *   [272..280]  vaultCapacity                 u64      (0 = uncapped)
  *   [280..288]  minDeposit                    u64
  *   [288..296]  hwm                           u64      (high-water mark for perf fees)
@@ -110,7 +110,7 @@ function deserializeStv(data) {
         childVaults,
         vaultId: (0, buffer_1.readU64)(data, 248),
         reservedBase: (0, buffer_1.readU64)(data, 256),
-        requestedBase: (0, buffer_1.readU64)(data, 264),
+        requestedShares: (0, buffer_1.readU64)(data, 264),
         vaultCapacity: (0, buffer_1.readU64)(data, 272),
         minDeposit: (0, buffer_1.readU64)(data, 280),
         hwm: (0, buffer_1.readU64)(data, 288),

package/dist/p-stv-core/sol-wrap.js

@@ -12,7 +12,6 @@ exports.findWsolAta = findWsolAta;
 exports.buildWrapSolIxs = buildWrapSolIxs;
 exports.buildUnwrapSolIx = buildUnwrapSolIx;
 const web3_js_1 = require("@solana/web3.js");
-const spl_token_1 = require("@solana/spl-token");
 const ata_1 = require("../common/ata");
 /** Native SOL mint (wrapped SOL) */
 exports.NATIVE_SOL_MINT = new web3_js_1.PublicKey("So11111111111111111111111111111111111111112");
@@ -39,15 +38,12 @@ function findWsolAta(owner) {
 function buildWrapSolIxs(payer, lamports) {
     const wsolAta = findWsolAta(payer);
     return [
-        // Create wSOL ATA (idempotent)
-        createAtaIxInternal(payer, exports.NATIVE_SOL_MINT, payer),
-        // Transfer SOL to wSOL ATA
+        (0, ata_1.createIdempotentAtaIx)(payer, exports.NATIVE_SOL_MINT, payer, SPL_TOKEN_PROGRAM),
         web3_js_1.SystemProgram.transfer({
             fromPubkey: payer,
             toPubkey: wsolAta,
             lamports: BigInt(lamports),
         }),
-        // Sync native balance
         new web3_js_1.TransactionInstruction({
             programId: SPL_TOKEN_PROGRAM,
             keys: [{ pubkey: wsolAta, isSigner: false, isWritable: true }],
@@ -76,19 +72,3 @@ function buildUnwrapSolIx(owner) {
         data: Buffer.from([9]),
     });
 }
-/** Internal: create ATA (idempotent) */
-function createAtaIxInternal(payer, mint, owner) {
-    const ata = (0, ata_1.findAta)(mint, owner, SPL_TOKEN_PROGRAM);
-    return new web3_js_1.TransactionInstruction({
-        keys: [
-            { pubkey: payer, isSigner: true, isWritable: true },
-            { pubkey: ata, isSigner: false, isWritable: true },
-            { pubkey: owner, isSigner: false, isWritable: false },
-            { pubkey: mint, isSigner: false, isWritable: false },
-            { pubkey: web3_js_1.SystemProgram.programId, isSigner: false, isWritable: false },
-            { pubkey: SPL_TOKEN_PROGRAM, isSigner: false, isWritable: false },
-        ],
-        programId: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
-        data: Buffer.from([1]), // CreateIdempotent
-    });
-}

package/dist/p-stv-core/types.d.ts

@@ -16,7 +16,9 @@ export interface Stv {
     childVaults: BN[];
     vaultId: BN;
     reservedBase: BN;
-    requestedBase: BN;
+    /** Pending withdrawal shares (sum across unprocessed WithdrawRequests).
+     *  Display value: requestedShares × currentPps / PPS_DECIMALS. */
+    requestedShares: BN;
     vaultCapacity: BN;
     minDeposit: BN;
     hwm: BN;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elemental-stv-core/sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "TypeScript SDK for Elemental Vaults — p-STV Core, Elemental Lend, JLPD Strategy",
   "license": "Apache-2.0",
   "keywords": [