x/restaking

Abstract

The following document specifies the restaking module.

This module contains the logic that allows users to restake their assets.

Assets can be restaked within a pool, towards an operator, or towards a specific Actively Validated Service (AVS).

In addition to managing the delegation, this module allows operators to start and stop securing an AVS, as well as AVS admins to determine which operator is authorized to secure their service and from which pool they may borrow security.

Contents

• State

  • Unbonding ID

  • Unbonding index

  • Unbonding type

  • Operator joined services

  • Service operators allow list

  • Service securing pools

  • Service joined by operator

  • Pool delegation

  • Pool delegation by pool ID

  • Pool unbonding delegation

  • Operator delegation

  • Operator delegations by operator ID

  • Operator unbonding delegation

  • Service delegation

  • Service delegations by service ID

  • Service unbonding delegation

  • Unbonding queue

  • User preferences

• State transitions

  • Delegations

  • Begin unbonding

  • Complete unbonding

• Messages

  • MsgJoinService

  • MsgLeaveService

  • MsgAddOperatorToAllowList

  • MsgRemoveOperatorFromAllowlist

  • MsgBorrowPoolSecurity

  • MsgCeasePoolSecurityBorrow

  • MsgDelegatePool

  • MsgUndelegatePool

  • MsgDelegateOperator

  • MsgUndelegateOperator

  • MsgDelegateService

  • MsgUndelegateService

  • MsgSetUserPreferences

  • MsgUpdateParams

• End-Block

  • Unbonding Delegations

• Hooks

• Events

• Parameters

State

Unbonding ID

UnbondingID stores the ID of the latest unbonding operation. It enables creating unique IDs for unbonding operations, i.e., UnbondingID is incremented every time a new unbonding operation (pool undelegation, service undelegation and operator undelegation) is initiated.

• Unbonding ID: 0x01 -> uint64

Unbonding index

UnbondingIndex maintains indexes used to acquire the key of a UnbondingDelegation based on its unique identifier,UnbondingID.

• UnbondingIndex: 0x02 | UnbondingID -> UnbondingDelegationKey

Unbonding type

UnbondingType represents the type of UnbondingDelegation, indicating to which entity (pool, operator, or service) the unbonding delegation is related. This information can be used to determine the appropriate actions to take when aUnbondingDelegation has completed and the funds should be returned to the user's account.

• UnbondingType: 0x03 | UnbondingID -> TargetID

Operator joined services

OperatorJoinedServices maintains a record of the services that an operator has joined.

• OperatorJoinedServices: collections.NewIndexedMap(0x13)

Service operators allow list

ServiceOperatorsAllowList stores which operators are allowed to join a service. It enables the creation of a whitelist of operators that can join a service.

• ServiceOperatorsAllowList: collections.KeySet(0x14)

Service securing pools

ServiceSecuringPools stores from which pools a service is borrowing security.

• ServiceSecuringPools: collections.KeySet(0x15)

Service joined by operator

ServiceJoinedByOperator stores the indexes to perform a reverse lookup of Operator joined services. It allows to obtain the list of operators that have joined a specific service.

• ServiceJoinedByOperator: indexes.NewReversePair(0x16)

Pool delegation

PoolDelegation stores the delegation made by a user toward a pool. It allows to obtain all the user's delegation toward a pool and to quick check if a user has delegated toward a specific pool.

• PoolDelegation: 0xa1 | UserAddr | PoolID -> ProtocolBuffer(Delegation)

Pool delegations by pool ID

PoolDelegation stores the delegations made toward a specific pool. It allows to perform a reverse lookup of Pool delegation.

• PoolDelegationsByPoolID: 0xa2 | PoolID | UserAddr -> []byte{}

Pool unbonding delegation

PoolUnbondingDelegation stores the pools unbonding delegation made by a user. It allows to obtain a user's pool unbonding delegation.

• PoolUnbondingDelegation: 0xa3 | UserAddr | PoolID -> ProtocolBuffer(UnbondingDelegation)

