Legacy와 v1

​

API 선택

• 기존 소비자는 legacy 계약을 유지할 수 있습니다. 신규 연동은 현재 v1을 사용합니다.
• V1은 지원 이력에 같은 공개 정책을 적용합니다. 전환일 파라미터는 필요하지 않습니다.
• /legacy/public/v1/...은 과거 공개 금융 payload의 호환성이 필요한 소비자에게 제공합니다.
• 발행 원본·재계산값을 별도로 보존하고 정정 시 새 버전·사유를 연결합니다.

​

현재 조회

• 달력·페이지·payload는 Scalar 레퍼런스을 따릅니다.
• 대사 시 자산·계정 범위·시간 경계·잔고 구성요소를 일치시킵니다.

​

레거시 harvestReport 및 totalAssets 인식 방식의 전환

• 공식 홀더 손익 및 잔고는 valuation=pps (또는 하위 운용처 실시간 발생액을 추정하는 valuation=estimated_nav)로만 산출됩니다. 하베스트 시점에는 즉시 출금할 권리가 없고, 이후 7일간의 신규 입금으로 이익이 희석되므로 미해제 잠금이익은 공식 PnL에서 제외됩니다.
• 전략별 하베스트 보고 수익을 확인하려면 GET /v1/harvests를 호출하여 확정 이벤트, 순이익 및 지갑별 배분액을 조회하십시오.
• 공식 PPS 잔고와 잠금이익을 포함한 컨트랙트 총자산 간의 차이를 검증하려면 /v1/balances 또는 /v1/earnings에 include=reconciliation을 추가하십시오.

​

평균 자본

C_bar    = (1 / D) * Sum(C_j * delta_t_j)
r_legacy = E_legacy / C_bar

APR = r_legacy * (Y / D)
g   = 1 + max(r_legacy, -0.999999)
APY = g^(Y / D) - 1

• 수익률에는 반올림 전 자본·손익을 사용하고 금액 출력은 0 방향으로 절사합니다.
• 자본·기간은 양수여야 합니다. Legacy 연환산값의 절댓값이 50을 넘거나 유한하지 않으면 null을 반환합니다.
• 거듭제곱은 QA 호환 계산의 기존 숫자 처리 방식을 유지합니다.
• Holder/PPS 시작은 start 이하, 마감은 end - 1초 이하의 상태를 선택합니다. 흐름은 (start, end - 1초]입니다.

B_endpoints = (B_0 + B_1) / 2
B_time      = (1 / D) * Integral(B(t) dt) from t_0 to t_1

• 잔고가 구간 전체에서 선형으로 변하면 두 값이 일치합니다.
• 구간 중 예치·출금·평가액 급변이 있으면 시간가중 계산에 실제 경로가 필요합니다.
• Holder/PPS의 분모는 잔여 원금 C(t)입니다. 시장 가치 B(t)와 구분해 사용하십시오.
• 복원된 vault/PPS는 보존 checkpoint의 사다리꼴 자본을 사용합니다. 범위 선택 전 아래 원천 지원 표를 확인하십시오.

​

Vault/PPS 자본

V_bar = (1 / D) * Sum(((V_j + V_{j+1}) / 2) * (u_{j+1} - u_j))

• 최종 출력·수익률 계산까지 checkpoint 곱·가중 합의 정밀도를 유지합니다.
• 호환 분모는 보존한 checkpoint 선택을 따릅니다. V1 경계 평가는 정확한 확정 블록 상태를 사용합니다.

​

Legacy 원천 범위

• Holder/PPS endDate를 명시합니다. 종료일 포함이므로 2026-09-07은 2026-09-08T00:00:00Z까지 증거가 필요합니다.
• 오늘·미수집 기간·가격 또는 이력 누락은 수집 완료까지 503을 반환합니다.
• 가격 묶음은 원천 ID·정수 가격을 보존합니다. 원천 갱신 후 선택 입력이 달라질 수 있습니다.
• 재구성 검증은 해당 입력·기간에 적용됩니다. 발행 원본과의 동일성은 원본 증거로 확인합니다.

​

Export 증거

• Export마다 정확한 요청·응답·헤더를 보존합니다.
• 가격·이력·자본·QA 증거 누락은 구체적인 legacy_*_unavailable 오류를 반환합니다.