# Soran

- [What is Soran](https://docs.soran.domains/index.md): Soran — the Soroban Registry for Assigned Names. Namespace infrastructure on Stellar: your brand as a namespace, names for your users, ownership guarantees enforced by an immutable contract.
- [Quickstart](https://docs.soran.domains/quickstart.md): Resolve a Soran name from your app in five minutes — trustlessly, straight from the chain.
- [Names and namespaces](https://docs.soran.domains/concepts/names-and-namespaces.md): How Soran names are shaped, hashed, and stored on chain — and the two clocks that keep ownership and storage rent from ever being confused.
- [Ownership guarantees](https://docs.soran.domains/concepts/ownership-guarantees.md): Every Soran name declares what can happen to it — permanent, reclaimable, or timed — and the contract enforces the declaration. Here's each model, the glyph language, and how permanence is proven on chain.
- [Claiming a namespace](https://docs.soran.domains/concepts/claiming-a-namespace.md): Namespaces are awarded through a public, timelocked claim window — announce with evidence, survive the objection window, and the namespace is yours, irreversibly.
- [Trust model](https://docs.soran.domains/concepts/trust-model.md): What's trustless, what's hosted, and why the line between them is enforced by code rather than promised by policy.
- [Installation and configuration](https://docs.soran.domains/sdk/installation.md): Install @sorandomains/lookup, pick a network preset or bring your own RPC and contract ids.
- [Resolving names](https://docs.soran.domains/sdk/resolving-names.md): Turn alice.nova into a Stellar address — trustlessly — and re-verify it at confirm time.
- [Reverse lookup and primary names](https://docs.soran.domains/sdk/reverse-and-primary.md): Show names instead of addresses — with every answer verified by the contracts, never by a hint service.
- [Assurance](https://docs.soran.domains/sdk/assurance.md): One opt-in call that tells you whether a name's resolution is immutable — or could be repointed underneath the payer.
- [Identity & enumeration](https://docs.soran.domains/sdk/identity.md): Wallet holdings, all reverse names, standard profiles, and one-call identity aggregates — with the trust boundary of every field spelled out.
- [SDK reference](https://docs.soran.domains/sdk/reference.md): Every constructor option, method, type, and error in @sorandomains/lookup.
- [Issuing from code](https://docs.soran.domains/owner/issuing-from-code.md): Issue names to your users programmatically with @sorandomains/owner — one call per name, or up to 23 per transaction, signed by your own key.
- [Lifecycle & transfers](https://docs.soran.domains/owner/lifecycle-and-transfers.md): Reclaim, renew, treasury routing, namespace transfers, resolver pointing, and the one-way permanence door — the rest of @sorandomains/owner.
- [Managing your name](https://docs.soran.domains/holder/managing-your-name.md): Records, profile, reverse, primary, and transfers — everything a name holder does with their own key, via @sorandomains/holder.
- [For AI agents](https://docs.soran.domains/agents/access.md): MCP servers and an agent skill give AI agents first-class access to Soran — resolve and verify names, create a wallet, claim and run a namespace, and hold a verified on-chain identity.
- [API overview](https://docs.soran.domains/api/overview.md): A public, keyless HTTP read surface over Soran's on-chain state — fast to query, verifiable against the chain.
- [Resolution endpoints](https://docs.soran.domains/api/resolution.md): Resolve a name to an address, read the full name record and resolver records, and reverse-lookup an address — one GET each, no key.
- [On-chain resolution](https://docs.soran.domains/api/onchain-resolution.md): Resolve names straight from Soroban contract state — no Soran API, no SDK. Contract addresses, the node hash, and the storage layout, for explorers, indexers, and resolution services.
- [Directory](https://docs.soran.domains/api/directory.md): The cross-tenant reverse directory: one query for every name an address holds across all of Soran, and the roster of namespaces on the network.
- [Marketplace](https://docs.soran.domains/api/market.md): Buy a namespace through money-only escrow: browse listings, mint a deposit intent, pay from your own wallet, accept the on-chain transfer.
- [Status & allocations](https://docs.soran.domains/api/status.md): Component health with real freshness signals, and the public namespace claim queue with live timelock math.
- [The console](https://docs.soran.domains/platform/console.md): Sign in with a wallet, operate one or many namespaces, and delegate console access with roles — no accounts, no emails, no passwords.
- [Issuing names](https://docs.soran.domains/platform/issuing-names.md): Activate your registrar once, choose your ownership policy, then issue names one at a time or in bulk — for free, paying only Stellar's own network fees.
- [Webhooks](https://docs.soran.domains/platform/webhooks.md): Signed HTTP notifications for everything that happens in your namespace — on-chain events, archival signals, and billing and marketplace updates.
- [Billing](https://docs.soran.domains/platform/billing.md): The optional platform subscription: metered pricing, invoices paid in XLM from your own wallet, and a hard line around what non-payment can ever touch.
- [Marketplace](https://docs.soran.domains/platform/marketplace.md): Sell a namespace through escrow: list it, bond it, propose the on-chain transfer, and let settlement pay out automatically — with a verified provenance record.

## Optional

- [Lookup SDK on npm](https://www.npmjs.com/package/@sorandomains/lookup)
- [Owner SDK on npm](https://www.npmjs.com/package/@sorandomains/owner)
- [Holder SDK on npm](https://www.npmjs.com/package/@sorandomains/holder)
- [SDKs on GitHub](https://github.com/SoranDomains/sdk)