Quickstart

Overview

This guide walks you through sending your first MEV-protected transaction with YoorQuezt. By the end, your transactions will be privately routed, shielded from sandwich attacks, and eligible for backrun rebates.

Prerequisites

• A wallet with funds on a supported chain (e.g., Ethereum Sepolia for testing)
• curl or any HTTP client
• Basic familiarity with EVM transactions

Step 1: Register for an API Key

Sign up at yoorquezt.io/portal/dashboard or register via the API:

curl -X POST https://api.yoorquezt.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "name": "My App"
  }'

Response:

{
  "api_key": "yq_test_abc123...",
  "tier": "free",
  "rate_limit": 100
}

Save your API key. Test keys (yq_test_) work on all testnets. Request a live key (yq_live_) when you're ready for mainnet.

Step 2: Point Your RPC to YoorQuezt

Replace your existing RPC endpoint with the YoorQuezt protected endpoint:

https://rpc.yoorquezt.com/v1/rpc/{CHAIN}

Pass your API key via the X-API-Key header. For wallets like MetaMask, add a custom network with this RPC URL. All standard JSON-RPC methods are supported — only eth_sendRawTransaction is intercepted for MEV protection.

Step 3: Send a Protected Transaction

Send a signed transaction through the protected endpoint:

curl -X POST https://rpc.yoorquezt.com/v1/rpc/ethereum \
  -H "X-API-Key: yq_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_sendRawTransaction",
    "params": ["0x YOUR_SIGNED_TX_HEX"]
  }'

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x TRANSACTION_HASH"
}

Your transaction is now privately routed through the YoorQuezt mesh network. It will never appear in the public mempool.

Step 4: Check Your Rebates

After your transaction is included in a block, check if a backrun was captured and a rebate is available:

curl https://mev.yoorquezt.io/protect/rebates?originator_id=YOUR_ADDRESS \
  -H "X-API-Key: yq_test_abc123" \
  -H "Content-Type: application/json"

Response:

{
  "rebates": [
    {
      "tx_hash": "0x...",
      "backrun_profit": "0.0042 ETH",
      "rebate_amount": "0.00378 ETH",
      "rebate_pct": 90,
      "status": "claimable",
      "chain_id": 11155111
    }
  ],
  "total_claimable": "0.00378 ETH"
}

Rebates are distributed via the on-chain RebateDistributor contract. Claim them at any time through the dashboard or the API.

What Happens Behind the Scenes

1. Your transaction enters the YoorQuezt mesh network via the protected RPC
2. It is broadcast privately to block builders — never to the public mempool
3. Searchers compete in a sealed-bid auction to backrun your transaction
4. The winning searcher's bundle is submitted alongside your transaction
5. 90% of the backrun profit is returned to you as a rebate

Next Steps

• Authentication — Understand API keys and access tiers
• Supported Chains — See all available networks and endpoints
• SDK Integration — Use the TypeScript, Python, or Go SDK for programmatic access