!5282odin/tss-rounds-leaf-package → develop823c343488

TSS round names move to a leaf package, so the memo parser builds without tss-lib-private

AI-generatedEverything on this page was written by an AI agent from the diff: the summaries, the narration, the diagrams, the flags and the glossary. It can be wrong or incomplete, so check it against the code before you rely on it.

2commits
8files
490lines changed
268lines to read
0tss-lib pkgs in memo deps
0behaviour changes
32–35Algo iota values (unchanged)

Where the diff is

3-minute explainer

What changed

Why

types imported messages, which imports private tss-lib.

memotypesmessagestss-lib404 anonFuzzParseMemo couldn't build outside CI

The move

Const block moves byte for byte into tssrounds; imports nothing.

messages(aliases)same bytestssroundsAlgo · 36 consts16-round mapiota 32–35

Aliases

messages re-exports every name; Bifrost call sites untouched.

type Algo = tssrounds.Algo36 const aliasessame map value, not a copy

Consensus import

x/thorchain/types swaps one import; strings and set identical.

raw roundcanonicalvalid? (16)no state change

Guard test

go list -deps on memo fails if tss-lib comes back.

develop: failsbranch: passes

Line by line · every changed logic line, narrated

4:55runtime
5code chapters
100%logic lines narrated (260/260)
4flagged spots
speed

Chapters

What to check

Ask an AI about this change

Chat assistantClaude, ChatGPT, … (reads a link)

Coding agentClaude Code, Cursor, … (reads the repo)

The context file is context.md. Use Copy with context for an AI that can't open links; it pastes the whole file in.

Glossary

Bifrost
THORNode's off-chain observer and signer; it runs TSS ceremonies and reports blame to the chain. how-bifrost-works.md ↗
Blame round
The TSS round name a keygen or keysign failure is blamed on; consensus normalizes it and checks it against ValidTssKeysignRounds. Blame process ↗ tss_round_normalizer.go ↗
FROST
A Schnorr threshold-signing protocol; its keysign rounds are in the valid set, while its equivocation-evidence rounds stay in messages.
FuzzParseMemo
The Go fuzz target for the memo parser; outside verifiers build it from a clean module cache. docs/security-fuzz.md ↗ memo_security_fuzz_test.go ↗
iota
Go's constant counter: it numbers each entry in a const block, so Algo's values depend on everything declared above them. Go spec: iota ↗
Leaf package
A package with no imports of its own, so depending on it adds nothing else to a build.
TSS
Threshold signature scheme: vault keys are split across nodes, which sign together in numbered rounds. Bifrost reports which round failed. docs/bifrost/tss.md ↗
tss-lib-private
THORChain's private fork of the TSS library. Anonymous module fetches get 404, so any package importing it can't be built by outside tools.
tssrounds
The new leaf package holding the round-name constants, Algo and the valid keysign set. It imports nothing. rounds.go ↗
Type alias
type A = B makes A another name for B, not a new type, so values pass between the two names freely. Go spec: alias declarations ↗