Quickstart

import { fromPrivateKey } from "@zkstash/sdk/rest";
 
// Initialize client with your wallet
const client = await fromPrivateKey(
  process.env.PRIVATE_KEY,    // Your wallet private key
  {
    // Optional configuration
    payment: {
      maxValue: 5000n // Max payment per request
    }
  }
);

import { z } from "zod";
 
// Define schema using Zod
const UserProfileSchema = z.object({
  name: z.string(),
  theme: z.enum(["light", "dark"]),
  language: z.string()
});
 
// Register the schema
await client.registerSchema(
  "UserProfile",
  UserProfileSchema,
  {
    description: "User preferences and settings",
    cardinality: "single" // Only one profile per user
  }
);

// Store a memory (auto-extracts based on your schemas)
await client.createMemory({
  agentId: "my-agent",
  conversation: [
    { role: "user", content: "My name is Alex and I prefer dark mode." },
    { role: "assistant", content: "Got it! I'll remember that." }
  ]
});
 
// Search memories semantically
const results = await client.searchMemories({
  query: "What is the user's preferred theme?",
  filters: {
    agentId: "my-agent"
  }
});
 
console.log(results.memories[0]); // Returns matching memory

import * as MCP from "@zkstash/sdk/mcp";
 
const mcpClient = await MCP.fromPrivateKey(
  process.env.PRIVATE_KEY,
  {
    agentId: "my-agent",
    mcpUrl: "https://zkstash.ai/mcp"
  }
);
 
// Get tools for LangChain or other frameworks
const tools = await mcpClient.getTools();

import { ChatAnthropic } from "@langchain/anthropic";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
 
const agent = createReactAgent({
  llm: new ChatAnthropic({ model: "claude-3-5-sonnet-20241022" }),
  tools: await mcpClient.getTools()
});
 
const result = await agent.invoke({
  messages: [{ role: "user", content: "My name is Alex and I prefer dark mode." }]
});