@peddles/sdk 0.2.0

package/dist/launch/salt.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Salt handling for the two CREATE2 launch paths — a pure port of the web app's
+ * `features/launch/salt.ts`, held identical by test.
+ *
+ * ─── EVERY PEDDLES ADDRESS ENDS IN `1978` ────────────────────────────────────
+ * The platform contracts do, and launched tokens do too, with no option to choose
+ * otherwise. So there is no vanity field: a launch MINES a salt whose address
+ * carries the suffix, and the creator sees the address they will get.
+ *
+ * A salt does two jobs, and only one of them is the suffix:
+ *
+ *   1. It picks the address. Both contracts mix the variant AND `msg.sender`
+ *      into it (`keccak256(abi.encode(variant, sender, salt))`), so a salt only
+ *      ever addresses the caller's OWN CREATE2 space.
+ *   2. It defeats front-running. The token address is an input to the pool key,
+ *      so anyone who can predict it can open that pool first at a price of their
+ *      choosing — the launch then reverts `POOL_PRICE_MISMATCH`. Mining starts
+ *      from a CSPRNG value, so the mined salt is as unguessable as a random one.
+ *
+ * ─── LOCAL DERIVATION, CONTRACT CONFIRMATION ─────────────────────────────────
+ * Mining computes the address locally (65,536 expected attempts is not an RPC
+ * job), and the plan builders then CONFIRM the candidate with the contract's own
+ * `getPeddlesAddress` / `predictCoin` before it is shown or submitted.
+ */
+/** The required address suffix, lowercase hex, no `0x`. */
+export declare const ADDRESS_SUFFIX = "1978";
+/**
+ * `keccak256(abi.encode(uint8 variant, address sender, bytes32 salt))` — the
+ * salt binding both `PeddlesStockLaunchpad._boundSalt` and
+ * `PeddlesFactoryV20._boundSalt` apply.
+ */
+export declare function boundSalt(variant: number, sender: `0x${string}`, salt: `0x${string}`): `0x${string}`;
+/** Standard CREATE2: `keccak256(0xff ‖ deployer ‖ salt ‖ initCodeHash)[12:]`. */
+export declare function create2Address(deployer: `0x${string}`, salt: `0x${string}`, initCodeHash: `0x${string}`): `0x${string}`;
+export declare function hasSuffix(address: string, suffix?: string): boolean;
+/**
+ * A fresh unguessable salt from the platform CSPRNG (`crypto.getRandomValues`,
+ * never `Math.random`): this value is the only thing standing between a launch
+ * and a mempool watcher who opens the pool first.
+ */
+export declare function randomSalt(): `0x${string}`;
+/** `0x00…00` — the salt a caller means by "none", still bound to the sender. */
+export declare const ZERO_SALT: `0x${string}`;
+export interface MineParams {
+    /** The contract that runs CREATE2 — the launchpad or the factory. */
+    readonly deployer: `0x${string}`;
+    /** The variant byte the contract mixes into the salt. */
+    readonly variant: number;
+    /** The `msg.sender` the contract binds the salt to — the creator, or the orchestrator. */
+    readonly sender: `0x${string}`;
+    readonly initCodeHash: `0x${string}`;
+    readonly suffix?: string;
+    /** Anything with an `aborted` flag — an `AbortSignal`, or a plain object a caller flips. */
+    readonly signal?: {
+        readonly aborted: boolean;
+    };
+    /** Called every chunk with the attempt count so far. */
+    readonly onProgress?: (attempts: number) => void;
+    /**
+     * Hard ceiling on attempts. A 4-hex suffix is 1 in 65,536; the default is ~60×
+     * that, so hitting it means something is wrong with the inputs, not bad luck,
+     * and the caller fails closed rather than looping forever.
+     */
+    readonly maxAttempts?: number;
+}
+export interface MinedSalt {
+    readonly salt: `0x${string}`;
+    /** The locally derived address. Confirm it with the contract before use. */
+    readonly address: `0x${string}`;
+    readonly attempts: number;
+}
+export declare class MiningAbortedError extends Error {
+    constructor();
+}
+export declare class MiningExhaustedError extends Error {
+    readonly attempts: number;
+    constructor(suffix: string, attempts: number);
+}
+/**
+ * Find a salt whose bound CREATE2 address ends in `suffix`.
+ *
+ * The hot loop works on bytes: two keccaks per attempt, preimages preallocated
+ * once, the suffix compared on the raw hash bytes. The winner is re-derived
+ * through `boundSalt` + `create2Address` before it is returned, so the fast path
+ * can never quietly disagree with the readable one. Runs in chunks and yields
+ * between them, so a caller can cancel through `signal` and a main thread keeps
+ * painting.
+ */
+export declare function mineSalt(params: MineParams): Promise<MinedSalt>;
+//# sourceMappingURL=salt.d.ts.map

