@artblocks/abx-sdk 0.1.0-alpha.0

package/dist/clients.js

@@ -0,0 +1,90 @@
+import { createPublicClient, createWalletClient, fallback, http, } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { DEFAULT_CHAIN_KEY, resolveChain, resolveRpcUrls, rpcEnvVar } from './chains.js';
+import { loadDotEnv } from './env.js';
+/**
+ * A transport over one or more endpoints. With several, a viem `fallback` fails
+ * over on error — so a request one endpoint rejects (e.g. a too-wide `eth_getLogs`)
+ * is retried on the next, which is how the toolkit "finds the endpoint fit for the
+ * job" at request time. `retryCount: 0` makes that failover immediate.
+ */
+function makeTransport(opts) {
+    if (opts.rpcUrl)
+        return http(opts.rpcUrl);
+    const urls = resolveRpcUrls(opts.chainKey);
+    if (urls.length <= 1)
+        return http(urls[0]);
+    return fallback(urls.map((u) => http(u, { retryCount: 0 })));
+}
+/** A read-only client — all the indexer and token API ever need. */
+export function makePublicClient(opts = {}) {
+    return createPublicClient({ chain: resolveChain(opts.chainKey), transport: makeTransport(opts) });
+}
+const verifiedChains = new Set();
+/**
+ * Verify the configured RPC actually IS the chain we think it is, before any write.
+ * The env var names a network ("sepolia") but the URL behind it could point anywhere;
+ * this calls `eth_chainId` and hard-fails on a mismatch so an irreversible tx can't go
+ * to the wrong chain. Memoized per chainKey — one round-trip per process, so callers can
+ * invoke it liberally at write preflights. Reads never call it (they stay zero-overhead).
+ *
+ * `allowUnreachable` (used by `--dry-run` preflights): a *wrong-network* RPC still hard-fails
+ * with the clear mismatch message — a dry run makes RPC reads (predict address, resolve the
+ * factory/renderer) that otherwise fail deep inside viem as an opaque "returned no data" — but
+ * an *unreachable* RPC is tolerated (returns silently), so a genuinely offline `--dry-run` can
+ * still preview what it can. Only a reachable-but-wrong endpoint is a preview-blocking error.
+ */
+export async function assertChainId(chainKey = DEFAULT_CHAIN_KEY, opts = {}) {
+    if (verifiedChains.has(chainKey))
+        return;
+    const expected = resolveChain(chainKey).id;
+    let actual;
+    try {
+        actual = await makePublicClient({ chainKey }).getChainId();
+    }
+    catch (err) {
+        if (opts.allowUnreachable)
+            return; // offline dry-run: preview what we can, don't block
+        throw new Error(`Could not reach an RPC for '${chainKey}' to verify the network: ${err.message}. ` +
+            `Check ${rpcEnvVar(chainKey)} / ABX_RPC_URLS in your .env.`);
+    }
+    if (actual !== expected) {
+        throw new Error(`RPC network mismatch: the configured endpoint reports chain ${actual}, but ABX_CHAIN='${chainKey}' ` +
+            `expects ${expected}. Point ${rpcEnvVar(chainKey)} (or ABX_RPC_URLS) at a '${chainKey}' endpoint.`);
+    }
+    verifiedChains.add(chainKey);
+}
+/**
+ * A signing client, backed by a private key from the environment. The SDK never
+ * takes custody of keys beyond reading them from the operator's own env — there
+ * is no key storage, no prompt, no remote signer here.
+ *
+ * Key precedence: `ABX_DEPLOYER_PK` → `SEPOLIA_FUNDED_PK` → `SEPOLIA_WALLET_PK`.
+ */
+export function makeWalletClient(opts = {}) {
+    loadDotEnv();
+    const pk = process.env.ABX_DEPLOYER_PK ?? process.env.SEPOLIA_FUNDED_PK ?? process.env.SEPOLIA_WALLET_PK;
+    if (!pk) {
+        throw new Error('No signing key found. Set ABX_DEPLOYER_PK, SEPOLIA_FUNDED_PK, or SEPOLIA_WALLET_PK in your .env.');
+    }
+    const account = privateKeyToAccount(normalizePk(pk));
+    const chain = resolveChain(opts.chainKey);
+    const wallet = createWalletClient({ account, chain, transport: makeTransport(opts) });
+    return { wallet, account };
+}
+function normalizePk(pk) {
+    const trimmed = pk.trim();
+    return (trimmed.startsWith('0x') ? trimmed : `0x${trimmed}`);
+}
+/**
+ * The env signing key (0x-normalized), same precedence as {@link makeWalletClient}
+ * (`ABX_DEPLOYER_PK` → `SEPOLIA_FUNDED_PK` → `SEPOLIA_WALLET_PK`), or `undefined` if none is set.
+ * For reusing the hot key as a *storage* signing identity (an Ethereum Turbo identity) without
+ * constructing a wallet client. Never throws.
+ */
+export function envSigningKey() {
+    loadDotEnv();
+    const pk = process.env.ABX_DEPLOYER_PK ?? process.env.SEPOLIA_FUNDED_PK ?? process.env.SEPOLIA_WALLET_PK;
+    return pk ? normalizePk(pk) : undefined;
+}
+//# sourceMappingURL=clients.js.map

