perena-vault-sdk 1.0.0

package/dist/client/client.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Vault program client.
+ *
+ * Composes PDA derivation, account fetching, instruction building, and
+ * transaction composition behind a single entry point.
+ *
+ * Usage:
+ *   const client = new VaultClient(provider);
+ *   const [vault] = await client.pda.deriveVaultPda(vaultId);
+ *   const ix = await client.tx.executeDeposit.getIx({ ... });
+ *   const plan = await client.tx.createVault.getTx({ curator, shareMint, ... });
+ *   await client.sendTransaction(payer, plan);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VaultClient = void 0;
+const core_1 = require("@anchor-lang/core");
+const kit_1 = require("@solana/kit");
+const web3_js_1 = require("@solana/web3.js");
+const common_1 = require("common");
+const vault_1 = require("../idl/vault");
+const constants_1 = require("../constants");
+const rpc_1 = require("../utils/rpc");
+const account_1 = require("./account");
+const pda_1 = require("./pda");
+const transaction_1 = require("./transaction");
+class VaultClient {
+    constructor(provider, programId = constants_1.VAULT_PROGRAM_ID) {
+        this.provider = provider;
+        const idl = { ...vault_1.IDL, address: programId };
+        this.program = new core_1.Program(idl, provider);
+        this.pda = new pda_1.PdaClient((0, kit_1.address)(this.program.programId.toBase58()));
+        const rpc = (0, rpc_1.createRpcFromConnection)(provider.connection);
+        this.account = new account_1.AccountClient(this.program, this.pda, rpc);
+        this.tx = new transaction_1.TransactionClient({
+            rpc,
+            program: this.program,
+            account: this.account,
+            pda: this.pda,
+        });
+    }
+    /** Sign, send, and confirm a transaction plan built from {@link TransactionClient}. */
+    async sendTransaction(payer, plan) {
+        const { blockhash, lastValidBlockHeight } = await this.provider.connection.getLatestBlockhash("confirmed");
+        const tx = new web3_js_1.Transaction().add(...plan.instructions.map(common_1.fromKitInstruction));
+        tx.feePayer = payer.publicKey;
+        tx.recentBlockhash = blockhash;
+        tx.sign(payer);
+        const signature = await this.provider.connection.sendRawTransaction(tx.serialize(), {
+            skipPreflight: false,
+        });
+        await this.provider.connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+        this.applyCacheInvalidations(plan);
+        return signature;
+    }
+    applyCacheInvalidations(plan) {
+        for (const invalidation of plan.postSuccessCacheInvalidations ?? []) {
+            this.account.dataCache.clearCacheEntry(account_1.VAULT_CACHE_CATEGORY, invalidation.vaultPda);
+            if (invalidation.vaultOraclePda) {
+                this.account.dataCache.clearCacheEntry(account_1.VAULT_ORACLE_CACHE_CATEGORY, invalidation.vaultOraclePda);
+            }
+            if (invalidation.vaultTrancheStatePda) {
+                this.account.dataCache.clearCacheEntry(account_1.VAULT_TRANCHE_STATE_CACHE_CATEGORY, invalidation.vaultTrancheStatePda);
+            }
+            if (invalidation.withdrawalQueuePda) {
+                this.account.dataCache.clearCacheEntry(account_1.VAULT_TRANCHE_WITHDRAWAL_QUEUE_CACHE_CATEGORY, invalidation.withdrawalQueuePda);
+            }
+        }
+    }
+    clearAllCache() {
+        this.account.dataCache.clearAllCache();
+    }
+}
+exports.VaultClient = VaultClient;
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}

package/dist/client/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./client";
+export * from "./pda";
+export * from "./account";
+export * from "./transaction";
+export * from "./builders";
+export * from "./types/tx";
+export * from "./types/builders";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,24 @@
+"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("./client"), exports);
+__exportStar(require("./pda"), exports);
+__exportStar(require("./account"), exports);
+__exportStar(require("./transaction"), exports);
+__exportStar(require("./builders"), exports);
+__exportStar(require("./types/tx"), exports);
+__exportStar(require("./types/builders"), exports);
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,wCAAsB;AACtB,4CAA0B;AAC1B,gDAA8B;AAC9B,6CAA2B;AAC3B,6CAA2B;AAC3B,mDAAiC"}

package/dist/client/pda.d.ts

