ERC-7254 토큰 수익 분배 표준 (Token Revenue Sharing)

Draft · 토큰 · 2023-06-29 작성

ERC-20 토큰을 그냥 들고만 있어도 프로젝트가 번 수익을 보상으로 나눠 받고, 원할 때 직접 꺼내 갈 수 있게 하는 확장 표준입니다.

왜 필요한가

ERC-20 토큰은 잔액을 주고받는 기능만 정의하고 있어서 프로젝트가 번 수익을 토큰 보유자에게 나눠 줄 공통 방법이 없습니다. 그래서 보상을 받으려면 보통 토큰을 따로 맡기거나(락) 스테이킹하거나 파밍에 참여해야 했습니다. 이 과정은 사용자에게 번거롭고 프로젝트마다 방식이 달라 호환되지 않습니다. 이 표준은 ERC-20을 확장해 보유자에게 추가 지급 수단을 제공합니다. 프로젝트가 수익을 올릴 때마다 그 수익을 보유자에게 분배하고 보유자는 쌓인 보상을 확인하고 인출할 수 있습니다. 원문은 회사가 토큰 보유자에게 배당을 지급하는 경우, 마켓플레이스·자동화 마켓 메이커(AMM)·게임 같은 사업 활동에서 나온 수익을 직접 나누는 경우를 활용 사례로 듭니다.

구현해야 하는 것

심층 설명

지분당 보상(rewardPerShare) 방식

분배의 핵심 값은 보상 토큰별 rewardPerShare입니다. updateReward(address[] memory token, uint256[] memory amount)가 호출되면 rewardPerShare = rewardPerShare + amount / totalSupply() 공식으로 갱신됩니다. 즉 분배된 금액을 전체 발행량으로 나눠 1주당 보상을 누적해 두는 구조입니다. 현재 값은 getRewardPerShare(address token)으로 조회합니다. 보상 토큰은 하나가 아니라 여러 개를 배열로 함께 갱신할 수 있습니다.

계정별 상태 UserInformation

각 계정의 보상 상태는 UserInformation 구조체로 관리합니다. 필드는 세 개입니다. inReward는 사용자의 잔액이 줄어들 때 갱신되고 outReward는 사용자의 잔액이 늘어날 때 갱신됩니다. withdraw는 지금까지 인출한 보상 토큰의 총액입니다. 특정 보상 토큰에 대한 한 계정의 정보는 informationOf(token, account)로, 모든 보상 토큰에 대한 정보 목록은 informationOfBatch(account)로 조회합니다.

보상 조회와 수령

계정이 받을 수 있는 보상 금액 목록은 viewReward(address account)로 확인합니다. 실제 수령은 getReward(address[] memory token)를 호출해 이뤄지며 받고 싶은 보상 토큰 주소 목록을 인자로 전달합니다. 잠금이나 스테이킹 절차 없이 보유 상태에서 바로 조회와 수령이 가능하다는 점이 이 표준이 내세우는 사용 방식입니다.

보상 토큰 관리

하나의 수익 분배 토큰에는 여러 보상 토큰이 등록될 수 있습니다. 등록된 보상 토큰 주소 목록은 tokenReward()로, 특정 주소가 보상 토큰인지 여부는 existsTokenReward(address token)으로 확인합니다. 보상 토큰 개수의 상한은 maxTokenReward()가 돌려줍니다.

ERC-20 확장이라는 위치

이 표준은 ERC-20의 확장판으로, 기존 전송·잔액 기능 위에 보유자를 위한 추가 지급 수단을 얹습니다. 표준이 정의하는 범위는 보유자 보상 갱신과 보상 인출 허용입니다. 참조 구현으로 ERC7254.sol과 IERC7254.sol 파일이 제공됩니다.

초안 단계의 제안

이 문서의 상태는 Draft로, 아직 내용이 바뀔 수 있는 초안 단계의 제안입니다. Rationale 절은 TBD(미정)이고 Security Considerations 절도 논의가 필요하다(Needs discussion)고만 적혀 있어 설계 근거와 보안 분석이 아직 채워지지 않았습니다.

ERC 원문 · ← ERCs