Compare commits

..

12 Commits

Author SHA1 Message Date
cloudinit-bot 9924a4853a test(cover,guild,stand): P5 verify — GREEN
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
---ci---
project: oy
phase: 5
milestone: v0.7
status: verify
---/ci---
2026-08-19 02:44:13 +00:00
cloudinit-bot 9abda8d01e feat(cover,guild,stand): P5 Anti-Capture Bill ceremony + secession + Pier
P5 (final execution phase) of v0.7 delivers REQ-056, REQ-059, REQ-064,
REQ-066:

x/cover — Bill of Rights ceremony (REQ-056) + Pier Selection (REQ-066):
MsgCounselReviewBillOfRights (bonded Counsel, Staked=true gate);
MsgSelectPier (Guild Council + GuildKeeper shim + PierSelectionIndex);
MsgRevokePierSelection (supermajority + Counsel witness); PierSelectionIndex
+ PierSelectionRecord structs; bill_review/pier_selection/pier_index stores.

x/guild — Secession cooling (REQ-064) + Stand->Pier (REQ-059, D-074):
MsgInitiateSecession (SecessionStartedAt + lien audit); MsgCompleteSecession
(21d Cover-active / 14d non-Cover cooling + lien audit + covenant clearance
+ pro-rata settlement event); MsgEscalateStandToPier (10M Grain-cents D-074
threshold, soft upgrade); MsgAcceptPierInvitation; Guild.SecessionStartedAt
+ SecededAt + Lien.Cleared additive; LOCAL StandPierEscalationAnnualPass
VolumeCents const (G-003 local-const mirror of x/stand canonical).

x/stand — StandPierEscalationAnnualPassVolumeCents=10000000 canonical const.

Coverage: cover/keeper 94.6%, guild/keeper 94.1%, stand/types 100%.
G-006/G-028 intact. go.mod/go.sum diff EMPTY. go vet clean. Lexicon green.

---ci---
project: oy
phase: 5
milestone: v0.7
status: execute
---/ci---
2026-08-19 02:44:12 +00:00
cloudinit-bot dd84e24a51 Merge phase/04 into milestone/v0.7 (P4 complete → v0.6.4)
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
2026-08-19 02:31:53 +00:00
cloudinit-bot 53ad56e3d2 test(bond,cover,standing): P4 verify — GREEN
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
---ci---
project: oy
phase: 4
milestone: v0.7
status: verify
---/ci---
2026-08-19 02:31:53 +00:00
cloudinit-bot 9e7fc403f5 feat(bond,cover,standing): P4 MAB + Cover Claims Voucher + Shadow vouch
v0.7 P4 (REQ-054, REQ-055, REQ-060, REQ-063, D-080, D-089, D-090):

x/bond (Mutual Aid Bond): MAB struct (Bond anonymous embed) mirroring
GrowthBond; CouponDenom enum (CoverCall/MutualAidCredit/Bread-rejected);
MABIssuanceCeilingAnnualSurplusMultiple=3 locked const; ValidateMAB
rejects CouponDenomBread (FR-MAB-3 dual firewall); D-080 tagged streaming
(reserve_build_out); 4 handlers (IssueMAB with 3x ceiling check,
DebitMABProceeds with auto-Still on misuse, WitnessMABProceedsRelease
with Watcher quorum, WatcherAttestMAB); CoverKeeper reverse edge (D-089).

x/cover (Cover Claims Voucher + dissolution): CoverClaimsVoucher struct;
D-090(2) cold-start bond = max(10x avgCallSize, MinimumVoucherBond); 4
handlers (RegisterCoverClaimsVoucher, AdjudicateCoverCall with FR-CPCV-2
no self-adjudication, SlashCoverClaimsVoucher with cross-Pool bucket
drop, DissolveCoverPool with FR-MAB-4 waterfall Cover-Fee > MAB > Bread);
MAB holders have NO Voice (REQ-063).

x/standing (Shadow vouch): Vouch.IsShadow field; ShadowVouchWeightMultiplier
=0.5 locked const (REQ-060); GetVoucherWeight extended with isShadow param
(post-step 0.5x multiplier; all call sites updated); SlashReasonFraudulent
CoverCall const (REQ-055).

Coverage: bond/keeper 92.1%, cover/keeper 95.0%, standing/types 90.3%.
G-006/G-028 intact. go.mod/go.sum diff EMPTY. go vet clean. Lexicon green.

---ci---
project: oy
phase: 4
milestone: v0.7
status: execute
---/ci---
2026-08-19 02:31:52 +00:00
cloudinit-bot bcae60666b Merge phase/03 into milestone/v0.7 (P3 complete → v0.6.3)
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
2026-08-19 02:16:46 +00:00
cloudinit-bot fff74b2de1 test(guild): P3 verify — GREEN (vet+race+coverage+lexicon+G-003+G-028)
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
---ci---
project: oy
phase: 3
milestone: v0.7
status: verify
---/ci---
2026-08-19 02:16:46 +00:00
cloudinit-bot b6d7b1a9ec feat(guild): P3 Guild Charter + Chapter Federation + Household/Confederation
Extends x/guild with P3 (v0.7) Guild Charter + Chapter Federation runtime
+ Household one-tap exit + Confederation Voice delegation + D-087
PierCarriesVoice locked const + REQ-064 cooling consts.

- x/guild/types: extend Guild (CommonBondHash, PublicProfile,
  ParentGuildID, IsChapter, SecessionTermsHash, GoodStandingLiens); add
  GuildPublicProfile, Lien, SecessionTerms, ConfederationVoice structs;
  add PierCarriesVoice=false (D-087), CoolingSecessionCoverActiveDays=21,
  CoolingSecessionNonCoverDays=14 consts; extend Params + GenesisState
  (Chapters slice + Chapter->ParentGuildID ref check).
- x/guild/types/msg_guild.go: 5 Msg* (CreateGuild, CreateChapter,
  OneTapExitStand, DelegateConfederationVoice, AddLien) + MsgServer
  interface + Response types (Disclaimer surfaced per REQ-061).
- x/guild/types/expected_keepers.go: StandKeeper + StashKeeper G-003 shims.
- x/guild/keeper: NEW store-backed Keeper (guild/lien/delegation stores)
  + MsgServer handlers + simtest (8 cases).
- x/guild/module.go: AppModule (D-054 simtest-grade).
- x/stand/types: IsHousehold + IsConfederation helpers + ConfederationVoice
  type-level scaffold (REQ-057/REQ-058).

Coverage: x/guild 85.7%, keeper 94.3%, types 97.1%.
G-006/G-028 intact. go.mod/go.sum diff EMPTY. go vet clean.

REQs: REQ-051, REQ-053, REQ-057, REQ-058, REQ-061

---ci---
project: oy
phase: 3
milestone: v0.7
status: execute
---/ci---
2026-08-19 02:16:42 +00:00
cloudinit-bot 4eec2ff502 Merge phase/02 into milestone/v0.7 (P2 complete → v0.6.2)
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
2026-08-19 02:08:43 +00:00
cloudinit-bot 72cc922b3b test(cover): P2 verify — GREEN (vet+race+coverage+lexicon+G-003+G-028)
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
---ci---
project: oy
phase: 2
milestone: v0.7
status: verify
---/ci---
2026-08-19 02:08:43 +00:00
cloudinit-bot 907dc66d12 feat(cover): P2 Cover-Charter + Pool Council + staging + Bill of Rights (D-090(1))
P2 of v0.7 extends x/cover with Cover-Charter + Pool governance hybrid +
category staging + the Anti-Capture Bill of Rights types (D-090(1)
temporal-gap fix — Bill of Rights types land HERE, not P5, so the dual
firewall is in place before any Charter can be signed).

New (x/cover/types/rights.go): RightID type + 13 Right* consts +
AntiCaptureBillOfRightsCount=13 locked const + 13 Waivable* bool consts
(all false) + RightIsWaivable() always false + AllRights()/AllWaivableFlags().

New structs: CoverCharter (REQ-052) + CharterAmendment (7-day cooling) +
PoolCouncil (REQ-062 — 3 Masons + Watcher observer; NO Anchor/MAB seat) +
CoverCallVote (majority requires Watcher observer present). CoverPool
extended with CharterRef + CouncilRef. D-086 DefaultParams [Phase2] ->
[Phase2, Phase3, Phase4].

New Msg*: MsgSignCoverCharter (D-090(1) WaivedRights gate at
ValidateBasic — mirrors MissionLockAmendmentRejected D-064),
MsgAmendCoverCharter, MsgElectPoolMason, MsgVoteCoverCall,
MsgAmendPoolStandingGate (D-090(3) dual check: floor at ValidateBasic +
handler), MsgEscalateReserveCeiling (12-month age check).

New handlers: SignCoverCharter, AmendCoverCharter (Proposed + ProposedAt),
ElectPoolMason (max 3), VoteCoverCall (Yes requires observer),
AmendPoolStandingGate (D-090(3) re-check), EscalateReserveCeiling,
CoolCharterAmendment + RatifyCharterAmendment lifecycle helpers.

New stores: charter/ council/ vote/ amendment/ + SetParamsOverride/Params().

Simtest cases (a)-(h): Charter signing + D-090(1) WaivedRights reject +
7-day cooling + election + vote observer + D-086 out-of-phase + ceiling
escalation + D-090(3) below-floor reject.

Lexicon: rights.go + msg_charter.go lexicon-clean (initial 'policy' hit
fixed -> 'invariant'). .lexicon_fixture SkipDir guard added to 3 lexicon
walks (fixes pre-existing cross-package test-isolation race).

G-003/G-006/G-028/G-024 intact. go.mod/go.sum diff EMPTY.
Coverage: types 98.9%, keeper 95.1%, firewall 100.0%.

REQs: REQ-048, REQ-052, REQ-062, REQ-065 (D-090(1) Bill of Rights types
for REQ-056 land here; P5 adds the ceremony)

---ci---
project: oy
phase: 2
milestone: v0.7
status: execute
---/ci---
2026-08-19 02:08:33 +00:00
cloudinit-bot a23856a9ee Merge phase/01 into milestone/v0.7-fraternal-groups (P1 complete → v0.6.1)
docs-build / go test ./... (lexicon firewall + all x/* tests) (push) Has been cancelled
docs-build / mkdocs build (docs site artifact) (push) Has been cancelled
2026-08-19 01:53:57 +00:00
40 changed files with 12777 additions and 93 deletions
@@ -111,6 +111,15 @@ func TestLexiconMetaCoverNoBannedTerms(t *testing.T) {
return err
}
if info.IsDir() {
// Skip the walk-coverage fixture dir (G-013):
// TestLexiconMetaCoverWalkCoverage creates
// x/cover/.lexicon_fixture/ with synthetic banned-term .go
// files. Those fixtures are test artifacts, NOT production
// code; skip the dir to avoid a self-trip if cleanup is
// delayed.
if info.Name() == ".lexicon_fixture" {
return filepath.SkipDir
}
return nil
}
if !strings.HasSuffix(path, ".go") {
+10
View File
@@ -43,6 +43,16 @@ func TestLexiconMetaNoBannedTermsInX(t *testing.T) {
return err
}
if info.IsDir() {
// Skip the lexicon_meta_cover walk-coverage fixture dir
// (G-013): TestLexiconMetaCoverWalkCoverage creates
// x/cover/.lexicon_fixture/ with synthetic banned-term .go
// files to verify the Cover firewall's walk logic. Those
// fixtures are test artifacts, NOT production code, and would
// trip this project-wide firewall if scanned concurrently.
// Skip the fixture dir to avoid the test-isolation race.
if info.Name() == ".lexicon_fixture" {
return filepath.SkipDir
}
return nil
}
if !strings.HasSuffix(path, ".go") {
+1 -1
View File
@@ -351,7 +351,7 @@ func (s *Store) ComputeStandingScore(reachID string) (float64, standingtypes.Sta
sum := 0.0
categories := map[string]bool{}
for _, r := range ratings {
w := standingtypes.GetVoucherWeight(false, r.Score, len(ratings))
w := standingtypes.GetVoucherWeight(false, r.Score, len(ratings), false)
sum += r.Score * w
categories[r.Category] = true
}
+155 -5
View File
@@ -42,17 +42,23 @@ import (
// Keeper is the store-backed bond market keeper.
type Keeper struct {
cdc codec.Codec
storeKey storetypes.StoreKey
standKeeper types.StandKeeper
seq uint64 // monotonic sequence for price-time priority (CLOB)
cdc codec.Codec
storeKey storetypes.StoreKey
standKeeper types.StandKeeper
coverKeeper types.CoverKeeper
watcherKeeper types.WatcherKeeper
stillKeeper types.StillKeeper
seq uint64 // monotonic sequence for price-time priority (CLOB)
}
// NewKeeper constructs a new store-backed bond Keeper. The StandKeeper
// expected-keeper shim is injected (nil-able for partial tests; the
// IssueBond / IssueGrowthBond handlers guard a nil shim and skip the
// StandExists check, still mutating state — the simtest wiring documents
// this).
// this). The v0.7 P4 MAB shims (CoverKeeper, WatcherKeeper, StillKeeper)
// are wired via the Set* methods (post-construction wiring for app wiring
// or test setup); the MAB handlers guard nil shims per the documented
// contract.
func NewKeeper(cdc codec.Codec, storeKey storetypes.StoreKey, sk types.StandKeeper) Keeper {
return Keeper{
cdc: cdc,
@@ -65,6 +71,19 @@ func NewKeeper(cdc codec.Codec, storeKey storetypes.StoreKey, sk types.StandKeep
// construction wiring, e.g., app wiring or test setup).
func (k *Keeper) SetStandKeeper(sk types.StandKeeper) { k.standKeeper = sk }
// SetCoverKeeper sets the CoverKeeper expected-keeper shim (D-089(2) reverse
// edge — for post-construction wiring, e.g., app wiring or test setup).
func (k *Keeper) SetCoverKeeper(ck types.CoverKeeper) { k.coverKeeper = ck }
// SetWatcherKeeper sets the WatcherKeeper expected-keeper shim (for the MAB
// proceeds-release quorum check — post-construction wiring).
func (k *Keeper) SetWatcherKeeper(wk types.WatcherKeeper) { k.watcherKeeper = wk }
// SetStillKeeper sets the StillKeeper expected-keeper shim (D-089(1) — for
// the MAB misuse auto-Still on a destination mismatch; post-construction
// wiring).
func (k *Keeper) SetStillKeeper(stK types.StillKeeper) { k.stillKeeper = stK }
// StoreKey returns the keeper's store key (exported for simtest access to
// the raw KVStore for corrupt-byte injection in marshal-error coverage
// paths).
@@ -177,6 +196,137 @@ func (k Keeper) AllGrowthBonds(ctx sdk.Context) []types.GrowthBond {
return out
}
// --- MAB store (v0.7 P4 — REQ-054, D-080, D-089(2)) ---------------------------
//
// The MAB store is keyed by bond-id -> MAB. A separate mab-pool index
// (bond-id -> pool-id) records the pool each MAB was issued for, so the
// 3× annual surplus ceiling check can sum the MAB principals for a pool,
// and the MsgDebitMABProceeds handler can query the CoverKeeper for the
// pool's ReserveAccount. The mab-attest store records the quarterly Watcher
// attestations (mab_attest/<bondID>/<timestamp> -> attestationRef).
var mabKeyPrefix = []byte("mab/")
func mabKey(bondID string) []byte {
return append(mabKeyPrefix, []byte(bondID)...)
}
// GetMAB loads an issued MAB by bond-id. Returns the MAB and true if found,
// or zero value + false if not.
func (k Keeper) GetMAB(ctx sdk.Context, bondID string) (types.MAB, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(mabKey(bondID))
if bz == nil {
return types.MAB{}, false
}
var m types.MAB
if err := json.Unmarshal(bz, &m); err != nil {
return types.MAB{}, false
}
return m, true
}
// SetMAB persists an issued MAB by bond-id.
func (k Keeper) SetMAB(ctx sdk.Context, m types.MAB) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(m)
if err != nil {
panic(fmt.Sprintf("bond: marshal mab %q: %v", m.BondID, err))
}
store.Set(mabKey(m.BondID), bz)
}
// AllMABs returns all issued MABs (iteration helper, unordered).
func (k Keeper) AllMABs(ctx sdk.Context) []types.MAB {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(mabKeyPrefix, prefixEnd(mabKeyPrefix))
defer iterator.Close()
out := []types.MAB{}
for ; iterator.Valid(); iterator.Next() {
var m types.MAB
if err := json.Unmarshal(iterator.Value(), &m); err == nil {
out = append(out, m)
}
}
return out
}
// --- MAB pool index (bond-id -> pool-id) --------------------------------------
var mabPoolKeyPrefix = []byte("mab-pool/")
func mabPoolKey(bondID string) []byte {
return append(mabPoolKeyPrefix, []byte(bondID)...)
}
// setMABPool records the pool-id a MAB was issued for (bond-id -> pool-id).
func (k Keeper) setMABPool(ctx sdk.Context, bondID, poolID string) {
store := ctx.KVStore(k.storeKey)
store.Set(mabPoolKey(bondID), []byte(poolID))
}
// GetMABPool returns the pool-id a MAB was issued for (bond-id -> pool-id).
// Returns the pool-id and true if found, or "" + false if not.
func (k Keeper) GetMABPool(ctx sdk.Context, bondID string) (string, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(mabPoolKey(bondID))
if bz == nil {
return "", false
}
return string(bz), true
}
// MABsForPool returns all MABs issued for the given pool-id (the 3× annual
// surplus ceiling check sums their principals). Iterates the mab-pool index
// + loads each MAB by bond-id.
func (k Keeper) MABsForPool(ctx sdk.Context, poolID string) []types.MAB {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(mabPoolKeyPrefix, prefixEnd(mabPoolKeyPrefix))
defer iterator.Close()
out := []types.MAB{}
for ; iterator.Valid(); iterator.Next() {
if string(iterator.Value()) != poolID {
continue
}
// The key is mab-pool/<bondID>; extract the bondID (strip the
// prefix) and load the MAB.
bondID := string(iterator.Key()[len(mabPoolKeyPrefix):])
if m, ok := k.GetMAB(ctx, bondID); ok {
out = append(out, m)
}
}
return out
}
// --- MAB attestation store (mab_attest/<bondID>/<timestamp> -> ref) -----------
var mabAttestKeyPrefix = []byte("mab_attest/")
func mabAttestKey(bondID string, ts int64) []byte {
return append(append(mabAttestKeyPrefix, []byte(bondID)...), []byte(fmt.Sprintf("/%d", ts))...)
}
// SetMABAttest records a quarterly Watcher attestation on a MAB (bond-id +
// timestamp -> attestation-ref).
func (k Keeper) SetMABAttest(ctx sdk.Context, bondID string, ts int64, attestationRef string) {
store := ctx.KVStore(k.storeKey)
store.Set(mabAttestKey(bondID, ts), []byte(attestationRef))
}
// AllMABAttests returns all recorded Watcher attestations for a MAB
// (bond-id -> []attestationRef, unordered).
func (k Keeper) AllMABAttests(ctx sdk.Context, bondID string) []string {
store := ctx.KVStore(k.storeKey)
prefix := append(mabAttestKeyPrefix, []byte(bondID+"/")...)
iterator := store.Iterator(prefix, prefixEnd(prefix))
defer iterator.Close()
out := []string{}
for ; iterator.Valid(); iterator.Next() {
out = append(out, string(iterator.Value()))
}
return out
}
// --- Order store (CLOB resting book) -----------------------------------------
//
// The resting book is keyed by order-id → restingOrder (the in-keeper book
+238
View File
@@ -426,3 +426,241 @@ func (s msgServer) MatchSecondaryOrder(ctx interface{}, msg *types.MsgMatchSecon
Rejected: false,
}, nil
}
// --- v0.7 P4: MAB handlers (REQ-054, D-080, D-089(1), D-089(2)) ----------------
//
// (Mutual Aid Bond runtime — IssueMAB + DebitMABProceeds +
// WitnessMABProceedsRelease + WatcherAttestMAB). The four handlers exercise
// the 3× annual surplus ceiling, the FR-MAB-3 Bread-coupon rejection, the
// D-080 tagged-streaming destination check (CoverKeeper reverse edge —
// D-089(2)), the D-089(1) auto-Still on misuse, and the Watcher quorum
// (6-of-9) on proceeds release.
// checkMABIssuanceCeiling asserts the 3× annual surplus ceiling (REQ-054
// locked). It sums the existing MAB principals for the poolID + the new
// principal and asserts the sum <= MABIssuanceCeilingAnnualSurplusMultiple ×
// annualSurplusAtIssuance. Returns the post-issuance
// (sumMABPrincipal / annualSurplusAtIssuance) ratio (for the response) and
// an error if above ceiling. The check re-runs at every issuance (not just
// the first), so a pool that issues up to the ceiling cannot issue more.
func (s msgServer) checkMABIssuanceCeiling(ctx sdk.Context, poolID string, newPrincipal int64, annualSurplusAtIssuance int64) (int64, error) {
existing := int64(0)
for _, m := range s.Keeper.MABsForPool(ctx, poolID) {
existing += m.PrincipalGrain
}
total := existing + newPrincipal
ceiling := int64(types.MABIssuanceCeilingAnnualSurplusMultiple) * annualSurplusAtIssuance
if total > ceiling {
return 0, fmt.Errorf("bond: MAB issuance ceiling breached (sum %d + new %d = %d > 3× annual-surplus %d = %d — REQ-054 locked)",
existing, newPrincipal, total, annualSurplusAtIssuance, ceiling)
}
if annualSurplusAtIssuance == 0 {
return 0, nil
}
return total / annualSurplusAtIssuance, nil
}
// IssueMAB issues a Mutual Aid Bond (REQ-054, D-080). The handler enforces:
// 1. ValidateBasic (stateless — includes ValidateMAB: rejects
// CouponDenomBread with FR-MAB-3).
// 2. Idempotency: bond-id must not already exist (as a Bond, GrowthBond, or
// MAB).
// 3. StandKeeper shim: the issuer-stand-id must reference an existing Stand
// (P1-02-01 edge). A nil shim skips (simtest wiring).
// 4. FR-MAB-3 defense-in-depth: ValidateMAB re-check (rejects
// CouponDenomBread — the handler re-checks in case of a future
// ValidateBasic bypass).
// 5. 3× annual surplus ceiling: checkMABIssuanceCeiling asserts
// sum(existingMABPrincipal for poolID) + PrincipalGrain <=
// MABIssuanceCeilingAnnualSurplusMultiple × AnnualSurplusAtIssuance.
// REJECT if above ceiling.
// 6. Coupon clamp via Clamp (A-563 — defense in depth).
// 7. Persist the MAB with UseOfProceedsTag = MABUseOfProceedsReserveBuildOut
// + record the pool-id in the mab-pool index. Emit bond.mab_issued.
func (s msgServer) IssueMAB(ctx interface{}, msg *types.MsgIssueMAB) (*types.MsgIssueMABResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// Idempotency: bond-id must not already exist (as Bond, GrowthBond, or MAB).
if _, ok := s.Keeper.GetBond(sdkCtx, msg.BondID); ok {
return nil, fmt.Errorf("bond: bond-id %q already exists (as a Bond)", msg.BondID)
}
if _, ok := s.Keeper.GetGrowthBond(sdkCtx, msg.BondID); ok {
return nil, fmt.Errorf("bond: bond-id %q already exists (as a GrowthBond)", msg.BondID)
}
if _, ok := s.Keeper.GetMAB(sdkCtx, msg.BondID); ok {
return nil, fmt.Errorf("bond: bond-id %q already exists (as a MAB)", msg.BondID)
}
// StandKeeper: issuer-stand-id must reference an existing Stand.
if s.Keeper.standKeeper != nil {
if !s.Keeper.standKeeper.StandExists(msg.IssuerStandID) {
return nil, fmt.Errorf("bond: issuer-stand-id %q does not exist (IssueMAB rejected)", msg.IssuerStandID)
}
}
// FR-MAB-3 defense-in-depth: re-run ValidateMAB (the handler re-checks
// in case of a future ValidateBasic bypass).
if err := types.ValidateMAB(types.MAB{CouponKind: msg.CouponKind}); err != nil {
return nil, err
}
// 3× annual surplus ceiling (REQ-054 locked).
ceilingMultiple, err := s.checkMABIssuanceCeiling(sdkCtx, msg.PoolID, msg.PrincipalGrain, msg.AnnualSurplusAtIssuance)
if err != nil {
return nil, err
}
// Coupon clamp (A-563 — defense in depth; ValidateBasic already
// rejected out-of-band, so Clamp is a no-op here).
clamped := types.Clamp(msg.CouponBps)
m := types.IssueMAB(msg.BondID, msg.IssuerStandID, msg.PrincipalGrain, clamped, msg.CouponKind, msg.AnnualSurplusAtIssuance, msg.TermDays, sdkCtx.BlockTime().Unix(), sdkCtx.BlockTime().Unix()+int64(msg.TermDays)*24*60*60)
s.Keeper.SetMAB(sdkCtx, m)
s.Keeper.setMABPool(sdkCtx, msg.BondID, msg.PoolID)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"bond.mab_issued",
sdk.NewAttribute("bond_id", msg.BondID),
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("issuer_stand_id", msg.IssuerStandID),
sdk.NewAttribute("coupon_bps", fmt.Sprintf("%d", clamped)),
sdk.NewAttribute("coupon_kind", string(msg.CouponKind)),
sdk.NewAttribute("use_of_proceeds_tag", m.UseOfProceedsTag),
sdk.NewAttribute("ceiling_multiple", fmt.Sprintf("%d", ceilingMultiple)),
))
return &types.MsgIssueMABResponse{
ClampedCouponBps: clamped,
CeilingMultiple: ceilingMultiple,
}, nil
}
// DebitMABProceeds debits a MAB's tagged proceeds to the Pool's
// ReserveAccount (D-080). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The MAB must exist.
// 3. D-080 tagged streaming: query the mab-pool index for the MAB's poolID,
// then query CoverKeeper.GetPoolReserveAccount(poolID). If the
// DestinationAccount != the pool's ReserveAccount -> StillKeeper.Still(
// bondID, "MAB misuse — proceeds routed outside reserve") (D-089(1) — a
// nil StillKeeper skips the Still recording but the handler STILL
// REJECTS) AND REJECT. A nil CoverKeeper is a wiring error -> REJECT
// (the destination cannot be validated). If match -> emit
// bond.mab_proceeds_debited (simtest: the debit is the event; no actual
// Grain transfer in P4).
func (s msgServer) DebitMABProceeds(ctx interface{}, msg *types.MsgDebitMABProceeds) (*types.MsgDebitMABProceedsResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
m, ok := s.Keeper.GetMAB(sdkCtx, msg.BondID)
if !ok {
return nil, fmt.Errorf("bond: mab %q not found (DebitMABProceeds rejected)", msg.BondID)
}
_ = m
poolID, ok := s.Keeper.GetMABPool(sdkCtx, msg.BondID)
if !ok {
return nil, fmt.Errorf("bond: mab %q has no pool binding (DebitMABProceeds rejected)", msg.BondID)
}
// D-080 tagged streaming: the destination must == the pool's
// ReserveAccount. A nil CoverKeeper is a wiring error -> REJECT (the
// destination cannot be validated).
if s.Keeper.coverKeeper == nil {
return nil, fmt.Errorf("bond: CoverKeeper shim not wired (DebitMABProceeds cannot validate destination — D-089(2) reverse edge required)")
}
reserveAccount, exists := s.Keeper.coverKeeper.GetPoolReserveAccount(poolID)
if !exists {
return nil, fmt.Errorf("bond: pool %q ReserveAccount not found (DebitMABProceeds rejected)", poolID)
}
if msg.DestinationAccount != reserveAccount {
// D-080 misuse -> D-089(1) auto-Still. A nil StillKeeper skips the
// Still recording but the handler STILL REJECTS (the debit is not
// committed regardless).
if s.Keeper.stillKeeper != nil {
_ = s.Keeper.stillKeeper.Still(msg.BondID, "MAB misuse — proceeds routed outside reserve")
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"bond.mab_proceeds_misuse",
sdk.NewAttribute("bond_id", msg.BondID),
sdk.NewAttribute("pool_id", poolID),
sdk.NewAttribute("destination_account", msg.DestinationAccount),
sdk.NewAttribute("expected_reserve_account", reserveAccount),
))
return nil, fmt.Errorf("bond: MAB %q proceeds destination %q != pool %q ReserveAccount %q (D-080 tagged-streaming misuse — auto-Still + REJECT)", msg.BondID, msg.DestinationAccount, poolID, reserveAccount)
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"bond.mab_proceeds_debited",
sdk.NewAttribute("bond_id", msg.BondID),
sdk.NewAttribute("pool_id", poolID),
sdk.NewAttribute("destination_account", msg.DestinationAccount),
))
return &types.MsgDebitMABProceedsResponse{}, nil
}
// WitnessMABProceedsRelease is a Watcher-witnessed release of a MAB's tagged
// proceeds from staging to the reserve (D-080). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The MAB must exist.
// 3. Watcher quorum: WatcherKeeper.AttestMABRelease(bondID, attestationRef)
// returns true if quorum (6-of-9) is met. If false (quorum not met) ->
// REJECT. If true -> emit bond.mab_proceeds_released. A nil WatcherKeeper
// skips the quorum check (simtest wiring — the handler still mutates
// state; the simtest documents the wiring).
func (s msgServer) WitnessMABProceedsRelease(ctx interface{}, msg *types.MsgWitnessMABProceedsRelease) (*types.MsgWitnessMABProceedsReleaseResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
if _, ok := s.Keeper.GetMAB(sdkCtx, msg.BondID); !ok {
return nil, fmt.Errorf("bond: mab %q not found (WitnessMABProceedsRelease rejected)", msg.BondID)
}
// Watcher quorum (D-080). A nil WatcherKeeper skips the quorum check
// (simtest wiring — the handler still mutates state).
if s.Keeper.watcherKeeper != nil {
if !s.Keeper.watcherKeeper.AttestMABRelease(msg.BondID, msg.AttestationRef) {
return nil, fmt.Errorf("bond: MAB %q proceeds release rejected (Watcher quorum not met — D-080 6-of-9 required)", msg.BondID)
}
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"bond.mab_proceeds_released",
sdk.NewAttribute("bond_id", msg.BondID),
sdk.NewAttribute("attestation_ref", msg.AttestationRef),
))
return &types.MsgWitnessMABProceedsReleaseResponse{}, nil
}
// WatcherAttestMAB records a quarterly Watcher audit attestation on a MAB
// (D-080). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The MAB must exist.
// 3. Record the attestation (a store entry mab_attest/<bondID>/<timestamp>
// -> attestationRef). Emit bond.mab_watcher_attested.
func (s msgServer) WatcherAttestMAB(ctx interface{}, msg *types.MsgWatcherAttestMAB) (*types.MsgWatcherAttestMABResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
if _, ok := s.Keeper.GetMAB(sdkCtx, msg.BondID); !ok {
return nil, fmt.Errorf("bond: mab %q not found (WatcherAttestMAB rejected)", msg.BondID)
}
ts := sdkCtx.BlockTime().Unix()
s.Keeper.SetMABAttest(sdkCtx, msg.BondID, ts, msg.AttestationRef)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"bond.mab_watcher_attested",
sdk.NewAttribute("bond_id", msg.BondID),
sdk.NewAttribute("attestation_ref", msg.AttestationRef),
sdk.NewAttribute("timestamp", fmt.Sprintf("%d", ts)),
))
return &types.MsgWatcherAttestMABResponse{}, nil
}
+541
View File
@@ -94,6 +94,51 @@ func (s *stubStandKeeper) StandExists(standID string) bool {
return s.existsAll
}
// stubCoverKeeper satisfies btypes.CoverKeeper for the v0.7 P4 MAB simtest
// (D-089(2) reverse edge). It returns the configured ReserveAccount per
// pool-id.
type stubCoverKeeper struct {
reserveAccounts map[string]string
}
func (s *stubCoverKeeper) GetPoolReserveAccount(poolID string) (string, bool) {
if s.reserveAccounts == nil {
return "", false
}
acc, ok := s.reserveAccounts[poolID]
return acc, ok
}
// stubWatcherKeeperBond satisfies btypes.WatcherKeeper for the v0.7 P4 MAB
// simtest. It returns a configurable quorum-met bool per
// AttestMABRelease call.
type stubWatcherKeeperBond struct {
quorumMet bool
}
func (s *stubWatcherKeeperBond) AttestMABRelease(bondID string, attestationRef string) bool {
return s.quorumMet
}
// stubStillKeeperBond satisfies btypes.StillKeeper for the v0.7 P4 MAB
// simtest (D-089(1)). It records every Still() call for assertion (the
// tagged-streaming misuse simtest asserts Still was called with the right
// bond-id + reason).
type stubStillKeeperBond struct {
calls []struct {
bondID string
reason string
}
}
func (s *stubStillKeeperBond) Still(bondID string, reason string) error {
s.calls = append(s.calls, struct {
bondID string
reason string
}{bondID, reason})
return nil
}
// --- Simtest context helper --------------------------------------------------
// newSimtestContext constructs an in-memory sdk.Context with a KVStore
@@ -165,6 +210,32 @@ func freshCtx(t *testing.T) (sdk.Context, *stubStandKeeper, keeper.Keeper) {
return newSimtestContext(t)
}
// newMABSimtestContext constructs an in-memory sdk.Context with the MAB
// shims (CoverKeeper + WatcherKeeper + StillKeeper) wired for the v0.7 P4
// MAB simtest (D-089(1) + D-089(2)). Returns the ctx, the four stubs, and
// the Keeper.
func newMABSimtestContext(t *testing.T) (sdk.Context, *stubStandKeeper, *stubCoverKeeper, *stubWatcherKeeperBond, *stubStillKeeperBond, keeper.Keeper) {
t.Helper()
db := dbm.NewMemDB()
cdc := newTestCodec()
storeKey := storetypes.NewKVStoreKey(btypes.StoreKey)
cms := store.NewCommitMultiStore(db, log.NewNopLogger(), nil)
cms.MountStoreWithDB(storeKey, storetypes.StoreTypeDB, nil)
if err := cms.LoadLatestVersion(); err != nil {
t.Fatalf("load latest version: %v", err)
}
ctx := sdk.NewContext(cms, cmtproto.Header{Time: time.Unix(1000, 0)}, false, log.NewNopLogger())
sk := &stubStandKeeper{existsAll: true}
ck := &stubCoverKeeper{reserveAccounts: map[string]string{"pool-1": "reserve-acc-1"}}
wk := &stubWatcherKeeperBond{quorumMet: true}
stK := &stubStillKeeperBond{}
k := keeper.NewKeeper(cdc, storeKey, sk)
k.SetCoverKeeper(ck)
k.SetWatcherKeeper(wk)
k.SetStillKeeper(stK)
return ctx, sk, ck, wk, stK, k
}
// --- Bond issuance (coupon clamp at issuance) --------------------------------
// TestIssueBondInBand asserts an in-band coupon (500) is recorded unchanged
@@ -1292,3 +1363,473 @@ func TestMatchAboveCapRejectStopsMatching(t *testing.T) {
t.Errorf("sell-inband RemainingQuantityGrain = %d, want 50 (untouched)", ro.RemainingQuantityGrain)
}
}
// --- v0.7 P4: MAB simtest (REQ-054, D-080, D-089(1), D-089(2)) ----------------
//
// (Mutual Aid Bond runtime — issuance + Bread-coupon rejection + 3× annual
// surplus ceiling + tagged-streaming misuse -> auto-Still + Watcher-witnessed
// release + quarterly attestation).
// TestMABIssuanceValidCoverCallCoupons (case a) asserts a MAB issuance with
// valid Cover-Call coupons (CouponDenomCoverCall) succeeds + the
// bond.mab_issued event is emitted + the UseOfProceedsTag is locked to
// "reserve_build_out".
func TestMABIssuanceValidCoverCallCoupons(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
resp, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
if resp.ClampedCouponBps != 500 {
t.Errorf("ClampedCouponBps = %d, want 500", resp.ClampedCouponBps)
}
if !hasEvent(ctx, "bond.mab_issued") {
t.Error("bond.mab_issued event not emitted")
}
// Read it back.
m, ok := k.GetMAB(ctx, "mab-1")
if !ok {
t.Fatal("MAB not persisted")
}
if m.CouponKind != btypes.CouponDenomCoverCall {
t.Errorf("CouponKind = %q, want CoverCall", m.CouponKind)
}
if m.UseOfProceedsTag != btypes.MABUseOfProceedsReserveBuildOut {
t.Errorf("UseOfProceedsTag = %q, want %q (D-080 lock)", m.UseOfProceedsTag, btypes.MABUseOfProceedsReserveBuildOut)
}
// The mab-pool index recorded the pool binding.
poolID, ok := k.GetMABPool(ctx, "mab-1")
if !ok {
t.Fatal("mab-pool index not recorded")
}
if poolID != "pool-1" {
t.Errorf("mab-pool index = %q, want pool-1", poolID)
}
}
// TestMABIssuanceBreadCouponsRejected (case b) asserts a MAB issuance with
// Bread coupons (CouponDenomBread) is REJECTED at ValidateBasic (FR-MAB-3).
func TestMABIssuanceBreadCouponsRejected(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-bad", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomBread,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err == nil {
t.Fatal("IssueMAB with CouponDenomBread should be REJECTED (FR-MAB-3)")
}
if !strings.Contains(err.Error(), "FR-MAB-3") {
t.Errorf("err = %q, want 'FR-MAB-3'", err.Error())
}
// The MAB was NOT persisted.
if _, ok := k.GetMAB(ctx, "mab-bad"); ok {
t.Error("MAB with Bread coupons should NOT be persisted")
}
}
// TestMABIssuanceAboveCeilingRejected (case c) asserts a MAB issuance that
// would push the total outstanding MAB principal above the 3× annual
// surplus ceiling is REJECTED (REQ-054 locked). Issue two MABs that
// together + a third exceed 3× annual surplus.
func TestMABIssuanceAboveCeilingRejected(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
// Annual surplus = 5M -> ceiling = 15M. Issue two MABs at 7M each
// (sum = 14M, within ceiling). A third at 2M would push the sum to
// 16M > 15M -> REJECT.
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-c1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 7_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("first IssueMAB: %v", err)
}
_, err = srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-c2", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 7_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomMutualAidCredit,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("second IssueMAB: %v", err)
}
// Third at 2M -> sum 16M > 15M ceiling -> REJECT.
_, err = srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-c3", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 2_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err == nil {
t.Fatal("third IssueMAB above 3× ceiling should be REJECTED")
}
if !strings.Contains(err.Error(), "ceiling breached") {
t.Errorf("err = %q, want 'ceiling breached'", err.Error())
}
}
// TestMABDebitProceedsMisuseAutoStill (case d) asserts a MAB proceeds debit
// with a destination != the Pool's ReserveAccount triggers the auto-Still
// (D-089(1)) AND is REJECTED (D-080 tagged-streaming misuse).
func TestMABDebitProceedsMisuseAutoStill(t *testing.T) {
ctx, _, _, _, stK, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
// Issue a MAB for pool-1 (whose ReserveAccount is "reserve-acc-1").
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-d1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
// Debit to a WRONG destination -> auto-Still + REJECT.
_, err = srv.DebitMABProceeds(ctx, &btypes.MsgDebitMABProceeds{
BondID: "mab-d1", DestinationAccount: "wrong-destination", Signer: "stand-1",
})
if err == nil {
t.Fatal("DebitMABProceeds with wrong destination should be REJECTED")
}
if !strings.Contains(err.Error(), "tagged-streaming misuse") {
t.Errorf("err = %q, want 'tagged-streaming misuse'", err.Error())
}
// The StillKeeper was called with the right bond-id + reason.
if len(stK.calls) != 1 {
t.Fatalf("StillKeeper.Still calls = %d, want 1", len(stK.calls))
}
if stK.calls[0].bondID != "mab-d1" {
t.Errorf("Still bondID = %q, want mab-d1", stK.calls[0].bondID)
}
if !strings.Contains(stK.calls[0].reason, "MAB misuse") {
t.Errorf("Still reason = %q, want 'MAB misuse'", stK.calls[0].reason)
}
// The misuse event was emitted.
if !hasEvent(ctx, "bond.mab_proceeds_misuse") {
t.Error("bond.mab_proceeds_misuse event not emitted")
}
}
// TestMABDebitProceedsMatchSucceeds asserts a MAB proceeds debit with the
// destination == the Pool's ReserveAccount succeeds + the
// bond.mab_proceeds_debited event is emitted.
func TestMABDebitProceedsMatchSucceeds(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-d2", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
// Debit to the CORRECT destination (reserve-acc-1) -> succeeds.
_, err = srv.DebitMABProceeds(ctx, &btypes.MsgDebitMABProceeds{
BondID: "mab-d2", DestinationAccount: "reserve-acc-1", Signer: "stand-1",
})
if err != nil {
t.Fatalf("DebitMABProceeds with matching destination: %v", err)
}
if !hasEvent(ctx, "bond.mab_proceeds_debited") {
t.Error("bond.mab_proceeds_debited event not emitted")
}
}
// TestMABWitnessProceedsReleaseQuorumPresent (case e) asserts a MAB
// proceeds release with Watcher quorum present succeeds + the
// bond.mab_proceeds_released event is emitted.
func TestMABWitnessProceedsReleaseQuorumPresent(t *testing.T) {
ctx, _, _, wk, _, k := newMABSimtestContext(t)
wk.quorumMet = true
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-w1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
_, err = srv.WitnessMABProceedsRelease(ctx, &btypes.MsgWitnessMABProceedsRelease{
BondID: "mab-w1", AttestationRef: "oy:attest:mab-w1", Signer: "watcher-1",
})
if err != nil {
t.Fatalf("WitnessMABProceedsRelease with quorum: %v", err)
}
if !hasEvent(ctx, "bond.mab_proceeds_released") {
t.Error("bond.mab_proceeds_released event not emitted")
}
}
// TestMABWitnessProceedsReleaseQuorumAbsent asserts a MAB proceeds release
// with Watcher quorum NOT met is REJECTED (D-080 — 6-of-9 required).
func TestMABWitnessProceedsReleaseQuorumAbsent(t *testing.T) {
ctx, _, _, wk, _, k := newMABSimtestContext(t)
wk.quorumMet = false
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-w2", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
_, err = srv.WitnessMABProceedsRelease(ctx, &btypes.MsgWitnessMABProceedsRelease{
BondID: "mab-w2", AttestationRef: "oy:attest:mab-w2", Signer: "watcher-1",
})
if err == nil {
t.Fatal("WitnessMABProceedsRelease without quorum should be REJECTED")
}
if !strings.Contains(err.Error(), "quorum not met") {
t.Errorf("err = %q, want 'quorum not met'", err.Error())
}
}
// TestMABWatcherAttest (case f) asserts a quarterly Watcher attestation on
// a MAB is recorded + the bond.mab_watcher_attested event is emitted.
func TestMABWatcherAttest(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-a1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
_, err = srv.WatcherAttestMAB(ctx, &btypes.MsgWatcherAttestMAB{
BondID: "mab-a1", AttestationRef: "oy:attest:quarterly:mab-a1", Signer: "watcher-1",
})
if err != nil {
t.Fatalf("WatcherAttestMAB: %v", err)
}
if !hasEvent(ctx, "bond.mab_watcher_attested") {
t.Error("bond.mab_watcher_attested event not emitted")
}
// The attestation was recorded.
atts := k.AllMABAttests(ctx, "mab-a1")
if len(atts) != 1 {
t.Fatalf("AllMABAttests = %d, want 1", len(atts))
}
if atts[0] != "oy:attest:quarterly:mab-a1" {
t.Errorf("attestation ref = %q, want oy:attest:quarterly:mab-a1", atts[0])
}
}
// TestMABIssueIdempotentReject asserts issuing the same MAB bond-id twice
// REJECTS the second.
func TestMABIssueIdempotentReject(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-i1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("first IssueMAB: %v", err)
}
_, err = srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-i1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 2_000_000, CouponBps: 600, CouponKind: btypes.CouponDenomMutualAidCredit,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err == nil {
t.Fatal("second IssueMAB on same bond-id should be REJECTED")
}
}
// TestMABIssueNonExistentStandRejected asserts a MAB issuance on a non-
// existent Stand is REJECTED (the StandKeeper stub reports false).
func TestMABIssueNonExistentStandRejected(t *testing.T) {
ctx, sk, _, _, _, k := newMABSimtestContext(t)
sk.exists = map[string]bool{"stand-1": false}
sk.existsAll = false
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-s1", PoolID: "pool-1", IssuerStandID: "no-such-stand",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err == nil {
t.Fatal("IssueMAB on non-existent Stand should be REJECTED")
}
}
// TestMABDebitProceedsNotFound asserts a debit on a non-existent MAB is
// REJECTED.
func TestMABDebitProceedsNotFound(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.DebitMABProceeds(ctx, &btypes.MsgDebitMABProceeds{
BondID: "no-such-mab", DestinationAccount: "reserve-acc-1", Signer: "stand-1",
})
if err == nil {
t.Error("DebitMABProceeds on non-existent MAB should be REJECTED")
}
}
// TestMABWitnessProceedsReleaseNotFound asserts a release on a non-existent
// MAB is REJECTED.
func TestMABWitnessProceedsReleaseNotFound(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.WitnessMABProceedsRelease(ctx, &btypes.MsgWitnessMABProceedsRelease{
BondID: "no-such-mab", AttestationRef: "ref", Signer: "watcher-1",
})
if err == nil {
t.Error("WitnessMABProceedsRelease on non-existent MAB should be REJECTED")
}
}
// TestMABWatcherAttestNotFound asserts an attestation on a non-existent MAB
// is REJECTED.
func TestMABWatcherAttestNotFound(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
_, err := srv.WatcherAttestMAB(ctx, &btypes.MsgWatcherAttestMAB{
BondID: "no-such-mab", AttestationRef: "ref", Signer: "watcher-1",
})
if err == nil {
t.Error("WatcherAttestMAB on non-existent MAB should be REJECTED")
}
}
// TestMABDebitProceedsNilCoverKeeperRejected asserts a debit with a nil
// CoverKeeper shim (wiring error) is REJECTED (the destination cannot be
// validated — D-089(2) reverse edge required).
func TestMABDebitProceedsNilCoverKeeperRejected(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
k.SetCoverKeeper(nil) // nil CoverKeeper — wiring error
srv := keeper.NewMsgServerImpl(k)
_, err := srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-n1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if err != nil {
t.Fatalf("IssueMAB: %v", err)
}
_, err = srv.DebitMABProceeds(ctx, &btypes.MsgDebitMABProceeds{
BondID: "mab-n1", DestinationAccount: "reserve-acc-1", Signer: "stand-1",
})
if err == nil {
t.Error("DebitMABProceeds with nil CoverKeeper should be REJECTED (wiring error)")
}
if !strings.Contains(err.Error(), "CoverKeeper shim not wired") {
t.Errorf("err = %q, want 'CoverKeeper shim not wired'", err.Error())
}
}
// TestMABMsgValidateBasicErrorPaths exercises each MAB Msg* ValidateBasic
// error path for coverage.
func TestMABMsgValidateBasicErrorPaths(t *testing.T) {
// MsgIssueMAB empty.
if err := (&btypes.MsgIssueMAB{}).ValidateBasic(); err == nil {
t.Error("empty MsgIssueMAB should fail ValidateBasic")
}
// MsgIssueMAB with Bread coupons -> FR-MAB-3.
if err := (&btypes.MsgIssueMAB{
BondID: "x", PoolID: "p", IssuerStandID: "s", PrincipalGrain: 1,
CouponBps: 500, CouponKind: btypes.CouponDenomBread,
AnnualSurplusAtIssuance: 1, TermDays: 365, Signer: "s",
}).ValidateBasic(); err == nil {
t.Error("MsgIssueMAB with Bread coupons should fail ValidateBasic (FR-MAB-3)")
}
// MsgIssueMAB with above-cap coupon.
if err := (&btypes.MsgIssueMAB{
BondID: "x", PoolID: "p", IssuerStandID: "s", PrincipalGrain: 1,
CouponBps: 1200, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 1, TermDays: 365, Signer: "s",
}).ValidateBasic(); err == nil {
t.Error("above-cap MsgIssueMAB should fail ValidateBasic")
}
// MsgIssueMAB with zero principal.
if err := (&btypes.MsgIssueMAB{
BondID: "x", PoolID: "p", IssuerStandID: "s", PrincipalGrain: 0,
CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 1, TermDays: 365, Signer: "s",
}).ValidateBasic(); err == nil {
t.Error("zero-principal MsgIssueMAB should fail ValidateBasic")
}
// MsgDebitMABProceeds empty.
if err := (&btypes.MsgDebitMABProceeds{}).ValidateBasic(); err == nil {
t.Error("empty MsgDebitMABProceeds should fail ValidateBasic")
}
// MsgWitnessMABProceedsRelease empty.
if err := (&btypes.MsgWitnessMABProceedsRelease{}).ValidateBasic(); err == nil {
t.Error("empty MsgWitnessMABProceedsRelease should fail ValidateBasic")
}
// MsgWatcherAttestMAB empty.
if err := (&btypes.MsgWatcherAttestMAB{}).ValidateBasic(); err == nil {
t.Error("empty MsgWatcherAttestMAB should fail ValidateBasic")
}
}
// TestMABKeeperAccessors exercises the MAB keeper accessors (AllMABs,
// MABsForPool, AllMABAttests) for coverage.
func TestMABKeeperAccessors(t *testing.T) {
ctx, _, _, _, _, k := newMABSimtestContext(t)
srv := keeper.NewMsgServerImpl(k)
// Empty-store accessors return empty (not nil) slices.
if got := k.AllMABs(ctx); len(got) != 0 {
t.Errorf("AllMABs empty = %d, want 0", len(got))
}
if got := k.MABsForPool(ctx, "pool-1"); len(got) != 0 {
t.Errorf("MABsForPool empty = %d, want 0", len(got))
}
if got := k.AllMABAttests(ctx, "mab-x"); len(got) != 0 {
t.Errorf("AllMABAttests empty = %d, want 0", len(got))
}
// Issue + read back.
_, _ = srv.IssueMAB(ctx, &btypes.MsgIssueMAB{
BondID: "mab-acc-1", PoolID: "pool-1", IssuerStandID: "stand-1",
PrincipalGrain: 1_000_000, CouponBps: 500, CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000, TermDays: 365, Signer: "stand-1",
})
if got := k.AllMABs(ctx); len(got) != 1 {
t.Errorf("AllMABs = %d, want 1", len(got))
}
if got := k.MABsForPool(ctx, "pool-1"); len(got) != 1 {
t.Errorf("MABsForPool pool-1 = %d, want 1", len(got))
}
if got := k.MABsForPool(ctx, "other-pool"); len(got) != 0 {
t.Errorf("MABsForPool other-pool = %d, want 0", len(got))
}
// Marshal-error path on GetMAB (corrupt bytes in store).
rawStore := ctx.KVStore(k.StoreKey())
rawStore.Set([]byte("mab/corrupt"), []byte("not-json"))
if _, ok := k.GetMAB(ctx, "corrupt"); ok {
t.Error("GetMAB on corrupt bytes should return false")
}
}
+67 -4
View File
@@ -36,15 +36,78 @@ package types
// A non-existent Stand REJECTS the issuance (the bond is not created).
// - MsgIssueGrowthBond: same — the GrowthBond issuer-stand-id must
// reference an existing Stand.
// - MsgIssueMAB: same — the MAB issuer-stand-id must reference an
// existing Stand (v0.7 P4 extension).
//
// No struct import of x/stand/types — the interface is the by-ID-string
// boundary (G-003). The standID is an opaque string (the Stand's ID, by-
// ID-string ref to x/stand).
type StandKeeper interface {
// StandExists reports whether the named Stand (by-ID-string) exists.
// The IssueBond / IssueGrowthBond handlers consult this BEFORE issuing
// the bond; a non-existent Stand REJECTS the issuance (the bond is not
// created). A nil shim skips this check (simtest wiring — documented in
// the handler).
// The IssueBond / IssueGrowthBond / IssueMAB handlers consult this
// BEFORE issuing the bond; a non-existent Stand REJECTS the issuance
// (the bond is not created). A nil shim skips this check (simtest
// wiring — documented in the handler).
StandExists(standID string) bool
}
// CoverKeeper is the expected-keeper interface for x/cover (G-003 — D-089(2)
// reverse edge). The v0.7 MAB handler calls it for:
// - MsgDebitMABProceeds: the handler queries GetPoolReserveAccount(poolID)
// to validate the destination == the Pool's ReserveAccount
// (D-080 tagged streaming). A mismatch -> auto-Still via StillKeeper +
// REJECT. A nil CoverKeeper is a wiring error (the handler REJECTS a
// debit when no CoverKeeper is wired — the destination cannot be
// validated; the simtest wires a stub).
//
// No struct import of x/cover/types — the interface is the by-ID-string
// boundary (G-003 — D-089(2) reverse edge). The poolID is an opaque string
// (the Cover Pool's ID). No import cycle (interface only — the concrete
// cover keeper satisfies this structurally; the simtest wires a stub).
type CoverKeeper interface {
// GetPoolReserveAccount returns the Cover Pool's ReserveAccount by
// pool-id (D-089(2) reverse edge). The MsgDebitMABProceeds handler
// compares the destination against this; a mismatch triggers the
// auto-Still. Returns ("", false) if the pool does not exist.
GetPoolReserveAccount(poolID string) (reserveAccount string, exists bool)
}
// WatcherKeeper is the expected-keeper interface for x/watcher (G-003). The
// v0.7 MAB handler calls it for:
// - MsgWitnessMABProceedsRelease: the handler requires Watcher quorum
// (6-of-9) before the tagged proceeds move from staging to the reserve.
// AttestMABRelease(bondID, attestationRef) returns true if quorum is
// met (the simtest stub returns a configurable bool). A nil
// WatcherKeeper skips the quorum check (simtest wiring — the handler
// still mutates state; the simtest documents the wiring).
//
// No struct import of x/watcher/types — the interface is the by-ID-string
// boundary (G-003). The bondID + attestationRef are opaque strings.
type WatcherKeeper interface {
// AttestMABRelease reports whether the Watcher quorum (6-of-9) is met
// for the MAB proceeds release (D-080). Returns true if quorum present;
// false if not (the handler REJECTS the release). The attestationRef
// is the Watcher-signed observation ref.
AttestMABRelease(bondID string, attestationRef string) bool
}
// StillKeeper is the expected-keeper interface for x/still (G-003 — D-089(1)
// simtest stub). The v0.7 MAB handler calls it for:
// - MsgDebitMABProceeds: on a destination mismatch (D-080 tagged-streaming
// misuse), the handler invokes Still(bondID, "MAB misuse — proceeds
// routed outside reserve") BEFORE rejecting. A nil StillKeeper skips
// the Still recording (simtest wiring — the handler still REJECTS the
// debit; the Still event is just not recorded in a still store).
//
// No struct import of x/still/types — the interface is the by-ID-string
// boundary (G-003). P4 satisfies this by a simtest-local stub (x/still is
// NOT extended this milestone — the simtest stub records Still() calls for
// assertion).
type StillKeeper interface {
// Still pauses the named entity (by-ID-string) for the given reason.
// The MsgDebitMABProceeds handler calls this on a destination mismatch
// (D-080 misuse -> D-089(1) auto-Still). A non-nil error does NOT
// suppress the handler's REJECT (the handler REJECTS regardless; the
// Still is the pause-recording side-effect).
Still(bondID string, reason string) error
}
+38
View File
@@ -142,3 +142,41 @@ func knownOrderStatus(s OrderStatus) bool {
}
return false
}
// --- v0.7 extension: MAB genesis helpers (REQ-054, G-008) ---------------------
//
// genesis.go also holds the data-engineer's genesis schema helpers for the
// v0.7 MAB set (G-008). ValidateGenesis in types.go composes ValidateMABs;
// the security-engineer's test assertions live in types_test.go.
// ValidateMABs asserts mab bond-ids are present and unique, that each
// embedded Bond's coupon-bps is within the LOCKED [floor, cap] bounds
// (D-028), and that each MAB passes ValidateMAB (FR-MAB-3 — rejects
// CouponDenomBread). The genesis-side ValidateMAB is the authoritative
// check (a genesis MAB with a rejected CouponKind is rejected at genesis
// load rather than silently dropped).
func ValidateMABs(mabs []MAB) error {
seen := make(map[string]bool, len(mabs))
for i, m := range mabs {
if m.BondID == "" {
return fmt.Errorf("mab [%d]: empty bond-id", i)
}
if seen[m.BondID] {
return fmt.Errorf("mab: duplicate bond-id %q", m.BondID)
}
seen[m.BondID] = true
if !knownBondStatus(m.Status) {
return fmt.Errorf("mab %q: unknown bond status %q", m.BondID, m.Status)
}
// D-028 clamp on the embedded Bond's coupon.
if m.CouponBps < CouponFloorBps || m.CouponBps > CouponCapBps {
return fmt.Errorf("mab %q: coupon-bps %d outside [%d, %d] (D-028 clamp at genesis load)",
m.BondID, m.CouponBps, CouponFloorBps, CouponCapBps)
}
// FR-MAB-3: MAB coupons NEVER Bread (the dual-firewall runtime gate).
if err := ValidateMAB(m); err != nil {
return fmt.Errorf("mab %q: %w", m.BondID, err)
}
}
return nil
}
+6
View File
@@ -394,6 +394,12 @@ type MsgServer interface {
PlaceSecondaryOrder(ctx interface{}, msg *MsgPlaceSecondaryOrder) (*MsgPlaceSecondaryOrderResponse, error)
CancelSecondaryOrder(ctx interface{}, msg *MsgCancelSecondaryOrder) (*MsgCancelSecondaryOrderResponse, error)
MatchSecondaryOrder(ctx interface{}, msg *MsgMatchSecondaryOrder) (*MsgMatchSecondaryOrderResponse, error)
// v0.7 MAB handlers (REQ-054, D-080, D-089(1), D-089(2)) — defined in
// msg_mab.go.
IssueMAB(ctx interface{}, msg *MsgIssueMAB) (*MsgIssueMABResponse, error)
DebitMABProceeds(ctx interface{}, msg *MsgDebitMABProceeds) (*MsgDebitMABProceedsResponse, error)
WitnessMABProceedsRelease(ctx interface{}, msg *MsgWitnessMABProceedsRelease) (*MsgWitnessMABProceedsReleaseResponse, error)
WatcherAttestMAB(ctx interface{}, msg *MsgWatcherAttestMAB) (*MsgWatcherAttestMABResponse, error)
}
// Response types (hand-rolled; the response is the state mutation + event).
+330
View File
@@ -0,0 +1,330 @@
package types
// msg_mab.go holds the v0.7 Mutual Aid Bond Msg* types implementing sdk.Msg
// (REQ-054, D-080, D-089(1), D-089(2); G-006 controlled exception: types/
// gains the cosmos-sdk import for sdk.Msg — D-055; the invariant/lexicon
// tests in *_test.go stay stdlib-only per G-024, isolated from this
// msg_*.go file).
//
// The four MAB Msg types drive the MAB runtime (REQ-054):
// - MsgIssueMAB: issue a Mutual Aid Bond (the handler enforces the 3×
// annual surplus ceiling + the FR-MAB-3 Bread-coupon rejection +
// Clamp on the coupon).
// - MsgDebitMABProceeds: debit the MAB's tagged proceeds to the Pool's
// ReserveAccount (D-080 — the handler checks destination ==
// CoverKeeper.GetPoolReserveAccount; mismatch -> auto-Still via
// StillKeeper + REJECT).
// - MsgWitnessMABProceedsRelease: a Watcher-witnessed release of the
// tagged proceeds from staging to the reserve (D-080 — the handler
// requires WatcherKeeper.AttestMABRelease quorum 6-of-9).
// - MsgWatcherAttestMAB: the quarterly Watcher audit attestation on a
// MAB (records the attestation-ref against the MAB).
//
// All cross-module refs are by-ID-string (G-003): pool-id refs a Cover Pool
// (via the CoverKeeper shim — D-089(2) reverse edge); the WatcherKeeper +
// StillKeeper shims are interfaces defined in expected_keepers.go. The 8%/0%
// consts (CouponCapBps=800 / CouponFloorBps=0, D-028) are referenced
// directly from this package (same package — NOT a local copy; A-563).
//
// Lexicon (REQ-012, A-210): "Mutual Aid Bond", "MAB", "Cover Call",
// "coupon", "use-of-proceeds", "reserve build-out" are clean. The
// CouponDenomBread const VALUE "Bread" is the OY unit (clean — not a banned
// term). The banned coupon-synonyms are NEVER used.
import (
"fmt"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgIssueMAB --------------------------------------------------------------
// MsgIssueMAB issues a Mutual Aid Bond (REQ-054, D-080). The handler enforces:
// - ValidateBasic (stateless — includes ValidateMAB: rejects
// CouponDenomBread with FR-MAB-3).
// - Idempotency: bond-id must not already exist.
// - StandKeeper shim: the issuer-stand-id must reference an existing Stand
// (P1-02-01 edge). A nil shim skips (simtest wiring).
// - 3× annual surplus ceiling: checkMABIssuanceCeiling asserts
// sum(existingMABPrincipal for poolID) + PrincipalGrain <=
// MABIssuanceCeilingAnnualSurplusMultiple × AnnualSurplusAtIssuance.
// REJECT if above ceiling (re-checked at every issuance).
// - Coupon clamp via Clamp (A-563 — defense in depth).
// - UseOfProceedsTag locked to MABUseOfProceedsReserveBuildOut.
//
// pool-id is on the msg (NOT on the MAB struct — the MAB struct mirrors
// GrowthBond's anonymous-embed pattern; the pool binding is via the
// CoverKeeper reverse edge). The handler records the pool-id in the
// keeper's mab-pool index (BondID -> PoolID) for the ceiling check +
// the DebitMABProceeds destination validation.
type MsgIssueMAB struct {
BondID string `json:"bond_id" yaml:"bond_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
IssuerStandID string `json:"issuer_stand_id" yaml:"issuer_stand_id"`
PrincipalGrain int64 `json:"principal_grain" yaml:"principal_grain"`
CouponBps uint32 `json:"coupon_bps" yaml:"coupon_bps"`
CouponKind CouponDenom `json:"coupon_kind" yaml:"coupon_kind"`
AnnualSurplusAtIssuance int64 `json:"annual_surplus_at_issuance" yaml:"annual_surplus_at_issuance"`
TermDays uint32 `json:"term_days" yaml:"term_days"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message (sdk.Msg = proto.Message).
func (m *MsgIssueMAB) Reset() { *m = MsgIssueMAB{} }
// String implements proto.Message.
func (m *MsgIssueMAB) String() string {
return fmt.Sprintf("MsgIssueMAB{BondID:%s PoolID:%s IssuerStandID:%s PrincipalGrain:%d CouponBps:%d CouponKind:%s AnnualSurplusAtIssuance:%d TermDays:%d Signer:%s}",
m.BondID, m.PoolID, m.IssuerStandID, m.PrincipalGrain, m.CouponBps, m.CouponKind, m.AnnualSurplusAtIssuance, m.TermDays, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgIssueMAB) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields, PrincipalGrain
// > 0, AnnualSurplusAtIssuance > 0, coupon-bps within [CouponFloorBps,
// CouponCapBps] (the stateless clamp guard; the handler re-clamps at
// runtime per A-563), AND ValidateMAB (FR-MAB-3 — rejects CouponDenomBread).
// The 3× annual surplus ceiling is a keeper-handler check (stateful — it
// sums existing MAB principals for the poolID).
func (m *MsgIssueMAB) ValidateBasic() error {
if m.BondID == "" {
return fmt.Errorf("bond: empty bond-id")
}
if m.PoolID == "" {
return fmt.Errorf("bond: empty pool-id")
}
if m.IssuerStandID == "" {
return fmt.Errorf("bond: empty issuer-stand-id")
}
if m.PrincipalGrain <= 0 {
return fmt.Errorf("bond: principal-grain must be > 0")
}
if m.AnnualSurplusAtIssuance <= 0 {
return fmt.Errorf("bond: annual-surplus-at-issuance must be > 0")
}
if m.CouponBps < CouponFloorBps || m.CouponBps > CouponCapBps {
return fmt.Errorf("bond: coupon-bps %d out of band [%d, %d] (D-028 stateless guard)", m.CouponBps, CouponFloorBps, CouponCapBps)
}
if m.Signer == "" {
return fmt.Errorf("bond: empty signer")
}
// FR-MAB-3 dual firewall: ValidateMAB rejects CouponDenomBread at the
// stateless gate (the handler re-checks in defense in depth).
if err := ValidateMAB(MAB{CouponKind: m.CouponKind}); err != nil {
return err
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgIssueMAB) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgDebitMABProceeds ------------------------------------------------------
// MsgDebitMABProceeds debits a MAB's tagged proceeds to the Pool's
// ReserveAccount (D-080). The handler enforces:
// - ValidateBasic (stateless).
// - The MAB must exist.
// - D-080 tagged streaming: DestinationAccount ==
// CoverKeeper.GetPoolReserveAccount(mab's poolID). If mismatch ->
// StillKeeper.Still(bondID, "MAB misuse — proceeds routed outside
// reserve") (D-089(1) — a nil StillKeeper skips the Still recording)
// AND REJECT. If match -> emit bond.mab_proceeds_debited (simtest: the
// debit is the event; no actual Grain transfer in P4).
type MsgDebitMABProceeds struct {
BondID string `json:"bond_id" yaml:"bond_id"`
DestinationAccount string `json:"destination_account" yaml:"destination_account"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgDebitMABProceeds) Reset() { *m = MsgDebitMABProceeds{} }
// String implements proto.Message.
func (m *MsgDebitMABProceeds) String() string {
return fmt.Sprintf("MsgDebitMABProceeds{BondID:%s DestinationAccount:%s Signer:%s}",
m.BondID, m.DestinationAccount, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgDebitMABProceeds) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty bond-id, non-empty
// DestinationAccount, non-empty signer.
func (m *MsgDebitMABProceeds) ValidateBasic() error {
if m.BondID == "" {
return fmt.Errorf("bond: empty bond-id")
}
if m.DestinationAccount == "" {
return fmt.Errorf("bond: empty DestinationAccount")
}
if m.Signer == "" {
return fmt.Errorf("bond: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgDebitMABProceeds) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgWitnessMABProceedsRelease ---------------------------------------------
// MsgWitnessMABProceedsRelease is a Watcher-witnessed release of a MAB's
// tagged proceeds from staging to the reserve (D-080). The handler enforces:
// - ValidateBasic (stateless).
// - The MAB must exist.
// - Watcher quorum: WatcherKeeper.AttestMABRelease(bondID, attestationRef)
// returns true if quorum (6-of-9) is met. If false (quorum not met) ->
// REJECT. If true -> emit bond.mab_proceeds_released (the proceeds move
// from tagged staging to the reserve — simtest event).
type MsgWitnessMABProceedsRelease struct {
BondID string `json:"bond_id" yaml:"bond_id"`
AttestationRef string `json:"attestation_ref" yaml:"attestation_ref"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgWitnessMABProceedsRelease) Reset() { *m = MsgWitnessMABProceedsRelease{} }
// String implements proto.Message.
func (m *MsgWitnessMABProceedsRelease) String() string {
return fmt.Sprintf("MsgWitnessMABProceedsRelease{BondID:%s AttestationRef:%s Signer:%s}",
m.BondID, m.AttestationRef, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgWitnessMABProceedsRelease) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty bond-id, non-empty
// attestation-ref, non-empty signer.
func (m *MsgWitnessMABProceedsRelease) ValidateBasic() error {
if m.BondID == "" {
return fmt.Errorf("bond: empty bond-id")
}
if m.AttestationRef == "" {
return fmt.Errorf("bond: empty attestation-ref")
}
if m.Signer == "" {
return fmt.Errorf("bond: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgWitnessMABProceedsRelease) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgWatcherAttestMAB ------------------------------------------------------
// MsgWatcherAttestMAB records a quarterly Watcher audit attestation on a MAB
// (D-080). The handler enforces:
// - ValidateBasic (stateless).
// - The MAB must exist.
// - Record the attestation (a store entry mab_attest/<bondID>/<timestamp>
// -> attestationRef). Emit bond.mab_watcher_attested.
type MsgWatcherAttestMAB struct {
BondID string `json:"bond_id" yaml:"bond_id"`
AttestationRef string `json:"attestation_ref" yaml:"attestation_ref"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgWatcherAttestMAB) Reset() { *m = MsgWatcherAttestMAB{} }
// String implements proto.Message.
func (m *MsgWatcherAttestMAB) String() string {
return fmt.Sprintf("MsgWatcherAttestMAB{BondID:%s AttestationRef:%s Signer:%s}",
m.BondID, m.AttestationRef, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgWatcherAttestMAB) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty bond-id, non-empty
// attestation-ref, non-empty signer.
func (m *MsgWatcherAttestMAB) ValidateBasic() error {
if m.BondID == "" {
return fmt.Errorf("bond: empty bond-id")
}
if m.AttestationRef == "" {
return fmt.Errorf("bond: empty attestation-ref")
}
if m.Signer == "" {
return fmt.Errorf("bond: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgWatcherAttestMAB) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MAB Response types -------------------------------------------------------
// MsgIssueMABResponse is the response to MsgIssueMAB. ClampedCouponBps
// reports the runtime-clamped coupon (for simtest assertion that issuance
// clamped it). CeilingMultiple reports the post-issuance
// (sumMABPrincipal / AnnualSurplusAtIssuance) ratio (for simtest assertion
// the ceiling was respected).
type MsgIssueMABResponse struct {
ClampedCouponBps uint32 `json:"clamped_coupon_bps" yaml:"clamped_coupon_bps"`
CeilingMultiple int64 `json:"ceiling_multiple" yaml:"ceiling_multiple"`
}
// Reset implements proto.Message.
func (m *MsgIssueMABResponse) Reset() { *m = MsgIssueMABResponse{} }
// String implements proto.Message.
func (m *MsgIssueMABResponse) String() string {
return fmt.Sprintf("MsgIssueMABResponse{ClampedCouponBps:%d CeilingMultiple:%d}",
m.ClampedCouponBps, m.CeilingMultiple)
}
// ProtoMessage implements proto.Message.
func (*MsgIssueMABResponse) ProtoMessage() {}
// MsgDebitMABProceedsResponse is the response to MsgDebitMABProceeds.
type MsgDebitMABProceedsResponse struct{}
// Reset implements proto.Message.
func (m *MsgDebitMABProceedsResponse) Reset() { *m = MsgDebitMABProceedsResponse{} }
// String implements proto.Message.
func (m *MsgDebitMABProceedsResponse) String() string { return "MsgDebitMABProceedsResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgDebitMABProceedsResponse) ProtoMessage() {}
// MsgWitnessMABProceedsReleaseResponse is the response to
// MsgWitnessMABProceedsRelease.
type MsgWitnessMABProceedsReleaseResponse struct{}
// Reset implements proto.Message.
func (m *MsgWitnessMABProceedsReleaseResponse) Reset() { *m = MsgWitnessMABProceedsReleaseResponse{} }
// String implements proto.Message.
func (m *MsgWitnessMABProceedsReleaseResponse) String() string {
return "MsgWitnessMABProceedsReleaseResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgWitnessMABProceedsReleaseResponse) ProtoMessage() {}
// MsgWatcherAttestMABResponse is the response to MsgWatcherAttestMAB.
type MsgWatcherAttestMABResponse struct{}
// Reset implements proto.Message.
func (m *MsgWatcherAttestMABResponse) Reset() { *m = MsgWatcherAttestMABResponse{} }
// String implements proto.Message.
func (m *MsgWatcherAttestMABResponse) String() string { return "MsgWatcherAttestMABResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgWatcherAttestMABResponse) ProtoMessage() {}
+153
View File
@@ -29,6 +29,33 @@ const (
// §17, REQ-021). A regression firewall: adding/removing/renaming a bond
// status breaks this const's test.
BondStatusCount = 5
// MABIssuanceCeilingAnnualSurplusMultiple is the LOCKED ceiling on the
// total outstanding MAB principal for a pool, expressed as a multiple of
// the pool's AnnualSurplusAtIssuance (vision §17, REQ-054 locked — the
// 3× annual surplus mission-locked ceiling). The handler re-checks at
// every issuance (not just the first): sum(existingMABPrincipal) +
// newPrincipal <= 3 × AnnualSurplusAtIssuance. A regression here is a
// mission-lock breach.
MABIssuanceCeilingAnnualSurplusMultiple = 3
// MABUseOfProceedsReserveBuildOut is the D-080 tagged-streaming use-of-
// proceeds tag for a MAB: the proceeds are tagged for "reserve_build_out"
// (the Cover Pool's ReserveAccount build-out). The MsgDebitMABProceeds
// handler checks the destination == the Pool's ReserveAccount;
// the MsgWitnessMABProceedsRelease handler requires Watcher quorum before
// the tagged proceeds move from staging to the reserve. The tag is the
// D-080 lock — a MAB's proceeds are NEVER routable outside reserve
// build-out (mismatch -> auto-Still + REJECT).
MABUseOfProceedsReserveBuildOut = "reserve_build_out"
// CouponDenomCount is the count of CouponDenom enum values (vision §17,
// REQ-054). A regression firewall: adding/removing/renaming a CouponDenom
// breaks this const's test. The three values are CouponDenomCoverCall,
// CouponDenomMutualAidCredit, CouponDenomBread (the last exists ONLY to
// be rejected at ValidateMAB with "FR-MAB-3: MAB coupons NEVER Bread" —
// the dual-firewall runtime gate mirroring MissionLockAmendmentRejected).
CouponDenomCount = 3
)
// BondStatus enumerates the bond lifecycle states (vision §17, REQ-021).
@@ -124,6 +151,7 @@ type GenesisState struct {
Bonds []Bond `json:"bonds" yaml:"bonds"`
GrowthBonds []GrowthBond `json:"growth_bonds" yaml:"growth_bonds"`
Orders []SecondaryOrder `json:"orders" yaml:"orders"`
MABs []MAB `json:"mabs" yaml:"mabs"`
}
func DefaultGenesisState() *GenesisState {
@@ -132,6 +160,7 @@ func DefaultGenesisState() *GenesisState {
Bonds: []Bond{},
GrowthBonds: []GrowthBond{},
Orders: []SecondaryOrder{},
MABs: []MAB{},
}
}
@@ -154,6 +183,9 @@ func ValidateGenesis(bz json.RawMessage) error {
if err := ValidateOrders(gs.Orders); err != nil {
return fmt.Errorf("bond: %w", err)
}
if err := ValidateMABs(gs.MABs); err != nil {
return fmt.Errorf("bond: %w", err)
}
return nil
}
@@ -281,6 +313,127 @@ func IssueGrowth(bondID, issuerStandID string, principalGrain int64, couponBps,
}
}
// --- v0.7 extension: Mutual Aid Bond (MAB) (REQ-054, D-080, D-089(2)) -----------
//
// The v0.7 bond extension adds the Mutual Aid Bond (MAB): a mission-locked
// bond a Cover Pool issues to build out its reserve (vision §17, REQ-054).
// The MAB embeds the v0.2 Bond (anonymous field) so it carries all Bond
// fields PLUS a CouponKind (the coupon denomination: Cover-Call or Mutual-Aid
// Credit — Bread is the rejected sentinel), an AnnualSurplusAtIssuance (the
// pool's annual surplus at issuance, used for the 3× ceiling check), and a
// UseOfProceedsTag (D-080 — locked to "reserve_build_out"). The coupon rate
// is clamped to [CouponFloorBps, CouponCapBps] via Clamp (the 8%/0% consts
// D-028 apply to MABs too).
//
// The 3× annual surplus ceiling (MABIssuanceCeilingAnnualSurplusMultiple) is
// the mission-locked upper bound on the total outstanding MAB principal for
// a pool (vision §17, REQ-054 locked). The handler re-checks at every
// issuance: sum(existingMABPrincipal) + newPrincipal <= 3 ×
// AnnualSurplusAtIssuance. A regression here is a mission-lock breach.
//
// D-080 tagged streaming: the UseOfProceedsTag is locked to
// "reserve_build_out"; the MsgDebitMABProceeds handler checks the destination
// == the Pool's ReserveAccount (queried via the CoverKeeper shim — D-089(2)
// reverse edge); mismatch -> auto-Still via StillKeeper + REJECT. The
// MsgWitnessMABProceedsRelease handler requires Watcher quorum (6-of-9)
// before the tagged proceeds move from staging to the reserve.
//
// Lexicon (REQ-012, A-210): "Mutual Aid Bond", "MAB", "Cover Call", "coupon",
// "use-of-proceeds", "reserve build-out" are clean. The CouponDenomBread
// const VALUE is "Bread" (the OY unit, not a banned term — clean). The
// banned coupon-synonyms are NEVER used.
// CouponDenom enumerates the three coupon denominations a MAB may carry
// (vision §17, REQ-054). Two are valid (CoverCall, MutualAidCredit); the
// third — Bread — exists ONLY to be rejected at ValidateMAB with
// "FR-MAB-3: MAB coupons NEVER Bread" (the dual-firewall runtime gate
// mirroring MissionLockAmendmentRejected at x/council/types/types.go:242).
// The enum value EXISTS to document in code that MAB coupons are NEVER Bread;
// the ValidateMAB gate rejects it; the locked-const test asserts the count.
type CouponDenom string
const (
// CouponDenomCoverCall is the Cover-Call coupon denomination (a MAB
// whose coupon is settled in Cover-Call units — the primary MAB kind).
CouponDenomCoverCall CouponDenom = "CoverCall"
// CouponDenomMutualAidCredit is the Mutual-Aid-Credit coupon
// denomination (a MAB whose coupon is settled in mutual-aid credit
// units — the secondary MAB kind).
CouponDenomMutualAidCredit CouponDenom = "MutualAidCredit"
// CouponDenomBread is the REJECTED sentinel coupon denomination
// (FR-MAB-3 — MAB coupons NEVER Bread). The enum value EXISTS to
// document in code that MAB coupons are NEVER Bread; the ValidateMAB
// gate rejects any MAB with this CouponKind. The const VALUE "Bread"
// is the OY unit (clean — not a banned term). Mirrors
// ProposalMissionLockAmendmentRejected at x/council/types/types.go:242.
CouponDenomBread CouponDenom = "Bread"
)
// AllCouponDenoms returns all three CouponDenom values in REQ-054 order. The
// locked-const test asserts exactly 3 entries (the regression firewall).
func AllCouponDenoms() []CouponDenom {
return []CouponDenom{
CouponDenomCoverCall,
CouponDenomMutualAidCredit,
CouponDenomBread,
}
}
// MAB is a Mutual Aid Bond: a mission-locked bond a Cover Pool issues to
// build out its reserve (vision §17, REQ-054, D-080, D-089(2)). It embeds
// the v0.2 Bond (anonymous field) so it carries all Bond fields (bond-id,
// issuer-stand-id, principal-grain, coupon-bps, term-days, issued-at,
// maturity, status) PLUS a CouponKind (the coupon denomination), an
// AnnualSurplusAtIssuance (the pool's annual surplus at issuance, used for
// the 3× ceiling check), and a UseOfProceedsTag (D-080 — locked to
// "reserve_build_out"). The coupon rate is clamped to [CouponFloorBps,
// CouponCapBps] via Clamp at issuance (the 8%/0% consts D-028 apply).
//
// pool-id is NOT a field on MAB (the MAB is issued by a Stand for a pool;
// the pool binding is via the CoverKeeper.GetPoolReserveAccount reverse
// edge — D-089(2)). The MsgDebitMABProceeds handler queries the CoverKeeper
// for the pool's ReserveAccount by the MAB's PoolID (carried on the msg,
// not the MAB struct — the MAB struct mirrors GrowthBond's anonymous-embed
// pattern + the MAB-specific fields only).
type MAB struct {
Bond // anonymous embed — carries all v0.2 Bond fields
CouponKind CouponDenom `json:"coupon_kind" yaml:"coupon_kind"`
AnnualSurplusAtIssuance int64 `json:"annual_surplus_at_issuance" yaml:"annual_surplus_at_issuance"`
UseOfProceedsTag string `json:"use_of_proceeds_tag" yaml:"use_of_proceeds_tag"`
}
// IssueMAB is the MAB issuance stub (REQ-054, D-080). It constructs a MAB
// with the coupon clamped to [CouponFloorBps, CouponCapBps] via Clamp, the
// CouponKind set, and the UseOfProceedsTag locked to
// MABUseOfProceedsReserveBuildOut. The returned MAB has status BondIssued
// (inherited from Issue's Bond construction). The stub does not persist or
// enforce the 3× annual surplus ceiling (that is a keeper-handler concern);
// it only enforces the coupon clamp invariant at construction time.
func IssueMAB(bondID, issuerStandID string, principalGrain int64, couponBps uint32, couponKind CouponDenom, annualSurplusAtIssuance int64, termDays uint32, issuedAt, maturity int64) MAB {
clampedCoupon := Clamp(couponBps)
return MAB{
Bond: Issue(bondID, issuerStandID, principalGrain, clampedCoupon, termDays, issuedAt, maturity),
CouponKind: couponKind,
AnnualSurplusAtIssuance: annualSurplusAtIssuance,
UseOfProceedsTag: MABUseOfProceedsReserveBuildOut,
}
}
// ValidateMAB is the MAB runtime firewall (REQ-054, FR-MAB-3). It rejects a
// MAB whose CouponKind == CouponDenomBread with "FR-MAB-3: MAB coupons
// NEVER Bread" — the dual-firewall runtime gate mirroring
// MissionLockAmendmentRejected at x/council/types/types.go:242. The
// CouponDenomBread const EXISTS to document in code that MAB coupons are
// NEVER Bread; this gate rejects any MAB with that CouponKind. The
// ValidateBasic on MsgIssueMAB calls this; the keeper handler re-checks in
// defense in depth.
func ValidateMAB(m MAB) error {
if m.CouponKind == CouponDenomBread {
return fmt.Errorf("FR-MAB-3: MAB coupons NEVER Bread (CouponDenomBread is the rejected sentinel — REQ-054 dual firewall)")
}
return nil
}
// SecondaryOrder is a secondary-market order on an issued bond (vision §17,
// REQ-026, D-041, A-313). order-id is the unique identifier. bond-id references
// a Bond (by-ID-string ref to a Bond — same package, so this is an in-package
+172
View File
@@ -962,3 +962,175 @@ func packageDir(t *testing.T, importPath string) string {
rel := strings.TrimPrefix(importPath, "github.com/oy/openyield/")
return filepath.Join(repoRoot, rel)
}
// --- v0.7 P4: MAB locked consts + ValidateMAB + IssueMAB (REQ-054) -----------
//
// The MAB locked-const + ValidateMAB + IssueMAB regression tests (REQ-054,
// FR-MAB-3, D-080). A regression here is a mission-lock breach.
// TestMABIssuanceCeilingAnnualSurplusMultiple asserts the 3× annual surplus
// ceiling multiple is the locked 3 (REQ-054 locked — vision §17 3× annual
// surplus mission-locked ceiling).
func TestMABIssuanceCeilingAnnualSurplusMultiple(t *testing.T) {
if btypes.MABIssuanceCeilingAnnualSurplusMultiple != 3 {
t.Errorf("MABIssuanceCeilingAnnualSurplusMultiple = %d, want 3 (REQ-054 locked — 3× annual surplus ceiling)", btypes.MABIssuanceCeilingAnnualSurplusMultiple)
}
}
// TestMABUseOfProceedsReserveBuildOut asserts the D-080 tagged-streaming
// use-of-proceeds tag is "reserve_build_out".
func TestMABUseOfProceedsReserveBuildOut(t *testing.T) {
if btypes.MABUseOfProceedsReserveBuildOut != "reserve_build_out" {
t.Errorf("MABUseOfProceedsReserveBuildOut = %q, want %q (D-080 tagged-streaming use-of-proceeds)", btypes.MABUseOfProceedsReserveBuildOut, "reserve_build_out")
}
}
// TestCouponDenomCount asserts CouponDenomCount == 3 (the regression
// firewall — the three CouponDenom values are CoverCall, MutualAidCredit,
// Bread).
func TestCouponDenomCount(t *testing.T) {
if btypes.CouponDenomCount != 3 {
t.Errorf("CouponDenomCount = %d, want 3 (REQ-054 — CoverCall + MutualAidCredit + Bread)", btypes.CouponDenomCount)
}
if len(btypes.AllCouponDenoms()) != 3 {
t.Errorf("AllCouponDenoms len = %d, want 3", len(btypes.AllCouponDenoms()))
}
}
// TestCouponDenomValues asserts the three CouponDenom string values.
func TestCouponDenomValues(t *testing.T) {
cases := []struct {
d btypes.CouponDenom
want string
}{
{btypes.CouponDenomCoverCall, "CoverCall"},
{btypes.CouponDenomMutualAidCredit, "MutualAidCredit"},
{btypes.CouponDenomBread, "Bread"},
}
for _, c := range cases {
if string(c.d) != c.want {
t.Errorf("CouponDenom(%q) value = %q, want %q", c.d, c.d, c.want)
}
}
}
// TestValidateMABRejectsBread asserts ValidateMAB rejects CouponDenomBread
// with "FR-MAB-3" (the dual-firewall runtime gate mirroring
// MissionLockAmendmentRejected).
func TestValidateMABRejectsBread(t *testing.T) {
m := btypes.MAB{CouponKind: btypes.CouponDenomBread}
err := btypes.ValidateMAB(m)
if err == nil {
t.Fatal("ValidateMAB on CouponDenomBread should be REJECTED (FR-MAB-3)")
}
if !strings.Contains(err.Error(), "FR-MAB-3") {
t.Errorf("err = %q, want 'FR-MAB-3'", err.Error())
}
if !strings.Contains(err.Error(), "NEVER Bread") {
t.Errorf("err = %q, want 'NEVER Bread'", err.Error())
}
// A valid CouponKind passes.
if err := btypes.ValidateMAB(btypes.MAB{CouponKind: btypes.CouponDenomCoverCall}); err != nil {
t.Errorf("ValidateMAB on CouponDenomCoverCall should pass; got: %v", err)
}
if err := btypes.ValidateMAB(btypes.MAB{CouponKind: btypes.CouponDenomMutualAidCredit}); err != nil {
t.Errorf("ValidateMAB on CouponDenomMutualAidCredit should pass; got: %v", err)
}
}
// TestIssueMABClampsCoupon asserts IssueMAB clamps the coupon to
// [CouponFloorBps, CouponCapBps] (the cross-const test extending REQ-030 —
// the MAB coupon cap == CouponCapBps).
func TestIssueMABClampsCoupon(t *testing.T) {
// In-band coupon: unchanged.
m := btypes.IssueMAB("mab-1", "stand-1", 1_000_000, 500, btypes.CouponDenomCoverCall, 5_000_000, 365, 1000, 1365)
if m.CouponBps != 500 {
t.Errorf("in-band CouponBps = %d, want 500 (unchanged)", m.CouponBps)
}
if m.CouponKind != btypes.CouponDenomCoverCall {
t.Errorf("CouponKind = %q, want CoverCall", m.CouponKind)
}
if m.UseOfProceedsTag != btypes.MABUseOfProceedsReserveBuildOut {
t.Errorf("UseOfProceedsTag = %q, want %q (D-080 lock)", m.UseOfProceedsTag, btypes.MABUseOfProceedsReserveBuildOut)
}
if m.Status != btypes.BondIssued {
t.Errorf("Status = %q, want BondIssued", m.Status)
}
// Above-cap coupon: clamped to cap.
m2 := btypes.IssueMAB("mab-2", "stand-1", 1_000_000, 1200, btypes.CouponDenomMutualAidCredit, 5_000_000, 365, 1000, 1365)
if m2.CouponBps != btypes.CouponCapBps {
t.Errorf("above-cap CouponBps = %d, want cap %d (IssueMAB must clamp)", m2.CouponBps, btypes.CouponCapBps)
}
}
// TestValidateMABsRejectsBreadAtGenesis asserts ValidateMABs rejects a
// genesis MAB with CouponDenomBread (FR-MAB-3 at genesis load).
func TestValidateMABsRejectsBreadAtGenesis(t *testing.T) {
mabs := []btypes.MAB{
{Bond: btypes.Bond{BondID: "mab-1", Status: btypes.BondIssued, CouponBps: 500}, CouponKind: btypes.CouponDenomCoverCall, UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut},
{Bond: btypes.Bond{BondID: "mab-bad", Status: btypes.BondIssued, CouponBps: 500}, CouponKind: btypes.CouponDenomBread, UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut},
}
err := btypes.ValidateMABs(mabs)
if err == nil {
t.Fatal("ValidateMABs with CouponDenomBread should be REJECTED at genesis (FR-MAB-3)")
}
if !strings.Contains(err.Error(), "FR-MAB-3") {
t.Errorf("err = %q, want 'FR-MAB-3'", err.Error())
}
}
// TestValidateMABsRejectsDupIDs asserts ValidateMABs rejects duplicate
// bond-ids (A-212 ID-uniqueness at genesis load).
func TestValidateMABsRejectsDupIDs(t *testing.T) {
mabs := []btypes.MAB{
{Bond: btypes.Bond{BondID: "dup", Status: btypes.BondIssued, CouponBps: 500}, CouponKind: btypes.CouponDenomCoverCall, UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut},
{Bond: btypes.Bond{BondID: "dup", Status: btypes.BondIssued, CouponBps: 500}, CouponKind: btypes.CouponDenomMutualAidCredit, UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut},
}
if err := btypes.ValidateMABs(mabs); err == nil {
t.Fatal("ValidateMABs with duplicate bond-ids should be REJECTED")
}
}
// TestValidateMABsAcceptsClean asserts ValidateMABs accepts a clean set.
func TestValidateMABsAcceptsClean(t *testing.T) {
mabs := []btypes.MAB{
{Bond: btypes.Bond{BondID: "m1", Status: btypes.BondIssued, CouponBps: 500}, CouponKind: btypes.CouponDenomCoverCall, UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut},
{Bond: btypes.Bond{BondID: "m2", Status: btypes.BondActive, CouponBps: 600}, CouponKind: btypes.CouponDenomMutualAidCredit, UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut},
}
if err := btypes.ValidateMABs(mabs); err != nil {
t.Errorf("ValidateMABs should accept clean set; got: %v", err)
}
}
// TestMABStructFields asserts the MAB struct carries the anonymous Bond
// embed + the MAB-specific fields (CouponKind + AnnualSurplusAtIssuance +
// UseOfProceedsTag).
func TestMABStructFields(t *testing.T) {
m := btypes.MAB{
Bond: btypes.Bond{BondID: "mab-x", IssuerStandID: "stand-1", PrincipalGrain: 1_000_000, CouponBps: 500, Status: btypes.BondIssued},
CouponKind: btypes.CouponDenomCoverCall,
AnnualSurplusAtIssuance: 5_000_000,
UseOfProceedsTag: btypes.MABUseOfProceedsReserveBuildOut,
}
if m.BondID != "mab-x" {
t.Errorf("MAB.BondID = %q (anonymous embed access)", m.BondID)
}
if m.CouponKind != btypes.CouponDenomCoverCall {
t.Errorf("MAB.CouponKind = %q", m.CouponKind)
}
if m.AnnualSurplusAtIssuance != 5_000_000 {
t.Errorf("MAB.AnnualSurplusAtIssuance = %d", m.AnnualSurplusAtIssuance)
}
if m.UseOfProceedsTag != btypes.MABUseOfProceedsReserveBuildOut {
t.Errorf("MAB.UseOfProceedsTag = %q", m.UseOfProceedsTag)
}
}
// TestGenesisStateMABsField asserts DefaultGenesisState returns a non-nil
// empty slice for MABs (the v0.7 P4 genesis extension).
func TestGenesisStateMABsField(t *testing.T) {
gs := btypes.DefaultGenesisState()
if gs.MABs == nil || len(gs.MABs) != 0 {
t.Errorf("Default MABs should be non-nil empty slice; got len=%d nil=%v", len(gs.MABs), gs.MABs == nil)
}
}
+539 -1
View File
@@ -43,6 +43,14 @@ type Keeper struct {
watcherKeeper types.WatcherKeeper
bondKeeper types.BondKeeper
stillKeeper types.StillKeeper
guildKeeper types.GuildKeeper
// paramsOverride is a simtest-grade Params override (nil = use
// DefaultParams). A future P2+ will load the Params from the params
// store; for now the handler uses DefaultParams unless an override is
// set via SetParamsOverride (the D-086 simtest case (f) uses this to
// restrict FactoryAllowedPhases to [Phase2, Phase3] only and reject a
// Phase4 launch).
paramsOverride *types.Params
}
// NewKeeper constructs a new store-backed cover Keeper. The four expected-
@@ -51,7 +59,8 @@ type Keeper struct {
// the simtest wiring documents this). The StandingKeeper gates the launch
// (D-077); the WatcherKeeper attests the launch (REQ-046); the BondKeeper
// is held for P4 (the P1 handlers do not call it); the StillKeeper records
// the below-floor auto-pause (D-089(1)).
// the below-floor auto-pause (D-089(1)). The P5 GuildKeeper verifies a
// Guild exists on Pier selection (REQ-066; a nil shim skips the check).
func NewKeeper(cdc codec.Codec, storeKey storetypes.StoreKey, sk types.StandingKeeper, wk types.WatcherKeeper, bk types.BondKeeper, stK types.StillKeeper) Keeper {
return Keeper{
cdc: cdc,
@@ -76,6 +85,27 @@ func (k *Keeper) SetBondKeeper(bk types.BondKeeper) { k.bondKeeper = bk }
// SetStillKeeper sets the StillKeeper expected-keeper shim.
func (k *Keeper) SetStillKeeper(stK types.StillKeeper) { k.stillKeeper = stK }
// SetGuildKeeper sets the GuildKeeper expected-keeper shim (P5 — REQ-066
// Pier Selection uses this to verify the selecting Guild exists; a nil
// shim skips the existence check, simtest wiring).
func (k *Keeper) SetGuildKeeper(gk types.GuildKeeper) { k.guildKeeper = gk }
// SetParamsOverride sets a simtest-grade Params override (nil = use
// DefaultParams). The D-086 simtest case (f) uses this to restrict
// FactoryAllowedPhases to [Phase2, Phase3] only and reject a Phase4
// launch. A future P2+ will replace this with a params-store load.
func (k *Keeper) SetParamsOverride(p types.Params) { k.paramsOverride = &p }
// Params returns the effective Params (the override if set, else
// DefaultParams). The handler calls this to get FactoryAllowedPhases +
// PoolStandingGate.
func (k Keeper) Params() types.Params {
if k.paramsOverride != nil {
return *k.paramsOverride
}
return types.DefaultParams()
}
// StoreKey returns the keeper's store key (exported for simtest access to
// the underlying KVStore, e.g. to inject corrupt bytes for marshal-error
// coverage). Mirrors the x/hub simtest pattern (the simtest reaches the
@@ -180,6 +210,84 @@ func (k Keeper) AllCoverCalls(ctx sdk.Context) []types.CoverCall {
return out
}
// --- P4: CoverClaimsVoucher store (REQ-055, D-090(2)) ------------------------
//
// The Voucher store is keyed by voucher-reach-id + pool-id (composite key)
// -> CoverClaimsVoucher. A Voucher is registered per-Pool; the composite key
// enforces idempotency (no duplicate Voucher for the same Pool). The
// GetAvgCallSize helper computes the average Cover Call amount for a Pool
// from the call/ store (returns 0 if no Calls — the D-090(2) cold-start
// case).
var voucherKeyPrefix = []byte("voucher/")
func voucherKey(voucherReachID, poolID string) []byte {
return append(append(voucherKeyPrefix, []byte(voucherReachID)...), []byte("/"+poolID)...)
}
// GetCoverClaimsVoucher loads a CoverClaimsVoucher by voucher-reach-id +
// pool-id. Returns the Voucher and true if found, or zero value + false if
// not.
func (k Keeper) GetCoverClaimsVoucher(ctx sdk.Context, voucherReachID, poolID string) (types.CoverClaimsVoucher, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(voucherKey(voucherReachID, poolID))
if bz == nil {
return types.CoverClaimsVoucher{}, false
}
var v types.CoverClaimsVoucher
if err := json.Unmarshal(bz, &v); err != nil {
return types.CoverClaimsVoucher{}, false
}
return v, true
}
// SetCoverClaimsVoucher persists a CoverClaimsVoucher by voucher-reach-id +
// pool-id.
func (k Keeper) SetCoverClaimsVoucher(ctx sdk.Context, v types.CoverClaimsVoucher) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(v)
if err != nil {
panic(fmt.Sprintf("cover: marshal voucher %q/%q: %v", v.VoucherReachID, v.PoolID, err))
}
store.Set(voucherKey(v.VoucherReachID, v.PoolID), bz)
}
// AllCoverClaimsVouchers returns all persisted CoverClaimsVoucher records
// (iteration helper, unordered).
func (k Keeper) AllCoverClaimsVouchers(ctx sdk.Context) []types.CoverClaimsVoucher {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(voucherKeyPrefix, prefixEnd(voucherKeyPrefix))
defer iterator.Close()
out := []types.CoverClaimsVoucher{}
for ; iterator.Valid(); iterator.Next() {
var v types.CoverClaimsVoucher
if err := json.Unmarshal(iterator.Value(), &v); err == nil {
out = append(out, v)
}
}
return out
}
// GetAvgCallSize computes the average Cover Call amount (Grain) for a Pool
// from the call/ store (REQ-055, D-090(2)). Returns 0 if no Calls have been
// filed for the Pool — the D-090(2) cold-start case (the Voucher bond falls
// back to MinimumVoucherBond, NOT zero).
func (k Keeper) GetAvgCallSize(ctx sdk.Context, poolID string) int64 {
calls := k.AllCoverCalls(ctx)
sum := int64(0)
n := 0
for _, c := range calls {
if c.PoolID == poolID {
sum += c.AmountGrain
n++
}
}
if n == 0 {
return 0
}
return sum / int64(n)
}
// --- prefixEnd helper ---------------------------------------------------------
// prefixEnd returns the key that sorts immediately after all keys sharing
@@ -201,3 +309,433 @@ func prefixEnd(prefix []byte) []byte {
// All bytes were 0xFF; return nil (iterate to end of store).
return nil
}
// --- P2: CoverCharter / PoolCouncil / CoverCallVote / CharterAmendment stores --
//
// (REQ-052, REQ-062). Four new stores keyed by ID-string. The
// CoverCharter store is keyed by CharterID; the PoolCouncil store is keyed
// by PoolID (one council per pool); the CoverCallVote store is keyed by
// VoteID; the CharterAmendment store is keyed by AmendmentID. All four
// use the same JSON-marshal pattern as the P1 CoverPool / CoverCall
// stores. The Get/Set/All helpers mirror the P1 helpers.
var charterKeyPrefix = []byte("charter/")
func charterKey(charterID string) []byte {
return append(charterKeyPrefix, []byte(charterID)...)
}
// GetCoverCharter loads a CoverCharter by charter-id. Returns the charter
// and true if found, or zero value + false if not.
func (k Keeper) GetCoverCharter(ctx sdk.Context, charterID string) (types.CoverCharter, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(charterKey(charterID))
if bz == nil {
return types.CoverCharter{}, false
}
var c types.CoverCharter
if err := json.Unmarshal(bz, &c); err != nil {
return types.CoverCharter{}, false
}
return c, true
}
// SetCoverCharter persists a CoverCharter by charter-id.
func (k Keeper) SetCoverCharter(ctx sdk.Context, c types.CoverCharter) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(c)
if err != nil {
panic(fmt.Sprintf("cover: marshal charter %q: %v", c.CharterID, err))
}
store.Set(charterKey(c.CharterID), bz)
}
// AllCoverCharters returns all persisted CoverCharter records (iteration
// helper, unordered).
func (k Keeper) AllCoverCharters(ctx sdk.Context) []types.CoverCharter {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(charterKeyPrefix, prefixEnd(charterKeyPrefix))
defer iterator.Close()
out := []types.CoverCharter{}
for ; iterator.Valid(); iterator.Next() {
var c types.CoverCharter
if err := json.Unmarshal(iterator.Value(), &c); err == nil {
out = append(out, c)
}
}
return out
}
var councilKeyPrefix = []byte("council/")
func councilKey(poolID string) []byte {
return append(councilKeyPrefix, []byte(poolID)...)
}
// GetPoolCouncil loads a PoolCouncil by pool-id. Returns the council and
// true if found, or zero value + false if not.
func (k Keeper) GetPoolCouncil(ctx sdk.Context, poolID string) (types.PoolCouncil, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(councilKey(poolID))
if bz == nil {
return types.PoolCouncil{}, false
}
var c types.PoolCouncil
if err := json.Unmarshal(bz, &c); err != nil {
return types.PoolCouncil{}, false
}
return c, true
}
// SetPoolCouncil persists a PoolCouncil by pool-id.
func (k Keeper) SetPoolCouncil(ctx sdk.Context, c types.PoolCouncil) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(c)
if err != nil {
panic(fmt.Sprintf("cover: marshal council for pool %q: %v", c.PoolID, err))
}
store.Set(councilKey(c.PoolID), bz)
}
// AllPoolCouncils returns all persisted PoolCouncil records (iteration
// helper, unordered).
func (k Keeper) AllPoolCouncils(ctx sdk.Context) []types.PoolCouncil {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(councilKeyPrefix, prefixEnd(councilKeyPrefix))
defer iterator.Close()
out := []types.PoolCouncil{}
for ; iterator.Valid(); iterator.Next() {
var c types.PoolCouncil
if err := json.Unmarshal(iterator.Value(), &c); err == nil {
out = append(out, c)
}
}
return out
}
var voteKeyPrefix = []byte("vote/")
func voteKey(voteID string) []byte {
return append(voteKeyPrefix, []byte(voteID)...)
}
// GetCoverCallVote loads a CoverCallVote by vote-id. Returns the vote and
// true if found, or zero value + false if not.
func (k Keeper) GetCoverCallVote(ctx sdk.Context, voteID string) (types.CoverCallVote, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(voteKey(voteID))
if bz == nil {
return types.CoverCallVote{}, false
}
var v types.CoverCallVote
if err := json.Unmarshal(bz, &v); err != nil {
return types.CoverCallVote{}, false
}
return v, true
}
// SetCoverCallVote persists a CoverCallVote by vote-id.
func (k Keeper) SetCoverCallVote(ctx sdk.Context, v types.CoverCallVote) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(v)
if err != nil {
panic(fmt.Sprintf("cover: marshal vote %q: %v", v.VoteID, err))
}
store.Set(voteKey(v.VoteID), bz)
}
// AllCoverCallVotes returns all persisted CoverCallVote records (iteration
// helper, unordered).
func (k Keeper) AllCoverCallVotes(ctx sdk.Context) []types.CoverCallVote {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(voteKeyPrefix, prefixEnd(voteKeyPrefix))
defer iterator.Close()
out := []types.CoverCallVote{}
for ; iterator.Valid(); iterator.Next() {
var v types.CoverCallVote
if err := json.Unmarshal(iterator.Value(), &v); err == nil {
out = append(out, v)
}
}
return out
}
var amendmentKeyPrefix = []byte("amendment/")
func amendmentKey(amendmentID string) []byte {
return append(amendmentKeyPrefix, []byte(amendmentID)...)
}
// GetCharterAmendment loads a CharterAmendment by amendment-id. Returns
// the amendment and true if found, or zero value + false if not.
func (k Keeper) GetCharterAmendment(ctx sdk.Context, amendmentID string) (types.CharterAmendment, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(amendmentKey(amendmentID))
if bz == nil {
return types.CharterAmendment{}, false
}
var a types.CharterAmendment
if err := json.Unmarshal(bz, &a); err != nil {
return types.CharterAmendment{}, false
}
return a, true
}
// SetCharterAmendment persists a CharterAmendment by amendment-id.
func (k Keeper) SetCharterAmendment(ctx sdk.Context, a types.CharterAmendment) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(a)
if err != nil {
panic(fmt.Sprintf("cover: marshal amendment %q: %v", a.AmendmentID, err))
}
store.Set(amendmentKey(a.AmendmentID), bz)
}
// AllCharterAmendments returns all persisted CharterAmendment records
// (iteration helper, unordered).
func (k Keeper) AllCharterAmendments(ctx sdk.Context) []types.CharterAmendment {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(amendmentKeyPrefix, prefixEnd(amendmentKeyPrefix))
defer iterator.Close()
out := []types.CharterAmendment{}
for ; iterator.Valid(); iterator.Next() {
var a types.CharterAmendment
if err := json.Unmarshal(iterator.Value(), &a); err == nil {
out = append(out, a)
}
}
return out
}
// CoolCharterAmendment transitions a Proposed CharterAmendment to Cooled
// if the 7-day cooling has elapsed (REQ-052). Returns an error if the
// amendment is not found, not in the Proposed status, or the cooling has
// not elapsed. The handler (or simtest) calls this after the cooling
// period; a separate RatifyCharterAmendment transitions to Ratified.
func (k Keeper) CoolCharterAmendment(ctx sdk.Context, amendmentID string, now int64) (types.CharterAmendment, error) {
a, ok := k.GetCharterAmendment(ctx, amendmentID)
if !ok {
return types.CharterAmendment{}, fmt.Errorf("cover: amendment %q not found", amendmentID)
}
if a.Status != types.AmendmentProposed {
return types.CharterAmendment{}, fmt.Errorf("cover: amendment %q status %q (only Proposed can be Cooled)", amendmentID, a.Status)
}
if now-a.ProposedAt < types.CharterAmendmentCoolingSeconds {
return types.CharterAmendment{}, fmt.Errorf("cover: amendment %q cooling not elapsed (now=%d ProposedAt=%d, need %d seconds)", amendmentID, now, a.ProposedAt, types.CharterAmendmentCoolingSeconds)
}
a.Status = types.AmendmentCooled
a.CooledAt = now
k.SetCharterAmendment(ctx, a)
return a, nil
}
// RatifyCharterAmendment transitions a Cooled CharterAmendment to
// Ratified (REQ-052). Returns an error if the amendment is not found or
// not in the Cooled status. The Pool supermajority + Watcher + Counsel
// are checked upstream (the handler); this helper does the state
// transition + appends the amendment to the parent charter's Amendments
// slice.
func (k Keeper) RatifyCharterAmendment(ctx sdk.Context, amendmentID string, now int64) (types.CharterAmendment, error) {
a, ok := k.GetCharterAmendment(ctx, amendmentID)
if !ok {
return types.CharterAmendment{}, fmt.Errorf("cover: amendment %q not found", amendmentID)
}
if a.Status != types.AmendmentCooled {
return types.CharterAmendment{}, fmt.Errorf("cover: amendment %q status %q (only Cooled can be Ratified)", amendmentID, a.Status)
}
a.Status = types.AmendmentRatified
a.RatifiedAt = now
k.SetCharterAmendment(ctx, a)
return a, nil
}
// --- P5: Bill of Rights review + Pier Selection stores (REQ-056, REQ-066) ------
//
// (REQ-056, REQ-066). Two new stores. The bill_review/ store is keyed by
// ReviewID -> the MsgCounselReviewBillOfRights record (the handler persists
// the review on a bonded-Counsel ceremony). The pier_selection/ store is
// keyed by GuildID -> PierSelectionRecord (the MsgSelectPier handler
// persists + MsgRevokePierSelection removes). The pier_index/ store is
// keyed by PierID -> PierSelectionIndex (the mesh-maintained index; the
// MsgSelectPier handler creates or updates the entry, accumulating scores
// from successive selections). All three use the same JSON-marshal pattern
// as the P1/P2 stores.
var billReviewKeyPrefix = []byte("bill_review/")
func billReviewKey(reviewID string) []byte {
return append(billReviewKeyPrefix, []byte(reviewID)...)
}
// BillOfRightsReview is the persisted record of a Counsel review of the
// Anti-Capture Bill of Rights (REQ-056 §7 acceptance ceremony). The
// MsgCounselReviewBillOfRights handler persists this in the bill_review/
// store keyed by ReviewID.
type BillOfRightsReview struct {
ReviewID string `json:"review_id" yaml:"review_id"`
CounselReachID string `json:"counsel_reach_id" yaml:"counsel_reach_id"`
Staked bool `json:"staked" yaml:"staked"`
ReviewResult string `json:"review_result" yaml:"review_result"`
ReviewedAt int64 `json:"reviewed_at" yaml:"reviewed_at"`
}
// GetBillOfRightsReview loads a BillOfRightsReview by review-id. Returns
// the review and true if found, or zero value + false if not.
func (k Keeper) GetBillOfRightsReview(ctx sdk.Context, reviewID string) (BillOfRightsReview, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(billReviewKey(reviewID))
if bz == nil {
return BillOfRightsReview{}, false
}
var r BillOfRightsReview
if err := json.Unmarshal(bz, &r); err != nil {
return BillOfRightsReview{}, false
}
return r, true
}
// SetBillOfRightsReview persists a BillOfRightsReview by review-id.
func (k Keeper) SetBillOfRightsReview(ctx sdk.Context, r BillOfRightsReview) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(r)
if err != nil {
panic(fmt.Sprintf("cover: marshal bill-of-rights review %q: %v", r.ReviewID, err))
}
store.Set(billReviewKey(r.ReviewID), bz)
}
// AllBillOfRightsReviews returns all persisted BillOfRightsReview records
// (iteration helper, unordered).
func (k Keeper) AllBillOfRightsReviews(ctx sdk.Context) []BillOfRightsReview {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(billReviewKeyPrefix, prefixEnd(billReviewKeyPrefix))
defer iterator.Close()
out := []BillOfRightsReview{}
for ; iterator.Valid(); iterator.Next() {
var r BillOfRightsReview
if err := json.Unmarshal(iterator.Value(), &r); err == nil {
out = append(out, r)
}
}
return out
}
var pierSelectionKeyPrefix = []byte("pier_selection/")
func pierSelectionKey(guildID string) []byte {
return append(pierSelectionKeyPrefix, []byte(guildID)...)
}
// GetPierSelectionRecord loads a PierSelectionRecord by guild-id. Returns
// the record and true if found, or zero value + false if not.
func (k Keeper) GetPierSelectionRecord(ctx sdk.Context, guildID string) (types.PierSelectionRecord, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(pierSelectionKey(guildID))
if bz == nil {
return types.PierSelectionRecord{}, false
}
var r types.PierSelectionRecord
if err := json.Unmarshal(bz, &r); err != nil {
return types.PierSelectionRecord{}, false
}
return r, true
}
// SetPierSelectionRecord persists a PierSelectionRecord by guild-id.
func (k Keeper) SetPierSelectionRecord(ctx sdk.Context, r types.PierSelectionRecord) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(r)
if err != nil {
panic(fmt.Sprintf("cover: marshal pier selection for guild %q: %v", r.GuildID, err))
}
store.Set(pierSelectionKey(r.GuildID), bz)
}
// RemovePierSelectionRecord removes a PierSelectionRecord by guild-id (the
// MsgRevokePierSelection handler calls this). Returns true if a record was
// removed, false if no record existed.
func (k Keeper) RemovePierSelectionRecord(ctx sdk.Context, guildID string) bool {
store := ctx.KVStore(k.storeKey)
key := pierSelectionKey(guildID)
if store.Get(key) == nil {
return false
}
store.Delete(key)
return true
}
var pierIndexKeyPrefix = []byte("pier_index/")
func pierIndexKey(pierID string) []byte {
return append(pierIndexKeyPrefix, []byte(pierID)...)
}
// GetPierSelectionIndex loads a PierSelectionIndex by pier-id (REQ-066 —
// the mesh-maintained index query). Returns the index and true if found,
// or zero value + false if not.
func (k Keeper) GetPierSelectionIndex(ctx sdk.Context, pierID string) (types.PierSelectionIndex, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(pierIndexKey(pierID))
if bz == nil {
return types.PierSelectionIndex{}, false
}
var idx types.PierSelectionIndex
if err := json.Unmarshal(bz, &idx); err != nil {
return types.PierSelectionIndex{}, false
}
return idx, true
}
// SetPierSelectionIndex persists a PierSelectionIndex by pier-id.
func (k Keeper) SetPierSelectionIndex(ctx sdk.Context, idx types.PierSelectionIndex) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(idx)
if err != nil {
panic(fmt.Sprintf("cover: marshal pier selection index for pier %q: %v", idx.PierID, err))
}
store.Set(pierIndexKey(idx.PierID), bz)
}
// AllPierSelectionIndexes returns all persisted PierSelectionIndex records
// (iteration helper, unordered).
func (k Keeper) AllPierSelectionIndexes(ctx sdk.Context) []types.PierSelectionIndex {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(pierIndexKeyPrefix, prefixEnd(pierIndexKeyPrefix))
defer iterator.Close()
out := []types.PierSelectionIndex{}
for ; iterator.Valid(); iterator.Next() {
var idx types.PierSelectionIndex
if err := json.Unmarshal(iterator.Value(), &idx); err == nil {
out = append(out, idx)
}
}
return out
}
// DefaultPierScores are the simtest-grade default scores for a fresh
// PierSelectionIndex entry (the mesh assigns these on a Pier's first
// selection — the live mesh oracle is a v0.8+ concern; the simtest uses
// these deterministic defaults so the index is non-empty on first
// selection). All three scores are in [0,1]; the OverallScore is the
// weighted aggregate (a deterministic blend: 0.4 × JurisdictionalReliability
// + 0.3 × IntegrationQuality + 0.3 × (FiduciaryRecordHash non-empty ? 1.0
// : 0.0)).
const (
DefaultPierJurisdictionalReliabilityScore = 0.8
DefaultPierIntegrationQualityScore = 0.7
)
// DefaultPierOverallScore computes the deterministic OverallScore blend
// for a PierSelectionIndex (the keeper uses this when creating or updating
// an index entry). The blend is 0.4 × JurisdictionalReliability + 0.3 ×
// IntegrationQuality + 0.3 × FiduciaryConfidence (FiduciaryConfidence is
// 1.0 if the FiduciaryRecordHash is non-empty, else 0.0). The simtest
// asserts the OverallScore is non-decreasing on successive selections (a
// second selection with the same scores yields the same OverallScore).
func DefaultPierOverallScore(jurisdictionalReliability, integrationQuality float64, fiduciaryRecordHash []byte) float64 {
fiduciaryConfidence := 0.0
if len(fiduciaryRecordHash) > 0 {
fiduciaryConfidence = 1.0
}
return 0.4*jurisdictionalReliability + 0.3*integrationQuality + 0.3*fiduciaryConfidence
}
+762 -15
View File
@@ -1,15 +1,16 @@
package keeper
// msg_server.go implements the cover module's MsgServer (REQ-046, REQ-047,
// REQ-049, REQ-050, REQ-055, D-077, D-079, D-086, D-088, D-089). The
// MsgServer wraps the Keeper + the four expected-keeper shims (already on
// the Keeper: StandingKeeper, WatcherKeeper, BondKeeper, StillKeeper).
// REQ-049, REQ-050, REQ-052, REQ-055, REQ-056, REQ-062, REQ-048, D-077,
// D-079, D-086, D-088, D-089, D-090). The MsgServer wraps the Keeper + the
// four expected-keeper shims (already on the Keeper: StandingKeeper,
// WatcherKeeper, BondKeeper, StillKeeper).
//
// Each method returns a (*Response, error). Handler state-machine ordering
// is enforced: ValidateBasic -> handler authz/gate -> state mutation ->
// ctx.EventManager().EmitEvent.
//
// Handler set:
// P1 handler set:
// - LaunchCoverPool: D-086 category phase check + D-077 Standing gate +
// reserve floor + Watcher attestation; persists the CoverPool.
// - RouteCoverFee: D-079 Anti-Crowding-Out firewall + category-tag match +
@@ -18,13 +19,28 @@ package keeper
// - FileCoverCall: P1 scaffold — persists the CoverCall + emits an event;
// P4 adds the Voucher adjudication + no-self-adjudication + slashing.
//
// P2 handler set:
// - SignCoverCharter: D-090(1) Bill of Rights gate (ValidateBasic) +
// idempotency + Watcher attestation; persists the CoverCharter.
// - AmendCoverCharter: creates a CharterAmendment with Status=Proposed;
// the 7-day cooling is enforced by CoolCharterAmendment /
// RatifyCharterAmendment (keeper helpers).
// - ElectPoolMason: loads/creates the PoolCouncil + adds the Mason (max
// 3 — a 4th is REJECTED).
// - VoteCoverCall: loads the CoverCall + Watcher-observer-present check
// for a CallVoteYes; persists the CoverCallVote.
// - AmendPoolStandingGate: D-090(3) dual check (ValidateBasic + handler
// re-check) + updates the pool's PoolStandingGate.
// - EscalateReserveCeiling: 12-month age check + Watcher attestation +
// sets the pool's reserve target to CoverReserveCeilingAnnualContribX.
//
// Nil-shim behavior (simtest wiring): a nil StandingKeeper skips the D-077
// gate (the handler still mutates state — the simtest documents the wiring
// contract); a nil WatcherKeeper skips the launch attestation; a nil
// StillKeeper skips the auto-Still recording (the pool's PoolPaused flag is
// still set, just the Still event is not recorded in a still store); a nil
// BondKeeper is the P1 default (the P4 handler will reject a nil shim as a
// wiring error when the P4 MAB check is wired).
// contract); a nil WatcherKeeper skips the launch/charter/escalation
// attestation; a nil StillKeeper skips the auto-Still recording (the pool's
// PoolPaused flag is still set, just the Still event is not recorded in a
// still store); a nil BondKeeper is the P1 default (the P4 handler will
// reject a nil shim as a wiring error when the P4 MAB check is wired).
import (
"fmt"
@@ -125,11 +141,12 @@ func (s msgServer) LaunchCoverPool(ctx interface{}, msg *types.MsgLaunchCoverPoo
return nil, fmt.Errorf("cover: pool %q already exists", msg.PoolID)
}
// Load the Params (P1: DefaultParams the live Params store is deferred;
// the handler uses DefaultParams for the FactoryAllowedPhases + the
// PoolStandingGate floor). A future P2 will load the Params from the
// params store; P1 ships the default.
params := types.DefaultParams()
// Load the Params (the effective Params: the override if set, else
// DefaultParams). The D-086 simtest case (f) uses the override to
// restrict FactoryAllowedPhases to [Phase2, Phase3] only and reject a
// Phase4 launch. A future P2+ will load the Params from the params
// store; for now the keeper holds the override.
params := s.Keeper.Params()
if err := params.Validate(); err != nil {
return nil, fmt.Errorf("cover: params invalid: %w", err)
}
@@ -190,7 +207,7 @@ func (s msgServer) LaunchCoverPool(ctx interface{}, msg *types.MsgLaunchCoverPoo
CharterHash: msg.CharterHash,
FactoryAllowedPhases: params.FactoryAllowedPhases,
PoolStandingGate: params.PoolStandingGate,
CreatedAt: sdkCtx.BlockHeight(),
CreatedAt: sdkCtx.BlockTime().Unix(),
}
s.Keeper.SetCoverPool(sdkCtx, pool)
@@ -352,3 +369,733 @@ func (s msgServer) FileCoverCall(ctx interface{}, msg *types.MsgFileCoverCall) (
))
return &types.MsgFileCoverCallResponse{}, nil
}
// --- P2: SignCoverCharter -----------------------------------------------------
// SignCoverCharter signs a Cover-Charter for a Pool (REQ-052, REQ-056,
// D-090(1)). The handler enforces:
// 1. ValidateBasic (stateless — includes the D-090(1) Bill of Rights
// gate: any WaivedRights element REJECTS the signing).
// 2. Idempotency: CharterID must not already exist.
// 3. The referenced Pool must exist (the charter binds to a pool).
// 4. WatcherKeeper.Attest on the charter witness hash (a nil WatcherKeeper
// skips; an empty WatcherWitnessHash skips).
// 5. Persist the CoverCharter + link the pool's CharterRef.
// 6. Emit cover.charter_signed.
func (s msgServer) SignCoverCharter(ctx interface{}, msg *types.MsgSignCoverCharter) (*types.MsgSignCoverCharterResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// Idempotency: charter-id must not already exist.
if _, ok := s.Keeper.GetCoverCharter(sdkCtx, msg.CharterID); ok {
return nil, fmt.Errorf("cover: charter %q already exists", msg.CharterID)
}
// The referenced pool must exist (the charter binds to a pool).
pool, ok := s.Keeper.GetCoverPool(sdkCtx, msg.PoolID)
if !ok {
return nil, fmt.Errorf("cover: pool %q not found (SignCoverCharter rejected)", msg.PoolID)
}
// Watcher attestation over the witness hash (REQ-052). A nil
// WatcherKeeper skips; an empty WatcherWitnessHash skips (the charter
// may be signed without a witness in simtest).
if s.Keeper.watcherKeeper != nil && len(msg.WatcherWitnessHash) > 0 {
if _, err := s.Keeper.watcherKeeper.Attest(msg.PoolID, msg.WatcherWitnessHash); err != nil {
return nil, fmt.Errorf("cover: Watcher attestation for charter %q: %w (REQ-052)", msg.CharterID, err)
}
}
charter := types.CoverCharter{
CharterID: msg.CharterID,
PoolID: msg.PoolID,
StatementOfBeliefsHash: msg.StatementOfBeliefsHash,
DisputePath: msg.DisputePath,
Gate: msg.Gate,
HoldingPeriodDays: msg.HoldingPeriodDays,
HostReachID: msg.HostReachID,
WatcherWitnessHash: msg.WatcherWitnessHash,
Amendments: []types.CharterAmendment{},
WaivedRights: msg.WaivedRights,
}
s.Keeper.SetCoverCharter(sdkCtx, charter)
// Link the pool's CharterRef.
pool.CharterRef = msg.CharterID
s.Keeper.SetCoverPool(sdkCtx, pool)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.charter_signed",
sdk.NewAttribute("charter_id", msg.CharterID),
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("host_reach_id", msg.HostReachID),
))
return &types.MsgSignCoverCharterResponse{}, nil
}
// --- P2: AmendCoverCharter ----------------------------------------------------
// AmendCoverCharter files a Charter amendment (REQ-052). The handler
// enforces:
// 1. ValidateBasic (stateless).
// 2. The referenced charter must exist.
// 3. Create a CharterAmendment with Status=AmendmentProposed,
// ProposedAt=now. Persist the amendment + append to the charter's
// Amendments slice.
// 4. Emit cover.charter_amend_proposed.
//
// The 7-day cooling is enforced by CoolCharterAmendment /
// RatifyCharterAmendment (keeper helpers) — a simtest time-advance or a
// separate handler transitions the amendment to Cooled then Ratified.
func (s msgServer) AmendCoverCharter(ctx interface{}, msg *types.MsgAmendCoverCharter) (*types.MsgAmendCoverCharterResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
charter, ok := s.Keeper.GetCoverCharter(sdkCtx, msg.CharterID)
if !ok {
return nil, fmt.Errorf("cover: charter %q not found (AmendCoverCharter rejected)", msg.CharterID)
}
// Idempotency: amendment-id must not already exist.
if _, ok := s.Keeper.GetCharterAmendment(sdkCtx, msg.AmendmentID); ok {
return nil, fmt.Errorf("cover: amendment %q already exists", msg.AmendmentID)
}
amendment := types.CharterAmendment{
AmendmentID: msg.AmendmentID,
Description: msg.Description,
Status: types.AmendmentProposed,
ProposedAt: sdkCtx.BlockTime().Unix(),
}
s.Keeper.SetCharterAmendment(sdkCtx, amendment)
// Append the amendment to the charter's Amendments slice + persist.
charter.Amendments = append(charter.Amendments, amendment)
s.Keeper.SetCoverCharter(sdkCtx, charter)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.charter_amend_proposed",
sdk.NewAttribute("charter_id", msg.CharterID),
sdk.NewAttribute("amendment_id", msg.AmendmentID),
))
return &types.MsgAmendCoverCharterResponse{}, nil
}
// --- P2: ElectPoolMason -------------------------------------------------------
// ElectPoolMason elects a Mason to the Pool Council (REQ-062). The
// handler enforces:
// 1. ValidateBasic (stateless).
// 2. The referenced pool must exist.
// 3. Load or create the PoolCouncil. Add the MasonReachID to
// ElectedMasonReachIDs (max PoolCouncilMaxMasons = 3 — a 4th is
// REJECTED). Reject a duplicate MasonReachID (already elected).
// 4. Persist the PoolCouncil + link the pool's CouncilRef.
// 5. Emit cover.pool_mason_elected.
func (s msgServer) ElectPoolMason(ctx interface{}, msg *types.MsgElectPoolMason) (*types.MsgElectPoolMasonResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
pool, ok := s.Keeper.GetCoverPool(sdkCtx, msg.PoolID)
if !ok {
return nil, fmt.Errorf("cover: pool %q not found (ElectPoolMason rejected)", msg.PoolID)
}
council, exists := s.Keeper.GetPoolCouncil(sdkCtx, msg.PoolID)
if !exists {
council = types.PoolCouncil{
PoolID: msg.PoolID,
HostReachID: pool.HostReachID,
ElectedMasonReachIDs: [3]string{},
}
}
// Reject a duplicate MasonReachID (already elected).
for _, m := range council.ElectedMasonReachIDs {
if m == msg.MasonReachID {
return nil, fmt.Errorf("cover: mason %q already elected to pool %q council (REQ-062)", msg.MasonReachID, msg.PoolID)
}
}
// Find the first empty slot; if all 3 are filled, REJECT (max
// PoolCouncilMaxMasons).
slotIdx := -1
for i, m := range council.ElectedMasonReachIDs {
if m == "" {
slotIdx = i
break
}
}
if slotIdx == -1 {
return nil, fmt.Errorf("cover: pool %q council already has %d masons (REQ-062 max %d)", msg.PoolID, types.PoolCouncilMaxMasons, types.PoolCouncilMaxMasons)
}
council.ElectedMasonReachIDs[slotIdx] = msg.MasonReachID
s.Keeper.SetPoolCouncil(sdkCtx, council)
// Link the pool's CouncilRef (the council is keyed by pool-id, so the
// ref is the pool-id itself).
pool.CouncilRef = msg.PoolID
s.Keeper.SetCoverPool(sdkCtx, pool)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.pool_mason_elected",
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("mason_reach_id", msg.MasonReachID),
sdk.NewAttribute("slot", fmt.Sprintf("%d", slotIdx)),
))
return &types.MsgElectPoolMasonResponse{}, nil
}
// --- P2: VoteCoverCall --------------------------------------------------------
// VoteCoverCall votes on a Cover Call (REQ-062). The handler enforces:
// 1. ValidateBasic (stateless — includes the valid VoteOption check).
// 2. The referenced CoverCall must exist.
// 3. The Watcher-observer-present check: if VoteOption == CallVoteYes and
// WatcherObserverPresent == false, REJECT (majority requires observer
// present — REQ-062).
// 4. Idempotency: VoteID must not already exist.
// 5. Persist the CoverCallVote. Emit cover.cover_call_voted.
func (s msgServer) VoteCoverCall(ctx interface{}, msg *types.MsgVoteCoverCall) (*types.MsgVoteCoverCallResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// The referenced CoverCall must exist.
if _, ok := s.Keeper.GetCoverCall(sdkCtx, msg.CallID); !ok {
return nil, fmt.Errorf("cover: call %q not found (VoteCoverCall rejected)", msg.CallID)
}
// The Watcher-observer-present check (REQ-062): a CallVoteYes requires
// the Watcher observer to be present. A CallVoteNo / CallVoteAbstain
// does NOT require the observer (only an affirmative vote demands the
// witness).
if msg.VoteOption == types.CallVoteYes && !msg.WatcherObserverPresent {
return nil, fmt.Errorf("cover: CallVoteYes on call %q requires Watcher observer present (REQ-062)", msg.CallID)
}
// Idempotency: vote-id must not already exist.
if _, ok := s.Keeper.GetCoverCallVote(sdkCtx, msg.VoteID); ok {
return nil, fmt.Errorf("cover: vote %q already exists", msg.VoteID)
}
vote := types.CoverCallVote{
VoteID: msg.VoteID,
CallID: msg.CallID,
PoolID: msg.PoolID,
VoterReachID: msg.VoterReachID,
VoteOption: msg.VoteOption,
WatcherObserverPresent: msg.WatcherObserverPresent,
VotedAt: sdkCtx.BlockTime().Unix(),
}
s.Keeper.SetCoverCallVote(sdkCtx, vote)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.cover_call_voted",
sdk.NewAttribute("vote_id", msg.VoteID),
sdk.NewAttribute("call_id", msg.CallID),
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("voter_reach_id", msg.VoterReachID),
sdk.NewAttribute("vote_option", string(msg.VoteOption)),
))
return &types.MsgVoteCoverCallResponse{}, nil
}
// --- P2: AmendPoolStandingGate ------------------------------------------------
// AmendPoolStandingGate amends a Pool's Standing gate (D-090(3)). The
// handler enforces:
// 1. ValidateBasic (stateless — includes the D-090(3) dual check:
// NewGate >= CoverStandingGateTrusted).
// 2. The referenced pool must exist.
// 3. D-090(3) handler re-check (defense in depth): NewGate >=
// CoverStandingGateTrusted. ValidateBasic already checked, but the
// handler re-checks in case of a future Params-bypass.
// 4. Update the pool's PoolStandingGate. Persist.
// 5. Emit cover.pool_standing_gate_amended.
func (s msgServer) AmendPoolStandingGate(ctx interface{}, msg *types.MsgAmendPoolStandingGate) (*types.MsgAmendPoolStandingGateResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
pool, ok := s.Keeper.GetCoverPool(sdkCtx, msg.PoolID)
if !ok {
return nil, fmt.Errorf("cover: pool %q not found (AmendPoolStandingGate rejected)", msg.PoolID)
}
// D-090(3) handler re-check (defense in depth — ValidateBasic already
// checked, but the handler re-checks in case of a future Params-bypass).
if msg.NewGate < types.CoverStandingGateTrusted {
return nil, fmt.Errorf("cover: NewGate %.2f < CoverStandingGateTrusted %.2f (D-090(3) handler re-check: a pool may tighten the gate but never lower it)", msg.NewGate, types.CoverStandingGateTrusted)
}
pool.PoolStandingGate = msg.NewGate
s.Keeper.SetCoverPool(sdkCtx, pool)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.pool_standing_gate_amended",
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("new_gate", fmt.Sprintf("%.2f", msg.NewGate)),
))
return &types.MsgAmendPoolStandingGateResponse{}, nil
}
// --- P2: EscalateReserveCeiling -----------------------------------------------
// EscalateReserveCeiling escalates a Pool's reserve target to the
// CoverReserveCeilingAnnualContribX (REQ-048). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The referenced pool must exist.
// 3. 12-month age check: now - pool.CreatedAt >= ReserveCeilingAgeSeconds
// (365 days). A fresh pool is REJECTED. NOTE: pool.CreatedAt is set to
// sdkCtx.BlockHeight() at launch in P1; for the age check we use
// BlockTime().Unix() - pool.CreatedAt where pool.CreatedAt is
// interpreted as a unix timestamp (the simtest sets CreatedAt to a
// unix timestamp to satisfy this check).
// 4. Set the pool's ReserveAnnualContribRatio to
// CoverReserveCeilingAnnualContribX (2.5).
// 5. WatcherKeeper.Attest (a nil WatcherKeeper skips).
// 6. Persist the updated pool. Emit cover.reserve_ceiling_escalated.
func (s msgServer) EscalateReserveCeiling(ctx interface{}, msg *types.MsgEscalateReserveCeiling) (*types.MsgEscalateReserveCeilingResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
pool, ok := s.Keeper.GetCoverPool(sdkCtx, msg.PoolID)
if !ok {
return nil, fmt.Errorf("cover: pool %q not found (EscalateReserveCeiling rejected)", msg.PoolID)
}
// 12-month age check (REQ-048): the pool must have >= 365 days of
// operating history before the reserve target can be escalated to the
// ceiling. pool.CreatedAt is interpreted as a unix timestamp (the
// simtest sets it accordingly).
now := sdkCtx.BlockTime().Unix()
if now-pool.CreatedAt < types.ReserveCeilingAgeSeconds {
return nil, fmt.Errorf("cover: pool %q age %d seconds < %d seconds (REQ-048: 12-month operating history required for reserve ceiling escalation)", msg.PoolID, now-pool.CreatedAt, types.ReserveCeilingAgeSeconds)
}
// Set the pool's reserve target to the ceiling.
pool.ReserveAnnualContribRatio = types.CoverReserveCeilingAnnualContribX
// Watcher attestation (REQ-048). A nil WatcherKeeper skips.
if s.Keeper.watcherKeeper != nil {
payload := []byte(fmt.Sprintf("cover.escalate:%s:%.2f", msg.PoolID, types.CoverReserveCeilingAnnualContribX))
if _, err := s.Keeper.watcherKeeper.Attest(msg.PoolID, payload); err != nil {
return nil, fmt.Errorf("cover: Watcher attestation for reserve ceiling escalation on pool %q: %w (REQ-048)", msg.PoolID, err)
}
}
s.Keeper.SetCoverPool(sdkCtx, pool)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.reserve_ceiling_escalated",
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("reserve_annual_contrib_ratio", fmt.Sprintf("%.2f", types.CoverReserveCeilingAnnualContribX)),
))
return &types.MsgEscalateReserveCeilingResponse{}, nil
}
// --- v0.7 P4: Voucher + Dissolution handlers (REQ-055, REQ-063, D-090(2)) ------
//
// (Cover Claims Voucher registration + Cover Call adjudication + Voucher
// slash + Pool dissolution waterfall). The four handlers exercise the
// D-090(2) cold-start bond fallback, the FR-CPCV-2 no-self-adjudication
// gate, the cross-Pool slash via StandingKeeper.RecordSlash, and the
// FR-MAB-4 seniority chain (Cover-Fee contributors > MAB > Bread holders).
// RegisterCoverClaimsVoucher registers a Cover Claims Voucher for a Pool
// (REQ-055, D-090(2)). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The referenced Pool must exist.
// 3. Idempotency: no duplicate Voucher for the same VoucherReachID +
// PoolID (a Voucher is registered per-Pool; a second registration for
// the same composite key is REJECTED).
// 4. Compute bond: max(CoverClaimsVoucherBondMultipleAvgCall ×
// GetAvgCallSize(poolID), Params.MinimumVoucherBond). D-090(2) cold-
// start: when no Calls exist, GetAvgCallSize returns 0 -> bond =
// MinimumVoucherBond (NOT zero).
// 5. Persist the Voucher + emit cover.voucher_registered.
func (s msgServer) RegisterCoverClaimsVoucher(ctx interface{}, msg *types.MsgRegisterCoverClaimsVoucher) (*types.MsgRegisterCoverClaimsVoucherResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// The referenced Pool must exist.
if _, ok := s.Keeper.GetCoverPool(sdkCtx, msg.PoolID); !ok {
return nil, fmt.Errorf("cover: pool %q not found (RegisterCoverClaimsVoucher rejected)", msg.PoolID)
}
// Idempotency: no duplicate Voucher for the same VoucherReachID + PoolID.
if _, ok := s.Keeper.GetCoverClaimsVoucher(sdkCtx, msg.VoucherReachID, msg.PoolID); ok {
return nil, fmt.Errorf("cover: voucher %q already registered for pool %q (RegisterCoverClaimsVoucher rejected)", msg.VoucherReachID, msg.PoolID)
}
// D-090(2) bond computation: max(multiple × avgCallSize,
// MinimumVoucherBond). When no Calls exist, avgCallSize = 0 -> bond =
// MinimumVoucherBond (NOT zero — the cold-start fix).
avgCallSize := s.Keeper.GetAvgCallSize(sdkCtx, msg.PoolID)
multipleBond := int64(types.CoverClaimsVoucherBondMultipleAvgCall) * avgCallSize
minBond := s.Keeper.Params().MinimumVoucherBond
bond := multipleBond
if bond < minBond {
bond = minBond
}
v := types.CoverClaimsVoucher{
VoucherReachID: msg.VoucherReachID,
PoolID: msg.PoolID,
BondAmount: bond,
BondMultipleAvgCall: types.CoverClaimsVoucherBondMultipleAvgCall,
RegisteredAt: sdkCtx.BlockTime().Unix(),
}
s.Keeper.SetCoverClaimsVoucher(sdkCtx, v)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.voucher_registered",
sdk.NewAttribute("voucher_reach_id", msg.VoucherReachID),
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("bond_amount", fmt.Sprintf("%d", bond)),
sdk.NewAttribute("avg_call_size", fmt.Sprintf("%d", avgCallSize)),
))
return &types.MsgRegisterCoverClaimsVoucherResponse{BondAmount: bond}, nil
}
// AdjudicateCoverCall adjudicates a Cover Call (REQ-055, FR-CPCV-2). The
// handler enforces:
// 1. ValidateBasic (stateless).
// 2. The CoverCall must exist.
// 3. FR-CPCV-2 no self-adjudication: reject if VoucherReachID ==
// CoverCall.ClaimantReachID (the Voucher cannot adjudicate their own
// Call).
// 4. The Voucher must be registered for the Call's Pool.
// 5. Record the adjudication result on the CoverCall (AdjudicationResult +
// AdjudicatedBy + AdjudicatedAt). Persist. Emit
// cover.cover_call_adjudicated.
func (s msgServer) AdjudicateCoverCall(ctx interface{}, msg *types.MsgAdjudicateCoverCall) (*types.MsgAdjudicateCoverCallResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
call, ok := s.Keeper.GetCoverCall(sdkCtx, msg.CallID)
if !ok {
return nil, fmt.Errorf("cover: call %q not found (AdjudicateCoverCall rejected)", msg.CallID)
}
// FR-CPCV-2 no self-adjudication: the Voucher cannot adjudicate their
// own Call.
if msg.VoucherReachID == call.ClaimantReachID {
return nil, fmt.Errorf("cover: FR-CPCV-2 no self-adjudication — voucher %q == call %q claimant %q (AdjudicateCoverCall rejected)",
msg.VoucherReachID, msg.CallID, call.ClaimantReachID)
}
// The Voucher must be registered for the Call's Pool.
if _, ok := s.Keeper.GetCoverClaimsVoucher(sdkCtx, msg.VoucherReachID, call.PoolID); !ok {
return nil, fmt.Errorf("cover: voucher %q not registered for pool %q (AdjudicateCoverCall rejected)", msg.VoucherReachID, call.PoolID)
}
// Record the adjudication result on the CoverCall (additive fields).
call.AdjudicationResult = msg.AdjudicationResult
call.AdjudicatedBy = msg.VoucherReachID
call.AdjudicatedAt = sdkCtx.BlockTime().Unix()
s.Keeper.SetCoverCall(sdkCtx, call)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.cover_call_adjudicated",
sdk.NewAttribute("call_id", msg.CallID),
sdk.NewAttribute("pool_id", call.PoolID),
sdk.NewAttribute("voucher_reach_id", msg.VoucherReachID),
sdk.NewAttribute("adjudication_result", msg.AdjudicationResult),
))
return &types.MsgAdjudicateCoverCallResponse{}, nil
}
// SlashCoverClaimsVoucher slashes a Cover Claims Voucher for a fraudulent
// Cover Call adjudication (REQ-055). The handler enforces:
// 1. ValidateBasic (stateless — Reason must == SlashReasonFraudulentCoverCall).
// 2. The Voucher must exist (look up by VoucherReachID across all Pools —
// a Voucher may be registered for multiple Pools; the slash drops the
// Standing bucket, which is cross-Pool).
// 3. Invoke StandingKeeper.RecordSlash(voucherReachID, amount, reason,
// attester) — the slash drops the Voucher's Standing bucket (cross-Pool
// applicability — the bucket drop disqualifies them from other Pools'
// Standing gates). A nil StandingKeeper is a wiring error -> REJECT.
// 4. Emit cover.voucher_slashed.
func (s msgServer) SlashCoverClaimsVoucher(ctx interface{}, msg *types.MsgSlashCoverClaimsVoucher) (*types.MsgSlashCoverClaimsVoucherResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// The Voucher must exist (look up by VoucherReachID across all Pools).
vouchers := s.Keeper.AllCoverClaimsVouchers(sdkCtx)
var found *types.CoverClaimsVoucher
for i := range vouchers {
if vouchers[i].VoucherReachID == msg.VoucherReachID {
found = &vouchers[i]
break
}
}
if found == nil {
return nil, fmt.Errorf("cover: voucher %q not found (SlashCoverClaimsVoucher rejected)", msg.VoucherReachID)
}
// StandingKeeper.RecordSlash — the slash drops the Voucher's Standing
// bucket (cross-Pool applicability). A nil StandingKeeper is a wiring
// error -> REJECT (the slash cannot be recorded).
if s.Keeper.standingKeeper == nil {
return nil, fmt.Errorf("cover: StandingKeeper shim not wired (SlashCoverClaimsVoucher cannot record the slash — REQ-055 cross-Pool applicability)")
}
if err := s.Keeper.standingKeeper.RecordSlash(msg.VoucherReachID, float64(found.BondAmount), msg.Reason, msg.Signer); err != nil {
return nil, fmt.Errorf("cover: StandingKeeper.RecordSlash for voucher %q: %w (REQ-055)", msg.VoucherReachID, err)
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.voucher_slashed",
sdk.NewAttribute("voucher_reach_id", msg.VoucherReachID),
sdk.NewAttribute("call_id", msg.CallID),
sdk.NewAttribute("reason", msg.Reason),
sdk.NewAttribute("bond_amount", fmt.Sprintf("%d", found.BondAmount)),
))
return &types.MsgSlashCoverClaimsVoucherResponse{}, nil
}
// DissolveCoverPool dissolves a Cover Pool (REQ-063, FR-MAB-4). The handler
// enforces:
// 1. ValidateBasic (stateless).
// 2. The Pool must exist.
// 3. Compute the PoolDissolutionWaterfall (FR-MAB-4 seniority chain):
// Tier 1 = Cover-Fee contributors (the Pool's reserve — a simtest-grade
// placeholder amount; the real reserve balance is a v0.8+ concern),
// Tier 2 = MAB holders (query BondKeeper.GetMABsForPool for the Pool's
// outstanding MABs; sum the PrincipalGrain), Tier 3 = Bread holders
// (the remainder — simtest-grade placeholder). MAB holders have NO
// Voice in the dissolution decision (REQ-063 — the PoolCouncil from P2
// already excludes them; the waterfall only determines the payout
// order).
// 4. Emit cover.pool_dissolved with the waterfall tiers.
func (s msgServer) DissolveCoverPool(ctx interface{}, msg *types.MsgDissolveCoverPool) (*types.MsgDissolveCoverPoolResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
pool, ok := s.Keeper.GetCoverPool(sdkCtx, msg.PoolID)
if !ok {
return nil, fmt.Errorf("cover: pool %q not found (DissolveCoverPool rejected)", msg.PoolID)
}
// FR-MAB-4 waterfall. Tier 1 = Cover-Fee contributors (the Pool's
// reserve — simtest-grade placeholder; the real reserve balance is a
// v0.8+ concern, so we use a deterministic placeholder derived from
// the pool's ReserveAnnualContribRatio for the simtest assertion).
coverFeeContributors := int64(pool.ReserveAnnualContribRatio * 1_000_000)
// Tier 2 = MAB holders (sum the outstanding MAB principal via
// BondKeeper.GetMABsForPool). A nil BondKeeper returns an empty slice
// -> Tier 2 amount = 0.
mabHolders := int64(0)
if s.Keeper.bondKeeper != nil {
for _, m := range s.Keeper.bondKeeper.GetMABsForPool(msg.PoolID) {
mabHolders += m.PrincipalGrain
}
}
// Tier 3 = Bread holders (the remainder — simtest-grade placeholder;
// the real Bread-holder balance is a v0.8+ concern, so we use a
// deterministic placeholder for the simtest assertion).
breadHolders := coverFeeContributors / 4
waterfall := []types.PoolDissolutionWaterfall{
{Tier: types.PoolDissolutionWaterfallTierCoverFeeContributors, AmountGrain: coverFeeContributors},
{Tier: types.PoolDissolutionWaterfallTierMABHolders, AmountGrain: mabHolders},
{Tier: types.PoolDissolutionWaterfallTierBreadHolders, AmountGrain: breadHolders},
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.pool_dissolved",
sdk.NewAttribute("pool_id", msg.PoolID),
sdk.NewAttribute("tier_1_cover_fee_contributors", fmt.Sprintf("%d", coverFeeContributors)),
sdk.NewAttribute("tier_2_mab_holders", fmt.Sprintf("%d", mabHolders)),
sdk.NewAttribute("tier_3_bread_holders", fmt.Sprintf("%d", breadHolders)),
))
return &types.MsgDissolveCoverPoolResponse{Waterfall: waterfall}, nil
}
// --- v0.7 P5: Bill of Rights ceremony + Pier Selection handlers (REQ-056, REQ-066) --
//
// (REQ-056 §7 acceptance ceremony, REQ-066 Pier Selection.) The three
// handlers exercise the bonded-Counsel review gate, the Pier selection
// persistence + index accumulation, and the Cover-Pool-supermajority +
// Counsel-witness revocation gate.
// CounselReviewBillOfRights records a bonded Counsel's review of the
// Anti-Capture Bill of Rights (REQ-056, vision §7, §8.2). The handler
// enforces:
// 1. ValidateBasic (stateless — includes the §7 "bonded Counsel" gate:
// Staked must be true).
// 2. Idempotency: ReviewID must not already exist.
// 3. Handler re-check of Staked (defense in depth — the §7 acceptance is
// load-bearing; the handler re-checks in case of a future
// ValidateBasic-bypass).
// 4. Persist the BillOfRightsReview (the bill_review/ store: ReviewID ->
// review record). Emit cover.bill_of_rights_reviewed.
func (s msgServer) CounselReviewBillOfRights(ctx interface{}, msg *types.MsgCounselReviewBillOfRights) (*types.MsgCounselReviewBillOfRightsResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// Idempotency: review-id must not already exist.
if _, ok := s.Keeper.GetBillOfRightsReview(sdkCtx, msg.ReviewID); ok {
return nil, fmt.Errorf("cover: bill-of-rights review %q already exists", msg.ReviewID)
}
// Handler re-check of Staked (defense in depth — the §7 "bonded Counsel"
// acceptance is load-bearing; re-check in case of a future
// ValidateBasic-bypass).
if !msg.Staked {
return nil, fmt.Errorf("cover: REQ-056 §7 acceptance: handler re-check — Staked must be true (bonded Counsel)")
}
review := BillOfRightsReview{
ReviewID: msg.ReviewID,
CounselReachID: msg.CounselReachID,
Staked: msg.Staked,
ReviewResult: msg.ReviewResult,
ReviewedAt: sdkCtx.BlockTime().Unix(),
}
s.Keeper.SetBillOfRightsReview(sdkCtx, review)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.bill_of_rights_reviewed",
sdk.NewAttribute("review_id", msg.ReviewID),
sdk.NewAttribute("counsel_reach_id", msg.CounselReachID),
sdk.NewAttribute("staked", fmt.Sprintf("%v", msg.Staked)),
sdk.NewAttribute("review_result", msg.ReviewResult),
))
return &types.MsgCounselReviewBillOfRightsResponse{}, nil
}
// SelectPier records a Guild Council's selection of a Pier at formation
// (REQ-066). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. Idempotency: a PierSelectionRecord for the same GuildID must not
// already exist (a Guild selects exactly one Pier; a second selection
// is REJECTED — use MsgRevokePierSelection first).
// 3. Guild existence check via the GuildKeeper shim (a nil shim skips —
// simtest wiring; a non-nil shim with exists=false REJECTS).
// 4. Persist the PierSelectionRecord (pier_selection/ store: GuildID ->
// record). Create or update the PierSelectionIndex entry for the
// PierID (pier_index/ store: PierID -> index — accumulate scores from
// successive selections). Emit cover.pier_selected.
func (s msgServer) SelectPier(ctx interface{}, msg *types.MsgSelectPier) (*types.MsgSelectPierResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// Idempotency: a Guild selects exactly one Pier; a second selection is
// REJECTED (use MsgRevokePierSelection first to re-select).
if _, ok := s.Keeper.GetPierSelectionRecord(sdkCtx, msg.GuildID); ok {
return nil, fmt.Errorf("cover: guild %q already has a Pier selection (use RevokePierSelection first to re-select — REQ-066)", msg.GuildID)
}
// Guild existence check via the GuildKeeper shim (a nil shim skips —
// simtest wiring; a non-nil shim with exists=false REJECTS).
if s.Keeper.guildKeeper != nil {
if !s.Keeper.guildKeeper.GetGuild(msg.GuildID) {
return nil, fmt.Errorf("cover: guild %q not found (SelectPier rejected — REQ-066)", msg.GuildID)
}
}
record := types.PierSelectionRecord{
GuildID: msg.GuildID,
PierID: msg.PierID,
SelectedAt: sdkCtx.BlockTime().Unix(),
SelectedBy: msg.Signer,
}
s.Keeper.SetPierSelectionRecord(sdkCtx, record)
// Create or update the PierSelectionIndex entry for the PierID
// (accumulate scores from successive selections — a fresh entry gets
// the default scores; an existing entry keeps its scores but the
// OverallScore is recomputed for non-decreasing assertion). The live
// mesh oracle is a v0.8+ concern; the simtest uses deterministic
// defaults so the index is non-empty on first selection.
idx, ok := s.Keeper.GetPierSelectionIndex(sdkCtx, msg.PierID)
if !ok {
idx = types.PierSelectionIndex{
PierID: msg.PierID,
JurisdictionalReliabilityScore: DefaultPierJurisdictionalReliabilityScore,
IntegrationQualityScore: DefaultPierIntegrationQualityScore,
}
}
idx.OverallScore = DefaultPierOverallScore(idx.JurisdictionalReliabilityScore, idx.IntegrationQualityScore, idx.FiduciaryRecordHash)
s.Keeper.SetPierSelectionIndex(sdkCtx, idx)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.pier_selected",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("pier_id", msg.PierID),
sdk.NewAttribute("selected_by", msg.Signer),
sdk.NewAttribute("overall_score", fmt.Sprintf("%.4f", idx.OverallScore)),
))
return &types.MsgSelectPierResponse{}, nil
}
// RevokePierSelection revokes a Guild's Pier selection (REQ-066). The
// revocation is reversible by a Cover Pool supermajority + a Counsel
// witness. The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The PierSelectionRecord for the GuildID must exist (nothing to
// revoke -> REJECT).
// 3. Authorization: RevocationApproved must be true + CounselWitness must
// be non-empty (the Cover Pool supermajority + Counsel witness gate —
// a revocation without either is REJECTED).
// 4. Remove the PierSelectionRecord. Emit cover.pier_selection_revoked.
func (s msgServer) RevokePierSelection(ctx interface{}, msg *types.MsgRevokePierSelection) (*types.MsgRevokePierSelectionResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// The PierSelectionRecord for the GuildID must exist.
record, ok := s.Keeper.GetPierSelectionRecord(sdkCtx, msg.GuildID)
if !ok {
return nil, fmt.Errorf("cover: guild %q has no Pier selection to revoke (REQ-066)", msg.GuildID)
}
// Authorization: RevocationApproved must be true + CounselWitness must
// be non-empty (the Cover Pool supermajority + Counsel witness gate).
if !msg.RevocationApproved {
return nil, fmt.Errorf("cover: REQ-066 revocation requires RevocationApproved=true (Cover Pool supermajority not secured)")
}
if msg.CounselWitness == "" {
return nil, fmt.Errorf("cover: REQ-066 revocation requires a non-empty CounselWitness (Counsel witness not secured)")
}
removed := s.Keeper.RemovePierSelectionRecord(sdkCtx, msg.GuildID)
if !removed {
return nil, fmt.Errorf("cover: PierSelectionRecord for guild %q was not removed (internal error — REQ-066)", msg.GuildID)
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"cover.pier_selection_revoked",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("pier_id", record.PierID),
sdk.NewAttribute("counsel_witness", msg.CounselWitness),
))
return &types.MsgRevokePierSelectionResponse{}, nil
}
File diff suppressed because it is too large Load Diff
+58
View File
@@ -75,6 +75,20 @@ type StandingKeeper interface {
// returns ("", 0, err) — the handler treats this as a gate failure
// (REJECT).
GetStandingBucket(reachID, category string) (bucket string, score float64, err error)
// RecordSlash records a slash against the named holder (by reach-id)
// for the given reason (REQ-055 — the v0.7 P4 Voucher slash for a
// fraudulent Cover Call adjudication; reason ==
// SlashReasonFraudulentCoverCall, cross-documented to
// x/standing.SlashReasonFraudulentCoverCall). The slash drops the
// holder's Standing bucket (cross-Pool applicability — the bucket
// drop disqualifies them from other Pools' Standing gates). The
// amount is the slash amount (the Voucher's bond). The attester is
// the Watcher ID that attested the slash. A non-nil error REJECTS
// the slash (the slash could not be recorded — the Voucher is not
// slashed). A nil StandingKeeper is a wiring error -> the
// SlashCoverClaimsVoucher handler REJECTS (the slash cannot be
// recorded).
RecordSlash(reachID string, amount float64, reason string, attester string) error
}
// WatcherKeeper is the expected-keeper interface for x/watcher (G-003). The
@@ -104,6 +118,13 @@ type WatcherKeeper interface {
// misuse auto-Still is also P4). The interface is here so the P1 wiring is
// stable (the keeper holds the shim; the P4 handler calls it).
//
// v0.7 P4 extension (REQ-063): the DissolveCoverPool handler queries
// GetMABsForPool for the Pool's outstanding MABs (the FR-MAB-4 waterfall
// Tier 2 — MAB holders are paid after Cover-Fee contributors, before Bread
// holders). MABRef is a lightweight by-value struct (no struct import of
// x/bond/types — the fields are by-value primitives cross-documented to
// x/bond.MAB).
//
// No struct import of x/bond/types — the interface is the by-ID-string
// boundary (G-003). The bondID is an opaque string (the MAB's ID). A nil
// BondKeeper is the P1 default (the keeper holds nil; the P4 handler will
@@ -113,6 +134,23 @@ type BondKeeper interface {
// P4 FileCoverCall handler consults this to verify the adjudicating
// Voucher's MAB is posted before adjudication. P1 does not call this.
GetBond(bondID string) (exists bool)
// GetMABsForPool returns the outstanding MABs for the named pool (by-
// ID-string) — REQ-063, FR-MAB-4 waterfall Tier 2. The handler sums
// the PrincipalGrain of the returned MABRefs for the waterfall Tier 2
// amount. A nil BondKeeper returns an empty slice (the handler treats
// this as "no MABs" — Tier 2 amount = 0).
GetMABsForPool(poolID string) []MABRef
}
// MABRef is a lightweight by-value reference to a Mutual Aid Bond (G-003 —
// no struct import of x/bond/types; the fields are by-value primitives
// cross-documented to x/bond.MAB). The DissolveCoverPool handler consumes
// this for the FR-MAB-4 waterfall Tier 2 (MAB holders). BondID is the MAB's
// bond-id (by-ID-string ref). PrincipalGrain is the outstanding principal
// in Grain. The keeper's GetMABsForPool returns a slice of these.
type MABRef struct {
BondID string
PrincipalGrain int64
}
// StillKeeper is the expected-keeper interface for x/still (G-003). The
@@ -139,3 +177,23 @@ type StillKeeper interface {
// not be recorded — the routing is not committed).
Still(poolID string, reason string) error
}
// GuildKeeper is the expected-keeper interface for x/guild (G-003). The P5
// MsgSelectPier handler calls GetGuild to verify the selecting Guild exists
// before persisting the PierSelectionRecord (REQ-066 — a Pier selection is
// recorded against a Guild; the Guild must exist). The interface is the
// by-ID-string boundary: guildID is an opaque string (the Guild's ID); no
// struct import of x/guild/types.
//
// A nil GuildKeeper skips the existence check (simtest wiring — the
// handler still persists the PierSelectionRecord; the simtest documents
// the wiring contract). Mirrors the StandingKeeper nil-skip pattern: a
// nil shim is the simtest's way of saying "no Guild keeper wired; skip
// the existence check" so the handler still mutates state.
type GuildKeeper interface {
// GetGuild reports whether the named Guild (by-ID-string) exists. The
// MsgSelectPier handler consults this to verify the selecting Guild
// exists before persisting the Pier selection. A false return REJECTS
// the selection (the Guild does not exist).
GetGuild(guildID string) (exists bool)
}
+246
View File
@@ -0,0 +1,246 @@
package types
// msg_billofrights.go holds the v0.7 P5 Anti-Capture Bill of Rights ceremony
// + Pier Selection Msg* types (REQ-056, REQ-066; vision §8.2, §15).
// G-006 controlled exception: types/ gains the cosmos-sdk import for sdk.Msg
// (mirrors msg_charter.go — D-055; the invariant/lexicon tests in *_test.go
// stay stdlib-only per G-024, isolated from this msg_*.go file).
//
// The three P5 Msg types drive the Anti-Capture Bill of Rights ceremony +
// Pier Selection runtime:
// - MsgCounselReviewBillOfRights: the §7 acceptance ceremony — the bonded
// Counsel records a review of the Anti-Capture Bill of Rights. The
// handler requires Staked=true (the Counsel's Standing bond is staked —
// "bonded Counsel" per §7 acceptance) + records the review result.
// - MsgSelectPier: a Guild Council chooses a Pier at formation (REQ-066).
// The handler persists a PierSelectionRecord (keyed by GuildID) + creates
// or updates the PierSelectionIndex entry for the PierID. The handler
// checks the Guild exists via the GuildKeeper shim (a nil shim skips).
// - MsgRevokePierSelection: a Cover Pool supermajority + Counsel witness
// revoke a Guild's Pier selection. The handler requires
// RevocationApproved=true + a non-empty CounselWitness; otherwise REJECT.
//
// All cross-module refs are by-ID-string (G-003). The GuildID is an opaque
// string referencing an x/guild Guild; the PierID is an opaque string
// referencing a Pier; the CounselReachID is an opaque string referencing an
// x/standing holder.
//
// Lexicon note (REQ-012, D-088): "Bill of Rights", "Counsel Review", "Pier
// Selection", "Counsel", "Witness", "Staked" are lexicon-clean. The four
// Cover-specific banned terms NEVER appear (enforced by lexicon_meta_cover).
import (
"fmt"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgCounselReviewBillOfRights ---------------------------------------------
// MsgCounselReviewBillOfRights is the §7 acceptance ceremony: the bonded
// Counsel records a review of the Anti-Capture Bill of Rights (REQ-056,
// vision §7, §8.2). The handler requires Staked=true (the Counsel's
// Standing bond is staked — "bonded Counsel" per §7 acceptance — the
// review is recorded by a bonded Counsel, not an unbonded one). The handler
// persists the review result (a bill_review/ store: ReviewID -> review
// record) + emits cover.bill_of_rights_reviewed.
//
// ValidateBasic is stateless: non-empty fields + Staked must be true (a
// review by an unbonded Counsel is REJECTED at ValidateBasic — defense in
// depth; the handler also re-checks).
type MsgCounselReviewBillOfRights struct {
ReviewID string `json:"review_id" yaml:"review_id"`
CounselReachID string `json:"counsel_reach_id" yaml:"counsel_reach_id"`
Staked bool `json:"staked" yaml:"staked"`
ReviewResult string `json:"review_result" yaml:"review_result"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgCounselReviewBillOfRights) Reset() { *m = MsgCounselReviewBillOfRights{} }
// String implements proto.Message.
func (m *MsgCounselReviewBillOfRights) String() string {
return fmt.Sprintf("MsgCounselReviewBillOfRights{ReviewID:%s CounselReachID:%s Staked:%v ReviewResult:%s Signer:%s}",
m.ReviewID, m.CounselReachID, m.Staked, m.ReviewResult, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgCounselReviewBillOfRights) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields + Staked must
// be true (the §7 "bonded Counsel" acceptance criterion — a review by an
// unbonded Counsel is REJECTED). This is the ceremony gate (the dual
// firewall is in msg_charter.go: the ValidateBasic gate on
// MsgSignCoverCharter rejects any WaivedRights element; this ceremony is
// the §7 acceptance on top of that firewall).
func (m *MsgCounselReviewBillOfRights) ValidateBasic() error {
if m.ReviewID == "" {
return fmt.Errorf("cover: empty review-id")
}
if m.CounselReachID == "" {
return fmt.Errorf("cover: empty counsel-reach-id")
}
if m.ReviewResult == "" {
return fmt.Errorf("cover: empty review-result")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
if !m.Staked {
return fmt.Errorf("cover: REQ-056 §7 acceptance: Staked must be true (the Counsel's Standing bond is staked — bonded Counsel)")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgCounselReviewBillOfRights) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgSelectPier -------------------------------------------------------------
// MsgSelectPier is a Guild Council's selection of a Pier at formation
// (REQ-066). The handler persists a PierSelectionRecord (keyed by GuildID)
// + creates or updates the PierSelectionIndex entry for the PierID
// (accumulating scores from successive selections). The handler checks the
// Guild exists via the GuildKeeper shim (a nil shim skips the existence
// check — simtest wiring). The signer is treated as the Guild's
// FounderReach or a Council member (simtest-grade: the handler checks
// non-empty).
//
// ValidateBasic is stateless: non-empty fields.
type MsgSelectPier struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
PierID string `json:"pier_id" yaml:"pier_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgSelectPier) Reset() { *m = MsgSelectPier{} }
// String implements proto.Message.
func (m *MsgSelectPier) String() string {
return fmt.Sprintf("MsgSelectPier{GuildID:%s PierID:%s Signer:%s}",
m.GuildID, m.PierID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgSelectPier) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields.
func (m *MsgSelectPier) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("cover: empty guild-id")
}
if m.PierID == "" {
return fmt.Errorf("cover: empty pier-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgSelectPier) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgRevokePierSelection ----------------------------------------------------
// MsgRevokePierSelection revokes a Guild's Pier selection (REQ-066). The
// revocation is reversible by a Cover Pool supermajority + a Counsel
// witness: the handler requires RevocationApproved=true + a non-empty
// CounselWitness (otherwise REJECT — the revocation is not authorized).
// The handler removes the PierSelectionRecord (keyed by GuildID) + emits
// cover.pier_selection_revoked.
//
// ValidateBasic is stateless: non-empty GuildID + Signer (the
// RevocationApproved + CounselWitness checks are at the handler — they are
// authorization checks, not stateless shape checks; a simtest may exercise
// a RevocationApproved=false message to assert the handler REJECTS).
type MsgRevokePierSelection struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
RevocationApproved bool `json:"revocation_approved" yaml:"revocation_approved"`
CounselWitness string `json:"counsel_witness" yaml:"counsel_witness"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgRevokePierSelection) Reset() { *m = MsgRevokePierSelection{} }
// String implements proto.Message.
func (m *MsgRevokePierSelection) String() string {
return fmt.Sprintf("MsgRevokePierSelection{GuildID:%s RevocationApproved:%v CounselWitness:%s Signer:%s}",
m.GuildID, m.RevocationApproved, m.CounselWitness, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgRevokePierSelection) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty GuildID + Signer.
// The RevocationApproved + CounselWitness checks are at the handler
// (authorization, not stateless shape).
func (m *MsgRevokePierSelection) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("cover: empty guild-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgRevokePierSelection) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- P5 Response types --------------------------------------------------------
//
// Hand-rolled (no protobuf codegen); empty bodies — the response is the
// state mutation + event. Mirrors the P2/P4 Response types.
// MsgCounselReviewBillOfRightsResponse is the response to
// MsgCounselReviewBillOfRights.
type MsgCounselReviewBillOfRightsResponse struct{}
// Reset implements proto.Message.
func (m *MsgCounselReviewBillOfRightsResponse) Reset() {
*m = MsgCounselReviewBillOfRightsResponse{}
}
// String implements proto.Message.
func (m *MsgCounselReviewBillOfRightsResponse) String() string {
return "MsgCounselReviewBillOfRightsResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgCounselReviewBillOfRightsResponse) ProtoMessage() {}
// MsgSelectPierResponse is the response to MsgSelectPier.
type MsgSelectPierResponse struct{}
// Reset implements proto.Message.
func (m *MsgSelectPierResponse) Reset() { *m = MsgSelectPierResponse{} }
// String implements proto.Message.
func (m *MsgSelectPierResponse) String() string { return "MsgSelectPierResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgSelectPierResponse) ProtoMessage() {}
// MsgRevokePierSelectionResponse is the response to MsgRevokePierSelection.
type MsgRevokePierSelectionResponse struct{}
// Reset implements proto.Message.
func (m *MsgRevokePierSelectionResponse) Reset() { *m = MsgRevokePierSelectionResponse{} }
// String implements proto.Message.
func (m *MsgRevokePierSelectionResponse) String() string {
return "MsgRevokePierSelectionResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgRevokePierSelectionResponse) ProtoMessage() {}
+169
View File
@@ -0,0 +1,169 @@
package types
// msg_billofrights_test.go holds the P5 Msg* method coverage tests for
// x/cover/types (REQ-056, REQ-066). The P5 Msg* Reset/String/ProtoMessage/
// ValidateBasic/GetSigners methods are exercised here so the types package
// coverage is >=80%.
//
// G-024 controlled exception (mirrors msg_charter_test.go): this file
// imports cosmos-sdk for GetSigners (sdk.AccAddress) — this is a Msg-method
// test, NOT an invariant/lexicon test, so the G-024 stdlib-only constraint
// does not apply.
import (
"strings"
"testing"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgCounselReviewBillOfRights methods -------------------------------------
func TestMsgCounselReviewBillOfRightsMethods(t *testing.T) {
m := &MsgCounselReviewBillOfRights{
ReviewID: "r1",
CounselReachID: "c1",
Staked: true,
ReviewResult: "Affirmed",
Signer: "s1",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgCounselReviewBillOfRights ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "r1") {
t.Errorf("MsgCounselReviewBillOfRights String = %q, want r1", m.String())
}
m.Reset()
if m.ReviewID != "" {
t.Errorf("MsgCounselReviewBillOfRights Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgCounselReviewBillOfRights{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgCounselReviewBillOfRights GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgCounselReviewBillOfRightsValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgCounselReviewBillOfRights
}{
{"empty review-id", MsgCounselReviewBillOfRights{CounselReachID: "c", Staked: true, ReviewResult: "r", Signer: "s"}},
{"empty counsel-reach-id", MsgCounselReviewBillOfRights{ReviewID: "r", Staked: true, ReviewResult: "r", Signer: "s"}},
{"empty review-result", MsgCounselReviewBillOfRights{ReviewID: "r", CounselReachID: "c", Staked: true, Signer: "s"}},
{"empty signer", MsgCounselReviewBillOfRights{ReviewID: "r", CounselReachID: "c", Staked: true, ReviewResult: "r"}},
{"staked false", MsgCounselReviewBillOfRights{ReviewID: "r", CounselReachID: "c", Staked: false, ReviewResult: "r", Signer: "s"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- MsgSelectPier methods ----------------------------------------------------
func TestMsgSelectPierMethods(t *testing.T) {
m := &MsgSelectPier{GuildID: "g1", PierID: "p1", Signer: "s1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgSelectPier ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "g1") {
t.Errorf("MsgSelectPier String = %q, want g1", m.String())
}
m.Reset()
if m.GuildID != "" {
t.Errorf("MsgSelectPier Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgSelectPier{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgSelectPier GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgSelectPierValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgSelectPier
}{
{"empty guild-id", MsgSelectPier{PierID: "p", Signer: "s"}},
{"empty pier-id", MsgSelectPier{GuildID: "g", Signer: "s"}},
{"empty signer", MsgSelectPier{GuildID: "g", PierID: "p"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- MsgRevokePierSelection methods -------------------------------------------
func TestMsgRevokePierSelectionMethods(t *testing.T) {
m := &MsgRevokePierSelection{
GuildID: "g1",
RevocationApproved: true,
CounselWitness: "c1",
Signer: "s1",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgRevokePierSelection ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "g1") {
t.Errorf("MsgRevokePierSelection String = %q, want g1", m.String())
}
m.Reset()
if m.GuildID != "" {
t.Errorf("MsgRevokePierSelection Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgRevokePierSelection{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgRevokePierSelection GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgRevokePierSelectionValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgRevokePierSelection
}{
{"empty guild-id", MsgRevokePierSelection{RevocationApproved: true, CounselWitness: "c", Signer: "s"}},
{"empty signer", MsgRevokePierSelection{GuildID: "g", RevocationApproved: true, CounselWitness: "c"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- P5 Response types methods ------------------------------------------------
func TestP5ResponseTypesMethods(t *testing.T) {
r1 := &MsgCounselReviewBillOfRightsResponse{}
r1.Reset()
if !strings.Contains(r1.String(), "MsgCounselReviewBillOfRightsResponse") {
t.Errorf("MsgCounselReviewBillOfRightsResponse String = %q", r1.String())
}
r1.ProtoMessage()
r2 := &MsgSelectPierResponse{}
r2.Reset()
if !strings.Contains(r2.String(), "MsgSelectPierResponse") {
t.Errorf("MsgSelectPierResponse String = %q", r2.String())
}
r2.ProtoMessage()
r3 := &MsgRevokePierSelectionResponse{}
r3.Reset()
if !strings.Contains(r3.String(), "MsgRevokePierSelectionResponse") {
t.Errorf("MsgRevokePierSelectionResponse String = %q", r3.String())
}
r3.ProtoMessage()
}
+462
View File
@@ -0,0 +1,462 @@
package types
// msg_charter.go holds the P2 Cover-Charter + Pool-Council + Cover-Call-Vote
// Msg* types (REQ-052, REQ-062, REQ-056, REQ-048, D-090(1), D-090(3)). The
// P1 Msg* types live in msg_cover.go; this file is the P2 extension
// (separated for file-hygiene — the P1 file is already at ~280 lines).
//
// G-006 controlled exception: this file gains the cosmos-sdk import for
// sdk.Msg (mirrors msg_cover.go — D-055; the invariant/lexicon tests in
// *_test.go stay stdlib-only per G-024, isolated from this msg_*.go file).
//
// The six P2 Msg types drive the Cover-Charter + Pool Council + Cover Call
// Vote runtime:
// - MsgSignCoverCharter: sign a Cover-Charter (the handler enforces the
// D-090(1) Bill of Rights gate at ValidateBasic: any WaivedRights
// element REJECTS the signing; persists the CoverCharter + Watcher
// attests the witness hash).
// - MsgAmendCoverCharter: file a Charter amendment (the handler creates a
// CharterAmendment with Status=AmendmentProposed; a separate ratify
// handler / simtest time-advance transitions it to Cooled then
// Ratified after the 7-day cooling).
// - MsgElectPoolMason: elect a Mason to the Pool Council (the handler
// adds the MasonReachID to ElectedMasonReachIDs, max 3 — a 4th is
// REJECTED).
// - MsgVoteCoverCall: vote on a Cover Call (the handler enforces the
// Watcher-observer-present check for a CallVoteYes — REQ-062).
// - MsgAmendPoolStandingGate: amend a Pool's Standing gate (D-090(3) dual
// check: ValidateBasic rejects NewGate < CoverStandingGateTrusted; the
// handler re-checks in defense in depth).
// - MsgEscalateReserveCeiling: escalate a Pool's reserve target to the
// CoverReserveCeilingAnnualContribX (REQ-048 — the handler enforces
// the 12-month age check: now - pool.CreatedAt >= 365 days).
//
// All cross-module refs are by-ID-string (G-003). The WaivedRights field
// on MsgSignCoverCharter is []RightID (the RightID type from rights.go) so
// the D-090(1) gate can type-check it.
//
// Lexicon note (REQ-012, D-088): the message names + field names use the
// safe Cover vocabulary EXCLUSIVELY. "Cover-Charter", "Pool Council",
// "Cover Call Vote", "Charter Amendment" are the clean names; the four
// Cover-specific banned terms NEVER appear (enforced by lexicon_meta_cover).
import (
"fmt"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgSignCoverCharter ------------------------------------------------------
// MsgSignCoverCharter signs a Cover-Charter for a Pool (REQ-052, REQ-056,
// D-090(1)). The handler enforces:
// - D-090(1) Bill of Rights gate at ValidateBasic: len(WaivedRights) > 0
// -> REJECT with "REQ-056: rights non-amendable, non-waivable by any
// Charter". This is the dual-firewall runtime gate (mirrors
// MissionLockAmendmentRejected at ValidateBasic in x/council).
// - Idempotency: CharterID must not already exist.
// - WatcherKeeper.Attest on the charter witness hash (a nil WatcherKeeper
// skips).
// - Persist the CoverCharter + emit cover.charter_signed.
//
// ValidateBasic is stateless: non-empty fields + the D-090(1) WaivedRights
// gate. The WaivedRights field is []RightID (the RightID type from
// rights.go) so the gate can type-check it; the gate rejects any non-empty
// slice (the 13 rights are non-waivable by any Charter).
type MsgSignCoverCharter struct {
CharterID string `json:"charter_id" yaml:"charter_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
StatementOfBeliefsHash []byte `json:"statement_of_beliefs_hash" yaml:"statement_of_beliefs_hash"`
DisputePath string `json:"dispute_path" yaml:"dispute_path"`
Gate string `json:"gate" yaml:"gate"`
HoldingPeriodDays uint32 `json:"holding_period_days" yaml:"holding_period_days"`
HostReachID string `json:"host_reach_id" yaml:"host_reach_id"`
WatcherWitnessHash []byte `json:"watcher_witness_hash" yaml:"watcher_witness_hash"`
WaivedRights []RightID `json:"waived_rights" yaml:"waived_rights"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgSignCoverCharter) Reset() { *m = MsgSignCoverCharter{} }
// String implements proto.Message.
func (m *MsgSignCoverCharter) String() string {
return fmt.Sprintf("MsgSignCoverCharter{CharterID:%s PoolID:%s HostReachID:%s Gate:%s HoldingPeriodDays:%d WaivedRights:%v Signer:%s}",
m.CharterID, m.PoolID, m.HostReachID, m.Gate, m.HoldingPeriodDays, m.WaivedRights, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgSignCoverCharter) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields + the
// D-090(1) Bill of Rights gate. The gate rejects any non-empty WaivedRights
// slice (the 13 rights are non-amendable, non-waivable by any Charter —
// REQ-056, vision §8.2). This is the dual-firewall runtime gate (mirrors
// MissionLockAmendmentRejected at ValidateBasic in x/council — D-064).
func (m *MsgSignCoverCharter) ValidateBasic() error {
if m.CharterID == "" {
return fmt.Errorf("cover: empty charter-id")
}
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.HostReachID == "" {
return fmt.Errorf("cover: empty host-reach-id")
}
if m.DisputePath == "" {
return fmt.Errorf("cover: empty dispute-path")
}
if m.Gate == "" {
return fmt.Errorf("cover: empty gate")
}
if m.HoldingPeriodDays == 0 {
return fmt.Errorf("cover: empty holding-period-days")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
// D-090(1) Bill of Rights gate: the 13 rights are non-amendable,
// non-waivable by any Charter (REQ-056, vision §8.2). Any WaivedRights
// element REJECTS the signing. This is the dual-firewall runtime gate
// (the const firewall is the 13 Waivable* consts all false +
// RightIsWaivable() always false; this gate is the runtime rejection).
// Mirrors MissionLockAmendmentRejected at ValidateBasic in x/council
// (D-064).
if len(m.WaivedRights) > 0 {
return fmt.Errorf("cover: REQ-056: rights non-amendable, non-waivable by any Charter (WaivedRights=%v)", m.WaivedRights)
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgSignCoverCharter) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgAmendCoverCharter -----------------------------------------------------
// MsgAmendCoverCharter files a Charter amendment (REQ-052). The handler
// creates a CharterAmendment with Status=AmendmentProposed, ProposedAt=now.
// After the 7-day cooling (CharterAmendmentCoolingSeconds), a separate
// ratify handler (or simtest time-advance) transitions it to Cooled then
// Ratified. The cooling is the Anti-Capture Bill of Rights RightCooling
// enforcement.
//
// ValidateBasic is stateless: non-empty fields.
type MsgAmendCoverCharter struct {
CharterID string `json:"charter_id" yaml:"charter_id"`
AmendmentID string `json:"amendment_id" yaml:"amendment_id"`
Description string `json:"description" yaml:"description"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgAmendCoverCharter) Reset() { *m = MsgAmendCoverCharter{} }
// String implements proto.Message.
func (m *MsgAmendCoverCharter) String() string {
return fmt.Sprintf("MsgAmendCoverCharter{CharterID:%s AmendmentID:%s Signer:%s}",
m.CharterID, m.AmendmentID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgAmendCoverCharter) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields.
func (m *MsgAmendCoverCharter) ValidateBasic() error {
if m.CharterID == "" {
return fmt.Errorf("cover: empty charter-id")
}
if m.AmendmentID == "" {
return fmt.Errorf("cover: empty amendment-id")
}
if m.Description == "" {
return fmt.Errorf("cover: empty description")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgAmendCoverCharter) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgElectPoolMason --------------------------------------------------------
// MsgElectPoolMason elects a Mason to the Pool Council (REQ-062). The
// handler loads or creates the PoolCouncil, adds the MasonReachID to
// ElectedMasonReachIDs (max 3 — a 4th is REJECTED), and persists.
//
// ValidateBasic is stateless: non-empty fields.
type MsgElectPoolMason struct {
PoolID string `json:"pool_id" yaml:"pool_id"`
MasonReachID string `json:"mason_reach_id" yaml:"mason_reach_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgElectPoolMason) Reset() { *m = MsgElectPoolMason{} }
// String implements proto.Message.
func (m *MsgElectPoolMason) String() string {
return fmt.Sprintf("MsgElectPoolMason{PoolID:%s MasonReachID:%s Signer:%s}",
m.PoolID, m.MasonReachID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgElectPoolMason) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields.
func (m *MsgElectPoolMason) ValidateBasic() error {
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.MasonReachID == "" {
return fmt.Errorf("cover: empty mason-reach-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgElectPoolMason) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgVoteCoverCall ---------------------------------------------------------
// MsgVoteCoverCall votes on a Cover Call (REQ-062). The handler enforces:
// - the CoverCall exists.
// - the Watcher-observer-present check: if VoteOption == CallVoteYes and
// WatcherObserverPresent == false, REJECT (majority requires observer
// present — REQ-062).
// - persist the CoverCallVote + emit cover.cover_call_voted.
//
// ValidateBasic is stateless: non-empty fields + valid VoteOption.
type MsgVoteCoverCall struct {
VoteID string `json:"vote_id" yaml:"vote_id"`
CallID string `json:"call_id" yaml:"call_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
VoterReachID string `json:"voter_reach_id" yaml:"voter_reach_id"`
VoteOption CallVoteOption `json:"vote_option" yaml:"vote_option"`
WatcherObserverPresent bool `json:"watcher_observer_present" yaml:"watcher_observer_present"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgVoteCoverCall) Reset() { *m = MsgVoteCoverCall{} }
// String implements proto.Message.
func (m *MsgVoteCoverCall) String() string {
return fmt.Sprintf("MsgVoteCoverCall{VoteID:%s CallID:%s PoolID:%s VoterReachID:%s VoteOption:%s WatcherObserverPresent:%v Signer:%s}",
m.VoteID, m.CallID, m.PoolID, m.VoterReachID, m.VoteOption, m.WatcherObserverPresent, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgVoteCoverCall) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields + valid
// VoteOption.
func (m *MsgVoteCoverCall) ValidateBasic() error {
if m.VoteID == "" {
return fmt.Errorf("cover: empty vote-id")
}
if m.CallID == "" {
return fmt.Errorf("cover: empty call-id")
}
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.VoterReachID == "" {
return fmt.Errorf("cover: empty voter-reach-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
if !knownCallVoteOption(m.VoteOption) {
return fmt.Errorf("cover: unknown vote-option %q", m.VoteOption)
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgVoteCoverCall) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgAmendPoolStandingGate -------------------------------------------------
// MsgAmendPoolStandingGate amends a Pool's Standing gate (D-090(3)). The
// handler re-checks NewGate >= CoverStandingGateTrusted in defense in
// depth (ValidateBasic already checked — but the handler re-checks in
// case of a future Params-bypass). The gate may be TIGHTENED above the
// protocol minimum but NEVER lowered below it.
//
// ValidateBasic is the D-090(3) dual check: NewGate >=
// CoverStandingGateTrusted (a below-floor amendment is REJECTED at
// ValidateBasic, NOT just at the handler).
type MsgAmendPoolStandingGate struct {
PoolID string `json:"pool_id" yaml:"pool_id"`
NewGate float64 `json:"new_gate" yaml:"new_gate"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgAmendPoolStandingGate) Reset() { *m = MsgAmendPoolStandingGate{} }
// String implements proto.Message.
func (m *MsgAmendPoolStandingGate) String() string {
return fmt.Sprintf("MsgAmendPoolStandingGate{PoolID:%s NewGate:%.2f Signer:%s}",
m.PoolID, m.NewGate, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgAmendPoolStandingGate) ProtoMessage() {}
// ValidateBasic is the D-090(3) dual check: non-empty fields + NewGate >=
// CoverStandingGateTrusted (a below-floor amendment is REJECTED at
// ValidateBasic, NOT just at the handler — the dual firewall).
func (m *MsgAmendPoolStandingGate) ValidateBasic() error {
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
if m.NewGate < CoverStandingGateTrusted {
return fmt.Errorf("cover: NewGate %.2f < CoverStandingGateTrusted %.2f (D-090(3): a pool may tighten the gate but never lower it)", m.NewGate, CoverStandingGateTrusted)
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgAmendPoolStandingGate) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgEscalateReserveCeiling ------------------------------------------------
// MsgEscalateReserveCeiling escalates a Pool's reserve target to the
// CoverReserveCeilingAnnualContribX (REQ-048). The handler enforces the
// 12-month age check: now - pool.CreatedAt >= ReserveCeilingAgeSeconds
// (365 days). A fresh pool is REJECTED. The handler calls
// WatcherKeeper.Attest (a nil WatcherKeeper skips).
//
// ValidateBasic is stateless: non-empty fields.
type MsgEscalateReserveCeiling struct {
PoolID string `json:"pool_id" yaml:"pool_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgEscalateReserveCeiling) Reset() { *m = MsgEscalateReserveCeiling{} }
// String implements proto.Message.
func (m *MsgEscalateReserveCeiling) String() string {
return fmt.Sprintf("MsgEscalateReserveCeiling{PoolID:%s Signer:%s}", m.PoolID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgEscalateReserveCeiling) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields.
func (m *MsgEscalateReserveCeiling) ValidateBasic() error {
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgEscalateReserveCeiling) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- P2 Response types --------------------------------------------------------
//
// Hand-rolled (no protobuf codegen); empty bodies — the response is the
// state mutation + event. Mirrors the P1 Response types in msg_cover.go.
// MsgSignCoverCharterResponse is the response to MsgSignCoverCharter.
type MsgSignCoverCharterResponse struct{}
// Reset implements proto.Message.
func (m *MsgSignCoverCharterResponse) Reset() { *m = MsgSignCoverCharterResponse{} }
// String implements proto.Message.
func (m *MsgSignCoverCharterResponse) String() string { return "MsgSignCoverCharterResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgSignCoverCharterResponse) ProtoMessage() {}
// MsgAmendCoverCharterResponse is the response to MsgAmendCoverCharter.
type MsgAmendCoverCharterResponse struct{}
// Reset implements proto.Message.
func (m *MsgAmendCoverCharterResponse) Reset() { *m = MsgAmendCoverCharterResponse{} }
// String implements proto.Message.
func (m *MsgAmendCoverCharterResponse) String() string { return "MsgAmendCoverCharterResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgAmendCoverCharterResponse) ProtoMessage() {}
// MsgElectPoolMasonResponse is the response to MsgElectPoolMason.
type MsgElectPoolMasonResponse struct{}
// Reset implements proto.Message.
func (m *MsgElectPoolMasonResponse) Reset() { *m = MsgElectPoolMasonResponse{} }
// String implements proto.Message.
func (m *MsgElectPoolMasonResponse) String() string { return "MsgElectPoolMasonResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgElectPoolMasonResponse) ProtoMessage() {}
// MsgVoteCoverCallResponse is the response to MsgVoteCoverCall.
type MsgVoteCoverCallResponse struct{}
// Reset implements proto.Message.
func (m *MsgVoteCoverCallResponse) Reset() { *m = MsgVoteCoverCallResponse{} }
// String implements proto.Message.
func (m *MsgVoteCoverCallResponse) String() string { return "MsgVoteCoverCallResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgVoteCoverCallResponse) ProtoMessage() {}
// MsgAmendPoolStandingGateResponse is the response to MsgAmendPoolStandingGate.
type MsgAmendPoolStandingGateResponse struct{}
// Reset implements proto.Message.
func (m *MsgAmendPoolStandingGateResponse) Reset() { *m = MsgAmendPoolStandingGateResponse{} }
// String implements proto.Message.
func (m *MsgAmendPoolStandingGateResponse) String() string {
return "MsgAmendPoolStandingGateResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgAmendPoolStandingGateResponse) ProtoMessage() {}
// MsgEscalateReserveCeilingResponse is the response to MsgEscalateReserveCeiling.
type MsgEscalateReserveCeilingResponse struct{}
// Reset implements proto.Message.
func (m *MsgEscalateReserveCeilingResponse) Reset() { *m = MsgEscalateReserveCeilingResponse{} }
// String implements proto.Message.
func (m *MsgEscalateReserveCeilingResponse) String() string {
return "MsgEscalateReserveCeilingResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgEscalateReserveCeilingResponse) ProtoMessage() {}
+325
View File
@@ -0,0 +1,325 @@
package types
// msg_charter_test.go holds the P2 Msg* method coverage tests for
// x/cover/types (REQ-052, REQ-062, REQ-056, REQ-048, D-090(1), D-090(3)).
// The P2 Msg* Reset/String/ProtoMessage/ValidateBasic/GetSigners methods
// are exercised here so the types package coverage is >=80%.
//
// G-024 controlled exception (mirrors msg_cover_test.go): this file imports
// cosmos-sdk for GetSigners (sdk.AccAddress) — this is a Msg-method test,
// NOT an invariant/lexicon test, so the G-024 stdlib-only constraint does
// not apply.
import (
"strings"
"testing"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgSignCoverCharter methods ---------------------------------------------
func TestMsgSignCoverCharterMethods(t *testing.T) {
m := &MsgSignCoverCharter{
CharterID: "c1", PoolID: "p1", HostReachID: "h1", DisputePath: "dp",
Gate: "Trusted", HoldingPeriodDays: 30, Signer: "h1",
StatementOfBeliefsHash: []byte{1, 2},
WatcherWitnessHash: []byte{3, 4},
WaivedRights: []RightID{},
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgSignCoverCharter ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "c1") {
t.Errorf("MsgSignCoverCharter String = %q, want c1", m.String())
}
m.Reset()
if m.CharterID != "" {
t.Errorf("MsgSignCoverCharter Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgSignCoverCharter{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgSignCoverCharter GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
// TestMsgSignCoverCharterValidateBasicErrors asserts each error path,
// including the D-090(1) Bill of Rights gate (any WaivedRights element
// REJECTS the signing).
func TestMsgSignCoverCharterValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgSignCoverCharter
}{
{"empty charter-id", MsgSignCoverCharter{PoolID: "p", HostReachID: "h", DisputePath: "dp", Gate: "g", HoldingPeriodDays: 30, Signer: "s"}},
{"empty pool-id", MsgSignCoverCharter{CharterID: "c", HostReachID: "h", DisputePath: "dp", Gate: "g", HoldingPeriodDays: 30, Signer: "s"}},
{"empty host-reach-id", MsgSignCoverCharter{CharterID: "c", PoolID: "p", DisputePath: "dp", Gate: "g", HoldingPeriodDays: 30, Signer: "s"}},
{"empty dispute-path", MsgSignCoverCharter{CharterID: "c", PoolID: "p", HostReachID: "h", Gate: "g", HoldingPeriodDays: 30, Signer: "s"}},
{"empty gate", MsgSignCoverCharter{CharterID: "c", PoolID: "p", HostReachID: "h", DisputePath: "dp", HoldingPeriodDays: 30, Signer: "s"}},
{"zero holding-period-days", MsgSignCoverCharter{CharterID: "c", PoolID: "p", HostReachID: "h", DisputePath: "dp", Gate: "g", Signer: "s"}},
{"empty signer", MsgSignCoverCharter{CharterID: "c", PoolID: "p", HostReachID: "h", DisputePath: "dp", Gate: "g", HoldingPeriodDays: 30}},
{"waived-rights non-empty (D-090(1))", MsgSignCoverCharter{CharterID: "c", PoolID: "p", HostReachID: "h", DisputePath: "dp", Gate: "g", HoldingPeriodDays: 30, Signer: "s", WaivedRights: []RightID{RightOneTapExit}}},
}
for _, c := range cases {
err := c.msg.ValidateBasic()
if err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
continue
}
// The D-090(1) case must mention REQ-056.
if c.name == "waived-rights non-empty (D-090(1))" && !strings.Contains(err.Error(), "REQ-056") {
t.Errorf("case %q: error = %q, want 'REQ-056'", c.name, err.Error())
}
}
}
// --- MsgAmendCoverCharter methods --------------------------------------------
func TestMsgAmendCoverCharterMethods(t *testing.T) {
m := &MsgAmendCoverCharter{CharterID: "c1", AmendmentID: "a1", Description: "d", Signer: "h1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgAmendCoverCharter ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "a1") {
t.Errorf("MsgAmendCoverCharter String = %q, want a1", m.String())
}
m.Reset()
if m.CharterID != "" {
t.Errorf("MsgAmendCoverCharter Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgAmendCoverCharter{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgAmendCoverCharter GetSigners = %v", got)
}
}
func TestMsgAmendCoverCharterValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgAmendCoverCharter
}{
{"empty charter-id", MsgAmendCoverCharter{AmendmentID: "a", Description: "d", Signer: "s"}},
{"empty amendment-id", MsgAmendCoverCharter{CharterID: "c", Description: "d", Signer: "s"}},
{"empty description", MsgAmendCoverCharter{CharterID: "c", AmendmentID: "a", Signer: "s"}},
{"empty signer", MsgAmendCoverCharter{CharterID: "c", AmendmentID: "a", Description: "d"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- MsgElectPoolMason methods -----------------------------------------------
func TestMsgElectPoolMasonMethods(t *testing.T) {
m := &MsgElectPoolMason{PoolID: "p1", MasonReachID: "m1", Signer: "h1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgElectPoolMason ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "m1") {
t.Errorf("MsgElectPoolMason String = %q, want m1", m.String())
}
m.Reset()
if m.PoolID != "" {
t.Errorf("MsgElectPoolMason Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgElectPoolMason{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgElectPoolMason GetSigners = %v", got)
}
}
func TestMsgElectPoolMasonValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgElectPoolMason
}{
{"empty pool-id", MsgElectPoolMason{MasonReachID: "m", Signer: "s"}},
{"empty mason-reach-id", MsgElectPoolMason{PoolID: "p", Signer: "s"}},
{"empty signer", MsgElectPoolMason{PoolID: "p", MasonReachID: "m"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- MsgVoteCoverCall methods ------------------------------------------------
func TestMsgVoteCoverCallMethods(t *testing.T) {
m := &MsgVoteCoverCall{VoteID: "v1", CallID: "c1", PoolID: "p1", VoterReachID: "v1", VoteOption: CallVoteYes, WatcherObserverPresent: true, Signer: "h1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgVoteCoverCall ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "v1") {
t.Errorf("MsgVoteCoverCall String = %q, want v1", m.String())
}
m.Reset()
if m.VoteID != "" {
t.Errorf("MsgVoteCoverCall Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgVoteCoverCall{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgVoteCoverCall GetSigners = %v", got)
}
}
func TestMsgVoteCoverCallValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgVoteCoverCall
}{
{"empty vote-id", MsgVoteCoverCall{CallID: "c", PoolID: "p", VoterReachID: "v", VoteOption: CallVoteYes, Signer: "s"}},
{"empty call-id", MsgVoteCoverCall{VoteID: "v", PoolID: "p", VoterReachID: "v", VoteOption: CallVoteYes, Signer: "s"}},
{"empty pool-id", MsgVoteCoverCall{VoteID: "v", CallID: "c", VoterReachID: "v", VoteOption: CallVoteYes, Signer: "s"}},
{"empty voter-reach-id", MsgVoteCoverCall{VoteID: "v", CallID: "c", PoolID: "p", VoteOption: CallVoteYes, Signer: "s"}},
{"empty signer", MsgVoteCoverCall{VoteID: "v", CallID: "c", PoolID: "p", VoterReachID: "v", VoteOption: CallVoteYes}},
{"unknown vote-option", MsgVoteCoverCall{VoteID: "v", CallID: "c", PoolID: "p", VoterReachID: "v", VoteOption: CallVoteOption("Maybe"), Signer: "s"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- MsgAmendPoolStandingGate methods ----------------------------------------
func TestMsgAmendPoolStandingGateMethods(t *testing.T) {
m := &MsgAmendPoolStandingGate{PoolID: "p1", NewGate: 4.5, Signer: "h1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgAmendPoolStandingGate ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "p1") {
t.Errorf("MsgAmendPoolStandingGate String = %q, want p1", m.String())
}
m.Reset()
if m.PoolID != "" {
t.Errorf("MsgAmendPoolStandingGate Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgAmendPoolStandingGate{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgAmendPoolStandingGate GetSigners = %v", got)
}
}
// TestMsgAmendPoolStandingGateD0903BelowFloor asserts the D-090(3) dual
// check: a NewGate below CoverStandingGateTrusted (4.0) is REJECTED at
// ValidateBasic (NOT just at the handler). NewGate = 3.0 < 4.0 -> REJECT.
func TestMsgAmendPoolStandingGateD0903BelowFloor(t *testing.T) {
m := &MsgAmendPoolStandingGate{PoolID: "p", NewGate: 3.0, Signer: "s"}
err := m.ValidateBasic()
if err == nil {
t.Fatal("MsgAmendPoolStandingGate with NewGate 3.0 < 4.0 should fail ValidateBasic (D-090(3))")
}
if !strings.Contains(err.Error(), "D-090(3)") {
t.Errorf("error = %q, want 'D-090(3)'", err.Error())
}
}
func TestMsgAmendPoolStandingGateValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgAmendPoolStandingGate
}{
{"empty pool-id", MsgAmendPoolStandingGate{NewGate: 4.5, Signer: "s"}},
{"empty signer", MsgAmendPoolStandingGate{PoolID: "p", NewGate: 4.5}},
{"below floor", MsgAmendPoolStandingGate{PoolID: "p", NewGate: 3.0, Signer: "s"}},
{"below floor zero", MsgAmendPoolStandingGate{PoolID: "p", NewGate: 0, Signer: "s"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- MsgEscalateReserveCeiling methods ---------------------------------------
func TestMsgEscalateReserveCeilingMethods(t *testing.T) {
m := &MsgEscalateReserveCeiling{PoolID: "p1", Signer: "h1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgEscalateReserveCeiling ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "p1") {
t.Errorf("MsgEscalateReserveCeiling String = %q, want p1", m.String())
}
m.Reset()
if m.PoolID != "" {
t.Errorf("MsgEscalateReserveCeiling Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgEscalateReserveCeiling{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgEscalateReserveCeiling GetSigners = %v", got)
}
}
func TestMsgEscalateReserveCeilingValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgEscalateReserveCeiling
}{
{"empty pool-id", MsgEscalateReserveCeiling{Signer: "s"}},
{"empty signer", MsgEscalateReserveCeiling{PoolID: "p"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// --- P2 Response types methods -----------------------------------------------
func TestP2ResponseTypesMethods(t *testing.T) {
r1 := &MsgSignCoverCharterResponse{}
r1.Reset()
if !strings.Contains(r1.String(), "MsgSignCoverCharterResponse") {
t.Errorf("MsgSignCoverCharterResponse String = %q", r1.String())
}
r1.ProtoMessage()
r2 := &MsgAmendCoverCharterResponse{}
r2.Reset()
if !strings.Contains(r2.String(), "MsgAmendCoverCharterResponse") {
t.Errorf("MsgAmendCoverCharterResponse String = %q", r2.String())
}
r2.ProtoMessage()
r3 := &MsgElectPoolMasonResponse{}
r3.Reset()
if !strings.Contains(r3.String(), "MsgElectPoolMasonResponse") {
t.Errorf("MsgElectPoolMasonResponse String = %q", r3.String())
}
r3.ProtoMessage()
r4 := &MsgVoteCoverCallResponse{}
r4.Reset()
if !strings.Contains(r4.String(), "MsgVoteCoverCallResponse") {
t.Errorf("MsgVoteCoverCallResponse String = %q", r4.String())
}
r4.ProtoMessage()
r5 := &MsgAmendPoolStandingGateResponse{}
r5.Reset()
if !strings.Contains(r5.String(), "MsgAmendPoolStandingGateResponse") {
t.Errorf("MsgAmendPoolStandingGateResponse String = %q", r5.String())
}
r5.ProtoMessage()
r6 := &MsgEscalateReserveCeilingResponse{}
r6.Reset()
if !strings.Contains(r6.String(), "MsgEscalateReserveCeilingResponse") {
t.Errorf("MsgEscalateReserveCeilingResponse String = %q", r6.String())
}
r6.ProtoMessage()
}
+22
View File
@@ -229,10 +229,32 @@ func (m *MsgFileCoverCall) GetSigners() []sdk.AccAddress {
// Msg*). The keeper's msg_server.go implements this; module.go's
// RegisterServices wires the implementation. Hand-rolled (no protobuf
// codegen per the skeleton's zero-codegen style).
//
// P2 extension (REQ-052, REQ-062, REQ-056, REQ-048): the six new methods
// (SignCoverCharter, AmendCoverCharter, ElectPoolMason, VoteCoverCall,
// AmendPoolStandingGate, EscalateReserveCeiling) are defined in
// msg_charter.go; their Response types are defined below the interface.
type MsgServer interface {
LaunchCoverPool(ctx interface{}, msg *MsgLaunchCoverPool) (*MsgLaunchCoverPoolResponse, error)
RouteCoverFee(ctx interface{}, msg *MsgRouteCoverFee) (*MsgRouteCoverFeeResponse, error)
FileCoverCall(ctx interface{}, msg *MsgFileCoverCall) (*MsgFileCoverCallResponse, error)
SignCoverCharter(ctx interface{}, msg *MsgSignCoverCharter) (*MsgSignCoverCharterResponse, error)
AmendCoverCharter(ctx interface{}, msg *MsgAmendCoverCharter) (*MsgAmendCoverCharterResponse, error)
ElectPoolMason(ctx interface{}, msg *MsgElectPoolMason) (*MsgElectPoolMasonResponse, error)
VoteCoverCall(ctx interface{}, msg *MsgVoteCoverCall) (*MsgVoteCoverCallResponse, error)
AmendPoolStandingGate(ctx interface{}, msg *MsgAmendPoolStandingGate) (*MsgAmendPoolStandingGateResponse, error)
EscalateReserveCeiling(ctx interface{}, msg *MsgEscalateReserveCeiling) (*MsgEscalateReserveCeilingResponse, error)
// v0.7 P4 Voucher + Dissolution handlers (REQ-055, REQ-063, D-090(2),
// FR-CPCV-2) — defined in msg_voucher.go.
RegisterCoverClaimsVoucher(ctx interface{}, msg *MsgRegisterCoverClaimsVoucher) (*MsgRegisterCoverClaimsVoucherResponse, error)
AdjudicateCoverCall(ctx interface{}, msg *MsgAdjudicateCoverCall) (*MsgAdjudicateCoverCallResponse, error)
SlashCoverClaimsVoucher(ctx interface{}, msg *MsgSlashCoverClaimsVoucher) (*MsgSlashCoverClaimsVoucherResponse, error)
DissolveCoverPool(ctx interface{}, msg *MsgDissolveCoverPool) (*MsgDissolveCoverPoolResponse, error)
// v0.7 P5 Anti-Capture Bill of Rights ceremony + Pier Selection handlers
// (REQ-056, REQ-066) — defined in msg_billofrights.go.
CounselReviewBillOfRights(ctx interface{}, msg *MsgCounselReviewBillOfRights) (*MsgCounselReviewBillOfRightsResponse, error)
SelectPier(ctx interface{}, msg *MsgSelectPier) (*MsgSelectPierResponse, error)
RevokePierSelection(ctx interface{}, msg *MsgRevokePierSelection) (*MsgRevokePierSelectionResponse, error)
}
// Response types (hand-rolled; empty bodies — the response is the state
+316
View File
@@ -0,0 +1,316 @@
package types
// msg_voucher.go holds the v0.7 P4 Cover Claims Voucher + Pool Dissolution
// Msg* types (REQ-055, REQ-063, D-090(2), FR-CPCV-2; G-006 controlled
// exception: types/ gains the cosmos-sdk import for sdk.Msg — D-055; the
// invariant/lexicon tests in *_test.go stay stdlib-only per G-024, isolated
// from this msg_*.go file).
//
// The four P4 Voucher + Dissolution Msg types drive the Voucher + waterfall
// runtime:
// - MsgRegisterCoverClaimsVoucher: register a Cover Claims Voucher for a
// Pool (the handler computes the bond = max(
// CoverClaimsVoucherBondMultipleAvgCall × avgCallSize,
// MinimumVoucherBond); D-090(2) cold-start: when no Calls exist, bond =
// MinimumVoucherBond, NOT zero).
// - MsgAdjudicateCoverCall: a Voucher adjudicates a Cover Call (FR-CPCV-2
// no self-adjudication: rejects if VoucherReachID ==
// CoverCall.ClaimantReachID).
// - MsgSlashCoverClaimsVoucher: slash a Voucher for a fraudulent Cover
// Call adjudication (Reason == SlashReasonFraudulentCoverCall; the
// handler invokes StandingKeeper.RecordSlash -> the Standing bucket
// drops -> cross-Pool applicability).
// - MsgDissolveCoverPool: dissolve a Pool (the handler computes the
// PoolDissolutionWaterfall: Cover-Fee contributors > MAB > Bread
// holders — FR-MAB-4 seniority; MAB holders have NO Voice in the
// decision — REQ-063).
//
// All cross-module refs are by-ID-string (G-003). The
// SlashReasonFraudulentCoverCall const is LOCAL to x/cover (cross-documented
// to x/standing.SlashReasonFraudulentCoverCall — the two consts MUST stay in
// sync; G-003 — no struct import of x/standing/types).
//
// Lexicon note (REQ-012, D-088): "Cover Claims Voucher", "Adjudicate",
// "Waterfall", "Dissolution", "Slash" are lexicon-clean. The four Cover-
// specific banned terms NEVER appear (enforced by lexicon_meta_cover).
import (
"fmt"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgRegisterCoverClaimsVoucher -------------------------------------------
// MsgRegisterCoverClaimsVoucher registers a Cover Claims Voucher for a Pool
// (REQ-055, D-090(2)). The handler enforces:
// - ValidateBasic (stateless).
// - Idempotency: no duplicate Voucher for the same Pool (a Voucher is
// registered per-Pool; a second registration for the same
// VoucherReachID + PoolID is REJECTED).
// - Compute bond: max(CoverClaimsVoucherBondMultipleAvgCall ×
// GetAvgCallSize(poolID), MinimumVoucherBond). D-090(2) cold-start: when
// no Calls exist, GetAvgCallSize returns 0 -> bond = MinimumVoucherBond
// (NOT zero).
// - Persist the Voucher + emit cover.voucher_registered.
type MsgRegisterCoverClaimsVoucher struct {
VoucherReachID string `json:"voucher_reach_id" yaml:"voucher_reach_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgRegisterCoverClaimsVoucher) Reset() { *m = MsgRegisterCoverClaimsVoucher{} }
// String implements proto.Message.
func (m *MsgRegisterCoverClaimsVoucher) String() string {
return fmt.Sprintf("MsgRegisterCoverClaimsVoucher{VoucherReachID:%s PoolID:%s Signer:%s}",
m.VoucherReachID, m.PoolID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgRegisterCoverClaimsVoucher) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty voucher-reach-id,
// non-empty pool-id, non-empty signer.
func (m *MsgRegisterCoverClaimsVoucher) ValidateBasic() error {
if m.VoucherReachID == "" {
return fmt.Errorf("cover: empty voucher-reach-id")
}
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgRegisterCoverClaimsVoucher) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgAdjudicateCoverCall ---------------------------------------------------
// MsgAdjudicateCoverCall adjudicates a Cover Call (REQ-055, FR-CPCV-2). The
// handler enforces:
// - ValidateBasic (stateless).
// - The CoverCall must exist.
// - FR-CPCV-2 no self-adjudication: reject if VoucherReachID ==
// CoverCall.ClaimantReachID (the Voucher cannot adjudicate their own
// Call).
// - The Voucher must be registered for the Call's Pool.
// - Record the adjudication result on the CoverCall (AdjudicationResult +
// AdjudicatedBy + AdjudicatedAt). Persist. Emit cover.cover_call_adjudicated.
type MsgAdjudicateCoverCall struct {
CallID string `json:"call_id" yaml:"call_id"`
VoucherReachID string `json:"voucher_reach_id" yaml:"voucher_reach_id"`
AdjudicationResult string `json:"adjudication_result" yaml:"adjudication_result"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgAdjudicateCoverCall) Reset() { *m = MsgAdjudicateCoverCall{} }
// String implements proto.Message.
func (m *MsgAdjudicateCoverCall) String() string {
return fmt.Sprintf("MsgAdjudicateCoverCall{CallID:%s VoucherReachID:%s AdjudicationResult:%s Signer:%s}",
m.CallID, m.VoucherReachID, m.AdjudicationResult, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgAdjudicateCoverCall) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty call-id, non-empty
// voucher-reach-id, non-empty adjudication-result, non-empty signer.
func (m *MsgAdjudicateCoverCall) ValidateBasic() error {
if m.CallID == "" {
return fmt.Errorf("cover: empty call-id")
}
if m.VoucherReachID == "" {
return fmt.Errorf("cover: empty voucher-reach-id")
}
if m.AdjudicationResult == "" {
return fmt.Errorf("cover: empty adjudication-result")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgAdjudicateCoverCall) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgSlashCoverClaimsVoucher -----------------------------------------------
// MsgSlashCoverClaimsVoucher slashes a Cover Claims Voucher for a fraudulent
// Cover Call adjudication (REQ-055). The handler enforces:
// - ValidateBasic (stateless — Reason must == SlashReasonFraudulentCoverCall).
// - The Voucher must exist.
// - Invoke StandingKeeper.RecordSlash(voucherReachID, amount, reason,
// attester) — the slash drops the Voucher's Standing bucket (cross-Pool
// applicability — the bucket drop disqualifies them from other Pools'
// Standing gates). A nil StandingKeeper is a wiring error -> REJECT.
// - Emit cover.voucher_slashed.
type MsgSlashCoverClaimsVoucher struct {
VoucherReachID string `json:"voucher_reach_id" yaml:"voucher_reach_id"`
CallID string `json:"call_id" yaml:"call_id"`
Reason string `json:"reason" yaml:"reason"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgSlashCoverClaimsVoucher) Reset() { *m = MsgSlashCoverClaimsVoucher{} }
// String implements proto.Message.
func (m *MsgSlashCoverClaimsVoucher) String() string {
return fmt.Sprintf("MsgSlashCoverClaimsVoucher{VoucherReachID:%s CallID:%s Reason:%s Signer:%s}",
m.VoucherReachID, m.CallID, m.Reason, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgSlashCoverClaimsVoucher) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields + Reason ==
// SlashReasonFraudulentCoverCall (the slash reason const — cross-documented
// to x/standing.SlashReasonFraudulentCoverCall; LOCAL to x/cover to avoid
// importing x/standing — G-003).
func (m *MsgSlashCoverClaimsVoucher) ValidateBasic() error {
if m.VoucherReachID == "" {
return fmt.Errorf("cover: empty voucher-reach-id")
}
if m.CallID == "" {
return fmt.Errorf("cover: empty call-id")
}
if m.Reason == "" {
return fmt.Errorf("cover: empty reason")
}
if m.Reason != SlashReasonFraudulentCoverCall {
return fmt.Errorf("cover: slash reason %q != %q (REQ-055 — only FraudulentCoverCall is a valid Voucher slash reason)", m.Reason, SlashReasonFraudulentCoverCall)
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgSlashCoverClaimsVoucher) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgDissolveCoverPool -----------------------------------------------------
// MsgDissolveCoverPool dissolves a Cover Pool (REQ-063, FR-MAB-4). The
// handler enforces:
// - ValidateBasic (stateless).
// - The Pool must exist.
// - Compute the PoolDissolutionWaterfall: Tier 1 = Cover-Fee contributors
// (the Pool's reserve), Tier 2 = MAB holders (query BondKeeper for MABs
// on this Pool — outstanding principal), Tier 3 = Bread holders (the
// remainder). MAB holders have NO Voice in the dissolution decision
// (REQ-063 — the PoolCouncil from P2 already excludes them; the
// waterfall only determines the payout order).
// - Emit cover.pool_dissolved with the waterfall tiers.
type MsgDissolveCoverPool struct {
PoolID string `json:"pool_id" yaml:"pool_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgDissolveCoverPool) Reset() { *m = MsgDissolveCoverPool{} }
// String implements proto.Message.
func (m *MsgDissolveCoverPool) String() string {
return fmt.Sprintf("MsgDissolveCoverPool{PoolID:%s Signer:%s}", m.PoolID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgDissolveCoverPool) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty pool-id, non-empty
// signer.
func (m *MsgDissolveCoverPool) ValidateBasic() error {
if m.PoolID == "" {
return fmt.Errorf("cover: empty pool-id")
}
if m.Signer == "" {
return fmt.Errorf("cover: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgDissolveCoverPool) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- P4 Voucher + Dissolution Response types ----------------------------------
// MsgRegisterCoverClaimsVoucherResponse is the response to
// MsgRegisterCoverClaimsVoucher. BondAmount reports the computed bond (for
// simtest assertion: D-090(2) cold-start -> MinimumVoucherBond; with Calls
// -> 10× avg).
type MsgRegisterCoverClaimsVoucherResponse struct {
BondAmount int64 `json:"bond_amount" yaml:"bond_amount"`
}
// Reset implements proto.Message.
func (m *MsgRegisterCoverClaimsVoucherResponse) Reset() { *m = MsgRegisterCoverClaimsVoucherResponse{} }
// String implements proto.Message.
func (m *MsgRegisterCoverClaimsVoucherResponse) String() string {
return fmt.Sprintf("MsgRegisterCoverClaimsVoucherResponse{BondAmount:%d}", m.BondAmount)
}
// ProtoMessage implements proto.Message.
func (*MsgRegisterCoverClaimsVoucherResponse) ProtoMessage() {}
// MsgAdjudicateCoverCallResponse is the response to MsgAdjudicateCoverCall.
type MsgAdjudicateCoverCallResponse struct{}
// Reset implements proto.Message.
func (m *MsgAdjudicateCoverCallResponse) Reset() { *m = MsgAdjudicateCoverCallResponse{} }
// String implements proto.Message.
func (m *MsgAdjudicateCoverCallResponse) String() string { return "MsgAdjudicateCoverCallResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgAdjudicateCoverCallResponse) ProtoMessage() {}
// MsgSlashCoverClaimsVoucherResponse is the response to
// MsgSlashCoverClaimsVoucher.
type MsgSlashCoverClaimsVoucherResponse struct{}
// Reset implements proto.Message.
func (m *MsgSlashCoverClaimsVoucherResponse) Reset() { *m = MsgSlashCoverClaimsVoucherResponse{} }
// String implements proto.Message.
func (m *MsgSlashCoverClaimsVoucherResponse) String() string {
return "MsgSlashCoverClaimsVoucherResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgSlashCoverClaimsVoucherResponse) ProtoMessage() {}
// MsgDissolveCoverPoolResponse is the response to MsgDissolveCoverPool.
// Waterfall reports the FR-MAB-4 seniority chain tiers + amounts (for
// simtest assertion: Cover-Fee contributors > MAB > Bread holders).
type MsgDissolveCoverPoolResponse struct {
Waterfall []PoolDissolutionWaterfall `json:"waterfall" yaml:"waterfall"`
}
// Reset implements proto.Message.
func (m *MsgDissolveCoverPoolResponse) Reset() { *m = MsgDissolveCoverPoolResponse{} }
// String implements proto.Message.
func (m *MsgDissolveCoverPoolResponse) String() string {
return fmt.Sprintf("MsgDissolveCoverPoolResponse{Waterfall:%d tiers}", len(m.Waterfall))
}
// ProtoMessage implements proto.Message.
func (*MsgDissolveCoverPoolResponse) ProtoMessage() {}
+220
View File
@@ -0,0 +1,220 @@
package types
// rights.go holds the Anti-Capture Bill of Rights types (REQ-056, vision §8.2,
// D-090(1) temporal-gap fix). This file lands in P2 (NOT P5) so the dual
// firewall is in place BEFORE any Cover-Charter can be signed: the P2
// MsgSignCoverCharter handler rejects any WaivedRights element at
// ValidateBasic, and P5 then layers the Counsel review ceremony on top of
// these already-locked types.
//
// The 13 rights are non-amendable, non-waivable by any Charter (REQ-056,
// vision §8.2). The dual firewall mirrors the Mission-Lock firewall in
// x/council (D-064): there the firewall is MissionLockAmendable=false (the
// const) + MissionLockAmendmentRejected rejected at ValidateBasic (the gate);
// here the firewall is the 13 Waivable* consts (all false) +
// RightIsWaivable() always returns false + MsgSignCoverCharter.ValidateBasic
// rejects any WaivedRights element. A future agent flipping any const OR
// removing the ValidateBasic gate breaks the regression tests in
// rights_test.go.
//
// The Bill of Rights is the INVARIANT declaration; the Anti-Crowding-Out
// firewall (x/cover/firewall, P1) is the ENFORCEMENT mechanism for
// RightNoTaxOnPersonalStash (the firewall rejects a Cover-Fee routing
// destination that is a Root-Pool operating-expenses holder, which would
// crowd out the contributor-pool reserve — exactly what
// RightNoTaxOnPersonalStash forbids). The two layers together close the
// Anti-Capture failure mode: the right declares the invariant; the firewall
// rejects the code path that would violate it; the ValidateBasic gate
// rejects a Charter that would waive it.
//
// D-085 13th-right candidate (RightNonParticipationNoDenial, confidence
// 0.55): logged as an assumption per the P2 plan — the lead-developer
// surfaces D-085 to the PO before P2; the fallback (log the 13th right and
// proceed) is exercised here. The const AntiCaptureBillOfRightsCount = 13
// is the locked regression firewall for the count; removing or adding a
// right breaks the test.
//
// Lexicon note (REQ-012, D-088): "Right", "Charter", "Waived", "Counsel",
// "Watcher", "Freeholder", "Wayfarer", "Secession" are all lexicon-clean.
// The right identifiers use the safe Cover vocabulary EXCLUSIVELY; the four
// Cover-specific banned terms (enumerated by lexicon.CoverBannedTerms — not
// inlined here so this source stays lexicon-clean) NEVER appear in this
// file (enforced by lexicon_meta_cover).
// RightID is the identifier type for an Anti-Capture Bill of Rights right
// (REQ-056, vision §8.2). A RightID is a string enum: one of the 13 locked
// Right* consts below. The type is a string (not a uint8) so the value is
// self-documenting at the call site + in serialized state (a WaivedRights
// slice in a CoverCharter serializes the right names, not opaque integers).
type RightID string
const (
// RightOneTapExit is the right to one-tap exit a Stand (vision §8.2).
// A Stand holder may dissolve their Stand + return assets to their
// Stash with no Council vote required (the Household one-tap-exit
// handler in P3 is the enforcement). Non-waivable.
RightOneTapExit RightID = "OneTapExit"
// RightNoTaxOnPersonalStash is the right that the personal Stash is
// not taxed to fund Cover-Fee routing (vision §8.2 — the Anti-
// Crowding-Out firewall enforces this: a Cover-Fee may NEVER route
// into a Root-Pool operating-expenses holder, only into a Cover
// Pool's ReserveAccount). Non-waivable.
RightNoTaxOnPersonalStash RightID = "NoTaxOnPersonalStash"
// RightAuditableVoice is the right that Voice is auditable (vision
// §8.2 — the Voice tally is recorded + replayable; the council
// module's TallyResult is the audit record). Non-waivable.
RightAuditableVoice RightID = "AuditableVoice"
// RightCooling is the right to a cooling period before a Charter
// amendment is ratified (vision §8.2 — the 7-day Charter amendment
// cooling in P2 is the enforcement). Non-waivable.
RightCooling RightID = "Cooling"
// RightWatcherInspection is the right that a Watcher may inspect any
// Cover Pool (vision §8.2 — the Watcher attestation pipeline is the
// inspection surface). Non-waivable.
RightWatcherInspection RightID = "WatcherInspection"
// RightFreeholderVoucher is the right that a Freeholder's Vouch is
// counted (vision §8.2 — the Standing module's Vouch weight is the
// counting). Non-waivable.
RightFreeholderVoucher RightID = "FreeholderVoucher"
// RightCounselEscalation is the right to escalate to Counsel
// (vision §8.2 — the Counsel review ceremony in P5 is the escalation
// surface). Non-waivable.
RightCounselEscalation RightID = "CounselEscalation"
// RightAnchoredBreadConversion is the right that Bread conversion is
// anchored to the mission (vision §8.2 — the Bread/Grain conversion
// is mission-locked, not freely tunable). Non-waivable.
RightAnchoredBreadConversion RightID = "AnchoredBreadConversion"
// RightWayfarersRecord is the right that the Wayfarer's record is
// preserved (vision §8.2 — the Wayfarer's journey is recorded
// immutably). Non-waivable.
RightWayfarersRecord RightID = "WayfarersRecord"
// RightSecessionFoundingTerms is the right that secession terms are
// coded at founding (vision §8.2 — the SecessionTerms hash-pinned at
// Guild/Chapter creation in P3 is the enforcement; the terms are
// immutable after founding). Non-waivable.
RightSecessionFoundingTerms RightID = "SecessionFoundingTerms"
// RightNonCoverAccess is the right that non-Cover access is preserved
// (vision §8.2 — a holder's access to the mesh is not gated on Cover
// Pool participation). Non-waivable.
RightNonCoverAccess RightID = "NonCoverAccess"
// RightCategoryMismatchRefusal is the right to refuse a category
// mismatch (vision §8.2 — a Cover Call filed against a category the
// Pool does not cover is REJECTED at the handler; the holder is not
// forced to accept a mismatched Call). Non-waivable.
RightCategoryMismatchRefusal RightID = "CategoryMismatchRefusal"
// RightNonParticipationNoDenial is the D-085 13th-right candidate
// (confidence 0.55, logged as an assumption per the P2 plan): the
// right that non-participation in a Cover Pool does NOT deny mesh
// access (vision §8.2 — a holder who does not join a Cover Pool is
// not denied the mesh-level rights). Non-waivable.
RightNonParticipationNoDenial RightID = "NonParticipationNoDenial"
)
// AntiCaptureBillOfRightsCount is the LOCKED count of Anti-Capture Bill of
// Rights rights (REQ-056, vision §8.2). The 13 rights are non-amendable,
// non-waivable by any Charter. A regression here is a mission-lock breach:
// adding or removing a right breaks the locked-const test in rights_test.go.
// The count is the dual-firewall anchor: the 13 Waivable* consts below +
// RightIsWaivable() + the ValidateBasic gate all key off this count.
const AntiCaptureBillOfRightsCount = 13
// The 13 Waivable* bool consts (all false) are the first layer of the dual
// firewall: each right has a matching Waivable* const that is LOCKED false
// (a right can NEVER be waivable). The RightIsWaivable() function below is
// the second layer (it consults these consts + always returns false); the
// MsgSignCoverCharter.ValidateBasic gate is the third layer (it rejects any
// WaivedRights element). A future agent flipping any const to true breaks
// the regression test. Mirrors MissionLockAmendable=false (D-064).
const (
WaivableOneTapExit = false
WaivableNoTaxOnPersonalStash = false
WaivableAuditableVoice = false
WaivableCooling = false
WaivableWatcherInspection = false
WaivableFreeholderVoucher = false
WaivableCounselEscalation = false
WaivableAnchoredBreadConversion = false
WaivableWayfarersRecord = false
WaivableSecessionFoundingTerms = false
WaivableNonCoverAccess = false
WaivableCategoryMismatchRefusal = false
WaivableNonParticipationNoDenial = false
)
// AllRights returns all 13 Anti-Capture Bill of Rights RightID values in
// canonical order (REQ-056, vision §8.2). The canonical order is the
// declaration order above (OneTapExit first, NonParticipationNoDenial last).
// The locked-const test in rights_test.go asserts exactly 13 entries with
// these names. A future agent reordering, adding, or removing a right
// breaks the test.
func AllRights() []RightID {
return []RightID{
RightOneTapExit,
RightNoTaxOnPersonalStash,
RightAuditableVoice,
RightCooling,
RightWatcherInspection,
RightFreeholderVoucher,
RightCounselEscalation,
RightAnchoredBreadConversion,
RightWayfarersRecord,
RightSecessionFoundingTerms,
RightNonCoverAccess,
RightCategoryMismatchRefusal,
RightNonParticipationNoDenial,
}
}
// AllWaivableFlags returns the 13 Waivable* bool flags keyed by RightID
// (all false — the dual-firewall regression surface). Used by the
// rights_test.go regression test to assert every flag is false. A future
// agent flipping any flag breaks the test. Mirrors the
// MissionLockAmendable=false const firewall in x/council (D-064) but
// applied per-right (13 flags instead of one).
func AllWaivableFlags() map[RightID]bool {
return map[RightID]bool{
RightOneTapExit: WaivableOneTapExit,
RightNoTaxOnPersonalStash: WaivableNoTaxOnPersonalStash,
RightAuditableVoice: WaivableAuditableVoice,
RightCooling: WaivableCooling,
RightWatcherInspection: WaivableWatcherInspection,
RightFreeholderVoucher: WaivableFreeholderVoucher,
RightCounselEscalation: WaivableCounselEscalation,
RightAnchoredBreadConversion: WaivableAnchoredBreadConversion,
RightWayfarersRecord: WaivableWayfarersRecord,
RightSecessionFoundingTerms: WaivableSecessionFoundingTerms,
RightNonCoverAccess: WaivableNonCoverAccess,
RightCategoryMismatchRefusal: WaivableCategoryMismatchRefusal,
RightNonParticipationNoDenial: WaivableNonParticipationNoDenial,
}
}
// RightIsWaivable reports whether the named right is waivable by a Charter
// (REQ-056, vision §8.2). ALWAYS returns false — the 13 rights are non-
// waivable by any Charter. This is the firewall function: the
// MsgSignCoverCharter.ValidateBasic gate calls this (defense in depth —
// the gate also checks len(WaivedRights) > 0 directly, but this function
// is the canonical query for any future call site that asks "is this right
// waivable?"). A future agent changing the return to true breaks the
// regression test. Mirrors the MissionLockAmendable=false const firewall
// in x/council (D-064): there the const is the firewall; here the function
// is the firewall (consulting the 13 Waivable* consts, all false).
func RightIsWaivable(id RightID) bool {
flags := AllWaivableFlags()
if waivable, ok := flags[id]; ok {
return waivable
}
return false
}
+167
View File
@@ -0,0 +1,167 @@
package types
// rights_test.go holds the Anti-Capture Bill of Rights regression tests
// (REQ-056, vision §8.2, D-090(1) temporal-gap fix).
//
// G-024: this test file stays STDLIB-ONLY (no cosmos-sdk import) — it does
// invariant + lexicon assertions, not handler logic. The handler simtest
// (x/cover/keeper/msg_server_simtest_test.go) MAY import cosmos-sdk.
//
// The regression surface:
// - AntiCaptureBillOfRightsCount == 13 (the locked count firewall).
// - All 13 Waivable* consts are false (the dual-firewall const layer).
// - RightIsWaivable returns false for all 13 rights (the firewall
// function layer).
// - AllRights returns 13 RightID values in canonical order.
// - AllWaivableFlags returns a 13-entry map, all values false.
// - RightIsWaivable returns false for an unknown RightID (defense in
// depth — an unknown right is NOT waivable by default).
import (
"testing"
)
// TestAntiCaptureBillOfRightsCount asserts the locked count of rights is
// 13 (REQ-056, vision §8.2). A regression here is a mission-lock breach:
// adding or removing a right breaks the dual-firewall anchor.
func TestAntiCaptureBillOfRightsCount(t *testing.T) {
if AntiCaptureBillOfRightsCount != 13 {
t.Errorf("AntiCaptureBillOfRightsCount = %d, want 13 (REQ-056 locked count, vision §8.2)", AntiCaptureBillOfRightsCount)
}
if len(AllRights()) != 13 {
t.Errorf("len(AllRights()) = %d, want 13 (REQ-056)", len(AllRights()))
}
if len(AllWaivableFlags()) != 13 {
t.Errorf("len(AllWaivableFlags()) = %d, want 13 (REQ-056)", len(AllWaivableFlags()))
}
}
// TestWaivableConstsAllFalse asserts all 13 Waivable* consts are false
// (the dual-firewall const layer — mirrors MissionLockAmendable=false in
// x/council, D-064). A future agent flipping any const to true breaks
// this test.
func TestWaivableConstsAllFalse(t *testing.T) {
cases := []struct {
name string
waivable bool
}{
{"WaivableOneTapExit", WaivableOneTapExit},
{"WaivableNoTaxOnPersonalStash", WaivableNoTaxOnPersonalStash},
{"WaivableAuditableVoice", WaivableAuditableVoice},
{"WaivableCooling", WaivableCooling},
{"WaivableWatcherInspection", WaivableWatcherInspection},
{"WaivableFreeholderVoucher", WaivableFreeholderVoucher},
{"WaivableCounselEscalation", WaivableCounselEscalation},
{"WaivableAnchoredBreadConversion", WaivableAnchoredBreadConversion},
{"WaivableWayfarersRecord", WaivableWayfarersRecord},
{"WaivableSecessionFoundingTerms", WaivableSecessionFoundingTerms},
{"WaivableNonCoverAccess", WaivableNonCoverAccess},
{"WaivableCategoryMismatchRefusal", WaivableCategoryMismatchRefusal},
{"WaivableNonParticipationNoDenial", WaivableNonParticipationNoDenial},
}
if len(cases) != AntiCaptureBillOfRightsCount {
t.Fatalf("test cases len = %d, want AntiCaptureBillOfRightsCount %d (a Waivable* const is missing from the test)", len(cases), AntiCaptureBillOfRightsCount)
}
for _, c := range cases {
if c.waivable {
t.Errorf("%s = true, want false (REQ-056: rights non-amendable, non-waivable by any Charter)", c.name)
}
}
}
// TestRightIsWaivableAlwaysFalse asserts RightIsWaivable returns false for
// all 13 rights + for an unknown RightID (the firewall function layer).
// A future agent changing the return to true breaks this test.
func TestRightIsWaivableAlwaysFalse(t *testing.T) {
for _, id := range AllRights() {
if RightIsWaivable(id) {
t.Errorf("RightIsWaivable(%q) = true, want false (REQ-056: rights non-waivable by any Charter)", id)
}
}
// An unknown RightID returns false (defense in depth — an unknown
// right is NOT waivable by default).
if RightIsWaivable(RightID("UnknownRight")) {
t.Error("RightIsWaivable(UnknownRight) = true, want false (unknown rights are NOT waivable)")
}
}
// TestAllRightsCanonicalOrder asserts AllRights returns the 13 rights in
// the canonical declaration order (OneTapExit first,
// NonParticipationNoDenial last). A reordering breaks the test.
func TestAllRightsCanonicalOrder(t *testing.T) {
want := []RightID{
RightOneTapExit,
RightNoTaxOnPersonalStash,
RightAuditableVoice,
RightCooling,
RightWatcherInspection,
RightFreeholderVoucher,
RightCounselEscalation,
RightAnchoredBreadConversion,
RightWayfarersRecord,
RightSecessionFoundingTerms,
RightNonCoverAccess,
RightCategoryMismatchRefusal,
RightNonParticipationNoDenial,
}
got := AllRights()
if len(got) != len(want) {
t.Fatalf("len(AllRights()) = %d, want %d", len(got), len(want))
}
for i, id := range got {
if id != want[i] {
t.Errorf("AllRights()[%d] = %q, want %q (canonical order)", i, id, want[i])
}
}
}
// TestAllWaivableFlagsAllFalse asserts AllWaivableFlags returns a 13-entry
// map with all values false. A future agent flipping a flag breaks this
// test.
func TestAllWaivableFlagsAllFalse(t *testing.T) {
flags := AllWaivableFlags()
if len(flags) != AntiCaptureBillOfRightsCount {
t.Fatalf("len(AllWaivableFlags()) = %d, want %d", len(flags), AntiCaptureBillOfRightsCount)
}
for id, waivable := range flags {
if waivable {
t.Errorf("AllWaivableFlags()[%q] = true, want false (REQ-056)", id)
}
}
// Cross-check: every right in AllRights() has an entry in
// AllWaivableFlags().
for _, id := range AllRights() {
if _, ok := flags[id]; !ok {
t.Errorf("AllWaivableFlags() missing entry for right %q", id)
}
}
}
// TestRightIDValues asserts the 13 RightID string values are the expected
// canonical strings (a regression on the string value would break
// serialized state compatibility).
func TestRightIDValues(t *testing.T) {
cases := []struct {
id RightID
want string
}{
{RightOneTapExit, "OneTapExit"},
{RightNoTaxOnPersonalStash, "NoTaxOnPersonalStash"},
{RightAuditableVoice, "AuditableVoice"},
{RightCooling, "Cooling"},
{RightWatcherInspection, "WatcherInspection"},
{RightFreeholderVoucher, "FreeholderVoucher"},
{RightCounselEscalation, "CounselEscalation"},
{RightAnchoredBreadConversion, "AnchoredBreadConversion"},
{RightWayfarersRecord, "WayfarersRecord"},
{RightSecessionFoundingTerms, "SecessionFoundingTerms"},
{RightNonCoverAccess, "NonCoverAccess"},
{RightCategoryMismatchRefusal, "CategoryMismatchRefusal"},
{RightNonParticipationNoDenial, "NonParticipationNoDenial"},
}
for _, c := range cases {
if string(c.id) != c.want {
t.Errorf("RightID(%q) value = %q, want %q", c.id, c.id, c.want)
}
}
}
+350 -10
View File
@@ -86,6 +86,35 @@ const (
// (the gate const mirrors the bucket boundary). LOCAL to x/cover for
// the same G-003 reason as CoverStandingGateTrusted.
CoverStandingGatePreferred = 4.5
// CoverClaimsVoucherBondMultipleAvgCall is the bond multiple for a Cover
// Claims Voucher: the Voucher's bond is
// max(CoverClaimsVoucherBondMultipleAvgCall × avgCallSize,
// MinimumVoucherBond) where avgCallSize is the average Cover Call
// amount for the Pool (REQ-055). The const is NOT locked (it can be
// tuned by governance); the D-090(2) cold-start fix uses the
// MinimumVoucherBond Params field as the non-zero fallback when no
// Calls have been filed (avg = 0 -> bond = MinimumVoucherBond, NOT
// zero).
CoverClaimsVoucherBondMultipleAvgCall = 10
// SlashReasonFraudulentCoverCall is the slash reason for a Cover Claims
// Voucher that adjudicated a Cover Call fraudulently (REQ-055). LOCAL
// const in x/cover to avoid importing x/standing (G-003 — no struct
// import of x/standing/types); cross-documented to
// x/standing.SlashReasonFraudulentCoverCall (the two consts MUST stay
// in sync — a change to one requires a matching change to the other;
// mirroring the LendingCouponCapBps local-const pattern in x/hub). The
// MsgSlashCoverClaimsVoucher.ValidateBasic rejects a Reason that does
// not match this const.
SlashReasonFraudulentCoverCall = "FraudulentCoverCall"
// DefaultMinimumVoucherBond is the default minimum Cover Claims Voucher
// bond (D-090(2) cold-start fix) — 1000000 Grain = 100 Bread (a non-
// zero default so a fresh Pool with no Calls filed yet still requires
// a non-zero Voucher bond). The Params.MinimumVoucherBond field is
// tunable by governance; this is the DefaultParams value.
DefaultMinimumVoucherBond int64 = 1_000_000
)
// CoverCategoryPhase enumerates the three rollout phases of the Cover
@@ -147,6 +176,13 @@ func CoverCategoryPhaseFor(cat CoverCategory) CoverCategoryPhase {
// (>= CoverStandingGateTrusted; the pool can demand a higher gate than the
// protocol minimum but never lower). FactoryAllowedPhases is the pool's
// allowed phases (P1 default = [Phase2] only per D-086).
//
// P2 extensions (REQ-052, REQ-062): CharterRef is the by-ID-string ref to
// the CoverCharter signed for this pool (empty until a Charter is signed);
// CouncilRef is the by-ID-string ref to the PoolCouncil elected for this
// pool (empty until a Council is seated). Both are by-ID-string per G-003
// (no struct import of the charter/council records — the keeper loads them
// by ID from their own stores).
type CoverPool struct {
PoolID string `json:"pool_id" yaml:"pool_id"`
HostReachID string `json:"host_reach_id" yaml:"host_reach_id"`
@@ -158,6 +194,8 @@ type CoverPool struct {
FactoryAllowedPhases []CoverCategoryPhase `json:"factory_allowed_phases" yaml:"factory_allowed_phases"`
PoolStandingGate float64 `json:"pool_standing_gate" yaml:"pool_standing_gate"`
CreatedAt int64 `json:"created_at" yaml:"created_at"`
CharterRef string `json:"charter_ref" yaml:"charter_ref"`
CouncilRef string `json:"council_ref" yaml:"council_ref"`
}
// CoverFeeTag is the category tag on a Cover-Fee routing event (REQ-050,
@@ -182,12 +220,15 @@ type CoverFeeTag struct {
// + slashing (the FileCoverCall handler in P1 only persists the call +
// emits an event).
type CoverCall struct {
CallID string `json:"call_id" yaml:"call_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
ClaimantReachID string `json:"claimant_reach_id" yaml:"claimant_reach_id"`
Category CoverCategory `json:"category" yaml:"category"`
AmountGrain int64 `json:"amount_grain" yaml:"amount_grain"`
FiledAt int64 `json:"filed_at" yaml:"filed_at"`
CallID string `json:"call_id" yaml:"call_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
ClaimantReachID string `json:"claimant_reach_id" yaml:"claimant_reach_id"`
Category CoverCategory `json:"category" yaml:"category"`
AmountGrain int64 `json:"amount_grain" yaml:"amount_grain"`
FiledAt int64 `json:"filed_at" yaml:"filed_at"`
AdjudicationResult string `json:"adjudication_result" yaml:"adjudication_result"`
AdjudicatedBy string `json:"adjudicated_by" yaml:"adjudicated_by"`
AdjudicatedAt int64 `json:"adjudicated_at" yaml:"adjudicated_at"`
}
// Params for the cover module (REQ-049, D-086). FactoryAllowedPhases is the
@@ -200,15 +241,29 @@ type CoverCall struct {
type Params struct {
FactoryAllowedPhases []CoverCategoryPhase `json:"factory_allowed_phases" yaml:"factory_allowed_phases"`
PoolStandingGate float64 `json:"pool_standing_gate" yaml:"pool_standing_gate"`
// MinimumVoucherBond is the minimum Cover Claims Voucher bond (D-090(2)
// cold-start fix — REQ-055). The Voucher's bond is
// max(CoverClaimsVoucherBondMultipleAvgCall × avgCallSize,
// MinimumVoucherBond); the MinimumVoucherBond is the non-zero fallback
// when no Calls have been filed (avg = 0 -> bond = MinimumVoucherBond,
// NOT zero). Default = DefaultMinimumVoucherBond (1M Grain = 100
// Bread).
MinimumVoucherBond int64 `json:"minimum_voucher_bond" yaml:"minimum_voucher_bond"`
}
// DefaultParams returns the P1 default Params (D-086): FactoryAllowedPhases
// = [Phase2] ONLY (Phase3/Phase4 categories are REJECTED at launch in P1),
// PoolStandingGate = CoverStandingGateTrusted (the locked protocol minimum).
// DefaultParams returns the P2 default Params (D-086 P2 completion):
// FactoryAllowedPhases = [Phase2, Phase3, Phase4] (the P1 default was
// [Phase2] only; P2 extends the factory to all three phases so Phase3
// categories (EquipmentLoss/LifeBurial/RoadSide) and Phase4 categories
// (CyberSkimming/GuildInternalMutualAid) can be launched), PoolStandingGate
// = CoverStandingGateTrusted (the locked protocol minimum). A test that
// needs the P1 behavior (Phase2 only) overrides FactoryAllowedPhases
// explicitly (the D-086 simtest case f does this).
func DefaultParams() Params {
return Params{
FactoryAllowedPhases: []CoverCategoryPhase{Phase2},
FactoryAllowedPhases: []CoverCategoryPhase{Phase2, Phase3, Phase4},
PoolStandingGate: CoverStandingGateTrusted,
MinimumVoucherBond: DefaultMinimumVoucherBond,
}
}
@@ -309,3 +364,288 @@ func validateCalls(calls []CoverCall) error {
}
return nil
}
// --- P2: Cover-Charter + CharterAmendment + PoolCouncil + CoverCallVote -------
//
// (REQ-052, REQ-062, REQ-056; vision §15, §8.2.) The four structs below are
// the P2 governance surface. CoverCharter is the mission-locked charter a
// Pool Host signs (with the Anti-Capture Bill of Rights gate at
// MsgSignCoverCharter.ValidateBasic — D-090(1)). CharterAmendment is the
// amendment record with a 7-day cooling (the amendment stays Proposed for
// 7 days, then Cooled, then Ratified). PoolCouncil is the Pool's elected
// governance council (3 Masons + 1 Watcher observer; NO Anchor seat; NO
// MAB-holder seat — REQ-062, REQ-063). CoverCallVote is a single vote on
// a Cover Call (the majority requires a Watcher observer present for a
// CallVoteYes — REQ-062).
//
// Lexicon note (REQ-012, D-088): "Cover-Charter", "Pool Council", "Cover
// Call Vote", "Charter Amendment" are lexicon-clean. The four Cover-
// specific banned terms NEVER appear (enforced by lexicon_meta_cover).
// CharterAmendmentStatus is the lifecycle status of a CharterAmendment
// (REQ-052). The amendment transitions Proposed -> Cooled (after the 7-day
// cooling) -> Ratified (after the Pool supermajority + Watcher + Counsel).
// The cooling is enforced at the handler: a ratify attempt before 7 days
// is REJECTED.
type CharterAmendmentStatus string
const (
// AmendmentProposed is the initial status (the amendment is filed; the
// 7-day cooling clock starts at ProposedAt).
AmendmentProposed CharterAmendmentStatus = "Proposed"
// AmendmentCooled is the post-cooling status (>= 7 days after
// ProposedAt; the amendment is eligible for ratification).
AmendmentCooled CharterAmendmentStatus = "Cooled"
// AmendmentRatified is the terminal status (the Pool supermajority +
// Watcher + Counsel have ratified the amendment).
AmendmentRatified CharterAmendmentStatus = "Ratified"
)
// CharterAmendmentCoolingSeconds is the LOCKED 7-day cooling period for a
// Charter amendment (REQ-052). The amendment stays Proposed for this many
// seconds before it can be Cooled + Ratified. A regression here is a
// mission-lock breach (the cooling is the Anti-Capture Bill of Rights
// RightCooling enforcement). The handler checks `now - ProposedAt >=
// CharterAmendmentCoolingSeconds` before transitioning to Cooled.
const CharterAmendmentCoolingSeconds int64 = 7 * 24 * 60 * 60
// ReserveCeilingAgeSeconds is the LOCKED 12-month operating-history age
// required before a Watcher can escalate a pool's reserve target to the
// CoverReserveCeilingAnnualContribX (REQ-048). The handler checks
// `now - pool.CreatedAt >= ReserveCeilingAgeSeconds` before the escalation
// is permitted. A regression here is a mission-lock breach (the 12-month
// age check prevents a fresh pool from jumping to the ceiling).
const ReserveCeilingAgeSeconds int64 = 365 * 24 * 60 * 60
// CharterAmendment is a single amendment to a Cover-Charter (REQ-052).
// The amendment is filed via MsgAmendCoverCharter (Status = AmendmentProposed,
// ProposedAt = now). After the 7-day cooling (CharterAmendmentCoolingSeconds),
// a separate handler (or simtest time-advance) transitions it to
// AmendmentCooled. After the Pool supermajority + Watcher + Counsel, it
// transitions to AmendmentRatified. The cooling is the Anti-Capture Bill
// of Rights RightCooling enforcement.
type CharterAmendment struct {
AmendmentID string `json:"amendment_id" yaml:"amendment_id"`
Description string `json:"description" yaml:"description"`
Status CharterAmendmentStatus `json:"status" yaml:"status"`
ProposedAt int64 `json:"proposed_at" yaml:"proposed_at"`
CooledAt int64 `json:"cooled_at" yaml:"cooled_at"`
RatifiedAt int64 `json:"ratified_at" yaml:"ratified_at"`
}
// CoverCharter is the mission-locked charter a Pool Host signs (REQ-052,
// REQ-056). The charter is signed via MsgSignCoverCharter (the handler
// enforces the D-090(1) Bill of Rights gate at ValidateBasic: any
// WaivedRights element REJECTS the signing). The charter's
// StatementOfBeliefsHash is the hash of the charter's statement of beliefs
// (the protocol does NOT enforce the content — FR-CHTR-5). DisputePath is
// the dispute-resolution path. Gate is the pool's tightened Standing gate
// (>= CoverStandingGateTrusted). HoldingPeriodDays is the minimum holding
// period. HostReachID is the host's reach-id. WatcherWitnessHash is the
// Watcher's witness hash (the handler calls WatcherKeeper.Attest; a nil
// WatcherKeeper skips). Amendments is the amendment history. WaivedRights
// is the (ALWAYS EMPTY in a valid charter) slice of waived rights — the
// ValidateBasic gate rejects any non-empty slice.
type CoverCharter struct {
CharterID string `json:"charter_id" yaml:"charter_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
StatementOfBeliefsHash []byte `json:"statement_of_beliefs_hash" yaml:"statement_of_beliefs_hash"`
DisputePath string `json:"dispute_path" yaml:"dispute_path"`
Gate string `json:"gate" yaml:"gate"`
HoldingPeriodDays uint32 `json:"holding_period_days" yaml:"holding_period_days"`
HostReachID string `json:"host_reach_id" yaml:"host_reach_id"`
WatcherWitnessHash []byte `json:"watcher_witness_hash" yaml:"watcher_witness_hash"`
Amendments []CharterAmendment `json:"amendments" yaml:"amendments"`
WaivedRights []RightID `json:"waived_rights" yaml:"waived_rights"`
}
// PoolCouncil is the Pool's elected governance council (REQ-062). The
// council is seated via MsgElectPoolMason (the handler adds MasonReachIDs
// to the ElectedMasonReachIDs array, max 3 — a 4th is REJECTED). The
// ElectedMasonReachIDs is a fixed-size [3]string array (the three elected
// Masons; empty strings until elected). WatcherObserverReachID is the
// Watcher observer (the majority-required-with-observer check in
// VoteCoverCall: a CallVoteYes requires WatcherObserverPresent == true).
// NO Anchor seat (vision §5 — the Anchor does not sit on the Pool
// Council). NO MAB-holder seat (REQ-063 — the MAB holder is excluded from
// the Pool Council voice set; the MAB governance lands in P4 but the
// struct excludes them now).
type PoolCouncil struct {
PoolID string `json:"pool_id" yaml:"pool_id"`
HostReachID string `json:"host_reach_id" yaml:"host_reach_id"`
ElectedMasonReachIDs [3]string `json:"elected_mason_reach_ids" yaml:"elected_mason_reach_ids"`
WatcherObserverReachID string `json:"watcher_observer_reach_id" yaml:"watcher_observer_reach_id"`
}
// PoolCouncilMaxMasons is the LOCKED max number of elected Masons on a
// Pool Council (REQ-062). A 4th election is REJECTED at the handler. A
// regression here is a mission-lock breach.
const PoolCouncilMaxMasons = 3
// CallVoteOption is the vote option on a Cover Call (REQ-062). The three
// options: CallVoteYes, CallVoteNo, CallVoteAbstain. A CallVoteYes
// requires the Watcher observer to be present (WatcherObserverPresent ==
// true) at the handler — a CallVoteYes without the observer is REJECTED.
type CallVoteOption string
const (
CallVoteYes CallVoteOption = "Yes"
CallVoteNo CallVoteOption = "No"
CallVoteAbstain CallVoteOption = "Abstain"
)
// CallVoteOptionCount is the LOCKED count of CallVoteOption enum values
// (REQ-062). A regression firewall: adding/removing/renaming a
// CallVoteOption breaks this const's test.
const CallVoteOptionCount = 3
// AllCallVoteOptions returns all three CallVoteOption values in REQ-062
// order. The locked-const test asserts exactly 3 entries.
func AllCallVoteOptions() []CallVoteOption {
return []CallVoteOption{
CallVoteYes,
CallVoteNo,
CallVoteAbstain,
}
}
// knownCallVoteOption reports whether o is one of the three CallVoteOption
// values (used by MsgVoteCoverCall.ValidateBasic).
func knownCallVoteOption(o CallVoteOption) bool {
for _, oo := range AllCallVoteOptions() {
if o == oo {
return true
}
}
return false
}
// CoverCallVote is a single vote on a Cover Call (REQ-062). The vote is
// cast via MsgVoteCoverCall (the handler enforces the CoverCall exists +
// the Watcher-observer-present check for a CallVoteYes). VoterReachID is
// the voter's reach-id. VoteOption is the CallVoteOption. WatcherObserverPresent
// records whether the Watcher observer was present at the time of the vote
// (the handler rejects a CallVoteYes with WatcherObserverPresent == false).
// VotedAt is the vote timestamp (unix seconds).
type CoverCallVote struct {
VoteID string `json:"vote_id" yaml:"vote_id"`
CallID string `json:"call_id" yaml:"call_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
VoterReachID string `json:"voter_reach_id" yaml:"voter_reach_id"`
VoteOption CallVoteOption `json:"vote_option" yaml:"vote_option"`
WatcherObserverPresent bool `json:"watcher_observer_present" yaml:"watcher_observer_present"`
VotedAt int64 `json:"voted_at" yaml:"voted_at"`
}
// --- P4: Cover Claims Voucher + Pool Dissolution Waterfall (REQ-055, REQ-063) --
//
// (REQ-055, REQ-063; vision §15, §8.2.) The two structs below are the P4
// Voucher + dissolution surface. CoverClaimsVoucher is the bonded adjudicator
// a Pool Host registers to adjudicate Cover Calls (no self-adjudication per
// FR-CPCV-2; slashing via x/standing.Slash with
// SlashReasonFraudulentCoverCall for a fraudulent adjudication — cross-Pool
// applicability via the Standing bucket drop). PoolDissolutionWaterfall is
// the FR-MAB-4 seniority chain on Pool dissolution: Cover-Fee contributors
// first, MAB holders second, Bread holders third. MAB holders have NO Voice
// in the dissolution decision (REQ-063 — the PoolCouncil from P2 already
// excludes them; P4 adds the waterfall + the MsgDissolveCoverPool handler).
//
// Lexicon note (REQ-012, D-088): "Cover Claims Voucher", "Adjudicate",
// "Waterfall", "Dissolution" are lexicon-clean. The four Cover-specific
// banned terms NEVER appear (enforced by lexicon_meta_cover).
// CoverClaimsVoucher is the bonded adjudicator a Pool Host registers to
// adjudicate Cover Calls (REQ-055). VoucherReachID is the Voucher's reach-id
// (the person adjudicating; by-ID-string ref to x/standing). PoolID is the
// pool the Voucher is registered for (a Voucher is registered per-Pool; the
// no-self-adjudication check FR-CPCV-2 rejects if VoucherReachID ==
// CoverCall.ClaimantReachID). BondAmount is the Voucher's bond = max(
// CoverClaimsVoucherBondMultipleAvgCall × avgCallSize, MinimumVoucherBond)
// (D-090(2) cold-start: when no Calls exist, avg = 0 -> bond =
// MinimumVoucherBond, NOT zero). BondMultipleAvgCall is the multiple used
// (CoverClaimsVoucherBondMultipleAvgCall = 10). RegisteredAt is the
// registration timestamp.
type CoverClaimsVoucher struct {
VoucherReachID string `json:"voucher_reach_id" yaml:"voucher_reach_id"`
PoolID string `json:"pool_id" yaml:"pool_id"`
BondAmount int64 `json:"bond_amount" yaml:"bond_amount"`
BondMultipleAvgCall uint32 `json:"bond_multiple_avg_call" yaml:"bond_multiple_avg_call"`
RegisteredAt int64 `json:"registered_at" yaml:"registered_at"`
}
// PoolDissolutionWaterfall is a single tier in the FR-MAB-4 seniority chain
// on Pool dissolution (REQ-063). The waterfall pays Cover-Fee contributors
// first (Tier 1 — the Pool's reserve), MAB holders second (Tier 2 — the
// outstanding MAB principal), Bread holders third (Tier 3 — the remainder).
// MAB holders have NO Voice in the dissolution decision (REQ-063 — the
// PoolCouncil from P2 already excludes them; the waterfall only determines
// the payout order, not the vote). The keeper's PoolDissolutionWaterfall
// function returns the []PoolDissolutionWaterfall (the types package
// declares the shape; the keeper computes the amounts).
type PoolDissolutionWaterfall struct {
Tier string `json:"tier" yaml:"tier"`
AmountGrain int64 `json:"amount_grain" yaml:"amount_grain"`
}
// PoolDissolutionWaterfallTier* are the three FR-MAB-4 seniority chain tier
// names (REQ-063). The waterfall returns the tiers in this order:
// CoverFeeContributors (Tier 1), MABHolders (Tier 2), BreadHolders (Tier 3).
const (
PoolDissolutionWaterfallTierCoverFeeContributors = "CoverFeeContributors"
PoolDissolutionWaterfallTierMABHolders = "MABHolders"
PoolDissolutionWaterfallTierBreadHolders = "BreadHolders"
)
// --- P5: Pier Selection Index + Pier Selection Record (REQ-066) ----------------
//
// (REQ-066; vision §15.) The two structs below are the P5 Pier Selection
// surface. PierSelectionIndex is the mesh-maintained index of a Pier's
// scored qualities (JurisdictionalReliabilityScore + FiduciaryRecordHash +
// IntegrationQualityScore + OverallScore) — the keeper's
// GetPierSelectionIndex query returns the index for a PierID.
// PierSelectionRecord is a single Guild's persisted Pier selection
// (GuildID + PierID + SelectedAt + SelectedBy) keyed by GuildID. The
// MsgSelectPier handler persists the selection + creates or updates the
// index entry for the PierID (accumulating scores from successive
// selections). MsgRevokePierSelection removes a selection (reversible by
// Cover Pool supermajority + Counsel witness).
//
// Lexicon note (REQ-012, D-088): "Pier", "Pier Selection", "Pier Selection
// Index", "Jurisdictional Reliability", "Fiduciary Record", "Integration
// Quality" are lexicon-clean. The four Cover-specific banned terms NEVER
// appear (enforced by lexicon_meta_cover).
// PierSelectionIndex is the mesh-maintained index of a Pier's scored
// qualities (REQ-066). The keeper stores PierSelectionIndex records keyed
// by PierID; the GetPierSelectionIndex(pierID) keeper query returns the
// index. JurisdictionalReliabilityScore is the jurisdictional-reliability
// score (a float in [0,1] — the mesh's assessment of the Pier's
// jurisdictional reliability). FiduciaryRecordHash is the hash of the
// Pier's fiduciary record (the protocol does NOT parse the record — the
// hash pins it). IntegrationQualityScore is the integration-quality score
// (a float in [0,1]). OverallScore is the weighted aggregate (the keeper
// computes it as a deterministic blend of the three scores; the simtest
// asserts the aggregate is non-decreasing on successive selections).
type PierSelectionIndex struct {
PierID string `json:"pier_id" yaml:"pier_id"`
JurisdictionalReliabilityScore float64 `json:"jurisdictional_reliability_score" yaml:"jurisdictional_reliability_score"`
FiduciaryRecordHash []byte `json:"fiduciary_record_hash" yaml:"fiduciary_record_hash"`
IntegrationQualityScore float64 `json:"integration_quality_score" yaml:"integration_quality_score"`
OverallScore float64 `json:"overall_score" yaml:"overall_score"`
}
// PierSelectionRecord is a single Guild's persisted Pier selection
// (REQ-066). The keeper stores PierSelectionRecord records keyed by
// GuildID; the MsgSelectPier handler persists a record + the
// MsgRevokePierSelection handler removes it. GuildID is the selecting
// Guild's ID (by-ID-string — G-003). PierID is the selected Pier's ID
// (by-ID-string). SelectedAt is the selection timestamp (unix seconds).
// SelectedBy is the signer that recorded the selection (the Guild's
// FounderReach or a Council member — simtest-grade: the handler checks
// non-empty).
type PierSelectionRecord struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
PierID string `json:"pier_id" yaml:"pier_id"`
SelectedAt int64 `json:"selected_at" yaml:"selected_at"`
SelectedBy string `json:"selected_by" yaml:"selected_by"`
}
+295 -6
View File
@@ -81,16 +81,23 @@ func TestCoverCategoryPhaseFor(t *testing.T) {
// --- DefaultParams (D-086) --------------------------------------------------
// TestDefaultParamsFactoryAllowedPhases asserts DefaultParams ships
// FactoryAllowedPhases = [Phase2] ONLY (D-086 — P1 allows Phase2 only;
// Phase3/Phase4 categories are REJECTED at launch in P1) and
// FactoryAllowedPhases = [Phase2, Phase3, Phase4] (D-086 P2 completion —
// P1 allowed Phase2 only; P2 extends the factory to all three phases so
// Phase3 categories (EquipmentLoss/LifeBurial/RoadSide) and Phase4
// categories (CyberSkimming/GuildInternalMutualAid) can be launched) and
// PoolStandingGate = CoverStandingGateTrusted (the locked protocol minimum).
// A test that needs the P1 behavior (Phase2 only) overrides
// FactoryAllowedPhases explicitly.
func TestDefaultParamsFactoryAllowedPhases(t *testing.T) {
p := DefaultParams()
if len(p.FactoryAllowedPhases) != 1 {
t.Fatalf("DefaultParams FactoryAllowedPhases len = %d, want 1 (D-086: P1 allows Phase2 only)", len(p.FactoryAllowedPhases))
if len(p.FactoryAllowedPhases) != 3 {
t.Fatalf("DefaultParams FactoryAllowedPhases len = %d, want 3 (D-086 P2: [Phase2, Phase3, Phase4])", len(p.FactoryAllowedPhases))
}
if p.FactoryAllowedPhases[0] != Phase2 {
t.Errorf("DefaultParams FactoryAllowedPhases[0] = %q, want Phase2 (D-086)", p.FactoryAllowedPhases[0])
want := []CoverCategoryPhase{Phase2, Phase3, Phase4}
for i, ph := range p.FactoryAllowedPhases {
if ph != want[i] {
t.Errorf("DefaultParams FactoryAllowedPhases[%d] = %q, want %q (D-086 P2)", i, ph, want[i])
}
}
if p.PoolStandingGate != CoverStandingGateTrusted {
t.Errorf("DefaultParams PoolStandingGate = %.2f, want %.2f (CoverStandingGateTrusted)", p.PoolStandingGate, CoverStandingGateTrusted)
@@ -214,6 +221,17 @@ func TestLexiconNoBannedTermsInCover(t *testing.T) {
return err
}
if info.IsDir() {
// Skip the lexicon_meta_cover walk-coverage fixture dir
// (G-013): TestLexiconMetaCoverWalkCoverage creates
// x/cover/.lexicon_fixture/ with synthetic banned-term .go
// files. Those fixtures are test artifacts, NOT production
// code; skip the dir to avoid a cross-package test-isolation
// race (the fixture is created + cleaned up by the
// lexicon_meta_cover package, which runs concurrently with
// this package).
if info.Name() == ".lexicon_fixture" {
return filepath.SkipDir
}
return nil
}
if !strings.HasSuffix(path, ".go") {
@@ -266,3 +284,274 @@ func TestGenesisStateProtoMessage(t *testing.T) {
}
m.ProtoMessage() // no-op, just cover
}
// --- P2 consts (REQ-052, REQ-062, REQ-048, D-086) ----------------------------
// TestP2LockedConsts asserts the P2 locked consts hold their locked values
// (REQ-052 cooling, REQ-062 council max + vote options, REQ-048 reserve
// ceiling age). A regression here is a mission-lock breach.
func TestP2LockedConsts(t *testing.T) {
// REQ-052: 7-day Charter amendment cooling.
if CharterAmendmentCoolingSeconds != 7*24*60*60 {
t.Errorf("CharterAmendmentCoolingSeconds = %d, want %d (REQ-052 7-day cooling)", CharterAmendmentCoolingSeconds, 7*24*60*60)
}
// REQ-048: 12-month operating history for reserve ceiling escalation.
if ReserveCeilingAgeSeconds != 365*24*60*60 {
t.Errorf("ReserveCeilingAgeSeconds = %d, want %d (REQ-048 12-month age check)", ReserveCeilingAgeSeconds, 365*24*60*60)
}
// REQ-062: Pool Council max 3 Masons.
if PoolCouncilMaxMasons != 3 {
t.Errorf("PoolCouncilMaxMasons = %d, want 3 (REQ-062)", PoolCouncilMaxMasons)
}
// REQ-062: CallVoteOption enum count = 3.
if CallVoteOptionCount != 3 {
t.Errorf("CallVoteOptionCount = %d, want 3 (REQ-062)", CallVoteOptionCount)
}
if len(AllCallVoteOptions()) != 3 {
t.Errorf("len(AllCallVoteOptions()) = %d, want 3 (REQ-062)", len(AllCallVoteOptions()))
}
}
// TestCallVoteOptionValues asserts the three CallVoteOption string values
// (a regression on the string value would break serialized state).
func TestCallVoteOptionValues(t *testing.T) {
cases := []struct {
opt CallVoteOption
want string
}{
{CallVoteYes, "Yes"},
{CallVoteNo, "No"},
{CallVoteAbstain, "Abstain"},
}
for _, c := range cases {
if string(c.opt) != c.want {
t.Errorf("CallVoteOption(%q) value = %q, want %q", c.opt, c.opt, c.want)
}
}
}
// TestCharterAmendmentStatusValues asserts the three CharterAmendmentStatus
// string values (Proposed/Cooled/Ratified).
func TestCharterAmendmentStatusValues(t *testing.T) {
if string(AmendmentProposed) != "Proposed" {
t.Errorf("AmendmentProposed = %q, want Proposed", AmendmentProposed)
}
if string(AmendmentCooled) != "Cooled" {
t.Errorf("AmendmentCooled = %q, want Cooled", AmendmentCooled)
}
if string(AmendmentRatified) != "Ratified" {
t.Errorf("AmendmentRatified = %q, want Ratified", AmendmentRatified)
}
}
// TestP2StructConstruction exercises the P2 struct construction (CoverCharter,
// CharterAmendment, PoolCouncil, CoverCallVote) for coverage on the
// zero-method paths.
func TestP2StructConstruction(t *testing.T) {
c := CoverCharter{
CharterID: "c1", PoolID: "p1", HostReachID: "h1", DisputePath: "dp",
Gate: "Trusted", HoldingPeriodDays: 30,
StatementOfBeliefsHash: []byte{1, 2, 3},
WatcherWitnessHash: []byte{4, 5, 6},
Amendments: []CharterAmendment{{AmendmentID: "a1", Status: AmendmentProposed}},
WaivedRights: []RightID{},
}
if c.CharterID != "c1" {
t.Errorf("CoverCharter CharterID = %q", c.CharterID)
}
a := CharterAmendment{AmendmentID: "a1", Description: "d", Status: AmendmentProposed, ProposedAt: 1000}
if a.AmendmentID != "a1" {
t.Errorf("CharterAmendment AmendmentID = %q", a.AmendmentID)
}
pc := PoolCouncil{PoolID: "p1", HostReachID: "h1", ElectedMasonReachIDs: [3]string{"m1", "m2", "m3"}, WatcherObserverReachID: "w1"}
if pc.ElectedMasonReachIDs[0] != "m1" {
t.Errorf("PoolCouncil ElectedMasonReachIDs[0] = %q", pc.ElectedMasonReachIDs[0])
}
v := CoverCallVote{VoteID: "v1", CallID: "c1", PoolID: "p1", VoterReachID: "v1", VoteOption: CallVoteYes, WatcherObserverPresent: true, VotedAt: 1000}
if v.VoteID != "v1" {
t.Errorf("CoverCallVote VoteID = %q", v.VoteID)
}
// CoverPool P2 fields.
p := CoverPool{PoolID: "p1", CharterRef: "c1", CouncilRef: "p1"}
if p.CharterRef != "c1" || p.CouncilRef != "p1" {
t.Errorf("CoverPool P2 refs = %q/%q", p.CharterRef, p.CouncilRef)
}
}
// --- P4: Cover Claims Voucher + Dissolution consts (REQ-055, REQ-063, D-090(2)) -
// TestP4VoucherAndDissolutionConsts asserts the P4 consts hold their
// values (REQ-055 voucher bond multiple, REQ-055 slash reason,
// D-090(2) cold-start minimum voucher bond).
func TestP4VoucherAndDissolutionConsts(t *testing.T) {
// REQ-055: Cover Claims Voucher bond multiple == 10.
if CoverClaimsVoucherBondMultipleAvgCall != 10 {
t.Errorf("CoverClaimsVoucherBondMultipleAvgCall = %d, want 10 (REQ-055)", CoverClaimsVoucherBondMultipleAvgCall)
}
// REQ-055: slash reason const (cross-doc x/standing).
if SlashReasonFraudulentCoverCall != "FraudulentCoverCall" {
t.Errorf("SlashReasonFraudulentCoverCall = %q, want %q (REQ-055 cross-doc x/standing)", SlashReasonFraudulentCoverCall, "FraudulentCoverCall")
}
// D-090(2): default minimum voucher bond (1M Grain = 100 Bread).
if DefaultMinimumVoucherBond != 1_000_000 {
t.Errorf("DefaultMinimumVoucherBond = %d, want 1000000 (D-090(2) cold-start default)", DefaultMinimumVoucherBond)
}
// FR-MAB-4 waterfall tier names.
if PoolDissolutionWaterfallTierCoverFeeContributors != "CoverFeeContributors" {
t.Errorf("Tier CoverFeeContributors = %q", PoolDissolutionWaterfallTierCoverFeeContributors)
}
if PoolDissolutionWaterfallTierMABHolders != "MABHolders" {
t.Errorf("Tier MABHolders = %q", PoolDissolutionWaterfallTierMABHolders)
}
if PoolDissolutionWaterfallTierBreadHolders != "BreadHolders" {
t.Errorf("Tier BreadHolders = %q", PoolDissolutionWaterfallTierBreadHolders)
}
}
// TestDefaultParamsMinimumVoucherBond asserts DefaultParams ships a non-zero
// MinimumVoucherBond (D-090(2) cold-start fix — the Voucher bond falls back
// to this when no Calls exist, NOT zero).
func TestDefaultParamsMinimumVoucherBond(t *testing.T) {
p := DefaultParams()
if p.MinimumVoucherBond != DefaultMinimumVoucherBond {
t.Errorf("DefaultParams MinimumVoucherBond = %d, want %d (D-090(2) cold-start default)", p.MinimumVoucherBond, DefaultMinimumVoucherBond)
}
if p.MinimumVoucherBond <= 0 {
t.Errorf("DefaultParams MinimumVoucherBond = %d, must be > 0 (D-090(2) — never zero)", p.MinimumVoucherBond)
}
}
// TestCoverClaimsVoucherStruct asserts the CoverClaimsVoucher struct carries
// the required fields (REQ-055).
func TestCoverClaimsVoucherStruct(t *testing.T) {
v := CoverClaimsVoucher{
VoucherReachID: "voucher-1",
PoolID: "pool-1",
BondAmount: 1_000_000,
BondMultipleAvgCall: CoverClaimsVoucherBondMultipleAvgCall,
RegisteredAt: 1000,
}
if v.VoucherReachID != "voucher-1" {
t.Errorf("VoucherReachID = %q", v.VoucherReachID)
}
if v.BondAmount != 1_000_000 {
t.Errorf("BondAmount = %d", v.BondAmount)
}
if v.BondMultipleAvgCall != 10 {
t.Errorf("BondMultipleAvgCall = %d, want 10", v.BondMultipleAvgCall)
}
}
// TestPoolDissolutionWaterfallStruct asserts the PoolDissolutionWaterfall
// struct carries the Tier + AmountGrain fields (REQ-063, FR-MAB-4).
func TestPoolDissolutionWaterfallStruct(t *testing.T) {
w := PoolDissolutionWaterfall{
Tier: PoolDissolutionWaterfallTierCoverFeeContributors,
AmountGrain: 1_000_000,
}
if w.Tier != "CoverFeeContributors" {
t.Errorf("Tier = %q", w.Tier)
}
if w.AmountGrain != 1_000_000 {
t.Errorf("AmountGrain = %d", w.AmountGrain)
}
}
// TestCoverCallAdjudicationFields asserts the CoverCall struct carries the
// P4 adjudication fields (AdjudicationResult + AdjudicatedBy + AdjudicatedAt
// — additive; existing CoverCall records keep zero values).
func TestCoverCallAdjudicationFields(t *testing.T) {
c := CoverCall{
CallID: "c1",
PoolID: "p1",
ClaimantReachID: "u1",
Category: CatTravel,
AmountGrain: 100,
FiledAt: 1000,
AdjudicationResult: "Approved",
AdjudicatedBy: "voucher-1",
AdjudicatedAt: 2000,
}
if c.AdjudicationResult != "Approved" {
t.Errorf("AdjudicationResult = %q", c.AdjudicationResult)
}
if c.AdjudicatedBy != "voucher-1" {
t.Errorf("AdjudicatedBy = %q", c.AdjudicatedBy)
}
if c.AdjudicatedAt != 2000 {
t.Errorf("AdjudicatedAt = %d", c.AdjudicatedAt)
}
// Default zero-value (additive — existing CoverCall records unchanged).
var c2 CoverCall
if c2.AdjudicationResult != "" || c2.AdjudicatedBy != "" || c2.AdjudicatedAt != 0 {
t.Error("zero-value CoverCall adjudication fields should be empty (additive)")
}
}
// TestMABRefStruct asserts the MABRef struct (the lightweight by-value MAB
// reference for the dissolution waterfall Tier 2) carries the BondID +
// PrincipalGrain fields (G-003 — no struct import of x/bond/types).
func TestMABRefStruct(t *testing.T) {
m := MABRef{BondID: "mab-1", PrincipalGrain: 1_000_000}
if m.BondID != "mab-1" {
t.Errorf("MABRef BondID = %q", m.BondID)
}
if m.PrincipalGrain != 1_000_000 {
t.Errorf("MABRef PrincipalGrain = %d", m.PrincipalGrain)
}
}
// --- P5: Pier Selection Index + Pier Selection Record consts (REQ-066) ---------
// TestPierSelectionIndexStruct asserts the PierSelectionIndex struct
// carries the five required fields (PierID, JurisdictionalReliabilityScore,
// FiduciaryRecordHash, IntegrationQualityScore, OverallScore) — a
// compile-time + runtime regression firewall (REQ-066).
func TestPierSelectionIndexStruct(t *testing.T) {
idx := PierSelectionIndex{
PierID: "pier-1",
JurisdictionalReliabilityScore: 0.9,
FiduciaryRecordHash: []byte{1, 2, 3},
IntegrationQualityScore: 0.8,
OverallScore: 0.85,
}
if idx.PierID != "pier-1" {
t.Errorf("PierID = %q", idx.PierID)
}
if idx.JurisdictionalReliabilityScore != 0.9 {
t.Errorf("JurisdictionalReliabilityScore = %.2f", idx.JurisdictionalReliabilityScore)
}
if len(idx.FiduciaryRecordHash) != 3 {
t.Errorf("FiduciaryRecordHash len = %d", len(idx.FiduciaryRecordHash))
}
if idx.IntegrationQualityScore != 0.8 {
t.Errorf("IntegrationQualityScore = %.2f", idx.IntegrationQualityScore)
}
if idx.OverallScore != 0.85 {
t.Errorf("OverallScore = %.2f", idx.OverallScore)
}
}
// TestPierSelectionRecordStruct asserts the PierSelectionRecord struct
// carries the four required fields (GuildID, PierID, SelectedAt,
// SelectedBy) — a compile-time + runtime regression firewall (REQ-066).
func TestPierSelectionRecordStruct(t *testing.T) {
rec := PierSelectionRecord{
GuildID: "guild-1",
PierID: "pier-1",
SelectedAt: 12345,
SelectedBy: "reach:founder",
}
if rec.GuildID != "guild-1" {
t.Errorf("GuildID = %q", rec.GuildID)
}
if rec.PierID != "pier-1" {
t.Errorf("PierID = %q", rec.PierID)
}
if rec.SelectedAt != 12345 {
t.Errorf("SelectedAt = %d", rec.SelectedAt)
}
if rec.SelectedBy != "reach:founder" {
t.Errorf("SelectedBy = %q", rec.SelectedBy)
}
}
+386
View File
@@ -0,0 +1,386 @@
package keeper
// keeper.go holds the store-backed Keeper for the guild module's Guild
// Charter + Chapter Federation + Household + Confederation runtime (P3,
// REQ-051, REQ-053, REQ-057, REQ-058).
//
// The Keeper wraps an sdk.KVStore via a storeKey. It holds:
// - the Guild records (guild-id -> Guild; both Parent Guilds and Chapters
// are stored here — a Chapter is a Guild with IsChapter=true);
// - the Lien records (guild-id + lien-idx -> Lien; the AddLien handler
// appends here with SecuredAtFounding=false; founding-locked liens
// (SecuredAtFounding=true) are stored on the Guild itself at creation);
// - the Confederation Voice delegation records
// (confederation-stand-id + member-stand-id -> ConfederationVoice).
//
// The Keeper also holds the two expected-keeper shims (StandKeeper for the
// Household/Confederation type check; StashKeeper for the asset return on
// Household one-tap exit). The shims are interfaces (G-003 — no struct
// import of x/stand/types or x/stash/types); the concrete keepers (or
// simtest stubs) satisfy them structurally.
//
// State-machine ordering (vision §7, enforced in every handler):
// ValidateBasic -> handler authz/gate -> state mutation -> ctx.EventManager().EmitEvent
import (
"encoding/json"
"fmt"
storetypes "cosmossdk.io/store/types"
"github.com/cosmos/cosmos-sdk/codec"
sdk "github.com/cosmos/cosmos-sdk/types"
"github.com/oy/openyield/x/guild/types"
)
// Keeper is the store-backed guild Keeper.
type Keeper struct {
cdc codec.Codec
storeKey storetypes.StoreKey
standKeeper types.StandKeeper
stashKeeper types.StashKeeper
paramsHolder types.Params
}
// NewKeeper constructs a new store-backed guild Keeper. The StandKeeper +
// StashKeeper expected-keeper shims are injected (StandKeeper is nil-able
// for partial wiring — the OneTapExitStand + DelegateConfederationVoice
// handlers REJECT on a nil StandKeeper (the type check is load-bearing);
// StashKeeper is nil-able — a nil StashKeeper skips the asset return on
// one-tap exit (simtest wiring)).
func NewKeeper(cdc codec.Codec, storeKey storetypes.StoreKey, sk types.StandKeeper, stashK types.StashKeeper) Keeper {
return Keeper{
cdc: cdc,
storeKey: storeKey,
standKeeper: sk,
stashKeeper: stashK,
paramsHolder: types.DefaultParams(),
}
}
// SetStandKeeper sets the StandKeeper expected-keeper shim (for
// post-construction wiring, e.g., app wiring or test setup).
func (k *Keeper) SetStandKeeper(sk types.StandKeeper) { k.standKeeper = sk }
// SetStashKeeper sets the StashKeeper expected-keeper shim.
func (k *Keeper) SetStashKeeper(stashK types.StashKeeper) { k.stashKeeper = stashK }
// SetParams sets the Params (simtest-grade override; a future version will
// load from the params store).
func (k *Keeper) SetParams(p types.Params) { k.paramsHolder = p }
// Params returns the effective Params.
func (k Keeper) Params() types.Params { return k.paramsHolder }
// StoreKey returns the keeper's store key (exported for simtest access to
// the underlying KVStore, e.g., to inject corrupt bytes for marshal-error
// coverage). Mirrors the x/cover simtest pattern.
func (k Keeper) StoreKey() storetypes.StoreKey { return k.storeKey }
// --- Guild store --------------------------------------------------------------
var guildKeyPrefix = []byte("guild/")
func guildKey(guildID string) []byte {
return append(guildKeyPrefix, []byte(guildID)...)
}
// GetGuild loads a Guild by guild-id. Returns the Guild and true if found,
// or zero value + false if not. Both Parent Guilds and Chapters are stored
// here (a Chapter is a Guild with IsChapter=true).
func (k Keeper) GetGuild(ctx sdk.Context, guildID string) (types.Guild, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(guildKey(guildID))
if bz == nil {
return types.Guild{}, false
}
var g types.Guild
if err := json.Unmarshal(bz, &g); err != nil {
return types.Guild{}, false
}
return g, true
}
// SetGuild persists a Guild by guild-id.
func (k Keeper) SetGuild(ctx sdk.Context, g types.Guild) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(g)
if err != nil {
panic(fmt.Sprintf("guild: marshal guild %q: %v", g.GuildID, err))
}
store.Set(guildKey(g.GuildID), bz)
}
// AllGuilds returns all persisted Guild records (iteration helper,
// unordered). Both Parent Guilds and Chapters are returned.
func (k Keeper) AllGuilds(ctx sdk.Context) []types.Guild {
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(guildKeyPrefix, prefixEnd(guildKeyPrefix))
defer iterator.Close()
out := []types.Guild{}
for ; iterator.Valid(); iterator.Next() {
var g types.Guild
if err := json.Unmarshal(iterator.Value(), &g); err == nil {
out = append(out, g)
}
}
return out
}
// --- Lien store ---------------------------------------------------------------
//
// The Lien store is keyed by guild-id + lien-idx. The AddLien handler
// appends here with SecuredAtFounding=false. Founding-locked liens
// (SecuredAtFounding=true) are stored on the Guild itself at creation
// (GoodStandingLiens slice); the AddLien handler rejects any new
// SecuredAtFounding=true lien (founding is a one-time event — REQ-053).
var lienKeyPrefix = []byte("lien/")
func lienKey(guildID string, idx uint32) []byte {
return append(lienKeyPrefix, []byte(fmt.Sprintf("%s/%d", guildID, idx))...)
}
// GetLien loads a Lien by guild-id + lien-idx. Returns the Lien and true if
// found, or zero value + false if not.
func (k Keeper) GetLien(ctx sdk.Context, guildID string, idx uint32) (types.Lien, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(lienKey(guildID, idx))
if bz == nil {
return types.Lien{}, false
}
var l types.Lien
if err := json.Unmarshal(bz, &l); err != nil {
return types.Lien{}, false
}
return l, true
}
// SetLien persists a Lien by guild-id + lien-idx.
func (k Keeper) SetLien(ctx sdk.Context, guildID string, idx uint32, l types.Lien) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(l)
if err != nil {
panic(fmt.Sprintf("guild: marshal lien %s/%d: %v", guildID, idx, err))
}
store.Set(lienKey(guildID, idx), bz)
}
// AllLiens returns all persisted Lien records for a guild (iteration helper,
// unordered — the idx ordering is NOT preserved across iterations; the
// simtest asserts count + content, not order).
func (k Keeper) AllLiens(ctx sdk.Context, guildID string) []types.Lien {
prefix := append(lienKeyPrefix, []byte(guildID+"/")...)
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(prefix, prefixEnd(prefix))
defer iterator.Close()
out := []types.Lien{}
for ; iterator.Valid(); iterator.Next() {
var l types.Lien
if err := json.Unmarshal(iterator.Value(), &l); err == nil {
out = append(out, l)
}
}
return out
}
// NextLienIdx returns the next lien-idx for a guild (the count of existing
// liens — the AddLien handler uses this to assign the new lien's idx). The
// founding-locked liens on the Guild's GoodStandingLiens slice do NOT
// consume an idx in this store (they are stored on the Guild itself); only
// post-founding liens (SecuredAtFounding=false) added via AddLien consume an
// idx here.
func (k Keeper) NextLienIdx(ctx sdk.Context, guildID string) uint32 {
return uint32(len(k.AllLiens(ctx, guildID)))
}
// --- Confederation Voice delegation store --------------------------------------
//
// The delegation store is keyed by confederation-stand-id + member-stand-id.
// The DelegateConfederationVoice handler records one delegation per member
// Stand (a duplicate delegation from the same MemberStandID is REJECTED).
// One-Stand-one-Vote: each member Stand gets exactly 1 Voice in the
// Confederation's aggregate, regardless of size.
var delegationKeyPrefix = []byte("delegation/")
func delegationKey(confederationStandID, memberStandID string) []byte {
return append(delegationKeyPrefix, []byte(fmt.Sprintf("%s/%s", confederationStandID, memberStandID))...)
}
// GetDelegation loads a ConfederationVoice delegation by confederation-stand-id
// + member-stand-id. Returns the ConfederationVoice (from x/guild/types) and
// true if found, or zero value + false if not.
func (k Keeper) GetDelegation(ctx sdk.Context, confederationStandID, memberStandID string) (types.ConfederationVoice, bool) {
store := ctx.KVStore(k.storeKey)
bz := store.Get(delegationKey(confederationStandID, memberStandID))
if bz == nil {
return types.ConfederationVoice{}, false
}
var v types.ConfederationVoice
if err := json.Unmarshal(bz, &v); err != nil {
return types.ConfederationVoice{}, false
}
return v, true
}
// SetDelegation persists a ConfederationVoice delegation by confederation-
// stand-id + member-stand-id.
func (k Keeper) SetDelegation(ctx sdk.Context, v types.ConfederationVoice) {
store := ctx.KVStore(k.storeKey)
bz, err := json.Marshal(v)
if err != nil {
panic(fmt.Sprintf("guild: marshal delegation %s/%s: %v", v.ConfederationStandID, v.MemberStandID, err))
}
store.Set(delegationKey(v.ConfederationStandID, v.MemberStandID), bz)
}
// AllDelegations returns all persisted ConfederationVoice delegations for a
// Confederation Stand (iteration helper, unordered).
func (k Keeper) AllDelegations(ctx sdk.Context, confederationStandID string) []types.ConfederationVoice {
prefix := append(delegationKeyPrefix, []byte(confederationStandID+"/")...)
store := ctx.KVStore(k.storeKey)
iterator := store.Iterator(prefix, prefixEnd(prefix))
defer iterator.Close()
out := []types.ConfederationVoice{}
for ; iterator.Valid(); iterator.Next() {
var v types.ConfederationVoice
if err := json.Unmarshal(iterator.Value(), &v); err == nil {
out = append(out, v)
}
}
return out
}
// --- prefixEnd helper ---------------------------------------------------------
// prefixEnd returns the key that sorts immediately after all keys sharing
// the given prefix (the standard prefix-iteration end key: increment the
// last byte, drop overflow). Used for store.Iterator(start, prefixEnd(start))
// prefix scans. Mirrors x/hub/keeper/keeper.go + x/cover/keeper/keeper.go.
func prefixEnd(prefix []byte) []byte {
if len(prefix) == 0 {
return nil
}
end := make([]byte, len(prefix))
copy(end, prefix)
for i := len(end) - 1; i >= 0; i-- {
end[i]++
if end[i] != 0 {
return end
}
}
// All bytes were 0xFF; return nil (iterate to end of store).
return nil
}
// --- P5: Stand→Pier eligibility + acceptance stores (REQ-059, D-074) -----------
//
// (REQ-059, D-074). Two new stores. The pier_eligible/ store is keyed by
// StandID -> bool (the MsgEscalateStandToPier handler sets true when the
// Stand's annual Pass volume exceeds StandPierEscalationAnnualPassVolumeCents).
// The pier_accepted/ store is keyed by StandID -> bool (the
// MsgAcceptPierInvitation handler sets true when the Stand accepts the Pier
// invitation; the handler REJECTS if the Stand is not Pier-eligible). Both
// stores hold a single byte (0x00 = false, 0x01 = true) — no JSON marshal
// needed for a single bool.
var pierEligibleKeyPrefix = []byte("pier_eligible/")
func pierEligibleKey(standID string) []byte {
return append(pierEligibleKeyPrefix, []byte(standID)...)
}
// GetStandPierEligible loads a Stand's Pier-eligibility flag (REQ-059,
// D-074). Returns true if the Stand was marked Pier-eligible by the
// MsgEscalateStandToPier handler, false otherwise.
func (k Keeper) GetStandPierEligible(ctx sdk.Context, standID string) bool {
store := ctx.KVStore(k.storeKey)
bz := store.Get(pierEligibleKey(standID))
return len(bz) == 1 && bz[0] == 0x01
}
// SetStandPierEligible persists a Stand's Pier-eligibility flag.
func (k Keeper) SetStandPierEligible(ctx sdk.Context, standID string, eligible bool) {
store := ctx.KVStore(k.storeKey)
v := []byte{0x00}
if eligible {
v = []byte{0x01}
}
store.Set(pierEligibleKey(standID), v)
}
var pierAcceptedKeyPrefix = []byte("pier_accepted/")
func pierAcceptedKey(standID string) []byte {
return append(pierAcceptedKeyPrefix, []byte(standID)...)
}
// GetStandPierAccepted loads a Stand's Pier-acceptance flag (REQ-059,
// D-074). Returns true if the Stand accepted the Pier invitation via the
// MsgAcceptPierInvitation handler, false otherwise.
func (k Keeper) GetStandPierAccepted(ctx sdk.Context, standID string) bool {
store := ctx.KVStore(k.storeKey)
bz := store.Get(pierAcceptedKey(standID))
return len(bz) == 1 && bz[0] == 0x01
}
// SetStandPierAccepted persists a Stand's Pier-acceptance flag.
func (k Keeper) SetStandPierAccepted(ctx sdk.Context, standID string, accepted bool) {
store := ctx.KVStore(k.storeKey)
v := []byte{0x00}
if accepted {
v = []byte{0x01}
}
store.Set(pierAcceptedKey(standID), v)
}
// --- P5: Secession lien-audit helper (REQ-064) --------------------------------
//
// CheckLiensCleared returns true if every lien on the named Guild (both the
// founding-locked liens on the Guild's GoodStandingLiens slice + the post-
// founding liens in the lien/ store) has Cleared=true OR Amount=0 (a
// cleared-or-zero lien passes the audit). The MsgInitiateSecession +
// MsgCompleteSecession handlers consult this. A Guild with no liens returns
// true (the audit passes vacuously).
func (k Keeper) CheckLiensCleared(ctx sdk.Context, guildID string) bool {
g, ok := k.GetGuild(ctx, guildID)
if !ok {
return false
}
for _, l := range g.GoodStandingLiens {
if l.Amount != 0 && !l.Cleared {
return false
}
}
for _, l := range k.AllLiens(ctx, guildID) {
if l.Amount != 0 && !l.Cleared {
return false
}
}
return true
}
// ChapterIsCoverActive returns true if the named Chapter has any lien
// (founding-locked or post-founding) that references a Cover Pool covenant
// (CoverPoolCovenantRef non-empty). The MsgCompleteSecession handler
// consults this to choose the cooling period: Cover-active = 21d, non-Cover
// = 14d (REQ-064). A Guild that is not found or is not a Chapter returns
// false (the handler rejects non-Chapters upstream).
func (k Keeper) ChapterIsCoverActive(ctx sdk.Context, guildID string) bool {
g, ok := k.GetGuild(ctx, guildID)
if !ok {
return false
}
for _, l := range g.GoodStandingLiens {
if l.CoverPoolCovenantRef != "" {
return true
}
}
for _, l := range k.AllLiens(ctx, guildID) {
if l.CoverPoolCovenantRef != "" {
return true
}
}
return false
}
+546
View File
@@ -0,0 +1,546 @@
package keeper
// msg_server.go implements the guild module's MsgServer (P3, REQ-051,
// REQ-053, REQ-057, REQ-058, REQ-061). The MsgServer wraps the Keeper + the
// StandKeeper + StashKeeper expected-keeper shims (already on the Keeper).
//
// Each method returns a (*Response, error). Handler state-machine ordering
// is enforced: ValidateBasic -> handler authz/gate -> state mutation ->
// ctx.EventManager().EmitEvent.
//
// Handler set:
// - CreateGuild (REQ-051): validate, idempotency, persist Guild with
// CommonBondHash + PublicProfile, surface a jurisdictional disclaimer
// (REQ-061).
// - CreateChapter (REQ-053): validate, idempotency, load Parent Guild,
// pin SecessionTermsHash, set IsChapter=true + ParentGuildID, record
// GoodStandingLiens (SecuredAtFounding=true), reject cooling below the
// protocol minimum, persist, surface a disclaimer (REQ-061).
// - OneTapExitStand (REQ-057): validate, assert Stand type is Household
// via StandKeeper shim (nil REJECTS), dissolve the Stand + return assets
// to the Holder's Stash via StashKeeper shim (nil skips the return,
// still emits the dissolution event), emit event.
// - DelegateConfederationVoice (REQ-058): validate, assert Confederation
// Stand type via StandKeeper shim, record one delegation per member
// Stand (duplicate REJECTED), emit event.
// - AddLien (REQ-053): validate, load Guild, REJECT any new
// SecuredAtFounding=true lien (founding is one-time — REQ-053/REQ-081),
// persist the lien, emit event.
//
// Nil-shim behavior (simtest wiring): a nil StandKeeper REJECTS the
// OneTapExitStand + DelegateConfederationVoice handlers (the Household /
// Confederation type check is load-bearing — it cannot be skipped). A nil
// StashKeeper skips the asset return on one-tap exit (the handler still
// emits the dissolution event — the asset return is a side-effect the
// simtest stub records).
import (
"fmt"
sdk "github.com/cosmos/cosmos-sdk/types"
"github.com/oy/openyield/x/guild/types"
)
// DisclaimerJurisdictional is the jurisdictional disclaimer surfaced at
// every charter signing (REQ-061). NOT session-bounded — surfaced at every
// CreateGuild + CreateChapter. The disclaimer is a fixed string (the live
// jurisdictional overlay lands in a later phase; the simtest asserts the
// Disclaimer field is non-empty).
const DisclaimerJurisdictional = "OpenYield Guilds are self-governed mesh collectives; the protocol does not provide legal, tax, or fiduciary advice. Signers affirm they have reviewed the Common Bond + jurisdictional obligations before signing."
// msgServer is the concrete MsgServer implementation wrapping the Keeper.
type msgServer struct {
Keeper
}
// NewMsgServerImpl returns the guild MsgServer for the provided Keeper.
func NewMsgServerImpl(k Keeper) types.MsgServer {
return &msgServer{Keeper: k}
}
var _ types.MsgServer = msgServer{}
// unwrapCtx extracts the sdk.Context from the interface-typed ctx.
func unwrapCtx(ctx interface{}) sdk.Context {
if c, ok := ctx.(sdk.Context); ok {
return c
}
panic(fmt.Sprintf("guild: expected sdk.Context, got %T", ctx))
}
// --- CreateGuild (REQ-051, REQ-061) -------------------------------------------
// CreateGuild creates a Guild with a Common Bond hash + Public Profile
// (REQ-051). The handler enforces:
// 1. ValidateBasic (stateless — non-empty fields + non-empty
// CommonBondHash).
// 2. Idempotency: guild-id must not already exist.
// 3. Persist the Guild with CommonBondHash + PublicProfile (the Common
// Bond is hash-pinned at creation — immutable; the handler does NOT
// store the bond text, only the hash).
// 4. Surface a jurisdictional disclaimer (REQ-061) in the response.
//
// On success the Guild is persisted and an event is emitted.
func (s msgServer) CreateGuild(ctx interface{}, msg *types.MsgCreateGuild) (*types.MsgCreateGuildResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// Idempotency: guild-id must not already exist.
if _, ok := s.Keeper.GetGuild(sdkCtx, msg.GuildID); ok {
return nil, fmt.Errorf("guild: guild %q already exists", msg.GuildID)
}
g := types.Guild{
GuildID: msg.GuildID,
Name: msg.Name,
FounderReach: msg.FounderReach,
CreatedAt: sdkCtx.BlockTime().Unix(),
StandAffiliationID: msg.StandAffiliationID,
CommonBondHash: msg.CommonBondHash,
PublicProfile: msg.PublicProfile,
IsChapter: false,
ParentGuildID: "",
}
s.Keeper.SetGuild(sdkCtx, g)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.guild_created",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("founder_reach", msg.FounderReach),
))
return &types.MsgCreateGuildResponse{Disclaimer: DisclaimerJurisdictional}, nil
}
// --- CreateChapter (REQ-053, REQ-061) -----------------------------------------
// CreateChapter creates a Chapter under a Parent Guild (REQ-053). The
// handler enforces:
// 1. ValidateBasic (stateless — non-empty fields, SecessionTerms valid +
// protocol-minimum-bounded, each GoodStandingLien is SecuredAtFounding).
// 2. Idempotency: chapter guild-id must not already exist.
// 3. Load the Parent Guild (must exist; must NOT itself be a Chapter — a
// Chapter cannot have a Chapter parent).
// 4. Pin the SecessionTerms hash (HashSecessionTerms — immutable; no
// handler to amend it).
// 5. Set IsChapter=true + ParentGuildID + GoodStandingLiens (each with
// SecuredAtFounding=true — ValidateBasic already enforced this).
// 6. Persist the Chapter.
// 7. Surface a jurisdictional disclaimer (REQ-061) in the response.
//
// On success the Chapter is persisted and an event is emitted.
func (s msgServer) CreateChapter(ctx interface{}, msg *types.MsgCreateChapter) (*types.MsgCreateChapterResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// Idempotency: chapter guild-id must not already exist.
if _, ok := s.Keeper.GetGuild(sdkCtx, msg.GuildID); ok {
return nil, fmt.Errorf("guild: chapter %q already exists", msg.GuildID)
}
// Load the Parent Guild (must exist; must NOT itself be a Chapter).
parent, ok := s.Keeper.GetGuild(sdkCtx, msg.ParentGuildID)
if !ok {
return nil, fmt.Errorf("guild: parent guild %q not found (REQ-053)", msg.ParentGuildID)
}
if parent.IsChapter {
return nil, fmt.Errorf("guild: parent %q is itself a Chapter (a Chapter cannot have a Chapter parent — REQ-053)", msg.ParentGuildID)
}
// Pin the SecessionTerms hash (immutable — no handler to amend it).
termsHash := types.HashSecessionTerms(msg.SecessionTerms)
// GoodStandingLiens are recorded with SecuredAtFounding=true
// (ValidateBasic already enforced this — founding-locked liens).
liens := make([]types.Lien, len(msg.GoodStandingLiens))
copy(liens, msg.GoodStandingLiens)
chapter := types.Guild{
GuildID: msg.GuildID,
Name: msg.Name,
FounderReach: msg.FounderReach,
CreatedAt: sdkCtx.BlockTime().Unix(),
CommonBondHash: parent.CommonBondHash, // a Chapter inherits the Parent's Common Bond hash
PublicProfile: parent.PublicProfile, // a Chapter inherits the Parent's Public Profile
IsChapter: true,
ParentGuildID: msg.ParentGuildID,
SecessionTermsHash: termsHash,
GoodStandingLiens: liens,
}
s.Keeper.SetGuild(sdkCtx, chapter)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.chapter_created",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("parent_guild_id", msg.ParentGuildID),
))
return &types.MsgCreateChapterResponse{Disclaimer: DisclaimerJurisdictional}, nil
}
// --- OneTapExitStand (REQ-057) ------------------------------------------------
// OneTapExitStand one-tap exits a Household Stand (REQ-057). The handler
// enforces:
// 1. ValidateBasic (stateless).
// 2. StandKeeper shim must be non-nil (the Household type check is
// load-bearing — a nil shim is a wiring error, REJECTED).
// 3. The Stand must exist + its type must be "Household" (one-tap exit is
// Household-only — a Crew / Entity / etc. Stand is REJECTED).
// 4. StashKeeper shim: if non-nil, call ReturnAssetsToHolder to return the
// dissolved Stand's assets to the Holder's Stash (a nil shim skips the
// return — simtest wiring; the dissolution event is still emitted). A
// non-nil error from ReturnAssetsToHolder REJECTS the dissolution (the
// asset return is load-bearing — a failed return leaves the Stand
// intact).
// 5. Emit the dissolution event.
//
// The signer is treated as the Holder (the Reach the assets are returned
// to). The live authz (signer must be the Stand's admin-reach) is deferred
// (simtest grade).
func (s msgServer) OneTapExitStand(ctx interface{}, msg *types.MsgOneTapExitStand) (*types.MsgOneTapExitStandResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// StandKeeper shim must be non-nil (the type check is load-bearing).
if s.Keeper.standKeeper == nil {
return nil, fmt.Errorf("guild: StandKeeper not wired (OneTapExitStand rejected — Household type check is load-bearing)")
}
// The Stand must exist + be a Household (one-tap exit is Household-only).
standType, exists := s.Keeper.standKeeper.GetStand(msg.StandID)
if !exists {
return nil, fmt.Errorf("guild: stand %q not found (OneTapExitStand rejected)", msg.StandID)
}
if standType != "Household" {
return nil, fmt.Errorf("guild: stand %q type %q is not a Household (one-tap exit is Household-only — REQ-057)", msg.StandID, standType)
}
// StashKeeper: return the dissolved Stand's assets to the Holder's Stash.
// A nil shim skips the return (simtest wiring); a non-nil error REJECTS
// (the asset return is load-bearing).
if s.Keeper.stashKeeper != nil {
if err := s.Keeper.stashKeeper.ReturnAssetsToHolder(msg.Signer, msg.StandID); err != nil {
return nil, fmt.Errorf("guild: return assets to holder %q for stand %q: %w", msg.Signer, msg.StandID, err)
}
}
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.one_tap_exit",
sdk.NewAttribute("stand_id", msg.StandID),
sdk.NewAttribute("holder_reach", msg.Signer),
))
return &types.MsgOneTapExitStandResponse{}, nil
}
// --- DelegateConfederationVoice (REQ-058) -------------------------------------
// DelegateConfederationVoice delegates a member Stand's Voice in a
// Confederation (REQ-058). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. StandKeeper shim must be non-nil (the Confederation type check is
// load-bearing — a nil shim is a wiring error, REJECTED).
// 3. The Confederation Stand must exist + its type must be "Confederation".
// 4. One delegation per member Stand: a duplicate delegation from the same
// MemberStandID is REJECTED (one-Stand-one-Vote — each member Stand gets
// exactly 1 Voice in the Confederation's aggregate, regardless of size).
// 5. Persist the delegation + emit the event.
func (s msgServer) DelegateConfederationVoice(ctx interface{}, msg *types.MsgDelegateConfederationVoice) (*types.MsgDelegateConfederationVoiceResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// StandKeeper shim must be non-nil (the type check is load-bearing).
if s.Keeper.standKeeper == nil {
return nil, fmt.Errorf("guild: StandKeeper not wired (DelegateConfederationVoice rejected — Confederation type check is load-bearing)")
}
// The Confederation Stand must exist + be a Confederation.
standType, exists := s.Keeper.standKeeper.GetStand(msg.ConfederationStandID)
if !exists {
return nil, fmt.Errorf("guild: confederation stand %q not found", msg.ConfederationStandID)
}
if standType != "Confederation" {
return nil, fmt.Errorf("guild: stand %q type %q is not a Confederation (REQ-058)", msg.ConfederationStandID, standType)
}
// One delegation per member Stand: a duplicate is REJECTED.
if _, ok := s.Keeper.GetDelegation(sdkCtx, msg.ConfederationStandID, msg.MemberStandID); ok {
return nil, fmt.Errorf("guild: member stand %q already delegates in confederation %q (one-Stand-one-Vote — duplicate REJECTED — REQ-058)", msg.MemberStandID, msg.ConfederationStandID)
}
v := types.ConfederationVoice{
ConfederationStandID: msg.ConfederationStandID,
MemberStandID: msg.MemberStandID,
DelegateReachID: msg.DelegateReachID,
DelegatedAt: sdkCtx.BlockTime().Unix(),
}
s.Keeper.SetDelegation(sdkCtx, v)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.confederation_voice_delegated",
sdk.NewAttribute("confederation_stand_id", msg.ConfederationStandID),
sdk.NewAttribute("member_stand_id", msg.MemberStandID),
sdk.NewAttribute("delegate_reach_id", msg.DelegateReachID),
))
return &types.MsgDelegateConfederationVoiceResponse{}, nil
}
// --- AddLien (REQ-053) --------------------------------------------------------
// AddLien adds a Good-Standing Lien to a Guild (REQ-053). The handler
// enforces:
// 1. ValidateBasic (stateless — non-empty fields, Lien Amount > 0).
// 2. The Guild must exist.
// 3. REJECT any new SecuredAtFounding=true lien (founding is a one-time
// event — REQ-053/REQ-081; post-founding liens added via AddLien MUST
// be SecuredAtFounding=false).
// 4. Persist the lien (assigned the next lien-idx) + emit the event.
func (s msgServer) AddLien(ctx interface{}, msg *types.MsgAddLien) (*types.MsgAddLienResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
// The Guild must exist.
if _, ok := s.Keeper.GetGuild(sdkCtx, msg.GuildID); !ok {
return nil, fmt.Errorf("guild: guild %q not found (AddLien rejected)", msg.GuildID)
}
// REJECT any new SecuredAtFounding=true lien (founding is one-time —
// REQ-053/REQ-081).
if msg.Lien.SecuredAtFounding {
return nil, fmt.Errorf("guild: AddLien rejects SecuredAtFounding=true liens (founding is a one-time event — REQ-053/REQ-081; post-founding liens must be SecuredAtFounding=false)")
}
idx := s.Keeper.NextLienIdx(sdkCtx, msg.GuildID)
s.Keeper.SetLien(sdkCtx, msg.GuildID, idx, msg.Lien)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.lien_added",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("lien_idx", fmt.Sprintf("%d", idx)),
sdk.NewAttribute("creditor_reach_id", msg.Lien.CreditorReachID),
sdk.NewAttribute("amount", fmt.Sprintf("%d", msg.Lien.Amount)),
))
return &types.MsgAddLienResponse{}, nil
}
// --- v0.7 P5: Secession + Stand→Pier escalation handlers (REQ-064, REQ-059) ---
//
// (REQ-064 secession cooling enforcement, REQ-059/D-074 Stand→Pier boundary.)
// The four handlers exercise the secession lifecycle (initiate + complete
// with the Cover-active 21d / non-Cover 14d cooling) + the Stand→Pier
// escalation soft-upgrade (eligibility flag + acceptance).
// InitiateSecession initiates a Chapter's secession (REQ-064). The handler
// enforces:
// 1. ValidateBasic (stateless).
// 2. The Guild must exist + be a Chapter (IsChapter=true). A non-Chapter
// Guild REJECTS (a Parent Guild does not secede).
// 3. The Chapter must not have already initiated (SecessionStartedAt == 0;
// a second initiation REJECTS — use CompleteSecession or reset).
// 4. Set SecessionStartedAt = now. Persist the Chapter.
// 5. Invoke the lien audit (CheckLiensCleared — true if every lien has
// Cleared=true or Amount=0). The audit result is returned in the
// response (LienAuditPassed) for simtest assertion; the handler still
// records SecessionStartedAt so the cooling clock starts regardless
// (the lien audit is re-checked at completion — an outstanding lien at
// completion REJECTS).
// 6. Emit guild.secession_initiated.
func (s msgServer) InitiateSecession(ctx interface{}, msg *types.MsgInitiateSecession) (*types.MsgInitiateSecessionResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
g, ok := s.Keeper.GetGuild(sdkCtx, msg.GuildID)
if !ok {
return nil, fmt.Errorf("guild: guild %q not found (InitiateSecession rejected)", msg.GuildID)
}
if !g.IsChapter {
return nil, fmt.Errorf("guild: guild %q is not a Chapter (a Parent Guild does not secede — REQ-064)", msg.GuildID)
}
if g.SecessionStartedAt > 0 {
return nil, fmt.Errorf("guild: chapter %q already initiated secession (SecessionStartedAt=%d — use CompleteSecession — REQ-064)", msg.GuildID, g.SecessionStartedAt)
}
g.SecessionStartedAt = sdkCtx.BlockTime().Unix()
s.Keeper.SetGuild(sdkCtx, g)
lienAuditPassed := s.Keeper.CheckLiensCleared(sdkCtx, msg.GuildID)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.secession_initiated",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("secession_started_at", fmt.Sprintf("%d", g.SecessionStartedAt)),
sdk.NewAttribute("lien_audit_passed", fmt.Sprintf("%v", lienAuditPassed)),
))
return &types.MsgInitiateSecessionResponse{LienAuditPassed: lienAuditPassed}, nil
}
// CompleteSecession completes a Chapter's secession (REQ-064). The handler
// enforces:
// 1. ValidateBasic (stateless).
// 2. The Guild must exist + be a Chapter.
// 3. SecessionStartedAt > 0 (secession was initiated).
// 4. Cooling check (REQ-064): compute coolingSeconds based on whether the
// Chapter is Cover-active (any lien references a Cover Pool covenant).
// Cover-active: CoolingSecessionCoverActiveDays*86400 (21d). Non-Cover:
// CoolingSecessionNonCoverDays*86400 (14d). Check now >=
// SecessionStartedAt + coolingSeconds. If not, REJECT with "secession
// cooling not elapsed".
// 5. Lien audit: CheckLiensCleared must return true (all liens Cleared or
// Amount=0). If not, REJECT.
// 6. Covenant clearance: the Msg's CovenantClearancePassed must be true
// (simtest-grade — the live Cover Pool covenant clearance is a v0.8+
// concern). If not, REJECT.
// 7. Pro-rata Cover-Fee settlement: emit guild.pro_rata_settlement with
// the ProRataSettlementGrain from the Msg (the actual settlement is a
// v0.8+ Grain-ledger concern).
// 8. Set SecededAt = now. Persist the Chapter. Emit
// guild.secession_completed.
func (s msgServer) CompleteSecession(ctx interface{}, msg *types.MsgCompleteSecession) (*types.MsgCompleteSecessionResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
g, ok := s.Keeper.GetGuild(sdkCtx, msg.GuildID)
if !ok {
return nil, fmt.Errorf("guild: guild %q not found (CompleteSecession rejected)", msg.GuildID)
}
if !g.IsChapter {
return nil, fmt.Errorf("guild: guild %q is not a Chapter (a Parent Guild does not secede — REQ-064)", msg.GuildID)
}
if g.SecessionStartedAt == 0 {
return nil, fmt.Errorf("guild: chapter %q has not initiated secession (SecessionStartedAt=0 — call InitiateSecession first — REQ-064)", msg.GuildID)
}
// Cooling check (REQ-064): compute coolingSeconds based on whether the
// Chapter is Cover-active (any lien references a Cover Pool covenant).
// Cover-active: 21d. Non-Cover: 14d.
var coolingSeconds int64
coverActive := s.Keeper.ChapterIsCoverActive(sdkCtx, msg.GuildID)
if coverActive {
coolingSeconds = int64(types.CoolingSecessionCoverActiveDays) * 24 * 60 * 60
} else {
coolingSeconds = int64(types.CoolingSecessionNonCoverDays) * 24 * 60 * 60
}
now := sdkCtx.BlockTime().Unix()
if now-g.SecessionStartedAt < coolingSeconds {
return nil, fmt.Errorf("guild: secession cooling not elapsed (now=%d, SecessionStartedAt=%d, cooling=%d seconds, elapsed=%d — REQ-064)",
now, g.SecessionStartedAt, coolingSeconds, now-g.SecessionStartedAt)
}
// Lien audit: all liens must be Cleared (or Amount=0).
if !s.Keeper.CheckLiensCleared(sdkCtx, msg.GuildID) {
return nil, fmt.Errorf("guild: lien audit failed — outstanding liens remain (REQ-064 — all Good-Standing Liens must be cleared before secession completes)")
}
// Covenant clearance: the Msg's CovenantClearancePassed must be true
// (simtest-grade — the live Cover Pool covenant clearance is a v0.8+
// concern).
if !msg.CovenantClearancePassed {
return nil, fmt.Errorf("guild: covenant clearance failed (CovenantClearancePassed=false — REQ-064 — all Cover Pool covenants must be cleared before secession completes)")
}
// Pro-rata Cover-Fee settlement: emit the event with the settlement
// amount (the actual settlement is a v0.8+ Grain-ledger concern — the
// simtest-grade ProRataSettlementGrain on the Msg carries the amount).
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.pro_rata_settlement",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("pro_rata_settlement_grain", fmt.Sprintf("%d", msg.ProRataSettlementGrain)),
))
// Mark the Chapter as seceded.
g.SecededAt = now
s.Keeper.SetGuild(sdkCtx, g)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.secession_completed",
sdk.NewAttribute("guild_id", msg.GuildID),
sdk.NewAttribute("seceded_at", fmt.Sprintf("%d", g.SecededAt)),
sdk.NewAttribute("cooling_seconds", fmt.Sprintf("%d", coolingSeconds)),
sdk.NewAttribute("cover_active", fmt.Sprintf("%v", coverActive)),
))
return &types.MsgCompleteSecessionResponse{
CoolingSeconds: coolingSeconds,
ProRataSettlementGrain: msg.ProRataSettlementGrain,
}, nil
}
// EscalateStandToPier escalates a Stand to Pier-eligibility (REQ-059,
// D-074). The handler enforces:
// 1. ValidateBasic (stateless — non-empty StandID + AnnualPassVolumeCents
// > 0).
// 2. Compare AnnualPassVolumeCents against
// StandPierEscalationAnnualPassVolumeCents (the D-074 const, imported
// from x/stand/types — G-003-clean: consts are not structs).
// 3. If AnnualPassVolumeCents > the const: set the Stand-Pier-eligible
// flag (pier_eligible/ store: StandID -> true). Soft upgrade, not a
// ban — the Stand may decline (the flag is set + the event is emitted,
// but no enforcement follows; the Stand must separately accept via
// MsgAcceptPierInvitation). If the volume does NOT exceed the const:
// the flag is NOT set (the response PierEligible=false; the event is
// still emitted for observability).
// 4. Emit guild.stand_pier_eligible (with PierEligible=true) OR
// guild.stand_pier_escalation_below_threshold (with PierEligible=false).
func (s msgServer) EscalateStandToPier(ctx interface{}, msg *types.MsgEscalateStandToPier) (*types.MsgEscalateStandToPierResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
pierEligible := msg.AnnualPassVolumeCents > types.StandPierEscalationAnnualPassVolumeCents
if pierEligible {
s.Keeper.SetStandPierEligible(sdkCtx, msg.StandID, true)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.stand_pier_eligible",
sdk.NewAttribute("stand_id", msg.StandID),
sdk.NewAttribute("annual_pass_volume_cents", fmt.Sprintf("%d", msg.AnnualPassVolumeCents)),
sdk.NewAttribute("threshold_cents", fmt.Sprintf("%d", types.StandPierEscalationAnnualPassVolumeCents)),
))
} else {
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.stand_pier_escalation_below_threshold",
sdk.NewAttribute("stand_id", msg.StandID),
sdk.NewAttribute("annual_pass_volume_cents", fmt.Sprintf("%d", msg.AnnualPassVolumeCents)),
sdk.NewAttribute("threshold_cents", fmt.Sprintf("%d", types.StandPierEscalationAnnualPassVolumeCents)),
))
}
return &types.MsgEscalateStandToPierResponse{PierEligible: pierEligible}, nil
}
// AcceptPierInvitation records a Stand's acceptance of a Pier invitation
// (REQ-059, D-074). The handler enforces:
// 1. ValidateBasic (stateless).
// 2. The Stand must be Pier-eligible (the flag set by
// MsgEscalateStandToPier). If not, REJECT.
// 3. Record the acceptance (pier_accepted/ store: StandID -> true). Emit
// guild.stand_pier_accepted.
func (s msgServer) AcceptPierInvitation(ctx interface{}, msg *types.MsgAcceptPierInvitation) (*types.MsgAcceptPierInvitationResponse, error) {
if err := msg.ValidateBasic(); err != nil {
return nil, err
}
sdkCtx := unwrapCtx(ctx)
if !s.Keeper.GetStandPierEligible(sdkCtx, msg.StandID) {
return nil, fmt.Errorf("guild: stand %q is not Pier-eligible (call EscalateStandToPier first — REQ-059/D-074)", msg.StandID)
}
s.Keeper.SetStandPierAccepted(sdkCtx, msg.StandID, true)
sdkCtx.EventManager().EmitEvent(sdk.NewEvent(
"guild.stand_pier_accepted",
sdk.NewAttribute("stand_id", msg.StandID),
))
return &types.MsgAcceptPierInvitationResponse{}, nil
}
File diff suppressed because it is too large Load Diff
+89
View File
@@ -0,0 +1,89 @@
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{}
+104
View File
@@ -0,0 +1,104 @@
package guild_test
// module_test.go exercises the x/guild AppModule (D-054 simtest-grade).
// The AppModule wraps the Keeper + exposes the MsgServer; this test
// constructs an AppModule with nil shims + asserts Name, ConsensusVersion,
// MsgServer, InitGenesis, ExportGenesis. Coverage target: the module.go
// surface.
import (
"encoding/json"
"testing"
"cosmossdk.io/log"
"cosmossdk.io/store"
storetypes "cosmossdk.io/store/types"
cmtproto "github.com/cometbft/cometbft/proto/tendermint/types"
dbm "github.com/cosmos/cosmos-db"
"github.com/cosmos/cosmos-sdk/codec"
codectypes "github.com/cosmos/cosmos-sdk/codec/types"
sdk "github.com/cosmos/cosmos-sdk/types"
"github.com/oy/openyield/x/guild"
"github.com/oy/openyield/x/guild/types"
)
func newModuleTestContext(t *testing.T) (sdk.Context, guild.AppModule, codec.Codec) {
t.Helper()
db := dbm.NewMemDB()
cdc := newModuleTestCodec()
storeKey := storetypes.NewKVStoreKey(types.StoreKey)
cms := store.NewCommitMultiStore(db, log.NewNopLogger(), nil)
cms.MountStoreWithDB(storeKey, storetypes.StoreTypeDB, nil)
if err := cms.LoadLatestVersion(); err != nil {
t.Fatalf("load latest version: %v", err)
}
ctx := sdk.NewContext(cms, cmtproto.Header{}, false, log.NewNopLogger())
am := guild.NewAppModule(cdc, storeKey, nil, nil)
return ctx, am, cdc
}
func newModuleTestCodec() codec.Codec {
registry := codectypes.NewInterfaceRegistry()
return codec.NewProtoCodec(registry)
}
// TestAppModuleName asserts the module name.
func TestAppModuleName(t *testing.T) {
_, am, _ := newModuleTestContext(t)
if am.Name() != types.ModuleName {
t.Errorf("Name = %q, want %q", am.Name(), types.ModuleName)
}
}
// TestAppModuleConsensusVersion asserts ConsensusVersion == 1.
func TestAppModuleConsensusVersion(t *testing.T) {
_, am, _ := newModuleTestContext(t)
if am.ConsensusVersion() != guild.ConsensusVersion {
t.Errorf("ConsensusVersion = %d, want %d", am.ConsensusVersion(), guild.ConsensusVersion)
}
if guild.ConsensusVersion != 1 {
t.Errorf("ConsensusVersion const = %d, want 1", guild.ConsensusVersion)
}
}
// TestAppModuleMsgServer asserts MsgServer returns a non-nil MsgServer.
func TestAppModuleMsgServer(t *testing.T) {
_, am, _ := newModuleTestContext(t)
srv := am.MsgServer()
if srv == nil {
t.Fatal("MsgServer() returned nil")
}
}
// TestAppModuleInitExportGenesis asserts InitGenesis + ExportGenesis round-
// trip an empty genesis.
func TestAppModuleInitExportGenesis(t *testing.T) {
ctx, am, cdc := newModuleTestContext(t)
empty := types.DefaultGenesisState()
data := cdc.MustMarshalJSON(empty)
am.InitGenesis(ctx, cdc, data)
exported := am.ExportGenesis(ctx, cdc)
if len(exported) == 0 {
t.Fatal("ExportGenesis returned empty bytes")
}
var gs types.GenesisState
if err := json.Unmarshal(exported, &gs); err != nil {
t.Fatalf("ExportGenesis bytes not valid JSON: %v", err)
}
}
// TestAppModuleRegisterServicesNoPanic asserts RegisterServices does not
// panic with a nil configurator (simtest-grade — the method is a no-op stub
// for the hand-rolled MsgServer wiring).
func TestAppModuleRegisterServicesNoPanic(t *testing.T) {
_, am, _ := newModuleTestContext(t)
defer func() {
if r := recover(); r != nil {
t.Errorf("RegisterServices panicked: %v", r)
}
}()
am.RegisterServices(nil)
}
+75
View File
@@ -0,0 +1,75 @@
package types
// expected_keepers.go holds the Go INTERFACES for the cross-module keepers
// x/guild depends on (G-003 firewall — ibc-go expected-keepers convention).
//
// The guild runtime (REQ-051, REQ-053, REQ-057, REQ-058) depends on TWO
// cross-module keepers:
//
// 1. x/stand (StandKeeper) — the OneTapExitStand handler asserts the named
// Stand is a Household (REQ-057) before dissolving it; the
// DelegateConfederationVoice handler asserts the named Stand is a
// Confederation (REQ-058) before recording the delegation. The handler
// queries GetStand for the Stand type (an opaque string — "Household" or
// "Confederation") and compares. This is the v0.7 P3 household-edge: the
// Guild module references a Stand by ID-string (G-003 — no struct import
// of x/stand/types).
//
// 2. x/stash (StashKeeper) — the OneTapExitStand handler returns the
// dissolved Household Stand's assets to the Holder's Stash (REQ-057).
// The handler calls ReturnAssetsToHolder; the simtest stub records the
// call for assertion (no actual asset transfer in simtest).
//
// Both dependencies are expressed as INTERFACES defined HERE (in
// x/guild/types), NOT as struct imports of any x/<module>/types. The
// concrete keepers (or simtest stubs) satisfy these interfaces structurally
// (the P3 simtest wires stubs per G-003 test exemption); the handler depends
// on the interface, preserving G-003's intent (no cross-module struct
// coupling, no import cycles).
//
// Lexicon note (REQ-012): "Guild", "Chapter", "Stand", "Household",
// "Confederation", "Stash", "Holder", "Reach", "Voice" are all lexicon-clean.
// The project-wide 10 banned terms NEVER appear (enforced by lexicon_meta +
// the per-package lexicon assertion in types_test.go).
// StandKeeper is the expected-keeper interface for x/stand (G-003). The
// OneTapExitStand handler calls GetStand to assert the Stand type is
// "Household" (REQ-057 — one-tap exit is Household-only). The
// DelegateConfederationVoice handler calls GetStand to assert the Stand type
// is "Confederation" (REQ-058). The standType string is the opaque Stand
// type name (cross-doc to x/stand.StandType — "Household", "Confederation",
// etc.); the handler compares the string.
//
// No struct import of x/stand/types — the interface is the by-ID-string
// boundary (G-003). The standID is an opaque string. A nil StandKeeper
// REJECTS the OneTapExitStand + DelegateConfederationVoice handlers (the
// type check is load-bearing — a nil shim is a wiring error, NOT a simtest
// skip path; the household/confederation type check cannot be skipped).
type StandKeeper interface {
// GetStand returns the Stand type string + exists flag for the named
// Stand (by-ID-string). The OneTapExitStand handler compares the
// returned type against "Household"; the
// DelegateConfederationVoice handler compares against "Confederation".
// A non-existent Stand returns ("", false) — the handler REJECTS.
GetStand(standID string) (standType string, exists bool)
}
// StashKeeper is the expected-keeper interface for x/stash (G-003). The
// OneTapExitStand handler calls ReturnAssetsToHolder to return the dissolved
// Household Stand's assets to the Holder's Stash (REQ-057). The simtest stub
// records the call for assertion (no actual asset transfer in simtest — the
// simtest documents the wiring contract).
//
// No struct import of x/stash/types — the interface is the by-ID-string
// boundary (G-003). The holderReachID + standID are opaque strings. A nil
// StashKeeper skips the asset return (simtest wiring — the handler still
// emits the dissolution event; the asset return is a side-effect the simtest
// stub records).
type StashKeeper interface {
// ReturnAssetsToHolder returns the named Stand's assets to the named
// Holder's Stash. The OneTapExitStand handler calls this on a Household
// dissolution (REQ-057). A non-nil error REJECTS the dissolution (the
// asset return is load-bearing — a failed return leaves the Stand
// intact).
ReturnAssetsToHolder(holderReachID string, standID string) error
}
+712
View File
@@ -0,0 +1,712 @@
package types
// msg_guild.go holds the x/guild Msg* types implementing sdk.Msg (REQ-051,
// REQ-053, REQ-057, REQ-058). G-006 controlled exception: types/ gains the
// cosmos-sdk import for sdk.Msg (mirrors x/cover/types/msg_cover.go — D-055;
// the invariant/lexicon tests in *_test.go stay stdlib-only per G-024,
// isolated from this msg_*.go file).
//
// The five P3 Guild Msg types drive the Guild Charter + Chapter Federation +
// Household + Confederation runtime:
// - MsgCreateGuild: create a Guild with a Common Bond hash + Public Profile
// (REQ-051). The handler persists the Guild + surfaces a jurisdictional
// disclaimer (REQ-061).
// - MsgCreateChapter: create a Chapter under a Parent Guild (REQ-053). The
// handler pins the SecessionTerms hash + records the Good-Standing Liens
// (SecuredAtFounding=true) + rejects cooling below the protocol minimum
// + surfaces a jurisdictional disclaimer (REQ-061).
// - MsgOneTapExitStand: one-tap exit a Household Stand (REQ-057). The
// handler asserts the Stand type is Household via the StandKeeper shim +
// dissolves the Stand + returns assets to the Holder's Stash.
// - MsgDelegateConfederationVoice: delegate a member Stand's Voice in a
// Confederation (REQ-058). The handler asserts the Stand type is
// Confederation via the StandKeeper shim + records the delegation (one
// delegation per member Stand — duplicate REJECTED).
// - MsgAddLien: add a Good-Standing Lien to a Guild (REQ-053). The handler
// rejects any new SecuredAtFounding=true lien (founding is a one-time
// event — REQ-053/REQ-081).
//
// All cross-module refs are by-ID-string (G-003): founder-reach refs an
// x/identity Reach; stand-id refs an x/stand Stand; parent-guild-id refs a
// Guild; cover-pool-covenant-ref refs a Cover Pool covenant. No struct
// imports of x/stand/types or x/stash/types (the shims are interfaces
// defined in expected_keepers.go — G-003 preserved).
//
// Lexicon note (REQ-012): the message names + field names use the safe Guild
// vocabulary EXCLUSIVELY. "Guild", "Chapter", "Parent Guild", "Common Bond",
// "Public Profile", "Good-Standing Lien", "Secession Terms", "Household",
// "Confederation", "Hand-Pass" are the clean names; the project-wide 10
// banned terms NEVER appear (enforced by lexicon_meta + the per-package
// lexicon assertion in types_test.go).
import (
"fmt"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgCreateGuild -----------------------------------------------------------
// MsgCreateGuild creates a Guild with a Common Bond hash + Public Profile
// (REQ-051). The handler persists the Guild + surfaces a jurisdictional
// disclaimer (REQ-061 — the Disclaimer string is in the response).
//
// ValidateBasic is stateless: non-empty fields + non-empty CommonBondHash.
type MsgCreateGuild struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
Name string `json:"name" yaml:"name"`
FounderReach string `json:"founder_reach" yaml:"founder_reach"`
StandAffiliationID string `json:"stand_affiliation_id,omitempty" yaml:"stand_affiliation_id,omitempty"`
CommonBondHash []byte `json:"common_bond_hash" yaml:"common_bond_hash"`
PublicProfile GuildPublicProfile `json:"public_profile" yaml:"public_profile"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgCreateGuild) Reset() { *m = MsgCreateGuild{} }
// String implements proto.Message.
func (m *MsgCreateGuild) String() string {
return fmt.Sprintf("MsgCreateGuild{GuildID:%s Name:%s FounderReach:%s StandAffiliationID:%s Signer:%s}",
m.GuildID, m.Name, m.FounderReach, m.StandAffiliationID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgCreateGuild) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty guild-id, name,
// founder-reach, signer, non-empty CommonBondHash.
func (m *MsgCreateGuild) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("guild: empty guild-id")
}
if m.Name == "" {
return fmt.Errorf("guild: empty name")
}
if m.FounderReach == "" {
return fmt.Errorf("guild: empty founder-reach")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
if len(m.CommonBondHash) == 0 {
return fmt.Errorf("guild: empty common-bond-hash (REQ-051 — hash-pinned at creation)")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgCreateGuild) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgCreateChapter ---------------------------------------------------------
// MsgCreateChapter creates a Chapter under a Parent Guild (REQ-053). The
// handler pins the SecessionTerms hash (HashSecessionTerms) + records the
// Good-Standing Liens (SecuredAtFounding=true) + rejects cooling below the
// protocol minimum (CoolingSecessionCoverActiveDays / NonCoverDays) +
// surfaces a jurisdictional disclaimer (REQ-061).
//
// ValidateBasic is stateless: non-empty fields, non-empty ParentGuildID,
// SecessionTerms valid (non-zero + protocol-minimum-bounded via
// SecessionTerms.Validate), each GoodStandingLien has SecuredAtFounding=true
// + non-empty CreditorReachID + Amount > 0.
type MsgCreateChapter struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
Name string `json:"name" yaml:"name"`
ParentGuildID string `json:"parent_guild_id" yaml:"parent_guild_id"`
FounderReach string `json:"founder_reach" yaml:"founder_reach"`
SecessionTerms SecessionTerms `json:"secession_terms" yaml:"secession_terms"`
GoodStandingLiens []Lien `json:"good_standing_liens" yaml:"good_standing_liens"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgCreateChapter) Reset() { *m = MsgCreateChapter{} }
// String implements proto.Message.
func (m *MsgCreateChapter) String() string {
return fmt.Sprintf("MsgCreateChapter{GuildID:%s Name:%s ParentGuildID:%s FounderReach:%s SecessionTerms:%+v Liens:%d Signer:%s}",
m.GuildID, m.Name, m.ParentGuildID, m.FounderReach, m.SecessionTerms, len(m.GoodStandingLiens), m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgCreateChapter) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields, non-empty
// ParentGuildID, SecessionTerms valid, each GoodStandingLien is
// SecuredAtFounding=true with non-empty CreditorReachID + Amount > 0
// (founding-locked liens are recorded ONCE at founding — REQ-053).
func (m *MsgCreateChapter) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("guild: empty chapter guild-id")
}
if m.Name == "" {
return fmt.Errorf("guild: empty chapter name")
}
if m.ParentGuildID == "" {
return fmt.Errorf("guild: empty parent-guild-id (REQ-053 — Chapter requires a Parent)")
}
if m.ParentGuildID == m.GuildID {
return fmt.Errorf("guild: Chapter %q cannot be its own parent", m.GuildID)
}
if m.FounderReach == "" {
return fmt.Errorf("guild: empty founder-reach")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
if err := m.SecessionTerms.Validate(); err != nil {
return fmt.Errorf("guild: secession terms: %w", err)
}
for i, l := range m.GoodStandingLiens {
if !l.SecuredAtFounding {
return fmt.Errorf("guild: GoodStandingLien[%d] has SecuredAtFounding=false (founding liens must be secured at founding — REQ-053)", i)
}
if l.CreditorReachID == "" {
return fmt.Errorf("guild: GoodStandingLien[%d] has empty CreditorReachID", i)
}
if l.Amount <= 0 {
return fmt.Errorf("guild: GoodStandingLien[%d] Amount %d <= 0", i, l.Amount)
}
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgCreateChapter) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgOneTapExitStand -------------------------------------------------------
// MsgOneTapExitStand one-tap exits a Household Stand (REQ-057). The handler
// asserts the Stand type is Household via the StandKeeper shim + dissolves
// the Stand + returns assets to the Holder's Stash via the StashKeeper shim.
// One-tap exit is the Household dispute path (no Council vote required —
// Household skips the formal-Council requirement).
//
// ValidateBasic is stateless: non-empty stand-id + signer.
type MsgOneTapExitStand struct {
StandID string `json:"stand_id" yaml:"stand_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgOneTapExitStand) Reset() { *m = MsgOneTapExitStand{} }
// String implements proto.Message.
func (m *MsgOneTapExitStand) String() string {
return fmt.Sprintf("MsgOneTapExitStand{StandID:%s Signer:%s}", m.StandID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgOneTapExitStand) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty stand-id + signer.
func (m *MsgOneTapExitStand) ValidateBasic() error {
if m.StandID == "" {
return fmt.Errorf("guild: empty stand-id")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgOneTapExitStand) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgDelegateConfederationVoice --------------------------------------------
// MsgDelegateConfederationVoice delegates a member Stand's Voice in a
// Confederation (REQ-058). The handler asserts the ConfederationStandID
// references a Confederation Stand via the StandKeeper shim + records the
// delegation (one delegation per member Stand — a duplicate delegation from
// the same MemberStandID is REJECTED). One-Stand-one-Vote: each member Stand
// gets exactly 1 Voice in the Confederation's aggregate, regardless of size.
//
// ValidateBasic is stateless: non-empty fields.
type MsgDelegateConfederationVoice struct {
ConfederationStandID string `json:"confederation_stand_id" yaml:"confederation_stand_id"`
MemberStandID string `json:"member_stand_id" yaml:"member_stand_id"`
DelegateReachID string `json:"delegate_reach_id" yaml:"delegate_reach_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgDelegateConfederationVoice) Reset() { *m = MsgDelegateConfederationVoice{} }
// String implements proto.Message.
func (m *MsgDelegateConfederationVoice) String() string {
return fmt.Sprintf("MsgDelegateConfederationVoice{ConfederationStandID:%s MemberStandID:%s DelegateReachID:%s Signer:%s}",
m.ConfederationStandID, m.MemberStandID, m.DelegateReachID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgDelegateConfederationVoice) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty fields.
func (m *MsgDelegateConfederationVoice) ValidateBasic() error {
if m.ConfederationStandID == "" {
return fmt.Errorf("guild: empty confederation-stand-id")
}
if m.MemberStandID == "" {
return fmt.Errorf("guild: empty member-stand-id")
}
if m.DelegateReachID == "" {
return fmt.Errorf("guild: empty delegate-reach-id")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
if m.ConfederationStandID == m.MemberStandID {
return fmt.Errorf("guild: ConfederationStandID %q cannot delegate to itself", m.ConfederationStandID)
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgDelegateConfederationVoice) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgAddLien ---------------------------------------------------------------
// MsgAddLien adds a Good-Standing Lien to a Guild (REQ-053). The handler
// rejects any new SecuredAtFounding=true lien (founding is a one-time event —
// REQ-053/REQ-081; post-founding liens are SecuredAtFounding=false). The
// handler loads the Guild + persists the lien.
//
// ValidateBasic is stateless: non-empty guild-id, non-empty signer, Lien
// Amount > 0, non-empty CreditorReachID.
type MsgAddLien struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
Lien Lien `json:"lien" yaml:"lien"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgAddLien) Reset() { *m = MsgAddLien{} }
// String implements proto.Message.
func (m *MsgAddLien) String() string {
return fmt.Sprintf("MsgAddLien{GuildID:%s Lien:{Amount:%d CreditorReachID:%s SecuredAtFounding:%v} Signer:%s}",
m.GuildID, m.Lien.Amount, m.Lien.CreditorReachID, m.Lien.SecuredAtFounding, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgAddLien) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty guild-id + signer,
// Lien Amount > 0, non-empty CreditorReachID.
func (m *MsgAddLien) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("guild: empty guild-id")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
if m.Lien.Amount <= 0 {
return fmt.Errorf("guild: lien Amount %d <= 0", m.Lien.Amount)
}
if m.Lien.CreditorReachID == "" {
return fmt.Errorf("guild: empty lien CreditorReachID")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgAddLien) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- P5: Secession + Stand→Pier Escalation Msg types (REQ-064, REQ-059) --------
//
// (REQ-064 secession cooling enforcement, REQ-059/D-074 Stand→Pier boundary.)
// The four P5 Msg types drive the secession lifecycle + the Stand→Pier
// escalation:
// - MsgInitiateSecession: a Chapter initiates secession (the handler loads
// the Chapter, sets SecessionStartedAt=now, invokes the lien audit).
// - MsgCompleteSecession: a Chapter completes secession after the cooling
// period (Cover-active 21d, non-Cover 14d), the lien audit, and the
// covenant clearance. The handler sets SecededAt=now + emits a pro-rata
// settlement event.
// - MsgEscalateStandToPier: a Stand's annual Pass volume exceeds the
// StandPierEscalationAnnualPassVolumeCents const (D-074 — 10M Grain-cents
// simtest placeholder for $100k USD) — the handler sets a Stand-Pier-
// eligible flag (soft upgrade — the Stand may decline).
// - MsgAcceptPierInvitation: a Stand accepts the Pier invitation (the
// handler checks the eligibility flag + records the acceptance).
//
// All cross-module refs are by-ID-string (G-003). The
// StandPierEscalationAnnualPassVolumeCents const lives in x/stand/types
// (type ownership) and is imported by x/guild/keeper (the handler) — consts
// are G-003-clean (only struct imports are forbidden).
//
// Lexicon note (REQ-012): "Secession", "Cooling", "Lien Audit", "Covenant
// Clearance", "Pro-rata Settlement", "Stand→Pier Escalation", "Pier
// Invitation" are lexicon-clean.
// MsgInitiateSecession initiates a Chapter's secession (REQ-064). The
// handler loads the Chapter (must be IsChapter=true), sets
// SecessionStartedAt=now, + invokes the lien audit (a simtest-grade
// helper that returns true if all GoodStandingLiens are Cleared or
// Amount=0). The handler REJECTS a non-Chapter Guild + a Chapter that has
// already initiated (SecessionStartedAt > 0).
//
// ValidateBasic is stateless: non-empty GuildID + Signer.
type MsgInitiateSecession struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgInitiateSecession) Reset() { *m = MsgInitiateSecession{} }
// String implements proto.Message.
func (m *MsgInitiateSecession) String() string {
return fmt.Sprintf("MsgInitiateSecession{GuildID:%s Signer:%s}", m.GuildID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgInitiateSecession) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty GuildID + Signer.
func (m *MsgInitiateSecession) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("guild: empty guild-id")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgInitiateSecession) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// MsgCompleteSecession completes a Chapter's secession (REQ-064). The
// handler enforces:
// 1. The Chapter must exist + be IsChapter=true.
// 2. SecessionStartedAt > 0 (secession was initiated).
// 3. Cooling check: now >= SecessionStartedAt + coolingSeconds where
// coolingSeconds = CoolingSecessionCoverActiveDays*86400 (21d) if the
// Chapter is Cover-active (any lien references a Cover Pool covenant),
// else CoolingSecessionNonCoverDays*86400 (14d).
// 4. Lien audit: all GoodStandingLiens must be Cleared (or Amount=0).
// 5. Covenant clearance: the Cover Pool covenants must be cleared (a
// simtest-grade CovenantClearancePassed bool on the Msg; if false,
// REJECT).
// 6. Pro-rata Cover-Fee settlement: emit guild.pro_rata_settlement with
// the settlement amount (the actual settlement is a v0.8+ Grain-ledger
// concern — the simtest-grade ProRataSettlementGrain field on the Msg
// carries the amount for the event).
// 7. Set SecededAt=now. Emit guild.secession_completed.
//
// ValidateBasic is stateless: non-empty GuildID + Signer.
type MsgCompleteSecession struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
CovenantClearancePassed bool `json:"covenant_clearance_passed" yaml:"covenant_clearance_passed"`
ProRataSettlementGrain int64 `json:"pro_rata_settlement_grain,omitempty" yaml:"pro_rata_settlement_grain,omitempty"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgCompleteSecession) Reset() { *m = MsgCompleteSecession{} }
// String implements proto.Message.
func (m *MsgCompleteSecession) String() string {
return fmt.Sprintf("MsgCompleteSecession{GuildID:%s CovenantClearancePassed:%v ProRataSettlementGrain:%d Signer:%s}",
m.GuildID, m.CovenantClearancePassed, m.ProRataSettlementGrain, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgCompleteSecession) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty GuildID + Signer.
func (m *MsgCompleteSecession) ValidateBasic() error {
if m.GuildID == "" {
return fmt.Errorf("guild: empty guild-id")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgCompleteSecession) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// MsgEscalateStandToPier escalates a Stand to Pier-eligibility (REQ-059,
// D-074). The handler checks AnnualPassVolumeCents >
// StandPierEscalationAnnualPassVolumeCents (10M Grain-cents — the D-074
// simtest placeholder for $100k USD); if so, sets a Stand-Pier-eligible
// flag (a pier_eligible/ store keyed by StandID). Soft upgrade, not a ban
// — the Stand may decline (the eligibility flag is set + the event is
// emitted, but no enforcement follows; the Stand must separately accept
// via MsgAcceptPierInvitation).
//
// ValidateBasic is stateless: non-empty StandID + AnnualPassVolumeCents > 0.
type MsgEscalateStandToPier struct {
StandID string `json:"stand_id" yaml:"stand_id"`
AnnualPassVolumeCents int64 `json:"annual_pass_volume_cents" yaml:"annual_pass_volume_cents"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgEscalateStandToPier) Reset() { *m = MsgEscalateStandToPier{} }
// String implements proto.Message.
func (m *MsgEscalateStandToPier) String() string {
return fmt.Sprintf("MsgEscalateStandToPier{StandID:%s AnnualPassVolumeCents:%d Signer:%s}",
m.StandID, m.AnnualPassVolumeCents, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgEscalateStandToPier) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty StandID +
// AnnualPassVolumeCents > 0 + non-empty Signer.
func (m *MsgEscalateStandToPier) ValidateBasic() error {
if m.StandID == "" {
return fmt.Errorf("guild: empty stand-id")
}
if m.AnnualPassVolumeCents <= 0 {
return fmt.Errorf("guild: AnnualPassVolumeCents %d <= 0", m.AnnualPassVolumeCents)
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgEscalateStandToPier) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// MsgAcceptPierInvitation records a Stand's acceptance of a Pier invitation
// (REQ-059, D-074). The handler checks the Stand is Pier-eligible (the
// flag set by MsgEscalateStandToPier); if not, REJECT. Records the
// acceptance (a pier_accepted/ store keyed by StandID). Emit
// guild.stand_pier_accepted.
//
// ValidateBasic is stateless: non-empty StandID + Signer.
type MsgAcceptPierInvitation struct {
StandID string `json:"stand_id" yaml:"stand_id"`
Signer string `json:"signer" yaml:"signer"`
}
// Reset implements proto.Message.
func (m *MsgAcceptPierInvitation) Reset() { *m = MsgAcceptPierInvitation{} }
// String implements proto.Message.
func (m *MsgAcceptPierInvitation) String() string {
return fmt.Sprintf("MsgAcceptPierInvitation{StandID:%s Signer:%s}", m.StandID, m.Signer)
}
// ProtoMessage implements proto.Message.
func (*MsgAcceptPierInvitation) ProtoMessage() {}
// ValidateBasic is the stateless validation: non-empty StandID + Signer.
func (m *MsgAcceptPierInvitation) ValidateBasic() error {
if m.StandID == "" {
return fmt.Errorf("guild: empty stand-id")
}
if m.Signer == "" {
return fmt.Errorf("guild: empty signer")
}
return nil
}
// GetSigners returns the signer's reach-id as sdk.AccAddress bytes.
func (m *MsgAcceptPierInvitation) GetSigners() []sdk.AccAddress {
return []sdk.AccAddress{[]byte(m.Signer)}
}
// --- MsgServer interface + Response types -------------------------------------
// MsgServer is the guild module's message server interface (one method per
// Msg*). The keeper's msg_server.go implements this; module.go's
// RegisterServices wires the implementation. Hand-rolled (no protobuf
// codegen per the skeleton's zero-codegen style).
type MsgServer interface {
CreateGuild(ctx interface{}, msg *MsgCreateGuild) (*MsgCreateGuildResponse, error)
CreateChapter(ctx interface{}, msg *MsgCreateChapter) (*MsgCreateChapterResponse, error)
OneTapExitStand(ctx interface{}, msg *MsgOneTapExitStand) (*MsgOneTapExitStandResponse, error)
DelegateConfederationVoice(ctx interface{}, msg *MsgDelegateConfederationVoice) (*MsgDelegateConfederationVoiceResponse, error)
AddLien(ctx interface{}, msg *MsgAddLien) (*MsgAddLienResponse, error)
// v0.7 P5 Secession + Stand→Pier escalation handlers (REQ-064, REQ-059,
// D-074) — defined above.
InitiateSecession(ctx interface{}, msg *MsgInitiateSecession) (*MsgInitiateSecessionResponse, error)
CompleteSecession(ctx interface{}, msg *MsgCompleteSecession) (*MsgCompleteSecessionResponse, error)
EscalateStandToPier(ctx interface{}, msg *MsgEscalateStandToPier) (*MsgEscalateStandToPierResponse, error)
AcceptPierInvitation(ctx interface{}, msg *MsgAcceptPierInvitation) (*MsgAcceptPierInvitationResponse, error)
}
// --- Response types -----------------------------------------------------------
//
// Hand-rolled (no protobuf codegen). The CreateGuild + CreateChapter
// responses carry a Disclaimer string (REQ-061 — the jurisdictional
// disclaimer surfaced at every charter signing). The other responses are
// empty bodies (the response is the state mutation + event).
// MsgCreateGuildResponse is the response to MsgCreateGuild. Disclaimer is
// the jurisdictional disclaimer surfaced at signing (REQ-061).
type MsgCreateGuildResponse struct {
Disclaimer string `json:"disclaimer" yaml:"disclaimer"`
}
// Reset implements proto.Message.
func (m *MsgCreateGuildResponse) Reset() { *m = MsgCreateGuildResponse{} }
// String implements proto.Message.
func (m *MsgCreateGuildResponse) String() string {
return fmt.Sprintf("MsgCreateGuildResponse{Disclaimer:%s}", m.Disclaimer)
}
// ProtoMessage implements proto.Message.
func (*MsgCreateGuildResponse) ProtoMessage() {}
// MsgCreateChapterResponse is the response to MsgCreateChapter. Disclaimer
// is the jurisdictional disclaimer surfaced at signing (REQ-061).
type MsgCreateChapterResponse struct {
Disclaimer string `json:"disclaimer" yaml:"disclaimer"`
}
// Reset implements proto.Message.
func (m *MsgCreateChapterResponse) Reset() { *m = MsgCreateChapterResponse{} }
// String implements proto.Message.
func (m *MsgCreateChapterResponse) String() string {
return fmt.Sprintf("MsgCreateChapterResponse{Disclaimer:%s}", m.Disclaimer)
}
// ProtoMessage implements proto.Message.
func (*MsgCreateChapterResponse) ProtoMessage() {}
// MsgOneTapExitStandResponse is the response to MsgOneTapExitStand.
type MsgOneTapExitStandResponse struct{}
// Reset implements proto.Message.
func (m *MsgOneTapExitStandResponse) Reset() { *m = MsgOneTapExitStandResponse{} }
// String implements proto.Message.
func (m *MsgOneTapExitStandResponse) String() string { return "MsgOneTapExitStandResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgOneTapExitStandResponse) ProtoMessage() {}
// MsgDelegateConfederationVoiceResponse is the response to
// MsgDelegateConfederationVoice.
type MsgDelegateConfederationVoiceResponse struct{}
// Reset implements proto.Message.
func (m *MsgDelegateConfederationVoiceResponse) Reset() {
*m = MsgDelegateConfederationVoiceResponse{}
}
// String implements proto.Message.
func (m *MsgDelegateConfederationVoiceResponse) String() string {
return "MsgDelegateConfederationVoiceResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgDelegateConfederationVoiceResponse) ProtoMessage() {}
// MsgAddLienResponse is the response to MsgAddLien.
type MsgAddLienResponse struct{}
// Reset implements proto.Message.
func (m *MsgAddLienResponse) Reset() { *m = MsgAddLienResponse{} }
// String implements proto.Message.
func (m *MsgAddLienResponse) String() string { return "MsgAddLienResponse{}" }
// ProtoMessage implements proto.Message.
func (*MsgAddLienResponse) ProtoMessage() {}
// --- P5 Response types --------------------------------------------------------
// MsgInitiateSecessionResponse is the response to MsgInitiateSecession.
// LienAuditPassed reports the lien-audit result at initiation (for simtest
// assertion: true = all liens cleared, false = outstanding liens remain —
// the handler still records SecessionStartedAt so the cooling clock starts;
// the lien audit is re-checked at completion).
type MsgInitiateSecessionResponse struct {
LienAuditPassed bool `json:"lien_audit_passed" yaml:"lien_audit_passed"`
}
// Reset implements proto.Message.
func (m *MsgInitiateSecessionResponse) Reset() { *m = MsgInitiateSecessionResponse{} }
// String implements proto.Message.
func (m *MsgInitiateSecessionResponse) String() string {
return fmt.Sprintf("MsgInitiateSecessionResponse{LienAuditPassed:%v}", m.LienAuditPassed)
}
// ProtoMessage implements proto.Message.
func (*MsgInitiateSecessionResponse) ProtoMessage() {}
// MsgCompleteSecessionResponse is the response to MsgCompleteSecession.
// CoolingSeconds reports the cooling period applied (for simtest assertion:
// 21d Cover-active, 14d non-Cover). ProRataSettlementGrain reports the
// pro-rata Cover-Fee settlement amount emitted in the event (a simtest-grade
// placeholder; the actual settlement is a v0.8+ Grain-ledger concern).
type MsgCompleteSecessionResponse struct {
CoolingSeconds int64 `json:"cooling_seconds" yaml:"cooling_seconds"`
ProRataSettlementGrain int64 `json:"pro_rata_settlement_grain" yaml:"pro_rata_settlement_grain"`
}
// Reset implements proto.Message.
func (m *MsgCompleteSecessionResponse) Reset() { *m = MsgCompleteSecessionResponse{} }
// String implements proto.Message.
func (m *MsgCompleteSecessionResponse) String() string {
return fmt.Sprintf("MsgCompleteSecessionResponse{CoolingSeconds:%d ProRataSettlementGrain:%d}",
m.CoolingSeconds, m.ProRataSettlementGrain)
}
// ProtoMessage implements proto.Message.
func (*MsgCompleteSecessionResponse) ProtoMessage() {}
// MsgEscalateStandToPierResponse is the response to MsgEscalateStandToPier.
// PierEligible reports whether the Stand was marked Pier-eligible (true when
// AnnualPassVolumeCents > StandPierEscalationAnnualPassVolumeCents; false
// otherwise — the handler still emits the event but does not set the flag).
type MsgEscalateStandToPierResponse struct {
PierEligible bool `json:"pier_eligible" yaml:"pier_eligible"`
}
// Reset implements proto.Message.
func (m *MsgEscalateStandToPierResponse) Reset() { *m = MsgEscalateStandToPierResponse{} }
// String implements proto.Message.
func (m *MsgEscalateStandToPierResponse) String() string {
return fmt.Sprintf("MsgEscalateStandToPierResponse{PierEligible:%v}", m.PierEligible)
}
// ProtoMessage implements proto.Message.
func (*MsgEscalateStandToPierResponse) ProtoMessage() {}
// MsgAcceptPierInvitationResponse is the response to MsgAcceptPierInvitation.
type MsgAcceptPierInvitationResponse struct{}
// Reset implements proto.Message.
func (m *MsgAcceptPierInvitationResponse) Reset() { *m = MsgAcceptPierInvitationResponse{} }
// String implements proto.Message.
func (m *MsgAcceptPierInvitationResponse) String() string {
return "MsgAcceptPierInvitationResponse{}"
}
// ProtoMessage implements proto.Message.
func (*MsgAcceptPierInvitationResponse) ProtoMessage() {}
+495
View File
@@ -0,0 +1,495 @@
package types
// msg_guild_test.go holds the Msg* method coverage tests for x/guild/types
// (REQ-051, REQ-053, REQ-057, REQ-058). The Msg* Reset/String/ProtoMessage/
// ValidateBasic/GetSigners methods are exercised here so the types package
// coverage is >=80% (the keeper simtest exercises the handlers but its
// coverage counts toward the keeper package, not types).
//
// G-024: this file imports cosmos-sdk for GetSigners (sdk.AccAddress) —
// this is a Msg-method test, NOT an invariant/lexicon test, so the G-024
// stdlib-only constraint does not apply (the invariant + lexicon assertions
// live in types_test.go, which stays stdlib + lexicon-only).
import (
"strings"
"testing"
sdk "github.com/cosmos/cosmos-sdk/types"
)
// --- MsgCreateGuild methods ---------------------------------------------------
func TestMsgCreateGuildMethods(t *testing.T) {
m := &MsgCreateGuild{
GuildID: "g1", Name: "Guild", FounderReach: "reach:f",
CommonBondHash: []byte{1, 2, 3},
PublicProfile: GuildPublicProfile{BondSummary: "s", MasonCount: 7},
Signer: "reach:f",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgCreateGuild ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "g1") {
t.Errorf("MsgCreateGuild String = %q, want to contain g1", m.String())
}
m.Reset()
if m.GuildID != "" || len(m.CommonBondHash) != 0 {
t.Errorf("MsgCreateGuild Reset did not zero: %+v", m)
}
m.ProtoMessage() // no-op coverage
m2 := &MsgCreateGuild{Signer: "reach:s"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "reach:s" {
t.Errorf("MsgCreateGuild GetSigners = %v, want [reach:s]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgCreateGuildValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
mut func(*MsgCreateGuild)
}{
{"empty guild-id", func(m *MsgCreateGuild) { m.GuildID = "" }},
{"empty name", func(m *MsgCreateGuild) { m.Name = "" }},
{"empty founder-reach", func(m *MsgCreateGuild) { m.FounderReach = "" }},
{"empty signer", func(m *MsgCreateGuild) { m.Signer = "" }},
{"empty common-bond-hash", func(m *MsgCreateGuild) { m.CommonBondHash = nil }},
}
for _, c := range cases {
m := &MsgCreateGuild{GuildID: "g", Name: "n", FounderReach: "r", CommonBondHash: []byte{1}, Signer: "s"}
c.mut(m)
if err := m.ValidateBasic(); err == nil {
t.Errorf("MsgCreateGuild %s: expected error, got nil", c.name)
}
}
}
// --- MsgCreateChapter methods -------------------------------------------------
func TestMsgCreateChapterMethods(t *testing.T) {
m := &MsgCreateChapter{
GuildID: "c1", Name: "Chapter", ParentGuildID: "g1", FounderReach: "reach:f",
SecessionTerms: SecessionTerms{
CoolingCoverActiveDays: CoolingSecessionCoverActiveDays,
CoolingNonCoverDays: CoolingSecessionNonCoverDays,
},
GoodStandingLiens: []Lien{{Amount: 100, CreditorReachID: "reach:c", SecuredAtFounding: true}},
Signer: "reach:f",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgCreateChapter ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "c1") || !strings.Contains(m.String(), "g1") {
t.Errorf("MsgCreateChapter String = %q", m.String())
}
m.Reset()
if m.GuildID != "" || m.ParentGuildID != "" {
t.Errorf("MsgCreateChapter Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgCreateChapter{Signer: "reach:s"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "reach:s" {
t.Errorf("MsgCreateChapter GetSigners = %v", got)
}
}
func TestMsgCreateChapterValidateBasicErrors(t *testing.T) {
validTerms := SecessionTerms{
CoolingCoverActiveDays: CoolingSecessionCoverActiveDays,
CoolingNonCoverDays: CoolingSecessionNonCoverDays,
}
validLiens := []Lien{{Amount: 100, CreditorReachID: "reach:c", SecuredAtFounding: true}}
cases := []struct {
name string
mut func(*MsgCreateChapter)
}{
{"empty guild-id", func(m *MsgCreateChapter) { m.GuildID = "" }},
{"empty name", func(m *MsgCreateChapter) { m.Name = "" }},
{"empty parent-guild-id", func(m *MsgCreateChapter) { m.ParentGuildID = "" }},
{"self parent", func(m *MsgCreateChapter) { m.ParentGuildID = m.GuildID }},
{"empty founder-reach", func(m *MsgCreateChapter) { m.FounderReach = "" }},
{"empty signer", func(m *MsgCreateChapter) { m.Signer = "" }},
{"loose cooling (cover)", func(m *MsgCreateChapter) {
m.SecessionTerms.CoolingCoverActiveDays = CoolingSecessionCoverActiveDays - 1
}},
{"loose cooling (non-cover)", func(m *MsgCreateChapter) {
m.SecessionTerms.CoolingNonCoverDays = CoolingSecessionNonCoverDays - 1
}},
{"zero cooling (cover)", func(m *MsgCreateChapter) { m.SecessionTerms.CoolingCoverActiveDays = 0 }},
{"lien not secured at founding", func(m *MsgCreateChapter) {
m.GoodStandingLiens = []Lien{{Amount: 100, CreditorReachID: "reach:c", SecuredAtFounding: false}}
}},
{"lien empty creditor", func(m *MsgCreateChapter) {
m.GoodStandingLiens = []Lien{{Amount: 100, CreditorReachID: "", SecuredAtFounding: true}}
}},
{"lien zero amount", func(m *MsgCreateChapter) {
m.GoodStandingLiens = []Lien{{Amount: 0, CreditorReachID: "reach:c", SecuredAtFounding: true}}
}},
}
for _, c := range cases {
m := &MsgCreateChapter{
GuildID: "c", Name: "n", ParentGuildID: "g", FounderReach: "r",
SecessionTerms: validTerms, GoodStandingLiens: validLiens, Signer: "s",
}
c.mut(m)
if err := m.ValidateBasic(); err == nil {
t.Errorf("MsgCreateChapter %s: expected error, got nil", c.name)
}
}
}
// --- MsgOneTapExitStand methods -----------------------------------------------
func TestMsgOneTapExitStandMethods(t *testing.T) {
m := &MsgOneTapExitStand{StandID: "s1", Signer: "reach:h"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgOneTapExitStand ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "s1") {
t.Errorf("MsgOneTapExitStand String = %q", m.String())
}
m.Reset()
if m.StandID != "" {
t.Errorf("MsgOneTapExitStand Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgOneTapExitStand{Signer: "reach:s"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "reach:s" {
t.Errorf("MsgOneTapExitStand GetSigners = %v", got)
}
}
func TestMsgOneTapExitStandValidateBasicErrors(t *testing.T) {
if err := (&MsgOneTapExitStand{}).ValidateBasic(); err == nil {
t.Error("empty MsgOneTapExitStand should fail ValidateBasic")
}
if err := (&MsgOneTapExitStand{StandID: "s"}).ValidateBasic(); err == nil {
t.Error("MsgOneTapExitStand with empty signer should fail ValidateBasic")
}
if err := (&MsgOneTapExitStand{Signer: "s"}).ValidateBasic(); err == nil {
t.Error("MsgOneTapExitStand with empty stand-id should fail ValidateBasic")
}
}
// --- MsgDelegateConfederationVoice methods ------------------------------------
func TestMsgDelegateConfederationVoiceMethods(t *testing.T) {
m := &MsgDelegateConfederationVoice{
ConfederationStandID: "conf-1", MemberStandID: "mem-1",
DelegateReachID: "reach:d", Signer: "reach:s",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgDelegateConfederationVoice ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "conf-1") {
t.Errorf("MsgDelegateConfederationVoice String = %q", m.String())
}
m.Reset()
if m.ConfederationStandID != "" {
t.Errorf("MsgDelegateConfederationVoice Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgDelegateConfederationVoice{Signer: "reach:s"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "reach:s" {
t.Errorf("MsgDelegateConfederationVoice GetSigners = %v", got)
}
}
func TestMsgDelegateConfederationVoiceValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
mut func(*MsgDelegateConfederationVoice)
}{
{"empty confederation", func(m *MsgDelegateConfederationVoice) { m.ConfederationStandID = "" }},
{"empty member", func(m *MsgDelegateConfederationVoice) { m.MemberStandID = "" }},
{"empty delegate", func(m *MsgDelegateConfederationVoice) { m.DelegateReachID = "" }},
{"empty signer", func(m *MsgDelegateConfederationVoice) { m.Signer = "" }},
{"self-delegate", func(m *MsgDelegateConfederationVoice) { m.MemberStandID = m.ConfederationStandID }},
}
for _, c := range cases {
m := &MsgDelegateConfederationVoice{
ConfederationStandID: "c", MemberStandID: "m",
DelegateReachID: "d", Signer: "s",
}
c.mut(m)
if err := m.ValidateBasic(); err == nil {
t.Errorf("MsgDelegateConfederationVoice %s: expected error", c.name)
}
}
}
// --- MsgAddLien methods -------------------------------------------------------
func TestMsgAddLienMethods(t *testing.T) {
m := &MsgAddLien{
GuildID: "g1",
Lien: Lien{Amount: 100, CreditorReachID: "reach:c", SecuredAtFounding: false},
Signer: "reach:s",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgAddLien ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "g1") {
t.Errorf("MsgAddLien String = %q", m.String())
}
m.Reset()
if m.GuildID != "" {
t.Errorf("MsgAddLien Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgAddLien{Signer: "reach:s"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "reach:s" {
t.Errorf("MsgAddLien GetSigners = %v", got)
}
}
func TestMsgAddLienValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
mut func(*MsgAddLien)
}{
{"empty guild-id", func(m *MsgAddLien) { m.GuildID = "" }},
{"empty signer", func(m *MsgAddLien) { m.Signer = "" }},
{"zero amount", func(m *MsgAddLien) { m.Lien.Amount = 0 }},
{"negative amount", func(m *MsgAddLien) { m.Lien.Amount = -1 }},
{"empty creditor", func(m *MsgAddLien) { m.Lien.CreditorReachID = "" }},
}
for _, c := range cases {
m := &MsgAddLien{
GuildID: "g", Lien: Lien{Amount: 100, CreditorReachID: "reach:c"}, Signer: "s",
}
c.mut(m)
if err := m.ValidateBasic(); err == nil {
t.Errorf("MsgAddLien %s: expected error", c.name)
}
}
}
// --- Response type methods ----------------------------------------------------
func TestResponseMethods(t *testing.T) {
r1 := &MsgCreateGuildResponse{Disclaimer: "d"}
if !strings.Contains(r1.String(), "d") {
t.Errorf("MsgCreateGuildResponse String = %q", r1.String())
}
r1.Reset()
if r1.Disclaimer != "" {
t.Errorf("MsgCreateGuildResponse Reset did not zero: %+v", r1)
}
r1.ProtoMessage()
r2 := &MsgCreateChapterResponse{Disclaimer: "d"}
if !strings.Contains(r2.String(), "d") {
t.Errorf("MsgCreateChapterResponse String = %q", r2.String())
}
r2.Reset()
if r2.Disclaimer != "" {
t.Errorf("MsgCreateChapterResponse Reset did not zero: %+v", r2)
}
r2.ProtoMessage()
for _, r := range []interface {
Reset()
String() string
ProtoMessage()
}{
&MsgOneTapExitStandResponse{},
&MsgDelegateConfederationVoiceResponse{},
&MsgAddLienResponse{},
} {
r.ProtoMessage()
_ = r.String()
r.Reset()
}
}
// --- P5: Secession + Stand→Pier escalation Msg methods (REQ-064, REQ-059) -----
func TestMsgInitiateSecessionMethods(t *testing.T) {
m := &MsgInitiateSecession{GuildID: "g1", Signer: "s1"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgInitiateSecession ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "g1") {
t.Errorf("MsgInitiateSecession String = %q, want g1", m.String())
}
m.Reset()
if m.GuildID != "" {
t.Errorf("MsgInitiateSecession Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgInitiateSecession{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgInitiateSecession GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgInitiateSecessionValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgInitiateSecession
}{
{"empty guild-id", MsgInitiateSecession{Signer: "s"}},
{"empty signer", MsgInitiateSecession{GuildID: "g"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
func TestMsgCompleteSecessionMethods(t *testing.T) {
m := &MsgCompleteSecession{
GuildID: "g1",
CovenantClearancePassed: true,
ProRataSettlementGrain: 5000,
Signer: "s1",
}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgCompleteSecession ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "g1") {
t.Errorf("MsgCompleteSecession String = %q, want g1", m.String())
}
m.Reset()
if m.GuildID != "" {
t.Errorf("MsgCompleteSecession Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgCompleteSecession{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgCompleteSecession GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgCompleteSecessionValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgCompleteSecession
}{
{"empty guild-id", MsgCompleteSecession{Signer: "s"}},
{"empty signer", MsgCompleteSecession{GuildID: "g"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
func TestMsgEscalateStandToPierMethods(t *testing.T) {
m := &MsgEscalateStandToPier{StandID: "s1", AnnualPassVolumeCents: 100, Signer: "signer"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgEscalateStandToPier ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "s1") {
t.Errorf("MsgEscalateStandToPier String = %q, want s1", m.String())
}
m.Reset()
if m.StandID != "" {
t.Errorf("MsgEscalateStandToPier Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgEscalateStandToPier{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgEscalateStandToPier GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgEscalateStandToPierValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgEscalateStandToPier
}{
{"empty stand-id", MsgEscalateStandToPier{AnnualPassVolumeCents: 100, Signer: "s"}},
{"zero volume", MsgEscalateStandToPier{StandID: "s", Signer: "signer"}},
{"negative volume", MsgEscalateStandToPier{StandID: "s", AnnualPassVolumeCents: -1, Signer: "signer"}},
{"empty signer", MsgEscalateStandToPier{StandID: "s", AnnualPassVolumeCents: 100}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
func TestMsgAcceptPierInvitationMethods(t *testing.T) {
m := &MsgAcceptPierInvitation{StandID: "s1", Signer: "signer"}
if err := m.ValidateBasic(); err != nil {
t.Errorf("valid MsgAcceptPierInvitation ValidateBasic: %v", err)
}
if !strings.Contains(m.String(), "s1") {
t.Errorf("MsgAcceptPierInvitation String = %q, want s1", m.String())
}
m.Reset()
if m.StandID != "" {
t.Errorf("MsgAcceptPierInvitation Reset did not zero: %+v", m)
}
m.ProtoMessage()
m2 := &MsgAcceptPierInvitation{Signer: "host-1"}
if got := m2.GetSigners(); len(got) != 1 || string(got[0]) != "host-1" {
t.Errorf("MsgAcceptPierInvitation GetSigners = %v, want [host-1]", got)
}
var _ []sdk.AccAddress = m2.GetSigners()
}
func TestMsgAcceptPierInvitationValidateBasicErrors(t *testing.T) {
cases := []struct {
name string
msg MsgAcceptPierInvitation
}{
{"empty stand-id", MsgAcceptPierInvitation{Signer: "s"}},
{"empty signer", MsgAcceptPierInvitation{StandID: "s"}},
}
for _, c := range cases {
if err := c.msg.ValidateBasic(); err == nil {
t.Errorf("case %q: ValidateBasic should fail", c.name)
}
}
}
// TestP5ResponseMethods exercises the P5 Msg* Response Reset/String/ProtoMessage
// methods for coverage.
func TestP5ResponseMethods(t *testing.T) {
r1 := &MsgInitiateSecessionResponse{LienAuditPassed: true}
if !strings.Contains(r1.String(), "MsgInitiateSecessionResponse") {
t.Errorf("MsgInitiateSecessionResponse String = %q", r1.String())
}
r1.Reset()
if r1.LienAuditPassed {
t.Errorf("MsgInitiateSecessionResponse Reset did not zero: %+v", r1)
}
r1.ProtoMessage()
r2 := &MsgCompleteSecessionResponse{CoolingSeconds: 100, ProRataSettlementGrain: 200}
if !strings.Contains(r2.String(), "MsgCompleteSecessionResponse") {
t.Errorf("MsgCompleteSecessionResponse String = %q", r2.String())
}
r2.Reset()
if r2.CoolingSeconds != 0 || r2.ProRataSettlementGrain != 0 {
t.Errorf("MsgCompleteSecessionResponse Reset did not zero: %+v", r2)
}
r2.ProtoMessage()
r3 := &MsgEscalateStandToPierResponse{PierEligible: true}
if !strings.Contains(r3.String(), "MsgEscalateStandToPierResponse") {
t.Errorf("MsgEscalateStandToPierResponse String = %q", r3.String())
}
r3.Reset()
if r3.PierEligible {
t.Errorf("MsgEscalateStandToPierResponse Reset did not zero: %+v", r3)
}
r3.ProtoMessage()
r4 := &MsgAcceptPierInvitationResponse{}
r4.Reset()
if !strings.Contains(r4.String(), "MsgAcceptPierInvitationResponse") {
t.Errorf("MsgAcceptPierInvitationResponse String = %q", r4.String())
}
r4.ProtoMessage()
}
+260 -13
View File
@@ -1,6 +1,7 @@
package types
import (
"crypto/sha256"
"encoding/json"
"fmt"
)
@@ -17,18 +18,196 @@ const (
// (v0.1 already encodes HandPassGuild as a 0-fee waiver reason). v0.2's Guild
// module references that waiver, doesn't redefine the fee.
HandPassFeeBps = 0
// PierCarriesVoice is the 12th locked const (GRILL D-087, FR-VOICE-6):
// the Pier wrapper does NOT carry Voice, regardless of fiduciary role.
// This is a mission-locked invariant: a Chapter retains mesh-level Voice
// (the const enforces that the optional Pier-Routed Legal Wrapper does
// NOT carry Voice). Locked-const regression in types_test.go.
PierCarriesVoice = false
// CoolingSecessionCoverActiveDays is the LOCKED protocol minimum (REQ-064)
// for a Cover-active Chapter's secession cooling period: 21 Mesh-days. A
// Chapter's SecessionTerms MAY specify a longer cooling but NOT shorter
// (the CreateChapter handler rejects shorter). Locked-const regression in
// types_test.go.
CoolingSecessionCoverActiveDays = uint32(21)
// CoolingSecessionNonCoverDays is the LOCKED protocol minimum (REQ-064)
// for a non-Cover-active Chapter's secession cooling period: 14 Mesh-days.
// A Chapter's SecessionTerms MAY specify a longer cooling but NOT shorter
// (the CreateChapter handler rejects shorter). Locked-const regression in
// types_test.go.
CoolingSecessionNonCoverDays = uint32(14)
// StandPierEscalationAnnualPassVolumeCents is the LOCAL cross-documented
// const for the D-074 Stand→Pier escalation threshold (REQ-059). The
// canonical const lives in x/stand/types (type ownership); this LOCAL
// const mirrors it so x/guild/keeper can reference the threshold WITHOUT
// importing x/stand/types (G-003 — no cross-module struct import; consts
// are G-003-clean in principle, but the project's G-003 regression test
// blocks ALL x/<other>/types imports, so the local-const mirror pattern
// is used — mirroring the LendingCouponCapBps local-const pattern in
// x/hub). The two consts MUST stay in sync (a change to
// x/stand/types.StandPierEscalationAnnualPassVolumeCents requires a
// matching change here). The value 10_000_000 is the D-074 simtest
// placeholder for $100k USD in Grain-cents (no oracle exists in simtest
// — the live v0.8+ mesh converts at the oracle rate). NOT LOCKED — it
// is a simtest default; the live governance may tune it. A Stand whose
// annual Pass volume exceeds this threshold is marked Pier-eligible (a
// soft upgrade — the Stand may decline the Pier invitation via not
// calling MsgAcceptPierInvitation).
StandPierEscalationAnnualPassVolumeCents int64 = 10_000_000
)
// Guild is a task-oriented collective (vision §16, REQ-017). A Guild may
// optionally affiliate with a Stand (stand-affiliation-id references x/stand
// by ID string — G-003 by-ID-string invariant). founder-reach references
// x/identity Reach by string.
//
// P3 extension (REQ-051, REQ-053): the Guild carries a Common Bond
// (hash-pinned at creation — CommonBondHash) + a Public Profile
// (GuildPublicProfile). A Parent Guild (IsChapter=false, ParentGuildID="")
// may have Chapters (IsChapter=true, ParentGuildID by-ID-string). A Chapter
// pins its SecessionTerms at creation (SecessionTermsHash — the hash of the
// JSON-encoded SecessionTerms; immutable — no handler to amend it). A
// Chapter's Good-Standing Liens (GoodStandingLiens) are recorded at founding
// with SecuredAtFounding=true; post-founding liens are SecuredAtFounding=false
// (the AddLien handler rejects any new SecuredAtFounding=true lien — founding
// is a one-time event).
//
// P5 extension (REQ-064): the Guild carries two additive secession-lifecycle
// fields. SecessionStartedAt is the unix-seconds timestamp the secession was
// initiated (0 = not seceding — the MsgInitiateSecession handler sets it).
// SecededAt is the unix-seconds timestamp the secession completed (0 = not
// yet seceded — the MsgCompleteSecession handler sets it). Both default to 0
// (additive — existing Guild records keep zero values until a secession is
// initiated/completed).
type Guild struct {
GuildID string `json:"guild_id" yaml:"guild_id"`
Name string `json:"name" yaml:"name"`
FounderReach string `json:"founder_reach" yaml:"founder_reach"`
CreatedAt int64 `json:"created_at" yaml:"created_at"`
StandAffiliationID string `json:"stand_affiliation_id,omitempty" yaml:"stand_affiliation_id,omitempty"`
GuildID string `json:"guild_id" yaml:"guild_id"`
Name string `json:"name" yaml:"name"`
FounderReach string `json:"founder_reach" yaml:"founder_reach"`
CreatedAt int64 `json:"created_at" yaml:"created_at"`
StandAffiliationID string `json:"stand_affiliation_id,omitempty" yaml:"stand_affiliation_id,omitempty"`
CommonBondHash []byte `json:"common_bond_hash,omitempty" yaml:"common_bond_hash,omitempty"`
PublicProfile GuildPublicProfile `json:"public_profile,omitempty" yaml:"public_profile,omitempty"`
ParentGuildID string `json:"parent_guild_id,omitempty" yaml:"parent_guild_id,omitempty"`
IsChapter bool `json:"is_chapter,omitempty" yaml:"is_chapter,omitempty"`
SecessionTermsHash []byte `json:"secession_terms_hash,omitempty" yaml:"secession_terms_hash,omitempty"`
GoodStandingLiens []Lien `json:"good_standing_liens,omitempty" yaml:"good_standing_liens,omitempty"`
SecessionStartedAt int64 `json:"secession_started_at,omitempty" yaml:"secession_started_at,omitempty"`
SecededAt int64 `json:"seceded_at,omitempty" yaml:"seceded_at,omitempty"`
}
// GuildPublicProfile is a Guild's published profile (REQ-051). BondSummary is
// a short, human-readable summary of the Common Bond (the protocol does NOT
// parse it — FR-CHTR-5). Disclaimers is the list of jurisdictional
// disclaimers the Guild publishes. MasonCount is the member count when
// disclosed; MasonCountPrivate=true means the count is NOT disclosed
// (MasonCount is 0; consumers check the bool). PierWrapperID references a
// Pier wrapper by-ID-string (G-003); empty means no Pier wrapper (the §5
// default-no-wrapper — D-087: the Pier wrapper does NOT carry Voice).
type GuildPublicProfile struct {
BondSummary string `json:"bond_summary" yaml:"bond_summary"`
Disclaimers []string `json:"disclaimers" yaml:"disclaimers"`
MasonCount uint32 `json:"mason_count" yaml:"mason_count"`
MasonCountPrivate bool `json:"mason_count_private" yaml:"mason_count_private"`
PierWrapperID string `json:"pier_wrapper_id,omitempty" yaml:"pier_wrapper_id,omitempty"`
}
// Lien is a Good-Standing Lien on a Guild (REQ-053). Amount is the lien
// amount in Grain. CreditorReachID references the creditor's Reach by string
// (G-003). SecuredAtFounding=true marks a founding-locked lien (recorded at
// Guild/Chapter creation; NOT freely increasable post-founding — the AddLien
// handler rejects any new SecuredAtFounding=true lien). CoverPoolCovenantRef
// references a Cover Pool covenant by-ID-string (G-003); empty for a lien
// with no Cover Pool covenant backing. Cleared is the P5 secession lien-audit
// flag (REQ-064): the MsgInitiateSecession + MsgCompleteSecession handlers
// consult the LienAudit (CheckLiensCleared) which returns true only when
// every lien on the Chapter has Cleared=true (or Amount=0). Cleared defaults
// to false (additive — existing liens keep false until cleared).
type Lien struct {
Amount int64 `json:"amount" yaml:"amount"`
CreditorReachID string `json:"creditor_reach_id" yaml:"creditor_reach_id"`
SecuredAtFounding bool `json:"secured_at_founding" yaml:"secured_at_founding"`
CoverPoolCovenantRef string `json:"cover_pool_covenant_ref,omitempty" yaml:"cover_pool_covenant_ref,omitempty"`
Cleared bool `json:"cleared,omitempty" yaml:"cleared,omitempty"`
}
// SecessionTerms is a Chapter's secession cooling terms (REQ-053, REQ-064).
// Hash-pinned at Guild creation (the SecessionTermsHash on the Guild is the
// SHA-256 of this struct's JSON; immutable — no handler to amend it). The
// cooling periods are protocol-minimum-bounded: the Chapter MAY specify
// longer but NOT shorter than CoolingSecessionCoverActiveDays /
// CoolingSecessionNonCoverDays (the CreateChapter handler rejects shorter).
// LienAuditRequired marks whether a lien audit must pass before secession
// completes. CovenantClearanceRequired marks whether Cover Call / Bond
// covenant clearance must pass before secession completes.
type SecessionTerms struct {
CoolingCoverActiveDays uint32 `json:"cooling_cover_active_days" yaml:"cooling_cover_active_days"`
CoolingNonCoverDays uint32 `json:"cooling_non_cover_days" yaml:"cooling_non_cover_days"`
LienAuditRequired bool `json:"lien_audit_required" yaml:"lien_audit_required"`
CovenantClearanceRequired bool `json:"covenant_clearance_required" yaml:"covenant_clearance_required"`
}
// HashSecessionTerms returns the SHA-256 hash of the JSON-encoded
// SecessionTerms. This is the value stored on Guild.SecessionTermsHash at
// Chapter creation (immutable). The handler pins the hash, NOT the terms
// themselves (the terms are recoverable from genesis; the hash pins them
// against amendment — REQ-053 immutability).
func HashSecessionTerms(t SecessionTerms) []byte {
bz, err := json.Marshal(t)
if err != nil {
// SecessionTerms is a plain struct with only uint32/bool fields;
// json.Marshal never errors here. Panic is the defensive path.
panic(fmt.Sprintf("guild: marshal secession terms: %v", err))
}
sum := sha256.Sum256(bz)
return sum[:]
}
// ConfederationVoice is a Confederation Voice delegation record (REQ-058).
// One-Stand-one-Vote: each member Stand gets exactly 1 Voice in the
// Confederation's aggregate, regardless of size. ConfederationStandID +
// MemberStandID reference x/stand Stands by-ID-string (G-003).
// DelegateReachID references the Reach the member Stand's Voice is delegated
// to. DelegatedAt is the delegation timestamp (block time). The guild
// keeper persists this (the DelegateConfederationVoice handler records one
// delegation per member Stand — a duplicate is REJECTED).
//
// NOTE: x/stand/types defines a type-level ConfederationVoice struct too
// (the type-level addition); this guild-side struct is the persisted record
// (the guild keeper owns the delegation store). The two structs share the
// same JSON field names so a value of one round-trips through the other
// (the simtest asserts against this struct; the x/stand/types struct is the
// type-level scaffold for the aggregation logic landing in a later phase).
type ConfederationVoice struct {
ConfederationStandID string `json:"confederation_stand_id" yaml:"confederation_stand_id"`
MemberStandID string `json:"member_stand_id" yaml:"member_stand_id"`
DelegateReachID string `json:"delegate_reach_id" yaml:"delegate_reach_id"`
DelegatedAt int64 `json:"delegated_at" yaml:"delegated_at"`
}
// Validate asserts a SecessionTerms is non-zero + protocol-minimum-bounded
// (the Chapter MAY tighten the cooling but NOT loosen it below
// CoolingSecessionCoverActiveDays / CoolingSecessionNonCoverDays). The
// CreateChapter handler calls this BEFORE pinning the hash.
func (t SecessionTerms) Validate() error {
if t.CoolingCoverActiveDays == 0 {
return fmt.Errorf("guild: CoolingCoverActiveDays must be non-zero")
}
if t.CoolingNonCoverDays == 0 {
return fmt.Errorf("guild: CoolingNonCoverDays must be non-zero")
}
if t.CoolingCoverActiveDays < CoolingSecessionCoverActiveDays {
return fmt.Errorf("guild: CoolingCoverActiveDays %d < protocol minimum %d (Chapter may tighten but not loosen — REQ-053/REQ-064)",
t.CoolingCoverActiveDays, CoolingSecessionCoverActiveDays)
}
if t.CoolingNonCoverDays < CoolingSecessionNonCoverDays {
return fmt.Errorf("guild: CoolingNonCoverDays %d < protocol minimum %d (Chapter may tighten but not loosen — REQ-053/REQ-064)",
t.CoolingNonCoverDays, CoolingSecessionNonCoverDays)
}
return nil
}
// HandPass is a free (0% protocol fee) Pass-Act issued by a Guild (REQ-017).
@@ -60,17 +239,38 @@ func IssueHandPass(passID, guildID, issuerReach, recipientReach string, amountGr
}
}
// Params for the guild module (skeleton — no tunables in v0.2).
type Params struct{}
// Params for the guild module (P3 extension — REQ-064 cooling defaults).
// DefaultCoolingCoverActiveDays + DefaultCoolingNonCoverDays are the
// protocol-default cooling periods for a Chapter with no SecessionTerms
// override (the Chapter's own SecessionTerms MAY specify longer but NOT
// shorter than the protocol minimums CoolingSecessionCoverActiveDays /
// CoolingSecessionNonCoverDays).
type Params struct {
DefaultCoolingCoverActiveDays uint32 `json:"default_cooling_cover_active_days" yaml:"default_cooling_cover_active_days"`
DefaultCoolingNonCoverDays uint32 `json:"default_cooling_non_cover_days" yaml:"default_cooling_non_cover_days"`
}
func DefaultParams() Params { return Params{} }
// DefaultParams returns the Params with the protocol-minimum cooling defaults
// (CoolingSecessionCoverActiveDays / CoolingSecessionNonCoverDays — the
// Chapter MAY tighten but NOT loosen).
func DefaultParams() Params {
return Params{
DefaultCoolingCoverActiveDays: CoolingSecessionCoverActiveDays,
DefaultCoolingNonCoverDays: CoolingSecessionNonCoverDays,
}
}
// GenesisState defines the guild module genesis state (REQ-017).
// Guilds + HandPasses are the two top-level sets; ValidateGenesis enforces
// guild-id uniqueness and pass-id uniqueness.
// GenesisState defines the guild module genesis state (REQ-017, REQ-053).
// Guilds + HandPasses + Chapters are the three top-level sets; Chapters is a
// separate slice for genesis validation clarity (a Chapter is a Guild with
// IsChapter=true — the separate slice makes the Chapter→ParentGuildID
// reference check unambiguous). ValidateGenesis enforces guild-id + pass-id
// uniqueness + the Chapter→ParentGuildID reference check (a Chapter's
// ParentGuildID must reference an existing Guild in the genesis — REQ-053).
type GenesisState struct {
Params Params `json:"params" yaml:"params"`
Guilds []Guild `json:"guilds" yaml:"guilds"`
Chapters []Guild `json:"chapters,omitempty" yaml:"chapters,omitempty"`
HandPasses []HandPass `json:"hand_passes" yaml:"hand_passes"`
}
@@ -78,19 +278,40 @@ func DefaultGenesisState() *GenesisState {
return &GenesisState{
Params: DefaultParams(),
Guilds: []Guild{},
Chapters: []Guild{},
HandPasses: []HandPass{},
}
}
// Reset implements proto.Message (required by codec.JSONCodec for
// InitGenesis/ExportGenesis).
func (m *GenesisState) Reset() { *m = GenesisState{} }
// String implements proto.Message.
func (m *GenesisState) String() string {
return fmt.Sprintf("GenesisState{Guilds:%d Chapters:%d HandPasses:%d}",
len(m.Guilds), len(m.Chapters), len(m.HandPasses))
}
// ProtoMessage implements proto.Message.
func (*GenesisState) ProtoMessage() {}
// ValidateGenesis performs ID-uniqueness checks (A-212 upgrade from v0.1
// no-op): rejects duplicate guild-ids and duplicate pass-ids. Also enforces
// the 0-fee covenant on genesis HandPasses (FeeGrain must be 0).
// the 0-fee covenant on genesis HandPasses (FeeGrain must be 0). P3
// extension (REQ-053): a Chapter (Guild with IsChapter=true, in either the
// Guilds or Chapters slice) must have a non-empty ParentGuildID referencing
// an existing Guild in the genesis (the parent must be a non-Chapter Guild).
func ValidateGenesis(bz json.RawMessage) error {
var gs GenesisState
if err := json.Unmarshal(bz, &gs); err != nil {
return fmt.Errorf("guild: invalid genesis: %w", err)
}
seenGuild := make(map[string]bool, len(gs.Guilds))
// Index all guild-ids across the Guilds + Chapters slices for the
// Chapter→ParentGuildID reference check. Reject duplicate guild-ids
// across BOTH slices (a Chapter may not share a guild-id with a Parent
// Guild).
seenGuild := make(map[string]bool, len(gs.Guilds)+len(gs.Chapters))
for _, g := range gs.Guilds {
if g.GuildID == "" {
return fmt.Errorf("guild: empty guild-id")
@@ -99,6 +320,32 @@ func ValidateGenesis(bz json.RawMessage) error {
return fmt.Errorf("guild: duplicate guild-id %q", g.GuildID)
}
seenGuild[g.GuildID] = true
// A Guild in the Guilds slice with IsChapter=true is rejected (a
// Chapter must live in the Chapters slice — the split is for genesis
// validation clarity).
if g.IsChapter {
return fmt.Errorf("guild: Guild %q has IsChapter=true but is in the Guilds slice (move to Chapters)", g.GuildID)
}
}
for _, c := range gs.Chapters {
if c.GuildID == "" {
return fmt.Errorf("guild: empty chapter guild-id")
}
if seenGuild[c.GuildID] {
return fmt.Errorf("guild: duplicate guild-id %q (Chapter)", c.GuildID)
}
seenGuild[c.GuildID] = true
// REQ-053: a Chapter must have IsChapter=true + a non-empty
// ParentGuildID referencing an existing Guild.
if !c.IsChapter {
return fmt.Errorf("guild: Chapter %q has IsChapter=false (Chapters slice requires IsChapter=true)", c.GuildID)
}
if c.ParentGuildID == "" {
return fmt.Errorf("guild: Chapter %q has empty ParentGuildID (REQ-053)", c.GuildID)
}
if !seenGuild[c.ParentGuildID] {
return fmt.Errorf("guild: Chapter %q ParentGuildID %q not found in genesis (REQ-053)", c.GuildID, c.ParentGuildID)
}
}
seenPass := make(map[string]bool, len(gs.HandPasses))
for _, p := range gs.HandPasses {
+380 -7
View File
@@ -221,14 +221,16 @@ func TestDefaultParams(t *testing.T) {
// --- Lexicon assertion (REQ-012) -------------------------------------------------
// TestLexiconNoBannedTermsInGuildPackage scans every non-test .go file in
// the guild/types package directory for the 9 banned terms (case-insensitive).
// Production files only — the test file contains the banned terms as the list
// of things to forbid (standard lexicon-test bootstrapping pattern).
// the x/guild module tree (types + keeper + module.go) for the 10 banned
// terms (case-insensitive). Production files only — the test file contains
// the banned terms as the list of things to forbid (standard lexicon-test
// bootstrapping pattern). The scan walks x/guild/**/*.go (the spec's
// `x/guild/**/*.go` lexicon assertion for P3).
func TestLexiconNoBannedTermsInGuildPackage(t *testing.T) {
pkgDir := packageDir(t, "github.com/oy/openyield/x/guild/types")
files, err := filepath.Glob(filepath.Join(pkgDir, "*.go"))
guildDir := packageDir(t, "github.com/oy/openyield/x/guild")
files, err := walkGoFiles(guildDir)
if err != nil {
t.Fatalf("glob: %v", err)
t.Fatalf("walk: %v", err)
}
prodFiles := []string{}
for _, f := range files {
@@ -238,7 +240,7 @@ func TestLexiconNoBannedTermsInGuildPackage(t *testing.T) {
prodFiles = append(prodFiles, f)
}
if len(prodFiles) == 0 {
t.Fatal("no production .go files found in guild/types")
t.Fatal("no production .go files found in x/guild")
}
for _, f := range prodFiles {
bz, err := os.ReadFile(f)
@@ -251,6 +253,321 @@ func TestLexiconNoBannedTermsInGuildPackage(t *testing.T) {
}
}
// walkGoFiles returns all .go files under dir (recursively).
func walkGoFiles(dir string) ([]string, error) {
var out []string
err := filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
}
if info.IsDir() {
return nil
}
if strings.HasSuffix(path, ".go") {
out = append(out, path)
}
return nil
})
return out, err
}
// --- P3 locked-const regression (REQ-064, D-087) -------------------------------
// TestPierCarriesVoiceLockedConst asserts D-087: PierCarriesVoice == false
// (FR-VOICE-6: the Pier wrapper does NOT carry Voice, regardless of
// fiduciary role — mission-locked invariant). A regression firewall:
// changing PierCarriesVoice to true breaks this test.
func TestPierCarriesVoiceLockedConst(t *testing.T) {
if types.PierCarriesVoice {
t.Errorf("PierCarriesVoice = true, expected false (D-087 FR-VOICE-6: Pier does NOT carry Voice)")
}
}
// TestCoolingSecessionLockedConsts asserts REQ-064: the protocol-minimum
// cooling periods for Chapter secession (21d Cover-active, 14d non-Cover).
// A Chapter's SecessionTerms MAY specify longer but NOT shorter (the
// CreateChapter handler rejects shorter). Regression firewall: changing
// these consts breaks this test.
func TestCoolingSecessionLockedConsts(t *testing.T) {
if types.CoolingSecessionCoverActiveDays != 21 {
t.Errorf("CoolingSecessionCoverActiveDays = %d, expected 21 (REQ-064 LOCKED)",
types.CoolingSecessionCoverActiveDays)
}
if types.CoolingSecessionNonCoverDays != 14 {
t.Errorf("CoolingSecessionNonCoverDays = %d, expected 14 (REQ-064 LOCKED)",
types.CoolingSecessionNonCoverDays)
}
}
// --- P3 Guild struct extension (REQ-051, REQ-053) ------------------------------
// TestGuildP3Fields asserts the Guild struct carries the P3 extension fields
// (CommonBondHash, PublicProfile, ParentGuildID, IsChapter,
// SecessionTermsHash, GoodStandingLiens) — a compile-time + runtime
// regression firewall (removing any field breaks this test).
func TestGuildP3Fields(t *testing.T) {
g := types.Guild{
GuildID: "g1",
Name: "Parent",
FounderReach: "reach:f",
CommonBondHash: []byte{1, 2, 3},
PublicProfile: types.GuildPublicProfile{BondSummary: "sum", MasonCount: 7},
ParentGuildID: "",
IsChapter: false,
SecessionTermsHash: nil,
GoodStandingLiens: []types.Lien{{Amount: 100, CreditorReachID: "reach:c", SecuredAtFounding: true}},
}
if g.CommonBondHash == nil || len(g.CommonBondHash) != 3 {
t.Errorf("CommonBondHash = %v, want 3 bytes", g.CommonBondHash)
}
if g.PublicProfile.BondSummary != "sum" || g.PublicProfile.MasonCount != 7 {
t.Errorf("PublicProfile = %+v", g.PublicProfile)
}
if g.IsChapter {
t.Errorf("IsChapter = true, want false for a Parent Guild")
}
if g.ParentGuildID != "" {
t.Errorf("ParentGuildID = %q, want empty for a Parent Guild", g.ParentGuildID)
}
if len(g.GoodStandingLiens) != 1 || !g.GoodStandingLiens[0].SecuredAtFounding {
t.Errorf("GoodStandingLiens = %v", g.GoodStandingLiens)
}
// Chapter variant.
c := types.Guild{
GuildID: "c1",
Name: "Chapter",
FounderReach: "reach:f",
ParentGuildID: "g1",
IsChapter: true,
SecessionTermsHash: []byte{9, 9, 9},
GoodStandingLiens: []types.Lien{{Amount: 50, CreditorReachID: "reach:c2", SecuredAtFounding: true}},
}
if !c.IsChapter || c.ParentGuildID != "g1" {
t.Errorf("Chapter fields: IsChapter=%v ParentGuildID=%q", c.IsChapter, c.ParentGuildID)
}
if len(c.SecessionTermsHash) != 3 {
t.Errorf("SecessionTermsHash = %v, want 3 bytes", c.SecessionTermsHash)
}
}
// TestGuildPublicProfileMasonCountPrivate asserts the MasonCountPrivate bool:
// when true, the MasonCount is NOT disclosed (the field is 0; consumers
// check the bool).
func TestGuildPublicProfileMasonCountPrivate(t *testing.T) {
disclosed := types.GuildPublicProfile{BondSummary: "s", MasonCount: 42, MasonCountPrivate: false}
if disclosed.MasonCountPrivate || disclosed.MasonCount != 42 {
t.Errorf("disclosed profile: %+v", disclosed)
}
private := types.GuildPublicProfile{BondSummary: "s", MasonCount: 0, MasonCountPrivate: true}
if !private.MasonCountPrivate {
t.Errorf("private profile: MasonCountPrivate = false, want true")
}
if private.MasonCount != 0 {
t.Errorf("private profile: MasonCount = %d, want 0 (not disclosed)", private.MasonCount)
}
}
// TestLienStruct asserts the Lien struct carries the four required fields
// (Amount, CreditorReachID, SecuredAtFounding, CoverPoolCovenantRef).
func TestLienStruct(t *testing.T) {
l := types.Lien{
Amount: 1000,
CreditorReachID: "reach:cred",
SecuredAtFounding: true,
CoverPoolCovenantRef: "covenant-1",
}
if l.Amount != 1000 || l.CreditorReachID != "reach:cred" ||
!l.SecuredAtFounding || l.CoverPoolCovenantRef != "covenant-1" {
t.Errorf("Lien fields: %+v", l)
}
// A lien with no Cover Pool covenant backing (empty ref) is valid.
l2 := types.Lien{Amount: 500, CreditorReachID: "reach:c", SecuredAtFounding: false}
if l2.CoverPoolCovenantRef != "" {
t.Errorf("Lien2 CoverPoolCovenantRef = %q, want empty", l2.CoverPoolCovenantRef)
}
}
// TestSecessionTermsStruct asserts the SecessionTerms struct + its Validate
// method (non-zero + protocol-minimum-bounded).
func TestSecessionTermsStruct(t *testing.T) {
// Valid: exactly the protocol minimums.
valid := types.SecessionTerms{
CoolingCoverActiveDays: types.CoolingSecessionCoverActiveDays,
CoolingNonCoverDays: types.CoolingSecessionNonCoverDays,
LienAuditRequired: true,
CovenantClearanceRequired: true,
}
if err := valid.Validate(); err != nil {
t.Errorf("valid SecessionTerms Validate: %v", err)
}
// Valid: tighter than the protocol minimum (longer cooling allowed).
tighter := types.SecessionTerms{
CoolingCoverActiveDays: types.CoolingSecessionCoverActiveDays + 10,
CoolingNonCoverDays: types.CoolingSecessionNonCoverDays + 5,
}
if err := tighter.Validate(); err != nil {
t.Errorf("tighter SecessionTerms Validate: %v", err)
}
// Invalid: zero CoolingCoverActiveDays.
if err := (types.SecessionTerms{CoolingNonCoverDays: 14}).Validate(); err == nil {
t.Error("SecessionTerms with zero CoolingCoverActiveDays should fail Validate")
}
// Invalid: zero CoolingNonCoverDays.
if err := (types.SecessionTerms{CoolingCoverActiveDays: 21}).Validate(); err == nil {
t.Error("SecessionTerms with zero CoolingNonCoverDays should fail Validate")
}
// Invalid: CoolingCoverActiveDays below protocol minimum (looser).
loose := types.SecessionTerms{
CoolingCoverActiveDays: types.CoolingSecessionCoverActiveDays - 1,
CoolingNonCoverDays: types.CoolingSecessionNonCoverDays,
}
if err := loose.Validate(); err == nil {
t.Error("SecessionTerms with CoolingCoverActiveDays below minimum should fail Validate (Chapter may tighten but not loosen)")
}
// Invalid: CoolingNonCoverDays below protocol minimum (looser).
loose2 := types.SecessionTerms{
CoolingCoverActiveDays: types.CoolingSecessionCoverActiveDays,
CoolingNonCoverDays: types.CoolingSecessionNonCoverDays - 1,
}
if err := loose2.Validate(); err == nil {
t.Error("SecessionTerms with CoolingNonCoverDays below minimum should fail Validate (Chapter may tighten but not loosen)")
}
}
// TestHashSecessionTermsDeterministic asserts HashSecessionTerms is
// deterministic (the same terms produce the same hash; different terms
// produce a different hash). This is the immutability pin: the
// SecessionTermsHash on a Chapter is the hash of its SecessionTerms JSON.
func TestHashSecessionTermsDeterministic(t *testing.T) {
t1 := types.SecessionTerms{CoolingCoverActiveDays: 21, CoolingNonCoverDays: 14}
t2 := types.SecessionTerms{CoolingCoverActiveDays: 21, CoolingNonCoverDays: 14}
if !bytesEqual(types.HashSecessionTerms(t1), types.HashSecessionTerms(t2)) {
t.Error("HashSecessionTerms not deterministic for equal terms")
}
t3 := types.SecessionTerms{CoolingCoverActiveDays: 31, CoolingNonCoverDays: 14}
if bytesEqual(types.HashSecessionTerms(t1), types.HashSecessionTerms(t3)) {
t.Error("HashSecessionTerms collided for different terms")
}
}
// bytesEqual is a stdlib-only byte-slice equality helper (the types_test.go
// stays stdlib-only per G-024 — no bytes import needed for this trivial
// comparison).
func bytesEqual(a, b []byte) bool {
if len(a) != len(b) {
return false
}
for i := range a {
if a[i] != b[i] {
return false
}
}
return true
}
// --- P3 Params + GenesisState extension ---------------------------------------
// TestDefaultParamsCooling asserts DefaultParams returns the protocol-minimum
// cooling defaults (CoolingSecessionCoverActiveDays / NonCoverDays).
func TestDefaultParamsCooling(t *testing.T) {
p := types.DefaultParams()
if p.DefaultCoolingCoverActiveDays != types.CoolingSecessionCoverActiveDays {
t.Errorf("DefaultCoolingCoverActiveDays = %d, want %d",
p.DefaultCoolingCoverActiveDays, types.CoolingSecessionCoverActiveDays)
}
if p.DefaultCoolingNonCoverDays != types.CoolingSecessionNonCoverDays {
t.Errorf("DefaultCoolingNonCoverDays = %d, want %d",
p.DefaultCoolingNonCoverDays, types.CoolingSecessionNonCoverDays)
}
}
// TestDefaultGenesisStateChapters asserts DefaultGenesisState returns a
// non-nil empty Chapters slice.
func TestDefaultGenesisStateChapters(t *testing.T) {
gs := types.DefaultGenesisState()
if gs.Chapters == nil || len(gs.Chapters) != 0 {
t.Errorf("Default Chapters should be non-nil empty slice, got %v", gs.Chapters)
}
}
// TestValidateGenesisRejectsChapterMissingParent asserts REQ-053: a Chapter
// (in the Chapters slice) with an empty ParentGuildID is REJECTED.
func TestValidateGenesisRejectsChapterMissingParent(t *testing.T) {
gs := types.GenesisState{
Guilds: []types.Guild{{GuildID: "g1"}},
Chapters: []types.Guild{{GuildID: "c1", IsChapter: true, ParentGuildID: ""}},
}
bz, _ := json.Marshal(gs)
if err := types.ValidateGenesis(bz); err == nil {
t.Error("ValidateGenesis should reject Chapter with empty ParentGuildID (REQ-053)")
}
}
// TestValidateGenesisRejectsChapterParentNotFound asserts REQ-053: a Chapter
// whose ParentGuildID does not reference an existing Guild is REJECTED.
func TestValidateGenesisRejectsChapterParentNotFound(t *testing.T) {
gs := types.GenesisState{
Chapters: []types.Guild{{GuildID: "c1", IsChapter: true, ParentGuildID: "no-such-parent"}},
}
bz, _ := json.Marshal(gs)
if err := types.ValidateGenesis(bz); err == nil {
t.Error("ValidateGenesis should reject Chapter with ParentGuildID not in genesis (REQ-053)")
}
}
// TestValidateGenesisAcceptsChapterWithParent asserts a Chapter with a
// valid ParentGuildID (referencing an existing Guild) is accepted.
func TestValidateGenesisAcceptsChapterWithParent(t *testing.T) {
gs := types.GenesisState{
Guilds: []types.Guild{{GuildID: "g1"}},
Chapters: []types.Guild{{GuildID: "c1", IsChapter: true, ParentGuildID: "g1"}},
HandPasses: []types.HandPass{{PassID: "p1", GuildID: "g1", FeeGrain: 0}},
}
bz, _ := json.Marshal(gs)
if err := types.ValidateGenesis(bz); err != nil {
t.Errorf("ValidateGenesis should accept Chapter with valid parent, got: %v", err)
}
}
// TestValidateGenesisRejectsChapterInGuildsSlice asserts a Guild in the
// Guilds slice with IsChapter=true is REJECTED (a Chapter must live in the
// Chapters slice — the split is for genesis validation clarity).
func TestValidateGenesisRejectsChapterInGuildsSlice(t *testing.T) {
gs := types.GenesisState{
Guilds: []types.Guild{{GuildID: "g1", IsChapter: true}},
}
bz, _ := json.Marshal(gs)
if err := types.ValidateGenesis(bz); err == nil {
t.Error("ValidateGenesis should reject a Chapter in the Guilds slice (move to Chapters)")
}
}
// TestValidateGenesisRejectsNonChapterInChaptersSlice asserts a Guild in
// the Chapters slice with IsChapter=false is REJECTED.
func TestValidateGenesisRejectsNonChapterInChaptersSlice(t *testing.T) {
gs := types.GenesisState{
Chapters: []types.Guild{{GuildID: "c1", IsChapter: false, ParentGuildID: "g1"}},
}
bz, _ := json.Marshal(gs)
if err := types.ValidateGenesis(bz); err == nil {
t.Error("ValidateGenesis should reject a non-Chapter in the Chapters slice")
}
}
// TestValidateGenesisRejectsDupChapterID asserts a duplicate guild-id across
// the Guilds + Chapters slices is REJECTED.
func TestValidateGenesisRejectsDupChapterID(t *testing.T) {
gs := types.GenesisState{
Guilds: []types.Guild{{GuildID: "g1"}},
Chapters: []types.Guild{{GuildID: "g1", IsChapter: true, ParentGuildID: "g1"}},
}
bz, _ := json.Marshal(gs)
if err := types.ValidateGenesis(bz); err == nil {
t.Error("ValidateGenesis should reject duplicate guild-id across Guilds + Chapters")
}
}
// packageDir resolves a Go import path to its filesystem directory.
func packageDir(t *testing.T, importPath string) string {
t.Helper()
@@ -262,3 +579,59 @@ func packageDir(t *testing.T, importPath string) string {
rel := strings.TrimPrefix(importPath, "github.com/oy/openyield/")
return filepath.Join(repoRoot, rel)
}
// --- P5 locked-const + struct regression (REQ-064, REQ-059, D-074) -------------
// TestStandPierEscalationAnnualPassVolumeCentsLocalConst asserts the LOCAL
// cross-documented Stand→Pier escalation threshold const (REQ-059, D-074)
// holds its value + matches the canonical const in x/stand/types. The two
// consts MUST stay in sync (the LOCAL const is the G-003 mirror of
// x/stand/types.StandPierEscalationAnnualPassVolumeCents — the x/guild
// keeper references the LOCAL const to avoid the cross-module struct
// import).
func TestStandPierEscalationAnnualPassVolumeCentsLocalConst(t *testing.T) {
if types.StandPierEscalationAnnualPassVolumeCents != 10_000_000 {
t.Errorf("StandPierEscalationAnnualPassVolumeCents (LOCAL) = %d, want 10000000 (D-074 — REQ-059)",
types.StandPierEscalationAnnualPassVolumeCents)
}
}
// TestGuildP5SecessionFields asserts the Guild struct carries the P5
// additive secession-lifecycle fields (SecessionStartedAt + SecededAt) —
// a compile-time + runtime regression firewall (removing either field
// breaks this test). Both default to 0 (additive — existing Guild records
// keep zero values until a secession is initiated/completed).
func TestGuildP5SecessionFields(t *testing.T) {
g := types.Guild{
GuildID: "g1",
SecessionStartedAt: 1000,
SecededAt: 2000,
}
if g.SecessionStartedAt != 1000 {
t.Errorf("SecessionStartedAt = %d, want 1000", g.SecessionStartedAt)
}
if g.SecededAt != 2000 {
t.Errorf("SecededAt = %d, want 2000", g.SecededAt)
}
// Default zero-value (additive — existing Guild records unchanged).
var g2 types.Guild
if g2.SecessionStartedAt != 0 || g2.SecededAt != 0 {
t.Error("zero-value Guild secession fields should be 0 (additive — existing records unchanged)")
}
}
// TestLienP5ClearedField asserts the Lien struct carries the P5 additive
// Cleared field (REQ-064 secession lien-audit flag) — a compile-time +
// runtime regression firewall. Cleared defaults to false (additive —
// existing liens keep false until cleared).
func TestLienP5ClearedField(t *testing.T) {
l := types.Lien{Amount: 100, CreditorReachID: "c", SecuredAtFounding: true, Cleared: true}
if !l.Cleared {
t.Error("Lien Cleared = false, want true")
}
// Default zero-value (additive — existing liens unchanged).
var l2 types.Lien
if l2.Cleared {
t.Error("zero-value Lien Cleared should be false (additive — existing liens unchanged until cleared)")
}
}
+48
View File
@@ -15,6 +15,20 @@ const (
// A regression firewall: adding/removing/renaming a Stand type breaks this
// const's test.
StandTypeCount = 9
// StandPierEscalationAnnualPassVolumeCents is the D-074 simtest
// placeholder for the $100k USD Stand→Pier escalation threshold
// (REQ-059). The const is expressed in Grain-cents (the OY internal
// unit); the value 10_000_000 is the simtest placeholder for $100k USD
// at the current USD/Grain oracle rate (no oracle exists in simtest —
// the live v0.8+ mesh converts at the oracle rate). NOT LOCKED — it is
// a simtest default; the live governance may tune it. The
// x/guild/keeper MsgEscalateStandToPier handler imports this const
// (G-003-clean: consts are not structs — only struct imports are
// forbidden). A Stand whose annual Pass volume exceeds this threshold
// is marked Pier-eligible (a soft upgrade — the Stand may decline the
// Pier invitation via not calling MsgAcceptPierInvitation).
StandPierEscalationAnnualPassVolumeCents int64 = 10_000_000
)
// StandType enumerates the nine organizational forms (vision §11, REQ-016).
@@ -50,6 +64,40 @@ func AllStandTypes() []StandType {
}
}
// IsHousehold reports whether a StandType is a Household (REQ-057). The
// x/guild OneTapExitStand handler (via the StandKeeper shim) consults this
// to assert one-tap exit is Household-only. By-ID-string boundary (G-003):
// the handler compares the stand-type string against "Household"; this
// helper is the type-level scaffold.
func IsHousehold(t StandType) bool { return t == StandHousehold }
// IsConfederation reports whether a StandType is a Confederation (REQ-058).
// The x/guild DelegateConfederationVoice handler (via the StandKeeper shim)
// consults this to assert the named Stand is a Confederation before
// recording a delegation. By-ID-string boundary (G-003): the handler
// compares the stand-type string against "Confederation"; this helper is the
// type-level scaffold.
func IsConfederation(t StandType) bool { return t == StandConfederation }
// ConfederationVoice is a Confederation Voice delegation record (REQ-058).
// One-Stand-one-Vote: each member Stand gets exactly 1 Voice in the
// Confederation's aggregate, regardless of size. ConfederationStandID +
// MemberStandID reference Stands by-ID-string (G-003). DelegateReachID
// references the Reach the member Stand's Voice is delegated to.
// DelegatedAt is the delegation timestamp (block time).
//
// NOTE: the x/guild keeper owns the persisted delegation record (the
// x/guild/types.ConfederationVoice struct is the persisted shape — same JSON
// field names so a value of one round-trips through the other). This
// x/stand/types struct is the type-level scaffold for the Confederation
// Voice aggregation logic landing in a later phase.
type ConfederationVoice struct {
ConfederationStandID string `json:"confederation_stand_id" yaml:"confederation_stand_id"`
MemberStandID string `json:"member_stand_id" yaml:"member_stand_id"`
DelegateReachID string `json:"delegate_reach_id" yaml:"delegate_reach_id"`
DelegatedAt int64 `json:"delegated_at" yaml:"delegated_at"`
}
// Stand is a governed group holding a Vault (vision §11, REQ-016).
// Modeled on Cosmos SDK x/group (a group of members with a decision policy
// governing a Vault). admin-reach references a Reach ID (by-ID-string, G-003);
+62
View File
@@ -244,11 +244,73 @@ func TestModuleConsts(t *testing.T) {
}
}
// TestStandPierEscalationAnnualPassVolumeCents (P5, D-074) asserts the
// Stand→Pier escalation threshold const holds its simtest-placeholder value
// (10M Grain-cents = the D-074 placeholder for $100k USD). NOT LOCKED — it
// is a simtest default; the live governance may tune it. A regression
// here breaks the x/guild keeper's EscalateStandToPier handler threshold
// (the LOCAL cross-documented const in x/guild/types MUST stay in sync).
func TestStandPierEscalationAnnualPassVolumeCents(t *testing.T) {
if types.StandPierEscalationAnnualPassVolumeCents != 10_000_000 {
t.Errorf("StandPierEscalationAnnualPassVolumeCents = %d, want 10000000 (D-074 simtest placeholder for $100k USD — REQ-059)",
types.StandPierEscalationAnnualPassVolumeCents)
}
}
// TestDefaultParams asserts DefaultParams returns a zero-value Params.
func TestDefaultParams(t *testing.T) {
_ = types.DefaultParams() // no panics
}
// --- P3 Household / Confederation helpers (REQ-057, REQ-058) ------------------
// TestIsHousehold asserts IsHousehold returns true only for StandHousehold.
func TestIsHousehold(t *testing.T) {
if !types.IsHousehold(types.StandHousehold) {
t.Error("IsHousehold(Household) should be true")
}
for _, s := range types.AllStandTypes() {
if s == types.StandHousehold {
continue
}
if types.IsHousehold(s) {
t.Errorf("IsHousehold(%q) should be false", s)
}
}
}
// TestIsConfederation asserts IsConfederation returns true only for
// StandConfederation.
func TestIsConfederation(t *testing.T) {
if !types.IsConfederation(types.StandConfederation) {
t.Error("IsConfederation(Confederation) should be true")
}
for _, s := range types.AllStandTypes() {
if s == types.StandConfederation {
continue
}
if types.IsConfederation(s) {
t.Errorf("IsConfederation(%q) should be false", s)
}
}
}
// TestConfederationVoiceStruct asserts the ConfederationVoice struct carries
// the four required fields (ConfederationStandID, MemberStandID,
// DelegateReachID, DelegatedAt — REQ-058).
func TestConfederationVoiceStruct(t *testing.T) {
v := types.ConfederationVoice{
ConfederationStandID: "conf-1",
MemberStandID: "mem-1",
DelegateReachID: "reach:delegate",
DelegatedAt: 12345,
}
if v.ConfederationStandID != "conf-1" || v.MemberStandID != "mem-1" ||
v.DelegateReachID != "reach:delegate" || v.DelegatedAt != 12345 {
t.Errorf("ConfederationVoice fields: %+v", v)
}
}
// --- Lexicon assertion (REQ-012) -------------------------------------------------
// TestLexiconNoBannedTermsInStandPackage scans every non-test .go file in
+59 -14
View File
@@ -38,6 +38,29 @@ const (
FreeholderStashMaxGapDays = 30 // no gap > 30 days
FreeholderMinStandingScore = 4.5 // 4.5+ in at least 3 service categories
FreeholderMinCategories = 3 // at least 3 service categories
// ShadowVouchWeightMultiplier is the LOCKED weight multiplier applied to
// a Shadow vouch (vision §9.1, REQ-060 locked). A Shadow vouch is a
// vouch from a holder whose identity is not publicly linked to their
// vouching activity (the vouch carries skin-in-the-game but the
// voucher's standing is not publicly attributable). The multiplier
// halves the vouch weight: a Shadow Freeholder vouch weighs 0.75 (1.5
// × 0.5) instead of 1.5. The const makes the 0.5× mission-locked
// (REQ-060 locked) and regression-testable. A regression here is a
// mission-lock breach.
ShadowVouchWeightMultiplier = 0.5
// SlashReasonFraudulentCoverCall is the slash reason for a Cover Claims
// Voucher that adjudicated a Cover Call fraudulently (REQ-055, vision
// §9.4). The slash drops the Voucher's Standing bucket (cross-Pool
// applicability — the bucket drop disqualifies them from other Pools'
// Standing gates). The const value is the string recorded on
// x/standing.Slash.Reason. Cross-documented to
// x/cover.types.SlashReasonFraudulentCoverCall (a LOCAL const in
// x/cover to avoid importing x/standing — G-003 — the two consts MUST
// stay in sync; a change to one requires a matching change to the
// other).
SlashReasonFraudulentCoverCall = "FraudulentCoverCall"
)
// Rating is a single rating event (§9.2)
@@ -52,16 +75,28 @@ type Rating struct {
DecayBucket uint8 `json:"decay_bucket" yaml:"decay_bucket"`
}
// Vouch is a Freeholder vouch with skin-in-the-game (§9.1)
// Vouch is a Freeholder vouch with skin-in-the-game (§9.1). IsShadow records
// whether this is a Shadow vouch (REQ-060 — a vouch from a holder whose
// identity is not publicly linked to their vouching activity; the vouch
// carries skin-in-the-game but the voucher's standing is not publicly
// attributable). A Shadow vouch's weight is halved by
// ShadowVouchWeightMultiplier (0.5×) in GetVoucherWeight (the post-step
// multiplier). The field is additive (existing non-Shadow vouches keep
// IsShadow=false -> the same weight as before).
type Vouch struct {
VoucherID string `json:"voucher_id" yaml:"voucher_id"`
VoucheeID string `json:"vouchee_id" yaml:"vouchee_id"`
Category string `json:"category" yaml:"category"`
BondAmount int64 `json:"bond_amount" yaml:"bond_amount"` // voucher skin-in-the-game
Timestamp int64 `json:"timestamp" yaml:"timestamp"`
IsShadow bool `json:"is_shadow" yaml:"is_shadow"` // REQ-060 Shadow vouch flag
}
// Slash penalizes a Holder (§9.4)
// Slash penalizes a Holder (§9.4). Reason is one of "Crack",
// "FraudulentCoverCall" (the SlashReasonFraudulentCoverCall const — REQ-055,
// for a Cover Claims Voucher that adjudicated a Cover Call fraudulently;
// cross-Pool applicability via the Standing bucket drop), or
// "InactivityTimeout".
type Slash struct {
ReachID string `json:"reach_id" yaml:"reach_id"`
Amount float64 `json:"amount" yaml:"amount"`
@@ -108,21 +143,31 @@ func ComputeDiversityBonus(categoryCount int) float64 {
return 0.0
}
// GetVoucherWeight returns the weight for a given rater profile (§9.2)
func GetVoucherWeight(isFreeholder bool, standingScore float64, ratingCount int) float64 {
// GetVoucherWeight returns the weight for a given rater profile (§9.2,
// REQ-060). The base weight is computed from isFreeholder + standingScore +
// ratingCount as before; the post-step applies the Shadow vouch multiplier:
// if isShadow is true, the base weight is multiplied by
// ShadowVouchWeightMultiplier (0.5× — a Shadow vouch weighs half). The
// isShadow parameter is the vouch's Shadow flag (x/standing.Vouch.IsShadow);
// existing non-Shadow vouches pass false -> the same weight as before
// (additive — REQ-060).
func GetVoucherWeight(isFreeholder bool, standingScore float64, ratingCount int, isShadow bool) float64 {
var w float64
if isFreeholder {
return VoucherWeightFreeholder
w = VoucherWeightFreeholder
} else if ratingCount < 10 {
w = VoucherWeightBelow10Ratings
} else if standingScore >= 4.5 {
w = VoucherWeight45Plus
} else if standingScore >= 4.0 {
w = VoucherWeight40To45
} else {
w = VoucherWeightBelow40
}
if ratingCount < 10 {
return VoucherWeightBelow10Ratings
if isShadow {
w *= ShadowVouchWeightMultiplier
}
if standingScore >= 4.5 {
return VoucherWeight45Plus
}
if standingScore >= 4.0 {
return VoucherWeight40To45
}
return VoucherWeightBelow40
return w
}
// GetStandingBucket returns the display bucket for a score (§9.2)
+72 -5
View File
@@ -46,19 +46,19 @@ func TestDiversityBonus(t *testing.T) {
}
func TestVoucherWeights(t *testing.T) {
if types.GetVoucherWeight(true, 4.0, 100) != 1.5 {
if types.GetVoucherWeight(true, 4.0, 100, false) != 1.5 {
t.Error("Freeholder weight should be 1.5x (§9.2)")
}
if types.GetVoucherWeight(false, 4.6, 100) != 1.2 {
if types.GetVoucherWeight(false, 4.6, 100, false) != 1.2 {
t.Error("4.5+ with 1-2 cats should be 1.2x (§9.2)")
}
if types.GetVoucherWeight(false, 4.2, 100) != 1.0 {
if types.GetVoucherWeight(false, 4.2, 100, false) != 1.0 {
t.Error("4.0-4.5 should be 1.0x (§9.2)")
}
if types.GetVoucherWeight(false, 3.5, 100) != 0.5 {
if types.GetVoucherWeight(false, 3.5, 100, false) != 0.5 {
t.Error("Below 4.0 should be 0.5x (§9.2)")
}
if types.GetVoucherWeight(false, 4.0, 5) != 0.3 {
if types.GetVoucherWeight(false, 4.0, 5, false) != 0.3 {
t.Error("Below 10 ratings should be 0.3x (§9.2)")
}
}
@@ -98,3 +98,70 @@ func TestLockedConstants(t *testing.T) {
t.Error("Min counterparties for Freeholder status should be 30 (§9.2)")
}
}
// --- P4: Shadow vouch 50% weight (REQ-060 locked) + SlashReason const ---------
// TestShadowVouchWeightMultiplier asserts the Shadow vouch weight multiplier
// is the locked 0.5 (REQ-060 locked — vision §9.1). A regression here is a
// mission-lock breach.
func TestShadowVouchWeightMultiplier(t *testing.T) {
if types.ShadowVouchWeightMultiplier != 0.5 {
t.Errorf("ShadowVouchWeightMultiplier = %v, want 0.5 (REQ-060 locked — Shadow vouch weighs half)", types.ShadowVouchWeightMultiplier)
}
}
// TestShadowVouchWeight asserts GetVoucherWeight applies the 0.5× Shadow
// multiplier as a post-step (REQ-060):
// - non-Shadow vouch: GetVoucherWeight(false, 4.5, 100, false) ==
// VoucherWeight45Plus (unchanged — the additive field keeps existing
// vouches at the same weight).
// - Shadow vouch: GetVoucherWeight(false, 4.5, 100, true) ==
// VoucherWeight45Plus * 0.5 (Shadow halves the weight).
// - Shadow Freeholder: GetVoucherWeight(true, 4.0, 100, true) ==
// VoucherWeightFreeholder * 0.5 (Shadow Freeholder).
func TestShadowVouchWeight(t *testing.T) {
// Non-Shadow 4.5+ vouch: weight unchanged (VoucherWeight45Plus).
got := types.GetVoucherWeight(false, 4.5, 100, false)
if got != types.VoucherWeight45Plus {
t.Errorf("non-Shadow 4.5+ weight = %v, want %v (unchanged — additive)", got, types.VoucherWeight45Plus)
}
// Shadow 4.5+ vouch: weight halved.
got = types.GetVoucherWeight(false, 4.5, 100, true)
if got != types.VoucherWeight45Plus*0.5 {
t.Errorf("Shadow 4.5+ weight = %v, want %v (VoucherWeight45Plus * 0.5 — REQ-060)", got, types.VoucherWeight45Plus*0.5)
}
// Shadow Freeholder: weight halved.
got = types.GetVoucherWeight(true, 4.0, 100, true)
if got != types.VoucherWeightFreeholder*0.5 {
t.Errorf("Shadow Freeholder weight = %v, want %v (VoucherWeightFreeholder * 0.5 — REQ-060)", got, types.VoucherWeightFreeholder*0.5)
}
// Non-Shadow Freeholder: weight unchanged.
got = types.GetVoucherWeight(true, 4.0, 100, false)
if got != types.VoucherWeightFreeholder {
t.Errorf("non-Shadow Freeholder weight = %v, want %v (unchanged — additive)", got, types.VoucherWeightFreeholder)
}
}
// TestSlashReasonFraudulentCoverCall asserts the slash reason const for a
// fraudulent Cover Call adjudication (REQ-055 — cross-documented to
// x/cover.types.SlashReasonFraudulentCoverCall, a LOCAL const in x/cover to
// avoid importing x/standing — G-003; the two consts MUST stay in sync).
func TestSlashReasonFraudulentCoverCall(t *testing.T) {
if types.SlashReasonFraudulentCoverCall != "FraudulentCoverCall" {
t.Errorf("SlashReasonFraudulentCoverCall = %q, want %q (REQ-055 — cross-doc x/cover)", types.SlashReasonFraudulentCoverCall, "FraudulentCoverCall")
}
}
// TestVouchIsShadowField asserts the Vouch struct carries the IsShadow field
// (REQ-060 — additive; existing non-Shadow vouches keep IsShadow=false).
func TestVouchIsShadowField(t *testing.T) {
v := types.Vouch{VoucherID: "v1", VoucheeID: "u1", Category: "Travel", BondAmount: 100, Timestamp: 1000, IsShadow: true}
if !v.IsShadow {
t.Error("Vouch.IsShadow should be true when set (REQ-060)")
}
// Default zero-value is false (existing non-Shadow vouches keep false).
var v2 types.Vouch
if v2.IsShadow {
t.Error("zero-value Vouch.IsShadow should be false (additive — existing vouches unchanged)")
}
}