@affluent-org/sdk 0.0.1

package/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "es5",
+  "printWidth": 120,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/Refactoring.md

@@ -0,0 +1,548 @@
+# Factorial SDK Refactoring Plan
+
+## 현재 핵심 문제
+
+하나의 클래스/파일이 여러 성격의 책임을 동시에 지고 있다.
+
+| 파일 | 라인 수 | 섞여 있는 것 |
+|------|---------|-------------|
+| `contracts/vault/strategy-vault/index.ts` | 4,614 | Codec + Query + Action + Computation |
+| `pool.ts` | 2,895 | Query + Action + Oracle + Tracker + Flow |
+| `strategy_vault/base.ts` | 2,637 | Query + Action + Oracle + Computation |
+| `share-vault.ts` | 1,213 | Query + Action + Tracker + Flow |
+| `contracts/core/pool/index.ts` | 409 | Codec + Query + Action + Computation |
+
+---
+
+## 기능 레이어 정의
+
+SDK가 하는 모든 일은 다음 5개 레이어로 분류된다.
+
+```
+┌─────────────────────────────────────────────────┐
+│                     Flow                        │
+│          다단계 흐름 조율 (조합 레이어)              │
+├────────┬────────┬────────┬─────────────────────┤
+│ Query  │ Oracle │Compute │  Tracker            │
+│온체인   │외부     │로컬     │ 온체인              │
+│읽기    │데이터    │연산     │ 변화 감시           │
+├────────┴────────┴────────┴─────────────────────┤
+│                    Codec                        │
+│             Cell ↔ TS 양방향 변환                  │
+└─────────────────────────────────────────────────┘
+```
+
+| 레이어 | 정의 | I/O | 의존 |
+|--------|------|-----|------|
+| **Codec** | Cell ↔ TypeScript 객체 양방향 변환. 메시지 빌드(`create*MsgBody` → Cell) 포함 | 없음 | 없음 |
+| **Query** | 온체인 상태 읽기 (get method 호출) | provider | Codec |
+| **Oracle** | 외부 데이터 수집 (가격 피드 등) | 외부 API | Codec |
+| **Computation** | 이미 가져온 데이터로 로컬 계산 | 없음 | 없음 |
+| **Tracker** | 온체인 트랜잭션 전파 추적, 결과 대기 | provider | Codec |
+| **Flow** | 위 레이어들의 조합. 고수준 사용자 동작 단위 | 전부 | 전부 |
+
+> **Action 레이어 제거**: 기존에 Codec의 `create*MsgBody`(→ Cell)를 `{ to, value, body }` 로 감싸는 Action 레이어가 있었으나, 모든 함수가 동일한 래핑만 수행하므로 불필요한 추상화로 판단하여 제거. 호출하는 쪽(Flow 또는 사용자)에서 직접 조립한다:
+> ```ts
+> const body = createSetOwnerAddressMsgBody(newOwner);
+> await sender.send({ to: vault.address, value: toNano("0.1"), body });
+> ```
+
+---
+
+## 3레벨 아키텍처
+
+레이어를 분리하려면 **2분류(libs + services)로는 부족**하다. Query/Action이 두 수준에 걸쳐 있고, Oracle/Tracker는 특정 도메인에 속하지 않기 때문이다.
+
+| 레이어 | I/O | 범위 | 소속 레벨 |
+|--------|-----|------|----------|
+| Codec | 없음 | 컨트랙트별 | contracts/ |
+| Computation | 없음 | 컨트랙트별 + 범용 | contracts/ + core/ |
+| Query | provider | 컨트랙트별 | contracts/ |
+| Oracle | 외부 API | **도메인 횡단** | core/ |
+| Tracker | provider + 시간 | **도메인 횡단** | core/ |
+| Flow | 전부 | 도메인별 | services/ |
+
+### 3개 레벨 구조
+
+```
+┌──────────────────────────────────────────────┐
+│              services/ (도메인별)               │
+│  Flow: 고수준 API, 레이어 조합                   │
+│  pool/ share-vault/ strategy-vault/ rfq/     │
+├──────────────────────────────────────────────┤
+│              core/ (도메인 횡단)                │
+│  Oracle: 외부 데이터 수집                        │
+│  Tracker: Tx 추적, Step 실행                    │
+│  ContractOpener: 컨트랙트 열기 + 캐시            │
+│  Cache: TTL 캐시                               │
+│  RiskCalculator: 범용 Computation              │
+├──────────────────────────────────────────────┤
+│              contracts/ (컨트랙트별)             │
+│  Codec: Cell ↔ TS                             │
+│  Computation: 순수 계산                         │
+│  Query + Action: 단일 컨트랙트 get/send          │
+│  Constants, Types                             │
+└──────────────────────────────────────────────┘
+```
+
+### 의존 방향
+
+```
+services/ ──→ core/ ──→ contracts/
+    │                       ↑
+    └───────────────────────┘
+```
+
+**단방향만 허용.** contracts/가 core/나 services/를 import하면 안 된다. core/가 services/를 import하면 안 된다.
+
+---
+
+## 레벨 1: contracts/ — 컨트랙트별, 바닥 레이어
+
+### 역할
+
+한 컨트랙트의 인터페이스를 정의한다. **다른 컨트랙트를 모른다.**
+
+포함 레이어: Codec, Computation, Query(단일), Constants, Types
+
+### 레이어별 경계
+
+| 레이어 | 받는 것 | 반환하는 것 | 의존 |
+|--------|---------|-----------|------|
+| Codec | Cell/Slice 또는 TS 객체 | TS 객체 또는 Cell | 없음 |
+| Computation | TS 객체 (이미 파싱된 상태) | TS 객체 (계산 결과) | Codec의 타입만 |
+| Query | provider + 주소/파라미터 | 파싱된 TS 객체 | Codec (파싱에 사용) |
+
+### 파일 분리 구조
+
+```
+contracts/<domain>/<contract>/
+├── codec.ts          ← Codec: 직렬화 + 파싱 + DictionaryValues (Cell ↔ TS 전부)
+├── computation.ts    ← Computation: 시뮬레이션, Gas 계산, 상태 변환
+├── constants.ts      ← Op, ErrorCodes, Gas
+├── type.ts           ← 상태/설정 타입 정의
+└── index.ts          ← Contract 클래스 (Query만)
+```
+
+> **dictionary.ts 제거**: DictionaryValues는 codec.ts 안에 포함. 단순한 serialize/parse 리스트이므로 별도 파일 불필요.
+
+### index.ts (Contract 클래스)의 최종 역할
+
+- **Query**: `get*` 메서드 — provider를 통해 온체인 데이터를 읽고, `codec.ts`로 파싱하여 반환
+
+Contract 클래스가 Codec과 Computation을 **import해서 사용**하되 **소유하지 않는** 구조.
+
+메시지 빌드는 Codec의 `create*MsgBody` 함수를 직접 사용:
+```ts
+import { createDepositPayload } from "./codec";
+const body = createDepositPayload(responseAddress, oracleParams);
+await sender.send({ to: vault.address, value: toNano("0.5"), body });
+```
+
+### 적용 대상
+
+| 컨트랙트 | Codec 추출 대상 | Computation 추출 대상 |
+|---------|----------------|---------------------|
+| Pool | `parsePoolData`, `createSupplyPayload`, `createWithdrawMsgBody` 등 | `simulateAccrueInterest`, `calculateGasFee` |
+| Account | `parseAccountData`, `accountConfigToCell` | `convertShareToAmount`, `applyDelta`, `haveBorrow`, `haveAssets` |
+| ShareVault | `parseVaultData`, config 직렬화 | `calculateGasFee` |
+| StrategyVault | 4,614줄 중 대부분 — parse/create 전체 | Gas 계산, fee accrual |
+| RFQAuction | `parseRFQStorage`, 메시지 빌더 | `computeBidReserveFee`, `computeSellReserveFee` |
+| RFQBatch | `parseStorage`, 메시지 빌더 | `computeOrderReserveFee` |
+
+### _parse_temp 폴더 처리
+
+`utils/_parse_temp/` (5,343줄)의 파싱 로직을 각 Contract의 `codec.ts`로 흡수하고 폴더 삭제.
+
+### Tx 메시지 Codec
+
+현재 `utils/parser.ts`에 범용으로 존재하는 Tx 메시지 파싱을 Contract별 `codec.ts`로 분산하고, 범용 dispatch 함수만 남긴다.
+
+---
+
+## 레벨 2: core/ — 도메인 횡단, 중간 레이어
+
+### 역할
+
+여러 도메인이 공유하는 I/O 인프라를 제공한다. **특정 도메인에 속하지 않는다.**
+
+포함 레이어: Oracle, Tracker, ContractOpener, Cache, 범용 Computation
+
+### 레이어별 경계
+
+| 모듈 | 받는 것 | 반환하는 것 | 의존 |
+|------|---------|-----------|------|
+| Oracle | 자산 주소 목록 + oracle config | 가격 데이터, oracle params (Cell) | contracts/ Codec (Cell 빌드), 외부 API (Redstone) |
+| Tracker | provider + 탐색 조건 (주소, queryId, step 목록) | 발견된 트랜잭션, 완료 상태 | contracts/ Codec (tx 파싱), provider (폴링) |
+| ContractOpener | TonClient + Contract 클래스 + 주소 | OpenedContract (캐시된 인스턴스) | contracts/ (Contract 타입), Cache |
+| Cache | 캐시 키 + 값 | 캐시된 값 | 없음 |
+| RiskCalculator | 파싱된 account/pool 상태 + 가격 | risk ratio, max borrow/withdraw | contracts/ 타입만 |
+
+### 파일 구조
+
+```
+core/
+├── oracle/
+│   ├── redstone.ts              ← Redstone 연동
+│   ├── oracle-params.ts         ← oracle params 빌드 (현 oracle-v2.ts)
+│   └── type.ts                  ← AddressBucket, OracleParamsResult 등
+├── tracker/
+│   ├── tx-finder.ts             ← 트랜잭션 탐색 (현 utils/tracer.ts)
+│   ├── step-runner.ts           ← Step 순차 실행 + 콜백
+│   ├── seqno-waiter.ts          ← wallet seqno 폴링 대기
+│   └── type.ts                  ← TxStep, StepCallback 등
+├── contract-opener.ts           ← Contract 열기 + 캐시 (현 ServiceBaseV1.open/getByContract)
+├── cache.ts                     ← ContractCache + withCache (현 common/cache.ts)
+├── risk-calculator/             ← 범용 Computation (현 utils/risk_calculator/)
+└── type.ts                      ← 공용 타입 (Maybe, AddressLike, AddressInput)
+```
+
+### 현재 코드에서 추출할 위치
+
+| core/ 모듈 | 현재 위치 | 추출 방법 |
+|------------|----------|----------|
+| oracle | `oracle/oracle-v2.ts` + `PoolV1` 내 oracle 메서드 + `StrategyVaultBase` 내 oracle 메서드 | oracle-v2.ts를 core/로 이동, 서비스 내 인라인 oracle 로직을 core/oracle 호출로 교체 |
+| tracker | `PoolV1.findAndCallback` + `ShareVaultV1.buildSupplySteps/waitSupplyTx` + `StrategyVaultSteps.processingSteps` + `utils/tracer.ts` | 공통 패턴(step 빌드, step 실행, tx 탐색, polling)을 추출 |
+| contract-opener | `ServiceBaseV1.open()`, `getByContract()`, `contractCache` | ServiceBaseV1에서 분리, 주입 가능한 객체로 |
+| cache | `common/cache.ts` | 위치 이동 |
+| risk-calculator | `utils/risk_calculator/` | 위치 이동 |
+
+### ServiceBaseV1 해체
+
+현재 ServiceBaseV1이 제공하는 기능을 core/ 모듈로 분산:
+
+| 기능 | 현재 (ServiceBaseV1) | 변경 (core/) |
+|------|---------------------|-------------|
+| Contract 캐시 + 열기 | `open()`, `getByContract()` | `core/contract-opener.ts` |
+| 네트워크 설정 | `contracts`, `network` | 생성자 주입 설정 타입 |
+| Asset Type 캐시 | `static assetTypes` | `core/contract-opener.ts` 인스턴스 레벨 |
+| Wallet seqno 대기 | `waitWalletSeq()` | `core/tracker/seqno-waiter.ts` |
+| WTON 배포 | `deployWTONWallet()` | `services/` 레벨 Flow |
+
+---
+
+## 레벨 3: services/ — 도메인별, 최상위 레이어
+
+### 역할
+
+사용자가 호출하는 고수준 API를 제공한다. contracts/와 core/를 **조합**한다.
+
+포함 레이어: Flow (Query + Action + Oracle + Tracker 조합)
+
+### 레이어별 경계
+
+| 레이어 | 받는 것 | 반환하는 것 | 의존 |
+|--------|---------|-----------|------|
+| Flow | 사용자 파라미터 (sender, 금액, 주소 등) | 트랜잭션 결과, 추적 결과 | contracts/ (Query, Action, Codec) + core/ (Oracle, Tracker, ContractOpener) |
+
+**실제 전송은 Flow에서 발생:**
+```ts
+// services/pool/supply.ts (Flow)
+const body = createSupplyPayload(params);  // Codec: Cell 생성
+await sender.send({ to: pool.address, value: toNano("0.5"), body });  // Flow: 전송
+```
+
+### 서비스 내부 분리 판단
+
+서비스 내부를 더 쪼갤지는 **크기로 판단**한다.
+
+| 서비스 | 현재 크기 | 분리 여부 | 근거 |
+|--------|----------|----------|------|
+| Pool | 2,895줄 | 분리 필요 | supply/withdraw/borrow/repay/liquidate 5개 도메인 액션 + 가격/리스크 조회 |
+| ShareVault | 1,213줄 | 분리 필요 | 버전 분기(V1/V2) + 매니저 액션 |
+| StrategyVault | 2,637 + 498줄 | 분리 필요 | deposit/withdraw/queue/owner/config 5개 도메인 액션 |
+| RFQAuction | 작음 | 단일 파일 | Flow가 단순 |
+| RFQBatch | 작음 | 단일 파일 | Flow가 단순 |
+
+### 큰 서비스 분리 구조
+
+```
+services/<domain>/
+├── index.ts          ← Flow: 고수준 API (조합 포인트)
+├── supply.ts         ← Flow: supply 흐름 (Action + Tracker 조합)
+├── withdraw.ts       ← Flow: withdraw 흐름
+├── ...               ← 도메인별 추가 흐름
+└── queries.ts        ← 서비스 레벨 조회 (여러 contracts/ Query 조합)
+```
+
+각 파일 내부에서 contracts/와 core/를 import해서 조합한다. **파일 간 import는 index.ts를 통해서만.**
+
+### 조합 예시: supply 흐름의 의존 관계
+
+```
+services/pool/supply.ts (Flow)
+  ├── contracts/jetton/         Query: wallet 주소 조회
+  ├── contracts/core/pool/      Query: pool 데이터, Codec: supply Cell 빌드, Computation: gas 계산
+  ├── contracts/core/account/   Query: account 주소
+  ├── core/oracle/              Oracle: 가격 데이터 수집
+  ├── core/tracker/             Tracker: tx 추적, step 실행
+  └── sender.send()             Flow에서 직접 전송 (Codec은 Cell만 생성)
+```
+
+### 작은 서비스 단일 파일 구조
+
+```
+services/rfq-auction/
+└── index.ts          ← Flow + 조회 전부 포함
+```
+
+---
+
+## 반복 패턴 추출
+
+3회 이상 반복이 확인된 패턴만 추출한다.
+
+### Dictionary → Record 변환 (5회 반복)
+
+Pool, Account, ShareVault, StrategyVault, RFQBatch에서 동일한 Dictionary → Record 변환 패턴 반복.
+`contracts/` 레벨 공통 Codec 유틸로 추출.
+
+### 트랜잭션 Step 빌드 + 실행 (3회 반복)
+
+PoolV1, ShareVaultV1, StrategyVaultSteps에서 동일한 step 배열 빌드 → 순차 실행 → 콜백 패턴 반복.
+`core/tracker/step-runner.ts`로 추출.
+
+### ~~Message 빌더 반환 타입 (10회+ 반복)~~ → 제거됨
+
+Action 레이어를 제거했으므로 `TxMessage` 래핑 패턴도 불필요. Codec이 `Cell`을 반환하고, 호출 측에서 `{ to, value, body }` 인라인 조립.
+
+### Address 변환 (4회 반복)
+
+`toAddress()` 헬퍼가 `contracts/common/utils.ts`, `pool.ts`, `share-vault.ts`, `strategy_vault/base.ts`에 중복.
+`core/type.ts`로 통합.
+
+---
+
+## 타입 정리
+
+### 중복 타입 통합
+
+| 타입 | 중복 위치 | 통합 위치 |
+|------|----------|----------|
+| `Maybe<T>` | `types/pool.ts`, `contracts/common/type.ts` | `core/type.ts` |
+| `AddressLike` | `contracts/common/type.ts`, 여러 파일 인라인 | `core/type.ts` |
+
+### 대형 Config 타입 분할
+
+`StrategyVaultConfig` (50+ 필드)를 논리적 하위 타입으로 분할: Ownership, State, FeeConfig, QueueConfig 등.
+
+### Cell | ParsedType 모호성 해결
+
+`irmConfig: Cell | JumpIRMConfig` 같은 union을 Raw 타입과 Parsed 타입으로 명확히 분리.
+
+### 네이밍 규칙 확립
+
+| 접미사 | 의미 |
+|--------|------|
+| `*Payload` | Jetton forward에 실리는 데이터 (Codec 산출물) |
+| `*MsgBody` | 직접 전송하는 메시지 본문 (Codec 산출물) |
+| `*Params` | SDK 함수에 전달하는 TypeScript 파라미터 (Codec 입력) |
+
+### 오타 수정
+
+- `TansferOutActionParams` → `TransferOutActionParams`
+- `traceActionNotificaitonTx` → `traceActionNotificationTx`
+- `LiquidateionNotificationFee` → `LiquidationNotificationFee`
+
+---
+
+## 정리 작업
+
+- `utils/_parse_temp/` 폴더 삭제 (contracts/ codec.ts로 흡수 완료)
+- console.log 제거 (`utils/parser.ts`, `share-vault.ts`)
+- 주석 처리된 dead code 제거 (`utils/parser.ts`, `share-vault.ts`)
+
+---
+
+## 최종 디렉토리 구조
+
+```
+src/
+├── contracts/                           ← 레벨 1: 컨트랙트별 (다른 컨트랙트를 모름)
+│   ├── core/
+│   │   ├── pool/
+│   │   │   ├── codec.ts               ← Codec + DictionaryValues
+│   │   │   ├── computation.ts          ← Computation: 시뮬레이션, Gas
+│   │   │   ├── constants.ts            ← Op, ErrorCodes, Gas
+│   │   │   ├── type.ts                 ← 타입 정의
+│   │   │   └── index.ts               ← Contract 클래스 (Query)
+│   │   └── account/
+│   │       ├── codec.ts
+│   │       ├── computation.ts          ← 지분 변환, delta
+│   │       ├── constants.ts
+│   │       ├── type.ts
+│   │       └── index.ts
+│   ├── vault/
+│   │   ├── share-vault/
+│   │   │   ├── codec.ts               ← Codec + DictionaryValues
+│   │   │   ├── computation.ts
+│   │   │   ├── constants.ts
+│   │   │   ├── type.ts
+│   │   │   └── index.ts
+│   │   └── strategy-vault/            ← ✅ codec 분리 완료
+│   │       ├── codec.ts               ← Codec + DictionaryValues (#region 섹션)
+│   │       ├── computation.ts
+│   │       ├── constants.ts
+│   │       ├── type.ts                 ← 분할된 Config 하위 타입
+│   │       └── index.ts
+│   ├── rfq/
+│   │   ├── auction/                    ← 동일 구조
+│   │   ├── batch/
+│   │   └── event-emitter/
+│   ├── jetton/
+│   ├── factory/
+│   └── wton/
+│
+├── core/                                ← 레벨 2: 도메인 횡단 (특정 도메인에 속하지 않음)
+│   ├── oracle/
+│   │   ├── redstone.ts                 ← Redstone 연동
+│   │   ├── oracle-params.ts            ← oracle params 빌드
+│   │   └── type.ts
+│   ├── tracker/
+│   │   ├── tx-finder.ts               ← 트랜잭션 탐색
+│   │   ├── step-runner.ts             ← Step 순차 실행 + 콜백
+│   │   ├── seqno-waiter.ts            ← wallet seqno 폴링 대기
+│   │   └── type.ts                    ← TxStep, StepCallback 등
+│   ├── risk-calculator/                ← 범용 Computation
+│   ├── contract-opener.ts             ← Contract 열기 + 캐시
+│   ├── cache.ts                        ← ContractCache + withCache
+│   └── type.ts                         ← Maybe, AddressLike, toAddress
+│
+├── services/                            ← 레벨 3: 도메인별 (contracts/ + core/ 조합)
+│   ├── pool/
+│   │   ├── index.ts                    ← Flow: 고수준 API
+│   │   ├── supply.ts                   ← Flow: supply 흐름
+│   │   ├── withdraw.ts                 ← Flow: withdraw 흐름
+│   │   ├── borrow.ts                   ← Flow: borrow 흐름
+│   │   ├── repay.ts                    ← Flow: repay 흐름
+│   │   ├── liquidate.ts               ← Flow: liquidate 흐름
+│   │   └── queries.ts                 ← 서비스 레벨 조회 (가격, 리스크 등)
+│   ├── share-vault/
+│   │   ├── index.ts                    ← Flow
+│   │   ├── supply.ts
+│   │   ├── withdraw.ts
+│   │   ├── manage.ts                  ← 매니저 액션 (supplyToPool, withdrawFromPool, setTargetWeight)
+│   │   └── queries.ts
+│   ├── strategy-vault/
+│   │   ├── index.ts                    ← Flow
+│   │   ├── deposit.ts
+│   │   ├── withdraw.ts
+│   │   ├── queue.ts                   ← deposit/withdraw queue
+│   │   ├── owner.ts                   ← owner/guardian/manager 설정
+│   │   └── queries.ts
+│   ├── rfq-auction/
+│   │   └── index.ts                    ← Flow (단일 파일)
+│   └── rfq-batch/
+│       └── index.ts                    ← Flow (단일 파일)
+│
+├── types/                               ← 공개 타입
+├── constants/                           ← 전역 상수
+├── _compiled/                           ← 컴파일된 바이너리
+└── index.ts                             ← 배럴 export
+```
+
+---
+
+## 실행 순서
+
+| 순서 | 내용 | 대상 레벨 | 상태 |
+|------|------|----------|------|
+| 1 | 정리 (console.log, dead code, 오타) | 전체 | |
+| 2 | 타입 중복 제거, 네이밍 정리 | 전체 | |
+| 3 | contracts/ Codec 분리 | contracts/ | **strategy-vault ✅** |
+| 4 | contracts/ Computation 분리 | contracts/ | |
+| 5 | contracts/ index.ts 정리 (Query만 잔류) | contracts/ | |
+| 6 | core/ 모듈 추출 (Oracle, Tracker, ContractOpener) | core/ | |
+| 7 | services/ 재구성 (상속 제거, Flow 조합) | services/ | |
+
+아래에서 위로. contracts/ (I/O 없는 Codec, Computation) → core/ (도메인 횡단 인프라) → services/ (Flow 조합).
+
+---
+
+## 진행 기록
+
+### strategy-vault Codec 분리 (완료)
+
+**변경 내용:**
+- 28개 파일 (`codec/` 디렉토리) + `parser.ts` + `dictionary.ts` → 단일 `codec.ts`로 병합 (~1270줄)
+- `#region` 섹션으로 구분: Dictionary Values, Storage, Utility, Message-Owner, Message-Manager, Message-User
+- `action/` 디렉토리 전체 삭제 — `{ to, value, body }` 래핑만 하는 함수들은 불필요한 추상화
+- `serializer.ts` (레거시) 삭제
+
+**결과 구조:**
+```
+contracts/vault/strategy-vault/
+├── codec.ts       ← 1270줄, #region 섹션
+├── constants.ts
+├── type.ts
+└── index.ts       ← StrategyVault 클래스 (Query + static re-exports)
+```
+
+**설계 판단:**
+- codec은 단순 serialize/parse 리스트이므로 파일이 길어도 문제 없음. 한번 만들면 고정이고, 수정해도 단일 액션
+- 파일 분할 기준은 "독립적으로 변경 가능한 단위"이지 "줄 수"가 아님
+- DictionaryValues도 codec 안에 포함 — 별도 파일 불필요
+
+---
+
+### CompositeOracle 리팩토링 (완료)
+
+**문제점:**
+- `strategy-vault/oracle.ts`에 가격 계산 로직이 중복 존재 (487줄)
+- `composite-oracle/`와 동일한 가격 계산 함수들이 분산되어 있음
+- `getOracleParams`(온체인 Cell 생성)와 `CompositeOracle`(오프체인 가격 계산)이 같은 데이터를 각각 따로 fetch
+
+**핵심 원칙: I/O와 Computation 분리**
+```
+┌─────────────────────────────────────────────────────────┐
+│                    services/ 레이어                      │
+├─────────────────────────────────────────────────────────┤
+│  CompositeOracle (가격 계산)   StrategyVault (트랜잭션)    │
+│         │                           │                    │
+│         ▼                           ▼                    │
+│  ┌─────────────────────────────────────────────┐        │
+│  │           getOracleContext()                │        │
+│  │         (공유 데이터 fetch)                  │        │
+│  └─────────────────────────────────────────────┘        │
+│         │                           │                    │
+│         ▼                           ▼                    │
+│   compute() ← 순수 함수       getOracleParamsV2()        │
+│   (가격 계산)                  (Cell 생성)                │
+└─────────────────────────────────────────────────────────┘
+```
+
+**변경 내용:**
+
+1. **getOracleContext() 공유 메서드 생성** (`composite-oracle/fetcher.ts`)
+   - vault 데이터, oracle config, 자산 목록, 포지션 등을 한 번에 fetch
+   - On-chain Cell 생성과 Off-chain 가격 계산 모두 동일 context 사용
+
+2. **strategy-vault/oracle.ts 대폭 축소** (487줄 → 107줄)
+   - 중복된 가격 계산 함수 모두 제거: `getAssetPrice`, `calcVaultPrice`, `computeAssetPrices` 등
+   - `getOracleParamsV2`만 남김 — CompositeOracle의 `getOracleContext()` 사용
+
+3. **StrategyVaultV1 가격 메서드 위임** (`services/strategy-vault/index.ts`)
+   - `getVaultPrice()`, `getTotalValue()`, `getAllAssetPrices()` → CompositeOracle 호출로 변경
+
+**결과 구조:**
+```
+services/
+├── composite-oracle/
+│   ├── fetcher.ts        ← getOracleContext() 공유 메서드 추가
+│   ├── computation.ts    ← 순수 가격 계산 (I/O 없음)
+│   └── index.ts          ← fetchAll(), compute(), static helpers
+├── strategy-vault/
+│   ├── oracle.ts         ← 107줄로 축소 (getOracleParamsV2만)
+│   └── index.ts          ← 가격 메서드는 CompositeOracle 위임
+```
+
+**설계 판단:**
+- **"Fetch once, compute multiple times"**: 데이터는 한 번만 fetch하고, 계산은 여러 번 재사용
+- **On-chain vs Off-chain 분리**:
+  - On-chain: `getOracleParamsV2()` → Cell 생성 (트랜잭션에 사용)
+  - Off-chain: `compute()` → 가격 계산 (조회에 사용)
+- **Static 메서드 제공**: 캐시된 input으로 재계산 가능 (`getVaultPriceFromInput`, `getTotalValueFromInput`)
+
+**테스트 결과:**
+- mainnet 테스트 7개 항목 모두 통과
+- fork 테스트 9개 항목 모두 통과

