XRPL EVM Sidechain - Architecture | XRPL Interoperability | XRP Academy - XRP Academy
3 free lessons remaining this month

Free preview access resets monthly

Upgrade for Unlimited
Skip to main content
advanced55 min

XRPL EVM Sidechain - Architecture

Learning Objectives

Explain the architecture of the XRPL EVM Sidechain including consensus, execution, and bridge components

Analyze the security model and trust assumptions introduced by the sidechain design

Evaluate the tradeoffs between sidechain approach vs. native smart contracts on mainnet

Identify potential failure modes and risks specific to the sidechain architecture

Assess the strategic importance of successful sidechain execution for XRPL's future

XRPL faces a fundamental tension: its design optimizes for payments (fast, cheap, efficient) but limits programmability. The blockchain trilemma extends to a feature trilemma—you can't optimize for everything.

XRPL's Design Choices:

XRPL MAINNET OPTIMIZATION

Optimized For:
├── Transaction speed (3-5 second finality)
├── Transaction cost (fractions of a cent)
├── Payment settlement (built-in DEX, pathfinding)
├── Reliability (99.99%+ uptime since 2012)
└── Energy efficiency (no PoW)

NOT Optimized For:
├── General smart contracts (no native EVM/WASM)
├── Complex DeFi (limited composability)
├── Developer familiarity (unique architecture)
├── Ecosystem compatibility (isolated from EVM world)
└── Cross-chain connectivity (limited bridges)
  • Runs full EVM for smart contract compatibility
  • Uses XRP as the native gas token
  • Bridges to XRPL mainnet for asset transfers
  • Enables connection to broader EVM ecosystem

This is architectural pragmatism: preserve what works, add what's missing on the side.


System Components:

XRPL EVM SIDECHAIN ARCHITECTURE

┌─────────────────────────────────────────────────────────────────┐
│                    XRPL MAINNET                                  │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  - Native XRP ledger                                     │    │
│  │  - Existing validators (150+)                            │    │
│  │  - Current functionality preserved                       │    │
│  │  - Bridge interface (door account)                       │    │
│  └─────────────────────────────────────────────────────────┘    │
│                              │                                   │
│                              │ BRIDGE                            │
│                              │ (Federated attestation)           │
│                              │                                   │
│                              ▼                                   │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │               XRPL EVM SIDECHAIN                         │    │
│  │                                                          │    │
│  │  ┌─────────────────────────────────────────────────┐    │    │
│  │  │            CONSENSUS LAYER                       │    │    │
│  │  │  - Proof of Authority (initially)               │    │    │
│  │  │  - Validator set                                 │    │    │
│  │  │  - Block production                             │    │    │
│  │  └─────────────────────────────────────────────────┘    │    │
│  │                          │                               │    │
│  │                          ▼                               │    │
│  │  ┌─────────────────────────────────────────────────┐    │    │
│  │  │            EXECUTION LAYER (EVM)                 │    │    │
│  │  │  - Ethereum Virtual Machine                     │    │    │
│  │  │  - Solidity/Vyper smart contracts               │    │    │
│  │  │  - XRP as native gas token                       │    │    │
│  │  │  - EVM-compatible tooling                        │    │    │
│  │  └─────────────────────────────────────────────────┘    │    │
│  │                          │                               │    │
│  │                          ▼                               │    │
│  │  ┌─────────────────────────────────────────────────┐    │    │
│  │  │            BRIDGE CONTRACTS                      │    │    │
│  │  │  - Asset bridging (XRP, issued tokens)          │    │    │
│  │  │  - Attestation verification                     │    │    │
│  │  │  - Cross-chain messaging                        │    │    │
│  │  └─────────────────────────────────────────────────┘    │    │
│  └─────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────┘

Initial Consensus: Proof of Authority (PoA)

PROOF OF AUTHORITY MODEL

Characteristics:
├── Fixed set of approved validators
├── Validators known and accountable
├── Block production by rotation/selection
├── Fast block times (seconds)
├── No mining/staking for consensus participation

Validator Requirements:
├── Approved by governance/foundation
├── Run specified node software
├── Meet uptime/performance standards
├── Subject to removal for misbehavior
└── Potentially requires stake/bond

Block Production:
├── Validators take turns proposing blocks
├── Other validators validate and sign
├── Finality achieved when threshold signs
├── Failed validators skipped
└── ~2-3 second block times targeted

Comparison to Other Models:

