Axpha

【AlphaSwap V2协议简介】 "交易即挖矿，手续费变资产！"Axpha与Uniswap V2创新融合，通过0.3%交易费自动注入流动性池提升k值，推动LP代币增值若协议费开启，0.05%定向增发至国库，0.25%仍归LP费用透明链上可查，团队费按治理比例ϕ分配支持多模块交互：Stats实时数据、Faucet领币、杠杆交易、Meme币池及排行榜等，后端集成交易轮播与API动态协议所有权明确。

Axpha

• Swap聚合器
  • 本地收藏，存储本地Loc，每次交易会存储购买的Token
  • Token选择，通过后端list_raw获取，数据来源
    • github配置
    • meme完成Bonding curve后
  • K线
    • 使用geckoTerminal iframe嵌入，测试网通过映射Pools地址实现
  • quote询价
    • 使用图论算法实现多跳
    • 增加Dex支持
    • swap fees，收取1%直接转到团队钱包
      • feeRate: 交易手续费，从tokenIn直接扣除fees后剩余的用于交易
      • slippageRatio：滑点收益，实际交易后获得的数量比询价时显示的值多的部分的收取比率
  • history
    • 通过子图获取数据，在个人中心查看，不包好swap和unswap的数据
• Pools Manage
  • overview 数据
  • Perp Pools
    • 添加流动性
    • 移除流动性(需要支付fees，两阶段执行，第二阶段收取) 每次添加流动性后，有15分钟的冻结时间
    • 30天收益图来自子图数据，快照计算所得
    • 7 Days Est.APR
      • 1. 获取基础数据来源 链上 / 接口数据 lpData lpData 中某个池子（或 id 为 "0" 的聚合）的结构包含： totalFees：累计手续费总额 totalSupply：当前 LP 总量 snap[0].totalFees：最新时刻的累计手续费 snap7[0].totalFees：7 天前的累计手续费 LP 单价 lpPriceUSD 顶部 useEffect（行 74-79）用的是： 从 localStorage 取出 lpPrice-usd-${chainId} 得到一个 LP 单位价格 lpPriceUSD 表格每一行的 APR（行 141-145）则是： 先算链上的 lpPrice = poolAmountUsd / totalSupply 再格式化为 lpPriceUSD = formatAmount(lpPrice, USD_DECIMALS, 8, false) 2. 计算 7 日手续费增量（收益） 在全局 APR（useEffect 74-79）和每一行 APR（行 141-145）中逻辑一致： 7 日总收益（以“手续费增量”定义）： totalProfit=(snap[0].totalFees∣∣0)−(snap7[0].totalFees∣∣0)totalProfit=(snap[0].totalFees∣∣0)−(snap7[0].totalFees∣∣0) 即：totalProfit = 最近时刻累计手续费 − 7 天前累计手续费 
    • LP price
      • https://docs.google.com/document/d/1dArq0PNKZlcQvww3n4IfFYbdrCwJej0Q2A2BW8fnBJY/edit?tab=t.0#heading=h.k94s2w5srib5 APLP 价格计算方式总结 在 APLPPools.tsx 里，APLP 的价格（LP 单价）本质上是：> APLP 单价 = 池子总资产价值（USD） ÷ LP 总供应量代码里对应两处核心计算： 1. 当前选中池的 APLP 价格（顶部全局 lpPrice） const lpPriceInfoDataPools = lpPriceInfoData[currentPoolsAddress]; const lpPrice = (lpPriceInfoDataPools && lpPriceInfoDataPools?.totalSupply?.gt(0) && lpPriceInfoDataPools?.poolAmountUsd?.gt(0) && lpPriceInfoDataPools?.poolAmountUsd ?.mul(expandDecimals(1, USD_DECIMALS)) .div(lpPriceInfoDataPools?.totalSupply)) || expandDecimals(1, USD_DECIMALS); 含义： poolAmountUsd：当前池子总资产价值（以 USD 计） totalSupply：该池子的 LP 总供应量 expandDecimals(1, USD_DECIMALS)：把 1 放大到带有 USD 精度的整数 计算逻辑： 如果 totalSupply > 0 且 poolAmountUsd > 0： lpPrice = poolAmountUsd * 10^USD_DECIMALS / totalSupply 否则回退为 1 * 10^USD_DECIMALS（等价于默认 1 USD） 后面再通过： const lpPriceUSD = (lpPrice.gt(0) && formatAmount(lpPrice, USD_DECIMALS, 8, false)) || 0; 把 lpPrice 转成实际显示用的 十进制价格（最多 8 位小数的 USD 价格）。 2. 表格中每个池子行内的 APLP 价格 在 Object.entries(infoTokensAll).map 里每个 poolAddress 也有一套同样逻辑： const lpBaseData = lpPriceInfoData[poolAddress]; const lpPrice = (lpBaseData && lpBaseData?.totalSupply?.gt(0) && lpBaseData.poolAmountUsd?.gt(0) && lpBaseData.poolAmountUsd ?.mul(expandDecimals(1, USD_DECIMALS)) .div(lpBaseData.totalSupply)) || bigNumberify(0); const lpPriceUSD = (lpPrice.gt(0) && formatAmount(lpPrice, USD_DECIMALS, 8, false)) || 0; 含义完全相同，只是针对每个具体池子算各自的 LP 单价，然后转为可读的 lpPriceUSD 给 APR 等其他逻辑使用。 3. 总结一句话 数学公式： ​ 实现细节： 用 poolAmountUsd / totalSupply 得到 LP 单价，再按 USD_DECIMALS 做精度放大、格式化输出。 当 totalSupply 或 poolAmountUsd 无效时，顶层使用默认值 1 USD，行内为 0。
  • AMM Pools，后端数据，涉及积分Token配置
    • V2 Pools
      • 1. 费率结构 统一费率：无论交易对如何，每笔 swap 都收取 0.3 % 的成交额作为手续费 。 协议费开关：这 0.3 % 里可以拆分出 0.05 % 作为“协议费”（protocol fee），但只有在 Factory 合约中设置了 feeTo 地址后才会启动；目前主网该开关仍为 关闭 状态，因此全部 0.3 % 现阶段都归 LP 。 2. 收取方式（不直接转账，而是“留存池子”） 手续费并不会在 swap 时单独转走，而是 直接留在 Pair 的储备池里，导致 k = reserve_x × reserve_y 比 swap 前略增 。 由于没有增发对应的 LP-token，这部分“额外 k”对应的资产价值 按比例摊到所有 LP 的份额中，相当于 LP 的每份 LP-token 可赎回的底层资产变多了，即 手续费通过 LP-token 增值来体现 3. 协议费的实现（若未来开启） 当且仅当 feeTo != address(0) 时，每次 mint/burn/swap 都会先调用 _mintFee(...)： 计算自上次记录以来 √k 的增长量； 用公式 liquidity = totalSupply * (√k – √kLast) / (5√k + √kLast) 铸出 约 1/6 的新 LP-token 给 feeTo 地址； 现有 LP 份额被等比例稀释，从而实现把 ≈ 0.05 % 的交易额 价值转给协议，而 LP 仍获得剩余 ≈ 0.25 % 的增值 。 4. 用户感知 交易者：每次 swap 输入金额中 0.3 % 被留存在池子，输出代币按扣除后的储备计算，滑点已内含费用 。 流动性提供者：无需领取操作，只要持有 LP-token，手续费收益自动累积；赎回流动性时一并提取增值部分 。
      • 添加流动性
      • 移除流动性
      • Swap，通过聚合器集成
      • Uniswap V2 通过“0.3 % 成交额留池子 → 提升 k 值 → LP-token 增值”的方式收取手续费；若未来社区投票开启协议费，则其中 0.05 % 会再通过 定向增发 LP-token 流向协议国库，其余 0.25 % 仍归全体 LP。
    • V3 Pools
      • 1. 如何计算（仅当开关打开时） 合约在每次 swap 的 Swap 事件里实时做： protocolFees.tokenX += feeAmount * ϕ protocolFees.token0 与 protocolFees.token1 即为该池子未领取的团队费余额 2. 如何查看 池子合约地址 → 读取 protocolFees.token0()、protocolFees.token1()（uint128，单位原生代币）。 3. 如何领取 只有 Factory.owner()能调用 pool.collectProtocol(address recipient, uint128 amount0Requested, uint128 amount1Requested) 举例：0.30 % 档若设 ϕ=1/6，则交易者每 swap 1 000 USDC，合约扣 3 USDC 手续费，其中 0.5 USDC 计入 protocolFees，2.5 USDC 归 LP。 protocolFees 是协议层“团队费”池子，对任何外部地址只读，无人可领，直到治理提案触发 collectProtocol 。 用户LP手续费： 交易者在 swap 时支付的 总手续费 × (1 – 协议费比例) 链上实时累加到每个仓位 NFT 的 tokensOwed0 / tokensOwed1 字段 任何时候调用 NonfungiblePositionManager.collect() 即可把这部分代币提到自己钱包，无需撤流动性
      • 添加流动性
      • 移除流动性
      • Swap，通过聚合器集成
      • 团队费 = 交易者手续费 × 治理设定的 ϕ；链上变量 protocolFees.token0/1 实时累加；任何人可读、可核对；只有 owner可以调用 collectProtocol 把代币提到国库
