Skip to content

04_state_transition.md

Latest commit

 

History

History
76 lines (45 loc) · 2.31 KB

04_state_transition.md

File metadata and controls

76 lines (45 loc) · 2.31 KB
Raw

PEP State Transitions

EncryptedTx

This state is modified in the following cases:

  • When an encrypted transaction is submitted by a user
  • When an encrypted transaction is executed from the store in the BeginBlock at its target height.

Ref:

func (k msgServer) SubmitEncryptedTx(goCtx context.Context, msg *types.MsgSubmitEncryptedTx) (*types.MsgSubmitEncryptedTxResponse, error)

func (am AppModule) BeginBlock(ctx sdk.Context, _ abci.RequestBeginBlock)

PepNonce

This state is modified when an encrypted transaction is about to be processed in the begin block at the target height.

Ref:

func (am AppModule) BeginBlock(ctx sdk.Context, _ abci.RequestBeginBlock)

ActivePubKey

The active public key is only modified from the end block of the PEP module.

It is modified in the following 2 scenarios:

  • No active pubkey exists, but there is a queued pubkey. In this case, the queued pubkey becomes active.
  • Active pubkey expires. In this case, if a queued pubkey exists, it replaces the active pubkey.

Ref:

func (am AppModule) EndBlock(ctx sdk.Context, _ abci.RequestEndBlock) []abci.ValidatorUpdate

QueuedPubKey

The queued public key is modified by receiving an acknowledgement IBC packet. It can also be modified in the end block of the PEP module.

  • On receiving acknowledgement to the CurrentKeysPacketData IBC packet
  • End Block: If the active public key is not found or expires, the queued pubkey replaces it and is deleted.

Ref:

func (k Keeper) OnAcknowledgementCurrentKeysPacket(ctx sdk.Context, packet channeltypes.Packet, data types.CurrentKeysPacketData, ack channeltypes.Acknowledgement)

func (am AppModule) EndBlock(ctx sdk.Context, _ abci.RequestEndBlock) []abci.ValidatorUpdate

AggregatedKeyShare

This state is modified when a transaction is made (normally by the FairyPort service) to register a new aggregated keyshare generated in the FairyRing chain. Unlike other transactions, this transaction is not normally executed. Instead, at the beginning block of the PEP module, transactions with message type MsgCreateAggregatedKeyShare are searched for in the mempool. If found, these messages are then automatically executed.

Ref:

func (k Keeper) ProcessUnconfirmedTxs(ctx sdk.Context, utxs *coretypes.ResultUnconfirmedTxs) error