UserData

propose

If user has enough gas and it's not slashed, deploys new proposal to the dao root, if not notifies user that proposal is not created.

function propose(
        TvmCell proposal_data,
        uint128 threshold
    ) override public onlyDaoRoot

Parameters:

Name	Type	Description

onProposalDeployed

Adds proposal to the created proposals, deletes pending proposal and notifies user that the proposal has been created.

function onProposalDeployed(uint32 nonce, uint32 proposal_id, uint32 answer_id) public override onlyDaoRoot

Parameters:

Name	Type	Description

castVote

If there was an error notifies user that vote is rejected, if not adds vote to the casted votes and casts vote to the proposal with given id.

function castVote(uint32 code_version, uint32 proposal_id, bool support, string reason) public override onlyRoot

Parameters:

Name	Type	Description

Events emitted:

• VoteCast

voteCasted

Notifies user that the vote is casted.

function voteCasted(uint32 proposal_id) override public onlyDaoProposal(proposal_id)

Parameters:

Name	Type	Description

rejectVote

Deletes vote from casted votes and notifies user about rejection.

function rejectVote(uint32 proposal_id) override public onlyDaoProposal(proposal_id)

Parameters:

Name	Type	Description

tryUnlockVoteTokens

Unlocks tokens used for voting.

function tryUnlockVoteTokens(uint32 code_version, uint32 proposal_id) override public view onlyRoot

Parameters:

Name	Type	Description

unlockVoteTokens

Deletes created proposal and unlocks user votes.

function unlockVoteTokens(uint32 proposal_id, bool success) override public onlyDaoProposal(proposal_id)

Parameters:

Name	Type	Description

Events emitted:

• UnlockVotes

tryUnlockCastedVotes

Unlocks casted votes from proposal and transfers remaining gas to user.

function tryUnlockCastedVotes(uint32 code_version, uint32[] proposal_ids) override public view onlyRoot

Parameters:

Name	Type	Description

unlockCastedVote

Deletes casted votes from list and notifies user that votes are unlocked.

function unlockCastedVote(uint32 proposal_id, bool success) override public onlyDaoProposal(proposal_id)

Parameters:

Name	Type	Description

Events emitted:

• UnlockCastedVotes

_lockedTokens

Returns the total amount of user’s locked tokens used in proposals

function _lockedTokens() private view returns (uint128)

Return value:

Type	Description

syncRewards

Synchronize all data linked to reward rounds list when adding new reward round.

function syncRewards(IStakingPool.RewardRound[] reward_rounds, uint256 updated_balance) internal

Parameters:

Name	Type	Description

slash

Synchronizes rewards, sets banned rewards, reward debts and token balance and confirms slashing using that data.

function slash(IStakingPool.RewardRound[] reward_rounds, address send_gas_to) external override onlyRoot

Parameters:

Name	Type	Description

processDeposit

Synchronizes rewards, adds deposited tokens to token balance and finishes deposit.

function processDeposit(
        uint64 nonce,
        uint128 _tokens_to_deposit,
        IStakingPool.RewardRound[] reward_rounds,
        uint32 code_version
    ) external override onlyRoot

Parameters:

Name	Type	Description

Events emitted:

• DepositProcessed

processClaimReward

Synchronizes rewards, creates new list of rewards whose data is reward balance from each reward round and finishes claiming rewards.

function processClaimReward(
        IStakingPool.RewardRound[] reward_rounds,
        address send_gas_to,
        uint32 code_version
    ) external override onlyRoot

Parameters:

Name	Type	Description

getRewardForRelayRound

Does all the necessary checks and processes getting the reward for finished relayer round.

function getRewardForRelayRound(uint32 round_num) external onlyRelay

Parameters:

Name	Type	Description

processGetRewardForRelayRound2

Synchronizes rewards and based on the relayer round address found using round number gets reward for the specified round.

function processGetRewardForRelayRound2(
        IStakingPool.RewardRound[] reward_rounds,
        uint32 round_num,
        uint32 code_version,
        uint32 relay_round_code_version
    ) external override onlyRoot

Parameters:

Name	Type	Description

receiveRewardForRelayRound

Increases reward balance for the specified round.

function receiveRewardForRelayRound(
        uint32 relay_round_num, uint32 reward_round_num, uint128 reward
    ) external override onlyRelayRound(relay_round_num)

Parameters:

Name	Type	Description

Events emitted:

• RelayRoundRewardClaimed

processLinkRelayAccounts

Links relayer accounts by setting the relay_ton_pubkey and relay_eth_address

function processLinkRelayAccounts(
        uint256 ton_pubkey,
        uint160 eth_address,
        bool confirm,
        uint32 code_version
    ) external override onlyRoot

Parameters:

Name	Type	Description

Events emitted:

• RelayKeysUpdated

• TonPubkeyConfirmed

• EthAddressConfirmed

confirmTonAccount

Sets ton_pubkey_confirmed to true.

function confirmTonAccount() external

Events emitted:

• TonPubkeyConfirmed

processConfirmEthAccount

Sets eth_address_confirmed to true and transfers remaining gas to the send_gas_to.

function processConfirmEthAccount(uint160 eth_address, address send_gas_to) external override onlyRoot

Parameters:

Name	Type	Description

Events emitted:

• EthAddressConfirmed

becomeRelayNextRound

Processes relayer for next round in the staking pool.

function becomeRelayNextRound() external onlyRelay

processBecomeRelayNextRound2

Based on election address apply for membership.

function processBecomeRelayNextRound2(
        uint32 round_num,
        uint32 lock_time,
        uint128 min_deposit,
        uint32 code_version,
        uint32 election_code_version
    ) external override onlyRoot

Parameters:

Name	Type	Description

relayMembershipRequestAccepted

Locks relayer for 30 days.

function relayMembershipRequestAccepted(
        uint32 round_num, uint128 tokens, uint256 ton_pubkey, uint160 eth_addr, uint32 lock_time
    ) external override onlyElection(round_num)

Parameters:

Name	Type	Description

Events emitted:

• RelayMembershipRequested

processWithdraw

Synchronizes rewards, decreases from token balance number of tokens to withdraw and finishes withdraw in the staking pool.

function processWithdraw(
        uint128 _tokens_to_withdraw,
        IStakingPool.RewardRound[] reward_rounds,
        bool emergency,
        address send_gas_to,
        uint32 code_version
    ) external override onlyRoot

Parameters:

Name	Type	Description

withdrawTons

Transfers to user all the tons left.

function withdrawTons() external override onlyRoot