@kehtus/proportion-sdk 0.1.2 → 0.1.3

package/dist/__tests__/utils.test.js

@@ -1,185 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { activationFee, subscriptionFee, splitProfit, trailingFloor, dailyFloor, isTrailingBreached, isDailyBreached, fromUsdc, toUsdc, from8Dec, to8Dec, toUsdc6, formatUsd, stateToLabel, labelToState, } from "../utils.js";
-import { AccountState } from "../types.js";
-// ── Helpers ──────────────────────────────────────────
-const usdc = (n) => BigInt(n) * 1000000n; // 6-dec USDC
-const dec8 = (n) => BigInt(n) * 100000000n; // 8-dec internal
-// ── Decimal conversions ──────────────────────────────
-describe("decimal conversions", () => {
-    it("toUsdc converts number to 6-dec bigint", () => {
-        expect(toUsdc(100)).toBe(100000000n);
-        expect(toUsdc(0.5)).toBe(500000n);
-        expect(toUsdc(5000)).toBe(5000000000n);
-    });
-    it("fromUsdc converts 6-dec bigint to number", () => {
-        expect(fromUsdc(100000000n)).toBe(100);
-        expect(fromUsdc(500000n)).toBe(0.5);
-    });
-    it("to8Dec scales 6-dec to 8-dec (*100)", () => {
-        expect(to8Dec(usdc(1000))).toBe(dec8(1000));
-    });
-    it("toUsdc6 scales 8-dec down to 6-dec (/100)", () => {
-        expect(toUsdc6(dec8(1000))).toBe(usdc(1000));
-    });
-    it("from8Dec converts 8-dec bigint to number", () => {
-        expect(from8Dec(dec8(5000))).toBe(5000);
-        expect(from8Dec(50000000n)).toBe(0.5);
-    });
-    it("roundtrip: toUsdc -> to8Dec -> toUsdc6", () => {
-        const original = toUsdc(1234);
-        const up = to8Dec(original);
-        const down = toUsdc6(up);
-        expect(down).toBe(original);
-    });
-});
-// ── Activation fee ───────────────────────────────────
-describe("activationFee", () => {
-    const FM = 120; // current contract feeMultiplier
-    it("$5000 account, 500bps, no daily DD → $300", () => {
-        // 5000 * 500 * 120 / 1_000_000 = 300
-        expect(activationFee(usdc(5000), 500, false, FM)).toBe(usdc(300));
-    });
-    it("$5000 account, 500bps, daily DD → $240", () => {
-        // 300 * 8000 / 10000 = 240 (20% discount)
-        expect(activationFee(usdc(5000), 500, true, FM)).toBe(usdc(240));
-    });
-    it("$10000 account, 1000bps, no daily DD → $1200", () => {
-        // 10000 * 1000 * 120 / 1_000_000 = 1200
-        expect(activationFee(usdc(10000), 1000, false, FM)).toBe(usdc(1200));
-    });
-    it("$10000 account, 1000bps, daily DD → $960", () => {
-        // 1200 * 8000 / 10000 = 960 (20% discount)
-        expect(activationFee(usdc(10000), 1000, true, FM)).toBe(usdc(960));
-    });
-    it("min params: $100 account, 500bps → $6", () => {
-        // 100 * 500 * 120 / 1_000_000 = 6
-        const fee = activationFee(usdc(100), 500, false, FM);
-        expect(fee).toBe(usdc(6));
-    });
-});
-// ── Subscription fee ─────────────────────────────────
-describe("subscriptionFee", () => {
-    const SFM = 150; // current contract subscriptionFeeMultiplier
-    it("$5000 account → $75/month", () => {
-        // 5000 * 150 / 10000 = 75
-        expect(subscriptionFee(usdc(5000), SFM)).toBe(usdc(75));
-    });
-    it("legacy signature is still accepted for compatibility", () => {
-        expect(subscriptionFee(usdc(5000), 500, true, SFM)).toBe(usdc(75));
-    });
-    it("$10000 account → $150/month", () => {
-        expect(subscriptionFee(usdc(10000), SFM)).toBe(usdc(150));
-    });
-});
-// ── Profit split ─────────────────────────────────────
-describe("splitProfit", () => {
-    it("$1000 profit → 80% owner, 7% protocol, 13% vault", () => {
-        const { owner, vault, protocol } = splitProfit(usdc(1000));
-        expect(owner).toBe(usdc(800));
-        expect(protocol).toBe(usdc(70));
-        expect(vault).toBe(usdc(130));
-    });
-    it("sum of parts equals total", () => {
-        const profit = usdc(7777);
-        const { owner, vault, protocol } = splitProfit(profit);
-        expect(owner + vault + protocol).toBe(profit);
-    });
-    it("zero profit", () => {
-        const { owner, vault, protocol } = splitProfit(0n);
-        expect(owner).toBe(0n);
-        expect(vault).toBe(0n);
-        expect(protocol).toBe(0n);
-    });
-    it("small profit — rounding goes to vault (remainder)", () => {
-        // $1 = 1_000_000
-        // owner = 1_000_000 * 8000 / 10000 = 800_000
-        // protocol = 1_000_000 * 700 / 10000 = 70_000
-        // vault = 1_000_000 - 800_000 - 70_000 = 130_000
-        const { owner, vault, protocol } = splitProfit(usdc(1));
-        expect(owner).toBe(800000n);
-        expect(protocol).toBe(70000n);
-        expect(vault).toBe(130000n);
-    });
-});
-// ── Drawdown floors ──────────────────────────────────
-describe("trailingFloor", () => {
-    it("500bps = 5% drawdown from HWM", () => {
-        const hwm = dec8(10000); // $10,000 in 8-dec
-        expect(trailingFloor(hwm, 500)).toBe(dec8(9500));
-    });
-    it("1000bps = 10% drawdown", () => {
-        const hwm = dec8(5000);
-        expect(trailingFloor(hwm, 1000)).toBe(dec8(4500));
-    });
-});
-describe("dailyFloor", () => {
-    it("500bps → daily = 250bps = 2.5% from day start", () => {
-        const dsv = dec8(10000);
-        // dailyBps = 500 / 2 = 250
-        // floor = 10000 - 10000 * 250 / 10000 = 10000 - 250 = 9750
-        expect(dailyFloor(dsv, 500)).toBe(dec8(9750));
-    });
-    it("1000bps → daily = 500bps = 5%", () => {
-        const dsv = dec8(10000);
-        expect(dailyFloor(dsv, 1000)).toBe(dec8(9500));
-    });
-});
-describe("breach checks", () => {
-    const hwm = dec8(10000);
-    const dsv = dec8(10000);
-    it("isTrailingBreached — below floor → true", () => {
-        expect(isTrailingBreached(dec8(9499), hwm, 500)).toBe(true);
-    });
-    it("isTrailingBreached — at floor → false", () => {
-        expect(isTrailingBreached(dec8(9500), hwm, 500)).toBe(false);
-    });
-    it("isTrailingBreached — above floor → false", () => {
-        expect(isTrailingBreached(dec8(9501), hwm, 500)).toBe(false);
-    });
-    it("isDailyBreached — below floor → true", () => {
-        expect(isDailyBreached(dec8(9749), dsv, 500)).toBe(true);
-    });
-    it("isDailyBreached — at floor → false", () => {
-        expect(isDailyBreached(dec8(9750), dsv, 500)).toBe(false);
-    });
-});
-// ── Enum mapping ─────────────────────────────────────
-describe("state enum mapping", () => {
-    it("stateToLabel maps all states", () => {
-        expect(stateToLabel(AccountState.Uninitialized)).toBe("UNINITIALIZED");
-        expect(stateToLabel(AccountState.Active)).toBe("ACTIVE");
-        expect(stateToLabel(AccountState.Closing)).toBe("CLOSING");
-        expect(stateToLabel(AccountState.Closed)).toBe("CLOSED");
-        expect(stateToLabel(AccountState.WithdrawalPending)).toBe("WITHDRAWAL_PENDING");
-        expect(stateToLabel(AccountState.Returning)).toBe("RETURNING");
-        expect(stateToLabel(AccountState.Initialized)).toBe("INITIALIZED");
-    });
-    it("labelToState reverses correctly", () => {
-        expect(labelToState("UNINITIALIZED")).toBe(AccountState.Uninitialized);
-        expect(labelToState("ACTIVE")).toBe(AccountState.Active);
-        expect(labelToState("CLOSED")).toBe(AccountState.Closed);
-        expect(labelToState("CLOSING")).toBe(AccountState.Closing);
-    });
-    it("roundtrip: state → label → state", () => {
-        for (const state of [
-            AccountState.Initialized,
-            AccountState.Active,
-            AccountState.WithdrawalPending,
-            AccountState.Closing,
-            AccountState.Returning,
-            AccountState.Closed,
-        ]) {
-            expect(labelToState(stateToLabel(state))).toBe(state);
-        }
-    });
-});
-// ── formatUsd ────────────────────────────────────────
-describe("formatUsd", () => {
-    it("formats 6-dec bigint as USD", () => {
-        expect(formatUsd(usdc(1000))).toBe("$1,000.00");
-        expect(formatUsd(usdc(0))).toBe("$0.00");
-    });
-    it("formats with custom decimals", () => {
-        expect(formatUsd(dec8(5000), 8)).toBe("$5,000.00");
-    });
-});

