> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity Canonicalizer Protocol • AI Agent SDK

> IdentityCanonicalizerProtocol: Reconcile a raw platform address to one stable canonical id.

# IdentityCanonicalizerProtocol

> Defined in the [**protocols**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) module.

AI Agent

Reconcile a raw platform address to one stable canonical id.

Consulted as the *first* step of identity resolution (before the session /
memory / pairing / allowlist keys are derived) so that alternate address
forms of the same person — e.g. WhatsApp's `<lid>@lid` vs
`<phone>@s.whatsapp.net` — resolve to a single principal.

Implementations MUST be deterministic and safe: return `raw_user_id`
unchanged whenever no reconciliation is known, so an adapter that cannot
map a given address never corrupts identity (fail-open to today's
behaviour). With no canonicalizer registered, resolution is unchanged.

## Methods

> [card] [canonicalize()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/IdentityCanonicalizerProtocol-canonicalize.md)
>
> Return the stable canonical id for a raw platform address.

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L3001)
>
> `praisonaiagents/gateway/protocols.py` at line 3001


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.