CrossRamp Integration

CrossRamp enables players to exchange in-game assets for Cross Game Tokens and trade them on a decentralized exchange. Integration is simple: generate a URL and open it in a popup.

Available Features

Feature	Method	Purpose
Shop	`getCrossRampShopUrl()`	Exchange in-game assets for Cross Game Tokens
Forge	`getCrossRampForgeUrl()`	Trade tokens on decentralized exchange (DEX)

⚠️

These methods are SDK built-in — call them directly on the server object. No server-side implementation required.

Quick Start


// Shop - Exchange game assets for tokens (opens in popup)
const shopUrl = await server.getCrossRampShopUrl("en");
window.open(shopUrl, "CrossRampShop", "width=1024,height=768");
 
// Forge - Trade tokens on DEX (opens in new tab)
const forgeUrl = await server.getCrossRampForgeUrl("en");
window.open(forgeUrl, "_blank");

Supported Languages

"en" - English
"ko" - Korean
"zh" - Chinese (Simplified)
"zh-Hant" - Chinese (Traditional)
"ja" - Japanese

Full Example


import React, { useState } from "react";
import { useGameServer } from "@agent8/gameserver";
 
export default function CrossRampButtons() {
  const { connected, server } = useGameServer();
  const [loading, setLoading] = useState(false);
 
  const openShop = async () => {
    if (!connected || !server) return;
    setLoading(true);
    try {
      const url = await server.getCrossRampShopUrl("en");
      window.open(url, "CrossRampShop", "width=1024,height=768");
    } catch (error) {
      console.error("Failed to open Shop:", error);
    } finally {
      setLoading(false);
    }
  };
 
  const openForge = async () => {
    if (!connected || !server) return;
    setLoading(true);
    try {
      const url = await server.getCrossRampForgeUrl("en");
      window.open(url, "_blank");
    } catch (error) {
      console.error("Failed to open Forge:", error);
    } finally {
      setLoading(false);
    }
  };
 
  if (!connected) return <div>Connecting...</div>;
 
  return (
    <div>
      <button onClick={openShop} disabled={loading}>
        Shop
      </button>
      <button onClick={openForge} disabled={loading}>
        Forge
      </button>
    </div>
  );
}

CrossRamp handles all blockchain complexity. Asset synchronization happens automatically.