PROTOCOL
DOCUMENTATION

What is LiveRecord?

LiveRecord is a blockchain protocol designed to solve one of entertainment's fundamental problems: fan contributions are invisible. Despite powering the cultural economy — trending artists, viral anime, global gaming communities — fans receive no recognition or reward for their devotion.

LiveRecord changes this. Through our R.E.C. (Record of Emotional Contribution) engine, we use AI to quantify genuine fan engagement across the internet — social media activity, streaming data, fan art creation, community participation, event attendance — and record it permanently on blockchain.

The result is a verifiable, immutable record of every fan's contribution to their fandom. This record is tied to $REC — the global fan engagement index token — which converts fandom activity into real economic value.

Key Components

• R.E.C. Engine — AI model that detects, scores, and validates genuine fan activity
• Fandom Records — Immutable onchain records of individual fan contributions
• $REC Token — Native protocol token and global fan engagement index
• LiveRecord Protocol — Permissionless smart contract infrastructure any IP can integrate

QUICK START

Get up and running with LiveRecord in 5 minutes. No sign-up required — just connect your wallet.

Step 1 — Connect Your Wallet

LiveRecord uses Solana wallets. Connect via Phantom, Solflare, or any supported wallet at kickstart.easya.io.

• Supported: Phantom, Solflare, Backpack, Glow
• Compatible with any Solana wallet that supports the Solana Wallet Adapter standard
• No email, no KYC — your wallet address is your identity

Step 2 — Link Your Fandom Activity

Authorize the R.E.C. Engine to observe your public fandom signals. This is read-only — we never post on your behalf.

Step 3 — Your R.E.C. Score Builds

Once linked, the R.E.C. Engine continuously scores your fandom activity. You can check your score in real time at any time. Scores are committed to blockchain at each epoch (every 24 hours).

Step 4 — Claim $REC

At each epoch, eligible fans can claim their $REC rewards based on their R.E.C. Score. Claims are low-cost and near-instant on Solana.

// Claim your $REC rewards (Anchor program instruction)
liverecord.methods
  .claimRewards(epoch, score, merkleProof)
  .accounts({
    recipient: wallet.publicKey,
    rewardVault: REWARD_VAULT_PDA,
    recTokenMint: REC_MINT,
  })
  .rpc();

CORE CONCEPTS

Fandom Economy

The fandom economy refers to the economic value generated by fan communities — not through direct purchases, but through cultural participation: creating content, spreading trends, maintaining community energy, and driving discovery of new fans.

R.E.C. Score

Your Record of Emotional Contribution score is a composite, weighted measure of your fandom engagement across all tracked IPs. It is:

• Cumulative — builds over time; past contributions are preserved
• Multi-dimensional — measures quality, not just quantity of engagement
• Sybil-resistant — AI filters bots and inauthentic activity
• Onchain — each epoch's snapshot is published to the blockchain

Epochs

LiveRecord operates in 24-hour epochs. At the end of each epoch, the R.E.C. Engine finalizes scores for all observed fans, publishes a Merkle root onchain, and opens the claim window for that epoch's $REC distribution.

IP Fandoms

An IP Fandom is a tracked entertainment property on LiveRecord — an idol group, anime series, music artist, or game franchise. Each IP Fandom has its own fandom pool, score multipliers, and reward allocation. IPs can join the protocol permissionlessly.

R.E.C. SCORING

The R.E.C. (Record of Emotional Contribution) Engine is the core AI component of LiveRecord Protocol. It turns public fandom signals into verifiable, onchain scores.

Signal Sources

R.E.C. Engine ingests the following public signal types:

Sybil Resistance

The R.E.C. Engine employs multiple layers of sybil detection to ensure scores reflect genuine human fans:

• Behavioral analysis — pattern recognition to distinguish authentic fan behavior from bot activity
• Cross-signal correlation — genuine fans leave consistent signals across multiple platforms
• Temporal analysis — long-term engagement history carries more weight than sudden spikes
• Social graph verification — community relationships add credibility to scored signals

Score Formula (Simplified)

REC_Score = Σ (signal_weight × quality_multiplier × recency_decay × ip_multiplier)