Consensus Type      Security Source       Decentralization    Speed
─────────────────────────────────────────────────────────────────────
PoW (Bitcoin)       Computational cost    High (anyone)       Slow
PoS (Ethereum)      Staked capital        Medium              Medium
PoA (EVM Sidechain) Reputation/identity   Low (permissioned)  Fast
DPoS (EOS)          Delegated stake       Medium              Fast
XRPL Mainnet        UNL trust network     Medium              Fast

Critical Analysis:
PoA provides speed and simplicity but sacrifices decentralization. The sidechain's security depends on the honesty and competence of the validator set. This is a meaningful tradeoff—the sidechain is NOT as decentralized as Ethereum or even XRPL mainnet.

EVM Compatibility:

EVM IMPLEMENTATION DETAILS

Compatibility Target:
├── Full Ethereum Virtual Machine
├── Support for Solidity smart contracts
├── EVM opcodes compatibility
├── Precompile support (standard set)
└── Gas metering similar to Ethereum

Development Stack Support:
├── Solidity (primary smart contract language)
├── Vyper (alternative language)
├── Hardhat (development framework)
├── Foundry (testing/deployment)
├── Remix (browser IDE)
├── Web3.js / ethers.js (JavaScript libraries)
├── MetaMask (wallet)
└── Standard block explorers

Native Token: XRP
├── Used for gas payments
├── Bridged from XRPL mainnet
├── Same economic relationship as mainnet XRP
└── Burns contribute to mainnet deflation (TBD)

Key Technical Specifications (Expected):

Parameter                   Expected Value      Notes
─────────────────────────────────────────────────────────────────
Block time                  2-3 seconds         Fast for EVM
Gas limit per block         30M+                Comparable to Ethereum
Gas price                   Dynamic             Market-based
Max contract size           24KB                EVM standard
Transaction throughput      100-500 TPS         Higher than ETH L1
Finality                    Single block        PoA advantage

The bridge is the critical component connecting the sidechain to XRPL mainnet.

Bridge Design:

SIDECHAIN BRIDGE ARCHITECTURE

XRPL MAINNET                              EVM SIDECHAIN
      │                                          │
      ▼                                          │
┌──────────────┐                                 │
│ Door Account │ ◄─── Locked XRP/assets          │
│              │                                 │
│ Multi-sig    │                                 │
│ controlled   │                                 │
└──────┬───────┘                                 │
       │                                         │
       │ Attestation                             │
       │ (Witness servers observe lock)          │
       │                                         │
       ▼                                         ▼
┌───────────────────────────────────────────────────┐
│              WITNESS SERVERS                       │
│  - Monitor XRPL mainnet door account              │
│  - Observe lock/unlock events                     │
│  - Create attestations (signed messages)          │
│  - Submit to sidechain bridge contract            │
└───────────────────────────────────────────────────┘
       │                                         │
       │ Signed attestations                     │
       │                                         │
       ▼                                         ▼
                                          ┌──────────────┐
                                          │   Bridge     │
                                          │  Contract    │
                                          │              │
                                          │ - Verify     │
                                          │   attestations│
                                          │ - Mint/burn  │
                                          │   wrapped XRP│
                                          │ - Track state│
                                          └──────────────┘

1. User sends XRP to door account on mainnet
2. Witness servers observe transaction
3. Witnesses create signed attestation
4. Attestation submitted to sidechain bridge contract
5. Bridge contract verifies signatures (threshold)
6. Wrapped XRP minted to user on sidechain

1. User burns wrapped XRP on sidechain
2. Witnesses observe burn transaction
3. Witnesses create signed attestation
4. Attestation submitted to mainnet door account
5. Door account releases XRP to user

---

The sidechain introduces trust assumptions not present on XRPL mainnet:

TRUST ASSUMPTION COMPARISON

Component               XRPL Mainnet           EVM Sidechain
─────────────────────────────────────────────────────────────────
Consensus              UNL (80%+ agreement)   PoA validators
Validator selection    Decentralized          Permissioned
Transaction validity   Protocol rules         Protocol rules
Asset custody          Self-custody           Bridge custody
Cross-chain messages   N/A                    Witness attestation
Smart contracts        N/A (limited)          User-deployed code

Trust Stack for Sidechain:

TRUST REQUIREMENTS (User perspective)

To trust assets on sidechain, user must trust:

  1. VALIDATOR SET HONESTY

  2. BRIDGE INTEGRITY

  3. SMART CONTRACT SECURITY

  4. GOVERNANCE

Potential Attack Scenarios:

ATTACK VECTOR ANALYSIS

Attack Type              Description                    Mitigation
─────────────────────────────────────────────────────────────────────
Validator collusion      Majority of validators         Reputation, legal
                         collude to steal/censor        accountability

Witness compromise       Witnesses fake attestations    Threshold signatures,
                         to mint unbacked assets        monitoring

