@kehtus/proportion-sdk 0.1.0 → 0.1.2

package/src/account.ts

@@ -52,8 +52,6 @@ export class AccountModule {
         { ...contract, functionName: "subscriptionCancelled" },
         { ...contract, functionName: "pendingSubscriptionFee" },
         { ...contract, functionName: "apiWallet" },
-        { ...contract, functionName: "riskEngineWallet" },
-        { ...contract, functionName: "builderRiskEngineWallet" },
         { ...contract, functionName: "checkpointIndex" },
         { ...contract, functionName: "profitableDaysCount" },
         { ...contract, functionName: "totalCheckpoints" },
@@ -70,10 +68,10 @@ export class AccountModule {
       ],
     });
 
-    const checkpointIndex = results[16].result!;
-    const totalCp = results[18].result!;
-    const [profit, requestedAt] = results[22].result!;
-    const rawCheckpoints = results[28].result!;
+    const checkpointIndex = results[14].result!;
+    const totalCp = results[16].result!;
+    const profit = results[20].result! as bigint;
+    const rawCheckpoints = results[26].result!;
     const checkpoints = normalizeCheckpoints(rawCheckpoints, totalCp, checkpointIndex);
 
     return {
@@ -92,20 +90,18 @@ export class AccountModule {
       subscriptionCancelled: results[11].result!,
       pendingSubscriptionFee: results[12].result!,
       apiWallet: results[13].result!,
-      riskEngineWallet: results[14].result!,
-      builderRiskEngineWallet: results[15].result!,
       checkpointIndex,
-      profitableDaysCount: results[17].result!,
+      profitableDaysCount: results[15].result!,
       totalCheckpoints: totalCp,
-      lastCheckpointDay: results[19].result!,
-      closingInitiatedAt: Number(results[20].result!),
-      returnInitiatedAt: Number(results[21].result!),
-      pendingWithdrawal: { profit, requestedAt: Number(requestedAt) },
-      trailingFloor: results[23].result!,
-      dailyFloor: results[24].result!,
-      subscriptionFee: results[25].result!,
-      isSubscriptionActive: results[26].result!,
-      canWithdrawProfit: results[27].result!,
+      lastCheckpointDay: results[17].result!,
+      closingInitiatedAt: Number(results[18].result!),
+      returnInitiatedAt: Number(results[19].result!),
+      pendingWithdrawal: { profit },
+      trailingFloor: results[21].result!,
+      dailyFloor: results[22].result!,
+      subscriptionFee: results[23].result!,
+      isSubscriptionActive: results[24].result!,
+      canWithdrawProfit: results[25].result!,
       checkpoints,
     };
   }
@@ -174,13 +170,13 @@ export class AccountModule {
     return normalizeCheckpoints(all, Number(total), Number(checkpointIndex));
   }
 
-  async getPendingWithdrawal(account: Address): Promise<{ profit: bigint; requestedAt: number }> {
-    const result = await this.publicClient.readContract({
+  async getPendingWithdrawal(account: Address): Promise<{ profit: bigint }> {
+    const profit = await this.publicClient.readContract({
       address: account,
       abi: fundedAccountAbi,
       functionName: "pendingWithdrawal",
-    });
-    return { profit: result[0], requestedAt: Number(result[1]) };
+    }) as bigint;
+    return { profit };
   }
 
   async getAccountConfig(account: Address): Promise<{
@@ -243,14 +239,6 @@ export class AccountModule {
     });
   }
 
-  async cancelStuckWithdrawal(account: Address): Promise<Hash> {
-    return this.write({
-      address: account,
-      abi: fundedAccountAbi,
-      functionName: "cancelStuckWithdrawal",
-    });
-  }
-
   // ── PERMISSIONLESS WRITES ───────────────────────────
 
   async checkpoint(account: Address): Promise<Hash> {
@@ -294,6 +282,14 @@ export class AccountModule {
     });
   }
 
+  async bridgeToEvm(account: Address): Promise<Hash> {
+    return this.write({
+      address: account,
+      abi: fundedAccountAbi,
+      functionName: "bridgeToEvm",
+    });
+  }
+
   async finalizeReturn(account: Address): Promise<Hash> {
     return this.write({
       address: account,
@@ -326,14 +322,4 @@ export class AccountModule {
     });
   }
 
-  // ── RISK ENGINE WRITES ──────────────────────────────
-
-  async setRiskEngineWallet(account: Address, wallet: Address): Promise<Hash> {
-    return this.write({
-      address: account,
-      abi: fundedAccountAbi,
-      functionName: "setRiskEngineWallet",
-      args: [wallet],
-    });
-  }
 }

