aminojson

Documentation

Index

• Constants
• type Encoder
  • func NewEncoder(options EncoderOptions) Encoder
  • func (enc Encoder) DefineFieldEncoding(name string, encoder FieldEncoder) Encoder
  • func (enc Encoder) DefineMessageEncoding(name string, encoder MessageEncoder) Encoder
  • func (enc Encoder) Marshal(message proto.Message) ([]byte, error)
• type EncoderOptions
• type FieldEncoder
• type MessageEncoder
• type SignModeHandler
  • func NewSignModeHandler(options SignModeHandlerOptions) *SignModeHandler
  • func (h SignModeHandler) GetSignBytes(_ context.Context, signerData signing.SignerData, txData signing.TxData) ([]byte, error)
  • func (h SignModeHandler) Mode() signingv1beta1.SignMode
• type SignModeHandlerOptions

Constants

const MaxDurationSeconds = int64(math.MaxInt64)/1e9 - 1

MaxDurationSeconds the maximum number of seconds (when expressed as nanoseconds) which can fit in an int64. gogoproto encodes google.protobuf.Duration as a time.Duration, which is 64-bit signed integer.

Types

type Encoder

type Encoder struct {
	// contains filtered or unexported fields
}

Encoder is a JSON encoder that uses the Amino JSON encoding rules for protobuf messages.

func NewEncoder

func NewEncoder(options EncoderOptions) Encoder

NewEncoder returns a new Encoder capable of serializing protobuf messages to JSON using the Amino JSON encoding rules.

func (Encoder) DefineFieldEncoding

func (enc Encoder) DefineFieldEncoding(name string, encoder FieldEncoder) Encoder

DefineFieldEncoding defines a custom encoding for a protobuf field. The `name` field must match a usage of an (amino.encoding) option in the protobuf message as in the following example. This encoding will be used instead of the default encoding for all usages of the tagged field.

message Balance {
  repeated cosmos.base.v1beta1.Coin coins = 2 [
    (amino.encoding)         = "legacy_coins",
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins",
    (gogoproto.nullable)     = false,
    (amino.dont_omitempty)   = true
  ];
  ...
}

func (Encoder) DefineMessageEncoding

func (enc Encoder) DefineMessageEncoding(name string, encoder MessageEncoder) Encoder

DefineMessageEncoding defines a custom encoding for a protobuf message. The `name` field must match a usage of an (amino.message_encoding) option in the protobuf message as in the following example. This encoding will be used instead of the default encoding for all usages of the tagged message.

message ModuleAccount {
  option (amino.name)                        = "cosmos-sdk/ModuleAccount";
  option (amino.message_encoding)            = "module_account";
  ...
}

func (Encoder) Marshal

func (enc Encoder) Marshal(message proto.Message) ([]byte, error)

Marshal serializes a protobuf message to JSON.

type EncoderOptions

type EncoderOptions struct {
	// TypeResolver is used to resolve protobuf message types by TypeURL when marshaling any packed messages.
	TypeResolver protoregistry.MessageTypeResolver
	// FileResolver is used to resolve protobuf file descriptors TypeURL when TypeResolver fails.
	FileResolver signing.ProtoFileResolver
}

EncoderOptions are options for creating a new Encoder.

type FieldEncoder

type FieldEncoder func(*Encoder, protoreflect.Value, io.Writer) error

FieldEncoder is a function that can encode a protobuf protoreflect.Value to JSON.

type MessageEncoder

type MessageEncoder func(*Encoder, protoreflect.Message, io.Writer) error

MessageEncoder is a function that can encode a protobuf protoreflect.Message to JSON.

type SignModeHandler

type SignModeHandler struct {
	// contains filtered or unexported fields
}

SignModeHandler implements the SIGN_MODE_LEGACY_AMINO_JSON signing mode.

func NewSignModeHandler

func NewSignModeHandler(options SignModeHandlerOptions) *SignModeHandler

NewSignModeHandler returns a new SignModeHandler.

func (SignModeHandler) GetSignBytes

func (h SignModeHandler) GetSignBytes(_ context.Context, signerData signing.SignerData, txData signing.TxData) ([]byte, error)

GetSignBytes implements the GetSignBytes method of the SignModeHandler interface.

func (SignModeHandler) Mode

func (h SignModeHandler) Mode() signingv1beta1.SignMode

Mode implements the Mode method of the SignModeHandler interface.

type SignModeHandlerOptions

type SignModeHandlerOptions struct {
	FileResolver signing.ProtoFileResolver
	TypeResolver protoregistry.MessageTypeResolver
	Encoder      *Encoder
}

SignModeHandlerOptions are the options for the SignModeHandler.