@hoodfi/sdk 0.0.0-stage → 0.1.1

package/dist/client.js

@@ -0,0 +1,304 @@
+import { createPublicClient, encodeFunctionData, erc20Abi, fallback, getAddress, http, isAddress, namehash, } from 'viem';
+import { registrarAbi, registryAbi } from './abi.js';
+import { CHAINS, paymentCaveat } from './coins.js';
+import { CONTRACTS, DEFAULT_API_URL, DEFAULT_ROBINHOOD_RPC, FALLBACK_ROBINHOOD_RPC, ROBINHOOD_CHAIN_ID, ROBINHOOD_EXPLORER, robinhoodChain, } from './constants.js';
+import { contentGatewayUrl, decodeContenthash } from './contenthash.js';
+import { STATUS_TEXT, checkHoodfiName, checkLabel, fullName, tierOf } from './labels.js';
+export class HoodfiError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'HoodfiError';
+        this.code = code;
+    }
+}
+const TEXT_KEYS = ['avatar', 'description', 'url', 'com.twitter', 'com.github', 'email'];
+const UNREADABLE_MSG = 'Could not read Robinhood Chain: the reads failed rather than coming back empty, so this says nothing about the name. Try again shortly.';
+function unavailableReason(status, label) {
+    switch (status) {
+        case 0:
+            return undefined;
+        case 1:
+            return `${fullName(label)} is already registered.`;
+        case 2:
+            return `${fullName(label)} is locked and not on sale right now.`;
+        case 3:
+            return `${label} is not a valid label.`;
+        case 4:
+            return `${label} is reserved and can never be registered.`;
+        default:
+            return `${fullName(label)} is not available (status ${status}).`;
+    }
+}
+/**
+ * A batch where nothing succeeded is a dead connection, not an answer.
+ *
+ * With `allowFailure: true`, a failed aggregate call (a 429 from a throttled RPC) marks
+ * every entry as failed, exactly like each one reverting. For a never-minted name only
+ * `ownerOf` reverts; `addr`/`text`/`contenthash` return empty successfully. So "all
+ * failed" can only mean the transport.
+ */
+function batchFailed(results) {
+    return results.every((r) => r.status === 'failure');
+}
+function requireName(input) {
+    if (typeof input !== 'string')
+        throw new HoodfiError('INVALID_NAME', 'Name must be a string.');
+    const checked = checkHoodfiName(input);
+    if (!checked.ok)
+        throw new HoodfiError('INVALID_NAME', checked.reason);
+    return checked;
+}
+function requireLabel(input) {
+    if (typeof input !== 'string')
+        throw new HoodfiError('INVALID_NAME', 'Name must be a string.');
+    const checked = checkLabel(input);
+    if (!checked.ok)
+        throw new HoodfiError('INVALID_NAME', checked.reason);
+    return checked.label;
+}
+function requireAddress(value) {
+    if (typeof value !== 'string' || !isAddress(value, { strict: false }))
+        throw new HoodfiError('INVALID_NAME', 'Expected a 0x-prefixed 20-byte address.');
+    return getAddress(value);
+}
+export function createHoodfiClient(options = {}) {
+    const client = options.publicClient ??
+        createPublicClient({
+            chain: robinhoodChain,
+            transport: fallback([...(options.rpcUrls ?? []), DEFAULT_ROBINHOOD_RPC, FALLBACK_ROBINHOOD_RPC].map((url) => http(url, { retryCount: 2, retryDelay: 200, timeout: 8_000 })), 
+            // Ranking probes every endpoint in the background, spending the rate limit
+            // this fallback exists to conserve.
+            { rank: false }),
+        });
+    const apiUrl = (options.apiUrl ?? DEFAULT_API_URL).replace(/\/+$/, '');
+    const doFetch = options.fetch ?? globalThis.fetch;
+    async function readRegistrar(label) {
+        try {
+            // allowFailure: false: none of these can revert for a valid label, so a failure
+            // is the RPC, and must not be folded into an answer.
+            const [status, prices, paused] = await client.multicall({
+                contracts: [
+                    { address: CONTRACTS.registrar, abi: registrarAbi, functionName: 'status', args: [label] },
+                    { address: CONTRACTS.registrar, abi: registrarAbi, functionName: 'priceOf', args: [label] },
+                    { address: CONTRACTS.registrar, abi: registrarAbi, functionName: 'paused' },
+                ],
+                allowFailure: false,
+            });
+            return { status, wei: prices[0], usdg: prices[1], paused };
+        }
+        catch (cause) {
+            throw new HoodfiError('UNREADABLE', UNREADABLE_MSG, { cause });
+        }
+    }
+    /** Is a name free, and what does it cost? Prices are read from the registrar on each call. */
+    async function checkName(name) {
+        const label = requireLabel(name);
+        const { status, wei, usdg, paused } = await readRegistrar(label);
+        const reason = paused ? 'Minting is paused by the registrar owner.' : unavailableReason(status, label);
+        return {
+            name: fullName(label),
+            label,
+            length: label.length,
+            tier: tierOf(label),
+            status: STATUS_TEXT[status] ?? 'invalid',
+            available: status === 0 && !paused,
+            paused,
+            ...(reason !== undefined && { reason }),
+            price: { wei, usdg },
+        };
+    }
+    /**
+     * Everything a name holds, in one RPC round-trip. Returns null when the name was never
+     * minted. Throws UNREADABLE (never null) when the chain didn't answer.
+     *
+     * Accepts `gm`, `gm.hoodfi.eth` or a subname like `jack.gm.hoodfi.eth`. Does not accept
+     * `gm.eth`: that's a different name on Ethereum.
+     */
+    async function resolve(name) {
+        const checked = requireName(name);
+        const node = namehash(checked.name);
+        const r = CONTRACTS.registry;
+        const addrAt = (coinType) => ({ address: r, abi: registryAbi, functionName: 'addr', args: [node, coinType] });
+        const text = (key) => ({ address: r, abi: registryAbi, functionName: 'text', args: [node, key] });
+        let results;
+        try {
+            results = await client.multicall({
+                contracts: [
+                    { address: r, abi: registryAbi, functionName: 'ownerOf', args: [BigInt(node)] },
+                    addrAt(CHAINS.robinhood.coinType),
+                    addrAt(CHAINS.ethereum.coinType),
+                    addrAt(CHAINS.bitcoin.coinType),
+                    addrAt(CHAINS.solana.coinType),
+                    addrAt(CHAINS.xrp.coinType),
+                    { address: r, abi: registryAbi, functionName: 'contenthash', args: [node] },
+                    text('avatar'),
+                    text('description'),
+                    text('url'),
+                    text('com.twitter'),
+                    text('com.github'),
+                    text('email'),
+                ],
+                allowFailure: true,
+                // viem splits a multicall past 1024 bytes of calldata by default; these 13 reads
+                // are ~1.2 KB. One request is the point: two is the shape public RPCs throttle.
+                batchSize: 0,
+            });
+        }
+        catch (cause) {
+            throw new HoodfiError('UNREADABLE', UNREADABLE_MSG, { cause });
+        }
+        if (batchFailed(results))
+            throw new HoodfiError('UNREADABLE', UNREADABLE_MSG);
+        const [owner, rh, eth, btc, sol, xrp, contenthash, ...texts] = results;
+        if (!owner || owner.status === 'failure')
+            return null;
+        const stored = (e) => e && e.status === 'success' && typeof e.result === 'string' ? e.result : '0x';
+        const records = {};
+        TEXT_KEYS.forEach((key, i) => {
+            const e = texts[i];
+            if (e && e.status === 'success' && typeof e.result === 'string' && e.result)
+                records[key] = e.result;
+        });
+        const content = decodeContenthash(stored(contenthash));
+        return {
+            name: checked.name,
+            node,
+            owner: getAddress(owner.result),
+            addresses: {
+                robinhood: CHAINS.robinhood.decode(stored(rh)),
+                ethereum: CHAINS.ethereum.decode(stored(eth)),
+                bitcoin: CHAINS.bitcoin.decode(stored(btc)),
+                solana: CHAINS.solana.decode(stored(sol)),
+                xrp: CHAINS.xrp.decode(stored(xrp)),
+            },
+            records,
+            website: content
+                ? { ...content, url: `https://${checked.name}.link/`, gateway: contentGatewayUrl(content) }
+                : null,
+            explorer: `${ROBINHOOD_EXPLORER}/token/${r}/instance/${BigInt(node).toString()}`,
+        };
+    }
+    /**
+     * The address to pay `name` at on `chain`, or a HoodfiError.
+     *
+     * Reads that chain's own record and nothing else. An empty Robinhood Chain record is
+     * NOT filled from the Ethereum one (or vice versa): a contract wallet like a Safe only
+     * exists on chains it was deployed to, and funds sent to its address elsewhere are
+     * stuck. Empty means ask the recipient.
+     */
+    async function getSendAddress(name, chain) {
+        const spec = CHAINS[chain];
+        if (!spec)
+            throw new HoodfiError('INVALID_NAME', `Unknown chain "${String(chain)}".`);
+        const profile = await resolve(name);
+        if (!profile)
+            throw new HoodfiError('NOT_REGISTERED', `${requireName(name).name} is not registered.`);
+        const address = profile.addresses[chain];
+        const sibling = chain === 'robinhood' ? 'ethereum' : chain === 'ethereum' ? 'robinhood' : null;
+        const other = sibling ? profile.addresses[sibling] : null;
+        if (!address)
+            throw new HoodfiError('NO_RECORD', `${profile.name} has no ${spec.label} address set, so it can't be paid there. Don't send to one of its other addresses instead.` +
+                (other && sibling ? ` It does have a ${CHAINS[sibling].label} address; the owner should set both.` : ''));
+        const warnings = [];
+        if (other && sibling && other !== address)
+            warnings.push(`${profile.name}'s two ETH records disagree: ${spec.label} → ${address}, ${CHAINS[sibling].label} → ${other}. This uses the ${spec.label} one; confirm with the recipient.`);
+        return { name: profile.name, chain, address, warnings, caveat: paymentCaveat(chain, address) };
+    }
+    /**
+     * The hoodfi names an address holds, and which one to display for it.
+     *
+     * Served by the HoodFi gateway (it indexes Transfer logs; the registry isn't
+     * enumerable), cached ~60s. Throws UNREADABLE on a failed read: an empty `names` list
+     * really means none.
+     */
+    async function lookupAddress(address) {
+        const checksummed = requireAddress(address);
+        let response;
+        try {
+            response = await doFetch(`${apiUrl}/owner/${checksummed}/names`, { headers: { accept: 'application/json' } });
+        }
+        catch (cause) {
+            throw new HoodfiError('UNREADABLE', 'Could not reach the HoodFi API. Try again shortly.', { cause });
+        }
+        if (!response.ok)
+            throw new HoodfiError('UNREADABLE', `The HoodFi API answered ${response.status}. This says nothing about the address; try again shortly.`);
+        return (await response.json());
+    }
+    /**
+     * Unsigned transactions that register `name` for `account`.
+     *
+     * The registrar mints to whoever SENDS the transaction: there is no recipient
+     * argument. Sign with `account` or the name goes to the actual signer.
+     *
+     * `payWith: 'usdg'` adds an approve step when the allowance is short. `overpayBps`
+     * (ETH only, default 100 = 1%) covers the owner repricing between quote and send;
+     * the registrar refunds anything above the price to the sender.
+     */
+    async function buildRegistration(args) {
+        const label = requireLabel(args.name);
+        const account = requireAddress(args.account);
+        const payWith = args.payWith ?? 'eth';
+        if (payWith !== 'eth' && payWith !== 'usdg')
+            throw new HoodfiError('INVALID_NAME', 'payWith must be "eth" or "usdg".');
+        const overpayBps = args.overpayBps ?? 100;
+        if (!Number.isInteger(overpayBps) || overpayBps < 0 || overpayBps > 10_000)
+            throw new HoodfiError('INVALID_NAME', 'overpayBps must be an integer from 0 to 10000.');
+        const { status, wei, usdg, paused } = await readRegistrar(label);
+        if (paused)
+            throw new HoodfiError('UNAVAILABLE', 'Minting is paused by the registrar owner.');
+        const reason = unavailableReason(status, label);
+        if (reason)
+            throw new HoodfiError('UNAVAILABLE', reason);
+        const name = fullName(label);
+        const steps = [];
+        const warnings = [];
+        try {
+            if (payWith === 'eth') {
+                const value = wei + (wei * BigInt(overpayBps)) / 10000n;
+                const balance = await client.getBalance({ address: account });
+                if (balance < value)
+                    warnings.push(`${account} holds less ETH on Robinhood Chain than the ${value} wei this sends.`);
+                steps.push({
+                    description: `Register ${name}`,
+                    to: CONTRACTS.registrar,
+                    data: encodeFunctionData({ abi: registrarAbi, functionName: 'register', args: [label] }),
+                    value,
+                    chainId: ROBINHOOD_CHAIN_ID,
+                });
+            }
+            else {
+                const [allowance, balance] = await client.multicall({
+                    contracts: [
+                        { address: CONTRACTS.usdg, abi: erc20Abi, functionName: 'allowance', args: [account, CONTRACTS.registrar] },
+                        { address: CONTRACTS.usdg, abi: erc20Abi, functionName: 'balanceOf', args: [account] },
+                    ],
+                    allowFailure: false,
+                });
+                if (balance < usdg)
+                    warnings.push(`${account} holds less USDG than the price.`);
+                if (allowance < usdg)
+                    steps.push({
+                        description: 'Approve the registrar to spend the USDG price',
+                        to: CONTRACTS.usdg,
+                        data: encodeFunctionData({ abi: erc20Abi, functionName: 'approve', args: [CONTRACTS.registrar, usdg] }),
+                        value: 0n,
+                        chainId: ROBINHOOD_CHAIN_ID,
+                    });
+                steps.push({
+                    description: `Register ${name}`,
+                    to: CONTRACTS.registrar,
+                    data: encodeFunctionData({ abi: registrarAbi, functionName: 'registerWithUsdc', args: [label] }),
+                    value: 0n,
+                    chainId: ROBINHOOD_CHAIN_ID,
+                });
+            }
+        }
+        catch (cause) {
+            throw new HoodfiError('UNREADABLE', UNREADABLE_MSG, { cause });
+        }
+        return { name, label, payWith, price: { wei, usdg }, steps, warnings };
+    }
+    return { checkName, resolve, getSendAddress, lookupAddress, buildRegistration, publicClient: client };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,MAAM,CAAA;AAEb,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACpD,OAAO,EAAE,MAAM,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,EACL,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAoB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzF,OAAO,EAAmB,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAiBzG,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAiB;IAC9B,YAAY,IAAqB,EAAE,OAAe,EAAE,OAA6B;QAC/E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAyGD,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,CAAU,CAAA;AAGjG,MAAM,cAAc,GAClB,yIAAyI,CAAA;AAE3I,SAAS,iBAAiB,CAAC,MAAc,EAAE,KAAa;IACtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,CAAC;YACJ,OAAO,SAAS,CAAA;QAClB,KAAK,CAAC;YACJ,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAA;QACpD,KAAK,CAAC;YACJ,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,uCAAuC,CAAA;QAClE,KAAK,CAAC;YACJ,OAAO,GAAG,KAAK,wBAAwB,CAAA;QACzC,KAAK,CAAC;YACJ,OAAO,GAAG,KAAK,2CAA2C,CAAA;QAC5D;YACE,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,6BAA6B,MAAM,IAAI,CAAA;IACpE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,OAAqD;IACxE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAA;IAC9F,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACtE,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAA;IAC9F,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACtE,OAAO,OAAO,CAAC,KAAK,CAAA;AACtB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACnE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,yCAAyC,CAAC,CAAA;IAClF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAYD,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,MAAM,GACV,OAAO,CAAC,YAAY;QACnB,kBAAkB,CAAC;YAClB,KAAK,EAAE,cAAc;YACrB,SAAS,EAAE,QAAQ,CACjB,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,qBAAqB,EAAE,sBAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACtF,IAAI,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAC9D;YACD,2EAA2E;YAC3E,oCAAoC;YACpC,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB;SACF,CAAkB,CAAA;IACrB,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAEjD,KAAK,UAAU,aAAa,CAAC,KAAa;QACxC,IAAI,CAAC;YACH,gFAAgF;YAChF,qDAAqD;YACrD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;gBACtD,SAAS,EAAE;oBACT,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;oBAC1F,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE;oBAC3F,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE;iBAC5E;gBACD,YAAY,EAAE,KAAK;aACpB,CAAC,CAAA;YACF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAA;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAChE,CAAC;IACH,CAAC;IAED,8FAA8F;IAC9F,KAAK,UAAU,SAAS,CAAC,IAAY;QACnC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;QAChE,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtG,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC;YACrB,KAAK;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;YACnB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,SAAS;YACxC,SAAS,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM;YAClC,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;YACvC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;SACrB,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,UAAU,OAAO,CAAC,IAAY;QACjC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAA;QAC5B,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAE,EAAE,CAClC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAU,CAAA;QAC3F,MAAM,IAAI,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAU,CAAA;QAEnH,IAAI,OAAO,CAAA;QACX,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;gBAC/B,SAAS,EAAE;oBACT,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;oBAC/E,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;oBACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAC9B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAC3B,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;oBAC3E,IAAI,CAAC,QAAQ,CAAC;oBACd,IAAI,CAAC,aAAa,CAAC;oBACnB,IAAI,CAAC,KAAK,CAAC;oBACX,IAAI,CAAC,aAAa,CAAC;oBACnB,IAAI,CAAC,YAAY,CAAC;oBAClB,IAAI,CAAC,OAAO,CAAC;iBACd;gBACD,YAAY,EAAE,IAAI;gBAClB,iFAAiF;gBACjF,gFAAgF;gBAChF,SAAS,EAAE,CAAC;aACb,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,WAAW,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;QAE7E,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAA;QACtE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAErD,MAAM,MAAM,GAAG,CAAC,CAAuC,EAAO,EAAE,CAC9D,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,MAAc,CAAC,CAAC,CAAC,IAAI,CAAA;QAExF,MAAM,OAAO,GAAqC,EAAE,CAAA;QACpD,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAClB,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;QACtG,CAAC,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;QACtD,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI;YACJ,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,MAAiB,CAAC;YAC1C,SAAS,EAAE;gBACT,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC9C,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7C,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;aACpC;YACD,OAAO;YACP,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,WAAW,OAAO,CAAC,IAAI,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE;gBAC3F,CAAC,CAAC,IAAI;YACR,QAAQ,EAAE,GAAG,kBAAkB,UAAU,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;SACjF,CAAA;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,KAAgB;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,kBAAkB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACrF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAA;QAErG,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACxC,MAAM,OAAO,GAAG,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAA;QAC9F,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAEzD,IAAI,CAAC,OAAO;YACV,MAAM,IAAI,WAAW,CACnB,WAAW,EACX,GAAG,OAAO,CAAC,IAAI,WAAW,IAAI,CAAC,KAAK,4FAA4F;gBAC9H,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,mBAAmB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,sCAAsC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3G,CAAA;QAEH,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,KAAK,OAAO;YACvC,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,CAAC,IAAI,gCAAgC,IAAI,CAAC,KAAK,MAAM,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,MAAM,KAAK,mBAAmB,IAAI,CAAC,KAAK,mCAAmC,CAC5K,CAAA;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAA;IAChG,CAAC;IAED;;;;;;OAMG;IACH,KAAK,UAAU,aAAa,CAAC,OAAe;QAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,IAAI,QAAkB,CAAA;QACtB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,MAAM,UAAU,WAAW,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAC/G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,oDAAoD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACtG,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE;YACd,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,2BAA2B,QAAQ,CAAC,MAAM,2DAA2D,CAAC,CAAA;QAC5I,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAA;IACjD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,UAAU,iBAAiB,CAAC,IAKhC;QACC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAA;QACrC,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAAA;QACtH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAA;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,MAAM;YACxE,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,gDAAgD,CAAC,CAAA;QAEzF,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;QAChE,IAAI,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE,2CAA2C,CAAC,CAAA;QAC7F,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC/C,IAAI,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QAExD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC5B,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,IAAI,CAAC;YACH,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,MAAO,CAAA;gBACxD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;gBAC7D,IAAI,OAAO,GAAG,KAAK;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,+CAA+C,KAAK,kBAAkB,CAAC,CAAA;gBACpH,KAAK,CAAC,IAAI,CAAC;oBACT,WAAW,EAAE,YAAY,IAAI,EAAE;oBAC/B,EAAE,EAAE,SAAS,CAAC,SAAS;oBACvB,IAAI,EAAE,kBAAkB,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxF,KAAK;oBACL,OAAO,EAAE,kBAAkB;iBAC5B,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;oBAClD,SAAS,EAAE;wBACT,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE;wBAC3G,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;qBACvF;oBACD,YAAY,EAAE,KAAK;iBACpB,CAAC,CAAA;gBACF,IAAI,OAAO,GAAG,IAAI;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,kCAAkC,CAAC,CAAA;gBAC/E,IAAI,SAAS,GAAG,IAAI;oBAClB,KAAK,CAAC,IAAI,CAAC;wBACT,WAAW,EAAE,+CAA+C;wBAC5D,EAAE,EAAE,SAAS,CAAC,IAAI;wBAClB,IAAI,EAAE,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;wBACvG,KAAK,EAAE,EAAE;wBACT,OAAO,EAAE,kBAAkB;qBAC5B,CAAC,CAAA;gBACJ,KAAK,CAAC,IAAI,CAAC;oBACT,WAAW,EAAE,YAAY,IAAI,EAAE;oBAC/B,EAAE,EAAE,SAAS,CAAC,SAAS;oBACvB,IAAI,EAAE,kBAAkB,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChG,KAAK,EAAE,EAAE;oBACT,OAAO,EAAE,kBAAkB;iBAC5B,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;IACxE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,EAAE,CAAA;AACvG,CAAC"}

package/dist/coins.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Decoding the address records a name can carry.
+ *
+ * ENSIP-9 stores an address as its chain's own bytes, not the text people copy (Bitcoin
+ * keeps its scriptPubKey, Solana its raw ed25519 key), so each record is re-derived
+ * through a per-chain codec rather than echoed. Same codecs as mcp/src/coins.ts and
+ * frontend/lib/ens.ts: `@ensdomains/address-encoder`.
+ */
+import { type Hex } from 'viem';
+/** Where a payment goes. `robinhood` and `ethereum` are separate records on purpose. */
+export type SendChain = 'robinhood' | 'ethereum' | 'bitcoin' | 'solana' | 'xrp';
+export type Verification = 'checksummed' | 'if-mixed-case' | 'length-only';
+interface Chain {
+    label: string;
+    symbol: string;
+    coinType: bigint;
+    /**
+     * How much a well-formed record proves. Bitcoin and XRP carry a checksum. An EVM
+     * record is checksummed when written in EIP-55 case, which this SDK always returns.
+     * Solana has none: any 32 bytes is a valid-looking key, so a typo at write time is
+     * undetectable at read time.
+     */
+    verification: Verification;
+    decode(stored: Hex): string | null;
+}
+export declare const CHAINS: Record<SendChain, Chain>;
+export declare const SEND_CHAINS: SendChain[];
+/**
+ * What to tell a user before they pay this address, or null when the record itself
+ * proves it is well-formed. Relay it; don't report the address as "validated".
+ */
+export declare function paymentCaveat(chain: SendChain, address: string): string | null;
+export {};
+//# sourceMappingURL=coins.d.ts.map

