# Pool Factory

The SyncSwap Stable Pool Factory contract is responsible for creating and managing Stable Pools within the SyncSwap ecosystem. It interacts with the Pool Master to ensure that newly created pools are properly registered and conform to the expected standards.

The SyncSwap Classic Pool Factory contract is responsible for creating and managing Classic Pools within the SyncSwap ecosystem. It interacts with the Pool Master to ensure that newly created pools are properly registered and conform to the expected standards.

#### Methods <a href="#methods" id="methods"></a>

**`constructor(address _master)`**

Initializes the Stable Pool Factory with the address of the Pool Master contract.

Copy

```
constructor(address _master) BasePoolFactory(_master) {
}
```

**`_createPool(address token0, address token1)`**

Internal function that creates a new Stable Pool with the given token pair. It performs necessary sanity checks and ensures that the pool is registered with the Pool Master.

Copy

```
function _createPool(address token0, address token1) internal override returns (address pool) {
    // Tokens with decimals more than 18 are not supported and will lead to reverts.
    uint token0PrecisionMultiplier = 10 ** (18 - IERC20(token0).decimals());
    uint token1PrecisionMultiplier = 10 ** (18 - IERC20(token1).decimals());

    bytes memory deployData = abi.encode(token0, token1, token0PrecisionMultiplier, token1PrecisionMultiplier);
    cachedDeployData = deployData;

    // Remove precision multipliers from salt and config.
    deployData = abi.encode(token0, token1);

    bytes32 salt = keccak256(deployData);
    pool = address(new SyncSwapStablePool{salt: salt}()); // this will prevent duplicated pools.

    // Register the pool with config.
    IPoolMaster(master).registerPool(pool, 2, deployData, token0, token1);
}
```

**`getDeployData()`**

Returns the deployment data for the pool being created.

Copy

```
function getDeployData() external view override returns (bytes memory deployData) {
    deployData = cachedDeployData;
}
```

**`getSwapFee(address pool, address sender, address tokenIn, address tokenOut, bytes calldata data)`**

Returns the swap fee for a given pool and token pair.

Copy

```
function getSwapFee(
    address pool,
    address sender,
    address tokenIn,
    address tokenOut,
    bytes calldata data
) external view override returns (uint24 swapFee) {
    swapFee = IPoolMaster(master).getSwapFee(pool, sender, tokenIn, tokenOut, data);
}
```

**`createPool(bytes calldata data)`**

Creates a new pool with the provided data and registers it with the Pool Master.

Copy

```
function createPool(bytes calldata data) external override returns (address pool) {
    (address tokenA, address tokenB) = abi.decode(data, (address, address));

    // Perform safety checks.
    if (tokenA == tokenB) {
        revert InvalidTokens();
    }

    // Sort tokens.
    if (tokenB < tokenA) {
        (tokenA, tokenB) = (tokenB, tokenA);
    }
    if (tokenA == address(0)) {
        revert InvalidTokens();
    }

    // Underlying implementation to deploy the pools and register them.
    pool = _createPool(tokenA, tokenB);

    // Populate mapping in both directions.
    getPool[tokenA][tokenB] = pool;
    getPool[tokenB][tokenA] = pool;

    emit PoolCreated(tokenA, tokenB, pool);
}
```

#### Events <a href="#events" id="events"></a>

**`PoolCreated`**

Emitted when a new pool is created.

Copy

```
event PoolCreated(address indexed token0, address indexed token1, address pool);
```

**`SetFactoryWhitelisted`**

Emitted when a factory's whitelist status is updated.

Copy

```
event SetFactoryWhitelisted(address indexed factory, bool whitelisted);
```

**`RegisterPool`**

Emitted when a new pool is registered.

Copy

```
event RegisterPool(address indexed factory, address indexed pool, uint16 indexed poolType, bytes data);
```

**`UpdateForwarderRegistry`**

Emitted when the forwarder registry is updated.

Copy

```
event UpdateForwarderRegistry(address indexed newForwarderRegistry);
```

**`UpdateFeeManager`**

Emitted when the fee manager is updated.

Copy

```
event UpdateFeeManager(address indexed newFeeManager);
```

***

#### Example Usage <a href="#example-usage" id="example-usage"></a>

**Creating a New Stable Pool**

To create a new Stable Pool, the following steps are typically followed:

1. Initialize the factory with the Pool Master address.
2. Call the `createPool` function with the desired token pair.
3. The factory will handle the rest, ensuring the new pool is registered and compliant with the Pool Master.

Example:

Copy

```
address poolMaster = 0x0000000000000000000000000000000000000000;
SyncSwapStablePoolFactory factory = new SyncSwapStablePoolFactory(poolMaster);

address tokenA = 0x0000000000000000000000000000000000000000;
address tokenB = 0x0000000000000000000000000000000000000000;
bytes memory data = abi.encode(tokenA, tokenB);
address newPool = factory.createPool(data);

// The new pool is now created and registered with the Pool Master.
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.syncswap.xyz/syncswap-technical-docs/stable-pool/pool-factory.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
