Getting Started with the Passport SDK

This page provides an overview of the Gitcoin Passport SDK

The Gitcoin Passport SDK

The SDK comprises a set of libraries designed to help developers interact with the Gitcoin Passport. This section explains how to install each of the libraries with npm. To learn more about using them in your dApp, progress to the integration section.



Reads from any Passport stream (on Ceramic).
To get started, import the library and construct a passportReader instance.
You can add to your project as a module
import PassportReader from "@gitcoinco/passport-sdk-reader"
or import the bundle.
<script src="./dist/reader.bundle.js" type="script/javascript"/>
Based on initial user feedback, most communities will benefit from using the Scoring API under development rather than building a weighted scorer with the SDK. Please check back in on progress, and consider using the Scoping API as a first place to begin experimenting with Passport scoring.
Score the contents of a Passport.
To add to your project, either add with npm or yarn, or download the Git repository and install the dependencies manually.
# install dependencies
yarn add @gitcoinco/passport-sdk-scorer
yarn install
# then run webpack
yarn run webpack


The Writer is scheduled to be deprecated. Please consider building stamp integrations into the Passport App at
Writes to an authenticated DIDs Passport stream in Ceramic.
You can install the Writer library using npm or yarn. You can also download the Git repository and install dependencies manually.
# install dependencies
yarn add @gitcoinco/passport-sdk-writer
yarn install
# begin by running webpack
yarn run webpack


Shared types (used by other packages in the SDK).
To use this library, ensure @gitcoinco/passport-sdk-types is included as a package dependency. Then, import types like so :
// import sdk types
import { VerifiableCredential } from "@gitcoinco/passport-sdk-types"

Working with Ceramic

Gitcoin Passport and the Passport SDK are built on top of the Ceramic Network for data persistence. If you're new to Ceramic, check out their documents to get familiarized with the basics:
With the Passport SDK, it's not necessary to interact with Ceramic directly, but you may find it helpful for debugging or just a general understanding of the system.