Developers
/
Developers 💻
Edit

Developers 💻

Welcome to developing on the XRPL EVM Sidechain! This guide will help you build decentralized applications on a high-performance blockchain that combines the best of both worlds.

What is the XRPL EVM Sidechain?

The XRPL EVM Sidechain is a Cosmos SDK-based blockchain that provides full support for Ethereum Virtual Machine (EVM) smart contracts. This unique architecture gives you:

  • EVM Compatibility: Deploy Solidity smart contracts with full Ethereum tooling support
  • Cosmos SDK Foundation: Benefit from fast finality, low fees, and modular architecture
  • Interoperability: Native support for IBC (Inter-Blockchain Communication) and cross-chain bridges
EVM Compatibility Notice

The XRPL EVM is currently compatible with:

  • EVM Version: Paris
  • Solidity Compiler: solc ≤ 0.8.24

With the upcoming upgrade from legacy evmOS to Cosmos EVM, compatibility will shift to:

  • EVM Version: Prague
  • Solidity Compiler: solc 0.8.30

Please ensure your contracts are compiled with the correct solc version depending on the network upgrade status.

1. Interacting with EVM

Build and deploy Ethereum-compatible smart contracts on the XRPL EVM Sidechain:

Smart Contract Development

  1. Develop a Smart Contract Learn the fundamentals of smart contract development on XRPL EVM, including Solidity best practices and development tools.

  2. Deploy the Smart Contract Step-by-step deployment guide using Remix IDE, Hardhat, or Foundry.

  3. Verify the Smart Contract Learn how to verify your contract source code on the XRPL EVM Explorer for transparency and trust.

  4. Interact with the Smart Contract Call contract functions and integrate using web3.js, ethers.js, or other Ethereum tools.

  5. Next Steps Explore advanced topics and full-stack dApp development patterns.

Data Indexing

Use Goldsky Indexer Set up real-time data indexing for your smart contracts, query events with GraphQL, and implement best practices for efficient data access.

Oracle Integration

Use Band Protocol Integrate Band Protocol's oracle contracts to fetch real-time price data on-chain for assets like XRP, BTC, ETH, and more.

Advanced Guides

Native XRP Integration

  • Using XRP as Wrapped ERC-20 Discover why you don't need to wrap XRP on XRPL EVM and how to work with the native 18-decimal ERC-20 at 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.

Cross-Chain Transactions

Build applications that span multiple blockchains using Axelar's powerful cross-chain infrastructure:

  1. Introduction to Cross-Chain Transactions Learn the fundamentals of cross-chain development, available bridge options, and when to use different solutions for connecting XRPL EVM with other blockchain ecosystems.

  2. Send Messages (Axelar GMP) Use Axelar's General Message Passing (GMP) to execute smart contract logic across chains. Enable cross-chain function calls, multi-chain governance, and complex inter-blockchain workflows.

  3. Send Tokens (Axelar ITS) Implement cross-chain token transfers using Axelar's Interchain Token Service (ITS). Move assets seamlessly between XRPL EVM and other supported networks like Ethereum, Polygon, Avalanche, and more.

  4. Swap with Squid Widget Integrate the Squid Widget to enable users to swap tokens from any supported chain directly into XRP on XRPL EVM. Perfect for onboarding users from Ethereum, Arbitrum, Polygon, and 70+ other chains.

  5. Cross-Chain FAQs Common questions, troubleshooting tips, and best practices for cross-chain development on XRPL EVM.

2. Interacting with Cosmos

Leverage the Cosmos SDK foundation for enhanced blockchain functionality:

  1. Introduction Understand how XRPL EVM leverages the Cosmos SDK for modularity, security, and interoperability.

  2. Using IBC Transfer assets to and from other Cosmos chains using Inter-Blockchain Communication protocol.

  3. Using the API Query network data using gRPC, REST, or CometBFT endpoints for deeper blockchain integration.

Advanced Guides

Address Management

  • Address Translation Convert addresses between Cosmos Bech32 format (ethm...) and EVM-style 0x formats for seamless integration across both sides of the blockchain.

Cross-Chain Transactions

  • Swap with Skip Widget Integrate Skip Protocol's widget to enable users to swap tokens from Cosmos chains like Osmosis, Injective, or Cosmos Hub directly into XRP on XRPL EVM. Perfect for accessing liquidity from the broader Cosmos ecosystem.

3. Resources

Essential tools and references for XRPL EVM development:

  • Block Explorers Track and inspect blocks, transactions, and contracts on both EVM and Cosmos sides.

  • Public APIs Access XRPL EVM via public RPC, REST, and WebSocket endpoints.