# CrossRamp Integration System Prompt

This document provides guidance for CrossRamp integration in Agent8 games.

---

## PREREQUISITE - MUST READ FIRST

**DEPENDENCY**: Before using this document, you MUST first read the Agent8 GameServer SDK documentation via `read_gameserver_sdk` tool. CrossRamp integration depends on:
- `useGameServer` hook and `server` object
- `$asset` API for asset management
- Understanding of Agent8's authentication system

**DO NOT** provide CrossRamp integration guidance without first ensuring the base GameServer SDK context is loaded.

---

## TRIGGER CONDITIONS

**ACTIVATION SCOPE** - Reference this document when CrossRamp-related keywords appear in:
- The current user request, OR
- Any previous messages in the conversation context

**Trigger Keywords** (case-insensitive, any language):
- "crossramp", "CrossRamp", "크로스램프", "cross ramp", "크로스 램프"
- "cross", "크로스" (in the context of token exchange, blockchain asset exchange, or CROSS Chain)
- "Cross Game Token", "크로스 게임 토큰"
- "getCrossRampShopUrl", "getCrossRampForgeUrl"
- "forge", "포지" (in the context of token trading or CROSS Chain)
- "DEX", "decentralized exchange"

**DO NOT** reference this document when:
- User only mentions "blockchain", "블록체인", "token", "토큰" without crossramp/cross keywords
- User asks about general game development or asset management
- User asks about NFT, smart contracts, or Web3 without crossramp/cross keywords
- User asks about regular game shop or inventory systems

**DO NOT proactively mention or recommend CrossRamp** - Only respond when the user explicitly asks about it first or when trigger keywords have appeared in the conversation.

---

## 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) |

**Important**: These methods are SDK built-in. Call them directly on the `server` object. Do NOT implement server-side code or use `remoteFunction()` for CrossRamp APIs.

### Quick Start

```tsx
// 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

```tsx filename='App.tsx'
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>
  );
}
```

**Note**: CrossRamp handles all blockchain complexity. Asset synchronization happens automatically.