package/dist/coins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coins.d.ts","sourceRoot":"","sources":["../src/coins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,GAAG,EAA0B,MAAM,MAAM,CAAA;AAKvD,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE/E,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,eAAe,GAAG,aAAa,CAAA;AAE1E,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAAA;CACnC;AAuBD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,CAM3C,CAAA;AAED,eAAO,MAAM,WAAW,EAA0B,SAAS,EAAE,CAAA;AAE7D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9E"}

package/dist/coins.js

@@ -0,0 +1,53 @@
+/**
+ * Decoding the address records a name can carry.
+ *
+ * ENSIP-9 stores an address as its chain's own bytes, not the text people copy (Bitcoin
+ * keeps its scriptPubKey, Solana its raw ed25519 key), so each record is re-derived
+ * through a per-chain codec rather than echoed. Same codecs as mcp/src/coins.ts and
+ * frontend/lib/ens.ts: `@ensdomains/address-encoder`.
+ */
+import { encodeBtcAddress, encodeSolAddress } from '@ensdomains/address-encoder/coders';
+import { getAddress, hexToBytes } from 'viem';
+import { BTC_COIN_TYPE, ETH_COIN_TYPE, ROBINHOOD_COIN_TYPE, SOL_COIN_TYPE, XRP_COIN_TYPE } from './constants.js';
+import { encodeXrpRecord } from './xrp.js';
+const ZERO = '0x0000000000000000000000000000000000000000';
+function evm(stored) {
+    if (!stored || stored.length !== 42)
+        return null;
+    const address = getAddress(stored);
+    return address === ZERO ? null : address;
+}
+function via(toText) {
+    return (stored) => {
+        if (!stored || stored === '0x')
+            return null;
+        try {
+            return toText(hexToBytes(stored));
+        }
+        catch {
+            return null;
+        }
+    };
+}
+// The library names directions from the address text's side: `encode…` turns stored
+// bytes INTO text, which is the only direction a reader needs.
+export const CHAINS = {
+    robinhood: { label: 'Robinhood Chain', symbol: 'ETH', coinType: ROBINHOOD_COIN_TYPE, verification: 'if-mixed-case', decode: evm },
+    ethereum: { label: 'Ethereum', symbol: 'ETH', coinType: ETH_COIN_TYPE, verification: 'if-mixed-case', decode: evm },
+    bitcoin: { label: 'Bitcoin', symbol: 'BTC', coinType: BTC_COIN_TYPE, verification: 'checksummed', decode: via(encodeBtcAddress) },
+    solana: { label: 'Solana', symbol: 'SOL', coinType: SOL_COIN_TYPE, verification: 'length-only', decode: via(encodeSolAddress) },
+    xrp: { label: 'XRP Ledger', symbol: 'XRP', coinType: XRP_COIN_TYPE, verification: 'checksummed', decode: via(encodeXrpRecord) },
+};
+export const SEND_CHAINS = Object.keys(CHAINS);
+/**
+ * What to tell a user before they pay this address, or null when the record itself
+ * proves it is well-formed. Relay it; don't report the address as "validated".
+ */
+export function paymentCaveat(chain, address) {
+    if (chain === 'xrp' && address.startsWith('r'))
+        return 'Classic XRP Ledger address (r…): it carries no destination tag. Fine for a personal wallet; an exchange deposit sent without its tag can be lost.';
+    if (chain === 'solana')
+        return 'Solana addresses carry no checksum, so a mistyped record looks exactly like a valid one. Confirm it with the recipient before a large payment.';
+    return null;
+}
+//# sourceMappingURL=coins.js.map

