web3bio-profile-kit 0.1.4 → 0.1.5

package/dist/hooks/useBaseQuery.cjs

@@ -7,9 +7,6 @@ require('../types/source.cjs');
 require('../types/cointype.cjs');
 var react = require('react');
 var helpers = require('../utils/helpers.cjs');
-require('../utils/network.cjs');
-require('../utils/platform.cjs');
-require('../utils/source.cjs');
 
 /**
  * Constructs the API URL based on query parameters
@@ -17,11 +14,11 @@ require('../utils/source.cjs');
 const buildApiUrl = (identity, endpoint, universal) => {
     // Handle batch requests
     if (Array.isArray(identity)) {
-        return `${helpers.API_ENDPOINT}/${endpoint}/batch/${encodeURIComponent(JSON.stringify(identity))}`;
+        return `${helpers.PROD_API_ENDPOINT}/${endpoint}/batch/${encodeURIComponent(JSON.stringify(identity))}`;
     }
     // Handle universal queries
     if (universal) {
-        return `${helpers.API_ENDPOINT}/${endpoint}/${identity}`;
+        return `${helpers.PROD_API_ENDPOINT}/${endpoint}/${identity}`;
     }
     // Handle platform-specific queries
     const resolvedId = helpers.resolveIdentity(identity);
@@ -29,11 +26,11 @@ const buildApiUrl = (identity, endpoint, universal) => {
         return null;
     // Domain endpoint uses resolved ID directly
     if (endpoint === hook.QueryEndpoint.DOMAIN) {
-        return `${helpers.API_ENDPOINT}/${endpoint}/${resolvedId}`;
+        return `${helpers.PROD_API_ENDPOINT}/${endpoint}/${resolvedId}`;
     }
     // Other endpoints need platform/handle split
     const [platform, handle] = resolvedId.split(",");
-    return `${helpers.API_ENDPOINT}/${endpoint}/${platform}/${handle}`;
+    return `${helpers.PROD_API_ENDPOINT}/${endpoint}/${platform}/${handle}`;
 };
 // Generate a stable cache key for this request
 const getCacheKey = (identity, endpoint, universal) => {

package/dist/hooks/useBaseQuery.js

@@ -4,10 +4,7 @@ import { ErrorMessages, QueryEndpoint } from '../types/hook.js';
 import '../types/source.js';
 import '../types/cointype.js';
 import { useState, useRef, useEffect } from 'react';
-import { getApiKey, API_ENDPOINT, resolveIdentity } from '../utils/helpers.js';
-import '../utils/network.js';
-import '../utils/platform.js';
-import '../utils/source.js';
+import { getApiKey, PROD_API_ENDPOINT, resolveIdentity } from '../utils/helpers.js';
 
 /**
  * Constructs the API URL based on query parameters
@@ -15,11 +12,11 @@ import '../utils/source.js';
 const buildApiUrl = (identity, endpoint, universal) => {
     // Handle batch requests
     if (Array.isArray(identity)) {
-        return `${API_ENDPOINT}/${endpoint}/batch/${encodeURIComponent(JSON.stringify(identity))}`;
+        return `${PROD_API_ENDPOINT}/${endpoint}/batch/${encodeURIComponent(JSON.stringify(identity))}`;
     }
     // Handle universal queries
     if (universal) {
-        return `${API_ENDPOINT}/${endpoint}/${identity}`;
+        return `${PROD_API_ENDPOINT}/${endpoint}/${identity}`;
     }
     // Handle platform-specific queries
     const resolvedId = resolveIdentity(identity);
@@ -27,11 +24,11 @@ const buildApiUrl = (identity, endpoint, universal) => {
         return null;
     // Domain endpoint uses resolved ID directly
     if (endpoint === QueryEndpoint.DOMAIN) {
-        return `${API_ENDPOINT}/${endpoint}/${resolvedId}`;
+        return `${PROD_API_ENDPOINT}/${endpoint}/${resolvedId}`;
     }
     // Other endpoints need platform/handle split
     const [platform, handle] = resolvedId.split(",");
-    return `${API_ENDPOINT}/${endpoint}/${platform}/${handle}`;
+    return `${PROD_API_ENDPOINT}/${endpoint}/${platform}/${handle}`;
 };
 // Generate a stable cache key for this request
 const getCacheKey = (identity, endpoint, universal) => {

package/dist/index.cjs

@@ -7,17 +7,13 @@ var useUniversalNS = require('./hooks/useUniversalNS.cjs');
 var useBatchProfile = require('./hooks/useBatchProfile.cjs');
 var useBatchNS = require('./hooks/useBatchNS.cjs');
 var useDomain = require('./hooks/useDomain.cjs');
-var useBaseQuery = require('./hooks/useBaseQuery.cjs');
-var cointype = require('./types/cointype.cjs');
-var regex = require('./utils/regex.cjs');
-var helpers = require('./utils/helpers.cjs');
-var network = require('./utils/network.cjs');
-var platform = require('./utils/platform.cjs');
-var source = require('./utils/source.cjs');
-var platform$1 = require('./types/platform.cjs');
-var network$1 = require('./types/network.cjs');
-var hook = require('./types/hook.cjs');
-var source$1 = require('./types/source.cjs');
+require('./types/platform.cjs');
+require('./types/network.cjs');
+require('./types/hook.cjs');
+require('./types/source.cjs');
+require('./types/cointype.cjs');
+require('react');
+require('./utils/helpers.cjs');
 
 
 
@@ -28,44 +24,3 @@ exports.useUniversalNS = useUniversalNS.useUniversalNS;
 exports.useBatchProfile = useBatchProfile.useBatchProfile;
 exports.useBatchNS = useBatchNS.useBatchNS;
 exports.useDomain = useDomain.useDomain;
-exports.useBaseQuery = useBaseQuery.useBaseQuery;
-Object.defineProperty(exports, 'CoinType', {
-	enumerable: true,
-	get: function () { return cointype.CoinType; }
-});
-exports.REGEX = regex.REGEX;
-exports.API_ENDPOINT = helpers.API_ENDPOINT;
-exports.detectPlatform = helpers.detectPlatform;
-exports.getApiKey = helpers.getApiKey;
-exports.isSupportedPlatform = helpers.isSupportedPlatform;
-exports.prettify = helpers.prettify;
-exports.resolveIdentity = helpers.resolveIdentity;
-exports.NETWORK_DATA = network.NETWORK_DATA;
-exports.DEFAULT_PLATFORM = platform.DEFAULT_PLATFORM;
-exports.PLATFORM_DATA = platform.PLATFORM_DATA;
-exports.getPlatformData = platform.getPlatformData;
-exports.SOURCE_DATA = source.SOURCE_DATA;
-Object.defineProperty(exports, 'Platform', {
-	enumerable: true,
-	get: function () { return platform$1.Platform; }
-});
-Object.defineProperty(exports, 'PlatformSystem', {
-	enumerable: true,
-	get: function () { return platform$1.PlatformSystem; }
-});
-Object.defineProperty(exports, 'Network', {
-	enumerable: true,
-	get: function () { return network$1.Network; }
-});
-Object.defineProperty(exports, 'ErrorMessages', {
-	enumerable: true,
-	get: function () { return hook.ErrorMessages; }
-});
-Object.defineProperty(exports, 'QueryEndpoint', {
-	enumerable: true,
-	get: function () { return hook.QueryEndpoint; }
-});
-Object.defineProperty(exports, 'Source', {
-	enumerable: true,
-	get: function () { return source$1.Source; }
-});

package/dist/index.d.ts

@@ -1,3 +1 @@
-export * from "./hooks";
-export * from "./utils";
-export * from "./types";
+export { useProfile, useNS, useUniversalProfile, useUniversalNS, useBatchProfile, useBatchNS, useDomain, } from "./hooks";

package/dist/index.js

@@ -5,14 +5,10 @@ export { useUniversalNS } from './hooks/useUniversalNS.js';
 export { useBatchProfile } from './hooks/useBatchProfile.js';
 export { useBatchNS } from './hooks/useBatchNS.js';
 export { useDomain } from './hooks/useDomain.js';
-export { useBaseQuery } from './hooks/useBaseQuery.js';
-export { CoinType } from './types/cointype.js';
-export { REGEX } from './utils/regex.js';
-export { API_ENDPOINT, detectPlatform, getApiKey, isSupportedPlatform, prettify, resolveIdentity } from './utils/helpers.js';
-export { NETWORK_DATA } from './utils/network.js';
-export { DEFAULT_PLATFORM, PLATFORM_DATA, getPlatformData } from './utils/platform.js';
-export { SOURCE_DATA } from './utils/source.js';
-export { Platform, PlatformSystem } from './types/platform.js';
-export { Network } from './types/network.js';
-export { ErrorMessages, QueryEndpoint } from './types/hook.js';
-export { Source } from './types/source.js';
+import './types/platform.js';
+import './types/network.js';
+import './types/hook.js';
+import './types/source.js';
+import './types/cointype.js';
+import 'react';
+import './utils/helpers.js';

package/dist/types/hook.d.ts

@@ -43,7 +43,7 @@ export type AddressRecord = {
     /** The blockchain address */
     address: string;
     /** Network identifier */
