DMind SDK

TypeScript SDK for the DMind AI platform — chat completions with built-in crypto trading tools.

Installation

npm install @dmindai/sdk

Quick Start

import {
  DMind,
  SEARCH_TOKEN,
  EXECUTE_SWAP,
  type SearchTokenInput,
  type ExecuteSwapInput,
} from "@dmindai/sdk";

// 1. Implement the two built-in tools with your own backend logic
//    params is fully typed — IDE will auto-complete all fields from SearchTokenInput / ExecuteSwapInput

const searchToken = SEARCH_TOKEN.implement(async (params: SearchTokenInput) => {
  const tokens = await myTokenService.search(params);
  return { tokens };
});

const executeSwap = EXECUTE_SWAP.implement(async (params: ExecuteSwapInput) => {
  const result = await myDexService.buildSwap(params);
  return { transaction: result.transaction, quote: result.quote };
});

// 2. Create the DMind client

const dmind = new DMind({
  baseUrl: "http://localhost:8000/v1", // vLLM local server
  apiKey: "your-api-key", // optional
});

// 3. Send a chat request with tool definitions

const response = await dmind.chat.send({
  messages: [{ role: "user", content: "Swap 1 SOL to USDC on Solana" }],
  model: "dmind-3-nano",
  tools: [searchToken.toDefinition(), executeSwap.toDefinition()],
  toolChoice: "auto",
});

// 4. Handle the tool call

const toolCall = response.choices[0].message.toolCalls?.[0];
if (toolCall) {
  const args = searchToken.parseInput(JSON.parse(toolCall.function.arguments));
  console.log("Tool called:", toolCall.function.name, args);
}

Built-in Tools

The SDK provides two fixed tools matching the DMind-3-nano model card. Their names, descriptions, and parameter schemas cannot be modified.

SEARCH_TOKEN

Search for a cryptocurrency token on-chain to retrieve its metadata or address.

Parameter	Type	Required	Description
symbol	string	No	Token ticker symbol (e.g. SOL, USDC)
address	string	No	Contract address of the token
chain	string	No	Target blockchain: solana, ethereum, bsc, base
keyword	string	No	Free-text search keywords

EXECUTE_SWAP

Propose a token swap transaction.

Parameter	Type	Required	Description
inputTokenSymbol	string	Yes	Symbol of the token being sold
inputTokenCA	string	No	Contract address of the input token
outputTokenCA	string	No	Contract address of the output token
inputTokenAmount	number	No	Absolute amount to swap
inputTokenPercentage	number	No	Percentage of balance to swap (0.0–1.0)
outputTokenAmount	number	No	Minimum output amount expected

Using Tools Without Execute Logic

The tools can also be used directly without implement() — for schema definitions and input parsing only:

import { SEARCH_TOKEN, EXECUTE_SWAP } from "@dmindai/sdk";

// Get the fixed JSON schema for the chat API
const tools = [SEARCH_TOKEN.toDefinition(), EXECUTE_SWAP.toDefinition()];

// Parse and validate raw tool call arguments
const args = SEARCH_TOKEN.parseInput({ symbol: "SOL", chain: "solana" });

Streaming

const stream = await dmind.chat.send({
  messages: [{ role: "user", content: "Find the USDC token on Ethereum" }],
  model: "dmind-3-nano",
  tools: [searchToken.toDefinition()],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0].delta.content ?? "");
}

Multi-turn Tool Loop

For automated multi-turn conversations with tool execution:

import { DMind, runLoop } from "@dmindai/sdk";

const dmind = new DMind({
  modelGenerate: async (messages) => {
    // call your model inference here
    return modelResponse;
  },
  tools: {
    SEARCH_TOKEN: async (args) => {
      return await myTokenService.search(args);
    },
    EXECUTE_SWAP: async (args) => {
      return await myDexService.buildSwap(args);
    },
  },
});

const result = await runLoop(dmind, [
  { role: "user", content: "Swap 0.5 SOL to USDC" },
]);

console.log(result.final); // final parsed result
console.log(result.toolHops); // number of tool calls executed

Developer Prompt Guard (DMind-3-nano)

For dmind-3-nano, the SDK enforces the official developer prompt from the model card:

• If no developer message is provided, the SDK injects the official one.
• If a developer message exists but does not match the official policy, the SDK replaces it.
• This guard is applied in both dmind.generate(...) and dmind.chat.send(...).
• For custom modelProfile without developerPromptPolicy, no prompt is injected.

This keeps tool-call behavior aligned with the model's expected protocol.