proposal

package
v0.47.3 Latest Latest
Warning

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

 Go to latest Published: Aug 22, 2024 License: Apache-2.0 Imports: 27 Imported by: 0

Documentation

Overview

Package proposal is a reverse proxy.

It translates gRPC into RESTful JSON APIs.

Index

Constants

View Source 
const (
	// ModuleName defines the name of the module
	ModuleName = "params"

	// RouterKey defines the routing key for a ParameterChangeProposal
	RouterKey = "params"
)
View Source 
const (
	// ProposalTypeChange defines the type for a ParameterChangeProposal
	ProposalTypeChange = "ParameterChange"
)

Variables

View Source 
var (
	ErrUnknownSubspace  = sdkerrors.Register(ModuleName, 2, "unknown subspace")
	ErrSettingParameter = sdkerrors.Register(ModuleName, 3, "failed to set parameter")
	ErrEmptyChanges     = sdkerrors.Register(ModuleName, 4, "submitted parameter changes are empty")
	ErrEmptySubspace    = sdkerrors.Register(ModuleName, 5, "parameter subspace is empty")
	ErrEmptyKey         = sdkerrors.Register(ModuleName, 6, "parameter key is empty")
	ErrEmptyValue       = sdkerrors.Register(ModuleName, 7, "parameter value is empty")
)

x/params module sentinel errors

View Source 
var (
	ErrInvalidLengthParams        = fmt.Errorf("proto: negative length found during unmarshaling")
	ErrIntOverflowParams          = fmt.Errorf("proto: integer overflow")
	ErrUnexpectedEndOfGroupParams = fmt.Errorf("proto: unexpected end of group")
)
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")
)

Functions

func RegisterInterfaces 

func RegisterInterfaces(registry types.InterfaceRegistry)

func RegisterLegacyAminoCodec 

func RegisterLegacyAminoCodec(cdc *codec.LegacyAmino)

RegisterLegacyAminoCodec registers all necessary param module types with a given LegacyAmino codec.

func RegisterQueryHandler 

func RegisterQueryHandler(ctx context.Context, mux *runtime.ServeMux, conn *grpc.ClientConn) error

RegisterQueryHandler registers the http handlers for service Query to "mux". The handlers forward requests to the grpc endpoint over "conn".

func RegisterQueryHandlerClient 

func RegisterQueryHandlerClient(ctx context.Context, mux *runtime.ServeMux, client QueryClient) error

RegisterQueryHandlerClient registers the http handlers for service Query to "mux". The handlers forward requests to the grpc endpoint over the given implementation of "QueryClient". Note: the gRPC framework executes interceptors within the gRPC handler. If the passed in "QueryClient" doesn't go through the normal gRPC flow (creating a gRPC client etc.) then it will be up to the passed in "QueryClient" to call the correct interceptors.

func RegisterQueryHandlerFromEndpoint 

func RegisterQueryHandlerFromEndpoint(ctx context.Context, mux *runtime.ServeMux, endpoint string, opts []grpc.DialOption) (err error)

RegisterQueryHandlerFromEndpoint is same as RegisterQueryHandler but automatically dials to "endpoint" and closes the connection when "ctx" gets done.

func RegisterQueryHandlerServer 

func RegisterQueryHandlerServer(ctx context.Context, mux *runtime.ServeMux, server QueryServer) error

RegisterQueryHandlerServer registers the http handlers for service Query to "mux". UnaryRPC :call QueryServer directly. StreamingRPC :currently unsupported pending https://github.com/grpc/grpc-go/issues/906. Note that using this registration option will cause many gRPC library features to stop working. Consider using RegisterQueryHandlerFromEndpoint instead.

func RegisterQueryServer 

func RegisterQueryServer(s grpc1.Server, srv QueryServer)

func ValidateChanges 

func ValidateChanges(changes []ParamChange) error

ValidateChanges performs basic validation checks over a set of ParamChange. It returns an error if any ParamChange is invalid.

Types

type ParamChange 

type ParamChange struct {
	Subspace string `protobuf:"bytes,1,opt,name=subspace,proto3" json:"subspace,omitempty"`
	Key      string `protobuf:"bytes,2,opt,name=key,proto3" json:"key,omitempty"`
	Value    string `protobuf:"bytes,3,opt,name=value,proto3" json:"value,omitempty"`
}

