@qorechain/qorex-rainbowkit 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work, excluding
+          those notices that do not pertain to any part of the Derivative
+          Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one of
+          the following places: within a NOTICE text file distributed as
+          part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and do
+          not modify the License. You may add Your own attribution notices
+          within Derivative Works that You distribute, alongside or as an
+          addendum to the NOTICE text from the Work, provided that such
+          additional attribution notices cannot be construed as modifying
+          the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 QoreChain Association
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @qorechain/qorex-rainbowkit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+QoreX as a RainbowKit wallet, plus viem chain definitions for the QoreChain EVM lane.
+
+```bash
+npm install @qorechain/qorex-rainbowkit @rainbow-me/rainbowkit wagmi viem @tanstack/react-query
+```
+
+```ts
+import { connectorsForWallets } from "@rainbow-me/rainbowkit";
+import { metaMaskWallet } from "@rainbow-me/rainbowkit/wallets";
+import { createConfig, http } from "wagmi";
+import { QOREX_CHAINS, qorechain, qorechainTestnet, qorexWallet } from "@qorechain/qorex-rainbowkit";
+
+const connectors = connectorsForWallets(
+  [{ groupName: "Recommended", wallets: [qorexWallet, metaMaskWallet] }],
+  { appName: "My dApp", projectId: "<walletconnect project id>" },
+);
+
+export const config = createConfig({
+  chains: QOREX_CHAINS,
+  connectors,
+  transports: { [qorechain.id]: http(), [qorechainTestnet.id]: http() },
+});
+```
+
+- `qorexWallet()` returns a RainbowKit `Wallet` (id `qorex`, rdns `network.qore.qorex`). Its connector is wagmi's injected connector pinned to the provider QoreX announces through EIP-6963; it never falls back to `window.ethereum`. When QoreX is not installed, RainbowKit shows the store links.
+- `QOREX_CHAINS` is `[qorechain, qorechainTestnet]`: EVM chain ids 9801 and 9800, RPC `https://evm.qore.host` and `https://evm-testnet.qore.host`, native currency QOR with 18 decimals, explorer `https://explore.qore.network`.
+
+## Account and network changes
+
+QoreX does not emit `accountsChanged` or `chainChanged` yet, so wagmi does not see a change made in the wallet. Opt in to a re-read when the page regains focus:
+
+```ts
+wallets: [() => qorexWallet({ pollAccountsOnFocus: true })]
+```
+
+While connected, the connector reads `eth_accounts` and `eth_chainId` on `focus` and `visibilitychange` and reports a change to wagmi. An empty account list (wallet locked or site disconnected) disconnects.
+
+## What QoreX answers on EVM today
+
+`eth_chainId`, `eth_accounts`, `eth_requestAccounts`, and `wallet_switchEthereumChain` for the network selected in QoreX (others reject with code 4902). Signing methods such as `personal_sign`, `eth_signTypedData_v4` and `eth_sendTransaction`, and `wallet_addEthereumChain`, are not supported yet and reject with "QoreX: EVM method ... not yet supported".
+
+On QoreChain, an EVM transaction is accepted only when the sender has a registered ML-DSA-87 key and an open EVM authorization window, both set up from the native lane.
+
+Guides: <https://github.com/qorechain/qorex-integrations>.
+
+Apache-2.0. Copyright 2026 QoreChain Association.

package/dist/index.cjs