package/dist/_compiled/Account.compiled.json

@@ -0,0 +1 @@
+{ "hash": "e51ae1b702b6dc0109637ce2802a1d0df407f55b9bb5500828f4eb1f43b78952", "hashBase64": "5RrhtwK23AEJY3zigCodDfQH9VubtVAIKPTrH0O3iVI=", "hex": "b5ee9c7241023701000d94000114ff00f4a413f4bcf2c80b0102016202360202c803130201200410020120050b03f3d7b68bb7ec831c02497c13816a840b434c0c05c6c30006497c0f83e900c3c248074c7c04074cfc0448860840af84b4deeb8c00860840717b870eea3888c7e1044f1c17cb8fa3d013e900c3e10d63c11fe18fc24c0a0822625a02d8244bc0ef80860841c825ff8aeb8c08d2084310ac264aeb8c097c0e103fcbc206080a01fcf8415240c705f2e3e802db3c2020d749d719fa40d31f0101d3270143306c1332208210ee555a2cba9c3032333302f180a1da40db31e002d4238210cb03bfafba9d333334344330f1809fda50db31e0238210cfc248e4ba9d333334344330f180a0da50db31e0038210cc52bae3ba9c3334344330f180a2da50db31e05b02070048d5d31301f866d30d01f867d31301f868d30d01f869d30d01f86ad30d01f86bf40430f86c019831f84113c705f2e3e8d2000101fa40fa00fa4030f8445d53210181010bf40a6fa194fa00307193307020e23001a1c801fa020281010bf441f86403915be30ef093028208989680b60912f03b0900b86d5953210181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e23058a0c8595920c1001201ca0001b60bfa020120c1001201ca0001b60bfa020281010bf441f84301f047f863004cf8438210134a41e9c8cb1f14cb3f13cc22c700b39458cf16019132e27002c912f0378040fb000201580c0d0029fe4400c00e582a801e78b00fd0100b8ac65b56664c0201480e0f002b5c8801801cb055003cf1601fa027001cb6a01cf17c9800615f8276f223021bc8e2372fb02708010c8cb0558cf1621fa02cb6a8210d53276db5802cb1fcb3fc9810082fb00925f03e28020162111200c9f90408085fa4137d28948472aa99880c08085fa0537d0cc7d007d002cb60938ca18382980711801690000d5005200fd00015400e90000d5005200fd000154091909502cd011081aace42cacfd0100fd0101408085fa20a90980c08085fa3a37d289742f81c0099d90408085fa4137d28948471efd001809b812012e80c08085fa0537d0cc7d007d002cb60938ca18382980711801d02cd0642cacfd0100fd0101408085fa20a90980c08085fa3a37d289742f81c020148141c0201581518020166161700313b51343e90007e187e90007e18bd01007e18fd01007e19346000293e113e10f23e1073c5be10b3c5bd003d00327b55200191ff6d176fd916ba66829a1f6a276a2f6a3c71218e46587e480c10815f0969be4658f89e59fe600e78b7c20b8016489781bc0207d806d98f6b3f6b2f6b2393ff688c576a0f6f880f97fc1902fefa40d2000101fa00fa40fa40fa00f40455605f0433f84c22db3cf2e3e9f8235006a1810258b9f2e3fa5004018e125210206f1620c000915b96016f1459a984e28e135210206f1420c000915b96016f1659a984e201e230f843230181010bf40a6fa198fa00fa00596c12719430705300e231f2e3ee21bef2e3ee6d21a34140301a02fe53210181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e23002a001c8595920c1001201ca0001b60bfa020120c1001201ca0001b60bfa020281010bf441f843f844f048f84c40132370db3cf8465004bef2e3fdf84758bef2e3fc01bef2e3eff84301f047f863f093281b0142db3c0182102be12d37c8cb1f13cb3fcc01cf16f8417002c912f0378040fb00db31250201ce1d260201201e2201913b68bb7ec8b5d33414d0fb513b517b51e3890c7232c3f24060840af84b4df232c7c4f2cff30073c5be105c00b244bc0de0103ec036cc7b59fb597b591c9ffb4462bb507b7c407cbfe01f02b4fa40d2000101fa00fa40fa40fa00f40455605f0433f84c22db3cf2e3e9f8235006a1810258b9f2e3fa5004018e125210206f1720c000915b96016f1559a984e28e135210206f1520c000915b96016f1759a984e201e2306d5331302002f453210181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e23058a0c8595920c1001201ca0001b60bfa020120c1001201ca0001b60bfa020281010bf441f843f844f048f84c03414470db3cf8465004bef2e3fdf84758bef2e3fc01bef2e3eff8445410222821018c53210181010bf40a6fa194fa00307193307020e23001a0c801fa020281010bf441f864f093db3c0182102be12d37c8cb1f13cb3fcc01cf16f8417002c912f0378040fb00db312502d73b68bb7ec84835d275c67e9034c7c04074c9c050cc00fe903e903e8015480cc411440d161b10be1308b6cf14d97b513b517b51e3890c7232c3f24060840af84b4df232c7c4f2cff30073c5be105c00b244bc0de0103ec036cc7b59fb597b591c9ffb4462bb507b7c407cbfe030230186f2e3e9f8235004a1810258b9f2e3fa58206f1520c000915b96016f1759a984e2f843220181010bf40a6fa198fa00fa00596c12719430705300e23031b6086d21a341302401fa53210181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e23058a0c8595920c1001201ca0001b60bfa020120c1001201ca0001b60bfa020281010bf441f84301f047f863f093db3c0182102be12d37c8cb1f13cb3fcc01cf16f8417002c912f0378040fb00db3125001070c8cb0f01fa02c904f74eda2edfb2220d749d719fa40d31f0101d32701433003fa40fa40fa0055203310451034586c4224d74cd0fa4031fa0031f40431fa4030f84c23db3cf84c23db3c53a9ed44ed45ed478e2431c8cb0fc90182102be12d37c8cb1f13cb3fcc01cf16f8417002c912f0378040fb00db31ed67ed65ed64727fed118aed4183030273502fef8235009a1810258b9f2e3fa01f2e3e906f2e3e9f84cf8436d52707fdb3cf848c2008e13f8495003b9f8485004b913b15222b9b1f2e3f29d33f84958b95213b912b1f2e3f2e25232206f1520c000915b96016f1759a984e253540181010bf40a6fa13051630181010bf40a6fa13006fa003006fa0030541466a984266f1c21283102f65413346d2181010bf4826fa512908ee3fa00fa00fa00fa00d2000101d30d0101d30d016f00706f8c706f8c706f8c706f8c50086f8c50066f8c50046f8c586f8c706f8c706f8c706f8c586f8c50036f8c586f8c706f8c3153510181010bf40a6fa198fa00fa00596c12719430705300e2305363e810255f05542003292b01f40181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e2955033a002a0915be221c20021c200b18e365112206f1620c000915b96016f1459a984e202206f1720c000915b96016f1559a984e222103459c85959fa0201fa020281010bf44101925f03e252202a00120181010bf4746fa51202906d93236eb38e8d2381010bf4826fa512908ae85be86c317054700181010bf4826fa512908ae85b6c3321c0009530705202138e135321a12381271022a984128127105003a9845ae22c2f02f6fa00fa00593253520181010bf40a6fa15363b1c3009420f2e3f0de8f46543431245d0181010bf40a6fa198fa00fa00596c12719430705300e23003a059a0c85959fa0201fa020281010bf44104fa00d307593120c0018e88c002925f03e30d04e30d04925f03e251440181010bf4593052050181010bf4746fa5122d2e00fcfa40fa40fa00fa00fa00554035547514a984527326a984103c44405d0181010bf40a6fa198fa00fa00596c12719430705300e23003a059a0c85959fa0201fa020281010bf441543312a9844414a9841347705d0181010bf40a6fa198fa00fa00596c12719430705300e23003a059a0c85959fa0201fa020281010bf44104008230fa40fa00fa00552033543332a9844434a9841037125d0181010bf40a6fa198fa00fa00596c12719430705300e23003a059a0c85959fa0201fa020281010bf44101d45371db3c3053720181010bf40a6fa130fa00d307593203fa00fa00593224821005f5e100a98404821005f5e100a98401c0009d216f1d945162a006de5155a005de216f1d9e12a1b60b016f1b812710a98412a09a326f1b812710a98412a0e252420181010bf4746fa5123000ae0181010bf40a6fa1b394306f0070e0fa00fa00fa00fa00d2000101d30d0101d30d016f00706f8c706f8c706f8c706f8c50086f8c50066f8c50046f8c586f8c706f8c706f8c706f8c586f8c50036f8c586f8c706f8c317101fc812710a984a05207206f1420c000915b96016f1659a984e2f843250181010bf40a6fa198fa00fa00596c12719430705300e23031f843240181010bf40a6fa198fa00fa00596c12719430705300e25b5115bef2e3ee21bef2e3ee5065821005f5e100a9848127105806a984f84a21bbf2e3fef84b01bef2e3fe6d21a341303201ae53210181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e23058a0c8595920c1001201ca0001b60bfa020120c1001201ca0001b60bfa020281010bf44122a341403301fc53210181010bf40a6fa1b394307053008e1bd20001aa00a401fa0002a801d20001aa00a401fa0002a8126c1271e23002a001c8595920c1001201ca0001b60bfa020120c1001201ca0001b60bfa020281010bf441f84301f047f863f093db3c0182102be12d37c8cb1f13cb3fcc01cf16f8417002c912f0378040fb00db3134001670c8cb0f58fa0201fa02c9000aedf101f2ff0019a0a273e125f083f085f087f089006cfeb4" }

