Practical overview
When it fits
Use it when a browser application needs to connect wallet-authenticated users to 3ID account and key management, rather than implementing the iframe-based account interface itself.
Who it is for
- Developers building browser applications for Ceramic.
- Teams that want users to authenticate with a blockchain wallet and manage 3ID keys or application permissions.
Documented uses
- Connect an Ethereum wallet provider and address to a 3ID connection flow.
- Give users an interface to manage and link 3ID keys.
- Request and manage application permissions for 3ID keys.
Requirements & limits
- The documented connection flow requires an Ethereum provider and an address.
- The parent app and iframe communicate through RPC; the DID provider handles most operations.
- The basic example documents the connection call, while application-specific setup may still be required.
- Published packages are licensed under Apache-2.0 or MIT; UI dependencies may use other licenses.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Connect a browser app to 3ID using an Ethereum wallet provider
Add the documented 3ID connection call to an application using @3id/connect.
Before you start
- A browser application
- The @3id/connect package
- An Ethereum provider and an address
Steps
Install the package with npm install @3id/connect.
Import EthereumAuthProvider and ThreeIdConnect from @3id/connect.
Create an EthereumAuthProvider with the Ethereum provider and an address.
Create a ThreeIdConnect instance and call connect with the authentication provider.
Expected outcome
The application invokes the documented 3ID connection flow using the supplied wallet provider and address.
Guide limitations
- The example shows the connection call; application-specific setup may also be needed.
Compare options for Wallet connections
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| 3ID-Connect | Connect an Ethereum wallet provider and address to a 3ID connection flow. | Web | |
| Sample Project Gradle | Connect a Java web3j application to an Ethereum node. | CLI | |
| Eth Nextjs Boilerplate | Create a dApp frontend with wallet connection and an example transaction flow. | CLI, Web |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 24 October 2026
- Original website title
- ceramicstudio/js-3id · Official homepage title · retained in its source language

