@artblocks/abx-cli 0.1.0-alpha.4 → 0.1.0-alpha.41

package/dist/commands/submit-app.d.ts

@@ -0,0 +1,102 @@
+/**
+ * `abx submit-app` — optional post-deploy listing in the ABX App Store.
+ *
+ * Not part of deploy. A creator (or the agent driving them) opts in after the
+ * collection exists: mint one entry token through the store's gated minter, then
+ * write catalog copy as the registry's TokenOwner params. Same transactions as
+ * the store's `/submit` page; the CLI is the agent path.
+ *
+ * Catalog copy is NOT the collection's `--name` / `--description`. Those are NFT
+ * metadata. The store wants outcome copy — what someone can do — and this command
+ * requires those fields on purpose so an agent cannot silently reuse deploy flags.
+ */
+import { type Address, type PreparedTx } from '@artblocks/abx-sdk';
+import { type Flags } from '../flags.js';
+/** Matches the App Store registry schema (`lib/submissions.ts` in abx-app-store). */
+export declare const APP_CATEGORIES: readonly ["Create", "Games", "Physical world", "Records", "Coordination", "Utilities", "Developer tools"];
+export declare const APP_STAGES: readonly ["Live", "Prototype", "Concept"];
+export declare const APP_TONES: readonly ["acid", "coral", "blue", "violet", "amber", "mint"];
+export declare const APP_RELATIONSHIP = "built-on-abx";
+export declare const SUBMIT_APP_CATALOG_NOTE = "The on-chain listing is updated. Hosted catalog refresh timing is provider-owned; verify the displayed copy separately. Re-run this command to change the on-chain copy (no second mint).";
+declare const PARAM_KEYS: readonly ["name", "summary", "description", "url", "urlLabel", "image", "mark", "tone", "category", "relationships", "stage", "tags"];
+type ParamKey = (typeof PARAM_KEYS)[number];
+/** Sequencer/RPC per-tx gas cap. A full param dump in one multicall exceeds it. */
+export declare const MAX_CALLS_PER_TX = 3;
+export type SubmitAppEntry = {
+    name: string;
+    summary: string;
+    description: string;
+    url: string;
+    urlLabel: string;
+    image: string;
+    mark: string;
+    tone: (typeof APP_TONES)[number];
+    category: (typeof APP_CATEGORIES)[number];
+    stage: (typeof APP_STAGES)[number];
+    tags: string[];
+};
+export type AppStoreAddresses = {
+    registry: Address;
+    minter: Address;
+};
+/**
+ * Catalog copy from flags. Requires name / summary / description so deploy identity
+ * cannot silently become the listing.
+ */
+export declare function parseSubmitAppEntry(flags: Flags): SubmitAppEntry;
+export declare function paramValues(entry: SubmitAppEntry): Record<ParamKey, string>;
+export declare function resolveAppStoreAddresses(chainKey: string, flags?: Flags, env?: NodeJS.ProcessEnv): AppStoreAddresses;
+export declare function chunkItems<T>(items: T[], size?: number): T[][];
+export declare function buildParamOps(args: {
+    registry: Address;
+    tokenId: bigint;
+    entry: SubmitAppEntry;
+    chainId: number;
+}): PreparedTx[];
+export declare function batchParamOps(ops: PreparedTx[]): PreparedTx[];
+/**
+ * Bounded, backed-off retry for ONLY the first metadata write immediately following a mint THIS
+ * run performed.
+ *
+ * `pinGas` (packages/sdk/src/execute.ts) is a provable-floor lie detector: it re-tries an estimate
+ * only when the number it got back is BELOW a gas floor it can compute in advance from bytes stored
+ * on-chain (its own docs walk through why). None of `buildParamOps`'s writes carry a `gasFloor` — a
+ * param write has no on-chain bytes to compute one from — so an estimate revert on any of them
+ * surfaces through `pinGas` immediately, with zero retries: `if (floor === 0n) throw err`. That is
+ * the right GENERAL behavior — an unfloored estimate revert is usually a real rejection ("caller is
+ * not the token owner"), and teaching `pinGas` to retry every unfloored revert would hide real ones
+ * behind a multi-second stall on every write the CLI makes, not just this one.
+ *
+ * This ONE call site is different in a way `pinGas` has no way to see: the token being written to is
+ * one THIS SAME PROCESS just minted a few lines up. Its estimate reverting is very likely the same
+ * read-after-write lag `execute.ts` already retries the nonce and the code-deposit gas for — the RPC
+ * answering the estimate hasn't caught up to the mint's block yet, so the registry's owner-gated
+ * param check reads a token that (from that node's point of view) does not exist yet — just on a
+ * write `pinGas` has no floor to detect it with. So the retry lives here, scoped to exactly the one
+ * write our own just-broadcast mint could have caused to fail this way (see `resumableConfigError`
+ * for what happens once the bound is spent).
+ */
+export declare const FIRST_METADATA_WRITE_RETRY_DELAYS_MS: readonly [2000, 4000, 8000];
+/**
+ * Takes a `send` thunk rather than a tx + lane opts so the retry policy is testable on its own — a
+ * fake `send` that fails a scripted number of times before succeeding, no RPC or signing involved —
+ * the same shape `sendMintThenParams` above already uses for its lane-agnostic send injection.
+ */
+export declare function withFirstMetadataWriteRetry<T>(send: () => Promise<T>, delaysMs?: readonly number[]): Promise<T>;
+/**
+ * Wrap an exhausted retry as an explicit resumable result instead of a bare estimate error. The mint
+ * already happened and is irreversible, and the collection's `claimed` gate — read at the top of
+ * `cmdSubmitApp`, before either lane decides whether to build a mint tx at all — means the NEXT
+ * invocation, even seconds later once the RPC has caught up, is guaranteed to skip straight to
+ * writing metadata onto THIS token rather than minting a second one (see `cmdSubmitApp`'s `claimed`
+ * read and its `if (claimed) { … } else { … }` branch just below it — a fresh mint is only ever
+ * prepared in the `else`). So the fix is always the same command again, never a different one — name
+ * that explicitly rather than leaving a raw revert on screen with no next step.
+ */
+export declare function resumableConfigError(args: {
+    tokenId: bigint;
+    cause: unknown;
+}): Error;
+export declare function cmdSubmitApp(address: string | undefined, flags: Flags): Promise<void>;
+export {};
+//# sourceMappingURL=submit-app.d.ts.map

package/dist/commands/submit-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-app.d.ts","sourceRoot":"","sources":["../../src/commands/submit-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAOL,KAAK,OAAO,EAEZ,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAC,KAAK,KAAK,EAAW,MAAM,aAAa,CAAC;AAWjD,qFAAqF;AACrF,eAAO,MAAM,cAAc,2GAQjB,CAAC;AAEX,eAAO,MAAM,UAAU,2CAA4C,CAAC;AACpE,eAAO,MAAM,SAAS,+DAAgE,CAAC;AACvF,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,uBAAuB,8LACyJ,CAAC;AAE9L,QAAA,MAAM,UAAU,uIAaN,CAAC;AAEX,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAgElC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,CAAC;AA4DrE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CAchE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAe3E;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,KAAU,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,iBAAiB,CAenB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,SAAmB,GAAG,CAAC,EAAE,EAAE,CAKxE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,EAAE,CA+Bf;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAQ7D;AAoCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oCAAoC,6BAAiC,CAAC;AAEnF;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EACjD,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,QAAQ,GAAE,SAAS,MAAM,EAAyC,GACjE,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,GAAG,KAAK,CAOnF;AASD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAuR3F"}