DOMAIN · Adapter
domain-namecheap
via Namecheap
Domain registration + DNS records (replace-all semantics) over HTTPS.
@openagentry/adapter-domain-namecheap npm → — · Install
Use it
# Install
$ npm install @openagentry/adapter-domain-namecheap
# Or in a workspace registered with the CLI
$ npx agentry init @openagentry/adapter-domain-namecheap — · Default export
Pattern: lazy
The default export is always a frozen DOMAINAdapter
with static category + id. Methods read env on
first call and cache the underlying instance. Missing config produces an
AgentryError at the use-site, not at import.
import default_ from '@openagentry/adapter-domain-namecheap';
// → domainAdapter — category: 'domain', id: 'domain-namecheap' — · Environment
Configuration
| Variable | Notes |
|---|---|
| NAMECHEAP_API_USER | Required. |
| NAMECHEAP_API_KEY | Optional. |
| NAMECHEAP_USERNAME | Optional. |
| NAMECHEAP_CLIENT_IP | Optional. |
Namecheap requires IP whitelisting on the API key.
— · Reported capabilities
What the manifest says
agentry capabilities --json reports these flags from
the package's openagentry.capabilities manifest block.
- dnsRecordTypes
- A,AAAA,CNAME,TXT,MX,NS,SRV
- purchase
- true
- transfer
- true
- premiumDomains
- read-only
- ipWhitelistRequired
- true
- sandbox
- true
— · Failure modes
Error codes
8 stable codes this adapter throws. Each has a one-line resolution.
-
E_NAMECHEAP_AUTHNamecheap credentials missing or rejected. -
E_NAMECHEAP_IP_NOT_WHITELISTEDCaller's IP is not on Namecheap's API allowlist. -
E_NAMECHEAP_DOMAIN_NOT_FOUNDRequested domain not found in your Namecheap account. -
E_NAMECHEAP_INVALIDNamecheap rejected the input shape. -
E_NAMECHEAP_RATE_LIMITNamecheap API rate limit reached. -
E_NAMECHEAP_NETWORKNetwork failure reaching Namecheap. -
E_NAMECHEAP_UPSTREAMNamecheap returned a non-2xx HTTP status. -
E_NAMECHEAP_SCHEMAInput failed Zod validation.