@the-situation/deployer 0.5.0-alpha.0

package/dist/admin-inputs.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Admin input builders and validators for factory/market operations.
+ *
+ * Converts plain numbers and form-like inputs into contract-safe SDK types.
+ *
+ * @module
+ */
+import { type SQ128x128Raw } from '@the-situation/core';
+import type { NormalMarketDeploymentParams } from '@the-situation/starknet';
+import type { DeployFactoryParams } from './deployer';
+/**
+ * Extension hook configuration for packed u16 call points.
+ */
+export interface ExtensionCallPointsConfig {
+    readonly beforeInitialize: boolean;
+    readonly afterInitialize: boolean;
+    readonly beforeTrade: boolean;
+    readonly afterTrade: boolean;
+    readonly beforeAddLiquidity: boolean;
+    readonly afterAddLiquidity: boolean;
+    readonly beforeRemoveLiquidity: boolean;
+    readonly afterRemoveLiquidity: boolean;
+    readonly beforeClaim: boolean;
+    readonly afterClaim: boolean;
+    readonly beforeSettle: boolean;
+    readonly afterSettle: boolean;
+}
+/**
+ * Oracle extension default call points used in contract integration tests.
+ *
+ * Enabled hooks:
+ * - before_initialize
+ * - before_trade
+ * - after_settle
+ */
+export declare const ORACLE_EXTENSION_CALL_POINTS = 2053;
+/**
+ * Plain-number input shape for deploying a normal market.
+ *
+ * This input is intended for UIs and scripts. Callers should pass values in
+ * human units (for example, `k` as a decimal number), and this module will
+ * convert/validate for contract calls.
+ */
+export interface DeployNormalMarketInput {
+    readonly salt: string | bigint;
+    readonly marketOwner: string;
+    readonly marketAdmin: string;
+    readonly collateralToken: string;
+    readonly tokenDecimals: number;
+    readonly internalDecimals: number;
+    readonly initialMean: number;
+    readonly initialVariance: number;
+    readonly k: number;
+    readonly backing: number;
+    readonly tolerance: number;
+    readonly minTradeCollateral: number;
+    readonly lpFeeBps: number;
+    readonly protocolFeeBps: number;
+    readonly settlementFeeBps: number;
+    readonly extension?: string;
+    readonly extensionCallPoints?: number;
+    readonly metadataHash?: string;
+}
+/**
+ * Deploy input that allows market owner/admin defaults to be derived from the
+ * connected operator address.
+ */
+export interface DeployNormalMarketInputWithSignerDefaults extends Omit<DeployNormalMarketInput, 'marketOwner' | 'marketAdmin'> {
+    readonly marketOwner?: string;
+    readonly marketAdmin?: string;
+}
+/**
+ * Converts a plain number into contract SQ128x128 raw form.
+ *
+ * @throws Error when value is non-finite or cannot be represented by SQ128x128.
+ */
+export declare function buildSQ128x128Raw(value: number, name: string): SQ128x128Raw;
+/**
+ * Converts a settlement value into contract SQ128x128 raw form.
+ *
+ * @throws Error when settlement value is non-finite or cannot be represented.
+ */
+export declare function buildSettlementValueRaw(settlementValue: number): SQ128x128Raw;
+/**
+ * Packs extension call-point flags into Cairo `u16` representation.
+ *
+ * @throws Error when the packed value would exceed `u16`.
+ */
+export declare function packExtensionCallPoints(config: ExtensionCallPointsConfig): number;
+/**
+ * Unpacks extension call points from Cairo `u16` into boolean flags.
+ *
+ * @throws Error when the input is not a valid `u16` integer.
+ */
+export declare function unpackExtensionCallPoints(packed: number): ExtensionCallPointsConfig;
+/**
+ * Plain input for factory deployment from class hashes.
+ */
+export interface DeployFactoryInput {
+    readonly factoryClassHash: string;
+    readonly ammClassHash: string;
+    readonly mathClassHash: string;
+    readonly owner: string;
+}
+/**
+ * Validates and normalizes factory deployment inputs.
+ */
+export declare function buildDeployFactoryParams(input: DeployFactoryInput): DeployFactoryParams;
+/**
+ * Builds a validated `deploy_normal_market` payload from plain-number input.
+ *
+ * Invariants enforced:
+ * - decimals are non-negative integers and `internalDecimals <= tokenDecimals`
+ * - initial variance is strictly positive
+ * - `k`, `backing`, `tolerance`, and `minTradeCollateral` are strictly positive
+ * - fee fields are non-negative integers and sum to <= `MAX_FEE_BPS`
+ * - extension call points, if provided, fit in Cairo `u16`
+ *
+ * @throws Error when any invariant is violated.
+ */
+export declare function buildDeployNormalMarketParams(input: DeployNormalMarketInput): NormalMarketDeploymentParams;
+/**
+ * Builds deploy params while defaulting market owner/admin to connected signer.
+ *
+ * Additional defaults:
+ * - When an extension is present and `extensionCallPoints` is omitted, uses
+ *   `ORACLE_EXTENSION_CALL_POINTS`.
+ */
+export declare function buildDeployNormalMarketParamsWithSignerDefaults(input: DeployNormalMarketInputWithSignerDefaults, connectedAddress: string): NormalMarketDeploymentParams;
+//# sourceMappingURL=admin-inputs.d.ts.map