package/dist/launch/salt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salt.d.ts","sourceRoot":"","sources":["../../src/launch/salt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,2DAA2D;AAC3D,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,CAOpG;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,KAAK,MAAM,EAAE,EACvB,IAAI,EAAE,KAAK,MAAM,EAAE,EACnB,YAAY,EAAE,KAAK,MAAM,EAAE,GAC1B,KAAK,MAAM,EAAE,CAGf;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAuB,GAAG,OAAO,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,KAAK,MAAM,EAAE,CAO1C;AAED,gFAAgF;AAChF,eAAO,MAAM,SAAS,EAAE,KAAK,MAAM,EAA0B,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAK7C;AAiBD;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAuErE"}

package/dist/launch/salt.js

@@ -0,0 +1,153 @@
+import { concat, encodeAbiParameters, getAddress, keccak256 } from 'viem';
+/**
+ * Salt handling for the two CREATE2 launch paths — a pure port of the web app's
+ * `features/launch/salt.ts`, held identical by test.
+ *
+ * ─── EVERY PEDDLES ADDRESS ENDS IN `1978` ────────────────────────────────────
+ * The platform contracts do, and launched tokens do too, with no option to choose
+ * otherwise. So there is no vanity field: a launch MINES a salt whose address
+ * carries the suffix, and the creator sees the address they will get.
+ *
+ * A salt does two jobs, and only one of them is the suffix:
+ *
+ *   1. It picks the address. Both contracts mix the variant AND `msg.sender`
+ *      into it (`keccak256(abi.encode(variant, sender, salt))`), so a salt only
+ *      ever addresses the caller's OWN CREATE2 space.
+ *   2. It defeats front-running. The token address is an input to the pool key,
+ *      so anyone who can predict it can open that pool first at a price of their
+ *      choosing — the launch then reverts `POOL_PRICE_MISMATCH`. Mining starts
+ *      from a CSPRNG value, so the mined salt is as unguessable as a random one.
+ *
+ * ─── LOCAL DERIVATION, CONTRACT CONFIRMATION ─────────────────────────────────
+ * Mining computes the address locally (65,536 expected attempts is not an RPC
+ * job), and the plan builders then CONFIRM the candidate with the contract's own
+ * `getPeddlesAddress` / `predictCoin` before it is shown or submitted.
+ */
+/** The required address suffix, lowercase hex, no `0x`. */
+export const ADDRESS_SUFFIX = '1978';
+/**
+ * `keccak256(abi.encode(uint8 variant, address sender, bytes32 salt))` — the
+ * salt binding both `PeddlesStockLaunchpad._boundSalt` and
+ * `PeddlesFactoryV20._boundSalt` apply.
+ */
+export function boundSalt(variant, sender, salt) {
+    return keccak256(encodeAbiParameters([{ type: 'uint8' }, { type: 'address' }, { type: 'bytes32' }], [variant, sender, salt]));
+}
+/** Standard CREATE2: `keccak256(0xff ‖ deployer ‖ salt ‖ initCodeHash)[12:]`. */
+export function create2Address(deployer, salt, initCodeHash) {
+    const digest = keccak256(concat(['0xff', deployer, salt, initCodeHash]));
+    return getAddress(`0x${digest.slice(26)}`);
+}
+export function hasSuffix(address, suffix = ADDRESS_SUFFIX) {
+    return address.toLowerCase().endsWith(suffix.toLowerCase());
+}
+/**
+ * A fresh unguessable salt from the platform CSPRNG (`crypto.getRandomValues`,
+ * never `Math.random`): this value is the only thing standing between a launch
+ * and a mempool watcher who opens the pool first.
+ */
+export function randomSalt() {
+    const bytes = new Uint8Array(32);
+    // Typed structurally: this package ships no DOM or Node lib, and both runtimes expose the same API.
+    const cryptoApi = globalThis.crypto;
+    if (!cryptoApi)
+        throw new Error('No CSPRNG (globalThis.crypto) is available; refusing to mine a guessable salt.');
+    cryptoApi.getRandomValues(bytes);
+    return `0x${Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('')}`;
+}
+/** `0x00…00` — the salt a caller means by "none", still bound to the sender. */
+export const ZERO_SALT = `0x${'0'.repeat(64)}`;
+export class MiningAbortedError extends Error {
+    constructor() {
+        super('Address mining was cancelled.');
+        this.name = 'MiningAbortedError';
+    }
+}
+export class MiningExhaustedError extends Error {
+    attempts;
+    constructor(suffix, attempts) {
+        super(`No address ending in ${suffix} was found after ${attempts.toLocaleString()} attempts.`);
+        this.name = 'MiningExhaustedError';
+        this.attempts = attempts;
+    }
+}
+const CHUNK = 4096;
+function hexToBytes(hex) {
+    const clean = hex.startsWith('0x') ? hex.slice(2) : hex;
+    const out = new Uint8Array(clean.length / 2);
+    for (let i = 0; i < out.length; i += 1)
+        out[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+    return out;
+}
+function bytesToHex(bytes) {
+    let s = '0x';
+    for (const b of bytes)
+        s += b.toString(16).padStart(2, '0');
+    return s;
+}
+/**
+ * Find a salt whose bound CREATE2 address ends in `suffix`.
+ *
+ * The hot loop works on bytes: two keccaks per attempt, preimages preallocated
+ * once, the suffix compared on the raw hash bytes. The winner is re-derived
+ * through `boundSalt` + `create2Address` before it is returned, so the fast path
+ * can never quietly disagree with the readable one. Runs in chunks and yields
+ * between them, so a caller can cancel through `signal` and a main thread keeps
+ * painting.
+ */
+export async function mineSalt(params) {
+    const { deployer, variant, sender, initCodeHash, suffix = ADDRESS_SUFFIX, signal, onProgress, maxAttempts = 4_000_000, } = params;
+    if (!/^[0-9a-fA-F]+$/.test(suffix) || suffix.length % 2 !== 0) {
+        throw new Error(`The address suffix must be whole hex bytes; got "${suffix}".`);
+    }
+    const want = hexToBytes(suffix);
+    // abi.encode(uint8 variant, address sender, bytes32 salt): three 32-byte words.
+    const bound = new Uint8Array(96);
+    bound[31] = variant & 0xff;
+    bound.set(hexToBytes(sender), 32 + 12);
+    const saltView = bound.subarray(64, 96);
+    saltView.set(hexToBytes(randomSalt()));
+    // 0xff ‖ deployer ‖ boundSalt ‖ initCodeHash.
+    const create2 = new Uint8Array(85);
+    create2[0] = 0xff;
+    create2.set(hexToBytes(deployer), 1);
+    create2.set(hexToBytes(initCodeHash), 53);
+    const bump = () => {
+        for (let i = 31; i >= 0; i -= 1) {
+            saltView[i] = (saltView[i] + 1) & 0xff;
+            if (saltView[i] !== 0)
+                break;
+        }
+    };
+    let attempts = 0;
+    while (attempts < maxAttempts) {
+        if (signal?.aborted)
+            throw new MiningAbortedError();
+        for (let i = 0; i < CHUNK && attempts < maxAttempts; i += 1) {
+            create2.set(keccak256(bound, 'bytes'), 21);
+            const digest = keccak256(create2, 'bytes');
+            attempts += 1;
+            let hit = true;
+            for (let j = 0; j < want.length; j += 1) {
+                if (digest[32 - want.length + j] !== want[j]) {
+                    hit = false;
+                    break;
+                }
+            }
+            if (hit) {
+                const salt = bytesToHex(saltView);
+                const address = create2Address(deployer, boundSalt(variant, sender, salt), initCodeHash);
+                if (!hasSuffix(address, suffix)) {
+                    throw new Error('The address miner disagreed with itself; nothing was reserved.');
+                }
+                return { salt, address, attempts };
+            }
+            bump();
+        }
+        onProgress?.(attempts);
+        // A macrotask yield (`setTimeout(0)`), so a main-thread caller gets to paint between chunks.
+        await new Promise((resolve) => globalThis.setTimeout(resolve, 0));
+    }
+    throw new MiningExhaustedError(suffix, attempts);
+}
+//# sourceMappingURL=salt.js.map

package/dist/launch/salt.js.map

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

package/dist/launch/stockCall.d.ts

@@ -0,0 +1,122 @@
+import type { ReadClient } from '../client.js';
+import type { Address, Hex } from 'viem';
+import { type FeeTerms } from './feeTerms.js';
+import type { UnsignedLaunchTx } from './wethCall.js';
+/**
+ * The stock-paired launch call — `PeddlesStockLaunchpad.createCoin` (two
+ * overloads) or `createCoinAndBuy`. A pure port of the web app's
+ * `buildStockLaunchCall` (`features/launch/useStockLaunch.ts`), held identical by test.
+ *
+ *   dev buy, any salt         → createCoinAndBuy(name, symbol, quote, tax, excess, salt, quoteIn, minOut)
+ *   no dev buy, vanity salt   → createCoin(name, symbol, quote, tax, excess, salt)
+ *   no dev buy, no salt       → createCoin(name, symbol, quote, tax, excess)      (auto-salt)
+ *
+ * Every entrypoint is payable and requires `msg.value >= launchFee`. The fee is
+ * READ LIVE (`readStockLaunchFee`) and attached exactly; a dev buy pulls the
+ * quote asset through `transferFrom`, so the launchpad must be approved first.
+ */
+export interface StockLaunchArgs {
+    readonly name: string;
+    readonly symbol: string;
+    readonly quote: `0x${string}`;
+    /** null → the auto-salt overload. */
+    readonly salt: `0x${string}` | null;
+    /** Quote base units to spend on the dev buy. 0n → no dev buy. */
+    readonly quoteIn: bigint;
+    /** Slippage floor for the dev buy, in the launched token's base units. */
+    readonly minTokensOut: bigint;
+    /** The creator's permanent fee terms. `null` is refused, never defaulted. */
+    readonly feeTerms: FeeTerms | null;
+}
+export type StockLaunchCall = {
+    readonly kind: 'buy';
+    readonly functionName: 'createCoinAndBuy';
+    readonly args: readonly [string, string, `0x${string}`, number, number, `0x${string}`, bigint, bigint];
+} | {
+    readonly kind: 'salt';
+    readonly functionName: 'createCoin';
+    readonly args: readonly [string, string, `0x${string}`, number, number, `0x${string}`];
+} | {
+    readonly kind: 'auto';
+    readonly functionName: 'createCoin';
+    readonly args: readonly [string, string, `0x${string}`, number, number];
+};
+/** Why these terms cannot ride in a launch, or null when they can. */
+export declare function stockLaunchTermsIssue(feeTerms: FeeTerms | null): string | null;
+export declare function buildStockLaunchCall({ name, symbol, quote, salt, quoteIn, minTokensOut, feeTerms }: StockLaunchArgs): StockLaunchCall;
+/** The calldata of a stock launch call. `launchFeeWei` is the live `launchFee()`, attached exactly. */
+export declare function encodeStockLaunchCall(call: StockLaunchCall, launchpad: `0x${string}`, launchFeeWei: bigint): UnsignedLaunchTx;
+/** ERC-20 `approve` / `allowance` — the standard shapes; the SDK's read-only `erc20Abi` carries neither. */
+export declare const erc20ApprovalAbi: readonly [{
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}];
+/** The ERC-20 approval a dev buy needs: EXACTLY `quoteIn`, never unlimited. */
+export declare function encodeStockApproval(quote: `0x${string}`, launchpad: `0x${string}`, quoteIn: bigint): UnsignedLaunchTx;
+/** The launchpad's current allowance on `quote` from `owner`. */
+export declare function readStockAllowance(client: ReadClient, quote: Address, owner: Address, launchpad: Address): Promise<bigint>;
+export interface StockLaunchFee {
+    /** Exact wei to attach to the launch call. */
+    readonly launchFee: bigint;
+    /** Immutable per-deployment ceiling — disclosure, not something to send. */
+    readonly maxLaunchFee: bigint;
+}
+/** The launch fee, READ FROM THE CHAIN. Owner-tunable storage under an immutable cap; never a constant. */
+export declare function readStockLaunchFee(client: ReadClient, launchpad: Address): Promise<StockLaunchFee>;
+export interface StockMiningInputs {
+    /** `COIN_VARIANT()` — the variant byte the launchpad binds into the salt. */
+    readonly variant: number;
+    /** `coinInitCodeHash(name, symbol)` — depends on the name and symbol, so a rename re-mines. */
+    readonly initCodeHash: Hex;
+}
+/** What `mineSalt` needs for a stock coin: the variant and the name/symbol-dependent init code hash. */
+export declare function readStockMiningInputs(client: ReadClient, launchpad: Address, name: string, symbol: string): Promise<StockMiningInputs>;
+/** The launchpad's own prediction for (creator, salt, name, symbol) — the confirmation a mined salt needs. */
+export declare function predictStockCoin(client: ReadClient, launchpad: Address, creator: Address, salt: Hex, name: string, symbol: string): Promise<Address>;
+/** One whitelisted quote leg, as the launchpad and its own ERC-20 describe it. */
+export interface StockQuote {
+    readonly address: Address;
+    /** Position in `allQuotes` — append-ordered, the only recency signal the chain offers. */
+    readonly registryIndex: number;
+    /** On-chain symbol; `null` when the ERC-20 did not answer. Never defaulted. */
+    readonly symbol: string | null;
+    readonly name: string | null;
+    /** On-chain decimals; `null` when unreadable. Never defaulted. */
+    readonly decimals: number | null;
+    /** `quoteConfig.startTick` — the launch price, set by the launchpad owner. */
+    readonly startTick: number;
+}
+/**
+ * The stock-paired launch whitelist — READ FROM THE CHAIN (`quoteCount` / `allQuotes`,
+ * each gated on `quoteConfig(quote).allowed`), identity read off each ERC-20. An entry whose
+ * identity cannot be read is kept and marked unresolved, never dropped or defaulted.
+ */
+export declare function readStockQuotes(client: ReadClient, launchpad: Address): Promise<readonly StockQuote[]>;
+/** Whether the launchpad allows `quote` right now. */
+export declare function isQuoteAllowed(client: ReadClient, launchpad: Address, quote: Address): Promise<boolean>;
+//# sourceMappingURL=stockCall.d.ts.map

package/dist/launch/stockCall.d.ts.map

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

package/dist/launch/stockCall.js

@@ -0,0 +1,144 @@
+import { encodeFunctionData } from 'viem';
+import { erc20Abi } from '../abis.js';
+import { stockLaunchpadLaunchAbi } from './abi.generated.js';
+import { validateFeeTerms } from './feeTerms.js';
+/** Why these terms cannot ride in a launch, or null when they can. */
+export function stockLaunchTermsIssue(feeTerms) {
+    if (feeTerms === null)
+        return 'Choose the trading fee for this token before launching.';
+    if (validateFeeTerms(feeTerms) !== null)
+        return 'The trading fee or its split is outside the range a launch can set.';
+    return null;
+}
+export function buildStockLaunchCall({ name, symbol, quote, salt, quoteIn, minTokensOut, feeTerms }) {
+    const issue = stockLaunchTermsIssue(feeTerms);
+    if (issue !== null)
+        throw new Error(issue);
+    if (feeTerms === null)
+        throw new Error('Choose the trading fee for this token before launching.');
+    if (quoteIn < 0n || minTokensOut < 0n)
+        throw new Error('A dev-buy amount cannot be negative.');
+    // uint16 on-chain; both are bounded (at most 10000) by `validateFeeTerms`, so the conversion is exact.
+    const tax = Number(feeTerms.taxBps);
+    const excess = Number(feeTerms.excessToCreatorBps);
+    if (quoteIn > 0n) {
+        return { kind: 'buy', functionName: 'createCoinAndBuy', args: [name, symbol, quote, tax, excess, salt ?? `0x${'00'.repeat(32)}`, quoteIn, minTokensOut] };
+    }
+    if (minTokensOut !== 0n)
+        throw new Error('Set a dev-buy amount, or clear the minimum.');
+    if (salt !== null) {
+        return { kind: 'salt', functionName: 'createCoin', args: [name, symbol, quote, tax, excess, salt] };
+    }
+    return { kind: 'auto', functionName: 'createCoin', args: [name, symbol, quote, tax, excess] };
+}
+/** The calldata of a stock launch call. `launchFeeWei` is the live `launchFee()`, attached exactly. */
+export function encodeStockLaunchCall(call, launchpad, launchFeeWei) {
+    // viem selects the `createCoin` overload by argument count (5 or 6).
+    const data = encodeFunctionData({ abi: stockLaunchpadLaunchAbi, functionName: call.functionName, args: call.args });
+    return { to: launchpad, data, value: launchFeeWei };
+}
+/** ERC-20 `approve` / `allowance` — the standard shapes; the SDK's read-only `erc20Abi` carries neither. */
+export const erc20ApprovalAbi = [
+    {
+        type: 'function',
+        name: 'approve',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'value', type: 'uint256' },
+        ],
+        outputs: [{ type: 'bool' }],
+    },
+    {
+        type: 'function',
+        name: 'allowance',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [{ type: 'uint256' }],
+    },
+];
+/** The ERC-20 approval a dev buy needs: EXACTLY `quoteIn`, never unlimited. */
+export function encodeStockApproval(quote, launchpad, quoteIn) {
+    return { to: quote, data: encodeFunctionData({ abi: erc20ApprovalAbi, functionName: 'approve', args: [launchpad, quoteIn] }), value: 0n };
+}
+/** The launchpad's current allowance on `quote` from `owner`. */
+export async function readStockAllowance(client, quote, owner, launchpad) {
+    return (await client.readContract({ address: quote, abi: erc20ApprovalAbi, functionName: 'allowance', args: [owner, launchpad] }));
+}
+/** The launch fee, READ FROM THE CHAIN. Owner-tunable storage under an immutable cap; never a constant. */
+export async function readStockLaunchFee(client, launchpad) {
+    const [launchFee, maxLaunchFee] = (await client.multicall({
+        allowFailure: false,
+        contracts: [
+            { address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'launchFee' },
+            { address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'maxLaunchFee' },
+        ],
+    }));
+    return { launchFee, maxLaunchFee };
+}
+/** What `mineSalt` needs for a stock coin: the variant and the name/symbol-dependent init code hash. */
+export async function readStockMiningInputs(client, launchpad, name, symbol) {
+    const [variant, initCodeHash] = (await client.multicall({
+        allowFailure: false,
+        contracts: [
+            { address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'COIN_VARIANT' },
+            { address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'coinInitCodeHash', args: [name, symbol] },
+        ],
+    }));
+    return { variant: Number(variant), initCodeHash };
+}
+/** The launchpad's own prediction for (creator, salt, name, symbol) — the confirmation a mined salt needs. */
+export async function predictStockCoin(client, launchpad, creator, salt, name, symbol) {
+    return (await client.readContract({ address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'predictCoin', args: [creator, salt, name, symbol] }));
+}
+/**
+ * The stock-paired launch whitelist — READ FROM THE CHAIN (`quoteCount` / `allQuotes`,
+ * each gated on `quoteConfig(quote).allowed`), identity read off each ERC-20. An entry whose
+ * identity cannot be read is kept and marked unresolved, never dropped or defaulted.
+ */
+export async function readStockQuotes(client, launchpad) {
+    const count = Number(await client.readContract({ address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'quoteCount' }));
+    if (count === 0)
+        return [];
+    const addresses = (await client.multicall({
+        allowFailure: false,
+        contracts: Array.from({ length: count }, (_, i) => ({ address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'allQuotes', args: [BigInt(i)] })),
+    }));
+    const configs = (await client.multicall({
+        allowFailure: false,
+        contracts: addresses.map((quote) => ({ address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'quoteConfig', args: [quote] })),
+    }));
+    const allowed = addresses.map((address, i) => ({ address, i, config: configs[i] })).filter(({ config }) => config[0]);
+    if (allowed.length === 0)
+        return [];
+    const identity = await client.multicall({
+        allowFailure: true,
+        contracts: allowed.flatMap(({ address }) => [
+            { address, abi: erc20Abi, functionName: 'symbol' },
+            { address, abi: erc20Abi, functionName: 'name' },
+            { address, abi: erc20Abi, functionName: 'decimals' },
+        ]),
+    });
+    return allowed.map(({ address, i, config }, k) => {
+        const sym = identity[k * 3];
+        const nm = identity[k * 3 + 1];
+        const dec = identity[k * 3 + 2];
+        return {
+            address,
+            registryIndex: i,
+            symbol: sym.status === 'success' ? String(sym.result) : null,
+            name: nm.status === 'success' ? String(nm.result) : null,
+            decimals: dec.status === 'success' ? Number(dec.result) : null,
+            startTick: Number(config[2]),
+        };
+    });
+}
+/** Whether the launchpad allows `quote` right now. */
+export async function isQuoteAllowed(client, launchpad, quote) {
+    const [allowed] = (await client.readContract({ address: launchpad, abi: stockLaunchpadLaunchAbi, functionName: 'quoteConfig', args: [quote] }));
+    return allowed;
+}
+//# sourceMappingURL=stockCall.js.map

