Thank you all for participating! The work from this initiative has successfully been published to:
- https://specs.walletconnect.com/2.0/blockchain-rpc/hedera-rpc
- https://www.npmjs.com/package/@hashgraph/hedera-wallet-connect?activeTab=readme
For additional support or to discuss development on other interesting projects, please email [email protected].
Great work everyone!
This library is the result of Hedera community collaboration to bring Hedera into the
WalletConnect ecosystem and vice versa. The final destination for the community supported and
governed repository will be made available under the @hashgraph organization on github.
The development branch of this repository is release/hip-820. The goal of this repository is
to be a reference for wallets and dApps integrating the WalletConnect <> Hedera JSON-RPC
reference. Additionally, this library is meant to be included in projects supporting
WalletConnect and Hedera, providing utility functions useful to validating requests and resposes
in both the WalletConnect JSON-RPC context as well as the Hedera context.
A few useful resources include:
WalletConnect brings the ecosystem together by enabling wallets and apps to securely connect and interact.
Hedera aims to be:
The open source public ledger for everyone
This package managed by the Hedera community and is intended to be a standard for ecosystem
wallets and dApp providers utilizing WalletConnect as a their
communications protocol. It utilizes the
@hashgraph/sdk and provides functions to
facilitate implementing the
WalletConnect <> Hedera JSON-RPC spec
which has been defined through the collaborative HIP process in
HIP-820.
HIP-820 has a current status of "Last Call", signifying it is in a mature review stage, or in HIP lingo - "The authors wish to finalize the HIP and appreciate feedback."
This library facilitates the implementation of the WalletConnect <> Hedera Spec which allows
wallets and dApps to natively integrate with Hedera. It provides additional, out of network
functionality with the hedera_signMessage function.
In short, it uses the Hedera javascript SDK to build transactions, serialize them, send "them over the wire" to wallets for processing and return responses back to dApps.
A message could be one of:
- a Hedera network response
- an error message
- signed transaction bytes
- signed arbitrary set of bytes
Please note, this is distinct from the Implementation of Ethereum JSON-RPC APIs for Hedera. At the time of this writing, "the Hedera JSON-RPC relay implementation is in beta, offers limited functionality today, and is only available to developers."
The relay and this library have different intentions and serve different purposes - namely native Hedera integration vs. Ethereum compatability layers to ease developer onboarding for those more familiar with the Ethereum ecosystem.
To start using WalletConnect, sign up for an account at https://cloud.walletconnect.com. You will use your project id when initializing client libraries.
It is important to understand core WalletConnect concepts when integrating this library. Please reference the WalletConnect documentation.
Upon successfully configuring your dApp and/or wallet to manage WalletConnect sessions, you can use this library’s functions to easily create and handle requests for the Hedera network.
This library provides a Wallet class that extends the Web3Wallet class provided by WalletConnect class
WalletConnect emits various events during a session. Listen to these events to synchronize the state of your application:
// Handle pairing proposals
signClient.on('session_proposal', (event) => {
// Display session proposal to the user and decide to approve or reject
})
// Handle session requests, like signing transactions or messages
signClient.on('session_request', (event) => {
// Process the session request
})
// Handle session deletions
signClient.on('session_delete', (event) => {
// React to session termination
})Pairing establishes a connection between the wallet and a dApp. Once paired, the dApp can send session requests to the wallet.
If a dApp shares a URI for pairing:
await signClient.core.pairing.pair({ uri: 'RECEIVED_URI' })Upon successful pairing, the session_proposal event will be triggered.
For a better user experience, dApps often share QR codes that wallets can scan to establish a pairing. Use a QR code scanning library to scan and obtain the URI, then proceed with pairing:
const scannedUri = '...' // URI obtained from scanning the QR code
await signClient.core.pairing.pair({ uri: scannedUri })Upon receiving a session_proposal event, display the proposal details to the user. Allow them
to approve or reject the session:
Upon receiving a session_request event, process the request. For instance, if the dApp
requests a transaction to be signed:
This repository includes a vanilla html/css/javascript implementation with a dApp and wallet example useful for testing and development while integrating WalletConnect and Hedera.
The docs site utilizes Typedoc to generate a library documentation site at https://wc.hgraph.app/docs/
The demo source code lives in ./src/examples/typescript and is available at
https://wc.hgraph.app