package/dist/_compiled/Receipt.compiled.json

@@ -0,0 +1 @@
+{ "hash": "1848df7451c2db0eb21df991fd59707c6334871cf9a41409b18dbc541682ceb0", "hashBase64": "GEjfdFHC2w6yHfmR/VlwfGM0hxz5pBQJsY28VBaCzrA=", "hex": "b5ee9c724102110100027e000114ff00f4a413f4bcf2c80b0102016202100202c9030b0201200408029fd4831c02497c1383c0cbb51341bc03e18be903e903e803e1094011be33e18be10961be33e18be10805be33e18b4485bc52456f8085bc5a0824e8f29aeb8c0885bc5a0842b9fc9deaeb8c096e103fcbc2050701fc216f15f8426f10c705f2e3e8f8426f10f04702fa40fa40fa00f40430266f13aa0022a082100bebc200a08208989680a0276f1121b9f2d3eaf8426f1217a120c101f2d3eec882093a3ca6f8416f1702cb1fcb3ff8426f10cf1651511057473401f0488208989680046f1214b60972fb02f8426f1103c94330f03c8306fb00060044f84201216f1201a0726f85f862f842c8216f10cf16216f11cf16016f12fa02c9ed540086216f15f8426f11c705f2e3e8fa40fa0030f84201216f1201a1726f85f862f842c8216f10cf16216f11cf16016f12fa02c9ed54216f178208989680036f1213b609f04b020158090a00a5b4bb4205a1a607f481f48063f40063e803f40063f40002e1f0746204e3618002412c070041ae4207bc07a63e0203a67e0224de00a012df18a00edf18a00adf18b0df18b0df1802df18b0df18b0df1841f0c2030029b991003003960aa0079e2c03f40402e2b196d599930201620c0d004bf80ea00eb9c80e983817971f5e001f971f66a69ff980180c08085fa0537d0f971f6fd00180940201480e0f002d4c85003cf1601fa02f400c95034cbff01fa0201cf16cc800615f8276f223021bc8e2372fb02708010c8cb0558cf1621fa02cb6a82107d7aec1d5802cb1fcb3fc9810082fb00925f03e280065a0a8d5da89a0de01f0c5f481f481f401f084a008df19f0c5f084b0df19f0c5f08402df19f0c5a3f084de21f084de23f084de25313d8fa8" }

package/dist/_compiled/WTONWallet.compiled.json

@@ -0,0 +1 @@
+{ "hash": "5984ead868e5af89236aea0594d4f6015ed93330de80792d94bf6abe2eb58656", "hashBase64": "WYTq2Gjlr4kjauoFlNT2AV7ZMzDegHktlL9qvi61hlY=", "hex": "b5ee9c7241021301000325000114ff00f4a413f4bcf2c80b0102016202120202cb030f0201200407020148050600d743322c700925f03e0d0d3030171b0925f03e0fa40fa4031fa003171d721fa0031fa003073a9b40003d31f012082100f8a7ea5ba95305023f00de0208210178d4519ba95304133f00fe020821005db0ab7ba95304133f010e08210595f07bcba945023f011e05f04840ff2f0800114fa4430c000f2e14d8020158080a01f7503d33f0101fa00fa4021f00282017b02ed43d8522ac705f2e2c144087054201354140333c858cf1601cf16ccc922c8cb0112f400f400cb00c920f9007074c8cb02ca07cbffc9d002fa40f40431fa0020d749c200f2e2c42191729171e25372a00ca81ba082098cba80a05008b6095144bcf2e2c577c8801801cb0580900665004cf165004fa0212cb6bccc88210178d451901cb1f500401cb3f58fa025004cf165003cf1601fa0258cf16c901ccc971fb000201200b0e01b33e903e802082319750096806284865948668062841e44e3889f0803cb8b148254c040d5b1078c34835c2c070c008f0802c23889c3220040072c15633c59400fe8084b2daa084354c9db6c072c7c04072cff25cbec02497c0f8a00c01b86d27d2000193d430d0de7f21d749c0178e3901d70b1682087fff61ba8e2c5b70c8821090d0a42f01cb1f2601cb3f5352a0fa0224cf16c971c8801001cb0529cf165374a0fa02cb6acc01de9131e2951027365f04e30d01c971fb00010d005e30c882107362d09c01cb1f2501cb3f5004fa0258cf165005cf16c971c8801001cb055005cf1658fa0213cb6a12cc01009b20805ec0bb50f60cc1b4cfc0407e803e901510699c150804d50500ccf21633c58073c5b33248b232c044bd003d0032c0327e401c1d3232c0b281f2fff2741401f1c17cb8b0c41180d155413c03a00201ce1011003520805ec0bb50f60408d7c0c134cfc0407e800411840d504c3c03a000af0c60805ec0bb50f616c134cfc0407e803e900c1499b1c17cb8b0608231975014012808e804a870803cb8b17220842434290bc072c7c04072cfc87e809400f3c5b25c7220040072c15400f3c59400fe80b2dab3325c7ec0200023a0f605da89a1f481f481a861f04ede20aa41382cdc56" }