Bridge exploit           Smart contract bug allows      Audits, bug bounties,
                         unauthorized minting           rate limits

Door account compromise  Mainnet funds stolen           Multi-sig, hardware
                                                        security

Reorg attack             Chain reorganization to        Fast finality, 
                         double-spend                   checkpointing

Smart contract exploit   User contracts exploited       Not protocol's fault
                         (indirect reputation damage)   but affects ecosystem

Risk Quantification:

Risk Category            Probability    Impact          Risk Level
─────────────────────────────────────────────────────────────────────
Validator collusion      Low (5-10%)    Catastrophic    MEDIUM-HIGH
Bridge exploit           Medium (10-20%) Catastrophic   HIGH
Witness compromise       Low (5-10%)    Catastrophic    MEDIUM-HIGH
Smart contract exploits  High (30-50%)  Varies          MEDIUM
Operational failures     Medium         Temporary       MEDIUM
Regulatory action        Unknown        Varies          UNKNOWN

Overall sidechain risk: ELEVATED compared to mainnet

Note: These probabilities are estimates based on industry patterns,
not specific assessments of XRPL EVM sidechain implementation.

Honest Assessment:

SECURITY COMPARISON

Dimension                    XRPL Mainnet        EVM Sidechain
─────────────────────────────────────────────────────────────────────
Years of operation           12+ years           New
Battle-tested                Yes ($100B+ volume) No
Consensus decentralization   Medium (150+ UNL)   Low (PoA set)
Bridge risk                  None                Significant
Smart contract risk          Minimal             Significant
Known exploits               None (protocol)     Unknown
Attack surface               Small               Large

BOTTOM LINE:
The EVM sidechain is inherently less secure than XRPL mainnet.
This is the tradeoff for EVM capability. Users must understand this.

How risks are being addressed:

SECURITY MITIGATIONS

1. BRIDGE SECURITY

1. VALIDATOR ACCOUNTABILITY

1. CONTRACT SECURITY

1. OPERATIONAL SECURITY

---

Why not add smart contracts to XRPL mainnet directly?

COMPARISON: SIDECHAIN VS. NATIVE CONTRACTS

Approach              Pros                          Cons
─────────────────────────────────────────────────────────────────────
SIDECHAIN             - Preserves mainnet stability  - Bridge risk
(Current approach)    - EVM compatibility instant    - Less decentralized
                      - Separate risk isolation      - Complexity
                      - Faster to market             - Two systems to learn
                      - Can iterate independently    - Fragmented liquidity

NATIVE EVM            - No bridge risk               - Mainnet changes risky
(Hypothetical)        - Single system                - Long development time
                      - Unified liquidity            - Consensus changes needed
                      - Simpler UX                   - Could break existing use

HOOKS EXPANSION       - Native XRPL integration      - Limited vs. full EVM
(Current path)        - No bridge                    - New language to learn
                      - Preserves efficiency         - Smaller ecosystem
                      - Complementary approach       - Less powerful

CONCLUSION: Sidechain is pragmatic choice given constraints.
Hooks + sidechain together provide both native and EVM paths.

Why PoA instead of other consensus mechanisms?

CONSENSUS CHOICE ANALYSIS

