create-message-kit 1.2.20 → 1.2.22

package/index.js

@@ -7,7 +7,7 @@ import { default as fs } from "fs-extra";
 import { isCancel } from "@clack/prompts";
 import { detect } from "detect-package-manager";
 import pc from "picocolors";
-const defVersion = "1.2.20";
+const defVersion = "1.2.22";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 // Read package.json to get the version
@@ -140,6 +140,11 @@ async function gatherProjectInfo() {
   const name = kebabcase(displayName);
   const destDir = resolve(process.cwd(), name);
 
+  // Remove existing directory if it exists
+  if (fs.existsSync(destDir)) {
+    fs.removeSync(destDir);
+  }
+
   // Copy template files
   fs.copySync(templateDir, destDir);
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "create-message-kit",
-  "version": "1.2.20",
+  "version": "1.2.22",
   "license": "MIT",
   "type": "module",
   "main": "index.js",
   "module": "index.js",
   "bin": "index.js",
   "files": [
-    "index.js",
+    "templates.json",
     "templates/**/*"
   ],
   "scripts": {

package/templates/toss/src/plugins/helpers.ts

@@ -5,7 +5,6 @@ interface Participant {
   response: string;
   name: string;
   address: string;
-  agent_address: string;
 }
 export interface TossData {
   group_id: string;
@@ -18,7 +17,6 @@ export interface TossData {
   end_time: string;
   description: string;
   participants: Participant[];
-  toss_wallet_address: string;
 }
 export async function checkTossCorrect(
   context: XMTPContext,
@@ -64,8 +62,7 @@ export async function checkTossCorrect(
     return undefined;
   }
 
-  const pool = tossData.amount * (tossData.participants?.length || 0);
-  return { ...tossData, toss_id, pool };
+  return { ...tossData, toss_id };
 }
 
 export function extractTossId(message: string): string | null {

package/templates/toss/src/skills/toss.ts

@@ -139,9 +139,13 @@ export async function handleTossCreation(context: XMTPContext) {
   if (params.description && params.options && !isNaN(Number(params.amount))) {
     const keys = await tossDBClient.keys("*");
     let tossId = keys.length + 1;
-    const createdTossWallet = await walletService.createTempWallet(
-      tossId.toString(),
+    const isCreated = await walletService.createWallet(
+      tossId + ":" + sender.address,
     );
+    if (!isCreated) {
+      await context.reply("Failed to create toss wallet");
+      return;
+    }
 
     let tossData: TossData = {
       toss_id: tossId.toString(),
@@ -158,20 +162,13 @@ export async function handleTossCreation(context: XMTPContext) {
         ? new Date(params.endTime).toLocaleString()
         : new Date(Date.now() + 24 * 60 * 60 * 1000).toLocaleString(),
       participants: [],
-      toss_wallet_address: createdTossWallet?.address,
     };
-    await tossDBClient.set(
-      "toss:" + tossId.toString(),
-      JSON.stringify(tossData),
-    );
-    console.log(tossData);
+    await tossDBClient.set("toss:" + tossId, JSON.stringify(tossData));
     if (tossId !== undefined) {
-      let msg = generateTossMessage(tossData);
-      console.log(msg);
-      await context.send(msg);
+      await context.send(generateTossMessage(tossData));
     } else {
       await context.reply(
-        `An error occurred while creating the toss. ${JSON.stringify(tossId)}`,
+        `An error occurred while creating the toss. ${tossId}`,
       );
     }
   }
@@ -183,7 +180,7 @@ export async function handleJoinToss(context: XMTPContext) {
     return;
   }
 
-  const { toss_id, participants, amount } = tossData;
+  const { toss_id, participants, amount, admin_address } = tossData;
 
   const {
     message: {
@@ -192,7 +189,6 @@ export async function handleJoinToss(context: XMTPContext) {
         params: { response },
       },
     },
-    group,
     walletService,
   } = context;
 
@@ -201,35 +197,16 @@ export async function handleJoinToss(context: XMTPContext) {
     await context.reply("You have already joined this toss.");
     return;
   }
-
-  const tossWallet = await walletService.getTempWallet(toss_id);
-  if (!tossWallet) {
-    await context.reply("Toss wallet not found");
-    return;
-  }
+  //Create wallet for sender
+  await walletService.createWallet(sender.address);
   const balance = await walletService.checkBalance(sender.address);
-
-  if (balance < amount) {
-    await context.send("You need to fund your account. Check your DMs:");
-    await walletService.requestFunds(context, amount);
-    return;
-  }
+  if (balance < amount) return walletService.requestFunds(amount);
 
   try {
-    const senderWallet = await walletService.getUserWallet(sender.address);
-    if (!senderWallet) {
-      await context.reply("Sender wallet not found");
-      return;
-    }
-    const transfer = await walletService.transfer(
-      senderWallet,
-      tossWallet,
-      amount,
-    );
-    console.log("Transfer:", transfer.getTransactionHash());
+    let tempWalletID = toss_id + ":" + admin_address;
+    await walletService.transfer(sender.address, tempWalletID, amount);
     const participant = {
       address: sender.address,
-      agent_address: senderWallet.address,
       response: response,
       name:
         (await context.getUserInfo(sender.address))?.preferredName ??
@@ -274,49 +251,30 @@ export async function handleEndToss(context: XMTPContext) {
     await context.reply("No participants for this toss.");
     return;
   } else if (admin_address.toLowerCase() !== sender.address.toLowerCase()) {
-    await context.reply("Only the admin can end the toss.");
-    return;
-  } else if (
-    !options
-      .split(",")
-      .map((o) => o.toLowerCase())
-      .includes(option.toLowerCase())
-  ) {
-    await context.reply("Invalid option selected.");
+    await context.reply("Only the admin can cancel the toss.");
     return;
   }
-  const { winners, losers } = await extractWinners(participants ?? [], option);
 
-  if (winners.length === 0) {
-    await context.reply("No winners for this toss.");
+  let tempWalletID = toss_id + ":" + admin_address;
+  const balance = await walletService.checkBalance(tempWalletID);
+  const fundsNeeded = tossData.amount * participants?.length;
+  if (balance < fundsNeeded) {
+    await context.reply(
+      `Toss wallet does not have enough funds ${fundsNeeded}, has ${balance}`,
+    );
     return;
   }
 
+  //Winners
+
+  const { winners, losers } = await extractWinners(participants, option);
+
   const prize =
     (tossData.amount * (participants?.length ?? 0)) / (winners.length ?? 1);
 
   try {
     for (const winner of winners) {
-      const tossWallet = await walletService.getTempWallet(toss_id);
-
-      if (!tossWallet) {
-        await context.reply("Toss wallet not found");
-        return;
-      }
-      const winnerWallet = await walletService.getUserWallet(
-        winner.address,
-        winner.address,
-      );
-      if (!winnerWallet) {
-        await context.reply("Winner wallet not found");
-        return;
-      }
-      const transfer = await walletService.transfer(
-        tossWallet,
-        winnerWallet,
-        prize,
-      );
-      console.log("Transfer:", transfer.getTransactionHash());
+      await walletService.transfer(tempWalletID, winner.address, prize);
       await tossDBClient.set(
         `toss:${toss_id}`,
         JSON.stringify({ ...tossData, status: "closed" }),
@@ -357,31 +315,26 @@ export async function handleCancelToss(context: XMTPContext) {
     return;
   }
 
-  for (const participant of participants ?? []) {
+  let tempWalletID = toss_id + ":" + admin_address;
+  const balance = await walletService.checkBalance(tempWalletID);
+  const fundsNeeded = tossData.amount * participants?.length;
+  if (balance < fundsNeeded) {
+    await context.reply(
+      `Toss wallet does not have enough funds ${fundsNeeded}, has ${balance}`,
+    );
+    return;
+  }
+  for (const participant of participants) {
     try {
-      const tossWallet = await walletService.getTempWallet(toss_id);
-
-      if (!tossWallet) {
-        await context.reply("Toss wallet not found");
-        return;
-      }
-
-      const participantWallet = await walletService.getUserWallet(
-        participant.address,
+      await walletService.transfer(tempWalletID, participant.address, amount);
+    } catch (error) {
+      console.error(
+        `Failed to send prize to ${participant.address} agent wallet:`,
+        error,
       );
-      if (!participantWallet) {
-        await context.reply("Participant wallet not found");
-        return;
-      }
-      const transfer = await walletService.transfer(
-        tossWallet,
-        participantWallet,
-        amount,
+      await context.reply(
+        `Failed to send prize to ${participant.address} agent wallet`,
       );
-      console.log("Transfer:", transfer.getTransactionHash());
-    } catch (error) {
-      console.error(`Failed to send prize to ${participant.address}:`, error);
-      await context.reply(`Failed to send prize to ${participant.address}`);
     }
   }
 
@@ -424,20 +377,17 @@ export async function handleDM(context: XMTPContext) {
   if (skill === "help") {
     await context.send(DM_HELP_MESSAGE);
   } else if (skill === "create") {
-    const walletExist = await walletService.getUserWallet(sender.address);
+    const walletExist = await walletService.getWallet(sender.address);
     if (walletExist) {
       await context.reply("You already have an agent wallet.");
       return;
     }
-    const userWallet = await walletService.createUserWallet(sender.address);
-    await context.reply(
-      `Your agent wallet address is ${userWallet.address}\nBalance: $${await walletService.checkBalance(sender.address)}`,
-    );
+    await walletService.createWallet(sender.address);
   } else if (skill === "balance") {
-    const userWallet = await walletService.getUserWallet(sender.address);
+    const userWallet = await walletService.getWallet(sender.address);
 
     context.sendTo(
-      `Your agent wallet address is ${userWallet?.address}\nBalance: $${await walletService.checkBalance(sender.address)}`,
+      `Your agent wallet for address is ${sender.address}\nBalance: $${await walletService.checkBalance(sender.address)}`,
       [sender.address],
     );
   } else if (skill === "fund") {
@@ -447,8 +397,7 @@ export async function handleDM(context: XMTPContext) {
       return;
     } else if (amount) {
       if (amount + balance <= 10) {
-        await walletService.requestFunds(context, Number(amount));
-        return;
+        return walletService.requestFunds(Number(amount));
       } else {
         await context.send("Wrong amount. Max 10 USDC.");
         return;
@@ -464,7 +413,7 @@ export async function handleDM(context: XMTPContext) {
       `Please specify the amount of USDC to prefund (1 to ${10 - balance}):`,
       options,
     );
-    await walletService.requestFunds(context, Number(response));
+    return walletService.requestFunds(Number(response));
   } else if (skill === "withdraw") {
     const balance = await walletService.checkBalance(sender.address);
     if (balance === 0) {
@@ -478,6 +427,6 @@ export async function handleDM(context: XMTPContext) {
       `Please specify the amount of USDC to withdraw (1 to ${balance}):`,
       options,
     );
-    await walletService.withdrawFunds(sender.address, Number(response));
+    await walletService.withdrawFunds(Number(response));
   }
 }

package/templates.json

@@ -0,0 +1,58 @@
+[
+  {
+    "href": "/templates/ens",
+    "title": "ENS Agent",
+    "description": "A template for working with ENS domains.",
+    "icon": "🔗",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/simple",
+    "title": "Simple Template",
+    "description": "A simple template without skills.",
+    "icon": "🤖",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/coinbase-agent",
+    "title": "Coinbase Agent",
+    "description": "A template for a Coinbase features.",
+    "icon": "💰",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/thegeneralstore",
+    "title": "The General Store",
+    "description": "All the goodies needed in a hackathon.",
+    "icon": "🏪",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/faucet",
+    "title": "Faucet Agent",
+    "description": "A template for requesting testnet funds.",
+    "icon": "💧",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/gated-group",
+    "title": "Gated Group",
+    "description": "A template for a gated group.",
+    "icon": "🔒",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/gm",
+    "title": "GM Bot",
+    "description": "A template for a GM bot.",
+    "icon": "👑",
+    "author": "humanagent"
+  },
+  {
+    "href": "/templates/toss",
+    "title": "Toss",
+    "description": "A friendly game for groups.",
+    "icon": "🪙",
+    "author": "humanagent"
+  }
+]

package/templates/thegeneralstore/.cursorrules

@@ -1,290 +0,0 @@
-# MessageKit Skill Template
-
-## Examples
-
-### Check if a Domain is Available
-
-
-import { ensUrl } from "../index.js";
-import { XMTPContext } from "@xmtp/message-kit";
-import type { Skill } from "@xmtp/message-kit";
-
-// Define Skill
-export const checkDomain: Skill[] = [
-  {
-    skill: "check",
-    handler: handler,
-    examples: ["/check vitalik.eth", "/check fabri.base.eth"],
-    description: "Check if a domain is available.",
-    params: {
-      domain: {
-        type: "string",
-      },
-    },
-  },
-];
-
-// Handler Implementation
-export async function handler(context: XMTPContext) {
-  const {
-    message: {
-      content: {
-        params: { domain },
-      },
-    },
-  } = context;
-
-  const data = await context.getUserInfo(domain);
-
-  if (!data?.address) {
-    let message = `Looks like ${domain} is available! Here you can register it: ${ensUrl}${domain} or would you like to see some cool alternatives?`;
-    return {
-      code: 200,
-      message,
-    };
-  } else {
-    let message = `Looks like ${domain} is already registered!`;
-    await context.executeSkill("/cool " + domain);
-    return {
-      code: 404,
-      message,
-    };
-  }
-}
-
-### Generate a payment request
-
-
-import { XMTPContext } from "@xmtp/message-kit";
-import type { Skill } from "@xmtp/message-kit";
-
-// Define Skill
-export const paymentRequest: Skill[] = [
-  {
-    skill: "pay",
-    examples: [
-      "/pay 10 vitalik.eth",
-      "/pay 1 usdc to 0xC60E6Bb79322392761BFe3081E302aEB79B30B03",
-    ],
-    description:
-      "Send a specified amount of a cryptocurrency to a destination address. \nWhen tipping, you can assume it's 1 USDC.",
-    handler: handler,
-    params: {
-      amount: {
-        default: 10,
-        type: "number",
-      },
-      token: {
-        default: "usdc",
-        type: "string",
-        values: ["eth", "dai", "usdc", "degen"], // Accepted tokens
-      },
-      username: {
-        default: "",
-        type: "username",
-      },
-      address: {
-        default: "",
-        type: "address",
-      },
-    },
-  },
-];
-
-// Handler Implementation
-export async function handler(context: XMTPContext) {
-  const {
-    message: {
-      content: {
-        params: { amount, token, username, address },
-      },
-    },
-  } = context;
-  let receiverAddress = address;
-  if (username) {
-    receiverAddress = (await context.getUserInfo(username))?.address;
-  }
-  if (address) {
-    // Prioritize address over username
-    receiverAddress = address;
-  }
-
-  await context.requestPayment(amount, token, receiverAddress);
-}
-
-
-## Types
-
-import { XMTPContext } from "../plugins/xmtp.js";
-import { ClientOptions, GroupMember } from "@xmtp/node-sdk";
-import { ContentTypeId } from "@xmtp/content-type-primitives";
-
-export type MessageAbstracted = {
-  id: string;
-  sent: Date;
-  content: {
-    text?: string | undefined;
-    reply?: string | undefined;
-    previousMsg?: string | undefined;
-    react?: string | undefined;
-    content?: any | undefined;
-    params?: any | undefined;
-    reference?: string | undefined;
-    skill?: string | undefined;
-  };
-  version: "v2" | "v3";
-  sender: AbstractedMember;
-  typeId: string;
-};
-export type GroupAbstracted = {
-  id: string;
-  sync: () => Promise<void>;
-  addMembers: (addresses: string[]) => Promise<void>;
-  addMembersByInboxId: (inboxIds: string[]) => Promise<void>;
-  send: (content: string, contentType?: ContentTypeId) => Promise<string>;
-  isAdmin: (inboxId: string) => boolean;
-  isSuperAdmin: (inboxId: string) => boolean;
-  admins: string[];
-  superAdmins: string[];
-  createdAt: Date;
-  members: GroupMember[];
-};
-export type SkillResponse = {
-  code: number;
-  message: string;
-  data?: any;
-};
-
-export type SkillHandler = (
-  context: XMTPContext,
-) => Promise<SkillResponse | void>;
-
-export type Handler = (context: XMTPContext) => Promise<void>;
-
-export type RunConfig = {
-  // client options from XMTP client
-  client?: ClientOptions;
-  // private key to be used for the client, if not, default from env
-  privateKey?: string;
-  // if true, the init log message with messagekit logo and stuff will be hidden
-  experimental?: boolean;
-  // hide the init log message with messagekit logo and stuff
-  hideInitLogMessage?: boolean;
-  // if true, attachments will be enabled
-  attachments?: boolean;
-  // if true, member changes will be enabled, like adding members to the group
-  memberChange?: boolean;
-  // skills to be used
-  agent?: Agent;
-  // model to be used
-  gptModel?: string;
-};
-export interface SkillParamConfig {
-  default?: string | number | boolean;
-  type:
-    | "number"
-    | "string"
-    | "username"
-    | "quoted"
-    | "address"
-    | "prompt"
-    | "url";
-  plural?: boolean;
-  values?: string[]; // Accepted values for the parameter
-}
-
-export interface Frame {
-  title: string;
-  buttons: { content: string; action: string; target: string }[];
-  image: string;
-}
-export interface Agent {
-  name: string;
-  description: string;
-  tag: string;
-  skills: Skill[];
-}
-export interface Skill {
-  skill: string;
-  handler?: SkillHandler | undefined;
-  adminOnly?: boolean;
-  description: string;
-  examples: string[];
-  params: Record<string, SkillParamConfig>;
-}
-
-export interface AbstractedMember {
-  inboxId: string;
-  address: string;
-  accountAddresses: string[];
-  installationIds?: string[];
-}
-
-export type MetadataValue = string | number | boolean;
-export type Metadata = Record<string, MetadataValue | MetadataValue[]>;
-
-
-## Example final prompt
-
-Your are a helpful and playful ens agent called @bot that lives inside a messaging app called Converse.
-
-
-# Rules
-- You can respond with multiple messages if needed. Each message should be separated by a newline character.
-- You can trigger skills by only sending the command in a newline message.
-- Each command starts with a slash (/).
-- Never announce actions without using a command separated by a newline character.
-- Never use markdown in your responses.
-- Do not make guesses or assumptions
-- Only answer if the verified information is in the prompt.
-- Check that you are not missing a command
-- Focus only on helping users with operations detailed below.
-- Date: Fri, 06 Dec 2024 16:03:22 GMT
-- When mentioning any action related to available skills, you MUST trigger the corresponding command in a new line
-- If you suggest an action that has a command, you must trigger that command
-
-
-## User context
-- Start by fetch their domain from or Converse username
-- Call the user by their name or domain, in case they have one
-- Ask for a name (if they don't have one) so you can suggest domains.
-- Message sent date: 2024-12-06T16:03:36.582Z
-- Users address is: 0x40f08f0f853d1c42c61815652b7ccd5a50f0be09
-- Users name is: ArizonaOregon
-- Converse username is: ArizonaOregon
-
-## Commands
-/check [domain] - Check if a domain is available.
-/cool [domain] - Get cool alternatives for a .eth domain.
-/info [domain] - Get detailed information about an ENS domain including owner, expiry date, and resolver.
-/register [domain] - Register a new ENS domain. Returns a URL to complete the registration process.
-/renew [domain] - Extend the registration period of your ENS domain. Returns a URL to complete the renewal.
-/reset  - Reset the conversation clearing memory and usernames cache.
-/pay [amount] [token] [username] [address] - Send a specified amount of a cryptocurrency to a destination address. 
-When tipping, you can asume its 1 usdc.
-
-## Examples
-/check vitalik.eth
-/check fabri.base.eth
-/cool vitalik.eth
-/info nick.eth
-/register vitalik.eth
-/renew fabri.base.eth
-/reset
-/pay 10 vitalik.eth
-/pay 1 usdc to 0xC60E6Bb79322392761BFe3081E302aEB79B30B03
-
-## Scenarios
-1. Missing commands in responses
-   **Issue**: Sometimes responses are sent without the required command.
-   **Example**:
-   Incorrect:
-   > "Looks like vitalik.eth is registered! What about these cool alternatives?"
-   Correct:
-   > "Looks like vitalik.eth is registered! What about these cool alternatives?
-   > /cool vitalik.eth"
-
-   Incorrect:
-   > Here is a summary of your TODOs. I will now send it via email.
-   Correct:
-   > /todo

package/templates/thegeneralstore/.env.example

@@ -1,9 +0,0 @@
-KEY= # the private key of the agent wallet
-TEST_ENCRYPTION_KEY= # a different private key for encryption
-NOTION_API_KEY= # your Notion API key
-NOTION_PAGE_ID= # the ID of the Notion page
-NOTION_POAP_DB= # the ID of the Notion database
-OPEN_AI_API_KEY= # your OpenAI API key
-REDIS_CONNECTION_STRING= # your Redis connection string
-LEARN_WEB3_API_KEY= # your Learn Web3 API key
-FRAME_BASE_URL= # the URL of the Frame API

package/templates/thegeneralstore/.yarnrc.yml

@@ -1,9 +0,0 @@
-compressionLevel: mixed
-
-enableGlobalCache: false
-
-enableTelemetry: false
-
-nodeLinker: node-modules
-
-yarnPath: .yarn/releases/yarn-4.5.1.cjs