LaunchCurveRouter 接入文档

合约地址

调用前请根据当前 chainId 选择 Router。不要跨链混用 Router、Factory、Pair Token 和 Launch Token 地址。

精确输入交易

已知 launchToken 后，通过 Factory 获取 Pair Token 和 Curve，再完成报价、授权与 Router 调用。示例兼容 ERC20 和原生币 Pair Token。

const factory = new ethers.Contract(
  factoryAddress,
  launchFactoryAbi,
  signer,
)
const launch = await factory.getLaunch(launchToken)

const curve = new ethers.Contract(launch.curve, launchCurveAbi, signer)
const router = new ethers.Contract(routerAddress, launchCurveRouterAbi, signer)

const [reserve0, reserve1] = await curve.getReserves()
const token0IsLaunchToken = await curve.token0IsLaunchToken() // Launch Token 是否为 token0
const pairTokenIsWrappedNative = await curve.pairTokenIsWrappedNative() // Pair Token 是否为封装原生币
const protocolFeeBps = await factory.protocolFeeBps() // 协议费率，分母为 10000
const graduationPairAmount = await curve.graduationPairAmount() // 发射成功所需 Pair Token 数量
const salePairReserve = await curve.salePairReserve() // 当前已进入曲线的 Pair Token 储备

const launchReserve = token0IsLaunchToken
  ? reserve0
  : reserve1
const pairReserve = token0IsLaunchToken
  ? reserve1
  : reserve0

const pairToken = launch.pairToken
const pair = new ethers.Contract(pairToken, erc20Abi, signer)
const amountIn = ethers.parseUnits('100', await pair.decimals())

const BPS = 10_000n
let curveAmountIn =
  amountIn * (BPS - protocolFeeBps) / BPS
const remainingPairAmount =
  graduationPairAmount - salePairReserve

if (curveAmountIn > remainingPairAmount) {
  curveAmountIn = remainingPairAmount
}

const quotedOut =
  curveAmountIn * launchReserve /
  (pairReserve + curveAmountIn)
const slippageBps = 100n
const amountOutMin =
  quotedOut * (BPS - slippageBps) / BPS

const path = [pairToken, launchToken]
const to = await signer.getAddress()
const deadline = Math.floor(Date.now() / 1000) + 600

if (!pairTokenIsWrappedNative) {
  await (
    await pair.approve(routerAddress, amountIn)
  ).wait()
}

const callAmountIn =
  pairTokenIsWrappedNative ? 0n : amountIn
const overrides =
  pairTokenIsWrappedNative
    ? { value: amountIn }
    : {}

const tx = await router.swapExactTokensForTokens(
  callAmountIn,
  amountOutMin,
  path,
  to,
  deadline,
  overrides,
)
const receipt = await tx.wait()

getLaunch 返回参数

getReserves 返回参数

Router 参数与返回值

精确输出交易

用户指定最终收到的 Launch Token 数量，Router 反算实际输入，并通过 amountInMax 限制最高支出。

const factory = new ethers.Contract(
  factoryAddress,
  launchFactoryAbi,
  signer,
)
const launch = await factory.getLaunch(launchToken)

const curve = new ethers.Contract(launch.curve, launchCurveAbi, signer)
const router = new ethers.Contract(routerAddress, launchCurveRouterAbi, signer)

const [reserve0, reserve1] = await curve.getReserves()
const token0IsLaunchToken = await curve.token0IsLaunchToken() // Launch Token 是否为 token0
const pairTokenIsWrappedNative = await curve.pairTokenIsWrappedNative() // Pair Token 是否为封装原生币
const protocolFeeBps = await factory.protocolFeeBps() // 协议费率，分母为 10000
const graduationPairAmount = await curve.graduationPairAmount() // 发射成功所需 Pair Token 数量
const salePairReserve = await curve.salePairReserve() // 当前已进入曲线的 Pair Token 储备

const launchReserve = token0IsLaunchToken ? reserve0 : reserve1
const pairReserve = token0IsLaunchToken ? reserve1 : reserve0

const pairToken = launch.pairToken
const pair = new ethers.Contract(pairToken, erc20Abi, signer)
const token = new ethers.Contract(launchToken, erc20Abi, signer)
const amountOut = ethers.parseUnits('100000', await token.decimals())

if (amountOut >= launchReserve) {
  throw new Error('amountOut exceeds curve reserve')
}

const BPS = 10_000n
const curveAmountIn =
  pairReserve * amountOut / (launchReserve - amountOut) + 1n
const protocolFee =
  curveAmountIn * protocolFeeBps / BPS
const quotedAmountIn =
  curveAmountIn + protocolFee

const remainingPairAmount =
  graduationPairAmount - salePairReserve
if (curveAmountIn > remainingPairAmount) {
  throw new Error('amountOut exceeds remaining launch capacity')
}

const slippageBps = 100n
const amountInMax =
  (
    quotedAmountIn *
    (BPS + slippageBps) +
    BPS - 1n
  ) / BPS

const path = [pairToken, launchToken]
const to = await signer.getAddress()
const deadline = Math.floor(Date.now() / 1000) + 600

if (!pairTokenIsWrappedNative) {
  await (
    await pair.approve(routerAddress, amountInMax)
  ).wait()
}

const overrides =
  pairTokenIsWrappedNative
    ? { value: amountInMax }
    : {}

const tx = await router.swapTokensForExactTokens(
  amountOut,
  amountInMax,
  path,
  to,
  deadline,
  overrides,
)
const receipt = await tx.wait()

报价与滑点

Router 当前没有公开 view 报价函数。应先根据虚拟储备计算报价，再通过 simulateContract 验证交易，并加入滑点保护。

const amountOutMin =
  quotedOut * (10_000n - slippageBps) / 10_000n

const amountInMax =
  (quotedIn * (10_000n + slippageBps) + 9_999n) /
  10_000n

特殊行为与安全提示

• 零数量语义：amountIn 或 amountInMax 为 0 时，Router 会使用当前持有的全部对应资产。
• 不要预转账：不要提前将 ERC20 转入 Router，也不要把 Router 当作资金保管合约。
• Graduation 退款：超过剩余目标的 Pair Token 会退回 msg.sender，而不是 to。
• 接收地址：输出原生币时，如果 to 是合约，该合约必须支持接收原生币。
• 迁移后交易：graduated 为 true 后，应切换至迁移后的 V3 Router。

常见错误