@phantom/utils 1.0.0-beta.3 → 1.0.0

package/dist/index.d.ts

@@ -15,4 +15,18 @@ declare function randomUUID(): string;
  */
 declare function randomString(length: number): string;
 
-export { randomString, randomUUID };
+/**
+ * Secure time service that fetches server time from Phantom's time API
+ * instead of relying on local machine time which can be manipulated
+ */
+declare const getSecureTimestamp: () => Promise<number>;
+declare const getSecureTimestampSync: () => number;
+
+/**
+ * Network utility functions for working with blockchain network identifiers
+ */
+declare function getChainPrefix(networkId: string): string;
+declare function isEthereumChain(networkId: string): boolean;
+declare function isSolanaChain(networkId: string): boolean;
+
+export { getChainPrefix, getSecureTimestamp, getSecureTimestampSync, isEthereumChain, isSolanaChain, randomString, randomUUID };

package/dist/index.js

@@ -20,6 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  getChainPrefix: () => getChainPrefix,
+  getSecureTimestamp: () => getSecureTimestamp,
+  getSecureTimestampSync: () => getSecureTimestampSync,
+  isEthereumChain: () => isEthereumChain,
+  isSolanaChain: () => isSolanaChain,
   randomString: () => randomString,
   randomUUID: () => randomUUID
 });
@@ -44,8 +49,93 @@ function randomString(length) {
   }
   return result;
 }
+
+// src/time.ts
+var TimeService = class {
+  constructor() {
+    this.cache = null;
+    this.CACHE_DURATION = 3e4;
+    // 30 seconds cache
+    this.TIME_API_URL = "https://time.phantom.app/utc";
+  }
+  static getInstance() {
+    if (!TimeService.instance) {
+      TimeService.instance = new TimeService();
+    }
+    return TimeService.instance;
+  }
+  /**
+   * Get current timestamp from Phantom's secure time API
+   * Includes basic caching to reduce API calls
+   */
+  async now() {
+    const now = Date.now();
+    if (this.cache && now - this.cache.fetchedAt < this.CACHE_DURATION) {
+      const elapsed = now - this.cache.fetchedAt;
+      return this.cache.timestamp + elapsed;
+    }
+    try {
+      const response = await fetch(this.TIME_API_URL);
+      if (!response.ok) {
+        throw new Error(`Time API responded with status: ${response.status}`);
+      }
+      const timestampText = await response.text();
+      const timestamp = parseInt(timestampText, 10);
+      if (isNaN(timestamp)) {
+        throw new Error(`Invalid timestamp received: ${timestampText}`);
+      }
+      this.cache = {
+        timestamp,
+        fetchedAt: now
+      };
+      return timestamp;
+    } catch (error) {
+      return Date.now();
+    }
+  }
+  /**
+   * Synchronous version that uses cached time if available,
+   * otherwise falls back to Date.now()
+   */
+  nowSync() {
+    if (this.cache) {
+      const elapsed = Date.now() - this.cache.fetchedAt;
+      if (elapsed < this.CACHE_DURATION) {
+        return this.cache.timestamp + elapsed;
+      }
+    }
+    return Date.now();
+  }
+  /**
+   * Clear the cache (useful for testing)
+   */
+  clearCache() {
+    this.cache = null;
+  }
+};
+var timeService = TimeService.getInstance();
+var getSecureTimestamp = () => timeService.now();
+var getSecureTimestampSync = () => timeService.nowSync();
+
+// src/network.ts
+function getChainPrefix(networkId) {
+  return networkId.split(":")[0].toLowerCase();
+}
+function isEthereumChain(networkId) {
+  const network = getChainPrefix(networkId);
+  return network === "eip155";
+}
+function isSolanaChain(networkId) {
+  const network = getChainPrefix(networkId);
+  return network === "solana";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getChainPrefix,
+  getSecureTimestamp,
+  getSecureTimestampSync,
+  isEthereumChain,
+  isSolanaChain,
   randomString,
   randomUUID
 });

package/dist/index.mjs

@@ -17,7 +17,92 @@ function randomString(length) {
   }
   return result;
 }
+
+// src/time.ts
+var TimeService = class {
+  constructor() {
+    this.cache = null;
+    this.CACHE_DURATION = 3e4;
+    // 30 seconds cache
+    this.TIME_API_URL = "https://time.phantom.app/utc";
+  }
+  static getInstance() {
+    if (!TimeService.instance) {
+      TimeService.instance = new TimeService();
+    }
+    return TimeService.instance;
+  }
+  /**
+   * Get current timestamp from Phantom's secure time API
+   * Includes basic caching to reduce API calls
+   */
+  async now() {
+    const now = Date.now();
+    if (this.cache && now - this.cache.fetchedAt < this.CACHE_DURATION) {
+      const elapsed = now - this.cache.fetchedAt;
+      return this.cache.timestamp + elapsed;
+    }
+    try {
+      const response = await fetch(this.TIME_API_URL);
+      if (!response.ok) {
+        throw new Error(`Time API responded with status: ${response.status}`);
+      }
+      const timestampText = await response.text();
+      const timestamp = parseInt(timestampText, 10);
+      if (isNaN(timestamp)) {
+        throw new Error(`Invalid timestamp received: ${timestampText}`);
+      }
+      this.cache = {
+        timestamp,
+        fetchedAt: now
+      };
+      return timestamp;
+    } catch (error) {
+      return Date.now();
+    }
+  }
+  /**
+   * Synchronous version that uses cached time if available,
+   * otherwise falls back to Date.now()
+   */
+  nowSync() {
+    if (this.cache) {
+      const elapsed = Date.now() - this.cache.fetchedAt;
+      if (elapsed < this.CACHE_DURATION) {
+        return this.cache.timestamp + elapsed;
+      }
+    }
+    return Date.now();
+  }
+  /**
+   * Clear the cache (useful for testing)
+   */
+  clearCache() {
+    this.cache = null;
+  }
+};
+var timeService = TimeService.getInstance();
+var getSecureTimestamp = () => timeService.now();
+var getSecureTimestampSync = () => timeService.nowSync();
+
+// src/network.ts
+function getChainPrefix(networkId) {
+  return networkId.split(":")[0].toLowerCase();
+}
+function isEthereumChain(networkId) {
+  const network = getChainPrefix(networkId);
+  return network === "eip155";
+}
+function isSolanaChain(networkId) {
+  const network = getChainPrefix(networkId);
+  return network === "solana";
+}
 export {
+  getChainPrefix,
+  getSecureTimestamp,
+  getSecureTimestampSync,
+  isEthereumChain,
+  isSolanaChain,
   randomString,
   randomUUID
 };

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@phantom/utils",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0",
   "description": "Utility functions for Phantom Wallet SDK",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/phantom/phantom-connect-sdk",
+    "directory": "packages/utils"
+  },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",