ParamChange defines an individual parameter change, for use in ParameterChangeProposal.

func NewParamChange 

func NewParamChange(subspace, key, value string) ParamChange

func (*ParamChange) Descriptor 

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

func (*ParamChange) Equal 

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

func (*ParamChange) GetKey 

func (m *ParamChange) GetKey() string

func (*ParamChange) GetSubspace 

func (m *ParamChange) GetSubspace() string

func (*ParamChange) GetValue 

func (m *ParamChange) GetValue() string

func (*ParamChange) Marshal 

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

func (*ParamChange) MarshalTo 

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

func (*ParamChange) MarshalToSizedBuffer 

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

func (*ParamChange) ProtoMessage 

func (*ParamChange) ProtoMessage()

func (*ParamChange) Reset 

func (m *ParamChange) Reset()

func (*ParamChange) Size 

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

func (ParamChange) String 

func (pc ParamChange) String() string

String implements the Stringer interface.

func (*ParamChange) Unmarshal 

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

func (*ParamChange) XXX_DiscardUnknown 

func (m *ParamChange) XXX_DiscardUnknown()

func (*ParamChange) XXX_Marshal 

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

func (*ParamChange) XXX_Merge 

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

func (*ParamChange) XXX_Size 

func (m *ParamChange) XXX_Size() int

func (*ParamChange) XXX_Unmarshal 

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

type ParameterChangeProposal 

type ParameterChangeProposal 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"`
	Changes     []ParamChange `protobuf:"bytes,3,rep,name=changes,proto3" json:"changes"`
}

ParameterChangeProposal defines a proposal to change one or more parameters.

func NewParameterChangeProposal 

func NewParameterChangeProposal(title, description string, changes []ParamChange) *ParameterChangeProposal

func (*ParameterChangeProposal) Descriptor 

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

func (*ParameterChangeProposal) Equal 

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

func (*ParameterChangeProposal) GetDescription 

func (pcp *ParameterChangeProposal) GetDescription() string

GetDescription returns the description of a parameter change proposal.

func (*ParameterChangeProposal) GetTitle 

func (pcp *ParameterChangeProposal) GetTitle() string

GetTitle returns the title of a parameter change proposal.

func (*ParameterChangeProposal) Marshal 

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

func (*ParameterChangeProposal) MarshalTo 

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

func (*ParameterChangeProposal) MarshalToSizedBuffer 

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

func (*ParameterChangeProposal) ProposalRoute 

func (pcp *ParameterChangeProposal) ProposalRoute() string

ProposalRoute returns the routing key of a parameter change proposal.

func (*ParameterChangeProposal) ProposalType 

func (pcp *ParameterChangeProposal) ProposalType() string

ProposalType returns the type of a parameter change proposal.

func (*ParameterChangeProposal) ProtoMessage 

func (*ParameterChangeProposal) ProtoMessage()

func (*ParameterChangeProposal) Reset 

func (m *ParameterChangeProposal) Reset()

func (*ParameterChangeProposal) Size 

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

func (ParameterChangeProposal) String 

func (pcp ParameterChangeProposal) String() string

String implements the Stringer interface.

func (*ParameterChangeProposal) Unmarshal 

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

func (*ParameterChangeProposal) ValidateBasic 

func (pcp *ParameterChangeProposal) ValidateBasic() error

ValidateBasic validates the parameter change proposal

func (*ParameterChangeProposal) XXX_DiscardUnknown 

func (m *ParameterChangeProposal) XXX_DiscardUnknown()

func (*ParameterChangeProposal) XXX_Marshal 

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

func (*ParameterChangeProposal) XXX_Merge 

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

func (*ParameterChangeProposal) XXX_Size 

func (m *ParameterChangeProposal) XXX_Size() int

func (*ParameterChangeProposal) XXX_Unmarshal 

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

type QueryClient 

