@hoodfi/sdk 0.0.0-stage → 0.1.1

package/dist/contenthash.js

@@ -0,0 +1,385 @@
+/**
+ * EIP-1577 contenthash — the record that turns a name into a website.
+ *
+ * Only the IPFS family is handled, which is the whole of what this site can honestly
+ * offer: names are minted here, pinned here and served through IPFS gateways here.
+ * Swarm and Arweave namespaces exist in the spec and are deliberately not accepted —
+ * writing one would produce a record we can't preview, can't link to, and can't tell
+ * an owner is working.
+ *
+ * The stored bytes are <protoCode varint><CID>, so a record is two decisions: which
+ * namespace, and a CID the gateways will accept.
+ *
+ * ## One copy, imported by three packages
+ *
+ * The site writes records on `/manage` and reads them on `/search`; the MCP worker
+ * (`mcp/src/tools.ts`) does both for agents; the gateway's share page is next. Two
+ * implementations of a byte format is the thing to avoid above all else here — a
+ * contenthash off by one byte is a *well-formed* record that resolves to nothing, on a
+ * name whose owner has no way to tell it is broken. So there is exactly one copy, this
+ * is it, and the workers import it across the repo by relative path.
+ *
+ * **Why it sits under `frontend/` rather than a top-level `shared/`:** Turbopack refuses
+ * to resolve any import that leaves its project root — a `@shared/*` alias pointing at
+ * `../shared` fails the build with "aliased to relative '../shared/…' inside of
+ * [project]/" — and Vercel builds this app with `frontend/` as its Root Directory, so a
+ * sibling directory is not guaranteed to be in the build at all. The workers have no
+ * such restriction: esbuild follows a relative path anywhere. So the file lives where
+ * the fussiest consumer can see it, and `shared/` names it for the others.
+ *
+ * **It has no bare imports on purpose.** Whoever bundles it resolves `node_modules` by
+ * walking up from *this* file, which would silently tie the workers to whatever version
+ * the site happens to have installed — and break them entirely if the site's install is
+ * missing. Everything needed is small, pure and specified: hex, base32, base58 and
+ * base36 come to ~60 lines, they are checked vector-by-vector against `multiformats` in
+ * `contenthash.test.mjs`, and being dependency-free is what lets that test run under
+ * plain `node` with nothing installed.
+ *
+ * It must also stay clean under `noUncheckedIndexedAccess`, which `mcp/` sets and the
+ * site does not. Reasonable for a parser: every index here is into attacker-supplied
+ * input.
+ */
+/** uvarint(0xe3) — ipfs-ns. */
+const IPFS_NS = [0xe3, 0x01];
+/** uvarint(0xe5) — ipns-ns. */
+const IPNS_NS = [0xe5, 0x01];
+/** Multicodecs a CID may carry for each namespace. dag-pb is a directory (a site), raw a single file. */
+const IPFS_CODECS = [0x70, 0x55];
+const IPNS_CODEC = 0x72; // libp2p-key
+/*//////////////////////////////////////////////////////////////
+                              HEX
+//////////////////////////////////////////////////////////////*/
+function hexToBytes(hex) {
+    const body = hex.startsWith("0x") ? hex.slice(2) : hex;
+    if (body.length % 2 !== 0)
+        throw new Error("Odd-length hex");
+    if (body.length > 0 && !/^[0-9a-f]+$/i.test(body))
+        throw new Error("Not hex");
+    const bytes = new Uint8Array(body.length / 2);
+    for (let i = 0; i < bytes.length; i += 1) {
+        bytes[i] = Number.parseInt(body.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+function bytesToHex(bytes) {
+    let out = "";
+    for (const byte of bytes)
+        out += byte.toString(16).padStart(2, "0");
+    return `0x${out}`;
+}
+/*//////////////////////////////////////////////////////////////
+                          MULTIBASE
+//////////////////////////////////////////////////////////////*/
+const BASE36 = "0123456789abcdefghijklmnopqrstuvwxyz";
+/** RFC 4648 base32, upper case, no padding. */
+const BASE32 = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+/** Bitcoin base58 — no 0, O, I or l, so a CID can survive being read aloud. */
+const BASE58 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+/**
+ * base-N over a big integer, for the two bases whose digits don't align to bit
+ * boundaries. Leading zero bytes are carried explicitly in both directions: a
+ * big-integer conversion drops them, and for a CID that would silently change which
+ * key the record points at.
+ */
+function bigBaseDecode(input, alphabet) {
+    const radix = BigInt(alphabet.length);
+    let value = 0n;
+    for (const char of input) {
+        const digit = alphabet.indexOf(char);
+        if (digit < 0)
+            throw new Error(`Not base${alphabet.length}`);
+        value = value * radix + BigInt(digit);
+    }
+    const bytes = [];
+    while (value > 0n) {
+        bytes.unshift(Number(value & 0xffn));
+        value >>= 8n;
+    }
+    const zero = alphabet[0];
+    for (const char of input) {
+        if (char !== zero)
+            break;
+        bytes.unshift(0);
+    }
+    return new Uint8Array(bytes);
+}
+function bigBaseEncode(bytes, alphabet) {
+    const radix = BigInt(alphabet.length);
+    let value = 0n;
+    for (const byte of bytes)
+        value = (value << 8n) | BigInt(byte);
+    let out = "";
+    while (value > 0n) {
+        out = alphabet[Number(value % radix)] + out;
+        value /= radix;
+    }
+    for (const byte of bytes) {
+        if (byte !== 0)
+            break;
+        out = `${alphabet[0]}${out}`;
+    }
+    return out;
+}
+/** base36, lowercase — multibase prefix `k`, the form IPNS names are published in. */
+function base36Decode(input) {
+    return bigBaseDecode(input, BASE36);
+}
+function base36Encode(bytes) {
+    return bigBaseEncode(bytes, BASE36);
+}
+/** base58, no checksum — the encoding inside a `Qm…` CIDv0. */
+function base58Decode(input) {
+    return bigBaseDecode(input, BASE58);
+}
+/**
+ * base32 with no padding, lowercase — multibase prefix `b`, the canonical CIDv1 form.
+ *
+ * Bit-accumulator rather than a big integer: base32's 5 bits divide into bytes, so the
+ * only thing to get right is the tail. Encoding pads the last group with zero bits;
+ * decoding drops a remainder of fewer than 8 bits rather than emitting a byte from it,
+ * which is what makes an unpadded string round-trip.
+ */
+function base32Decode(input) {
+    const upper = input.toUpperCase();
+    const bytes = [];
+    let bits = 0;
+    let value = 0;
+    for (const char of upper) {
+        const digit = BASE32.indexOf(char);
+        if (digit < 0)
+            throw new Error("Not base32");
+        value = (value << 5) | digit;
+        bits += 5;
+        if (bits >= 8) {
+            bits -= 8;
+            bytes.push((value >> bits) & 0xff);
+        }
+    }
+    return new Uint8Array(bytes);
+}
+function base32Encode(bytes) {
+    let out = "";
+    let bits = 0;
+    let value = 0;
+    for (const byte of bytes) {
+        value = (value << 8) | byte;
+        bits += 8;
+        while (bits >= 5) {
+            bits -= 5;
+            out += BASE32[(value >> bits) & 0x1f];
+        }
+    }
+    if (bits > 0)
+        out += BASE32[(value << (5 - bits)) & 0x1f];
+    return out.toLowerCase();
+}
+/*//////////////////////////////////////////////////////////////
+                            VARINT
+//////////////////////////////////////////////////////////////*/
+/** Reads an unsigned varint, returning the value and where it ended. */
+function readVarint(bytes, offset) {
+    let value = 0;
+    let shift = 0;
+    let i = offset;
+    while (i < bytes.length) {
+        const byte = bytes[i];
+        if (byte === undefined)
+            break;
+        value |= (byte & 0x7f) << shift;
+        i += 1;
+        if ((byte & 0x80) === 0)
+            return [value >>> 0, i];
+        shift += 7;
+        if (shift > 28)
+            break;
+    }
+    throw new Error("Malformed varint");
+}
+/*//////////////////////////////////////////////////////////////
+                              CID
+//////////////////////////////////////////////////////////////*/
+/**
+ * Rejects anything that isn't a well-formed CIDv1 for the namespace it claims.
+ *
+ * The length check is what catches a truncated paste. A CID is base-encoded, so half a
+ * CID decodes to bytes perfectly happily — only the multihash's own length prefix says
+ * how many bytes should have followed it, and a record written from a half-CID resolves
+ * to nothing forever with no error anywhere to explain why.
+ */
+function isValidCid(bytes, codecs) {
+    try {
+        if (bytes[0] !== 0x01)
+            return false;
+        const [codec, afterCodec] = readVarint(bytes, 1);
+        if (!codecs.includes(codec))
+            return false;
+        const [, afterHashCode] = readVarint(bytes, afterCodec);
+        const [digestLength, afterLength] = readVarint(bytes, afterHashCode);
+        return bytes.length - afterLength === digestLength && digestLength > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** Decodes any multibase form a user might paste into raw CID bytes. */
+function decodeMultibase(id) {
+    try {
+        // CIDv0 — a bare base58 multihash, always dag-pb. Kept as its own case because it
+        // has no multibase prefix at all: the leading `Qm` is part of the hash.
+        if (/^Qm[1-9A-HJ-NP-Za-km-z]{44}$/.test(id)) {
+            return new Uint8Array([0x01, 0x70, ...base58Decode(id)]);
+        }
+        if (/^b[a-z2-7]+$/i.test(id))
+            return base32Decode(id.slice(1));
+        if (/^k[0-9a-z]+$/.test(id))
+            return base36Decode(id.slice(1));
+        // A raw libp2p peer id, which is how IPNS names were published before base36.
+        if (/^1[1-9A-HJ-NP-Za-km-z]{10,}$/.test(id)) {
+            return new Uint8Array([0x01, IPNS_CODEC, ...base58Decode(id)]);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/*//////////////////////////////////////////////////////////////
+                        PUBLIC INTERFACE
+//////////////////////////////////////////////////////////////*/
+/**
+ * Reads what the registry holds. Returns null for an unset record and — deliberately —
+ * for a record in a namespace this site doesn't handle, so callers can't offer a
+ * "Visit" button pointing somewhere they were never able to check.
+ */
+export function decodeContenthash(stored) {
+    if (!stored || stored === "0x")
+        return null;
+    try {
+        const bytes = hexToBytes(stored);
+        const [namespace, offset] = readVarint(bytes, 0);
+        const cid = bytes.slice(offset);
+        if (namespace === 0xe3 && isValidCid(cid, IPFS_CODECS)) {
+            const id = `b${base32Encode(cid)}`;
+            return { protocol: "ipfs", id, uri: `ipfs://${id}` };
+        }
+        if (namespace === 0xe5 && isValidCid(cid, [IPNS_CODEC])) {
+            const id = `k${base36Encode(cid)}`;
+            return { protocol: "ipns", id, uri: `ipns://${id}` };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whatever an owner pasted -> the bytes to store, or null if it can't be one.
+ *
+ * Generous about the input because everything people copy is a different shape of the
+ * same CID: the URI form, a bare CID, a gateway link with the CID in the path, and a
+ * subdomain gateway link with it in the host. Every one of those is unambiguous, and
+ * refusing them would only teach owners to hand-edit a URL until it looks like ours.
+ */
+export function encodeContenthash(input) {
+    const parsed = parseContentInput(input);
+    if (!parsed)
+        return null;
+    const namespace = parsed.protocol === "ipfs" ? IPFS_NS : IPNS_NS;
+    return bytesToHex(new Uint8Array([...namespace, ...parsed.cid]));
+}
+/** The same parse, exposed for the editor's "what you're about to publish" preview. */
+export function parseContenthash(input) {
+    const parsed = parseContentInput(input);
+    if (!parsed)
+        return null;
+    const id = parsed.protocol === "ipfs"
+        ? `b${base32Encode(parsed.cid)}`
+        : `k${base36Encode(parsed.cid)}`;
+    return { protocol: parsed.protocol, id, uri: `${parsed.protocol}://${id}` };
+}
+function parseContentInput(input) {
+    let value = input.trim();
+    if (!value)
+        return null;
+    let protocol = null;
+    // A gateway link: the CID sits either in the path (/ipfs/<cid>) or, on a subdomain
+    // gateway, in the host (<cid>.ipfs.dweb.link).
+    const httpMatch = value.match(/^https?:\/\/([^/]+)(\/.*)?$/i);
+    if (httpMatch) {
+        const host = httpMatch[1] ?? "";
+        const path = httpMatch[2] ?? "";
+        const pathMatch = path.match(/\/(ipfs|ipns)\/([^/?#]+)/i);
+        const hostMatch = host.match(/^([^.]+)\.(ipfs|ipns)\./i);
+        // Every group read below is inside its own alternative and non-optional in the
+        // pattern, so it is present whenever the match is — but the checks are spelled out
+        // because a bundler that strips them would leave the string "undefined" being
+        // parsed as a CID.
+        if (pathMatch?.[1] && pathMatch[2]) {
+            protocol = pathMatch[1].toLowerCase();
+            value = pathMatch[2];
+        }
+        else if (hostMatch?.[1] && hostMatch[2]) {
+            protocol = hostMatch[2].toLowerCase();
+            value = hostMatch[1];
+        }
+        else {
+            return null;
+        }
+    }
+    const uriMatch = value.match(/^(ipfs|ipns):\/\/(?:(?:ipfs|ipns)\/)?(.+)$/i);
+    if (uriMatch?.[1] && uriMatch[2]) {
+        protocol = uriMatch[1].toLowerCase();
+        value = uriMatch[2];
+    }
+    // A CID can carry a trailing path — the record can't, and storing the CID alone
+    // would quietly point at a different page than the one that was pasted.
+    const id = value.replace(/\/+$/, "");
+    if (id.includes("/") || id.includes("?") || id.includes("#"))
+        return null;
+    let cid = decodeMultibase(id);
+    if (!cid)
+        return null;
+    // A `Qm…` peer id and a `Qm…` file CID are the same 34 bytes; only the prefix that
+    // was typed tells them apart, so an explicit ipns:// re-labels it as a key.
+    if (protocol === "ipns" && cid[0] === 0x01 && cid[1] === 0x70) {
+        cid = new Uint8Array([0x01, IPNS_CODEC, ...cid.slice(2)]);
+    }
+    // Otherwise the CID itself says which namespace it belongs to, and it outranks the
+    // prefix: `ipfs://k51…` is a key, not a file, however it was pasted.
+    if (isValidCid(cid, IPFS_CODECS))
+        return { protocol: "ipfs", cid };
+    if (isValidCid(cid, [IPNS_CODEC]))
+        return { protocol: "ipns", cid };
+    // Everything left is a CID in a codec no gateway would serve as a page.
+    return null;
+}
+/**
+ * A URL that serves the site today, for anyone in an ordinary browser.
+ *
+ * Deliberately a *subdomain* gateway: a path gateway (`/ipfs/<cid>/`) serves every page
+ * from one origin, so a site's own absolute links, its styles and its scripts resolve
+ * against the gateway root and the page arrives unstyled. The subdomain form gives the
+ * CID its own origin and the site loads as its author built it.
+ *
+ * Not our own Pinata gateway, which serves only what this account pinned and 403s
+ * everything else — owners publish their sites wherever they like.
+ */
+export function contentGatewayUrl(content) {
+    return `https://${content.id}.${content.protocol}.dweb.link/`;
+}
+/**
+ * The address the name itself answers on.
+ *
+ * This is the point of setting the record — the CID link above is the fallback that
+ * always works, this is the one worth telling people.
+ *
+ * `.eth.link` and `.eth.limo` both serve a hoodfi subname (verified on gm.hoodfi.eth
+ * once the first record existed) and both are run by eth.limo, so this is a naming
+ * call rather than a technical one: `.link` reads as what it is. Kept as one function
+ * so every place that shows an owner their address and sends a visitor to it can
+ * never drift apart.
+ */
+export function nameUrl(label) {
+    return `https://${label}.hoodfi.eth.link/`;
+}
+//# sourceMappingURL=contenthash.js.map

package/dist/contenthash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contenthash.js","sourceRoot":"","sources":["../src/contenthash.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createHoodfiClient, HoodfiError, type HoodfiClient, type HoodfiClientOptions, type HoodfiErrorCode, type NameCheck, type NameProfile, type SendAddress, type AddressLookup, type OwnedName, type Registration, type TxStep, type TextKey, } from './client.js';
+export { CHAINS, SEND_CHAINS, paymentCaveat, type SendChain } from './coins.js';
+export { checkHoodfiName, checkLabel, fullName, normalizeLabel, tierOf, MAX_LABEL_LENGTH, PUBLIC_MIN_LENGTH, STATUS_TEXT, type NameStatus, } from './labels.js';
+export { decodeContenthash, type ContentHash } from './contenthash.js';
+export { registrarAbi, registryAbi } from './abi.js';
+export * from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,OAAO,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,cAAc,EACd,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACpD,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createHoodfiClient, HoodfiError, } from './client.js';
+export { CHAINS, SEND_CHAINS, paymentCaveat } from './coins.js';
+export { checkHoodfiName, checkLabel, fullName, normalizeLabel, tierOf, MAX_LABEL_LENGTH, PUBLIC_MIN_LENGTH, STATUS_TEXT, } from './labels.js';
+export { decodeContenthash } from './contenthash.js';
+export { registrarAbi, registryAbi } from './abi.js';
+export * from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,WAAW,GAYZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAA;AAC/E,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,cAAc,EACd,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GAEZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAoB,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACpD,cAAc,gBAAgB,CAAA"}

package/dist/labels.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Label rules, mirroring LabelUtils.sol (and mcp/src/labels.ts). The contract enforces
+ * the same rules; this exists so a bad name fails with a sentence before any RPC call.
+ */
+export declare const MAX_LABEL_LENGTH = 32;
+/** Shortest label at the $3 floor. 1-3 characters are premium tiers ($15 / $10 / $5). */
+export declare const PUBLIC_MIN_LENGTH = 4;
+export type LabelCheck = {
+    ok: true;
+    label: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Accepts `foo`, `foo.hoodfi.eth` or `foo.eth` and returns the bare label.
+ *
+ * Only for minting, where "you typed vitalik.eth, here is vitalik.hoodfi.eth" is a
+ * convenience. Never use it to decide who to pay: see {@link checkHoodfiName}.
+ */
+export declare function normalizeLabel(input: string): string;
+export declare function checkLabel(input: string): LabelCheck;
+export type HoodfiNameCheck = {
+    ok: true;
+    labels: string[];
+    name: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * For reading or paying a name: its labels under hoodfi.eth, or a reason to refuse.
+ *
+ * Stricter than {@link normalizeLabel} on purpose. `vitalik.eth` is NOT rewritten to
+ * `vitalik.hoodfi.eth`: that is a different name anyone can mint, so "pay vitalik.eth"
+ * would pay whoever did. Only a bare label or a name ending in `.hoodfi.eth` passes.
+ */
+export declare function checkHoodfiName(input: string): HoodfiNameCheck;
+/** Tier index 0-3 (1 char, 2 chars, 3 chars, 4+). Mirrors LabelUtils.tierOf. */
+export declare function tierOf(label: string): 0 | 1 | 2 | 3;
+export declare function fullName(label: string): string;
+export type NameStatus = 'available' | 'taken' | 'locked' | 'invalid' | 'blocked';
+/** HoodfiRegistrar.status() codes, in words. */
+export declare const STATUS_TEXT: Record<number, NameStatus>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAapD;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1G;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAuB9D;AAED,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAEnD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;AAEjF,gDAAgD;AAChD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAMlD,CAAA"}

package/dist/labels.js

@@ -0,0 +1,83 @@
+/**
+ * Label rules, mirroring LabelUtils.sol (and mcp/src/labels.ts). The contract enforces
+ * the same rules; this exists so a bad name fails with a sentence before any RPC call.
+ */
+import { PARENT } from './constants.js';
+export const MAX_LABEL_LENGTH = 32;
+/** Shortest label at the $3 floor. 1-3 characters are premium tiers ($15 / $10 / $5). */
+export const PUBLIC_MIN_LENGTH = 4;
+/**
+ * Accepts `foo`, `foo.hoodfi.eth` or `foo.eth` and returns the bare label.
+ *
+ * Only for minting, where "you typed vitalik.eth, here is vitalik.hoodfi.eth" is a
+ * convenience. Never use it to decide who to pay: see {@link checkHoodfiName}.
+ */
+export function normalizeLabel(input) {
+    return input.trim().toLowerCase().replace(/\.hoodfi\.eth$/, '').replace(/\.eth$/, '');
+}
+export function checkLabel(input) {
+    const label = normalizeLabel(input);
+    if (label.length === 0)
+        return { ok: false, reason: 'Name is empty' };
+    if (label.length > MAX_LABEL_LENGTH)
+        return { ok: false, reason: `Names are at most ${MAX_LABEL_LENGTH} characters` };
+    if (!/^[a-z0-9-]+$/.test(label))
+        return {
+            ok: false,
+            reason: 'Names may only contain a-z, 0-9 and hyphens. Unicode and uppercase are rejected on-chain.',
+        };
+    if (label.startsWith('-') || label.endsWith('-'))
+        return { ok: false, reason: 'Names cannot start or end with a hyphen' };
+    return { ok: true, label };
+}
+/**
+ * For reading or paying a name: its labels under hoodfi.eth, or a reason to refuse.
+ *
+ * Stricter than {@link normalizeLabel} on purpose. `vitalik.eth` is NOT rewritten to
+ * `vitalik.hoodfi.eth`: that is a different name anyone can mint, so "pay vitalik.eth"
+ * would pay whoever did. Only a bare label or a name ending in `.hoodfi.eth` passes.
+ */
+export function checkHoodfiName(input) {
+    const name = input.trim().toLowerCase();
+    const suffix = `.${PARENT}`;
+    let labels;
+    if (name.endsWith(suffix))
+        labels = name.slice(0, -suffix.length).split('.');
+    else if (!name.includes('.'))
+        labels = [name];
+    else if (name === PARENT)
+        return { ok: false, reason: `${PARENT} is the parent name itself, not a name anyone holds.` };
+    else if (name.endsWith('.eth'))
+        return {
+            ok: false,
+            reason: `${name} is not a hoodfi.eth name. ${name.slice(0, -'.eth'.length)}${suffix} would be a different name, possibly held by someone else, so it is not substituted. Resolve ${name} with ENS on Ethereum instead.`,
+        };
+    else
+        return {
+            ok: false,
+            reason: `"${name}" is not a hoodfi.eth name. Give a bare name ("gm") or the full name ending in ${suffix} ("jack.gm${suffix}").`,
+        };
+    for (const label of labels) {
+        const check = checkLabel(label);
+        if (!check.ok)
+            return { ok: false, reason: `"${label}": ${check.reason}` };
+        // checkLabel would also strip a trailing ".eth"; a label here never contains a dot.
+    }
+    return { ok: true, labels, name: `${labels.join('.')}${suffix}` };
+}
+/** Tier index 0-3 (1 char, 2 chars, 3 chars, 4+). Mirrors LabelUtils.tierOf. */
+export function tierOf(label) {
+    return (label.length >= 4 ? 3 : label.length - 1);
+}
+export function fullName(label) {
+    return `${label}.${PARENT}`;
+}
+/** HoodfiRegistrar.status() codes, in words. */
+export const STATUS_TEXT = {
+    0: 'available',
+    1: 'taken',
+    2: 'locked',
+    3: 'invalid',
+    4: 'blocked',
+};
+//# sourceMappingURL=labels.js.map

package/dist/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"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"}

package/dist/xrp.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The two shapes ENSIP-9 stores for the XRP Ledger, and nothing else.
+ *
+ * The library's coder is base58check over the XRP alphabet and checks the checksum but
+ * not the payload, and the XRPL uses that same encoding for its *secrets*: a family
+ * seed (`s…`, version 0x21) and an ed25519 seed (`sEd…`) decode just as cleanly as an
+ * address. Without this, someone pasting the wrong line from their wallet export would
+ * publish their seed in a public record. Testnet X-addresses (`T…`) are refused too —
+ * a payment record that resolves to a testnet account loses whatever is sent to it.
+ *
+ * - r-address: version 0x00 + 20-byte account ID = 21 bytes.
+ * - X-address (mainnet): 0x05 0x44 + account ID + tag flag (0/1) + 4-byte tag + 4
+ *   reserved zero bytes = 31 bytes. It carries the destination tag inside it.
+ *
+ * Its own module, with no imports of ours, so `xrp.test.mjs` can load it directly.
+ * `frontend/lib/ens.ts` applies the same rule — see the header of coins.ts for why the
+ * policy is duplicated rather than shared.
+ */
+export declare function isXrpRecord(bytes: Uint8Array): boolean;
+/** Address text -> stored bytes. Throws on anything but a mainnet r- or X-address. */
+export declare function decodeXrpRecord(value: string): Uint8Array;
+/** Stored bytes -> address text. Throws on bytes that are not one of the two shapes. */
+export declare function encodeXrpRecord(bytes: Uint8Array): string;
+//# sourceMappingURL=xrp.d.ts.map

package/dist/xrp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrp.d.ts","sourceRoot":"","sources":["../src/xrp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMtD;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAIzD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGzD"}

package/dist/xrp.js

@@ -0,0 +1,43 @@
+/**
+ * The two shapes ENSIP-9 stores for the XRP Ledger, and nothing else.
+ *
+ * The library's coder is base58check over the XRP alphabet and checks the checksum but
+ * not the payload, and the XRPL uses that same encoding for its *secrets*: a family
+ * seed (`s…`, version 0x21) and an ed25519 seed (`sEd…`) decode just as cleanly as an
+ * address. Without this, someone pasting the wrong line from their wallet export would
+ * publish their seed in a public record. Testnet X-addresses (`T…`) are refused too —
+ * a payment record that resolves to a testnet account loses whatever is sent to it.
+ *
+ * - r-address: version 0x00 + 20-byte account ID = 21 bytes.
+ * - X-address (mainnet): 0x05 0x44 + account ID + tag flag (0/1) + 4-byte tag + 4
+ *   reserved zero bytes = 31 bytes. It carries the destination tag inside it.
+ *
+ * Its own module, with no imports of ours, so `xrp.test.mjs` can load it directly.
+ * `frontend/lib/ens.ts` applies the same rule — see the header of coins.ts for why the
+ * policy is duplicated rather than shared.
+ */
+import { decodeXrpAddress, encodeXrpAddress, } from '@ensdomains/address-encoder/coders';
+export function isXrpRecord(bytes) {
+    if (bytes.length === 21)
+        return bytes[0] === 0x00;
+    if (bytes.length !== 31 || bytes[0] !== 0x05 || bytes[1] !== 0x44)
+        return false;
+    const flag = bytes[22];
+    if (flag !== 0 && flag !== 1)
+        return false;
+    return bytes.slice(27).every((b) => b === 0);
+}
+/** Address text -> stored bytes. Throws on anything but a mainnet r- or X-address. */
+export function decodeXrpRecord(value) {
+    const bytes = decodeXrpAddress(value);
+    if (!isXrpRecord(bytes))
+        throw new Error('not an XRP Ledger address');
+    return bytes;
+}
+/** Stored bytes -> address text. Throws on bytes that are not one of the two shapes. */
+export function encodeXrpRecord(bytes) {
+    if (!isXrpRecord(bytes))
+        throw new Error('not an XRP Ledger address');
+    return encodeXrpAddress(bytes);
+}
+//# sourceMappingURL=xrp.js.map

package/dist/xrp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrp.js","sourceRoot":"","sources":["../src/xrp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oCAAoC,CAAA;AAE3C,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC/E,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAA;IACtB,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IACrE,OAAO,KAAK,CAAA;AACd,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IACrE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC"}