Use getSingleSubname to fetch a single subname by its fully-qualified name.
Usage
const subname = await client.getSingleSubname("alice.example.eth");
Returns null if the subname doesn’t exist.
Response Fields
Unique identifier for the subname record.
Fully-qualified ENS name (e.g., alice.example.eth).
Label portion of the subname (e.g., alice).
Text records associated with the subname.
Address records keyed by coin type (SLIP-44) or chain identifier.
Custom metadata key-value pairs.
ENS namehash of the subname.
Owner address, if present.
Creation timestamp (ISO 8601).
Last update timestamp (ISO 8601).
Example Response
{
"id": "01J9Q4YF7V3M8K2P9N6D1R4T7C",
"fullName": "alice.example.eth",
"parentName": "example.eth",
"label": "alice",
"texts": { "name": "Alice", "url": "https://example.com" },
"addresses": { "60": "0x1234567890abcdef1234567890abcdef12345678" },
"metadata": { "sender": "0x1234567890abcdef1234567890abcdef12345678" },
"contenthash": null,
"namehash": "0xa9f0e1d2c3b4a5f6e8d9c0a1e2f6b7c2c3b9f5f7e8a1c3d7e1b2b3e6f2f6155f",
"owner": "0x1234567890abcdef1234567890abcdef12345678",
"ttl": 3600,
"createdAt": "2025-08-21T12:34:56.000Z",
"updatedAt": "2025-08-21T13:45:12.000Z"
}
Notes
- Returns
null when the subname cannot be found.
- For bulk queries or filtering by
owner, label, or metadata, see getFilteredSubnames.