@@ -0,0 +1,42 @@
+import { type Address, type ProgramDerivedAddressBump } from "@solana/kit";
+/**
+ * PDA derivation for the vault program.
+ *
+ * The program ID is injected via constructor — no global state.
+ */
+export declare class PdaClient {
+    private readonly programAddress;
+    constructor(programAddress: Address);
+    /**
+     * Vault PDA for a global vault id.
+     *
+     * Seeds: `["vault", vault_id_le_bytes]`
+     */
+    deriveVaultPda(vaultId: number): Promise<readonly [Address, ProgramDerivedAddressBump]>;
+    /**
+     * Oracle PDA tied 1:1 to a vault.
+     *
+     * Seeds: `["vault_oracle", vault]`
+     */
+    deriveVaultOraclePda(vault: Address): Promise<readonly [Address, ProgramDerivedAddressBump]>;
+    /**
+     * Fee-vault PDA tied 1:1 to a vault: token authority custodying accrued
+     * performance/protocol fees until the crank sweeps them.
+     *
+     * Seeds: `["VFEEVAULT", vault]`
+     */
+    deriveFeeAuthorityPda(vault: Address): Promise<readonly [Address, ProgramDerivedAddressBump]>;
+    /**
+     * Tranche state PDA tied 1:1 to a vault when tranching is enabled.
+     *
+     * Seeds: `["vault_tranche", vault]`
+     */
+    deriveVaultTrancheStatePda(vault: Address): Promise<readonly [Address, ProgramDerivedAddressBump]>;
+    /**
+     * Junior tranche withdrawal queue PDA.
+     *
+     * Seeds: `["vault_withdrawal_queue", vault, owner, queue_id]`
+     */
+    deriveVaultTrancheWithdrawalQueuePda(vault: Address, owner: Address, queueId: number): Promise<readonly [Address, ProgramDerivedAddressBump]>;
+}
+//# sourceMappingURL=pda.d.ts.map

package/dist/client/pda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../src/client/pda.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,yBAAyB,EAG/B,MAAM,aAAa,CAAC;AAgBrB;;;;GAIG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,OAAO;IAEpD;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAOzD;;;;OAIG;IACG,oBAAoB,CACxB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAOzD;;;;;OAKG;IACG,qBAAqB,CACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAOzD;;;;OAIG;IACG,0BAA0B,CAC9B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAOzD;;;;OAIG;IACG,oCAAoC,CACxC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;CAW1D"}

package/dist/client/pda.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdaClient = void 0;
+const kit_1 = require("@solana/kit");
+const addressEncoder = (0, kit_1.getAddressEncoder)();
+function u16LeBytes(value) {
+    const bytes = new Uint8Array(2);
+    new DataView(bytes.buffer).setUint16(0, value, true);
+    return bytes;
+}
+function u8Bytes(value) {
+    const bytes = new Uint8Array(1);
+    new DataView(bytes.buffer).setUint8(0, value);
+    return bytes;
+}
+/**
+ * PDA derivation for the vault program.
+ *
+ * The program ID is injected via constructor — no global state.
+ */
+class PdaClient {
+    constructor(programAddress) {
+        this.programAddress = programAddress;
+    }
+    /**
+     * Vault PDA for a global vault id.
+     *
+     * Seeds: `["vault", vault_id_le_bytes]`
+     */
+    async deriveVaultPda(vaultId) {
+        return (0, kit_1.getProgramDerivedAddress)({
+            programAddress: this.programAddress,
+            seeds: [Buffer.from("vault"), u16LeBytes(vaultId)],
+        });
+    }
+    /**
+     * Oracle PDA tied 1:1 to a vault.
+     *
+     * Seeds: `["vault_oracle", vault]`
+     */
+    async deriveVaultOraclePda(vault) {
+        return (0, kit_1.getProgramDerivedAddress)({
+            programAddress: this.programAddress,
+            seeds: [Buffer.from("vault_oracle"), addressEncoder.encode(vault)],
+        });
+    }
+    /**
+     * Fee-vault PDA tied 1:1 to a vault: token authority custodying accrued
+     * performance/protocol fees until the crank sweeps them.
+     *
+     * Seeds: `["VFEEVAULT", vault]`
+     */
+    async deriveFeeAuthorityPda(vault) {
+        return (0, kit_1.getProgramDerivedAddress)({
+            programAddress: this.programAddress,
+            seeds: [Buffer.from("VFEEVAULT"), addressEncoder.encode(vault)],
+        });
+    }
+    /**
+     * Tranche state PDA tied 1:1 to a vault when tranching is enabled.
+     *
+     * Seeds: `["vault_tranche", vault]`
+     */
+    async deriveVaultTrancheStatePda(vault) {
+        return (0, kit_1.getProgramDerivedAddress)({
+            programAddress: this.programAddress,
+            seeds: [Buffer.from("vault_tranche"), addressEncoder.encode(vault)],
+        });
+    }
+    /**
+     * Junior tranche withdrawal queue PDA.
+     *
+     * Seeds: `["vault_withdrawal_queue", vault, owner, queue_id]`
+     */
+    async deriveVaultTrancheWithdrawalQueuePda(vault, owner, queueId) {
+        return (0, kit_1.getProgramDerivedAddress)({
+            programAddress: this.programAddress,
+            seeds: [
+                Buffer.from("vault_withdrawal_queue"),
+                addressEncoder.encode(vault),
+                addressEncoder.encode(owner),
+                u8Bytes(queueId),
+            ],
+        });
+    }
+}
+exports.PdaClient = PdaClient;
+//# sourceMappingURL=pda.js.map