type QueryClient interface {
	// Params queries a specific parameter of a module, given its subspace and
	// key.
	Params(ctx context.Context, in *QueryParamsRequest, opts ...grpc.CallOption) (*QueryParamsResponse, error)
	// Subspaces queries for all registered subspaces and all keys for a subspace.
	//
	// Since: cosmos-sdk 0.46
	Subspaces(ctx context.Context, in *QuerySubspacesRequest, opts ...grpc.CallOption) (*QuerySubspacesResponse, 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 QueryParamsRequest 

type QueryParamsRequest struct {
	// subspace defines the module to query the parameter for.
	Subspace string `protobuf:"bytes,1,opt,name=subspace,proto3" json:"subspace,omitempty"`
	// key defines the key of the parameter in the subspace.
	Key string `protobuf:"bytes,2,opt,name=key,proto3" json:"key,omitempty"`
}

QueryParamsRequest is request type for the Query/Params RPC method.

func (*QueryParamsRequest) Descriptor 

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

func (*QueryParamsRequest) GetKey 

func (m *QueryParamsRequest) GetKey() string

func (*QueryParamsRequest) GetSubspace 

func (m *QueryParamsRequest) GetSubspace() string

func (*QueryParamsRequest) Marshal 

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

func (*QueryParamsRequest) MarshalTo 

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

func (*QueryParamsRequest) MarshalToSizedBuffer 

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

func (*QueryParamsRequest) ProtoMessage 

func (*QueryParamsRequest) ProtoMessage()

func (*QueryParamsRequest) Reset 

func (m *QueryParamsRequest) Reset()

func (*QueryParamsRequest) Size 

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

func (*QueryParamsRequest) String 

func (m *QueryParamsRequest) String() string

func (*QueryParamsRequest) Unmarshal 

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

func (*QueryParamsRequest) XXX_DiscardUnknown 

func (m *QueryParamsRequest) XXX_DiscardUnknown()

func (*QueryParamsRequest) XXX_Marshal 

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

func (*QueryParamsRequest) XXX_Merge 

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

func (*QueryParamsRequest) XXX_Size 

func (m *QueryParamsRequest) XXX_Size() int

func (*QueryParamsRequest) XXX_Unmarshal 

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

type QueryParamsResponse 

type QueryParamsResponse struct {
	// param defines the queried parameter.
	Param ParamChange `protobuf:"bytes,1,opt,name=param,proto3" json:"param"`
}

QueryParamsResponse is response type for the Query/Params RPC method.

func (*QueryParamsResponse) Descriptor 

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

func (*QueryParamsResponse) GetParam 

func (m *QueryParamsResponse) GetParam() ParamChange

func (*QueryParamsResponse) Marshal 

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

func (*QueryParamsResponse) MarshalTo 

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

func (*QueryParamsResponse) MarshalToSizedBuffer 

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

func (*QueryParamsResponse) ProtoMessage 

func (*QueryParamsResponse) ProtoMessage()

func (*QueryParamsResponse) Reset 

func (m *QueryParamsResponse) Reset()

func (*QueryParamsResponse) Size 

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

func (*QueryParamsResponse) String 

func (m *QueryParamsResponse) String() string

func (*QueryParamsResponse) Unmarshal 

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

func (*QueryParamsResponse) XXX_DiscardUnknown 

func (m *QueryParamsResponse) XXX_DiscardUnknown()

func (*QueryParamsResponse) XXX_Marshal 

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

func (*QueryParamsResponse) XXX_Merge 

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

func (*QueryParamsResponse) XXX_Size 

func (m *QueryParamsResponse) XXX_Size() int

func (*QueryParamsResponse) XXX_Unmarshal 

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

type QueryServer 

type QueryServer interface {
	// Params queries a specific parameter of a module, given its subspace and
	// key.
	Params(context.Context, *QueryParamsRequest) (*QueryParamsResponse, error)
	// Subspaces queries for all registered subspaces and all keys for a subspace.
	//
	// Since: cosmos-sdk 0.46
	Subspaces(context.Context, *QuerySubspacesRequest) (*QuerySubspacesResponse, error)
}

QueryServer is the server API for Query service.

type QuerySubspacesRequest 

type QuerySubspacesRequest struct {
}

QuerySubspacesRequest defines a request type for querying for all registered subspaces and all keys for a subspace.

Since: cosmos-sdk 0.46

func (*QuerySubspacesRequest) Descriptor 

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

func (*QuerySubspacesRequest) Marshal 

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

func (*QuerySubspacesRequest) MarshalTo 

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

func (*QuerySubspacesRequest) MarshalToSizedBuffer 

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

func (*QuerySubspacesRequest) ProtoMessage 

func (*QuerySubspacesRequest) ProtoMessage()

func (*QuerySubspacesRequest) Reset 

func (m *QuerySubspacesRequest) Reset()

func (*QuerySubspacesRequest) Size 

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

func (*QuerySubspacesRequest) String 

func (m *QuerySubspacesRequest) String() string

func (*QuerySubspacesRequest) Unmarshal 

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

func (*QuerySubspacesRequest) XXX_DiscardUnknown 

func (m *QuerySubspacesRequest) XXX_DiscardUnknown()

func (*QuerySubspacesRequest) XXX_Marshal 

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

func (*QuerySubspacesRequest) XXX_Merge 

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

func (*QuerySubspacesRequest) XXX_Size 

func (m *QuerySubspacesRequest) XXX_Size() int

func (*QuerySubspacesRequest) XXX_Unmarshal 

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

type QuerySubspacesResponse 

type QuerySubspacesResponse struct {
	Subspaces []*Subspace `protobuf:"bytes,1,rep,name=subspaces,proto3" json:"subspaces,omitempty"`
}

QuerySubspacesResponse defines the response types for querying for all registered subspaces and all keys for a subspace.

Since: cosmos-sdk 0.46

func (*QuerySubspacesResponse) Descriptor 

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

func (*QuerySubspacesResponse) GetSubspaces 

func (m *QuerySubspacesResponse) GetSubspaces() []*Subspace

func (*QuerySubspacesResponse) Marshal 

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

func (*QuerySubspacesResponse) MarshalTo 

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

func (*QuerySubspacesResponse) MarshalToSizedBuffer 

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

func (*QuerySubspacesResponse) ProtoMessage 

func (*QuerySubspacesResponse) ProtoMessage()

func (*QuerySubspacesResponse) Reset 

func (m *QuerySubspacesResponse) Reset()

func (*QuerySubspacesResponse) Size 

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

func (*QuerySubspacesResponse) String 

func (m *QuerySubspacesResponse) String() string

func (*QuerySubspacesResponse) Unmarshal 

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

func (*QuerySubspacesResponse) XXX_DiscardUnknown 

func (m *QuerySubspacesResponse) XXX_DiscardUnknown()

func (*QuerySubspacesResponse) XXX_Marshal 

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

func (*QuerySubspacesResponse) XXX_Merge 

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

func (*QuerySubspacesResponse) XXX_Size 

func (m *QuerySubspacesResponse) XXX_Size() int

func (*QuerySubspacesResponse) XXX_Unmarshal 

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

type Subspace 

type Subspace struct {
	Subspace string   `protobuf:"bytes,1,opt,name=subspace,proto3" json:"subspace,omitempty"`
	Keys     []string `protobuf:"bytes,2,rep,name=keys,proto3" json:"keys,omitempty"`
}

Subspace defines a parameter subspace name and all the keys that exist for the subspace.

Since: cosmos-sdk 0.46

func (*Subspace) Descriptor 

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

func (*Subspace) GetKeys 

func (m *Subspace) GetKeys() []string

func (*Subspace) GetSubspace 

func (m *Subspace) GetSubspace() string

func (*Subspace) Marshal 

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

func (*Subspace) MarshalTo 

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

func (*Subspace) MarshalToSizedBuffer 

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

func (*Subspace) ProtoMessage 

func (*Subspace) ProtoMessage()

func (*Subspace) Reset 

func (m *Subspace) Reset()

func (*Subspace) Size 

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

func (*Subspace) String 

func (m *Subspace) String() string

func (*Subspace) Unmarshal 

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

func (*Subspace) XXX_DiscardUnknown 

func (m *Subspace) XXX_DiscardUnknown()

func (*Subspace) XXX_Marshal 

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

func (*Subspace) XXX_Merge 

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

func (*Subspace) XXX_Size 

func (m *Subspace) XXX_Size() int

func (*Subspace) XXX_Unmarshal 

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

type UnimplementedQueryServer 

type UnimplementedQueryServer struct {
}

UnimplementedQueryServer can be embedded to have forward compatible implementations.

func (*UnimplementedQueryServer) Params 

func (*UnimplementedQueryServer) Params(ctx context.Context, req *QueryParamsRequest) (*QueryParamsResponse, error)

func (*UnimplementedQueryServer) Subspaces 

func (*UnimplementedQueryServer) Subspaces(ctx context.Context, req *QuerySubspacesRequest) (*QuerySubspacesResponse, error)

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.