Window Wallet Communication Substrate
Last updated
Last updated
Brayden Langley (brayden@projectbabbage.com)
The Window Wallet Communication Substrate is a standardized interface that enables seamless integration between web applications and browser embedded Bitcoin wallets. It serves as a unified gateway for applications to access various wallet functionalities, including the creation of Bitcoin transactions, encryption, digital signature creation, and more. By establishing this standardized interface, applications gain the ability to support multiple wallet providers, enhancing flexibility and choice for users in managing their Bitcoin-related tasks. This interface empowers users with greater control and accessibility while maintaining compatibility across different applications and wallets.
The motivation behind this standard is to enable web browsers to directly integrate Bitcoin wallet functionality without relying on an additional application running on the client's device.
Although BRC-5 defines a standard for local communication over HTTP, integrating wallet functionality in the browser eliminates the need for external wallet applications, reducing the overhead of inter-process communication and network requests.
This also eliminates the need for users to switch between multiple applications when approving permissions, creating transactions, etc. They can perform all wallet-related tasks within the web application they are already using, resulting in a more cohesive and convenient user experience.
We define a specification for providing access to Bitcoin wallet functionality via the global window object that is directly available in all standard browser implementations.
Once the browser has verified that the user is authenticated, an object labeled CWI
should be added to the window object to provide access to the standard wallet functionality as defined by BRC-56.
For each of the message pairs (request and response) incorporated into BRC-56, we specify the existence of a corresponding message type with a specific function name:
Message Type | Window Function Name Value |
---|---|
This will allow applications to call functions with the following syntax:
We specify that all required parameters are provided in an object to the CWI functions.
Example Identity Key Request
Example Encrypt Function
Implementors of this BRC should follow the abstract messaging layer as defined by BRC-56 to provide support for standard messaging types, and then modify the window object created to include this functionality in a CWI object.
window.CWI.createAction()
window.CWI.encrypt()
window.CWI.decrypt()
window.CWI.createSignature()
window.CWI.verifySignature()
window.CWI.createCertificate()
window.CWI.proveCertificate()
window.CWI.createHmac()
window.CWI.verifyHmac()
window.CWI.getPublicKey()
window.CWI.findCertificates
window.CWI.getVersion()
window.CWI.getNetwork()
window.CWI.isAuthenticated()
window.CWI.waitForAuthentication()