Operator delegation

OperatorDelegation stores the delegation made by a user toward an operator. It allows to obtain all the user's delegation toward an operator and to quick check if a user has delegated toward a specific operator.

• OperatorDelegation: 0xb1 | UserAddr | OperatorID -> ProtocolBuffer(Delegation)

Operator delegations by operator ID

OperatorDelegationsByOperatorID stores the delegations made toward a specific operator. It allows to perform a reverse lookup of Operator delegation.

• OperatorDelegationsByOperatorID: 0xb2 | OperatorID | UserAddr -> []byte{}

Operator unbonding delegation

OperatorUnbondingDelegation stores the users' unbonding delegation that are related to an operator. It allows to obtain a user's operator unbonding delegation.

• OperatorUnbondingDelegation: 0xb3 | UserAddr | OperatorID -> ProtocolBuffer(UnbondingDelegation)

Service delegation

ServiceDelegation stores the delegation made by a user toward a service. It allows to obtain all the user's delegation toward a service and to quick check if a user has delegated toward a specific service.

• ServiceDelegation: 0xc1 | UserAddr | ServiceID -> ProtocolBuffer(Delegation)

Service delegations by service ID

ServiceDelegationsByServiceID stores the delegations made toward a specific service. It allows to perform a reverse lookup of Service delegation.

• ServiceDelegationsByServiceID: 0xc2 | ServiceID | UserAddr -> []byte{}

Service unbonding delegation

ServiceUnbondingDelegation stores the users' unbonding delegation that are related to a service. It allows to obtain a user's service unbonding delegation.

• ServiceUnbondingDelegation: 0xc3 | UserAddr | ServiceID -> ProtocolBuffer(UnbondingDelegation)

Unbonding queue

UnbondingQueue stores the timestamp at which a list of UnbodingDelegation completes and the delegated funds should return to the user's account.

• UnbondingQueue: 0xd1 | Timestamp -> ProtocolBuffer(DTDataList)

User preferences

UserPreferences stores the users' preferences.

• UserPreferences: collections.NewMap[string, UserPreferences](0xe1)

State transitions

Delegations

When a delegation occurs the target object is affected together with the internal state of the module. The target object can be a Pool, Operator or Service.

• determine the delegators shares based on the tokens delegated and the total amount of tokens delegated toward the target

• creates a new Delegation or update an existing one with the computed shares

• move the tokens from the delegator account to the target's account

• store the Delegation object in the target's delegation store (PoolDelegation, OperatorDelegation orServiceDelegation)

• store the index to perform the inverse look of all the delegations given the target id (PoolDelegationByUser,OperatorDelegationByUser or ServiceDelegationByUser)

Begin unbonding

When a user perform an UndelegatePool, UndelegateOperator or UndelegateService the following operations occur:

• determine the shares based the amount of tokens that the user want to undelegate

• subtract the computed shares from the Delegation object. In case the final shares are 0 the Delegation object will be removed

• subtract the undelegated tokens from the Target total delegated tokens

• computes the time when the undelegated tokens will be returned to the user

• increments the UnbondingID

• creates a new UnbondingDelegation or obtain an existing UnbondingDelegation in case the user was already undelegating some tokens from the target

• adds a new UnbondingDelegationEntry to the UnbondingDelegation

• stores the UnbondingDelegation, this is stored in UserPoolUnbondingDelegation for pools,UserOperatorUnbondingDelegation for operators and UserServiceUnbondingDelegation for services

• stores an index to retrive the UnbondingDelegation given an UnbondingID

• stores in the UnbondingQueue when the UnbondingDelegation completes

Complete unbonding

When an UnbondingDelegationEntry matures the following operations occur:

• remove the index that associates the UnbondigID with the UnbondingDelegation object

• transfer the unbonded tokens from the target to the user

• removes the UnbondingDelegationEntry from the UnbondingDelegation object