package/dist/client/pda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../../src/client/pda.ts"],"names":[],"mappings":";;;AAAA,qCAKqB;AAErB,MAAM,cAAc,GAAG,IAAA,uBAAiB,GAAE,CAAC;AAE3C,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAa,SAAS;IACpB,YAA6B,cAAuB;QAAvB,mBAAc,GAAd,cAAc,CAAS;IAAG,CAAC;IAExD;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAClB,OAAe;QAEf,OAAO,IAAA,8BAAwB,EAAC;YAC9B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,oBAAoB,CACxB,KAAc;QAEd,OAAO,IAAA,8BAAwB,EAAC;YAC9B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB,CACzB,KAAc;QAEd,OAAO,IAAA,8BAAwB,EAAC;YAC9B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,0BAA0B,CAC9B,KAAc;QAEd,OAAO,IAAA,8BAAwB,EAAC;YAC9B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACpE,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,oCAAoC,CACxC,KAAc,EACd,KAAc,EACd,OAAe;QAEf,OAAO,IAAA,8BAAwB,EAAC;YAC9B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE;gBACL,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC;gBACrC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC5B,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC5B,OAAO,CAAC,OAAO,CAAC;aACjB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAhFD,8BAgFC"}

package/dist/client/transaction.d.ts

@@ -0,0 +1,36 @@
+import type { VaultBuilderContext } from "./types/builders";
+import { ActivateCircuitBreakerBuilder, CancelJuniorTrancheWithdrawBuilder, CreateAssetHoldingBuilder, RemoveAssetHoldingBuilder, UpdateConsensusSignersBuilder, CreateTrancheStateBuilder, CreateVaultBuilder, DisableCircuitBreakerBuilder, InitializeVaultRolesBuilder, ExecuteDepositBuilder, ExecuteTrancheDepositBuilder, ExecuteTrancheWithdrawBuilder, ExecuteWithdrawBuilder, FulfillJuniorTrancheWithdrawBuilder, ManagerRedepositAssetBuilder, ManagerWithdrawAssetBuilder, JupiterSwapBuilder, ProtocolInteractionBuilder, RequestJuniorTrancheWithdrawBuilder, SetAssetPriceOracleBuilder, SetExternalLiquidityBuilder, SetVaultConfigBuilder, SetProtocolFeeBuilder, CrankNavBuilder, CrankPerformanceFeesBuilder, UpdateAssetPriceBuilder, UpdateConsensusOracleBuilder, UpdateTrancheConfigBuilder, VaultReallocationBuilder } from "./builders";
+export declare class TransactionClient {
+    readonly createVault: CreateVaultBuilder;
+    readonly initializeVaultRoles: InitializeVaultRolesBuilder;
+    readonly createAssetHolding: CreateAssetHoldingBuilder;
+    readonly removeAssetHolding: RemoveAssetHoldingBuilder;
+    readonly updateConsensusSigners: UpdateConsensusSignersBuilder;
+    readonly createTrancheState: CreateTrancheStateBuilder;
+    readonly setVaultConfig: SetVaultConfigBuilder;
+    readonly setProtocolFee: SetProtocolFeeBuilder;
+    readonly crankNav: CrankNavBuilder;
+    readonly crankPerformanceFees: CrankPerformanceFeesBuilder;
+    readonly updateTrancheConfig: UpdateTrancheConfigBuilder;
+    readonly activateCircuitBreaker: ActivateCircuitBreakerBuilder;
+    readonly disableCircuitBreaker: DisableCircuitBreakerBuilder;
+    readonly updateConsensusOracle: UpdateConsensusOracleBuilder;
+    readonly executeDeposit: ExecuteDepositBuilder;
+    readonly executeTrancheDeposit: ExecuteTrancheDepositBuilder;
+    readonly executeTrancheWithdraw: ExecuteTrancheWithdrawBuilder;
+    readonly requestJuniorTrancheWithdraw: RequestJuniorTrancheWithdrawBuilder;
+    readonly cancelJuniorTrancheWithdraw: CancelJuniorTrancheWithdrawBuilder;
+    readonly fulfillJuniorTrancheWithdraw: FulfillJuniorTrancheWithdrawBuilder;
+    readonly executeWithdraw: ExecuteWithdrawBuilder;
+    readonly managerWithdrawAsset: ManagerWithdrawAssetBuilder;
+    readonly managerRedepositAsset: ManagerRedepositAssetBuilder;
+    readonly protocolInteraction: ProtocolInteractionBuilder;
+    readonly jupiterSwap: JupiterSwapBuilder;
+    readonly setExternalLiquidity: SetExternalLiquidityBuilder;
+    readonly setAssetPriceOracle: SetAssetPriceOracleBuilder;
+    readonly updateAssetPrice: UpdateAssetPriceBuilder;
+    readonly vaultReallocation: VaultReallocationBuilder;
+    constructor(context: VaultBuilderContext);
+}
+export type TransactionBuilder = TransactionClient[keyof TransactionClient];
+//# sourceMappingURL=transaction.d.ts.map

