ERC-8330 대상 연동 NAV 스냅샷 오라클 (Subject-Linked NAV Snapshot Oracle)

Last Call · 금고·DeFi · 2026-07-05 작성

펀드나 부동산처럼 수시로 거래되지 않는 자산의 순자산가치(NAV)를 누가, 어느 시점 기준으로, 어떤 방법론으로 산정했는지와 함께 온체인에 기록하고 조회하는 표준 인터페이스를 정의합니다.

왜 필요한가

펀드, 사모 대출, 부동산, 인프라, 원자재 같은 자산은 거래소 가격처럼 실시간으로 형성되지 않고 주기적인 평가로 가치가 정해집니다. 이런 값을 쓰는 쪽은 그 값이 무엇을 뜻하는지, 평가 기준 시점이 언제인지, 언제 게시됐는지, 누가 제공했는지, 지금 쓰기에 너무 오래되지 않았는지를 알아야 합니다. 그런데 기존 가격·호가 오라클 인터페이스는 평가 이력, 공급자 신원, 산정 방법론 참조, 재산정(정정) 내역, 게시 경과와 평가 경과를 따로 확인하는 수단을 반드시 보존하지는 않습니다. 개별적으로 만든 NAV 컨트랙트들도 스트림 키와 최신값 규칙이 제각각이라 서로 호환되지 않습니다. 이 표준은 NAV의 게시와 조회 의미를 통일하되, NAV 계산 자체나 공급자 자격 심사, 자산 뒷받침 보증은 다루지 않습니다.

심층 설명

스트림과 NAV 기준 설정

모든 스냅샷은 (subjectId, currency) 쌍으로 식별되는 스트림에 속하고 스냅샷 인덱스는 스트림마다 0부터 독립적으로 매겨집니다. 각 스트림은 첫 게시 전에 setNAVBasis로 NAV 기준을 한 번만 설정해야 합니다. 기준은 기초자산 1단위 가치인 PER_UNIT, 1좌(토큰) 가치인 PER_SHARE, 대상 전체 가치인 TOTAL 세 가지만 허용되며 한 번 저장되면 영구히 바뀌지 않습니다. streamNAVBasis는 설정된 기준을, 미설정 스트림에는 bytes32(0)을 돌려줍니다. publishNAV는 기준이 설정되지 않은 스트림과 설정값과 다른 기준이 들어온 호출을 거부해야 합니다. 공급자가 기준을 각자 고르면 같은 평가 시점의 제출값들이 서로 비교 불가능해져 집계가 막히기 때문에 스트림 수준에서 고정합니다.

게시 규칙과 수치 한계

publishNAV는 허가된 공급자만 호출할 수 있고 권한 부여 방식은 구현이 정의하되 문서화해야 합니다. 수락된 스냅샷에는 provider가 msg.sender로, publishedAt이 블록 타임스탬프로 기록되고 NAVPublished 이벤트가 발생합니다. valuationTimestamp는 block.timestamp를 넘을 수 없고 methodologyHash는 bytes32(0)이면 안 됩니다. 수치 제한으로 decimals가 18을 넘는 값, nav가 type(int256).min인 값, 크기가 uint256(type(int256).max) / (10 ** uint256(18 - decimals))를 넘는 값은 거부합니다. 이 한계 덕분에 집계 구현은 모든 값을 소수 18자리로 안전하게 정규화할 수 있습니다. 한 공급자는 같은 스트림의 같은 valuationTimestamp에 현재 유효한 원본 스냅샷을 하나만 가질 수 있고 그 자리가 차 있으면 정정 절차를 써야 합니다. nav는 부채가 자산을 넘을 수 있어 부호 있는 정수이며 소비자는 0과 음수를 명시적으로 처리해야 합니다.

정정 체인

원본 스냅샷은 correctsIndex를 NO_CORRECTION(type(uint256).max)으로 둡니다. 정정 스냅샷은 같은 스트림의 더 앞선 스냅샷을 가리켜야 하고 대상은 아직 후속 정정과 무효화가 없는 말단(terminal) 스냅샷이어야 하며 대상과 같은 공급자가 같은 valuationTimestamp와 navBasis로 게시해야 합니다. 수락되면 대상의 correctedByIndex가 새 인덱스로 바뀌고 다른 필드는 그대로 남습니다. 정정은 다시 정정될 수 있어 선형 체인이 만들어집니다. NAV, decimals, 방법론 해시와 URI는 정정으로 바꿀 수 있습니다. currentSnapshotIndex는 correctedByIndex를 따라가 무효화되지 않은 말단 인덱스를 돌려주고 isSnapshotCurrent는 말단이면서 무효화되지 않은 스냅샷에만 true를 돌려줍니다.

관리자 무효화

