timefi-sdk 0.1.2 → 0.1.4

package/README.md

@@ -3,58 +3,75 @@
 The official JavaScript SDK for interacting with the **TimeFi Protocol** on the Stacks blockchain.
 
 [![npm version](https://img.shields.io/npm/v/timefi-sdk.svg)](https://www.npmjs.com/package/timefi-sdk)
+[![Downloads](https://img.shields.io/npm/dm/timefi-sdk.svg)](https://www.npmjs.com/package/timefi-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## 🚀 Features
+## Features
 
-- **Protocol Client**: Easy-to-use `TimeFiClient` for read and write interactions.
-- **On-chain Data**: Fetch TVL, vault status, and lock durations directly from smart contracts.
-- **Formatting Utilities**: Standardized formatting for STX (microSTX to STX), addresses, and dates.
-- **Mainnet/Testnet Support**: Unified interface for both networks.
+- Protocol Client: Easy-to-use `TimeFiClient` for read and write interactions.
+- On-chain Data: Fetch TVL, vault status, and lock durations directly from smart contracts.
+- Formatting Utilities: Standardized formatting for STX (microSTX to STX), addresses, and dates.
+- Mainnet/Testnet Support: Unified interface for both networks.
 
-## 📦 Installation
+## Installation
 
 ```bash
 npm install timefi-sdk
-
-### Running Tests
-
-```bash
-npm test
 ```
-## 🛠️ Quick Start
+
+## Quick Start
 
 ### Fetch Protocol Stats
 
 ```javascript
 import { TimeFiClient, formatSTX } from 'timefi-sdk';
 
-// Initialize for Stacks Mainnet
 const client = new TimeFiClient('mainnet');
-
-// Get Total Value Locked
 const tvl = await client.getTVL();
+
 console.log(`Current TVL: ${formatSTX(tvl)} STX`);
 ```
 
+### Build a Create-Vault Transaction
+
+```javascript
+import { TimeFiClient } from 'timefi-sdk';
+
+const client = new TimeFiClient('mainnet');
+
+const txOptions = client.getCreateVaultOptions('1.25', 4320);
+```
+
 ### Format a Stacks Address
 
 ```javascript
 import { formatAddress } from 'timefi-sdk';
 
-const shortAddress = formatAddress('SP3...XYZ123');
-console.log(shortAddress); // SP3...Z123
+const shortAddress = formatAddress('SP3F1234567890ABCDEFG1234567890XYZ123');
+console.log(shortAddress);
+```
+
+## Running Tests
+
+```bash
+npm test
 ```
 
-## 📖 Documentation
+## Documentation
 
-The SDK provides the following exports:
+The SDK exports:
 
-- `TimeFiClient`: Core class for blockchain interactions.
-- `formatSTX(microStx)`: Converts microSTX to a human-readable STX string.
-- `formatAddress(address)`: Truncates addresses for UI display.
-- `CONTRACT_ADDRESS`: The main TimeFi Protocol contract address on Stacks.
+- `TimeFiClient`
+- `formatSTX(microStx)`
+- `formatAddress(address)`
+- `formatNumber(value)`
+- `formatPercent(value)`
+- `formatDate(value)`
+- `formatRelativeTime(value)`
+- `CONTRACT_ADDRESS`
+- `CONTRACT_NAMES`
+- `LOCK_PERIODS`
 
-## 📄 License
+## License
 
 MIT © [AdekunleBamz](https://github.com/AdekunleBamz)

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+export class TimeFiClient {
+    constructor(networkType?: string);
+    networkType: string;
+    network: StacksMainnet | StacksTestnet;
+    contractAddress: string;
+    callReadOnly(functionName: any, functionArgs: any[], senderAddress: any): Promise<any>;
+    getVault(vaultId: any): Promise<any>;
+    getTimeRemaining(vaultId: any): Promise<any>;
+    canWithdraw(vaultId: any): Promise<any>;
+    getTVL(): Promise<any>;
+    getCreateVaultOptions(amountSTX: any, lockDurationBlocks: any): {
+        contractAddress: string;
+        contractName: string;
+        functionName: string;
+        functionArgs: import("@stacks/transactions").UIntCV[];
+        network: StacksMainnet | StacksTestnet;
+        anchorMode: AnchorMode;
+        postConditionMode: PostConditionMode;
+    };
+    getWithdrawOptions(vaultId: any): {
+        contractAddress: string;
+        contractName: string;
+        functionName: string;
+        functionArgs: import("@stacks/transactions").UIntCV[];
+        network: StacksMainnet | StacksTestnet;
+        anchorMode: AnchorMode;
+        postConditionMode: PostConditionMode;
+    };
+}
+import { StacksMainnet } from '@stacks/network';
+import { StacksTestnet } from '@stacks/network';
+import { AnchorMode } from '@stacks/transactions';
+import { PostConditionMode } from '@stacks/transactions';

package/dist/constants.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Protocol Constants
+ */
+export const CONTRACT_ADDRESS: "SP3FKNEZ86RG5RT7SZ5FBRGH85FZNG94ZH1MCGG6N";
+export namespace CONTRACT_NAMES {
+    let VAULT: string;
+    let REWARDS: string;
+    let GOVERNANCE: string;
+    let EMERGENCY: string;
+}
+export namespace LOCK_PERIODS {
+    namespace MONTH_1 {
+        let label: string;
+        let blocks: number;
+        let apy: number;
+    }
+    namespace MONTH_3 {
+        let label_1: string;
+        export { label_1 as label };
+        let blocks_1: number;
+        export { blocks_1 as blocks };
+        let apy_1: number;
+        export { apy_1 as apy };
+    }
+    namespace MONTH_6 {
+        let label_2: string;
+        export { label_2 as label };
+        let blocks_2: number;
+        export { blocks_2 as blocks };
+        let apy_2: number;
+        export { apy_2 as apy };
+    }
+    namespace MONTH_9 {
+        let label_3: string;
+        export { label_3 as label };
+        let blocks_3: number;
+        export { blocks_3 as blocks };
+        let apy_3: number;
+        export { apy_3 as apy };
+    }
+    namespace YEAR_1 {
+        let label_4: string;
+        export { label_4 as label };
+        let blocks_4: number;
+        export { blocks_4 as blocks };
+        let apy_4: number;
+        export { apy_4 as apy };
+    }
+}
+export const MIN_DEPOSIT: 0.01;
+export const MAX_DEPOSIT: 1000000;

package/dist/format.d.ts

@@ -0,0 +1,6 @@
+export function formatSTX(microStx: any): string;
+export function formatAddress(address: any, prefix?: number, suffix?: number): any;
+export function formatNumber(val: any): string;
+export function formatPercent(val: any, decimals?: number): string;
+export function formatDate(date: any): string;
+export function formatRelativeTime(date: any): string;

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@stacks/transactions"),c=require("@stacks/network"),u="SP3FKNEZ86RG5RT7SZ5FBRGH85FZNG94ZH1MCGG6N",s={VAULT:"timefi-vault-v-A2",REWARDS:"timefi-rewards-v-A2",GOVERNANCE:"timefi-governance-v-A2",EMERGENCY:"timefi-emergency-v-A2"},f={MONTH_1:{label:"1 Month",blocks:4320,apy:1},MONTH_3:{label:"3 Months",blocks:12960,apy:3},MONTH_6:{label:"6 Months",blocks:25920,apy:6},MONTH_9:{label:"9 Months",blocks:38880,apy:9},YEAR_1:{label:"1 Year",blocks:52560,apy:12}},d=.01,m=1e6,g=t=>{if(t==null)return"0.000000";try{const e=typeof t=="object"&&t!==null&&"value"in t?t.value:t,r=Number(e);return isNaN(r)?"0.000000":(r/1e6).toLocaleString(void 0,{minimumFractionDigits:0,maximumFractionDigits:6})}catch(e){return console.error("Error formatting STX:",e),"0.000000"}},h=(t,e=4,r=4)=>t?t.length<=e+r?t:`${t.slice(0,e+2)}...${t.slice(-r)}`:"",b=t=>{if(t==null)return"0";const e=Number(t);return isNaN(e)?"0":e.toLocaleString()},C=(t,e=2)=>{if(t==null)return"0%";const r=Number(t);return isNaN(r)?"0%":(r*100).toFixed(e)+"%"},l=t=>{if(!t)return"--";const e=new Date(t);return isNaN(e.getTime())?"--":e.toLocaleDateString(void 0,{year:"numeric",month:"short",day:"numeric"})},A=t=>{if(!t)return"--";const e=new Date,r=new Date(t),o=Math.floor((e-r)/1e3);if(o<-1){const i=Math.abs(o);return i<60?"in a few seconds":i<3600?`in ${Math.floor(i/60)}m`:i<86400?`in ${Math.floor(i/3600)}h`:`in ${Math.floor(i/86400)}d`}return o<5?"just now":o<60?`${o}s ago`:o<3600?`${Math.floor(o/60)}m ago`:o<86400?`${Math.floor(o/3600)}h ago`:o<604800?`${Math.floor(o/86400)}d ago`:l(t)};function a(t,e){if(!Number.isInteger(t)||t<=0)throw new Error(`${e} must be a positive integer.`)}function w(t){if(t==null)throw new Error("amountSTX is required");const e=String(t).trim();if(!/^\d+(\.\d+)?$/.test(e))throw new Error("amountSTX must be a valid positive number.");const[r,o=""]=e.split(".");if(o.length>6)throw new Error("amountSTX supports at most 6 decimal places.");const i=BigInt(r)*1000000n+BigInt((o+"000000").slice(0,6));if(i<=0n)throw new Error("amountSTX must be greater than 0.");return i}class M{constructor(e="mainnet"){if(!["mainnet","testnet"].includes(e))throw new Error(`Invalid networkType "${e}". Use "mainnet" or "testnet".`);this.networkType=e,this.network=e==="mainnet"?new c.StacksMainnet:new c.StacksTestnet,this.contractAddress=u}async callReadOnly(e,r=[],o){const i=await n.callReadOnlyFunction({contractAddress:this.contractAddress,contractName:s.VAULT,functionName:e,functionArgs:r,network:this.network,senderAddress:o||this.contractAddress});return i.type===7||i.type===8?n.cvToValue(i.value):n.cvToValue(i)}async getVault(e){return a(e,"vaultId"),this.callReadOnly("get-vault",[n.uintCV(e)])}async getTimeRemaining(e){return a(e,"vaultId"),this.callReadOnly("get-time-remaining",[n.uintCV(e)])}async canWithdraw(e){return a(e,"vaultId"),this.callReadOnly("can-withdraw",[n.uintCV(e)])}async getTVL(){return this.callReadOnly("get-tvl",[])}getCreateVaultOptions(e,r){return a(r,"lockDurationBlocks"),{contractAddress:this.contractAddress,contractName:s.VAULT,functionName:"create-vault",functionArgs:[n.uintCV(w(e)),n.uintCV(r)],network:this.network,anchorMode:n.AnchorMode.Any,postConditionMode:n.PostConditionMode.Allow}}getWithdrawOptions(e){return a(e,"vaultId"),{contractAddress:this.contractAddress,contractName:s.VAULT,functionName:"request-withdraw",functionArgs:[n.uintCV(e)],network:this.network,anchorMode:n.AnchorMode.Any,postConditionMode:n.PostConditionMode.Allow}}}Object.defineProperty(exports,"AnchorMode",{enumerable:!0,get:()=>n.AnchorMode});Object.defineProperty(exports,"PostConditionMode",{enumerable:!0,get:()=>n.PostConditionMode});Object.defineProperty(exports,"bufferCV",{enumerable:!0,get:()=>n.bufferCV});Object.defineProperty(exports,"noneCV",{enumerable:!0,get:()=>n.noneCV});Object.defineProperty(exports,"principalCV",{enumerable:!0,get:()=>n.principalCV});Object.defineProperty(exports,"responseErrorCV",{enumerable:!0,get:()=>n.responseErrorCV});Object.defineProperty(exports,"responseOkCV",{enumerable:!0,get:()=>n.responseOkCV});Object.defineProperty(exports,"someCV",{enumerable:!0,get:()=>n.someCV});Object.defineProperty(exports,"stringAsciiCV",{enumerable:!0,get:()=>n.stringAsciiCV});Object.defineProperty(exports,"stringUtf8CV",{enumerable:!0,get:()=>n.stringUtf8CV});Object.defineProperty(exports,"uintCV",{enumerable:!0,get:()=>n.uintCV});exports.CONTRACT_ADDRESS=u;exports.CONTRACT_NAMES=s;exports.LOCK_PERIODS=f;exports.MAX_DEPOSIT=m;exports.MIN_DEPOSIT=d;exports.TimeFiClient=M;exports.formatAddress=h;exports.formatDate=l;exports.formatNumber=b;exports.formatPercent=C;exports.formatRelativeTime=A;exports.formatSTX=g;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./constants.js";
+export * from "./format.js";
+export * from "./client.js";
+export { uintCV, principalCV, bufferCV, stringAsciiCV, stringUtf8CV, noneCV, someCV, responseOkCV, responseErrorCV, AnchorMode, PostConditionMode } from "@stacks/transactions";

package/dist/index.mjs

@@ -0,0 +1,147 @@
+import { callReadOnlyFunction as f, cvToValue as c, uintCV as i, PostConditionMode as u, AnchorMode as l } from "@stacks/transactions";
+import { AnchorMode as S, PostConditionMode as k, bufferCV as D, noneCV as _, principalCV as $, responseErrorCV as I, responseOkCV as L, someCV as F, stringAsciiCV as P, stringUtf8CV as G, uintCV as H } from "@stacks/transactions";
+import { StacksMainnet as d, StacksTestnet as m } from "@stacks/network";
+const h = "SP3FKNEZ86RG5RT7SZ5FBRGH85FZNG94ZH1MCGG6N", a = {
+  VAULT: "timefi-vault-v-A2",
+  REWARDS: "timefi-rewards-v-A2",
+  GOVERNANCE: "timefi-governance-v-A2",
+  EMERGENCY: "timefi-emergency-v-A2"
+}, M = {
+  MONTH_1: { label: "1 Month", blocks: 4320, apy: 1 },
+  MONTH_3: { label: "3 Months", blocks: 12960, apy: 3 },
+  MONTH_6: { label: "6 Months", blocks: 25920, apy: 6 },
+  MONTH_9: { label: "9 Months", blocks: 38880, apy: 9 },
+  YEAR_1: { label: "1 Year", blocks: 52560, apy: 12 }
+}, p = 0.01, T = 1e6, y = (n) => {
+  if (n == null) return "0.000000";
+  try {
+    const t = typeof n == "object" && n !== null && "value" in n ? n.value : n, e = Number(t);
+    return isNaN(e) ? "0.000000" : (e / 1e6).toLocaleString(void 0, {
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 6
+    });
+  } catch (t) {
+    return console.error("Error formatting STX:", t), "0.000000";
+  }
+}, C = (n, t = 4, e = 4) => n ? n.length <= t + e ? n : `${n.slice(0, t + 2)}...${n.slice(-e)}` : "", b = (n) => {
+  if (n == null) return "0";
+  const t = Number(n);
+  return isNaN(t) ? "0" : t.toLocaleString();
+}, E = (n, t = 2) => {
+  if (n == null) return "0%";
+  const e = Number(n);
+  return isNaN(e) ? "0%" : (e * 100).toFixed(t) + "%";
+}, w = (n) => {
+  if (!n) return "--";
+  const t = new Date(n);
+  return isNaN(t.getTime()) ? "--" : t.toLocaleDateString(void 0, {
+    year: "numeric",
+    month: "short",
+    day: "numeric"
+  });
+}, O = (n) => {
+  if (!n) return "--";
+  const t = /* @__PURE__ */ new Date(), e = new Date(n), r = Math.floor((t - e) / 1e3);
+  if (r < -1) {
+    const o = Math.abs(r);
+    return o < 60 ? "in a few seconds" : o < 3600 ? `in ${Math.floor(o / 60)}m` : o < 86400 ? `in ${Math.floor(o / 3600)}h` : `in ${Math.floor(o / 86400)}d`;
+  }
+  return r < 5 ? "just now" : r < 60 ? `${r}s ago` : r < 3600 ? `${Math.floor(r / 60)}m ago` : r < 86400 ? `${Math.floor(r / 3600)}h ago` : r < 604800 ? `${Math.floor(r / 86400)}d ago` : w(n);
+};
+function s(n, t) {
+  if (!Number.isInteger(n) || n <= 0)
+    throw new Error(`${t} must be a positive integer.`);
+}
+function g(n) {
+  if (n == null)
+    throw new Error("amountSTX is required");
+  const t = String(n).trim();
+  if (!/^\d+(\.\d+)?$/.test(t))
+    throw new Error("amountSTX must be a valid positive number.");
+  const [e, r = ""] = t.split(".");
+  if (r.length > 6)
+    throw new Error("amountSTX supports at most 6 decimal places.");
+  const o = BigInt(e) * 1000000n + BigInt((r + "000000").slice(0, 6));
+  if (o <= 0n)
+    throw new Error("amountSTX must be greater than 0.");
+  return o;
+}
+class R {
+  constructor(t = "mainnet") {
+    if (!["mainnet", "testnet"].includes(t))
+      throw new Error(`Invalid networkType "${t}". Use "mainnet" or "testnet".`);
+    this.networkType = t, this.network = t === "mainnet" ? new d() : new m(), this.contractAddress = h;
+  }
+  // --- Read-only Methods ---
+  async callReadOnly(t, e = [], r) {
+    const o = await f({
+      contractAddress: this.contractAddress,
+      contractName: a.VAULT,
+      functionName: t,
+      functionArgs: e,
+      network: this.network,
+      senderAddress: r || this.contractAddress
+    });
+    return o.type === 7 || o.type === 8 ? c(o.value) : c(o);
+  }
+  async getVault(t) {
+    return s(t, "vaultId"), this.callReadOnly("get-vault", [i(t)]);
+  }
+  async getTimeRemaining(t) {
+    return s(t, "vaultId"), this.callReadOnly("get-time-remaining", [i(t)]);
+  }
+  async canWithdraw(t) {
+    return s(t, "vaultId"), this.callReadOnly("can-withdraw", [i(t)]);
+  }
+  async getTVL() {
+    return this.callReadOnly("get-tvl", []);
+  }
+  // --- Transaction Signing Options Helpers ---
+  getCreateVaultOptions(t, e) {
+    return s(e, "lockDurationBlocks"), {
+      contractAddress: this.contractAddress,
+      contractName: a.VAULT,
+      functionName: "create-vault",
+      functionArgs: [i(g(t)), i(e)],
+      network: this.network,
+      anchorMode: l.Any,
+      postConditionMode: u.Allow
+    };
+  }
+  getWithdrawOptions(t) {
+    return s(t, "vaultId"), {
+      contractAddress: this.contractAddress,
+      contractName: a.VAULT,
+      functionName: "request-withdraw",
+      functionArgs: [i(t)],
+      network: this.network,
+      anchorMode: l.Any,
+      postConditionMode: u.Allow
+    };
+  }
+}
+export {
+  S as AnchorMode,
+  h as CONTRACT_ADDRESS,
+  a as CONTRACT_NAMES,
+  M as LOCK_PERIODS,
+  T as MAX_DEPOSIT,
+  p as MIN_DEPOSIT,
+  k as PostConditionMode,
+  R as TimeFiClient,
+  D as bufferCV,
+  C as formatAddress,
+  w as formatDate,
+  b as formatNumber,
+  E as formatPercent,
+  O as formatRelativeTime,
+  y as formatSTX,
+  _ as noneCV,
+  $ as principalCV,
+  I as responseErrorCV,
+  L as responseOkCV,
+  F as someCV,
+  P as stringAsciiCV,
+  G as stringUtf8CV,
+  H as uintCV
+};

package/package.json

@@ -1,19 +1,28 @@
 {
     "name": "timefi-sdk",
-    "version": "0.1.2",
+    "version": "0.1.4",
     "description": "Official JavaScript SDK for TimeFi Protocol - Time-locked vaults on Stacks blockchain",
-    "main": "dist/index.js",
-    "module": "dist/index.esm.js",
+    "main": "dist/index.cjs",
+    "module": "dist/index.mjs",
     "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.cjs"
+        }
+    },
     "files": [
         "dist",
         "README.md",
         "LICENSE"
     ],
     "scripts": {
-        "build": "vite build",
-        "test": "echo \"Error: no test specified\" && exit 1",
-        "prepublishOnly": "npm run build"
+        "clean": "rimraf dist",
+        "build": "npm run clean && vite build && npm run build:types",
+        "build:types": "tsc -p tsconfig.types.json",
+        "test": "vitest run",
+        "prepublishOnly": "npm run build && npm run test"
     },
     "keywords": [
         "stacks",
@@ -41,11 +50,17 @@
     "publishConfig": {
         "access": "public"
     },
-    "peerDependencies": {
+    "engines": {
+        "node": ">=18"
+    },
+    "dependencies": {
         "@stacks/transactions": "^6.0.0",
         "@stacks/network": "^6.0.0"
     },
     "devDependencies": {
-        "vite": "^5.0.0"
+        "rimraf": "^6.1.0",
+        "typescript": "^5.9.2",
+        "vite": "^5.0.0",
+        "vitest": "^4.0.8"
     }
-}
+}

package/dist/index.esm.js

@@ -1,131 +0,0 @@
-import { callReadOnlyFunction as l, cvToValue as a, uintCV as i, PostConditionMode as c, AnchorMode as u } from "@stacks/transactions";
-import { AnchorMode as b, PostConditionMode as D, bufferCV as k, noneCV as _, principalCV as S, responseErrorCV as L, responseOkCV as $, someCV as F, stringAsciiCV as v, stringUtf8CV as G, uintCV as P } from "@stacks/transactions";
-import { StacksMainnet as f, StacksTestnet as d } from "@stacks/network";
-const h = "SP3FKNEZ86RG5RT7SZ5FBRGH85FZNG94ZH1MCGG6N", s = {
-  VAULT: "timefi-vault-v-A2",
-  REWARDS: "timefi-rewards-v-A2",
-  GOVERNANCE: "timefi-governance-v-A2",
-  EMERGENCY: "timefi-emergency-v-A2"
-}, N = {
-  MONTH_1: { label: "1 Month", blocks: 4320, apy: 1 },
-  MONTH_3: { label: "3 Months", blocks: 12960, apy: 3 },
-  MONTH_6: { label: "6 Months", blocks: 25920, apy: 6 },
-  MONTH_9: { label: "9 Months", blocks: 38880, apy: 9 },
-  YEAR_1: { label: "1 Year", blocks: 52560, apy: 12 }
-}, M = 0.01, g = 1e6, y = (t) => {
-  if (t == null) return "0.000000";
-  try {
-    const n = typeof t == "object" && t !== null && "value" in t ? t.value : t, e = Number(n);
-    return isNaN(e) ? "0.000000" : (e / 1e6).toLocaleString(void 0, {
-      minimumFractionDigits: 0,
-      maximumFractionDigits: 6
-    });
-  } catch (n) {
-    return console.error("Error formatting STX:", n), "0.000000";
-  }
-}, C = (t, n = 4, e = 4) => t ? t.length <= n + e ? t : `${t.slice(0, n + 2)}...${t.slice(-e)}` : "", T = (t) => {
-  if (t == null) return "0";
-  const n = Number(t);
-  return isNaN(n) ? "0" : n.toLocaleString();
-}, p = (t, n = 2) => {
-  if (t == null) return "0%";
-  const e = Number(t);
-  return isNaN(e) ? "0%" : (e * 100).toFixed(n) + "%";
-}, m = (t) => {
-  if (!t) return "--";
-  const n = new Date(t);
-  return isNaN(n.getTime()) ? "--" : n.toLocaleDateString(void 0, {
-    year: "numeric",
-    month: "short",
-    day: "numeric"
-  });
-}, O = (t) => {
-  if (!t) return "--";
-  const n = /* @__PURE__ */ new Date(), e = new Date(t), r = Math.floor((n - e) / 1e3);
-  if (r < -1) {
-    const o = Math.abs(r);
-    return o < 60 ? "in a few seconds" : o < 3600 ? `in ${Math.floor(o / 60)}m` : o < 86400 ? `in ${Math.floor(o / 3600)}h` : `in ${Math.floor(o / 86400)}d`;
-  }
-  return r < 5 ? "just now" : r < 60 ? `${r}s ago` : r < 3600 ? `${Math.floor(r / 60)}m ago` : r < 86400 ? `${Math.floor(r / 3600)}h ago` : r < 604800 ? `${Math.floor(r / 86400)}d ago` : m(t);
-};
-class R {
-  constructor(n = "mainnet") {
-    this.network = n === "mainnet" ? new f() : new d(), this.contractAddress = h;
-  }
-  // --- Read-only Methods ---
-  async callReadOnly(n, e = [], r) {
-    const o = await l({
-      contractAddress: this.contractAddress,
-      contractName: s.VAULT,
-      functionName: n,
-      functionArgs: e,
-      network: this.network,
-      senderAddress: r || this.contractAddress
-    });
-    return o.type === 7 || o.type === 8 ? a(o.value) : a(o);
-  }
-  async getVault(n) {
-    if (n == null) throw new Error("vaultId is required");
-    return this.callReadOnly("get-vault", [i(n)]);
-  }
-  async getTimeRemaining(n) {
-    if (n == null) throw new Error("vaultId is required");
-    return this.callReadOnly("get-time-remaining", [i(n)]);
-  }
-  async canWithdraw(n) {
-    if (n == null) throw new Error("vaultId is required");
-    return this.callReadOnly("can-withdraw", [i(n)]);
-  }
-  async getTVL() {
-    return this.callReadOnly("get-tvl", []);
-  }
-  // --- Transaction Signing Options Helpers ---
-  getCreateVaultOptions(n, e) {
-    return {
-      contractAddress: this.contractAddress,
-      contractName: s.VAULT,
-      functionName: "create-vault",
-      functionArgs: [i(n * 1e6), i(e)],
-      network: this.network,
-      anchorMode: u.Any,
-      postConditionMode: c.Deny
-    };
-  }
-  getWithdrawOptions(n) {
-    if (n == null) throw new Error("vaultId is required");
-    return {
-      contractAddress: this.contractAddress,
-      contractName: s.VAULT,
-      functionName: "request-withdraw",
-      functionArgs: [i(n)],
-      network: this.network,
-      anchorMode: u.Any,
-      postConditionMode: c.Deny
-    };
-  }
-}
-export {
-  b as AnchorMode,
-  h as CONTRACT_ADDRESS,
-  s as CONTRACT_NAMES,
-  N as LOCK_PERIODS,
-  g as MAX_DEPOSIT,
-  M as MIN_DEPOSIT,
-  D as PostConditionMode,
-  R as TimeFiClient,
-  k as bufferCV,
-  C as formatAddress,
-  m as formatDate,
-  T as formatNumber,
-  p as formatPercent,
-  O as formatRelativeTime,
-  y as formatSTX,
-  _ as noneCV,
-  S as principalCV,
-  L as responseErrorCV,
-  $ as responseOkCV,
-  F as someCV,
-  v as stringAsciiCV,
-  G as stringUtf8CV,
-  P as uintCV
-};

package/dist/index.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@stacks/transactions"),s=require("@stacks/network"),u="SP3FKNEZ86RG5RT7SZ5FBRGH85FZNG94ZH1MCGG6N",a={VAULT:"timefi-vault-v-A2",REWARDS:"timefi-rewards-v-A2",GOVERNANCE:"timefi-governance-v-A2",EMERGENCY:"timefi-emergency-v-A2"},l={MONTH_1:{label:"1 Month",blocks:4320,apy:1},MONTH_3:{label:"3 Months",blocks:12960,apy:3},MONTH_6:{label:"6 Months",blocks:25920,apy:6},MONTH_9:{label:"9 Months",blocks:38880,apy:9},YEAR_1:{label:"1 Year",blocks:52560,apy:12}},f=.01,d=1e6,m=t=>{if(t==null)return"0.000000";try{const e=typeof t=="object"&&t!==null&&"value"in t?t.value:t,r=Number(e);return isNaN(r)?"0.000000":(r/1e6).toLocaleString(void 0,{minimumFractionDigits:0,maximumFractionDigits:6})}catch(e){return console.error("Error formatting STX:",e),"0.000000"}},C=(t,e=4,r=4)=>t?t.length<=e+r?t:`${t.slice(0,e+2)}...${t.slice(-r)}`:"",h=t=>{if(t==null)return"0";const e=Number(t);return isNaN(e)?"0":e.toLocaleString()},b=(t,e=2)=>{if(t==null)return"0%";const r=Number(t);return isNaN(r)?"0%":(r*100).toFixed(e)+"%"},c=t=>{if(!t)return"--";const e=new Date(t);return isNaN(e.getTime())?"--":e.toLocaleDateString(void 0,{year:"numeric",month:"short",day:"numeric"})},g=t=>{if(!t)return"--";const e=new Date,r=new Date(t),o=Math.floor((e-r)/1e3);if(o<-1){const i=Math.abs(o);return i<60?"in a few seconds":i<3600?`in ${Math.floor(i/60)}m`:i<86400?`in ${Math.floor(i/3600)}h`:`in ${Math.floor(i/86400)}d`}return o<5?"just now":o<60?`${o}s ago`:o<3600?`${Math.floor(o/60)}m ago`:o<86400?`${Math.floor(o/3600)}h ago`:o<604800?`${Math.floor(o/86400)}d ago`:c(t)};class A{constructor(e="mainnet"){this.network=e==="mainnet"?new s.StacksMainnet:new s.StacksTestnet,this.contractAddress=u}async callReadOnly(e,r=[],o){const i=await n.callReadOnlyFunction({contractAddress:this.contractAddress,contractName:a.VAULT,functionName:e,functionArgs:r,network:this.network,senderAddress:o||this.contractAddress});return i.type===7||i.type===8?n.cvToValue(i.value):n.cvToValue(i)}async getVault(e){if(e==null)throw new Error("vaultId is required");return this.callReadOnly("get-vault",[n.uintCV(e)])}async getTimeRemaining(e){if(e==null)throw new Error("vaultId is required");return this.callReadOnly("get-time-remaining",[n.uintCV(e)])}async canWithdraw(e){if(e==null)throw new Error("vaultId is required");return this.callReadOnly("can-withdraw",[n.uintCV(e)])}async getTVL(){return this.callReadOnly("get-tvl",[])}getCreateVaultOptions(e,r){return{contractAddress:this.contractAddress,contractName:a.VAULT,functionName:"create-vault",functionArgs:[n.uintCV(e*1e6),n.uintCV(r)],network:this.network,anchorMode:n.AnchorMode.Any,postConditionMode:n.PostConditionMode.Deny}}getWithdrawOptions(e){if(e==null)throw new Error("vaultId is required");return{contractAddress:this.contractAddress,contractName:a.VAULT,functionName:"request-withdraw",functionArgs:[n.uintCV(e)],network:this.network,anchorMode:n.AnchorMode.Any,postConditionMode:n.PostConditionMode.Deny}}}Object.defineProperty(exports,"AnchorMode",{enumerable:!0,get:()=>n.AnchorMode});Object.defineProperty(exports,"PostConditionMode",{enumerable:!0,get:()=>n.PostConditionMode});Object.defineProperty(exports,"bufferCV",{enumerable:!0,get:()=>n.bufferCV});Object.defineProperty(exports,"noneCV",{enumerable:!0,get:()=>n.noneCV});Object.defineProperty(exports,"principalCV",{enumerable:!0,get:()=>n.principalCV});Object.defineProperty(exports,"responseErrorCV",{enumerable:!0,get:()=>n.responseErrorCV});Object.defineProperty(exports,"responseOkCV",{enumerable:!0,get:()=>n.responseOkCV});Object.defineProperty(exports,"someCV",{enumerable:!0,get:()=>n.someCV});Object.defineProperty(exports,"stringAsciiCV",{enumerable:!0,get:()=>n.stringAsciiCV});Object.defineProperty(exports,"stringUtf8CV",{enumerable:!0,get:()=>n.stringUtf8CV});Object.defineProperty(exports,"uintCV",{enumerable:!0,get:()=>n.uintCV});exports.CONTRACT_ADDRESS=u;exports.CONTRACT_NAMES=a;exports.LOCK_PERIODS=l;exports.MAX_DEPOSIT=d;exports.MIN_DEPOSIT=f;exports.TimeFiClient=A;exports.formatAddress=C;exports.formatDate=c;exports.formatNumber=h;exports.formatPercent=b;exports.formatRelativeTime=g;exports.formatSTX=m;