Quickstart

npm install @sorandomains/lookup @stellar/stellar-sdk

import { Soran } from "@sorandomains/lookup";

const soran = new Soran({ network: "testnet" });

const address = await soran.resolve("alice.nova");
// "GDHNO4WK…" — or null if unissued, expired, or the namespace has no public resolver

// Send-to-name: swap the address field for a name field.
const dest = await soran.resolve(input);
if (!dest) throw new Error("name doesn't resolve");

// Re-check at CONFIRM time — names can move between keystrokes and confirmation.
if (!(await soran.verify(input, dest))) throw new Error("resolution changed");

// Show names instead of addresses in history — contract-verified, never spoofable.
const name = await soran.reverseLookup(senderAddress);

const a = await soran.assurance("alice.nova");
// {
//   resolverLocked:   true,  // the resolver pointer can never change again
//   resolverAttested: true,  // it is the provenance-bound resolver the Registry deployed
//   resolverTainted:  false, // it has never been upgraded
//   trustworthy:      true,  // locked ∧ attested ∧ ¬tainted — resolution is immutable
// }