package/dist/_compiled/index.d.ts

@@ -0,0 +1,4 @@
+import AccountCompiled from "./Account.compiled.json";
+import WTONWalletCompiled from "./WTONWallet.compiled.json";
+import RecipientCompiled from "./Receipt.compiled.json";
+export { AccountCompiled, WTONWalletCompiled, RecipientCompiled };

package/dist/_compiled/index.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecipientCompiled = exports.WTONWalletCompiled = exports.AccountCompiled = void 0;
+const Account_compiled_json_1 = __importDefault(require("./Account.compiled.json"));
+exports.AccountCompiled = Account_compiled_json_1.default;
+const WTONWallet_compiled_json_1 = __importDefault(require("./WTONWallet.compiled.json"));
+exports.WTONWalletCompiled = WTONWallet_compiled_json_1.default;
+const Receipt_compiled_json_1 = __importDefault(require("./Receipt.compiled.json"));
+exports.RecipientCompiled = Receipt_compiled_json_1.default;

package/dist/affluent.d.ts

@@ -0,0 +1,14 @@
+import { PoolServiceV1 as PoolV1 } from "./services/pool";
+import { ShareVaultServiceV1 as ShareVaultV1 } from "./services/share-vault";
+import { StrategyVaultV1 } from "./services/strategy-vault";
+import { RFQAuctionServiceV1 } from "./services/rfq-auction";
+import { RFQBatchServiceV1 } from "./services/rfq-batch";
+export { PoolV1, ShareVaultV1, StrategyVaultV1, RFQAuctionServiceV1 as RFQAuctionV1, RFQBatchServiceV1 as RFQBatchV1 };
+declare const _default: {
+    PoolV1: typeof PoolV1;
+    ShareVaultV1: typeof ShareVaultV1;
+    StrategyVaultV1: typeof StrategyVaultV1;
+    RFQAuctionV1: typeof RFQAuctionServiceV1;
+    RFQBatchV1: typeof RFQBatchServiceV1;
+};
+export default _default;

