Getting Started

User Guides

Technical

Development

Resources

Blockchain Integration

How Elusiv integrates with blockchain networks

Overview

Elusiv leverages blockchain technology to provide immutable records, transparent transactions, and decentralized access control. The protocol uses smart contracts to manage membership, payments, and research request lifecycle.

Elusiv currently operates on EVM-compatible chains, with plans for multi-chain expansion in future versions.

Network Architecture

Current Network

Elusiv is deployed on EVM-compatible blockchain networks:

Supported Networks

  • Ethereum Mainnet (production)
  • Local test networks (development)
  • Testnets for testing and validation

Multi-Chain Future

Future versions will support:

  • Layer 2 solutions for lower costs
  • Cross-chain bridges for interoperability
  • Partner network integrations
  • Optimized deployments per network

Transaction Flow

Research Request Flow

When a user commissions research, the following on-chain transactions occur:

1. Token Approval

User approves Research Desk contract to spend $ELUSIV tokens (ERC-20 approve)

2. Request Submission

User calls requestResearch(string query) on Research Desk contract

3. Token Transfer

Contract transfers $ELUSIV tokens from user to contract (ERC-20 transferFrom)

4. Event Emission

Contract emits RequestSubmitted event with request details

5. Completion Recording

When research is complete, document hash is recorded on-chain via submitCompletion

Access Pass Minting Flow

1. Payment

User sends native token (ETH) to Access Pass contract with mint price

2. Distribution

Contract distributes payment: portion to treasury, portion to affiliate (if promo code used)

3. NFT Minting

Contract mints ERC-721 token to user's address, emits PassMinted event

On-Chain Data Storage

What's Stored On-Chain

Elusiv uses a hybrid approach: critical data on-chain, heavy data off-chain:

On-Chain

  • Research request metadata
  • Payment amounts
  • Document hashes (SHA-256)
  • Request status
  • Access Pass ownership
  • Token balances

Off-Chain

  • Full research dossiers (PDFs)
  • Source materials
  • AI agent logs
  • Model prompts
  • Large datasets

Document Hash Anchoring

Completed research dossiers are anchored on-chain via document hashes:

Process

  1. Research dossier is generated off-chain
  2. SHA-256 hash is computed from the document
  3. Hash is submitted on-chain via submitCompletion
  4. Full document stored in decentralized storage (IPFS/Filecoin/Arweave)
  5. Hash provides immutable proof of document integrity

Event Indexing

Event System

Smart contracts emit events for all significant state changes:

Access Pass Events

  • PassMinted - When a pass is minted
  • MintingStatusUpdated - Minting enabled/disabled
  • PromoUsed - Promo code redemption

Research Desk Events

  • RequestSubmitted - New research request
  • RequestCompleted - Request fulfilled
  • CompletionSubmitted - Completion submitted for approval
  • CompletionApproved - Completion approved

Token Events

  • Standard ERC-20 events (Transfer, Approval)
  • Custom events for staking/rewards (future)

Indexing Benefits

Event indexing enables:

  • Real-time Updates: Frontend can react to on-chain changes immediately
  • Analytics: Track platform usage, request patterns, and trends
  • Notifications: Alert users when their requests are completed
  • Search: Index requests by topic, requester, or status
  • Audit: Complete history of all protocol activity

Gas Optimization

Design Decisions

Elusiv is designed with gas efficiency in mind:

Minimal On-Chain Storage

Only essential data stored on-chain; heavy data stored off-chain in decentralized storage.

Efficient Data Structures

Uses mappings and arrays efficiently to minimize storage costs.

Event-Based Architecture

Heavy reliance on events for data retrieval, reducing on-chain storage needs.

Interoperability

Standard Interfaces

Elusiv uses standard token interfaces for maximum compatibility:

ERC-721

Access Pass NFT standard

ERC-20

$ELUSIV token standard

OpenZeppelin

Security-audited base contracts

Future Enhancements

Planned Improvements

  • Multi-chain deployments (L2s, partner networks)
  • Cross-chain bridges for token transfers
  • Batched transactions for gas savings
  • Layer 2 optimizations for lower costs
  • Enhanced event indexing and analytics

Continue Learning

Explore other technical aspects of the Elusiv protocol.

Security & PrivacyProtocol Architecture