LayerLedger (LL2) - Quick Reference

The Provenance Layer for Everything Real

What is LayerLedger?

LayerLedger (LL2) is a hybrid Layer-2 protocol built on XRPL that provides programmable, tamper-evident provenance for real-world assets, digital collectibles, NFC-linked objects, and multi-app ecosystems.

Key Features

✅ Hybrid Ledger - Tracks both on-chain (XRPL) and off-chain (managed custody) events
✅ State Machine - Enforces valid asset state transitions
✅ Sequencer - Orders events, prevents double-spends, manages bundles
✅ Gas Abstraction - Users don't need XRPL tokens; treasury sponsors burns
✅ Managed Custody - Instant transfers, gas-free UX, kid-safe flows
✅ Multi-World - Powers Mintlings, CardLayer, LegacyLayer from one engine
✅ Provenance - Complete asset lineage and history tracking

Architecture

Application Worlds (Mintlings, CardLayer, LegacyLayer)
           ↓
    LayerLedger (LL2)
    - Sequencer
    - State Engine
    - Provenance Log
           ↓
      XRPL L1
    - Settlement
    - Minting
    - Finality

Core Tables

Table	Purpose
`asset_registry`	Global asset list (Mintlings, Cards, Heirlooms, Packs)
`asset_states`	Current state snapshots (ownership, custody, fractions)
`asset_transactions`	Core ledger - every provable change
`asset_events`	Social/view events (scans, stories, reactions)
`gas_ledger`	Managed custody gas accounting
`xrpl_sync_log`	XRPL transaction sync for replay

Transaction Types

MINTED - Asset creation
TRANSFERRED - Ownership change
FRACTIONED - Asset fractionation
MERGED - Fraction recombination
PACK_CREATED - Bundle creation
PACK_OPENED - Bundle dissolution
BURNED - Asset destruction
LISTED / SOLD - Marketplace operations
ONCHAIN_SEND / ONCHAIN_RECEIVE / ONCHAIN_BURN - XRPL sync
INTERNAL_GAS_CHARGE / INTERNAL_GAS_COVERAGE - Gas accounting

Quick Start

Get Asset Provenance

const provenance = await api.layerledger.getAssetProvenance.query({
  asset_id: 'uuid-here'
});

Get User History

const history = await api.layerledger.getUserHistory.query({
  user_id: 'user-uuid',
  limit: 50
});

Get Gas Report

const gasReport = await api.layerledger.getGasReport.query({
  user_id: 'user-uuid'
});

Use Cases

1. Asset Provenance

Track complete history of any asset from mint to current state.

2. Managed Custody

Enable gas-free UX for users who can't hold XRPL tokens.

3. Bundle/Repack

Create virtual bundles, track component provenance, dissolve and restore.

4. Fractional Ownership

Track fractions, merge them back, maintain complete lineage.

5. Cross-App Provenance

Unified provenance across Mintlings, CardLayer, LegacyLayer.

Roadmap

Phase 1 (Current) ✅

LL2 engine
Managed custody
Provenance engine
NFC registry

Phase 2 🚧

Multi-chain anchoring (Base, Solana, Polygon)
Proof explorer

Phase 3 📋

Cross-chain fractions
Multi-chain repacks
Chain abstraction layer

Documentation

Full Whitepaper - Complete technical specification
Architecture Guide - Detailed architecture and data flow
Example Queries - SQL and tRPC query examples

Status

Version: 1.1
Phase: 1 - Active Development
Status: ✅ Production Ready (Core Features)

LayerLedger is the foundation of the LayerVerse - a unified provenance engine for digital and real-world assets.