package/src/__tests__/account.test.ts

@@ -1,40 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { normalizeCheckpoints } from "../account.js";
-
-describe("normalizeCheckpoints", () => {
-  it("keeps linear order before the ring buffer wraps", () => {
-    const checkpoints = [
-      { accountValue: 100n, timestamp: 1n, profitable: false },
-      { accountValue: 110n, timestamp: 2n, profitable: true },
-      { accountValue: 120n, timestamp: 3n, profitable: true },
-      { accountValue: 0n, timestamp: 0n, profitable: false },
-      { accountValue: 0n, timestamp: 0n, profitable: false },
-      { accountValue: 0n, timestamp: 0n, profitable: false },
-      { accountValue: 0n, timestamp: 0n, profitable: false },
-    ] as const;
-
-    expect(normalizeCheckpoints(checkpoints, 3, 3).map((cp) => cp.accountValue)).toEqual([100n, 110n, 120n]);
-  });
-
-  it("returns chronological order after the ring buffer wraps", () => {
-    const checkpoints = [
-      { accountValue: 800n, timestamp: 8n, profitable: true },
-      { accountValue: 200n, timestamp: 2n, profitable: false },
-      { accountValue: 300n, timestamp: 3n, profitable: false },
-      { accountValue: 400n, timestamp: 4n, profitable: false },
-      { accountValue: 500n, timestamp: 5n, profitable: true },
-      { accountValue: 600n, timestamp: 6n, profitable: true },
-      { accountValue: 700n, timestamp: 7n, profitable: true },
-    ] as const;
-
-    expect(normalizeCheckpoints(checkpoints, 7, 1).map((cp) => cp.accountValue)).toEqual([
-      200n,
-      300n,
-      400n,
-      500n,
-      600n,
-      700n,
-      800n,
-    ]);
-  });
-});

