@sorandomains/owner 0.4.0 → 0.5.0

package/README.md

@@ -1,5 +1,10 @@
 # @sorandomains/owner
 
+Version 0.5.0 targets Stellar SDK17 (`>=17 <18`). ASCII names
+and labels are validated before lowercase normalization; Unicode lookalikes are
+rejected. Writes continue to target the owning Registry/Registrar/Resolver. Universal
+Lookup is the read entry point in `@sorandomains/lookup` 0.5.0.
+
 Run your Soran namespace on Stellar, programmatically. Issue names to your
 users, manage their lifecycle, transfer the namespace, and — when you are
 ready — walk the one-way permanence door. Every operation is a transaction
@@ -68,3 +73,15 @@ trustless resolve, reverse lookup, and ownership assurance, with no signing
 code at all.
 
 Docs: <https://github.com/SoranDomains/docs> · License: MIT
+
+## Verified testnet deployment
+
+Verified on 2026-09-05 at ledger 4515471. Network passphrase: `Test SDF Network ; September 2015`.
+
+| Contract | Address |
+|---|---|
+| Registry | `CBSORANXTUFKBZK74AAM2ZM5OX2V7PIXUADM3HGP6WU3IDN7M3YEEDLU` |
+
+Mainnet has no deployment preset. Custom networks must supply their own verified
+addresses. Universal Lookup upgrades remain immediately executable; an address
+and ABI version do not pin the code that will execute after a governance upgrade.

package/dist/index.d.ts

@@ -40,7 +40,7 @@ export declare const DEPLOYMENTS: {
     readonly testnet: {
         readonly rpcUrl: "https://soroban-testnet.stellar.org";
         readonly passphrase: string;
-        readonly registryId: "CAUEHYVLLNNDZ4H5QWCPBDWEONRI44SI3XYSEACB4U3HYILIVQGQAMNI";
+        readonly registryId: "CBSORANXTUFKBZK74AAM2ZM5OX2V7PIXUADM3HGP6WU3IDN7M3YEEDLU";
     };
 };
 /**
@@ -75,6 +75,8 @@ export declare class OwnerError extends Error {
     readonly txHash: string | null;
     constructor(message: string, contractId?: string | null, fn?: string | null, code?: number | null, codeName?: string | null, txHash?: string | null);
 }
+/** Contract label rules: 1–63 bytes of a-z 0-9, `-` neither first nor last. */
+export declare function normalizeLabel(value: string): string;
 /** One transaction issues at most this many names (contract MAX_BATCH). */
 export declare const MAX_BATCH = 23;
 export type Submitted = {

package/dist/index.js

@@ -94,7 +94,7 @@ export const DEPLOYMENTS = {
         passphrase: Networks.TESTNET,
         // The immutable Registry. The Registrar for a namespace is discovered on
         // chain via `registrar_of(node)` — never configured by hand.
-        registryId: "CAUEHYVLLNNDZ4H5QWCPBDWEONRI44SI3XYSEACB4U3HYILIVQGQAMNI",
+        registryId: "CBSORANXTUFKBZK74AAM2ZM5OX2V7PIXUADM3HGP6WU3IDN7M3YEEDLU",
     },
 };
 /** A TxSigner over a raw secret key — for backends and scripts. */
