@artblocks/abx-cli 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/main.js

@@ -70,7 +70,7 @@ const SCHEMA_CATALOG = 'Types: Bool·Select·Uint256Range·Int256Range·DecimalR
     'Select needs options — key:Select[A|B|C]:Auth; a Range takes bounds — key:Uint256Range[0..100]:Auth. ' +
     'A palette collectors set = palette:HexColor:TokenOwner';
 import { uploadAndLocate } from './upload.js';
-import { assertChainId, discoverDeployBlock, deployFactory, deploySeriesFactory, deploySeries, deployOneOfOne, deployRenderer, predictRenderer, predictSeedSource, encodeTag, encodeFieldRenderer, isCodeProject, loadDotEnv, makePublicClient, makeWalletClient, oneOfOneImageAbi, oneOfOneImageFactoryAbi, seriesImageAbi, seriesImageFactoryAbi, abxMetadataRendererAbi, predictClone, probeRpcEndpoints, prepareDeployOneOfOne, prepareDeploySeries, reconstructProject, saltFor, saltGuard, resolveChain, DEFAULT_CHAIN_KEY, normalizeAttributes, parseTraitPairs, METADATA_FIELD as F, METADATA_REPRESENTATION as R, } from '@artblocks/abx-sdk';
+import { assertChainId, discoverDeployBlock, deployFactory, deploySeriesFactory, deploySeries, deployOneOfOne, deployRenderer, predictRenderer, predictSeedSource, encodeTag, encodeFieldRenderer, isCodeProject, loadDotEnv, makePublicClient, makeWalletClient, oneOfOneImageAbi, oneOfOneImageFactoryAbi, seriesImageAbi, seriesImageFactoryAbi, abxMetadataRendererAbi, predictClone, probeRpcEndpoints, prepareDeployOneOfOne, prepareDeploySeries, reconstructProject, saltFor, saltGuard, resolveChain, explorerUrl, DEFAULT_CHAIN_KEY, normalizeAttributes, parseTraitPairs, METADATA_FIELD as F, METADATA_REPRESENTATION as R, } from '@artblocks/abx-sdk';
 import { SelfHostIndexer, SqliteStore } from '@artblocks/abx-indexer';
 import { artContentHash, currentRenderArtifact, generateArt, resolveBaseUrl, startChainWatcher, startTokenApiServer, verifyProject, watchIntervalMs, DEFAULT_PORT, } from '@artblocks/abx-token-api';
 import { ARWEAVE_FREE_UPLOAD_LIMIT, arweaveAddress, arweaveFunding, contentTypeFromPath, hashContent, resolveBackend, turboBalanceForAddress, turboUploadCostUsd, turboUploadWinc } from '@artblocks/abx-storage';
@@ -80,12 +80,10 @@ import { remoteAddProject, remoteRemoveProject } from './remote.js';
 import { buildMigrationPlan, repinNodeCustody, verifyParity } from './migrate.js';
 import { activeBackendId, arweaveKeyFilePath, backendResolution, ensureArweaveJwk, factoryAddress, seriesFactoryAddress, fixedPriceMinterAddress, loadArweaveJwk, loopbackBaseUrl, faucetHint, rendererAddress, storageOptions, storageSignerChoice, } from './config.js';
 const CHAIN = process.env.ABX_CHAIN ?? DEFAULT_CHAIN_KEY;
-// Block explorer base per chain (keyed by EIP-155 chainId), for the tx/address links the CLI prints.
-const EXPLORERS = {
-    11155111: 'https://sepolia.etherscan.io', // Sepolia
-    84532: 'https://sepolia.basescan.org', // Base Sepolia
-};
-const EXPLORER = EXPLORERS[resolveChain(CHAIN).id] ?? 'https://sepolia.etherscan.io';
+// Block explorer base for the tx/address links the CLI prints. Derived from viem's chain metadata via
+// the SDK (see explorerUrl) rather than a local table — this used to be a hand-maintained map, which is
+// the same shape of bug that had the token-api dashboard sending every Base Sepolia link to Etherscan.
+const EXPLORER = explorerUrl(resolveChain(CHAIN).id);
 // Product dimensions — what you can launch. One concrete contract exists today
 // (the 1/1 image); this table is the seam future implementations slot into, so
 // `abx deploy --type <dimension>` is stable while the contracts grow under it.
@@ -155,7 +153,7 @@ async function main() {
         return;
     }
     // Notify-only "you're behind" nudge (cached, opt-out, stderr — see update-check.ts). Awaited so
-    // the notice lands before command output, but it hits the network at most once a day and never
+    // the notice lands before command output, but it hits the network at most once every 6h and never
     // throws, so it can't break or meaningfully slow a command. Skipped for the pure help path below.
     await maybeNotifyUpdate(flags);
     // SAFETY: --help / -h on ANY command is read-only — print usage, never execute.
@@ -449,7 +447,7 @@ function refuseMissingFactory(kind, envVar, reason) {
         `  To deploy your OWN trust anchor instead (private chains, sandboxes — platforms won't recognize its clones), ` +
         `re-run with --bootstrap-factory.`);
 }
