@sorandomains/holder 0.1.0 → 0.1.1

package/README.md

@@ -28,11 +28,12 @@ await me.setProfile("alice.nova", {  // the standard keys every wallet reads
 | --- | --- |
 | `setRecord` | Point your name's explicit resolver record at any address (generation-gated — stops resolving the moment the name changes hands) |
 | `setAddress` | Re-point the built-in (Registrar) resolution target |
-| `setText` / `setProfile` | Publish text records; `setProfile` writes the standard `PROFILE_KEYS` (one transaction per key) |
+| `setText` / `setProfile` / `clearText` | Publish text records; `setProfile` writes the standard `PROFILE_KEYS` (one transaction per key); records are overwrite-only on chain — `clearText` retracts by writing the empty value standard readers treat as unset |
 | `setReverse` / `clearReverse` | Claim your address→name reverse record — the contract refuses names that don't already resolve to you (`ForwardMismatch`) |
 | `setPrimary` / `clearPrimary` | Your one cross-namespace display name, re-verified on chain at every read |
 | `proposeNameTransfer` / `acceptNameTransfer` / `cancelNameTransfer` | Two-step, accept-to-move name transfers (policy-gated) |
 | `pendingNameTransfer` | Read the pending proposal |
+| `registrarOf` / `resolverOf` | Discover the namespace's attested Registrar / resolver pointer |
 
 Everything is holder-authorized **on chain** — the Resolver checks you hold
 the name right now, reverse and primary claims are authorized by the address

package/dist/index.d.ts

@@ -158,6 +158,11 @@ export declare class SoranHolder {
      * and the contract enforces that the name's forward record already
      * resolves to you (ForwardMismatch otherwise): a reverse claim on a name
      * that doesn't point back at you is spoofing, and the chain refuses it.
+     *
+     * NOTE the forward proof must be the RESOLVER's OWN record — the
+     * Registrar's built-in target (which `lookup.resolve` also honors for
+     * fresh names) does not count. On a freshly issued name, call
+     * `setRecord(name, yourAddress)` first, then `setReverse(name)`.
      */
     setReverse(name: string): Promise<Submitted>;
     /** Remove your reverse record on a namespace's resolver. */

package/dist/index.js

@@ -322,12 +322,26 @@ export class SoranHolder {
      * and the contract enforces that the name's forward record already
      * resolves to you (ForwardMismatch otherwise): a reverse claim on a name
      * that doesn't point back at you is spoofing, and the chain refuses it.
+     *
+     * NOTE the forward proof must be the RESOLVER's OWN record — the
+     * Registrar's built-in target (which `lookup.resolve` also honors for
+     * fresh names) does not count. On a freshly issued name, call
+     * `setRecord(name, yourAddress)` first, then `setReverse(name)`.
      */
     async setReverse(name) {
         const { namespace } = parseName(name);
         const resolverId = await this.resolverOf(namespace);
         const pub = await this.signer.publicKey();
-        const r = await this.invoke(resolverId, "set_reverse", [addrArg(pub), nativeToScVal(name.toLowerCase(), { type: "string" })], RESOLVER_ERRORS);
+        let r;
+        try {
+            r = await this.invoke(resolverId, "set_reverse", [addrArg(pub), nativeToScVal(name.toLowerCase(), { type: "string" })], RESOLVER_ERRORS);
+        }
+        catch (e) {
+            if (e instanceof HolderError && e.codeName === "ForwardMismatch") {
+                throw new HolderError(`${e.message} — the resolver only accepts its OWN forward record as proof; if this name still resolves via the Registrar's built-in target, call setRecord(name, yourAddress) first, then retry setReverse`, e.contractId, e.fn, e.code, e.codeName, e.txHash);
+            }
+            throw e;
+        }
         return { hash: r.hash, ledger: r.ledger };
     }
     /** Remove your reverse record on a namespace's resolver. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sorandomains/holder",
-  "version": "0.1.0",
-  "description": "Manage your own Soran name on Stellar — records, profile, reverse, primary, and transfers, signed by your key.",
+  "version": "0.1.1",
+  "description": "Manage your own Soran name on Stellar \u2014 records, profile, reverse, primary, and transfers, signed by your key.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",