package/dist/client/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/client/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,yBAAyB,EACzB,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,mCAAmC,EACnC,4BAA4B,EAC5B,2BAA2B,EAC3B,kBAAkB,EAClB,0BAA0B,EAC1B,mCAAmC,EACnC,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;IAC/D,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;IAC/D,QAAQ,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IAC7D,QAAQ,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IAC7D,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IAC7D,QAAQ,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;IAC/D,QAAQ,CAAC,4BAA4B,EAAE,mCAAmC,CAAC;IAC3E,QAAQ,CAAC,2BAA2B,EAAE,kCAAkC,CAAC;IACzE,QAAQ,CAAC,4BAA4B,EAAE,mCAAmC,CAAC;IAC3E,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;IAC3D,QAAQ,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;gBAEzC,OAAO,EAAE,mBAAmB;CAqCzC;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,iBAAiB,CAAC,CAAC"}

package/dist/client/transaction.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionClient = void 0;
+const builders_1 = require("./builders");
+class TransactionClient {
+    constructor(context) {
+        this.createVault = new builders_1.CreateVaultBuilder(context);
+        this.initializeVaultRoles = new builders_1.InitializeVaultRolesBuilder(context);
+        this.createAssetHolding = new builders_1.CreateAssetHoldingBuilder(context);
+        this.removeAssetHolding = new builders_1.RemoveAssetHoldingBuilder(context);
+        this.updateConsensusSigners = new builders_1.UpdateConsensusSignersBuilder(context);
+        this.createTrancheState = new builders_1.CreateTrancheStateBuilder(context);
+        this.setVaultConfig = new builders_1.SetVaultConfigBuilder(context);
+        this.setProtocolFee = new builders_1.SetProtocolFeeBuilder(context);
+        this.crankNav = new builders_1.CrankNavBuilder(context);
+        this.crankPerformanceFees = new builders_1.CrankPerformanceFeesBuilder(context);
+        this.updateTrancheConfig = new builders_1.UpdateTrancheConfigBuilder(context);
+        this.activateCircuitBreaker = new builders_1.ActivateCircuitBreakerBuilder(context);
+        this.disableCircuitBreaker = new builders_1.DisableCircuitBreakerBuilder(context);
+        this.updateConsensusOracle = new builders_1.UpdateConsensusOracleBuilder(context);
+        this.executeDeposit = new builders_1.ExecuteDepositBuilder(context);
+        this.executeTrancheDeposit = new builders_1.ExecuteTrancheDepositBuilder(context);
+        this.executeTrancheWithdraw = new builders_1.ExecuteTrancheWithdrawBuilder(context);
+        this.requestJuniorTrancheWithdraw = new builders_1.RequestJuniorTrancheWithdrawBuilder(context);
+        this.cancelJuniorTrancheWithdraw = new builders_1.CancelJuniorTrancheWithdrawBuilder(context);
+        this.fulfillJuniorTrancheWithdraw = new builders_1.FulfillJuniorTrancheWithdrawBuilder(context);
+        this.executeWithdraw = new builders_1.ExecuteWithdrawBuilder(context);
+        this.managerWithdrawAsset = new builders_1.ManagerWithdrawAssetBuilder(context);
+        this.managerRedepositAsset = new builders_1.ManagerRedepositAssetBuilder(context);
+        this.protocolInteraction = new builders_1.ProtocolInteractionBuilder(context);
+        this.jupiterSwap = new builders_1.JupiterSwapBuilder(context);
+        this.setExternalLiquidity = new builders_1.SetExternalLiquidityBuilder(context);
+        this.setAssetPriceOracle = new builders_1.SetAssetPriceOracleBuilder(context);
+        this.updateAssetPrice = new builders_1.UpdateAssetPriceBuilder(context);
+        this.vaultReallocation = new builders_1.VaultReallocationBuilder(context);
+    }
+}
+exports.TransactionClient = TransactionClient;
+//# sourceMappingURL=transaction.js.map

