Skip to main content

Blockchain Overview

Zzyra is building comprehensive blockchain integration capabilities, starting with strong Sei Network support and expanding toward multi-chain automation with advanced security features.

Core Blockchain Capabilities

Current & Planned Blockchain Support

Current Networks

✅ Implemented - SEI Testnet (Chain ID 1328) - Native Sei operations - GOAT SDK integration 🚧 In Development - Enhanced Sei MCP server - Address format validation - Gas optimization

Planned Networks

📋 Multi-Chain Roadmap - Ethereum (Mainnet & Sepolia) - Base (Mainnet & Sepolia) - Optimism - Polygon - Arbitrum - Additional EVM chains

DeFi Roadmap

📋 Planned DeFi Features - DEX token swapping - Liquidity provision - Yield farming automation - Portfolio management - Cross-chain operations - Arbitrage detection

Enhanced Blockchain Blocks

Zzyra includes production-ready blockchain automation blocks:
Advanced Wallet Creation
  • Multi-chain wallet generation
  • Automatic testnet funding
  • Secure key management
  • Wallet type selection (EOA, Smart Contract, Multi-sig)
  • Database storage with encryption
interface CreateWalletConfig {
  chainId: "1328" | "ethereum-sepolia" | "base-sepolia";
  walletType: "eoa" | "smart" | "multisig";
  autoFund: boolean;
  fundingAmount: string;
  walletLabel?: string;
  saveToDb: boolean;
}
Comprehensive Balance Monitoring
  • Native currency balances
  • ERC20/Token balances
  • USD value integration
  • Multi-wallet monitoring
  • Portfolio tracking
interface BalanceCheckConfig {
  chainId: string;
  walletAddress: string;
  tokenAddresses?: string[];
  includeUsdValue: boolean;
}
Secure Transaction Execution
  • Session key validation
  • Spending limit enforcement
  • Multi-chain support
  • Gas optimization
  • Transaction monitoring
interface SendTransactionConfig {
  chainId: string;
  recipientAddress: string;
  amount: string;
  tokenAddress?: string;
  gasLimit?: number;
  memo?: string;
}
Advanced DEX Integration
  • Multiple DEX platforms
  • Slippage protection
  • Price impact analysis
  • Route optimization
  • MEV protection
interface SwapTokensConfig {
  chainId: string;
  fromToken: string;
  toToken: string;
  amountIn: string;
  minAmountOut?: string;
  slippageTolerance: number;
  dexPlatform: "auto" | "uniswap-v3" | "sushiswap" | "sei-dex";
  deadline: number;
}

Account Abstraction & Session Keys

Session Key System

Zzyra implements a comprehensive Account Abstraction solution using session keys:
Automated Transaction Signing - Execute transactions without manual approval - Time-bounded authorization (1 hour to 7 days) - Spending limits and security controls - Multi-chain session support Security Features - AES-256-GCM encryption - User signature-based key derivation - Hardware-level protection ready - Comprehensive audit trails

Session Key Architecture

interface SessionKeyData {
  id: string;
  userId: string;
  walletAddress: string;
  chainId: string;
  sessionPublicKey: string;
  encryptedPrivateKey: string;
  securityLevel: SecurityLevel;
  status: SessionKeyStatus;
  validUntil: Date;
  permissions: SessionPermission[];
  totalUsedAmount: string;
  dailyUsedAmount: string;
}

interface SessionPermission {
  operation: string; // "send", "swap", "stake", etc.
  maxAmountPerTx: string; // Per-transaction limit
  maxDailyAmount: string; // Daily spending limit
  allowedContracts: string[]; // Whitelisted addresses
  requireConfirmation: boolean; // Manual approval required
  emergencyStop: boolean; // Operation suspended
}

enum SecurityLevel {
  BASIC = "basic",
  ENHANCED = "enhanced",
  MAXIMUM = "maximum",
}

Blockchain Authorization Flow

Enhanced Authorization Modal

1

Workflow Analysis

Automatically detects blockchain operations in workflow and calculates spending requirements
2

Chain Configuration

Configure spending limits and security settings for each blockchain network
3

Session Key Creation

Generate encrypted session key using Magic SDK secure signing
4

Permission Setup

Configure granular permissions for each operation type
5

Execution Authorization

Enable automated blockchain operations within configured limits

Real-time Transaction Validation

Every blockchain operation undergoes comprehensive validation:
interface TransactionValidation {
  // Authorization checks
  validateBlockchainAuthorization(): boolean;
  validateChainPermissions(chainId: string): boolean;
  validateOperationPermissions(operation: string): boolean;

  // Session key validation
  validateSessionKey(sessionKeyId: string): Promise<ValidationResult>;
  checkSpendingLimits(amount: string): boolean;
  validateContractAddress(address: string): boolean;

  // Security validations
  checkTransactionSafety(transaction: Transaction): Promise<SafetyResult>;
  validateGasParameters(gasLimit: number, gasPrice: string): boolean;
  detectSuspiciousActivity(context: ExecutionContext): boolean;
}

Security Features

Multi-Layer Security

Cryptographic Security

Advanced Encryption - AES-256-GCM for session keys - Scrypt key derivation functions - Nonce-based replay protection - Authentication tag verification

Authorization Controls

Access Management - Role-based permissions - Time-bounded sessions - Spending limit enforcement - Emergency revocation

Transaction Safety

