levr-sdk 0.2.2 → 0.3.1

package/dist/esm/vault.js

@@ -0,0 +1,136 @@
+/**
+ * Vault utilities for interacting with the Clanker Vault contract
+ * This module provides server-side functions to retrieve and interact with vault state
+ */
+import { ClankerVault } from "./abis/index.js";
+import { GET_VAULT_ADDRESS } from "./constants.js";
+/**
+ * Vault status enum
+ */
+export var VaultStatus;
+(function (VaultStatus) {
+    VaultStatus["LOCKED"] = "locked";
+    VaultStatus["VESTING"] = "vesting";
+    VaultStatus["VESTED"] = "vested";
+})(VaultStatus || (VaultStatus = {}));
+/**
+ * Build contract calls for vault data
+ * @param vaultAddress - Vault contract address
+ * @param tokenAddress - Token address to query
+ * @returns Array of contract calls
+ */
+function getVaultContracts(vaultAddress, tokenAddress) {
+    return [
+        {
+            address: vaultAddress,
+            abi: ClankerVault,
+            functionName: "allocation",
+            args: [tokenAddress],
+        },
+        {
+            address: vaultAddress,
+            abi: ClankerVault,
+            functionName: "amountAvailableToClaim",
+            args: [tokenAddress],
+        },
+    ];
+}
+/**
+ * Parse vault contract results
+ * @param results - Array of contract call results
+ * @returns Parsed vault state or undefined if allocation doesn't exist
+ */
+function parseVaultData(results) {
+    const allocationResult = results[0];
+    const claimableResult = results[1];
+    // Check if allocation call failed
+    if (allocationResult.status === "failure") {
+        return undefined;
+    }
+    const allocation = allocationResult.result;
+    const claimable = (claimableResult.result ?? 0n);
+    return {
+        allocation: {
+            token: allocation[0],
+            amountTotal: allocation[1],
+            amountClaimed: allocation[2],
+            lockupEndTime: allocation[3],
+            vestingEndTime: allocation[4],
+            admin: allocation[5],
+        },
+        claimable,
+    };
+}
+/**
+ * Fetch vault data using multicall
+ * @param publicClient - Viem public client
+ * @param tokenAddress - Token address to query
+ * @param chainId - Chain ID (optional, can be inferred from publicClient)
+ * @returns Parsed vault data or undefined if allocation doesn't exist
+ */
+export async function fetchVaultData(publicClient, tokenAddress, chainId) {
+    const actualChainId = chainId || publicClient.chain?.id;
+    if (!actualChainId)
+        throw new Error("Chain ID not found");
+    const vaultAddress = GET_VAULT_ADDRESS(actualChainId);
+    if (!vaultAddress)
+        throw new Error(`Vault not configured for chain ${actualChainId}`);
+    try {
+        const contracts = getVaultContracts(vaultAddress, tokenAddress);
+        const results = await publicClient.multicall({ contracts });
+        return parseVaultData(results);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get vault status with computed messages
+ * @param data - Vault data from fetchVaultData
+ * @param blockTimestamp - Current block timestamp in seconds (for consistency)
+ * @returns Vault status data with messages
+ */
+export function getVaultStatus(data, blockTimestamp) {
+    const lockupEndTime = Number(data.allocation.lockupEndTime);
+    const vestingEndTime = Number(data.allocation.vestingEndTime);
+    let status;
+    let statusMessage;
+    let descriptionMessage;
+    let daysRemaining;
+    if (blockTimestamp < lockupEndTime) {
+        // Still in lockup
+        status = VaultStatus.LOCKED;
+        daysRemaining = Math.ceil((lockupEndTime - blockTimestamp) / (24 * 60 * 60));
+        statusMessage = "Tokens Locked";
+        descriptionMessage = `Your tokens will be available to claim in ${daysRemaining} days.`;
+    }
+    else if (blockTimestamp < vestingEndTime) {
+        // In vesting period
+        status = VaultStatus.VESTING;
+        daysRemaining = Math.ceil((vestingEndTime - blockTimestamp) / (24 * 60 * 60));
+        statusMessage = "Vesting in Progress";
+        descriptionMessage = `Tokens are vesting linearly. ${daysRemaining} days until fully vested.`;
+    }
+    else {
+        // Fully vested
+        status = VaultStatus.VESTED;
+        daysRemaining = 0;
+        statusMessage = "Vesting Complete";
+        descriptionMessage =
+            data.claimable > 0n
+                ? "All tokens are now available to claim."
+                : "All tokens in this vault have been claimed.";
+    }
+    return {
+        status,
+        statusMessage,
+        descriptionMessage,
+        daysRemaining,
+        claimable: data.claimable,
+        total: data.allocation.amountTotal,
+        claimed: data.allocation.amountClaimed,
+        lockupEndTime: data.allocation.lockupEndTime,
+        vestingEndTime: data.allocation.vestingEndTime,
+    };
+}
+//# sourceMappingURL=vault.js.map

package/dist/esm/vault.js.map

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