HookrMarketCoordinatorTokenDeployerV3

Deployed at 0x7A2821F7Ea0e4d0C5a409D479cd457d5B34F9399, compiled from src/HookrMarketCoordinatorV3.sol at source commit 8db7fc940938f811f508ba9cb0c8f2d3f24c9a25. Its source is verified on the explorer; see Verification.

A linked library. Deploys a new-token market's subject token with CREATE2 and derives its founding band

Linked rather than inlined because the coordinator's runtime has to stay inside the EIP-170 limit. It executes by DELEGATECALL, so the token is deployed from the coordinator's address and the CREATE2 address depends on the coordinator, not the library.

Functions

deploy

Deploys one HookrTokenV61 with the given salt, minting the whole supply to the caller's context.

function deploy(
    string calldata name,
    string calldata symbol,
    string calldata tagline,
    string calldata logoURI,
    address creator,
    uint256 totalSupply,
    bytes32 create2Salt
) public returns (address subject);

Parameters

Returns

initCodeHash

The creation-code hash for a set of constructor arguments, so any caller can predict the CREATE2 address before the launch transaction is sent.

function initCodeHash(
    string calldata name,
    string calldata symbol,
    string calldata tagline,
    string calldata logoURI,
    address creator,
    uint256 totalSupply
) public pure returns (bytes32);

Returns

Prefer the coordinator's previewNewTokenAddress, which composes this with the salt derivation.

foundingTickRange

Derives the bounded token-only sell band around the exact initialized tick.

function foundingTickRange(address subject, PoolKey calldata key, uint160 sqrtPriceX96, int24 bandTicks)
    public
    pure
    returns (bool valid, int24 tickLower, int24 tickUpper);

Returns

The opening price must sit exactly on a usable tick, because that tick is the band's edge on the quote side: the lower edge, with the supply above it, when the token is currency0, and the upper edge, with the supply below it, when the token is currency1. The coordinator rejects a sqrtPriceX96 that does not.

seedBand

Mints the founding position into the band foundingTickRange derived, inside the coordinator's own unlock callback.

function seedBand(
    IPoolManager poolManager,
    PoolKey calldata key,
    uint160 sqrtPriceX96,
    int24 tickLower,
    int24 tickUpper,
    uint256 amount0,
    uint256 amount1
) public returns (bool valid, uint256 used0, uint256 used1);

Returns

The amounts consumed are usually below the amounts offered, because liquidity is quantised. The coordinator burns the remainder to 0x…dEaD; the residue fields of CreatorBuyExecuted are always zero.

collectBand

Collects the accrued LP fees of the founding position without touching its liquidity. There is no path here that removes it.

function collectBand(IPoolManager poolManager, PoolKey calldata key, int24 tickLower, int24 tickUpper)
    public
    returns (bool valid, uint256 amount0, uint256 amount1);

Returns

This is what HookrMarketCoordinatorV5.collectLpFees calls. The routing of the collected amounts is HookrNativeMechanicsCoordinatorLibV2.routeFoundingPositionFees, which sends all of both currencies to the market's lpFeeRecipient.

The Token It Deploys

HookrTokenV61 is a fixed-supply ERC-20. 18 decimals, the whole supply minted once at construction, name, symbol, tagline, logoURI, creator and launchpad recorded on the token. No owner, no mint, no burn, no pause, no blocklist, no transfer tax.

It also tracks weightedAcquiredAt per holder and exposes holdingAge(account), which other Hookr surfaces read. Neither affects transfers or pool math.