aptos-pfp
Description
The Aptos Profile Picture Protocol allows Aptos users to set a single Token-standard NFT as a universal PFP for the Aptos blockchain.
Individual Aptos protocols can use the documentation below both to show PFPs in their FE, and to provide functionality within their own FE to allow users to set a new PFP.
Example
import { AptosClient } from 'aptos';
import { getProfilePicture } from 'aptos-pfp';
const client = new AptosClient('https://fullnode.devnet.aptoslabs.com');
const walletAddress = '0xe4f6a3e6d9735d2c561949090df0a332b648462017d88835e60afed507412e51';
const { isAvailable, url } = await getProfilePicture(client, walletAddress);
API
Get the wallet's profile picture
function getProfilePicture (client: AptosClient, address: string, config: ProfilePictureConfig): Promise<ProfilePicture>
Params
-
client
- Aptos client object -
address
- The address of the wallet -
config
(optional)-
fallback
- Boolean, use a fallback generated image (defaulttrue
) -
resize
- Object with Cloudflare image resize params (default{ width: 100 }
)
-
Return value
Object with the following fields:
-
isAvailable
- Boolean,true
if there is a profile picture for the given wallet -
url
- The URL of the profile image, always populated (either a fallback image or an empty-image icon), you can choose to ignore it ifisAvailable
is false -
name
- NFT name (only ifisAvailable: true
) -
address
- Owner address -
tokenId
- The NFT token identifier (only ifisAvailable: true
)
Transaction for setting an NFT for the profile picture
function createSetProfilePicturePayload (tokenId: TokenId): Promise<TransactionPayloadEntryFunction>
Params
-
tokenId
- The NFT token identifier
Return value
A entry function transaction payload object
Transaction for unsetting the profile picture
function createUnsetProfilePicturePayload (): Promise<TransactionPayloadEntryFunction>
Return value
A entry function transaction payload object