@@ -0,0 +1,177 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/wallet.ts
+var _wagmi = require('wagmi');
+
+
+
+
+
+var _qorextypes = require('@qorechain/qorex-types');
+var _icon = require('@qorechain/qorex-types/icon');
+var QOREX_ICON_BACKGROUND = "#EEE9FB";
+function getQorexEip1193Provider() {
+  const announced = _qorextypes.findQorexEip1193.call(void 0, );
+  if (announced) return announced;
+  if (typeof window === "undefined") return void 0;
+  const evm = _optionalChain([window, 'access', _ => _.qorex, 'optionalAccess', _2 => _2.evm]);
+  return evm && evm.isQoreX === true && typeof evm.request === "function" ? evm : void 0;
+}
+function createQorexConnector(walletDetails, options = {}) {
+  const { id, name } = walletDetails.rkDetails;
+  let cached;
+  const provider = () => cached ??= getQorexEip1193Provider();
+  return _wagmi.createConnector.call(void 0, (config) => {
+    const base = _wagmi.injected.call(void 0, {
+      shimDisconnect: true,
+      // An object target: wagmi then never substitutes window.ethereum.
+      target: { id, name, icon: _icon.QOREX_ICON_DATA_URI, provider }
+    })(config);
+    let stopPolling;
+    const startPolling = (connector2, accounts, chainId) => {
+      if (options.pollAccountsOnFocus !== true || typeof window === "undefined") return;
+      _optionalChain([stopPolling, 'optionalCall', _3 => _3()]);
+      let lastAccounts = accounts.map((a) => a.toLowerCase()).join(",");
+      let lastChainId = chainId;
+      let running = false;
+      const check = async () => {
+        if (running) return;
+        running = true;
+        try {
+          const p = provider();
+          if (!p) return;
+          const nextAccounts = await p.request({ method: "eth_accounts" });
+          const nextChainHex = await p.request({ method: "eth_chainId" });
+          const accountsKey = nextAccounts.map((a) => a.toLowerCase()).join(",");
+          const nextChainId = Number(nextChainHex);
+          if (accountsKey !== lastAccounts) {
+            lastAccounts = accountsKey;
+            connector2.onAccountsChanged(nextAccounts);
+          }
+          if (Number.isFinite(nextChainId) && nextChainId !== lastChainId) {
+            lastChainId = nextChainId;
+            connector2.onChainChanged(nextChainHex);
+          }
+        } catch (e) {
+        } finally {
+          running = false;
+        }
+      };
+      const onFocus = () => void check();
+      const onVisibility = () => {
+        if (document.visibilityState === "visible") void check();
+      };
+      window.addEventListener("focus", onFocus);
+      document.addEventListener("visibilitychange", onVisibility);
+      stopPolling = () => {
+        window.removeEventListener("focus", onFocus);
+        document.removeEventListener("visibilitychange", onVisibility);
+        stopPolling = void 0;
+      };
+    };
+    const connect = async function(parameters) {
+      const result = await base.connect.call(this, parameters);
+      const accounts = result.accounts.map(
+        (a) => typeof a === "string" ? a : a.address
+      );
+      startPolling(this, accounts, result.chainId);
+      return result;
+    };
+    const connector = {
+      ...base,
+      rdns: _qorextypes.QOREX_RDNS,
+      connect,
+      async disconnect() {
+        _optionalChain([stopPolling, 'optionalCall', _4 => _4()]);
+        await base.disconnect.call(this);
+      }
+    };
+    return { ...connector, ...walletDetails };
+  });
+}
+function qorexWallet(options = {}) {
+  const connectorOptions = { pollAccountsOnFocus: options.pollAccountsOnFocus === true };
+  return {
+    id: "qorex",
+    name: _qorextypes.QOREX_NAME,
+    rdns: _qorextypes.QOREX_RDNS,
+    iconUrl: _icon.QOREX_ICON_DATA_URI,
+    iconBackground: QOREX_ICON_BACKGROUND,
+    installed: typeof window === "undefined" ? void 0 : getQorexEip1193Provider() !== void 0,
+    downloadUrls: {
+      chrome: _qorextypes.QOREX_DOWNLOAD_URLS.chrome,
+      edge: _qorextypes.QOREX_DOWNLOAD_URLS.chrome,
+      opera: _qorextypes.QOREX_DOWNLOAD_URLS.chrome,
+      firefox: _qorextypes.QOREX_DOWNLOAD_URLS.firefox,
+      safari: _qorextypes.QOREX_DOWNLOAD_URLS.safari,
+      macos: _qorextypes.QOREX_DOWNLOAD_URLS.safari,
+      browserExtension: _qorextypes.QOREX_DOWNLOAD_URLS.chrome,
+      ios: _qorextypes.QOREX_DOWNLOAD_URLS.ios,
+      android: _qorextypes.QOREX_DOWNLOAD_URLS.android,
+      mobile: _qorextypes.QOREX_DOWNLOAD_URLS.website,
+      qrCode: _qorextypes.QOREX_DOWNLOAD_URLS.website
+    },
+    extension: {
+      instructions: {
+        learnMoreUrl: _qorextypes.QOREX_DOWNLOAD_URLS.website,
+        steps: [
+          {
+            step: "install",
+            title: "Install the QoreX extension",
+            description: "Add QoreX to your browser and pin it to the toolbar so you can open it quickly."
+          },
+          {
+            step: "create",
+            title: "Create or import a wallet",
+            description: "Write down your recovery phrase and keep it offline. Never share it with anyone."
+          },
+          {
+            step: "refresh",
+            title: "Refresh this page",
+            description: "After setting up QoreX, refresh the page so it can find the extension."
+          }
+        ]
+      }
+    },
+    createConnector: (walletDetails) => createQorexConnector(walletDetails, connectorOptions)
+  };
+}
+
+// src/chains.ts
+var _viem = require('viem');
+var nativeCurrency = { name: "QOR", symbol: "QOR", decimals: 18 };
+var qorechain = _viem.defineChain.call(void 0, {
+  id: 9801,
+  name: "QoreChain",
+  nativeCurrency,
+  rpcUrls: {
+    default: { http: ["https://evm.qore.host"] }
+  },
+  blockExplorers: {
+    default: { name: "QoreChain Explorer", url: "https://explore.qore.network" }
+  }
+});
+var qorechainTestnet = _viem.defineChain.call(void 0, {
+  id: 9800,
+  name: "QoreChain Testnet",
+  nativeCurrency,
+  rpcUrls: {
+    default: { http: ["https://evm-testnet.qore.host"] }
+  },
+  blockExplorers: {
+    default: { name: "QoreChain Explorer", url: "https://explore.qore.network" }
+  },
+  testnet: true
+});
+var QOREX_CHAINS = [qorechain, qorechainTestnet];
+
+// src/index.ts
+
+
+
+
+
+
+
+
+
+
+exports.QOREX_CHAINS = QOREX_CHAINS; exports.QOREX_ICON_BACKGROUND = QOREX_ICON_BACKGROUND; exports.QOREX_RDNS = _qorextypes.QOREX_RDNS; exports.createQorexConnector = createQorexConnector; exports.getQorexEip1193Provider = getQorexEip1193Provider; exports.qorechain = qorechain; exports.qorechainTestnet = qorechainTestnet; exports.qorexWallet = qorexWallet;