invalidateSnapshot은 문서화된 관리·거버넌스 정책 아래에서만 호출할 수 있고 0인 reasonHash, 없는 스냅샷, 말단이 아닌 스냅샷, 이미 무효화된 스냅샷을 거부합니다. 성공하면 기록은 보존한 채 영구히 무효 표시를 합니다. 최신값, 공급자 최신값, 현재 체인, 쿼럼, 집계, 편차 계산에서 제외하며 영향받는 포인터를 다시 계산합니다. 원본이 무효화되면 그 공급자·시점 자리는 새 원본으로 다시 채울 수 있고 정정이 무효화되면 직전 스냅샷이 다시 말단이 되어 교체 정정을 올릴 수 있습니다. 긴 체인은 새로 말단이 된 스냅샷을 차례로 무효화해 되감습니다. 무효화는 correctsIndex 이력을 지우지 않으므로 이력을 복원하는 소비자는 NAVSnapshotInvalidated 이벤트까지 함께 봐야 하고 무효화된 스냅샷은 다시 정정하거나 되살릴 수 없습니다.

최신값 선택과 이중 신선도

latestNAV는 신선도와 무관하게 valuationTimestamp가 가장 큰 현재 스냅샷을 돌려줍니다. 평가 시점이 같으면 더 최근에 게시된 것, 게시 시점도 같으면 인덱스가 큰 것을 고릅니다. 오래된 평가 시점에 대한 늦은 정정이 더 최근 평가를 밀어내서는 안 됩니다. latestNAVStatus는 같은 스냅샷에 두 플래그를 더해 돌려줍니다. isPublishStale은 block.timestamp > publishedAt + heartbeat, isValuationStale은 block.timestamp > valuationTimestamp + maxValuationAge입니다. 임계값 정각에는 신선한 것으로 봅니다. 두 임계값 중 하나라도 미설정이면 latestNAVStatus는 되돌리기(revert)합니다. 최근에 게시됐어도 평가 자체가 오래됐을 수 있으므로 소비자는 두 플래그를 모두 확인해야 합니다.

선택적 집계 확장

집계는 선택 기능입니다. setAggregationConfig로 쿼럼, 편차 임계값(최대 10,000bps), 개별 제출의 최대 나이인 maxSubmissionAge를 설정합니다. 한 평가 시점에는 공급자당 현재 스냅샷 하나만 집계 자격이 있고 자격 있는 공급자 수가 쿼럼 이상인 가장 늦은 평가 시점이 latestAggregationTimestamp가 됩니다. aggregatedNAV는 publishedAt이 maxSubmissionAge 이내인 신선한 제출만 쓰며 그 수가 쿼럼에 못 미치면 더 오래된 평가 시점으로 물러나지 않고 되돌리기합니다. 계산은 모든 신선한 값을 제출된 최대 소수 자릿수로 정규화(nav * 10^(maxDecimals - decimals))한 뒤 오름차순으로 정렬해 values[(providerCount - 1) / 2], 즉 짝수 개일 때 하위 중앙값을 고르는 결정적 방식입니다. 신선도 임계값과 집계 설정이 모두 갖춰지기 전에는 되돌리기합니다.

편차 감지

게시 트랜잭션에서 최신 집계 시점에 신선한 쿼럼이 있을 때만 편차를 계산하며 aggregatedNAV와 같은 신선한 제출 집합을 씁니다. 계산식은 deviationBps = (maxNav - minNav) * 10_000 / abs(medianNav)입니다. 스프레드가 0이면 편차도 0이고 중앙값이 0인데 스프레드가 있거나 계산이 오버플로하면 type(uint256).max로 포화시킵니다. 편차가 deviationThresholdBps를 넘으면 NAVDeviationDetected 이벤트가 발생하고 같을 때는 발생하지 않습니다. 이 이벤트는 경보일 뿐 제출을 무효화하거나 집계를 막지 않으며 오래된 제출은 편차 계산을 유발하거나 영향을 주면 안 됩니다.

ERC-165와 Review 단계 주의점

핵심 오라클은 ERC-165를 구현해 type(INAVSnapshotOracle).interfaceId에 true를 돌려줘야 하고 집계를 지원하면 type(INAVAggregation).interfaceId에도 true를 돌려줘야 합니다. 이번 Review 단계 개정은 INAVAggregation에 신선 제출 조회 함수와 maxSubmissionAge를 더하고 aggregatedNAV의 반환 튜플을 바꿨습니다. 함수 선택자는 같지만 반환 형식이 ABI 수준에서 호환되지 않아 이전 배포본에 새 디코더를 쓰면 이전 버전의 isPublishStale 값을 isValuationStale로 잘못 읽을 수 있습니다. 집계 응답을 해석하기 전에 반드시 이번 개정의 interfaceId 지원을 확인해야 하며 aggregatedNAV 호출 성공만으로 호환성을 판단하면 안 됩니다. 이 제안은 현재 Review 상태라 명세가 앞으로 더 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs