@elmntl/jlpd-sdk 0.2.0 → 0.13.5

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

@@ -0,0 +1,138 @@
+import { PublicKey } from "@solana/web3.js";
+export declare const PROGRAM_ID: PublicKey;
+export declare const CONFIG_SEED: Buffer<ArrayBuffer>;
+export declare const STV_SEED: Buffer<ArrayBuffer>;
+export declare const EV_MINT_SEED: Buffer<ArrayBuffer>;
+export declare const WITHDRAW_REQUEST_SEED: Buffer<ArrayBuffer>;
+export declare const MIGRATE_REQUEST_SEED: Buffer<ArrayBuffer>;
+export declare const DELAYED_DEPOSIT_SEED: Buffer<ArrayBuffer>;
+export declare const MANAGER_SEED: Buffer<ArrayBuffer>;
+export declare const DISC_GLOBAL_CONFIG: Buffer<ArrayBuffer>;
+export declare const DISC_STV: Buffer<ArrayBuffer>;
+export declare const DISC_WITHDRAW_REQUEST: Buffer<ArrayBuffer>;
+export declare const DISC_DELAYED_DEPOSIT_REQUEST: Buffer<ArrayBuffer>;
+export { DISC_MANAGER_ROLE } from "../common/constants";
+export declare const IX_INIT_OR_UPDATE_CONFIG = 0;
+export declare const IX_INIT_OR_UPDATE_STV = 1;
+export declare const IX_DEPOSIT = 2;
+export declare const IX_REQUEST_WITHDRAW = 3;
+export declare const IX_CLAIM_WITHDRAW = 4;
+export declare const IX_PROCESS_EPOCH = 5;
+export declare const IX_DEPOSIT_TO_STRATEGY = 6;
+export declare const IX_WITHDRAW_FROM_STRATEGY = 7;
+export declare const IX_CLOSE_STV = 8;
+export declare const IX_ADD_MANAGER = 9;
+export declare const IX_REMOVE_MANAGER = 10;
+export declare const IX_OVERRIDE_CLAIM_WITHDRAW = 11;
+export declare const IX_MIGRATE_LEND = 12;
+export declare const IX_MIGRATE_REQUEST = 13;
+export declare const IX_MIGRATE_EXECUTE = 14;
+export declare const IX_PROCESS_DELAYED_DEPOSIT = 15;
+export declare const IX_MIGRATE_CANCEL = 16;
+export declare const IX_INSTANT_WITHDRAW = 17;
+export declare const IX_SEED_STV = 18;
+/** accept_vault_admin (disc 0x14 = 20) — complete a two-step vault-admin rotation. */
+export declare const IX_ACCEPT_VAULT_ADMIN = 20;
+/**
+ * trip_circuit_breaker (disc 0x15 = 21) — freeze a vault (sets FLAG_PAUSED).
+ * Set-only, idempotent; callable by cold admin, warm admin, or a valid
+ * manager (OR-auth precedence: cold -> warm -> manager). Disc 21 is used
+ * (not the retired 19 = migrate_stv_layout) so a stale client replaying the
+ * old migration call keeps failing InvalidInstructionData instead of
+ * silently freezing a vault. See docs/spec-warm-admin-guardrails.md §4.3.
+ */
+export declare const IX_TRIP_CIRCUIT_BREAKER = 21;
+export declare const EVT_CONFIG_INITIALIZED = 0;
+export declare const EVT_CONFIG_UPDATED = 1;
+export declare const EVT_STV_CREATED = 2;
+export declare const EVT_STV_UPDATED = 3;
+export declare const EVT_DEPOSITED = 4;
+export declare const EVT_WITHDRAW_REQUESTED = 5;
+export declare const EVT_WITHDRAW_REQUEST_INCREASED = 6;
+export declare const EVT_WITHDRAW_CLAIMED = 7;
+export declare const EVT_DEPOSITED_TO_STRATEGY = 8;
+export declare const EVT_WITHDRAWN_FROM_STRATEGY = 9;
+export declare const EVT_EPOCH_PROCESSED = 10;
+export declare const EVT_EPOCH_ADVANCED = 11;
+export declare const EVT_FEES_SETTLED = 12;
+export declare const EVT_STV_CLOSED = 13;
+export declare const EVT_MANAGER_ADDED = 14;
+export declare const EVT_MANAGER_REMOVED = 15;
+export declare const EVT_WITHDRAW_OVERRIDE_CLAIMED = 16;
+export declare const EVT_LEND_MIGRATED = 17;
+export declare const EVT_MIGRATE_REQUESTED = 18;
+export declare const EVT_MIGRATE_EXECUTED = 19;
+export declare const EVT_DELAYED_DEPOSIT_PROCESSED = 20;
+export declare const EVT_INSTANT_WITHDRAWN = 21;
+export declare const EVT_STV_SEEDED = 22;
+/** AdminRotationStarted — emitted when update sets pending_admin to nonzero. Fields: vault_id(8), newPendingAdmin(32). */
+export declare const EVT_ADMIN_ROTATION_STARTED = 24;
+/** AdminRotationAccepted — emitted by accept_vault_admin. Fields: vault_id(8), newAdmin(32). */
+export declare const EVT_ADMIN_ROTATION_ACCEPTED = 25;
+/**
+ * WarmAdminSet — emitted whenever the stored `Stv.warmAdmin` value actually
+ * changes: by init_or_update_stv (create/update) or by accept_vault_admin
+ * (self-warm promotion normalization). Fields: vaultId(8), warmAdmin(32).
+ * (23 = StvAdminSet stays dead; disc numbers are never reused.)
+ */
+export declare const EVT_WARM_ADMIN_SET = 26;
+/**
+ * CircuitBreakerTripped — emitted by trip_circuit_breaker (disc 21) every
+ * call, including idempotent re-trips of an already-paused vault.
+ * Fields: vaultId(8), trippedBy(32), authorityKind(1: 0=cold,1=warm,2=manager).
+ */
+export declare const EVT_CIRCUIT_BREAKER_TRIPPED = 27;
+/**
+ * `trip_circuit_breaker`'s `authority_kind` values (also the
+ * CircuitBreakerTripped event's authorityKind field). Precedence order at
+ * evaluation time is cold -> warm -> manager (first match wins — a stray or
+ * invalid manager_role account never vetoes a valid cold/warm signer).
+ */
+export declare const TRIP_AUTHORITY_KIND_COLD = 0;
+export declare const TRIP_AUTHORITY_KIND_WARM = 1;
+export declare const TRIP_AUTHORITY_KIND_MANAGER = 2;
+export declare const FLAG_PAUSED = 1;
+export declare const FLAG_DEPOSITS_DISABLED = 2;
+export declare const FLAG_WITHDRAWALS_DISABLED = 4;
+export declare const FLAG_REBALANCE_DISABLED = 8;
+export declare const FLAG_ALLOCATOR = 32;
+/** Skip the per-epoch withdraw rate-limit on this STV (claim_withdraw + migrate_execute). */
+export declare const FLAG_BYPASS_WITHDRAW_LIMIT = 64;
+/** Source STV: apply withdrawal_fee_bps when migrating OUT via migrate_request/migrate_execute. */
+export declare const FLAG_WITHDRAWAL_FEE_ON_MIGRATE = 128;
+/** Dest STV: apply deposit_fee_bps when migrating IN via migrate_execute. */
+export declare const FLAG_DEPOSIT_FEE_ON_MIGRATE = 256;
+/** Delay user deposits by at least one epoch before evX is minted. */
+export declare const FLAG_DELAYED_DEPOSIT = 512;
+/** Migrate exit (source) skips the +1 epoch cooldown — in-protocol move, no drain risk. */
+export declare const FLAG_BYPASS_MIGRATE_SRC_WAITOUT = 1024;
+/** Migrate entry (dest) skips its waitout. */
+export declare const FLAG_BYPASS_MIGRATE_DST_WAITOUT = 2048;
+/**
+ * C-1 seed gate. Program-owned (set by seed_stv, never via
+ * init_or_update_stv). When unset, every public path reverts VaultNotSeeded.
+ * When set with locked_seed_shares > 0, the vault may run instant_withdraw.
+ */
+export declare const FLAG_SEEDED = 4096;
+/**
+ * Protocol-wide emergency pause. When set on `GlobalConfig.flags`, blocks
+ * every value-movement instruction across every STV (deposit, request/claim
+ * withdraw, process_epoch, deposit/withdraw_from_strategy,
+ * override_claim_withdraw). Admin/rescue paths
+ * (init_or_update_config, init_or_update_stv, close_stv, add/remove_manager)
+ * remain open so the admin can reconfigure and clear the pause.
+ */
+export declare const CFG_FLAG_GLOBAL_PAUSED = 1;
+export { PPS_DECIMALS, BPS_DENOMINATOR, STALENESS_THRESHOLD } from "../common/constants";
+export declare const MAX_CHILD_VAULTS = 4;
+export declare const MAX_STRATEGIES = 4;
+export declare const FEE_CAP_BPS = 9900;
+/** Max deposit_fee_bps / withdrawal_fee_bps (enforced at init_or_update_stv). */
+export declare const MAX_FEE_BPS = 1000;
+/** WithdrawRequest.request_flags bit 0: 0 = withdraw, 1 = migrate. */
+export declare const WR_FLAG_MIGRATE = 1;
+export declare const GLOBAL_CONFIG_SIZE = 56;
+export declare const STV_SIZE = 664;
+export declare const WITHDRAW_REQUEST_SIZE = 168;
+export declare const DELAYED_DEPOSIT_REQUEST_SIZE = 152;
+export declare const MANAGER_ROLE_SIZE = 80;

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

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVT_MANAGER_REMOVED = exports.EVT_MANAGER_ADDED = exports.EVT_STV_CLOSED = exports.EVT_FEES_SETTLED = exports.EVT_EPOCH_ADVANCED = exports.EVT_EPOCH_PROCESSED = exports.EVT_WITHDRAWN_FROM_STRATEGY = exports.EVT_DEPOSITED_TO_STRATEGY = exports.EVT_WITHDRAW_CLAIMED = exports.EVT_WITHDRAW_REQUEST_INCREASED = exports.EVT_WITHDRAW_REQUESTED = exports.EVT_DEPOSITED = exports.EVT_STV_UPDATED = exports.EVT_STV_CREATED = exports.EVT_CONFIG_UPDATED = exports.EVT_CONFIG_INITIALIZED = exports.IX_TRIP_CIRCUIT_BREAKER = exports.IX_ACCEPT_VAULT_ADMIN = exports.IX_SEED_STV = exports.IX_INSTANT_WITHDRAW = exports.IX_MIGRATE_CANCEL = exports.IX_PROCESS_DELAYED_DEPOSIT = exports.IX_MIGRATE_EXECUTE = exports.IX_MIGRATE_REQUEST = exports.IX_MIGRATE_LEND = exports.IX_OVERRIDE_CLAIM_WITHDRAW = exports.IX_REMOVE_MANAGER = exports.IX_ADD_MANAGER = exports.IX_CLOSE_STV = exports.IX_WITHDRAW_FROM_STRATEGY = exports.IX_DEPOSIT_TO_STRATEGY = exports.IX_PROCESS_EPOCH = exports.IX_CLAIM_WITHDRAW = exports.IX_REQUEST_WITHDRAW = exports.IX_DEPOSIT = exports.IX_INIT_OR_UPDATE_STV = exports.IX_INIT_OR_UPDATE_CONFIG = exports.DISC_MANAGER_ROLE = exports.DISC_DELAYED_DEPOSIT_REQUEST = exports.DISC_WITHDRAW_REQUEST = exports.DISC_STV = exports.DISC_GLOBAL_CONFIG = exports.MANAGER_SEED = exports.DELAYED_DEPOSIT_SEED = exports.MIGRATE_REQUEST_SEED = exports.WITHDRAW_REQUEST_SEED = exports.EV_MINT_SEED = exports.STV_SEED = exports.CONFIG_SEED = exports.PROGRAM_ID = void 0;
+exports.MANAGER_ROLE_SIZE = exports.DELAYED_DEPOSIT_REQUEST_SIZE = exports.WITHDRAW_REQUEST_SIZE = exports.STV_SIZE = exports.GLOBAL_CONFIG_SIZE = exports.WR_FLAG_MIGRATE = exports.MAX_FEE_BPS = exports.FEE_CAP_BPS = exports.MAX_STRATEGIES = exports.MAX_CHILD_VAULTS = exports.STALENESS_THRESHOLD = exports.BPS_DENOMINATOR = exports.PPS_DECIMALS = exports.CFG_FLAG_GLOBAL_PAUSED = exports.FLAG_SEEDED = exports.FLAG_BYPASS_MIGRATE_DST_WAITOUT = exports.FLAG_BYPASS_MIGRATE_SRC_WAITOUT = exports.FLAG_DELAYED_DEPOSIT = exports.FLAG_DEPOSIT_FEE_ON_MIGRATE = exports.FLAG_WITHDRAWAL_FEE_ON_MIGRATE = exports.FLAG_BYPASS_WITHDRAW_LIMIT = exports.FLAG_ALLOCATOR = exports.FLAG_REBALANCE_DISABLED = exports.FLAG_WITHDRAWALS_DISABLED = exports.FLAG_DEPOSITS_DISABLED = exports.FLAG_PAUSED = exports.TRIP_AUTHORITY_KIND_MANAGER = exports.TRIP_AUTHORITY_KIND_WARM = exports.TRIP_AUTHORITY_KIND_COLD = exports.EVT_CIRCUIT_BREAKER_TRIPPED = exports.EVT_WARM_ADMIN_SET = exports.EVT_ADMIN_ROTATION_ACCEPTED = exports.EVT_ADMIN_ROTATION_STARTED = exports.EVT_STV_SEEDED = exports.EVT_INSTANT_WITHDRAWN = exports.EVT_DELAYED_DEPOSIT_PROCESSED = exports.EVT_MIGRATE_EXECUTED = exports.EVT_MIGRATE_REQUESTED = exports.EVT_LEND_MIGRATED = exports.EVT_WITHDRAW_OVERRIDE_CLAIMED = void 0;
+const web3_js_1 = require("@solana/web3.js");
+// ---------------------------------------------------------------------------
+// Program ID
+// ---------------------------------------------------------------------------
+exports.PROGRAM_ID = new web3_js_1.PublicKey("PSTVH77GiPqA3msXmpjAyUXdh3MytK37GCPbPzWu3Rc");
+// ---------------------------------------------------------------------------
+// PDA Seeds
+// ---------------------------------------------------------------------------
+exports.CONFIG_SEED = Buffer.from("config");
+exports.STV_SEED = Buffer.from("stv");
+exports.EV_MINT_SEED = Buffer.from("ev_mint");
+exports.WITHDRAW_REQUEST_SEED = Buffer.from("withdraw_request");
+exports.MIGRATE_REQUEST_SEED = Buffer.from("migrate_request");
+exports.DELAYED_DEPOSIT_SEED = Buffer.from("delayed_deposit");
+exports.MANAGER_SEED = Buffer.from("manager");
+// ---------------------------------------------------------------------------
+// Account Discriminators (8-byte Anchor-compatible)
+// ---------------------------------------------------------------------------
+exports.DISC_GLOBAL_CONFIG = Buffer.from([
+    0x95, 0x08, 0x9c, 0xca, 0xa0, 0xfc, 0xb0, 0xd9,
+]);
+exports.DISC_STV = Buffer.from([
+    0xeb, 0xe0, 0xe4, 0x64, 0x04, 0xde, 0x9b, 0xa6,
+]);
+exports.DISC_WITHDRAW_REQUEST = Buffer.from([
+    0xba, 0xef, 0xae, 0xbf, 0xbd, 0x0d, 0x2f, 0xc4,
+]);
+exports.DISC_DELAYED_DEPOSIT_REQUEST = Buffer.from([
+    0x33, 0x09, 0xc3, 0xd1, 0xbd, 0xee, 0x7b, 0xe1,
+]);
+// Shared with elemental-lend and jlpd-strategy — defined once in common/
+var constants_1 = require("../common/constants");
+Object.defineProperty(exports, "DISC_MANAGER_ROLE", { enumerable: true, get: function () { return constants_1.DISC_MANAGER_ROLE; } });
+// ---------------------------------------------------------------------------
+// Instruction Discriminators (1-byte)
+// ---------------------------------------------------------------------------
+exports.IX_INIT_OR_UPDATE_CONFIG = 0;
+exports.IX_INIT_OR_UPDATE_STV = 1;
+exports.IX_DEPOSIT = 2;
+exports.IX_REQUEST_WITHDRAW = 3;
+exports.IX_CLAIM_WITHDRAW = 4;
+exports.IX_PROCESS_EPOCH = 5;
+exports.IX_DEPOSIT_TO_STRATEGY = 6;
+exports.IX_WITHDRAW_FROM_STRATEGY = 7;
+exports.IX_CLOSE_STV = 8;
+exports.IX_ADD_MANAGER = 9;
+exports.IX_REMOVE_MANAGER = 10;
+exports.IX_OVERRIDE_CLAIM_WITHDRAW = 11;
+exports.IX_MIGRATE_LEND = 12;
+exports.IX_MIGRATE_REQUEST = 13;
+exports.IX_MIGRATE_EXECUTE = 14;
+exports.IX_PROCESS_DELAYED_DEPOSIT = 15;
+exports.IX_MIGRATE_CANCEL = 16;
+exports.IX_INSTANT_WITHDRAW = 17;
+exports.IX_SEED_STV = 18;
+/** accept_vault_admin (disc 0x14 = 20) — complete a two-step vault-admin rotation. */
+exports.IX_ACCEPT_VAULT_ADMIN = 20;
+/**
+ * trip_circuit_breaker (disc 0x15 = 21) — freeze a vault (sets FLAG_PAUSED).
+ * Set-only, idempotent; callable by cold admin, warm admin, or a valid
+ * manager (OR-auth precedence: cold -> warm -> manager). Disc 21 is used
+ * (not the retired 19 = migrate_stv_layout) so a stale client replaying the
+ * old migration call keeps failing InvalidInstructionData instead of
+ * silently freezing a vault. See docs/spec-warm-admin-guardrails.md §4.3.
+ */
+exports.IX_TRIP_CIRCUIT_BREAKER = 21;
+// ---------------------------------------------------------------------------
+// Event Discriminators (1-byte)
+// ---------------------------------------------------------------------------
+exports.EVT_CONFIG_INITIALIZED = 0;
+exports.EVT_CONFIG_UPDATED = 1;
+exports.EVT_STV_CREATED = 2;
+exports.EVT_STV_UPDATED = 3;
+exports.EVT_DEPOSITED = 4;
+exports.EVT_WITHDRAW_REQUESTED = 5;
+exports.EVT_WITHDRAW_REQUEST_INCREASED = 6;
+exports.EVT_WITHDRAW_CLAIMED = 7;
+exports.EVT_DEPOSITED_TO_STRATEGY = 8;
+exports.EVT_WITHDRAWN_FROM_STRATEGY = 9;
+exports.EVT_EPOCH_PROCESSED = 10;
+exports.EVT_EPOCH_ADVANCED = 11;
+exports.EVT_FEES_SETTLED = 12;
+exports.EVT_STV_CLOSED = 13;
+exports.EVT_MANAGER_ADDED = 14;
+exports.EVT_MANAGER_REMOVED = 15;
+exports.EVT_WITHDRAW_OVERRIDE_CLAIMED = 16;
+exports.EVT_LEND_MIGRATED = 17;
+exports.EVT_MIGRATE_REQUESTED = 18;
+exports.EVT_MIGRATE_EXECUTED = 19;
+exports.EVT_DELAYED_DEPOSIT_PROCESSED = 20;
+exports.EVT_INSTANT_WITHDRAWN = 21;
+exports.EVT_STV_SEEDED = 22;
+/** AdminRotationStarted — emitted when update sets pending_admin to nonzero. Fields: vault_id(8), newPendingAdmin(32). */
+exports.EVT_ADMIN_ROTATION_STARTED = 24;
+/** AdminRotationAccepted — emitted by accept_vault_admin. Fields: vault_id(8), newAdmin(32). */
+exports.EVT_ADMIN_ROTATION_ACCEPTED = 25;
+/**
+ * WarmAdminSet — emitted whenever the stored `Stv.warmAdmin` value actually
+ * changes: by init_or_update_stv (create/update) or by accept_vault_admin
+ * (self-warm promotion normalization). Fields: vaultId(8), warmAdmin(32).
+ * (23 = StvAdminSet stays dead; disc numbers are never reused.)
+ */
+exports.EVT_WARM_ADMIN_SET = 26;
+/**
+ * CircuitBreakerTripped — emitted by trip_circuit_breaker (disc 21) every
+ * call, including idempotent re-trips of an already-paused vault.
+ * Fields: vaultId(8), trippedBy(32), authorityKind(1: 0=cold,1=warm,2=manager).
+ */
+exports.EVT_CIRCUIT_BREAKER_TRIPPED = 27;
+/**
+ * `trip_circuit_breaker`'s `authority_kind` values (also the
+ * CircuitBreakerTripped event's authorityKind field). Precedence order at
+ * evaluation time is cold -> warm -> manager (first match wins — a stray or
+ * invalid manager_role account never vetoes a valid cold/warm signer).
+ */
+exports.TRIP_AUTHORITY_KIND_COLD = 0;
+exports.TRIP_AUTHORITY_KIND_WARM = 1;
+exports.TRIP_AUTHORITY_KIND_MANAGER = 2;
+// ---------------------------------------------------------------------------
+// Vault Flags
+// ---------------------------------------------------------------------------
+// STV flags
+exports.FLAG_PAUSED = 0x0001;
+exports.FLAG_DEPOSITS_DISABLED = 0x0002;
+exports.FLAG_WITHDRAWALS_DISABLED = 0x0004;
+exports.FLAG_REBALANCE_DISABLED = 0x0008;
+exports.FLAG_ALLOCATOR = 0x0020;
+/** Skip the per-epoch withdraw rate-limit on this STV (claim_withdraw + migrate_execute). */
+exports.FLAG_BYPASS_WITHDRAW_LIMIT = 0x0040;
+/** Source STV: apply withdrawal_fee_bps when migrating OUT via migrate_request/migrate_execute. */
+exports.FLAG_WITHDRAWAL_FEE_ON_MIGRATE = 0x0080;
+/** Dest STV: apply deposit_fee_bps when migrating IN via migrate_execute. */
+exports.FLAG_DEPOSIT_FEE_ON_MIGRATE = 0x0100;
+/** Delay user deposits by at least one epoch before evX is minted. */
+exports.FLAG_DELAYED_DEPOSIT = 0x0200;
+/** Migrate exit (source) skips the +1 epoch cooldown — in-protocol move, no drain risk. */
+exports.FLAG_BYPASS_MIGRATE_SRC_WAITOUT = 0x0400;
+/** Migrate entry (dest) skips its waitout. */
+exports.FLAG_BYPASS_MIGRATE_DST_WAITOUT = 0x0800;
+/**
+ * C-1 seed gate. Program-owned (set by seed_stv, never via
+ * init_or_update_stv). When unset, every public path reverts VaultNotSeeded.
+ * When set with locked_seed_shares > 0, the vault may run instant_withdraw.
+ */
+exports.FLAG_SEEDED = 0x1000;
+// GlobalConfig flags
+/**
+ * Protocol-wide emergency pause. When set on `GlobalConfig.flags`, blocks
+ * every value-movement instruction across every STV (deposit, request/claim
+ * withdraw, process_epoch, deposit/withdraw_from_strategy,
+ * override_claim_withdraw). Admin/rescue paths
+ * (init_or_update_config, init_or_update_stv, close_stv, add/remove_manager)
+ * remain open so the admin can reconfigure and clear the pause.
+ */
+exports.CFG_FLAG_GLOBAL_PAUSED = 0x0001;
+// ---------------------------------------------------------------------------
+// Protocol Constants
+// ---------------------------------------------------------------------------
+var constants_2 = require("../common/constants");
+Object.defineProperty(exports, "PPS_DECIMALS", { enumerable: true, get: function () { return constants_2.PPS_DECIMALS; } });
+Object.defineProperty(exports, "BPS_DENOMINATOR", { enumerable: true, get: function () { return constants_2.BPS_DENOMINATOR; } });
+Object.defineProperty(exports, "STALENESS_THRESHOLD", { enumerable: true, get: function () { return constants_2.STALENESS_THRESHOLD; } });
+exports.MAX_CHILD_VAULTS = 4;
+exports.MAX_STRATEGIES = exports.MAX_CHILD_VAULTS; // backward compat
+exports.FEE_CAP_BPS = 9900;
+/** Max deposit_fee_bps / withdrawal_fee_bps (enforced at init_or_update_stv). */
+exports.MAX_FEE_BPS = 1000;
+/** WithdrawRequest.request_flags bit 0: 0 = withdraw, 1 = migrate. */
+exports.WR_FLAG_MIGRATE = 0x01;
+// ---------------------------------------------------------------------------
+// Account Sizes
+// ---------------------------------------------------------------------------
+exports.GLOBAL_CONFIG_SIZE = 56;
+exports.STV_SIZE = 664;
+exports.WITHDRAW_REQUEST_SIZE = 168;
+exports.DELAYED_DEPOSIT_REQUEST_SIZE = 152;
+exports.MANAGER_ROLE_SIZE = 80;

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

