Digital Identity: IdentityHackathon Projects

At the intersection of blockchain and digital identity, teams and enthusiasts are challenging the status quo of online reputation and authentication. We recently wrapped up the IdentityHackathon, which showcased the potential of Web3 technologies to revolutionize digital identity.

Collaborative Spirit in the Web3 Space

The Ceramic team was excited to collaborate with the NEWFORUM team for the hackathon, in addition to an impressive lineup of ecosystem partners, such as Newcoin, Jokerace, 1kx, Lit Protocol,,, Sismo, Gitcoin, Intuition, Orbis, Cyberconnect, and Ethereum Attestation Service.

The challenge? To get hackers to utilize the tools and technologies offered by these aforementioned partners to create novel applications that transform our understanding and verification of online identity and reputation.

Spotlight on Ceramic-Integrated Solutions

We received exceptional submissions! A special mention to the following projects that incorporated Ceramic into their frameworks:

  1. Plurality. Coming in at 2nd place, Plurality pioneers a Web3 onboarding protocol. Leveraging tools like Orbis and Lit Protocol, it paves the way for social media users and content creators to transition seamlessly to Web3 social platforms, anchoring their pre-existing social reputation and interests.
  2. Respect Protocol. Securing 3rd place, Respect Protocol empowers users to sculpt their digital identity and weave a reputation graph reminiscent of SSL certificates. This innovation fosters easier navigation and interaction within the digital ecosystem.
  3. BrainShare. BrainShare, coming in at 5th place, is a decentralized protocol championed by VeramoLabs. It merges the power of Decentralized Identifiers (DIDs) and W3C Verifiable Credentials to champion data portability and harness composable reputation.
  4. Shinjitsu. Dedicated to standardizing rank and expertise within the Brazilian Jiu Jitsu community, Shinjitsu utilizes blockchain to combat rank misrepresentation and foster fairness.
  5. Orbis Chat. This application allows users to craft an AI Avatar embedded with personalized training data and their voice model. Delve deeper into users’ profiles, conversing with their AI Avatar, to uncover more about their aptitudes and inclinations.
  6. LinkedTrust. This platform, built with Ceramic, takes Web3 technology to the next level. It integrates signed attestations within a dynamic social graph. More than just stating claims, LinkedTrust is about real-time validation, ensuring every impact declared is both genuine and demonstrable.
  7. Ampy. Using Ceramic, Ampy sets out to craft the first-ever music social graph. It bestows every music aficionado with a digital music passport, enabling them to chronicle and validate their musical journey and fandom.
  8. Milky Pink Space. Built using the synergy of, Ceramic, and, Milky Pink Space stands out as a novel crypto journal. It touches upon arts, philosophy, and the multifaceted topics that underpin and influence Web3. By spotlighting identity and relationships on chain through in-depth interviews, the project fosters a richer understanding of the decentralized digital realm.

Forward and Beyond

A heartfelt thank you to all the participants of the IdentityHackathon. Your projects not only showcased the immense potential of Web3 technologies but also laid the groundwork for a more secure and decentralized digital future. We can’t wait to see the updates on your projects in the near future!

Tutorial: Getting Started With ComposeDB on Ceramic

ComposeDB on Ceramic is a decentralized, composable graph database that empowers developers to store and interact with their application data efficiently and swiftly. By integrating Ceramic infrastructure with an indexer, reusable data models, and GraphQL, ComposeDB paves the way for the creation of truly interoperable and composable Web3 applications.

The core Ceramic team recently unveiled a new CLI tool named Wheel. This tool simplifies the process of running Ceramic nodes locally. Moreover, it incorporates a straightforward Web3 social application that developers can utilize to interact with ComposeDB on Ceramic, or even leverage it as a foundation for their unique projects. This tutorial will guide you through using Wheel and the embedded example Web3 social application, enabling you to engage with ComposeDB on Ceramic in a matter of minutes.

By adhering to this guide, you will accomplish the following:

  1. Configure your development environment
  2. Run a local Ceramic node
  3. Operate a fully functional example dApp on your local machine
  4. Understand the subsequent steps to continue building on Ceramic

Let’s get started!


For this tutorial, ensure you have the following tools and resources installed on your system:

  • A code editor that suits your preferences (for example, VSCode)
  • A web browser that you’re comfortable with (we’ll be using Chrome for this guide)
  • Node.js v16 or a newer version
  • jq

After you’ve installed the necessary dependencies and prepped your development tools as outlined above, you can dive into setting up your work environment with Wheel.

Configure your working environment