• store the updated UnbondingDelegation or deletes in case the removed UnbondingDelegationEntry was the last one

Messages

In this section we describe the processing of the restaking messages.

MsgJoinService

It allows the operator's admin to start securing a AVS.

// MsgJoinService defines the message structure for the
// JoinService gRPC service method. It allows the operator admin to
// start securing a AVS.
message MsgJoinService {
  option (cosmos.msg.v1.signer) = "sender";
  option (amino.name) = "milkyway/MsgJoinService";

  string sender = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  uint32 operator_id = 2 [(gogoproto.customname) = "OperatorID"];

  uint32 service_id = 3 [(gogoproto.customname) = "ServiceID"];
}

This message is expected to fail if:

• the sender is not the Operator admin

• the service that the admin wants to join is no logger active

• the operator is not in the service's operators allow list

MsgLeaveService

It allows the operator's admin to stop securing an AVS.

// MsgLeaveService defines the message structure for the
// LeaveService gRPC service method. It allows the operator admin to
// stop securing a AVS.
message MsgLeaveService {
  option (cosmos.msg.v1.signer) = "sender";
  option (amino.name) = "milkyway/MsgLeaveService";

  string sender = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  uint32 operator_id = 2 [(gogoproto.customname) = "OperatorID"];

  uint32 service_id = 3 [(gogoproto.customname) = "ServiceID"];
}

This message is expected to fail if:

• the sender is not the Operator admin

• the Operator didn't join the service

MsgAddOperatorToAllowList

It allows the service admin to add an operator to the list of allowed operator to secure the service. If the service didn't have an allow list after adding the operator to the allow list all the operators not in the allow list will be stopped from securing the service.

// MsgAddOperatorToAllowList defines the message structure for the
// AddOperatorToAllowList gRPC service method. It allows the service admin
// to add an operator to the list of allowed operator to secure the service.
message MsgAddOperatorToAllowList {
  option (cosmos.msg.v1.signer) = "sender";
  option (amino.name) = "milkyway/MsgAddOperatorToAllowList";

  string sender = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  uint32 service_id = 2 [(gogoproto.customname) = "ServiceID"];

  uint32 operator_id = 3 [(gogoproto.customname) = "OperatorID"];
}

This message is expected to fail if:

• the sender is not the Service admin

• the Operator is already in the allow list

MsgRemoveOperatorFromAllowlist

It allows the service admin to remove an operator to the list of allowed operator to secure the service. If the operator was securing the service will be stopped from securing it. When the last operator is removed from the allow list the service will allow all operators to join.

// MsgRemoveOperatorFromAllowlist defines the message structure for the
// RemoveOperatorFromAllowlist gRPC service method. It allows the service admin
// to remove a previously added operator from the list of allowed operators
// to secure the service.
message MsgRemoveOperatorFromAllowlist {
  option (cosmos.msg.v1.signer) = "sender";
  option (amino.name) = "milkyway/MsgRemoveOperatorFromAllowlist";

  string sender = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  uint32 service_id = 2 [(gogoproto.customname) = "ServiceID"];

  uint32 operator_id = 3 [(gogoproto.customname) = "OperatorID"];
}

This message is expected to fail if:

• the sender is not the Service admin

• the Operator is not in the Service's allow list

MsgBorrowPoolSecurity

It allows the service admin to add a pool to the list of pools from which the service has chosen to borrow security.

// MsgBorrowPoolSecurity defines the message structure for the
// BorrowPoolSecurity gRPC service method. It allows the service admin
// to add a pool to the list of pools from which the service has chosen
// to borrow security.
message MsgBorrowPoolSecurity {
  option (cosmos.msg.v1.signer) = "sender";
  option (amino.name) = "milkyway/MsgBorrowPoolSecurity";

  string sender = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  uint32 service_id = 2 [(gogoproto.customname) = "ServiceID"];

  uint32 pool_id = 3 [(gogoproto.customname) = "PoolID"];
}

This message is expected to fail if:

