Skip to main content
Walley is a self-custodial wallet for the Canton Network. The @k2flabs/walley-dapp-sdk package lets your dApp connect to a user’s Walley wallet so they can approve connections, sign messages, and submit Daml transactions — all without your application ever touching their keys. The SDK is a provider adapter for the official @canton-network/dapp-sdk. You register it once with the dApp SDK’s discovery registry, and Walley becomes a selectable wallet alongside any other Canton provider your users have.

Quickstart

Install the SDK, register the adapter, and connect a wallet in a few minutes.

Provider API

Every method you can call through the provider, with request and result shapes.

Transactions & Fees

Submit Daml commands and understand Walley’s deferred network-fee model.

Ledger API

Read ledger state through the wallet’s authenticated read-only proxy.

​
How the integration works

Walley is a hosted web wallet. Rather than injecting an extension into the page, the SDK opens a popup window to walley.cc for any action that needs the user’s approval — connecting, signing a message, or reviewing and submitting a transaction. The user authenticates and approves inside that trusted Walley window, and the result is returned to your dApp. This means:
  • Your dApp never sees the user’s keys. Signing happens entirely inside Walley.
  • Every sensitive action is user-approved in a window your dApp does not control.
  • There is nothing to install. Any user with a Walley account can connect from a normal browser.
Because each interaction opens a popup, call SDK methods like connect, signMessage, and prepareExecute in response to a user gesture (such as a button click). Browsers block popups that are not triggered by user interaction.

​
What you can build

  • Connect a wallet and read the user’s party identity, public key, and network.
  • Request a signature over an arbitrary message — useful for off-chain authentication.
  • Prepare and submit Daml commands, either fire-and-forget or awaiting the committed result.
  • Query ledger state through the wallet’s authenticated read-only proxy.

​
Requirements

  • A browser-based dApp (the adapter is inactive during server-side rendering and in Node).
  • @canton-network/dapp-sdk ^0.24.0 as a peer dependency.
  • Your users each need a Walley wallet — they can create one at walley.cc.
Ready to wire it up? Head to the Quickstart.