package/dist/client/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/client/transaction.ts"],"names":[],"mappings":";;;AACA,yCA8BoB;AAEpB,MAAa,iBAAiB;IA+B5B,YAAY,OAA4B;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,6BAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,oBAAoB,GAAG,IAAI,sCAA2B,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,kBAAkB,GAAG,IAAI,oCAAyB,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,kBAAkB,GAAG,IAAI,oCAAyB,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,sBAAsB,GAAG,IAAI,wCAA6B,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,kBAAkB,GAAG,IAAI,oCAAyB,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAqB,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAqB,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,0BAAe,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,oBAAoB,GAAG,IAAI,sCAA2B,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,mBAAmB,GAAG,IAAI,qCAA0B,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,sBAAsB,GAAG,IAAI,wCAA6B,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,qBAAqB,GAAG,IAAI,uCAA4B,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,qBAAqB,GAAG,IAAI,uCAA4B,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAqB,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,qBAAqB,GAAG,IAAI,uCAA4B,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,sBAAsB,GAAG,IAAI,wCAA6B,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,4BAA4B,GAAG,IAAI,8CAAmC,CACzE,OAAO,CACR,CAAC;QACF,IAAI,CAAC,2BAA2B,GAAG,IAAI,6CAAkC,CACvE,OAAO,CACR,CAAC;QACF,IAAI,CAAC,4BAA4B,GAAG,IAAI,8CAAmC,CACzE,OAAO,CACR,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,iCAAsB,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,oBAAoB,GAAG,IAAI,sCAA2B,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,qBAAqB,GAAG,IAAI,uCAA4B,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,mBAAmB,GAAG,IAAI,qCAA0B,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,6BAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,oBAAoB,GAAG,IAAI,sCAA2B,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,mBAAmB,GAAG,IAAI,qCAA0B,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,gBAAgB,GAAG,IAAI,kCAAuB,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,iBAAiB,GAAG,IAAI,mCAAwB,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;CACF;AApED,8CAoEC"}

package/dist/client/types/builders.d.ts

@@ -0,0 +1,12 @@
+import type { Program } from "@anchor-lang/core";
+import type { Rpc, SolanaRpcApi } from "@solana/kit";
+import type { Vault } from "../../idl/vault";
+import type { AccountClient } from "../../client/account";
+import type { PdaClient } from "../../client/pda";
+export interface VaultBuilderContext {
+    rpc: Rpc<SolanaRpcApi>;
+    program: Program<Vault>;
+    account: AccountClient;
+    pda: PdaClient;
+}
+//# sourceMappingURL=builders.d.ts.map

package/dist/client/types/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/client/types/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;CAChB"}

package/dist/client/types/builders.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=builders.js.map

package/dist/client/types/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/client/types/builders.ts"],"names":[],"mappings":""}

package/dist/client/types/tx.d.ts

@@ -0,0 +1,13 @@
+import type { Address, Instruction } from "@solana/kit";
+import type { TransactionPlan } from "common";
+export interface VaultCacheInvalidation {
+    vaultPda: Address;
+    vaultOraclePda?: Address;
+    vaultTrancheStatePda?: Address;
+    withdrawalQueuePda?: Address;
+}
+export interface VaultTransactionPlan extends TransactionPlan {
+    instructions: Instruction[];
+    postSuccessCacheInvalidations?: VaultCacheInvalidation[];
+}
+//# sourceMappingURL=tx.d.ts.map

package/dist/client/types/tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../../src/client/types/tx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,6BAA6B,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC1D"}

package/dist/client/types/tx.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tx.js.map

package/dist/client/types/tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.js","sourceRoot":"","sources":["../../../src/client/types/tx.ts"],"names":[],"mappings":""}

package/dist/constants.d.ts