• the sender is not the Service admin

• the Service is inactive

• the Service is already secured by the provided Pool

MsgCeasePoolSecurityBorrow

It allows the service admin to remove a pool from the list of pools from which the service has chosen to borrow security.

// MsgCeasePoolSecurityBorrow defines the message structure for the
// CeaseBorrowPoolSecurity gRPC service method. It allows the service admin
// to remove a pool from the list of pools from which the service has chosen
// to borrow security.
message MsgCeasePoolSecurityBorrow {
  option (cosmos.msg.v1.signer) = "sender";
  option (amino.name) = "milkyway/MsgCeasePoolSecurityBorrow";

  string sender = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  uint32 service_id = 2 [(gogoproto.customname) = "ServiceID"];

  uint32 pool_id = 3 [(gogoproto.customname) = "PoolID"];
}

This message is expected to fail if:

• the sender is not the Service admin

• the Service is not secured by the provided Pool

MsgDelegatePool

It allows a user to put their assets into a restaking pool that will later be used to provide cryptoeconomic security to services that choose it.

// MsgDelegatePool defines the message structure for the DelegatePool gRPC
// service method. It allows a user to put their assets into a restaking pool
// that will later be used to provide cryptoeconomic security to services that
// choose it.
message MsgDelegatePool {
  option (cosmos.msg.v1.signer) = "delegator";
  option (amino.name) = "milkyway/MsgDelegatePool";

  // Delegator is the address of the user joining the pool
  string delegator = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // Amount is the amount of coins to be staked
  cosmos.base.v1beta1.Coin amount = 2 [
    (gogoproto.customname) = "Amount",
    (gogoproto.nullable) = false
  ];
}

This message is expected to fail if:

• the denom of the coin that the user wants to delegate is not allowed

• the sender don't have the amount of coin that wants to delegate

MsgUndelegatePool

It allows a user to undelegate their assets from a restaking pool.

// MsgUndelegatePool the message structure for the UndelegatePool gRPC service
// method. It allows a user to undelegate their assets from a restaking pool.
message MsgUndelegatePool {
  option (cosmos.msg.v1.signer) = "delegator";
  option (amino.name) = "milkyway/MsgUndelegatePool";

  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  // Delegator is the address of the user undelegating from the pool.
  string delegator = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // Amount is the amount of coins to be undelegated.
  cosmos.base.v1beta1.Coin amount = 2 [
    (gogoproto.nullable) = false,
    (amino.dont_omitempty) = true
  ];
}

This message is expected to fail if:

• the user wants to undelegates an amount greater than the amount delegated

MsgDelegateOperator

It allows a user to delegate their assets to an operator.

// MsgDelegateOperator defines the message structure for the DelegateOperator
// gRPC service method. It allows a user to delegate their assets to an
// operator.
message MsgDelegateOperator {
  option (cosmos.msg.v1.signer) = "delegator";
  option (amino.name) = "milkyway/MsgDelegateOperator";

  // Delegator is the address of the user delegating to the operator
  string delegator = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // OperatorID is the ID of the operator to delegate to
  uint32 operator_id = 2 [(gogoproto.customname) = "OperatorID"];

  // Amount is the amount of coins to be delegated
  repeated cosmos.base.v1beta1.Coin amount = 3 [
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins",
    (gogoproto.customname) = "Amount",
    (gogoproto.nullable) = false
  ];
}

This message is expected to fail if:

• don't exist an Operator with the given id

• the Operator is not active

• the denom of the coin that the user wants to delegate is not allowed

• the sender don't have the amount of coin that wants to delegate

MsgUndelegateOperator

It allows a user to undelegate their assets from a restaking operator.

