@kehtus/proportion-sdk 0.1.0

package/dist/indexer.js

@@ -0,0 +1,540 @@
+export class IndexerModule {
+    graphqlUrl;
+    graphqlWsUrl;
+    transports;
+    ws = null;
+    wsId = 0;
+    subscriptions = new Map();
+    reconnectTimer = null;
+    reconnectDelay = 1000;
+    constructor(graphqlUrl, graphqlWsUrl, transports = {}) {
+        this.graphqlUrl = graphqlUrl;
+        this.graphqlWsUrl = graphqlWsUrl;
+        this.transports = transports;
+    }
+    static PAGE_SIZE = 1000;
+    static VAULT_FIELDS = `id address totalDeposits totalWithdrawals totalActivationFees cumulativeActivationFeesToVault totalAllocated totalShares cumulativeProfitShares cumulativeCancelledProfit cumulativeSubscriptionFees cumulativeProtocolFeesRouted cumulativeHypercoreFees cumulativeAccountGains cumulativeAccountLosses cumulativeRescuedFunds totalAccountsActivated totalAccountsActive totalAccountsClosed paused subscriptionFeeMultiplier protocolFeeBps protocolFeeReceiver updatedAt`;
+    static ACCOUNT_FIELDS = `id owner builder { id address vaultAddress } vaultAddress factoryAddress state accountSize drawdownBps dailyDrawdownEnabled activationFee highWaterMark profitableDaysCount lastCheckpointDay totalCheckpoints subscriptionPaidUntil subscriptionCancelled pendingSubscriptionFee subscriptionFeeMultiplier dayStartValue apiWallet riskEngineWallet builderRiskEngineWallet createdAt activatedAt closingInitiatedAt returnInitiatedAt closedAt returnedAmount breachType breachValue breachFloor closePendingSubFee closePendingProfit lastWithdrawalId updatedAt`;
+    static MAIN_VAULT_CONFIG_FIELDS = `id vaultAddress factoryAddress owner pendingOwner relayer paused protocolFeeReceiver feeMultiplier subscriptionFeeMultiplier dailyDdDiscountBps minBuilderShares builderLeverage protocolFeeBps minAccountSize maxAccountSize minDrawdownBps maxDrawdownBps maxUtilizationBps maxSingleAccountBps hypeForSpot maxCap createdAt updatedAt`;
+    static FACTORY_CONFIG_FIELDS = `id factoryAddress vaultAddress owner pendingOwner createdAt updatedAt`;
+    static CONFIG_CHANGE_FIELDS = `id contractAddress contractType field oldValue newValue blockNumber timestamp txHash`;
+    static VAULT_DAY_DATA_FIELDS = `id date dayNumber evmBalance totalAllocated totalAssets totalShares sharePrice dailyDeposits dailyWithdrawals dailyNetLpFlow dailyActivationFees dailyActivationFeesToVault dailyProfitShares dailyCancelledProfit dailySubscriptionFees dailyProtocolFeesRouted dailyHypercoreFees dailyRescuedFunds dailyAccountReturnAmount dailyAccountPrincipalReturned dailyAccountGains dailyAccountLosses dailyPerformancePnl totalAccountsActivated totalAccountsActive totalAccountsClosed accountsActivatedToday accountsClosedToday navChange24h sharePriceChange24h return24hBps paused updatedAt`;
+    static LP_DAY_DATA_FIELDS = `id lp { id } date dayNumber shares sharesValue dailyDeposits dailyWithdrawals depositCount withdrawCount`;
+    // Explicit vault address always wins. ProtocolConfig is only a convenience default for
+    // indexer-scoped reads when the caller does not provide one.
+    async resolveVaultAddress(vaultAddress) {
+        if (vaultAddress)
+            return vaultAddress.toLowerCase();
+        const protocol = await this.getProtocolConfig();
+        return protocol?.vaultAddress?.toLowerCase() ?? null;
+    }
+    // Explicit factory address always wins. ProtocolConfig is only a convenience default for
+    // indexer-scoped reads when the caller does not provide one.
+    async resolveFactoryAddress(factoryAddress) {
+        if (factoryAddress)
+            return factoryAddress.toLowerCase();
+        const protocol = await this.getProtocolConfig();
+        return protocol?.factoryAddress?.toLowerCase() ?? null;
+    }
+    // ── GraphQL fetch helper ──────────────────────────
+    async query(query, variables) {
+        const fetchFn = this.transports.fetchFn ?? globalThis.fetch;
+        if (!fetchFn)
+            throw new Error("fetch is not available; pass fetchFn in SDKConfig");
+        const res = await fetchFn(this.graphqlUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ query, variables }),
+        });
+        if (!res.ok)
+            throw new Error(`GraphQL request failed: ${res.status} ${res.statusText}`);
+        const json = (await res.json());
+        if (json.errors?.length)
+            throw new Error(`GraphQL error: ${json.errors[0].message}`);
+        return json.data;
+    }
+    // ── VAULT ─────────────────────────────────────────
+    async getVault(vaultAddress) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query {
+          Vault(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.VAULT_FIELDS} }
+        }
+      `);
+            return data.Vault[0] ?? null;
+        }
+        const data = await this.query(`
+      query($id: String!) {
+        Vault(where: { id: { _eq: $id } }) { ${IndexerModule.VAULT_FIELDS} }
+      }
+    `, { id: resolvedVault });
+        return data.Vault[0] ?? null;
+    }
+    // ── LP ────────────────────────────────────────────
+    async getLP(address) {
+        const data = await this.query(`
+      query($id: String!) { LiquidityProvider(where: { id: { _ilike: $id } }) { id totalDeposited totalWithdrawn depositCount withdrawCount lastActionAt } }
+    `, { id: address.toLowerCase() });
+        return data.LiquidityProvider[0] ?? null;
+    }
+    async getLPDeposits(address, p) {
+        const data = await this.query(`
+      query($lp: String!, $limit: Int, $offset: Int) {
+        VaultDeposit(where: { lp_id: { _ilike: $lp } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
+          id lp { id } amount sharesReceived timestamp txHash
+        }
+      }
+    `, { lp: address.toLowerCase(), limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.VaultDeposit;
+    }
+    async getLPWithdrawals(address, p) {
+        const data = await this.query(`
+      query($lp: String!, $limit: Int, $offset: Int) {
+        VaultWithdrawal(where: { lp_id: { _ilike: $lp } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
+          id lp { id } amount sharesBurned timestamp txHash
+        }
+      }
+    `, { lp: address.toLowerCase(), limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.VaultWithdrawal;
+    }
+    // ── BUILDER ───────────────────────────────────────
+    async getBuilder(address, vaultAddress) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query($address: String!) {
+          Builder(where: { address: { _ilike: $address } }) {
+            id
+            address
+            vaultAddress
+            active
+            totalAccountsActivated
+            totalAccountsClosed
+            activeAccounts
+            registeredAt
+            deactivatedAt
+          }
+        }
+      `, { address: address.toLowerCase() });
+            return data.Builder[0] ?? null;
+        }
+        const data = await this.query(`
+      query($address: String!, $vaultAddress: String) {
+        Builder(
+          where: {
+            address: { _ilike: $address }
+            vaultAddress: { _ilike: $vaultAddress }
+          }
+        ) {
+          id
+          address
+          vaultAddress
+          active
+          totalAccountsActivated
+          totalAccountsClosed
+          activeAccounts
+          registeredAt
+          deactivatedAt
+        }
+      }
+    `, { address: address.toLowerCase(), vaultAddress: resolvedVault });
+        return data.Builder[0] ?? null;
+    }
+    async getDelegates(builder, vaultAddress) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query($builder: String!) {
+          Delegate(where: { builderAddress: { _ilike: $builder } }) {
+            id
+            vaultAddress
+            delegateAddress
+            builderAddress
+          }
+        }
+      `, { builder: builder.toLowerCase() });
+            return data.Delegate;
+        }
+        const data = await this.query(`
+      query($builder: String!, $vaultAddress: String) {
+        Delegate(
+          where: {
+            builderAddress: { _ilike: $builder }
+            vaultAddress: { _ilike: $vaultAddress }
+          }
+        ) {
+          id
+          vaultAddress
+          delegateAddress
+          builderAddress
+        }
+      }
+    `, { builder: builder.toLowerCase(), vaultAddress: resolvedVault });
+        return data.Delegate;
+    }
+    // ── ACCOUNTS ──────────────────────────────────────
+    async getAccount(address) {
+        const data = await this.query(`
+      query($id: String!) { FundedAccount(where: { id: { _ilike: $id } }) { ${IndexerModule.ACCOUNT_FIELDS} } }
+    `, { id: address.toLowerCase() });
+        return data.FundedAccount[0] ?? null;
+    }
+    async getAccountsByOwner(owner) {
+        const data = await this.query(`
+      query($owner: String!) { FundedAccount(where: { owner: { _ilike: $owner } }, order_by: { createdAt: desc }) { ${IndexerModule.ACCOUNT_FIELDS} } }
+    `, { owner: owner.toLowerCase() });
+        return data.FundedAccount;
+    }
+    async getAccountsByBuilder(builder, vaultAddress) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query($builder: String!) {
+          FundedAccount(
+            where: { builder: { address: { _ilike: $builder } } },
+            order_by: { createdAt: desc }
+          ) { ${IndexerModule.ACCOUNT_FIELDS} }
+        }
+      `, { builder: builder.toLowerCase() });
+            return data.FundedAccount;
+        }
+        const data = await this.query(`
+      query($builder: String!, $vaultAddress: String) {
+        FundedAccount(
+          where: {
+            builder: {
+              address: { _ilike: $builder }
+              vaultAddress: { _ilike: $vaultAddress }
+            }
+          },
+          order_by: { createdAt: desc }
+        ) { ${IndexerModule.ACCOUNT_FIELDS} }
+      }
+    `, { builder: builder.toLowerCase(), vaultAddress: resolvedVault });
+        return data.FundedAccount;
+    }
+    async getAccountsByState(state) {
+        const data = await this.query(`
+      query($state: accountstate!) { FundedAccount(where: { state: { _eq: $state } }, order_by: { updatedAt: desc }) { ${IndexerModule.ACCOUNT_FIELDS} } }
+    `, { state });
+        return data.FundedAccount;
+    }
+    async getAccountsByStates(states) {
+        const all = [];
+        let offset = 0;
+        while (true) {
+            const data = await this.query(`
+        query($states: [accountstate!]!, $limit: Int!, $offset: Int!) {
+          FundedAccount(where: { state: { _in: $states } }, order_by: { updatedAt: desc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
+        }
+      `, { states, limit: IndexerModule.PAGE_SIZE, offset });
+            all.push(...data.FundedAccount);
+            if (data.FundedAccount.length < IndexerModule.PAGE_SIZE)
+                break;
+            offset += IndexerModule.PAGE_SIZE;
+        }
+        return all;
+    }
+    async getAccountsUpdatedSince(since) {
+        const all = [];
+        let offset = 0;
+        while (true) {
+            const data = await this.query(`
+        query($since: numeric!, $limit: Int!, $offset: Int!) {
+          FundedAccount(where: { updatedAt: { _gt: $since } }, order_by: { updatedAt: asc }, limit: $limit, offset: $offset) { ${IndexerModule.ACCOUNT_FIELDS} }
+        }
+      `, { since, limit: IndexerModule.PAGE_SIZE, offset });
+            all.push(...data.FundedAccount);
+            if (data.FundedAccount.length < IndexerModule.PAGE_SIZE)
+                break;
+            offset += IndexerModule.PAGE_SIZE;
+        }
+        return all;
+    }
+    // ── HISTORY ───────────────────────────────────────
+    async getCheckpoints(account, p) {
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        Checkpoint(where: { account_id: { _ilike: $account } }, order_by: { dayNumber: desc }, limit: $limit, offset: $offset) {
+          id dayNumber accountValue previousValue profitable profitableDaysCount timestamp
+        }
+      }
+    `, { account: account.toLowerCase(), limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.Checkpoint;
+    }
+    async getWithdrawals(account, p) {
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        ProfitWithdrawal(where: { account_id: { _ilike: $account } }, order_by: { requestedAt: desc }, limit: $limit, offset: $offset) {
+          id profit ownerAmount vaultAmount protocolAmount status requestedAt claimedAt cancelledAt
+        }
+      }
+    `, { account: account.toLowerCase(), limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.ProfitWithdrawal;
+    }
+    async getSubscriptionPayments(account, p) {
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        SubscriptionPayment(where: { account_id: { _ilike: $account } }, order_by: { timestamp: desc }, limit: $limit, offset: $offset) {
+          id amount paidUntil timestamp
+        }
+      }
+    `, { account: account.toLowerCase(), limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.SubscriptionPayment;
+    }
+    async getEvents(account, p) {
+        const data = await this.query(`
+      query($account: String!, $limit: Int, $offset: Int) {
+        AccountEvent(where: { account_id: { _ilike: $account } }, order_by: { blockNumber: desc }, limit: $limit, offset: $offset) {
+          id eventType data timestamp blockNumber txHash
+        }
+      }
+    `, { account: account.toLowerCase(), limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+        return data.AccountEvent;
+    }
+    async getEventsByType(type, limit) {
+        const data = await this.query(`
+      query($type: String!, $limit: Int) {
+        AccountEvent(where: { eventType: { _eq: $type } }, order_by: { blockNumber: desc }, limit: $limit) {
+          id eventType data timestamp blockNumber txHash
+        }
+      }
+    `, { type, limit: limit ?? 50 });
+        return data.AccountEvent;
+    }
+    // ── PROTOCOL CONFIG ─────────────────────────────
+    async getProtocolConfig() {
+        const data = await this.query(`{
+      ProtocolConfig { id vaultAddress factoryAddress updatedAt }
+    }`);
+        return data.ProtocolConfig[0] ?? null;
+    }
+    // ── CONFIG ────────────────────────────────────────
+    async getMainVaultConfig(vaultAddress) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query {
+          MainVaultConfig(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.MAIN_VAULT_CONFIG_FIELDS} }
+        }
+      `);
+            return data.MainVaultConfig[0] ?? null;
+        }
+        const data = await this.query(`
+      query($id: String!) {
+        MainVaultConfig(where: { id: { _eq: $id } }) { ${IndexerModule.MAIN_VAULT_CONFIG_FIELDS} }
+      }
+    `, { id: resolvedVault });
+        return data.MainVaultConfig[0] ?? null;
+    }
+    async getFactoryConfig(factoryAddress) {
+        const resolvedFactory = await this.resolveFactoryAddress(factoryAddress);
+        if (!resolvedFactory) {
+            const data = await this.query(`
+        query {
+          FactoryConfig(order_by: { updatedAt: desc }, limit: 1) { ${IndexerModule.FACTORY_CONFIG_FIELDS} }
+        }
+      `);
+            return data.FactoryConfig[0] ?? null;
+        }
+        const data = await this.query(`
+      query($id: String!) {
+        FactoryConfig(where: { id: { _eq: $id } }) { ${IndexerModule.FACTORY_CONFIG_FIELDS} }
+      }
+    `, { id: resolvedFactory });
+        return data.FactoryConfig[0] ?? null;
+    }
+    async getConfigChanges(filters) {
+        const variables = {
+            limit: filters?.limit ?? 50,
+            offset: filters?.offset ?? 0,
+        };
+        const variableDefs = ["$limit: Int", "$offset: Int"];
+        const whereClauses = [];
+        if (filters?.contractAddress) {
+            variableDefs.push("$contractAddress: String!");
+            whereClauses.push("contractAddress: { _ilike: $contractAddress }");
+            variables.contractAddress = filters.contractAddress.toLowerCase();
+        }
+        if (filters?.contractType) {
+            variableDefs.push("$contractType: String!");
+            whereClauses.push("contractType: { _eq: $contractType }");
+            variables.contractType = filters.contractType;
+        }
+        if (filters?.field) {
+            variableDefs.push("$field: String!");
+            whereClauses.push("field: { _eq: $field }");
+            variables.field = filters.field;
+        }
+        const whereBlock = whereClauses.length > 0
+            ? `where: { ${whereClauses.join(" ")} }`
+            : "";
+        const data = await this.query(`
+      query(${variableDefs.join(", ")}) {
+        ConfigChange(
+          ${whereBlock}
+          order_by: [{ timestamp: desc }, { blockNumber: desc }]
+          limit: $limit
+          offset: $offset
+        ) { ${IndexerModule.CONFIG_CHANGE_FIELDS} }
+      }
+    `, variables);
+        return data.ConfigChange;
+    }
+    async getVaultDayData(vaultAddress, p) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query($limit: Int, $offset: Int) {
+          VaultDayData(order_by: [{ date: desc }, { updatedAt: desc }], limit: $limit, offset: $offset) {
+            ${IndexerModule.VAULT_DAY_DATA_FIELDS}
+          }
+        }
+      `, { limit: p?.limit ?? 50, offset: p?.offset ?? 0 });
+            return data.VaultDayData;
+        }
+        const data = await this.query(`
+      query($vaultAddress: String!, $limit: Int, $offset: Int) {
+        VaultDayData(
+          where: { id: { _ilike: $vaultAddress } }
+          order_by: [{ date: desc }, { updatedAt: desc }]
+          limit: $limit
+          offset: $offset
+        ) { ${IndexerModule.VAULT_DAY_DATA_FIELDS} }
+      }
+    `, {
+            vaultAddress: `${resolvedVault}-%`,
+            limit: p?.limit ?? 50,
+            offset: p?.offset ?? 0,
+        });
+        return data.VaultDayData;
+    }
+    async getLPDayData(address, p) {
+        const data = await this.query(`
+      query($lp: String!, $limit: Int, $offset: Int) {
+        LiquidityProviderDayData(
+          where: { lp_id: { _ilike: $lp } }
+          order_by: [{ date: desc }, { dayNumber: desc }]
+          limit: $limit
+          offset: $offset
+        ) { ${IndexerModule.LP_DAY_DATA_FIELDS} }
+      }
+    `, {
+            lp: address.toLowerCase(),
+            limit: p?.limit ?? 50,
+            offset: p?.offset ?? 0,
+        });
+        return data.LiquidityProviderDayData;
+    }
+    async getAllowedPerps(vaultAddress) {
+        const resolvedVault = await this.resolveVaultAddress(vaultAddress);
+        if (!resolvedVault) {
+            const data = await this.query(`
+        query {
+          AllowedPerp(where: { allowed: { _eq: true } }) { id vaultAddress perpIndex allowed }
+        }
+      `);
+            return data.AllowedPerp;
+        }
+        const data = await this.query(`
+      query($vaultAddress: String) {
+        AllowedPerp(
+          where: {
+            allowed: { _eq: true }
+            vaultAddress: { _ilike: $vaultAddress }
+          }
+        ) { id vaultAddress perpIndex allowed }
+      }
+    `, { vaultAddress: resolvedVault });
+        return data.AllowedPerp;
+    }
+    // ── SUBSCRIPTIONS (Hasura graphql-transport-ws) ───
+    ensureWs() {
+        const WebSocketCtor = (this.transports.webSocketCtor ?? globalThis.WebSocket);
+        if (!WebSocketCtor)
+            throw new Error("WebSocket is not available; pass webSocketCtor in SDKConfig");
+        if (this.ws && this.ws.readyState === WebSocketCtor.OPEN)
+            return this.ws;
+        if (!this.graphqlWsUrl)
+            throw new Error("graphqlWsUrl required for subscriptions");
+        const ws = new WebSocketCtor(this.graphqlWsUrl, "graphql-transport-ws");
+        this.ws = ws;
+        ws.onopen = () => {
+            this.reconnectDelay = 1000;
+            ws.send(JSON.stringify({ type: "connection_init" }));
+        };
+        ws.onmessage = (event) => {
+            const msg = JSON.parse(String(event.data));
+            if (msg.type === "connection_ack") {
+                for (const [id, sub] of this.subscriptions) {
+                    ws.send(JSON.stringify({
+                        id: String(id),
+                        type: "subscribe",
+                        payload: { query: sub.query, variables: sub.variables },
+                    }));
+                }
+            }
+            if (msg.type === "next" && msg.id && msg.payload?.data) {
+                const sub = this.subscriptions.get(Number(msg.id));
+                if (sub)
+                    sub.cb(msg.payload.data);
+            }
+        };
+        ws.onclose = () => {
+            this.reconnectTimer = setTimeout(() => {
+                this.reconnectDelay = Math.min(this.reconnectDelay * 2, 30000);
+                this.ensureWs();
+            }, this.reconnectDelay);
+        };
+        ws.onerror = () => {
+            ws.close();
+        };
+        return ws;
+    }
+    subscribe(query, variables, cb) {
+        const id = ++this.wsId;
+        this.subscriptions.set(id, { query, variables, cb: cb });
+        const ws = this.ensureWs();
+        const WebSocketCtor = (this.transports.webSocketCtor ?? globalThis.WebSocket);
+        if (WebSocketCtor && ws.readyState === WebSocketCtor.OPEN) {
+            ws.send(JSON.stringify({
+                id: String(id),
+                type: "subscribe",
+                payload: { query, variables },
+            }));
+        }
+        return () => {
+            this.subscriptions.delete(id);
+            const WebSocketCtor = (this.transports.webSocketCtor ?? globalThis.WebSocket);
+            if (this.ws && WebSocketCtor && this.ws.readyState === WebSocketCtor.OPEN) {
+                this.ws.send(JSON.stringify({ id: String(id), type: "complete" }));
+            }
+        };
+    }
+    subscribeActiveAccounts(cb) {
+        return this.subscribe(`subscription { FundedAccount(where: { state: { _eq: ACTIVE } }) { ${IndexerModule.ACCOUNT_FIELDS} } }`, undefined, (data) => cb(data.FundedAccount));
+    }
+    subscribeAccount(address, cb) {
+        return this.subscribe(`subscription($id: String!) { FundedAccount(where: { id: { _ilike: $id } }) { ${IndexerModule.ACCOUNT_FIELDS} } }`, { id: address.toLowerCase() }, (data) => { if (data.FundedAccount[0])
+            cb(data.FundedAccount[0]); });
+    }
+    subscribeAccountEvents(address, cb) {
+        return this.subscribe(`subscription($account: String!) { AccountEvent(where: { account_id: { _ilike: $account } }, order_by: { blockNumber: desc }, limit: 10) { id eventType data timestamp blockNumber txHash } }`, { account: address.toLowerCase() }, (data) => cb(data.AccountEvent));
+    }
+    subscribeStateChanges(cb) {
+        return this.subscribe(`subscription { FundedAccount(where: { state: { _neq: CLOSED } }, order_by: { updatedAt: desc }) { ${IndexerModule.ACCOUNT_FIELDS} } }`, undefined, (data) => cb(data.FundedAccount));
+    }
+    disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.subscriptions.clear();
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+}

package/dist/sdk.d.ts

@@ -0,0 +1,22 @@
+import { VaultModule } from "./vault.js";
+import { AccountModule } from "./account.js";
+import { FactoryModule } from "./factory.js";
+import { IndexerModule } from "./indexer.js";
+import type { SDKConfig } from "./types.js";
+export declare class ProportionSDK {
+    readonly vault: VaultModule;
+    readonly account: AccountModule;
+    readonly factory: FactoryModule;
+    readonly indexer: IndexerModule;
+    /**
+     * Async factory: resolves addresses from explicit config > ENV > ProtocolConfig > hardcoded constants.
+     *
+     * ProtocolConfig is only a convenience fallback from the indexer. It is not the source of truth
+     * for protocol configuration and should not replace explicit deployment config in applications.
+     *
+     * ENV vars: PROPORTION_VAULT_ADDRESS, PROPORTION_FACTORY_ADDRESS, PROPORTION_USDC_ADDRESS
+     */
+    static create(config: SDKConfig): Promise<ProportionSDK>;
+    constructor(config: SDKConfig);
+    disconnect(): void;
+}

package/dist/sdk.js

@@ -0,0 +1,89 @@
+import { createPublicClient, http } from "viem";
+import { ADDRESSES, hyperEvm } from "./constants.js";
+import { VaultModule } from "./vault.js";
+import { AccountModule } from "./account.js";
+import { FactoryModule } from "./factory.js";
+import { IndexerModule } from "./indexer.js";
+import { mainVaultAbi } from "./abi/mainVault.js";
+export class ProportionSDK {
+    vault;
+    account;
+    factory;
+    indexer;
+    /**
+     * Async factory: resolves addresses from explicit config > ENV > ProtocolConfig > hardcoded constants.
+     *
+     * ProtocolConfig is only a convenience fallback from the indexer. It is not the source of truth
+     * for protocol configuration and should not replace explicit deployment config in applications.
+     *
+     * ENV vars: PROPORTION_VAULT_ADDRESS, PROPORTION_FACTORY_ADDRESS, PROPORTION_USDC_ADDRESS
+     */
+    static async create(config) {
+        const resolved = { ...config.addresses };
+        // ENV fallbacks (Node; safely ignored in browsers)
+        const env = typeof process !== "undefined" ? process.env : undefined;
+        if (!resolved.MAIN_VAULT && env?.PROPORTION_VAULT_ADDRESS)
+            resolved.MAIN_VAULT = env.PROPORTION_VAULT_ADDRESS;
+        if (!resolved.FACTORY && env?.PROPORTION_FACTORY_ADDRESS)
+            resolved.FACTORY = env.PROPORTION_FACTORY_ADDRESS;
+        if (!resolved.USDC && env?.PROPORTION_USDC_ADDRESS)
+            resolved.USDC = env.PROPORTION_USDC_ADDRESS;
+        // Fetch missing addresses from the indexer only as a convenience fallback.
+        // Primary address sources remain explicit config.addresses and ENV.
+        if (!resolved.MAIN_VAULT || !resolved.FACTORY) {
+            try {
+                const indexer = new IndexerModule(config.graphqlUrl, undefined, {
+                    fetchFn: config.fetchFn,
+                    webSocketCtor: config.webSocketCtor,
+                });
+                const protocol = await indexer.getProtocolConfig();
+                if (protocol) {
+                    if (!resolved.MAIN_VAULT && protocol.vaultAddress)
+                        resolved.MAIN_VAULT = protocol.vaultAddress;
+                    if (!resolved.FACTORY && protocol.factoryAddress)
+                        resolved.FACTORY = protocol.factoryAddress;
+                }
+            }
+            catch { /* fall back to hardcoded constants */ }
+        }
+        if (resolved.MAIN_VAULT && !resolved.USDC) {
+            try {
+                const publicClient = createPublicClient({
+                    chain: hyperEvm,
+                    transport: http(config.rpcUrl ?? hyperEvm.rpcUrls.default.http[0]),
+                });
+                resolved.USDC = await publicClient.readContract({
+                    address: resolved.MAIN_VAULT,
+                    abi: mainVaultAbi,
+                    functionName: "usdc",
+                });
+            }
+            catch { /* fall back to hardcoded constants */ }
+        }
+        return new ProportionSDK({ ...config, addresses: resolved });
+    }
+    constructor(config) {
+        const addresses = {
+            vault: (config.addresses?.MAIN_VAULT ?? ADDRESSES.MAIN_VAULT),
+            usdc: (config.addresses?.USDC ?? ADDRESSES.USDC),
+            factory: (config.addresses?.FACTORY ?? ADDRESSES.FACTORY),
+        };
+        const publicClient = createPublicClient({
+            chain: hyperEvm,
+            transport: http(config.rpcUrl ?? hyperEvm.rpcUrls.default.http[0]),
+        });
+        this.vault = new VaultModule(publicClient, config.walletClient, hyperEvm, {
+            vault: addresses.vault,
+            usdc: addresses.usdc,
+        });
+        this.account = new AccountModule(publicClient, config.walletClient, hyperEvm);
+        this.factory = new FactoryModule(publicClient, addresses.factory);
+        this.indexer = new IndexerModule(config.graphqlUrl, config.graphqlWsUrl, {
+            fetchFn: config.fetchFn,
+            webSocketCtor: config.webSocketCtor,
+        });
+    }
+    disconnect() {
+        this.indexer.disconnect();
+    }
+}