Where:
  signal_weight    = base weight per signal type (see table above)
  quality_multiplier = 0.1 – 5.0 based on engagement quality
  recency_decay    = e^(-λt) where t = days since signal
  ip_multiplier    = 0.5 – 2.0 based on IP fandom size & activity

$REC TOKEN

$REC is the native token of LiveRecord Protocol. It serves as the global fan engagement index for entertainment — a benchmark for fandom value, denominated onchain.

Token Utility

• Fandom rewards — earned by fans with high R.E.C. scores each epoch
• IP integration — IP owners stake $REC to join the protocol and allocate reward pools
• Governance — $REC holders vote on protocol parameters, new IP admissions, and score model updates
• Fan benefits — gating exclusive experiences, early access, and merchandise perks in partner apps
• Developer incentives — granted to builders deploying approved integrations on the protocol

Token Details

SUPPORTED NETWORK

LiveRecord Protocol is built natively on Solana. Solana's high throughput and sub-cent transaction fees mean fans never pay meaningful costs to claim their rewards.

SMART CONTRACTS

Core Contracts

Claiming Rewards (Full Interface)

#[program]
pub mod reward_distributor {
  // Claim $REC for a specific epoch
  pub fn claim(
    ctx: Context<Claim>,
    epoch: u64,
    amount: u64,
    merkle_proof: Vec<[u8; 32]>,
  ) -> Result<()> { /* ... */ }

  // View whether a recipient already claimed an epoch
  // (read the ClaimRecord PDA: seeds = [b"claim", epoch, recipient])
  // Get Merkle root for an epoch
  // (read the EpochRoot PDA: seeds = [b"epoch", epoch])
}

DEVELOPER GUIDE

LiveRecord is permissionless — any developer can build fan apps, reward integrations, or IP dashboards on top of the protocol. No whitelisting required.

Integration Options

• Direct program integration — invoke the LiveRecord Solana programs from your dApp
• REST API — query fan scores, epoch data, and IP statistics via our API
• JavaScript SDK — high-level abstractions for common integration patterns
• Webhooks — receive real-time events when scores update or epochs close

Common Use Cases for Builders

• Fan loyalty apps — gate perks and experiences by R.E.C. score threshold
• Voting systems — weight fan votes by $REC balance or R.E.C. score
• Leaderboards — build real-time fandom leaderboards per IP
• NFT gating — let fans mint exclusive NFTs based on their fandom record
• IP dashboards — analytics for IP owners to understand their global fandom

API REFERENCE

Base URL: https://api.liverecord.fun/v1

GET /fan/:address

Retrieve a fan's current R.E.C. Score and profile.

GET /v1/fan/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
X-API-Key: your_api_key

Response 200:
{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "rec_score": 4821,
  "rec_score_rank": 1204,
  "epoch": 142,
  "unclaimed_rec": "1240000000",
  "fandoms": [
    { "ip_id": "jpop-stars-001", "score": 2840, "rank": 88 },
    { "ip_id": "anime-xyz-002",  "score": 1981, "rank": 330 }
  ],
  "last_updated": "2025-04-30T00:00:00Z"
}

GET /epoch/:id

Get details about a specific epoch including Merkle root and distribution stats.

GET /v1/epoch/142
X-API-Key: your_api_key

Response 200:
{
  "epoch": 142,
  "start_time": "2025-04-29T00:00:00Z",
  "end_time":   "2025-04-30T00:00:00Z",
  "merkle_root": "8f2QnXk4...",
  "total_rec_distributed": "500000000000000",
  "total_fans_scored": 28471,
  "claim_window_closes": "2025-05-07T00:00:00Z"
}

GET /fan/:wallet/proof/:epoch

Retrieve the Merkle proof for a fan's claim for a specific epoch.

GET /v1/fan/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU/proof/142
X-API-Key: your_api_key

Response 200:
{
  "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "epoch": 142,
  "amount": "1240000000",
  "proof": [
    "9aZ5x7Q1wM3eR8Tn...",
    "Fk2pLm6gV4Nh8YjQ...",
    "Cz1bDx7JyU3Hs9KrPm..."
  ]
}

GET /ip/:ip_id