// MsgUndelegateOperator the message structure for the UndelegateOperator gRPC
// service method. It allows a user to undelegate their assets from a restaking
// operator.
message MsgUndelegateOperator {
  option (cosmos.msg.v1.signer) = "delegator";
  option (amino.name) = "milkyway/MsgUndelegateOperator";

  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  // Delegator is the address of the user undelegating from the operator.
  string delegator = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // OperatorID is the ID of the operator to undelegate from.
  uint32 operator_id = 2 [(gogoproto.customname) = "OperatorID"];

  // Amount is the amount of coins to be undelegated.
  repeated cosmos.base.v1beta1.Coin amount = 3 [
    (gogoproto.nullable) = false,
    (amino.dont_omitempty) = true,
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"
  ];
}

This message is expected to fail if:

• don't exist an Operator with the given id

• the user wants to undelegates an amount greater than the amount delegated toward that operator

MsgDelegateService

It allows a user to delegate their assets to a service.

// MsgDelegateService defines the message structure for the DelegateService gRPC
// service method. It allows a user to delegate their assets to a service.
message MsgDelegateService {
  option (cosmos.msg.v1.signer) = "delegator";
  option (amino.name) = "milkyway/MsgDelegateService";

  // Delegator is the address of the user delegating to the service
  string delegator = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // ServiceID is the ID of the service to delegate to
  uint32 service_id = 2 [(gogoproto.customname) = "ServiceID"];

  // Amount is the amount of coins to be delegated
  repeated cosmos.base.v1beta1.Coin amount = 3 [
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins",
    (gogoproto.customname) = "Amount",
    (gogoproto.nullable) = false
  ];
}

This message is expected to fail if:

• don't exist a Service with the given id

• the denom of the coin that the user wants to delegate is not allowed

• the sender don't have the amount of coin that wants to delegate

MsgUndelegateService

It allows a user to undelegate their assets from a restaking service.

// MsgUndelegateService the message structure for the UndelegateService gRPC
// service method. It allows a user to undelegate their assets from a restaking
// service.
message MsgUndelegateService {
  option (cosmos.msg.v1.signer) = "delegator";
  option (amino.name) = "milkyway/MsgUndelegateService";

  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  // Delegator is the address of the user undelegating from the service.
  string delegator = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // ServiceID is the ID of the service to undelegate from.
  uint32 service_id = 2 [(gogoproto.customname) = "ServiceID"];

  // Amount is the amount of coins to be undelegated.
  repeated cosmos.base.v1beta1.Coin amount = 3 [
    (gogoproto.nullable) = false,
    (amino.dont_omitempty) = true,
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"
  ];
}

This message is expected to fail if:

• don't exist a Service with the given id

• the user wants to undelegates an amount greater than the amount delegated toward that operator

MsgSetUserPreferences

It allows a user to set their preferences for the restaking module.

// MsgSetUserPreferences is the message structure for the SetUserPreferences
// gRPC service method. It allows a user to set their preferences for the
// restaking module.
message MsgSetUserPreferences {
  option (cosmos.msg.v1.signer) = "user";
  option (amino.name) = "milkyway/MsgSetUserPreferences";

  // User is the address of the user setting their preferences
  string user = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];

  // Preferences is the user's preferences
  UserPreferences preferences = 2 [(gogoproto.nullable) = false];
}

User preferences:

// UserPreferences is a struct that contains a user's preferences for
// restaking.
message UserPreferences {
  // TrustedServices is a list of services that the user trusts
  repeated TrustedServiceEntry trusted_services = 4 [
    (gogoproto.customname) = "TrustedServices",
    (gogoproto.nullable) = false
  ];

  reserved 1 to 3; // trusted_non_accredited_services, trust_accredited_services, trusted_services_ids
}

// TrustedServiceEntry is a struct that contains the ID of a service that the user trusts
// and the IDs of the pools that the user wants the service to access
message TrustedServiceEntry {
  // ServiceID represents the ID of the service that the user trusts
  uint32 service_id = 1 [(gogoproto.customname) = "ServiceID"];

  // PoolsIDs represents the IDs of the pools that the user wants the service with ServiceID to access
  repeated uint32 pools_ids = 2 [(gogoproto.customname) = "PoolsIDs"];
}