package/dist/coins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coins.js","sourceRoot":"","sources":["../src/coins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACvF,OAAO,EAAY,UAAU,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAChH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAqB1C,MAAM,IAAI,GAAG,4CAA4C,CAAA;AAEzD,SAAS,GAAG,CAAC,MAAW;IACtB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAChD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAClC,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;AAC1C,CAAC;AAED,SAAS,GAAG,CAAC,MAAqC;IAChD,OAAO,CAAC,MAAW,EAAiB,EAAE;QACpC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,oFAAoF;AACpF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,MAAM,GAA6B;IAC9C,SAAS,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE;IACjI,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE;IACnH,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,gBAAgB,CAAC,EAAE;IACjI,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,gBAAgB,CAAC,EAAE;IAC/H,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE;CAChI,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgB,CAAA;AAE7D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,OAAe;IAC7D,IAAI,KAAK,KAAK,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAC5C,OAAO,mJAAmJ,CAAA;IAC5J,IAAI,KAAK,KAAK,QAAQ;QACpB,OAAO,gJAAgJ,CAAA;IACzJ,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,31 @@
+import { type Chain } from 'viem';
+export declare const PARENT = "hoodfi.eth";
+export declare const ROBINHOOD_CHAIN_ID = 4663;
+export declare const DEFAULT_ROBINHOOD_RPC = "https://rpc.mainnet.chain.robinhood.com";
+/** Used when the public RPC rate-limits. It's throttled too, but on a separate budget. */
+export declare const FALLBACK_ROBINHOOD_RPC = "https://robinhoodchain.blockscout.com/api/eth-rpc";
+export declare const ROBINHOOD_EXPLORER = "https://robinhoodchain.blockscout.com";
+/** Base URL of the HoodFi gateway that serves the reverse lookup. */
+export declare const DEFAULT_API_URL = "https://ccip.hoodfi-mcp.com";
+/** Live contracts. Owners and sources: contracts/README.md in the repository. */
+export declare const CONTRACTS: {
+    readonly registry: "0xf2bABA012244bdD7445129597350054E1B3aEe5C";
+    readonly registrar: "0x56be5565acc823f4195c2cf3b9046C083633209a";
+    readonly partnerRouter: "0xb7bd5f2c7c445ddc5d55ebd9b8f6a20c2e6e4b5d";
+    readonly usdg: "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168";
+    /** HoodfiL1Resolver on Ethereum mainnet. */
+    readonly l1Resolver: "0x37215Dd89D0Fd4ea0Dbce690bDe58490fB7f7cF2";
+};
+/**
+ * The ENSIP-11 coinType for Robinhood Chain, 0x80000000 | 4663.
+ *
+ * It's written as a literal on purpose. In JS, `0x80000000 | 4663` is a signed 32-bit
+ * operation and comes out negative, so every addr read silently returns nothing.
+ */
+export declare const ROBINHOOD_COIN_TYPE = 2147488311n;
+export declare const ETH_COIN_TYPE = 60n;
+export declare const BTC_COIN_TYPE = 0n;
+export declare const SOL_COIN_TYPE = 501n;
+export declare const XRP_COIN_TYPE = 144n;
+export declare const robinhoodChain: Chain;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,MAAM,CAAA;AAE9C,eAAO,MAAM,MAAM,eAAe,CAAA;AAClC,eAAO,MAAM,kBAAkB,OAAO,CAAA;AACtC,eAAO,MAAM,qBAAqB,4CAA4C,CAAA;AAC9E,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,sDAAsD,CAAA;AACzF,eAAO,MAAM,kBAAkB,0CAA0C,CAAA;AACzE,qEAAqE;AACrE,eAAO,MAAM,eAAe,gCAAgC,CAAA;AAE5D,iFAAiF;AACjF,eAAO,MAAM,SAAS;;;;;IAKpB,4CAA4C;;CAEpC,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,cAAc,CAAA;AAC9C,eAAO,MAAM,aAAa,MAAM,CAAA;AAChC,eAAO,MAAM,aAAa,KAAK,CAAA;AAC/B,eAAO,MAAM,aAAa,OAAO,CAAA;AACjC,eAAO,MAAM,aAAa,OAAO,CAAA;AAEjC,eAAO,MAAM,cAAc,EAAE,KAO3B,CAAA"}

