How fystack/mpcium works
Mpcium is a distributed MPC wallet engine: clients request wallet generation, signing, or resharing; node processes authenticate and route those events into threshold sessions, which coordinate peers and return results. The graph also shows node identity, persistence, HD derivation, service discovery, health checks, and backup capabilities. Relationships reflect sampled source references and README statements; some subsystems are documented but their internal wiring was not sampled.
Main entry points: main.go Node process · client.go MPC client · session.go Threshold sessions · badger.go Encrypted key store
Components 27
Requests and operations
- MPC client
pkg/client/client.go - Client signers
pkg/client - Keygen events
pkg/event/keygen.go - Signing events
pkg/event/sign.go - Reshare events
pkg/event/reshare.go
Node coordination
- Event consumer
pkg/eventconsumer/event_consumer.go - Keygen handler
pkg/eventconsumer/keygen_consumer.go - Signing handler
pkg/eventconsumer/sign_consumer.go - NATS messaging
pkg/messaging/jetstream_broker.go - Peer messaging
pkg/messaging
MPC and identity
- MPC node
pkg/mpc/node.go - Threshold sessions
pkg/mpc/session.go - ECDSA signing
pkg/mpc/ecdsa_signing_session.go - EdDSA signing
pkg/mpc/eddsa_signing_session.go - Identity and auth
pkg/identity/identity.go - HD derivation
pkg/ckdutil/child_derivation.go
State and key material
- Encrypted key store
pkg/kvstore/badger.go - Wallet metadata
pkg/keyinfo/keyinfo.go - Encrypted backups
pkg/kvstore/badger_backup.go
Node operations
- Node process
cmd/mpcium/main.go - Consul discovery
pkg/infra/consul.go - Health checks
pkg/healthcheck/server.go - Node setup CLI
cmd/mpcium-cli/main.go
Other components
- Wallet client
- NATS service
- MPC peers
- Consul service
Connections 37
- Wallet client → MPC client: requests operations
- MPC client → Client signers: signs requests
- MPC client → NATS messaging: publishes requests
pkg/client/client.go - MPC client → Keygen events: builds
pkg/client/client.go - MPC client → Signing events: builds
pkg/client/client.go - MPC client → Reshare events: builds
- Node process → Event consumer: starts
cmd/mpcium/main.go - Node process → MPC node: creates
cmd/mpcium/main.go - Node process → NATS messaging: connects
cmd/mpcium/main.go - Node process → Encrypted key store: opens
cmd/mpcium/main.go - Node process → Identity and auth: loads
cmd/mpcium/main.go - Node process → Consul discovery: configures
cmd/mpcium/main.go - Node process → Health checks: starts
cmd/mpcium/main.go - NATS messaging → Event consumer: delivers events
- Event consumer → Identity and auth: verifies senders
- Event consumer → Keygen handler: dispatches keygen
pkg/eventconsumer/event_consumer.go - Event consumer → Signing handler: dispatches signing
pkg/eventconsumer/event_consumer.go - Keygen handler → MPC node: creates sessions
pkg/eventconsumer/keygen_consumer.go - Signing handler → MPC node: creates sessions
- MPC node → Threshold sessions: runs sessions
- Threshold sessions → Peer messaging: coordinates peers
pkg/mpc/session.go - Threshold sessions → Identity and auth: signs messages
pkg/mpc/session.go - Threshold sessions → Encrypted key store: loads shares
pkg/mpc/session.go - ECDSA signing → Wallet metadata: reads metadata
pkg/mpc/ecdsa_signing_session.go - ECDSA signing → Encrypted key store: loads shares
pkg/mpc/ecdsa_signing_session.go - ECDSA signing → HD derivation: derives child key
- EdDSA signing → Wallet metadata: reads metadata
pkg/mpc/eddsa_signing_session.go - EdDSA signing → Encrypted key store: loads shares
pkg/mpc/eddsa_signing_session.go - Threshold sessions → MPC peers: exchanges shares
- Threshold sessions → NATS messaging: publishes results
- Keygen handler → Encrypted key store: stores shares
- Encrypted key store → Encrypted backups: backs up data
- Consul discovery → Consul service: registers nodes
- Health checks → Consul service: checks status
pkg/healthcheck/server.go - Health checks → MPC peers: checks readiness
pkg/healthcheck/server.go - Node setup CLI → Identity and auth: generates identity
- NATS service → MPC peers: relays messages