This message is expected to fail if:

• one or more service specified in the preferences don't exist

• one or more pool specified in the preferences don't exist

MsgUpdateParams

Allows to update the module parameters. The params are updated through a governance proposal where the signer is the gov module account address.

// MsgUpdateParams defines the message structure for the UpdateParams gRPC
// service method. It allows the authority to update the module parameters.
message MsgUpdateParams {
  option (cosmos.msg.v1.signer) = "authority";
  option (amino.name) = "milkyway/restaking/MsgUpdateParams";

  // Authority is the address that controls the module (defaults to x/gov unless
  // overwritten).
  string authority = 1 [
    (gogoproto.moretags) = "yaml:\"authority\"",
    (cosmos_proto.scalar) = "cosmos.AddressString"
  ];

  // Params define the parameters to update.
  //
  // NOTE: All parameters must be supplied.
  Params params = 2 [(gogoproto.nullable) = false];
}

Params:

// Params defines the parameters for the module.
message Params {
  // UnbondingTime represents the time that will take for assets to be unbonded
  // after the user initiates an unbonding request. This will be applied to all
  // types of restaking: pool, operator and service restaking.
  int64 unbonding_time = 1 [(gogoproto.stdduration) = true];

  // AllowedDenoms represents the list of denoms allowed for restaking
  // and that will be considered when computing rewards. If no denoms are set,
  // all denoms will be considered as restakable.
  repeated string allowed_denoms = 2;

  // RestakingCap represents the maximum USD value of overall restaked assets
  // inside the chain. If set to 0, it indicates no limit, allowing any amount
  // of assets to be restaked.
  string restaking_cap = 3 [
    (cosmos_proto.scalar) = "cosmos.Dec",
    (gogoproto.customtype) = "cosmossdk.io/math.LegacyDec",
    (gogoproto.nullable) = false
  ];
}

End-Block

In this section we describe the operation that this modules executes during each abci end block call.

Unbonding delegations

Complete the unbonding of all mature UnbondingDelegations.Entries within the UnbondingQueue with the following procedure:

• removes the index that associates the UnbondigID with the UnbondingDelegation object

• transfer the unbonded tokens from the target to the user

• removes the UnbondingDelegationEntry from the UnbondingDelegation object

• store the updated UnbondingDelegation or deletes in case the removed UnbondingDelegationEntry was the last one

Hooks

Other modules may register operations to execute when a certain event has occurred within the restaking module. The following hooks can be registered with restaking:

• BeforePoolDelegationCreated(ctx context.Context, poolID uint32, delegator string) error

  • called before a new Delegation object associated to a Pool is created

• BeforePoolDelegationSharesModified(ctx context.Context, poolID uint32, delegator string) error

  • called before the shares of Delegation object associated a Pool are modified

• AfterPoolDelegationModified(ctx context.Context, poolID uint32, delegator string) error

  • called after a Delegation object associated to a Pool is modified

• BeforePoolDelegationRemoved(ctx context.Context, poolID uint32, delegator string) error

  • called after a Delegation object associated to a Pool is removed

• BeforeOperatorDelegationCreated(ctx context.Context, operatorID uint32, delegator string) error

  • called before a new Delegation object associated to a Operator is created

• BeforeOperatorDelegationSharesModified(ctx context.Context, operatorID uint32, delegator string) error

  • called before the shares of Delegation object associated a Operator are modified

• AfterOperatorDelegationModified(ctx context.Context, operatorID uint32, delegator string) error

  • called after a Delegation object associated to a Operator is modified

• BeforeOperatorDelegationRemoved(ctx context.Context, operatorID uint32, delegator string) error

  • called after a Delegation object associated to a Operator is removed

• BeforeServiceDelegationCreated(ctx context.Context, serviceID uint32, delegator string) error

  • called before a new Delegation object associated to a Service is created

• BeforeServiceDelegationSharesModified(ctx context.Context, serviceID uint32, delegator string) error

  • called before the shares of Delegation object associated a Service are modified

