Overview

In the Moxie protocol, a user can participate in the protocol either through one of their Farcaster verified wallet (must have Moxie Pass NFT) or their respective vesting contract address (if they earn airdrops).

While a user on Farcaster is identified by their FID, a user on-chain action on the Moxie protocol is identified through their beneficiary and vesting contract addresses instead

Thus, you must be able to resolve between FIDs and their addresses, either beneficiary or vesting contract, to fetch the necessary data from the subgraphs or execute a smart contract function on the Moxie protocol.

To simplify the resolution, here we provide you with a static JSON file that you can download and include in your project.

Alternatives: API solutions

As an alternative solution, you can also use a third-party API provider, such as Airstack, to resolve the identities.

However, keep in mind that this might increase the latency of your application as you will need to make additional API calls.

Tutorials

You can follow the list of tutorials below to enable resolution between FIDs and their respective addresses when integrating the Moxie protocol:

📄️ Download Data

Download the JSON file to start resolving between FIDs and beneficiary and vesting contract addresses.

📄️ Map FID to Beneficiary Addresses

Learn how to resolve FIDs to their respective beneficiary addresses when integrating the Moxie protocol.

📄️ Map FID to Vesting Contract Addresses

Learn how to resolve FIDs to their respective vesting contract addresses when integrating the Moxie protocol.

📄️ Map Beneficiary Or Vesting Contract Addresses to FID

Learn how to resolve from vesting contract addresses or beneficiary addresses to their respective FID when integrating the Moxie protocol.