package/dist/affluent.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RFQBatchV1 = exports.RFQAuctionV1 = exports.StrategyVaultV1 = exports.ShareVaultV1 = exports.PoolV1 = void 0;
+const pool_1 = require("./services/pool");
+Object.defineProperty(exports, "PoolV1", { enumerable: true, get: function () { return pool_1.PoolServiceV1; } });
+const share_vault_1 = require("./services/share-vault");
+Object.defineProperty(exports, "ShareVaultV1", { enumerable: true, get: function () { return share_vault_1.ShareVaultServiceV1; } });
+const strategy_vault_1 = require("./services/strategy-vault");
+Object.defineProperty(exports, "StrategyVaultV1", { enumerable: true, get: function () { return strategy_vault_1.StrategyVaultV1; } });
+const rfq_auction_1 = require("./services/rfq-auction");
+Object.defineProperty(exports, "RFQAuctionV1", { enumerable: true, get: function () { return rfq_auction_1.RFQAuctionServiceV1; } });
+const rfq_batch_1 = require("./services/rfq-batch");
+Object.defineProperty(exports, "RFQBatchV1", { enumerable: true, get: function () { return rfq_batch_1.RFQBatchServiceV1; } });
+exports.default = {
+    PoolV1: pool_1.PoolServiceV1,
+    ShareVaultV1: share_vault_1.ShareVaultServiceV1,
+    StrategyVaultV1: strategy_vault_1.StrategyVaultV1,
+    RFQAuctionV1: rfq_auction_1.RFQAuctionServiceV1,
+    RFQBatchV1: rfq_batch_1.RFQBatchServiceV1,
+};

package/dist/constants/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const ONE_PERCENT_IR_PER_SEC: bigint;
+export declare const PERCENT_BIT = 14;

package/dist/constants/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERCENT_BIT = exports.ONE_PERCENT_IR_PER_SEC = void 0;
+exports.ONE_PERCENT_IR_PER_SEC = 10n ** 36n / 100n / 3600n / 24n / 365n;
+exports.PERCENT_BIT = 14;