@topazdex/id-connect 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Topaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,128 @@
+# @topazdex/id-connect
+
+Add **Topaz ID** — a self-custodial BNB Chain global wallet — to your dapp as a
+one-click login. Users sign in with their existing Topaz ID account
+([id.topazdex.com](https://id.topazdex.com)); no seed phrase, no extension, and
+**no Privy app of your own**.
+
+Topaz ID is built on [Privy's global wallets](https://docs.privy.io/wallets/global-wallets/overview).
+Your app is the *requester* and references Topaz ID's public app id — that's the
+whole integration. You don't need a Privy account, and your domain does **not**
+need to be allowlisted by Topaz ID.
+
+## Install
+
+```bash
+yarn add @topazdex/id-connect @privy-io/cross-app-connect wagmi viem \
+  @rainbow-me/rainbowkit @tanstack/react-query
+```
+
+> `@privy-io/cross-app-connect` pins `viem@2.52.0`. Match it to avoid peer
+> warnings.
+
+## RainbowKit
+
+```ts
+import { topazIdWallet } from "@topazdex/id-connect/rainbow-kit";
+import { connectorsForWallets } from "@rainbow-me/rainbowkit";
+import { createConfig, http } from "wagmi";
+import { TOPAZ_ID_CHAIN } from "@topazdex/id-connect/rainbow-kit";
+
+const connectors = connectorsForWallets(
+  [{ groupName: "Sign in", wallets: [topazIdWallet()] }],
+  { appName: "Your App", projectId: "<walletconnect-project-id>" },
+);
+
+export const wagmiConfig = createConfig({
+  chains: [TOPAZ_ID_CHAIN], // BNB Chain (56)
+  transports: { [TOPAZ_ID_CHAIN.id]: http() },
+  connectors,
+  ssr: true,
+});
+```
+
+`"Topaz ID"` now appears in the RainbowKit picker. Selecting it opens a Topaz ID
+consent window where the user signs in — no new wallet is created.
+
+## Plain wagmi (no RainbowKit)
+
+```ts
+import { topazIdConnector, TOPAZ_ID_CHAIN } from "@topazdex/id-connect/rainbow-kit";
+import { createConfig, http } from "wagmi";
+
+export const wagmiConfig = createConfig({
+  chains: [TOPAZ_ID_CHAIN],
+  transports: { [TOPAZ_ID_CHAIN.id]: http() },
+  connectors: [topazIdConnector()],
+  ssr: true,
+});
+```
+
+## Using the wallet
+
+Once connected, Topaz ID is a standard EIP-1193 wallet. Use plain wagmi — **never**
+`@privy-io/react-auth` signing hooks (those are embedded-wallet-only and won't
+route through Topaz ID).
+
+```ts
+import { useAccount, useSendTransaction } from "wagmi";
+import { parseEther } from "viem";
+
+const { address } = useAccount(); // the user's Topaz ID address
+
+const { sendTransactionAsync } = useSendTransaction();
+await sendTransactionAsync({ to, value: parseEther("0.01"), chainId: 56 });
+// Topaz ID pops a consent window; the user approves every action.
+```
+
+## Show the user's Topaz ID profile
+
+Topaz ID owns each wallet's name, handle, and avatar. Render real identity instead
+of a bare address. Framework-agnostic helpers live at the root entry; a React Query
+hook lives at `/react`.
+
+```ts
+import { displayNameForWallet, avatarForWallet } from "@topazdex/id-connect";
+import { useTopazIdProfile } from "@topazdex/id-connect/react";
+
+const { data: profile } = useTopazIdProfile(address);
+const label = displayNameForWallet(profile ?? null, address);
+const avatar = avatarForWallet(profile ?? null, "/default-avatar.png");
+```
+
+Reads are public and CORS-open. `found: false` → fall back to the address; never
+block your UI on the fetch.
+
+## Already using Privy?
+
+If your app is itself a Privy app, skip the connector and add Topaz ID as a
+cross-app login method instead:
+
+```ts
+// PrivyProvider config:
+//   loginMethods: ["email", "wallet", "privy:<topaz-id-app-id>"]
+import { useCrossAppAccounts, usePrivy } from "@privy-io/react-auth";
+import { TOPAZ_ID_APP_ID } from "@topazdex/id-connect";
+
+const { user } = usePrivy();
+const { loginWithCrossAppAccount } = useCrossAppAccounts();
+
+await loginWithCrossAppAccount({ appId: TOPAZ_ID_APP_ID });
+
+const topaz = user?.linkedAccounts.find(
+  (a) => a.type === "cross_app" && a.providerApp.id === TOPAZ_ID_APP_ID,
+);
+const address = topaz?.embeddedWallets[0]?.address;
+```
+
+## Exports
+
+| Entry | Contents |
+| --- | --- |
+| `@topazdex/id-connect` | `TOPAZ_ID_APP_ID`, profile helpers, `TopazIdProfile` |
+| `@topazdex/id-connect/rainbow-kit` | `topazIdWallet`, `topazIdConnector`, `TOPAZ_ID_CHAIN` |
+| `@topazdex/id-connect/react` | `useTopazIdProfile` |
+
+## License
+
+MIT

package/dist/chunk-7OXTIVNI.js

@@ -0,0 +1,9 @@
+// src/constants.ts
+var TOPAZ_ID_APP_ID = "cmpt1zsgh00rs0cld1hgqc0v7";
+var TOPAZ_ID_NAME = "Topaz ID";
+var TOPAZ_ID_ICON_URL = "https://id.topazdex.com/brand/topaz-logo.png";
+var TOPAZ_ID_BASE_URL = "https://id.topazdex.com";
+
+export { TOPAZ_ID_APP_ID, TOPAZ_ID_BASE_URL, TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME };
+//# sourceMappingURL=chunk-7OXTIVNI.js.map
+//# sourceMappingURL=chunk-7OXTIVNI.js.map

package/dist/chunk-7OXTIVNI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"names":[],"mappings":";AAIO,IAAM,eAAA,GAAkB;AAExB,IAAM,aAAA,GAAgB;AAEtB,IAAM,iBAAA,GACX;AAEK,IAAM,iBAAA,GAAoB","file":"chunk-7OXTIVNI.js","sourcesContent":["/**\n * Topaz ID's PUBLIC Privy app id. This is the provider app id partners reference\n * to surface Topaz ID's global wallet — it is safe to ship in client code.\n */\nexport const TOPAZ_ID_APP_ID = \"cmpt1zsgh00rs0cld1hgqc0v7\";\n\nexport const TOPAZ_ID_NAME = \"Topaz ID\";\n\nexport const TOPAZ_ID_ICON_URL =\n  \"https://id.topazdex.com/brand/topaz-logo.png\";\n\nexport const TOPAZ_ID_BASE_URL = \"https://id.topazdex.com\";\n"]}

package/dist/chunk-NE4VWRG6.js

@@ -0,0 +1,26 @@
+import { TOPAZ_ID_BASE_URL } from './chunk-7OXTIVNI.js';
+
+// src/profile.ts
+async function fetchTopazIdProfile(wallet, options = {}) {
+  const base = options.baseUrl ?? TOPAZ_ID_BASE_URL;
+  const res = await fetch(`${base}/api/v1/profile/${wallet}`, {
+    signal: options.signal
+  });
+  if (!res.ok) return null;
+  return await res.json();
+}
+function shortenAddress(wallet) {
+  return `${wallet.slice(0, 6)}\u2026${wallet.slice(-4)}`;
+}
+function displayNameForWallet(profile, wallet) {
+  if (profile?.handle) return `@${profile.handle}`;
+  if (profile?.name) return profile.name;
+  return shortenAddress(wallet);
+}
+function avatarForWallet(profile, fallback = "") {
+  return profile?.image ?? fallback;
+}
+
+export { avatarForWallet, displayNameForWallet, fetchTopazIdProfile, shortenAddress };
+//# sourceMappingURL=chunk-NE4VWRG6.js.map
+//# sourceMappingURL=chunk-NE4VWRG6.js.map

package/dist/chunk-NE4VWRG6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/profile.ts"],"names":[],"mappings":";;;AAkCA,eAAsB,mBAAA,CACpB,MAAA,EACA,OAAA,GAAsC,EAAC,EACP;AAChC,EAAA,MAAM,IAAA,GAAO,QAAQ,OAAA,IAAW,iBAAA;AAChC,EAAA,MAAM,MAAM,MAAM,KAAA,CAAM,GAAG,IAAI,CAAA,gBAAA,EAAmB,MAAM,CAAA,CAAA,EAAI;AAAA,IAC1D,QAAQ,OAAA,CAAQ;AAAA,GACjB,CAAA;AACD,EAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,OAAO,IAAA;AACpB,EAAA,OAAQ,MAAM,IAAI,IAAA,EAAK;AACzB;AAEO,SAAS,eAAe,MAAA,EAAwB;AACrD,EAAA,OAAO,CAAA,EAAG,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,MAAA,EAAI,MAAA,CAAO,KAAA,CAAM,EAAE,CAAC,CAAA,CAAA;AAClD;AAGO,SAAS,oBAAA,CACd,SACA,MAAA,EACQ;AACR,EAAA,IAAI,OAAA,EAAS,MAAA,EAAQ,OAAO,CAAA,CAAA,EAAI,QAAQ,MAAM,CAAA,CAAA;AAC9C,EAAA,IAAI,OAAA,EAAS,IAAA,EAAM,OAAO,OAAA,CAAQ,IAAA;AAClC,EAAA,OAAO,eAAe,MAAM,CAAA;AAC9B;AAGO,SAAS,eAAA,CACd,OAAA,EACA,QAAA,GAAW,EAAA,EACH;AACR,EAAA,OAAO,SAAS,KAAA,IAAS,QAAA;AAC3B","file":"chunk-NE4VWRG6.js","sourcesContent":["import { TOPAZ_ID_BASE_URL } from \"./constants\";\n\n/** Public profile shape returned by `GET /api/v1/profile/{wallet}`. */\nexport interface TopazIdProfile {\n  wallet: string;\n  found: boolean;\n  name: string | null;\n  description: string | null;\n  handle: string | null;\n  /** Absolute avatar URL, or null when the wallet has no avatar. */\n  image: string | null;\n  /** Absolute banner URL, or null. */\n  banner: string | null;\n  /** \"#rrggbb\" accent, or null. */\n  accent: string | null;\n  theme: string;\n  links?: Record<string, unknown>;\n  showcase?: Record<string, unknown>;\n  followers?: number;\n  following?: number;\n  updatedAt: string | null;\n}\n\nexport interface FetchTopazIdProfileOptions {\n  /** Override the Topaz ID base URL (defaults to https://id.topazdex.com). */\n  baseUrl?: string;\n  signal?: AbortSignal;\n}\n\n/**\n * Fetch a wallet's public Topaz ID profile. Reads are public and CORS-open — no\n * auth, no signature. Returns `null` on a network/HTTP failure; a wallet with no\n * profile resolves to an object with `found: false`.\n */\nexport async function fetchTopazIdProfile(\n  wallet: string,\n  options: FetchTopazIdProfileOptions = {},\n): Promise<TopazIdProfile | null> {\n  const base = options.baseUrl ?? TOPAZ_ID_BASE_URL;\n  const res = await fetch(`${base}/api/v1/profile/${wallet}`, {\n    signal: options.signal,\n  });\n  if (!res.ok) return null;\n  return (await res.json()) as TopazIdProfile;\n}\n\nexport function shortenAddress(wallet: string): string {\n  return `${wallet.slice(0, 6)}…${wallet.slice(-4)}`;\n}\n\n/** Best display label: `@handle` → name → shortened address. */\nexport function displayNameForWallet(\n  profile: TopazIdProfile | null,\n  wallet: string,\n): string {\n  if (profile?.handle) return `@${profile.handle}`;\n  if (profile?.name) return profile.name;\n  return shortenAddress(wallet);\n}\n\n/** Avatar URL from the profile, or your `fallback` when there is none. */\nexport function avatarForWallet(\n  profile: TopazIdProfile | null,\n  fallback = \"\",\n): string {\n  return profile?.image ?? fallback;\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+// src/constants.ts
+var TOPAZ_ID_APP_ID = "cmpt1zsgh00rs0cld1hgqc0v7";
+var TOPAZ_ID_NAME = "Topaz ID";
+var TOPAZ_ID_ICON_URL = "https://id.topazdex.com/brand/topaz-logo.png";
+var TOPAZ_ID_BASE_URL = "https://id.topazdex.com";
+
+// src/profile.ts
+async function fetchTopazIdProfile(wallet, options = {}) {
+  const base = options.baseUrl ?? TOPAZ_ID_BASE_URL;
+  const res = await fetch(`${base}/api/v1/profile/${wallet}`, {
+    signal: options.signal
+  });
+  if (!res.ok) return null;
+  return await res.json();
+}
+function shortenAddress(wallet) {
+  return `${wallet.slice(0, 6)}\u2026${wallet.slice(-4)}`;
+}
+function displayNameForWallet(profile, wallet) {
+  if (profile?.handle) return `@${profile.handle}`;
+  if (profile?.name) return profile.name;
+  return shortenAddress(wallet);
+}
+function avatarForWallet(profile, fallback = "") {
+  return profile?.image ?? fallback;
+}
+
+exports.TOPAZ_ID_APP_ID = TOPAZ_ID_APP_ID;
+exports.TOPAZ_ID_BASE_URL = TOPAZ_ID_BASE_URL;
+exports.TOPAZ_ID_ICON_URL = TOPAZ_ID_ICON_URL;
+exports.TOPAZ_ID_NAME = TOPAZ_ID_NAME;
+exports.avatarForWallet = avatarForWallet;
+exports.displayNameForWallet = displayNameForWallet;
+exports.fetchTopazIdProfile = fetchTopazIdProfile;
+exports.shortenAddress = shortenAddress;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/profile.ts"],"names":[],"mappings":";;;AAIO,IAAM,eAAA,GAAkB;AAExB,IAAM,aAAA,GAAgB;AAEtB,IAAM,iBAAA,GACX;AAEK,IAAM,iBAAA,GAAoB;;;ACuBjC,eAAsB,mBAAA,CACpB,MAAA,EACA,OAAA,GAAsC,EAAC,EACP;AAChC,EAAA,MAAM,IAAA,GAAO,QAAQ,OAAA,IAAW,iBAAA;AAChC,EAAA,MAAM,MAAM,MAAM,KAAA,CAAM,GAAG,IAAI,CAAA,gBAAA,EAAmB,MAAM,CAAA,CAAA,EAAI;AAAA,IAC1D,QAAQ,OAAA,CAAQ;AAAA,GACjB,CAAA;AACD,EAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,OAAO,IAAA;AACpB,EAAA,OAAQ,MAAM,IAAI,IAAA,EAAK;AACzB;AAEO,SAAS,eAAe,MAAA,EAAwB;AACrD,EAAA,OAAO,CAAA,EAAG,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,MAAA,EAAI,MAAA,CAAO,KAAA,CAAM,EAAE,CAAC,CAAA,CAAA;AAClD;AAGO,SAAS,oBAAA,CACd,SACA,MAAA,EACQ;AACR,EAAA,IAAI,OAAA,EAAS,MAAA,EAAQ,OAAO,CAAA,CAAA,EAAI,QAAQ,MAAM,CAAA,CAAA;AAC9C,EAAA,IAAI,OAAA,EAAS,IAAA,EAAM,OAAO,OAAA,CAAQ,IAAA;AAClC,EAAA,OAAO,eAAe,MAAM,CAAA;AAC9B;AAGO,SAAS,eAAA,CACd,OAAA,EACA,QAAA,GAAW,EAAA,EACH;AACR,EAAA,OAAO,SAAS,KAAA,IAAS,QAAA;AAC3B","file":"index.cjs","sourcesContent":["/**\n * Topaz ID's PUBLIC Privy app id. This is the provider app id partners reference\n * to surface Topaz ID's global wallet — it is safe to ship in client code.\n */\nexport const TOPAZ_ID_APP_ID = \"cmpt1zsgh00rs0cld1hgqc0v7\";\n\nexport const TOPAZ_ID_NAME = \"Topaz ID\";\n\nexport const TOPAZ_ID_ICON_URL =\n  \"https://id.topazdex.com/brand/topaz-logo.png\";\n\nexport const TOPAZ_ID_BASE_URL = \"https://id.topazdex.com\";\n","import { TOPAZ_ID_BASE_URL } from \"./constants\";\n\n/** Public profile shape returned by `GET /api/v1/profile/{wallet}`. */\nexport interface TopazIdProfile {\n  wallet: string;\n  found: boolean;\n  name: string | null;\n  description: string | null;\n  handle: string | null;\n  /** Absolute avatar URL, or null when the wallet has no avatar. */\n  image: string | null;\n  /** Absolute banner URL, or null. */\n  banner: string | null;\n  /** \"#rrggbb\" accent, or null. */\n  accent: string | null;\n  theme: string;\n  links?: Record<string, unknown>;\n  showcase?: Record<string, unknown>;\n  followers?: number;\n  following?: number;\n  updatedAt: string | null;\n}\n\nexport interface FetchTopazIdProfileOptions {\n  /** Override the Topaz ID base URL (defaults to https://id.topazdex.com). */\n  baseUrl?: string;\n  signal?: AbortSignal;\n}\n\n/**\n * Fetch a wallet's public Topaz ID profile. Reads are public and CORS-open — no\n * auth, no signature. Returns `null` on a network/HTTP failure; a wallet with no\n * profile resolves to an object with `found: false`.\n */\nexport async function fetchTopazIdProfile(\n  wallet: string,\n  options: FetchTopazIdProfileOptions = {},\n): Promise<TopazIdProfile | null> {\n  const base = options.baseUrl ?? TOPAZ_ID_BASE_URL;\n  const res = await fetch(`${base}/api/v1/profile/${wallet}`, {\n    signal: options.signal,\n  });\n  if (!res.ok) return null;\n  return (await res.json()) as TopazIdProfile;\n}\n\nexport function shortenAddress(wallet: string): string {\n  return `${wallet.slice(0, 6)}…${wallet.slice(-4)}`;\n}\n\n/** Best display label: `@handle` → name → shortened address. */\nexport function displayNameForWallet(\n  profile: TopazIdProfile | null,\n  wallet: string,\n): string {\n  if (profile?.handle) return `@${profile.handle}`;\n  if (profile?.name) return profile.name;\n  return shortenAddress(wallet);\n}\n\n/** Avatar URL from the profile, or your `fallback` when there is none. */\nexport function avatarForWallet(\n  profile: TopazIdProfile | null,\n  fallback = \"\",\n): string {\n  return profile?.image ?? fallback;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+export { F as FetchTopazIdProfileOptions, T as TopazIdProfile, a as avatarForWallet, d as displayNameForWallet, f as fetchTopazIdProfile, s as shortenAddress } from './profile-C6bkM1cP.cjs';
+
+/**
+ * Topaz ID's PUBLIC Privy app id. This is the provider app id partners reference
+ * to surface Topaz ID's global wallet — it is safe to ship in client code.
+ */
+declare const TOPAZ_ID_APP_ID = "cmpt1zsgh00rs0cld1hgqc0v7";
+declare const TOPAZ_ID_NAME = "Topaz ID";
+declare const TOPAZ_ID_ICON_URL = "https://id.topazdex.com/brand/topaz-logo.png";
+declare const TOPAZ_ID_BASE_URL = "https://id.topazdex.com";
+
+export { TOPAZ_ID_APP_ID, TOPAZ_ID_BASE_URL, TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { F as FetchTopazIdProfileOptions, T as TopazIdProfile, a as avatarForWallet, d as displayNameForWallet, f as fetchTopazIdProfile, s as shortenAddress } from './profile-C6bkM1cP.js';
+
+/**
+ * Topaz ID's PUBLIC Privy app id. This is the provider app id partners reference
+ * to surface Topaz ID's global wallet — it is safe to ship in client code.
+ */
+declare const TOPAZ_ID_APP_ID = "cmpt1zsgh00rs0cld1hgqc0v7";
+declare const TOPAZ_ID_NAME = "Topaz ID";
+declare const TOPAZ_ID_ICON_URL = "https://id.topazdex.com/brand/topaz-logo.png";
+declare const TOPAZ_ID_BASE_URL = "https://id.topazdex.com";
+
+export { TOPAZ_ID_APP_ID, TOPAZ_ID_BASE_URL, TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME };

package/dist/index.js

@@ -0,0 +1,4 @@
+export { avatarForWallet, displayNameForWallet, fetchTopazIdProfile, shortenAddress } from './chunk-NE4VWRG6.js';
+export { TOPAZ_ID_APP_ID, TOPAZ_ID_BASE_URL, TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME } from './chunk-7OXTIVNI.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/profile-C6bkM1cP.d.cts

@@ -0,0 +1,38 @@
+/** Public profile shape returned by `GET /api/v1/profile/{wallet}`. */
+interface TopazIdProfile {
+    wallet: string;
+    found: boolean;
+    name: string | null;
+    description: string | null;
+    handle: string | null;
+    /** Absolute avatar URL, or null when the wallet has no avatar. */
+    image: string | null;
+    /** Absolute banner URL, or null. */
+    banner: string | null;
+    /** "#rrggbb" accent, or null. */
+    accent: string | null;
+    theme: string;
+    links?: Record<string, unknown>;
+    showcase?: Record<string, unknown>;
+    followers?: number;
+    following?: number;
+    updatedAt: string | null;
+}
+interface FetchTopazIdProfileOptions {
+    /** Override the Topaz ID base URL (defaults to https://id.topazdex.com). */
+    baseUrl?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Fetch a wallet's public Topaz ID profile. Reads are public and CORS-open — no
+ * auth, no signature. Returns `null` on a network/HTTP failure; a wallet with no
+ * profile resolves to an object with `found: false`.
+ */
+declare function fetchTopazIdProfile(wallet: string, options?: FetchTopazIdProfileOptions): Promise<TopazIdProfile | null>;
+declare function shortenAddress(wallet: string): string;
+/** Best display label: `@handle` → name → shortened address. */
+declare function displayNameForWallet(profile: TopazIdProfile | null, wallet: string): string;
+/** Avatar URL from the profile, or your `fallback` when there is none. */
+declare function avatarForWallet(profile: TopazIdProfile | null, fallback?: string): string;
+
+export { type FetchTopazIdProfileOptions as F, type TopazIdProfile as T, avatarForWallet as a, displayNameForWallet as d, fetchTopazIdProfile as f, shortenAddress as s };

package/dist/profile-C6bkM1cP.d.ts

@@ -0,0 +1,38 @@
+/** Public profile shape returned by `GET /api/v1/profile/{wallet}`. */
+interface TopazIdProfile {
+    wallet: string;
+    found: boolean;
+    name: string | null;
+    description: string | null;
+    handle: string | null;
+    /** Absolute avatar URL, or null when the wallet has no avatar. */
+    image: string | null;
+    /** Absolute banner URL, or null. */
+    banner: string | null;
+    /** "#rrggbb" accent, or null. */
+    accent: string | null;
+    theme: string;
+    links?: Record<string, unknown>;
+    showcase?: Record<string, unknown>;
+    followers?: number;
+    following?: number;
+    updatedAt: string | null;
+}
+interface FetchTopazIdProfileOptions {
+    /** Override the Topaz ID base URL (defaults to https://id.topazdex.com). */
+    baseUrl?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Fetch a wallet's public Topaz ID profile. Reads are public and CORS-open — no
+ * auth, no signature. Returns `null` on a network/HTTP failure; a wallet with no
+ * profile resolves to an object with `found: false`.
+ */
+declare function fetchTopazIdProfile(wallet: string, options?: FetchTopazIdProfileOptions): Promise<TopazIdProfile | null>;
+declare function shortenAddress(wallet: string): string;
+/** Best display label: `@handle` → name → shortened address. */
+declare function displayNameForWallet(profile: TopazIdProfile | null, wallet: string): string;
+/** Avatar URL from the profile, or your `fallback` when there is none. */
+declare function avatarForWallet(profile: TopazIdProfile | null, fallback?: string): string;
+
+export { type FetchTopazIdProfileOptions as F, type TopazIdProfile as T, avatarForWallet as a, displayNameForWallet as d, fetchTopazIdProfile as f, shortenAddress as s };

package/dist/rainbow-kit.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var rainbowKit = require('@privy-io/cross-app-connect/rainbow-kit');
+var chains = require('viem/chains');
+
+// src/rainbow-kit.ts
+
+// src/constants.ts
+var TOPAZ_ID_APP_ID = "cmpt1zsgh00rs0cld1hgqc0v7";
+var TOPAZ_ID_NAME = "Topaz ID";
+var TOPAZ_ID_ICON_URL = "https://id.topazdex.com/brand/topaz-logo.png";
+
+// src/rainbow-kit.ts
+var TOPAZ_ID_CHAIN = chains.bsc;
+function topazIdWallet(options = {}) {
+  return rainbowKit.toPrivyWallet({
+    id: options.appId ?? TOPAZ_ID_APP_ID,
+    name: TOPAZ_ID_NAME,
+    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL
+  });
+}
+function topazIdConnector(options = {}) {
+  return rainbowKit.toPrivyWalletConnector({
+    id: options.appId ?? TOPAZ_ID_APP_ID,
+    name: TOPAZ_ID_NAME,
+    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL
+  });
+}
+
+exports.TOPAZ_ID_CHAIN = TOPAZ_ID_CHAIN;
+exports.topazIdConnector = topazIdConnector;
+exports.topazIdWallet = topazIdWallet;
+//# sourceMappingURL=rainbow-kit.cjs.map
+//# sourceMappingURL=rainbow-kit.cjs.map

package/dist/rainbow-kit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/rainbow-kit.ts"],"names":["bsc","toPrivyWallet","toPrivyWalletConnector"],"mappings":";;;;;;;;AAIO,IAAM,eAAA,GAAkB,2BAAA;AAExB,IAAM,aAAA,GAAgB,UAAA;AAEtB,IAAM,iBAAA,GACX,8CAAA;;;ACDK,IAAM,cAAA,GAAiBA;AAmBvB,SAAS,aAAA,CAAc,OAAA,GAAmC,EAAC,EAAG;AACnE,EAAA,OAAOC,wBAAA,CAAc;AAAA,IACnB,EAAA,EAAI,QAAQ,KAAA,IAAS,eAAA;AAAA,IACrB,IAAA,EAAM,aAAA;AAAA,IACN,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA,GAC7B,CAAA;AACH;AAMO,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAG;AACtE,EAAA,OAAOC,iCAAA,CAAuB;AAAA,IAC5B,EAAA,EAAI,QAAQ,KAAA,IAAS,eAAA;AAAA,IACrB,IAAA,EAAM,aAAA;AAAA,IACN,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA,GAC7B,CAAA;AACH","file":"rainbow-kit.cjs","sourcesContent":["/**\n * Topaz ID's PUBLIC Privy app id. This is the provider app id partners reference\n * to surface Topaz ID's global wallet — it is safe to ship in client code.\n */\nexport const TOPAZ_ID_APP_ID = \"cmpt1zsgh00rs0cld1hgqc0v7\";\n\nexport const TOPAZ_ID_NAME = \"Topaz ID\";\n\nexport const TOPAZ_ID_ICON_URL =\n  \"https://id.topazdex.com/brand/topaz-logo.png\";\n\nexport const TOPAZ_ID_BASE_URL = \"https://id.topazdex.com\";\n","import {\n  toPrivyWallet,\n  toPrivyWalletConnector,\n} from \"@privy-io/cross-app-connect/rainbow-kit\";\nimport { bsc } from \"viem/chains\";\nimport { TOPAZ_ID_APP_ID, TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME } from \"./constants\";\n\n/** BNB Chain (id 56) — the chain Topaz ID wallets operate on. */\nexport const TOPAZ_ID_CHAIN = bsc;\n\nexport interface TopazIdConnectorOptions {\n  /** Override Topaz ID's app id (e.g. to target a staging app). */\n  appId?: string;\n  /** Override the wallet icon shown in the picker. */\n  iconUrl?: string;\n}\n\n/**\n * A RainbowKit wallet for Topaz ID. Drop into `connectorsForWallets`:\n *\n * ```ts\n * connectorsForWallets(\n *   [{ groupName: \"Sign in\", wallets: [topazIdWallet()] }],\n *   { appName: \"Your App\", projectId: WC_PROJECT_ID },\n * );\n * ```\n */\nexport function topazIdWallet(options: TopazIdConnectorOptions = {}) {\n  return toPrivyWallet({\n    id: options.appId ?? TOPAZ_ID_APP_ID,\n    name: TOPAZ_ID_NAME,\n    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL,\n  });\n}\n\n/**\n * A plain wagmi connector for Topaz ID — no RainbowKit required. Add to\n * `createConfig({ connectors: [topazIdConnector()] })`.\n */\nexport function topazIdConnector(options: TopazIdConnectorOptions = {}) {\n  return toPrivyWalletConnector({\n    id: options.appId ?? TOPAZ_ID_APP_ID,\n    name: TOPAZ_ID_NAME,\n    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL,\n  });\n}\n"]}

package/dist/rainbow-kit.d.cts

@@ -0,0 +1,80 @@
+import * as wagmi from 'wagmi';
+import * as _rainbow_me_rainbowkit from '@rainbow-me/rainbowkit';
+import * as viem from 'viem';
+
+/** BNB Chain (id 56) — the chain Topaz ID wallets operate on. */
+declare const TOPAZ_ID_CHAIN: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "BscScan";
+            readonly url: "https://bscscan.com";
+            readonly apiUrl: "https://api.bscscan.com/api";
+        };
+    };
+    blockTime: 750;
+    contracts: {
+        readonly multicall3: {
+            readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+            readonly blockCreated: 15921452;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 56;
+    name: "BNB Smart Chain";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "BNB";
+        readonly symbol: "BNB";
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://56.rpc.thirdweb.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        client: viem.Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        client: viem.Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+interface TopazIdConnectorOptions {
+    /** Override Topaz ID's app id (e.g. to target a staging app). */
+    appId?: string;
+    /** Override the wallet icon shown in the picker. */
+    iconUrl?: string;
+}
+/**
+ * A RainbowKit wallet for Topaz ID. Drop into `connectorsForWallets`:
+ *
+ * ```ts
+ * connectorsForWallets(
+ *   [{ groupName: "Sign in", wallets: [topazIdWallet()] }],
+ *   { appName: "Your App", projectId: WC_PROJECT_ID },
+ * );
+ * ```
+ */
+declare function topazIdWallet(options?: TopazIdConnectorOptions): () => _rainbow_me_rainbowkit.Wallet;
+/**
+ * A plain wagmi connector for Topaz ID — no RainbowKit required. Add to
+ * `createConfig({ connectors: [topazIdConnector()] })`.
+ */
+declare function topazIdConnector(options?: TopazIdConnectorOptions): wagmi.CreateConnectorFn<{
+    on: <event extends keyof viem.EIP1193EventMap>(event: event, listener: viem.EIP1193EventMap[event]) => void;
+    removeListener: <event extends keyof viem.EIP1193EventMap>(event: event, listener: viem.EIP1193EventMap[event]) => void;
+    request: viem.EIP1193RequestFn<viem.EIP1474Methods>;
+}, Record<string, unknown>, Record<string, unknown>>;
+
+export { TOPAZ_ID_CHAIN, type TopazIdConnectorOptions, topazIdConnector, topazIdWallet };

package/dist/rainbow-kit.d.ts

@@ -0,0 +1,80 @@
+import * as wagmi from 'wagmi';
+import * as _rainbow_me_rainbowkit from '@rainbow-me/rainbowkit';
+import * as viem from 'viem';
+
+/** BNB Chain (id 56) — the chain Topaz ID wallets operate on. */
+declare const TOPAZ_ID_CHAIN: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "BscScan";
+            readonly url: "https://bscscan.com";
+            readonly apiUrl: "https://api.bscscan.com/api";
+        };
+    };
+    blockTime: 750;
+    contracts: {
+        readonly multicall3: {
+            readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+            readonly blockCreated: 15921452;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 56;
+    name: "BNB Smart Chain";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "BNB";
+        readonly symbol: "BNB";
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://56.rpc.thirdweb.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        client: viem.Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        client: viem.Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+interface TopazIdConnectorOptions {
+    /** Override Topaz ID's app id (e.g. to target a staging app). */
+    appId?: string;
+    /** Override the wallet icon shown in the picker. */
+    iconUrl?: string;
+}
+/**
+ * A RainbowKit wallet for Topaz ID. Drop into `connectorsForWallets`:
+ *
+ * ```ts
+ * connectorsForWallets(
+ *   [{ groupName: "Sign in", wallets: [topazIdWallet()] }],
+ *   { appName: "Your App", projectId: WC_PROJECT_ID },
+ * );
+ * ```
+ */
+declare function topazIdWallet(options?: TopazIdConnectorOptions): () => _rainbow_me_rainbowkit.Wallet;
+/**
+ * A plain wagmi connector for Topaz ID — no RainbowKit required. Add to
+ * `createConfig({ connectors: [topazIdConnector()] })`.
+ */
+declare function topazIdConnector(options?: TopazIdConnectorOptions): wagmi.CreateConnectorFn<{
+    on: <event extends keyof viem.EIP1193EventMap>(event: event, listener: viem.EIP1193EventMap[event]) => void;
+    removeListener: <event extends keyof viem.EIP1193EventMap>(event: event, listener: viem.EIP1193EventMap[event]) => void;
+    request: viem.EIP1193RequestFn<viem.EIP1474Methods>;
+}, Record<string, unknown>, Record<string, unknown>>;
+
+export { TOPAZ_ID_CHAIN, type TopazIdConnectorOptions, topazIdConnector, topazIdWallet };

package/dist/rainbow-kit.js

@@ -0,0 +1,23 @@
+import { TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME, TOPAZ_ID_APP_ID } from './chunk-7OXTIVNI.js';
+import { toPrivyWallet, toPrivyWalletConnector } from '@privy-io/cross-app-connect/rainbow-kit';
+import { bsc } from 'viem/chains';
+
+var TOPAZ_ID_CHAIN = bsc;
+function topazIdWallet(options = {}) {
+  return toPrivyWallet({
+    id: options.appId ?? TOPAZ_ID_APP_ID,
+    name: TOPAZ_ID_NAME,
+    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL
+  });
+}
+function topazIdConnector(options = {}) {
+  return toPrivyWalletConnector({
+    id: options.appId ?? TOPAZ_ID_APP_ID,
+    name: TOPAZ_ID_NAME,
+    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL
+  });
+}
+
+export { TOPAZ_ID_CHAIN, topazIdConnector, topazIdWallet };
+//# sourceMappingURL=rainbow-kit.js.map
+//# sourceMappingURL=rainbow-kit.js.map

package/dist/rainbow-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rainbow-kit.ts"],"names":[],"mappings":";;;;AAQO,IAAM,cAAA,GAAiB;AAmBvB,SAAS,aAAA,CAAc,OAAA,GAAmC,EAAC,EAAG;AACnE,EAAA,OAAO,aAAA,CAAc;AAAA,IACnB,EAAA,EAAI,QAAQ,KAAA,IAAS,eAAA;AAAA,IACrB,IAAA,EAAM,aAAA;AAAA,IACN,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA,GAC7B,CAAA;AACH;AAMO,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAG;AACtE,EAAA,OAAO,sBAAA,CAAuB;AAAA,IAC5B,EAAA,EAAI,QAAQ,KAAA,IAAS,eAAA;AAAA,IACrB,IAAA,EAAM,aAAA;AAAA,IACN,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA,GAC7B,CAAA;AACH","file":"rainbow-kit.js","sourcesContent":["import {\n  toPrivyWallet,\n  toPrivyWalletConnector,\n} from \"@privy-io/cross-app-connect/rainbow-kit\";\nimport { bsc } from \"viem/chains\";\nimport { TOPAZ_ID_APP_ID, TOPAZ_ID_ICON_URL, TOPAZ_ID_NAME } from \"./constants\";\n\n/** BNB Chain (id 56) — the chain Topaz ID wallets operate on. */\nexport const TOPAZ_ID_CHAIN = bsc;\n\nexport interface TopazIdConnectorOptions {\n  /** Override Topaz ID's app id (e.g. to target a staging app). */\n  appId?: string;\n  /** Override the wallet icon shown in the picker. */\n  iconUrl?: string;\n}\n\n/**\n * A RainbowKit wallet for Topaz ID. Drop into `connectorsForWallets`:\n *\n * ```ts\n * connectorsForWallets(\n *   [{ groupName: \"Sign in\", wallets: [topazIdWallet()] }],\n *   { appName: \"Your App\", projectId: WC_PROJECT_ID },\n * );\n * ```\n */\nexport function topazIdWallet(options: TopazIdConnectorOptions = {}) {\n  return toPrivyWallet({\n    id: options.appId ?? TOPAZ_ID_APP_ID,\n    name: TOPAZ_ID_NAME,\n    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL,\n  });\n}\n\n/**\n * A plain wagmi connector for Topaz ID — no RainbowKit required. Add to\n * `createConfig({ connectors: [topazIdConnector()] })`.\n */\nexport function topazIdConnector(options: TopazIdConnectorOptions = {}) {\n  return toPrivyWalletConnector({\n    id: options.appId ?? TOPAZ_ID_APP_ID,\n    name: TOPAZ_ID_NAME,\n    iconUrl: options.iconUrl ?? TOPAZ_ID_ICON_URL,\n  });\n}\n"]}