package/dist/constants.js

@@ -0,0 +1,38 @@
+import { defineChain } from 'viem';
+export const PARENT = 'hoodfi.eth';
+export const ROBINHOOD_CHAIN_ID = 4663;
+export const DEFAULT_ROBINHOOD_RPC = 'https://rpc.mainnet.chain.robinhood.com';
+/** Used when the public RPC rate-limits. It's throttled too, but on a separate budget. */
+export const FALLBACK_ROBINHOOD_RPC = 'https://robinhoodchain.blockscout.com/api/eth-rpc';
+export const ROBINHOOD_EXPLORER = 'https://robinhoodchain.blockscout.com';
+/** Base URL of the HoodFi gateway that serves the reverse lookup. */
+export const DEFAULT_API_URL = 'https://ccip.hoodfi-mcp.com';
+/** Live contracts. Owners and sources: contracts/README.md in the repository. */
+export const CONTRACTS = {
+    registry: '0xf2bABA012244bdD7445129597350054E1B3aEe5C',
+    registrar: '0x56be5565acc823f4195c2cf3b9046C083633209a',
+    partnerRouter: '0xb7bd5f2c7c445ddc5d55ebd9b8f6a20c2e6e4b5d',
+    usdg: '0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168',
+    /** HoodfiL1Resolver on Ethereum mainnet. */
+    l1Resolver: '0x37215Dd89D0Fd4ea0Dbce690bDe58490fB7f7cF2',
+};
+/**
+ * The ENSIP-11 coinType for Robinhood Chain, 0x80000000 | 4663.
+ *
+ * It's written as a literal on purpose. In JS, `0x80000000 | 4663` is a signed 32-bit
+ * operation and comes out negative, so every addr read silently returns nothing.
+ */
+export const ROBINHOOD_COIN_TYPE = 2147488311n;
+export const ETH_COIN_TYPE = 60n;
+export const BTC_COIN_TYPE = 0n;
+export const SOL_COIN_TYPE = 501n;
+export const XRP_COIN_TYPE = 144n;
+export const robinhoodChain = defineChain({
+    id: ROBINHOOD_CHAIN_ID,
+    name: 'Robinhood Chain',
+    nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+    rpcUrls: { default: { http: [DEFAULT_ROBINHOOD_RPC] } },
+    blockExplorers: { default: { name: 'Blockscout', url: ROBINHOOD_EXPLORER } },
+    contracts: { multicall3: { address: '0xcA11bde05977b3631167028862bE2a173976CA11' } },
+});
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,WAAW,EAAE,MAAM,MAAM,CAAA;AAE9C,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAA;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAA;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,yCAAyC,CAAA;AAC9E,0FAA0F;AAC1F,MAAM,CAAC,MAAM,sBAAsB,GAAG,mDAAmD,CAAA;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,uCAAuC,CAAA;AACzE,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,6BAA6B,CAAA;AAE5D,iFAAiF;AACjF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,4CAA4C;IACtD,SAAS,EAAE,4CAA4C;IACvD,aAAa,EAAE,4CAA4C;IAC3D,IAAI,EAAE,4CAA4C;IAClD,4CAA4C;IAC5C,UAAU,EAAE,4CAA4C;CAChD,CAAA;AAEV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAA;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA;AAEjC,MAAM,CAAC,MAAM,cAAc,GAAU,WAAW,CAAC;IAC/C,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,iBAAiB;IACvB,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9D,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,qBAAqB,CAAC,EAAE,EAAE;IACvD,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,kBAAkB,EAAE,EAAE;IAC5E,SAAS,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,EAAE;CACrF,CAAC,CAAA"}

