@web3jskit/walletkit 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to `@web3jskit/walletkit` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.6.3] - 2026-09-20
+
+### Fixed
+
+- Opening the connect modal no longer fails with `Cannot destructure property 'createConnector' of '(intermediate value)' as it is undefined` when a Vite app rebundles the ESM build. Connector factories now load through a default-export entry so consumer bundlers keep a stable interop shape.
+
+### Changed
+
+- npm / ESM apps should import `@web3jskit/walletkit/base.css` (fonts + theme tokens). Component CSS is already injected into ESM chunks. Use `style.css` only for UMD / CDN.
+
+## [0.6.2] - 2026-09-20
+
+### Added
+
+- MetaMask TRON connector via the official `@metamask/connect-tron` adapter (Multichain API / CAIP-25), including Nile and Shasta when the wallet already has the network.
+- Built-in TRON network table in the docs: Mainnet `728126428`, Nile `3448148188`, Shasta `2494104990`.
+
+### Fixed
+
+- Bitget no longer auto-opens just because the wallet list is rendered. TRON detection uses `'tronLink' in bitkeep` and a lazy provider, instead of reading `bitkeep.tronLink`.
+- MetaMask can show as Installed on TRON even when OKX / TokenPocket / Bitget spoof `window.ethereum.isMetaMask`.
+- MetaMask TRON connect waits until the adapter is `Found` before calling `connect()`, avoiding `Wallet not found or not ready`.
+
+### Changed
+
+- Wallets that cannot switch to Nile stay in the list. Only TronLink (TIP-3326) and MetaMask can switch from the dapp; WalletKit will not fake a local-only network change.
+
+## [0.6.1] - 2026-09-20
+
+### Fixed
+
+- TRON `switchNetwork` now talks to the wallet (TIP-3326 `wallet_switchEthereumChain`). Unsupported wallets throw instead of silently calling `tronWeb.setNode` or updating local state only.
+
+## [0.6.0] - 2026-09-20
+
+### Added
+
+- TRON as a first-class chain type in connect, discovery, and wallet catalog (TronLink, OKX, Bitget, TokenPocket).
+- TIP-6963 discovery for injected TRON wallets, with a Browser Wallet fallback when an injected provider exists.
+
+[0.6.3]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.3
+[0.6.2]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.2
+[0.6.1]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.1
+[0.6.0]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.0

package/CHANGELOG.zh.md

@@ -0,0 +1,50 @@
+# 更新日志
+
+`@web3jskit/walletkit` 的重要变更记录于此。
+
+格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.6.3] - 2026-09-20
+
+### 修复
+
+- 接入方用 Vite 二次打包 ESM 时，打开连接弹窗不再报 `Cannot destructure property 'createConnector' of '(intermediate value)' as it is undefined`。connector 工厂改为 default export 入口，二次打包后的模块形状保持稳定。
+
+### 变更
+
+- npm / ESM 请导入 `@web3jskit/walletkit/base.css`（字体 + 主题变量）。组件样式已经打进 ESM chunk。只有 UMD / CDN 才用 `style.css`。
+
+## [0.6.2] - 2026-09-20
+
+### 新增
+
+- MetaMask TRON：走官方 `@metamask/connect-tron` adapter（Multichain API / CAIP-25）。钱包里已有 Nile / Shasta 时可以切网。
+- 文档补充内置 TRON 网络：Mainnet `728126428`、Nile `3448148188`、Shasta `2494104990`。
+
+### 修复
+
+- 仅渲染钱包列表时不再自动唤起 Bitget。TRON 探测改用 `'tronLink' in bitkeep` 和懒加载 provider，不再读取 `bitkeep.tronLink`。
+- 同时装着 OKX / TokenPocket / Bitget 时，MetaMask 在 TRON 上仍可显示为已安装（不再被 `window.ethereum.isMetaMask` 冒充干扰）。
+- MetaMask TRON 会等到 adapter 进入 `Found` 再 `connect()`，避免 `Wallet not found or not ready`。
+
+### 变更
+
+- 切不了 Nile 的钱包仍会展示。目前只有 TronLink（TIP-3326）和 MetaMask 能由 DApp 切网；WalletKit 不会只改本地状态假装切成功。
+
+## [0.6.1] - 2026-09-20
+
+### 修复
+
+- TRON `switchNetwork` 会真正请求钱包（TIP-3326 `wallet_switchEthereumChain`）。不支持切网的钱包会抛错，不再静默调用 `tronWeb.setNode` 或只改本地网络。
+
+## [0.6.0] - 2026-09-20
+
+### 新增
+
+- TRON 作为一等链类型进入连接、发现和钱包目录（TronLink、OKX、Bitget、TokenPocket）。
+- 注入式 TRON 钱包走 TIP-6963 发现；存在注入 provider 时提供 Browser Wallet 兜底。
+
+[0.6.3]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.3
+[0.6.2]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.2
+[0.6.1]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.1
+[0.6.0]: https://www.npmjs.com/package/@web3jskit/walletkit/v/0.6.0

package/README.md

@@ -70,8 +70,8 @@ pnpm add @web3jskit/walletkit
 
 ```tsx
 import { WalletKitProvider, ConnectButton, useWalletKit } from '@web3jskit/walletkit';
-// Import styles (required)
-import '@web3jskit/walletkit/style.css';
+// Import fonts and theme tokens (required for npm / ESM)
+import '@web3jskit/walletkit/base.css';
 
 function App() {
   return (
@@ -101,20 +101,25 @@ function YourApp() {
 }
 ```
 
-> ⚠️ **Important**: Always import the CSS file `@web3jskit/walletkit/style.css` for proper styling.
+> ⚠️ **Important**: For npm / ESM, import `@web3jskit/walletkit/base.css`. Component styles are already injected into ESM chunks. Use `style.css` only for UMD / CDN.
 
 ## Styling
 
-The library includes built-in styles that are automatically loaded when you import the CSS file. The styles support both light and dark themes and are fully responsive.
+The library includes built-in styles that support both light and dark themes and are fully responsive.
 
 ### CSS Import Methods
 
 ```tsx
-// Method 1: Direct import (recommended)
-import '@web3jskit/walletkit/style.css';
+// npm / ESM (recommended): fonts + theme tokens
+import '@web3jskit/walletkit/base.css';
 
-// Method 2: Import from dist
-import '@web3jskit/walletkit/dist/style.css';
+// equivalent path
+import '@web3jskit/walletkit/dist/base.css';
+```
+
+```html
+<!-- UMD / CDN: full stylesheet (base + component CSS) -->
+<link rel="stylesheet" href="https://unpkg.com/@web3jskit/walletkit@latest/dist/style.css">
 ```
 
 ### Theme Variables
@@ -571,6 +576,10 @@ function EventListener() {
 }
 ```
 
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md).
+
 ## License
 
 MIT

package/README.zh.md

@@ -70,8 +70,8 @@ pnpm add @web3jskit/walletkit
 
 ```tsx
 import { WalletKitProvider, ConnectButton, useWalletKit } from '@web3jskit/walletkit';
-// 导入样式（必需）
-import '@web3jskit/walletkit/style.css';
+// 导入字体和主题变量（npm / ESM 必需）
+import '@web3jskit/walletkit/base.css';
 
 function App() {
   return (
@@ -108,20 +108,25 @@ function YourApp() {
 }
 ```
 
-> ⚠️ **重要**: 请务必导入 CSS 文件 `@web3jskit/walletkit/style.css` 以确保正确的样式显示。
+> ⚠️ **重要**: npm / ESM 请导入 `@web3jskit/walletkit/base.css`。组件样式已经打进 ESM chunk。只有 UMD / CDN 才用 `style.css`。
 
 ## 样式
 
-组件库包含内置样式，导入 CSS 文件后会自动加载。样式支持明暗主题，并且完全响应式。
+组件库包含内置样式，支持明暗主题，并且完全响应式。
 
 ### CSS 导入方法
 
 ```tsx
-// 方法 1: 直接导入（推荐）
-import '@web3jskit/walletkit/style.css';
+// npm / ESM（推荐）：字体 + 主题变量
+import '@web3jskit/walletkit/base.css';
 
-// 方法 2: 从 dist 目录导入
-import '@web3jskit/walletkit/dist/style.css';
+// 等价路径
+import '@web3jskit/walletkit/dist/base.css';
+```
+
+```html
+<!-- UMD / CDN：完整样式（base + 组件 CSS） -->
+<link rel="stylesheet" href="https://unpkg.com/@web3jskit/walletkit@latest/dist/style.css">
 ```
 
 ### 主题变量
@@ -578,6 +583,10 @@ function EventListener() {
 }
 ```
 
+## 更新日志
+
+见 [CHANGELOG.zh.md](./CHANGELOG.zh.md)。
+
 ## 许可证
 
 MIT

package/dist/{btcConnector-DyocBque.mjs → btcConnector-B-FBz618.mjs}

@@ -1,5 +1,5 @@
-import { a as d } from "./index-Ca5U0KJA.mjs";
-import { B as v } from "./createConnectors-C90GnGoD.mjs";
+import { a as d } from "./index-BWBZ1f0K.mjs";
+import { B as v } from "./createConnectors-DPb4fTuL.mjs";
 class y extends v {
   constructor(h) {
     var r, i;

package/dist/{btcConnector-Ip851Zzx.js → btcConnector-BmBSGGDG.js}

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./index-Bo_G8w5V.js"),v=require("./createConnectors-C-XiQWnC.js");class l extends v.BaseConnector{constructor(h){var r,i;const g=(r=window.phantom)==null?void 0:r.bitcoin;super(h,g),this.addEventListener=async()=>{(await this.getProvider()).on("accountsChanged",s=>{var n;const e=(n=s[0])==null?void 0:n.address;e?this.connectSuccess(e):this.disconnect()})},this.removeEventListener=async()=>{(await this.getProvider()).off("accountsChanged",()=>{})},this.connect=async()=>{const t=await this.getProvider();try{this.beforeConnecting();const e=(await t.requestAccounts())[0].address;return this.connectSuccess(e),this.addEventListener(),e}catch(s){throw this.connectError(),s}},this.disconnect=async()=>{this.resetStatus(),this.removeEventListener()},this.getAccounts=async()=>(await(await this.getProvider()).requestAccounts())[0],this.signMessage=async()=>{const t=new TextEncoder().encode("hello world"),s=await this.getAccounts().catch(()=>{}),e=s==null?void 0:s.address,{signature:n}=await this.getProvider().signMessage(e,t);return n},this.getPublicKey=async()=>{const t=await this.getAccounts().catch(()=>{});return console.log("accounts",t),t.publicKey},this.signAndBroadcastPsbt=async(t,s)=>{console.log(t);const e=await this.getProvider();console.log("provider",e);const n=o=>Uint8Array.from(o.match(/.{1,2}/g).map(u=>parseInt(u,16))),c=await this.getAccounts().catch(()=>{}),a=c==null?void 0:c.address;console.log("address",a);try{const o=await e.signPSBT(n(t),{inputsToSign:[{address:a,signingIndexes:[0,1,3],sigHash:0}]});console.log("签名成功:",o)}catch(o){throw console.error("签名失败:",o),new Error("Broadcast method not supported by Phantom provider")}},this.__onAccountsChanged=()=>{},this.__onChainChanged=()=>{},this.__onConnect=()=>{},this.reconnection=async()=>{},this.__onDisconnect=()=>{},this.connectorType=(i=window.phantom)!=null&&i.bitcoin?d.ConnectorType.Installed:d.ConnectorType.More}}exports.default=l;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./index-BNUh90Ws.js"),v=require("./createConnectors-DzepxSHv.js");class l extends v.BaseConnector{constructor(h){var r,i;const g=(r=window.phantom)==null?void 0:r.bitcoin;super(h,g),this.addEventListener=async()=>{(await this.getProvider()).on("accountsChanged",s=>{var n;const e=(n=s[0])==null?void 0:n.address;e?this.connectSuccess(e):this.disconnect()})},this.removeEventListener=async()=>{(await this.getProvider()).off("accountsChanged",()=>{})},this.connect=async()=>{const t=await this.getProvider();try{this.beforeConnecting();const e=(await t.requestAccounts())[0].address;return this.connectSuccess(e),this.addEventListener(),e}catch(s){throw this.connectError(),s}},this.disconnect=async()=>{this.resetStatus(),this.removeEventListener()},this.getAccounts=async()=>(await(await this.getProvider()).requestAccounts())[0],this.signMessage=async()=>{const t=new TextEncoder().encode("hello world"),s=await this.getAccounts().catch(()=>{}),e=s==null?void 0:s.address,{signature:n}=await this.getProvider().signMessage(e,t);return n},this.getPublicKey=async()=>{const t=await this.getAccounts().catch(()=>{});return console.log("accounts",t),t.publicKey},this.signAndBroadcastPsbt=async(t,s)=>{console.log(t);const e=await this.getProvider();console.log("provider",e);const n=o=>Uint8Array.from(o.match(/.{1,2}/g).map(u=>parseInt(u,16))),c=await this.getAccounts().catch(()=>{}),a=c==null?void 0:c.address;console.log("address",a);try{const o=await e.signPSBT(n(t),{inputsToSign:[{address:a,signingIndexes:[0,1,3],sigHash:0}]});console.log("签名成功:",o)}catch(o){throw console.error("签名失败:",o),new Error("Broadcast method not supported by Phantom provider")}},this.__onAccountsChanged=()=>{},this.__onChainChanged=()=>{},this.__onConnect=()=>{},this.reconnection=async()=>{},this.__onDisconnect=()=>{},this.connectorType=(i=window.phantom)!=null&&i.bitcoin?d.ConnectorType.Installed:d.ConnectorType.More}}exports.default=l;

package/dist/{btcConnector-ZZavkQAJ.mjs → btcConnector-CoDLrD-5.mjs}

@@ -1,5 +1,5 @@
-import { a as c } from "./index-Ca5U0KJA.mjs";
-import { B as d } from "./createConnectors-C90GnGoD.mjs";
+import { a as c } from "./index-BWBZ1f0K.mjs";
+import { B as d } from "./createConnectors-DPb4fTuL.mjs";
 class p extends d {
   constructor(a) {
     const i = window.bitkeep.unisat;

package/dist/{btcConnector-CLm-gxx3.js → btcConnector-D6hRNl6J.js}

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./index-Bo_G8w5V.js"),d=require("./createConnectors-C-XiQWnC.js");class h extends d.BaseConnector{constructor(a){const i=window.bitkeep.unisat;super(a,i),this.addEventListener=async()=>{(await this.getProvider()).on("accountsChanged",t=>{const s=t[0];s?this.connectSuccess(s):this.disconnect()})},this.removeEventListener=async()=>{(await this.getProvider()).removeListener("accountsChanged",()=>{})},this.connect=async()=>{const e=await this.getProvider();try{this.beforeConnecting();const t=await e.requestAccounts();console.log("accounts",t);const s=t[0];return this.connectSuccess(s),this.addEventListener(),s}catch(t){throw this.connectError(),t}},this.disconnect=async()=>{this.resetStatus(),this.removeEventListener()},this.getAccounts=async()=>(await(await this.getProvider()).getAccounts())[0],this.signPsbt=async(e,t)=>await(await this.getProvider()).signPsbt(e,t),this.pushPsbt=async e=>await(await this.getProvider()).pushPsbt(e),this.signMessage=async(e,t)=>await(await this.getProvider()).signMessage(e,t),this.sendBitcoin=async(e,t,s)=>{const o=await this.getProvider();console.log("provider",o),console.log("toAddress, satoshis, options",e,t,s);try{let n=await o.sendBitcoin(e,t);return console.log(n),n}catch(n){console.error(n)}},this.signAndBroadcastPsbt=async(e,t)=>{const s=await this.getProvider();console.log("provider",s);const o=await this.getAccounts().catch(()=>{});console.log("address",o);const n={autoFinalize:!0,...t||{}};console.log("signOptions",n),!n.toSignInputs&&o&&(n.toSignInputs=[{index:0,address:o}]);const r=await s.signPsbt(e,n);return console.log("signed PsbtHex",r),await s.pushPsbt(r)},this.__onAccountsChanged=()=>{},this.__onChainChanged=()=>{},this.__onConnect=()=>{},this.reconnection=async()=>{},this.__onDisconnect=()=>{},this.connectorType=i?c.ConnectorType.Installed:c.ConnectorType.More}}exports.default=h;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./index-BNUh90Ws.js"),d=require("./createConnectors-DzepxSHv.js");class h extends d.BaseConnector{constructor(a){const i=window.bitkeep.unisat;super(a,i),this.addEventListener=async()=>{(await this.getProvider()).on("accountsChanged",t=>{const s=t[0];s?this.connectSuccess(s):this.disconnect()})},this.removeEventListener=async()=>{(await this.getProvider()).removeListener("accountsChanged",()=>{})},this.connect=async()=>{const e=await this.getProvider();try{this.beforeConnecting();const t=await e.requestAccounts();console.log("accounts",t);const s=t[0];return this.connectSuccess(s),this.addEventListener(),s}catch(t){throw this.connectError(),t}},this.disconnect=async()=>{this.resetStatus(),this.removeEventListener()},this.getAccounts=async()=>(await(await this.getProvider()).getAccounts())[0],this.signPsbt=async(e,t)=>await(await this.getProvider()).signPsbt(e,t),this.pushPsbt=async e=>await(await this.getProvider()).pushPsbt(e),this.signMessage=async(e,t)=>await(await this.getProvider()).signMessage(e,t),this.sendBitcoin=async(e,t,s)=>{const o=await this.getProvider();console.log("provider",o),console.log("toAddress, satoshis, options",e,t,s);try{let n=await o.sendBitcoin(e,t);return console.log(n),n}catch(n){console.error(n)}},this.signAndBroadcastPsbt=async(e,t)=>{const s=await this.getProvider();console.log("provider",s);const o=await this.getAccounts().catch(()=>{});console.log("address",o);const n={autoFinalize:!0,...t||{}};console.log("signOptions",n),!n.toSignInputs&&o&&(n.toSignInputs=[{index:0,address:o}]);const r=await s.signPsbt(e,n);return console.log("signed PsbtHex",r),await s.pushPsbt(r)},this.__onAccountsChanged=()=>{},this.__onChainChanged=()=>{},this.__onConnect=()=>{},this.reconnection=async()=>{},this.__onDisconnect=()=>{},this.connectorType=i?c.ConnectorType.Installed:c.ConnectorType.More}}exports.default=h;

package/dist/core/connectors/connectorLoader.d.ts

@@ -1,3 +1,3 @@
 export declare function loadCreateConnector(): Promise<typeof import('./createConnectors').createConnector>;
-export declare function loadCreateEvmConnectors(): Promise<typeof import('./_evm/createConnectors').createConnectors>;
+export declare function loadCreateEvmConnectors(): Promise<typeof import('./createEvmConnectors.entry').default>;
 //# sourceMappingURL=connectorLoader.d.ts.map

package/dist/core/connectors/connectorLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectorLoader.d.ts","sourceRoot":"","sources":["../../../src/core/connectors/connectorLoader.ts"],"names":[],"mappings":"AAAA,wBAAsB,mBAAmB,iEAGxC;AAED,wBAAsB,uBAAuB,uEAG5C"}
+{"version":3,"file":"connectorLoader.d.ts","sourceRoot":"","sources":["../../../src/core/connectors/connectorLoader.ts"],"names":[],"mappings":"AAAA,wBAAsB,mBAAmB,iEAExC;AAED,wBAAsB,uBAAuB,kEAE5C"}

package/dist/core/connectors/createConnector.entry.d.ts

@@ -0,0 +1,2 @@
+export { createConnector as default } from './createConnectors';
+//# sourceMappingURL=createConnector.entry.d.ts.map

package/dist/core/connectors/createConnector.entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createConnector.entry.d.ts","sourceRoot":"","sources":["../../../src/core/connectors/createConnector.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/connectors/createEvmConnectors.entry.d.ts

@@ -0,0 +1,2 @@
+export { createConnectors as default } from './_evm/createConnectors';
+//# sourceMappingURL=createEvmConnectors.entry.d.ts.map

package/dist/core/connectors/createEvmConnectors.entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEvmConnectors.entry.d.ts","sourceRoot":"","sources":["../../../src/core/connectors/createEvmConnectors.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/createConnector.entry-C2ezrrEW.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./createConnectors-DvITc7A3.js");exports.default=e.createConnector;

package/dist/createConnector.entry-CxyXzv78.mjs

@@ -0,0 +1,4 @@
+import { c as f } from "./createConnectors-ADoTab9F.mjs";
+export {
+  f as default
+};