Getting Started with Games.fun

Games.fun lets players use tokens in your game. Here's the 2-minute setup:

1. Install

npm install @games-fun/sdk @games-fun/server-sdk

2. Client Setup

// Initialize SDK
const sdk = new GamesFunSDK({
    gameServerUrl: "your-server.com/validate"
});

// Handle token transfers
async function buyItem(itemId: string, price: number) {
    try {
        // Transfer tokens to game wallet
        await sdk.triggerAction("transferTokens", {
            recipient: gameWalletAddress,
            amount: price
        });
    } catch (error) {
        if (error.code === 'NO_WALLET') {
            alert('Connect wallet first');
        } else if (error.code === 'INSUFFICIENT_BALANCE') {
            alert('Not enough tokens');
        }
    }
}

3. Server Setup

// Initialize wallet
const walletClient = new WalletClient({
    apiKey: process.env.GAMES_FUN_API_KEY
});

// Validate transfers
app.post('/validate', async (req, res) => {
    const { actionName, sender, recipient, amount } = req.body;
    
    if(actionName !== 'transferTokens') {
        return res.json({ error: 'Invalid action type' });
    }

    // Check recipient is your game wallet
    if (recipient !== gameWalletAddress) {
        return res.json({ error: 'Invalid recipient' });
    }
    
    // Convert tokens to points (1:10 ratio)
    const points = amount * 10;
    
    // Update player state
    await updatePlayerBalance(sender, points);
    
    res.json({ success: true });
});

4. That's It!

Now you can:

• Accept token transfers

• Convert tokens to points

• Update game state

• Process withdrawals

Need More?

• Game Wallet - Token handling details

• Authentication - Secure your game

• React Integration - React components