Onchain Passport
How to mint your Passport Stamps onto the blockchain
Last updated
How to mint your Passport Stamps onto the blockchain
Last updated
Please note: Pushing your Passport onchain is optional. However, you may want to push onchain to a specific network to participate in some of the different onchain partner campaigns that are protected by Passport
Passport Stamps are verified offchain using Passport's server. However, they can be minted onchain.
Minting your Passport onchain creates a tamper-proof record of your Passport onchain. This is only required if you're using applications that fetch Passport data onchain.
The benefits of doing this are:
Apps that use smart contracts can easily retrieve your Passport Stamps and score
You are no longer reliant upon Passport's servers to provide your Passport credentials - they are available forever on the blockchain
Your Stamps are permanently stored on the blockchain - each app gets to choose what age of Stamp they consider to be valid
There is a one-off fee of $3 for doing this and you'll have to pay gas on the chain that you are using. While it is possible to migrate your Stamps to Ethereum Mainnet, this is also the most expensive option with respect to gas fees. Therefore, it is recommended to use a Layer 2 (for example, Optimism) where possible.
First, you will need a Passport with Stamps. If you need to create a Passport or add Stamps, please visit the Creating your Passport and Collecting Stamps pages.
With your Passport ready, visit https://app.passport.xyz/ .
You will be greeted with the option to sign in with Ethereum. Click the Sign in with Ethereum button.
Once you are signed in, you will be greeted by some information cards that you can read and click through to learn about some foundational concepts of Passport.
The third card describes the one-click option for web3 Stamps. Choosing this option will trigger a pop-up showing the web3 Stamps in your Passport. These are Stamps that can be verified by querying the blockchain, rather than relying on authorization tokens from an offchain service.
Clicking Verify checks that all your web3 Stamps are still valid.
You may also want to refresh your non-web3 Stamps too. You can do this on the next screen by clicking each Stamp.
Now you are ready to migrate your Stamps onchain! When you scroll down to the bottom of the app, you will see a button that allows you to move your valid stamps onchain. It looks like this:
Clicking this button will start the Stamp migration. You need to make sure you are connected to the chain you want to migrate onto. The chain can be selected in a dropdown menu to the right of your Ethereum address in the upper right of the app.
Your wallet will pop up a request to sign a transaction. This will incur a gas fee and Gitcoin fee ($3) so you will need to have a sufficient amount of your chosen chain's gas token to complete the transaction.
Once you sign, the transaction will execute and your Stamps will be available onchain.
A success pop-up will appear offering you the option to check your Stamps. Clicking this will redirect you to the Ethereum Attestation Service explorer, where you will see an attestation for each of your verified Stamps. This confirms that your Stamps exist on the blockchain!
Stamps are not initially verified onchain. Instead, Gitcoin's server verifies Stamp credentials and stores the data on Ceramic. These act as "ground truth" from which onchain Stamps are created. The way they move onchain is through the Ethereum Attestation Service.
The flow is as follows:
Users click a "mint onchain" button in the Passport app
The server checks that all the user's Stamps are still valid, and then creates a list of attestation requests (one for each Stamp), a signature, and a unique counter (known as a nonce) that prevents each Stamp from being minted multiple times.
The attestation requests are passed to a smart contract that checks the signature to ensure it came from a trusted server (currently the only trusted server is the same one that mints the Stamps, in other words, Passport's IAM server).
The attestation requests are passed to a smart contract, GitcoinVerifier, which checks the attestations are coming from a trusted source (in other words a Passport address) and then passes the validated requests to a second smart contract, GitcoinAttester.
The GitcoinAttester contract writes the attestation data to the Ethereum Attestation Service.
Other smart contracts, or offchain apps, can now query the data by calling functions in the GitcoinAttester contract.
