ERC-900 간단 스테이킹 인터페이스 (Simple Staking Interface)

Stagnant · 금고·DeFi · 2018-02-22 작성

토큰을 컨트랙트에 예치(스테이킹)하고 조회·해제하는 과정을 공통된 함수와 이벤트로 정의해, 서로 다른 스테이킹 시스템도 같은 방식으로 다룰 수 있게 합니다.

왜 필요한가

스테이킹을 쓰는 애플리케이션이 토큰 큐레이션 레지스트리 등으로 늘어나는데, 각 컨트랙트가 함수 이름과 이벤트 형식을 제각각 정하면 지갑이나 다른 서비스가 매번 새로 통합 작업을 해야 합니다. 특정 주소가 얼마를 스테이킹했는지, 과거 어느 시점에 얼마가 스테이킹되어 있었는지를 조회하는 방법도 표준이 없으면 서비스마다 따로 구현해야 해서 재사용이 어렵고 사용자도 서비스마다 다른 사용법을 익혀야 합니다.

구현해야 하는 것

심층 설명

stake와 stakeFor의 차이

stake는 호출자 자신의 토큰을 전송해 스테이킹합니다. stakeFor는 호출자가 지정한 다른 주소(user)를 위해 스테이킹하지만, 전송되는 토큰은 호출자(caller)로부터 나옵니다. 두 함수 모두 data 필드를 받는데, 원문은 이 필드가 더 복잡한 스테이킹 응용에서 신호(signalling) 정보를 추가하는 데 쓰일 수 있다고 설명합니다. 두 함수 모두 호출 시 반드시(MUST) Staked 이벤트를 발생시켜야 합니다.

unstake의 반환 조건

unstake는 지정한 양만큼 스테이킹을 해제합니다. 원문은 토큰을 사용자에게 반환해야 한다(SHOULD)고 하면서도, 현재 언스테이킹이 불가능한 상태라면 반드시(MUST) 트랜잭션을 되돌려야(revert) 한다고 규정합니다. data 필드는 스테이킹 시 추가했던 신호 정보를 제거하는 용도로 쓸 수 있습니다. 호출 시 Unstaked 이벤트를 반드시 발생시켜야 합니다.

조회 함수 totalStakedFor, totalStaked, token

totalStakedFor(addr)는 특정 주소가 현재 스테이킹한 총량을 반환하고, totalStaked()는 컨트랙트 전체의 현재 총 스테이킹량을 반환합니다. token()은 이 스테이킹 인터페이스가 다루는 토큰 컨트랙트의 주소를 반환합니다.

supportsHistory와 선택적 히스토리 함수

모든 스테이킹 시스템이 완전한 과거 기록을 필요로 하지는 않는다는 전제에서, lastStakedFor, totalStakedForAt, totalStakedAt 세 함수는 선택(OPTIONAL) 사항입니다. supportsHistory()는 이 세 함수가 구현되어 있는지를 true 또는 false로 반드시(MUST) 정확하게 알려주어야 합니다. lastStakedFor는 해당 주소가 마지막으로 스테이킹한 블록 번호를, totalStakedForAt은 특정 블록에서 특정 주소의 스테이킹 총량을, totalStakedAt은 특정 블록에서 전체 스테이킹 총량을 반환합니다.

제안 상태: Stagnant

이 제안은 2018년 2월에 작성되었고 현재 상태는 Stagnant(정체)입니다. 즉 논의가 더 이상 진행되지 않고 멈춘 제안이며, 앞으로 수정되거나 정식으로 채택되지 않을 수 있습니다.

ERC 원문 · ← ERCs