Skip to content

Commit 45e6bb5

Browse files
committed
chore: improve godoc for module.go
1 parent 8cf86ea commit 45e6bb5

File tree

1 file changed

+9
-6
lines changed
  • modules/light-clients/06-solomachine

1 file changed

+9
-6
lines changed

modules/light-clients/06-solomachine/module.go

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,40 +14,43 @@ import (
1414
var _ module.AppModuleBasic = AppModuleBasic{}
1515

1616
// AppModuleBasic defines the basic application module used by the solo machine light client.
17+
// Only the RegisterInterfaces function needs to be implemented. All other function perform
18+
// a no-op.
1719
type AppModuleBasic struct{}
1820

1921
// Name returns the solo machine module name.
2022
func (AppModuleBasic) Name() string {
2123
return SubModuleName
2224
}
2325

24-
// RegisterLegacyAminoCodec does nothing. The solo machine client does not support amino.
26+
// RegisterLegacyAminoCodec performs a no-op. The solo machine client does not support amino.
2527
func (AppModuleBasic) RegisterLegacyAminoCodec(*codec.LegacyAmino) {}
2628

27-
// RegisterInterfaces registers module concrete types into protobuf Any.
29+
// RegisterInterfaces registers module concrete types into protobuf Any. This allows core IBC
30+
// to unmarshal solo machine types.
2831
func (AppModuleBasic) RegisterInterfaces(registry codectypes.InterfaceRegistry) {
2932
RegisterInterfaces(registry)
3033
}
3134

32-
// DefaultGenesis returns nil
35+
// DefaultGenesis performs a no-op. Genesis is not supported for solo machine.
3336
func (AppModuleBasic) DefaultGenesis(cdc codec.JSONCodec) json.RawMessage {
3437
return nil
3538
}
3639

37-
// ValidateGenesis return nil
40+
// ValidateGenesis performs a no-op. Genesis is not supported for solo machine.
3841
func (AppModuleBasic) ValidateGenesis(cdc codec.JSONCodec, config client.TxEncodingConfig, bz json.RawMessage) error {
3942
return nil
4043
}
4144

4245
// RegisterGRPCGatewayRoutes performs a no-op.
4346
func (AppModuleBasic) RegisterGRPCGatewayRoutes(clientCtx client.Context, mux *runtime.ServeMux) {}
4447

45-
// GetTxCmd returns nil.
48+
// GetTxCmd performs a no-op. Please see the 02-client cli commands.
4649
func (AppModuleBasic) GetTxCmd() *cobra.Command {
4750
return nil
4851
}
4952

50-
// GetQueryCmd returns nil.
53+
// GetQueryCmd performs a no-op. Please see the 02-client cli commands.
5154
func (AppModuleBasic) GetQueryCmd() *cobra.Command {
5255
return nil
5356
}

0 commit comments

Comments
 (0)