@hashgraph/hedera-wallet-connect 2.1.3-canary.c6aa77e.0 → 2.1.3

package/README.md

@@ -61,10 +61,14 @@ reviewing the [Reown docs](https://docs.reown.com/overview).
 
 ## Using Reown's AppKit (Recommended)
 
-> **For EVM developers:** If you're coming from Ethereum or other EVM chains, the `eip155` adapter
-> lets you use standard Ethereum methods (`personal_sign`, `eth_sendTransaction`, etc.) on Hedera's
-> EVM-compatible layer - no Hedera-specific RPC knowledge required. The native `hedera` adapter is
-> optional and only needed for Hedera-native operations (HTS tokens, HBAR transfers via SDK, etc.).
+> **For EVM developers:** If you're coming from Ethereum or other EVM chains, use `WagmiAdapter`
+> from `@reown/appkit-adapter-wagmi` for standard Ethereum methods (`personal_sign`,
+> `eth_sendTransaction`, etc.) on Hedera's EVM-compatible layer - no Hedera-specific RPC knowledge
+> required. The native `hedera` adapter is only needed for Hedera-native operations (HTS tokens,
+> HBAR transfers via SDK, etc.).
+>
+> **Note:** The `HederaAdapter` with `namespace: 'eip155'` is deprecated. Use `WagmiAdapter` from
+> `@reown/appkit-adapter-wagmi` instead. See the migration example below.
 
 1. Follow one of the quickstart instructions at
    https://docs.reown.com/appkit/overview#quickstart
@@ -72,7 +76,7 @@ reviewing the [Reown docs](https://docs.reown.com/overview).
 2. Add Hedera dependencies to your project:
 
 ```sh
-npm install @hashgraph/hedera-wallet-connect @hiero-ledger/sdk @walletconnect/universal-provider
+npm install @hashgraph/hedera-wallet-connect @hiero-ledger/sdk @walletconnect/universal-provider @reown/appkit-adapter-wagmi
 ```
 
 3. Initialize adapters and create AppKit:
@@ -85,6 +89,7 @@ import {
   HederaChainDefinition,
   hederaNamespace,
 } from '@hashgraph/hedera-wallet-connect'
+import { WagmiAdapter } from '@reown/appkit-adapter-wagmi'
 import { createAppKit } from '@reown/appkit'
 
 const projectId = 'YOUR_PROJECT_ID'
@@ -96,11 +101,10 @@ const metadata = {
   icons: ['https://avatars.githubusercontent.com/u/179229932'],
 }
 
-// EVM adapter (eip155)
-const hederaEVMAdapter = new HederaAdapter({
-  projectId,
+// EVM adapter using Reown's WagmiAdapter
+const evmAdapter = new WagmiAdapter({
   networks: [HederaChainDefinition.EVM.Mainnet, HederaChainDefinition.EVM.Testnet],
-  namespace: 'eip155',
+  projectId,
 })
 
 // Native adapter (hedera namespace)
@@ -116,7 +120,7 @@ const universalProvider = (await HederaProvider.init({
 })) as unknown as UniversalProvider
 
 const appKit = createAppKit({
-  adapters: [hederaEVMAdapter, hederaNativeAdapter],
+  adapters: [evmAdapter, hederaNativeAdapter],
   // @ts-expect-error expected type mismatch
   universalProvider,
   projectId,
@@ -155,26 +159,15 @@ appKit.subscribeCaipNetworkChange((network) => {
 6. Sign a message (EVM):
 
 ```typescript
-const address = appKit.getAddress()
-const provider = hederaEVMAdapter.getWalletConnectProvider()
-
-const signature = await hederaEVMAdapter.signMessage({
-  message: 'Hello from my Hedera dApp!',
-  address,
-  provider,
-})
+// With WagmiAdapter, use standard wagmi/viem actions for EVM operations.
+// See https://docs.reown.com/appkit/recipes/wagmi for more examples.
 ```
 
 7. Get balance:
 
 ```typescript
-const address = appKit.getAddress()
-const network = appKit.getCaipNetwork()
-
-const { balance, symbol } = await hederaEVMAdapter.getBalance({
-  address,
-  caipNetwork: network,
-})
+// With WagmiAdapter, use standard wagmi hooks or actions (e.g., useBalance, getBalance)
+// to query balances on Hedera's EVM layer.
 ```
 
 8. Sign and execute a Hedera native transaction:

package/dist/reown/adapter.d.ts

@@ -36,12 +36,32 @@ export declare class HederaAdapter extends AdapterBlueprint {
     syncConnections(_params: AdapterBlueprint.SyncConnectionsParams): Promise<void>;
     getBalance(params: AdapterBlueprint.GetBalanceParams): Promise<AdapterBlueprint.GetBalanceResult>;
     signMessage(params: AdapterBlueprint.SignMessageParams): Promise<AdapterBlueprint.SignMessageResult>;
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     estimateGas(params: AdapterBlueprint.EstimateGasTransactionArgs): Promise<AdapterBlueprint.EstimateGasTransactionResult>;
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     sendTransaction(params: AdapterSendTransactionParams): Promise<AdapterBlueprint.SendTransactionResult>;
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     writeContract(params: AdapterBlueprint.WriteContractParams): Promise<AdapterBlueprint.WriteContractResult>;
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     getEnsAddress(params: GetEnsAddressParams): Promise<GetEnsAddressResult>;
     parseUnits(params: AdapterBlueprint.ParseUnitsParams): AdapterBlueprint.ParseUnitsResult;
     formatUnits(params: AdapterBlueprint.FormatUnitsParams): AdapterBlueprint.FormatUnitsResult;
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     getCapabilities(params: AdapterBlueprint.GetCapabilitiesParams): Promise<unknown>;
     getProfile(): Promise<GetProfileResult>;
     grantPermissions(): Promise<unknown>;

package/dist/reown/adapter.js

@@ -13,6 +13,8 @@ export class HederaAdapter extends AdapterBlueprint {
             throw new Error('Namespace must be "hedera" or "eip155"');
         }
         if (params.namespace == 'eip155') {
+            console.warn('HederaAdapter with namespace "eip155" is deprecated and will be removed in the next major version. ' +
+                'Use WagmiAdapter from @reown/appkit-adapter-wagmi for EVM wallet connectivity instead.');
             if ((_a = params.networks) === null || _a === void 0 ? void 0 : _a.some((n) => n.chainNamespace != 'eip155')) {
                 throw new Error('Invalid networks for eip155 namespace');
             }
@@ -325,6 +327,10 @@ export class HederaAdapter extends AdapterBlueprint {
         }
         return { signature };
     }
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     async estimateGas(params) {
         const { caipNetwork, address } = params;
         if (this.namespace !== 'eip155') {
@@ -353,6 +359,10 @@ export class HederaAdapter extends AdapterBlueprint {
         }, address, Number(caipNetwork === null || caipNetwork === void 0 ? void 0 : caipNetwork.id));
         return { gas: result };
     }
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     async sendTransaction(params) {
         var _a, _b;
         if (this.namespace !== 'eip155') {
@@ -386,6 +396,10 @@ export class HederaAdapter extends AdapterBlueprint {
         }, params.address, Number((_b = params.caipNetwork) === null || _b === void 0 ? void 0 : _b.id));
         return { hash: tx };
     }
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     async writeContract(params) {
         if (this.namespace !== 'eip155') {
             throw new Error('Namespace is not eip155');
@@ -414,6 +428,10 @@ export class HederaAdapter extends AdapterBlueprint {
         else
             throw new Error('Contract method is undefined');
     }
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     async getEnsAddress(params) {
         if (this.namespace !== 'eip155') {
             throw new Error('Namespace is not eip155');
@@ -434,6 +452,10 @@ export class HederaAdapter extends AdapterBlueprint {
     formatUnits(params) {
         return formatUnits(params.value, params.decimals);
     }
+    /**
+     * @deprecated This method is only used with the eip155 namespace, which is deprecated.
+     * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM operations instead.
+     */
     async getCapabilities(params) {
         var _a, _b;
         if (this.namespace !== 'eip155') {

package/dist/reown/connectors/HederaConnector.d.ts

@@ -23,6 +23,11 @@ export declare namespace HederaConnector {
     type Options = {
         provider: UniversalProvider;
         caipNetworks: CaipNetwork[];
+        /**
+         * The chain namespace for the connector.
+         * @remarks The `'eip155'` option is deprecated and will be removed in the next major version.
+         * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
+         */
         namespace: 'hedera' | 'eip155';
     };
 }

package/dist/reown/providers/EIP155Provider.d.ts

@@ -1,6 +1,11 @@
 import { EventEmitter } from 'events';
 import { SessionTypes } from '@walletconnect/types';
 import { IProvider, SessionNamespace, RpcProvidersMap, RequestParams, Namespace } from '@walletconnect/universal-provider';
+/**
+ * @deprecated EIP155Provider is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
+ * Hedera's JSON-RPC relay makes it a standard EVM chain, so no custom EVM adapter is needed.
+ */
 declare class EIP155Provider implements IProvider {
     name: string;
     client: IProvider['client'];

package/dist/reown/providers/EIP155Provider.js

@@ -3,10 +3,17 @@ import { HttpConnection } from '@walletconnect/jsonrpc-http-connection';
 import { formatJsonRpcRequest } from '@walletconnect/jsonrpc-utils';
 import { BUNDLER_URL, getChainId, HederaChainDefinition } from '../utils';
 import { createLogger } from '../../lib/shared/logger';
+/**
+ * @deprecated EIP155Provider is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
+ * Hedera's JSON-RPC relay makes it a standard EVM chain, so no custom EVM adapter is needed.
+ */
 class EIP155Provider {
     constructor({ client, events, namespace, }) {
         this.name = 'eip155';
         this.logger = createLogger('EIP155Provider');
+        this.logger.warn('EIP155Provider is deprecated and will be removed in the next major version. ' +
+            'Use WagmiAdapter from @reown/appkit-adapter-wagmi for EVM wallet connectivity instead.');
         this.namespace = namespace;
         this.events = events;
         this.client = client;

package/dist/reown/utils/constants.d.ts

@@ -4,6 +4,10 @@ export declare const BUNDLER_URL = "https://rpc.walletconnect.org/v1/bundler";
 export declare const PROVIDER_EVENTS: {
     DEFAULT_CHAIN_CHANGED: string;
 };
+/**
+ * @deprecated Eip155JsonRpcMethod is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
+ */
 export declare enum Eip155JsonRpcMethod {
     PersonalSign = "personal_sign",
     Sign = "eth_sign",

package/dist/reown/utils/constants.js

@@ -4,6 +4,10 @@ export const BUNDLER_URL = `${RPC_URL}bundler`;
 export const PROVIDER_EVENTS = {
     DEFAULT_CHAIN_CHANGED: 'default_chain_changed',
 };
+/**
+ * @deprecated Eip155JsonRpcMethod is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
+ */
 // EIP-155 Wallet Methods
 export var Eip155JsonRpcMethod;
 (function (Eip155JsonRpcMethod) {

package/dist/reown/utils/helpers.d.ts

@@ -2,11 +2,17 @@
  * Gets message from various signing request methods by filtering out
  * a value that is not an address (thus is a message).
  * If it is a hex string, it gets converted to utf8 string
+ *
+ * @deprecated This function is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
  */
 export declare function getSignParamsMessage(params: string[]): string;
 /**
  * Gets data from various signTypedData request methods by filtering out
  * a value that is not an address (thus is data).
  * If data is a string convert it to object
+ *
+ * @deprecated This function is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
  */
 export declare function getSignTypedDataParamsData(params: string[]): any;

package/dist/reown/utils/helpers.js

@@ -3,6 +3,9 @@ import { ethers } from 'ethers';
  * Gets message from various signing request methods by filtering out
  * a value that is not an address (thus is a message).
  * If it is a hex string, it gets converted to utf8 string
+ *
+ * @deprecated This function is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
  */
 export function getSignParamsMessage(params) {
     const message = params.filter((p) => !ethers.isAddress(p))[0];
@@ -15,6 +18,9 @@ export function getSignParamsMessage(params) {
  * Gets data from various signTypedData request methods by filtering out
  * a value that is not an address (thus is data).
  * If data is a string convert it to object
+ *
+ * @deprecated This function is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
  */
 export function getSignTypedDataParamsData(params) {
     const data = params.filter((p) => !ethers.isAddress(p))[0];

package/dist/reown/wallets/EIP155Wallet.d.ts

@@ -23,7 +23,8 @@ export interface EIP155WalletInterface {
     [Eip155JsonRpcMethod.SendRawTransaction](rawTransaction: string, provider: JsonRpcProvider): Promise<TransactionResponse>;
 }
 /**
- * Library
+ * @deprecated EIP155Wallet is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
  */
 export declare class EIP155Wallet implements EIP155WalletInterface {
     wallet: BaseEvmWallet;

package/dist/reown/wallets/EIP155Wallet.js

@@ -3,10 +3,13 @@ import { formatJsonRpcError, formatJsonRpcResult, } from '@walletconnect/jsonrpc
 import { getSdkError } from '@walletconnect/utils';
 import { Eip155JsonRpcMethod, HederaChainDefinition, getSignParamsMessage, getSignTypedDataParamsData, } from '..';
 /**
- * Library
+ * @deprecated EIP155Wallet is deprecated and will be removed in the next major version.
+ * Use `WagmiAdapter` from `@reown/appkit-adapter-wagmi` for EVM wallet connectivity instead.
  */
 export class EIP155Wallet {
     constructor(wallet) {
+        console.warn('EIP155Wallet is deprecated and will be removed in the next major version. ' +
+            'Use WagmiAdapter from @reown/appkit-adapter-wagmi for EVM wallet connectivity instead.');
         this.wallet = wallet;
     }
     connect(provider) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraph/hedera-wallet-connect",
-  "version": "2.1.3-canary.c6aa77e.0",
+  "version": "2.1.3",
   "description": "A library to facilitate integrating Hedera with WalletConnect",
   "repository": {
     "type": "git",
@@ -28,6 +28,7 @@
     "prettier:fix": "prettier --write ./src/"
   },
   "peerDependencies": {
+    "@hiero-ledger/proto": "^2.25.0",
     "@hiero-ledger/sdk": "2.79.0",
     "@reown/appkit": "^1.8.10",
     "@reown/appkit-controllers": "^1.8.10",
@@ -36,13 +37,12 @@
     "ethers": "^6.13.5"
   },
   "devDependencies": {
-    "@hiero-ledger/proto": "^2.25.0",
     "@swc/jest": "^0.2.37",
     "@types/jest": "^30.0.0",
     "jest": "^30.0.3",
     "nodemon": "^3.1.10",
     "prettier": "^3.8.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.2"
+    "typescript": "^6.0.2"
   }
 }