회계 증거 기준
2-Track 상업 정산 모델
상업적 수익 배분 계약(Revenue Sharing)을 체결한 기관 파트너의 경우, 시스템 무결성을 위해 2-Track 분리 체계를 운영합니다:- Track 1: 온체인 Data API (총 운용 성과, Gross Yield):
- 온체인 확정 블록 상태에 기반한 순수 총 운용 원장.
- Gross PnL, 잔고, TWR 수익률을 제공하며 일체의 오프체인 비용을 임의 차감하지 않음.
- 기업 재무상태표 작성 및 외부 회계 감사의 기준선(Single Source of Truth).
- Track 2: 상업적 월별 정산 명세서 (실지급액, Net Payout):
- 온체인 Gross PnL을 기초로 오프체인 상업 계약 조항을 적용.
- 성과보수율(10%) 중 파트너 배분율(50~70%) 적용 및 오프체인 브릿지 실비(Rhino 월별 인보이스) 공제.
- 월말 확정 데이터를 결합한 별도 정산서 승인 및 현금 지급.
전략 NAV 추정
기본적으로 SuperEarn은 온체인 확정 주당 가치(valuation=pps)를 사용합니다. 그러나 하위 전략(Morpho 대출 이자, Pendle PT 할인 수렴, RWA 실물 자산 수익 등)에서 매일 발생하는 이자를 루트 볼트 Harvest 전에 실시간으로 파악하고자 할 경우 valuation=estimated_nav 옵션을 사용합니다.
- 동일 블록 조회: 모든 하위 전략 어댑터의 상태를 동일한 확정 블록에서 일괄 조회합니다.
- 자금 유출입 시 수익률 제약: 추정 NAV 기준의 True TWR은 외부 자금 유출입이 없는 기간을 지원합니다. 기간 중 외부 자금 이동이 발생한 경우 NAV 시점 상태 미비로
twr_nav_flow_state_unavailable과 함께 수익률은null처리되며, 순손익(PnL)은 검증된 현금 흐름으로 정상 산출됩니다. - 취득원가 보존:
valuation=estimated_nav는positionValue와unrealizedPnl을 재평가하지만, 검증된 과거costBasis는 변경 없이 그대로 유지합니다.
Harvest 보고와 투자자 손익 연계
스마트 컨트랙트에서 하위 전략의 운용 수익이 투자자의 최종 손익으로 이어지는 생애주기:두 가지 실현 기준
Cooldown 원금과 정산
3개 기간에 걸친 손익 변동 예시
기초 상태: 지분 100개, 원가 100, 볼트 총자산 1,000, 발행량 1,000 (1:1 환산, 수수료 및 외부 유출입 없음 가정):- 하베스트 보고 직후에는 이익이 전액 잠겨 있으므로 투자자 PnL은 0입니다.
- 7일에 걸쳐 잠금이 해제되면서 지분 가치가 110으로 상승하고 투자자는 10의 미실현이익을 인식합니다.
- 출금 신청 시 지분이 소각되면서 10의 미실현이익이 10의 실현이익으로 완벽히 치환되며, 총 관리 자산은 110으로 유지됩니다.
레거시 harvestReport 모드가 폐기된 이유와 대체 조회 방법
초기 레거시 프로토타입(kaia-usdt-miniapp 및 /external/v2/...)에는 하베스트 직후 발생한 lockedProfit이 향후 7일간 기존 지분권자에게 그대로 귀속될 것이라는 가정하에, 하베스트 시점에 이익을 전액 인식하는 accountedBy=harvestReport 모드가 존재했습니다.
이 방식은 다음과 같은 3가지 회계적·기술적 이유로 v1에서 **공식 폐기(HTTP 410)**되었습니다:
-
하베스트 시점의 청구권 및 환금성 부재 (IFRS 자산 인식 요건 불충족):
- 스마트 컨트랙트 원리상, 하베스트 직후 7일 동안의 실제 출금 가치는
lockedProfit을 제외한freeFunds(PPS)로만 확정됩니다. - 만약 투자자가 하베스트 직후 지분을 출금(
redeem)하면, 컨트랙트는lockedProfit을 지급하지 않고 오직 당시의 PPS 금액만 지급합니다. - 출금 시 회수할 권리가 없는 미해제 금액을 홀더의 ‘장부 잔고’나 ‘실현/미실현 손익’으로 기록하는 것은 IFRS 및 GAAP의 자산/수익 인식 요건에 위배됩니다.
- 스마트 컨트랙트 원리상, 하베스트 직후 7일 동안의 실제 출금 가치는
-
지분 희석(Dilution) 및 유출입 왜곡:
- “잠금이익이 결국 현재 홀더에게 배분된다”는 가정은 “향후 7일간 제3자의 신규 입출금이 전혀 없다”는 비현실적 전제를 필요로 합니다.
- 하베스트 2일 뒤 신규 자금이 대규모로 유입되면 신규 투자자가 발행 당시의 PPS로 지분을 취득하고, 남은 5일간 해제되는 이익을 신규 투자자와 나눠 갖게 되어 기존 홀더의 몫이 희석됩니다.
- 따라서 하베스트 블록 시점에 이익을 100% 홀더에게 귀속시키는 것은 실제 온체인 자금 흐름과 모순됩니다.
-
원장 통산 불변식(Lifetime Ledger Invariant) 붕괴:
- 감사 통과의 핵심 항등식인 다음 관계는 모든 입출금이 실제 온체인 현금 및 PPS로 집행된다는 사실에 기반합니다:
- 장부 잔고만 locked profit을 더해 높여 놓으면, 실제 출금 시점에 실제 현금 수령액과의 차이로 인해 대규모 **허위 처분손실(False Disposal Loss)**이 장부에 발생하여 재무제표가 왜곡됩니다.
- 감사 통과의 핵심 항등식인 다음 관계는 모든 입출금이 실제 온체인 현금 및 PPS로 집행된다는 사실에 기반합니다:
필요한 정보별 공식 조회 방법
v1은 가상의 미해제 이익을 공식 장부에 섞지 않고, 목적에 따라 명확히 분리된 엔드포인트를 제공합니다:경계 평가 수식
지원되는 SuperVault 루트 볼트(apiVersion: "0.4.6")의 경계 평가는 3단계로 엄밀하게 산출됩니다:
1. 선형 이익 잠금 해제
include=reconciliation)
- 배분된 Locked Profit:
floor(보유 지분 * 유효 Locked Profit / 총 발행량) (환산). - 반올림 조정액: 보고 총자산의 단순 환산액(
floor(보유 지분 * 보고 총자산 / 총 발행량) (환산))과 (활성 지분 가치 + 배분된 Locked Profit)의 합 사이의 정수 내림 차이.
[!NOTE] 평가 모드(Valuation Mode)와 대사 증거의 구분: Data API가 지원하는 공식 평가 모드는valuation=pps(기본 공식 장부)와valuation=estimated_nav(하위 전략 실시간 발생 수익 추정)의 2가지뿐입니다.include=reconciliation은 별도의 valuation 모드가 아니며,valuation=pps조회 시 공식 PPS 장부 가치와 컨트랙트 보고 총자산 사이의 차이 내역(locked profit 버퍼 및 정수 절사 반올림 조정액)을 감사용 증거로 제공하는 부가 대사(Enrichment) 기능입니다.
Harvest 배분
개별 보고 건에 대해 선택적 지갑 배분은 **보고 블록 종료 시점(end-of-report-block)**의 지분율을 사용합니다:- 순 보고 수익: 기초 토큰 단위의 총 보고 이익(gross gain) − 총 보고 손실(gross loss).
- 보고 블록 지분율: 보고 트랜잭션이 포함된 블록의 모든 처리가 완료된 직후의 지갑 지분과 총 발행량.
- 부과 수수료:
min(총 이익, 운용보수 + 성과보수 + 전략보수); 이익이 0이면 수수료도 0.
회계 결산 워크플로우
감사 수준의 월별 또는 연간 법정 결산 절차:[!TIP] 실무 워크스루: 실제 계정 기준의 curl 호출 및 실측 수치 대사 과정은 파트너 실무 회계 대사 워크스루를 참고하십시오.
추가 인식·측정
온체인 현금 흐름의 변동 없이 장부금액 조정을 적용하는 경우, 다음과 같이 대사합니다: