@t2000/engine 0.31.1 → 0.31.3

package/dist/index.d.ts

@@ -833,10 +833,12 @@ declare const healthCheckTool: Tool<{}, {
 declare const ratesInfoTool: Tool<{}, _t2000_sdk.RatesResult>;
 
 declare const transactionHistoryTool: Tool<{
+    date?: string | undefined;
     limit?: number | undefined;
 }, {
     transactions: _t2000_sdk.TransactionRecord[];
     count: number;
+    date: string | null;
 }>;
 
 declare const saveDepositTool: Tool<{
@@ -1097,7 +1099,7 @@ interface SpendingResponse {
     byService: unknown[];
 }
 declare const spendingAnalyticsTool: Tool<{
-    period?: "all" | "week" | "month" | "year" | undefined;
+    period?: "month" | "year" | "all" | "week" | undefined;
 }, SpendingResponse>;
 
 interface YieldSummary {
@@ -1126,7 +1128,7 @@ interface ActivitySummary {
     yieldEarnedUsd: number;
 }
 declare const activitySummaryTool: Tool<{
-    period?: "all" | "week" | "month" | "year" | undefined;
+    period?: "month" | "year" | "all" | "week" | undefined;
 }, ActivitySummary>;
 
 declare const defillamaYieldPoolsTool: Tool<{

package/dist/index.js

@@ -992,7 +992,7 @@ function parseRpcTx(tx, address) {
     gasCost
   };
 }
-async function queryHistoryRpc(rpcUrl, address, limit) {
+async function queryHistoryPage(rpcUrl, address, limit, cursor) {
   const res = await fetch(rpcUrl, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -1002,7 +1002,7 @@ async function queryHistoryRpc(rpcUrl, address, limit) {
       method: "suix_queryTransactionBlocks",
       params: [
         { filter: { FromAddress: address }, options: { showEffects: true, showInput: true, showBalanceChanges: true } },
-        null,
+        cursor,
         limit,
         true
       ]
@@ -1012,13 +1012,48 @@ async function queryHistoryRpc(rpcUrl, address, limit) {
   if (!res.ok) throw new Error(`Sui RPC error: ${res.status}`);
   const json = await res.json();
   if (json.error) throw new Error(`RPC error: ${json.error.message}`);
-  return (json.result?.data ?? []).map((tx) => parseRpcTx(tx, address));
+  return {
+    data: json.result?.data ?? [],
+    nextCursor: json.result?.nextCursor ?? null,
+    hasNextPage: json.result?.hasNextPage ?? false
+  };
+}
+async function queryHistoryRpc(rpcUrl, address, limit) {
+  const page = await queryHistoryPage(rpcUrl, address, limit, null);
+  return page.data.map((tx) => parseRpcTx(tx, address));
+}
+async function queryHistoryByDate(rpcUrl, address, targetDate, limit) {
+  const target = new Date(targetDate);
+  const dayStart = new Date(target.getFullYear(), target.getMonth(), target.getDate()).getTime();
+  const dayEnd = dayStart + 864e5;
+  const MAX_PAGES = 20;
+  const PAGE_SIZE = 50;
+  const results = [];
+  let cursor = null;
+  for (let page = 0; page < MAX_PAGES; page++) {
+    const res = await queryHistoryPage(rpcUrl, address, PAGE_SIZE, cursor);
+    if (res.data.length === 0) break;
+    for (const tx of res.data) {
+      const ts = Number(tx.timestampMs ?? 0);
+      if (ts === 0) continue;
+      if (ts < dayStart) {
+        return results.slice(0, limit);
+      }
+      if (ts >= dayStart && ts < dayEnd) {
+        results.push(parseRpcTx(tx, address));
+      }
+    }
+    if (!res.hasNextPage || !res.nextCursor) break;
+    cursor = res.nextCursor;
+  }
+  return results.slice(0, limit);
 }
 var transactionHistoryTool = buildTool({
   name: "transaction_history",
-  description: "Retrieve recent transaction history: past sends, saves, withdrawals, borrows, repayments, and rewards claims. Optionally limit the number of results.",
+  description: "Retrieve transaction history: past sends, saves, withdrawals, borrows, repayments, and rewards claims. Pass a date (YYYY-MM-DD) to find transactions from a specific day, or omit for the most recent.",
   inputSchema: z.object({
-    limit: z.number().int().min(1).max(50).optional()
+    limit: z.number().int().min(1).max(50).optional(),
+    date: z.string().optional().describe("Specific date to search for transactions (YYYY-MM-DD format). Paginates back to find that day.")
   }),
   jsonSchema: {
     type: "object",
@@ -1026,6 +1061,10 @@ var transactionHistoryTool = buildTool({
       limit: {
         type: "number",
         description: "Maximum number of transactions to return (1-50, default 10)"
+      },
+      date: {
+        type: "string",
+        description: "Specific date to search for transactions (YYYY-MM-DD format). Paginates back to find that day."
       }
     }
   },
@@ -1036,16 +1075,24 @@ var transactionHistoryTool = buildTool({
       const agent = requireAgent(context);
       const records2 = await agent.history({ limit });
       return {
-        data: { transactions: records2, count: records2.length },
+        data: { transactions: records2, count: records2.length, date: input.date ?? null },
         displayText: `${records2.length} recent transaction(s)`
       };
     }
     if (!context.walletAddress || !context.suiRpcUrl) {
       throw new Error("Transaction history requires a wallet address");
     }
+    if (input.date) {
+      const records2 = await queryHistoryByDate(context.suiRpcUrl, context.walletAddress, input.date, limit);
+      const dateLabel = new Date(input.date).toLocaleDateString("en-US", { month: "long", day: "numeric", year: "numeric" });
+      return {
+        data: { transactions: records2, count: records2.length, date: input.date },
+        displayText: records2.length > 0 ? `${records2.length} transaction(s) on ${dateLabel}` : `No transactions found on ${dateLabel}`
+      };
+    }
     const records = await queryHistoryRpc(context.suiRpcUrl, context.walletAddress, limit);
     return {
-      data: { transactions: records, count: records.length },
+      data: { transactions: records, count: records.length, date: null },
       displayText: `${records.length} recent transaction(s)`
     };
   }