Skip to content

docs(mint-manager): document SDK v2 - #14

Merged
HAPPYS1NGH merged 5 commits into
mainfrom
docs/mint-manager-v2-published
Sep 24, 2026
Merged

HAPPYS1NGH merged 5 commits into
mainfrom
docs/mint-manager-v2-published

Conversation

@HAPPYS1NGH

Copy link
Copy Markdown
Collaborator

Changes

  • New check-name, errors, and normalization pages — v2 answers availability, price, and eligibility in one checkName call — integrators branch on MintManagerError codes instead of message text.
  • Installation, transaction parameters, mint guide, and the type-checked example updated for v2 — customRpcUrls, maxValue, and records at mint time — a moved quote fails loudly instead of being charged silently.
  • is-subname-available marked deprecated and get-mint-details gains the obstacle axis — registry ownership alone misses allowlists, reservations, and expired listings.
  • Skills page documents the mint-manager-sdk skill — agents get the check-then-mint flow and typed error codes — same skill already published in thenamespace/skills.
  • Lockfile pinned to @thenamespace/mint-manager@2.0.0 — the package is on npm now — npm ci no longer fails looking for an unpublished version.

Notes

  • Replaces draft docs(mint-manager): document SDK v2 #13, which failed the quality check on 2026-09-18 with ETARGET for @thenamespace/mint-manager@2.0.0 before the package was published.
  • Verified locally: npm ci and npm run check (validate, links, a11y, content, examples) all passed.
  • Non-visual change, so no screenshots.

Made with Cursor

HAPPYS1NGH and others added 3 commits September 24, 2026 17:23
Brings the Mint Manager docs up to @thenamespace/mint-manager 2.0.0.

New pages:
- check-name: checkName/prepareMint, the status union, the refusal-reason
  table split by obstacle (name vs minter), and the rpc policy
- errors: every MintManagerError code and how to handle it
- normalization: ENSIP-15 behaviour, the exported helpers, ENS v2 note

Updated:
- installation: customRpcUrls, logger, timeout, supported-network table
- transaction parameters: prepareMint, maxValue, records at mint time
- subname availability: marked deprecated in favour of checkName
- mint details: obstacle axis on the validation table, isTestnet deprecation
- mint-l1-l2 guide: v2 flow, price cap, typed error handling
- examples/mint-subname.ts: v2 flow, type-checked against the 2.0.0 build

Pins install commands and the devDependency to 2.0.0, which is not yet
published to npm.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S1c5DdbyBz5zPzvop9osmp
npm ci failed on the earlier draft because 2.0.0 was not on the registry yet, and the lockfile still resolved 1.1.1. The package is published now, so install matches the docs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
HAPPYS1NGH and others added 2 commits September 24, 2026 18:02
Drop brochure phrasing so the v2 pages state what the SDK does.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Replace em dashes and figurative phrasing with the behavior the SDK actually has.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@HAPPYS1NGH
HAPPYS1NGH merged commit 9349300 into main Sep 24, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant