RWA 학습맵과 ERC-4626 볼트

도입

RWA는 온체인 토큰과 오프체인 자산 사이의 시간차를 다루는 영역이다. token balance가 있다고 해서 즉시 현금화 가능한 자산이 있는 것은 아니고, NAV가 높다고 해서 오늘 상환 가능한 유동성이 충분한 것도 아니다. 이 구분을 놓치면 stablecoin reserve, yield vault, permissioned transfer를 모두 잘못 설계하게 된다.

ERC-4626은 tokenized vault의 공통 인터페이스를 제공한다. vault share는 underlying asset에 대한 지분이지 stablecoin처럼 1달러를 목표로 하는 결제 단위가 아니다. RWA 학습의 첫 단계는 이 share/asset 관계를 정확히 읽는 것이다.

학습 목표

• ERC-4626 share/asset 모델을 설명한다.
• RWA 볼트에서 NAV와 유동성이 왜 별도 문제인지 이해한다.

개념 설명

RWA 트랙은 ERC-4626, ERC-7540, ERC-3643, NAV/redemption, 실무 체크리스트 순서로 읽는다. 이 순서는 권리 구조에서 시작해 상환 지연, 자격 제한, 운영 검증으로 이동한다.

ERC-4626에서 핵심은 asset, share, totalAssets, conversion, preview, max limit을 분리해 읽는 것이다.

Stablecoin과 ERC-4626 share는 같은 "토큰"처럼 보이지만 권리가 다르다.

코드로 확인하기

RWA vault 코드는 "얼마를 넣으면 몇 share를 받는가"를 숫자로 고정한다. 강의에서 본 share/asset/NAV 관계는 previewDeposit, totalAssets, reconciliation 코드가 같은 값을 말할 때만 운영 가능한 모델이 된다.

컨트랙트ERC-4626 share 계산의 방어선

01function previewDeposit(uint256 assets) public view returns (uint256 shares) {02    uint256 supply = totalSupply();03    uint256 managedAssets = totalAssets();0405    if (supply == 0) {06        return assets;07    }0809    if (managedAssets == 0) {10        revert NavNotPublished();11    }1213    shares = Math.mulDiv(assets, supply, managedAssets, Math.Rounding.Floor);14}1516function deposit(uint256 assets, address receiver) public returns (uint256 shares) {17    shares = previewDeposit(assets);18    if (shares == 0) revert DustDeposit(assets);1920    asset.safeTransferFrom(msg.sender, address(this), assets);21    _mint(receiver, shares);22}

이 코드는 NAV가 비어 있는 상태에서 신규 예치가 들어오면 share 가격이 왜곡되는 문제를 먼저 막는다. 특히 RWA vault에서는 off-chain asset value가 늦게 들어올 수 있으므로, totalAssets()가 단순 token balance가 아니라 검증된 NAV snapshot을 참조하는지 봐야 한다.

백엔드custodian NAV와 on-chain totalAssets 대조

01type NavSnapshot = {02  asOf: string;03  custodianAssets: bigint;04  onchainCash: bigint;05  liabilities: bigint;06};0708function expectedTotalAssets(snapshot: NavSnapshot) {09  return snapshot.custodianAssets + snapshot.onchainCash - snapshot.liabilities;10}1112function assertVaultDrift(snapshot: NavSnapshot, onchainTotalAssets: bigint) {13  const expected = expectedTotalAssets(snapshot);14  const drift = expected > onchainTotalAssets15    ? expected - onchainTotalAssets16    : onchainTotalAssets - expected;1718  if (drift > expected / 10_000n) {19    throw new Error(`NAV drift too high: ${drift.toString()}`);20  }21}

백엔드 검증은 "컨트랙트가 틀렸다"를 찾는 도구가 아니라, 컨트랙트가 신뢰하는 off-chain 수치가 충분히 최신이고 일관적인지 확인하는 운영 장치다.

강의 포인트

실무 예시

스테이블코인 issuer가 준비자산 일부를 tokenized treasury vault에 넣는다고 가정한다. 사용자의 stablecoin balance는 vault share가 아니다. 사용자는 issuer에 대한 상환 청구권을 갖고, issuer가 reserve portfolio 안에서 vault share를 보유한다.

흔한 오해와 실패 시나리오

실습 과제

1. RWA 학습맵과 ERC-4626 볼트 이해 점검: share, asset, totalAssets, conversion, preview, max limit의 의미를 표로 정리한다.
2. RWA vault 데이터 모델 설계: vaultAddress, assetAddress, shareDecimals, assetDecimals, totalAssets, totalSupply, navTimestamp, feePolicy, maxRedeem을 포함한 데이터 모델을 만든다.
3. conversion 테스트 작성: 6 decimals stablecoin을 underlying으로 가정하고 첫 deposit, donation, previewWithdraw, rounding case를 테스트 시나리오로 쓴다.
4. reserve 연결 메모 작성: stablecoin liability와 vault reserve asset을 어떻게 dashboard에서 분리할지 설명한다.

완료 기준

1. ERC-4626 핵심 함수를 설명했다.
2. NAV와 유동성 차이를 정리했다.
3. 데이터 모델 초안을 만들었다.

근거 자료

• RWA 학습맵: 04-RWA-토큰화/00-RWA-학습맵.md
• ERC4626 토큰화 볼트: 04-RWA-토큰화/01-ERC4626-토큰화-볼트.md
• ERC-4626: Tokenized Vault Standard: https://eips.ethereum.org/EIPS/eip-4626