Xrplevm

xrplevm

Knowledge skill for the XRPL EVM sidechain — a sovereign Cosmos SDK chain with full EVM execution, built by Peersyst with Ripple. Native gas is XRP at 18 decimals. Connectivity to XRPL is via Axelar; connectivity to Cosmos chains is via IBC; connectivity to other EVM chains is via Axelar.

How to Use

Read reference files directly:

Read <skill-dir>/references/<topic>/<file>.md

Common locations:

• claude.ai: /mnt/skills/user/xrplevm/
• Claude Code (npx skills add): .claude/skills/xrplevm/ (relative to project root)

What to read when

Reference Files

network/

• endpoints.md — Public EVM JSON-RPC, WSS, Tendermint RPC, Cosmos REST, Cosmos gRPC per network (mainnet / testnet / devnet); Cosmos + EIP-155 chain IDs; third-party providers; curl examples.
• faucet.md — Primary faucet.xrplevm.org (Next.js, repo vriveraPeersyst/faucet): Testnet mechanism (XRPL altnet → Axelar bridge, 98.83 XRP) vs Devnet mechanism (direct mint on 0xEee...EEeE, 100 XRP). Programmatic POST /api/devnet-faucet. Community #🚰・faucet Discord fallback. Third-party devnet (chains.tools).
• block-explorers.md — EVM (Blockscout-derived explorer.xrplevm.org), Cosmos governance (governance.xrplevm.org), crosschain (AxelarScan, Range, ITRocket); Blockscout /api for Hardhat customChains verify config.

architecture/

• cosmos-evm-vs-xrplevm.md — How XRPL EVM differs from a vanilla Cosmos EVM chain: PoA via x/poa, XRP as native gas with 6↔18 decimal scaling, current Prague EVM fork target.
• exrpd-node.md — Running a full node with exrpd: system requirements, install methods (binary, source, Docker peersyst/exrp, Cosmovisor), ports, data dirs, mandatory evm-chain-id setting.
• exrpd-cli.md — Day-to-day exrpd commands: status, keys, tx, query (bank, staking, gov), debug addr, governance, validator ops, IBC transfers.
• cosmos-layer-interop.md — 0x... ↔ ethm1... translation via exrpd debug addr or in-process; calling Cosmos modules from an EVM-only dApp via REST/gRPC/Tendermint RPC; x/erc20 token pairs.
• precompiles-and-wxrp.md — XRP native ERC-20 at the sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (18 decimals), x/erc20-registered ERC20MinterBurnerDecimals pattern. No WXRP wrapper needed; balance mirrors native XRP 1:1.

bridge-axelar/

• overview.md — Axelar GMP + ITS architecture, deployed contract addresses (Gateway, GasService, InterchainTokenService, InterchainTokenFactory) per network, Axelar chain IDs (xrpl, xrpl-evm), XRP token ID, AxelarExecutable pattern, XRPL Payment+memo encoding.
• xrp.md — Bridge XRP both directions via Squid UI or programmatic ITS; interchainTransfer example; r-address → 20-byte hex conversion.
• erc20.md — Bridge ERC-20s via ITS (Squid UI + programmatic call).
• iou-bridging.md — Bridge whitelisted XRPL IOUs to/from XRPL EVM: trustline + allowance flow.
• iou-registration.md — Whitelisting / registering an XRPL issued currency with Axelar ITS so it can be bridged.

bridge-ibc/

• overview.md — ICS20 IBC transfers of XRP (axrp) and Cosmos assets; channel IDs to Cosmos Hub (channel-2), Osmosis, Injective, Elys, Noble per network; Keplr UX, exrpd tx ibc-transfer transfer CLI; x/erc20 token-pair lookup for IBC ERC-20s.

swap-widgets/

