@dimcool/dimclaw 0.1.10 → 0.1.11

package/dist/index.js

@@ -55022,10 +55022,12 @@ var Wallet = class {
    */
   async getBalances() {
     try {
-      const response = await this.http.get(
-        "/wallets/me/balance"
-      );
-      return response;
+      const raw = await this.http.get("/wallets/me/balance");
+      const usdcDollars = raw.usdc / 1e6;
+      return {
+        ...raw,
+        usdcFormatted: `$${usdcDollars.toFixed(2)}`
+      };
     } catch (error) {
       this.logger.error("Failed to get balances", {
         error: error instanceof Error ? error.message : String(error)
@@ -57444,26 +57446,37 @@ function register(api) {
   }
   api.registerTool({
     name: "dim_login",
-    description: "Authenticate with DIM using the configured wallet. Must be called before using any other tools. Returns user profile info.",
+    description: "Authenticate with DIM using the configured wallet. After login: set a username with dim_set_username, check balance with dim_get_balance, list games with dim_list_games, or apply a referral code with dim_apply_referral_code for a 10% fee discount.",
     parameters: { type: "object", properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
       if ("error" in c) return c.error;
       try {
         const result = await c.authenticate();
-        const response = {
-          success: true,
-          userId: result.userId,
-          username: result.username,
-          walletAddress: c.walletAddress
-        };
+        const nextSteps = [];
+        if (result.username == null || result.username === "") {
+          nextSteps.push(
+            "No username set \u2014 call dim_set_username to claim one"
+          );
+        }
+        nextSteps.push("Check your balance with dim_get_balance");
+        nextSteps.push("Explore available games with dim_list_games");
         try {
           const summary = await c.sdk.referrals.getSummary();
           if (!summary.hasReferrer) {
-            response.referralHint = "You have no referrer yet. Use dim_apply_referral_code to apply one and get a 10% fee discount.";
+            nextSteps.push(
+              "No referrer yet \u2014 call dim_apply_referral_code for 10% fee discount"
+            );
           }
         } catch {
         }
+        const response = {
+          success: true,
+          userId: result.userId,
+          username: result.username ?? null,
+          walletAddress: c.walletAddress,
+          nextSteps
+        };
         return textResult(JSON.stringify(response, null, 2));
       } catch (err) {
         return textResult(
@@ -57529,9 +57542,165 @@ function register(api) {
       }
     }
   });
+  const DIM_INSTRUCTIONS = [
+    {
+      name: "dim_login",
+      description: "Authenticate with DIM. Call first; then set username, check balance, list games, or apply referral code."
+    },
+    {
+      name: "dim_get_profile",
+      description: "Get current user profile (username, avatar, bio, chess ELO)."
+    },
+    {
+      name: "dim_set_username",
+      description: "Set or update your username (alphanumeric, 3\u201320 chars)."
+    },
+    {
+      name: "dim_list_instructions",
+      description: "List all available DIM tools and short descriptions (this list)."
+    },
+    {
+      name: "dim_get_balance",
+      description: "Get SOL and USDC balance; usdcFormatted is always present (e.g. $0.00)."
+    },
+    {
+      name: "dim_send_usdc",
+      description: "Send USDC to a user by username or address. 1\xA2 fee; amount in dollars."
+    },
+    {
+      name: "dim_tip_user",
+      description: "Tip a user with USDC; broadcast to global chat. 1\xA2 fee."
+    },
+    {
+      name: "dim_get_wallet_activity",
+      description: "Get recent wallet activity (deposits, payouts, transfers)."
+    },
+    { name: "dim_search_users", description: "Search users by username." },
+    {
+      name: "dim_send_friend_request",
+      description: "Send friend request by user ID."
+    },
+    {
+      name: "dim_accept_friend_request",
+      description: "Accept an incoming friend request."
+    },
+    {
+      name: "dim_list_friends",
+      description: "List your friends with pagination."
+    },
+    {
+      name: "dim_get_incoming_friend_requests",
+      description: "List pending incoming friend requests."
+    },
+    {
+      name: "dim_send_message",
+      description: "Send chat in a context (lobby, game, dm, global)."
+    },
+    {
+      name: "dim_get_chat_history",
+      description: "Get chat history for a context."
+    },
+    {
+      name: "dim_send_dm",
+      description: "Send a direct message to a user by ID."
+    },
+    {
+      name: "dim_list_dm_threads",
+      description: "List DM threads with last message and unread counts."
+    },
+    {
+      name: "dim_list_games",
+      description: "List available game types (RPS, Chess, Tic-Tac-Toe, etc.)."
+    },
+    {
+      name: "dim_get_game_metrics",
+      description: "Get real-time metrics: active players, live games, money in play."
+    },
+    {
+      name: "dim_create_lobby",
+      description: "Create a game lobby; bet in USDC minor units."
+    },
+    {
+      name: "dim_join_queue",
+      description: "Join matchmaking queue for a game type."
+    },
+    { name: "dim_get_lobby", description: "Get lobby details by ID." },
+    {
+      name: "dim_get_game_state",
+      description: "Get current state of a game (for submitting moves)."
+    },
+    {
+      name: "dim_submit_action",
+      description: "Submit a move/action in a game."
+    },
+    { name: "dim_donate_to_pot", description: "Add to the pot in a lobby." },
+    { name: "dim_get_game", description: "Get game summary by ID." },
+    {
+      name: "dim_challenge_user",
+      description: "Challenge another user to a game."
+    },
+    { name: "dim_accept_challenge", description: "Accept a game challenge." },
+    {
+      name: "dim_get_referral_summary",
+      description: "Get your referral stats and rewards."
+    },
+    { name: "dim_get_referral_tree", description: "Get your referral tree." },
+    {
+      name: "dim_get_referral_rewards",
+      description: "Get claimable referral rewards."
+    },
+    {
+      name: "dim_claim_referral_rewards",
+      description: "Claim referral rewards to your wallet."
+    },
+    {
+      name: "dim_apply_referral_code",
+      description: "Apply a referral code for 10% fee discount."
+    },
+    {
+      name: "dim_create_support_ticket",
+      description: "Create a support ticket."
+    },
+    { name: "dim_get_my_tickets", description: "List your support tickets." },
+    { name: "dim_get_ticket", description: "Get a ticket by ID." },
+    {
+      name: "dim_add_ticket_message",
+      description: "Add a message to a ticket."
+    },
+    { name: "dim_close_ticket", description: "Close a support ticket." },
+    {
+      name: "dim_get_market",
+      description: "Get prediction market for a game."
+    },
+    { name: "dim_buy_shares", description: "Buy prediction market shares." },
+    { name: "dim_sell_shares", description: "Sell prediction market shares." },
+    { name: "dim_get_positions", description: "Get your market positions." },
+    {
+      name: "dim_redeem_shares",
+      description: "Redeem shares after market resolution."
+    },
+    { name: "dim_get_market_analytics", description: "Get market analytics." }
+  ];
+  api.registerTool({
+    name: "dim_list_instructions",
+    description: "List all available DIM tools (instructions) with short descriptions. Use this to discover what you can do after dim_login.",
+    parameters: { type: "object", properties: {}, additionalProperties: false },
+    async execute() {
+      return textResult(
+        JSON.stringify(
+          {
+            instructions: DIM_INSTRUCTIONS,
+            hint: "Call dim_login first if you have not authenticated. Then use any tool above by name."
+          },
+          null,
+          2
+        )
+      );
+    }
+  });
   api.registerTool({
     name: "dim_get_balance",
-    description: "Get the wallet balance for the authenticated user. Returns SOL and USDC amounts. USDC amounts are in minor units (1 USDC = 1,000,000 minor units).",
+    description: "Get the wallet balance for the authenticated user. Returns SOL and USDC (usdc in minor units; usdcFormatted is always present, e.g. $0.00 or $1.50, so you do not need to convert).",
     parameters: { type: "object", properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
@@ -57539,13 +57708,11 @@ function register(api) {
       try {
         const balance = await c.sdk.wallet.getBalances();
         const usdcDollars = balance.usdc / 1e6;
-        return textResult(
-          JSON.stringify(
-            { ...balance, usdcFormatted: `$${usdcDollars.toFixed(2)}` },
-            null,
-            2
-          )
-        );
+        const payload = {
+          ...balance,
+          usdcFormatted: `$${usdcDollars.toFixed(2)}`
+        };
+        return textResult(JSON.stringify(payload, null, 2));
       } catch (err) {
         return textResult(
           `Failed to get balance: ${err instanceof Error ? err.message : String(err)}`,

package/index.ts

@@ -149,28 +149,38 @@ export default function register(api: {
   api.registerTool({
     name: 'dim_login',
     description:
-      'Authenticate with DIM using the configured wallet. Must be called before using any other tools. Returns user profile info.',
+      'Authenticate with DIM using the configured wallet. After login: set a username with dim_set_username, check balance with dim_get_balance, list games with dim_list_games, or apply a referral code with dim_apply_referral_code for a 10% fee discount.',
     parameters: { type: 'object', properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
       if ('error' in c) return c.error;
       try {
         const result = await c.authenticate();
-        const response: Record<string, unknown> = {
-          success: true,
-          userId: result.userId,
-          username: result.username,
-          walletAddress: c.walletAddress,
-        };
+        const nextSteps: string[] = [];
+        if (result.username == null || result.username === '') {
+          nextSteps.push(
+            'No username set — call dim_set_username to claim one',
+          );
+        }
+        nextSteps.push('Check your balance with dim_get_balance');
+        nextSteps.push('Explore available games with dim_list_games');
         try {
           const summary = await c.sdk.referrals.getSummary();
           if (!summary.hasReferrer) {
-            response.referralHint =
-              'You have no referrer yet. Use dim_apply_referral_code to apply one and get a 10% fee discount.';
+            nextSteps.push(
+              'No referrer yet — call dim_apply_referral_code for 10% fee discount',
+            );
           }
         } catch {
           /* non-critical */
         }
+        const response: Record<string, unknown> = {
+          success: true,
+          userId: result.userId,
+          username: result.username ?? null,
+          walletAddress: c.walletAddress,
+          nextSteps,
+        };
         return textResult(JSON.stringify(response, null, 2));
       } catch (err) {
         return textResult(
@@ -242,11 +252,176 @@ export default function register(api: {
     },
   });
 
+  // --- Instructions (discovery) ---
+  const DIM_INSTRUCTIONS = [
+    {
+      name: 'dim_login',
+      description:
+        'Authenticate with DIM. Call first; then set username, check balance, list games, or apply referral code.',
+    },
+    {
+      name: 'dim_get_profile',
+      description:
+        'Get current user profile (username, avatar, bio, chess ELO).',
+    },
+    {
+      name: 'dim_set_username',
+      description: 'Set or update your username (alphanumeric, 3–20 chars).',
+    },
+    {
+      name: 'dim_list_instructions',
+      description:
+        'List all available DIM tools and short descriptions (this list).',
+    },
+    {
+      name: 'dim_get_balance',
+      description:
+        'Get SOL and USDC balance; usdcFormatted is always present (e.g. $0.00).',
+    },
+    {
+      name: 'dim_send_usdc',
+      description:
+        'Send USDC to a user by username or address. 1¢ fee; amount in dollars.',
+    },
+    {
+      name: 'dim_tip_user',
+      description: 'Tip a user with USDC; broadcast to global chat. 1¢ fee.',
+    },
+    {
+      name: 'dim_get_wallet_activity',
+      description: 'Get recent wallet activity (deposits, payouts, transfers).',
+    },
+    { name: 'dim_search_users', description: 'Search users by username.' },
+    {
+      name: 'dim_send_friend_request',
+      description: 'Send friend request by user ID.',
+    },
+    {
+      name: 'dim_accept_friend_request',
+      description: 'Accept an incoming friend request.',
+    },
+    {
+      name: 'dim_list_friends',
+      description: 'List your friends with pagination.',
+    },
+    {
+      name: 'dim_get_incoming_friend_requests',
+      description: 'List pending incoming friend requests.',
+    },
+    {
+      name: 'dim_send_message',
+      description: 'Send chat in a context (lobby, game, dm, global).',
+    },
+    {
+      name: 'dim_get_chat_history',
+      description: 'Get chat history for a context.',
+    },
+    {
+      name: 'dim_send_dm',
+      description: 'Send a direct message to a user by ID.',
+    },
+    {
+      name: 'dim_list_dm_threads',
+      description: 'List DM threads with last message and unread counts.',
+    },
+    {
+      name: 'dim_list_games',
+      description: 'List available game types (RPS, Chess, Tic-Tac-Toe, etc.).',
+    },
+    {
+      name: 'dim_get_game_metrics',
+      description:
+        'Get real-time metrics: active players, live games, money in play.',
+    },
+    {
+      name: 'dim_create_lobby',
+      description: 'Create a game lobby; bet in USDC minor units.',
+    },
+    {
+      name: 'dim_join_queue',
+      description: 'Join matchmaking queue for a game type.',
+    },
+    { name: 'dim_get_lobby', description: 'Get lobby details by ID.' },
+    {
+      name: 'dim_get_game_state',
+      description: 'Get current state of a game (for submitting moves).',
+    },
+    {
+      name: 'dim_submit_action',
+      description: 'Submit a move/action in a game.',
+    },
+    { name: 'dim_donate_to_pot', description: 'Add to the pot in a lobby.' },
+    { name: 'dim_get_game', description: 'Get game summary by ID.' },
+    {
+      name: 'dim_challenge_user',
+      description: 'Challenge another user to a game.',
+    },
+    { name: 'dim_accept_challenge', description: 'Accept a game challenge.' },
+    {
+      name: 'dim_get_referral_summary',
+      description: 'Get your referral stats and rewards.',
+    },
+    { name: 'dim_get_referral_tree', description: 'Get your referral tree.' },
+    {
+      name: 'dim_get_referral_rewards',
+      description: 'Get claimable referral rewards.',
+    },
+    {
+      name: 'dim_claim_referral_rewards',
+      description: 'Claim referral rewards to your wallet.',
+    },
+    {
+      name: 'dim_apply_referral_code',
+      description: 'Apply a referral code for 10% fee discount.',
+    },
+    {
+      name: 'dim_create_support_ticket',
+      description: 'Create a support ticket.',
+    },
+    { name: 'dim_get_my_tickets', description: 'List your support tickets.' },
+    { name: 'dim_get_ticket', description: 'Get a ticket by ID.' },
+    {
+      name: 'dim_add_ticket_message',
+      description: 'Add a message to a ticket.',
+    },
+    { name: 'dim_close_ticket', description: 'Close a support ticket.' },
+    {
+      name: 'dim_get_market',
+      description: 'Get prediction market for a game.',
+    },
+    { name: 'dim_buy_shares', description: 'Buy prediction market shares.' },
+    { name: 'dim_sell_shares', description: 'Sell prediction market shares.' },
+    { name: 'dim_get_positions', description: 'Get your market positions.' },
+    {
+      name: 'dim_redeem_shares',
+      description: 'Redeem shares after market resolution.',
+    },
+    { name: 'dim_get_market_analytics', description: 'Get market analytics.' },
+  ];
+  api.registerTool({
+    name: 'dim_list_instructions',
+    description:
+      'List all available DIM tools (instructions) with short descriptions. Use this to discover what you can do after dim_login.',
+    parameters: { type: 'object', properties: {}, additionalProperties: false },
+    async execute() {
+      return textResult(
+        JSON.stringify(
+          {
+            instructions: DIM_INSTRUCTIONS,
+            hint: 'Call dim_login first if you have not authenticated. Then use any tool above by name.',
+          },
+          null,
+          2,
+        ),
+      );
+    },
+  });
+
   // --- Wallet ---
   api.registerTool({
     name: 'dim_get_balance',
     description:
-      'Get the wallet balance for the authenticated user. Returns SOL and USDC amounts. USDC amounts are in minor units (1 USDC = 1,000,000 minor units).',
+      'Get the wallet balance for the authenticated user. Returns SOL and USDC (usdc in minor units; usdcFormatted is always present, e.g. $0.00 or $1.50, so you do not need to convert).',
     parameters: { type: 'object', properties: {}, additionalProperties: false },
     async execute() {
       const c = await requireClient();
@@ -254,13 +429,11 @@ export default function register(api: {
       try {
         const balance = await c.sdk.wallet.getBalances();
         const usdcDollars = balance.usdc / 1_000_000;
-        return textResult(
-          JSON.stringify(
-            { ...balance, usdcFormatted: `$${usdcDollars.toFixed(2)}` },
-            null,
-            2,
-          ),
-        );
+        const payload = {
+          ...balance,
+          usdcFormatted: `$${usdcDollars.toFixed(2)}`,
+        };
+        return textResult(JSON.stringify(payload, null, 2));
       } catch (err) {
         return textResult(
           `Failed to get balance: ${err instanceof Error ? err.message : String(err)}`,

package/openclaw.plugin.json

@@ -30,5 +30,6 @@
       "label": "API URL",
       "placeholder": "https://api.dim.cool"
     }
-  }
+  },
+  "setupHint": "After install, add your Solana wallet private key to plugins.entries.dimclaw.config.walletPrivateKey, then call dim_login to get started."
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/dimclaw",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "OpenClaw plugin for DIM — play games, chat, send USDC, and earn on DIM using the SDK directly (no MCP subprocess).",
   "type": "module",
   "openclaw": {