@@ -0,0 +1,45 @@
+import { type Address } from "@solana/kit";
+import { PublicKey } from "@solana/web3.js";
+/** Bankineco program id (local). Hosts new vault instructions. */
+export declare const VAULT_PROGRAM_ID: Address;
+export declare const VAULT_PROGRAM_PUBLIC_KEY: PublicKey;
+/**
+ * Hardcoded protocol admin wallet — the only authority permitted to set a
+ * vault's protocol performance fee (via `setProtocolFee`). Must match
+ * `PROTOCOL_ADMIN` in the on-chain program constants.
+ *
+ * This is the `local`-feature dev wallet, matching the localnet program build.
+ * TODO: replace with the real protocol admin wallet for production (in lockstep
+ * with the non-`local` program constant).
+ */
+export declare const PROTOCOL_ADMIN: Address;
+/**
+ * Hardcoded wallet that receives all protocol performance fees when accrued
+ * fees are swept via `crankPerformanceFees`. Must match `PROTOCOL_FEE_RECIPIENT`
+ * in the on-chain program constants.
+ */
+export declare const PROTOCOL_FEE_RECIPIENT: Address;
+export declare const TOKEN_PROGRAM_ID: Address;
+/**
+ * Default (zero) pubkey — the on-chain `Pubkey::default()`. Used as the
+ * `priceOracleAccount` for ConsensusOracle holdings, which have no external
+ * price-source account.
+ */
+export declare const DEFAULT_PRICE_ORACLE_ACCOUNT: Address;
+/** @deprecated Use {@link TOKEN_PROGRAM_ID}. */
+export declare const TOKEN_PROGRAM: PublicKey;
+export declare const ASSET_DECIMALS = 6;
+export declare const SHARE_DECIMALS = 6;
+export declare const DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS = 86400;
+/** Asset-price staleness window used when a vault has not configured its own. */
+export declare const DEFAULT_PRICE_STALENESS_THRESHOLD_SECS = 86400;
+/** Default delay before staged vault role updates take effect via setVaultConfig. */
+export declare const VAULT_ROLE_UPDATE_TIMELOCK_SECS: number;
+/** Largest asset-price staleness window a curator may set via setVaultConfig. */
+export declare const MAX_PRICE_STALENESS_THRESHOLD_SECS: number;
+export declare const DEFAULT_VAULT_ID = 0;
+export declare const DEFAULT_MAX_ACCEPTABLE_APY_BPS = 10000;
+export declare const DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS: number;
+export declare const DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS = 100;
+export declare const DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS = 50;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,OAE9B,CAAC;AACF,eAAO,MAAM,wBAAwB,WAAkC,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,OAE5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAEpC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAE9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAE1C,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,aAAa,WAAwB,CAAC;AAEnD,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,uCAAuC,QAAS,CAAC;AAC9D,iFAAiF;AACjF,eAAO,MAAM,sCAAsC,QAAS,CAAC;AAC7D,qFAAqF;AACrF,eAAO,MAAM,+BAA+B,QAAe,CAAC;AAC5D,iFAAiF;AACjF,eAAO,MAAM,kCAAkC,QAAmB,CAAC;AACnE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,qCAAqC,QAAmB,CAAC;AACtE,eAAO,MAAM,oCAAoC,MAAM,CAAC;AACxD,eAAO,MAAM,uCAAuC,KAAK,CAAC"}