When it comes to building applications using ComposeDB, it’s essential for every developer to run their own node. This step ensures your node can connect to the Ceramic Anchor Service to generate commits on a blockchain, thereby enabling seamless data composability between applications.

First, let’s create our project folder where we will keep all the files and directories used for this tutorial. Open your terminal and run the following commands:

mkdir ceramic-getting-started
cd ceramic-getting-started

The most straightforward path to configure and run a Ceramic node is through Wheel—a user-friendly CLI tool. Wheel not only allows developers to run Ceramic nodes locally, but it also walks you through the entire configuration process with a clear, easy-to-understand prompt.

Note, for more visual walkthrough, check out this video which illustrates all of the setup steps written below:

To download the Wheel on your local machine, run the command below. This command will download the Wheel in your working directory:

curl --proto '=https' --tlsv1.2 -sSf  | bash

Once downloaded, start the Wheel by running the following command:


Executing this command will kick-start the environment configuration prompt. Here, you’ll have the ability to select which Ceramic-specific dependencies you’d prefer to install, and how you’d like your Ceramic node to be configured.

If you’re brand new to ComposeDB on Ceramic, we suggest you begin with the default setup. This configuration is lightweight and easy to manage.

📌 The default configuration will run your Ceramic node in-memory, meaning it won’t connect to the Ceramic Anchor Service or create commits on a blockchain. Therefore, your app data will only be saved locally on your machine. The indexed data will be housed in a straightforward and lightweight SQLite database, requiring no additional configurations on your part. This setup serves as an excellent launchpad to start engaging with ComposeDB on Ceramic and to experiment with its features.

Simply follow the prompt and confirm the following default configurations by hitting return key on your keyboard:

  • Project Type: InMemory
  • Project Name: ceramic-test-app
  • Project Path: default
  • Include Ceramic?: Y
  • Include ComposeDB?: Y
  • Include ComposeDB Sample Application?: Y
  • Admin DID Configuration: Generate DID and Private Key
  • File to save DID private key to?: default
  • Wheel config file location: default
  • Configure Ceramic?: Defaults: Use default configuration based on network

At this point, the Wheel will start the process of installing dependencies. Once complete, you’ll be prompted with the question, Would you like Ceramic started as a daemon? (Y/n). Choose option Y. This action will fire up your local Ceramic node and construct an example app for you to experiment with. You’ll know everything is up and running smoothly if you see the following output in your terminal:

Application demo is available at 
Users/user/ceramic-getting-started/wheel/ceramic-test-app/ceramic-test-app-app. To run the demo application:
cd /Users/user/ceramic-getting-started/wheel/ceramic-test-app/ceramic-test-app-app
npm run nextDev

Keep this terminal running and now let’s dive into the example Web3 social application!

Example Web3 social application

The example Web3 social app, a simple example of decentralized Twitter, is a creation of the 3Box Labs team. It’s designed to offer developers a glimpse into how applications work with ComposeDB on Ceramic, and serves as an example of how to implement the basic core functionality using Ceramic tools.

The application comes packed with the following features:

  • Sign-in using DID Key or your Metamask wallet
  • User profile creation
  • Post creation
  • The ability to follow other users
  • Access to the posts of those you follow on an ‘Explore’ page

So, you may ask, how do you launch this application? At the end of the previous section, we noted the output you should expect to see in your terminal if everything is operating smoothly:

Application demo is available at 
/Users/user/ceramic-getting-started/wheel/ceramic-test-app/ceramic-test-app-app. To run the demo application:
cd /Users/user/ceramic-getting-started/wheel/ceramic-test-app/ceramic-test-app-app
npm run nextDev

Follow the provided instructions to navigate to the example app directory and start the application:

cd /Users/user/ceramic-getting-started/wheel/ceramic-test-app/ceramic-test-app-app
npm run nextDev

The output of this command will look similar to the one shown below.

> demo@0.1.0 nextDev
> next dev
ready - started server on, url: 

Copy the provided url http://localhost:3000 and open it in your browser. This will launch the example application in your browser for you to interact with.

Interacting with the application

Once you open the URL that your application is running on, you should be greeted with the following user interface:

Tutorial: Getting Started With ComposeDB on Ceramic

At this point ,you can start interacting with the application by choosing your authentication method. You can choose from the following options:

  • Key DID—an authentication method using did:key method
  • Ethereum DID PKH—an authentication method that uses an Ethereum wallet (e.g. Metamask)

Choose the authentication method that you prefer and start interacting with the application:

  1. Click on Profile tab and create your profile:
Tutorial: Getting Started With ComposeDB on Ceramic

