Skip to Content
UsageMapDocs

Wallet analytics

See how many people open your wallet dialog, connect, sign and submit, by wallet type, without recording a single address.

The wallet adapters turn your Stellar wallet library's calls into a wallet funnel: dialog opened → wallet selected → connected → sign requested → approved or rejected → transaction submitted.

No addresses, ever

The adapters send only fixed categories: wallet type, network, outcome and a duration bucket. They never send addresses, transaction hashes, XDR, amounts, memos or error messages.

Stellar Wallets Kit

Attach the adapter once, after the tracker has started:

analytics.ts
import { init } from "@scf-analytics/tracker";
import { attachWalletsKit } from "@scf-analytics/tracker/wallets-kit";
import { StellarWalletsKit } from "@creit.tech/stellar-wallets-kit";

init({ site: "YOUR_SITE_KEY" });
const detach = attachWalletsKit(StellarWalletsKit); // call detach() to undo

It works with Stellar Wallets Kit 2.x, including references to signTransaction that your app copied before attaching (as Scaffold Stellar does). For kit versions up to 1.9.5, use attachWalletsKitV1.

The adapters ship in the npm package, which is not yet on the public npm registry.

Other wallets and passkeys

If you use a wallet's own API instead of the kit, wrap it:

import { wrapFreighter } from "@scf-analytics/tracker/wallets";

Available: wrapFreighter, wrapAlbedo, wrapXBull, wrapLobstr, wrapHana, wrapHot, and wrapInjected with detectInjectedWallet for other injected wallets.

What is recorded

EventWhen
wallet_modal_opened, wallet_modal_closedThe wallet dialog opens or closes
wallet_selectedThe visitor picks a wallet
wallet_connect, wallet_disconnectA wallet connects or disconnects
sign_requested, sign_approved, sign_rejectedA signature is asked for, given or refused
tx_submittedA transaction is sent to the network
smart_wallet_created, passkey_usedPasskey and smart-wallet activity

Signing, submission and passkey events are counted per day only: they are never attached to a visit, so nobody can link a signature to a browsing session.

Where to see it

Open your website and choose the Wallets tab. You'll see the funnel, a breakdown By wallet type (Freighter, Albedo, xBull, LOBSTR, Hana, HOT, Rabet, WalletConnect, Ledger, Trezor, …) and a network filter. If you also register your contracts, their on-chain counts are shown next to the funnel.

On this page