@the-situation/sdk 0.1.0-alpha.0

package/dist/__integration__/setup/accounts.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Test personas from predeployed devnet accounts.
+ *
+ * @module
+ */
+import { Account, type RpcProvider } from 'starknet';
+import { type DevnetConfig } from './devnet';
+/**
+ * A test persona with account and metadata.
+ */
+export interface TestPersona {
+    readonly name: string;
+    readonly account: Account;
+    readonly address: string;
+    readonly privateKey: string;
+    readonly publicKey: string;
+    readonly initialBalance: bigint;
+}
+/**
+ * All test personas for the integration tests.
+ */
+export interface TestPersonas {
+    readonly deployer: TestPersona;
+    readonly traderA: TestPersona;
+    readonly traderB: TestPersona;
+    readonly lpProvider: TestPersona;
+    readonly hybrid: TestPersona;
+    readonly all: TestPersona[];
+}
+/**
+ * Fetches predeployed accounts from devnet and creates test personas.
+ */
+export declare function getTestPersonas(provider: RpcProvider, config?: Partial<DevnetConfig>): Promise<TestPersonas>;
+/**
+ * Gets all addresses from personas for balance tracking.
+ */
+export declare function getAllAddresses(personas: TestPersonas): string[];
+//# sourceMappingURL=accounts.d.ts.map

package/dist/__integration__/setup/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../src/__integration__/setup/accounts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC;CAC7B;AAgBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,YAAY,CAAC,CA0BvB;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAEhE"}

package/dist/__integration__/setup/accounts.js

@@ -0,0 +1,50 @@
+/**
+ * Test personas from predeployed devnet accounts.
+ *
+ * @module
+ */
+import { Account } from 'starknet';
+import { callDevnetRpc } from './devnet';
+const PERSONA_NAMES = ['deployer', 'traderA', 'traderB', 'lpProvider', 'hybrid'];
+/**
+ * Fetches predeployed accounts from devnet and creates test personas.
+ */
+export async function getTestPersonas(provider, config) {
+    const accounts = await callDevnetRpc('devnet_getPredeployedAccounts', { with_balance: true }, config);
+    if (accounts.length < 5) {
+        throw new Error(`Need at least 5 predeployed accounts, got ${accounts.length}. ` +
+            'Start devnet with: starknet-devnet --seed 0 --accounts 10');
+    }
+    const personas = accounts
+        .slice(0, 5)
+        .map((acc, i) => createPersona(acc, PERSONA_NAMES[i], provider));
+    return {
+        deployer: personas[0],
+        traderA: personas[1],
+        traderB: personas[2],
+        lpProvider: personas[3],
+        hybrid: personas[4],
+        all: personas,
+    };
+}
+/**
+ * Creates a TestPersona from a predeployed account.
+ */
+function createPersona(acc, name, provider) {
+    const account = new Account({ provider, address: acc.address, signer: acc.private_key });
+    return {
+        name,
+        account,
+        address: acc.address,
+        privateKey: acc.private_key,
+        publicKey: acc.public_key,
+        initialBalance: BigInt(acc.initial_balance),
+    };
+}
+/**
+ * Gets all addresses from personas for balance tracking.
+ */
+export function getAllAddresses(personas) {
+    return personas.all.map((p) => p.address);
+}
+//# sourceMappingURL=accounts.js.map

