ERC-900 간단 스테이킹 인터페이스 (Simple Staking Interface)
Stagnant · 금고·DeFi · 2018-02-22 작성
토큰을 컨트랙트에 예치(스테이킹)하고 조회·해제하는 과정을 공통된 함수와 이벤트로 정의해, 서로 다른 스테이킹 시스템도 같은 방식으로 다룰 수 있게 합니다.
왜 필요한가
스테이킹을 쓰는 애플리케이션이 토큰 큐레이션 레지스트리 등으로 늘어나는데, 각 컨트랙트가 함수 이름과 이벤트 형식을 제각각 정하면 지갑이나 다른 서비스가 매번 새로 통합 작업을 해야 합니다. 특정 주소가 얼마를 스테이킹했는지, 과거 어느 시점에 얼마가 스테이킹되어 있었는지를 조회하는 방법도 표준이 없으면 서비스마다 따로 구현해야 해서 재사용이 어렵고 사용자도 서비스마다 다른 사용법을 익혀야 합니다.
구현해야 하는 것
event Staked(address indexed user, uint256 amount, uint256 total, bytes data);: 사용자가 토큰을 스테이킹했을 때 발생하는 이벤트입니다.event Unstaked(address indexed user, uint256 amount, uint256 total, bytes data);: 사용자가 스테이킹한 토큰을 반환받았을 때 발생하는 이벤트입니다.function stake(uint256 amount, bytes data) public;: 호출자 본인이 일정량의 토큰을 스테이킹합니다.function stakeFor(address user, uint256 amount, bytes data) public;: 호출자가 지정한 다른 주소를 대신해 토큰을 스테이킹합니다.function unstake(uint256 amount, bytes data) public;: 스테이킹한 토큰 중 일정량을 해제하고 반환받습니다.function totalStakedFor(address addr) public view returns (uint256);: 특정 주소가 현재 스테이킹한 총량을 반환합니다.function totalStaked() public view returns (uint256);: 컨트랙트 전체의 현재 총 스테이킹량을 반환합니다.function token() public view returns (address);: 이 인터페이스가 다루는 토큰의 컨트랙트 주소를 반환합니다.function supportsHistory() public pure returns (bool);: 아래 히스토리 조회용 선택 함수들을 구현했는지 여부를 반환합니다.function lastStakedFor(address addr) public view returns (uint256);: 해당 주소가 마지막으로 스테이킹한 블록 번호를 반환합니다. 선택 구현 사항입니다.function totalStakedForAt(address addr, uint256 blockNumber) public view returns (uint256);: 특정 블록 시점에 해당 주소가 스테이킹한 총량을 반환합니다. 선택 구현 사항입니다.function totalStakedAt(uint256 blockNumber) public view returns (uint256);: 특정 블록 시점의 전체 스테이킹 총량을 반환합니다. 선택 구현 사항입니다.
심층 설명
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(정체)입니다. 즉 논의가 더 이상 진행되지 않고 멈춘 제안이며, 앞으로 수정되거나 정식으로 채택되지 않을 수 있습니다.