核对Velora集成费用:容量套餐、分成与待领取余额
链小知 · 进阶 · 核验 · 依官方文档整理
按当前官方资料,把请求容量与交易分成拆开,再核Market/Delta的费用合约、历史累计和领取失败;只形成可审阅的费用核对表。
开始前准备
- 准备所用模式、链和已有脱敏配置或费用记录;无记录时只按文档列待核项
- 确认本人/组织资格与商业条款;本教程不开户、订阅、签名或操作资产
1. 先区分容量套餐、交易模式和商业资格
将材料分成API容量与交易经济两张表。免费partner只是请求中的应用标识,默认1 RPS和每日5000次;付费套餐提高速率、日配额与支持。按持续RPS、burst、每日请求分别核需求,不能用套餐名或日配额代替峰值速率,也不能按交易次数直接计算API调用量。
当前Basic每月500美元、10 RPS、burst 20、每日5万次;Pro每月700美元、20 RPS、每日12万次。只是核对日的标价,订阅与定制商业条款另确认。Market和Delta按所用模式和链分列,Gnosis/Avalanche的当前静态表只列Market。官网条款的资格与限制同样适用于API;本教程只核已有材料。
检查结果:容量单位、模式/链与资格分列;免费标识或付费套餐均未写成已开通交易分成或本人可交易。
2. 只选择一种交易变现模型并核报价净额
partnerFeeBps表示基点,文档例200为2%;应在报价阶段传入,使报价包含该费用。takeSurplus选择盈余分享,两者互斥;若同时提供,partnerFeeBps优先。旧positiveSlippageToUser已弃用,当前isSurplusToUser要求takeSurplus为true。
逐项记录partner、partnerAddress、partnerFeeBps或takeSurplus、isSurplusToUser和模式。partner字符串用于标识集成,不能把任意字符串当已获分成许可。前段规定无partner默认anon的1 bps,末段却概括费用/盈余需partner;在配置核清前保留差异,不能据末段当匿名零费。
检查结果:基点、互斥优先级、报价是否含费及匿名默认已记录;未重复扣费,缺商业配置仍标待核。
3. 按执行路径拆合作方收入与用户盈余
默认partner fee分成中,Delta为100%合作方,Market为85%合作方/15%Velora;盈余分享两者均为50%/50%,可有定制条款。假设已完成交易对应可分配partner fee为100个单位,Market默认合作方85、平台15;这只是分成算例,不是按输入资产总额直接乘,也不是实际收益。
isSurplusToUser把合作方的盈余份额转给终端用户,不是把双方全部盈余都给用户;它在兑换交易中结算,没有额外领取步骤。API容量月费与这张分成表独立,不能付了套餐就删除交易分成或把报价盈余当固定收入。
检查结果:模式、费用资产与分成基数对应;容量账单、合作方收入及用户盈余已分开,算例未当实收。
4. 核费用落在哪个合约、是否仍需领取
Market默认把合作方费累积到Fee Claimer;Delta累积在Delta主合约。两者使用同一个Fee Claimer界面但各自领取、各链分别处理,不能把UI合并当一次全链领取。Market的isDirectFeeTransfer可逐笔直接转给partnerAddress,绕过归集但用户每次多付转费gas;Delta不支持该开关。
在已有脱敏材料中逐项列模式、chainId、fee token、partnerAddress、合约角色和归集/直接转费。领取由匹配partnerAddress的钱包签名,并由领取方付gas;无领取回执就不能标已到账。旧Augustus v6之前费用属于Legacy Claimer,不能套当前余额或合约。
检查结果:链/币种/partnerAddress与Market或Delta合约对应;直接支付、归集和已领取状态没有混用。
5. 将历史累计与待领取余额分开
文档的费用token统计端点列历年累计,包含已领取与未领取。它可提示曾经产生费用的币种,不能直接当当前余额。已有材料应另列当前余额字段、读取链与时间;Market示例getBalance(token,partner),Delta示例getCollectedFees(partner,token),参数顺序也不同。
当前方法每次可领取一个币种的完整归集余额并指定recipient;合作方地址负责签名,recipient只是接收地址。材料缺余额或领取交易状态时保留未知,不将历史统计与累计报价相加得出可提现收入。此处不运行示例或请求端点。
检查结果:历史累计、当前余额、已领取回执及地址角色分别记录;缺余额未当零或可领总额。
6. 把领取失败定位到币种与整笔范围
文档将代币拒绝转账等情况记为TransferFailed();多币种一次领取中,一个币转账失败会让整笔回滚。失败余额仍在对应合约,不应标已损失或已领取。界面把部分币种标Unclaimable并可排除;状态与具体币种必须按已有材料核。
程序方法建议发送前逐币模拟,部分RPC不支持eth_simulateV1时用simulateContract逐币核。模拟成功不是已广播或已到账,模拟失败也不总能单凭错误断言代币冻结。本教程产出容量/分成表与费用状态表;未运行RPC、签名或领取。Delta概览的gasless也不能免除领取方gas,native source的存入交易另有流程。
检查结果:失败币种、整笔回滚范围和未知原因保留;模拟、发送与最终到账状态未混作成功。
怎样确认完成
- 容量和交易费用各有独立单位、模式与限制
- 形成逐链逐币费用状态表,缺项与文档差异明确保留
常见错误与边界
- 把付费吞吐套餐当免交易分成或已获商业资格。
- 把Market和Delta同一领取界面当同一个归集合约。
- 用历史累计端点计算当前待领取余额。
- 把模拟成功、归集或quote当实际领取到账。