package/dist/constants.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS = exports.DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS = exports.DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS = exports.DEFAULT_MAX_ACCEPTABLE_APY_BPS = exports.DEFAULT_VAULT_ID = exports.MAX_PRICE_STALENESS_THRESHOLD_SECS = exports.VAULT_ROLE_UPDATE_TIMELOCK_SECS = exports.DEFAULT_PRICE_STALENESS_THRESHOLD_SECS = exports.DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS = exports.SHARE_DECIMALS = exports.ASSET_DECIMALS = exports.TOKEN_PROGRAM = exports.DEFAULT_PRICE_ORACLE_ACCOUNT = exports.TOKEN_PROGRAM_ID = exports.PROTOCOL_FEE_RECIPIENT = exports.PROTOCOL_ADMIN = exports.VAULT_PROGRAM_PUBLIC_KEY = exports.VAULT_PROGRAM_ID = void 0;
+const kit_1 = require("@solana/kit");
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+/** Bankineco program id (local). Hosts new vault instructions. */
+exports.VAULT_PROGRAM_ID = (0, kit_1.address)("5emH1da51MCvjTBZLhmiSmz1do7iMc5FRcjiSQcpUe9m");
+exports.VAULT_PROGRAM_PUBLIC_KEY = new web3_js_1.PublicKey(exports.VAULT_PROGRAM_ID);
+/**
+ * Hardcoded protocol admin wallet — the only authority permitted to set a
+ * vault's protocol performance fee (via `setProtocolFee`). Must match
+ * `PROTOCOL_ADMIN` in the on-chain program constants.
+ *
+ * This is the `local`-feature dev wallet, matching the localnet program build.
+ * TODO: replace with the real protocol admin wallet for production (in lockstep
+ * with the non-`local` program constant).
+ */
+exports.PROTOCOL_ADMIN = (0, kit_1.address)("BQJZAhDnvgSGHjdAbzQEXRBYzSBuWgSYqDzhDnUSRWGR");
+/**
+ * Hardcoded wallet that receives all protocol performance fees when accrued
+ * fees are swept via `crankPerformanceFees`. Must match `PROTOCOL_FEE_RECIPIENT`
+ * in the on-chain program constants.
+ */
+exports.PROTOCOL_FEE_RECIPIENT = (0, kit_1.address)("2gymhnRsU4nimHpZuAEZXjvgMXvskcdXz5cyvXzG39iB");
+exports.TOKEN_PROGRAM_ID = (0, kit_1.address)(spl_token_1.TOKEN_2022_PROGRAM_ID.toBase58());
+/**
+ * Default (zero) pubkey — the on-chain `Pubkey::default()`. Used as the
+ * `priceOracleAccount` for ConsensusOracle holdings, which have no external
+ * price-source account.
+ */
+exports.DEFAULT_PRICE_ORACLE_ACCOUNT = (0, kit_1.address)("11111111111111111111111111111111");
+/** @deprecated Use {@link TOKEN_PROGRAM_ID}. */
+exports.TOKEN_PROGRAM = spl_token_1.TOKEN_2022_PROGRAM_ID;
+exports.ASSET_DECIMALS = 6;
+exports.SHARE_DECIMALS = 6;
+exports.DEFAULT_ORACLE_STALENESS_THRESHOLD_SECS = 86400;
+/** Asset-price staleness window used when a vault has not configured its own. */
+exports.DEFAULT_PRICE_STALENESS_THRESHOLD_SECS = 86400;
+/** Default delay before staged vault role updates take effect via setVaultConfig. */
+exports.VAULT_ROLE_UPDATE_TIMELOCK_SECS = 24 * 60 * 60;
+/** Largest asset-price staleness window a curator may set via setVaultConfig. */
+exports.MAX_PRICE_STALENESS_THRESHOLD_SECS = 7 * 24 * 60 * 60;
+exports.DEFAULT_VAULT_ID = 0;
+exports.DEFAULT_MAX_ACCEPTABLE_APY_BPS = 10000;
+exports.DEFAULT_JUNIOR_WITHDRAWAL_LOCKUP_SECS = 7 * 24 * 60 * 60;
+exports.DEFAULT_JUNIOR_EARLY_UNSTAKE_FEE_BPS = 100;
+exports.DEFAULT_JUNIOR_STANDARD_UNSTAKE_FEE_BPS = 50;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA,qCAAoD;AACpD,6CAA4C;AAC5C,iDAA0D;AAE1D,kEAAkE;AACrD,QAAA,gBAAgB,GAAY,IAAA,aAAO,EAC9C,8CAA8C,CAC/C,CAAC;AACW,QAAA,wBAAwB,GAAG,IAAI,mBAAS,CAAC,wBAAgB,CAAC,CAAC;AAExE;;;;;;;;GAQG;AACU,QAAA,cAAc,GAAY,IAAA,aAAO,EAC5C,8CAA8C,CAC/C,CAAC;AAEF;;;;GAIG;AACU,QAAA,sBAAsB,GAAY,IAAA,aAAO,EACpD,8CAA8C,CAC/C,CAAC;AAEW,QAAA,gBAAgB,GAAY,IAAA,aAAO,EAC9C,iCAAqB,CAAC,QAAQ,EAAE,CACjC,CAAC;AAEF;;;;GAIG;AACU,QAAA,4BAA4B,GAAY,IAAA,aAAO,EAC1D,kCAAkC,CACnC,CAAC;AAEF,gDAAgD;AACnC,QAAA,aAAa,GAAG,iCAAqB,CAAC;AAEtC,QAAA,cAAc,GAAG,CAAC,CAAC;AACnB,QAAA,cAAc,GAAG,CAAC,CAAC;AACnB,QAAA,uCAAuC,GAAG,KAAM,CAAC;AAC9D,iFAAiF;AACpE,QAAA,sCAAsC,GAAG,KAAM,CAAC;AAC7D,qFAAqF;AACxE,QAAA,+BAA+B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC5D,iFAAiF;AACpE,QAAA,kCAAkC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtD,QAAA,gBAAgB,GAAG,CAAC,CAAC;AACrB,QAAA,8BAA8B,GAAG,KAAM,CAAC;AACxC,QAAA,qCAAqC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACzD,QAAA,oCAAoC,GAAG,GAAG,CAAC;AAC3C,QAAA,uCAAuC,GAAG,EAAE,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Environment & client-construction helpers for the vault SDK.
+ *
+ * Centralizes the "which network / which keypair / which program id" decisions
+ * so that both scripts (CLI) and backend services build a {@link VaultClient}
+ * the same way. Scripts parse CLI flags and delegate here; backend services
+ * call {@link createVaultClient} directly.
+ *
+ * Resolution precedence for the RPC endpoint:
+ *   1. explicit `rpcUrl` option
+ *   2. `VAULT_RPC_URL_TEST` / `VAULT_RPC_URL_PROD` (env-specific)
+ *   3. `RPC_URL` (shared)
+ *   4. `HELIUS_API_KEY` (Helius mainnet URL — test and prod programs both deploy on mainnet)
+ */
+import { AnchorProvider } from "@anchor-lang/core";
+import { Keypair } from "@solana/web3.js";
+import { address, type Address } from "@solana/kit";
+import { VaultClient } from "./client/client";
+/** Deployed networks the helpers target. Local validator flows use tests, not these. */
+export type VaultEnv = "test" | "prod";
+export declare const VAULT_ENVIRONMENTS: readonly VaultEnv[];
+export declare function isVaultEnv(value: string): value is VaultEnv;
+/**
+ * Per-environment program ids. Both default to {@link VAULT_PROGRAM_ID} today;
+ * update individually once test and prod deployments diverge.
+ */
+export declare const VAULT_PROGRAM_IDS: Record<VaultEnv, Address>;
+export declare function getVaultProgramId(env: VaultEnv): Address;
+/** Resolve the RPC endpoint for `env` from options/env vars (see module docs). */
+export declare function getRpcUrl(env: VaultEnv): string;
+/** Expand a leading `~` and resolve to an absolute path. */
+export declare function resolveKeypairPath(keypairPath: string): string;
+/** Load a `solana-keygen` style JSON byte-array keypair from disk. */
+export declare function loadKeypair(keypairPath: string): Keypair;
+/**
+ * Default keypair location for a given role/env, e.g.
+ * `~/.config/solana/vault-fulfiller-prod.json`. Override per-invocation with
+ * the `--keypair` CLI flag or the `keypairPath` option.
+ */
+export declare function defaultKeypairPath(env: VaultEnv, role?: string): string;
+export interface CreateVaultClientOptions {
+    /** Explicit RPC endpoint; otherwise resolved from env vars. */
+    rpcUrl?: string;
+    /** Keypair file path; defaults to {@link defaultKeypairPath}. Ignored if `keypair` is set. */
+    keypairPath?: string;
+    /** Pre-loaded signer; takes precedence over `keypairPath`. */
+    keypair?: Keypair;
+    /** Logical role used to pick the default keypair path (e.g. "fulfiller", "oracle"). */
+    role?: string;
+    /** Override the program id; defaults to {@link getVaultProgramId}. */
+    programId?: Address;
+}
+export interface VaultClientBundle {
+    env: VaultEnv;
+    client: VaultClient;
+    provider: AnchorProvider;
+    /** web3.js keypair used as fee payer / signer for {@link VaultClient.sendTransaction}. */
+    payer: Keypair;
+    /** Kit-style address of the payer, for builder `signer`/`user` fields. */
+    signer: Address;
+}
+/**
+ * Build a fully-wired {@link VaultClient} for an environment. Single entry point
+ * shared by CLI scripts and backend services.
+ */
+export declare function createVaultClient(env: VaultEnv, opts?: CreateVaultClientOptions): VaultClientBundle;
+/** Convenience: a kit `Address` for a `solana-keygen` keypair file (no client). */
+export declare function keypairAddress(keypairPath: string): Address;
+export { address };
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,cAAc,EAAU,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAc,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,wFAAwF;AACxF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,eAAO,MAAM,kBAAkB,EAAE,SAAS,QAAQ,EAGxC,CAAC;AAEX,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAGvD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAExD;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAkB/C;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,SAAU,GAAG,MAAM,CAExE;AAED,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,QAAQ,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,0FAA0F;IAC1F,KAAK,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,QAAQ,EACb,IAAI,GAAE,wBAA6B,GAClC,iBAAiB,CAmBnB;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}