ERC-7425 토큰화 준비금 (Tokenized Reserve)
Draft · 금고·DeFi · 2023-06-30 작성
조직의 비상 자금(준비금)을 스마트 컨트랙트에 투명하게 보관하고 자금 인출은 제안(proposal)을 열어 이해관계자가 참여한 상태에서만 하도록 만드는 표준입니다.
왜 필요한가
현실의 조직은 평소 자금이 부족해질 때를 대비해 준비금을 두고 어떤 조건에서 꺼내 쓸지 구성원이 합의합니다. 이것을 블록체인 위에서 그대로 만들려면 두 가지가 필요합니다. 자금이 어디서 들어와 어디로 나갔는지 누구나 확인할 수 있는 기록과, 소유자가 마음대로 돈을 빼 가지 못하게 하는 참여 장치입니다. 기존의 토큰 금고 표준(ERC-4626)은 입금, 출금, 잔액 조회 같은 기본 기능만 정의해서 금고에 담긴 자산을 어떻게 감사(audit)하고 이해관계자를 어떻게 참여시킬지는 정해진 방식이 없었습니다. 이 표준은 ERC-4626을 확장해 모든 자금 이동을 제안 단위로 기록하고 이해관계자가 예치로 제안을 지지하는 구조를 정의합니다.
구현해야 하는 것
function ownerTime(uint256 count) external view returns (uint256);: 소유자의 예치 또는 인출이 이루어진 시각을 예치 횟수 번호로 조회합니다. block.timestamp 형식으로 돌려줍니다.function ownerDeposit(uint256 count, uint256 proposal) external view returns(uint256);: 소유자가 준비금에 예치한 금액을 예치 횟수와 제안 번호로 조회합니다.function ownerWithdrawals(uint256 proposal) external view returns(uint256);: 열린 제안에 대해 소유자가 인출한 금액을 조회합니다.function tokenDeposit(uint256 count) external view returns(address);: 소유자가 준비금에 예치한 토큰의 종류(ERC-20 주소)를 예치 횟수로 조회합니다.function tokenWithdrawal(uint256 proposal) external view returns(address);: 열린 제안에서 소유자가 인출한 토큰의 종류(ERC-20 주소)를 조회합니다.function userDeposit(address user, uint256 proposal) external view returns(uint256);: 사용자가 지분을 받기 위해 특정 제안에 예치한 ERC-20 금액을 조회합니다.function userWithdrawals(address user, uint256 proposal) public view returns(uint256);: 사용자가 특정 제안에서 인출한 금액을 조회합니다.function proposalDeposit(uint256 assets, address receiver, uint256 proposal) external returns(uint256);: ERC-4626의 deposit()을 이용해 제안에 예치하고 새 지분을 만듭니다. 열려 있고 아직 닫히지 않은 제안이어야 하며 발행된 지분 수량을 돌려줍니다.function proposalWithdraw(uint256 assets, address receiver, address owner, uint256 proposal)external returns(uint256);: ERC-4626의 withdraw()를 이용해 지분을 소각하고 1대1 가치의 기초 토큰을 돌려받습니다. userDeposit이 userWithdrawal 이상이어야 합니다.function openProposal(address token, uint256 amount, address receiver) external returns (uint256);: 소유자가 새 정책(제안)을 발행합니다. 새 정책 번호를 만들고 인출 금액을 회계에 반영하며 준비금 소유 ERC-20 토큰을 인출하는 유일한 방법이어야 합니다.function closeProposal(address token, uint256 proposal, uint256 amount, bool close) external returns (bool);: 소유자가 열린 제안에 예치하거나 제안을 닫습니다. 받은 금액을 회계에 반영하고 닫히면 true를 돌려줍니다.function depositReserve(address token, address sender, uint256 amount) external;: 소유자가 준비금에 예치한 토큰을 회계에 기록합니다. 지분은 발행되지 않고 환급도 되지 않으며 인출은 openProposal로만 합니다.
심층 설명
ERC-4626 확장 구조와 생성자 필드
이 표준은 ERC-4626 금고 인터페이스를 상속하는 확장입니다. 생성자는 다섯 가지를 받습니다. name과 ticker는 지분용 ERC-20 토큰의 이름과 티커, asset은 ERC-4626 금고의 기초 ERC-20 주소, rAuth는 소유자가 여럿이거나 소유자 인출을 제한하는 경우를 위한 권한 사용자, rOwner는 준비금의 소유자입니다. 용어 정의에서 reserve는 ERC-4626 기초 토큰을 제외하고 컨트랙트가 보유한 자산을 가리키며 proposal은 인출을 요청하기 위해 소유자나 이해관계자가 만드는 것입니다.
제안이 없으면 토큰이 나갈 수 없음
준비금 밖으로 토큰을 보내려면 반드시(MUST) 제안이 먼저 열려 있어야 합니다. 제안 열기는 이해관계자나 소유자가 요청할 수 있습니다(MAY). 새 제안은 모두 기록되고 그 정보는 조회 함수로 가져올 수 있어야 하며(SHOULD), 제안의 금액과 주소는 필수(REQUIRED) 기록 항목입니다. 새 이해관계자를 받아들일 때는 소유자가 만든 기준이 필요하며 ERC-4626 금고의 기초 asset으로 온보딩합니다.
이해관계자 참여: proposalDeposit과 proposalWithdraw
제안이 열리면 이해관계자는 proposalDeposit으로 지지를 표시해야 합니다(MUST). 이 함수는 ERC-4626의 deposit()을 사용해 지분을 발행하며 금고에 예치하는 유일한 방법이어야 합니다(SHOULD). ERC-4626의 deposit()을 직접 쓰면 자산이 제안에 회계 반영되지 않는다는 주의가 원문에 있습니다. proposalWithdraw는 ERC-4626의 withdraw()로 지분을 소각하고 1대1 가치를 돌려주며 userDeposit이 userWithdrawal 이상이어야 하고(MUST), 기초 토큰을 인출하는 유일한 방법이어야 합니다(SHOULD).
소유자 동작: openProposal, closeProposal, depositReserve
openProposal은 소유자만 호출할 수 있고(MUST), 새 정책 번호를 만들고 인출 금액을 회계에 반영해야 하며 제안에 예치된 지분 토큰을 제외하고 준비금이 소유한 ERC-20을 인출하는 유일한 방법이어야 합니다(MUST). closeProposal은 소유자만 호출하며 받은 금액을 회계에 반영하고 close 인자로 제안을 닫을지 선택합니다. depositReserve는 소유자가 준비금에 넣는 토큰을 기록하는 함수로, 지분이 발행되지 않고 환급할 수 없으며 제안도 열리지 않습니다. 두 함수 모두 각각 proposals, depositR 이벤트를 내야 합니다(SHOULD).
지분 설계의 근거
각 준비금은 지분에 ERC-20 표준을, 지분 생성에 ERC-4626을 사용합니다. 기초 토큰은 준비금 토큰이라 부를 수 있고 지분 토큰은 ERC-4626 금고가 발행합니다. 지분은 제안에 참여하는 이해관계자를 나타내며 준비금에는 이해관계자 대표성이 반드시 있어야 합니다(MUST). 사용자가 금고를 드나들 때 대표성을 어떻게 다룰지는 구현자가 정합니다. 예를 들어 같은 준비금 토큰을 여러 제안에 쓰지 못하게 하면 지분을 공정하게 배분할 수 있다는 예시가 원문에 있습니다. 명세에 없는 조건은 사례별로 다루도록 설계되었습니다.
Draft 상태의 제안
이 문서는 2023년 6월 30일에 만들어진 Draft 상태의 제안입니다. 아직 확정되지 않아 내용이 바뀌거나 진행이 멈출 수 있으므로, 구현 전에 최신 상태를 확인해야 합니다.
쓸 때 주의할 점
- 소유자 인출은 금고가 지켜 주지 않음: 컨트랙트에 보관된 기초 asset은 rAuth 같은 승인 주체나 제한 없이 소유자가 인출할 수 있다는 점을 이해관계자가 알아야 합니다(SHOULD). 승인 구현 방식에 따라서는 그래도 소유자가 asset을 인출할 수 있습니다.
- 권장 구현 방식: openProposal은 기초 asset의 전송을 명시적으로 제한해야 합니다(MUST). 기초 자산이 금고(제안 내부)가 아니라 준비금 소유인 경우, 사용자 asset 손실을 피하기 위해 준비금이 그 차이를 회계에 반영해야 합니다(MUST).
- ERC-20·ERC-4626과 같은 보안 고려 사항: 토큰화 준비금은 ERC-20과 ERC-4626이 가진 보안 고려 사항을 그대로 공유합니다.