v5-ASAMM Protocol

The SwapFacet executes token swaps using the sigmoid bonding curve with progressive fee calculation.

Functions

Execute a swap against a pool.

solidity

function swap(SwapParams calldata params) external returns (SwapResult memory result)

Parameters (SwapParams):

Name	Type	Description
poolId	bytes32	The pool to swap against
zeroForOne	bool	true = sell token0 for token1, false = reverse
amountSpecified	int256	Positive = exact input, negative = exact output
sqrtPriceLimitX96	uint160	Price limit (0 = no limit)
recipient	address	Address to receive output tokens
deadline	uint256	Transaction deadline (unix timestamp)

Returns (SwapResult):

Field	Type	Description
amount0	int256	Token0 delta (negative = sent to user)
amount1	int256	Token1 delta (negative = sent to user)
sqrtPriceX96After	uint160	Price after swap
tickAfter	int24	Tick after swap
liquidityAfter	uint128	Active liquidity after swap
feeAmount	uint256	Total fee charged

Events: Swap, SwapExecuted (via EventEmitter)

Reverts:

The swap engine iterates through ticks, computing output amounts using the sigmoid curve
At each step, the progressive fee is calculated: fee = baseFee + impactFee * (stepSize/liquidity)^2
Fees are split: 70% LP, 20% protocol, 10% trader rebate pool
Oracle observations are recorded for TWAP
EventEmitter is notified with full before/after state

Licensed under the GNU General Public License v3.0--see LICENSE for terms.

Copyright (C) 2026 PaxLabs Inc.
SPDX-License-Identifier: GPL-3.0-only