从第一原理讲清 Mirror。
协议机制、集成说明与安全公示三部分。所有数字与费率以链上读数为准,文档只解释规则本身;涉及资金的每条规则都写明边界与例外。
地板价是金库资产的折算值,会随股价下跌而下跌,任何情况下都不构成保本、回购或收益承诺。主网合约已审计,参与前请先读完风险揭示。
概览
Mirror 是一个镜像模因币的发行与交易协议。平台把股票代币锁进链上金库,发行与之对应的模因币;公众先在发射架按曲线认购,达到门槛后标的毕业进入二级交易池。每一步都由你自己的钱包签名,平台不托管你的代币与资金。
与普通模因币的区别只有一条:每一枚镜像模因币背后都对应链上金库里真实持有的股票代币,因此它有一条可核对的资产折算线 —— 地板价。地板价会随股价下跌而下跌,它是折算值,不是保本、回购或收益承诺。
一个标的在生命周期里会在两个地方成交:先在发射架的认购曲线上,毕业后在二级交易池里。切换时你不需要做任何事,钱包里的代币在切换前后是同一枚代币。
标的由平台方创建并上架,没有自助发币入口;用户参与的是认购与交易。你想要的标的可以在提名页提出。
生命周期
每个标的都走同样的四步,中途没有别的分支。
01 上架
平台方创建标的并写入参数:总供给、曲线分配、毕业门槛、费率、白名单与开售时间。参数在上架时写入合约,之后不再由后台改动。
02 曲线认购
任何符合条件的地址都可以用 USDG 加注,价格随累计入金沿曲线上升,越早进入价格越低。曲线阶段只进不出:这一阶段没有卖出或退款入口,这是有意设计,用来避免曲线内低买高卖套利。
03 毕业
累计入金触及门槛即硬性封盘,不再接受加注,避免尾差导致建池失败。封盘后由多签在 24 小时内执行毕业:合约把募集资金与预留供给交给池子,原子化完成建池。
04 二级交易
建池完成后,买卖在交易池进行,股票代币与模因币之间的兑换在闪兑池进行,你也可以注入成对资产做市赚取手续费。
认购曲线
曲线是一台只收不付的自动售货机:它按累计入金定价,价格不由任何人设定。
认购价 = 你实付的 USDG ÷ 实际获得的数量。买得越多,价格沿曲线抬得越高;大额单笔的成交均价会差于你看到的即时报价,这与任何流动性有限的市场一致。
每笔认购的 USDG 里有 10% 由合约自动预留,作为毕业后交易池的种子流动性,不参与曲线定价份额。页面在下单区明确标示这部分,认购价里已经含它。
超额买入不会被吃掉
如果你的下单金额超过门槛剩余额度,交易整笔回滚,而不是按剩余额度部分成交。这样你不会在不知情的情况下按另一个价格拿到另一个数量;页面会先提示剩余可买额度。
为什么曲线阶段不能卖出
曲线在售完之前持有的正是即将用于建池的资金,允许卖出会改变每个标的应当到达的建池状态。退出渠道是毕业后的交易池。
毕业与封盘
毕业门槛按标的分级配置,一级为 150,000 美元,在上架时写入合约;进度条按链上累计入金实时计算,不使用后台估算。
建池所用的供给是上架即预留的固定份额,任何人都不能在事后调整,因此同一档参数下的标的毕业时得到的池子规模一致,不取决于是被一笔大单还是几百笔小单买满。
封盘期间你的资金
封盘到建池完成之间,你已投入的资产由合约托管,既不能继续加注也不能撤回,这是合约层面的既定规则。平台承诺自封盘起 24 小时内完成建池;若因行情或流动性异常无法在时限内完成,平台会在同一时限内公告处理方案,而不是自动退款。
毕业容差与调整规则
为吸收精度尾差,合约设有毕业容差上限 50 bps,当前生效值 5 bps。放宽容差立即生效;收紧容差必须先发起提案,等待 24 小时后才能应用,期间的毕业仍按当前已生效值执行,也可以在生效前取消提案。
- 一级门槛
- 150,000 美元
- 封盘后建池时限
- 24 小时
- 毕业容差
- 当前 5 bps / 上限 50 bps
- 收紧容差
- 提案后等待 24 小时
地板价
地板价是金库资产的折算线,用来判断当前市场价相对资产的溢价水平。
地板价 = 链上金库内股票代币的当前市值 ÷ 模因币总供给。它随储备规模与股价变动:储备增加会抬高地板,股价下跌会压低地板。它不是保本线,也不是任何形式的回购或收益承诺。
三个价格口径
认购价:发射阶段每枚实付美元,已含交易池种子预留。
地板价:金库资产折算出的托底参照。
市场价:毕业后交易池内的实际成交价,由池内供需决定,可能显著高于地板价,也可能回落至接近地板价。
全站只使用这三个名称,不出现其他叫法。早期认购价与地板价差距较大是正常的,差额即市场对该标的的投机定价。
按链上储备算地板价
地板价必须用链上读数现算:闪兑池的有效股票储备折算成美元,再除以模因币总供给。不要用缓存价格或页面上显示过的数字反推。
import { formatUnits } from "viem";
// 注意:USDG 是 6 位小数,股票代币与模因币是 18 位小数,不能混用
const [stockReserve, memeSupply] = await Promise.all([
client.readContract({ address: poolA, abi: mirrorPoolAbi, functionName: "getEffectiveStockReserve" }),
client.readContract({ address: memeToken, abi: erc20Abi, functionName: "totalSupply" }),
]);
// stockUsdPrice:股票代币的美元单价(1e6 精度),来自池内报价或预言机
const vaultUsd = Number(formatUnits(stockReserve, 18)) * Number(formatUnits(stockUsdPrice, 6));
const floorUsd = vaultUsd / Number(formatUnits(memeSupply, 18));闪兑池与交易池
闪兑池(股票代币 ⇄ 模因币)
用于股票代币与模因币之间的双向兑换,是地板价的资产来源池。报价、费率与储备一律实时读取链上合约,前端不自算、不硬编码。
交易池(USDG ⇄ 模因币)
毕业后开启的二级市场,买卖在这里发生。页面同时展示地板价与市场价、池内双边储备与当前费率,便于你判断溢价与滑点。
做市
把 USDG 与模因币成对注入交易池即可获得做市份额。归 LP 的手续费自动并入池内资产,收益体现为份额价值上涨,无需领取;撤出时按当时比例拿回两种资产,因此你承担无常损失。
手续费与分配
交易池每笔成交收取手续费,按三层分配:50% 留在池内归做市份额持有人,15% 进入金库用于买入股票代币、加厚地板,35% 归协议留存。展示值全部实时读链,实际费率以合约读数为准。
协议留存的 35% 暂时整体留在协议账上,其中 20% 是为平台币预留的储备 —— 待平台币上线后,这部分将用于回购并销毁平台币。平台币上线前不作其他用途。
手续费以成交所用的计价资产计收,不会以你正要卖出的模因币形式向你收费。
两条收入处置线
USDG 形式的金库份额由多签用于买入股票代币并注入闪兑池储备,直接抬高地板价,每笔复投都有链上记录与地板抬升幅度。
模因币形式的金库份额采取销毁处理,减少总供给;销毁统计只计入多签地址发出的销毁,避免与普通地址的自发销毁混计。
- 做市份额
- 50%
- 金库加厚地板
- 15%
- 协议留存
- 35%
- 其中平台币回购储备
- 20%
白名单与参与限制
部分标的在开售初期仅对白名单地址开放,并按档位限制单钱包上限;进入公开售卖时间后自动对所有地址开放。你的额度与剩余可买数量由合约校验,页面直接显示,不足时不会让你发出一笔注定失败的交易。
白名单以 Merkle 证明的形式在链上校验,名单根在上架时写入合约;更换标的必须重新生成名单根。
部分司法辖区不在服务范围内,访问时会出现地区提示。首次进行资金操作前必须完成风险确认。
校验白名单额度与剩余可买
下单前先读本地址在当前档位的额度与剩余可买数量,额度为 0 或不足时不要发交易。证明由名单根对应的 Merkle 树生成,换标的必须重算。
// tier:档位序号;proof:该地址在名单树中的兄弟节点数组
const quota = await client.readContract({
address: launchCurve, abi: launchCurveAbi, functionName: "quotaFor",
args: [launchId, wallet, tier, proof],
});
// 已买部分要扣掉,剩余可买才是真正能下单的上限
const remaining = await client.readContract({
address: launchCurve, abi: launchCurveAbi, functionName: "getRemainingWalletCap",
args: [launchId, wallet],
});
const maxBuy = quota < remaining ? quota : remaining;治理与权限
所有管理动作 —— 创建发射、设置白名单、执行毕业建池、复投与销毁、提取协议收入 —— 都由 2-of-3 多签钱包执行,需要任意两名签署人分别签名,单个私钥无法动用资金。
管理权限在合约部署时即写入多签,部署钱包不保留任何角色。关键合约具备暂停能力;发现高危问题时相关资金入口会被直接关闭,修复、重新部署并完成只读核验后才重新开启。
收款地址变更与容差收紧等参数调整设有时间锁,公告等待期后才能生效。
$preMIRROR 与积分
MIRROR 是 Robinhood 链首个股票模因币发行平台。$preMIRROR 为官方创世通行证,已在 PONS 平台发射交易,合约地址:0x211c44e16928d46853356dd4b3448467a9f19959。
代币后续将迁移至 Mirror 官方平台:2 枚 $preMIRROR 合成 1 枚正式平台代币 $MIRROR,资产与市值将会 100% 守恒迁移。
$MIRROR 总量 10 亿:50% 归 PONS 创世通行证合成,40% 归平台交易积分兑换,10% 为主场初始流动性(协议拥有,永不抛售)。
100% 纯社区:0 团队预留、0 预售、0 私募、0 机构、0 增发、0 创作者税。
赛季积分记录你的参与度,将在赛季结束后按占比兑换为空投。积分本身不是代币,也不能转让。
KOL 与社区传播任务在大喇叭页面提交,人工审核,结果通过通知中心告知。
风险揭示
参与前必须读完的部分。
地板价不等于保本:金库持有的股票代币价格下跌时地板价同步下跌,极端情况下模因币市场价可跌破地板价。
退出受限:曲线阶段没有卖出与退款入口;封盘至建池完成期间资金由合约托管,不可撤回。
流动性与滑点:池子深度有限,大额交易会显著移动价格;毕业初期深度最薄。
合约与预言机风险:合约已审计;审计不等于零风险,价格来源与跨合约组合路径仍存在被利用的可能。
合规风险:地域限制与监管口径可能变化,服务范围可能随之调整。
合约地址
链上是唯一事实来源。我们的接口不在信任路径里,需要可靠数据时请直接索引合约,不要依赖我们的服务。
系统由一组各司其职的小合约组成:发射曲线是认购与毕业的入口,其余合约要么按标的创建,要么是全局单例。
- 发射曲线
- 全部标的的认购定价与结算入口,持有募集资金,执行封盘与毕业。
- 模因币工厂
- 按标的铸造固定供给的 ERC-20 模因币,供给一次铸足、不可增发。
- 预检闸门
- 资金动作前的资格校验、审批与留痕;不持有资金、不参与定价。主网资格校验已内嵌于发射曲线,此闸门为可选组件,当前未部署。
- 池子工厂
- 毕业时委托两个部署器,在同一笔交易内原子创建闪兑池与交易池。
- 闪兑池部署器
- 创建股票代币 ⇄ 模因币的闪兑池并注入初始储备。
- 交易池部署器
- 创建 USDG ⇄ 模因币的二级交易池,写入三层费率分配。
- 预路由路由器
- 让用户只用 USDG 参与发射:同笔交易内换成股票代币再进入曲线。
- 手续费复投器
- 多签指定金额采购股票代币并注入闪兑池储备;合约不留存余额,无取回出口。
- 多签金库
- 全部合约的管理权持有者,2-of-3 签名(三名签署人,任意两名即可);部署钱包不保留任何角色。
- Uniswap v4 PoolManager
- 官方部署的池子核算层,不属于我们的自有合约。
- Uniswap v4 Quoter
- 官方部署的报价合约,页面与 SDK 的报价来源之一。
- USDG(结算稳定币)
- 认购与二级交易的计价资产,6 位小数。
版本定义
V1 = 下表这 7 个业务合约的当前主网部署(chain id 4663,部署区块 26026682,送审源码快照提交号 19b6a43c)。审计报告引用的版本号即此定义,地址与字节码哈希一经公示不再变更;整套合约的升级方式是整套替换,不是就地升级。
前端与链下服务另按应用构建号迭代(当前 app-2026-09-22)。应用构建变化只影响页面与索引服务,不改动 V1 合约,也不改变任何链上参数。
已部署地址
主网当前运行在 Robinhood Chain ,chain id 4663。每个标的自己的模因币、闪兑池与交易池由工厂按标的创建,请从曲线与工厂解析,不要硬编码。
治理与外部依赖
一整套合约互相绑定,升级方式是整套替换而不是就地升级。早期套件上的标的仍留在它发射时的那套合约上,因此判断一个标的属于哪一套要去查,而不是假定;从错误的曲线读参与量只会返回零,不会报错,很容易被忽略。
旧套件已由多签暂停,仅保留退款通道。当前生效套件的管理权在部署时即写入多签,装配完成后经过链上只读核验。
读取链上状态
标的阶段、累计入金、剩余额度、单钱包已认购量、毕业门槛与容差、费率、池内双边储备,全部可从合约直接读取。页面展示的每个数字都来自这些读数。
读不到链上数据时页面会明确标注为不可用,而不是回退到估算值。缓存只用于降低读取压力,过期数据会标注为陈旧。
读取标的配置、进度与毕业容差
一个标的的全部关键状态来自三处读数:静态配置、动态数据、以及全局的毕业容差。容差有待生效提案时,毕业仍按当前已生效值执行。
import { createPublicClient, http, parseAbi } from "viem";
const client = createPublicClient({ transport: http(RPC_URL) });
const curveAbi = parseAbi([
"function launchConfigs(bytes32) view returns (address stockToken,address memeToken,uint256 graduationThreshold,uint256 virtualStockReserve,uint256 maxPerWalletBps,uint64 deadline,uint256 requiredPoolBReserve)",
"function launchData(bytes32) view returns (uint8 state,uint256 realStockReserve,uint256 memeSold,uint256 k,uint64 createdAt,uint64 graduatedAt)",
"function getGraduationProgress(bytes32) view returns (uint256)",
"function stockNeededToGraduate(bytes32) view returns (uint256)",
"function graduationToleranceBps() view returns (uint16)",
"function pendingTolerance() view returns (uint16 newBps,uint64 effectiveAt,address proposer,bool exists)",
]);
const [config, data, progressBps, stockNeeded, toleranceBps, pending] =
await Promise.all([
client.readContract({ address: LAUNCH_CURVE, abi: curveAbi, functionName: "launchConfigs", args: [launchId] }),
client.readContract({ address: LAUNCH_CURVE, abi: curveAbi, functionName: "launchData", args: [launchId] }),
client.readContract({ address: LAUNCH_CURVE, abi: curveAbi, functionName: "getGraduationProgress", args: [launchId] }),
client.readContract({ address: LAUNCH_CURVE, abi: curveAbi, functionName: "stockNeededToGraduate", args: [launchId] }),
client.readContract({ address: LAUNCH_CURVE, abi: curveAbi, functionName: "graduationToleranceBps" }),
client.readContract({ address: LAUNCH_CURVE, abi: curveAbi, functionName: "pendingTolerance" }),
]);
// 注意:股票代币是 18 位小数;只有结算稳定币 USDG 是 6 位小数。
// pending.exists 为真时只是公告中的待生效值,毕业仍用 toleranceBps。报价与下单
报价一律调用合约的报价函数(兑换报价、做市报价、总费率),不要用前端公式或历史费率自算。费率可由治理调整,硬编码会在调整后立刻失真。
曲线认购要先读剩余额度:超过剩余额度的下单会整笔回滚。二级交易与闪兑要设置滑点保护,毕业初期尤其必要。
曲线期报价:先判断额度是否够
带明细的报价会同时告诉你是否受剩余供给限制、以及还剩多少。受限时不要按报价下单,应把下单量改成剩余量,否则整笔回滚。
const curveAbi = parseAbi([
"function quoteBuyDetailed(bytes32 launchId,uint256 stockAmount) view returns (uint256 memeOut,bool supplyLimited,uint256 remainingSupply)",
"function getRemainingWalletCap(bytes32,address) view returns (uint256)",
]);
const [memeOut, supplyLimited, remainingSupply] = await client.readContract({
address: LAUNCH_CURVE,
abi: curveAbi,
functionName: "quoteBuyDetailed",
args: [launchId, stockAmount],
});
if (supplyLimited) {
// 剩余供给不足:把下单量降到 remainingSupply 对应的额度,不要照原量提交
}
// 单钱包上限也要读:白名单阶段还要额外用 quotaFor 校验档位与证明
const walletLeft = await client.readContract({
address: LAUNCH_CURVE, abi: curveAbi,
functionName: "getRemainingWalletCap", args: [launchId, account],
});二级市场报价:费率必须现读
闪兑池与交易池都自带报价函数,返回值已经扣掉手续费;总费率同样从合约读,不要用前端常量或缓存值,治理调整后常量会立刻失真。
const poolAbi = parseAbi([
// 闪兑池:stockToMeme;交易池:usdToMeme。方向布尔含义不同,不要互抄。
"function quoteSwap(bool direction,uint256 amountIn) view returns (uint256)",
"function totalFeeBps() view returns (uint256)",
]);
const [amountOut, totalFeeBps] = await Promise.all([
client.readContract({ address: POOL, abi: poolAbi, functionName: "quoteSwap", args: [true, amountIn] }),
client.readContract({ address: POOL, abi: poolAbi, functionName: "totalFeeBps" }),
]);
// 滑点保护:按自己的容忍度下限提交,毕业初期建议留足空间
const minOut = (amountOut * 995n) / 1000n; // 0.5%确定性地址与登记
每个标的的两个池子地址在毕业前就可以算出来:池子工厂按登记的 salt 预测地址,登记时同时快照当时的费率。登记完成后再改全局费率,不影响已登记标的,避免参与者在认购期看到的费率与毕业后实际生效的费率不一致。
建池必须在创建标的之后进行,且两侧代币必须与该标的一致,否则调用直接回滚。集成方应以工厂预测出的地址为准,不要自行拼装。
预测池子地址与读取登记费率
池子地址在毕业前即可由工厂预测;登记时会快照费率,之后改全局默认值不影响已登记标的。集成方一律以工厂读数为准。
const [poolA, poolB] = await client.readContract({
address: poolFactory, abi: poolFactoryAbi, functionName: "poolsOf", args: [launchId],
});
// 尚未部署时 poolsOf 返回零地址,用登记数据拿预测地址与当时快照的费率
const registered = await client.readContract({
address: poolFactory, abi: poolFactoryAbi, functionName: "registeredPoolParams", args: [launchId],
});
// registered: [admin, predictedPoolA, predictedPoolB, poolATotalFeeBps, ...]推动停滞的毕业
认购满额即封盘,封盘后由多签在 24 小时内执行毕业并原子建池。毕业记账按声明量进行,实际余额须达到声明量,允许一个很小的容差;余额略有缺口时可由多签补入股票代币储备,补入走独立台账,取消或作废后由多签单独取回,不与用户退款混账。
封盘满 7 天且两个池子仍未部署时,多签可放弃该标的,走既有退款通道;放弃是终态,不能再建池。
极端情况下的应急结算只能由多签发起,执行结果与事件都在链上可核对。
检查毕业缺口与容差
缺口按声明量与容差一起判断:先读还需多少股票代币储备,再读当前容差,两者都要以链上读数为准。
const [needed, toleranceBps, progress] = await Promise.all([
client.readContract({ address: launchCurve, abi: launchCurveAbi, functionName: "stockNeededToGraduate", args: [launchId] }),
client.readContract({ address: launchCurve, abi: launchCurveAbi, functionName: "graduationToleranceBps" }),
client.readContract({ address: launchCurve, abi: launchCurveAbi, functionName: "getGraduationProgress", args: [launchId] }),
]);
// needed === 0n 表示储备已在容差范围内,可由多签执行毕业建池
const canGraduate = needed === 0n;手续费归集与复投
手续费分成按固定比例进入做市、复投与协议三条线。稳定币那条走复投合约买入并注入流动性,模因币那条由多签直接销毁;统计协议销毁量时必须按发起地址是多签来过滤,否则会把用户自发销毁算进来。
复投合约不预先拉取资金:结算时的付款方是多签,预拉取会让授权归零并导致整笔回滚。复投额度以复投事件为准统计,不要用余额差值推算。
统计复投与协议销毁
复投额度按复投事件累计,不要用余额差值推算;协议销毁必须按发起地址是多签来过滤,否则会混入用户自发销毁。
const reinvested = await client.getLogs({
address: feeReinvestor,
event: parseAbiItem(
"event Reinvested(bytes32 launchId, address poolA, uint256 usdIn, uint256 stockOut, uint256 newStockReserve, uint256 newEffectiveStockReserve)"
),
fromBlock, toBlock,
});
const totalUsdIn = reinvested.reduce((a, l) => a + l.args.usdIn!, 0n);
// 协议销毁:只认多签发起、转入零地址的那些
const burns = await client.getLogs({
address: memeToken,
event: parseAbiItem("event Transfer(address indexed from, address indexed to, uint256 value)"),
args: { from: SAFE_ADDRESS, to: "0x0000000000000000000000000000000000000000" },
fromBlock, toBlock,
});常见回滚与处理
曲线认购超过剩余额度:整笔回滚,不做部分成交,请先读剩余额度再下单。白名单阶段超出本档额度同样回滚,需要用正确的证明与档位重试。
收紧毕业容差若直接调用即时接口会回滚,必须走提案并等待时间锁;放宽则即时生效。填写等于当前值时不做任何改动,也不会发出事件。
二级交易滑点不足、报价过期、池子未初始化都会回滚。遇到回滚请重新读一次链上状态再重试,不要重复广播同一笔。
解析自定义错误
合约用自定义错误回滚,先解码再决定提示文案与是否重试;读一次最新链上状态后再重试,不要重复广播同一笔。
import { BaseError, ContractFunctionRevertedError } from "viem";
try {
await client.simulateContract({ address: launchCurve, abi: launchCurveAbi, functionName: "buy", args, account });
} catch (err) {
if (err instanceof BaseError) {
const reverted = err.walk((e) => e instanceof ContractFunctionRevertedError);
if (reverted instanceof ContractFunctionRevertedError) {
const name = reverted.data?.errorName;
// 例:ToleranceDecreaseRequiresTimelock(须走提案)、超额认购整笔回滚(先读剩余额度)
if (name === "ToleranceDecreaseRequiresTimelock") { /* 引导走提案流程 */ }
}
}
throw err;
}第三方聚合器与机器人接入
看盘与追踪可用第三方工具;在第三方完成适配前,买卖请走 Mirror 官网。
行情与数据
Robinhood Chain 主网(Chain ID 4663)已被 GMGN、Ave.ai 等多链行情平台收录。Mirror 标的的 K 线、持仓分布与流动性等公开链上数据可以在这些平台查看与追踪。
为什么第三方一键交易可能失败
Mirror 的交易池是定制合约,每笔成交都会在链上按规则分配手续费(50% 做市份额、15% 金库加厚地板、35% 协议留存)。第三方聚合器或交易机器人若按通用池子的方式调用,未针对 Mirror 做适配,交易可能被合约拒绝并回滚。这不是代币无法卖出,而是调用方式不匹配。
无论从哪个入口成交,手续费都由合约在链上收取与分配,不因入口不同而改变。
推荐交易方式
普通用户请在 Mirror 官网(mirror.top)的交易页面买卖。请核对代币合约地址与合约公示页一致,谨防仿冒代币。
开发者:直接调用交易池
每个标的的交易池合约自带公开的 swap 函数,做市团队与交易机器人可以直接调用,不必经过 Uniswap V4 的路由。调用前先对交易池合约授权输入代币,并用 quoteSwap 读取报价、按你的滑点容忍度设置 minAmountOut;实际成交少于 minAmountOut 时整笔回滚。
费率、报价与储备一律实时读链,不要硬编码。交易池地址以合约公示页为准;池子暂停时所有入口都会拒绝交易。
const poolAbi = parseAbi([
"function quoteSwap(bool usdToMeme, uint256 amountIn) view returns (uint256)",
"function swap(bool usdToMeme, uint256 amountIn, uint256 minAmountOut) returns (uint256)",
"function USD_TOKEN_ADDRESS() view returns (address)",
]);
// 用 10 USDG 买入模因币(USDG 为 6 位小数)
const amountIn = 10_000_000n;
const usdg = await client.readContract({ address: POOL_B, abi: poolAbi, functionName: "USD_TOKEN_ADDRESS" });
await wallet.writeContract({ address: usdg, abi: erc20Abi, functionName: "approve", args: [POOL_B, amountIn] });
const quoted = await client.readContract({ address: POOL_B, abi: poolAbi, functionName: "quoteSwap", args: [true, amountIn] });
const minAmountOut = (quoted * 9_900n) / 10_000n; // 1% 滑点容忍
await wallet.writeContract({ address: POOL_B, abi: poolAbi, functionName: "swap", args: [true, amountIn, minAmountOut] });聚合器:Uniswap V4 路由参数
交易池同时挂在 Uniswap V4 上,Hook 地址就是交易池合约本身。PoolKey 请直接从交易池合约的 poolKey() 读取,不要自行拼装。
目前 V4 路径只支持精确输入(指定支付数量);精确输出(指定获得数量)的调用会失败。V4 路径尚未经过第三方路由器的实盘测试,接入前请先联系我们联调。
const key = await client.readContract({
address: POOL_B,
abi: parseAbi([
"function poolKey() view returns (address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks)",
]),
functionName: "poolKey",
});
// key.hooks === POOL_B;只使用 exact input(amountSpecified < 0)技术对接
欢迎聚合器、链上交易终端、交易机器人与做市团队接入。请发邮件至 contact@mirror.top,标题注明「技术对接」,我们会提供接口说明、ABI 与测试协助。
事件与索引
成交、认购、毕业、复投、销毁与治理提案都有对应链上事件。K 线与成交列表来自这些事件的自建索引缓存;读不到时不会伪造数据,窗口内无成交的统计(如 24 小时涨跌)会显示为空。
代付场景下,本金账本按受益地址记账,并单独发出代付留痕事件,索引方应以受益地址为口径统计参与量。
治理公告可订阅容差收紧提案事件,其中带有生效时间与发起人,可直接用于生成 24 小时倒计时。
订阅容差收紧提案,生成 24 小时倒计时
收紧毕业容差必须先提案、等满时间锁才能生效。提案事件里带有生效时间与发起人,直接拿来做倒计时即可;取消与最终生效各有独立事件。
const events = parseAbi([
"event GraduationToleranceDecreaseProposed(uint16 newBps,uint64 effectiveAt,address proposer)",
"event GraduationToleranceDecreaseApplied(uint16 newBps)",
"event GraduationToleranceDecreaseCancelled(uint16 newBps)",
"event GraduationToleranceRaised(uint16 oldBps,uint16 newBps)",
]);
client.watchEvent({
address: LAUNCH_CURVE,
events,
onLogs: (logs) => {
for (const log of logs) {
if (log.eventName === "GraduationToleranceDecreaseProposed") {
// effectiveAt 是秒级 UTC 时间戳,倒计时到点后任何地址都可触发生效
showCountdown(Number(log.args.effectiveAt) * 1000);
}
}
},
});统计参与量:按受益地址,不按付款地址
代付买入时付款方与受益人不同。本金账本按受益地址记账,并另外发出一条代付留痕事件;索引方若按付款地址统计,会把代付计到错误的人头上。
const events = parseAbi([
"event MemeMinted(bytes32 indexed launchId,address indexed buyer,uint256 stockIn,uint256 memeOut)",
"event PurchasePaidOnBehalf(bytes32 indexed launchId,address indexed payer,address indexed recipient,uint256 stockAmount)",
]);
// 参与量以 recipient / buyer(受益地址)为键累加;
// PurchasePaidOnBehalf 只用于展示"由谁代付",不要再重复累加一次本金。通知
通知中心会推送:认购意向状态变化、标的提名进度、工单回复、大喇叭任务审核结果、标的毕业提醒,以及价格偏离等风险提示。每一类都能在用户中心的偏好里单独关闭。
所有时间戳以 UTC 记录与展示。
审计
Mirror 安全审计进展正式公告。
当前状态:首轮执行代码审计已完成,二轮独立审计进行中
Mirror 协议目前已完成首轮执行代码审计。我们已开始第二阶段,由完全独立的专业安全审计机构进行二轮三方审计。第二阶段的完整审计报告(包含已确认发现与未采纳发现的全部明细)将在审计结束后正式发布于本页面。
采用多阶段的三方并行审计模式系经审慎评估后确定:更多轮、多方持续的安全审计工作,可从差异化视角识别潜在漏洞,同时在 graduation 机制与 fee allocation 等核心模块实施交叉验证,其整体风险覆盖效果显著优于单一深度审计。
关键提示
在进行任何代码集成操作前,请务必完整阅读本公告。
审计流程尚未完结。在正式三方审计报告于本页面发布之前,请将当前 V1 版本视为未经最终审计确认状态。
V1 合约已完成主网部署,合约地址已公布。部分标的发射仅 whitelist 地址具备加注权限。请独立核验全部相关信息,避免基于未经验证的假设作出决策。
安全审计可显著降低风险敞口,但无法彻底消除残余风险。
漏洞报告方式
如发现任何安全相关问题,请通过邮件:contact@mirror.top 以私密方式提交报告,而非进行公开披露,以便项目方优先完成修复。
送审快照与范围
送审以固定提交号的源码快照为准,范围覆盖业务合约、链下服务、数据库权限与定时任务。快照号、合约清单与地址表都在合约公示页列出,可逐项核对。
内部多模型白盒复核
安全审计之前,我们先做逐层白盒复核,包含跨合约与「链上+数据库+定时任务」的组合路径审查 —— 每层单看合规、串起来才出问题的那一类。发现项按等级登记处置并公开处置状态。这不能替代安全审计,我们也不会把它称为审计报告。
怎么自己核对
合约地址、管理权限归属、暂停状态与费率都能在区块浏览器读到;页面报价与费率同样实时读链。两边数字应当一致,不一致请立即联系我们。
支持
提交工单
在支持页面提交工单描述问题,回复会同时出现在工单里与通知中心。资金相关问题请优先走工单,便于留痕。
请一并提供
钱包地址、标的代码、交易哈希、发生时间(UTC)与页面截图。带上交易哈希的问题通常一次就能定位。
我们永远不会索要
任何情况下都不会索要助记词、私钥,也不会要求你签署来源不明的交易。收到此类要求一律是诈骗,请立即停止并告知我们。