package/dist/react.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+var reactQuery = require('@tanstack/react-query');
+
+// src/react.ts
+
+// src/constants.ts
+var TOPAZ_ID_BASE_URL = "https://id.topazdex.com";
+
+// src/profile.ts
+async function fetchTopazIdProfile(wallet, options = {}) {
+  const base = options.baseUrl ?? TOPAZ_ID_BASE_URL;
+  const res = await fetch(`${base}/api/v1/profile/${wallet}`, {
+    signal: options.signal
+  });
+  if (!res.ok) return null;
+  return await res.json();
+}
+
+// src/react.ts
+function useTopazIdProfile(wallet, options = {}) {
+  return reactQuery.useQuery({
+    queryKey: ["topaz-id-profile", wallet?.toLowerCase()],
+    queryFn: ({ signal }) => fetchTopazIdProfile(wallet, {
+      baseUrl: options.baseUrl,
+      signal
+    }),
+    enabled: Boolean(wallet),
+    staleTime: options.staleTime ?? 6e4
+  });
+}
+
+exports.useTopazIdProfile = useTopazIdProfile;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/profile.ts","../src/react.ts"],"names":["useQuery"],"mappings":";;;;;;;AAWO,IAAM,iBAAA,GAAoB,yBAAA;;;ACuBjC,eAAsB,mBAAA,CACpB,MAAA,EACA,OAAA,GAAsC,EAAC,EACP;AAChC,EAAA,MAAM,IAAA,GAAO,QAAQ,OAAA,IAAW,iBAAA;AAChC,EAAA,MAAM,MAAM,MAAM,KAAA,CAAM,GAAG,IAAI,CAAA,gBAAA,EAAmB,MAAM,CAAA,CAAA,EAAI;AAAA,IAC1D,QAAQ,OAAA,CAAQ;AAAA,GACjB,CAAA;AACD,EAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,OAAO,IAAA;AACpB,EAAA,OAAQ,MAAM,IAAI,IAAA,EAAK;AACzB;;;AChCO,SAAS,iBAAA,CACd,MAAA,EACA,OAAA,GAAoC,EAAC,EACrC;AACA,EAAA,OAAOA,mBAAA,CAAgC;AAAA,IACrC,QAAA,EAAU,CAAC,kBAAA,EAAoB,MAAA,EAAQ,aAAa,CAAA;AAAA,IACpD,SAAS,CAAC,EAAE,MAAA,EAAO,KACjB,oBAAoB,MAAA,EAAkB;AAAA,MACpC,SAAS,OAAA,CAAQ,OAAA;AAAA,MACjB;AAAA,KACD,CAAA;AAAA,IACH,OAAA,EAAS,QAAQ,MAAM,CAAA;AAAA,IACvB,SAAA,EAAW,QAAQ,SAAA,IAAa;AAAA,GACjC,CAAA;AACH","file":"react.cjs","sourcesContent":["/**\n * Topaz ID's PUBLIC Privy app id. This is the provider app id partners reference\n * to surface Topaz ID's global wallet — it is safe to ship in client code.\n */\nexport const TOPAZ_ID_APP_ID = \"cmpt1zsgh00rs0cld1hgqc0v7\";\n\nexport const TOPAZ_ID_NAME = \"Topaz ID\";\n\nexport const TOPAZ_ID_ICON_URL =\n  \"https://id.topazdex.com/brand/topaz-logo.png\";\n\nexport const TOPAZ_ID_BASE_URL = \"https://id.topazdex.com\";\n","import { TOPAZ_ID_BASE_URL } from \"./constants\";\n\n/** Public profile shape returned by `GET /api/v1/profile/{wallet}`. */\nexport interface TopazIdProfile {\n  wallet: string;\n  found: boolean;\n  name: string | null;\n  description: string | null;\n  handle: string | null;\n  /** Absolute avatar URL, or null when the wallet has no avatar. */\n  image: string | null;\n  /** Absolute banner URL, or null. */\n  banner: string | null;\n  /** \"#rrggbb\" accent, or null. */\n  accent: string | null;\n  theme: string;\n  links?: Record<string, unknown>;\n  showcase?: Record<string, unknown>;\n  followers?: number;\n  following?: number;\n  updatedAt: string | null;\n}\n\nexport interface FetchTopazIdProfileOptions {\n  /** Override the Topaz ID base URL (defaults to https://id.topazdex.com). */\n  baseUrl?: string;\n  signal?: AbortSignal;\n}\n\n/**\n * Fetch a wallet's public Topaz ID profile. Reads are public and CORS-open — no\n * auth, no signature. Returns `null` on a network/HTTP failure; a wallet with no\n * profile resolves to an object with `found: false`.\n */\nexport async function fetchTopazIdProfile(\n  wallet: string,\n  options: FetchTopazIdProfileOptions = {},\n): Promise<TopazIdProfile | null> {\n  const base = options.baseUrl ?? TOPAZ_ID_BASE_URL;\n  const res = await fetch(`${base}/api/v1/profile/${wallet}`, {\n    signal: options.signal,\n  });\n  if (!res.ok) return null;\n  return (await res.json()) as TopazIdProfile;\n}\n\nexport function shortenAddress(wallet: string): string {\n  return `${wallet.slice(0, 6)}…${wallet.slice(-4)}`;\n}\n\n/** Best display label: `@handle` → name → shortened address. */\nexport function displayNameForWallet(\n  profile: TopazIdProfile | null,\n  wallet: string,\n): string {\n  if (profile?.handle) return `@${profile.handle}`;\n  if (profile?.name) return profile.name;\n  return shortenAddress(wallet);\n}\n\n/** Avatar URL from the profile, or your `fallback` when there is none. */\nexport function avatarForWallet(\n  profile: TopazIdProfile | null,\n  fallback = \"\",\n): string {\n  return profile?.image ?? fallback;\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { fetchTopazIdProfile, type TopazIdProfile } from \"./profile\";\n\nexport interface UseTopazIdProfileOptions {\n  baseUrl?: string;\n  staleTime?: number;\n}\n\n/**\n * React Query hook for a wallet's Topaz ID profile. Disabled until `wallet` is\n * defined; cached per lowercased address.\n */\nexport function useTopazIdProfile(\n  wallet: string | undefined,\n  options: UseTopazIdProfileOptions = {},\n) {\n  return useQuery<TopazIdProfile | null>({\n    queryKey: [\"topaz-id-profile\", wallet?.toLowerCase()],\n    queryFn: ({ signal }) =>\n      fetchTopazIdProfile(wallet as string, {\n        baseUrl: options.baseUrl,\n        signal,\n      }),\n    enabled: Boolean(wallet),\n    staleTime: options.staleTime ?? 60_000,\n  });\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,14 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { T as TopazIdProfile } from './profile-C6bkM1cP.cjs';
+
+interface UseTopazIdProfileOptions {
+    baseUrl?: string;
+    staleTime?: number;
+}
+/**
+ * React Query hook for a wallet's Topaz ID profile. Disabled until `wallet` is
+ * defined; cached per lowercased address.
+ */
+declare function useTopazIdProfile(wallet: string | undefined, options?: UseTopazIdProfileOptions): _tanstack_react_query.UseQueryResult<NoInfer<TopazIdProfile | null>, Error>;
+
+export { type UseTopazIdProfileOptions, useTopazIdProfile };