package/src/constants.ts

@@ -13,8 +13,9 @@ export const hyperEvm = {
 } as const satisfies Chain;
 
 export const ADDRESSES = {
-  MAIN_VAULT: "0x4478888dA8d22E275344C1A24BDEbcf2bfE2dc45",
-  FACTORY: "0xb7cE604a000CCFCe7c7DAfFBaefD26c33C86CE7A",
+  MAIN_VAULT: "0x3A8cD3feb02959B2AB622Fcebe40A477c73f9488",
+  FACTORY: "0x04B71DC7414Bfa940D1c11f839011B6a11031D2E",
+  FORWARDER: "0x5961880B2C461F9733EC71720528461840881f4E",
   USDC: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
 } as const;
 
@@ -33,12 +34,12 @@ export const HYPE_FOR_GAS = 1_000_000_000_000_000n; // 0.001 ether
 
 // Decimals
 export const USDC_DECIMALS = 6;
-export const ACCOUNT_VALUE_DECIMALS = 8;
-export const DECIMALS_MULTIPLIER = 100n; // 6→8 dec
+export const ACCOUNT_VALUE_DECIMALS = 8; // spotBalance, spotSend
+export const DECIMALS_MULTIPLIER = 100n; // 6dec→8dec (used for spotSend conversion)
+// Note: accountValue, HWM, dayStartValue, floors are all 6dec (accountMarginSummary returns 6dec)
 
 // Time (seconds)
 export const SUBSCRIPTION_PERIOD = 30 * 86400;
-export const WITHDRAWAL_TIMEOUT = 7 * 86400;
 export const BRIDGE_DELAY = 30;
 export const CLOSING_TIMEOUT = 3 * 86400;
 export const CHECKPOINT_INTERVAL = 86400;

package/src/indexer.ts

