Testnet Guide

Get started on testnet

Everything you need to set up MetaMask, get test tokens, and run your first escrow — step by step.

1

Install MetaMask

If you don't have MetaMask yet, install the browser extension from the official site.

Download MetaMask →
Create a new wallet and store your seed phrase safely — even on testnet, treat it as practice for mainnet habits.
2

Add the XRPL EVM Testnet to MetaMask

Cascrow runs on the XRPL EVM Sidechain Testnet. Add it as a custom network in MetaMask:

  1. Open MetaMask → click the network dropdown at the top
  2. "Add a custom network" → "Add a network manually"
  3. Fill in the fields below, then click Save
Network nameXRPL EVM Testnet
RPC URLhttps://rpc.testnet.xrplevm.org
Chain ID1449000
Currency symbolXRP
Block explorerhttps://explorer.testnet.xrplevm.org
✓ After saving, MetaMask will switch to "XRPL EVM Testnet" and show your XRP balance (0 for now).
3

Get testnet XRP for gas fees

You need a small amount of XRP on the EVM Sidechain to pay for gas. The easiest way is via the XRPL EVM Discord:

  1. Join the XRPL EVM Discord (link below)
  2. Go to the #faucet channel
  3. Type: !faucet 0x… (your MetaMask address)
  4. You'll receive 90 XRP within ~2 minutes — enough for hundreds of transactions
Join XRPL EVM Discord →
This XRP is testnet-only and has no real value — it's purely for paying gas fees on the XRPL EVM Sidechain.
4

Add MockRLUSD to MetaMask

MockRLUSD is the testnet version of RLUSD — a fake USD-pegged token you can mint freely for testing. Add it as a custom token so it shows up in your MetaMask wallet:

  1. In MetaMask, scroll down and click "Import tokens"
  2. Select "Custom token"
  3. Paste the contract address below
  4. Token symbol (RLUSD) and decimals (6) fill in automatically
  5. Click "Add custom token" → "Import tokens"
MockRLUSD contract address0xF717cC3a7ae4a8839e7d964B64A622Dae523a348
Token symbolRLUSD
Decimals6
✓ MockRLUSD now shows up in your MetaMask with a balance of 0. Next step will give you tokens.
5

Mint MockRLUSD tokens

The MockRLUSD contract has an open mint function — anyone can call it to get test tokens. The easiest way is via the block explorer:

  1. Open the MockRLUSD contract on the block explorer (link below)
  2. Once the page loads, click the "Write contract" tab
  3. Click "Connect wallet" and connect your MetaMask
  4. Find the "mint" function in the list
  5. Enter your wallet address and an amount — e.g. 10000000000 for 10,000 RLUSD (6 decimals)
  6. Click "Write" and confirm the transaction in MetaMask
Open MockRLUSD on Explorer →
Amount uses 6 decimals: 1000000 = 1 RLUSD, 10000000000 = 10,000 RLUSD
6

Register on Cascrow

Both the investor and the startup need a Cascrow account. Registration takes under a minute:

  1. Go to cascrow.xyz/register
  2. Enter your email, choose a password, and select your role (Grant Giver or Receiver)
  3. Check your email and click the verification link
  4. Log in — you're in
For a full test of the flow you need two accounts — one as Grant Giver (investor), one as Receiver (startup). Use two different email addresses or two different browsers.
7

Connect your MetaMask wallet

After logging in, connect your wallet so Cascrow knows which address to use for signing transactions:

  1. Go to your Dashboard
  2. Click "Connect Wallet" — MetaMask will pop up
  3. Select your account and confirm the connection
  4. Your 0x… address now appears on your profile
8

Create a contract (Grant Giver)

As the Grant Giver, you define the milestone and the payout amount:

  1. Click "New Contract" on your dashboard
  2. Enter a project title and describe the milestone clearly — this is what the AI will verify against
  3. Set the RLUSD amount and the deadline in days
  4. Optionally enter the Receiver's wallet address directly, or leave blank to get a shareable invite link
  5. Click "Create Contract"
Be specific in the milestone description — the AI reads this to decide if the uploaded proof meets the criteria.
9

Fund the escrow (Grant Giver)

Once both parties are linked, you lock the RLUSD on-chain:

  1. Open the contract detail page
  2. Click "Fund Escrow" — MetaMask opens with two transactions
  3. First transaction: approve MockRLUSD spending (sign in MetaMask)
  4. Second transaction: fundMilestone() locks the tokens in the escrow contract (sign in MetaMask)
  5. Wait for confirmation — status changes to "Funded"
✓ The RLUSD is now locked in the smart contract at 0x7d0B1119c3b2b6e9aAc025ae6A051C67eF40d8c4. Neither party can access it without the AI approving the proof.
10

Submit proof (Receiver)

As the Receiver (startup), upload evidence that the milestone was completed:

  1. Log in with the Receiver account and open the contract
  2. Click "Upload Proof"
  3. Upload a PDF document describing what was delivered
  4. Click "Submit" — the AI verification starts automatically
The document should clearly address the milestone criteria set by the investor. Vague or unrelated content will likely get rejected.
11

AI verification & settlement

Five AI models independently read the proof and vote. The result is immediate:

  1. Watch the contract status — it updates in real time
  2. If 3/5 models vote YES with high confidence → funds are released automatically to the Receiver
  3. If confidence is medium (60–85%) → the investor is notified to review manually
  4. If 3/5 models vote NO → the Receiver is notified with a rejection reason and can resubmit
  5. If the deadline passes without a verified proof → the investor can cancel and get a full refund
✓ On approval, an NFT completion certificate is minted on the native XRPL Ledger as permanent proof — visible on testnet.xrpl.org.

You're set.

Questions? Something not working? Open an issue or reach out — we're happy to help.

Create your first contract →