package/dist/index.d.cts

@@ -0,0 +1,251 @@
+import { WalletDetailsParams, Wallet } from '@rainbow-me/rainbowkit';
+import { CreateConnectorFn } from 'wagmi';
+import { QorexEip1193Provider } from '@qorechain/qorex-types';
+export { QOREX_RDNS } from '@qorechain/qorex-types';
+import * as viem from 'viem';
+
+/** Background behind the QoreX icon in RainbowKit's lists. */
+declare const QOREX_ICON_BACKGROUND = "#EEE9FB";
+interface QorexConnectorOptions {
+    /**
+     * QoreX does not emit `accountsChanged` or `chainChanged` yet, so wagmi does
+     * not see an account or network change made in the wallet. When true, the
+     * connector re-reads `eth_accounts` and `eth_chainId` each time the page
+     * regains focus or becomes visible while connected, and reports a change to
+     * wagmi as if the wallet had emitted the event. An empty account list (the
+     * wallet was locked or the site disconnected) disconnects. Default false.
+     */
+    readonly pollAccountsOnFocus?: boolean;
+}
+interface QorexWalletOptions extends QorexConnectorOptions {
+    /** Passed by RainbowKit to every wallet function; not used. */
+    readonly projectId?: string;
+    /** Passed by RainbowKit to every wallet function; not used. */
+    readonly appName?: string;
+}
+/**
+ * The QoreX EVM provider: the one announced through EIP-6963 with rdns
+ * `network.qore.qorex`, or `window.qorex.evm` (the same object) if the
+ * announcement is not seen.
+ */
+declare function getQorexEip1193Provider(): QorexEip1193Provider | undefined;
+/**
+ * wagmi connector for QoreX. `qorexWallet().createConnector` uses this; call
+ * it directly only to use QoreX with plain wagmi.
+ */
+declare function createQorexConnector(walletDetails: WalletDetailsParams, options?: QorexConnectorOptions): CreateConnectorFn;
+/**
+ * QoreX as a RainbowKit wallet.
+ *
+ * ```ts
+ * connectorsForWallets([{ groupName: "Recommended", wallets: [qorexWallet] }], { appName, projectId });
+ * // with options:
+ * connectorsForWallets([{ groupName: "Recommended", wallets: [() => qorexWallet({ pollAccountsOnFocus: true })] }], { appName, projectId });
+ * ```
+ */
+declare function qorexWallet(options?: QorexWalletOptions): Wallet;
+
+/** QoreChain mainnet, EVM chain id 9801. */
+declare const qorechain: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9801;
+    name: "QoreChain";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | 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;
+};
+/** QoreChain testnet, EVM chain id 9800. */
+declare const qorechainTestnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9800;
+    name: "QoreChain Testnet";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm-testnet.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+    testnet: true;
+    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;
+};
+/** Both QoreChain EVM chains, mainnet first. Pass to wagmi or RainbowKit `chains`. */
+declare const QOREX_CHAINS: readonly [{
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9801;
+    name: "QoreChain";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | 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;
+}, {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9800;
+    name: "QoreChain Testnet";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm-testnet.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+    testnet: true;
+    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;
+}];
+
+export { QOREX_CHAINS, QOREX_ICON_BACKGROUND, type QorexConnectorOptions, type QorexWalletOptions, createQorexConnector, getQorexEip1193Provider, qorechain, qorechainTestnet, qorexWallet };

package/dist/index.d.ts

@@ -0,0 +1,251 @@
+import { WalletDetailsParams, Wallet } from '@rainbow-me/rainbowkit';
+import { CreateConnectorFn } from 'wagmi';
+import { QorexEip1193Provider } from '@qorechain/qorex-types';
+export { QOREX_RDNS } from '@qorechain/qorex-types';
+import * as viem from 'viem';
+
+/** Background behind the QoreX icon in RainbowKit's lists. */
+declare const QOREX_ICON_BACKGROUND = "#EEE9FB";
+interface QorexConnectorOptions {
+    /**
+     * QoreX does not emit `accountsChanged` or `chainChanged` yet, so wagmi does
+     * not see an account or network change made in the wallet. When true, the
+     * connector re-reads `eth_accounts` and `eth_chainId` each time the page
+     * regains focus or becomes visible while connected, and reports a change to
+     * wagmi as if the wallet had emitted the event. An empty account list (the
+     * wallet was locked or the site disconnected) disconnects. Default false.
+     */
+    readonly pollAccountsOnFocus?: boolean;
+}
+interface QorexWalletOptions extends QorexConnectorOptions {
+    /** Passed by RainbowKit to every wallet function; not used. */
+    readonly projectId?: string;
+    /** Passed by RainbowKit to every wallet function; not used. */
+    readonly appName?: string;
+}
+/**
+ * The QoreX EVM provider: the one announced through EIP-6963 with rdns
+ * `network.qore.qorex`, or `window.qorex.evm` (the same object) if the
+ * announcement is not seen.
+ */
+declare function getQorexEip1193Provider(): QorexEip1193Provider | undefined;
+/**
+ * wagmi connector for QoreX. `qorexWallet().createConnector` uses this; call
+ * it directly only to use QoreX with plain wagmi.
+ */
+declare function createQorexConnector(walletDetails: WalletDetailsParams, options?: QorexConnectorOptions): CreateConnectorFn;
+/**
+ * QoreX as a RainbowKit wallet.
+ *
+ * ```ts
+ * connectorsForWallets([{ groupName: "Recommended", wallets: [qorexWallet] }], { appName, projectId });
+ * // with options:
+ * connectorsForWallets([{ groupName: "Recommended", wallets: [() => qorexWallet({ pollAccountsOnFocus: true })] }], { appName, projectId });
+ * ```
+ */
+declare function qorexWallet(options?: QorexWalletOptions): Wallet;
+
+/** QoreChain mainnet, EVM chain id 9801. */
+declare const qorechain: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9801;
+    name: "QoreChain";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | 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;
+};
+/** QoreChain testnet, EVM chain id 9800. */
+declare const qorechainTestnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9800;
+    name: "QoreChain Testnet";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm-testnet.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+    testnet: true;
+    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;
+};
+/** Both QoreChain EVM chains, mainnet first. Pass to wagmi or RainbowKit `chains`. */
+declare const QOREX_CHAINS: readonly [{
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9801;
+    name: "QoreChain";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | 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;
+}, {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "QoreChain Explorer";
+            readonly url: "https://explore.qore.network";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 9800;
+    name: "QoreChain Testnet";
+    nativeCurrency: {
+        readonly name: "QOR";
+        readonly symbol: "QOR";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://evm-testnet.qore.host"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | undefined | undefined;
+    testnet: true;
+    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;
+}];
+
+export { QOREX_CHAINS, QOREX_ICON_BACKGROUND, type QorexConnectorOptions, type QorexWalletOptions, createQorexConnector, getQorexEip1193Provider, qorechain, qorechainTestnet, qorexWallet };

package/dist/index.js

@@ -0,0 +1,177 @@
+// src/wallet.ts
+import { createConnector, injected } from "wagmi";
+import {
+  QOREX_DOWNLOAD_URLS,
+  QOREX_NAME,
+  QOREX_RDNS,
+  findQorexEip1193
+} from "@qorechain/qorex-types";
+import { QOREX_ICON_DATA_URI } from "@qorechain/qorex-types/icon";
+var QOREX_ICON_BACKGROUND = "#EEE9FB";
+function getQorexEip1193Provider() {
+  const announced = findQorexEip1193();
+  if (announced) return announced;
+  if (typeof window === "undefined") return void 0;
+  const evm = window.qorex?.evm;
+  return evm && evm.isQoreX === true && typeof evm.request === "function" ? evm : void 0;
+}
+function createQorexConnector(walletDetails, options = {}) {
+  const { id, name } = walletDetails.rkDetails;
+  let cached;
+  const provider = () => cached ??= getQorexEip1193Provider();
+  return createConnector((config) => {
+    const base = injected({
+      shimDisconnect: true,
+      // An object target: wagmi then never substitutes window.ethereum.
+      target: { id, name, icon: QOREX_ICON_DATA_URI, provider }
+    })(config);
+    let stopPolling;
+    const startPolling = (connector2, accounts, chainId) => {
+      if (options.pollAccountsOnFocus !== true || typeof window === "undefined") return;
+      stopPolling?.();
+      let lastAccounts = accounts.map((a) => a.toLowerCase()).join(",");
+      let lastChainId = chainId;
+      let running = false;
+      const check = async () => {
+        if (running) return;
+        running = true;
+        try {
+          const p = provider();
+          if (!p) return;
+          const nextAccounts = await p.request({ method: "eth_accounts" });
+          const nextChainHex = await p.request({ method: "eth_chainId" });
+          const accountsKey = nextAccounts.map((a) => a.toLowerCase()).join(",");
+          const nextChainId = Number(nextChainHex);
+          if (accountsKey !== lastAccounts) {
+            lastAccounts = accountsKey;
+            connector2.onAccountsChanged(nextAccounts);
+          }
+          if (Number.isFinite(nextChainId) && nextChainId !== lastChainId) {
+            lastChainId = nextChainId;
+            connector2.onChainChanged(nextChainHex);
+          }
+        } catch {
+        } finally {
+          running = false;
+        }
+      };
+      const onFocus = () => void check();
+      const onVisibility = () => {
+        if (document.visibilityState === "visible") void check();
+      };
+      window.addEventListener("focus", onFocus);
+      document.addEventListener("visibilitychange", onVisibility);
+      stopPolling = () => {
+        window.removeEventListener("focus", onFocus);
+        document.removeEventListener("visibilitychange", onVisibility);
+        stopPolling = void 0;
+      };
+    };
+    const connect = async function(parameters) {
+      const result = await base.connect.call(this, parameters);
+      const accounts = result.accounts.map(
+        (a) => typeof a === "string" ? a : a.address
+      );
+      startPolling(this, accounts, result.chainId);
+      return result;
+    };
+    const connector = {
+      ...base,
+      rdns: QOREX_RDNS,
+      connect,
+      async disconnect() {
+        stopPolling?.();
+        await base.disconnect.call(this);
+      }
+    };
+    return { ...connector, ...walletDetails };
+  });
+}
+function qorexWallet(options = {}) {
+  const connectorOptions = { pollAccountsOnFocus: options.pollAccountsOnFocus === true };
+  return {
+    id: "qorex",
+    name: QOREX_NAME,
+    rdns: QOREX_RDNS,
+    iconUrl: QOREX_ICON_DATA_URI,
+    iconBackground: QOREX_ICON_BACKGROUND,
+    installed: typeof window === "undefined" ? void 0 : getQorexEip1193Provider() !== void 0,
+    downloadUrls: {
+      chrome: QOREX_DOWNLOAD_URLS.chrome,
+      edge: QOREX_DOWNLOAD_URLS.chrome,
+      opera: QOREX_DOWNLOAD_URLS.chrome,
+      firefox: QOREX_DOWNLOAD_URLS.firefox,
+      safari: QOREX_DOWNLOAD_URLS.safari,
+      macos: QOREX_DOWNLOAD_URLS.safari,
+      browserExtension: QOREX_DOWNLOAD_URLS.chrome,
+      ios: QOREX_DOWNLOAD_URLS.ios,
+      android: QOREX_DOWNLOAD_URLS.android,
+      mobile: QOREX_DOWNLOAD_URLS.website,
+      qrCode: QOREX_DOWNLOAD_URLS.website
+    },
+    extension: {
+      instructions: {
+        learnMoreUrl: QOREX_DOWNLOAD_URLS.website,
+        steps: [
+          {
+            step: "install",
+            title: "Install the QoreX extension",
+            description: "Add QoreX to your browser and pin it to the toolbar so you can open it quickly."
+          },
+          {
+            step: "create",
+            title: "Create or import a wallet",
+            description: "Write down your recovery phrase and keep it offline. Never share it with anyone."
+          },
+          {
+            step: "refresh",
+            title: "Refresh this page",
+            description: "After setting up QoreX, refresh the page so it can find the extension."
+          }
+        ]
+      }
+    },
+    createConnector: (walletDetails) => createQorexConnector(walletDetails, connectorOptions)
+  };
+}
+
+// src/chains.ts
+import { defineChain } from "viem";
+var nativeCurrency = { name: "QOR", symbol: "QOR", decimals: 18 };
+var qorechain = defineChain({
+  id: 9801,
+  name: "QoreChain",
+  nativeCurrency,
+  rpcUrls: {
+    default: { http: ["https://evm.qore.host"] }
+  },
+  blockExplorers: {
+    default: { name: "QoreChain Explorer", url: "https://explore.qore.network" }
+  }
+});
+var qorechainTestnet = defineChain({
+  id: 9800,
+  name: "QoreChain Testnet",
+  nativeCurrency,
+  rpcUrls: {
+    default: { http: ["https://evm-testnet.qore.host"] }
+  },
+  blockExplorers: {
+    default: { name: "QoreChain Explorer", url: "https://explore.qore.network" }
+  },
+  testnet: true
+});
+var QOREX_CHAINS = [qorechain, qorechainTestnet];
+
+// src/index.ts
+import { QOREX_RDNS as QOREX_RDNS2 } from "@qorechain/qorex-types";
+export {
+  QOREX_CHAINS,
+  QOREX_ICON_BACKGROUND,
+  QOREX_RDNS2 as QOREX_RDNS,
+  createQorexConnector,
+  getQorexEip1193Provider,
+  qorechain,
+  qorechainTestnet,
+  qorexWallet
+};

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@qorechain/qorex-rainbowkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "QoreX wallet for RainbowKit, plus viem chain definitions for the QoreChain EVM lane.",
+  "license": "Apache-2.0",
+  "author": "QoreChain Association",
+  "homepage": "https://github.com/qorechain/qorex-integrations/tree/main/packages/rainbowkit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qorechain/qorex-integrations.git",
+    "directory": "packages/rainbowkit"
+  },
+  "bugs": {
+    "url": "https://github.com/qorechain/qorex-integrations/issues"
+  },
+  "keywords": [
+    "qorex",
+    "qorechain",
+    "rainbowkit",
+    "wagmi",
+    "viem",
+    "eip-6963",
+    "wallet"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@qorechain/qorex-types": "0.1.0"
+  },
+  "peerDependencies": {
+    "@rainbow-me/rainbowkit": "^2.2.11",
+    "viem": "^2.0.0",
+    "wagmi": "^2.9.0"
+  },
+  "devDependencies": {
+    "@rainbow-me/rainbowkit": "2.2.11",
+    "@tanstack/react-query": "5.104.2",
+    "jsdom": "30.1.2",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "viem": "2.57.5",
+    "wagmi": "2.19.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src test",
+    "typecheck": "tsc --noEmit"
+  }
 }