package/src/__tests__/indexer.test.ts

@@ -1,255 +0,0 @@
-import { describe, it, expect, beforeAll } from "vitest";
-import { IndexerModule } from "../indexer.js";
-import "dotenv/config";
-
-// ── Setup ────────────────────────────────────────────
-
-const GRAPHQL_URL = process.env.GRAPHQL_URL;
-if (!GRAPHQL_URL) throw new Error("GRAPHQL_URL required in .env for indexer tests");
-
-const indexer = new IndexerModule(GRAPHQL_URL);
-
-// We'll find an existing account address from the indexer to test detail queries
-let existingAccountId: string | null = null;
-let existingOwner: string | null = null;
-let activeVaultId: string | null = null;
-let activeFactoryId: string | null = null;
-
-beforeAll(async () => {
-  try {
-    const protocol = await indexer.getProtocolConfig();
-    if (protocol) {
-      activeVaultId = protocol.vaultAddress;
-      activeFactoryId = protocol.factoryAddress;
-    }
-  } catch {
-    // protocol config may be unavailable on older indexers
-  }
-
-  try {
-    const accounts = await indexer.getAccountsByState("ACTIVE");
-    if (accounts.length > 0) {
-      existingAccountId = accounts[0].id;
-      existingOwner = accounts[0].owner;
-    }
-  } catch {
-    // indexer may have no active accounts
-  }
-});
-
-// ── Protocol ───────────────────────────────────────
-
-describe("indexer: protocol", () => {
-  it("getProtocolConfig returns deployment pointer or null", async () => {
-    const protocol = await indexer.getProtocolConfig();
-    if (!protocol) {
-      console.log("  [SKIP] no ProtocolConfig entity in indexer yet");
-      return;
-    }
-    expect(protocol.id).toBeTruthy();
-    expect(protocol.vaultAddress).toBeTruthy();
-    expect(protocol.factoryAddress).toBeTruthy();
-  });
-});
-
-// ── Vault ────────────────────────────────────────────
-
-describe("indexer: vault", () => {
-  it("getVault returns vault data or null", async () => {
-    const vault = await indexer.getVault();
-    if (!vault) {
-      console.log("  [SKIP] no Vault entity in indexer yet");
-      return;
-    }
-    expect(vault.id).toBeTruthy();
-    expect(vault.address).toBeTruthy();
-    expect(typeof vault.totalAccountsActivated).toBe("number");
-    expect(typeof vault.paused).toBe("boolean");
-    expect(typeof vault.totalAccountsActive).toBe("number");
-    expect(vault).toHaveProperty("cumulativeProtocolFeesRouted");
-    expect(vault).toHaveProperty("cumulativeRescuedFunds");
-  });
-});
-
-// ── Accounts ─────────────────────────────────────────
-
-describe("indexer: accounts", () => {
-  it("getAccountsByState returns array", async () => {
-    const accounts = await indexer.getAccountsByState("ACTIVE");
-    expect(Array.isArray(accounts)).toBe(true);
-    if (accounts.length > 0) {
-      expect(accounts[0].state).toBe("ACTIVE");
-      expect(accounts[0].id).toBeTruthy();
-      expect(accounts[0].owner).toBeTruthy();
-    }
-  });
-
-  it("getAccountsByStates returns array", async () => {
-    const accounts = await indexer.getAccountsByStates(["ACTIVE", "CLOSING"]);
-    expect(Array.isArray(accounts)).toBe(true);
-    for (const acc of accounts) {
-      expect(["ACTIVE", "CLOSING"]).toContain(acc.state);
-    }
-  });
-
-  it("getAccount returns single account or null", async () => {
-    if (!existingAccountId) {
-      console.log("  [SKIP] no existing accounts");
-      return;
-    }
-    const acc = await indexer.getAccount(existingAccountId);
-    expect(acc).not.toBeNull();
-    expect(acc!.id).toBe(existingAccountId);
-    expect(acc!.owner).toBeTruthy();
-    expect(acc!.vaultAddress).toBeTruthy();
-    expect(acc!.factoryAddress).toBeTruthy();
-    expect(typeof acc!.drawdownBps).toBe("number");
-    expect(typeof acc!.dailyDrawdownEnabled).toBe("boolean");
-    expect(acc).toHaveProperty("closePendingSubFee");
-    expect(acc).toHaveProperty("closePendingProfit");
-  });
-
-  it("getAccountsByOwner returns accounts", async () => {
-    if (!existingOwner) {
-      console.log("  [SKIP] no existing owner");
-      return;
-    }
-    const accounts = await indexer.getAccountsByOwner(existingOwner);
-    expect(Array.isArray(accounts)).toBe(true);
-    expect(accounts.length).toBeGreaterThan(0);
-    expect(accounts[0].owner.toLowerCase()).toBe(existingOwner.toLowerCase());
-  });
-});
-
-// ── History ──────────────────────────────────────────
-
-describe("indexer: history", () => {
-  it("getCheckpoints returns array", async () => {
-    if (!existingAccountId) return;
-    const checkpoints = await indexer.getCheckpoints(existingAccountId);
-    expect(Array.isArray(checkpoints)).toBe(true);
-    if (checkpoints.length > 0) {
-      expect(checkpoints[0].dayNumber).toBeTruthy();
-      expect(typeof checkpoints[0].profitable).toBe("boolean");
-    }
-  });
-
-  it("getWithdrawals returns array", async () => {
-    if (!existingAccountId) return;
-    const withdrawals = await indexer.getWithdrawals(existingAccountId);
-    expect(Array.isArray(withdrawals)).toBe(true);
-  });
-
-  it("getSubscriptionPayments returns array", async () => {
-    if (!existingAccountId) return;
-    const payments = await indexer.getSubscriptionPayments(existingAccountId);
-    expect(Array.isArray(payments)).toBe(true);
-  });
-
-  it("getEvents returns array", async () => {
-    if (!existingAccountId) return;
-    const events = await indexer.getEvents(existingAccountId);
-    expect(Array.isArray(events)).toBe(true);
-    if (events.length > 0) {
-      expect(events[0].eventType).toBeTruthy();
-      expect(events[0].txHash).toBeTruthy();
-    }
-  });
-
-  it("getEventsByType returns array", async () => {
-    const events = await indexer.getEventsByType("Initialized", 5);
-    expect(Array.isArray(events)).toBe(true);
-  });
-});
-
-// ── LP ───────────────────────────────────────────────
-
-describe("indexer: LP", () => {
-  it("getLP returns null for unknown address", async () => {
-    const lp = await indexer.getLP("0x0000000000000000000000000000000000000001");
-    expect(lp).toBeNull();
-  });
-
-  it("getLPDeposits returns array", async () => {
-    if (!existingOwner) return;
-    const deposits = await indexer.getLPDeposits(existingOwner);
-    expect(Array.isArray(deposits)).toBe(true);
-  });
-
-  it("getLPWithdrawals returns array", async () => {
-    if (!existingOwner) return;
-    const withdrawals = await indexer.getLPWithdrawals(existingOwner);
-    expect(Array.isArray(withdrawals)).toBe(true);
-  });
-
-  it("getLPDayData returns array", async () => {
-    const dayData = await indexer.getLPDayData(existingOwner ?? "0x0000000000000000000000000000000000000001");
-    expect(Array.isArray(dayData)).toBe(true);
-  });
-});
-
-// ── Builder ──────────────────────────────────────────
-
-describe("indexer: builder", () => {
-  it("getBuilder returns null for unknown address", async () => {
-    const builder = await indexer.getBuilder("0x0000000000000000000000000000000000000001");
-    expect(builder).toBeNull();
-  });
-
-  it("getDelegates returns array", async () => {
-    if (!existingOwner) return;
-    const delegates = await indexer.getDelegates(existingOwner);
-    expect(Array.isArray(delegates)).toBe(true);
-  });
-});
-
-// ── Config ───────────────────────────────────────────
-
-describe("indexer: config", () => {
-  it("getMainVaultConfig returns config or null", async () => {
-    if (!activeVaultId) {
-      console.log("  [SKIP] no active vault in ProtocolConfig");
-      return;
-    }
-    const config = await indexer.getMainVaultConfig(activeVaultId);
-    expect(config).not.toBeNull();
-    expect(config!.vaultAddress.toLowerCase()).toBe(activeVaultId.toLowerCase());
-    expect(typeof config!.subscriptionFeeMultiplier).toBe("number");
-  });
-
-  it("getFactoryConfig returns config or null", async () => {
-    if (!activeFactoryId) {
-      console.log("  [SKIP] no active factory in ProtocolConfig");
-      return;
-    }
-    const config = await indexer.getFactoryConfig(activeFactoryId);
-    expect(config).not.toBeNull();
-    expect(config!.factoryAddress.toLowerCase()).toBe(activeFactoryId.toLowerCase());
-  });
-
-  it("getConfigChanges returns array", async () => {
-    const changes = await indexer.getConfigChanges({
-      contractAddress: activeVaultId ?? undefined,
-      limit: 5,
-    });
-    expect(Array.isArray(changes)).toBe(true);
-  });
-
-  it("getAllowedPerps returns array", async () => {
-    const perps = await indexer.getAllowedPerps();
-    expect(Array.isArray(perps)).toBe(true);
-    if (perps.length > 0) {
-      expect(typeof perps[0].perpIndex).toBe("number");
-      expect(perps[0].allowed).toBe(true);
-    }
-  });
-
-  it("getVaultDayData returns array", async () => {
-    const days = await indexer.getVaultDayData(activeVaultId ?? undefined, { limit: 5 });
-    expect(Array.isArray(days)).toBe(true);
-    if (days.length > 0) {
-      expect(typeof days[0].dayNumber).toBe("number");
-      expect(days[0].totalAssets).toBeTruthy();
-    }
-  });
-});