Skip to content
3Box Hub App: User profiles and storage drive
Branch: master
Clone or download
Latest commit ebfbec0 Jul 19, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci change options for build Jan 25, 2019
.github/ISSUE_TEMPLATE Merge pull request #51 from uport-project/bug-template/3box-dapp/add Oct 1, 2018
public remove default headers Jul 16, 2019
src refresh s3 Jul 19, 2019
.babelrc update feed Oct 17, 2018
.env showing all metadata except for when over limit Feb 6, 2019
.eslintrc.js handle eslint error Dec 7, 2018
.flowconfig update feed Oct 17, 2018
.gitignore Open Source the World and Enjoy the Moment Aug 31, 2018
.jshintrc spaces in activity feed Apr 22, 2019
LICENSE Update LICENSE Feb 13, 2019 Merge pull request #389 from kuhnchris/patch-2 Apr 29, 2019 fix script merge conflict Jan 23, 2019
package.json build fix dynamic import Jul 16, 2019
static.json update file structure Sep 18, 2018
webpack.config.js code splitting for speed Jul 16, 2019

Twitter Follow Discord CircleCI Greenkeeper badge

3Box Profiles Application

This is the home of the 3Box Profiles Application, which is deployed at and works on all standard web3-compatible browsers. The 3Box Profiles Application is built on top of the 3Box user data network and allows users to:

  • create a social web3 profile, which they can use to sign in to Ethereum applications
  • store and manage their information on IPFS, in OrbitDB instances
  • verify their Github and Twitter social accounts for use throughout the web3 dapp ecosystem
  • view their unified, integrated Ethereum and 3Box activity feed

Getting Started

For an overview of 3Box and all of our components, check out the main 3Box project repo.

3Box Profiles App Hero Image


Create a Social Profile

The primary feature of the 3Box Profiles App is that it allows Ethereum users to create a shareable social profile for their Ethereum account. 3Box profiles consist of various public and private information saved by the user and other applications (with the user's consent).

Public Profile

Public profiles are available for all to see. The 3Box Profiles App allows users to add a name, image, description, emoji, twitter, github, education, and work history to their public profile. Third-party applications can save additional information to the user's public profile as well, such as public group affiliations, using the 3Box.js API. Public profiles are available for all to query using the getProfile() method in the 3Box.js API, even without the user's consent – since the information is public.

Private Profile

Private profiles consist of encrypted data and are only made available to specific third-party applications that the user approves. The 3Box Profiles App offers users the ability save email and birthday to their private profile, however applications can save additional information there as well.

View Your Activity Feed

User activity feeds in the Profiles App display a simple, unified view on a user's activity across all Ethereum networks and the 3Box network. The 3Box activity feed relies on the 3box-js getProfile() method and the MetaMask contract metadata library to replace hexadecimal Ethereum addresses with more user-friendly information.

Verify Your Web2 Social Accounts

The Profiles App allows users to verify certain important attributes of their profile so other users and third-party apps can be more confident in the information that users claim about themselves. Users' Twitter and Github account handles are verified and saved to their public profile, while emails are verified and saved to the private profile. The code for verifications can be found at 3box-verifications. Verifications follow decentralized identity (DID) standards proposed by the decentralized identity foundation (DIF), and are issued as JWTs.

Technical Components


The 3Box Profiles App uses the 3Box.js API (3box-js) for all interactions with the 3Box user data network, including setting, getting, and removing information.

3Box Verifications

The Profiles App relies on the 3box-verifications library to issue and verify Github, Twitter, and Email claims.

3Box Activity

The activity feed populates 3Box activity using 3box-js and Ethereum activity using the 3box-activity library. The 3box-activity library is a wrapper on the Etherscan API which presents public network activity.

You can’t perform that action at this time.