@@ -205,6 +205,13 @@ function typedError(contractId, fn, raw, names, txHash = null) {
 // ---------------------------------------------------------------------------
 const LABEL_RE = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
 /** Contract label rules: 1–63 bytes of a-z 0-9, `-` neither first nor last. */
+export function normalizeLabel(value) {
+    if (typeof value !== "string" || /[^\x00-\x7f]/.test(value))
+        throw new OwnerError("label must contain ASCII characters only");
+    const normalized = value.toLowerCase();
+    assertLabel(normalized);
+    return normalized;
+}
 function assertLabel(label) {
     if (label.length < 1 || label.length > 63 || !LABEL_RE.test(label)) {
         throw new OwnerError(`invalid label "${label}" — 1-63 chars of a-z, 0-9, and non-edge hyphens`);
@@ -280,7 +287,7 @@ export class SoranOwner {
     // ---- discovery -----------------------------------------------------------
     /** The namespace's on-chain attested Registrar id. Cached per instance. */
     async registrarOf(namespace) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         const hit = this.registrars.get(namespace);
         if (hit && Date.now() - hit.at < SoranOwner.REGISTRAR_TTL_MS)
             return hit.value;
@@ -295,7 +302,7 @@ export class SoranOwner {
     }
     /** The namespace's current owner on the Registry, or null if unallocated. */
     async namespaceOwner(namespace) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         return (await this.read(this.registryId, "owner_of", [
             nodeArg(namehash(namespace)),
         ]));
@@ -319,7 +326,7 @@ export class SoranOwner {
     // ---- registrar: issuance -------------------------------------------------
     /** Issue `label.namespace` to `holder`. Owner-signed; term set by policy. */
     async issue(namespace, label, holder) {
-        assertLabel(label);
+        label = normalizeLabel(label);
         const registrarId = await this.registrarOf(namespace);
         const r = await this.invoke(registrarId, "issue", [labelArg(label), addrArg(holder)], REGISTRAR_ERRORS);
         return { hash: r.hash, ledger: r.ledger, node: toHex(r.returnValue) };
@@ -338,8 +345,7 @@ export class SoranOwner {
         if (entries.length > MAX_BATCH) {
             throw new OwnerError(`issueBatch: ${entries.length} entries exceeds the contract cap of ${MAX_BATCH} per transaction — split the batch`);
         }
-        for (const e of entries)
-            assertLabel(e.label);
+        entries = entries.map(e => ({ ...e, label: normalizeLabel(e.label) }));
         const registrarId = await this.registrarOf(namespace);
         const r = await this.invoke(registrarId, "issue_batch", [
             xdr.ScVal.scvVec(entries.map((e) => labelArg(e.label))),
@@ -424,14 +430,14 @@ export class SoranOwner {
      * policy never allowed it and after `make_permanent` removed it forever.
      */
     async reclaim(namespace, label) {
-        assertLabel(label);
+        label = normalizeLabel(label);
         const registrarId = await this.registrarOf(namespace);
         const r = await this.invoke(registrarId, "reclaim", [labelArg(label)], REGISTRAR_ERRORS);
         return { hash: r.hash, ledger: r.ledger };
     }
     /** Extend a finite-term name. Returns the new expiry (unix seconds). */
     async renew(namespace, label, extendSecs) {
-        assertLabel(label);
+        label = normalizeLabel(label);
         const registrarId = await this.registrarOf(namespace);
         const r = await this.invoke(registrarId, "renew", [labelArg(label), nativeToScVal(extendSecs, { type: "u64" })], REGISTRAR_ERRORS);
         return { hash: r.hash, ledger: r.ledger, expiresAt: BigInt(r.returnValue) };
@@ -463,19 +469,19 @@ export class SoranOwner {
      * accepts; re-proposing replaces the pending offer, cancel withdraws it.
      */
     async proposeNamespaceTransfer(namespace, to) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         const r = await this.invoke(this.registryId, "propose_transfer", [nodeArg(namehash(namespace)), addrArg(to)], REGISTRY_ERRORS);
         return { hash: r.hash, ledger: r.ledger };
     }
     /** Accept a namespace offered to you. Signer must be the PROPOSED owner. */
     async acceptNamespaceTransfer(namespace) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         const r = await this.invoke(this.registryId, "accept_transfer", [nodeArg(namehash(namespace))], REGISTRY_ERRORS);
         return { hash: r.hash, ledger: r.ledger };
     }
     /** Withdraw a pending namespace transfer. Current owner only. */
     async cancelNamespaceTransfer(namespace) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         const r = await this.invoke(this.registryId, "cancel_transfer", [nodeArg(namehash(namespace))], REGISTRY_ERRORS);
         return { hash: r.hash, ledger: r.ledger };
     }
@@ -484,7 +490,7 @@ export class SoranOwner {
      * Refused (ResolverFrozen) once the namespace is permanent.
      */
     async setResolver(namespace, resolver) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         const r = await this.invoke(this.registryId, "set_resolver", [nodeArg(namehash(namespace)), resolver === null ? xdr.ScVal.scvVoid() : addrArg(resolver)], REGISTRY_ERRORS);
         return { hash: r.hash, ledger: r.ledger };
     }
@@ -508,13 +514,13 @@ export class SoranOwner {
     }
     /** Current state of `label.namespace`, or null if never issued. */
     async nameState(namespace, label) {
-        assertLabel(label);
+        label = normalizeLabel(label);
         const registrarId = await this.registrarOf(namespace);
         return this.readRecord(registrarId, label);
     }
     /** The pending namespace transfer on the Registry, or null. */
     async pendingNamespaceTransfer(namespace) {
-        assertLabel(namespace);
+        namespace = normalizeLabel(namespace);
         return this.read(this.registryId, "pending_transfer", [nodeArg(namehash(namespace))]);
     }
     // ---- internals -----------------------------------------------------------

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sorandomains/owner",
-  "version": "0.4.0",
-  "description": "Run your Soran namespace on Stellar — issue names, manage lifecycle, transfer, and walk the one-way permanence door.",
+  "version": "0.5.0",
+  "description": "Run your Soran namespace on Stellar \u2014 issue names, manage lifecycle, transfer, and walk the one-way permanence door.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,7 +12,8 @@
     "build": "tsc",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "tsc",
-    "check:browser": "esbuild dist/index.js --bundle --platform=browser --external:@stellar/stellar-sdk --outfile=browser-check.js --legal-comments=none --log-level=error && node -e \"const fs=require('fs');const s=fs.readFileSync('browser-check.js','utf8');fs.unlinkSync('browser-check.js');if(/\\bBuffer\\b/.test(s)){console.error('FAIL: bare Buffer reference in browser bundle');process.exit(1)}console.log('browser bundle clean')\""
+    "check:browser": "esbuild dist/index.js --bundle --platform=browser --external:@stellar/stellar-sdk --outfile=browser-check.js --legal-comments=none --log-level=error && node -e \"const fs=require('fs');const s=fs.readFileSync('browser-check.js','utf8');fs.unlinkSync('browser-check.js');if(/\\bBuffer\\b/.test(s)){console.error('FAIL: bare Buffer reference in browser bundle');process.exit(1)}console.log('browser bundle clean')\"",
+    "test": "node --import tsx test/decode-failure.test.mts && node --import tsx --test test/integration.test.mts"
   },
   "license": "MIT",
   "repository": {