@midnames/sdk 0.1.1

package/dist/managed/leaf/contract/index.d.cts

@@ -0,0 +1,142 @@
+import type * as __compactRuntime from '@midnight-ntwrk/compact-runtime';
+
+export type DomainData = { owner: { bytes: Uint8Array };
+                           resolver: { bytes: Uint8Array }
+                         };
+
+export type Either<A, B> = { is_left: boolean; left: A; right: B };
+
+export type Maybe<T> = { is_some: boolean; value: T };
+
+export type CoinInfo = { nonce: Uint8Array; color: Uint8Array; value: bigint };
+
+export type Witnesses<T> = {
+}
+
+export type ImpureCircuits<T> = {
+  update_color(context: __compactRuntime.CircuitContext<T>, c_0: Uint8Array): __compactRuntime.CircuitResults<T, []>;
+  update_cost(context: __compactRuntime.CircuitContext<T>, c_0: bigint): __compactRuntime.CircuitResults<T, []>;
+  update_target_and_fields(context: __compactRuntime.CircuitContext<T>,
+                           new_target_0: Either<{ bytes: Uint8Array },
+                                                { bytes: Uint8Array }>,
+                           kvs_0: Maybe<[string, string]>[]): __compactRuntime.CircuitResults<T, []>;
+  buy_domain_for(context: __compactRuntime.CircuitContext<T>,
+                 owner_0: { bytes: Uint8Array },
+                 domain_0: string,
+                 resolver_0: { bytes: Uint8Array },
+                 payment_0: CoinInfo): __compactRuntime.CircuitResults<T, []>;
+  add_multiple_fields(context: __compactRuntime.CircuitContext<T>,
+                      kvs_0: Maybe<[string, string]>[]): __compactRuntime.CircuitResults<T, []>;
+  insert_field(context: __compactRuntime.CircuitContext<T>,
+               k_0: string,
+               v_0: string): __compactRuntime.CircuitResults<T, []>;
+  clear_field(context: __compactRuntime.CircuitContext<T>, k_0: string): __compactRuntime.CircuitResults<T, []>;
+  clear_all_fields(context: __compactRuntime.CircuitContext<T>, domain_0: string): __compactRuntime.CircuitResults<T, []>;
+  register_domain_for(context: __compactRuntime.CircuitContext<T>,
+                      owner_0: { bytes: Uint8Array },
+                      domain_0: string,
+                      resolver_0: { bytes: Uint8Array }): __compactRuntime.CircuitResults<T, []>;
+  set_resolver(context: __compactRuntime.CircuitContext<T>,
+               domain_0: string,
+               resolver_0: { bytes: Uint8Array }): __compactRuntime.CircuitResults<T, []>;
+  update_domain_target(context: __compactRuntime.CircuitContext<T>,
+                       new_target_0: Either<{ bytes: Uint8Array },
+                                            { bytes: Uint8Array }>): __compactRuntime.CircuitResults<T, []>;
+  transfer_domain(context: __compactRuntime.CircuitContext<T>,
+                  domain_0: string,
+                  new_owner_0: { bytes: Uint8Array }): __compactRuntime.CircuitResults<T, []>;
+}
+
+export type PureCircuits = {
+}
+
+export type Circuits<T> = {
+  update_color(context: __compactRuntime.CircuitContext<T>, c_0: Uint8Array): __compactRuntime.CircuitResults<T, []>;
+  update_cost(context: __compactRuntime.CircuitContext<T>, c_0: bigint): __compactRuntime.CircuitResults<T, []>;
+  update_target_and_fields(context: __compactRuntime.CircuitContext<T>,
+                           new_target_0: Either<{ bytes: Uint8Array },
+                                                { bytes: Uint8Array }>,
+                           kvs_0: Maybe<[string, string]>[]): __compactRuntime.CircuitResults<T, []>;
+  buy_domain_for(context: __compactRuntime.CircuitContext<T>,
+                 owner_0: { bytes: Uint8Array },
+                 domain_0: string,
+                 resolver_0: { bytes: Uint8Array },
+                 payment_0: CoinInfo): __compactRuntime.CircuitResults<T, []>;
+  add_multiple_fields(context: __compactRuntime.CircuitContext<T>,
+                      kvs_0: Maybe<[string, string]>[]): __compactRuntime.CircuitResults<T, []>;
+  insert_field(context: __compactRuntime.CircuitContext<T>,
+               k_0: string,
+               v_0: string): __compactRuntime.CircuitResults<T, []>;
+  clear_field(context: __compactRuntime.CircuitContext<T>, k_0: string): __compactRuntime.CircuitResults<T, []>;
+  clear_all_fields(context: __compactRuntime.CircuitContext<T>, domain_0: string): __compactRuntime.CircuitResults<T, []>;
+  register_domain_for(context: __compactRuntime.CircuitContext<T>,
+                      owner_0: { bytes: Uint8Array },
+                      domain_0: string,
+                      resolver_0: { bytes: Uint8Array }): __compactRuntime.CircuitResults<T, []>;
+  set_resolver(context: __compactRuntime.CircuitContext<T>,
+               domain_0: string,
+               resolver_0: { bytes: Uint8Array }): __compactRuntime.CircuitResults<T, []>;
+  update_domain_target(context: __compactRuntime.CircuitContext<T>,
+                       new_target_0: Either<{ bytes: Uint8Array },
+                                            { bytes: Uint8Array }>): __compactRuntime.CircuitResults<T, []>;
+  transfer_domain(context: __compactRuntime.CircuitContext<T>,
+                  domain_0: string,
+                  new_owner_0: { bytes: Uint8Array }): __compactRuntime.CircuitResults<T, []>;
+}
+
+export type Ledger = {
+  readonly PARENT_DOMAIN: Maybe<string>;
+  readonly PARENT_RESOLVER: { bytes: Uint8Array };
+  readonly DOMAIN_OWNER: { bytes: Uint8Array };
+  readonly DOMAIN: Maybe<string>;
+  readonly DOMAIN_TARGET: Either<{ bytes: Uint8Array }, { bytes: Uint8Array }>;
+  domains: {
+    isEmpty(): boolean;
+    size(): bigint;
+    member(key_0: string): boolean;
+    lookup(key_0: string): DomainData;
+    [Symbol.iterator](): Iterator<[string, DomainData]>
+  };
+  domains_owned: {
+    isEmpty(): boolean;
+    size(): bigint;
+    member(key_0: { bytes: Uint8Array }): boolean;
+    lookup(key_0: { bytes: Uint8Array }): {
+      isEmpty(): boolean;
+      size(): bigint;
+      member(elem_0: string): boolean;
+      [Symbol.iterator](): Iterator<string>
+    }
+  };
+  fields: {
+    isEmpty(): boolean;
+    size(): bigint;
+    member(key_0: string): boolean;
+    lookup(key_0: string): string;
+    [Symbol.iterator](): Iterator<[string, string]>
+  };
+  readonly COIN_COLOR: Uint8Array;
+  readonly DOMAIN_COST: bigint;
+}
+
+export type ContractReferenceLocations = any;
+
+export declare const contractReferenceLocations : ContractReferenceLocations;
+
+export declare class Contract<T, W extends Witnesses<T> = Witnesses<T>> {
+  witnesses: W;
+  circuits: Circuits<T>;
+  impureCircuits: ImpureCircuits<T>;
+  constructor(witnesses: W);
+  initialState(context: __compactRuntime.ConstructorContext<T>,
+               parent_domain_0: Maybe<string>,
+               parent_resolver_0: { bytes: Uint8Array },
+               target_0: Either<{ bytes: Uint8Array }, { bytes: Uint8Array }>,
+               domain_0: Maybe<string>,
+               coin_color_0: Uint8Array,
+               domain_cost_0: bigint,
+               kvs_0: Maybe<[string, string]>[]): __compactRuntime.ConstructorResult<T>;
+}
+
+export declare function ledger(state: __compactRuntime.StateValue): Ledger;
+export declare const pureCircuits: PureCircuits;