Get data about a registered IP Fandom — stats, top fans, activity.

GET /v1/ip/jpop-stars-001
X-API-Key: your_api_key

Response 200:
{
  "ip_id": "jpop-stars-001",
  "name": "J-Pop Stars",
  "category": "music",
  "total_fans": 14820,
  "active_fans_7d": 4231,
  "total_rec_allocated": "10000000000000",
  "score_multiplier": 1.5,
  "top_fans": [
    { "wallet": "5Tb9pXqK2Mr3VnHj4LzCsW8FdGyNoEaB1ZuPxR7QvJkM", "score": 9821, "rank": 1 }
  ]
}

JAVASCRIPT SDK

The LiveRecord JS SDK provides high-level abstractions for interacting with the protocol. Works in Node.js and browser environments.

Installation

npm install @liverecord/sdk
# or
yarn add @liverecord/sdk

Initialize

import { LiveRecord } from '@liverecord/sdk';

const lr = new LiveRecord({
  apiKey: 'your_api_key',
  cluster: 'mainnet-beta', // 'mainnet-beta' | 'devnet' | 'testnet'
});

// Connect user wallet
await lr.connect(wallet); // Solana Wallet Adapter wallet

Get Fan Score

const fan = await lr.getFan('7xKXt...abcd'); // Solana wallet pubkey
console.log(fan.recScore);     // 4821
console.log(fan.fandoms);      // [{ ipId, score, rank }, ...]
console.log(fan.unclaimedRec); // BN (lamports of $REC)

Claim Rewards

// Get claimable epochs
const epochs = await lr.getClaimableEpochs(userPubkey);

// Claim all pending rewards
for (const epoch of epochs) {
  const sig = await lr.claimRewards(epoch.id);
  await connection.confirmTransaction(sig, 'confirmed');
  console.log(`Claimed ${epoch.amount} $REC for epoch ${epoch.id}`);
}

WEBHOOKS

Register a webhook endpoint to receive real-time events from LiveRecord Protocol. Configure webhooks in your developer dashboard.

Available Events

Webhook Payload Example

{
  "event": "epoch.finalized",
  "timestamp": "2025-04-30T00:00:00Z",
  "data": {
    "epoch": 142,
    "merkle_root": "8f2QnXk4...",
    "total_fans": 28471,
    "total_rec_distributed": "500000000000000"
  },
  "signature": "ed25519:5Yt9pXqK2Mr..."
}

TOKEN DISTRIBUTION

Total supply: 1,000,000,000 $REC. Distribution is designed to reward fans first, with long vesting schedules for team and investors to align long-term incentives.

EARNING $REC

Fans earn $REC based on their R.E.C. Score at the end of each 24-hour epoch. The more genuine your fandom engagement, the higher your score, the larger your share of that epoch's $REC distribution.

Epoch Distribution Formula

fan_share = (fan_rec_score / total_epoch_rec_score) × epoch_allocation

Where:
  fan_rec_score      = your R.E.C. score at epoch close
  total_epoch_rec_score = sum of all scored fans in epoch
  epoch_allocation   = total $REC allocated for that epoch

Score Multipliers

Certain actions carry multipliers that boost your score beyond the base rate:

• Long-term fan bonus — 1.25x for fans with 6+ months of history
• Multi-IP fan bonus — 1.1x for fans active across 3+ IPs
• Early adopter bonus — 1.5x during the first 3 months of protocol launch
• Event attendance — up to 10x multiplier for verified live event attendance

GOVERNANCE

LiveRecord Protocol is governed by $REC token holders. Major protocol decisions — score model parameters, new IP admissions, reward allocations, smart contract upgrades — require a governance vote.

Voting Power

1 $REC = 1 vote. Votes can be delegated. A minimum of 100,000 $REC is required to submit a proposal.

Governance Process

• Proposal — posted on governance forum for community discussion (3 days)
• On-chain vote — 7-day voting window; quorum 4% of circulating supply
• Timelock — 48-hour delay before execution for security
• Execution — auto-executed by Governor contract if vote passes

DEVELOPMENT ROADMAP

LiveRecord is building toward a fully permissionless, community-governed fandom economy. Here's the phased roadmap.