Safe Execution - Pre-execution validation - Simulation mode (planned) - Multi-signature support (planned) - Automated risk assessment

Audit & Monitoring

Complete Visibility - Real-time transaction monitoring - Comprehensive audit logs - Usage analytics - Security event tracking

Security Event Tracking

enum SessionEventType {
  CREATED = "created",
  USED = "used",
  REVOKED = "revoked",
  EXPIRED = "expired",
  SECURITY_ALERT = "security_alert",
}

interface SessionEvent {
  sessionKeyId: string;
  eventType: SessionEventType;
  eventData: Record<string, any>;
  severity: "info" | "warning" | "error" | "critical";
  ipAddress?: string;
  userAgent?: string;
  createdAt: Date;
}

Integration Patterns

Workflow Integration

Blockchain blocks integrate seamlessly with Zzyra’s workflow system:
// AI Agent can trigger blockchain operations
const aiBlockchainWorkflow = {
  blocks: [
    {
      id: "market-analysis",
      type: "AI_AGENT",
      config: {
        systemPrompt: "Analyze DeFi market conditions and recommend actions",
        selectedTools: ["brave-search", "fetch", "goat"],
      },
    },
    {
      id: "execute-swap",
      type: "SWAP_TOKENS",
      config: {
        chainId: "{{aiAgent.recommendedChain}}",
        fromToken: "{{aiAgent.fromToken}}",
        toToken: "{{aiAgent.toToken}}",
        amountIn: "{{aiAgent.swapAmount}}",
        slippageTolerance: 1.0,
      },
    },
  ],
};

Cross-Block Data Flow

// Template variables enable data flow between blocks
interface BlockDataFlow {
  // From HTTP Request block
  "{{httpRequest.data.price}}": number;
  "{{httpRequest.data.volume}}": number;

  // From Price Monitor block
  "{{priceMonitor.currentPrice}}": number;
  "{{priceMonitor.triggered}}": boolean;

  // From AI Agent block
  "{{aiAgent.recommendation}}": string;
  "{{aiAgent.confidence}}": number;

  // From Blockchain blocks
  "{{createWallet.address}}": string;
  "{{checkBalance.nativeBalance.balance}}": string;
  "{{swapTokens.transactionHash}}": string;
}

Advanced Features

MCP Blockchain Tools

Integration with Model Context Protocol for AI-driven blockchain operations:
Comprehensive Blockchain Toolkit
  • Multi-chain wallet management
  • DeFi protocol interactions
  • Token operations and swaps
  • NFT management
  • Smart contract interactions
const goatTools = {
  "goat_wallet_balance": "Check wallet balances",
  "goat_send_transaction": "Send native currency",
  "goat_swap_tokens": "Swap tokens on DEX",
  "goat_get_price": "Get token prices",
  "goat_stake_tokens": "Stake tokens for rewards"
};

Enterprise Features

Enterprise Treasury Operations - Multi-signature treasury wallets - Automated treasury rebalancing - Cross-chain treasury management - Compliance and reporting - Risk management controls
Automated DeFi Strategies - Yield farming automation - Liquidity provision management - Impermanent loss protection - Arbitrage bot deployment - Portfolio rebalancing
Advanced Risk Controls - Real-time risk assessment - Position size limitations - Exposure monitoring - Emergency stop mechanisms - Slippage protection
Regulatory Compliance - Transaction categorization - Tax reporting preparation - Audit trail generation - Compliance rule enforcement - Regulatory reporting

Best Practices

Security Best Practices

Session Key Management

Secure Session Practices - Use minimum required permissions - Set appropriate time limits - Monitor usage patterns - Implement spending controls - Enable security alerts

Transaction Safety

Safe Transaction Practices - Always validate recipient addresses - Use appropriate gas limits - Monitor for MEV attacks - Implement slippage protection - Test with small amounts first

Multi-Chain Operations

Cross-Chain Best Practices - Understand chain-specific risks - Monitor bridge security - Use reputable bridge protocols - Account for different gas tokens - Plan for network congestion

Emergency Procedures

Emergency Response - Implement emergency stops - Have revocation procedures - Monitor for unusual activity - Maintain emergency contacts - Plan incident response

Performance Optimization

// Batch operations for efficiency
interface BatchOperation {
  operations: BlockchainOperation[];
  gasOptimization: boolean;
  executionOrder: "parallel" | "sequential";
  failureHandling: "stop" | "continue" | "retry";
}

// Example batch transaction
const batchSwap: BatchOperation = {
  operations: [
    { type: "approve", token: "USDC", amount: "1000" },
    { type: "swap", fromToken: "USDC", toToken: "ETH", amount: "1000" },
    { type: "stake", token: "ETH", amount: "0.5" },
  ],
  gasOptimization: true,
  executionOrder: "sequential",
  failureHandling: "stop",
};

Troubleshooting

Common Issues

Symptoms: Session key validation failures Solutions: - Check session key expiration - Verify spending limits not exceeded - Confirm operation permissions - Review emergency stop status - Validate wallet authorization
Symptoms: Blockchain transactions failing Solutions: - Verify sufficient balance for gas - Check network congestion - Validate contract addresses - Confirm slippage tolerance - Review transaction parameters
Symptoms: Unable to connect to blockchain networks Solutions: - Check RPC endpoint status - Verify network connectivity - Confirm firewall settings - Test alternative RPC providers - Check for network maintenance

Next Steps