-async function ensureFactory(override, allowBootstrap = false) {
+async function ensureFactory(override, allowBootstrap = false, quiet = false) {
     // Resolve the canonical factory from the shipped manifest (flag → env → manifest); on a chain
     // with no entry, deploy a fresh trust anchor and tell the operator how to reuse it.
     const known = factoryAddress(override);
@@ -459,7 +457,10 @@ async function ensureFactory(override, allowBootstrap = false) {
         const code = await publicClient.getCode({ address: known });
         if (code && code !== '0x') {
             if (await isCurrentFactory(publicClient, known)) {
-                info(`using canonical factory ${EXPLORER}/address/${known}`);
+                // `quiet` suppresses only this happy-path line (the demo resolves the factory without making a
+                // teaching moment of it). Bootstrap/mismatch messages below always print — those matter.
+                if (!quiet)
+                    info(`using canonical factory ${EXPLORER}/address/${known}`);
                 return known;
             }
             if (!allowBootstrap)
@@ -1038,7 +1039,13 @@ async function cmdDeploy(flags, serveAfter) {
         if (signer)
             await warnUnfunded(publicClient, signer);
     }
-    step(serveAfter ? 'Who vouches for this token?' : 'Trust anchor');
+    // `deploy` surfaces the trust anchor as a step; the demo does NOT. It briefly opened on "only this
+    // factory can make a token that IS an ABX token", which is simply false — anything that follows the
+    // protocol's event spine is an ABX token, and the factory is one way to get there, not the
+    // definition of the thing. Rather than restate it more carefully, the demo skips it: a first-timer
+    // does not need a provenance lecture before they have made anything.
+    if (!serveAfter)
+        step('Trust anchor');
     let factory;
     if (dryRun) {
         const existing = factoryAddress(flags.factory);
@@ -1051,16 +1058,7 @@ async function cmdDeploy(flags, serveAfter) {
         info(`would reuse canonical factory ${factory}`);
     }
     else {
-        factory = await ensureFactory(flags.factory, !!flags['bootstrap-factory']);
-    }
-    // The demo explains what it just did; `deploy` stays terse. The authenticity point is the least
-    // obvious thing about ABX and the easiest to get wrong, so it's worth spelling out — but in plain
-    // language, with the actual term parked in a dim aside for whoever wants to look it up.
-    if (serveAfter) {
-        console.log(`    ${g('✦')} anyone can write a contract that ${bold('claims')} to be an ABX token`);
-        console.log(`    ${g('✦')} only this one factory can make a token that ${bold('is')} one`);
-        info(dim('so "is this real?" is a yes/no question anyone can ask the chain — not a matter of trusting us'));
-        info(dim(`the factory answers it on-chain: isAbxClone(yourToken) · ${EXPLORER}/address/${factory}`));
+        factory = await ensureFactory(flags.factory, !!flags['bootstrap-factory'], serveAfter);
     }
     // --onchain-uri: resolve tokenURI/contractURI fully on-chain via the canonical renderer
     // (the JSON is assembled from on-chain fields → no resolver needed, ever). The off-chain
@@ -1437,7 +1435,10 @@ async function cmdDeploy(flags, serveAfter) {
     if (serveAfter) {
         if (state.eventCount > 0)
             ok(`read ${bold(String(state.eventCount))} events straight off ${CHAIN} in ${elapsedMs}ms — no API key, no company's server`);
-        info(`it says: "${state.name}" · owned by ${state.owner} · ${state.isCanonical ? `${g('verified real')} ${dim('(that factory vouched for it)')}` : `${c.orange}unverified${c.reset}`}`);
+        // "verified real" overstated it in the same way the removed trust-anchor step did — factory
+        // provenance is a fact about how this contract was made, not a verdict on whether a token counts
+        // as ABX. Report the fact.
+        info(`it says: "${state.name}" · owned by ${state.owner} · ${state.isCanonical ? g('made by the canonical factory') : dim('not factory-made')}`);
         info(dim(`optional features switched on: ${state.extensions.map((e) => e.name.replace(/^abx\.extension\./, '')).join(' · ') || 'none'}`));
         walkthroughSpine(state);
     }
@@ -5498,7 +5499,7 @@ function help() {
     ${g('abx version')}             print the installed CLI version
 
   ${dim('Run')} ${g('abx <command> --help')} ${dim('for per-command usage. --help / -h never executes — it only prints usage.')}
-  ${dim('abx checks npm for a newer release (once a day, notify-only). Silence with')} ${g('ABX_NO_UPDATE_CHECK=1')} ${dim('or')} ${g('--no-update-check')}${dim('.')}
+  ${dim('abx checks npm for a newer release (every 6h, notify-only). Silence with')} ${g('ABX_NO_UPDATE_CHECK=1')} ${dim('or')} ${g('--no-update-check')}${dim('.')}
 `);
 }
 /** Validate an explicit --salt (a 32-byte hex). Undefined when absent. */