decane-connect-kit 1.0.0 → 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/dist/index.cjs

@@ -1104,7 +1104,14 @@ async function getSolanaAddress(wallet) {
 }
 
 // src/tron/adapter.ts
+function getTronWeb() {
+  if (typeof window === "undefined") return void 0;
+  const win = window;
+  return win.tronLink?.tronWeb ?? win.tronWeb;
+}
 async function getTronAddress(provider) {
+  const addr = getTronWeb()?.defaultAddress?.base58;
+  if (addr) return addr;
   try {
     const result = await provider.request({ method: "tron_requestAccounts" });
     const accounts = result;
@@ -1123,11 +1130,80 @@ async function tronRequest(provider, method, payload, account) {
         method: "tron_signMessage",
         params: { message: payload }
       });
-    case "wallet_sendTransaction":
-      return provider.request({
-        method: "tron_sendTransaction",
-        params: { ...payload, from: account }
-      });
+    case "wallet_sendTransaction": {
+      const tronWeb = getTronWeb();
+      const p = payload;
+      const toAddress = p.to;
+      const sunAmount = typeof p.value === "string" ? parseInt(p.value, 10) : p.value ?? 0;
+      let unsignedTx;
+      if (tronWeb?.transactionBuilder?.sendTrx) {
+        if (p.data && p.data !== "0x") {
+          const res = await tronWeb.transactionBuilder.triggerSmartContract(
+            toAddress,
+            "transfer(address,uint256)",
+            { callValue: 0, feeLimit: 1e8 },
+            [],
+            account
+          );
+          unsignedTx = res.transaction;
+        } else {
+          unsignedTx = await tronWeb.transactionBuilder.sendTrx(toAddress, sunAmount, account);
+        }
+      } else {
+        const host = tronWeb?.fullNode?.host ?? "https://api.trongrid.io";
+        const endpoint = p.data && p.data !== "0x" ? `${host}/wallet/triggersmartcontract` : `${host}/wallet/createtransaction`;
+        const body = p.data && p.data !== "0x" ? {
+          owner_address: account,
+          contract_address: toAddress,
+          function_selector: "transfer(address,uint256)",
+          fee_limit: 1e8,
+          call_value: 0,
+          visible: true
+        } : {
+          owner_address: account,
+          to_address: toAddress,
+          amount: sunAmount,
+          visible: true
+        };
+        const res = await fetch(endpoint, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(body)
+        });
+        if (!res.ok) {
+          throw new DecaneError(
+            5022 /* PROVIDER_ERROR */,
+            `Failed to build Tron transaction: ${res.statusText}`
+          );
+        }
+        const json = await res.json();
+        unsignedTx = json.transaction ?? json;
+      }
+      let signedTx;
+      if (tronWeb?.trx?.sign) {
+        signedTx = await tronWeb.trx.sign(unsignedTx);
+      } else {
+        signedTx = await provider.request({
+          method: "tron_signTransaction",
+          params: unsignedTx
+        });
+      }
+      let txid;
+      if (tronWeb?.trx?.sendRawTransaction) {
+        const result = await tronWeb.trx.sendRawTransaction(signedTx);
+        txid = result?.txid;
+      } else {
+        const result = await provider.request({
+          method: "tron_sendRawTransaction",
+          params: signedTx
+        });
+        txid = result?.txid;
+      }
+      if (!txid) {
+        throw new DecaneError(5022 /* PROVIDER_ERROR */, "Tron transaction broadcast failed");
+      }
+      return txid;
+    }
     default:
       throw new DecaneError(
         5030 /* METHOD_NOT_SUPPORTED */,
@@ -2425,6 +2501,11 @@ function useDecaneContext() {
 
 // src/ui/hooks.ts
 var import_react4 = require("react");
+function toDecaneError(err) {
+  if (err instanceof DecaneError) return err;
+  const msg = err instanceof Error ? err.message : err?.message != null ? String(err.message) : String(err);
+  return new DecaneError(5022 /* PROVIDER_ERROR */, msg);
+}
 function useDecane() {
   const { provider, theme, setTheme } = useDecaneContext();
   const [, forceUpdate] = (0, import_react4.useState)(0);
@@ -2502,7 +2583,7 @@ function useChainSwitch() {
         });
         forceUpdate((n) => n + 1);
       } catch (err) {
-        const e = err instanceof DecaneError ? err : new DecaneError(5022 /* PROVIDER_ERROR */, String(err));
+        const e = toDecaneError(err);
         setError(e);
         throw err;
       } finally {
@@ -2553,7 +2634,7 @@ function useSignMessage() {
         setSignature(sig);
         return sig;
       } catch (err) {
-        const e = err instanceof DecaneError ? err : new DecaneError(5022 /* PROVIDER_ERROR */, String(err));
+        const e = toDecaneError(err);
         setError(e);
         throw err;
       } finally {
@@ -2591,7 +2672,7 @@ function useSendTransaction() {
         setTxHash(hash);
         return hash;
       } catch (err) {
-        const e = err instanceof DecaneError ? err : new DecaneError(5022 /* PROVIDER_ERROR */, String(err));
+        const e = toDecaneError(err);
         setError(e);
         throw err;
       } finally {
@@ -2628,7 +2709,7 @@ function useSignTypedData() {
         setSignature(sig);
         return sig;
       } catch (err) {
-        const e = err instanceof DecaneError ? err : new DecaneError(5022 /* PROVIDER_ERROR */, String(err));
+        const e = toDecaneError(err);
         setError(e);
         throw err;
       } finally {