@kehtus/proportion-sdk 0.1.1 → 0.1.2

package/dist/constants.d.ts

@@ -19,9 +19,9 @@ export declare const hyperEvm: {
     };
 };
 export declare const ADDRESSES: {
-    readonly MAIN_VAULT: "0xA89F85eC9350e64295B199ee8011454d891e19B1";
-    readonly FACTORY: "0xE056F0D2A476CCd9A24230C7DB7c9d6AF44a0161";
-    readonly FORWARDER: "0x4fDc2489dE19BECC9FAeA59672F377bf740E4ecF";
+    readonly MAIN_VAULT: "0x3A8cD3feb02959B2AB622Fcebe40A477c73f9488";
+    readonly FACTORY: "0x04B71DC7414Bfa940D1c11f839011B6a11031D2E";
+    readonly FORWARDER: "0x5961880B2C461F9733EC71720528461840881f4E";
     readonly USDC: "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
 };
 export declare const BPS = 10000n;

package/dist/constants.js

@@ -9,9 +9,9 @@ export const hyperEvm = {
     },
 };
 export const ADDRESSES = {
-    MAIN_VAULT: "0xA89F85eC9350e64295B199ee8011454d891e19B1",
-    FACTORY: "0xE056F0D2A476CCd9A24230C7DB7c9d6AF44a0161",
-    FORWARDER: "0x4fDc2489dE19BECC9FAeA59672F377bf740E4ecF",
+    MAIN_VAULT: "0x3A8cD3feb02959B2AB622Fcebe40A477c73f9488",
+    FACTORY: "0x04B71DC7414Bfa940D1c11f839011B6a11031D2E",
+    FORWARDER: "0x5961880B2C461F9733EC71720528461840881f4E",
     USDC: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
 };
 // BPS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kehtus/proportion-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/constants.ts

@@ -13,9 +13,9 @@ export const hyperEvm = {
 } as const satisfies Chain;
 
 export const ADDRESSES = {
-  MAIN_VAULT: "0xA89F85eC9350e64295B199ee8011454d891e19B1",
-  FACTORY: "0xE056F0D2A476CCd9A24230C7DB7c9d6AF44a0161",
-  FORWARDER: "0x4fDc2489dE19BECC9FAeA59672F377bf740E4ecF",
+  MAIN_VAULT: "0x3A8cD3feb02959B2AB622Fcebe40A477c73f9488",
+  FACTORY: "0x04B71DC7414Bfa940D1c11f839011B6a11031D2E",
+  FORWARDER: "0x5961880B2C461F9733EC71720528461840881f4E",
   USDC: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
 } as const;
 

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-зависимые тесты не считаются источником истины, пока локальные контракты не задеплоены.