2018-06-26 19:00:12 -07:00
|
|
|
package keeper
|
|
|
|
|
|
|
|
import (
|
2018-08-31 00:37:25 -07:00
|
|
|
"container/list"
|
2018-06-26 19:00:12 -07:00
|
|
|
"fmt"
|
2018-10-14 17:37:06 -07:00
|
|
|
"time"
|
2018-06-26 19:00:12 -07:00
|
|
|
|
|
|
|
sdk "github.com/cosmos/cosmos-sdk/types"
|
|
|
|
"github.com/cosmos/cosmos-sdk/x/stake/types"
|
|
|
|
)
|
|
|
|
|
2018-09-01 13:21:42 -07:00
|
|
|
// Cache the amino decoding of validators, as it can be the case that repeated slashing calls
|
|
|
|
// cause many calls to GetValidator, which were shown to throttle the state machine in our
|
|
|
|
// simulation. Note this is quite biased though, as the simulator does more slashes than a
|
|
|
|
// live chain should, however we require the slashing to be fast as noone pays gas for it.
|
2018-08-31 00:37:25 -07:00
|
|
|
type cachedValidator struct {
|
|
|
|
val types.Validator
|
2018-09-02 12:42:25 -07:00
|
|
|
marshalled string // marshalled amino bytes for the validator object (not operator address)
|
2018-08-31 00:37:25 -07:00
|
|
|
}
|
|
|
|
|
2018-09-02 12:42:25 -07:00
|
|
|
// validatorCache-key: validator amino bytes
|
2018-09-01 13:21:42 -07:00
|
|
|
var validatorCache = make(map[string]cachedValidator, 500)
|
2018-08-31 00:37:25 -07:00
|
|
|
var validatorCacheList = list.New()
|
|
|
|
|
2018-06-26 19:00:12 -07:00
|
|
|
// get a single validator
|
2018-08-30 21:06:44 -07:00
|
|
|
func (k Keeper) GetValidator(ctx sdk.Context, addr sdk.ValAddress) (validator types.Validator, found bool) {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-07-03 22:32:49 -07:00
|
|
|
value := store.Get(GetValidatorKey(addr))
|
|
|
|
if value == nil {
|
2018-06-26 19:00:12 -07:00
|
|
|
return validator, false
|
|
|
|
}
|
2018-09-02 12:42:25 -07:00
|
|
|
|
2018-09-01 13:21:42 -07:00
|
|
|
// If these amino encoded bytes are in the cache, return the cached validator
|
2018-08-31 00:37:25 -07:00
|
|
|
strValue := string(value)
|
|
|
|
if val, ok := validatorCache[strValue]; ok {
|
|
|
|
valToReturn := val.val
|
|
|
|
// Doesn't mutate the cache's value
|
2018-09-08 01:44:58 -07:00
|
|
|
valToReturn.OperatorAddr = addr
|
2018-08-31 00:37:25 -07:00
|
|
|
return valToReturn, true
|
|
|
|
}
|
2018-09-02 12:42:25 -07:00
|
|
|
|
2018-09-01 13:21:42 -07:00
|
|
|
// amino bytes weren't found in cache, so amino unmarshal and add it to the cache
|
2018-08-31 08:29:32 -07:00
|
|
|
validator = types.MustUnmarshalValidator(k.cdc, addr, value)
|
|
|
|
cachedVal := cachedValidator{validator, strValue}
|
|
|
|
validatorCache[strValue] = cachedValidator{validator, strValue}
|
|
|
|
validatorCacheList.PushBack(cachedVal)
|
2018-09-02 12:42:25 -07:00
|
|
|
|
2018-09-01 13:21:42 -07:00
|
|
|
// if the cache is too big, pop off the last element from it
|
2018-08-31 08:29:32 -07:00
|
|
|
if validatorCacheList.Len() > 500 {
|
|
|
|
valToRemove := validatorCacheList.Remove(validatorCacheList.Front()).(cachedValidator)
|
|
|
|
delete(validatorCache, valToRemove.marshalled)
|
|
|
|
}
|
|
|
|
|
2018-07-04 14:07:06 -07:00
|
|
|
validator = types.MustUnmarshalValidator(k.cdc, addr, value)
|
2018-06-26 19:00:12 -07:00
|
|
|
return validator, true
|
|
|
|
}
|
|
|
|
|
2018-10-03 09:37:06 -07:00
|
|
|
func (k Keeper) mustGetValidator(ctx sdk.Context, addr sdk.ValAddress) types.Validator {
|
|
|
|
validator, found := k.GetValidator(ctx, addr)
|
|
|
|
if !found {
|
|
|
|
panic(fmt.Sprintf("validator record not found for address: %X\n", addr))
|
|
|
|
}
|
|
|
|
return validator
|
|
|
|
}
|
|
|
|
|
2018-09-24 21:09:31 -07:00
|
|
|
// get a single validator by consensus address
|
|
|
|
func (k Keeper) GetValidatorByConsAddr(ctx sdk.Context, consAddr sdk.ConsAddress) (validator types.Validator, found bool) {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-09-24 21:09:31 -07:00
|
|
|
opAddr := store.Get(GetValidatorByConsAddrKey(consAddr))
|
|
|
|
if opAddr == nil {
|
2018-06-26 19:00:12 -07:00
|
|
|
return validator, false
|
|
|
|
}
|
2018-09-24 21:09:31 -07:00
|
|
|
return k.GetValidator(ctx, opAddr)
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
2018-10-03 09:37:06 -07:00
|
|
|
func (k Keeper) mustGetValidatorByConsAddr(ctx sdk.Context, consAddr sdk.ConsAddress) types.Validator {
|
|
|
|
validator, found := k.GetValidatorByConsAddr(ctx, consAddr)
|
|
|
|
if !found {
|
|
|
|
panic(fmt.Errorf("validator with consensus-Address %s not found", consAddr))
|
|
|
|
}
|
|
|
|
return validator
|
|
|
|
}
|
|
|
|
|
|
|
|
//___________________________________________________________________________
|
|
|
|
|
2018-06-26 19:00:12 -07:00
|
|
|
// set the main record holding validator details
|
|
|
|
func (k Keeper) SetValidator(ctx sdk.Context, validator types.Validator) {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-07-04 14:07:06 -07:00
|
|
|
bz := types.MustMarshalValidator(k.cdc, validator)
|
2018-09-08 01:44:58 -07:00
|
|
|
store.Set(GetValidatorKey(validator.OperatorAddr), bz)
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
// validator index
|
2018-09-24 21:09:31 -07:00
|
|
|
func (k Keeper) SetValidatorByConsAddr(ctx sdk.Context, validator types.Validator) {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-09-24 21:09:31 -07:00
|
|
|
consAddr := sdk.ConsAddress(validator.ConsPubKey.Address())
|
|
|
|
store.Set(GetValidatorByConsAddrKey(consAddr), validator.OperatorAddr)
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
// validator index
|
|
|
|
func (k Keeper) SetValidatorByPowerIndex(ctx sdk.Context, validator types.Validator, pool types.Pool) {
|
2018-10-03 09:37:06 -07:00
|
|
|
// jailed validators are not kept in the power index
|
|
|
|
if validator.Jailed {
|
|
|
|
return
|
|
|
|
}
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-09-08 01:44:58 -07:00
|
|
|
store.Set(GetValidatorsByPowerIndexKey(validator, pool), validator.OperatorAddr)
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
// validator index
|
2018-10-03 09:37:06 -07:00
|
|
|
func (k Keeper) DeleteValidatorByPowerIndex(ctx sdk.Context, validator types.Validator, pool types.Pool) {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-10-03 09:37:06 -07:00
|
|
|
store.Delete(GetValidatorsByPowerIndexKey(validator, pool))
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
2018-10-03 09:37:06 -07:00
|
|
|
// validator index
|
|
|
|
func (k Keeper) SetNewValidatorByPowerIndex(ctx sdk.Context, validator types.Validator) {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-10-03 09:37:06 -07:00
|
|
|
pool := k.GetPool(ctx)
|
|
|
|
store.Set(GetValidatorsByPowerIndexKey(validator, pool), validator.OperatorAddr)
|
|
|
|
}
|
|
|
|
|
|
|
|
//___________________________________________________________________________
|
|
|
|
|
|
|
|
// Update the tokens of an existing validator, update the validators power index key
|
|
|
|
func (k Keeper) AddValidatorTokensAndShares(ctx sdk.Context, validator types.Validator,
|
|
|
|
tokensToAdd sdk.Int) (valOut types.Validator, addedShares sdk.Dec) {
|
|
|
|
|
|
|
|
pool := k.GetPool(ctx)
|
|
|
|
k.DeleteValidatorByPowerIndex(ctx, validator, pool)
|
|
|
|
validator, pool, addedShares = validator.AddTokensFromDel(pool, tokensToAdd)
|
|
|
|
// increment the intra-tx counter
|
|
|
|
// in case of a conflict, the validator which least recently changed power takes precedence
|
|
|
|
counter := k.GetIntraTxCounter(ctx)
|
|
|
|
validator.BondIntraTxCounter = counter
|
|
|
|
k.SetIntraTxCounter(ctx, counter+1)
|
|
|
|
k.SetValidator(ctx, validator)
|
|
|
|
k.SetPool(ctx, pool)
|
|
|
|
k.SetValidatorByPowerIndex(ctx, validator, pool)
|
|
|
|
return validator, addedShares
|
|
|
|
}
|
|
|
|
|
|
|
|
// Update the tokens of an existing validator, update the validators power index key
|
|
|
|
func (k Keeper) RemoveValidatorTokensAndShares(ctx sdk.Context, validator types.Validator,
|
|
|
|
sharesToRemove sdk.Dec) (valOut types.Validator, removedTokens sdk.Dec) {
|
|
|
|
|
|
|
|
pool := k.GetPool(ctx)
|
|
|
|
k.DeleteValidatorByPowerIndex(ctx, validator, pool)
|
|
|
|
validator, pool, removedTokens = validator.RemoveDelShares(pool, sharesToRemove)
|
|
|
|
k.SetValidator(ctx, validator)
|
|
|
|
k.SetPool(ctx, pool)
|
|
|
|
k.SetValidatorByPowerIndex(ctx, validator, pool)
|
|
|
|
return validator, removedTokens
|
|
|
|
}
|
|
|
|
|
|
|
|
// Update the tokens of an existing validator, update the validators power index key
|
|
|
|
func (k Keeper) RemoveValidatorTokens(ctx sdk.Context, validator types.Validator, tokensToRemove sdk.Dec) types.Validator {
|
|
|
|
pool := k.GetPool(ctx)
|
|
|
|
k.DeleteValidatorByPowerIndex(ctx, validator, pool)
|
|
|
|
validator, pool = validator.RemoveTokens(pool, tokensToRemove)
|
|
|
|
k.SetValidator(ctx, validator)
|
|
|
|
k.SetPool(ctx, pool)
|
|
|
|
k.SetValidatorByPowerIndex(ctx, validator, pool)
|
|
|
|
return validator
|
|
|
|
}
|
|
|
|
|
|
|
|
// UpdateValidatorCommission attempts to update a validator's commission rate.
|
|
|
|
// An error is returned if the new commission rate is invalid.
|
|
|
|
func (k Keeper) UpdateValidatorCommission(ctx sdk.Context, validator types.Validator, newRate sdk.Dec) (types.Commission, sdk.Error) {
|
|
|
|
commission := validator.Commission
|
|
|
|
blockTime := ctx.BlockHeader().Time
|
|
|
|
|
|
|
|
if err := commission.ValidateNewRate(newRate, blockTime); err != nil {
|
|
|
|
return commission, err
|
|
|
|
}
|
|
|
|
|
|
|
|
commission.Rate = newRate
|
|
|
|
commission.UpdateTime = blockTime
|
|
|
|
|
|
|
|
return commission, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// remove the validator record and associated indexes
|
|
|
|
// except for the bonded validator index which is only handled in ApplyAndReturnTendermintUpdates
|
|
|
|
func (k Keeper) RemoveValidator(ctx sdk.Context, address sdk.ValAddress) {
|
|
|
|
|
|
|
|
// first retrieve the old validator record
|
|
|
|
validator, found := k.GetValidator(ctx, address)
|
|
|
|
if !found {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
// delete the old validator record
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
pool := k.GetPool(ctx)
|
|
|
|
store.Delete(GetValidatorKey(address))
|
|
|
|
store.Delete(GetValidatorByConsAddrKey(sdk.ConsAddress(validator.ConsPubKey.Address())))
|
|
|
|
store.Delete(GetValidatorsByPowerIndexKey(validator, pool))
|
|
|
|
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
2018-10-03 09:37:06 -07:00
|
|
|
//___________________________________________________________________________
|
|
|
|
// get groups of validators
|
|
|
|
|
|
|
|
// get the set of all validators with no limits, used during genesis dump
|
2018-06-26 19:00:12 -07:00
|
|
|
func (k Keeper) GetAllValidators(ctx sdk.Context) (validators []types.Validator) {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
iterator := sdk.KVStorePrefixIterator(store, ValidatorsKey)
|
2018-09-13 14:23:44 -07:00
|
|
|
defer iterator.Close()
|
2018-06-26 19:00:12 -07:00
|
|
|
|
2018-09-13 14:23:44 -07:00
|
|
|
for ; iterator.Valid(); iterator.Next() {
|
2018-07-03 22:32:49 -07:00
|
|
|
addr := iterator.Key()[1:]
|
2018-07-04 14:07:06 -07:00
|
|
|
validator := types.MustUnmarshalValidator(k.cdc, addr, iterator.Value())
|
2018-06-26 19:00:12 -07:00
|
|
|
validators = append(validators, validator)
|
|
|
|
}
|
|
|
|
return validators
|
|
|
|
}
|
|
|
|
|
2018-09-13 14:23:44 -07:00
|
|
|
// return a given amount of all the validators
|
|
|
|
func (k Keeper) GetValidators(ctx sdk.Context, maxRetrieve uint16) (validators []types.Validator) {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-09-13 14:23:44 -07:00
|
|
|
validators = make([]types.Validator, maxRetrieve)
|
|
|
|
|
2018-06-26 19:00:12 -07:00
|
|
|
iterator := sdk.KVStorePrefixIterator(store, ValidatorsKey)
|
2018-09-13 14:23:44 -07:00
|
|
|
defer iterator.Close()
|
2018-06-26 19:00:12 -07:00
|
|
|
|
|
|
|
i := 0
|
2018-09-13 14:23:44 -07:00
|
|
|
for ; iterator.Valid() && i < int(maxRetrieve); iterator.Next() {
|
2018-07-03 22:32:49 -07:00
|
|
|
addr := iterator.Key()[1:]
|
2018-07-04 14:07:06 -07:00
|
|
|
validator := types.MustUnmarshalValidator(k.cdc, addr, iterator.Value())
|
2018-06-26 19:00:12 -07:00
|
|
|
validators[i] = validator
|
2018-09-13 14:23:44 -07:00
|
|
|
i++
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
2018-09-13 14:23:44 -07:00
|
|
|
return validators[:i] // trim if the array length < maxRetrieve
|
2018-06-26 19:00:12 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
// get the group of the bonded validators
|
|
|
|
func (k Keeper) GetValidatorsBonded(ctx sdk.Context) (validators []types.Validator) {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
|
|
|
|
// add the actual validator power sorted store
|
2018-08-31 02:03:43 -07:00
|
|
|
maxValidators := k.MaxValidators(ctx)
|
2018-06-26 19:00:12 -07:00
|
|
|
validators = make([]types.Validator, maxValidators)
|
|
|
|
|
|
|
|
iterator := sdk.KVStorePrefixIterator(store, ValidatorsBondedIndexKey)
|
2018-09-13 14:23:44 -07:00
|
|
|
defer iterator.Close()
|
|
|
|
|
2018-06-26 19:00:12 -07:00
|
|
|
i := 0
|
|
|
|
for ; iterator.Valid(); iterator.Next() {
|
|
|
|
|
|
|
|
// sanity check
|
|
|
|
if i > int(maxValidators-1) {
|
|
|
|
panic("maxValidators is less than the number of records in ValidatorsBonded Store, store should have been updated")
|
|
|
|
}
|
2018-07-02 17:58:22 -07:00
|
|
|
address := GetAddressFromValBondedIndexKey(iterator.Key())
|
2018-10-03 09:37:06 -07:00
|
|
|
validator := k.mustGetValidator(ctx, address)
|
2018-06-26 19:00:12 -07:00
|
|
|
|
|
|
|
validators[i] = validator
|
|
|
|
i++
|
|
|
|
}
|
|
|
|
return validators[:i] // trim
|
|
|
|
}
|
|
|
|
|
|
|
|
// get the group of bonded validators sorted by power-rank
|
2018-10-03 09:37:06 -07:00
|
|
|
func (k Keeper) GetBondedValidatorsByPower(ctx sdk.Context) []types.Validator {
|
2018-06-26 19:00:12 -07:00
|
|
|
store := ctx.KVStore(k.storeKey)
|
2018-08-31 02:03:43 -07:00
|
|
|
maxValidators := k.MaxValidators(ctx)
|
2018-06-26 19:00:12 -07:00
|
|
|
validators := make([]types.Validator, maxValidators)
|
2018-09-13 14:23:44 -07:00
|
|
|
|
|
|
|
iterator := sdk.KVStoreReversePrefixIterator(store, ValidatorsByPowerIndexKey)
|
|
|
|
defer iterator.Close()
|
|
|
|
|
2018-06-26 19:00:12 -07:00
|
|
|
i := 0
|
2018-09-13 14:23:44 -07:00
|
|
|
for ; iterator.Valid() && i < int(maxValidators); iterator.Next() {
|
2018-06-26 19:00:12 -07:00
|
|
|
address := iterator.Value()
|
2018-10-03 09:37:06 -07:00
|
|
|
validator := k.mustGetValidator(ctx, address)
|
2018-09-11 02:12:35 -07:00
|
|
|
|
2018-07-13 13:46:14 -07:00
|
|
|
if validator.Status == sdk.Bonded {
|
2018-06-26 19:00:12 -07:00
|
|
|
validators[i] = validator
|
|
|
|
i++
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return validators[:i] // trim
|
|
|
|
}
|
2018-10-14 17:37:06 -07:00
|
|
|
|
|
|
|
// gets a specific validator queue timeslice. A timeslice is a slice of ValAddresses corresponding to unbonding validators
|
|
|
|
// that expire at a certain time.
|
|
|
|
func (k Keeper) GetValidatorQueueTimeSlice(ctx sdk.Context, timestamp time.Time) (valAddrs []sdk.ValAddress) {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
bz := store.Get(GetValidatorQueueTimeKey(timestamp))
|
|
|
|
if bz == nil {
|
|
|
|
return []sdk.ValAddress{}
|
|
|
|
}
|
|
|
|
k.cdc.MustUnmarshalBinary(bz, &valAddrs)
|
|
|
|
return valAddrs
|
|
|
|
}
|
|
|
|
|
|
|
|
// Sets a specific validator queue timeslice.
|
|
|
|
func (k Keeper) SetValidatorQueueTimeSlice(ctx sdk.Context, timestamp time.Time, keys []sdk.ValAddress) {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
bz := k.cdc.MustMarshalBinary(keys)
|
|
|
|
store.Set(GetValidatorQueueTimeKey(timestamp), bz)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Insert an validator address to the appropriate timeslice in the validator queue
|
|
|
|
func (k Keeper) InsertValidatorQueue(ctx sdk.Context, val types.Validator) {
|
|
|
|
timeSlice := k.GetValidatorQueueTimeSlice(ctx, val.UnbondingMinTime)
|
|
|
|
if len(timeSlice) == 0 {
|
|
|
|
k.SetValidatorQueueTimeSlice(ctx, val.UnbondingMinTime, []sdk.ValAddress{val.OperatorAddr})
|
|
|
|
} else {
|
|
|
|
timeSlice = append(timeSlice, val.OperatorAddr)
|
|
|
|
k.SetValidatorQueueTimeSlice(ctx, val.UnbondingMinTime, timeSlice)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Returns all the validator queue timeslices from time 0 until endTime
|
|
|
|
func (k Keeper) ValidatorQueueIterator(ctx sdk.Context, endTime time.Time) sdk.Iterator {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
return store.Iterator(ValidatorQueueKey, sdk.InclusiveEndBytes(GetValidatorQueueTimeKey(endTime)))
|
|
|
|
}
|
|
|
|
|
|
|
|
// Returns a concatenated list of all the timeslices before currTime, and deletes the timeslices from the queue
|
|
|
|
func (k Keeper) GetAllMatureValidatorQueue(ctx sdk.Context, currTime time.Time) (matureValsAddrs []sdk.ValAddress) {
|
|
|
|
// gets an iterator for all timeslices from time 0 until the current Blockheader time
|
|
|
|
validatorTimesliceIterator := k.ValidatorQueueIterator(ctx, ctx.BlockHeader().Time)
|
|
|
|
for ; validatorTimesliceIterator.Valid(); validatorTimesliceIterator.Next() {
|
|
|
|
timeslice := []sdk.ValAddress{}
|
|
|
|
k.cdc.MustUnmarshalBinary(validatorTimesliceIterator.Value(), ×lice)
|
|
|
|
matureValsAddrs = append(matureValsAddrs, timeslice...)
|
|
|
|
}
|
|
|
|
return matureValsAddrs
|
|
|
|
}
|
|
|
|
|
|
|
|
// Unbonds all the unbonding validators that have finished their unbonding period
|
|
|
|
func (k Keeper) UnbondAllMatureValidatorQueue(ctx sdk.Context) {
|
|
|
|
store := ctx.KVStore(k.storeKey)
|
|
|
|
validatorTimesliceIterator := k.ValidatorQueueIterator(ctx, ctx.BlockHeader().Time)
|
|
|
|
for ; validatorTimesliceIterator.Valid(); validatorTimesliceIterator.Next() {
|
|
|
|
timeslice := []sdk.ValAddress{}
|
|
|
|
k.cdc.MustUnmarshalBinary(validatorTimesliceIterator.Value(), ×lice)
|
|
|
|
for _, valAddr := range timeslice {
|
|
|
|
val, found := k.GetValidator(ctx, valAddr)
|
|
|
|
if !found || val.GetStatus() != sdk.Unbonding {
|
|
|
|
continue
|
|
|
|
}
|
|
|
|
k.unbondingToUnbonded(ctx, val)
|
|
|
|
}
|
|
|
|
store.Delete(validatorTimesliceIterator.Key())
|
|
|
|
}
|
|
|
|
}
|