package/dist/launch/stockCall.js.map

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

package/dist/launch/tickMath.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Uniswap v4 tick maths, in `bigint` — a pure port of the web app's
+ * `features/launch/tickMath.ts`.
+ *
+ * The WETH-type launch (`PeddlesLaunchOrchestratorV20.launch`) makes the CALLER do
+ * the pool maths: `LaunchInput` carries `sqrtPriceX96`, `tickLower`, `tickUpper`
+ * and `liquidity`, and the executor mints exactly the position those describe.
+ * Get `liquidity` one wei too high and `modifyLiquidities` reverts.
+ *
+ *   - `getSqrtPriceAtTick`  ← `StockTickMath.getSqrtPriceAtTick`
+ *   - `liquidityForAmount`  ← `_liquidityFor` / `_amountForLiquidity` (VerifyLive.s.sol),
+ *                             Uniswap's `getLiquidityForAmount0/1` plus the round-down
+ *                             shave the mint's round-UP demands.
+ *
+ * `number` appears nowhere below the tick index itself (`int24`). Every price and
+ * amount is `bigint`.
+ */
+export declare const MIN_TICK = -887272;
+export declare const MAX_TICK = 887272;
+export declare const Q96: bigint;
+/** `sqrt(1.0001^tick) * 2^96`, identical to the on-chain implementation. Throws on an out-of-range tick. */
+export declare function getSqrtPriceAtTick(tick: number): bigint;
+/** Token amount a position of `liquidity` over [sqrtA, sqrtB] costs, rounded UP — how the mint charges. */
+export declare function amountForLiquidity(tokenIsCurrency0: boolean, sqrtA: bigint, sqrtB: bigint, liquidity: bigint): bigint;
+export interface LiquidityQuote {
+    readonly liquidity: bigint;
+    readonly sqrtLower: bigint;
+    readonly sqrtUpper: bigint;
+    /** What the mint will actually pull, rounded up. Always <= the allocation. */
+    readonly amountUsed: bigint;
+}
+/**
+ * The largest liquidity whose rounded-up token requirement still fits `amount`.
+ * Returns `null` when no liquidity fits — the caller must then refuse the launch, never guess.
+ */
+export declare function liquidityForAmount(tokenIsCurrency0: boolean, tickLower: number, tickUpper: number, amount: bigint): LiquidityQuote | null;
+/** `sqrtPriceX96` for a token/quote pair at `startTick`, mirroring `startSqrtPriceFor`. */
+export declare function startSqrtPrice(startTick: number, tokenIsCurrency0: boolean): bigint;
+//# sourceMappingURL=tickMath.d.ts.map

package/dist/launch/tickMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickMath.d.ts","sourceRoot":"","sources":["../../src/launch/tickMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,GAAG,QAAY,CAAC;AA6B7B,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBvD;AAOD,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,OAAO,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAMR;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,OAAO,EACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,cAAc,GAAG,IAAI,CA0BvB;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAEnF"}