Files
40eadc995e Feat/1285 es ucan formatting (#1302)
* feat: Add Enclave Usage Examples

* feat(es/ucan): Add comprehensive integration tests

- Create integration.test.ts with full UCAN token lifecycle testing
- Cover end-to-end token creation, parsing, and validation
- Test capability attenuation and delegation chains
- Validate multi-algorithm support and timestamp scenarios
- Implement error recovery and performance test scenarios

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

* No commit suggestions generated

* No commit suggestions generated

* chore: Remove migrated components and add migration documentation

Removed all code and references for components that have been moved to separate repositories:

**Moved to sonr-io/hway:**
- bridge/ - HTTP service with OAuth2/OIDC/WebAuthn handlers
- cmd/hway/ - Highway service binary
- internal/migrations/ - PostgreSQL schema migrations

**Moved to sonr-io/motr:**
- cmd/motr/ - Motor worker service (WASM vault operations)
- cmd/vault/ - Vault CLI tool
- crypto/ - Comprehensive cryptographic library
- packages/ - TypeScript SDK packages (es, sdk, ui, com, pkl)
- web/auth/ - Authentication web application
- web/dash/ - Dashboard web application

**Updated Configuration:**
- Makefile: Removed build/test/release targets for moved components
- CLAUDE.md: Simplified to focus on core blockchain components
- devbox.json: Removed scripts for moved services
- docker-compose.yml: Removed hway, postgres, redis, auth, dash services
- .github/scopes.yml: Removed CI scopes for migrated components
- .goreleaser.yml: Updated release configuration

**Added Migration Documentation:**
- MIGRATE_HWAY.md: Comprehensive Highway service architecture and migration guide
- MIGRATE_MOTR.md: Comprehensive Motor/Worker/Vault architecture and migration guide

These migration documents provide complete context for setting up the new repositories including architecture diagrams, component breakdowns, API documentation, and migration checklists.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* No commit suggestions generated

* chore: Remove contracts references and documentation

Removed all references to the contracts directory that was migrated to a separate repository.

**Changes:**
- .gitignore: Removed contract-specific ignore patterns for DAO and wSNR contracts
- .gitignore: Removed hway and motr binary references (already migrated)
- .rgignore: Removed contracts, chains, and crypto directory references
- docs/reference/contracts/: Removed DAO.mdx and wSNR.mdx documentation files

This completes the cleanup of migrated components from the repository.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: add crypto library migration documentation

Added comprehensive migration documentation for the crypto library that was
moved to sonr-io/crypto repository. This documentation provides complete context
for understanding the cryptographic primitives and protocols used throughout
the Sonr ecosystem.

## Key Documentation Added

### MIGRATE_CRYPTO.md
Complete documentation of the crypto library covering:

**Core Cryptographic Primitives**
- Elliptic curve implementations (Ed25519, Secp256k1, P-256, BLS12-381, Pallas/Vesta)
- Native curve arithmetic with optimized field operations
- Pairing-friendly curves for BLS signatures

**Multi-Party Computation (MPC)**
- MPC enclave for vault key generation and management
- Threshold cryptography (TECDSA, TED25519 with FROST protocol)
- Distributed Key Generation (DKG) via Gennaro and FROST protocols
- Secret sharing schemes (Shamir, Feldman VSS, Pedersen VSS)

**Digital Signature Schemes**
- BLS signatures with aggregation support
- BBS+ signatures for selective disclosure
- Schnorr signatures (standard and Mina/NEM variants)
- ECDSA with deterministic nonce generation

**Zero-Knowledge Proofs**
- Bulletproofs for range proofs
- Inner Product Arguments (IPA)
- Batch verification support

**Advanced Cryptographic Protocols**
- Cryptographic accumulators for set membership proofs
- Paillier homomorphic encryption
- Oblivious Transfer (OT) protocols
- Verifiable Random Functions (VRF)

**Key Management & Identity**
- DID key management with multi-chain support
- Multi-algorithm public key handling
- Wallet address derivation (Bitcoin, Ethereum, Cosmos, Solana, etc.)

**UCAN Integration**
- User-Controlled Authorization Networks
- Capability delegation and attenuation
- JWT-based capability tokens
- MPC-enabled UCAN signing

**Security Utilities**
- AEAD encryption (AES-GCM, AES-SIV)
- Argon2 key derivation
- ECIES encryption
- Secure memory handling

### MIGRATE_MOTR.md Updates
Updated Motor migration documentation to clarify that the crypto library
is now a separate external dependency at github.com/sonr-io/crypto v1.0.1

## Repository Context

The crypto library has been successfully migrated to its own repository
and is published as a Go module. It serves as the foundational cryptographic
layer for:
- Sonr blockchain (snrd) - DID signatures, vault operations
- Highway service (hway) - UCAN token signing, WebAuthn
- Motor/Worker (motr) - MPC vault operations, threshold signatures

## Integration Impact

All Sonr ecosystem components now depend on the external crypto library:
```go
require github.com/sonr-io/crypto v1.0.1
```

The migration enables independent versioning and maintenance of cryptographic
primitives while maintaining security and compatibility across the ecosystem.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* No commit suggestions generated

* No commit suggestions generated

* No commit suggestions generated

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-10-10 11:47:18 -04:00

197 lines
4.8 KiB
Go

// Package context provides the Sonr context system for managing node-specific state.
package context
import (
"fmt"
"os"
"path/filepath"
"sync"
"cosmossdk.io/log"
"github.com/cosmos/cosmos-sdk/client"
"github.com/sonr-io/crypto/vrf"
)
// SonrContext manages node-specific state and configuration
type SonrContext struct {
logger log.Logger
// VRF keypair for the node
vrfPrivateKey vrf.PrivateKey
vrfPublicKey vrf.PublicKey
// Client context for transaction operations
clientCtx client.Context
// Synchronization for thread-safe access
mu sync.RWMutex
// Initialization state
initialized bool
}
// NewSonrContext creates a new SonrContext instance
func NewSonrContext(logger log.Logger) *SonrContext {
if logger == nil {
logger = log.NewNopLogger()
}
return &SonrContext{
logger: logger.With("component", "sonr-context"),
initialized: false,
}
}
// SetClientContext sets the client context for transaction operations (thread-safe)
func (sc *SonrContext) SetClientContext(clientCtx client.Context) {
sc.mu.Lock()
defer sc.mu.Unlock()
sc.clientCtx = clientCtx
}
// GetClientContext returns the client context (thread-safe)
func (sc *SonrContext) GetClientContext() (client.Context, error) {
sc.mu.RLock()
defer sc.mu.RUnlock()
if sc.clientCtx.Codec == nil {
return client.Context{}, fmt.Errorf("client context not initialized")
}
return sc.clientCtx, nil
}
// Initialize loads the VRF keypair from storage
func (sc *SonrContext) Initialize() error {
sc.mu.Lock()
defer sc.mu.Unlock()
if sc.initialized {
return nil
}
// Load VRF private key from storage
// Use hardcoded default path to avoid import cycle
defaultNodeHome := os.ExpandEnv("$HOME/.sonr")
vrfKeyPath := filepath.Join(defaultNodeHome, "vrf_secret.key")
// #nosec G304 - vrfKeyPath is constructed from trusted DefaultNodeHome constant
vrfKeyData, err := os.ReadFile(vrfKeyPath)
if err != nil {
return fmt.Errorf("failed to read VRF secret key from %s: %w\n"+
"VRF keys are required for multi-validator encryption features.\n"+
"To generate VRF keys:\n"+
" 1. For new nodes: Run 'snrd init <moniker>' to initialize with VRF keys\n"+
" 2. For existing nodes: VRF keys should have been generated during init\n"+
" 3. If encryption is not needed, disable it in DWN module params",
vrfKeyPath, err)
}
// Validate key size
if len(vrfKeyData) != vrf.PrivateKeySize {
return fmt.Errorf(
"invalid VRF private key size: expected %d, got %d",
vrf.PrivateKeySize,
len(vrfKeyData),
)
}
sc.vrfPrivateKey = vrf.PrivateKey(vrfKeyData)
// Derive public key
publicKey, ok := sc.vrfPrivateKey.Public()
if !ok {
return fmt.Errorf("failed to derive VRF public key from private key")
}
sc.vrfPublicKey = publicKey
sc.initialized = true
sc.logger.Info("SonrContext initialized successfully",
"vrf_key_path", vrfKeyPath,
"public_key_size", len(sc.vrfPublicKey),
)
return nil
}
// GetVRFPrivateKey returns the VRF private key (thread-safe)
func (sc *SonrContext) GetVRFPrivateKey() (vrf.PrivateKey, error) {
sc.mu.RLock()
defer sc.mu.RUnlock()
if !sc.initialized {
return nil, fmt.Errorf("SonrContext not initialized")
}
return sc.vrfPrivateKey, nil
}
// GetVRFPublicKey returns the VRF public key (thread-safe)
func (sc *SonrContext) GetVRFPublicKey() (vrf.PublicKey, error) {
sc.mu.RLock()
defer sc.mu.RUnlock()
if !sc.initialized {
return nil, fmt.Errorf("SonrContext not initialized")
}
return sc.vrfPublicKey, nil
}
// IsInitialized returns whether the context has been initialized (thread-safe)
func (sc *SonrContext) IsInitialized() bool {
sc.mu.RLock()
defer sc.mu.RUnlock()
return sc.initialized
}
// ComputeVRF generates VRF output for the given input using the loaded private key
func (sc *SonrContext) ComputeVRF(input []byte) ([]byte, error) {
sc.mu.RLock()
defer sc.mu.RUnlock()
if !sc.initialized {
return nil, fmt.Errorf("SonrContext not initialized")
}
if len(input) == 0 {
return nil, fmt.Errorf("VRF input cannot be empty")
}
return sc.vrfPrivateKey.Compute(input), nil
}
// ProveVRF generates VRF output with proof for the given input
func (sc *SonrContext) ProveVRF(input []byte) (vrf []byte, proof []byte, err error) {
sc.mu.RLock()
defer sc.mu.RUnlock()
if !sc.initialized {
return nil, nil, fmt.Errorf("SonrContext not initialized")
}
if len(input) == 0 {
return nil, nil, fmt.Errorf("VRF input cannot be empty")
}
vrf, proof = sc.vrfPrivateKey.Prove(input)
return vrf, proof, nil
}
// Global context instance (initialized by the node)
var globalSonrContext *SonrContext
// SetGlobalSonrContext sets the global SonrContext instance
func SetGlobalSonrContext(ctx *SonrContext) {
globalSonrContext = ctx
}
// GetGlobalSonrContext returns the global SonrContext instance
func GetGlobalSonrContext() *SonrContext {
return globalSonrContext
}