-    network: string;
+    network: Network;
     /** Type identifier */
     __typename: "Address";
 };
@@ -114,7 +114,7 @@ export interface NSResponse {
     /** Profile description */
     description: string | null;
     /** Platform identifier */
-    platform: string;
+    platform: Platform;
     /** Human-readable display name */
     displayName: string | null;
     /** Alternative identities */

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./platform";
-export * from "./network";
-export * from "./hook";
-export * from "./source";
-export * from "./cointype";
+export { Platform, PlatformSystem, type PlatformType } from "./platform";
+export { Network, type NetworkType } from "./network";
+export { ErrorMessages, QueryEndpoint, type AddressRecord, type SocialLinksItem, type SocialLinks, type SocialRecord, type ProfileResponse, type NSResponse, type DomainResponse, type QueryOptions, type IdentityString, type QueryResult, type ProfileResult, type NSResult, type ProfileBatchResult, type NSBatchResult, type ProfileUniversalResult, type NSUniversalResult, type DomainResult } from "./hook";
+export { Source, type SourceType } from "./source";
+export { CoinType } from "./cointype";

package/dist/types/source.cjs

@@ -18,7 +18,6 @@ exports.Source = void 0;
     Source["lens"] = "lens";
     Source["farcaster"] = "farcaster";
     Source["space_id"] = "space_id";
-    Source["crossbell"] = "crossbell";
     Source["clusters"] = "clusters";
     Source["solana"] = "solana";
     Source["sns"] = "sns";

package/dist/types/source.d.ts

@@ -15,7 +15,6 @@ export declare enum Source {
     lens = "lens",
     farcaster = "farcaster",
     space_id = "space_id",
-    crossbell = "crossbell",
     clusters = "clusters",
     solana = "solana",
     sns = "sns",

package/dist/types/source.js

@@ -16,7 +16,6 @@ var Source;
     Source["lens"] = "lens";
     Source["farcaster"] = "farcaster";
     Source["space_id"] = "space_id";
-    Source["crossbell"] = "crossbell";
     Source["clusters"] = "clusters";
     Source["solana"] = "solana";
     Source["sns"] = "sns";

package/dist/utils/helpers.cjs

@@ -7,7 +7,7 @@ require('../types/source.cjs');
 require('../types/cointype.cjs');
 var regex = require('./regex.cjs');
 
-const API_ENDPOINT = "https://api.web3.bio";
+const PROD_API_ENDPOINT = "https://api.web3.bio";
 /**
  * Resolves an identity string to a platform and identifier
  * @param input The identity to resolve
@@ -62,36 +62,85 @@ const prettify = (input) => {
     }
     return input;
 };
+/**
+ * Fufill and standardize identity format
+ */
+const uglify = (input, platform$1) => {
+    if (!input)
+        return "";
+    switch (platform$1) {
+        case platform.Platform.farcaster:
+            return input.endsWith(".farcaster") ||
+                input.endsWith(".fcast.id") ||
+                input.endsWith(".farcaster.eth")
+                ? input
+                : `${input}.farcaster`;
+        case platform.Platform.lens:
+            return input.endsWith(".lens") ? input : `${input}.lens`;
+        case platform.Platform.basenames:
+            return input.endsWith(".base.eth")
+                ? input
+                : input.endsWith(".base")
+                    ? `${input}.eth`
+                    : `${input}.base.eth`;
+        case platform.Platform.linea:
+            return input.endsWith(".linea.eth")
+                ? input
+                : input.endsWith(".linea")
+                    ? `${input}.eth`
+                    : `${input}.linea.eth`;
+        default:
+            return input;
+    }
+};
 /**
  * Check if the platform is supported for API queries
  */
 const isSupportedPlatform = (platform$1) => {
     if (!platform$1)
         return false;
-    return Object.values(platform.Platform).includes(platform$1);
+    return [
+        platform.Platform.ens,
+        platform.Platform.basenames,
+        platform.Platform.linea,
+        platform.Platform.ethereum,
+        platform.Platform.twitter,
+        platform.Platform.github,
+        platform.Platform.farcaster,
+        platform.Platform.lens,
+        platform.Platform.unstoppableDomains,
+        platform.Platform.nextid,
+        platform.Platform.dotbit,
+        platform.Platform.solana,
+        platform.Platform.sns,
+    ].includes(platform$1);
 };
+const platformMap = new Map([
+    [regex.REGEX.BASENAMES, platform.Platform.basenames],
+    [regex.REGEX.LINEA, platform.Platform.linea],
+    [regex.REGEX.ENS, platform.Platform.ens],
+    [regex.REGEX.ETH_ADDRESS, platform.Platform.ethereum],
+    [regex.REGEX.LENS, platform.Platform.lens],
+    [regex.REGEX.UNSTOPPABLE_DOMAINS, platform.Platform.unstoppableDomains],
+    [regex.REGEX.SPACE_ID, platform.Platform.space_id],
+    [regex.REGEX.GRAVITY, platform.Platform.gravity],
+    [regex.REGEX.DOTBIT, platform.Platform.dotbit],
+    [regex.REGEX.SNS, platform.Platform.sns],
+    [regex.REGEX.GENOME, platform.Platform.genome],
+    [regex.REGEX.BTC_ADDRESS, platform.Platform.bitcoin],
+    [regex.REGEX.SOLANA_ADDRESS, platform.Platform.solana],
+    [regex.REGEX.FARCASTER, platform.Platform.farcaster],
+    [regex.REGEX.CLUSTER, platform.Platform.clusters],
+    [regex.REGEX.NEXT_ID, platform.Platform.nextid],
+    [regex.REGEX.NOSTR, platform.Platform.nostr],
+    [regex.REGEX.TWITTER, platform.Platform.twitter],
+]);
 /**
  * Detect platform from identity string based on regex patterns
  */
 const detectPlatform = (term) => {
     if (term.endsWith(".farcaster.eth"))
         return platform.Platform.farcaster;
-    const platformMap = [
-        [regex.REGEX.BASENAMES, platform.Platform.basenames],
-        [regex.REGEX.LINEA, platform.Platform.linea],
-        [regex.REGEX.ENS, platform.Platform.ens],
-        [regex.REGEX.ETH_ADDRESS, platform.Platform.ethereum],
-        [regex.REGEX.LENS, platform.Platform.lens],
-        [regex.REGEX.UNSTOPPABLE_DOMAINS, platform.Platform.unstoppableDomains],
-        [regex.REGEX.SPACE_ID, platform.Platform.space_id],
-        [regex.REGEX.DOTBIT, platform.Platform.dotbit],
-        [regex.REGEX.SNS, platform.Platform.sns],
-        [regex.REGEX.BTC_ADDRESS, platform.Platform.bitcoin],
-        [regex.REGEX.SOLANA_ADDRESS, platform.Platform.solana],
-        [regex.REGEX.FARCASTER, platform.Platform.farcaster],
-        [regex.REGEX.TWITTER, platform.Platform.twitter],
-        [regex.REGEX.NEXT_ID, platform.Platform.nextid],
-    ];
     for (const [regex, Platform] of platformMap) {
         if (regex.test(term)) {
             return Platform;
@@ -110,10 +159,71 @@ const getApiKey = (userProvidedKey) => {
         process.env.NEXT_PUBLIC_WEB3BIO_API_KEY ||
         process.env.VITE_WEB3BIO_API_KEY);
 };
+/**
+ * Compare two addresses for equality in a case-insensitive manner
+ * Used for blockchain address comparison where case doesn't affect validity
+ *
+ * @param address The first address to compare
+ * @param otherAddress The second address to compare
+ * @returns True if addresses match (ignoring case), false otherwise
+ */
+const isSameAddress = (address, otherAddress) => {
+    if (!address || !otherAddress)
+        return false;
+    return address.toLowerCase() === otherAddress.toLowerCase();
+};
+const web3AddressRegexes = [
+    regex.REGEX.ETH_ADDRESS,
+    regex.REGEX.BTC_ADDRESS,
+    regex.REGEX.SOLANA_ADDRESS,
+    regex.REGEX.NEXT_ID,
+    regex.REGEX.NOSTR,
+];
+/**
+ * Determines if a string is a valid Web3 address
+ * Checks against multiple blockchain address formats
+ *
+ * @param address The string to check
+ * @returns True if the string matches any supported Web3 address format, false otherwise
+ */
+const isWeb3Address = (address) => {
+    if (!address)
+        return false;
+    return web3AddressRegexes.some((regex) => regex.test(address));
+};
+/**
+ * Validates if a string is a valid Ethereum address
+ * Checks both the address format and excludes common burn/empty addresses
+ *
+ * @param address - The string to validate as an Ethereum address
+ * @returns True if the address is valid and not a burn/empty address, false otherwise
+ */
+const isValidEthereumAddress = (address) => {
+    if (!regex.REGEX.ETH_ADDRESS.test(address))
+        return false; // invalid ethereum address
+    if (address.match(/^0x0*.$|0x[123468abef]*$|0x0*dead$/i))
+        return false; // empty & burn address
+    return true;
+};
+/**
+ * Validates if a string is a valid Solana address
+ * Checks if the string matches the Solana address format
+ *
+ * @param address - The string to validate as a Solana address
+ * @returns True if the string is a valid Solana address, false otherwise
+ */
+const isValidSolanaAddress = (address) => {
+    return regex.REGEX.SOLANA_ADDRESS.test(address);
+};
 
-exports.API_ENDPOINT = API_ENDPOINT;
+exports.PROD_API_ENDPOINT = PROD_API_ENDPOINT;
 exports.detectPlatform = detectPlatform;
 exports.getApiKey = getApiKey;
+exports.isSameAddress = isSameAddress;
 exports.isSupportedPlatform = isSupportedPlatform;
+exports.isValidEthereumAddress = isValidEthereumAddress;
+exports.isValidSolanaAddress = isValidSolanaAddress;
+exports.isWeb3Address = isWeb3Address;
 exports.prettify = prettify;
 exports.resolveIdentity = resolveIdentity;
+exports.uglify = uglify;

package/dist/utils/helpers.d.ts

@@ -1,5 +1,6 @@
 import { Platform } from "../types";
-export declare const API_ENDPOINT = "https://api.web3.bio";
+export declare const PROD_API_ENDPOINT = "https://api.web3.bio";
+export declare const STAGING_API_ENDPOINT = "https://api-staging.web3.bio";
 /**
  * Resolves an identity string to a platform and identifier
  * @param input The identity to resolve
@@ -10,6 +11,10 @@ export declare const resolveIdentity: (input: string) => string | null;
  * Clean up and standardize identity format
  */
 export declare const prettify: (input: string) => string;
+/**
+ * Fufill and standardize identity format
+ */
+export declare const uglify: (input: string, platform: Platform) => string;
 /**
  * Check if the platform is supported for API queries
  */
@@ -22,3 +27,36 @@ export declare const detectPlatform: (term: string) => Platform;
  * Get API key from various environment sources or user provided value
  */
 export declare const getApiKey: (userProvidedKey?: string) => string | undefined;
+/**
+ * Compare two addresses for equality in a case-insensitive manner
+ * Used for blockchain address comparison where case doesn't affect validity
+ *
+ * @param address The first address to compare
+ * @param otherAddress The second address to compare
+ * @returns True if addresses match (ignoring case), false otherwise
+ */
+export declare const isSameAddress: (address?: string | undefined, otherAddress?: string | undefined) => boolean;
+/**
+ * Determines if a string is a valid Web3 address
+ * Checks against multiple blockchain address formats
+ *
+ * @param address The string to check
+ * @returns True if the string matches any supported Web3 address format, false otherwise
+ */
+export declare const isWeb3Address: (address: string) => boolean;
+/**
+ * Validates if a string is a valid Ethereum address
+ * Checks both the address format and excludes common burn/empty addresses
+ *
+ * @param address - The string to validate as an Ethereum address
+ * @returns True if the address is valid and not a burn/empty address, false otherwise
+ */
+export declare const isValidEthereumAddress: (address: string) => boolean;
+/**
+ * Validates if a string is a valid Solana address
+ * Checks if the string matches the Solana address format
+ *
+ * @param address - The string to validate as a Solana address
+ * @returns True if the string is a valid Solana address, false otherwise
+ */
+export declare const isValidSolanaAddress: (address: string) => boolean;

package/dist/utils/helpers.js

@@ -5,7 +5,7 @@ import '../types/source.js';
 import '../types/cointype.js';
 import { REGEX } from './regex.js';
 
-const API_ENDPOINT = "https://api.web3.bio";
+const PROD_API_ENDPOINT = "https://api.web3.bio";
 /**
  * Resolves an identity string to a platform and identifier
  * @param input The identity to resolve
@@ -60,36 +60,85 @@ const prettify = (input) => {
     }
     return input;
 };
+/**
+ * Fufill and standardize identity format
+ */
+const uglify = (input, platform) => {
+    if (!input)
+        return "";
+    switch (platform) {
+        case Platform.farcaster:
+            return input.endsWith(".farcaster") ||
+                input.endsWith(".fcast.id") ||
+                input.endsWith(".farcaster.eth")
+                ? input
+                : `${input}.farcaster`;
+        case Platform.lens:
+            return input.endsWith(".lens") ? input : `${input}.lens`;
+        case Platform.basenames:
+            return input.endsWith(".base.eth")
+                ? input
+                : input.endsWith(".base")
+                    ? `${input}.eth`
+                    : `${input}.base.eth`;
+        case Platform.linea:
+            return input.endsWith(".linea.eth")
+                ? input
+                : input.endsWith(".linea")
+                    ? `${input}.eth`
+                    : `${input}.linea.eth`;
+        default:
+            return input;
+    }
+};
 /**
  * Check if the platform is supported for API queries
  */
 const isSupportedPlatform = (platform) => {
     if (!platform)
         return false;
-    return Object.values(Platform).includes(platform);
+    return [
+        Platform.ens,
+        Platform.basenames,
+        Platform.linea,
+        Platform.ethereum,
+        Platform.twitter,
+        Platform.github,
+        Platform.farcaster,
+        Platform.lens,
+        Platform.unstoppableDomains,
+        Platform.nextid,
+        Platform.dotbit,
+        Platform.solana,
+        Platform.sns,
+    ].includes(platform);
 };
+const platformMap = new Map([
+    [REGEX.BASENAMES, Platform.basenames],
+    [REGEX.LINEA, Platform.linea],
+    [REGEX.ENS, Platform.ens],
+    [REGEX.ETH_ADDRESS, Platform.ethereum],
+    [REGEX.LENS, Platform.lens],
+    [REGEX.UNSTOPPABLE_DOMAINS, Platform.unstoppableDomains],
+    [REGEX.SPACE_ID, Platform.space_id],
+    [REGEX.GRAVITY, Platform.gravity],
+    [REGEX.DOTBIT, Platform.dotbit],
+    [REGEX.SNS, Platform.sns],
+    [REGEX.GENOME, Platform.genome],
+    [REGEX.BTC_ADDRESS, Platform.bitcoin],
+    [REGEX.SOLANA_ADDRESS, Platform.solana],
+    [REGEX.FARCASTER, Platform.farcaster],
+    [REGEX.CLUSTER, Platform.clusters],
+    [REGEX.NEXT_ID, Platform.nextid],
+    [REGEX.NOSTR, Platform.nostr],
+    [REGEX.TWITTER, Platform.twitter],
+]);
 /**
  * Detect platform from identity string based on regex patterns
  */
 const detectPlatform = (term) => {
     if (term.endsWith(".farcaster.eth"))
         return Platform.farcaster;
-    const platformMap = [
-        [REGEX.BASENAMES, Platform.basenames],
-        [REGEX.LINEA, Platform.linea],
-        [REGEX.ENS, Platform.ens],
-        [REGEX.ETH_ADDRESS, Platform.ethereum],
-        [REGEX.LENS, Platform.lens],
-        [REGEX.UNSTOPPABLE_DOMAINS, Platform.unstoppableDomains],
-        [REGEX.SPACE_ID, Platform.space_id],
-        [REGEX.DOTBIT, Platform.dotbit],
-        [REGEX.SNS, Platform.sns],
-        [REGEX.BTC_ADDRESS, Platform.bitcoin],
-        [REGEX.SOLANA_ADDRESS, Platform.solana],
-        [REGEX.FARCASTER, Platform.farcaster],
-        [REGEX.TWITTER, Platform.twitter],
-        [REGEX.NEXT_ID, Platform.nextid],
-    ];
     for (const [regex, Platform] of platformMap) {
         if (regex.test(term)) {
             return Platform;
@@ -108,5 +157,61 @@ const getApiKey = (userProvidedKey) => {
         process.env.NEXT_PUBLIC_WEB3BIO_API_KEY ||
         process.env.VITE_WEB3BIO_API_KEY);
 };
+/**
+ * Compare two addresses for equality in a case-insensitive manner
+ * Used for blockchain address comparison where case doesn't affect validity
+ *
+ * @param address The first address to compare
+ * @param otherAddress The second address to compare
+ * @returns True if addresses match (ignoring case), false otherwise
+ */
+const isSameAddress = (address, otherAddress) => {
+    if (!address || !otherAddress)
+        return false;
+    return address.toLowerCase() === otherAddress.toLowerCase();
+};
+const web3AddressRegexes = [
+    REGEX.ETH_ADDRESS,
+    REGEX.BTC_ADDRESS,
+    REGEX.SOLANA_ADDRESS,
+    REGEX.NEXT_ID,
+    REGEX.NOSTR,
+];
+/**
+ * Determines if a string is a valid Web3 address
+ * Checks against multiple blockchain address formats
+ *
+ * @param address The string to check
+ * @returns True if the string matches any supported Web3 address format, false otherwise
+ */
+const isWeb3Address = (address) => {
+    if (!address)
+        return false;
+    return web3AddressRegexes.some((regex) => regex.test(address));
+};
+/**
+ * Validates if a string is a valid Ethereum address
+ * Checks both the address format and excludes common burn/empty addresses
+ *
+ * @param address - The string to validate as an Ethereum address
+ * @returns True if the address is valid and not a burn/empty address, false otherwise
+ */
+const isValidEthereumAddress = (address) => {
+    if (!REGEX.ETH_ADDRESS.test(address))
+        return false; // invalid ethereum address
+    if (address.match(/^0x0*.$|0x[123468abef]*$|0x0*dead$/i))
+        return false; // empty & burn address
+    return true;
+};
+/**
+ * Validates if a string is a valid Solana address
+ * Checks if the string matches the Solana address format
+ *
+ * @param address - The string to validate as a Solana address
+ * @returns True if the string is a valid Solana address, false otherwise
+ */
+const isValidSolanaAddress = (address) => {
+    return REGEX.SOLANA_ADDRESS.test(address);
+};
 
-export { API_ENDPOINT, detectPlatform, getApiKey, isSupportedPlatform, prettify, resolveIdentity };
+export { PROD_API_ENDPOINT, detectPlatform, getApiKey, isSameAddress, isSupportedPlatform, isValidEthereumAddress, isValidSolanaAddress, isWeb3Address, prettify, resolveIdentity, uglify };

package/dist/utils/index.cjs

@@ -2,10 +2,10 @@
 
 var cointype = require('../types/cointype.cjs');
 var regex = require('./regex.cjs');
-var helpers = require('./helpers.cjs');
-var network = require('./network.cjs');
 var platform = require('./platform.cjs');
+var network = require('./network.cjs');
 var source = require('./source.cjs');
+var helpers = require('./helpers.cjs');
 
 
 
@@ -14,14 +14,16 @@ Object.defineProperty(exports, 'CoinType', {
 	get: function () { return cointype.CoinType; }
 });
 exports.REGEX = regex.REGEX;
-exports.API_ENDPOINT = helpers.API_ENDPOINT;
+exports.DEFAULT_PLATFORM = platform.DEFAULT_PLATFORM;
+exports.PLATFORM_DATA = platform.PLATFORM_DATA;
+exports.NETWORK_DATA = network.NETWORK_DATA;
+exports.SOURCE_DATA = source.SOURCE_DATA;
 exports.detectPlatform = helpers.detectPlatform;
-exports.getApiKey = helpers.getApiKey;
+exports.isSameAddress = helpers.isSameAddress;
 exports.isSupportedPlatform = helpers.isSupportedPlatform;
+exports.isValidEthereumAddress = helpers.isValidEthereumAddress;
+exports.isValidSolanaAddress = helpers.isValidSolanaAddress;
+exports.isWeb3Address = helpers.isWeb3Address;
 exports.prettify = helpers.prettify;
 exports.resolveIdentity = helpers.resolveIdentity;
-exports.NETWORK_DATA = network.NETWORK_DATA;
-exports.DEFAULT_PLATFORM = platform.DEFAULT_PLATFORM;
-exports.PLATFORM_DATA = platform.PLATFORM_DATA;
-exports.getPlatformData = platform.getPlatformData;
-exports.SOURCE_DATA = source.SOURCE_DATA;
+exports.uglify = helpers.uglify;

package/dist/utils/index.d.ts

@@ -1,6 +1,6 @@
 export * from "../types/cointype";
-export * from "./regex";
-export * from "./helpers";
-export * from "./network";
-export * from "./platform";
-export * from "./source";
+export { REGEX } from "./regex";
+export { DEFAULT_PLATFORM, PLATFORM_DATA } from "./platform";
+export { NETWORK_DATA } from "./network";
+export { SOURCE_DATA } from "./source";
+export { resolveIdentity, prettify, uglify, isSupportedPlatform, detectPlatform, isSameAddress, isWeb3Address, isValidEthereumAddress, isValidSolanaAddress, } from "./helpers";

package/dist/utils/index.js

@@ -1,6 +1,6 @@
 export { CoinType } from '../types/cointype.js';
 export { REGEX } from './regex.js';
-export { API_ENDPOINT, detectPlatform, getApiKey, isSupportedPlatform, prettify, resolveIdentity } from './helpers.js';
+export { DEFAULT_PLATFORM, PLATFORM_DATA } from './platform.js';
 export { NETWORK_DATA } from './network.js';
-export { DEFAULT_PLATFORM, PLATFORM_DATA, getPlatformData } from './platform.js';
 export { SOURCE_DATA } from './source.js';
+export { detectPlatform, isSameAddress, isSupportedPlatform, isValidEthereumAddress, isValidSolanaAddress, isWeb3Address, prettify, resolveIdentity, uglify } from './helpers.js';

package/dist/utils/platform.cjs

@@ -968,16 +968,6 @@ const PLATFORM_DATA = new Map([
         },
     ],
 ]);
-/**
- * Get Platform data by key
- * @param platform - Platform
- * @returns Platform data or default
- * @public
- */
-function getPlatformData(platform) {
-    return PLATFORM_DATA.get(platform) || DEFAULT_PLATFORM;
-}
 
 exports.DEFAULT_PLATFORM = DEFAULT_PLATFORM;
 exports.PLATFORM_DATA = PLATFORM_DATA;
-exports.getPlatformData = getPlatformData;

package/dist/utils/platform.d.ts

@@ -9,10 +9,3 @@ export declare const DEFAULT_PLATFORM: Readonly<PlatformType>;
  * @public
  */
 export declare const PLATFORM_DATA: ReadonlyMap<Platform, Readonly<PlatformType>>;
-/**
- * Get Platform data by key
- * @param platform - Platform
- * @returns Platform data or default
- * @public
- */
-export declare function getPlatformData(platform: Platform): Readonly<PlatformType>;

package/dist/utils/platform.js

@@ -966,14 +966,5 @@ const PLATFORM_DATA = new Map([
         },
     ],
 ]);
-/**
- * Get Platform data by key
- * @param platform - Platform
- * @returns Platform data or default
- * @public
- */
-function getPlatformData(platform) {
-    return PLATFORM_DATA.get(platform) || DEFAULT_PLATFORM;
-}
 
-export { DEFAULT_PLATFORM, PLATFORM_DATA, getPlatformData };
+export { DEFAULT_PLATFORM, PLATFORM_DATA };

package/dist/utils/regex.cjs

@@ -15,7 +15,6 @@ const REGEX = {
     GRAVITY: /^.+\.g$/,
     GENOME: /^.+\.gno$/i,
     UNSTOPPABLE_DOMAINS: /^.+\.(?:crypto|888|nft|blockchain|bitcoin|dao|x|klever|hi|zil|kresus|polygon|wallet|binanceus|anime|go|manga|eth)$/i,
-    CROSSBELL: /^.+\.csb$/i,
     DOTBIT: /^.+\.bit$/i,
     SNS: /^.+\.sol$/i,
     ETH_ADDRESS: /^0x[a-fA-F0-9]{40}$/i,

package/dist/utils/regex.d.ts

@@ -13,7 +13,6 @@ export declare const REGEX: {
     GRAVITY: RegExp;
     GENOME: RegExp;
     UNSTOPPABLE_DOMAINS: RegExp;
-    CROSSBELL: RegExp;
     DOTBIT: RegExp;
     SNS: RegExp;
     ETH_ADDRESS: RegExp;

package/dist/utils/regex.js

@@ -13,7 +13,6 @@ const REGEX = {
     GRAVITY: /^.+\.g$/,
     GENOME: /^.+\.gno$/i,
     UNSTOPPABLE_DOMAINS: /^.+\.(?:crypto|888|nft|blockchain|bitcoin|dao|x|klever|hi|zil|kresus|polygon|wallet|binanceus|anime|go|manga|eth)$/i,
-    CROSSBELL: /^.+\.csb$/i,
     DOTBIT: /^.+\.bit$/i,
     SNS: /^.+\.sol$/i,
     ETH_ADDRESS: /^0x[a-fA-F0-9]{40}$/i,

package/dist/utils/source.cjs

@@ -51,10 +51,6 @@ const SOURCE_DATA = {
         name: "Gravity",
         description: "Gravity alpha mainnet name service",
     },
-    [source.Source.crossbell]: {
-        name: "Crossbell",
-        description: "Decentralized publishing protocol",
-    },
     [source.Source.clusters]: {
         name: "Clusters",
         description: "On-chain social protocol",

package/dist/utils/source.d.ts

@@ -1,2 +1,2 @@
-import { SourceType, Source } from "../types/source";
+import { Source, type SourceType } from "../types/source";
 export declare const SOURCE_DATA: Readonly<Record<Source, SourceType>>;

package/dist/utils/source.js

@@ -49,10 +49,6 @@ const SOURCE_DATA = {
         name: "Gravity",
         description: "Gravity alpha mainnet name service",
     },
-    [Source.crossbell]: {
-        name: "Crossbell",
-        description: "Decentralized publishing protocol",
-    },
     [Source.clusters]: {
         name: "Clusters",
         description: "On-chain social protocol",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web3bio-profile-kit",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "React hooks for querying ENS, Farcaster, Lens and Web3 universal profiles",
   "author": "web3bio",
   "license": "MIT",
@@ -17,15 +17,31 @@
     },
     "./hooks": {
       "types": "./dist/hooks/index.d.ts",
-      "default": "./dist/hooks/index.js"
+      "import": "./dist/hooks/index.js",
+      "require": "./dist/hooks/index.cjs"
     },
     "./types": {
       "types": "./dist/types/index.d.ts",
-      "default": "./dist/types/index.js"
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.cjs"
     },
     "./utils": {
       "types": "./dist/utils/index.d.ts",
-      "default": "./dist/utils/index.js"
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "types": [
+        "./dist/types/index.d.ts"
+      ],
+      "hooks": [
+        "./dist/hooks/index.d.ts"
+      ],
+      "utils": [
+        "./dist/utils/index.d.ts"
+      ]
     }
   },
   "files": [