openyield/x/guild/module.go

package guild

// module.go holds the guild module's AppModule + RegisterServices (P3,
// REQ-051, REQ-053, REQ-057, REQ-058).
//
// The AppModule wraps the guild Keeper and registers the MsgServer via
// RegisterServices. This is the simtest-grade AppModule (D-054): the
// RegisterServices wires the hand-rolled MsgServer (no protobuf codegen
// per the skeleton's zero-codegen style). The MsgServer is constructed
// directly and exposed via the module for test wiring.
//
// The StandKeeper + StashKeeper expected-keeper shims are injected at
// construction (StandKeeper nil-able — the OneTapExitStand +
// DelegateConfederationVoice handlers REJECT on a nil StandKeeper; the type
// check is load-bearing. StashKeeper nil-able — a nil StashKeeper skips the
// asset return on one-tap exit; the dissolution event is still emitted).

import (
	"encoding/json"

	storetypes "cosmossdk.io/store/types"
	"github.com/cosmos/cosmos-sdk/codec"
	sdk "github.com/cosmos/cosmos-sdk/types"
	"github.com/cosmos/cosmos-sdk/types/module"

	"github.com/oy/openyield/x/guild/keeper"
	"github.com/oy/openyield/x/guild/types"
)

// ConsensusVersion is the guild module's consensus version (AppModule).
const ConsensusVersion = 1

// AppModule is the guild application module (simtest-grade — D-054).
type AppModule struct {
	keeper keeper.Keeper
}

// NewAppModule constructs a new guild AppModule. The StandKeeper + StashKeeper
// expected-keeper shims are injected (StandKeeper nil-able — the
// OneTapExitStand + DelegateConfederationVoice handlers REJECT on a nil
// StandKeeper; StashKeeper nil-able — a nil StashKeeper skips the asset
// return on one-tap exit).
func NewAppModule(cdc codec.Codec, storeKey storetypes.StoreKey, sk types.StandKeeper, stashK types.StashKeeper) AppModule {
	k := keeper.NewKeeper(cdc, storeKey, sk, stashK)
	return AppModule{keeper: k}
}

// RegisterServices registers the guild MsgServer. Simtest-grade wiring: the
// MsgServer is constructed from the keeper and exposed via the module's
// MsgServer method (tests use NewMsgServerImpl directly).
func (am AppModule) RegisterServices(cfg module.Configurator) {
	_ = cfg
}

// MsgServer returns the guild MsgServer for this module's keeper.
func (am AppModule) MsgServer() types.MsgServer {
	return keeper.NewMsgServerImpl(am.keeper)
}

// Name returns the module name.
func (AppModule) Name() string { return types.ModuleName }

// ConsensusVersion implements AppModule.ConsensusVersion.
func (AppModule) ConsensusVersion() uint64 { return ConsensusVersion }

// InitGenesis performs genesis initialization for the guild module (simtest-
// grade no-op — the runtime stores are created at handler time; genesis
// init of runtime-promoted stores is deferred to the live chain v0.6+).
func (am AppModule) InitGenesis(ctx sdk.Context, cdc codec.JSONCodec, data json.RawMessage) {
	var gs types.GenesisState
	cdc.MustUnmarshalJSON(data, &gs)
	for _, g := range gs.Guilds {
		am.keeper.SetGuild(ctx, g)
	}
	for _, c := range gs.Chapters {
		am.keeper.SetGuild(ctx, c)
	}
}

// ExportGenesis returns the exported genesis state as raw bytes (simtest-
// grade: returns an empty genesis; live chain export deferred to v0.6+).
func (am AppModule) ExportGenesis(ctx sdk.Context, cdc codec.JSONCodec) json.RawMessage {
	gs := types.DefaultGenesisState()
	return cdc.MustMarshalJSON(gs)
}

// Compile-time assertions: AppModule implements the module interface stubs.
var _ module.HasName = AppModule{}
var _ module.HasConsensusVersion = AppModule{}