Indexer.getReceivedAttestationUIDCount
getReceivedAttestationUIDCount(address recipient, bytes32 schemaUid) external view returns (uint256) Returns the number of attestations issued to recipient under schemaUid. A cheap existence check — call this before paginating with getReceivedAttestationUIDs. The count tracks issuance only; revoked or expired attestations still increment it, so use the count as a search bound rather than a validity gate.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
recipient | address | ✓ | The recipient (subject) address — typically the user being checked for KYC/KYB. |
schemaUid | bytes32 | ✓ | The 32-byte UID of the schema you're filtering by (e.g., the KYC schema). |
Returns
Type:
uint256 Total attestations ever issued to recipient under that schema. Returns 0 if none.
Examples
viem — existence check
// Indexer canonical preinstall address: 0x1000000000000000000000000000000000000008
const INDEXER = "0x1000000000000000000000000000000000000008";
const count = await publicClient.readContract({
address: INDEXER,
abi: indexerAbi,
functionName: "getReceivedAttestationUIDCount",
args: [recipient, schemaUid],
});
if (count === 0n) {
// user has never been attested under this schema — trigger KYC onboarding
}