Transactions

​

Overview

​

Transaction Types

​

Basic Transfers

​

Module-Specific Transactions

​

Service Module (x/svc) Transactions

• MsgRegisterService: Register a new service with TLD domain verification and capability requests
• MsgUpdateService: Update service metadata or request additional permissions
• DNS Verification: Simple DNS TXT record verification for domain ownership
• Stake Requirements: Services must stake SNR tokens based on requested capabilities

​

DWN Module (x/dwn) Transactions

• MsgClaimVault: Gasless transaction for claiming user vaults during onboarding
• Vault Configuration Updates: Paid transactions for advanced vault settings and WASM runtime upgrades
• Cross-Chain Operations: SNR fees for multi-chain vault management and bridging
• MPC Operations: Transaction fees for multi-party computation within secure enclaves

​

UCAN Module (x/ucan) Transactions

• MsgIssueRootCapability: Request MPC threshold signing for root capability tokens
• MsgSubmitThresholdShare: Validators submit MPC shares for capability creation
• MsgRevokeCapability: Revoke previously issued capability tokens on-chain
• Delegation Chain Processing: Computational fees for validating complex authorization chains

​

DID Module (x/did) Transactions

• DID Registration: Fees for creating new decentralized identifiers
• MsgLinkAuthentication: Add WebAuthn credentials or other authentication methods
• MsgLinkAssertion: Link identity claims and verifications to DIDs
• MsgExecuteTx: Execute UCAN-authorized transactions on behalf of DIDs

​

Fee Structure

​

Dual Fee Model

​

Fee Components

​

Economic Mechanisms

1. Gasless Subsidies: Network subsidizes vault claiming for zero-barrier onboarding
2. Stake-Based Pricing: Service registration costs scale with capability requests
3. MPC Rewards: Validators earn additional fees for threshold signing participation
4. Deflationary Pressure: Service registration fees are burned, reducing total supply

​

Transaction Lifecycle

​

Gasless Vault Claiming Flow

​

Service Registration Flow

​

UCAN Authorization Flow

​

Standard Transaction Processing

1. UCAN Validation: Check authorization tokens and delegation chains
2. Module Routing: Route to appropriate module (svc, dwn, ucan, did)
3. MPC Coordination: Multi-party computation for sensitive operations
4. State Updates: Update module-specific state and emit events
5. Fee Distribution: Distribute fees to validators, burn pool, and treasury

​

Advanced Features

​

UCAN-Powered Automation

​

Multi-Party Computation Integration

• Threshold Signing: Validators collaborate to issue root capabilities
• Key Sharding: No single point of failure for vault key management
• Secure Enclaves: WASM-based computation with hardware security
• Privacy Preservation: Zero-knowledge proofs for sensitive operations

​

Cross-Module Interactions

// Example: Complete user onboarding with service registration
const tx = {
  messages: [
    // DID Module: Create decentralized identity
    {
      type: "did/MsgCreateDID",
      creator: "sonr1abc...",
      document: didDocument,
      webauthnCredential: credential,
    },
    // DWN Module: Claim gasless vault
    {
      type: "dwn/MsgClaimVault",
      creator: "did:sonr:alice123",
      vaultConfig: vaultCID,
      mpcThreshold: 3,
    },
    // Service Module: Register domain service
    {
      type: "svc/MsgRegisterService",
      creator: "did:sonr:alice123",
      domain: "alice-app.com",
      capabilities: ["dwn:read", "dwn:write"],
      stakeAmount: "5000usnr",
    },
    // UCAN Module: Request root capability
    {
      type: "ucan/MsgIssueRootCapability",
      issuer: "did:sonr:alice123",
      audience: "alice-app.com",
      capabilities: ["service:register"],
    },
  ],
  fee: {
    amount: [{ denom: "usnr", amount: "5000" }], // Only service registration fee
    gasLimit: "500000",
  },
  memo: "Complete onboarding: Identity + Vault + Service + Capabilities",
};

// Example: Cross-chain payment automation
const paymentTx = {
  messages: [
    // UCAN: Validate payment authority
    {
      type: "ucan/MsgValidateCapability",
      token: ucanPaymentToken,
      requestedAction: "payment:send",
    },
    // DID: Execute authorized transaction
    {
      type: "did/MsgExecuteTx",
      signer: "did:sonr:alice123",
      targetChain: "osmosis-1",
      transaction: swapTransaction,
      authorization: ucanToken,
    },
  ],
};

