跳转到主要内容

​
V3 QuoterV2

QuoterV2 合约允许在不执行交换的情况下获取给定 V3 交换的预期输出或输入数量。它在链上模拟交换逻辑以返回准确的报价。
这些函数不是 Gas 高效的，不应在链上调用。请通过 eth_call（静态调用）从链下代码中使用它们。链上交换执行请使用 V3 Router 或 Universal Router。

​
核心函数

​
quoteExactInputSingle

返回单池精确输入交换的预期输出数量。 
function quoteExactInputSingle(
    QuoteExactInputSingleParams memory params
) public override returns (
    uint256 amountOut,
    uint160 sqrtPriceX96After,
    uint32 initializedTicksCrossed,
    uint256 gasEstimate
);
参数（结构体 QuoteExactInputSingleParams）：
参数类型描述
tokenInaddress输入代币地址
tokenOutaddress输出代币地址
amountInuint256期望的输入数量
feeuint24池子费率等级（100、500、3000 或 10000）
sqrtPriceLimitX96uint160价格限制（0 表示无限制）
返回值：
返回值类型描述
amountOutuint256预期输出数量
sqrtPriceX96Afteruint160交换后的池子价格
initializedTicksCrosseduint32穿越的已初始化 tick 数量
gasEstimateuint256交换的预估 Gas 费用

​
quoteExactInput

返回多跳精确输入交换的预期输出数量。 
function quoteExactInput(
    bytes memory path,
    uint256 amountIn
) public override returns (
    uint256 amountOut,
    uint160[] memory sqrtPriceX96AfterList,
    uint32[] memory initializedTicksCrossedList,
    uint256 gasEstimate
);
参数类型描述
pathbytes编码的交换路径（代币地址和费率）
amountInuint256期望的输入数量
返回值：
返回值类型描述
amountOutuint256预期输出数量
sqrtPriceX96AfterListuint160[]每一跳后的池子价格
initializedTicksCrossedListuint32[]每一跳穿越的 tick 数量
gasEstimateuint256总预估 Gas 费用

​
quoteExactOutputSingle

返回单池精确输出交换所需的输入数量。 
function quoteExactOutputSingle(
    QuoteExactOutputSingleParams memory params
) public override returns (
    uint256 amountIn,
    uint160 sqrtPriceX96After,
    uint32 initializedTicksCrossed,
    uint256 gasEstimate
);
参数（结构体 QuoteExactOutputSingleParams）：
参数类型描述
tokenInaddress输入代币地址
tokenOutaddress输出代币地址
amountuint256期望的输出数量
feeuint24池子费率等级
sqrtPriceLimitX96uint160价格限制（0 表示无限制）

​
quoteExactOutput

返回多跳精确输出交换所需的输入数量。 
function quoteExactOutput(
    bytes memory path,
    uint256 amountOut
) public override returns (
    uint256 amountIn,
    uint160[] memory sqrtPriceX96AfterList,
    uint32[] memory initializedTicksCrossedList,
    uint256 gasEstimate
);
参数类型描述
pathbytes编码的交换路径（精确输出时为反序）
amountOutuint256期望的输出数量

​
回调

​
uniswapV3SwapCallback

function uniswapV3SwapCallback(
    int256 amount0Delta,
    int256 amount1Delta,
    bytes data
) external view override;
在报价模拟期间由池子调用。这是内部机制 — 你不需要直接调用此函数。
参数类型描述
amount0Deltaint256池子发送（负值）或接收（正值）的 token0 数量
amount1Deltaint256池子发送（负值）或接收（正值）的 token1 数量
databytes从交换调用传递过来的回调数据

​
ABI

[
  "function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96)) returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)",
  "function quoteExactInput(bytes path, uint256 amountIn) returns (uint256 amountOut, uint160[] sqrtPriceX96AfterList, uint32[] initializedTicksCrossedList, uint256 gasEstimate)",
  "function quoteExactOutputSingle((address tokenIn, address tokenOut, uint256 amount, uint24 fee, uint160 sqrtPriceLimitX96)) returns (uint256 amountIn, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)",
  "function quoteExactOutput(bytes path, uint256 amountOut) returns (uint256 amountIn, uint160[] sqrtPriceX96AfterList, uint32[] initializedTicksCrossedList, uint256 gasEstimate)"
]

​
示例：获取报价

const QUOTER_ABI = [
  'function quoteExactInputSingle((address,address,uint256,uint24,uint160)) returns (uint256,uint160,uint32,uint256)',
];

const quoter = new ethers.Contract(QUOTER_V2_ADDRESS, QUOTER_ABI, provider);

// 报价：通过 0.3% 池子，1 个 tokenIn 可以换多少 tokenOut？
const [amountOut, sqrtPriceAfter, ticksCrossed, gasEstimate] =
  await quoter.quoteExactInputSingle.staticCall({
    tokenIn: '0xTokenA',
    tokenOut: '0xTokenB',
    amountIn: ethers.parseEther('1'),
    fee: 3000,
    sqrtPriceLimitX96: 0,
  });

console.log(`预期输出: ${ethers.formatEther(amountOut)}`);
console.log(`Gas 预估: ${gasEstimate}`);
务必使用 staticCall（ethers v6）或 callStatic（ethers v5）— 这些函数如果作为普通交易调用会回滚。