@@ -0,0 +1,7 @@
+import { PublicKey } from "@solana/web3.js";
+import type { StvEvent } from "./types";
+/**
+ * Parse events from transaction log messages.
+ * p-stv-core uses 1-byte event discriminators via sol_log_data.
+ */
+export declare function parseEventsFromLogs(logs: string[], programId?: PublicKey): StvEvent[];

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

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEventsFromLogs = parseEventsFromLogs;
+const buffer_1 = require("../common/buffer");
+const constants_1 = require("./constants");
+const PROGRAM_DATA_PREFIX = "Program data: ";
+/**
+ * Parse events from transaction log messages.
+ * p-stv-core uses 1-byte event discriminators via sol_log_data.
+ */
+function parseEventsFromLogs(logs, programId = constants_1.PROGRAM_ID) {
+    const events = [];
+    const programIdStr = programId.toBase58();
+    let inProgram = false;
+    for (const line of logs) {
+        if (line.includes(`Program ${programIdStr} invoke`)) {
+            inProgram = true;
+            continue;
+        }
+        if (line.includes(`Program ${programIdStr} success`) ||
+            line.includes(`Program ${programIdStr} failed`)) {
+            inProgram = false;
+            continue;
+        }
+        if (!inProgram)
+            continue;
+        if (!line.startsWith(PROGRAM_DATA_PREFIX))
+            continue;
+        const dataStr = line.slice(PROGRAM_DATA_PREFIX.length);
+        const segments = dataStr.split(" ").filter((s) => s.length > 0);
+        if (segments.length === 0)
+            continue;
+        const buffers = segments.map((s) => Buffer.from(s, "base64"));
+        const combined = Buffer.concat(buffers);
+        if (combined.length === 0)
+            continue;
+        const evt = parseEventBuffer(combined);
+        if (evt)
+            events.push(evt);
+    }
+    return events;
+}
+/**
+ * p-stv-core event payload layout reference (offsets are within the
+ * `Program data: …` log buffer; see also `EVT_*` discriminators in
+ * `constants.ts`):
+ *
+ *   ConfigInitialized           [0..1] disc | [1..33]  admin
+ *   ConfigUpdated               [0..1] disc | [1..33]  admin     | [33..35] flags
+ *   StvCreated                  [0..1] disc | [1..9]  vaultId    | [9..41]  baseMint     |
+ *                               [41..73] evMint | [73..105] feeReceiver | [105..137] strategy |
+ *                               [137..169] lendProgram | [169..173] epochSec |
+ *                               [173..175] mgmtFeeBps | [175..177] perfFeeBps
+ *   StvUpdated                  [0..1] disc | [1..9]  vaultId    | [9..41]  feeReceiver  |
+ *                               [41..43] flags | [43..45] mgmtFeeBps | [45..47] perfFeeBps |
+ *                               [47..55] vaultCapacity | [55..63] minDeposit |
+ *                               [63..64] childVaultCount | [64..96] lendProgram
+ *   Deposited                   [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] amount | [49..57] sharesMinted | [57..65] depositFeeShares |
+ *                               [65..73] pps
+ *   WithdrawRequested           [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] shares | [49..53] epochId
+ *   WithdrawRequestIncreased    [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] additionalShares | [49..57] totalShares |
+ *                               [57..61] epochId
+ *   WithdrawClaimed             [0..1] disc | [1..9]  vaultId    | [9..41]  user         |
+ *                               [41..49] shares | [49..57] baseAmount | [57..61] epochId
+ *   DepositedToStrategy         [0..1] disc | [1..9]  vaultId    | [9..41]  strategy     |
+ *                               [41..49] amount | [49..57] sharesReceived
+ *   WithdrawnFromStrategy       [0..1] disc | [1..9]  vaultId    | [9..41]  strategy     |
+ *                               [41..49] shares | [49..57] baseReceived
+ *   EpochProcessed              [0..1] disc | [1..9]  vaultId    | [9..13]  epochId      |
+ *                               [13..21] epochPps | [21..29] feeSharesMinted
+ *   EpochAdvanced               [0..1] disc | [1..9]  vaultId    | [9..13]  newEpochId   |
+ *                               [13..17] nextEpochTs
+ *   FeesSettled                 [0..1] disc | [1..9]  vaultId    | [9..17]  mgmtFeeBase  |
+ *                               [17..25] perfFeeBase | [25..33] feeSharesMinted |
+ *                               [33..41] postFeePps | [41..49] hwm
+ *   StvClosed                   [0..1] disc | [1..9]  vaultId
+ *   ManagerAdded                [0..1] disc | [1..33] stv        | [33..65] manager
+ *   ManagerRemoved              [0..1] disc | [1..33] stv        | [33..65] manager
+ *   DelayedDepositProcessed     [0..1] disc | [1..9] vaultId     | [9..41] user |
+ *                               [41..49] amount | [49..57] sharesMinted |
+ *                               [57..65] depositFeeShares | [65..73] pps |
+ *                               [73..77] requestEpochId
+ *   WarmAdminSet                [0..1] disc | [1..9]  vaultId    | [9..41]  warmAdmin
+ *   CircuitBreakerTripped       [0..1] disc | [1..9]  vaultId    | [9..41]  trippedBy   |
+ *                               [41..42] authorityKind
+ */
+function parseEventBuffer(data) {
+    if (data.length === 0)
+        return null;
+    const disc = data[0];
+    switch (disc) {
+        case constants_1.EVT_CONFIG_INITIALIZED:
+            return data.length >= 33 ? { name: "ConfigInitialized", admin: (0, buffer_1.readPubkey)(data, 1) } : null;
+        case constants_1.EVT_CONFIG_UPDATED:
+            return data.length >= 35 ? { name: "ConfigUpdated", admin: (0, buffer_1.readPubkey)(data, 1), flags: (0, buffer_1.readU16)(data, 33) } : null;
+        case constants_1.EVT_STV_CREATED:
+            return data.length >= 177 ? {
+                name: "StvCreated", vaultId: (0, buffer_1.readU64)(data, 1), baseMint: (0, buffer_1.readPubkey)(data, 9),
+                evMint: (0, buffer_1.readPubkey)(data, 41), feeReceiver: (0, buffer_1.readPubkey)(data, 73),
+                strategy: (0, buffer_1.readPubkey)(data, 105), lendProgram: (0, buffer_1.readPubkey)(data, 137),
+                epochSec: (0, buffer_1.readU32)(data, 169), mgmtFeeBps: (0, buffer_1.readU16)(data, 173), perfFeeBps: (0, buffer_1.readU16)(data, 175),
+            } : null;
+        case constants_1.EVT_STV_UPDATED:
+            return data.length >= 96 ? {
+                name: "StvUpdated", vaultId: (0, buffer_1.readU64)(data, 1), feeReceiver: (0, buffer_1.readPubkey)(data, 9),
+                flags: (0, buffer_1.readU16)(data, 41), mgmtFeeBps: (0, buffer_1.readU16)(data, 43),
+                perfFeeBps: (0, buffer_1.readU16)(data, 45), vaultCapacity: (0, buffer_1.readU64)(data, 47), minDeposit: (0, buffer_1.readU64)(data, 55),
+                childVaultCount: data[63], lendProgram: (0, buffer_1.readPubkey)(data, 64),
+            } : null;
+        case constants_1.EVT_DEPOSITED:
+            return data.length >= 73 ? {
+                name: "Deposited", vaultId: (0, buffer_1.readU64)(data, 1), user: (0, buffer_1.readPubkey)(data, 9),
+                amount: (0, buffer_1.readU64)(data, 41), sharesMinted: (0, buffer_1.readU64)(data, 49),
+                depositFeeShares: (0, buffer_1.readU64)(data, 57), pps: (0, buffer_1.readU64)(data, 65),
+            } : null;
+        case constants_1.EVT_WITHDRAW_REQUESTED:
+            return data.length >= 53 ? {
+                name: "WithdrawRequested", vaultId: (0, buffer_1.readU64)(data, 1), user: (0, buffer_1.readPubkey)(data, 9),
+                shares: (0, buffer_1.readU64)(data, 41), epochId: (0, buffer_1.readU32)(data, 49),
+            } : null;
+        case constants_1.EVT_WITHDRAW_REQUEST_INCREASED:
+            return data.length >= 61 ? {
+                name: "WithdrawRequestIncreased", vaultId: (0, buffer_1.readU64)(data, 1), user: (0, buffer_1.readPubkey)(data, 9),
+                additionalShares: (0, buffer_1.readU64)(data, 41), totalShares: (0, buffer_1.readU64)(data, 49), epochId: (0, buffer_1.readU32)(data, 57),
+            } : null;
+        case constants_1.EVT_WITHDRAW_CLAIMED:
+            // Rust: vault_id(8), user(32), shares(8), net_base(8), withdrawal_fee_base(8), epoch_id(4)
+            return data.length >= 69 ? {
+                name: "WithdrawClaimed", vaultId: (0, buffer_1.readU64)(data, 1), user: (0, buffer_1.readPubkey)(data, 9),
+                shares: (0, buffer_1.readU64)(data, 41), baseAmount: (0, buffer_1.readU64)(data, 49),
+                withdrawalFeeBase: (0, buffer_1.readU64)(data, 57), epochId: (0, buffer_1.readU32)(data, 65),
+            } : null;
+        case constants_1.EVT_DEPOSITED_TO_STRATEGY:
+            return data.length >= 57 ? {
+                name: "DepositedToStrategy", vaultId: (0, buffer_1.readU64)(data, 1), strategy: (0, buffer_1.readPubkey)(data, 9),
+                amount: (0, buffer_1.readU64)(data, 41), sharesReceived: (0, buffer_1.readU64)(data, 49),
+            } : null;
+        case constants_1.EVT_WITHDRAWN_FROM_STRATEGY:
+            return data.length >= 57 ? {
+                name: "WithdrawnFromStrategy", vaultId: (0, buffer_1.readU64)(data, 1), strategy: (0, buffer_1.readPubkey)(data, 9),
+                shares: (0, buffer_1.readU64)(data, 41), baseReceived: (0, buffer_1.readU64)(data, 49),
+            } : null;
+        case constants_1.EVT_EPOCH_PROCESSED:
+            return data.length >= 29 ? {
+                name: "EpochProcessed", vaultId: (0, buffer_1.readU64)(data, 1), epochId: (0, buffer_1.readU32)(data, 9),
+                epochPps: (0, buffer_1.readU64)(data, 13), feeSharesMinted: (0, buffer_1.readU64)(data, 21),
+            } : null;
+        case constants_1.EVT_EPOCH_ADVANCED:
+            return data.length >= 17 ? {
+                name: "EpochAdvanced", vaultId: (0, buffer_1.readU64)(data, 1), newEpochId: (0, buffer_1.readU32)(data, 9), nextEpochTs: (0, buffer_1.readU32)(data, 13),
+            } : null;
+        case constants_1.EVT_FEES_SETTLED:
+            return data.length >= 49 ? {
+                name: "FeesSettled", vaultId: (0, buffer_1.readU64)(data, 1), mgmtFeeBase: (0, buffer_1.readU64)(data, 9),
+                perfFeeBase: (0, buffer_1.readU64)(data, 17), feeSharesMinted: (0, buffer_1.readU64)(data, 25),
+                postFeePps: (0, buffer_1.readU64)(data, 33), hwm: (0, buffer_1.readU64)(data, 41),
+            } : null;
+        case constants_1.EVT_STV_CLOSED:
+            return data.length >= 9 ? {
+                name: "StvClosed", vaultId: (0, buffer_1.readU64)(data, 1),
+            } : null;
+        case constants_1.EVT_MANAGER_ADDED:
+            return data.length >= 65 ? {
+                name: "ManagerAdded", stv: (0, buffer_1.readPubkey)(data, 1), manager: (0, buffer_1.readPubkey)(data, 33),
+            } : null;
+        case constants_1.EVT_MANAGER_REMOVED:
+            return data.length >= 65 ? {
+                name: "ManagerRemoved", stv: (0, buffer_1.readPubkey)(data, 1), manager: (0, buffer_1.readPubkey)(data, 33),
+            } : null;
+        case constants_1.EVT_WITHDRAW_OVERRIDE_CLAIMED:
+            // Rust: vault_id(8), manager(32), user(32), shares(8), net_base(8),
+            //       withdrawal_fee_base(8), epoch_id(4), daily_withdrawn(8), daily_limit(8)
+            return data.length >= 117 ? {
+                name: "WithdrawOverrideClaimed", vaultId: (0, buffer_1.readU64)(data, 1), manager: (0, buffer_1.readPubkey)(data, 9),
+                user: (0, buffer_1.readPubkey)(data, 41), shares: (0, buffer_1.readU64)(data, 73), baseAmount: (0, buffer_1.readU64)(data, 81),
+                withdrawalFeeBase: (0, buffer_1.readU64)(data, 89), epochId: (0, buffer_1.readU32)(data, 97),
+                dailyWithdrawnBase: (0, buffer_1.readU64)(data, 101), dailyLimit: (0, buffer_1.readU64)(data, 109),
+            } : null;
+        case constants_1.EVT_LEND_MIGRATED:
+            return data.length >= 89 ? {
+                name: "LendMigrated", vaultId: (0, buffer_1.readU64)(data, 1), oldLendProgram: (0, buffer_1.readPubkey)(data, 9),
+                newLendProgram: (0, buffer_1.readPubkey)(data, 41), sharesWithdrawn: (0, buffer_1.readU64)(data, 73), baseMigrated: (0, buffer_1.readU64)(data, 81),
+            } : null;
+        case constants_1.EVT_MIGRATE_REQUESTED:
+            // Rust: src_vault_id(8), dest_vault_id(8), user(32), shares(8), epoch_id(4)
+            return data.length >= 61 ? {
+                name: "MigrateRequested", srcVaultId: (0, buffer_1.readU64)(data, 1), destVaultId: (0, buffer_1.readU64)(data, 9),
+                user: (0, buffer_1.readPubkey)(data, 17), shares: (0, buffer_1.readU64)(data, 49), epochId: (0, buffer_1.readU32)(data, 57),
+            } : null;
+        case constants_1.EVT_MIGRATE_EXECUTED:
+            // Rust: src_vault_id(8), dst_vault_id(8), user(32), shares_burned(8), base_moved(8),
+            //       withdrawal_fee_base(8), deposit_fee_base(8), user_dest_shares(8), epoch_id(4)
+            return data.length >= 93 ? {
+                name: "MigrateExecuted", srcVaultId: (0, buffer_1.readU64)(data, 1), destVaultId: (0, buffer_1.readU64)(data, 9),
+                user: (0, buffer_1.readPubkey)(data, 17), sharesBurned: (0, buffer_1.readU64)(data, 49), baseMoved: (0, buffer_1.readU64)(data, 57),
+                withdrawalFeeBase: (0, buffer_1.readU64)(data, 65), depositFeeBase: (0, buffer_1.readU64)(data, 73),
+                userDestShares: (0, buffer_1.readU64)(data, 81), epochId: (0, buffer_1.readU32)(data, 89),
+            } : null;
+        case constants_1.EVT_DELAYED_DEPOSIT_PROCESSED:
+            return data.length >= 77 ? {
+                name: "DelayedDepositProcessed", vaultId: (0, buffer_1.readU64)(data, 1), user: (0, buffer_1.readPubkey)(data, 9),
+                amount: (0, buffer_1.readU64)(data, 41), sharesMinted: (0, buffer_1.readU64)(data, 49),
+                depositFeeShares: (0, buffer_1.readU64)(data, 57), pps: (0, buffer_1.readU64)(data, 65),
+                requestEpochId: (0, buffer_1.readU32)(data, 73),
+            } : null;
+        case constants_1.EVT_INSTANT_WITHDRAWN:
+            return data.length >= 65 ? {
+                name: "InstantWithdrawn", vaultId: (0, buffer_1.readU64)(data, 1), user: (0, buffer_1.readPubkey)(data, 9),
+                shares: (0, buffer_1.readU64)(data, 41), netBase: (0, buffer_1.readU64)(data, 49),
+                withdrawalFeeBase: (0, buffer_1.readU64)(data, 57),
+            } : null;
+        case constants_1.EVT_STV_SEEDED:
+            return data.length >= 17 ? {
+                name: "StvSeeded", vaultId: (0, buffer_1.readU64)(data, 1), amount: (0, buffer_1.readU64)(data, 9),
+            } : null;
+        case constants_1.EVT_ADMIN_ROTATION_STARTED:
+            // Fields: vault_id(8), new_pending_admin(32) → total payload 41 bytes
+            return data.length >= 41 ? {
+                name: "AdminRotationStarted", vaultId: (0, buffer_1.readU64)(data, 1), newPendingAdmin: (0, buffer_1.readPubkey)(data, 9),
+            } : null;
+        case constants_1.EVT_ADMIN_ROTATION_ACCEPTED:
+            // Fields: vault_id(8), new_admin(32) → total payload 41 bytes
+            return data.length >= 41 ? {
+                name: "AdminRotationAccepted", vaultId: (0, buffer_1.readU64)(data, 1), newAdmin: (0, buffer_1.readPubkey)(data, 9),
+            } : null;
+        case constants_1.EVT_WARM_ADMIN_SET:
+            // Fields: vault_id(8), warm_admin(32) → total payload 41 bytes.
+            // warmAdmin is the raw stored value (PublicKey.default on any
+            // reset/normalize-to-follow-cold) — see warmAdminEffective() to resolve.
+            return data.length >= 41 ? {
+                name: "WarmAdminSet", vaultId: (0, buffer_1.readU64)(data, 1), warmAdmin: (0, buffer_1.readPubkey)(data, 9),
+            } : null;
+        case constants_1.EVT_CIRCUIT_BREAKER_TRIPPED:
+            // Fields: vault_id(8), tripped_by(32), authority_kind(1) → total payload 42 bytes.
+            // authorityKind: 0=cold, 1=warm, 2=manager (TRIP_AUTHORITY_KIND_* in constants.ts).
+            return data.length >= 42 ? {
+                name: "CircuitBreakerTripped", vaultId: (0, buffer_1.readU64)(data, 1), trippedBy: (0, buffer_1.readPubkey)(data, 9),
+                authorityKind: data[41],
+            } : null;
+        default:
+            return null;
+    }
+}

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

@@ -0,0 +1,11 @@
+export * from "./constants";
+export * from "./types";
+export * from "./pda";
+export * from "./accounts";
+export * from "./events";
+export * from "./instructions";
+export * from "./remaining-accounts";
+export * from "./send-tx";
+export * from "./sol-wrap";
+export * from "./prices";
+export * from "./lut";

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

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./pda"), exports);
+__exportStar(require("./accounts"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./instructions"), exports);
+__exportStar(require("./remaining-accounts"), exports);
+__exportStar(require("./send-tx"), exports);
+__exportStar(require("./sol-wrap"), exports);
+__exportStar(require("./prices"), exports);
+__exportStar(require("./lut"), exports);