package/dist/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"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"}

package/dist/create2.d.ts

@@ -0,0 +1,42 @@
+import { type Address, type Hex } from 'viem';
+/**
+ * Keyless CREATE2 deployment — the TS twin of `contracts/script/AbxSalts.sol`.
+ *
+ * ABX infra is deployed through the keyless CREATE2 proxy (present at the same address on every EVM
+ * chain — the address `forge` routes `new X{salt: …}()` through) with a canonical salt, so a given
+ * contract has the **same address on every chain**. Keeping the salts + proxy here lets the SDK/CLI
+ * predict those addresses and deploy to them, so the toolkit's lazy deployers land at the exact
+ * addresses the forge scripts (and the manifest) use — deterministic everywhere, no drift.
+ */
+/** The keyless CREATE2 proxy (Arachnid deterministic-deployment-proxy). Same address on every chain. */
+export declare const CREATE2_PROXY: Address;
+/** Canonical salt strings — MUST stay byte-identical to `contracts/script/AbxSalts.sol`, since the
+ *  deterministic address is `keccak256(0xff ++ proxy ++ keccak256(salt) ++ keccak256(initcode))`. */
+export declare const ABX_SALT: {
+    readonly oneOfOneFactory: "abx.factory.one-of-one.v1";
+    readonly seriesFactory: "abx.factory.series.v1";
+    readonly seriesCodeFactory: "abx.factory.series-code.v1";
+    readonly renderer: "abx.renderer.v1";
+    readonly chunkStore: "abx.chunk-store.v1";
+    readonly fixedPriceMinter: "abx.minter.fixed-price.v1";
+    readonly seedSource: "abx.seed-source.v1";
+    readonly generator: "abx.generator.v1";
+};
+/** The 32-byte salt a CREATE2 deploy uses (`keccak256` of the canonical string). */
+export declare const saltHash: (salt: string) => Hex;
+/** The deterministic address `bytecode` deploys to under `salt` via the keyless proxy — identical
+ *  on every chain. Pure: no chain access. */
+export declare function predictCreate2Address(salt: string, bytecode: Hex): Address;
+/** The calldata a CREATE2-proxy deploy sends: 32-byte salt ++ initcode (the proxy CREATE2-deploys it). */
+export declare function create2Calldata(salt: string, bytecode: Hex): Hex;
+/** The canonical (cross-chain-identical) AbxChunkStore address for the current bytecode. */
+export declare const predictChunkStore: () => Address;
+/** The canonical (cross-chain-identical) AbxMetadataRenderer address for the current bytecode. */
+export declare const predictRenderer: () => Address;
+/** The canonical (cross-chain-identical) AbxFixedPriceMinter address for the current bytecode. */
+export declare const predictFixedPriceMinter: () => Address;
+/** The canonical (cross-chain-identical) AbxSeedSource address. Deploy it standalone
+ *  (`DeploySeedSource.s.sol`) so it compiles at the default profile — bundling it with the
+ *  SeriesCode factory's `clone-impl` unit yields a different, non-canonical bytecode + address. */
+export declare const predictSeedSource: () => Address;
+//# sourceMappingURL=create2.d.ts.map

package/dist/create2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create2.d.ts","sourceRoot":"","sources":["../src/create2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,OAAO,EAAE,KAAK,GAAG,EAAC,MAAM,MAAM,CAAC;AAQ5F;;;;;;;;GAQG;AAEH,wGAAwG;AACxG,eAAO,MAAM,aAAa,EAAE,OAAsD,CAAC;AAEnF;qGACqG;AACrG,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,oFAAoF;AACpF,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,GAA+B,CAAC;AAExE;6CAC6C;AAC7C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAE1E;AAED,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG,CAEhE;AAED,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,QAAO,OAA4E,CAAC;AAElH,kGAAkG;AAClG,eAAO,MAAM,eAAe,QAAO,OAAgF,CAAC;AAEpH,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,QAAO,OACoC,CAAC;AAEhF;;mGAEmG;AACnG,eAAO,MAAM,iBAAiB,QAAO,OAA4E,CAAC"}

