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

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