@@ -43,7 +43,7 @@ export class IndexerModule {
 
   private static readonly PAGE_SIZE = 1000;
   private static readonly 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`;
-  private static readonly 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`;
+  private static readonly 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 createdAt activatedAt closingInitiatedAt returnInitiatedAt closedAt returnedAmount breachType breachValue breachFloor closePendingSubFee closePendingProfit lastWithdrawalId updatedAt`;
   private static readonly 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`;
   private static readonly FACTORY_CONFIG_FIELDS = `id factoryAddress vaultAddress owner pendingOwner createdAt updatedAt`;
   private static readonly CONFIG_CHANGE_FIELDS = `id contractAddress contractType field oldValue newValue blockNumber timestamp txHash`;

package/src/types.ts

@@ -58,7 +58,6 @@ export type IndexerAccountStateLabel =
 export type BreachType =
   | "TRAILING_DRAWDOWN"
   | "DAILY_DRAWDOWN"
-  | "LEVERAGE"
   | "POSITION_LEVERAGE"
   | "UNAUTHORIZED_ASSET"
   | "SUBSCRIPTION_EXPIRED";
@@ -123,15 +122,13 @@ export interface AccountDetails {
   subscriptionCancelled: boolean;
   pendingSubscriptionFee: bigint;
   apiWallet: Address;
-  riskEngineWallet: Address;
-  builderRiskEngineWallet: Address;
   checkpointIndex: number;
   totalCheckpoints: number;
   profitableDaysCount: number;
   lastCheckpointDay: bigint;
   closingInitiatedAt: number;
   returnInitiatedAt: number;
-  pendingWithdrawal: { profit: bigint; requestedAt: number };
+  pendingWithdrawal: { profit: bigint };
   trailingFloor: bigint;
   dailyFloor: bigint;
   subscriptionFee: bigint;
@@ -214,8 +211,6 @@ export interface GqlAccount {
   subscriptionFeeMultiplier: number;
   dayStartValue: string;
   apiWallet: string | null;
-  riskEngineWallet: string | null;
-  builderRiskEngineWallet: string | null;
   createdAt: string;
   activatedAt: string | null;
   closingInitiatedAt: string | null;

package/src/utils.ts

@@ -35,7 +35,7 @@ export function formatUsd(amount: bigint, dec: number = USDC_DECIMALS): string {
   return "$" + num.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
 }
 
-// ── Drawdown ────────────────────────────────────────
+// ── Drawdown (all values in 6dec — matching on-chain HWM/dayStartValue) ──
 
 export function trailingFloor(hwm: bigint, drawdownBps: number): bigint {
   return hwm - (hwm * BigInt(drawdownBps)) / BPS;

package/SDK_IMPROVEMENT_PLAN.md

@@ -1,197 +0,0 @@
-# План улучшения Proportion SDK
-
-## Статус после повторной сверки
-
-Этот документ обновлён после повторной проверки against:
-
-- `contracts/MainVault.sol`
-- `contracts/FundedAccount.sol`
-- `contracts/FundedAccountFactory.sol`
-- `prop-sdk/src/*`
-- критичные indexer-файлы `envio-funded/schema.graphql` и `envio-funded/src/EventHandlers.ts`
-
-Если этот план и Solidity расходятся, Solidity остаётся source of truth.
-
-## Что уже закрыто
-
-### Контрактная синхронизация
-
-- ABI в SDK синхронизированы с текущими локальными контрактами.
-- Формулы `activationFee`, `subscriptionFee`, `splitProfit`, `trailingFloor`, `dailyFloor` приведены к актуальной Solidity-логике.
-- `arch.md` обновлён и теперь описывает текущий surface SDK, а не старую версию контрактов.
-
-### VaultModule
-
-- Добавлены admin setters для текущих mutable параметров vault:
-  - `setFeeMultiplier`
-  - `setSubscriptionFeeMultiplier`
-  - `setHypeForSpot`
-  - `setMaxCap`
-  - `setMinBuilderShares`
-  - `setBuilderLeverage`
-  - `setProtocolFeeBps`
-  - `setMinAccountSize`
-  - `setMaxAccountSize`
-  - `setMinDrawdownBps`
-  - `setMaxDrawdownBps`
-  - `setMaxUtilizationBps`
-  - `setMaxSingleAccountBps`
-- `getStats()` расширен и читает текущий конфиг и runtime state vault.
-- Добавлены utility getters:
-  - `isFundedAccount`
-  - `getDelegateBuilder`
-  - `getRemainingCap`
-- `activateFunded()` больше не полагается на stale native fee default и читает `hypeForSpot()` из vault.
-
-### AccountModule
-
-- Добавлен `initiateCloseAdmin`.
-- Добавлен `getAccountConfig()`.
-- `getDetails()` теперь возвращает `subscriptionFeeMultiplier`, `checkpointIndex` и нормализованные checkpoints вместо сырого ring-buffer порядка.
-- Текущий write surface выровнен с локальным `FundedAccount.sol`.
-
-### FactoryModule
-
-- SDK переведён на реальный on-chain surface новой фабрики:
-  - `allAccounts(index)`
-  - `allAccountsIndex(account)`
-  - `traderBuilderNonce(owner, builder)`
-  - `predictFundedAccountAddress(owner, builder)`
-- Сохранены совместимые helper-методы `getAccountsCount()` и `getAccounts()`, но теперь они реализованы поверх probing `allAccounts(index)`.
-- Добавлены safe helpers:
-  - `hasAccount`
-  - `findAccountIndex`
-
-### Indexer Layer
-
-- GraphQL-типы приведены к реальной `schema.graphql`.
-- Разделены on-chain state labels и indexer state labels.
-- Учтён `POSITION_LEVERAGE`.
-- Учтены дополнительные индексируемые поля вроде `subscriptionFeeMultiplier`, `lastWithdrawalId`, `totalAllocated`, `totalShares`.
-- Vault analytics больше не должны опираться на жёстко зашитый 90/10 split: актуальны `protocolFeeReceiver`, mutable `PROTOCOL_FEE_BPS` и фактический amount, остающийся в vault.
-- Для service/backend use cases добавлена инъекция `fetchFn` и `webSocketCtor`, чтобы SDK не зависел жёстко от глобальных runtime объектов.
-
-## Что в старом плане устарело
-
-### Устаревшие статусы
-
-Следующие пункты были верны для прошлой версии SDK, но уже закрыты:
-
-- отсутствие `initiateCloseAdmin`
-- отсутствие `getAccountConfig`
-- отсутствие большинства admin setters в `VaultModule`
-- неполный `VaultStats`
-- отсутствие `isFundedAccount` и `getDelegateBuilder`
-
-### Устаревшие константы
-
-В старом плане были значения, которые больше не совпадают с текущими контрактами:
-
-- `MIN_PROFIT_BPS` указан как `150`, но в текущем `FundedAccount.sol` он равен `50`
-- важные экспортируемые значения нужно сверять с локальной Solidity, а не со старым plan draft
-
-### Необязательная рекомендация про отдельный `AdminModule`
-
-Идея отдельного `AdminModule` сама по себе нормальная, но сейчас это не must-have.
-Текущий `VaultModule` уже покрывает актуальный owner admin surface без архитектурного долга, который требовал бы срочного выделения нового модуля.
-
-## Что остаётся актуальным
-
-### Phase 2. Улучшения API и DX
-
-1. Выровнять числовую модель SDK для service use cases.
-Сейчас часть helper-ов (`fromUsdc`, `from8Dec`, `formatUsd`) переводит `bigint` в `number`, что удобно для UI, но не идеально для финансовой серверной логики.
-
-2. Выровнять timestamp-модель.
-Сейчас часть временных полей в `AccountDetails` хранится как `bigint`, часть как `number`. Лучше выбрать одну ясную стратегию API.
-
-3. Добавить типы для параметризуемого admin-конфига.
-Практичный следующий шаг:
-
-```ts
-export interface VaultParameters {
-  feeMultiplier: number;
-  subscriptionFeeMultiplier: number;
-  minBuilderShares: bigint;
-  builderLeverage: bigint;
-  protocolFeeBps: bigint;
-  minAccountSize: bigint;
-  maxAccountSize: bigint;
-  minDrawdownBps: number;
-  maxDrawdownBps: number;
-  maxUtilizationBps: bigint;
-  maxSingleAccountBps: bigint;
-  hypeForSpot: bigint;
-  maxCap: bigint;
-}
-```
-
-4. Добавить validation helpers поверх текущего `VaultStats`.
-Это уже полезный SDK-level слой, который не зависит от деплоя:
-
-```ts
-export function validateAccountSize(size: bigint, vaultStats: VaultStats): {
-  valid: boolean;
-  reason?: string;
-}
-
-export function validateDrawdownBps(bps: number, vaultStats: VaultStats): {
-  valid: boolean;
-  reason?: string;
-}
-
-export function canBuilderActivate(
-  builderInfo: BuilderInfo,
-  accountSize: bigint,
-  vaultStats: VaultStats
-): {
-  canActivate: boolean;
-  reason?: string;
-}
-```
-
-### Phase 3. Дополнительные helper-обёртки
-
-1. Batch reads:
-
-```ts
-async getMultipleLPPositions(addresses: Address[]): Promise<LPPosition[]>
-async getMultipleBuilderInfo(addresses: Address[]): Promise<BuilderInfo[]>
-async getMultipleAccountDetails(addresses: Address[]): Promise<AccountDetails[]>
-```
-
-2. Дополнительные indexer helpers:
-
-```ts
-async getEventsByDateRange(
-  accountAddress: Address,
-  fromDate: Date,
-  toDate: Date
-): Promise<GqlAccountEvent[]>
-
-async getCheckpointHistory(
-  accountAddress: Address,
-  limit?: number
-): Promise<GqlCheckpoint[]>
-```
-
-3. Higher-level admin ergonomics:
-
-- `getCurrentParameters()`
-- `validateParameters()`
-- опциональный bulk-update helper для owner workflows
-
-## Рекомендуемый следующий порядок работ
-
-1. Сначала привести numeric/timestamp API к более строгой и единообразной модели.
-2. Затем добавить validation helpers поверх уже актуального `VaultStats`.
-3. После этого расширять batch helpers и high-level admin ergonomics.
-
-## Проверка
-
-После последних изменений:
-
-- `npm run check` проходит
-- `npm run test:unit` проходит
-
-RPC/GraphQL-зависимые тесты не считаются источником истины, пока локальные контракты не задеплоены.