package/dist/create2.js

@@ -0,0 +1,47 @@
+import { concat, getContractAddress, keccak256, toBytes } from 'viem';
+import { abxChunkStoreBytecode, abxFixedPriceMinterBytecode, abxMetadataRendererBytecode, abxSeedSourceBytecode, } from './abi/index.js';
+/**
+ * Keyless CREATE2 deployment — the TS twin of `contracts/script/AbxSalts.sol`.
+ *
+ * ABX infra is deployed through the keyless CREATE2 proxy (present at the same address on every EVM
+ * chain — the address `forge` routes `new X{salt: …}()` through) with a canonical salt, so a given
+ * contract has the **same address on every chain**. Keeping the salts + proxy here lets the SDK/CLI
+ * predict those addresses and deploy to them, so the toolkit's lazy deployers land at the exact
+ * addresses the forge scripts (and the manifest) use — deterministic everywhere, no drift.
+ */
+/** The keyless CREATE2 proxy (Arachnid deterministic-deployment-proxy). Same address on every chain. */
+export const CREATE2_PROXY = '0x4e59b44847b379578588920cA78FbF26c0B4956C';
+/** Canonical salt strings — MUST stay byte-identical to `contracts/script/AbxSalts.sol`, since the
+ *  deterministic address is `keccak256(0xff ++ proxy ++ keccak256(salt) ++ keccak256(initcode))`. */
+export const ABX_SALT = {
+    oneOfOneFactory: 'abx.factory.one-of-one.v1',
+    seriesFactory: 'abx.factory.series.v1',
+    seriesCodeFactory: 'abx.factory.series-code.v1',
+    renderer: 'abx.renderer.v1',
+    chunkStore: 'abx.chunk-store.v1',
+    fixedPriceMinter: 'abx.minter.fixed-price.v1',
+    seedSource: 'abx.seed-source.v1',
+    generator: 'abx.generator.v1',
+};
+/** The 32-byte salt a CREATE2 deploy uses (`keccak256` of the canonical string). */
+export const saltHash = (salt) => keccak256(toBytes(salt));
+/** The deterministic address `bytecode` deploys to under `salt` via the keyless proxy — identical
+ *  on every chain. Pure: no chain access. */
+export function predictCreate2Address(salt, bytecode) {
+    return getContractAddress({ opcode: 'CREATE2', from: CREATE2_PROXY, salt: saltHash(salt), bytecode });
+}
+/** The calldata a CREATE2-proxy deploy sends: 32-byte salt ++ initcode (the proxy CREATE2-deploys it). */
+export function create2Calldata(salt, bytecode) {
+    return concat([saltHash(salt), bytecode]);
+}
+/** The canonical (cross-chain-identical) AbxChunkStore address for the current bytecode. */
+export const predictChunkStore = () => predictCreate2Address(ABX_SALT.chunkStore, abxChunkStoreBytecode);
+/** The canonical (cross-chain-identical) AbxMetadataRenderer address for the current bytecode. */
+export const predictRenderer = () => predictCreate2Address(ABX_SALT.renderer, abxMetadataRendererBytecode);
+/** The canonical (cross-chain-identical) AbxFixedPriceMinter address for the current bytecode. */
+export const predictFixedPriceMinter = () => predictCreate2Address(ABX_SALT.fixedPriceMinter, abxFixedPriceMinterBytecode);
+/** The canonical (cross-chain-identical) AbxSeedSource address. Deploy it standalone
+ *  (`DeploySeedSource.s.sol`) so it compiles at the default profile — bundling it with the
+ *  SeriesCode factory's `clone-impl` unit yields a different, non-canonical bytecode + address. */
+export const predictSeedSource = () => predictCreate2Address(ABX_SALT.seedSource, abxSeedSourceBytecode);
+//# sourceMappingURL=create2.js.map