• AfterServiceDelegationModified(ctx context.Context, serviceID uint32, delegator string) error

  • called after a Delegation object associated to a Service is modified

• BeforeServiceDelegationRemoved(ctx context.Context, serviceID uint32, delegator string) error

  • called after a Delegation object associated to a Service is removed

• AfterUnbondingInitiated(ctx context.Context, unbondingDelegationID uint64) error

  • called after a new UnbondingDelegation is created

AfterUserPreferencesModified(ctx context.Context, userAddress string, oldPreferences, newPreferences UserPreferences) error

• called after a user's preferences are modified

Events

The restaking module emits the following events:

EndBlocker

Type	Attribute Key	Attribute Value
complete_unbonding	amount	{totalUnbondingAmount}
complete_unbonding	unbonding_delegation	{unbondingDelegationTargetType}
complete_redelegation	target_id	{delegationTargetId}
complete_unbonding	delegator	{delegatorAddress}

MsgJoinService

Type	Attribute Key	Attribute Value
join_service	operator_id	{operatorId}
join_service	service_id	{serviceId}

MsgLeaveService

Type	Attribute Key	Attribute Value
leave_service	operator_id	{operatorId}
leave_service	service_id	{serviceId}

MsgAddOperatorToAllowList

Type	Attribute Key	Attribute Value
allow_operator	operator_id	{operatorId}
allow_operator	service_id	{serviceId}

MsgRemoveOperatorFromAllowlist

Type	Attribute Key	Attribute Value
remove_allowed_operator	operator_id	{operatorId}
remove_allowed_operator	service_id	{serviceId}

MsgBorrowPoolSecurity

Type	Attribute Key	Attribute Value
borrow_pool_security	service_id	{serviceId}
borrow_pool_security	pool_id	{poolId}

MsgCeasePoolSecurityBorrow

Type	Attribute Key	Attribute Value
cease_pool_security_borrow	service_id	{serviceId}
cease_pool_security_borrow	pool_id	{poolId}

MsgDelegatePool

Type	Attribute Key	Attribute Value
delegate_pool	delegator	{delegatorAddress}
delegate_pool	amount	{delegationAmount}
delegate_pool	new_shares	{newShares}

MsgUndelegatePool

Type	Attribute Key	Attribute Value
unbond_pool	amount	{unbondAmount}
unbond_pool	delegator	{delegatorAddress}
unbond_pool	completion_time	{completionTime}

MsgDelegateOperator

Type	Attribute Key	Attribute Value
delegate_operator	delegator	{delegatorAddress}
delegate_operator	operator_id	{operatorID}
delegate_operator	amount	{delegationAmount}
delegate_operator	new_shares	{newShares}

MsgUndelegateOperator

Type	Attribute Key	Attribute Value
unbond_operator	amount	{unbondAmount}
unbond_operator	delegator	{delegatorAddress}
unbond_operator	operator_id	{operatorID}
unbond_operator	completion_time	{completionTime}

MsgDelegateService

Type	Attribute Key	Attribute Value
delegate_service	delegator	{delegatorAddress}
delegate_service	service_id	{serviceID}
delegate_service	amount	{delegationAmount}
delegate_service	new_shares	{newShares}

MsgUndelegateService

Type	Attribute Key	Attribute Value
unbond_service	amount	{unbondAmount}
unbond_service	delegator	{delegatorAddress}
unbond_service	service_id	{serviceID}
unbond_service	completion_time	{completionTime}

MsgSetUserPreferences

Type	Attribute Key	Attribute Value
set_user_preferences	user	{userAddress}

Parameters

The restaking module contains the following parameters:

Key	Type	Example
UnbondingTime	string (time ns)	"259200000000000"
AllowedDenoms	[]string	{"utia", "uusdc"}
RestakingCap	sdkmath.LegacyDec	"259200000000000"
MaxEntries	uint32	7