package/dist/react.d.ts

@@ -0,0 +1,14 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { T as TopazIdProfile } from './profile-C6bkM1cP.js';
+
+interface UseTopazIdProfileOptions {
+    baseUrl?: string;
+    staleTime?: number;
+}
+/**
+ * React Query hook for a wallet's Topaz ID profile. Disabled until `wallet` is
+ * defined; cached per lowercased address.
+ */
+declare function useTopazIdProfile(wallet: string | undefined, options?: UseTopazIdProfileOptions): _tanstack_react_query.UseQueryResult<NoInfer<TopazIdProfile | null>, Error>;
+
+export { type UseTopazIdProfileOptions, useTopazIdProfile };

package/dist/react.js

@@ -0,0 +1,19 @@
+import { fetchTopazIdProfile } from './chunk-NE4VWRG6.js';
+import './chunk-7OXTIVNI.js';
+import { useQuery } from '@tanstack/react-query';
+
+function useTopazIdProfile(wallet, options = {}) {
+  return useQuery({
+    queryKey: ["topaz-id-profile", wallet?.toLowerCase()],
+    queryFn: ({ signal }) => fetchTopazIdProfile(wallet, {
+      baseUrl: options.baseUrl,
+      signal
+    }),
+    enabled: Boolean(wallet),
+    staleTime: options.staleTime ?? 6e4
+  });
+}
+
+export { useTopazIdProfile };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"names":[],"mappings":";;;;AAYO,SAAS,iBAAA,CACd,MAAA,EACA,OAAA,GAAoC,EAAC,EACrC;AACA,EAAA,OAAO,QAAA,CAAgC;AAAA,IACrC,QAAA,EAAU,CAAC,kBAAA,EAAoB,MAAA,EAAQ,aAAa,CAAA;AAAA,IACpD,SAAS,CAAC,EAAE,MAAA,EAAO,KACjB,oBAAoB,MAAA,EAAkB;AAAA,MACpC,SAAS,OAAA,CAAQ,OAAA;AAAA,MACjB;AAAA,KACD,CAAA;AAAA,IACH,OAAA,EAAS,QAAQ,MAAM,CAAA;AAAA,IACvB,SAAA,EAAW,QAAQ,SAAA,IAAa;AAAA,GACjC,CAAA;AACH","file":"react.js","sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { fetchTopazIdProfile, type TopazIdProfile } from \"./profile\";\n\nexport interface UseTopazIdProfileOptions {\n  baseUrl?: string;\n  staleTime?: number;\n}\n\n/**\n * React Query hook for a wallet's Topaz ID profile. Disabled until `wallet` is\n * defined; cached per lowercased address.\n */\nexport function useTopazIdProfile(\n  wallet: string | undefined,\n  options: UseTopazIdProfileOptions = {},\n) {\n  return useQuery<TopazIdProfile | null>({\n    queryKey: [\"topaz-id-profile\", wallet?.toLowerCase()],\n    queryFn: ({ signal }) =>\n      fetchTopazIdProfile(wallet as string, {\n        baseUrl: options.baseUrl,\n        signal,\n      }),\n    enabled: Boolean(wallet),\n    staleTime: options.staleTime ?? 60_000,\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@topazdex/id-connect",
+  "version": "0.1.0",
+  "description": "Add Topaz ID — a BNB Chain global wallet — to your dapp in one line.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "packageManager": "yarn@4.12.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/topazdex/topaz-id-connect.git"
+  },
+  "bugs": {
+    "url": "https://github.com/topazdex/topaz-id-connect/issues"
+  },
+  "homepage": "https://id.topazdex.com/developers",
+  "keywords": [
+    "topaz",
+    "topaz-id",
+    "privy",
+    "global-wallet",
+    "cross-app",
+    "wagmi",
+    "rainbowkit",
+    "bnb-chain",
+    "wallet"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./rainbow-kit": {
+      "types": "./dist/rainbow-kit.d.ts",
+      "import": "./dist/rainbow-kit.js",
+      "require": "./dist/rainbow-kit.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "yarn build"
+  },
+  "peerDependencies": {
+    "@privy-io/cross-app-connect": "^0.5.0",
+    "@rainbow-me/rainbowkit": "^2.2.3",
+    "@tanstack/react-query": "^5",
+    "react": "^18 || ^19",
+    "viem": "^2",
+    "wagmi": "^2"
+  },
+  "peerDependenciesMeta": {
+    "@rainbow-me/rainbowkit": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    },
+    "wagmi": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@privy-io/cross-app-connect": "^0.5.12",
+    "@rainbow-me/rainbowkit": "^2.2.3",
+    "@tanstack/react-query": "^5.59.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "viem": "2.52.0",
+    "wagmi": "^2.14.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}