Fetching Wearers

getWearer

Get a Wearer by its address.

const wearer = await hatsSubgraphClient.getWearer({
    chainId,
    wearerAddress,
    props,
});

Arguments:

{
    chainId: number;
    wearerAddress:`0x${string}`;
    props: WearerPropsConfig;
}

chainId - ID of the chain to fetch from.
wearerAddress - Wearer's address.
props - Wearer's properties to fetch, including the ones of nested objects. Check the type for the available properties and query filters.

Response:

Wearer

Example:

const res = await client.getWearer({
  chainId: 10, // optimism
  wearerAddress: "0x1230000000000000000000000000000000000000",
  props: {
    currentHats: { // get the wearer's hats
      props: {
        status: true, // for each hat, include its status (active/inactive)
      },
    },
    mintEvent: { // get the wearer's hat minting events
      props: {
        blockNumber: true, // for each event, include its block number
      },
      filters: {
        first: 1, // fetch only the latest event
      },
    },
  },
});

getWearersOfHatPaginated

Paginate over the Wearers of a Hat.

const wearers = await hatsSubgraphClient.getWearersOfHatPaginated({
    chainId,
    hatId,
    props,
    page,
    perPage,
});

Arguments:

{
    chainId: number;
    hatId: bigint;
    props: WearerPropsConfig;
    page: number;
    perPage: number;
}

chainId - ID of the chain to fetch from.
hatId - ID of the hat of which wearers to fetch.
page - Number of page to fetch.
perPage - Number of Wearers to fetch in each page.

Response:

Wearer[]

Example:

// get the first 10 wearers of a given hat
const res = await client.getWearersOfHatPaginated({
  chainId: 10,
  props: {}, // for each wearer, include only its ID (address)
  hatId: BigInt("0x0000000100020001000100000000000000000000000000000000000000000000"),
  page: 0,
  perPage: 10,
});

PreviousFetching Hats NextFetching Trees

Last updated 1 year ago

const res = await client.getWearer({ chainId: 10, // optimism wearerAddress: "0x1230000000000000000000000000000000000000", props: { currentHats: { // get the wearer's hats props: { status: true, // for each hat, include its status (active/inactive) }, }, mintEvent: { // get the wearer's hat minting events props: { blockNumber: true, // for each event, include its block number }, filters: { first: 1, // fetch only the latest event }, }, }, });

// get the first 10 wearers of a given hat const res = await client.getWearersOfHatPaginated({ chainId: 10, props: {}, // for each wearer, include only its ID (address) hatId: BigInt("0x0000000100020001000100000000000000000000000000000000000000000000"), page: 0, perPage: 10, });