Files
sonr/x/dwn/client/plugin/embed.go
T
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

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)
}