@artblocks/abx-cli 0.1.0-alpha.5 → 0.1.0-alpha.51

package/dist/kind.js

@@ -0,0 +1,122 @@
+import { isMissingContractCapability, isRpcReadFailure } from './contract-read-error.js';
+/** ERC-165 id of ERC-1155 itself — what sorts a clone into the edition family (anchors.ts's
+ *  `ERC1155_INTERFACE_ID`, restated here rather than imported: it's a fixed standard id, not SDK
+ *  surface). */
+const ERC1155_INTERFACE_ID = '0xd9b67a26';
+const KIND_PROBE_ABI = [
+    { type: 'function', name: 'supportsInterface', stateMutability: 'view', inputs: [{ type: 'bytes4' }], outputs: [{ type: 'bool' }] },
+    { type: 'function', name: 'maxInvocations', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
+    { type: 'function', name: 'paramHooks', stateMutability: 'view', inputs: [], outputs: [{ type: 'address' }, { type: 'address' }, { type: 'address' }] },
+];
+function capabilityMissOrThrow(client, address, error) {
+    if (isMissingContractCapability(error))
+        return false;
+    if (isRpcReadFailure(error)) {
+        const chain = client.chain?.name ?? 'the active chain';
+        throw new Error(`could not detect the token type for ${address} on ${chain} — the RPC answered block/code requests but failed eth_call ` +
+            `(rate-limited or backend unhealthy). This is not a contract verdict; check the configured RPC URLs.`, { cause: error });
+    }
+    throw error;
+}
+/**
+ * Refuse to infer a kind for an address that holds no contract. Without this the three negative
+ * probes below are indistinguishable from "nothing deployed here", and the ladder's `1of1` default
+ * becomes a confident lie about a specific contract type (see the file docstring).
+ *
+ * Deliberately silent when the check itself can't run (an RPC hiccup → `getCode` throws): a network
+ * blip must not become a "no contract" claim, so we fall through to the probes exactly as before and
+ * let whatever the caller was doing surface its own error. Same stance as `assertContractExists`.
+ */
+async function assertHasCode(client, address) {
+    let code;
+    try {
+        code = await client.getCode({ address });
+    }
+    catch {
+        return; // can't tell — don't manufacture a verdict
+    }
+    if (code && code !== '0x')
+        return;
+    const chain = client.chain?.name ?? 'the active chain';
+    throw new Error(`no contract at ${address} on ${chain} — so there is no token type to read. ` +
+        `Check the address, and check the network: a contract that lives on another chain reads as empty here ` +
+        `(the chain is picked with ABX_CHAIN; base-sepolia is the default). Owner ops run AFTER deploy.`);
+}
+async function supportsErc1155(client, address) {
+    try {
+        return (await client.readContract({ address, abi: KIND_PROBE_ABI, functionName: 'supportsInterface', args: [ERC1155_INTERFACE_ID] }));
+    }
+    catch (error) {
+        return capabilityMissOrThrow(client, address, error);
+    }
+}
+async function hasMaxInvocations(client, address) {
+    try {
+        await client.readContract({ address, abi: KIND_PROBE_ABI, functionName: 'maxInvocations' });
+        return true;
+    }
+    catch (error) {
+        return capabilityMissOrThrow(client, address, error);
+    }
+}
+/** The Params/ConfigurableParams surface probe — `paramHooks()` exists only on SeriesCode/
+ *  EditionCode (mirrors the exact check `ownerops.ts`'s `cmdSetParamHooks` already ran ad-hoc). */
+async function hasConfigurableParams(client, address) {
+    try {
+        await client.readContract({ address, abi: KIND_PROBE_ABI, functionName: 'paramHooks' });
+        return true;
+    }
+    catch (error) {
+        return capabilityMissOrThrow(client, address, error);
+    }
+}
+/**
+ * Which of the six concrete ABX token types `address` is — the shared discriminator every command
+ * that branches on kind should call instead of re-deriving its own probe. Three live `eth_call`s,
+ * in the order that lets each short-circuit the next: ERC-165 first (edition family or not), then
+ * `maxInvocations()` (multi-id or not), then the Params surface (code or not).
+ */
+export async function detectTokenKind(client, address) {
+    await assertHasCode(client, address);
+    const isEdition = await supportsErc1155(client, address);
+    const capped = await hasMaxInvocations(client, address);
+    if (isEdition) {
+        if (!capped)
+            return { kind: '1of1-edition', isEdition: true, label: 'OneOfOneEdition' };
+        const code = await hasConfigurableParams(client, address);
+        return code ? { kind: 'edition-code', isEdition: true, label: 'EditionCode' } : { kind: 'edition', isEdition: true, label: 'EditionImage' };
+    }
+    if (!capped)
+        return { kind: '1of1', isEdition: false, label: 'OneOfOneImage' };
+    const code = await hasConfigurableParams(client, address);
+    return code ? { kind: 'code', isEdition: false, label: 'SeriesCode' } : { kind: 'series', isEdition: false, label: 'SeriesImage' };
+}
+/** Convenience for a call site that only needs the one boolean (is this an ERC-1155 edition, at
+ *  all) — the cheapest single probe, so a guard that doesn't need the full breakdown doesn't pay
+ *  for the other two calls. */
+export async function isEditionContract(client, address) {
+    return supportsErc1155(client, address);
+}
+/** Human, one-line description of a kind — `"EditionImage (edition)"`, `"SeriesImage (series)"` —
+ *  the shared phrasing for a readout header (`state`, `tokens`). */
+export function describeKind(info) {
+    return `${info.label} (${info.kind === '1of1' ? '1/1' : info.kind === '1of1-edition' ? 'edition' : info.kind})`;
+}
+/** The ConfigurableParams / PostParams surface — SeriesCode and EditionCode only. */
+export function hasParamsSurface(info) {
+    return info.kind === 'code' || info.kind === 'edition-code';
+}
+/**
+ * Refuse a PostParams command (set-schema / configure-param / retire-param) against a contract
+ * that does not compose ConfigurableParams — before any signing prompt, and as a capability
+ * mismatch rather than a raw viem revert. Same probe `set-param-hooks` already ran.
+ */
+export async function assertHasParamsSurface(client, address, what) {
+    const kind = await detectTokenKind(client, address);
+    if (!hasParamsSurface(kind)) {
+        throw new Error(`${address} exposes no PostParams — ${what} is a SeriesCode/EditionCode feature. ` +
+            `${kind.label} has no configurable params.`);
+    }
+    return kind;
+}
+//# sourceMappingURL=kind.js.map

package/dist/kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind.js","sourceRoot":"","sources":["../src/kind.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAC,2BAA2B,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAcvF;;gBAEgB;AAChB,MAAM,oBAAoB,GAAG,YAAqB,CAAC;AAEnD,MAAM,cAAc,GAAG;IACrB,EAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,MAAM,EAAC,CAAC,EAAC;IAC7H,EAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,EAAC;IAC7G,EAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,SAAS,EAAC,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC,CAAC,EAAC;CACvI,CAAC;AAEX,SAAS,qBAAqB,CAAC,MAAoB,EAAE,OAAgB,EAAE,KAAc;IACnF,IAAI,2BAA2B,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,kBAAkB,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,OAAO,KAAK,8DAA8D;YACtH,qGAAqG,EACvG,EAAC,KAAK,EAAE,KAAK,EAAC,CACf,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,aAAa,CAAC,MAAoB,EAAE,OAAgB;IACjE,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAC,OAAO,EAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,2CAA2C;IACrD,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,kBAAkB,CAAC;IACvD,MAAM,IAAI,KAAK,CACb,kBAAkB,OAAO,OAAO,KAAK,wCAAwC;QAC3E,uGAAuG;QACvG,gGAAgG,CACnG,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,MAAoB,EAAE,OAAgB;IACnE,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,EAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,oBAAoB,CAAC,EAAC,CAAC,CAAY,CAAC;IACjJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,MAAoB,EAAE,OAAgB;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,EAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAC,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;mGACmG;AACnG,KAAK,UAAU,qBAAqB,CAAC,MAAoB,EAAE,OAAgB;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,EAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAC,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAoB,EAAE,OAAgB;IAC1E,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,MAAM;YAAE,OAAO,EAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAC,CAAC;QACtF,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC;IAC1I,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAC,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAC,CAAC;AACjI,CAAC;AAED;;+BAE+B;AAC/B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAoB,EAAE,OAAgB;IAC5E,OAAO,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;oEACoE;AACpE,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,OAAO,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAClH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAoB,EACpB,OAAgB,EAChB,IAAY;IAEZ,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,4BAA4B,IAAI,wCAAwC;YAChF,GAAG,IAAI,CAAC,KAAK,8BAA8B,CAC9C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}