• squid.md — Squid widgets on XRPL EVM: (1) Swap Widget (@0xsquid/widget, SquidWidget React component) for open-ended cross-chain swaps; (2) Deposit Widget (@0xsquid/deposit-widget, DepositWidget + DepositConfig) with deposit / payment modes for deposits into a destination address. Install, props, XRPL-EVM chain IDs (1440000 / 1449000) as strings, native XRP sentinel.
• skip-go.md — Skip Go widget (@skip-go/widget) for Cosmos-source IBC routes into XRPL EVM (xrplevm_1440000-1, denom axrp). React + Web Component, route defaults, callbacks.

tokens/

• supported.md — Token catalog grouped by origin (native XRP + mXRP, Ethereum-origin via Axelar ITS, Cosmos-origin via IBC). Live addresses from the xrplevm-tvl repo (STATIC_ASSETS + /api/tokens/approved).
• stablecoins.md — Mainnet stablecoin addresses (USDT, USDC ETH and Noble-IBC, DAI, FDUSD, USDf) + RLUSD bridging notes. Decimals per token.

dapp-dev/

• evm-tooling.md — Hardhat / Foundry / ethers / viem / web3.js setup; customChains for hardhat-verify against Blockscout; evmVersion: prague; viem defineChain for mainnet until viem ships xrplevm; devnet RPC now public.
• solidity-on-xrplevm.md — Solidity gotchas on XRPL EVM: 18-decimal XRP vs 6 drops on XRPL, axrp ↔ drops conversion, Cancun opcodes active on public RPCs (Prague EIP-2935 not deployed), sentinel ERC-20 call limits, address translation from contracts.
• wallets.md — MetaMask wallet_addEthereumChain snippets, Reown AppKit / WalletConnect with viem defineChain for mainnet, Keplr experimentalSuggestChain (coinType 60, ethm prefix, eth-key-sign), Leap, Cosmostation, Crossmark, Xaman, XRPL MetaMask Snap. Wallet capability matrix.
• social-logins.md — Reown AppKit (Google / X / GitHub / Discord / Apple / Farcaster + email) with pinned versions for XRPL EVM; provisional Privy notes.
• oracles-band.md — Band Protocol on XRPL EVM: (1) StdReferenceProxy price feeds (addresses, supported pairs, Solidity + JS examples, staleness checks); (2) custom oracle data via Band Tunnel + TSS (ITssVerifier, originatorHash, oracle scripts, custom data sources, minCount threat model — testnet TSS verifier address verified on-chain, mainnet to be checked against Band deployments).
• indexing-goldsky.md — Goldsky on XRPL EVM: graph-cli (AssemblyScript) subgraphs, no-code declarative subgraph JSON, factory pattern via templates, Mirror sinks (Postgres/ClickHouse/Kafka) and Fusion (multi-subgraph + off-chain GraphQL merging), GOLDSKY_API_KEY for CI.

ecosystem/

• dapps.md — Curated catalog of XRPL EVM dApps grouped by category (bridges, wallets, DeFi/DEX/perps, prediction markets, NFT, launchpads/tools, DAOs, oracles/indexers, explorers, infra). Built from explorer.xrplevm.org/assets/configs/marketplace_config.json + ecosystem-map-xrplevm snapshot, with broken-as-listed entries removed. Pointer to the canonical live map and the in-page submission flow.

Other

• INDEX.md — Page-by-page index of docs.xrplevm.org with one-line summaries.

Authoritative external resources

• https://docs.xrplevm.org — Canonical documentation (primary source for everything in this skill).
• https://faucet.xrplevm.org — Testnet and devnet XRP faucet.
• https://github.com/xrplevm — Peersyst's XRPL EVM org: node (the exrpd binary), networks (genesis files, peers), and other tooling.
• https://www.axelar.network — Axelar bridge documentation and tooling.
• https://github.com/axelarnetwork/axelar-contract-deployments/tree/main/xrpl — Authoritative Axelar deployments and contract interaction scripts for XRPL + XRPL EVM.
• https://ecosystem.xrplevm.org — Ecosystem map of dApps, wallets, validators, infra.
• https://discord.gg/xrplevm — Official Discord (includes #faucet channel).