@peddles/sdk 0.2.0

package/dist/feeTerms.d.ts

@@ -0,0 +1,46 @@
+import type { ReadClient } from './client.js';
+import type { Address, Hex } from 'viem';
+/**
+ * A launch pool's permanent terms, read from `PeddlesFeeHook`.
+ *
+ * Every launch pool — stock-paired, WETH-paired, Clog, and both NFT graduations —
+ * is registered with the hook once, at launch, and nothing can change these
+ * afterwards. What a buyer pays is `creatorTaxBps`; `excessToCreatorBps` decides
+ * who receives the part above the fixed 1% (creator vs holders).
+ */
+export interface PoolTerms {
+    readonly poolId: Hex;
+    readonly token: Address;
+    /** The asset the tax is charged in, and the asset holder rewards pay out in. */
+    readonly quote: Address;
+    readonly creator: Address;
+    /** All-in tax a trader pays, in bps (100..1000). Excludes any opening-window premium. */
+    readonly creatorTaxBps: number;
+    /** Creator's share of the tax above the fixed 1%, in bps (0..10000). The rest goes to holders. */
+    readonly excessToCreatorBps: number;
+    /** The pool's `PeddlesHolderRewards` distributor. */
+    readonly rewards: Address;
+}
+/** Why `getPoolTerms` could not answer. It never substitutes a default. */
+export type PoolTermsFailure = 'legacy-fee-hook' | 'not-registered' | 'ambiguous';
+export declare class PoolTermsUnavailableError extends Error {
+    readonly reason: PoolTermsFailure;
+    constructor(reason: PoolTermsFailure, message: string);
+}
+/**
+ * The launch terms of `token`'s pool on `chainId`.
+ *
+ * FINDING THE POOL. The hook is keyed by pool id, not by token, so the id comes
+ * from the contract that created the pool: `PeddlesStockLaunchpad.coins(token)`
+ * for stock-paired coins (including NFT stock graduations), and
+ * `PeddlesV4LiquidityExecutor.poolIdFor(token)` for WETH-paired ones. The hook's
+ * own record must then name this token and be registered — anything else throws.
+ *
+ * FAILS CLOSED, the same as the address book:
+ *   - a deployment whose hook predates the fixed-terms model throws
+ *     (`legacy-fee-hook`) — its third config field meant something else, so
+ *     decoding it with this ABI would return a plausible, wrong number;
+ *   - a token with no registered launch pool throws (`not-registered`).
+ */
+export declare function getPoolTerms(client: ReadClient, chainId: number, token: Address): Promise<PoolTerms>;
+//# sourceMappingURL=feeTerms.d.ts.map

package/dist/feeTerms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeTerms.d.ts","sourceRoot":"","sources":["../src/feeTerms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAIzC;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,kGAAkG;IAClG,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAElF,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBACtB,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKtD;AAcD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAsE1G"}

package/dist/feeTerms.js