package/dist/__integration__/setup/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/__integration__/setup/accounts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,aAAa,EAAqB,MAAM,UAAU,CAAC;AAsC5D,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAqB,EACrB,MAA8B;IAE9B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,+BAA+B,EAC/B,EAAE,YAAY,EAAE,IAAI,EAAE,EACtB,MAAM,CACP,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,CAAC,MAAM,IAAI;YAC9D,2DAA2D,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ;SACtB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE7E,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAgB;QACpC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAgB;QACnC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAgB;QACnC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAgB;QACtC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAgB;QAClC,GAAG,EAAE,QAAQ;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,GAAuB,EAAE,IAAY,EAAE,QAAqB;IACjF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzF,OAAO;QACL,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAsB;IACpD,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/__integration__/setup/artifacts.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Contract artifact loading utilities.
+ *
+ * Loads Sierra (contract class) and CASM (compiled contract class) files
+ * for declaring contracts on devnet.
+ *
+ * @module
+ */
+import type { CairoAssembly, CompiledContract } from 'starknet';
+/**
+ * Paths to contract artifacts.
+ */
+export interface ArtifactPaths {
+    readonly sierra: string;
+    readonly casm: string;
+}
+/**
+ * Loaded contract artifacts.
+ */
+export interface ContractArtifact {
+    readonly name: string;
+    readonly sierra: CompiledContract;
+    readonly casm: CairoAssembly;
+}
+/**
+ * All loaded contract artifacts.
+ */
+export interface LoadedArtifacts {
+    readonly amm: ContractArtifact;
+    readonly factory: ContractArtifact;
+    readonly mathLibrary: ContractArtifact;
+    readonly oracle: ContractArtifact;
+}
+/**
+ * Options for loading artifacts.
+ */
+export interface LoadArtifactsOptions {
+    /** Directory containing Sierra (.contract_class.json) files */
+    readonly sierraDir?: string;
+    /** Directory containing CASM (.compiled_contract_class.json) files */
+    readonly casmDir?: string;
+}
+/**
+ * Loads all contract artifacts needed for integration tests.
+ */
+export declare function loadAllArtifacts(options?: LoadArtifactsOptions): LoadedArtifacts;
+/**
+ * Gets the ABI from a loaded Sierra artifact.
+ */
+export declare function getAbiFromArtifact(artifact: ContractArtifact): readonly unknown[];
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/__integration__/setup/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/__integration__/setup/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AA6BD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AA8BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,eAAe,CAOhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,OAAO,EAAE,CAEjF"}

package/dist/__integration__/setup/artifacts.js

