Skip to main content
보고 요약 (TL;DR) · 파트너 회계 및 보고 · 실무 회계 대사 워크스루 · 데이터 API 개요 · Scalar 레퍼런스 발생주의 회계는 현금의 수수 시점과 무관하게 경제적 사건이 발생한 기간에 수익과 비용을 인식합니다. 기관 파트너를 위해 SuperEarn은 IFRS 및 일반기업회계기준에 부합하는 온체인 검증 증거를 제공합니다. Conceptual Framework §1.17 (AASB)

회계 증거 기준

2-Track 상업 정산 모델

상업적 수익 배분 계약(Revenue Sharing)을 체결한 기관 파트너의 경우, 시스템 무결성을 위해 2-Track 분리 체계를 운영합니다:
  1. Track 1: 온체인 Data API (총 운용 성과, Gross Yield):
    • 온체인 확정 블록 상태에 기반한 순수 총 운용 원장.
    • Gross PnL, 잔고, TWR 수익률을 제공하며 일체의 오프체인 비용을 임의 차감하지 않음.
    • 기업 재무상태표 작성 및 외부 회계 감사의 기준선(Single Source of Truth).
  2. Track 2: 상업적 월별 정산 명세서 (실지급액, Net Payout):
    • 온체인 Gross PnL을 기초로 오프체인 상업 계약 조항을 적용.
    • 성과보수율(10%) 중 파트너 배분율(50~70%) 적용 및 오프체인 브릿지 실비(Rhino 월별 인보이스) 공제.
    • 월말 확정 데이터를 결합한 별도 정산서 승인 및 현금 지급.

전략 NAV 추정

기본적으로 SuperEarn은 온체인 확정 주당 가치(valuation=pps)를 사용합니다. 그러나 하위 전략(Morpho 대출 이자, Pendle PT 할인 수렴, RWA 실물 자산 수익 등)에서 매일 발생하는 이자를 루트 볼트 Harvest 전에 실시간으로 파악하고자 할 경우 valuation=estimated_nav 옵션을 사용합니다.
전략 NAV 운영 규칙
  • 동일 블록 조회: 모든 하위 전략 어댑터의 상태를 동일한 확정 블록에서 일괄 조회합니다.
  • 자금 유출입 시 수익률 제약: 추정 NAV 기준의 True TWR은 외부 자금 유출입이 없는 기간을 지원합니다. 기간 중 외부 자금 이동이 발생한 경우 NAV 시점 상태 미비로 twr_nav_flow_state_unavailable과 함께 수익률은 null 처리되며, 순손익(PnL)은 검증된 현금 흐름으로 정상 산출됩니다.
  • 취득원가 보존: valuation=estimated_navpositionValueunrealizedPnl을 재평가하지만, 검증된 과거 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)**되었습니다:
  1. 하베스트 시점의 청구권 및 환금성 부재 (IFRS 자산 인식 요건 불충족):
    • 스마트 컨트랙트 원리상, 하베스트 직후 7일 동안의 실제 출금 가치는 lockedProfit을 제외한 freeFunds(PPS)로만 확정됩니다.
    • 만약 투자자가 하베스트 직후 지분을 출금(redeem)하면, 컨트랙트는 lockedProfit을 지급하지 않고 오직 당시의 PPS 금액만 지급합니다.
    • 출금 시 회수할 권리가 없는 미해제 금액을 홀더의 ‘장부 잔고’나 ‘실현/미실현 손익’으로 기록하는 것은 IFRS 및 GAAP의 자산/수익 인식 요건에 위배됩니다.
  2. 지분 희석(Dilution) 및 유출입 왜곡:
    • “잠금이익이 결국 현재 홀더에게 배분된다”는 가정은 “향후 7일간 제3자의 신규 입출금이 전혀 없다”는 비현실적 전제를 필요로 합니다.
    • 하베스트 2일 뒤 신규 자금이 대규모로 유입되면 신규 투자자가 발행 당시의 PPS로 지분을 취득하고, 남은 5일간 해제되는 이익을 신규 투자자와 나눠 갖게 되어 기존 홀더의 몫이 희석됩니다.
    • 따라서 하베스트 블록 시점에 이익을 100% 홀더에게 귀속시키는 것은 실제 온체인 자금 흐름과 모순됩니다.
  3. 원장 통산 불변식(Lifetime Ledger Invariant) 붕괴:
    • 감사 통과의 핵심 항등식인 다음 관계는 모든 입출금이 실제 온체인 현금 및 PPS로 집행된다는 사실에 기반합니다:
    • 장부 잔고만 locked profit을 더해 높여 놓으면, 실제 출금 시점에 실제 현금 수령액과의 차이로 인해 대규모 **허위 처분손실(False Disposal Loss)**이 장부에 발생하여 재무제표가 왜곡됩니다.

필요한 정보별 공식 조회 방법

v1은 가상의 미해제 이익을 공식 장부에 섞지 않고, 목적에 따라 명확히 분리된 엔드포인트를 제공합니다:

경계 평가 수식

지원되는 SuperVault 루트 볼트(apiVersion: "0.4.6")의 경계 평가는 3단계로 엄밀하게 산출됩니다: 1. 선형 이익 잠금 해제
2. Free Funds 및 활성 지분 평가
3. 보고 자산 대사 (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 호출 및 실측 수치 대사 과정은 파트너 실무 회계 대사 워크스루를 참고하십시오.

추가 인식·측정

온체인 현금 흐름의 변동 없이 장부금액 조정을 적용하는 경우, 다음과 같이 대사합니다: