decane-connect-kit 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # decane-connect-kit
 
-Wallet connection for EVM and Solana dApps. Detects installed wallets via EIP-6963 and the Solana Wallet Standard, manages sessions with CAIP-25, and ships a polished wallet selector UI. Works with React 18+ in any framework.
+Wallet connection for EVM, Solana, Tron, and Bitcoin dApps. Detects installed wallets via EIP-6963, the Solana Wallet Standard, TronLink, and Unisat/OKX/MetaMask Snap. Manages sessions with CAIP-25 and ships a polished wallet selector UI. Works with React 18+ in any framework.
 
 ---
 
@@ -137,7 +137,7 @@ All options are optional.
 ```tsx
 <DecaneKit config={{
   // Which wallet types to show and connect
-  // "evm" | "solana" | "all" — default: "all"
+  // "evm" | "solana" | "tron" | "bitcoin" | "all" — default: "all"
   networks: "all",
 
   // Restrict which built-in chains are available
@@ -167,16 +167,22 @@ All options are optional.
 
 ### `networks`
 
-Controls which wallets appear in the selector and how multi-chain wallets connect.
+Controls which wallets appear in the selector and which chain types are offered.
 
 ```tsx
-// EVM-only dApp — Solana wallets hidden, chain picker skipped
+// EVM-only dApp — all other wallets hidden
 <DecaneKit config={{ networks: "evm" }}>
 
 // Solana-only dApp
 <DecaneKit config={{ networks: "solana" }}>
 
-// Both (default) — all wallets shown, chain picker appears for Phantom/Backpack
+// Tron-only dApp
+<DecaneKit config={{ networks: "tron" }}>
+
+// Bitcoin-only dApp
+<DecaneKit config={{ networks: "bitcoin" }}>
+
+// All chains (default)
 <DecaneKit config={{ networks: "all" }}>
 ```
 
@@ -188,7 +194,7 @@ Restricts the chain list used throughout the SDK — the wallet selector, `provi
 import { CHAINS } from "decane-connect-kit";
 
 <DecaneKit config={{
-  supportedChainIds: [CHAINS.ETHEREUM, CHAINS.BASE, CHAINS.SOLANA],
+  supportedChainIds: [CHAINS.ETHEREUM, CHAINS.BASE, CHAINS.SOLANA, CHAINS.TRON, CHAINS.BITCOIN],
 }}>
 ```
 
@@ -204,9 +210,11 @@ Reactive state hook. Re-renders on any wallet or session change.
 const {
   // Detected wallets
   wallets,           // all wallets
-  evmWallets,        // EVM-only + multi-chain
-  solanaWallets,     // Solana-only + multi-chain
-  multiChainWallets, // wallets with both EVM + Solana
+  evmWallets,        // EVM wallets
+  solanaWallets,     // Solana wallets
+  tronWallets,       // Tron wallets (TronLink)
+  bitcoinWallets,    // Bitcoin wallets (Unisat, OKX, MetaMask Snap)
+  multiChainWallets, // wallets supporting 2+ chains
 
   // Connection state
   isConnected,
@@ -241,6 +249,8 @@ const { isOpen, open, close } = useWalletSelector();
 
 ### `useSignMessage()`
 
+Works on EVM, Solana, Tron, and Bitcoin. The active chain determines the signing method used.
+
 ```tsx
 const { signMessage, signature, loading, error, reset } = useSignMessage();
 
@@ -249,27 +259,38 @@ await signMessage("Hello world");
 
 // Override chain or account
 await signMessage("Hello world", { chainId: CHAINS.POLYGON, account: "0xAbc…" });
+await signMessage("Hello world", { chainId: CHAINS.TRON });
+await signMessage("Hello world", { chainId: CHAINS.BITCOIN });
 ```
 
 ### `useSendTransaction()`
 
+Works on EVM, Solana, Tron, and Bitcoin.
+
 ```tsx
 const { sendTransaction, txHash, loading, error, reset } = useSendTransaction();
 
+// EVM — value in wei
 await sendTransaction({
   to: "0xRecipient",
-  value: "1000000000000000", // wei as decimal string or hex
+  value: "1000000000000000", // decimal string or hex
   data: "0x",               // optional calldata
   gas: "21000",             // optional
 });
 
+// Tron — value in SUN (1 TRX = 1,000,000 SUN)
+await sendTransaction({ to: "TRecipient…", value: "1000000" }, { chainId: CHAINS.TRON });
+
+// Bitcoin — value in satoshis
+await sendTransaction({ to: "bc1q…", value: "10000" }, { chainId: CHAINS.BITCOIN });
+
 // Override chain
 await sendTransaction({ to: "0xRecipient" }, { chainId: CHAINS.ARBITRUM });
 ```
 
 ### `useSignTypedData()`
 
-EVM only. Throws `DecaneErrorCode.EVM_ONLY_METHOD` if called on a Solana chain.
+EVM only. Throws `DecaneErrorCode.EVM_ONLY_METHOD` if called on a non-EVM chain.
 
 ```tsx
 const { signTypedData, signature, loading, error, reset } = useSignTypedData();
@@ -289,12 +310,35 @@ Switch the active chain within the current session.
 const { switchChain, activeChain, grantedChains, loading, error } = useChainSwitch();
 
 // grantedChains — CAIP-2 IDs granted in the current session
-// switchChain requests permissions for the new chain
 await switchChain(CHAINS.POLYGON);
+await switchChain(CHAINS.TRON);
+await switchChain(CHAINS.BITCOIN);
 ```
 
 ---
 
+## Wallet detection
+
+### EVM
+Detected via **EIP-6963** — standard event-based discovery. All compliant wallets (MetaMask, Rabby, Coinbase Wallet, Brave, OKX, and others) are discovered automatically. `window.ethereum` is never used.
+
+### Solana
+Detected via the **Wallet Standard** (`@wallet-standard/app`). Wallets must expose `standard:connect`, `solana:signTransaction`, and `solana:signMessage`. Multi-chain wallets like Phantom and Backpack are merged into a single entry when detected on both EVM and Solana.
+
+### Tron
+Detected via **TronLink's injected provider** (`window.tronLink`). The SDK listens for `tronLink#initialized` and polls for up to 3 seconds to handle extensions that load after the page. Transactions are built via `window.tronWeb.transactionBuilder` when available, falling back to the TronGrid HTTP API.
+
+### Bitcoin
+Three detection paths run in parallel:
+
+| Wallet | Detection |
+|--------|-----------|
+| **Unisat** | `window.unisat` injected provider |
+| **OKX Wallet** | `window.okxwallet.bitcoin` — shares `rdns` with OKX EVM, auto-merges to give EVM + Bitcoin support |
+| **MetaMask Bitcoin Snap** | After each EVM wallet is discovered, `wallet_getSnaps` is called silently. If `npm:@metamask/bitcoin-snap` or `npm:@consensys/btc-snap` is enabled, the wallet gains Bitcoin support with no user interaction |
+
+---
+
 ## Chain constants
 
 Use `CHAINS` instead of bare strings to get autocomplete and catch typos at compile time.
@@ -302,7 +346,7 @@ Use `CHAINS` instead of bare strings to get autocomplete and catch typos at comp
 ```tsx
 import { CHAINS, type ChainId } from "decane-connect-kit";
 
-// Tier-1
+// Tier-1 EVM
 CHAINS.ETHEREUM         // "eip155:1"
 CHAINS.BASE             // "eip155:8453"
 CHAINS.ARBITRUM         // "eip155:42161"
@@ -335,6 +379,13 @@ CHAINS.LOCALHOST        // "eip155:31337"
 // Solana
 CHAINS.SOLANA           // "solana:mainnet"
 CHAINS.SOLANA_DEVNET    // "solana:devnet"
+
+// Tron
+CHAINS.TRON             // "tron:mainnet"
+CHAINS.TRON_SHASTA      // "tron:shasta"
+
+// Bitcoin
+CHAINS.BITCOIN          // "bip122:mainnet"
 ```
 
 `ChainId` is the union type of all built-in chain ID strings.
@@ -422,7 +473,7 @@ if (error) {
 | `WALLET_DISCONNECTED` | 5021 | Wallet disconnected mid-session |
 | `PROVIDER_ERROR` | 5022 | Underlying wallet threw an error |
 | `METHOD_NOT_SUPPORTED` | 5030 | Method not recognised |
-| `EVM_ONLY_METHOD` | 5031 | `wallet_signTypedData` on Solana chain |
+| `EVM_ONLY_METHOD` | 5031 | `wallet_signTypedData` on a non-EVM chain |
 
 ---
 
@@ -477,7 +528,7 @@ import type {
   ChainDescriptor,      // chain definition object
   ActiveSession,        // CAIP-25 session state
   ChainScope,           // methods + accounts for one chain
-  ChainType,            // "evm" | "solana"
+  ChainType,            // "evm" | "solana" | "tron" | "bitcoin"
   ChainId,              // union of all built-in CAIP-2 chain IDs
   Theme,                // "light" | "dark" | "auto"
   TxParams,             // params for useSendTransaction
@@ -490,7 +541,7 @@ import type {
 ## What is not included
 
 - Social sign-in or email login
-- Any backend, server, or API calls
+- Any backend, server, or API calls (except the TronGrid fallback when TronWeb is unavailable)
 - `window.ethereum` — detection uses EIP-6963 exclusively
 - Private key or seed phrase management
 - State management libraries (Redux, Zustand) — pure React context
@@ -581,3 +632,16 @@ The following chains are available out of the box. Pass `supportedChainIds` in c
 |------|-----------|-------------------|
 | Solana | `solana:mainnet` | `CHAINS.SOLANA` |
 | Solana Devnet | `solana:devnet` | `CHAINS.SOLANA_DEVNET` |
+
+### Tron
+
+| Name | CAIP-2 ID | `CHAINS` constant |
+|------|-----------|-------------------|
+| Tron | `tron:mainnet` | `CHAINS.TRON` |
+| Tron Shasta Testnet | `tron:shasta` | `CHAINS.TRON_SHASTA` |
+
+### Bitcoin
+
+| Name | CAIP-2 ID | `CHAINS` constant |
+|------|-----------|-------------------|
+| Bitcoin | `bip122:mainnet` | `CHAINS.BITCOIN` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decane-connect-kit",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",