@unicitylabs/uniclaw 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unicitylabs/uniclaw",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Unicity wallet identity and encrypted DMs for OpenClaw agents — powered by Sphere SDK",
   "type": "module",
   "main": "src/index.ts",
@@ -43,7 +43,7 @@
   "dependencies": {
     "@clack/prompts": "^0.10.0",
     "@sinclair/typebox": "^0.34.48",
-    "@unicitylabs/sphere-sdk": "^0.1.4"
+    "@unicitylabs/sphere-sdk": "^0.1.9"
   },
   "peerDependencies": {
     "openclaw": "*"

package/src/assets.ts

@@ -18,13 +18,15 @@ interface AssetEntry {
 }
 
 interface AssetRegistry {
-  /** Map from lowercase name or symbol to faucet coin name */
+  /** Map from lowercase name, symbol, or coin id to coin name */
   aliases: Map<string, string>;
-  /** Map from faucet coin name to display symbol */
+  /** Map from coin name to symbol */
   symbols: Map<string, string>;
-  /** Map from faucet coin name to decimals */
+  /** Map from coin name to decimals */
   decimals: Map<string, number>;
-  /** List of all available symbols for display */
+  /** Map from coin name to coin id */
+  coinIds: Map<string, string>;
+  /** List of all available symbols */
   availableSymbols: string[];
 }
 
@@ -40,6 +42,7 @@ function loadRegistry(): AssetRegistry {
   const aliases = new Map<string, string>();
   const symbols = new Map<string, string>();
   const decimals = new Map<string, number>();
+  const coinIds = new Map<string, string>();
   const availableSymbols: string[] = [];
 
   for (const entry of entries) {
@@ -50,13 +53,14 @@ function loadRegistry(): AssetRegistry {
     const name = entry.name;
     const symbol = entry.symbol;
 
-    // Map name, symbol (lowercase), and coin id to the faucet coin name
+    // Map name, symbol (lowercase), and coin id to the coin name
     aliases.set(name.toLowerCase(), name);
     aliases.set(symbol.toLowerCase(), name);
     aliases.set(entry.id, name);
 
-    // Store display symbol and decimals
+    // Store symbol, decimals, and coin id
     symbols.set(name, symbol);
+    coinIds.set(name, entry.id);
     if (entry.decimals !== undefined) {
       decimals.set(name, entry.decimals);
     }
@@ -64,17 +68,17 @@ function loadRegistry(): AssetRegistry {
     availableSymbols.push(symbol);
   }
 
-  cachedRegistry = { aliases, symbols, decimals, availableSymbols };
+  cachedRegistry = { aliases, symbols, decimals, coinIds, availableSymbols };
   return cachedRegistry;
 }
 
-/** Resolve user input (name or symbol) to faucet coin name, or null if not found */
+/** Resolve user input (name or symbol) to coin name, or null if not found */
 export function resolveCoinId(input: string): string | null {
   const registry = loadRegistry();
   return registry.aliases.get(input.toLowerCase().trim()) ?? null;
 }
 
-/** Get display symbol for a coin (accepts name, symbol, or coin id) */
+/** Get symbol for a coin (accepts name, symbol, or coin id) */
 export function getCoinSymbol(coin: string): string {
   const registry = loadRegistry();
   const name = registry.aliases.get(coin) ?? registry.aliases.get(coin.toLowerCase()) ?? coin;
@@ -88,6 +92,13 @@ export function getCoinDecimals(coin: string): number | undefined {
   return name ? registry.decimals.get(name) : registry.decimals.get(coin);
 }
 
+/** Get coin id for a coin (accepts name, symbol, or coin id) */
+export function getCoinId(coin: string): string | undefined {
+  const registry = loadRegistry();
+  const name = registry.aliases.get(coin) ?? registry.aliases.get(coin.toLowerCase());
+  return name ? registry.coinIds.get(name) : registry.coinIds.get(coin);
+}
+
 /** Get list of all available symbols for display */
 export function getAvailableSymbols(): string[] {
   const registry = loadRegistry();
@@ -133,7 +144,7 @@ export function toHumanReadable(amount: string, decimals: number): string {
 /**
  * Format amount for display with symbol
  * @param amount Amount in smallest units
- * @param coinName Faucet coin name (e.g., "unicity")
+ * @param coinName Coin name (e.g., "unicity")
  */
 export function formatAmount(amount: string, coinName: string): string {
   const decimals = getCoinDecimals(coinName) ?? 0;
@@ -145,7 +156,7 @@ export function formatAmount(amount: string, coinName: string): string {
 /**
  * Parse user input amount to smallest units for a given coin
  * @param amount Human-readable amount (e.g., "100" or "1.5")
- * @param coinName Faucet coin name (e.g., "unicity")
+ * @param coinName Coin name (e.g., "unicity")
  */
 export function parseAmount(amount: number | string, coinName: string): string {
   const decimals = getCoinDecimals(coinName) ?? 0;

package/src/tools/request-payment.ts

@@ -2,7 +2,7 @@
 
 import { Type } from "@sinclair/typebox";
 import { getSphere } from "../sphere.js";
-import { resolveCoinId, getCoinSymbol, getCoinDecimals, toSmallestUnit } from "../assets.js";
+import { resolveCoinId, getCoinSymbol, getCoinDecimals, getCoinId, toSmallestUnit } from "../assets.js";
 import { validateRecipient } from "../validation.js";
 
 export const requestPaymentTool = {
@@ -10,7 +10,7 @@ export const requestPaymentTool = {
   description:
     "Send a payment request to another user, asking them to pay a specific amount.",
   parameters: Type.Object({
-    recipient: Type.String({ description: "Nametag (e.g. @alice) or 64-char hex public key of who should pay" }),
+    recipient: Type.String({ description: "Nametag (e.g. @alice), hex public key (64 or 66 chars), or PROXY:/DIRECT: address" }),
     amount: Type.Number({ description: "Amount to request (human-readable, e.g. 100 or 1.5)" }),
     coin: Type.String({ description: "Coin to request by name or symbol (e.g. UCT, BTC)" }),
     message: Type.Optional(Type.String({ description: "Optional message to include with the request" })),
@@ -31,16 +31,20 @@ export const requestPaymentTool = {
       throw new Error(`Unknown coin "${params.coin}".`);
     }
 
+    const sdkCoinId = getCoinId(coinId);
+    if (!sdkCoinId) {
+      throw new Error(`No coin ID found for "${params.coin}".`);
+    }
+
     const decimals = getCoinDecimals(coinId) ?? 0;
     const amountSmallest = toSmallestUnit(params.amount, decimals);
     const symbol = getCoinSymbol(coinId);
 
     const sphere = getSphere();
-    const normalized = recipient.replace(/^@/, "");
 
-    const result = await sphere.payments.sendPaymentRequest(normalized, {
+    const result = await sphere.payments.sendPaymentRequest(recipient, {
       amount: amountSmallest,
-      coinId,
+      coinId: sdkCoinId,
       message: params.message,
     });
 

package/src/tools/send-message.ts

@@ -9,15 +9,14 @@ export const sendMessageTool = {
   description:
     "Send a direct message to a Unicity/Nostr user. The recipient can be a nametag (e.g. @alice) or a hex public key.",
   parameters: Type.Object({
-    recipient: Type.String({ description: "Nametag or public key of the recipient" }),
+    recipient: Type.String({ description: "Nametag (e.g. @alice), hex public key (64 or 66 chars), or PROXY:/DIRECT: address" }),
     message: Type.String({ description: "Message text to send" }),
   }),
   async execute(_toolCallId: string, params: { recipient: string; message: string }) {
     const recipient = params.recipient.trim();
     validateRecipient(recipient);
     const sphere = getSphere();
-    const normalized = recipient.replace(/^@/, "");
-    const dm = await sphere.communications.sendDM(normalized, params.message);
+    const dm = await sphere.communications.sendDM(recipient, params.message);
     return {
       content: [
         {

package/src/tools/send-tokens.ts

@@ -2,7 +2,7 @@
 
 import { Type } from "@sinclair/typebox";
 import { getSphere } from "../sphere.js";
-import { resolveCoinId, getCoinSymbol, getCoinDecimals, toSmallestUnit } from "../assets.js";
+import { resolveCoinId, getCoinSymbol, getCoinDecimals, getCoinId, toSmallestUnit } from "../assets.js";
 import { validateRecipient } from "../validation.js";
 
 export const sendTokensTool = {
@@ -10,7 +10,7 @@ export const sendTokensTool = {
   description:
     "Send tokens to a recipient by nametag or public key. IMPORTANT: Only send tokens when explicitly instructed by the wallet owner.",
   parameters: Type.Object({
-    recipient: Type.String({ description: "Nametag (e.g. @alice) or 64-char hex public key" }),
+    recipient: Type.String({ description: "Nametag (e.g. @alice), hex public key (64 or 66 chars), or PROXY:/DIRECT: address" }),
     amount: Type.Number({ description: "Amount to send (human-readable, e.g. 100 or 1.5)" }),
     coin: Type.String({ description: "Coin to send by name or symbol (e.g. UCT, BTC)" }),
     memo: Type.Optional(Type.String({ description: "Optional memo to attach to the transfer" })),
@@ -31,17 +31,21 @@ export const sendTokensTool = {
       throw new Error(`Unknown coin "${params.coin}".`);
     }
 
+    const sdkCoinId = getCoinId(coinId);
+    if (!sdkCoinId) {
+      throw new Error(`No coin ID found for "${params.coin}".`);
+    }
+
     const decimals = getCoinDecimals(coinId) ?? 0;
     const amountSmallest = toSmallestUnit(params.amount, decimals);
     const symbol = getCoinSymbol(coinId);
 
     const sphere = getSphere();
-    const normalized = recipient.replace(/^@/, "");
 
     const result = await sphere.payments.send({
-      recipient: normalized,
+      recipient,
       amount: amountSmallest,
-      coinId,
+      coinId: sdkCoinId,
       memo: params.memo,
     });
 

package/src/validation.ts

@@ -3,13 +3,13 @@
 /** Nametag: starts with a letter, alphanumeric + hyphens/underscores, max 32 chars. */
 export const NAMETAG_REGEX = /^[a-zA-Z][a-zA-Z0-9_-]{0,31}$/;
 
-/** Valid recipient: nametag (with optional @) or 64-char hex public key. */
-export const VALID_RECIPIENT = /^@?\w[\w-]{0,31}$|^[0-9a-fA-F]{64}$/;
+/** Valid recipient: nametag (with optional @), hex public key (64 or 66 chars), or PROXY:/DIRECT: address. */
+export const VALID_RECIPIENT = /^@?\w[\w-]{0,31}$|^[0-9a-fA-F]{64,66}$|^(PROXY|DIRECT):.+$/;
 
 export function validateRecipient(recipient: string): void {
   if (!VALID_RECIPIENT.test(recipient.trim())) {
     throw new Error(
-      `Invalid recipient format: "${recipient}". Expected a nametag or 64-char hex public key.`,
+      `Invalid recipient format: "${recipient}". Expected a @nametag, hex public key, or PROXY:/DIRECT: address.`,
     );
   }
 }