PoA Chosen For:
├── Speed (fast blocks without stake/work competition)
├── Simplicity (easier to implement correctly)
├── Efficiency (low resource requirements)
├── Control (can launch with known-good validators)
└── Pragmatism (matches XRPL's semi-permissioned philosophy)

Sacrificed:
├── Decentralization (validator set is permissioned)
├── Censorship resistance (validators could collude)
├── Trustlessness (must trust validator selection)
└── Community participation (not open to all)

FUTURE OPTIONS:
├── Transition to PoS when ecosystem matures
├── Expand validator set progressively
├── Implement slashing for PoS transition
└── Federated model with diverse participants

Federated bridge vs. trustless alternatives:

BRIDGE DESIGN OPTIONS

Option              Security         Speed    Complexity    Status
─────────────────────────────────────────────────────────────────────
Federated/Witness   Medium          Fast     Low           CHOSEN
(Current design)    (trust witnesses)

Light Client        High            Medium   High          NOT FEASIBLE
                    (trustless)                           (different consensus)

Optimistic          High            Slow     Medium        POSSIBLE FUTURE
                    (fraud proofs)  (7 days)

ZK Proof            High            Medium   Very High     FAR FUTURE
                    (math proof)

RATIONALE FOR FEDERATED:
├── Light client not possible (XRPL ≠ Tendermint consensus)
├── Optimistic too slow for UX (7-day withdrawal)
├── ZK proofs not mature enough
├── Federated is practical and proven (with known risks)
└── Can upgrade bridge design later if better options emerge

The EVM sidechain is arguably XRPL's most important strategic initiative:

STRATEGIC VALUE OF EVM SIDECHAIN

1. DEVELOPER ACCESS

1. ECOSYSTEM COMPATIBILITY

1. DeFi EXPANSION

1. NARRATIVE SHIFT

The sidechain's value is contingent on successful execution:

EXECUTION RISK FACTORS

Technical Risks:
├── Bridge security (most critical)
├── EVM compatibility edge cases
├── Performance under load
├── Integration with XRPL mainnet
└── Upgrade mechanism reliability

Adoption Risks:
├── Developer interest (will they come?)
├── Liquidity bootstrap (chicken-and-egg)
├── User experience quality
├── Competing for attention with other L2s/sidechains
└── Timing relative to market conditions

Operational Risks:
├── Validator reliability
├── Witness server uptime
├── Incident response capability
├── Governance disputes
└── Key person dependencies

Timeline Risks:
├── Development delays (already occurred)
├── Audit delays
├── Launch timing vs. market conditions
└── Competitor advances during delay

OVERALL EXECUTION RISK: HIGH
This is a complex system with many dependencies.
History shows most blockchain launches have issues.
Expect problems; evaluate based on response quality.

How to evaluate sidechain success:

SUCCESS METRICS FRAMEWORK

LAUNCH PHASE (First 6 months):
├── Mainnet launch without critical bugs
├── Bridge operates reliably
├── 5+ protocols deployed
├── $10M+ TVL
└── No security incidents

GROWTH PHASE (6-18 months):
├── 20+ active protocols
├── $100M+ TVL
├── Integration with LayerZero or similar
├── Meaningful transaction volume
└── Developer community forming

MATURITY PHASE (18+ months):
├── $500M+ TVL
├── Recognized as legitimate EVM environment
├── Cross-chain volume from other chains
├── Self-sustaining developer ecosystem
└── Decentralization improvements

FAILURE INDICATORS:
├── Security incident with significant losses
├── Prolonged downtime/instability
├── <$10M TVL after 12 months
├── Developer exodus/no growth
└── Bridge exploited

How sidechain outcomes affect XRP investment thesis:

SCENARIO ANALYSIS

SCENARIO A: Strong Success (20% probability)
├── TVL reaches $500M+ within 2 years
├── Major protocols deploy (Aave, Uniswap forks, etc.)
├── Becomes meaningful EVM environment
├── XRP demand increases (gas, DeFi collateral)
├── Impact: +20-50% to XRP valuation thesis

SCENARIO B: Moderate Success (40% probability)
├── TVL reaches $50-100M
├── Niche protocols and XRPL-specific applications
├── Useful but not transformative
├── Modest XRP demand increase
├── Impact: +5-15% to XRP valuation thesis

SCENARIO C: Limited Traction (25% probability)
├── TVL stays <$50M
├── Few quality protocols
├── Doesn't attract developers
├── Minimal impact on XRP utility
├── Impact: Neutral (0-5%)

SCENARIO D: Failure (15% probability)
├── Security incident or critical bugs
├── Trust damaged, users flee
├── Negative narrative impact
├── Resources wasted
├── Impact: -10-20% to XRP valuation thesis

EXPECTED VALUE:
(0.20 × 35%) + (0.40 × 10%) + (0.25 × 2.5%) + (0.15 × -15%)
= 7% + 4% + 0.6% - 2.25% = +9.35% expected contribution

Note: These are illustrative estimates, not precise predictions.

Block Production Process:

POA BLOCK PRODUCTION

Round Structure:
├── Each round has designated block proposer
├── Proposer selected by rotation/random from validator set
├── Proposer collects transactions from mempool
├── Creates block with transactions, state root, timestamp
├── Broadcasts block to other validators

Validation:
├── Other validators receive proposed block
├── Verify transaction validity
├── Execute transactions, verify state root
├── Sign block if valid
├── Reject/ignore if invalid

Finality:
├── Block final when threshold validators sign
├── Typically 2/3 + 1 of validator set
├── Fast finality (one block) unlike PoW chains
├── No reorganization under normal operation

Fault Tolerance:
├── Can tolerate f Byzantine validators where n ≥ 3f + 1
├── With 10 validators, can tolerate 3 Byzantine
├── Larger validator set = more fault tolerance
└── But also slower consensus

Execution Layer Details:

EVM EXECUTION STACK

Client Software:
├── Based on go-ethereum (geth) or similar
├── Modified for PoA consensus
├── Custom precompiles for XRPL integration (possible)
├── Standard EVM opcodes

State Management:
├── Account-based state (like Ethereum)
├── Patricia Merkle Trie state storage
├── State stored by validators
├── Standard state proof generation

Gas Mechanics:
├── Gas metering per opcode
├── Gas price auction (EIP-1559 style possible)
├── XRP as gas payment (1 XRP = 10^6 drops)
├── Gas limits per block and transaction

Transaction Types:
├── Standard EVM transactions
├── Contract deployments
├── Contract interactions
├── Bridge transactions (special handling)

Detailed Bridge Flow:

MAINNET → SIDECHAIN BRIDGE (Deposit)

1. USER ACTION

1. MAINNET PROCESSING

1. WITNESS OBSERVATION

1. ATTESTATION CREATION

1. SIDECHAIN SUBMISSION

1. USER RECEIVES

Withdrawal Flow (Sidechain → Mainnet):

SIDECHAIN → MAINNET BRIDGE (Withdrawal)

1. USER ACTION

1. SIDECHAIN PROCESSING

1. WITNESS OBSERVATION

1. MAINNET SUBMISSION

1. USER RECEIVES

---

The XRPL EVM Sidechain is a pragmatic solution to XRPL's programmability limitations, offering EVM compatibility without risking mainnet stability. However, it introduces meaningful new trust assumptions, particularly around the bridge and validator set. The architecture is sound in principle but unproven in practice. Success requires flawless execution on security, smooth operation, developer attraction, and thoughtful decentralization over time. Users should understand they're trading XRPL mainnet's battle-tested security for expanded functionality—a tradeoff that may be worthwhile but shouldn't be ignored.


Assignment: Create a comprehensive technical assessment of the XRPL EVM Sidechain architecture.

Requirements:

  • Create detailed architecture diagram with all components

  • Document data flows for key operations (deposit, withdrawal, contract execution)

  • Identify all trust boundaries and assumptions

  • Compare to similar systems (Polygon, BSC, other sidechains)

  • Enumerate all attack vectors

  • Assess probability and impact of each

  • Identify current mitigations

  • Recommend additional security measures

  • Create risk matrix with overall assessment

  • What's needed to run a validator?

  • What's needed to run a witness server?

  • What monitoring should be in place?

  • What incident response procedures are needed?

  • Define concrete metrics for success at 6, 12, 24 months

  • Identify early warning signs of failure

  • Create monitoring dashboard requirements

  • Specify decision triggers for increasing/decreasing exposure

  • Probability-weighted scenarios for sidechain outcomes

  • Impact on XRP investment thesis for each scenario

  • Recommended monitoring approach

  • Position sizing recommendations based on risk assessment

  • Technical accuracy (25%)

  • Security analysis depth (25%)

  • Practical recommendations (25%)

  • Investment framework quality (25%)

Time investment: 5-6 hours
Value: This assessment provides the analytical framework for evaluating the sidechain as it launches and evolves.


Knowledge Check

Question 1 of 4

(Tests Knowledge):

  • XRPL EVM Sidechain documentation (when available)
  • XRPL Foundation announcements and updates
  • Developer preview materials
  • Polygon Architecture Documentation
  • BSC Technical Papers
  • Avalanche C-Chain Documentation
  • "Bridge Security Framework" - L2Beat
  • Rekt News bridge exploit analyses
  • Academic papers on cross-chain security
  • "Proof of Authority" - Wikipedia and academic sources
  • Clique PoA (geth) documentation
  • Comparison of consensus mechanisms

For Next Lesson:
Prepare for hands-on development on the EVM sidechain in Lesson 9, where we'll deploy smart contracts and interact with the bridge.


End of Lesson 8

Total words: ~7,400
Estimated completion time: 55 minutes reading + 5-6 hours for deliverable

Key Takeaways

1

Architecture is pragmatic:

The sidechain adds EVM capability without changing XRPL mainnet, preserving proven strengths while expanding functionality through a separate system.

2

Security tradeoffs are real:

PoA consensus is less decentralized than mainnet, and the bridge introduces trust assumptions in witness servers. The sidechain is inherently less secure than mainnet.

3

Bridge is the critical component:

Most risk concentrates in the bridge. Federated attestation is practical but requires trusting the witness set. Bridge security should be the primary evaluation criterion.

4

Strategic importance is high:

The sidechain is XRPL's main path to interoperability (enabling LayerZero, etc.) and developer ecosystem expansion. Success or failure significantly impacts the investment thesis.

5

Execution risk is elevated:

Complex systems have issues at launch. Expect problems and evaluate based on response quality rather than perfection. Long-term success requires sustained execution over years. ---