• Perp
  • Trade
    • indexToken
      • 后端API
        • 通过监听wss获取合约的funding和Interest 数据
        • 通过轮询pyth的接口获取实时价格和24H变化量
        • 通过查询子图，获取24H Volume数据
    • PayToken
      • 前端配置和合约交叉验证，取交集
    • K线
      • pyth的history数据和流式实时价格
    • Positions
      • 通过wss合约轮询
    • Orders
      • 通过wss合约轮询
    • Claims funding Fee
      • 子图显示领取记录
      • 合约查询可领取数量
    • History
      • Trade History：用户个人数据
      • Order History：用户个人数据
      • Market Activity：全量所有用户数据
    • 交易（两阶段执行）
      • Market
      • Limit
  • Fees
    • 1、开仓/平仓交易费（Open/Close Position Fee） 费率：0.1% × Position Size（名义本金，与杠杆倍数无关） 扣款时点：下单成交瞬间 去向：50% 团队钱包，50% 流动性提供者 举例：开 100 k USDC 名义多仓，立刻被扣 100 k × 0.1% = 100 USDC 2、执行费（Execution Fee），不进行分配，直接进入keeper 金额：固定，合约配置（链上 keeper 触发执行的成本） 扣款时点：下单时随交易费一起预扣 去向：100% 给到执行订单的 keeper（链上可见直接转给 bot 地址） 3、借款费（Borrow Fee，仅持仓期间按小时计） 费率： 每小时利息 = (你借走的资产价值) ÷ (池子该资产总余额) × 0.01% 借走资产价值 = |名义仓位| ÷ 杠杆倍数（即你的债务部分） 扣款时点：每小时整点自动从仓位保证金里扣，平仓时结算剩余小时 去向：100% 进入对应资产池，归流动性提供者 4、资金费（Funding Fee，多空互打，每小时结算） 费率： 单边上限 0.015%/h（= 0.36%/24 h） 多空互相支付 80%，剩余 20% 归流动性池 实际瞬时 rate 由多空仓位差额决定，可正可负 扣款时点：关仓或者增加较少抵押品都会触发（不实时结算，按小时计算费用）； 去向：80% 付给对手盘，20% 给流动性池 5、清仓费（Liquidation Fee，仅爆仓时） 金额：固定 5 USDC.e 扣款时点：仓位被 keeper 触发爆仓瞬间 去向：100% 直接转入团队钱包（0xad2786…） 假设： 名义仓位 100 k USDC，杠杆 10×，持仓 24 h 后平仓，期间 funding rate 恒定为 +0.01%/h（多头付给空头），多空差额刚好触发 80/20 分配。 持仓 24 h Borrow Fee： 债务 = 100 k / 10 = 10 k USDC 假设池子余额 1 M USDC → 每小时利率 = (10 k/1 M) × 0.01% = 0.0001% 24 h 利息 ≈ 10 k × 0.0001% × 24 = 0.24 USDC Funding Fee： 每小时付 100 k × 0.01% = 10 USDC 24 h 共付 240 USDC，其中 192 USDC 给空头，48 USDC 进流动性池 若未爆仓，总成本 105 + 0.24 + 240 + 105 ≈ 450.24 USDC 其中： 团队：开仓 50 + 平仓 50 + 执行 5 + 5 = 110 USDC 流动性提供者：开仓 50 + 平仓 50 + borrow 0.24 + funding 48 ≈ 148.24 USDC 对手盘（空头）：192 USDC 若中途爆仓 额外再扣 5 U 清仓费，全部给团队；其余三项照常发生。 一句话总结 “开/关”一笔仓位，用户肉眼可见的硬性支出只有 0.1%×名义本金（开仓）+ 0.1%×名义本金（平仓） 其余 Borrow/Funding 是持仓时间成本，爆仓时再+5 U 清仓费；所有费用按 50/50 或 80/20 规 则在团队、LP、对手盘之间实时分配。
    • Open/Close fees：0.1%，开关仓时收取
    • Borrow Fee
    • Funding fees
    • Liq fees：固定5USD
