mirror of
https://github.com/sonr-io/sonr.git
synced 2026-08-03 18:01:39 +00:00
* 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>
220 lines
6.5 KiB
Go
220 lines
6.5 KiB
Go
package plugin
|
|
|
|
import (
|
|
"bytes"
|
|
"compress/zlib"
|
|
"crypto/ed25519"
|
|
_ "embed"
|
|
"encoding/base64"
|
|
"encoding/json"
|
|
"fmt"
|
|
"time"
|
|
|
|
extism "github.com/extism/go-sdk"
|
|
"github.com/sonr-io/crypto/wasm"
|
|
)
|
|
|
|
// motrPluginBytes contains the embedded WebAssembly bytecode for the cryptographic enclave.
|
|
// This is embedded at compile time and loaded into the WASM runtime for secure operations.
|
|
//
|
|
//go:embed vault.wasm
|
|
var motrPluginBytes []byte
|
|
|
|
// motrPluginHash is the SHA256 hash of the embedded WASM module
|
|
// This will be computed at runtime for verification
|
|
var motrPluginHash string
|
|
|
|
// hashVerifier is the global hash verifier for WASM modules
|
|
var hashVerifier = wasm.NewHashVerifier()
|
|
|
|
// signatureVerifier is the global signature verifier for WASM modules
|
|
var signatureVerifier = wasm.NewSignatureVerifier()
|
|
|
|
// pluginSignatureManifest stores the signature manifest for the plugin
|
|
var pluginSignatureManifest *wasm.SignatureManifest
|
|
|
|
// init initializes the hash and signature verifiers
|
|
func init() {
|
|
// Compute hash of embedded WASM module
|
|
motrPluginHash = hashVerifier.ComputeHash(motrPluginBytes)
|
|
// Add as trusted hash
|
|
hashVerifier.AddTrustedHash("motr", motrPluginHash)
|
|
|
|
// Initialize signature verification (signatures will be added via configuration)
|
|
// In production, trusted keys would be loaded from secure configuration
|
|
initializeTrustedSigningKeys()
|
|
}
|
|
|
|
// initializeTrustedSigningKeys loads trusted signing keys for verification
|
|
func initializeTrustedSigningKeys() {
|
|
// These would typically come from secure configuration
|
|
// For now, we'll prepare the infrastructure for key management
|
|
// Production keys would be loaded from config files or environment
|
|
}
|
|
|
|
// MotrPluginRaw contains the raw WebAssembly bytecode for the cryptographic enclave.
|
|
func MotrPluginRaw() ([]byte, error) {
|
|
var b bytes.Buffer
|
|
w := zlib.NewWriter(&b)
|
|
defer w.Close()
|
|
_, err := w.Write(motrPluginBytes)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return b.Bytes(), nil
|
|
}
|
|
|
|
// GetManifest returns the WebAssembly manifest configuration for the MPC-based UCAN enclave plugin.
|
|
// This manifest specifies the WASM bytecode and configuration required to run
|
|
// the MPC-based UCAN token operations.
|
|
func GetManifest() extism.Manifest {
|
|
return extism.Manifest{
|
|
Wasm: []extism.Wasm{
|
|
extism.WasmData{
|
|
Data: motrPluginBytes,
|
|
},
|
|
},
|
|
Config: map[string]string{},
|
|
}
|
|
}
|
|
|
|
// GetManifestWithEnclave returns a WebAssembly manifest with MPC enclave configuration.
|
|
// This allows passing enclave data and vault configuration to the Motor plugin via PDK environment.
|
|
// DEPRECATED: Use GetManifestFromConfig for enhanced configuration support.
|
|
func GetManifestWithEnclave(
|
|
chainID string,
|
|
enclaveData []byte,
|
|
vaultConfig map[string]any,
|
|
) extism.Manifest {
|
|
// Prepare configuration for PDK environment variables
|
|
config := map[string]string{
|
|
"chain_id": chainID,
|
|
}
|
|
|
|
// Add enclave data as JSON-encoded environment variable
|
|
if len(enclaveData) > 0 {
|
|
config["enclave"] = string(enclaveData) // Motor plugin expects JSON-encoded enclave data
|
|
}
|
|
|
|
// Add vault configuration if provided
|
|
if len(vaultConfig) > 0 {
|
|
if configBytes, err := json.Marshal(vaultConfig); err == nil {
|
|
config["vault_config"] = string(configBytes)
|
|
}
|
|
}
|
|
|
|
return extism.Manifest{
|
|
Wasm: []extism.Wasm{
|
|
extism.WasmData{
|
|
Data: motrPluginBytes,
|
|
},
|
|
},
|
|
Config: config,
|
|
}
|
|
}
|
|
|
|
// GetManifestFromConfig creates a WebAssembly manifest from an EnclaveConfig.
|
|
// This is the preferred method for creating manifests with comprehensive configuration.
|
|
func GetManifestFromConfig(config *EnclaveConfig) (extism.Manifest, error) {
|
|
manifestConfig, err := config.ToManifestConfig()
|
|
if err != nil {
|
|
return extism.Manifest{}, fmt.Errorf(
|
|
"failed to convert enclave config to manifest config: %w",
|
|
err,
|
|
)
|
|
}
|
|
|
|
return extism.Manifest{
|
|
Wasm: []extism.Wasm{
|
|
extism.WasmData{
|
|
Data: motrPluginBytes,
|
|
},
|
|
},
|
|
Config: manifestConfig,
|
|
}, nil
|
|
}
|
|
|
|
// ValidateManifest validates that a manifest contains required configuration.
|
|
func ValidateManifest(manifest extism.Manifest) error {
|
|
if len(manifest.Wasm) == 0 {
|
|
return fmt.Errorf("manifest must contain WASM data")
|
|
}
|
|
|
|
// Check for required configuration keys
|
|
requiredKeys := []string{"chain_id"}
|
|
for _, key := range requiredKeys {
|
|
if _, exists := manifest.Config[key]; !exists {
|
|
return fmt.Errorf("manifest missing required config key: %s", key)
|
|
}
|
|
}
|
|
|
|
// Validate enclave data if present
|
|
if enclaveStr, exists := manifest.Config["enclave"]; exists && enclaveStr != "" {
|
|
var enclaveData map[string]any
|
|
if err := json.Unmarshal([]byte(enclaveStr), &enclaveData); err != nil {
|
|
return fmt.Errorf("invalid enclave data in manifest: %w", err)
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// GetPluginConfig returns the configuration for the WebAssembly plugin runtime.
|
|
// It enables WASI (WebAssembly System Interface) for file system and system call access.
|
|
func GetPluginConfig() extism.PluginConfig {
|
|
return extism.PluginConfig{
|
|
EnableWasi: true,
|
|
}
|
|
}
|
|
|
|
// VerifyPluginIntegrity verifies the integrity of the WASM plugin
|
|
func VerifyPluginIntegrity(wasmBytes []byte) error {
|
|
return hashVerifier.VerifyHash("motr", wasmBytes)
|
|
}
|
|
|
|
// GetPluginHash returns the SHA256 hash of the embedded WASM module
|
|
func GetPluginHash() string {
|
|
return motrPluginHash
|
|
}
|
|
|
|
// VerifyPluginSignature verifies the signature of the WASM plugin
|
|
func VerifyPluginSignature(wasmBytes []byte, signature []byte) error {
|
|
return signatureVerifier.Verify(wasmBytes, signature)
|
|
}
|
|
|
|
// SetPluginSignatureManifest sets the signature manifest for the plugin
|
|
func SetPluginSignatureManifest(manifest *wasm.SignatureManifest) error {
|
|
if manifest == nil {
|
|
return fmt.Errorf("manifest cannot be nil")
|
|
}
|
|
pluginSignatureManifest = manifest
|
|
|
|
// Load trusted keys from manifest
|
|
for _, key := range manifest.TrustedKeys {
|
|
if key.ExpiresAt != nil && time.Now().After(*key.ExpiresAt) {
|
|
continue // Skip expired keys
|
|
}
|
|
|
|
publicKey, err := base64.StdEncoding.DecodeString(key.PublicKey)
|
|
if err != nil {
|
|
return fmt.Errorf("failed to decode public key: %w", err)
|
|
}
|
|
|
|
if err := signatureVerifier.AddTrustedKey(key.KeyID, ed25519.PublicKey(publicKey)); err != nil {
|
|
return fmt.Errorf("failed to add trusted key: %w", err)
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// GetPluginSignatureManifest returns the current signature manifest
|
|
func GetPluginSignatureManifest() *wasm.SignatureManifest {
|
|
return pluginSignatureManifest
|
|
}
|
|
|
|
// AddTrustedSigningKey adds a trusted public key for signature verification
|
|
func AddTrustedSigningKey(keyID string, publicKeyHex string) error {
|
|
return signatureVerifier.AddTrustedKeyFromHex(keyID, publicKeyHex)
|
|
}
|