mirror of
https://github.com/sonr-io/sonr.git
synced 2026-08-02 17:31: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>
261 lines
6.9 KiB
Go
261 lines
6.9 KiB
Go
package plugin_test
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"testing"
|
|
"time"
|
|
|
|
"github.com/sonr-io/crypto/mpc"
|
|
"github.com/sonr-io/sonr/x/dwn/client/plugin"
|
|
)
|
|
|
|
// ExampleLoadPluginWithEnclave demonstrates how to load and use the refactored
|
|
// Motor plugin as an MPC-based UCAN KeyshareSource.
|
|
func ExampleLoadPluginWithEnclave() {
|
|
ctx := context.Background()
|
|
|
|
// Example MPC enclave data (in practice, this would be real enclave data)
|
|
enclaveData := &mpc.EnclaveData{
|
|
// This would contain actual MPC enclave configuration
|
|
// For example purposes, we'll assume this is properly initialized
|
|
}
|
|
|
|
// Serialize enclave data for the plugin
|
|
enclaveJSON, err := json.Marshal(enclaveData)
|
|
if err != nil {
|
|
fmt.Printf("Failed to marshal enclave data: %v\n", err)
|
|
return
|
|
}
|
|
|
|
// Optional vault configuration
|
|
vaultConfig := map[string]any{
|
|
"auto_lock_timeout": 300, // 5 minutes
|
|
"key_rotation_interval": 86400, // 24 hours
|
|
"supported_chains": []string{"sonr", "cosmos", "ethereum"},
|
|
}
|
|
|
|
// Load the plugin with enclave configuration
|
|
p, err := plugin.LoadPluginWithEnclave(ctx, "sonr-testnet-1", enclaveJSON, vaultConfig)
|
|
if err != nil {
|
|
fmt.Printf("Failed to load plugin: %v\n", err)
|
|
return
|
|
}
|
|
|
|
// Get issuer DID and address
|
|
issuerResp, err := p.GetIssuerDID()
|
|
if err != nil {
|
|
fmt.Printf("Failed to get issuer DID: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Issuer DID: %s\n", issuerResp.IssuerDID)
|
|
fmt.Printf("Address: %s\n", issuerResp.Address)
|
|
fmt.Printf("Chain Code: %s\n", issuerResp.ChainCode)
|
|
|
|
// Create a UCAN origin token
|
|
originReq := &plugin.NewOriginTokenRequest{
|
|
AudienceDID: "did:sonr:example-audience",
|
|
Attenuations: []map[string]any{
|
|
{
|
|
"can": []string{"sign", "verify"},
|
|
"with": "vault://example-vault",
|
|
},
|
|
},
|
|
ExpiresAt: time.Now().Add(24 * time.Hour).Unix(),
|
|
}
|
|
|
|
originResp, err := p.NewOriginToken(originReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to create origin token: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Origin Token: %s\n", originResp.Token)
|
|
|
|
// Create an attenuated token from the origin token
|
|
attenuatedReq := &plugin.NewAttenuatedTokenRequest{
|
|
ParentToken: originResp.Token,
|
|
AudienceDID: "did:sonr:delegated-user",
|
|
Attenuations: []map[string]any{
|
|
{
|
|
"can": []string{"sign"}, // More restrictive than parent
|
|
"with": "vault://example-vault",
|
|
},
|
|
},
|
|
ExpiresAt: time.Now().Add(1 * time.Hour).Unix(), // Shorter than parent
|
|
}
|
|
|
|
attenuatedResp, err := p.NewAttenuatedToken(attenuatedReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to create attenuated token: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Attenuated Token: %s\n", attenuatedResp.Token)
|
|
|
|
// Sign some data
|
|
signReq := &plugin.SignDataRequest{
|
|
Data: []byte("Hello, UCAN world!"),
|
|
}
|
|
|
|
signResp, err := p.SignData(signReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to sign data: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Signature: %x\n", signResp.Signature)
|
|
|
|
// Verify the signature
|
|
verifyReq := &plugin.VerifyDataRequest{
|
|
Data: []byte("Hello, UCAN world!"),
|
|
Signature: signResp.Signature,
|
|
}
|
|
|
|
verifyResp, err := p.VerifyData(verifyReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to verify signature: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Signature valid: %t\n", verifyResp.Valid)
|
|
|
|
fmt.Println("Example completed successfully!")
|
|
}
|
|
|
|
// TestAdvancedOperationsExample demonstrates advanced UCAN operations
|
|
// including comprehensive signing and verification workflows.
|
|
func TestAdvancedOperationsExample(t *testing.T) {
|
|
t.Skip("Example test - skipped during normal test runs")
|
|
ctx := context.Background()
|
|
|
|
// Example MPC enclave data
|
|
enclaveData, _ := json.Marshal(&mpc.EnclaveData{})
|
|
|
|
// Load plugin with enhanced configuration
|
|
p, err := plugin.LoadPluginWithEnclave(ctx, "sonr-testnet-1", enclaveData, nil)
|
|
if err != nil {
|
|
fmt.Printf("Failed to load plugin: %v\n", err)
|
|
return
|
|
}
|
|
|
|
// UCAN-based signing approach
|
|
signReq := &plugin.SignDataRequest{
|
|
Data: []byte("UCAN secure message"),
|
|
}
|
|
|
|
signResp, err := p.SignData(signReq)
|
|
if err != nil {
|
|
fmt.Printf("Signing failed: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Signature: %x\n", signResp.Signature)
|
|
|
|
// Verify the signature
|
|
verifyReq := &plugin.VerifyDataRequest{
|
|
Data: []byte("UCAN secure message"),
|
|
Signature: signResp.Signature,
|
|
}
|
|
|
|
verifyResp, err := p.VerifyData(verifyReq)
|
|
if err != nil {
|
|
fmt.Printf("Verification failed: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Signature valid: %t\n", verifyResp.Valid)
|
|
|
|
fmt.Println("Enhanced UCAN operations completed!")
|
|
}
|
|
|
|
// TestTokenWorkflowExample demonstrates a complete UCAN token workflow
|
|
// including token creation, delegation, and validation.
|
|
func TestTokenWorkflowExample(t *testing.T) {
|
|
t.Skip("Example test - skipped during normal test runs")
|
|
ctx := context.Background()
|
|
|
|
// Load plugin with enclave configuration
|
|
enclaveData, _ := json.Marshal(&mpc.EnclaveData{})
|
|
p, err := plugin.LoadPluginWithEnclave(ctx, "sonr-testnet-1", enclaveData, nil)
|
|
if err != nil {
|
|
fmt.Printf("Failed to load plugin: %v\n", err)
|
|
return
|
|
}
|
|
|
|
// Step 1: Get issuer information
|
|
issuer, err := p.GetIssuerDID()
|
|
if err != nil {
|
|
fmt.Printf("Failed to get issuer: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Vault Issuer: %s\n", issuer.IssuerDID)
|
|
|
|
// Step 2: Create admin token with broad permissions
|
|
adminReq := &plugin.NewOriginTokenRequest{
|
|
AudienceDID: "did:sonr:admin",
|
|
Attenuations: []map[string]any{
|
|
{
|
|
"can": []string{"admin", "sign", "verify", "delegate"},
|
|
"with": fmt.Sprintf("vault://%s", issuer.Address),
|
|
},
|
|
},
|
|
ExpiresAt: time.Now().Add(7 * 24 * time.Hour).Unix(), // 7 days
|
|
}
|
|
|
|
adminToken, err := p.NewOriginToken(adminReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to create admin token: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Admin Token: %s...\n", adminToken.Token[:50])
|
|
|
|
// Step 3: Delegate signing permission to a user
|
|
userReq := &plugin.NewAttenuatedTokenRequest{
|
|
ParentToken: adminToken.Token,
|
|
AudienceDID: "did:sonr:user123",
|
|
Attenuations: []map[string]any{
|
|
{
|
|
"can": []string{"sign"}, // Only signing permission
|
|
"with": fmt.Sprintf("vault://%s", issuer.Address),
|
|
},
|
|
},
|
|
ExpiresAt: time.Now().Add(24 * time.Hour).Unix(), // 24 hours
|
|
}
|
|
|
|
userToken, err := p.NewAttenuatedToken(userReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to create user token: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("User Token: %s...\n", userToken.Token[:50])
|
|
|
|
// Step 4: Further delegate read-only permission
|
|
readOnlyReq := &plugin.NewAttenuatedTokenRequest{
|
|
ParentToken: userToken.Token,
|
|
AudienceDID: "did:sonr:readonly",
|
|
Attenuations: []map[string]any{
|
|
{
|
|
"can": []string{"verify"}, // Only verification permission
|
|
"with": fmt.Sprintf("vault://%s", issuer.Address),
|
|
},
|
|
},
|
|
ExpiresAt: time.Now().Add(1 * time.Hour).Unix(), // 1 hour
|
|
}
|
|
|
|
readOnlyToken, err := p.NewAttenuatedToken(readOnlyReq)
|
|
if err != nil {
|
|
fmt.Printf("Failed to create read-only token: %v\n", err)
|
|
return
|
|
}
|
|
|
|
fmt.Printf("Read-only Token: %s...\n", readOnlyToken.Token[:50])
|
|
|
|
fmt.Println("UCAN token delegation workflow completed successfully!")
|
|
}
|