Skip to Content
Rally Private Alpha is live 🚀
Technical DocumentationOverview

Overview

Dive deep into Rally’s architecture, smart contracts, and integration options. This section is for developers, auditors, and technical teams.

Architecture Overview

Rally is built on a unique multi-chain architecture that combines:

  • EVM Chains: Enables projects to distribute tokens directly in their own ecosystems where their communities already live
  • GenLayer: For AI-powered intelligent contracts and verification
  • Bridge System: Built on LayerZero for seamless cross-chain communication

Rally’s architecture enables both the security of established chains and the innovation of AI-powered verification.

Core Components

Smart Contracts (EVM)

Traditional Solidity contracts handle:

  • Campaign creation and management
  • Token escrow and distribution
  • User registration and XID verification
  • Multi-chain deployment

Intelligent Contracts (GenLayer)

Python-based contracts that leverage AI for:

  • Content quality analysis
  • Engagement verification
  • Spam detection
  • Dynamic reward calculation

Cross-Chain Bridge

Synchronizes state between chains:

  • Message passing protocol
  • State verification
  • Atomic operations
  • Fault tolerance

Technology Stack

Rally leverages cutting-edge technology across four key components:

Intelligent Contracts

AI-powered contracts on GenLayer that handle:

  • Content quality verification
  • Engagement analysis
  • Reward distribution logic
  • Anti-spam mechanisms

Smart Contracts

Traditional EVM contracts managing:

  • Campaign creation and escrow
  • Token distribution
  • Cross-chain operations
  • User authentication

Bridge

Cross-chain communication layer enabling:

  • State synchronization
  • Message passing
  • Multi-chain deployments
  • Unified user experience

App

Full-stack application providing:

  • User interface for participants and projects
  • Analytics and reporting
  • Wallet integration

Security

Rally prioritizes security through:

  • Multi-LLM Consensus: Submissions are verified by multi-LLM consensus on GenLayer 
  • Escrow Protection: Funds are held in escrow smart contracts, ensuring fair rules for content creators

Multi-Chain Architecture

Rally’s multi-chain architecture orchestrates three key blockchain environments to deliver AI-powered marketing campaigns:

GenLayer (AI Verification Layer)

  • Hosts Python-based intelligent contracts that leverage LLM consensus
  • CampaignFactory.py deploys and manages campaign instances
  • CampaignIC.py calculates submission scores using AI evaluation
  • XID.py verifies X (Twitter) account ownership and authenticity
  • BridgeSender.py stores messages for cross-chain communication

ZKSync Era Chain

  • Acts as the central routing hub for all cross-chain messages
  • BridgeForwarder.sol receives messages from Bridge Service and routes them:
    • Locally to ZKSync contracts
    • Cross-chain to Base via LayerZero
  • Provides token distribution
  • Maintains synchronized user registries and campaign rewards distributions

Base Chain

  • BridgeReceiver.sol processes incoming LayerZero messages
  • Provides token distribution
  • Maintains synchronized user registries and campaign rewards distributions

Message Flow Architecture

  1. GenLayer intelligent contracts generate verification results
  2. BridgeSender.py stores messages for the Bridge Service
  3. Bridge Service (off-chain relayer) picks up messages and calls BridgeForwarder.sol on ZKSync
  4. BridgeForwarder.sol determines the destination:
    • Local ZKSync execution for L2 operations
    • LayerZero bridge to Base
  5. Target chain contracts execute the requested operations

Advanced Topics

  • GenLayer Integration (coming soon)
  • Analytics Integration (coming soon)

Questions?

Last updated on