types

package
v0.0.0-...-7c30539 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 25, 2020 License: Apache-2.0 Imports: 22 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	// ModuleName is the name of this module
	ModuleName = "upgrade"

	// RouterKey is used to route governance proposals
	RouterKey = ModuleName

	// StoreKey is the prefix under which we store this module's data
	StoreKey = ModuleName

	// QuerierKey is used to handle abci_query requests
	QuerierKey = ModuleName
)
View Source 
const (
	// PlanByte specifies the Byte under which a pending upgrade plan is stored in the store
	PlanByte = 0x0
	// DoneByte is a prefix for to look up completed upgrade plan by name
	DoneByte = 0x1
)
View Source 
const (
	ProposalTypeSoftwareUpgrade       string = "SoftwareUpgrade"
	ProposalTypeCancelSoftwareUpgrade string = "CancelSoftwareUpgrade"
)
View Source 
const (
	QueryCurrent = "current"
	QueryApplied = "applied"
)

query endpoints supported by the upgrade Querier

Variables

View Source 
var (
	ErrInvalidLengthQuery        = fmt.Errorf("proto: negative length found during unmarshaling")
	ErrIntOverflowQuery          = fmt.Errorf("proto: integer overflow")
	ErrUnexpectedEndOfGroupQuery = fmt.Errorf("proto: unexpected end of group")
)
View Source 
var (
	ErrInvalidLengthUpgrade        = fmt.Errorf("proto: negative length found during unmarshaling")
	ErrIntOverflowUpgrade          = fmt.Errorf("proto: integer overflow")
	ErrUnexpectedEndOfGroupUpgrade = fmt.Errorf("proto: unexpected end of group")
)

Functions

func NewCancelSoftwareUpgradeProposal 

func NewCancelSoftwareUpgradeProposal(title, description string) gov.Content

func NewSoftwareUpgradeProposal 

func NewSoftwareUpgradeProposal(title, description string, plan Plan) gov.Content

func PlanKey 

func PlanKey() []byte

PlanKey is the key under which the current plan is saved We store PlanByte as a const to keep it immutable (unlike a []byte)

func RegisterCodec 

func RegisterCodec(cdc *codec.Codec)

RegisterCodec registers concrete types on the Amino codec

func RegisterInterfaces 

func RegisterInterfaces(registry types.InterfaceRegistry)

func RegisterQueryServer 

func RegisterQueryServer(s grpc1.Server, srv QueryServer)

func UpgradeStoreLoader 

func UpgradeStoreLoader(upgradeHeight int64, storeUpgrades *store.StoreUpgrades) baseapp.StoreLoader

UpgradeStoreLoader is used to prepare baseapp with a fixed StoreLoader pattern. This is useful for custom upgrade loading logic.

Types

type CancelSoftwareUpgradeProposal 

