cosmos-sdk/docs/spec/ibc/mvp3.md

IBC Spec

MVP3

IBCOpenMsg is added to open the connection between two chains. Also, IBCUpdateMsg is added, making it able to prove the header.

IBC Module

// User facing API

type IBCTransferData struct {
    SrcAddr  sdk.Address
    DestAddr sdk.Address
    Coins    sdk.Coins
}

// Implements sdk.Msg
type IBCTransferMsg struct {
    IBCTransferData
}

// Implements sdk.Msg
type IBCReceiveMsg struct {
    IBCTransferData    
}

type IBCPacket struct {
    Msg       IBCMsg
    SrcChain  string    
    DestChain string
}

type RootOfTrust struct {
    // 
}

// Implements sdk.Msg
type IBCOpenMsg struct {
    ROT   RootOfTrust
    Chain string   
}

// Implements sdk.Msg
type IBCUpdateMsg struct {
    Header tm.Header
    Commit tm.Commit
}

// Internal API

func NewHandler(router sdk.Router, ibcm IBCMapper) sdk.Handler

type IBCMapper struct {
    ingressKey sdk.StoreKey // ChannelID              => last income msg's sequence
    egressKey  sdk.StoreKey // (ChannelID, Msg index) => length / indexed msg
    headerKey  sdk.StoreKey // ChannelID              => last known header
}

type IngressKey struct {
    ChannelID uint64
}

type EgressKey struct {
    ChannelID uint64
    Index     int64
}

type HeaderKey struct {
    ChannelID uint64
}

// Used by other modules
func (ibcm IBCMapper) PushPacket(ctx sdk.Context, dest string, packet IBCTransferPacket)