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

# Username

> Bind a public username or handle to a Proofable account without requiring legal identity. Keep pseudonymity, prove control.

**Verifier ID:** `ownership-pseudonym`

Claim a portable handle with a wallet signature. A public name, not a legal identity.

## Use cases

* Product handles
* Portable public names
* Pseudonymous creator identity

## Flow type

Instant. The user signs once and the pseudonym binding is created.

## Fields

| Field | Required | Notes |
| - | - | - |
| `pseudonymId` | Yes | Handle, 3–32 chars, pattern `^[a-z0-9][a-z0-9._-]{1,30}[a-z0-9]$` |
| `namespace` | No | Defaults to `proofable`. Legacy `neus` writes remap to `proofable`; existing `neus:<handle>` proofs still resolve. |
| `displayName` | No | Human-readable label |
| `metadata` | No | Optional object for app-specific attributes |

## Example

```json theme={"system"}
{
  "pseudonymId": "alice123",
  "displayName": "Alice"
}
```

## Expiry

Pseudonym proofs are time-bound: the proof includes an `expiresAt`. Re-verify to refresh before it lapses.

Full schema: [`ownership-pseudonym.json`](https://github.com/proofable/docs/blob/main/verifiers/schemas/ownership-pseudonym.json).


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