package/dist/contenthash.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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.
+ */
+export type ContentProtocol = "ipfs" | "ipns";
+export type ContentHash = {
+    protocol: ContentProtocol;
+    /**
+     * The canonical multibase id: base32 for an IPFS CID, base36 for an IPNS key. Both
+     * are lowercase and DNS-safe, which is what lets them be used as a gateway subdomain
+     * — the only gateway form that serves a site's own assets from the site's own origin.
+     */
+    id: string;
+    /** `ipfs://…` — how every other ENS tool shows the same record. */
+    uri: string;
+};
+/**
+ * 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 declare function decodeContenthash(stored: string | undefined | null): ContentHash | 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 declare function encodeContenthash(input: string): `0x${string}` | null;
+/** The same parse, exposed for the editor's "what you're about to publish" preview. */
+export declare function parseContenthash(input: string): ContentHash | 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 declare function contentGatewayUrl(content: ContentHash): string;
+/**
+ * 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 declare function nameUrl(label: string): string;
+//# sourceMappingURL=contenthash.d.ts.map

package/dist/contenthash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contenthash.d.ts","sourceRoot":"","sources":["../src/contenthash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAWH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AA0MF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAChC,WAAW,GAAG,IAAI,CAmBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,GAAG,IAAI,CAKrE;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAQlE;AA6DD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C"}