proposal

package
v0.48.84 Latest Latest
Warning

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

Go to latest
Published: Oct 24, 2023 License: Apache-2.0 Imports: 25 Imported by: 1

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 (m *ParamChange) String() string

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 (m *ParameterChangeProposal) String() string

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) Subspaces

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL