Ask the registry — domain lookup over ICANN RDAP

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_243":244,"_245":246},"routes/_app.x.$handle.$name",{"_96":95,"_31":44,"_104":86,"_26":52,"_13":14,"_105":-5,"_11":106,"_107":108,"_109":110,"_111":112,"_113":114,"_20":-5,"_115":-5,"_116":-5,"_117":24,"_118":119,"_120":24,"_121":-5,"_122":-5,"_123":124},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_31":44,"_37":45,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":24},"version",10,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_23":24},"previous","deleted",false,"deletedHere","path","backend/rdap.ts","latestPath","fileId","b8d99310-89d4-11f1-aa02-1607ee4eb77e","name","rdap.ts","fileType","script","content","import type { DomainRecord, LookupResult } from \"../shared/types.ts\";\n\n/** ICANN/IANA's authoritative map of TLD -> RDAP service. */\nconst BOOTSTRAP_URL = \"https://data.iana.org/rdap/dns.json\";\nconst BOOTSTRAP_TTL_MS = 12 * 60 * 60 * 1000;\nconst REQUEST_TIMEOUT_MS = 10_000;\n\n/**\n * Registries that run RDAP but that IANA's bootstrap file doesn't list.\n * Each entry was checked against a known-registered name in that exact TLD.\n * Never point a TLD at a service that isn't authoritative for it: a foreign\n * RDAP service answers 404, and 404 is how we read \"available\".\n */\nconst SUPPLEMENTAL_SERVICES: Record = {\n ac: \"https://rdap.identitydigital.services/rdap/\",\n de: \"https://rdap.denic.de/\",\n io: \"https://rdap.identitydigital.services/rdap/\",\n sh: \"https://rdap.identitydigital.services/rdap/\",\n};\n\ninterface BootstrapFile {\n publication: string;\n services: [string[], string[]][];\n}\n\nlet bootstrapCache: { fetchedAt: number; map: Map } | null = null;\n\nasync function getServiceMap(): Promise> {\n if (bootstrapCache && Date.now() - bootstrapCache.fetchedAt < BOOTSTRAP_TTL_MS) {\n return bootstrapCache.map;\n }\n\n const res = await fetch(BOOTSTRAP_URL, {\n signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n });\n if (!res.ok) throw new Error(`IANA bootstrap returned ${res.status}`);\n const bootstrap = (await res.json()) as BootstrapFile;\n\n const map = new Map();\n for (const [tlds, urls] of bootstrap.services) {\n const base = urls.find((u) => u.startsWith(\"https://\")) ?? urls[0];\n if (!base) continue;\n for (const tld of tlds) map.set(tld.toLowerCase(), base);\n }\n for (const [tld, base] of Object.entries(SUPPLEMENTAL_SERVICES)) {\n if (!map.has(tld)) map.set(tld, base);\n }\n\n bootstrapCache = { fetchedAt: Date.now(), map };\n return map;\n}\n\ninterface NormalizedDomain {\n domain: string;\n unicodeName?: string;\n tld: string;\n labelCount: number;\n}\n\n/**\n * Reduce whatever was typed to an ASCII (punycoded) domain name. Accepts pasted\n * URLs and IDNs; drops a leading \"www.\" since it is never registrable itself.\n */\nexport function normalizeDomain(input: string): NormalizedDomain | { error: string } {\n const raw = input.trim().replace(/^[a-z][a-z0-9+.-]*:\\/\\//i, \"\").split(/[/?#]/)[0]\n .replace(/\\.$/, \"\");\n if (!raw) return { error: \"Enter a domain name to look up.\" };\n\n let hostname: string;\n try {\n hostname = new URL(`http://${raw}`).hostname;\n } catch {\n return { error: `\"${input.trim()}\" isn't a domain name.` };\n }\n\n const domain = hostname.replace(/^www\\./, \"\");\n const labels = domain.split(\".\");\n if (labels.length < 2) {\n return { error: `Add a top-level domain — try \"${domain}.com\".` };\n }\n if (domain.length > 253 || labels.some((l) => !/^[a-z0-9-]{1,63}$/.test(l))) {\n return { error: `\"${input.trim()}\" isn't a domain name.` };\n }\n\n // URL() punycodes IDNs one way only, so keep what was typed as the unicode form.\n const typed = raw.toLowerCase().replace(/^www\\./, \"\");\n const unicodeName = domain.includes(\"xn--\") && typed !== domain ? typed : undefined;\n return { domain, unicodeName, tld: labels[labels.length - 1], labelCount: labels.length };\n}\n\nexport async function lookupDomain(query: string): Promise {\n const normalized = normalizeDomain(query);\n if (\"error\" in normalized) {\n return { query, domain: \"\", tld: \"\", status: \"invalid\", message: normalized.error };\n }\n\n const { domain, unicodeName, tld, labelCount } = normalized;\n const base = { query, domain, unicodeName, tld };\n\n const services = await getServiceMap();\n const service = services.get(tld);\n if (!service) {\n return {\n ...base,\n status: \"unsupported\",\n message:\n `IANA publishes no RDAP service for .${tld}, so the registry can't be asked directly.`,\n };\n }\n\n const url = `${service.replace(/\\/?$/, \"/\")}domain/${encodeURIComponent(domain)}`;\n const source = new URL(url).hostname;\n const answeredAt = new Date().toISOString();\n\n let res: Response;\n try {\n res = await fetch(url, {\n headers: { accept: \"application/rdap+json, application/json\" },\n signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n });\n } catch (err) {\n // A registry that is slow or down is a normal outcome here, not a bug to\n // surface as a 500 — the visitor needs to know who failed to answer.\n const reason = err instanceof DOMException && err.name === \"TimeoutError\"\n ? `${source} took longer than ${REQUEST_TIMEOUT_MS / 1000} seconds to answer.`\n : `${source} couldn't be reached.`;\n return { ...base, status: \"error\", source, message: reason };\n }\n\n if (res.status === 404) {\n return {\n ...base,\n status: \"available\",\n source,\n answeredAt,\n note: labelCount > 2\n ? `${domain} has ${labelCount} labels. If it's a subdomain, look up the name it sits under instead.`\n : undefined,\n };\n }\n\n if (res.status === 429) {\n return {\n ...base,\n status: \"error\",\n source,\n message: `${source} is rate-limiting lookups. Wait a moment and search again.`,\n };\n }\n\n if (!res.ok) {\n return {\n ...base,\n status: \"error\",\n source,\n message: `${source} answered ${res.status} ${res.statusText}.`.trim(),\n };\n }\n\n const data = await res.json();\n if (data?.errorCode === 404) {\n return { ...base, status: \"available\", source, answeredAt };\n }\n\n return {\n ...base,\n domain: typeof data?.ldhName === \"string\" ? data.ldhName.toLowerCase() : domain,\n unicodeName: typeof data?.unicodeName === \"string\" ? data.unicodeName : unicodeName,\n status: \"registered\",\n source,\n answeredAt,\n record: parseRecord(data),\n };\n}\n\nfunction parseRecord(data: any): DomainRecord {\n const registrar = (data?.entities ?? []).find((e: any) => e?.roles?.includes(\"registrar\"));\n\n return {\n registrar: vcardValue(registrar?.vcardArray, \"fn\"),\n registrarIanaId: (registrar?.publicIds ?? []).find((id: any) =>\n id?.type === \"IANA Registrar ID\"\n )?.identifier,\n registered: eventDate(data, \"registration\"),\n expires: eventDate(data, \"expiration\"),\n updated: eventDate(data, \"last changed\"),\n statuses: (data?.status ?? []).filter((s: unknown) => typeof s === \"string\"),\n nameservers: (data?.nameservers ?? [])\n .map((ns: any) => typeof ns?.ldhName === \"string\" ? ns.ldhName.toLowerCase() : null)\n .filter(Boolean),\n dnssec: data?.secureDNS?.delegationSigned ?? undefined,\n };\n}\n\nfunction eventDate(data: any, action: string): string | undefined {\n const event = (data?.events ?? []).find((e: any) => e?.eventAction === action);\n return typeof event?.eventDate === \"string\" ? event.eventDate : undefined;\n}\n\n/** vCard entries are [\"fn\", {}, \"text\", \"Registrar Name\"] tuples. */\nfunction vcardValue(vcardArray: any, field: string): string | undefined {\n const entry = (vcardArray?.[1] ?? []).find((e: any) => e?.[0] === field);\n const value = entry?.[3];\n return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n","createdAt",["D",1785168215079],"branchVersion","branchId","56b9e60d-44d2-4baf-b4cd-1a7b1ec05f36","id","a00dc9e7-a23e-4397-a1f9-3cf4c617a61f","whois",["D",1785166232232],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","b8f52b40-db4b-11ef-9fdc-e7ba3d98ed08","pinnedFileId","1ae3c4c2-89d0-11f1-8211-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"orgId","c0309a09-c920-43c3-9d64-1db94f641c1a","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_96":95,"_103":99},"org",{"_96":95,"_97":-5,"_98":99,"_18":54,"_100":101,"_102":24},"branch",{"_13":85,"_31":86,"_42":41,"_87":43,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":44,"_94":95},"isOwned",33,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","hunterparks","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yczhIY1pIYWJ5ZnVPVjgxM0R2OENRWTJlTW0ifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_42":43,"_31":44,"_37":239,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":240,"_80":241,"_82":242,"_84":24},"tree",[182,185,187,189,190,191],"files",[182,183,184,185,186,187,188,189,190,191],"counts",{"_172":136,"_173":62,"_174":136,"_175":176,"_177":178},"contents",[125,126,127,128,129,130],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":166,"_31":167,"_29":168,"_133":-5,"_40":41,"_39":169,"_134":58,"_37":170,"_13":136,"_33":158,"_35":-5,"_23":24,"_137":-5,"_26":171},{"_42":160,"_31":161,"_29":162,"_133":-5,"_40":41,"_39":163,"_134":58,"_37":164,"_13":136,"_33":158,"_35":-5,"_23":24,"_137":-5,"_26":165},{"_42":153,"_31":154,"_29":155,"_133":-5,"_40":41,"_39":156,"_134":58,"_37":157,"_13":136,"_33":158,"_35":-5,"_23":24,"_137":-5,"_26":159},{"_42":146,"_31":147,"_29":148,"_133":-5,"_40":41,"_39":149,"_134":58,"_37":150,"_13":136,"_33":20,"_35":151,"_23":24,"_137":-5,"_26":152},{"_42":139,"_31":140,"_29":141,"_133":-5,"_40":41,"_39":142,"_134":58,"_37":143,"_13":136,"_33":20,"_35":144,"_23":24,"_137":-5,"_26":145},{"_42":131,"_31":132,"_29":56,"_133":-5,"_40":41,"_39":62,"_134":24,"_37":135,"_13":136,"_33":34,"_35":52,"_23":24,"_137":44,"_26":138},"6ea9d588-74f7-4979-ad67-5d90ab943066","main.ts","parentId","latest",["D",1785166232244],0,"label",[132],"482c4167-2489-4dc5-8d09-755c0e9334ed","deno.json","b8c0f422-89d4-11f1-96e4-1607ee4eb77e",6,["D",1785168215020],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[140],"1c9e7a6c-9507-4148-bbd1-2fc34f94a828",".vtignore","b8c60a48-89d4-11f1-97dc-1607ee4eb77e",7,["D",1785168215096],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[147],"1e49960f-1466-46fa-a5e2-7137c8eecfb7","shared","b8698246-89d4-11f1-97dc-1607ee4eb77e",2,["D",1785168214472],"directory",[154],"64242c32-bb1f-495a-b292-5472fd3ed691","frontend","b898b818-89d4-11f1-9340-1607ee4eb77e",4,["D",1785168214803],[161],"57fa537f-e8b3-4f1e-b82d-2babea12af78","backend","b87e942e-89d4-11f1-97dc-1607ee4eb77e",3,["D",1785168214649],[167],"pulls","branches","forks","envVars",{"_179":156,"_181":136},"connections",{"_179":136,"_180":136},"count","unfilledCount","emptyCount",{"_42":166,"_31":167,"_29":168,"_133":-5,"_40":41,"_39":169,"_134":58,"_37":236,"_13":136,"_33":158,"_35":-5,"_23":24,"_137":-5,"_193":237,"_26":238},{"_42":228,"_31":229,"_29":230,"_133":168,"_40":41,"_39":231,"_134":58,"_37":232,"_13":136,"_33":34,"_35":233,"_23":24,"_137":-5,"_193":234,"_26":235},{"_42":224,"_31":32,"_29":30,"_133":168,"_40":41,"_39":14,"_134":58,"_37":225,"_13":136,"_33":34,"_35":36,"_23":24,"_137":-5,"_193":226,"_26":227},{"_42":160,"_31":161,"_29":162,"_133":-5,"_40":41,"_39":163,"_134":58,"_37":221,"_13":136,"_33":158,"_35":-5,"_23":24,"_137":-5,"_193":222,"_26":223},{"_42":213,"_31":214,"_29":215,"_133":162,"_40":41,"_39":216,"_134":24,"_37":217,"_13":136,"_33":20,"_35":218,"_23":24,"_137":-5,"_193":219,"_26":220},{"_42":153,"_31":154,"_29":155,"_133":-5,"_40":41,"_39":156,"_134":58,"_37":210,"_13":136,"_33":158,"_35":-5,"_23":24,"_137":-5,"_193":211,"_26":212},{"_42":202,"_31":203,"_29":204,"_133":155,"_40":41,"_39":205,"_134":24,"_37":206,"_13":136,"_33":34,"_35":207,"_23":24,"_137":-5,"_193":208,"_26":209},{"_42":146,"_31":147,"_29":148,"_133":-5,"_40":41,"_39":149,"_134":58,"_37":199,"_13":136,"_33":20,"_35":151,"_23":24,"_137":-5,"_193":200,"_26":201},{"_42":139,"_31":140,"_29":141,"_133":-5,"_40":41,"_39":142,"_134":58,"_37":196,"_13":136,"_33":20,"_35":144,"_23":24,"_137":-5,"_193":197,"_26":198},{"_42":131,"_31":132,"_29":56,"_133":-5,"_40":41,"_39":62,"_134":24,"_37":192,"_13":136,"_33":34,"_35":52,"_23":24,"_137":44,"_193":194,"_26":195},["D",1785166232244],"children",[],[132],["D",1785168215020],[],[140],["D",1785168215096],[],[147],"16752bd3-0dd5-4b5d-9550-9b265a1f4bd2","types.ts","b8b6a26a-89d4-11f1-bf8b-1607ee4eb77e",5,["D",1785168215015],"/** Shape of the /api/lookup response. Kept in shared/ as the contract the\n * frontend renders against. */\n\nexport type LookupStatus =\n | \"registered\" // the registry returned a record\n | \"available\" // the registry has no record for this name\n | \"unsupported\" // no RDAP service is published for this TLD\n | \"invalid\" // the input isn't a domain name we can query\n | \"error\"; // the registry failed to answer\n\nexport interface DomainRecord {\n registrar?: string;\n registrarIanaId?: string;\n registered?: string;\n expires?: string;\n updated?: string;\n statuses: string[];\n nameservers: string[];\n dnssec?: boolean;\n}\n\nexport interface LookupResult {\n /** What the visitor typed. */\n query: string;\n /** The normalized, punycoded name that was queried. */\n domain: string;\n /** Unicode form, when the name was an IDN. */\n unicodeName?: string;\n tld: string;\n status: LookupStatus;\n /** Hostname of the RDAP service that answered. */\n source?: string;\n /** UTC timestamp of the answer. */\n answeredAt?: string;\n record?: DomainRecord;\n /** Human-readable explanation for invalid, unsupported, and error results. */\n message?: string;\n /** Caveat worth showing alongside an otherwise good answer. */\n note?: string;\n}\n",[],[154,203],["D",1785168214472],[188],[154],"0a304bd6-280f-45b6-9100-8e1418cebbfa","index.html","b8d5c3c0-89d4-11f1-96e4-1607ee4eb77e",9,["D",1785168215223],"\n\n \n \n \n Ask the registry — domain lookup over ICANN RDAP\n \n \n \n \n \n \n \n \n \n

\n \n\n \n\n

\n\n \n

\n\n \n \n\n",[],[161,214],["D",1785168214803],[186],[161],"62a20e79-1d40-4355-836c-5dc3f1dc3c54",["D",1785168215079],[],[167,32],"163aa5f4-c617-4f00-bba3-c0982dde2551","files.ts","b8cc58f8-89d4-11f1-9e1f-1607ee4eb77e",8,["D",1785168215152],"import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n/**\n * Val Town's file helpers resolve project files through the esm.town URL of the\n * running val, which doesn't exist when the same code runs from disk. These\n * wrappers keep `deno run` working for local preview; on Val Town they hand off\n * to the standard helpers untouched.\n */\n\nconst CONTENT_TYPES: Record = {\n css: \"text/css; charset=utf-8\",\n html: \"text/html; charset=utf-8\",\n js: \"text/javascript; charset=utf-8\",\n json: \"application/json; charset=utf-8\",\n svg: \"image/svg+xml\",\n};\n\nconst isLocal = (metaUrl: string) => metaUrl.startsWith(\"file://\");\n\nexport function readProjectFile(path: string, metaUrl: string): Promise {\n if (!isLocal(metaUrl)) return readFile(path, metaUrl);\n return Deno.readTextFile(new URL(`.${path}`, metaUrl));\n}\n\nexport async function serveProjectFile(path: string, metaUrl: string): Promise {\n if (!isLocal(metaUrl)) return serveFile(path, metaUrl);\n\n const body = await Deno.readTextFile(new URL(`.${path}`, metaUrl)).catch(() => null);\n if (body === null) return new Response(\"Not found\", { status: 404 });\n\n const extension = path.split(\".\").pop() ?? \"\";\n return new Response(body, {\n headers: { \"content-type\": CONTENT_TYPES[extension] ?? \"text/plain; charset=utf-8\" },\n });\n}\n",[],[167,229],["D",1785168214649],[183,184],[167],["D",1785166232232],{"_96":95,"_103":99},{"_96":95,"_97":-5,"_98":99,"_18":54,"_100":101,"_102":24},{"_13":85,"_31":86,"_42":41,"_87":43,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":44,"_94":95},"ctx",{"_78":-5,"_122":276,"_277":278,"_279":280,"_281":24,"_282":24,"_283":24,"_284":58,"_285":-5,"_286":-7,"_287":-7,"_288":136,"_289":24,"_290":24,"_291":-5,"_292":24,"_293":24,"_294":24,"_295":-5},"ENV",{"_247":248,"_249":250,"_251":86,"_252":253,"_254":255,"_256":257,"_258":259,"_260":261,"_262":263,"_264":265,"_266":267,"_268":269,"_270":271,"_272":273,"_274":275},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v10