type CancelSoftwareUpgradeProposal struct {
	Title       string `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
}

CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade

func (*CancelSoftwareUpgradeProposal) Descriptor 

func (*CancelSoftwareUpgradeProposal) Descriptor() ([]byte, []int)

func (*CancelSoftwareUpgradeProposal) Equal 

func (this *CancelSoftwareUpgradeProposal) Equal(that interface{}) bool

func (*CancelSoftwareUpgradeProposal) GetDescription 

func (sup *CancelSoftwareUpgradeProposal) GetDescription() string

func (*CancelSoftwareUpgradeProposal) GetTitle 

func (sup *CancelSoftwareUpgradeProposal) GetTitle() string

func (*CancelSoftwareUpgradeProposal) Marshal 

func (m *CancelSoftwareUpgradeProposal) Marshal() (dAtA []byte, err error)

func (*CancelSoftwareUpgradeProposal) MarshalTo 

func (m *CancelSoftwareUpgradeProposal) MarshalTo(dAtA []byte) (int, error)

func (*CancelSoftwareUpgradeProposal) MarshalToSizedBuffer 

func (m *CancelSoftwareUpgradeProposal) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*CancelSoftwareUpgradeProposal) ProposalRoute 

func (sup *CancelSoftwareUpgradeProposal) ProposalRoute() string

func (*CancelSoftwareUpgradeProposal) ProposalType 

func (sup *CancelSoftwareUpgradeProposal) ProposalType() string

func (*CancelSoftwareUpgradeProposal) ProtoMessage 

func (*CancelSoftwareUpgradeProposal) ProtoMessage()

func (*CancelSoftwareUpgradeProposal) Reset 

func (m *CancelSoftwareUpgradeProposal) Reset()

func (*CancelSoftwareUpgradeProposal) Size 

func (m *CancelSoftwareUpgradeProposal) Size() (n int)

func (CancelSoftwareUpgradeProposal) String 

func (sup CancelSoftwareUpgradeProposal) String() string

func (*CancelSoftwareUpgradeProposal) Unmarshal 

func (m *CancelSoftwareUpgradeProposal) Unmarshal(dAtA []byte) error

func (*CancelSoftwareUpgradeProposal) ValidateBasic 

func (sup *CancelSoftwareUpgradeProposal) ValidateBasic() error

func (*CancelSoftwareUpgradeProposal) XXX_DiscardUnknown 

func (m *CancelSoftwareUpgradeProposal) XXX_DiscardUnknown()

func (*CancelSoftwareUpgradeProposal) XXX_Marshal 

func (m *CancelSoftwareUpgradeProposal) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*CancelSoftwareUpgradeProposal) XXX_Merge 

func (m *CancelSoftwareUpgradeProposal) XXX_Merge(src proto.Message)

func (*CancelSoftwareUpgradeProposal) XXX_Size 

func (m *CancelSoftwareUpgradeProposal) XXX_Size() int

func (*CancelSoftwareUpgradeProposal) XXX_Unmarshal 

func (m *CancelSoftwareUpgradeProposal) XXX_Unmarshal(b []byte) error

type Plan 

type Plan struct {
	// Sets the name for the upgrade. This name will be used by the upgraded version of the software to apply any
	// special "on-upgrade" commands during the first BeginBlock method after the upgrade is applied. It is also used
	// to detect whether a software version can handle a given upgrade. If no upgrade handler with this name has been
	// set in the software, it will be assumed that the software is out-of-date when the upgrade Time or Height
	// is reached and the software will exit.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The time after which the upgrade must be performed.
	// Leave set to its zero value to use a pre-defined Height instead.
	Time time.Time `protobuf:"bytes,2,opt,name=time,proto3,stdtime" json:"time"`
	// The height at which the upgrade must be performed.
	// Only used if Time is not set.
	Height int64 `protobuf:"varint,3,opt,name=height,proto3" json:"height,omitempty"`
	// Any application specific upgrade info to be included on-chain
	// such as a git commit that validators could automatically upgrade to
	Info string `protobuf:"bytes,4,opt,name=info,proto3" json:"info,omitempty"`
}

Plan specifies information about a planned upgrade and when it should occur

func (*Plan) Descriptor 

func (*Plan) Descriptor() ([]byte, []int)

func (Plan) DueAt 

func (p Plan) DueAt() string

DueAt is a string representation of when this plan is due to be executed

func (*Plan) Equal 

func (this *Plan) Equal(that interface{}) bool

func (*Plan) Marshal 

func (m *Plan) Marshal() (dAtA []byte, err error)

func (*Plan) MarshalTo 

func (m *Plan) MarshalTo(dAtA []byte) (int, error)

func (*Plan) MarshalToSizedBuffer 

func (m *Plan) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*Plan) ProtoMessage 

func (*Plan) ProtoMessage()

func (*Plan) Reset 

func (m *Plan) Reset()

func (Plan) ShouldExecute 

func (p Plan) ShouldExecute(ctx sdk.Context) bool

ShouldExecute returns true if the Plan is ready to execute given the current context

func (*Plan) Size 

func (m *Plan) Size() (n int)

func (Plan) String 

func (p Plan) String() string

func (*Plan) Unmarshal 

func (m *Plan) Unmarshal(dAtA []byte) error

func (Plan) ValidateBasic 

func (p Plan) ValidateBasic() error

ValidateBasic does basic validation of a Plan

func (*Plan) XXX_DiscardUnknown 

func (m *Plan) XXX_DiscardUnknown()

func (*Plan) XXX_Marshal 

func (m *Plan) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*Plan) XXX_Merge 

func (m *Plan) XXX_Merge(src proto.Message)

func (*Plan) XXX_Size 

func (m *Plan) XXX_Size() int

func (*Plan) XXX_Unmarshal 

func (m *Plan) XXX_Unmarshal(b []byte) error

type QueryAppliedPlanRequest 

type QueryAppliedPlanRequest struct {
	// name is the name of the applied plan to query for
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
}

QueryCurrentPlanRequest is the request type for the Query/AppliedPlan RPC method

func (*QueryAppliedPlanRequest) Descriptor 

func (*QueryAppliedPlanRequest) Descriptor() ([]byte, []int)

func (*QueryAppliedPlanRequest) GetName 

func (m *QueryAppliedPlanRequest) GetName() string

func (*QueryAppliedPlanRequest) Marshal 

func (m *QueryAppliedPlanRequest) Marshal() (dAtA []byte, err error)

func (*QueryAppliedPlanRequest) MarshalTo 

func (m *QueryAppliedPlanRequest) MarshalTo(dAtA []byte) (int, error)

func (*QueryAppliedPlanRequest) MarshalToSizedBuffer 

func (m *QueryAppliedPlanRequest) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*QueryAppliedPlanRequest) ProtoMessage 

func (*QueryAppliedPlanRequest) ProtoMessage()

func (*QueryAppliedPlanRequest) Reset 

func (m *QueryAppliedPlanRequest) Reset()

func (*QueryAppliedPlanRequest) Size 

func (m *QueryAppliedPlanRequest) Size() (n int)

func (*QueryAppliedPlanRequest) String 

func (m *QueryAppliedPlanRequest) String() string

func (*QueryAppliedPlanRequest) Unmarshal 

func (m *QueryAppliedPlanRequest) Unmarshal(dAtA []byte) error

func (*QueryAppliedPlanRequest) XXX_DiscardUnknown 

func (m *QueryAppliedPlanRequest) XXX_DiscardUnknown()

func (*QueryAppliedPlanRequest) XXX_Marshal 

func (m *QueryAppliedPlanRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*QueryAppliedPlanRequest) XXX_Merge 

func (m *QueryAppliedPlanRequest) XXX_Merge(src proto.Message)

func (*QueryAppliedPlanRequest) XXX_Size 

func (m *QueryAppliedPlanRequest) XXX_Size() int

func (*QueryAppliedPlanRequest) XXX_Unmarshal 

func (m *QueryAppliedPlanRequest) XXX_Unmarshal(b []byte) error

type QueryAppliedPlanResponse 

type QueryAppliedPlanResponse struct {
	// height is the block height at which the plan was applied
	Height int64 `protobuf:"varint,1,opt,name=height,proto3" json:"height,omitempty"`
}

QueryAppliedPlanResponse is the response type for the Query/AppliedPlan RPC method

func (*QueryAppliedPlanResponse) Descriptor 

func (*QueryAppliedPlanResponse) Descriptor() ([]byte, []int)

func (*QueryAppliedPlanResponse) GetHeight 

func (m *QueryAppliedPlanResponse) GetHeight() int64

func (*QueryAppliedPlanResponse) Marshal 

func (m *QueryAppliedPlanResponse) Marshal() (dAtA []byte, err error)

func (*QueryAppliedPlanResponse) MarshalTo 

func (m *QueryAppliedPlanResponse) MarshalTo(dAtA []byte) (int, error)

func (*QueryAppliedPlanResponse) MarshalToSizedBuffer 

func (m *QueryAppliedPlanResponse) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*QueryAppliedPlanResponse) ProtoMessage 

func (*QueryAppliedPlanResponse) ProtoMessage()

func (*QueryAppliedPlanResponse) Reset 

func (m *QueryAppliedPlanResponse) Reset()

func (*QueryAppliedPlanResponse) Size 

func (m *QueryAppliedPlanResponse) Size() (n int)

func (*QueryAppliedPlanResponse) String 

func (m *QueryAppliedPlanResponse) String() string

func (*QueryAppliedPlanResponse) Unmarshal 

func (m *QueryAppliedPlanResponse) Unmarshal(dAtA []byte) error

func (*QueryAppliedPlanResponse) XXX_DiscardUnknown 

func (m *QueryAppliedPlanResponse) XXX_DiscardUnknown()

func (*QueryAppliedPlanResponse) XXX_Marshal 

func (m *QueryAppliedPlanResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*QueryAppliedPlanResponse) XXX_Merge 

func (m *QueryAppliedPlanResponse) XXX_Merge(src proto.Message)

func (*QueryAppliedPlanResponse) XXX_Size 

func (m *QueryAppliedPlanResponse) XXX_Size() int

func (*QueryAppliedPlanResponse) XXX_Unmarshal 

func (m *QueryAppliedPlanResponse) XXX_Unmarshal(b []byte) error

type QueryClient 

type QueryClient interface {
	// CurrentPlan queries the current upgrade plan
	CurrentPlan(ctx context.Context, in *QueryCurrentPlanRequest, opts ...grpc.CallOption) (*QueryCurrentPlanResponse, error)
	// AppliedPlan queries a previously applied upgrade plan by its name
	AppliedPlan(ctx context.Context, in *QueryAppliedPlanRequest, opts ...grpc.CallOption) (*QueryAppliedPlanResponse, error)
}

QueryClient is the client API for Query service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.

func NewQueryClient 

func NewQueryClient(cc grpc1.ClientConn) QueryClient

type QueryCurrentPlanRequest 

type QueryCurrentPlanRequest struct {
}

QueryCurrentPlanRequest is the request type for the Query/CurrentPlan RPC method

func (*QueryCurrentPlanRequest) Descriptor 

func (*QueryCurrentPlanRequest) Descriptor() ([]byte, []int)

func (*QueryCurrentPlanRequest) Marshal 

func (m *QueryCurrentPlanRequest) Marshal() (dAtA []byte, err error)

func (*QueryCurrentPlanRequest) MarshalTo 

func (m *QueryCurrentPlanRequest) MarshalTo(dAtA []byte) (int, error)

func (*QueryCurrentPlanRequest) MarshalToSizedBuffer 

func (m *QueryCurrentPlanRequest) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*QueryCurrentPlanRequest) ProtoMessage 

func (*QueryCurrentPlanRequest) ProtoMessage()

func (*QueryCurrentPlanRequest) Reset 

func (m *QueryCurrentPlanRequest) Reset()

func (*QueryCurrentPlanRequest) Size 

func (m *QueryCurrentPlanRequest) Size() (n int)

func (*QueryCurrentPlanRequest) String 

func (m *QueryCurrentPlanRequest) String() string

func (*QueryCurrentPlanRequest) Unmarshal 

func (m *QueryCurrentPlanRequest) Unmarshal(dAtA []byte) error

func (*QueryCurrentPlanRequest) XXX_DiscardUnknown 

func (m *QueryCurrentPlanRequest) XXX_DiscardUnknown()

func (*QueryCurrentPlanRequest) XXX_Marshal 

func (m *QueryCurrentPlanRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*QueryCurrentPlanRequest) XXX_Merge 

func (m *QueryCurrentPlanRequest) XXX_Merge(src proto.Message)

func (*QueryCurrentPlanRequest) XXX_Size 

func (m *QueryCurrentPlanRequest) XXX_Size() int

func (*QueryCurrentPlanRequest) XXX_Unmarshal 

func (m *QueryCurrentPlanRequest) XXX_Unmarshal(b []byte) error

type QueryCurrentPlanResponse 

type QueryCurrentPlanResponse struct {
	// plan is the current upgrade plan
	Plan *Plan `protobuf:"bytes,1,opt,name=plan,proto3" json:"plan,omitempty"`
}

QueryCurrentPlanResponse is the response type for the Query/CurrentPlan RPC method

func (*QueryCurrentPlanResponse) Descriptor 

func (*QueryCurrentPlanResponse) Descriptor() ([]byte, []int)

func (*QueryCurrentPlanResponse) GetPlan 

func (m *QueryCurrentPlanResponse) GetPlan() *Plan

func (*QueryCurrentPlanResponse) Marshal 

func (m *QueryCurrentPlanResponse) Marshal() (dAtA []byte, err error)

func (*QueryCurrentPlanResponse) MarshalTo 

func (m *QueryCurrentPlanResponse) MarshalTo(dAtA []byte) (int, error)

func (*QueryCurrentPlanResponse) MarshalToSizedBuffer 

func (m *QueryCurrentPlanResponse) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*QueryCurrentPlanResponse) ProtoMessage 

func (*QueryCurrentPlanResponse) ProtoMessage()

func (*QueryCurrentPlanResponse) Reset 

func (m *QueryCurrentPlanResponse) Reset()

func (*QueryCurrentPlanResponse) Size 

func (m *QueryCurrentPlanResponse) Size() (n int)

func (*QueryCurrentPlanResponse) String 

func (m *QueryCurrentPlanResponse) String() string

func (*QueryCurrentPlanResponse) Unmarshal 

func (m *QueryCurrentPlanResponse) Unmarshal(dAtA []byte) error

func (*QueryCurrentPlanResponse) XXX_DiscardUnknown 

func (m *QueryCurrentPlanResponse) XXX_DiscardUnknown()

func (*QueryCurrentPlanResponse) XXX_Marshal 

func (m *QueryCurrentPlanResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*QueryCurrentPlanResponse) XXX_Merge 

func (m *QueryCurrentPlanResponse) XXX_Merge(src proto.Message)

func (*QueryCurrentPlanResponse) XXX_Size 

func (m *QueryCurrentPlanResponse) XXX_Size() int

func (*QueryCurrentPlanResponse) XXX_Unmarshal 

func (m *QueryCurrentPlanResponse) XXX_Unmarshal(b []byte) error

type QueryServer 

type QueryServer interface {
	// CurrentPlan queries the current upgrade plan
	CurrentPlan(context.Context, *QueryCurrentPlanRequest) (*QueryCurrentPlanResponse, error)
	// AppliedPlan queries a previously applied upgrade plan by its name
	AppliedPlan(context.Context, *QueryAppliedPlanRequest) (*QueryAppliedPlanResponse, error)
}

QueryServer is the server API for Query service.

type SoftwareUpgradeProposal 

type SoftwareUpgradeProposal struct {
	Title       string `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	Plan        Plan   `protobuf:"bytes,3,opt,name=plan,proto3" json:"plan"`
}

SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade

func (*SoftwareUpgradeProposal) Descriptor 

func (*SoftwareUpgradeProposal) Descriptor() ([]byte, []int)

func (*SoftwareUpgradeProposal) Equal 

func (this *SoftwareUpgradeProposal) Equal(that interface{}) bool

func (*SoftwareUpgradeProposal) GetDescription 

func (sup *SoftwareUpgradeProposal) GetDescription() string

func (*SoftwareUpgradeProposal) GetTitle 

func (sup *SoftwareUpgradeProposal) GetTitle() string

func (*SoftwareUpgradeProposal) Marshal 

func (m *SoftwareUpgradeProposal) Marshal() (dAtA []byte, err error)

func (*SoftwareUpgradeProposal) MarshalTo 

func (m *SoftwareUpgradeProposal) MarshalTo(dAtA []byte) (int, error)

func (*SoftwareUpgradeProposal) MarshalToSizedBuffer 

func (m *SoftwareUpgradeProposal) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*SoftwareUpgradeProposal) ProposalRoute 

func (sup *SoftwareUpgradeProposal) ProposalRoute() string

func (*SoftwareUpgradeProposal) ProposalType 

func (sup *SoftwareUpgradeProposal) ProposalType() string

func (*SoftwareUpgradeProposal) ProtoMessage 