​

Performance Optimization

​

Module-Specific Batching

1. DWN Operations: Batch vault updates and data operations
2. Service Operations: Group domain verifications and capability requests
3. UCAN Processing: Batch capability validations and delegation chains
4. Cross-Chain Coordination: Bundle InterchainAccount operations

​

Gasless Operation Prioritization

​

MPC Coordination Efficiency

// MPC threshold signing optimization
interface MPCOptimization {
  parallelShares: boolean; // Generate shares in parallel
  precomputedCommitments: boolean; // Cache commitments
  batchSigning: boolean; // Sign multiple capabilities together
  networkSharding: boolean; // Distribute computation load
}

​

Security Considerations

​

Module-Specific Security

• DID Security: WebAuthn hardware-backed authentication prevents identity theft
• UCAN Validation: Cryptographic proof chains ensure capability authenticity
• Vault Isolation: MPC key sharding prevents single points of failure
• Service Reputation: Stake-based trust system deters malicious actors

​

Zero-Knowledge Privacy

// Privacy-preserving operations
interface PrivacyFeatures {
  zkProofs: {
    ageVerification: boolean; // Prove age without revealing birthdate
    balanceProofs: boolean; // Prove sufficient funds without amounts
    reputationProofs: boolean; // Prove service quality without data
  };
  selectiveDisclosure: {
    didDocuments: boolean; // Share only necessary identity claims
    vaultData: boolean; // Controlled data access permissions
    paymentHistory: boolean; // Private transaction records
  };
}

​

Best Practices for Sonr Transactions

1. UCAN Validation: Always verify capability tokens before execution
2. MPC Coordination: Ensure threshold requirements are met
3. Gasless Limits: Monitor gasless operation quotas and fallbacks
4. Cross-Chain Safety: Validate IBC channel security and timeouts

​

Fee Distribution

​

Module-Specific Fee Sources

// Fee sources by module
interface ModuleFees {
  svc: {
    domainRegistration: "25% to burn, 75% to validators";
    capabilityRequests: "Deposit-based, refundable on completion";
    stakeSlashing: "100% to community treasury";
  };

  dwn: {
    vaultClaiming: "Gasless (subsidized by treasury)";
    storageOperations: "Standard gas fees";
    mpcOperations: "Premium fees for computation";
  };

  ucan: {
    rootCapabilityIssuance: "MPC coordination fees";
    delegationValidation: "Minimal computational costs";
    revocations: "Standard gas fees";
  };

  did: {
    didRegistration: "One-time identity creation fee";
    credentialLinking: "WebAuthn integration costs";
    crossChainExecution: "IBC and InterchainAccount fees";
  };
}

​

Future Enhancements

​

Revolutionary Capabilities in Development

• AI-Powered Automation: Natural language transaction commands through Motr Vault agents
• Predictive Authorization: Pre-approve expected transactions based on user patterns
• W3C Payment Handler: Native browser integration for seamless Web2/Web3 payments
• Subscription Automation: Recurring payments through UCAN capability delegation
• Privacy-First Operations: Full zero-knowledge transaction processing
• Hardware Enclave Integration: Dedicated Sonr hardware for enhanced security
• Cross-Chain DeFi: Seamless DeFi operations across all supported chains
• Social Recovery Networks: Trustless account recovery through guardian systems

​

Standards-Based Interoperability

// Future standards integration
interface FutureStandards {
  w3cCompliance: {
    paymentHandlerAPI: "Native browser payment integration";
    webauthnLevel3: "Enhanced biometric authentication";
    didCore2: "Next-generation identity standards";
  };

  crossChainStandards: {
    ibcV2: "Enhanced cross-chain capabilities";
    cosmwasmCompatibility: "Universal smart contract execution";
    evmIntegration: "Ethereum Virtual Machine support";
  };

  privacyStandards: {
    zkStarks: "Scalable zero-knowledge proofs";
    selectiveDisclosure: "W3C verifiable credentials";
    confidentialComputing: "Hardware-backed privacy";
  };
}