package/dist/create2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create2.js","sourceRoot":"","sources":["../src/create2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAyB,MAAM,MAAM,CAAC;AAC5F,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;GAQG;AAEH,wGAAwG;AACxG,MAAM,CAAC,MAAM,aAAa,GAAY,4CAA4C,CAAC;AAEnF;qGACqG;AACrG,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,eAAe,EAAE,2BAA2B;IAC5C,aAAa,EAAE,uBAAuB;IACtC,iBAAiB,EAAE,4BAA4B;IAC/C,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,oBAAoB;IAChC,gBAAgB,EAAE,2BAA2B;IAC7C,UAAU,EAAE,oBAAoB;IAChC,SAAS,EAAE,kBAAkB;CACrB,CAAC;AAEX,oFAAoF;AACpF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAO,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAExE;6CAC6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,QAAa;IAC/D,OAAO,kBAAkB,CAAC,EAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAC;AACtG,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAa;IACzD,OAAO,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAElH,kGAAkG;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAEpH,kGAAkG;AAClG,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAY,EAAE,CACnD,qBAAqB,CAAC,QAAQ,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC;AAEhF;;mGAEmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/deploy.d.ts

@@ -0,0 +1,192 @@
+import { type Account, type Address, type Hex, type PublicClient, type WalletClient } from 'viem';
+/** One on-chain metadata field to set at deploy (bytes32 `field`/`representation`, bytes `value`). */
+export interface OnChainFieldInput {
+    field: Hex;
+    representation: Hex;
+    value: Hex;
+}
+/** Mirrors `OneOfOneImage.InitParams` (the deploy-time configuration). */
+export interface OneOfOneInitParams {
+    owner: Address;
+    /** Recipient of the token at deploy; `0x0` (zeroAddress) defers the mint to a later `mint(to)`. */
+    mintTo: Address;
+    name: string;
+    symbol: string;
+    /** Off-chain resolver base; the per-token pointer is derived on-chain as
+     *  `{base}/{chainId}/{address}/{tokenId}`. Empty ⇒ no off-chain pointer. */
+    tokenURIBase: string;
+    /** On-chain renderer for the token URI; `0x0` ⇒ resolve off-chain via the base. */
+    tokenURIRenderer: Address;
+    /** Off-chain resolver base for the collection; derived as `{base}/{chainId}/{address}`. */
+    contractURIBase: string;
+    /** On-chain renderer for the collection URI; `0x0` ⇒ resolve off-chain via the base. */
+    contractURIRenderer: Address;
+    royaltyReceiver: Address;
+    royaltyBps: number;
+    /** Optional on-chain metadata fields for token 0 and for the collection. */
+    tokenFields: OnChainFieldInput[];
+    contractFields: OnChainFieldInput[];
+}
+/** One per-token on-chain metadata field to set at deploy — keyed by `tokenId`. */
+export interface SeriesTokenFieldInput {
+    tokenId: bigint | number;
+    field: Hex;
+    representation: Hex;
+    value: Hex;
+}
+/** Mirrors `SeriesImage.InitParams` (the multi-token deploy-time configuration). */
+export interface SeriesInitParams {
+    owner: Address;
+    name: string;
+    symbol: string;
+    /** Off-chain resolver base; per-token pointer derived as `{base}/{chainId}/{address}/{tokenId}`. */
+    tokenURIBase: string;
+    /** On-chain renderer for the token URI; `0x0` ⇒ resolve off-chain via the base. */
+    tokenURIRenderer: Address;
+    contractURIBase: string;
+    contractURIRenderer: Address;
+    royaltyReceiver: Address;
+    royaltyBps: number;
+    /** Series size N (> 0): the supply cap. Monotonically non-increasing after deploy. */
+    maxInvocations: bigint | number;
+    /** Primary-sale payout destination (`0x0` = none). */
+    primaryPayee: Address;
+    /** Initial authorized minter — a single address (`0x0` = owner-only minting). */
+    minter: Address;
+    /** Initial mint-pause state — `true` = owner-only minting until unpaused (deploy-time
+     *  reserves still mint). Projects usually deploy paused and unpause to go live. */
+    paused: boolean;
+    /** Recipient for the deploy-time mint (`0x0` defers all minting). */
+    mintTo: Address;
+    /** Tokens to mint in order (`[0, mintCount)`) at deploy; `<= maxInvocations`. */
+    mintCount: bigint | number;
+    /** Optional per-token on-chain metadata fields (keyed by token id). */
+    tokenFields: SeriesTokenFieldInput[];
+    contractFields: OnChainFieldInput[];
+}
+/** {@link SeriesInitParams} plus the code-project extension config ({SeriesCode.InitParams}). */
+export interface SeriesCodeInitParams extends SeriesInitParams {
+    /** IAbxSeedSource the token calls at mint (`0x0` = no mint-time seed). */
+    seedSource: Address;
+    /** Opt out of delegate.xyz on the TokenOwner auth leg (default false = canonical registry). */
+    disableTokenOwnerDelegation: boolean;
+}
+export interface DeployResult<T extends string> {
+    txHash: Hex;
+    blockNumber: bigint;
+}
+/**
+ * A salt that reserves the deployed address to `deployer`. The factory's salt
+ * guard requires the leading 20 bytes to equal `msg.sender` when non-zero, so
+ * encoding the deployer there makes the address **front-run-proof**: nobody else
+ * can land their params on the address this salt predicts. The trailing 12 bytes
+ * are entropy (pass your own to mine a vanity suffix; random otherwise). Works for
+ * any account type — an EOA, an ERC-4337 smart account, or a Safe — since each is
+ * the `msg.sender` the factory checks.
+ */
+export declare function saltFor(deployer: Address, entropy?: Hex): Hex;
+/**
+ * A permissionless salt: an all-zero guard prefix, so **anyone** may deploy to the
+ * address it predicts (a shared, canonical deployment). No front-run protection —
+ * use only when a publicly-deployable, caller-independent address is the point.
+ */
+export declare function permissionlessSalt(entropy?: Hex): Hex;
+/** The address a salt reserves the deploy to (`0x0` ⇒ permissionless). */
+export declare function saltGuard(salt: Hex): Address;
+/**
+ * Deploy the canonical clone factory — the trust anchor. Ownerless and immutable;
+ * once deployed, its address is what platforms allowlist. Deploy this once per
+ * (chain, core version) and reuse it for every clone.
+ */
+export declare function deployFactory(wallet: WalletClient, account: Account, publicClient: PublicClient): Promise<DeployResult<'factory'> & {
+    factory: Address;
+    implementation: Address;
+}>;
+/**
+ * Deploy the canonical Series clone factory — the trust anchor for multi-token drops.
+ * Ownerless and immutable; the sibling of `deployFactory`. Deploy once per (chain, core
+ * version). The shared renderer + chunk store are reused (deploy them separately).
+ */
+export declare function deploySeriesFactory(wallet: WalletClient, account: Account, publicClient: PublicClient): Promise<DeployResult<'seriesFactory'> & {
+    factory: Address;
+    implementation: Address;
+}>;
+/**
+ * Deploy the code-project trust root on a chain with no canonical set: the two
+ * delegatecalled write-path libraries first ({AbxParamsLib}, {AbxCodeLib}), the factory
+ * bytecode LINKED against them (solc placeholders replaced — what forge does at build
+ * time, done here so a sandbox/fresh chain needs no forge), then the factory (whose
+ * constructor deploys the {SeriesCode} implementation).
+ */
+export declare function deploySeriesCodeFactory(wallet: WalletClient, account: Account, publicClient: PublicClient): Promise<{
+    factory: Address;
+    implementation: Address;
+    paramsLib: Address;
+    codeLib: Address;
+    txHash: Hex;
+    blockNumber: bigint;
+}>;
+/** Deploy the canonical pseudorandom seed source (for chains without one shipped). CREATE2 via the
+ *  keyless proxy + canonical salt → the SAME address on every chain (matches `DeploySeedSource.s.sol`
+ *  and the manifest). The seed source is single-profile, so — unlike the SeriesCode factory — the
+ *  SDK's bytecode is the canonical one. */
+export declare function deploySeedSource(wallet: WalletClient, account: Account, publicClient: PublicClient): Promise<{
+    seedSource: Address;
+    txHash: Hex;
+}>;
+/**
+ * Deploy `AbxMetadataRenderer` — the canonical on-chain metadata renderer.
+ * Stateless and shared: deploy once per chain, then point any number of tokens at it via
+ * their URI-renderer config. It reads each token's on-chain fields and returns a
+ * `data:application/json` URI, so a token using it resolves with zero off-chain infra.
+ */
+export declare function deployRenderer(wallet: WalletClient, account: Account, publicClient: PublicClient): Promise<DeployResult<'renderer'> & {
+    renderer: Address;
+    specVersion: bigint;
+}>;
+/**
+ * Deploy `AbxFixedPriceMinter` — the canonical, ownerless, multi-tenant fixed-price sale
+ * singleton (the Minter spine reference). Deploy once per chain; every project shares it
+ * (config is keyed by token address, authority defers to each token's owner). Sibling of
+ * `deployRenderer` — ownerless, no constructor args, safe for any funded signer to stand up.
+ */
+export declare function deployFixedPriceMinter(wallet: WalletClient, account: Account, publicClient: PublicClient): Promise<DeployResult<'fixedPriceMinter'> & {
+    minter: Address;
+}>;
+/**
+ * The address `deployOneOfOne` will produce for this (factory, salt). It's a pure
+ * function of the salt — independent of who deploys — so it can be predicted and
+ * its URIs baked in before any signer is known. (Front-running is governed by the
+ * salt's guard prefix; see `saltFor` / `permissionlessSalt`.)
+ */
+export declare function predictClone(publicClient: PublicClient, args: {
+    factory: Address;
+    salt: Hex;
+}): Promise<Address>;
+/**
+ * Deploy a 1/1 image NFT as an immutable EIP-1167 clone, at a deterministic
+ * address (so URIs can be baked in before deploy). Returns the clone address and
+ * the block it landed in — the indexer's start block.
+ */
+export declare function deployOneOfOne(wallet: WalletClient, account: Account | Address, publicClient: PublicClient, args: {
+    factory: Address;
+    params: OneOfOneInitParams;
+    salt: Hex;
+}): Promise<DeployResult<'clone'> & {
+    clone: Address;
+}>;
+/**
+ * Deploy a Series (multi-token) NFT as an immutable EIP-1167 clone, at a deterministic
+ * address. The sibling of `deployOneOfOne`. `predictClone` works unchanged — the
+ * `predictDeterministicAddress` fragment is identical across factories, and each factory
+ * computes with its own implementation. `params.mintCount`/`mintTo` decide the deploy-time
+ * mint; anything larger mints post-deploy under a gas budget.
+ */
+export declare function deploySeries(wallet: WalletClient, account: Account | Address, publicClient: PublicClient, args: {
+    factory: Address;
+    params: SeriesInitParams;
+    salt: Hex;
+}): Promise<DeployResult<'clone'> & {
+    clone: Address;
+}>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"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"}