@@ -0,0 +1,80 @@
+import { feeHookAbi, liquidityExecutorAbi, stockLaunchpadAbi } from './abis.js';
+import { addressOf } from './deployments.js';
+export class PoolTermsUnavailableError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.name = 'PoolTermsUnavailableError';
+        this.reason = reason;
+    }
+}
+const ZERO_ID = /^0x0{64}$/i;
+/**
+ * The launch terms of `token`'s pool on `chainId`.
+ *
+ * FINDING THE POOL. The hook is keyed by pool id, not by token, so the id comes
+ * from the contract that created the pool: `PeddlesStockLaunchpad.coins(token)`
+ * for stock-paired coins (including NFT stock graduations), and
+ * `PeddlesV4LiquidityExecutor.poolIdFor(token)` for WETH-paired ones. The hook's
+ * own record must then name this token and be registered — anything else throws.
+ *
+ * FAILS CLOSED, the same as the address book:
+ *   - a deployment whose hook predates the fixed-terms model throws
+ *     (`legacy-fee-hook`) — its third config field meant something else, so
+ *     decoding it with this ABI would return a plausible, wrong number;
+ *   - a token with no registered launch pool throws (`not-registered`).
+ */
+export async function getPoolTerms(client, chainId, token) {
+    const hook = addressOf(chainId, 'PeddlesFeeHook');
+    const launchpad = addressOf(chainId, 'PeddlesStockLaunchpad');
+    const executor = addressOf(chainId, 'PeddlesV4LiquidityExecutor');
+    const [factory, coin, wethPoolId] = await client.multicall({
+        allowFailure: true,
+        contracts: [
+            { address: hook, abi: feeHookAbi, functionName: 'holderRewardsFactory' },
+            { address: launchpad, abi: stockLaunchpadAbi, functionName: 'coins', args: [token] },
+            { address: executor, abi: liquidityExecutorAbi, functionName: 'poolIdFor', args: [token] },
+        ],
+    });
+    // `holderRewardsFactory` exists only on the fixed-terms hook. A hook that does not
+    // answer it is the previous model, not a transient failure to be guessed around.
+    if (factory.status !== 'success' || /^0x0{40}$/i.test(factory.result)) {
+        throw new PoolTermsUnavailableError('legacy-fee-hook', `PeddlesFeeHook ${hook} on chain ${chainId} does not expose holderRewardsFactory(); ` +
+            `this deployment predates fixed launch terms, so they cannot be read from it.`);
+    }
+    const candidates = [];
+    if (coin.status === 'success') {
+        const poolId = coin.result[2];
+        if (!ZERO_ID.test(poolId))
+            candidates.push(poolId);
+    }
+    if (wethPoolId.status === 'success' && !ZERO_ID.test(wethPoolId.result)) {
+        candidates.push(wethPoolId.result);
+    }
+    const configs = candidates.length === 0
+        ? []
+        : await client.multicall({
+            allowFailure: false,
+            contracts: candidates.map((poolId) => ({ address: hook, abi: feeHookAbi, functionName: 'poolConfig', args: [poolId] })),
+        });
+    const matches = candidates
+        .map((poolId, i) => ({ poolId, config: configs[i] }))
+        .filter(({ config }) => config.registered && config.token.toLowerCase() === token.toLowerCase());
+    if (matches.length === 0) {
+        throw new PoolTermsUnavailableError('not-registered', `No registered Peddles launch pool for ${token} on chain ${chainId}.`);
+    }
+    if (matches.length > 1) {
+        throw new PoolTermsUnavailableError('ambiguous', `${token} has more than one registered launch pool on chain ${chainId}; refusing to pick one.`);
+    }
+    const { poolId, config } = matches[0];
+    return {
+        poolId,
+        token: config.token,
+        quote: config.quote,
+        creator: config.creator,
+        creatorTaxBps: Number(config.creatorTaxBps),
+        excessToCreatorBps: Number(config.excessToCreatorBps),
+        rewards: config.rewards,
+    };
+}
+//# sourceMappingURL=feeTerms.js.map

package/dist/feeTerms.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import type { ReadClient } from './client.js';
+/**
+ * @peddles/sdk — read and build against Peddles launches.
+ *
+ * ONE PACKAGE, SIX ENTRY POINTS. Take only what you import:
+ *
+ *   @peddles/sdk               this file — chain resolution, launch reads, pool terms
+ *   @peddles/sdk/abis          ABI fragments alone, no runtime
+ *   @peddles/sdk/clog          the Clog launch type
+ *   @peddles/sdk/deployments   the address book
+ *   @peddles/sdk/launch        launch calldata builders, salts, revert decoding
+ *   @peddles/sdk/perps         the perp launchpad (PeddlesPerpFactory)
+ *
+ * `viem` is a PEER dependency, not a bundled one: an integrator already has a
+ * client, and two copies of viem in a bundle is both bloat and a source of
+ * "instance is not a PublicClient" errors that are miserable to diagnose.
+ *
+ * WHAT IS DELIBERATELY ABSENT. This package exposes reads and calldata, not
+ * infrastructure. `ContractService`, `WalletService` and the log-source used by
+ * the indexer stay internal to the monorepo: publishing them would freeze this
+ * project's internals as public API and commit it to supporting them.
+ */
+import type { Address, Hex } from 'viem';
+export { DEPLOYMENTS, addressOf, deploymentFor, isKnownChain, UnknownChainError, UnknownContractError, } from './deployments.js';
+export type { KnownChainId, ContractName } from './deployments.js';
+export type { ReadClient } from './client.js';
+export { getVariantAllocation, getClogVault, getClogState, inflowShareBps, isReleaseReady, CLOG_MODEL_FLOW_MULTIPLE, CLOG_TABLE_SLICE_BPS, clogShareOfInflows, clogShareOfInflowsFromBps, clogInflowShareBps, } from './clog.js';
+export type { VariantAllocation, ClogState, ShareOfInflows, ClogModelInput } from './clog.js';
+export { factoryAbi, clogVaultAbi, clogVaultFactoryAbi, erc20Abi, tokenV20Abi, feeHookAbi, stockLaunchpadAbi, holderRewardsAbi, nftFactoryAbi, nftCollectionAbi, nftFeeDistributorFactoryAbi, nftFeeDistributorAbi, nftBondingGraduationOrchestratorAbi, nftStockGraduationOrchestratorAbi, liquidityExecutorAbi, } from './abis.js';
+export { relayParamsHash, stockGraduationOptInRequest, graduateToStockWithTermsRequest, graduateAndBuyRequest, predictDistributor, getHolderCommitment, getDistributorState, holderClaimable, } from './artDex.js';
+export type { RelayParams, StockTermsLaunch, HolderCommitment, DistributorState, HolderClaimable } from './artDex.js';
+export { getPoolTerms, PoolTermsUnavailableError } from './feeTerms.js';
+export type { PoolTerms, PoolTermsFailure } from './feeTerms.js';
+export { feeSplit, PLATFORM_FEE_BPS, CREATOR_FEE_BPS, MIN_CREATOR_TAX_BPS, MAX_CREATOR_TAX_BPS, MAX_FEE_AMOUNT, } from './feeSplit.js';
+export type { FeeSplit } from './feeSplit.js';
+/** A launched token, as the chain describes it. */
+export interface TokenInfo {
+    readonly address: Address;
+    readonly name: string;
+    readonly symbol: string;
+    readonly decimals: number;
+    readonly totalSupply: bigint;
+}
+/**
+ * Identity and supply, read from the token itself.
+ *
+ * `decimals` travels with `totalSupply` on purpose. Every amount this SDK
+ * returns is a raw `bigint` in base units and MUST be formatted against its own
+ * decimals — never assume 18, and never route a token amount through a JS
+ * `number`, which loses precision above 2^53 and will silently mis-price a
+ * large-supply token.
+ */
+export declare function getTokenInfo(client: ReadClient, token: Address): Promise<TokenInfo>;
+/**
+ * Whether a launch type can be launched on this chain right now.
+ *
+ * Ask before offering one. A variant with no code registered, or one an owner
+ * has retired, reports false — and a UI that offers it anyway sends a creator
+ * into a transaction that cannot succeed.
+ */
+export declare function isVariantSupported(client: ReadClient, chainId: number, variant: number): Promise<boolean>;
+/** Everything `PeddlesFactoryV20` hashes into a token's CREATE2 address. */
+export interface TokenAddressInput {
+    readonly factory: Address;
+    readonly variant: number;
+    /** The launcher that calls the factory (e.g. the orchestrator), not the end user. */
+    readonly sender: Address;
+    readonly salt: Hex;
+    /** keccak256 of the variant's creation code, as the factory reports it. */
+    readonly creationCodeHash: Hex;
+}
+/**
+ * The CREATE2 address, computed locally — the exact formula the factory uses:
+ *
+ *   boundSalt = keccak256(abi.encode(uint8 variant, address sender, bytes32 salt))
+ *   address   = keccak256(0xff ‖ factory ‖ boundSalt ‖ creationCodeHash)[12:]
+ *
+ * `creationCodeHash` is deliberately an input, not a constant shipped here. For
+ * the plain token it is the factory's immutable `TOKEN_CREATION_CODE_HASH`
+ * (keccak256 of `type(PeddlesTokenV20).creationCode` in the build that
+ * deployed it), and for a registered variant the hash stored at registration.
+ * Any recompile moves it, so the deployed factory is the only reliable source —
+ * read it with `predictTokenAddress`, or pass one you read yourself.
+ */
+export declare function computeTokenAddress(input: TokenAddressInput): Address;
+/**
+ * The CREATE2 address a launch will deploy to, before it is launched.
+ *
+ * THE VARIANT IS PART OF THE ADDRESS: the factory binds
+ * `keccak256(abi.encode(variant, sender, salt))`, so the same salt under two
+ * launch types produces two different addresses. Passing the wrong variant here
+ * yields an address the factory will never deploy to.
+ *
+ * The creation-code hash is read from the deployed factory (`variantInfo`, which
+ * returns `TOKEN_CREATION_CODE_HASH` for the plain token), never assumed. An
+ * unknown variant throws, as `getPeddlesAddress` does; a retired one still
+ * resolves, so an address quoted before retirement stays recoverable.
+ */
+export declare function predictTokenAddress(client: ReadClient, chainId: number, variant: number, sender: Address, salt: Hex): Promise<Address>;
+/** Chains this build ships an address book for. */
+export declare function supportedChains(): number[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,108 @@
+import { encodeAbiParameters, getContractAddress, keccak256 } from 'viem';
+import { erc20Abi, factoryAbi } from './abis.js';
+import { addressOf } from './deployments.js';
+export { DEPLOYMENTS, addressOf, deploymentFor, isKnownChain, UnknownChainError, UnknownContractError, } from './deployments.js';
+export { getVariantAllocation, getClogVault, getClogState, inflowShareBps, isReleaseReady, CLOG_MODEL_FLOW_MULTIPLE, CLOG_TABLE_SLICE_BPS, clogShareOfInflows, clogShareOfInflowsFromBps, clogInflowShareBps, } from './clog.js';
+export { factoryAbi, clogVaultAbi, clogVaultFactoryAbi, erc20Abi, tokenV20Abi, feeHookAbi, stockLaunchpadAbi, holderRewardsAbi, nftFactoryAbi, nftCollectionAbi, nftFeeDistributorFactoryAbi, nftFeeDistributorAbi, nftBondingGraduationOrchestratorAbi, nftStockGraduationOrchestratorAbi, liquidityExecutorAbi, } from './abis.js';
+export { relayParamsHash, stockGraduationOptInRequest, graduateToStockWithTermsRequest, graduateAndBuyRequest, predictDistributor, getHolderCommitment, getDistributorState, holderClaimable, } from './artDex.js';
+export { getPoolTerms, PoolTermsUnavailableError } from './feeTerms.js';
+export { feeSplit, PLATFORM_FEE_BPS, CREATOR_FEE_BPS, MIN_CREATOR_TAX_BPS, MAX_CREATOR_TAX_BPS, MAX_FEE_AMOUNT, } from './feeSplit.js';
+/**
+ * Identity and supply, read from the token itself.
+ *
+ * `decimals` travels with `totalSupply` on purpose. Every amount this SDK
+ * returns is a raw `bigint` in base units and MUST be formatted against its own
+ * decimals — never assume 18, and never route a token amount through a JS
+ * `number`, which loses precision above 2^53 and will silently mis-price a
+ * large-supply token.
+ */
+export async function getTokenInfo(client, token) {
+    const base = { address: token, abi: erc20Abi };
+    const [name, symbol, decimals, totalSupply] = await client.multicall({
+        allowFailure: false,
+        contracts: [
+            { ...base, functionName: 'name' },
+            { ...base, functionName: 'symbol' },
+            { ...base, functionName: 'decimals' },
+            { ...base, functionName: 'totalSupply' },
+        ],
+    });
+    return {
+        address: token,
+        name: name,
+        symbol: symbol,
+        decimals: decimals,
+        totalSupply: totalSupply,
+    };
+}
+/**
+ * Whether a launch type can be launched on this chain right now.
+ *
+ * Ask before offering one. A variant with no code registered, or one an owner
+ * has retired, reports false — and a UI that offers it anyway sends a creator
+ * into a transaction that cannot succeed.
+ */
+export async function isVariantSupported(client, chainId, variant) {
+    return (await client.readContract({
+        address: addressOf(chainId, 'PeddlesFactoryV20'),
+        abi: factoryAbi,
+        functionName: 'isVariantSupported',
+        args: [variant],
+    }));
+}
+/**
+ * The CREATE2 address, computed locally — the exact formula the factory uses:
+ *
+ *   boundSalt = keccak256(abi.encode(uint8 variant, address sender, bytes32 salt))
+ *   address   = keccak256(0xff ‖ factory ‖ boundSalt ‖ creationCodeHash)[12:]
+ *
+ * `creationCodeHash` is deliberately an input, not a constant shipped here. For
+ * the plain token it is the factory's immutable `TOKEN_CREATION_CODE_HASH`
+ * (keccak256 of `type(PeddlesTokenV20).creationCode` in the build that
+ * deployed it), and for a registered variant the hash stored at registration.
+ * Any recompile moves it, so the deployed factory is the only reliable source —
+ * read it with `predictTokenAddress`, or pass one you read yourself.
+ */
+export function computeTokenAddress(input) {
+    const boundSalt = keccak256(encodeAbiParameters([{ type: 'uint8' }, { type: 'address' }, { type: 'bytes32' }], [input.variant, input.sender, input.salt]));
+    return getContractAddress({
+        opcode: 'CREATE2',
+        from: input.factory,
+        salt: boundSalt,
+        bytecodeHash: input.creationCodeHash,
+    });
+}
+/**
+ * The CREATE2 address a launch will deploy to, before it is launched.
+ *
+ * THE VARIANT IS PART OF THE ADDRESS: the factory binds
+ * `keccak256(abi.encode(variant, sender, salt))`, so the same salt under two
+ * launch types produces two different addresses. Passing the wrong variant here
+ * yields an address the factory will never deploy to.
+ *
+ * The creation-code hash is read from the deployed factory (`variantInfo`, which
+ * returns `TOKEN_CREATION_CODE_HASH` for the plain token), never assumed. An
+ * unknown variant throws, as `getPeddlesAddress` does; a retired one still
+ * resolves, so an address quoted before retirement stays recoverable.
+ */
+export async function predictTokenAddress(client, chainId, variant, sender, salt) {
+    const factory = addressOf(chainId, 'PeddlesFactoryV20');
+    const [, creationCodeHash] = (await client.readContract({
+        address: factory,
+        abi: factoryAbi,
+        functionName: 'variantInfo',
+        args: [variant],
+    }));
+    if (/^0x0{64}$/i.test(creationCodeHash)) {
+        throw new Error(`PeddlesFactoryV20 on chain ${chainId} has no launch type ${variant}.`);
+    }
+    return computeTokenAddress({ factory, variant, sender, salt, creationCodeHash });
+}
+/** Chains this build ships an address book for. */
+export function supportedChains() {
+    return Object.keys(DEPLOYMENTS_KEYS).map(Number);
+}
+// Imported lazily-shaped to keep the public surface honest: `supportedChains`
+// reads the same generated map every other entry point does.
+import { DEPLOYMENTS as DEPLOYMENTS_KEYS } from './deployments.generated.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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