@@ -0,0 +1,72 @@
+/**
+ * Contract artifact loading utilities.
+ *
+ * Loads Sierra (contract class) and CASM (compiled contract class) files
+ * for declaring contracts on devnet.
+ *
+ * @module
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// Default artifact directories
+// const SDK_ARTIFACTS_DIR = resolve(__dirname, '../../artifacts');
+// v0.5.1 contracts with Library Dispatcher pattern and optimized contract sizes
+const CONTRACTS_DEV_DIR = '/private/tmp/the-situation-contracts-v0.5.1';
+/**
+ * Contract artifact file mappings.
+ */
+const ARTIFACT_FILES = {
+    amm: {
+        sierra: 'the_situation_normal_amm.contract_class.json',
+        casm: 'the_situation_normal_amm.compiled_contract_class.json',
+    },
+    factory: {
+        sierra: 'the_situation_normal_factory.contract_class.json',
+        casm: 'the_situation_normal_factory.compiled_contract_class.json',
+    },
+    mathLibrary: {
+        sierra: 'the_situation_normal_math_library.contract_class.json',
+        casm: 'the_situation_normal_math_library.compiled_contract_class.json',
+    },
+    oracle: {
+        sierra: 'the_situation_oracle.contract_class.json',
+        casm: 'the_situation_oracle.compiled_contract_class.json',
+    },
+};
+/**
+ * Loads a single contract artifact.
+ */
+function loadArtifact(name, files, options) {
+    // Use the same directory for both Sierra and CASM to ensure they match
+    const sierraDir = options?.sierraDir ?? CONTRACTS_DEV_DIR;
+    const casmDir = options?.casmDir ?? CONTRACTS_DEV_DIR;
+    const sierraPath = join(sierraDir, files.sierra);
+    const casmPath = join(casmDir, files.casm);
+    if (!existsSync(sierraPath)) {
+        throw new Error(`Sierra artifact not found: ${sierraPath}`);
+    }
+    if (!existsSync(casmPath)) {
+        throw new Error(`CASM artifact not found: ${casmPath}`);
+    }
+    const sierra = JSON.parse(readFileSync(sierraPath, 'utf-8'));
+    const casm = JSON.parse(readFileSync(casmPath, 'utf-8'));
+    return { name, sierra, casm };
+}
+/**
+ * Loads all contract artifacts needed for integration tests.
+ */
+export function loadAllArtifacts(options) {
+    return {
+        amm: loadArtifact('AMM', ARTIFACT_FILES.amm, options),
+        factory: loadArtifact('Factory', ARTIFACT_FILES.factory, options),
+        mathLibrary: loadArtifact('MathLibrary', ARTIFACT_FILES.mathLibrary, options),
+        oracle: loadArtifact('Oracle', ARTIFACT_FILES.oracle, options),
+    };
+}
+/**
+ * Gets the ABI from a loaded Sierra artifact.
+ */
+export function getAbiFromArtifact(artifact) {
+    return artifact.sierra.abi;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/__integration__/setup/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../src/__integration__/setup/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA8BjC,+BAA+B;AAC/B,mEAAmE;AACnE,gFAAgF;AAChF,MAAM,iBAAiB,GAAG,6CAA6C,CAAC;AAExE;;GAEG;AACH,MAAM,cAAc,GAAG;IACrB,GAAG,EAAE;QACH,MAAM,EAAE,8CAA8C;QACtD,IAAI,EAAE,uDAAuD;KAC9D;IACD,OAAO,EAAE;QACP,MAAM,EAAE,kDAAkD;QAC1D,IAAI,EAAE,2DAA2D;KAClE;IACD,WAAW,EAAE;QACX,MAAM,EAAE,uDAAuD;QAC/D,IAAI,EAAE,gEAAgE;KACvE;IACD,MAAM,EAAE;QACN,MAAM,EAAE,0CAA0C;QAClD,IAAI,EAAE,mDAAmD;KAC1D;CACO,CAAC;AAYX;;GAEG;AACH,SAAS,YAAY,CACnB,IAAY,EACZ,KAAuC,EACvC,OAA8B;IAE9B,uEAAuE;IACvE,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,iBAAiB,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,iBAAiB,CAAC;IAEtD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAqB,CAAC;IACjF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAkB,CAAC;IAE1E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA8B;IAC7D,OAAO;QACL,GAAG,EAAE,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC;QACrD,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;QACjE,WAAW,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC;QAC7E,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA0B;IAC3D,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAgB,CAAC;AAC1C,CAAC"}

package/dist/__integration__/setup/deploy.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Contract declaration and deployment helpers.
+ *
+ * @module
+ */
+import { type Abi, type Account } from 'starknet';
+import type { ContractArtifact, LoadedArtifacts } from './artifacts';
+import type { MarketFixture } from './fixtures';
+/**
+ * Declared contract class hashes.
+ */
+export interface DeclaredContracts {
+    readonly mathLibraryClassHash: string;
+    readonly factoryClassHash: string;
+    readonly ammClassHash: string;
+    readonly oracleClassHash: string;
+}
+/**
+ * Devnet predeployed token addresses.
+ */
+export declare const DEVNET_ETH_ADDRESS = "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7";
+export declare const DEVNET_STRK_ADDRESS = "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d";
+/**
+ * Deployed contract addresses.
+ */
+export interface DeployedContracts {
+    readonly factoryAddress: string;
+    readonly tokenAddress: string;
+    readonly marketAddress?: string;
+}
+/**
+ * Declares a single contract class.
+ *
+ * Returns the class hash, or existing hash if already declared.
+ */
+export declare function declareContract(account: Account, artifact: ContractArtifact): Promise<string>;
+/**
+ * Declares all contract classes needed for integration tests.
+ *
+ * Declarations are done sequentially to avoid nonce conflicts.
+ */
+export declare function declareAllContracts(account: Account, artifacts: LoadedArtifacts): Promise<DeclaredContracts>;
+/**
+ * Deploys the factory contract.
+ *
+ * In v0.5.0+, the factory requires both AMM and MathLibrary class hashes.
+ * The MathLibrary is used via Library Dispatcher pattern (no deployed contract).
+ */
+export declare function deployFactory(deployer: Account, factoryClassHash: string, ammClassHash: string, mathClassHash: string): Promise<string>;
+/**
+ * Approves an extension contract for use with markets deployed by the factory.
+ *
+ * Extensions must be approved by the factory owner before they can be used
+ * when deploying new markets.
+ *
+ * @param deployer - Account to execute the approval (must be factory owner)
+ * @param factoryAddress - Factory contract address
+ * @param extensionAddress - Extension contract address to approve
+ */
+export declare function approveExtension(deployer: Account, factoryAddress: string, extensionAddress: string): Promise<void>;
+/**
+ * Options for building deploy market calldata.
+ */
+export interface DeployMarketOptions {
+    /** Salt for deterministic address calculation */
+    readonly salt?: bigint;
+    /** Extension contract address (Oracle) - defaults to '0x0' */
+    readonly extension?: string;
+    /** Extension call points bitmask (v0.5.0+) - defaults to 0 */
+    readonly extensionCallPoints?: number;
+}
+/**
+ * Builds deploy_market calldata for the factory using ABI-aware encoding.
+ */
+export declare function buildDeployMarketCalldata(deployer: Account, collateralToken: string, fixture: MarketFixture, factoryAbi: Abi, options?: DeployMarketOptions): string[];
+/**
+ * Deploys a market via the factory.
+ */
+export declare function deployMarket(deployer: Account, factoryAddress: string, collateralToken: string, fixture: MarketFixture, factoryAbi: Abi, options?: DeployMarketOptions): Promise<string>;
+/**
+ * Deploys the Oracle contract as an extension for a market.
+ *
+ * In v0.2.0, Oracle is AMM-agnostic and has no constructor parameters.
+ * This eliminates the circular dependency between Oracle and AMM.
+ *
+ * @param deployer - Account to deploy with
+ * @param oracleClassHash - Declared Oracle class hash
+ * @returns Promise resolving to Oracle contract address
+ */
+export declare function deployOracle(deployer: Account, oracleClassHash: string): Promise<string>;
+/**
+ * Full deployment flow for integration tests.
+ *
+ * Uses devnet's predeployed ETH token as collateral.
+ */
+export declare function deployAll(deployer: Account, artifacts: LoadedArtifacts, fixture: MarketFixture, collateralToken?: string): Promise<{
+    declared: DeclaredContracts;
+    deployed: DeployedContracts;
+}>;
+/**
+ * Calculates the Oracle contract address before deployment.
+ *
+ * When deploying via `account.deployContract`, the deployer address is 0
+ * (contracts are deployed to a deterministic address based on class hash,
+ * salt, and constructor calldata).
+ *
+ * In v0.2.0, Oracle has no constructor parameters (AMM-agnostic).
+ *
+ * @param oracleClassHash - Declared Oracle class hash
+ * @param salt - Salt for deterministic address
+ * @returns Calculated Oracle contract address
+ */
+export declare function calculateOracleAddress(oracleClassHash: string, salt: bigint): string;
+/**
+ * Builds AMM constructor calldata for address calculation.
+ *
+ * This is the raw constructor calldata passed to the AMM contract,
+ * NOT the deploy_market calldata passed to the factory.
+ *
+ * @param owner - Market owner address
+ * @param admin - Market admin address
+ * @param collateralToken - Collateral token address
+ * @param fixture - Market configuration fixture
+ * @param factoryAddress - Factory contract address
+ * @param extension - Extension contract address (Oracle)
+ * @returns Compiled constructor calldata as string array
+ */
+export declare function buildAmmConstructorCalldata(owner: string, admin: string, collateralToken: string, fixture: MarketFixture, factoryAddress: string, extension: string): string[];
+/**
+ * Calculates the Market address before deployment via factory.
+ *
+ * When deploying via factory's `deploy_syscall`, the deployer is the factory address.
+ *
+ * @param factoryAddress - Factory contract address
+ * @param ammClassHash - Declared AMM class hash
+ * @param ammConstructorCalldata - AMM constructor calldata
+ * @param salt - Salt for deterministic address
+ * @returns Calculated Market contract address
+ */
+export declare function calculateMarketAddress(factoryAddress: string, ammClassHash: string, ammConstructorCalldata: string[], salt: bigint): string;
+/**
+ * Deploys Oracle with specific salt for deterministic address.
+ *
+ * In v0.2.0, Oracle has no constructor parameters (AMM-agnostic).
+ *
+ * @param deployer - Account to deploy with
+ * @param oracleClassHash - Declared Oracle class hash
+ * @param salt - Salt for deterministic address (must match what was used in calculateOracleAddress)
+ * @returns Promise resolving to Oracle contract address
+ */
+export declare function deployOracleWithSalt(deployer: Account, oracleClassHash: string, salt: bigint): Promise<string>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/__integration__/setup/deploy.d.ts.map

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