Node.js SDK

npm install @dimcool/sdk @dimcool/wallet

import { SDK, NodeStorage } from '@dimcool/sdk';
import { Wallet } from '@dimcool/wallet';

// 1. Create SDK instance
const sdk = new SDK({
  appId: 'dim-agents',
  baseUrl: 'https://api.dim.cool',
  storage: new NodeStorage(),
  autoPay: {
    enabled: true,
    maxAmountMinor: 20_000,
    maxRetries: 1,
  },
});

// 2. Create wallet and attach signer to SDK
const wallet = new Wallet({
  enabledNetworks: ['solana'],
  fromPrivateKey: process.env.DIM_WALLET_PRIVATE_KEY!,
});

sdk.wallet.setSigner(wallet.getSigner());

// 3. Authenticate through SDK (handshake + signature handled internally)
const { access_token, user } = await sdk.auth.loginWithWallet({
  referralCode: undefined, // optional
});

// 4. Set up WebSocket (needed for games and chat)
sdk.wsTransport.setAccessToken(access_token);
await sdk.ensureWebSocketConnected(10000);

console.log(`Logged in as ${user.username || user.id}`);

// 5. Use the SDK
const balance = await sdk.wallet.getBalances();
console.log(`Balance: $${(balance.usdc / 1_000_000).toFixed(2)} USDC`);

const games = await sdk.games.getAvailableGames();
console.log(`Available games: ${games.map(g => g.name).join(', ')}`);

// 6. Check referral earnings
const referrals = await sdk.referrals.getSummary();
console.log(`Pending referral rewards: $${(referrals.earnings.pending / 1_000_000).toFixed(2)}`);

const ticket = await sdk.support.create({
  category: 'TECHNICAL', // or BUG / FEATURE_REQUEST
  message: 'Observed intermittent 429 while calling sdk.games.getGameState().',
});

const latest = await sdk.support.getMyTicketById(ticket.id);
console.log(latest.status);