Skip to main content
The Trustware SDK includes WalletConnect support out of the box via the Reown AppKit Universal Connector. A built-in project ID and sane defaults are provided, so in most cases you do not need to touch walletConnect at all. This page covers when and how to override those defaults.

WalletConnectConfig type

Properties

string
Your WalletConnect Cloud project ID. The SDK ships with a Trustware-managed default that works out of the box. Override only if you want to track your dApp’s WalletConnect stats with your own ID.
number[]
default:"[1]"
The primary chain IDs the connector will support. Defaults to [1] (Ethereum mainnet).
number[]
Additional chain IDs that the connector advertises as optional. Wallets that support these chains can switch to them without being required to at connection time.
object
Metadata for your dApp or business, shown inside the wallet during a WalletConnect session. If omitted, the connector uses generic Trustware defaults.
string
required
The display name of your dApp or business shown in the wallet.
string
A short description of your dApp or business.
string
required
The canonical URL of your dApp or business. Must be a valid https URL.
string[]
An array of icon URLs for your dApp or business. The wallet will use the first icon in the list.
string
Override the WalletConnect relay server URL. Defaults to WalletConnect’s public relay. Only change this if you are running a private relay.
boolean
default:"true"
Controls whether the SDK renders its built-in QR modal when initiating a WalletConnect session. Set to false if you want to handle the QR display yourself.
boolean
default:"false"
Set to true to disable WalletConnect entirely. The connector will not be initialized and will not appear as a connection option in the widget. Useful when your app already owns wallet state and you are using the host wallet integration pattern.

When to configure vs leave as default

Leave as default when:
  • You are prototyping or building an internal tool.
  • You are using the drop-in widget pattern and want the shortest path to production.
Override when:
  • You want your own WalletConnect dashboard stats for your dApp (optional; the Trustware-managed project ID works in production).
  • You want your dApp name and icon to appear correctly inside connected wallets.
  • You are using the host wallet integration pattern and want to disable WalletConnect to avoid duplicate connection UI.

WalletConnect via Reown AppKit

WalletConnect is handled internally through the Reown AppKit Universal Connector. The connector is initialized once when TrustwareProvider mounts. You do not need to install or configure AppKit directly; the SDK manages the integration for you.
All WalletConnect behavior in the current SDK version goes through the Reown AppKit Universal Connector. You do not need to install or configure AppKit separately.

Example

Disable WalletConnect for host-wallet integrations