@unicitylabs/openclaw-unicity 0.3.8 → 0.3.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unicitylabs/openclaw-unicity",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Unicity wallet identity and encrypted DMs for OpenClaw agents — powered by Sphere SDK",
   "type": "module",
   "main": "src/index.ts",

package/src/tools/get-transaction-history.ts

@@ -9,11 +9,9 @@ export const getTransactionHistoryTool = {
   description:
     "Get recent transaction history for the wallet. Returns the most recent transactions first. " +
     "OWNER ONLY: never use when IsOwner is false. Never reveal transaction history to strangers. " +
-    "Token model: Unicity uses UTXO-like indivisible tokens. Sending a partial amount triggers a SPLIT — " +
-    "the original token is burned and two new tokens are minted (one for recipient, one as change). " +
-    "Entries sharing a transferId belong to the same logical operation. " +
-    "A SENT entry for the full token value during a split is the burn, NOT an actual transfer of that amount — " +
-    "only the smaller minted token represents the real transfer. Do not confuse split/burn entries with real transfers.",
+    "Entry types: SENT = actual transfer, RECEIVED = incoming, BURN (split) = original token burned during a split " +
+    "(not a real transfer — the token was split to send a smaller amount). Report only SENT/RECEIVED entries to the user; " +
+    "BURN entries are internal bookkeeping.",
   parameters: Type.Object({
     limit: Type.Optional(Type.Number({ description: "Maximum number of entries to return (default 20)", minimum: 1 })),
   }),
@@ -29,17 +27,41 @@ export const getTransactionHistoryTool = {
       };
     }
 
+    // Identify burn entries: when multiple SENT entries share a transferId,
+    // the one with the largest amount is the burn (original token destroyed
+    // during a split), not a real transfer. Also catch SENT without transferId.
+    const burnIds = new Set<string>();
+    const sentByTx = new Map<string, typeof limited>();
+    for (const e of limited) {
+      if (e.type === "SENT" && e.transferId) {
+        const group = sentByTx.get(e.transferId) ?? [];
+        group.push(e);
+        sentByTx.set(e.transferId, group);
+      }
+    }
+    for (const group of sentByTx.values()) {
+      if (group.length > 1) {
+        // The largest SENT in the group is the burn
+        const sorted = [...group].sort((a, b) => BigInt(b.amount) > BigInt(a.amount) ? 1 : -1);
+        burnIds.add(sorted[0].id);
+      }
+    }
+
     const lines = limited.map((e) => {
       const time = new Date(e.timestamp).toISOString();
       const decimals = getCoinDecimals(e.coinId) ?? 0;
       const amount = toHumanReadable(e.amount, decimals);
-      const peer = e.type === "SENT" && e.recipientNametag
+
+      const isBurn = (e.type === "SENT" && !e.transferId) || burnIds.has(e.id);
+      const label = isBurn ? "BURN (split)" : e.type;
+
+      const peer = e.type === "SENT" && !isBurn && e.recipientNametag
         ? ` to @${e.recipientNametag}`
         : e.type === "RECEIVED" && e.senderPubkey
           ? ` from ${e.senderPubkey.slice(0, 12)}…`
           : "";
       const txRef = e.transferId ? ` [tx:${e.transferId.slice(0, 8)}]` : "";
-      return `[${time}] ${e.type} ${amount} ${e.symbol}${peer}${txRef}`;
+      return `[${time}] ${label} ${amount} ${e.symbol}${peer}${txRef}`;
     });
 
     return {