# VotingKSP 이 컨트랙트는 KSP를 스테이킹과 관련된 생태계 동작을 담당합니다. 스테이킹 수량과 기간에 따라 투표권(vKSP)을 발행하며, 스테이킹 참여자에게 1일 KSP 마이닝 수량의 40%를 분배합니다. \ (스테이킹 참여자 대상 KSP 분배율은 거버넌스 투표를 통해 변경될 수 있습니다) ## Code Github Link: (Will be updated after official launch) ## Address * Cypress : [0x2F3713F388BC4b8b364a7A2d8D57c5Ff4E054830](https://scope.klaytn.com/account/0x2F3713F388BC4b8b364a7A2d8D57c5Ff4E054830?tabId=txList) ## Events, Read-Only Functions, and State-Changing Functions {% tabs %} {% tab title="Events" %} ## Events **LockKSP** ```solidity event LockKSP(address user, uint lockPeriod, uint KSPAmount, uint totalLockedKSP, uint unlockTime); ``` * KSP를 스테이킹시 발생되는 이벤트 * Parameters * `user` : 유저 지갑 주소 * `lockPeriod` : * 4개월 : 10,368,000 * 8개월 : 20,736,000 * 12개월 : 31,104,000 * x8 : 1,555,200,000 * `KSPAmount` : KSP 수량 * `totalLockedKSP` : 총 스테이킹된 KSP 수량 * `unlockTime` : 언스테이킹 가능한 시간 (timestamp) **UnlockKSP** 
event UnlockKSP(address user, uint vKSPAmount, uint KSPAmount);
* vKSP를 언스테이킹 시 발생되는 이벤트 * Parameters * `user` : 유저 지갑 주소 * `vKSPAmount` : 보유했던 vKSP 수량 * `KSPAmount` : 언스테이킹 KSP 수량 **UnlockKSPUnlimited** ```solidity event UnlockKSPUnlimited(address user, uint vKSPBefore, uint vKSPAfter, uint KSPAmount, uint unlockTime); ``` * vKSP x8 스테이킹을 해제할시 발생되는 이벤트 * Parameters * `user` : 유저 지갑 주소 * `vKSPBefore` : 보유했던 vKSP 수량 * `vKSPAfter` : 스테이킹 해제후 보유한 vKSP 수량 * `KSPAmount` : 스테이킹한 KSP 수량 * `unlockTime` : 언스테이킹 가능한 시간 (timestamp) **RefixBoosting** ```solidity event RefixBoosting(address user, uint lockPeriod, uint boostingAmount, uint unlockTime); ``` * 스테이킹 기간 변경 시 발생되는 이벤트 * Parameter * `user` : 유저 지갑 주소 * `lockPeriod` : 변경 기간 * `boostingAmount` : 변경 후 보유 vKSP * `unlockTime` : 언스테이킹 가능한 시간 (timestamp) **ChangeMiningRate** ```solidity event ChangeMiningRate(uint _mining); ``` * 일일 KSP 분배율 변경 시 발생되는 이벤트 **GiveReward** ```solidity event GiveReward(address user, uint amount, uint lastIndex, uint rewardSum); ``` * KSP 보상 시 발생되는 이벤트 {% endtab %} {% tab title="Read-Only Functions" %} ## Read-Only Functions **balanceOf** * 지갑별 vKSP 보유 수량 **getCurrentBalance** * 라운드 시작시 지갑별 vKSP 보유 수량 **getUserUnlockTime** * 언스테이킹 가능 시점(스테이킹 기간 계산 포함) **lockedKSP** * 스테이킹 한 KSP 수량 **mining** * 일일 KSP 분배 * 0 \~ 10000 값, 단위 0.01% **snapShotBalance** * 상위 풀 여부 스냅샷 **snapShotCount** * 스냅샷 개 **unlockTime** * 언스테이킹 가능 시 **getPriorBalance** ```solidity function getPriorBalance(address user, uint blockNumber) public view returns (uint) ``` * 블록 별 과거 vKSP 보유 수량 * Parameter * `user` : 지갑 주소 * `blockNumber` : 과거 blockNumber **getSnapBalance** ```solidity function snapShotBalance(address user, uint index) public view returns (uint) ``` * 지갑 별 과거 vKSP 보유 수량 * Parameter * `user` : 지갑 주소 * `index` : 순차 별 인덱 **snapShotBlock** ```solidity function snapShotBlock(address user, uint index) public view returns (uint) ``` * 지갑 스냅샷 당시 BlockNumber * Parameter * `user` : 지갑 주소 * `index` : 순차 별 BlockNumber {% endtab %} {% tab title="State-Changing Functions" %} ## **State-Changing Functions** **lockKSP** ```solidity function lockKSP(uint amount, uint lockPeriodRequested) public ``` * KSP 스테이킹 함수 * KSP 정수단위로 스테이킹 가능 **unlockKSP** ```solidity function unlockKSP() public ``` * KSP 언스테이킹 함수 * 언락 기간에만 언스테이킹 가능하다 **unlockKSPUnlimited** ```solidity function unlockKSPUnlimited() public ``` * KSP x8 스테이킹을 해제하는 함수 * 해제 시점부터 x4 스테이킹으로 변경 **refixBoosting** ```solidity function refixBoosting(uint lockPeriodRequested) ``` * KSP 스테이킹 기간 변경 함수 **claimReward** ```solidity function claimReward() public ``` * KSP 보상 수령 함수 **compoundReward** ```solidity function compoundReward() public ``` * KSP 보상 스테이킹 함수 * 보상이 1 KSP 이상일때 호출 가능 * 정수 단위로 스테이킹 가능하며 나머지는 지갑 주소로 전 {% endtab %} {% endtabs %}