package/dist/deploy.js

@@ -0,0 +1,231 @@
+import { concat, getAddress, toHex, zeroAddress, keccak256, toBytes, } from 'viem';
+import { oneOfOneImageFactoryAbi, oneOfOneImageFactoryBytecode, seriesImageFactoryAbi, seriesImageFactoryBytecode, abxMetadataRendererAbi, abxMetadataRendererBytecode, abxFixedPriceMinterBytecode, seriesCodeFactoryAbi, seriesCodeFactoryBytecode, abxSeedSourceBytecode, abxParamsLibBytecode, abxCodeLibBytecode, } from './abi/index.js';
+import { ABX_SALT, CREATE2_PROXY, create2Calldata, predictCreate2Address } from './create2.js';
+/** 12 bytes of entropy — the non-guard tail of a deterministic-deploy salt. */
+function entropy12() {
+    return toHex(crypto.getRandomValues(new Uint8Array(12)));
+}
+/**
+ * A salt that reserves the deployed address to `deployer`. The factory's salt
+ * guard requires the leading 20 bytes to equal `msg.sender` when non-zero, so
+ * encoding the deployer there makes the address **front-run-proof**: nobody else
+ * can land their params on the address this salt predicts. The trailing 12 bytes
+ * are entropy (pass your own to mine a vanity suffix; random otherwise). Works for
+ * any account type — an EOA, an ERC-4337 smart account, or a Safe — since each is
+ * the `msg.sender` the factory checks.
+ */
+export function saltFor(deployer, entropy = entropy12()) {
+    return concat([getAddress(deployer), entropy]); // 20 + 12 = 32 bytes
+}
+/**
+ * A permissionless salt: an all-zero guard prefix, so **anyone** may deploy to the
+ * address it predicts (a shared, canonical deployment). No front-run protection —
+ * use only when a publicly-deployable, caller-independent address is the point.
+ */
+export function permissionlessSalt(entropy = entropy12()) {
+    return concat([zeroAddress, entropy]); // zero prefix + 12 bytes
+}
+/** The address a salt reserves the deploy to (`0x0` ⇒ permissionless). */
+export function saltGuard(salt) {
+    return getAddress(`0x${salt.slice(2, 42)}`);
+}
+/**
+ * Deploy the canonical clone factory — the trust anchor. Ownerless and immutable;
+ * once deployed, its address is what platforms allowlist. Deploy this once per
+ * (chain, core version) and reuse it for every clone.
+ */
+export async function deployFactory(wallet, account, publicClient) {
+    const txHash = await wallet.deployContract({
+        abi: oneOfOneImageFactoryAbi,
+        bytecode: oneOfOneImageFactoryBytecode,
+        account,
+        chain: wallet.chain,
+        args: [],
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    if (!receipt.contractAddress)
+        throw new Error('Factory deploy produced no contract address');
+    const factory = receipt.contractAddress;
+    const implementation = (await publicClient.readContract({
+        address: factory,
+        abi: oneOfOneImageFactoryAbi,
+        functionName: 'implementation',
+    }));
+    return { factory, implementation, txHash, blockNumber: receipt.blockNumber };
+}
+/**
+ * Deploy the canonical Series clone factory — the trust anchor for multi-token drops.
+ * Ownerless and immutable; the sibling of `deployFactory`. Deploy once per (chain, core
+ * version). The shared renderer + chunk store are reused (deploy them separately).
+ */
+export async function deploySeriesFactory(wallet, account, publicClient) {
+    const txHash = await wallet.deployContract({
+        abi: seriesImageFactoryAbi,
+        bytecode: seriesImageFactoryBytecode,
+        account,
+        chain: wallet.chain,
+        args: [],
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    if (!receipt.contractAddress)
+        throw new Error('Series factory deploy produced no contract address');
+    const factory = receipt.contractAddress;
+    const implementation = (await publicClient.readContract({
+        address: factory,
+        abi: seriesImageFactoryAbi,
+        functionName: 'implementation',
+    }));
+    return { factory, implementation, txHash, blockNumber: receipt.blockNumber };
+}
+/** The solc link placeholder for a fully-qualified library name: `__$<keccak(fqn)[0:34]>$__`. */
+function libPlaceholder(fullyQualified) {
+    return `__$${keccak256(toBytes(fullyQualified)).slice(2, 36)}$__`;
+}
+/**
+ * Deploy the code-project trust root on a chain with no canonical set: the two
+ * delegatecalled write-path libraries first ({AbxParamsLib}, {AbxCodeLib}), the factory
+ * bytecode LINKED against them (solc placeholders replaced — what forge does at build
+ * time, done here so a sandbox/fresh chain needs no forge), then the factory (whose
+ * constructor deploys the {SeriesCode} implementation).
+ */
+export async function deploySeriesCodeFactory(wallet, account, publicClient) {
+    const deployRaw = async (bytecode) => {
+        const hash = await wallet.sendTransaction({ data: bytecode, account, chain: wallet.chain, to: null });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash });
+        if (!receipt.contractAddress)
+            throw new Error('library deploy produced no contract address');
+        return { address: receipt.contractAddress, hash };
+    };
+    const { address: paramsLib } = await deployRaw(abxParamsLibBytecode);
+    const { address: codeLib } = await deployRaw(abxCodeLibBytecode);
+    const linked = seriesCodeFactoryBytecode
+        .split(libPlaceholder('src/libraries/AbxParamsLib.sol:AbxParamsLib'))
+        .join(paramsLib.slice(2).toLowerCase())
+        .split(libPlaceholder('src/libraries/AbxCodeLib.sol:AbxCodeLib'))
+        .join(codeLib.slice(2).toLowerCase());
+    if (linked.includes('__$'))
+        throw new Error('unlinked library placeholder remains in SeriesCodeFactory bytecode');
+    const txHash = await wallet.deployContract({ abi: seriesCodeFactoryAbi, bytecode: linked, account, chain: wallet.chain, args: [] });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    if (!receipt.contractAddress)
+        throw new Error('SeriesCodeFactory deploy produced no contract address');
+    const factory = receipt.contractAddress;
+    const implementation = (await publicClient.readContract({
+        address: factory,
+        abi: seriesCodeFactoryAbi,
+        functionName: 'implementation',
+    }));
+    return { factory, implementation, paramsLib, codeLib, txHash, blockNumber: receipt.blockNumber };
+}
+/** Deploy the canonical pseudorandom seed source (for chains without one shipped). CREATE2 via the
+ *  keyless proxy + canonical salt → the SAME address on every chain (matches `DeploySeedSource.s.sol`
+ *  and the manifest). The seed source is single-profile, so — unlike the SeriesCode factory — the
+ *  SDK's bytecode is the canonical one. */
+export async function deploySeedSource(wallet, account, publicClient) {
+    const seedSource = predictCreate2Address(ABX_SALT.seedSource, abxSeedSourceBytecode);
+    const txHash = await wallet.sendTransaction({
+        account,
+        chain: wallet.chain,
+        to: CREATE2_PROXY,
+        data: create2Calldata(ABX_SALT.seedSource, abxSeedSourceBytecode),
+    });
+    await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return { seedSource, txHash };
+}
+/**
+ * Deploy `AbxMetadataRenderer` — the canonical on-chain metadata renderer.
+ * Stateless and shared: deploy once per chain, then point any number of tokens at it via
+ * their URI-renderer config. It reads each token's on-chain fields and returns a
+ * `data:application/json` URI, so a token using it resolves with zero off-chain infra.
+ */
+export async function deployRenderer(wallet, account, publicClient) {
+    // CREATE2 via the keyless proxy + canonical salt → the SAME address on every chain (matches the
+    // forge `DeployRenderer` script and the manifest). Address is deterministic, so compute it (the
+    // tx targets the proxy, not a contract creation, so `receipt.contractAddress` is null).
+    const renderer = predictCreate2Address(ABX_SALT.renderer, abxMetadataRendererBytecode);
+    const txHash = await wallet.sendTransaction({
+        account,
+        chain: wallet.chain,
+        to: CREATE2_PROXY,
+        data: create2Calldata(ABX_SALT.renderer, abxMetadataRendererBytecode),
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    const specVersion = (await publicClient.readContract({
+        address: renderer,
+        abi: abxMetadataRendererAbi,
+        functionName: 'specVersion',
+    }));
+    return { renderer, specVersion, txHash, blockNumber: receipt.blockNumber };
+}
+/**
+ * Deploy `AbxFixedPriceMinter` — the canonical, ownerless, multi-tenant fixed-price sale
+ * singleton (the Minter spine reference). Deploy once per chain; every project shares it
+ * (config is keyed by token address, authority defers to each token's owner). Sibling of
+ * `deployRenderer` — ownerless, no constructor args, safe for any funded signer to stand up.
+ */
+export async function deployFixedPriceMinter(wallet, account, publicClient) {
+    // CREATE2 via the keyless proxy + canonical salt → the SAME address on every chain (matches the
+    // forge `DeployMinter` script and the manifest). Address is deterministic, so compute it.
+    const minter = predictCreate2Address(ABX_SALT.fixedPriceMinter, abxFixedPriceMinterBytecode);
+    const txHash = await wallet.sendTransaction({
+        account,
+        chain: wallet.chain,
+        to: CREATE2_PROXY,
+        data: create2Calldata(ABX_SALT.fixedPriceMinter, abxFixedPriceMinterBytecode),
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return { minter, txHash, blockNumber: receipt.blockNumber };
+}
+/**
+ * The address `deployOneOfOne` will produce for this (factory, salt). It's a pure
+ * function of the salt — independent of who deploys — so it can be predicted and
+ * its URIs baked in before any signer is known. (Front-running is governed by the
+ * salt's guard prefix; see `saltFor` / `permissionlessSalt`.)
+ */
+export async function predictClone(publicClient, args) {
+    return (await publicClient.readContract({
+        address: args.factory,
+        abi: oneOfOneImageFactoryAbi,
+        functionName: 'predictDeterministicAddress',
+        args: [args.salt],
+    }));
+}
+/**
+ * Deploy a 1/1 image NFT as an immutable EIP-1167 clone, at a deterministic
+ * address (so URIs can be baked in before deploy). Returns the clone address and
+ * the block it landed in — the indexer's start block.
+ */
+export async function deployOneOfOne(wallet, account, publicClient, args) {
+    const clone = await predictClone(publicClient, { factory: args.factory, salt: args.salt });
+    const { request } = await publicClient.simulateContract({
+        address: args.factory,
+        abi: oneOfOneImageFactoryAbi,
+        functionName: 'deployDeterministic',
+        args: [args.params, args.salt],
+        account,
+    });
+    const txHash = await wallet.writeContract(request);
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return { clone, txHash, blockNumber: receipt.blockNumber };
+}
+/**
+ * Deploy a Series (multi-token) NFT as an immutable EIP-1167 clone, at a deterministic
+ * address. The sibling of `deployOneOfOne`. `predictClone` works unchanged — the
+ * `predictDeterministicAddress` fragment is identical across factories, and each factory
+ * computes with its own implementation. `params.mintCount`/`mintTo` decide the deploy-time
+ * mint; anything larger mints post-deploy under a gas budget.
+ */
+export async function deploySeries(wallet, account, publicClient, args) {
+    const clone = await predictClone(publicClient, { factory: args.factory, salt: args.salt });
+    const { request } = await publicClient.simulateContract({
+        address: args.factory,
+        abi: seriesImageFactoryAbi,
+        functionName: 'deployDeterministic',
+        args: [args.params, args.salt],
+        account,
+    });
+    const txHash = await wallet.writeContract(request);
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return { clone, txHash, blockNumber: receipt.blockNumber };
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"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"}