2. After creating your profile, head to Home tab and create your first post:

Tutorial: Getting Started With ComposeDB on Ceramic

3. Head to Explore tab and check out currently existing posts. You should see your own post posted there:

Tutorial: Getting Started With ComposeDB on Ceramic

If other users started using your application, you would be able to see their posts in the Explore section as well. This would also give you an option to follow other users. You can simulate this behavior by logging out and signing up for the application using a different authentication method.

Explore what’s under the hood

One of the best things about this example application is that you can see everything under the hood, including all of the implementation, data models, and frontend components.

Remember the path that was provided to you by Wheel? You can find all of the application files there:

Application demo is available at 

Once you navigate to the project directory you should see the following files:

Tutorial: Getting Started With ComposeDB on Ceramic

When you navigate to the composites directory, you’ll discover all the data models utilized by this application defined using the GraphQL schema definition language. The application comes with four data models:

  • basicProfile.graphql – This data model offers a GraphQL implementation of a fundamental user profile data model
  • post.graphql – This data model provides a GraphQL implementation of a user post. It also delineates a relation to the basicProfile model
  • postsProfile.graphql – This data model establishes a relation between the basicProfile model and the post model
  • following.graphql – This data model outlines a schema for preserving the data of the users being followed. Notably, this model also defines a relation to the basicProfile model, enabling user profile data retrieval

Make sure to open these files to explore how data models are defined and how they tie to the details you see on the frontend. For example, if you open basicProfile.grapqh you’ll probably recognize the fields like name, username, description, gender and emoji you set when creating your profile:

type BasicProfile @createModel(accountRelation: SINGLE, description: "A basic Profile") {
  name: String! @string(minLength: 3, maxLength: 100)
  username: String! @string(minLength: 5, maxLength: 255)
  description: String @string(minLength: 3, maxLength: 100)
  gender: String @string(minLength: 3, maxLength: 100)
  emoji: String @string(minLength: 1, maxLength: 2)

In addition to data models, you can explore the the pages directory that contains the implementation of pages you see when you interact with the application. There you can see some examples of how Grapqhl queries are used to retrieve and display the information you see. For example, if you open the explore.ts file, you will see an example query that is used to extract the data that is displayed once your open the Explore page on your app:

query {
        postsIndex (last:300) {
          edges {
            node {
              profile {

Interact with the data using Graphiql server

As you engage with the example Web3 social app, you’re creating user data that’s stored on the Ceramic network (this depends on the project-type you selected when setting up your Ceramic node). You can smoothly interact with this data using a straightforward Graphiql server and crafting GraphQL queries. Here’s how you can accomplish this:

  1. Open a new terminal and generate a runtime representation of your composite:
npx composedb composite:compile src/__generated__/merged.json src/__generated__/runtime-composite.json

2.  Start the Graphiql server:

npx composedb graphql:server --ceramic-url=http://localhost:7007 --graphiql src/__generated__runtime-composite.json --port=5005

You will know that the server is successfully up and running if you see the following output in your terminal:

GraphQL server is listening on 

3.  Copy the provided URL and open it in your browser. This should open a Graphiql interface. This interface has 3 core parts:

  • Top left terminal for writing the GraphQL queries
  • Bottom left section for providing variables and headers for your queries
  • Section on the right for displaying the query output
Tutorial: Getting Started With ComposeDB on Ceramic

4. Run the following query to get the first 2 records of the user profile stored:

 basicProfileIndex(first: 2) {
   edges {
     node {

The output of this query looks as follows:

Tutorial: Getting Started With ComposeDB on Ceramic

Next steps

The integration of Wheel and the example Web3 app aims to provide developers with an easy starting point. It simplifies the process of running Ceramic nodes and offers a tangible application to experiment with. If you’ve followed this tutorial, here are some promising next steps to continue your journey as a Ceramic developer:

  1. Dive into the ComposeDB documentation to familiarize yourself more with the technical concepts discussed in this tutorial
  2. Interact with the data by constructing more advanced GraphQL queries, or even update an existing record by executing a mutation
  3. Launch the example app on clay-testnet which will connect your node to Ceramic Anchor Service and create commits on a blockchain. You can achieve this by selecting the clay-testnet project type when following the Wheel prompt
  4. Improve the application—introduce a new feature or use it as a foundation for your own unique project. Here are some ideas for you to consider:
  • Add a feature to “like” a post.
  • Create more sophisticated queries to filter the posts displayed on the “Explore” page
  • Introduce a feature to comment on a post

We’re eager to see what you’ll create! Don’t hesitate to share your projects with us on our community forum!