Skip to content

docs: add Wraith Names lifecycle guide for Stellar - #97

Merged
truthixify merged 1 commit into
wraith-protocol:developfrom
brooksdevon001-star:docs/wraith-names-lifecycle
Jul 27, 2026
Merged

docs: add Wraith Names lifecycle guide for Stellar#97
truthixify merged 1 commit into
wraith-protocol:developfrom
brooksdevon001-star:docs/wraith-names-lifecycle

Conversation

@brooksdevon001-star

Copy link
Copy Markdown
Contributor

Add Wraith Names lifecycle guide for Stellar

This guide covers the full operational lifecycle of .wraith names on Stellar — the topics most
frequently asked about on Discord that aren't covered by the existing wraith-names-stellar.mdx
resolution quick-start.

What's new

  • Name grammar & reserved names — character rules, length limits, and the three reserved-name
    categories (protocol-reserved, short squats, abuse-prevention list)
  • Registration fees — tiered XLM fee table by name length, testnet vs. mainnet behaviour,
    Soroban resource fee budgeting note
  • Expiry & renewal — TTL formula, ledger-per-year estimate, Active / Grace Period / Expired
    state machine, renewal SDK + CLI
  • Transfer — Soroban auth model, transfer event schema, Active-only constraint, SDK + CLI
  • Reverse lookup — name_of entrypoint, lookupMetaAddress() SDK helper, null-not-error semantics
  • Expiration & re-registration — in-flight payment behaviour, getNameInfo() expiry status
    check, immediate re-registration window
  • Entrypoint quick-reference table — all 8 entrypoints (register, renew, transfer, update,
    release, resolve, name_of, name_info) with mutability, fee, and auth requirements at a glance

Testing

All TypeScript snippets use the same @wraith-protocol/sdk import and agent.chat() / wraith.*
patterns as the rest of the codebase. CLI snippets use the verified testnet contract address.
Cross-links to /guides/wraith-names-stellar, /contracts/stellar#wraith-names,
/guides/stellar-fees, and /guides/stellar-mainnet-deployment all verified to exist.

Blocked / out of scope

Subdomain delegation is not covered here — it depends on the v2 contract and is already noted
as upcoming in wraith-names-stellar.mdx.
closes #74

@drips-wave

drips-wave Bot commented Jul 26, 2026

Copy link
Copy Markdown

@brooksdevon001-star Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@truthixify
truthixify merged commit 8a5f85a into wraith-protocol:develop Jul 27, 2026
2 checks passed
@truthixify

Copy link
Copy Markdown
Contributor

Merged. Full lifecycle guide covers the ground the resolution-only page was missing, nice work.

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.

Wraith Names full lifecycle guide

2 participants