package/dist/admin-inputs.d.ts.map

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

package/dist/admin-inputs.js

@@ -0,0 +1,285 @@
+/**
+ * Admin input builders and validators for factory/market operations.
+ *
+ * Converts plain numbers and form-like inputs into contract-safe SDK types.
+ *
+ * @module
+ */
+import { MAX_FEE_BPS, createFeeConfigRaw } from '@the-situation/abi';
+import { NormalDistribution, SQ128x128 } from '@the-situation/core';
+import { computeHints } from '@the-situation/utils';
+/**
+ * Create a NormalDistribution from target mean and variance.
+ *
+ * Computes sigma as sqrt(variance), then recomputes variance
+ * from sigma to ensure exact equality: variance == sigma * sigma
+ */
+function createNormalDistributionFromMeanVariance(targetMean, targetVariance) {
+    if (targetVariance < 0) {
+        return null;
+    }
+    const sigma = Math.sqrt(targetVariance);
+    const sigmaSq = SQ128x128.fromNumber(sigma);
+    if (!sigmaSq) {
+        return null;
+    }
+    const varianceSq = sigmaSq.mul(sigmaSq);
+    if (!varianceSq) {
+        return null;
+    }
+    const meanSq = SQ128x128.fromNumber(targetMean);
+    if (!meanSq) {
+        return null;
+    }
+    return NormalDistribution.withSigma(meanSq, varianceSq, sigmaSq);
+}
+const EXTENSION_CALL_POINT_BITS = {
+    beforeInitialize: 1 << 0,
+    afterInitialize: 1 << 1,
+    beforeTrade: 1 << 2,
+    afterTrade: 1 << 3,
+    beforeAddLiquidity: 1 << 4,
+    afterAddLiquidity: 1 << 5,
+    beforeRemoveLiquidity: 1 << 6,
+    afterRemoveLiquidity: 1 << 7,
+    beforeClaim: 1 << 8,
+    afterClaim: 1 << 9,
+    beforeSettle: 1 << 10,
+    afterSettle: 1 << 11,
+};
+/**
+ * Oracle extension default call points used in contract integration tests.
+ *
+ * Enabled hooks:
+ * - before_initialize
+ * - before_trade
+ * - after_settle
+ */
+export const ORACLE_EXTENSION_CALL_POINTS = 0x805;
+function assertFiniteNumber(value, name) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${name} must be a finite number`);
+    }
+}
+function assertPositiveFiniteNumber(value, name) {
+    assertFiniteNumber(value, name);
+    if (value <= 0) {
+        throw new Error(`${name} must be positive`);
+    }
+}
+function assertNonNegativeInteger(value, name) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`${name} must be a non-negative integer`);
+    }
+}
+function normalizeOptional(value) {
+    if (!value) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function normalizeRequiredHex(value, label) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new Error(`${label} is required`);
+    }
+    if (!/^0x[0-9a-fA-F]+$/.test(trimmed)) {
+        throw new Error(`${label} must be a 0x-prefixed hex string`);
+    }
+    return trimmed.toLowerCase();
+}
+/**
+ * Converts a plain number into contract SQ128x128 raw form.
+ *
+ * @throws Error when value is non-finite or cannot be represented by SQ128x128.
+ */
+export function buildSQ128x128Raw(value, name) {
+    assertFiniteNumber(value, name);
+    const sq = SQ128x128.fromNumber(value);
+    if (!sq) {
+        throw new Error(`${name} is out of SQ128x128 range`);
+    }
+    return sq.toRaw();
+}
+/**
+ * Converts a settlement value into contract SQ128x128 raw form.
+ *
+ * @throws Error when settlement value is non-finite or cannot be represented.
+ */
+export function buildSettlementValueRaw(settlementValue) {
+    return buildSQ128x128Raw(settlementValue, 'Settlement value');
+}
+/**
+ * Packs extension call-point flags into Cairo `u16` representation.
+ *
+ * @throws Error when the packed value would exceed `u16`.
+ */
+export function packExtensionCallPoints(config) {
+    let packed = 0;
+    if (config.beforeInitialize) {
+        packed |= EXTENSION_CALL_POINT_BITS.beforeInitialize;
+    }
+    if (config.afterInitialize) {
+        packed |= EXTENSION_CALL_POINT_BITS.afterInitialize;
+    }
+    if (config.beforeTrade) {
+        packed |= EXTENSION_CALL_POINT_BITS.beforeTrade;
+    }
+    if (config.afterTrade) {
+        packed |= EXTENSION_CALL_POINT_BITS.afterTrade;
+    }
+    if (config.beforeAddLiquidity) {
+        packed |= EXTENSION_CALL_POINT_BITS.beforeAddLiquidity;
+    }
+    if (config.afterAddLiquidity) {
+        packed |= EXTENSION_CALL_POINT_BITS.afterAddLiquidity;
+    }
+    if (config.beforeRemoveLiquidity) {
+        packed |= EXTENSION_CALL_POINT_BITS.beforeRemoveLiquidity;
+    }
+    if (config.afterRemoveLiquidity) {
+        packed |= EXTENSION_CALL_POINT_BITS.afterRemoveLiquidity;
+    }
+    if (config.beforeClaim) {
+        packed |= EXTENSION_CALL_POINT_BITS.beforeClaim;
+    }
+    if (config.afterClaim) {
+        packed |= EXTENSION_CALL_POINT_BITS.afterClaim;
+    }
+    if (config.beforeSettle) {
+        packed |= EXTENSION_CALL_POINT_BITS.beforeSettle;
+    }
+    if (config.afterSettle) {
+        packed |= EXTENSION_CALL_POINT_BITS.afterSettle;
+    }
+    if (packed < 0 || packed > 0xffff) {
+        throw new Error('Extension call points must fit in u16');
+    }
+    return packed;
+}
+/**
+ * Unpacks extension call points from Cairo `u16` into boolean flags.
+ *
+ * @throws Error when the input is not a valid `u16` integer.
+ */
+export function unpackExtensionCallPoints(packed) {
+    if (!Number.isInteger(packed) || packed < 0 || packed > 0xffff) {
+        throw new Error('Extension call points must be a u16 integer');
+    }
+    return {
+        beforeInitialize: (packed & EXTENSION_CALL_POINT_BITS.beforeInitialize) !== 0,
+        afterInitialize: (packed & EXTENSION_CALL_POINT_BITS.afterInitialize) !== 0,
+        beforeTrade: (packed & EXTENSION_CALL_POINT_BITS.beforeTrade) !== 0,
+        afterTrade: (packed & EXTENSION_CALL_POINT_BITS.afterTrade) !== 0,
+        beforeAddLiquidity: (packed & EXTENSION_CALL_POINT_BITS.beforeAddLiquidity) !== 0,
+        afterAddLiquidity: (packed & EXTENSION_CALL_POINT_BITS.afterAddLiquidity) !== 0,
+        beforeRemoveLiquidity: (packed & EXTENSION_CALL_POINT_BITS.beforeRemoveLiquidity) !== 0,
+        afterRemoveLiquidity: (packed & EXTENSION_CALL_POINT_BITS.afterRemoveLiquidity) !== 0,
+        beforeClaim: (packed & EXTENSION_CALL_POINT_BITS.beforeClaim) !== 0,
+        afterClaim: (packed & EXTENSION_CALL_POINT_BITS.afterClaim) !== 0,
+        beforeSettle: (packed & EXTENSION_CALL_POINT_BITS.beforeSettle) !== 0,
+        afterSettle: (packed & EXTENSION_CALL_POINT_BITS.afterSettle) !== 0,
+    };
+}
+/**
+ * Validates and normalizes factory deployment inputs.
+ */
+export function buildDeployFactoryParams(input) {
+    return {
+        factoryClassHash: normalizeRequiredHex(input.factoryClassHash, 'Factory class hash'),
+        ammClassHash: normalizeRequiredHex(input.ammClassHash, 'AMM class hash'),
+        mathClassHash: normalizeRequiredHex(input.mathClassHash, 'Math class hash'),
+        owner: normalizeRequiredHex(input.owner, 'Factory owner'),
+    };
+}
+/**
+ * Builds a validated `deploy_normal_market` payload from plain-number input.
+ *
+ * Invariants enforced:
+ * - decimals are non-negative integers and `internalDecimals <= tokenDecimals`
+ * - initial variance is strictly positive
+ * - `k`, `backing`, `tolerance`, and `minTradeCollateral` are strictly positive
+ * - fee fields are non-negative integers and sum to <= `MAX_FEE_BPS`
+ * - extension call points, if provided, fit in Cairo `u16`
+ *
+ * @throws Error when any invariant is violated.
+ */
+export function buildDeployNormalMarketParams(input) {
+    assertNonNegativeInteger(input.tokenDecimals, 'Token decimals');
+    assertNonNegativeInteger(input.internalDecimals, 'Internal decimals');
+    if (input.internalDecimals > input.tokenDecimals) {
+        throw new Error('Internal decimals cannot exceed token decimals');
+    }
+    assertFiniteNumber(input.initialMean, 'Initial mean');
+    assertPositiveFiniteNumber(input.initialVariance, 'Initial variance');
+    assertPositiveFiniteNumber(input.k, 'k');
+    assertPositiveFiniteNumber(input.backing, 'Backing');
+    assertPositiveFiniteNumber(input.tolerance, 'Tolerance');
+    assertPositiveFiniteNumber(input.minTradeCollateral, 'Minimum trade collateral');
+    const initialDistribution = createNormalDistributionFromMeanVariance(input.initialMean, input.initialVariance);
+    if (!initialDistribution) {
+        throw new Error('Initial distribution is invalid');
+    }
+    const initialHints = computeHints(initialDistribution.sigma);
+    if (!initialHints) {
+        throw new Error('Failed to compute initial sqrt hints');
+    }
+    assertNonNegativeInteger(input.lpFeeBps, 'LP fee (bps)');
+    assertNonNegativeInteger(input.protocolFeeBps, 'Protocol fee (bps)');
+    assertNonNegativeInteger(input.settlementFeeBps, 'Settlement fee (bps)');
+    const feeConfig = createFeeConfigRaw(input.lpFeeBps, input.protocolFeeBps, input.settlementFeeBps);
+    if (!feeConfig) {
+        throw new Error(`Total fees exceed ${MAX_FEE_BPS} bps`);
+    }
+    const extension = normalizeOptional(input.extension);
+    const metadataHash = normalizeOptional(input.metadataHash);
+    if (input.extensionCallPoints !== undefined) {
+        assertNonNegativeInteger(input.extensionCallPoints, 'Extension call points');
+        if (input.extensionCallPoints > 0xffff) {
+            throw new Error('Extension call points must fit in u16');
+        }
+    }
+    const baseParams = {
+        salt: input.salt,
+        marketOwner: input.marketOwner,
+        marketAdmin: input.marketAdmin,
+        collateralToken: input.collateralToken,
+        tokenDecimals: input.tokenDecimals,
+        internalDecimals: input.internalDecimals,
+        initialDistribution: initialDistribution.toRaw(),
+        k: buildSQ128x128Raw(input.k, 'k'),
+        backing: buildSQ128x128Raw(input.backing, 'Backing'),
+        tolerance: buildSQ128x128Raw(input.tolerance, 'Tolerance'),
+        minTradeCollateral: buildSQ128x128Raw(input.minTradeCollateral, 'Minimum trade collateral'),
+        initialHints,
+        feeConfig,
+    };
+    return {
+        ...baseParams,
+        ...(extension !== undefined ? { extension } : {}),
+        ...(input.extensionCallPoints !== undefined
+            ? { extensionCallPoints: input.extensionCallPoints }
+            : {}),
+        ...(metadataHash !== undefined ? { metadataHash } : {}),
+    };
+}
+/**
+ * Builds deploy params while defaulting market owner/admin to connected signer.
+ *
+ * Additional defaults:
+ * - When an extension is present and `extensionCallPoints` is omitted, uses
+ *   `ORACLE_EXTENSION_CALL_POINTS`.
+ */
+export function buildDeployNormalMarketParamsWithSignerDefaults(input, connectedAddress) {
+    const normalizedConnectedAddress = normalizeRequiredHex(connectedAddress, 'Connected address');
+    return buildDeployNormalMarketParams({
+        ...input,
+        marketOwner: input.marketOwner ?? normalizedConnectedAddress,
+        marketAdmin: input.marketAdmin ?? normalizedConnectedAddress,
+        ...(input.extension !== undefined && input.extensionCallPoints === undefined
+            ? { extensionCallPoints: ORACLE_EXTENSION_CALL_POINTS }
+            : {}),
+    });
+}
+//# sourceMappingURL=admin-inputs.js.map

package/dist/admin-inputs.js.map

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

package/dist/deployer-node.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Node-only deployer helpers that require filesystem access.
+ *
+ * @module
+ */
+import type { CoreBuildArtifacts } from './deployer';
+/**
+ * Loads deployable Sierra/CASM artifacts from a packaged contracts release directory.
+ *
+ * Expected directory shape:
+ * - manifest.json
+ * - referenced `*.contract_class.json` and `*.compiled_contract_class.json` files
+ */
+export declare function loadCoreBuildArtifactsFromReleaseDir(releaseDir: string): CoreBuildArtifacts;
+//# sourceMappingURL=deployer-node.d.ts.map

package/dist/deployer-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployer-node.d.ts","sourceRoot":"","sources":["../src/deployer-node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAyB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAY5E;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CA8B3F"}

package/dist/deployer-node.js

@@ -0,0 +1,41 @@
+/**
+ * Node-only deployer helpers that require filesystem access.
+ *
+ * @module
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Loads deployable Sierra/CASM artifacts from a packaged contracts release directory.
+ *
+ * Expected directory shape:
+ * - manifest.json
+ * - referenced `*.contract_class.json` and `*.compiled_contract_class.json` files
+ */
+export function loadCoreBuildArtifactsFromReleaseDir(releaseDir) {
+    const manifestPath = join(releaseDir, 'manifest.json');
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    const byName = new Map();
+    for (const entry of manifest.contracts) {
+        byName.set(entry.name, entry);
+    }
+    const load = (name) => {
+        const entry = byName.get(name);
+        if (!entry) {
+            throw new Error(`Release manifest missing contract entry: ${name}`);
+        }
+        const sierraPath = join(releaseDir, entry.sierra);
+        const casmPath = join(releaseDir, entry.casm);
+        return {
+            sierra: JSON.parse(readFileSync(sierraPath, 'utf-8')),
+            casm: JSON.parse(readFileSync(casmPath, 'utf-8')),
+        };
+    };
+    return {
+        amm: load('normal_amm'),
+        factory: load('normal_factory'),
+        mathLibrary: load('normal_math_library'),
+        oracle: load('oracle'),
+    };
+}
+//# sourceMappingURL=deployer-node.js.map

package/dist/deployer-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployer-node.js","sourceRoot":"","sources":["../src/deployer-node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAcjC;;;;;;GAMG;AACH,MAAM,UAAU,oCAAoC,CAAC,UAAkB;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAoB,CAAC;IAEpF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IACvD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAyB,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE9C,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAqB;YACzE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAkB;SACnE,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC;QACvB,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC;QAC/B,WAAW,EAAE,IAAI,CAAC,qBAAqB,CAAC;QACxC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/deployer.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Deployment helpers for factory/oracle/market setup.
+ *
+ * @module
+ */
+import { type Abi, type AccountInterface, type CairoAssembly, type CompiledContract } from 'starknet';
+import type { NormalMarketDeploymentParams } from '@the-situation/starknet';
+export interface ContractBuildArtifact {
+    readonly sierra: CompiledContract;
+    readonly casm: CairoAssembly;
+}
+export interface CoreBuildArtifacts {
+    readonly amm: ContractBuildArtifact;
+    readonly factory: ContractBuildArtifact;
+    readonly mathLibrary: ContractBuildArtifact;
+    readonly oracle: ContractBuildArtifact;
+}
+export interface DeclaredClassHashes {
+    readonly ammClassHash: string;
+    readonly factoryClassHash: string;
+    readonly mathLibraryClassHash: string;
+    readonly oracleClassHash: string;
+}
+export interface DeployFactoryParams {
+    readonly factoryClassHash: string;
+    readonly ammClassHash: string;
+    readonly mathClassHash: string;
+    readonly owner: string;
+}
+/**
+ * Deployment result with both contract address and transaction hash.
+ */
+export interface DeployContractResult {
+    readonly contractAddress: string;
+    readonly transactionHash: string;
+}
+/**
+ * Contracts release manifest entry used for remote artifact loading.
+ */
+export interface ReleaseManifestEntry {
+    readonly name: string;
+    readonly sierra: string;
+    readonly casm: string;
+}
+/**
+ * Contracts release manifest shape for remote artifact loading.
+ */
+export interface ReleaseManifest {
+    readonly contracts: readonly ReleaseManifestEntry[];
+}
+/**
+ * Source configuration for loading deployable artifacts over HTTP(S).
+ *
+ * If `baseUrl` is not provided, it is derived from `manifestUrl`.
+ */
+export interface RemoteArtifactsSource {
+    readonly manifestUrl: string;
+    readonly baseUrl?: string;
+    readonly fetchFn?: typeof fetch;
+}
+/**
+ * Builds the contracts release tag from a semantic version.
+ *
+ * Example: `0.6.0` -> `the-situation-contracts-v0.6.0`.
+ */
+export declare function getContractsReleaseTag(version: string): string;
+/**
+ * Builds the GitHub release asset base URL for contracts artifacts.
+ */
+export declare function buildGitHubReleaseAssetBaseUrl(owner: string, repo: string, tag: string): string;
+/**
+ * Loads deployable Sierra/CASM artifacts from remote release assets.
+ *
+ * This is intended for admin UIs and browser-based tooling.
+ */
+export declare function loadCoreBuildArtifactsFromReleaseAssets(source: RemoteArtifactsSource): Promise<CoreBuildArtifacts>;
+/**
+ * Declares a contract class if it is not already declared.
+ */
+export declare function declareContractIfNeeded(account: AccountInterface, artifact: ContractBuildArtifact): Promise<string>;
+/**
+ * Declares AMM, factory, math library, and oracle classes sequentially.
+ */
+export declare function declareCoreContracts(account: AccountInterface, artifacts: CoreBuildArtifacts): Promise<DeclaredClassHashes>;
+/**
+ * Deploys the factory contract.
+ */
+export declare function deployFactory(account: AccountInterface, params: DeployFactoryParams): Promise<string>;
+/**
+ * Deploys the factory contract and returns address + transaction hash.
+ */
+export declare function deployFactoryWithResult(account: AccountInterface, params: DeployFactoryParams): Promise<DeployContractResult>;
+/**
+ * Deploys the oracle extension contract.
+ */
+export declare function deployOracle(account: AccountInterface, oracleClassHash: string): Promise<string>;
+/**
+ * Deploys the oracle extension contract and returns address + transaction hash.
+ */
+export declare function deployOracleWithResult(account: AccountInterface, oracleClassHash: string): Promise<DeployContractResult>;
+/**
+ * Builds ABI-aware calldata for `deploy_normal_market`.
+ */
+export declare function buildDeployNormalMarketCalldata(factoryAbi: Abi, params: NormalMarketDeploymentParams): string[];
+/**
+ * Deploys a normal market and returns its deployed address.
+ */
+export declare function deployNormalMarket(account: AccountInterface, factoryAddress: string, factoryAbi: Abi, params: NormalMarketDeploymentParams): Promise<string>;
+/**
+ * Deploys a normal market and returns deployed address + transaction hash.
+ */
+export declare function deployNormalMarketWithResult(account: AccountInterface, factoryAddress: string, factoryAbi: Abi, params: NormalMarketDeploymentParams): Promise<DeployContractResult>;
+/**
+ * Calculates deterministic oracle address for account.deployContract usage.
+ */
+export declare function calculateOracleAddress(oracleClassHash: string, salt: bigint): string;
+//# sourceMappingURL=deployer.d.ts.map

package/dist/deployer.d.ts.map

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

package/dist/deployer.js

@@ -0,0 +1,260 @@
+/**
+ * Deployment helpers for factory/oracle/market setup.
+ *
+ * @module
+ */
+import { CallData, hash, } from 'starknet';
+const REQUIRED_RELEASE_CONTRACTS = [
+    'normal_amm',
+    'normal_factory',
+    'normal_math_library',
+    'oracle',
+];
+/**
+ * Builds the contracts release tag from a semantic version.
+ *
+ * Example: `0.6.0` -> `the-situation-contracts-v0.6.0`.
+ */
+export function getContractsReleaseTag(version) {
+    return `the-situation-contracts-v${version}`;
+}
+/**
+ * Builds the GitHub release asset base URL for contracts artifacts.
+ */
+export function buildGitHubReleaseAssetBaseUrl(owner, repo, tag) {
+    return `https://github.com/${owner}/${repo}/releases/download/${tag}/`;
+}
+function deriveBaseUrl(manifestUrl) {
+    const lastSlash = manifestUrl.lastIndexOf('/');
+    if (lastSlash === -1) {
+        throw new Error('manifestUrl must include a path');
+    }
+    return manifestUrl.slice(0, lastSlash + 1);
+}
+function assetUrl(baseUrl, fileName) {
+    return new URL(fileName, baseUrl).toString();
+}
+async function fetchJson(fetchFn, url) {
+    const response = await fetchFn(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+}
+/**
+ * Loads deployable Sierra/CASM artifacts from remote release assets.
+ *
+ * This is intended for admin UIs and browser-based tooling.
+ */
+export async function loadCoreBuildArtifactsFromReleaseAssets(source) {
+    const fetchFn = source.fetchFn ?? fetch;
+    const baseUrl = source.baseUrl ?? deriveBaseUrl(source.manifestUrl);
+    const manifestRaw = await fetchJson(fetchFn, source.manifestUrl);
+    const manifest = manifestRaw;
+    if (!Array.isArray(manifest.contracts)) {
+        throw new Error('Release manifest is missing contracts[]');
+    }
+    const byName = new Map();
+    for (const entry of manifest.contracts) {
+        if (!entry ||
+            typeof entry.name !== 'string' ||
+            typeof entry.sierra !== 'string' ||
+            typeof entry.casm !== 'string') {
+            throw new Error('Release manifest contains malformed contract entry');
+        }
+        byName.set(entry.name, entry);
+    }
+    const load = async (name) => {
+        const entry = byName.get(name);
+        if (!entry) {
+            throw new Error(`Release manifest missing contract entry: ${name}`);
+        }
+        const sierraRaw = await fetchJson(fetchFn, assetUrl(baseUrl, entry.sierra));
+        const casmRaw = await fetchJson(fetchFn, assetUrl(baseUrl, entry.casm));
+        return {
+            sierra: sierraRaw,
+            casm: casmRaw,
+        };
+    };
+    const [amm, factory, mathLibrary, oracle] = await Promise.all([
+        load('normal_amm'),
+        load('normal_factory'),
+        load('normal_math_library'),
+        load('oracle'),
+    ]);
+    return {
+        amm,
+        factory,
+        mathLibrary,
+        oracle,
+    };
+}
+/**
+ * Declares a contract class if it is not already declared.
+ */
+export async function declareContractIfNeeded(account, artifact) {
+    const expectedClassHash = hash.computeContractClassHash(artifact.sierra);
+    try {
+        await account.getClassByHash(expectedClassHash);
+        return expectedClassHash;
+    }
+    catch {
+        // Not declared yet.
+    }
+    const declared = await account.declare({
+        contract: artifact.sierra,
+        casm: artifact.casm,
+    });
+    await waitForTransaction(account, declared.transaction_hash);
+    return declared.class_hash;
+}
+/**
+ * Declares AMM, factory, math library, and oracle classes sequentially.
+ */
+export async function declareCoreContracts(account, artifacts) {
+    const mathLibraryClassHash = await declareContractIfNeeded(account, artifacts.mathLibrary);
+    const factoryClassHash = await declareContractIfNeeded(account, artifacts.factory);
+    const ammClassHash = await declareContractIfNeeded(account, artifacts.amm);
+    const oracleClassHash = await declareContractIfNeeded(account, artifacts.oracle);
+    return {
+        ammClassHash,
+        factoryClassHash,
+        mathLibraryClassHash,
+        oracleClassHash,
+    };
+}
+/**
+ * Deploys the factory contract.
+ */
+export async function deployFactory(account, params) {
+    const result = await deployFactoryWithResult(account, params);
+    return result.contractAddress;
+}
+/**
+ * Deploys the factory contract and returns address + transaction hash.
+ */
+export async function deployFactoryWithResult(account, params) {
+    const deployed = await account.deployContract({
+        classHash: params.factoryClassHash,
+        constructorCalldata: CallData.compile({
+            owner: params.owner,
+            // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+            amm_class_hash: params.ammClassHash,
+            // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+            math_class_hash: params.mathClassHash,
+        }),
+    });
+    await waitForTransaction(account, deployed.transaction_hash);
+    return {
+        contractAddress: deployed.contract_address,
+        transactionHash: deployed.transaction_hash,
+    };
+}
+/**
+ * Deploys the oracle extension contract.
+ */
+export async function deployOracle(account, oracleClassHash) {
+    const result = await deployOracleWithResult(account, oracleClassHash);
+    return result.contractAddress;
+}
+/**
+ * Deploys the oracle extension contract and returns address + transaction hash.
+ */
+export async function deployOracleWithResult(account, oracleClassHash) {
+    const deployed = await account.deployContract({
+        classHash: oracleClassHash,
+        constructorCalldata: [],
+    });
+    await waitForTransaction(account, deployed.transaction_hash);
+    return {
+        contractAddress: deployed.contract_address,
+        transactionHash: deployed.transaction_hash,
+    };
+}
+/**
+ * Builds ABI-aware calldata for `deploy_normal_market`.
+ */
+export function buildDeployNormalMarketCalldata(factoryAbi, params) {
+    const callData = new CallData(factoryAbi);
+    return callData.compile('deploy_normal_market', {
+        salt: params.salt,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        market_owner: params.marketOwner,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        market_admin: params.marketAdmin,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        collateral_token: params.collateralToken,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        token_decimals: params.tokenDecimals,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        internal_decimals: params.internalDecimals,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        initial_distribution: params.initialDistribution,
+        k: params.k,
+        backing: params.backing,
+        tolerance: params.tolerance,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        min_trade_collateral: params.minTradeCollateral,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        initial_hints: params.initialHints,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        fee_config: {
+            // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+            lp_fee_bps: params.feeConfig.lpFeeBps,
+            // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+            protocol_fee_bps: params.feeConfig.protocolFeeBps,
+            // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+            settlement_fee_bps: params.feeConfig.settlementFeeBps,
+        },
+        extension: params.extension ?? '0x0',
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        extension_call_points: params.extensionCallPoints ?? 0,
+        // biome-ignore lint/style/useNamingConvention: Cairo ABI field names are snake_case
+        metadata_hash: params.metadataHash ?? '0x0',
+    });
+}
+/**
+ * Deploys a normal market and returns its deployed address.
+ */
+export async function deployNormalMarket(account, factoryAddress, factoryAbi, params) {
+    const result = await deployNormalMarketWithResult(account, factoryAddress, factoryAbi, params);
+    return result.contractAddress;
+}
+/**
+ * Deploys a normal market and returns deployed address + transaction hash.
+ */
+export async function deployNormalMarketWithResult(account, factoryAddress, factoryAbi, params) {
+    const calldata = buildDeployNormalMarketCalldata(factoryAbi, params);
+    const result = await account.execute({
+        contractAddress: factoryAddress,
+        entrypoint: 'deploy_normal_market',
+        calldata,
+    });
+    const receipt = await waitForTransaction(account, result.transaction_hash);
+    const marketAddress = extractMarketAddressFromReceipt(receipt);
+    if (!marketAddress) {
+        throw new Error('MarketDeployed event not found in transaction receipt');
+    }
+    return {
+        contractAddress: marketAddress,
+        transactionHash: result.transaction_hash,
+    };
+}
+/**
+ * Calculates deterministic oracle address for account.deployContract usage.
+ */
+export function calculateOracleAddress(oracleClassHash, salt) {
+    return hash.calculateContractAddressFromHash(salt, oracleClassHash, [], 0);
+}
+async function waitForTransaction(account, transactionHash) {
+    return await account.waitForTransaction(transactionHash, { retryInterval: 1000 });
+}
+function extractMarketAddressFromReceipt(receipt) {
+    const selector = hash.getSelectorFromName('MarketDeployed');
+    const event = receipt.events?.find((candidate) => candidate.keys?.[0] === selector);
+    if (!event?.keys || event.keys.length < 2) {
+        return null;
+    }
+    return event.keys[1] ?? null;
+}
+//# sourceMappingURL=deployer.js.map

package/dist/deployer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @the-situation/deployer
+ *
+ * Contract deployment tooling for The Situation prediction markets.
+ *
+ * @packageDocumentation
+ */
+export { buildGitHubReleaseAssetBaseUrl, buildDeployNormalMarketCalldata, calculateOracleAddress, declareContractIfNeeded, declareCoreContracts, deployFactory, deployFactoryWithResult, deployNormalMarket, deployNormalMarketWithResult, deployOracle, deployOracleWithResult, getContractsReleaseTag, loadCoreBuildArtifactsFromReleaseAssets, type ContractBuildArtifact, type CoreBuildArtifacts, type DeclaredClassHashes, type DeployContractResult, type DeployFactoryParams, type ReleaseManifest, type ReleaseManifestEntry, type RemoteArtifactsSource, } from './deployer';
+export { buildDeployFactoryParams, buildDeployNormalMarketParams, buildDeployNormalMarketParamsWithSignerDefaults, ORACLE_EXTENSION_CALL_POINTS, packExtensionCallPoints, buildSettlementValueRaw, buildSQ128x128Raw, unpackExtensionCallPoints, type DeployFactoryInput, type DeployNormalMarketInput, type DeployNormalMarketInputWithSignerDefaults, type ExtensionCallPointsConfig, } from './admin-inputs';
+//# 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":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,4BAA4B,EAC5B,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,uCAAuC,EACvC,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,+CAA+C,EAC/C,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,yCAAyC,EAC9C,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @the-situation/deployer
+ *
+ * Contract deployment tooling for The Situation prediction markets.
+ *
+ * @packageDocumentation
+ */
+export { buildGitHubReleaseAssetBaseUrl, buildDeployNormalMarketCalldata, calculateOracleAddress, declareContractIfNeeded, declareCoreContracts, deployFactory, deployFactoryWithResult, deployNormalMarket, deployNormalMarketWithResult, deployOracle, deployOracleWithResult, getContractsReleaseTag, loadCoreBuildArtifactsFromReleaseAssets, } from './deployer';
+export { buildDeployFactoryParams, buildDeployNormalMarketParams, buildDeployNormalMarketParamsWithSignerDefaults, ORACLE_EXTENSION_CALL_POINTS, packExtensionCallPoints, buildSettlementValueRaw, buildSQ128x128Raw, unpackExtensionCallPoints, } from './admin-inputs';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,4BAA4B,EAC5B,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,uCAAuC,GASxC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,+CAA+C,EAC/C,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAK1B,MAAM,gBAAgB,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Node-only deployer helpers.
+ *
+ * Import from `@the-situation/deployer/node` to access filesystem-backed
+ * artifact loading helpers.
+ *
+ * @module
+ */
+export { loadCoreBuildArtifactsFromReleaseDir } from './deployer-node';
+export type { ContractBuildArtifact, CoreBuildArtifacts } from './deployer';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oCAAoC,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/node.js

@@ -0,0 +1,10 @@
+/**
+ * Node-only deployer helpers.
+ *
+ * Import from `@the-situation/deployer/node` to access filesystem-backed
+ * artifact loading helpers.
+ *
+ * @module
+ */
+export { loadCoreBuildArtifactsFromReleaseDir } from './deployer-node';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oCAAoC,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@the-situation/deployer",
+  "version": "0.5.0-alpha.0",
+  "description": "Contract deployment tooling for The Situation prediction markets",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./node": {
+      "import": "./dist/node.js",
+      "types": "./dist/node.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "test": "bun test src/",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "declare:sepolia": "bun run scripts/declare-sepolia-core.ts",
+    "deploy:sepolia": "bun run scripts/deploy-sepolia.ts"
+  },
+  "dependencies": {
+    "@the-situation/core": "0.5.0-alpha.0",
+    "@the-situation/abi": "0.5.0-alpha.0",
+    "@the-situation/utils": "0.5.0-alpha.0",
+    "@the-situation/starknet": "0.5.0-alpha.0",
+    "starknet": "^9.2.1",
+    "effect": "^3.12.0"
+  },
+  "devDependencies": {
+    "@the-situation/artifacts": "0.5.0-alpha.0",
+    "typescript": "^5.4.0",
+    "@types/bun": "^1.1.0"
+  },
+  "license": "MIT"
+}