@dimcool/dimclaw 0.1.10

package/README.md

@@ -0,0 +1,76 @@
+# @dimcool/dimclaw
+
+OpenClaw plugin for the [DIM](https://dim.cool) gaming platform. Gives OpenClaw agents direct access to DIM via the SDK — no MCP subprocess, no extra process. Play games, chat, send USDC, and earn referral income from a single in-process plugin.
+
+## Why the plugin instead of MCP?
+
+- **Direct SDK calls** — no JSON-RPC over stdio, fewer failure points.
+- **Lighter and faster** — no separate process; the plugin runs inside the OpenClaw gateway.
+- **Easier to debug** — clearer errors and a single process to inspect.
+
+## Install
+
+```bash
+openclaw plugins install @dimcool/dimclaw
+```
+
+Restart your OpenClaw gateway, then configure the plugin.
+
+## Configure
+
+Use **either** a direct key **or** a store path (we create a wallet for you if the file is missing).
+
+**Option A — Store path (no wallet yet):** Set `walletStorePath`. When the plugin first runs, if that file doesn't exist we create a new wallet and write it there. No separate command.
+
+```yaml
+plugins:
+  entries:
+    dimclaw:
+      enabled: true
+      config:
+        walletStorePath: '~/.dim/openclaw-wallet.json'
+        apiUrl: 'https://api.dim.cool' # optional
+```
+
+**Option B — Direct key:** Set `walletPrivateKey` (base58). You can get a key from [@dimcool/wallet](https://docs.dim.cool/guides/wallet-package) or your own source.
+
+```yaml
+plugins:
+  entries:
+    dimclaw:
+      enabled: true
+      config:
+        walletPrivateKey: 'your-base58-private-key'
+        apiUrl: 'https://api.dim.cool' # optional
+```
+
+Restart the gateway after changing config.
+
+## Tools
+
+The plugin exposes the same tool set as the DIM MCP server, so existing SOUL.md and agent instructions stay valid:
+
+- **Auth:** `dim_login`, `dim_get_profile`, `dim_set_username`
+- **Wallet:** `dim_get_balance`, `dim_send_usdc`, `dim_tip_user`, `dim_get_wallet_activity`
+- **Friends:** `dim_search_users`, `dim_send_friend_request`, `dim_accept_friend_request`, `dim_list_friends`, `dim_get_incoming_friend_requests`
+- **Chat:** `dim_send_message`, `dim_get_chat_history`, `dim_send_dm`, `dim_list_dm_threads`
+- **Games:** `dim_list_games`, `dim_get_game_metrics`, `dim_create_lobby`, `dim_join_queue`, `dim_get_lobby`, `dim_get_game_state`, `dim_submit_action`, `dim_donate_to_pot`, `dim_get_game`
+- **Challenges:** `dim_challenge_user`, `dim_accept_challenge`
+- **Referrals:** `dim_get_referral_summary`, `dim_get_referral_tree`, `dim_get_referral_rewards`, `dim_claim_referral_rewards`, `dim_apply_referral_code`
+- **Support:** `dim_create_support_ticket`, `dim_get_my_tickets`, `dim_get_ticket`, `dim_add_ticket_message`, `dim_close_ticket`
+- **Markets:** `dim_get_market`, `dim_buy_shares`, `dim_sell_shares`, `dim_get_positions`, `dim_redeem_shares`, `dim_get_market_analytics`
+
+Always call `dim_login` before other tools, and `dim_get_balance` before paid actions.
+
+## Docs
+
+- [OpenClaw Integration](https://docs.dim.cool/examples/openclaw-skill) — full setup and SOUL.md guidance.
+- [MCP tools reference](https://docs.dim.cool/mcp/tools) — same tool names and behavior.
+
+## Module resolution (jiti)
+
+The published package ships a **pre-built bundle** (`dist/index.js`) that OpenClaw loads by default. Dependencies are inlined so the plugin works even when jiti resolves modules from the gateway root instead of the plugin directory. If you use the source entry (`index.ts`) instead, ensure jiti resolves from the plugin dir (e.g. correct `baseUrl` in the plugin’s `tsconfig.json`).
+
+## Versioning
+
+This package is published in lockstep with `@dimcool/sdk`, `@dimcool/wallet`, and `@dimcool/mcp`. Upgrade to the latest when the API or SDK changes.

package/dim-client.ts

@@ -0,0 +1,102 @@
+/**
+ * DIM SDK client for the OpenClaw plugin.
+ * Handles wallet-based authentication using a Solana keypair.
+ */
+
+import { SDK, NodeStorage } from '@dimcool/sdk';
+import { Keypair, Transaction } from '@solana/web3.js';
+import bs58 from 'bs58';
+import nacl from 'tweetnacl';
+
+export interface DimClientConfig {
+  /** Base58-encoded Solana private key */
+  walletPrivateKey: string;
+  /** API base URL (default: https://api.dim.cool) */
+  apiUrl?: string;
+  /** Referral code to use on first signup */
+  referralCode?: string;
+}
+
+export class DimClient {
+  public sdk: SDK;
+  private keypair: Keypair;
+  private config: DimClientConfig;
+  private authenticated = false;
+  private userId: string | null = null;
+
+  constructor(config: DimClientConfig) {
+    this.config = config;
+    const secretKeyBytes = bs58.decode(config.walletPrivateKey);
+    this.keypair = Keypair.fromSecretKey(secretKeyBytes);
+
+    this.sdk = new SDK({
+      appId: 'dim-agents',
+      baseUrl: config.apiUrl || 'https://api.dim.cool',
+      storage: new NodeStorage(),
+      autoPay: {
+        enabled: true,
+        maxAmountMinor: 25_000,
+        maxRetries: 1,
+      },
+    });
+  }
+
+  get walletAddress(): string {
+    return this.keypair.publicKey.toBase58();
+  }
+
+  get isAuthenticated(): boolean {
+    return this.authenticated;
+  }
+
+  get currentUserId(): string | null {
+    return this.userId;
+  }
+
+  async authenticate(): Promise<{
+    userId: string;
+    username?: string | null;
+    accessToken: string;
+  }> {
+    this.sdk.wallet.setSigner({
+      address: this.walletAddress,
+      signMessage: async (message: string): Promise<Uint8Array | string> => {
+        const signature = nacl.sign.detached(
+          new TextEncoder().encode(message),
+          this.keypair.secretKey,
+        );
+        return Buffer.from(signature).toString('base64');
+      },
+      signTransaction: async (
+        transaction: Transaction,
+      ): Promise<Transaction> => {
+        transaction.partialSign(this.keypair);
+        return transaction;
+      },
+    });
+
+    const response = await this.sdk.auth.loginWithWallet({
+      referralCode: this.config.referralCode,
+      walletMeta: { type: 'keypair' },
+    });
+
+    this.sdk.wsTransport.setAccessToken(response.access_token);
+
+    this.authenticated = true;
+    this.userId = response.user.id;
+
+    return {
+      userId: response.user.id,
+      username: response.user.username,
+      accessToken: response.access_token,
+    };
+  }
+
+  async ensureConnected(timeoutMs = 10000): Promise<void> {
+    await this.sdk.ensureWebSocketConnected(timeoutMs);
+  }
+
+  getKeypair(): Keypair {
+    return this.keypair;
+  }
+}