func (*SoftwareUpgradeProposal) ProtoMessage()

func (*SoftwareUpgradeProposal) Reset 

func (m *SoftwareUpgradeProposal) Reset()

func (*SoftwareUpgradeProposal) Size 

func (m *SoftwareUpgradeProposal) Size() (n int)

func (SoftwareUpgradeProposal) String 

func (sup SoftwareUpgradeProposal) String() string

func (*SoftwareUpgradeProposal) Unmarshal 

func (m *SoftwareUpgradeProposal) Unmarshal(dAtA []byte) error

func (*SoftwareUpgradeProposal) ValidateBasic 

func (sup *SoftwareUpgradeProposal) ValidateBasic() error

func (*SoftwareUpgradeProposal) XXX_DiscardUnknown 

func (m *SoftwareUpgradeProposal) XXX_DiscardUnknown()

func (*SoftwareUpgradeProposal) XXX_Marshal 

func (m *SoftwareUpgradeProposal) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*SoftwareUpgradeProposal) XXX_Merge 

func (m *SoftwareUpgradeProposal) XXX_Merge(src proto.Message)

func (*SoftwareUpgradeProposal) XXX_Size 

func (m *SoftwareUpgradeProposal) XXX_Size() int

func (*SoftwareUpgradeProposal) XXX_Unmarshal 

func (m *SoftwareUpgradeProposal) XXX_Unmarshal(b []byte) error

type UnimplementedQueryServer 

type UnimplementedQueryServer struct {
}

UnimplementedQueryServer can be embedded to have forward compatible implementations.

func (*UnimplementedQueryServer) AppliedPlan 

func (*UnimplementedQueryServer) AppliedPlan(ctx context.Context, req *QueryAppliedPlanRequest) (*QueryAppliedPlanResponse, error)

func (*UnimplementedQueryServer) CurrentPlan 

func (*UnimplementedQueryServer) CurrentPlan(ctx context.Context, req *QueryCurrentPlanRequest) (*QueryCurrentPlanResponse, error)

type UpgradeHandler 

type UpgradeHandler func(ctx sdk.Context, plan Plan)

UpgradeHandler specifies the type of function that is called when an upgrade is applied

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.