# Bungee集成目标到账量不符：核V3输出模式、费用与Refuel

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/bungee-v3-exact-output-refuel-quote-diagnosis
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用已有请求和报价材料排查EXPECTED_OUTPUT与EXACT_OUTPUT、路由资格、净金额和目的Gas；保留官方条件与Schema冲突。

## 使用工具
- [Bungee](https://lianxiaozhi.com/tools/bungee) · [官方入口](https://www.bungee.exchange/)

## 前置条件
- 准备已有脱敏请求、报价与可选到账记录；保留版本、链ID、token地址、小数位、金额原单位和时间。

## 1. 定位原Bungee集成版本与Socket端点

准备原请求及响应的脱敏副本，先辨旧/api/v1/bungee/quote、requestHash与新/v3/swap/quote、quoteId。V3返回routes数组，不能继续从autoRoute/manualRoute/depositRoute旧容器取字段。记录源/目的链ID、两端token地址、userAddress与receiverAddress；相同symbol不能替代链上地址。

当前Access页区分public-backend.socket.tech（无鉴权、共享限流测试）、backend.socket.tech（域名白名单、affiliate）及dedicated-backend.socket.tech（API key、affiliate）。迁移页简写backend、集成示例用dedicated、Reference server用public；按原集成许可辨认，不能换host后假定权限等价。对错误材料保留server-req-id，隐藏key和身份信息。

核对结果：版本、原端点、权限类型和链/token/接收人均有记录；缺失明确未知。
依据：[Socket：Bungee v1到Socket V3迁移](https://docs.socket.tech/integrate/migration-guide.md)
依据：[Socket：三个端点的权限与请求编号](https://docs.socket.tech/integrate/get-api-access.md)
依据：[Socket：当前V3集成、筛选与费用方法](https://docs.socket.tech/integrate/integration-guides/socket-api.md)
依据：[Socket：V3报价参数及响应示例](https://docs.socket.tech/api-reference/swap/get-quotes.md)

## 2. 分清固定输入、预计输出与精确输出

按原quoteType分三类：EXACT_INPUT默认固定inputAmount；EXPECTED_OUTPUT以outputAmount为目标、所需输入是估计；EXACT_OUTPUT在合格路线中求解目标outputAmount所需输入。不能把EXPECTED_OUTPUT或MIN_INPUT排序标签解释为最终到账保证。

outputAmount以目的token最小单位填写。官方示例100000000若对应decimals=6才是100个token；按原token decimals还原，不能借同名代币或美元价格推小数位。HyperCore origin的inputAmount另允许十进制字符串，不把这个输入特例推广到所有输出。

输出专题明确outputAmount必填且省略inputAmount，Reference却把inputAmount统一标required=true；保留这项条件/Schema差异。响应没有echo的quoteType、原请求或小数位时，不自行补默认输出模式，也不声称冲突已在端点消除。

核对结果：原模式、输入/输出单位及条件必填冲突分开；预计值未变成实际值。
依据：[Socket：预期输出与精确输出](https://docs.socket.tech/about/features/exact-output.md)
依据：[Socket：V3报价参数及响应示例](https://docs.socket.tech/api-reference/swap/get-quotes.md)
依据：[Socket：当前V3集成、筛选与费用方法](https://docs.socket.tech/integrate/integration-guides/socket-api.md)

## 3. 核输出模式的路由资格和无报价分支

输出模式仅支持合格direct tx provider，不套deposit或cex-withdraw；也不兼容Incognito。当前集成指南同时说simulatedQuotesRequired不适用于输出报价类型；不要为精确输出强行叠加隐私或模拟开关。

对原includeProvider/excludeProvider逐项核对：同链代表DEX ID，跨链代表公开bridge ID，两个列表不能重叠。includeQuoteRejections=true的Reference范围为跨链tx无路线时逐provider理由，不保证每个产品、模式和错误都有理由。

只对原返回的拒绝信息分类。空routes或未返回rejections不等于余额为零、被制裁、所有桥停用或金额一定低于某美元门槛；缺provider/请求/错误正文就留未知，不能把评论中的错误枚举冒充本次结果。

核对结果：userOp、模式兼容、provider筛选与原拒绝信息对应；没有理由不补原因。
依据：[Socket：预期输出与精确输出](https://docs.socket.tech/about/features/exact-output.md)
依据：[Socket：V3报价参数及响应示例](https://docs.socket.tech/api-reference/swap/get-quotes.md)
依据：[Socket：当前V3集成、筛选与费用方法](https://docs.socket.tech/integrate/integration-guides/socket-api.md)

## 4. 核净输出、集成费用与目的Gas诉求

原feeBps与feeTakerAddress必须成对，feeBps单位为基点，指南允许0到10000；100bps才等于1%。指南说用户输出已扣费用，纯桥无swap路线在输入侧取费；不要看到费用字段就从净输出再扣一次，也不要把美元估值当代币数量。

refuel参数必须恰为true或false，作用是让合格路线同时提供目的链原生Gas。官方Refuel说明未给每链统一美元量或保证下一笔动作所需Gas；保存原请求开关、目的链与已有Gas材料，不能由请求true推出实际已补足，更不能将评论建议的1–2美元当官方定额。

平台不另收费与链上执行有成本可以同时成立。对原报价费用、gasFee和输出单位分别记账；缺目的Gas或费用明细就明确未核，不由一个输出金额推导所有成本为零或失败可全退。

核对结果：净额与收费侧、基点单位、Refuel请求与实际Gas材料分别记录。
依据：[Socket：当前V3集成、筛选与费用方法](https://docs.socket.tech/integrate/integration-guides/socket-api.md)
依据：[Socket：V3报价参数及响应示例](https://docs.socket.tech/api-reference/swap/get-quotes.md)
依据：[Socket：目的链Gas Refuel用途](https://docs.socket.tech/about/features/refuel.md)
依据：[Socket：平台费用与集成方收费](https://docs.socket.tech/about/fees-monetization.md)

## 5. 核原路线有效期和金额证据

在原响应按quoteId定位同一条route，保留expiresAt；指南要求丢弃过期报价。MIN_INPUT用于匹配路线按更小输入排序，MAX_OUTPUT/FASTEST/SUGGESTED也只是标签，不能混用不同quoteId的金额、费用和有效期。

Reference中的普通同链示例同时列output.token.decimals、amount与minAmountOut，它不是EXACT_OUTPUT专用成功样本。原记录如有这些字段，按各自字段和单位保留；不能把普通示例的minAmountOut当每个输出模式恒定公式，或把已过期预估直接当实际到账。

最后对照已有实际结果与目的token、接收人和金额；只有报价或没有结果材料时，结论停在“模式/路线/费用文档已核，实际到账未确认”。保留原请求编号和未决字段供排查，不据此重建calldata或断言精确输出已完成。

核对结果：同一quoteId、有效期、报价金额与实际结果证据分开；缺结果未记成功。
依据：[Socket：当前V3集成、筛选与费用方法](https://docs.socket.tech/integrate/integration-guides/socket-api.md)
依据：[Socket：V3报价参数及响应示例](https://docs.socket.tech/api-reference/swap/get-quotes.md)
依据：[Socket：三个端点的权限与请求编号](https://docs.socket.tech/integrate/get-api-access.md)

## 常见错误
- EXPECTED_OUTPUT是预计输入，MIN_INPUT是排序标签，均不替代到账证明。
- Socket V3的输出能力不自动等于当前Bungee客户端按钮；未知版本、字段与权限不可套用。
- refuel=true表达请求；净输出、目的Gas与最终到账分别核，不把空报价当明确拒绝理由。

## 完成检查
- 得到原集成版本、输出目标、路由资格、净费用及Gas材料对照；官方方法已核，实际账户、报价与到账结果依原记录确认。

## 相关知识

## 官方依据
- [Socket：Bungee v1到Socket V3迁移](https://docs.socket.tech/integrate/migration-guide.md)
- [Socket：三个端点的权限与请求编号](https://docs.socket.tech/integrate/get-api-access.md)
- [Socket：预期输出与精确输出](https://docs.socket.tech/about/features/exact-output.md)
- [Socket：V3报价参数及响应示例](https://docs.socket.tech/api-reference/swap/get-quotes.md)
- [Socket：当前V3集成、筛选与费用方法](https://docs.socket.tech/integrate/integration-guides/socket-api.md)
- [Socket：目的链Gas Refuel用途](https://docs.socket.tech/about/features/refuel.md)
- [Socket：平台费用与集成方收费](https://docs.socket.tech/about/fees-monetization.md)