package/dist/managed/witnesses.d.ts

@@ -0,0 +1,4 @@
+export type DNSPrivateState = {
+    phantom: boolean;
+};
+export declare const witnesses: {};

package/dist/managed/witnesses.js

@@ -0,0 +1,3 @@
+// NS contract doesn't use private state
+export const witnesses = {};
+//# sourceMappingURL=witnesses.js.map

package/dist/react/DomainProfileWidget.d.ts

@@ -0,0 +1,10 @@
+import type { PublicDataProvider } from '@midnight-ntwrk/midnight-js-types';
+import { MidNamesError } from '../types.js';
+export type DomainProfileWidgetProps = {
+    fullDomain: string;
+    publicDataProvider: PublicDataProvider;
+    className?: string;
+    showStatus?: boolean;
+    onError?: (error: MidNamesError) => void;
+};
+export declare function DomainProfileWidget({ fullDomain, publicDataProvider, className, showStatus, onError }: DomainProfileWidgetProps): import("react/jsx-runtime").JSX.Element;

package/dist/react/DomainProfileWidget.js

@@ -0,0 +1,100 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import { MidNamesError } from '../types.js';
+import { deriveShieldedAddress } from '../utils/address.js';
+import { Copy, Check } from 'lucide-react';
+import { getDomainProfile } from '../core.js';
+function truncate(addr, head = 10, tail = 6) {
+    if (!addr)
+        return 'N/A';
+    if (addr.length <= head + tail + 3)
+        return addr;
+    return `${addr.slice(0, head)}…${addr.slice(-tail)}`;
+}
+function CopyableValue({ value, className }) {
+    const [copied, setCopied] = useState(false);
+    const [hovered, setHovered] = useState(false);
+    if (!value)
+        return _jsx("span", { className: className, children: "N/A" });
+    const copy = async () => {
+        try {
+            await navigator.clipboard.writeText(value);
+            setCopied(true);
+            setTimeout(() => setCopied(false), 1500);
+        }
+        catch {
+            // Silently fail if clipboard API is not available
+        }
+    };
+    return (_jsxs("span", { className: `${className} midnames-copyable`, onClick: copy, onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), title: value, children: [truncate(value), _jsx("span", { className: "midnames-copy-icon-container", children: copied ? (_jsx(Check, { className: "midnames-copy-icon midnames-copy-success" })) : (_jsx(Copy, { className: `midnames-copy-icon midnames-copy-hover ${hovered ? 'midnames-copy-visible' : 'midnames-copy-invisible'}` })) })] }));
+}
+export function DomainProfileWidget({ fullDomain, publicDataProvider, className, showStatus = true, onError }) {
+    var _a, _b, _c, _d, _e;
+    const [loading, setLoading] = useState(false);
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        let mounted = true;
+        setLoading(true);
+        setError(null);
+        getDomainProfile(publicDataProvider, fullDomain)
+            .then((d) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            if (mounted) {
+                if (d.success) {
+                    setData(d.data);
+                }
+                else {
+                    setError(new MidNamesError((_b = (_a = d.error) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : 'Unknown error', (_d = (_c = d.error) === null || _c === void 0 ? void 0 : _c.code) !== null && _d !== void 0 ? _d : 'UNKNOWN', d.error));
+                    if (onError)
+                        onError(new MidNamesError((_f = (_e = d.error) === null || _e === void 0 ? void 0 : _e.message) !== null && _f !== void 0 ? _f : 'Unknown error', (_h = (_g = d.error) === null || _g === void 0 ? void 0 : _g.code) !== null && _h !== void 0 ? _h : 'UNKNOWN', d.error));
+                    setData(null);
+                }
+            }
+        })
+            .catch((err) => {
+            if (mounted) {
+                const midnamesError = err instanceof MidNamesError ? err : new MidNamesError('Unknown error', 'UNKNOWN', err);
+                setError(midnamesError);
+                if (onError)
+                    onError(midnamesError);
+            }
+        })
+            .finally(() => mounted && setLoading(false));
+        return () => {
+            mounted = false;
+        };
+    }, [publicDataProvider, fullDomain, onError]);
+    const fieldsMap = useMemo(() => {
+        const m = {};
+        ((data === null || data === void 0 ? void 0 : data.fields) || []).forEach(([k, v]) => (m[k.toLowerCase()] = v));
+        return m;
+    }, [data]);
+    const displayName = fieldsMap['name'] || fieldsMap['displayname'] || fieldsMap['handle'] || '';
+    const bio = fieldsMap['bio'] || fieldsMap['description'] || '';
+    const website = fieldsMap['website'] || fieldsMap['url'] || '';
+    const twitter = (fieldsMap['twitter'] || '').replace(/^@/, '');
+    const github = (fieldsMap['github'] || '').replace(/^@/, '');
+    const location = fieldsMap['location'] || '';
+    const avatarUrl = fieldsMap['avatar'] || fieldsMap['image'] || fieldsMap['pfp'] || '';
+    const bannerUrl = fieldsMap['banner'] || fieldsMap['header'] || '';
+    const epk = fieldsMap['epk'];
+    const resolvedTarget = useMemo(() => {
+        if (!(data === null || data === void 0 ? void 0 : data.resolvedTarget))
+            return null;
+        if (epk)
+            return deriveShieldedAddress(data.resolvedTarget, epk) || data.resolvedTarget;
+        return data.resolvedTarget;
+    }, [data === null || data === void 0 ? void 0 : data.resolvedTarget, epk]);
+    const status = useMemo(() => {
+        if (loading)
+            return 'unknown';
+        if (error)
+            return 'error';
+        return (data === null || data === void 0 ? void 0 : data.info) ? 'registered' : 'available';
+    }, [loading, data === null || data === void 0 ? void 0 : data.info, error]);
+    if (error && !loading) {
+        return (_jsx("div", { className: `midnames-card ${className !== null && className !== void 0 ? className : ''}`, children: _jsxs("div", { className: "midnames-error", children: [_jsx("div", { className: "midnames-error-title", children: "Error loading domain" }), _jsx("div", { className: "midnames-error-message", children: error.message }), _jsxs("div", { className: "midnames-error-code", children: ["Code: ", error.code] })] }) }));
+    }
+    return (_jsxs("div", { className: `midnames-card ${className !== null && className !== void 0 ? className : ''}`, children: [bannerUrl && _jsx("img", { src: bannerUrl, alt: "", className: "midnames-banner" }), _jsxs("div", { className: "midnames-header", children: [_jsx("div", { className: "midnames-avatar", children: avatarUrl ? (_jsx("img", { src: avatarUrl, alt: "", onError: (e) => (e.currentTarget.style.display = 'none') })) : (_jsx("span", { children: (_c = (_b = (_a = (displayName || (data === null || data === void 0 ? void 0 : data.fullDomain) || '?')[0]) === null || _a === void 0 ? void 0 : _a.toUpperCase) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : '?' })) }), _jsxs("div", { className: "midnames-ident", children: [_jsx("div", { className: "midnames-name", children: displayName || (data === null || data === void 0 ? void 0 : data.fullDomain) || fullDomain }), _jsx("div", { className: "midnames-domain", children: (data === null || data === void 0 ? void 0 : data.fullDomain) || fullDomain })] }), showStatus && (_jsx("div", { className: `midnames-status midnames-status-${status}`, children: loading ? 'Checking…' : status === 'registered' ? 'Registered' : status === 'available' ? 'Available' : status === 'error' ? 'Error' : 'Unknown' }))] }), bio && _jsx("p", { className: "midnames-bio", children: bio }), _jsxs("div", { className: "midnames-grid", children: [_jsxs("div", { className: "midnames-box", children: [_jsx("div", { className: "midnames-box-label", children: "Resolved Target" }), _jsx(CopyableValue, { value: resolvedTarget, className: "midnames-box-value" })] }), _jsxs("div", { className: "midnames-box", children: [_jsx("div", { className: "midnames-box-label", children: "Owner" }), _jsx(CopyableValue, { value: (_d = data === null || data === void 0 ? void 0 : data.info) === null || _d === void 0 ? void 0 : _d.owner, className: "midnames-box-value" })] }), _jsxs("div", { className: "midnames-box", children: [_jsx("div", { className: "midnames-box-label", children: "Resolver" }), _jsx(CopyableValue, { value: (_e = data === null || data === void 0 ? void 0 : data.info) === null || _e === void 0 ? void 0 : _e.resolver, className: "midnames-box-value" })] })] }), _jsxs("div", { className: "midnames-links", children: [website && (_jsx("a", { className: "midnames-chip", href: website.startsWith('http') ? website : `https://${website}`, target: "_blank", rel: "noreferrer", children: website.replace(/^https?:\/\//, '') })), twitter && (_jsxs("a", { className: "midnames-chip", href: `https://x.com/${twitter}`, target: "_blank", rel: "noreferrer", children: ["@", twitter] })), github && (_jsx("a", { className: "midnames-chip", href: `https://github.com/${github}`, target: "_blank", rel: "noreferrer", children: github })), location && _jsx("span", { className: "midnames-chip", children: location })] })] }));
+}

package/dist/react/index.d.ts

@@ -0,0 +1 @@
+export * from './DomainProfileWidget.js';

package/dist/react/index.js

@@ -0,0 +1 @@
+export * from './DomainProfileWidget.js';

package/dist/styles.css

@@ -0,0 +1,33 @@
+.midnames-card{border:1px solid rgba(255,255,255,.12);background:transparent;border-radius:12px;padding:12px;max-width:640px}
+.midnames-banner{width:100%;height:120px;object-fit:cover;border-radius:8px}
+.midnames-header{display:flex;gap:12px;align-items:center;margin-top:8px}
+.midnames-avatar{height:64px;width:64px;border-radius:9999px;background:rgba(0,170,255,.1);color:#0af;display:flex;align-items:center;justify-content:center;font-weight:600;overflow:hidden}
+.midnames-avatar img{width:100%;height:100%;object-fit:cover}
+.midnames-ident{flex:1 1 auto;min-width:0}
+.midnames-name{font-size:20px;font-weight:600;line-height:1.2}
+.midnames-domain{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;opacity:.7}
+.midnames-status{font-size:12px;border-radius:9999px;padding:4px 8px;border:1px solid rgba(255,255,255,.2)}
+.midnames-status-registered{border-color:#1fbf75;color:#1fbf75}
+.midnames-status-available{border-color:#f0b429;color:#f0b429}
+.midnames-bio{margin:8px 2px 0 2px;font-size:14px;opacity:.85}
+.midnames-grid{display:grid;grid-template-columns:repeat(1,minmax(0,1fr));gap:8px;margin-top:12px}
+@media(min-width:720px){.midnames-grid{grid-template-columns:repeat(3,minmax(0,1fr))}}
+.midnames-box{border:1px solid rgba(255,255,255,.12);border-radius:8px;padding:8px}
+.midnames-box-label{font-size:11px;opacity:.7}
+.midnames-box-value{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:13px;margin-top:4px}
+.midnames-links{display:flex;flex-wrap:wrap;gap:6px;margin-top:10px}
+.midnames-chip{border:1px solid rgba(255,255,255,.12);border-radius:9999px;padding:6px 10px;font-size:12px;text-decoration:none;color:inherit}
+.midnames-status-error{border-color:#ef4444;color:#ef4444}
+.midnames-error{padding:16px;text-align:center}
+.midnames-error-title{font-size:16px;font-weight:600;color:#ef4444;margin-bottom:8px}
+.midnames-error-message{font-size:14px;opacity:.85;margin-bottom:4px}
+.midnames-error-code{font-size:12px;opacity:.7;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace}
+.midnames-copyable{cursor:pointer;display:inline-flex;align-items:center;gap:4px}
+.midnames-copy-icon-container{width:16px;display:inline-flex;justify-content:center;align-items:center}
+.midnames-copy-icon{width:12px;height:12px;transition:opacity 0.2s ease}
+.midnames-copy-hover{opacity:.8}
+.midnames-copy-hover:hover{opacity:1}
+.midnames-copy-success{color:#22c55e;opacity:1}
+.midnames-copy-visible{opacity:.8}
+.midnames-copy-invisible{opacity:0}
+

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export interface DomainInfo {
+    owner: string;
+    resolver: string;
+    contractAddress?: string;
+}
+export interface DomainSettings {
+    coinColor: Uint8Array;
+    domainCost: bigint;
+}
+export interface DomainProfileData {
+    fullDomain: string;
+    resolvedTarget: string | null;
+    info: DomainInfo | null;
+    fields: Array<[string, string]>;
+    settings: DomainSettings | null;
+}
+export declare class MidNamesError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+export declare class NetworkError extends MidNamesError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ContractNotFoundError extends MidNamesError {
+    constructor(contractAddress: string, details?: unknown);
+}
+export declare class DomainNotFoundError extends MidNamesError {
+    constructor(domain: string, details?: unknown);
+}
+export declare class InvalidDomainError extends MidNamesError {
+    constructor(domain: string, reason: string, details?: unknown);
+}
+export declare class ProviderError extends MidNamesError {
+    constructor(message: string, details?: unknown);
+}
+export type Result<T, E = MidNamesError> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+export declare function success<T>(data: T): Result<T>;
+export declare function failure<E = MidNamesError>(error: E): Result<never, E>;
+export declare function isSuccess<T, E>(result: Result<T, E>): result is {
+    success: true;
+    data: T;
+};
+export declare function isError<T, E>(result: Result<T, E>): result is {
+    success: false;
+    error: E;
+};
+export declare function unwrap<T>(result: Result<T>): T;
+export declare function unwrapOr<T>(result: Result<T>, defaultValue: T): T;

package/dist/types.js

@@ -0,0 +1,61 @@
+// Error handling types
+export class MidNamesError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MidNamesError';
+    }
+}
+export class NetworkError extends MidNamesError {
+    constructor(message, details) {
+        super(message, 'NETWORK_ERROR', details);
+        this.name = 'NetworkError';
+    }
+}
+export class ContractNotFoundError extends MidNamesError {
+    constructor(contractAddress, details) {
+        super(`Contract not found: ${contractAddress}`, 'CONTRACT_NOT_FOUND', details);
+        this.name = 'ContractNotFoundError';
+    }
+}
+export class DomainNotFoundError extends MidNamesError {
+    constructor(domain, details) {
+        super(`Domain not found: ${domain}`, 'DOMAIN_NOT_FOUND', details);
+        this.name = 'DomainNotFoundError';
+    }
+}
+export class InvalidDomainError extends MidNamesError {
+    constructor(domain, reason, details) {
+        super(`Invalid domain "${domain}": ${reason}`, 'INVALID_DOMAIN', details);
+        this.name = 'InvalidDomainError';
+    }
+}
+export class ProviderError extends MidNamesError {
+    constructor(message, details) {
+        super(message, 'PROVIDER_ERROR', details);
+        this.name = 'ProviderError';
+    }
+}
+// Helper functions for Result type
+export function success(data) {
+    return { success: true, data };
+}
+export function failure(error) {
+    return { success: false, error };
+}
+export function isSuccess(result) {
+    return result.success;
+}
+export function isError(result) {
+    return !result.success;
+}
+export function unwrap(result) {
+    if (isSuccess(result)) {
+        return result.data;
+    }
+    throw result.error;
+}
+export function unwrapOr(result, defaultValue) {
+    return isSuccess(result) ? result.data : defaultValue;
+}

package/dist/utils/address.d.ts

@@ -0,0 +1,3 @@
+export declare function bytesToHex(bytes: Uint8Array): string;
+export declare function formatContractAddress(bytes: Uint8Array): string;
+export declare function deriveShieldedAddress(coinPublicKeyAddress: string, encryptionPublicKey: string): string | null;

package/dist/utils/address.js

@@ -0,0 +1,24 @@
+import { MidnightBech32m, ShieldedCoinPublicKey, ShieldedAddress } from "@midnight-ntwrk/wallet-sdk-address-format";
+import { getZswapNetworkId } from "@midnight-ntwrk/midnight-js-network-id";
+export function bytesToHex(bytes) {
+    return Array.from(bytes).map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+export function formatContractAddress(bytes) {
+    return '0200' + bytesToHex(bytes);
+}
+export function deriveShieldedAddress(coinPublicKeyAddress, encryptionPublicKey) {
+    try {
+        const cpkParsed = MidnightBech32m.parse(coinPublicKeyAddress);
+        if (cpkParsed.type !== 'shield-cpk')
+            return null;
+        const coinPublicKey = ShieldedCoinPublicKey.codec.decode(getZswapNetworkId(), cpkParsed);
+        const epkParsed = MidnightBech32m.parse(encryptionPublicKey);
+        if (epkParsed.type !== 'shield-epk')
+            return null;
+        const shieldedAddress = new ShieldedAddress(coinPublicKey, epkParsed);
+        return ShieldedAddress.codec.encode(getZswapNetworkId(), shieldedAddress).asString();
+    }
+    catch {
+        return null;
+    }
+}

package/dist/utils/domain.d.ts

@@ -0,0 +1,15 @@
+export declare function normalizeDomain(input: string, assumeTld?: boolean): string;
+export interface ParsedDomain {
+    isValid: boolean;
+    domainName: string;
+    parentDomainPath: string;
+    fullDomain: string;
+    depth: number;
+}
+export declare function parseFullDomain(fullDomain: string, tld?: string): ParsedDomain;
+export declare function buildTraversalPath(fullDomain: string, tld?: string): string[];
+export declare function isValidDomainName(domainName: string): boolean;
+export declare function getParentDomain(fullDomain: string): string | null;
+export declare function getSubdomain(fullDomain: string): string;
+export declare function isTLD(domain: string, tld?: string): boolean;
+export declare function buildFullDomain(subdomain: string, parent: string): string;

package/dist/utils/domain.js

@@ -0,0 +1,57 @@
+const DEFAULT_TLD = 'night';
+export function normalizeDomain(input, assumeTld = true) {
+    const trimmedInput = input.trim().toLowerCase();
+    const cleaned = trimmedInput.replace(/\.+/g, '.').replace(/\.$/, '');
+    if (!assumeTld)
+        return cleaned;
+    if (cleaned.endsWith(`.${DEFAULT_TLD}`))
+        return cleaned;
+    return `${cleaned}.${DEFAULT_TLD}`;
+}
+export function parseFullDomain(fullDomain, tld = DEFAULT_TLD) {
+    const normalized = normalizeDomain(fullDomain);
+    const parts = normalized.split('.');
+    if (parts[parts.length - 1] !== tld || parts.length < 2) {
+        return { isValid: false, domainName: '', parentDomainPath: '', fullDomain: normalized, depth: 0 };
+    }
+    const domainName = parts[0];
+    const parentDomainPath = parts.slice(1).join('.');
+    return { isValid: true, domainName, parentDomainPath, fullDomain: normalized, depth: parts.length - 1 };
+}
+export function buildTraversalPath(fullDomain, tld = DEFAULT_TLD) {
+    const parsed = parseFullDomain(fullDomain, tld);
+    if (!parsed.isValid)
+        return [];
+    const path = [tld];
+    if (parsed.depth === 0)
+        return path;
+    const parts = parsed.fullDomain.split('.');
+    for (let i = parts.length - 2; i >= 0; i--) {
+        path.push(parts.slice(i).join('.'));
+    }
+    return path;
+}
+export function isValidDomainName(domainName) {
+    if (!domainName || domainName.length === 0 || domainName.length > 63)
+        return false;
+    const regex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+    return regex.test(domainName.toLowerCase());
+}
+export function getParentDomain(fullDomain) {
+    const parts = fullDomain.split('.');
+    if (parts.length <= 1)
+        return null;
+    return parts.slice(1).join('.');
+}
+export function getSubdomain(fullDomain) {
+    const parts = fullDomain.split('.');
+    return parts[0] || '';
+}
+export function isTLD(domain, tld = DEFAULT_TLD) {
+    return normalizeDomain(domain, false) === tld;
+}
+export function buildFullDomain(subdomain, parent) {
+    if (!subdomain)
+        return parent;
+    return `${subdomain}.${parent}`;
+}

package/exported.md

@@ -0,0 +1,116 @@
+# MidNames SDK - Exported Signatures
+
+This document contains all exported functions, types, interfaces, classes, and components from the MidNames SDK.
+
+## Functions
+
+### Core
+
+```typescript
+export function resolveDomain(publicDataProvider: PublicDataProvider, domain: string, tldAddress?: string): Promise<Result<string>>
+```
+Resolves a domain name to its target address.
+
+```typescript
+export function getDomainInfo(publicDataProvider: PublicDataProvider, contractAddress: string, domainName: string): Promise<Result<DomainInfo>>
+```
+Gets information about a domain from a specific contract.
+
+```typescript
+export function getDomainInfoByResolving(publicDataProvider: PublicDataProvider, fullDomain: string): Promise<Result<DomainInfo>>
+```
+Gets domain information by resolving the full domain path.
+
+```typescript
+export function getDomainFields(publicDataProvider: PublicDataProvider, contractAddress: string): Promise<Result<tuple[]>>
+```
+Gets all fields stored in a domain contract.
+
+```typescript
+export function getNamespacedDomainFields(publicDataProvider: PublicDataProvider, _parentContractAddress: string, fullDomainName: string): Promise<Result<tuple[]>>
+```
+Gets fields for a domain by resolving its full namespace path.
+
+```typescript
+export function getDomainSettings(publicDataProvider: PublicDataProvider, contractAddress: string): Promise<Result<DomainSettings>>
+```
+Gets the settings (coin color, domain cost) for a domain contract.
+
+```typescript
+export function getDomainProfile(publicDataProvider: PublicDataProvider, fullDomain: string): Promise<Result<DomainProfileData>>
+```
+Gets the complete profile data for a domain.
+
+### Domain Utility Functions
+
+```typescript
+export function normalizeDomain(input: string, assumeTld: boolean): string
+```
+Normalizes a domain string by cleaning and formatting it.
+
+```typescript
+export function parseFullDomain(fullDomain: string, tld: string): ParsedDomain
+```
+Parses a full domain string into its component parts.
+
+```typescript
+export function buildTraversalPath(fullDomain: string, tld: string): string[]
+```
+Builds the traversal path for resolving a domain.
+
+```typescript
+export function isValidDomainName(domainName: string): boolean
+```
+Validates if a domain name follows the correct format.
+
+```typescript
+export function getParentDomain(fullDomain: string): null | string
+```
+Gets the parent domain of a given domain.
+
+```typescript
+export function getSubdomain(fullDomain: string): string
+```
+Extracts the subdomain portion from a full domain.
+
+```typescript
+export function isTLD(domain: string, tld: string): boolean
+```
+Checks if a domain is a top-level domain.
+
+```typescript
+export function buildFullDomain(subdomain: string, parent: string): string
+```
+Builds a full domain from subdomain and parent parts.
+
+### Address Utility Functions
+
+```typescript
+export function bytesToHex(bytes: Uint8Array): string
+```
+Converts a byte array to a hexadecimal string.
+
+```typescript
+export function formatContractAddress(bytes: Uint8Array): string
+```
+Formats a contract address from bytes with proper prefix.
+
+```typescript
+export function deriveShieldedAddress(coinPublicKeyAddress: string, encryptionPublicKey: string): null | string
+```
+Derives a shielded address from coin public key and encryption key.
+
+## React Components
+
+```typescript
+export type DomainProfileWidgetProps = {
+  fullDomain: string;
+  publicDataProvider: PublicDataProvider;
+  className?: string;
+  showStatus?: boolean;
+  onError?: (error: MidNamesError) => void;
+}
+
+export function DomainProfileWidget(props: DomainProfileWidgetProps): JSX.Element
+```
+React component for displaying domain profile information.