• Referrals
  • Affiliates
    • 当被邀请者交易的时候，每一笔都会有开关参观费用的5%进行累计，邀请者手工领取
  • Traders
    • 当绑定邀请码后（不能绑定自己的邀请码），每一笔交易都会直接进行折扣. 折扣金额为：开关仓手续费的5%
• Meme
  • 创建Meme
    • 创建fees，固定费用，可通过合约owner配置
  • Meme Trade
    • fees：每笔交易的1%
    • 流动性转移：固定
    • keeper费用：固定
    • 交易如果输入5U，使用不完的话，会退还给用户
    • Meme详情
  • Meme列表：后端API+WebSocket
  • 交易轮播：子图
  • King of the Hill：后端
    • 计算规则：当前king为100%时，寻找大于70%未满100%且进度最大的代替当前king，找不到则继续使用当前king
  • Listed：后端
    • 最新达到100%的Meme
  • Leaderboard：后端
• Portfolio
  • Trade
    • 后端数据
  • Pools
    • Perp Pools
      • 合约数据
    • V2 Pools
      • 来自子图和合约数据
    • V3 Pools
      • 通过NFTPositionManage合约blanceOf获取
  • Meme
    • 后端数据
• Lend
• Faucet
  • 合约配置可领取Token列表、状态
• Stats