perena-vault-sdk 1.0.0

package/dist/env.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * 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)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.address = exports.VAULT_PROGRAM_IDS = exports.VAULT_ENVIRONMENTS = void 0;
+exports.isVaultEnv = isVaultEnv;
+exports.getVaultProgramId = getVaultProgramId;
+exports.getRpcUrl = getRpcUrl;
+exports.resolveKeypairPath = resolveKeypairPath;
+exports.loadKeypair = loadKeypair;
+exports.defaultKeypairPath = defaultKeypairPath;
+exports.createVaultClient = createVaultClient;
+exports.keypairAddress = keypairAddress;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const core_1 = require("@anchor-lang/core");
+const web3_js_1 = require("@solana/web3.js");
+const kit_1 = require("@solana/kit");
+Object.defineProperty(exports, "address", { enumerable: true, get: function () { return kit_1.address; } });
+const common_1 = require("common");
+const client_1 = require("./client/client");
+exports.VAULT_ENVIRONMENTS = [
+    "test",
+    "prod",
+];
+function isVaultEnv(value) {
+    return value === "test" || value === "prod";
+}
+/**
+ * Per-environment program ids. Both default to {@link VAULT_PROGRAM_ID} today;
+ * update individually once test and prod deployments diverge.
+ */
+exports.VAULT_PROGRAM_IDS = {
+    test: (0, kit_1.address)("6HyT8NQDpXY5wGkvX7haQVJ5nGUBVXQSkaT6Nf7fbsuJ"),
+    prod: (0, kit_1.address)("save8RQVPMWNTzU18t3GBvBkN9hT7jsGjiCQ28FpD9H"),
+};
+function getVaultProgramId(env) {
+    return exports.VAULT_PROGRAM_IDS[env];
+}
+/** Resolve the RPC endpoint for `env` from options/env vars (see module docs). */
+function getRpcUrl(env) {
+    const envSpecific = env === "prod"
+        ? process.env.VAULT_RPC_URL_PROD
+        : process.env.VAULT_RPC_URL_TEST;
+    if (envSpecific)
+        return envSpecific;
+    if (process.env.RPC_URL)
+        return process.env.RPC_URL;
+    const heliusKey = process.env.HELIUS_API_KEY;
+    if (heliusKey) {
+        // `test` vs `prod` selects the program id; both deployments live on mainnet.
+        return `https://mainnet.helius-rpc.com/?api-key=${heliusKey}`;
+    }
+    throw new Error(`No RPC endpoint configured for env "${env}". Set VAULT_RPC_URL_${env.toUpperCase()}, RPC_URL, or HELIUS_API_KEY (or pass rpcUrl).`);
+}
+/** Expand a leading `~` and resolve to an absolute path. */
+function resolveKeypairPath(keypairPath) {
+    let resolved = keypairPath;
+    if (resolved.startsWith("~")) {
+        resolved = path_1.default.join(os_1.default.homedir(), resolved.slice(1));
+    }
+    return path_1.default.resolve(resolved);
+}
+/** Load a `solana-keygen` style JSON byte-array keypair from disk. */
+function loadKeypair(keypairPath) {
+    const raw = fs_1.default.readFileSync(resolveKeypairPath(keypairPath), "utf-8");
+    return web3_js_1.Keypair.fromSecretKey(new Uint8Array(JSON.parse(raw)));
+}
+/**
+ * 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.
+ */
+function defaultKeypairPath(env, role = "vault") {
+    return `~/.config/solana/${role}-${env}.json`;
+}
+/**
+ * Build a fully-wired {@link VaultClient} for an environment. Single entry point
+ * shared by CLI scripts and backend services.
+ */
+function createVaultClient(env, opts = {}) {
+    const payer = opts.keypair ??
+        loadKeypair(opts.keypairPath ?? defaultKeypairPath(env, opts.role));
+    const connection = new web3_js_1.Connection(opts.rpcUrl ?? getRpcUrl(env), "confirmed");
+    const provider = new core_1.AnchorProvider(connection, new core_1.Wallet(payer), {
+        commitment: "confirmed",
+    });
+    const client = new client_1.VaultClient(provider, opts.programId ?? getVaultProgramId(env));
+    return {
+        env,
+        client,
+        provider,
+        payer,
+        signer: (0, common_1.fromWeb3Pk)(payer.publicKey),
+    };
+}
+/** Convenience: a kit `Address` for a `solana-keygen` keypair file (no client). */
+function keypairAddress(keypairPath) {
+    return (0, common_1.fromWeb3Pk)(loadKeypair(keypairPath).publicKey);
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/idl/index.d.ts

@@ -0,0 +1,3 @@
+export type { Bankineco, Vault } from "./vault";
+export { IDL } from "./vault";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/idl/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC"}

package/dist/idl/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDL = void 0;
+var vault_1 = require("./vault");
+Object.defineProperty(exports, "IDL", { enumerable: true, get: function () { return vault_1.IDL; } });
+//# sourceMappingURL=index.js.map

package/dist/idl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/idl/index.ts"],"names":[],"mappings":";;;AACA,iCAA8B;AAArB,4FAAA,GAAG,OAAA"}