Titan：核Portal报价map的推荐路由、指令身份与错误层
链小知 · 进阶 · 核验 · 依官方文档整理
从官方示例或已有脱敏报价建立provider→venue→指令映射，避免取最大outAmount、误读空steps或混用凭据与交易版本。
开始前准备
- 准备Portal官方Quote Swap/Info/Errors方法及已有脱敏请求、响应和header；无真实响应时仅完成文档示例映射。
- 不申请key、不请求quote/info/providers/venues，不组装或签名交易；保留原响应时间和环境。
1. 辨认Portal、分销商与响应编码
Portal host为portal.api.titan.exchange、组织key走x-api-key；分销商host及JWT另由provider提供，凭据不可互换。官方门户默认MessagePack；Accept: application/json时pubkey为base58、instruction data为base64。
检查已有样例host/Accept及返回编码，只记录凭据类型，不保存key。Direct WebSocket为Enterprise范围，不能把门户REST教程套成流式免费接口。
检查结果：能明确host、凭据类别与编码；缺header/host保留未知。
2. 核mints、amount和钱包参数的作用
请求必有inputMint、outputMint、amount(u64最小单位)、userPublicKey；amount=1000000000在官方wSOL→USDC示例为1 SOL。请求整数已是最小单位，不再乘decimals；输出按metadata的mint decimals格式化。
userPublicKey是指令针对的签名/执行钱包及token accounts，不是随意查询地址。只核样例地址，不建立钱包或发送。具体ONyc资格/可路由状态不能从9月26日报道代填。
检查结果：记录请求echo、最小单位与用户钱包用途，mint未知不按ticker猜。
3. 区分provider ID、venue label与pool地址过滤
quotes map键、ExpectedWinner及providers过滤用provider id；官方providers例为Titan和Titan-DART，display name可以不同。dexes/excludeDexes用venue label；venueAllowlist/Banlist用pool pubkey，Banlist覆盖Allowlist。
已有venues响应的labels[i]与programIds[i]仅同一响应位置对应，下次顺序不稳定。未知dexes label会找不到路由404 -7而非一定400；当前有效目录未取到就不声称指定池已启用。
检查结果：provider/label/pool三层身份分别映射，没有复用旧位置或猜测有效标签。
4. 先读推荐赢家再拆路由和指令
quotes是按provider键控的对象，不是数组；默认1个、numQuotes上限10。metadata.ExpectedWinner（也可expectedWinner同值）是滑点调整后的推荐，不能仅sort outAmount替代；推荐键缺失时保持未知。
route.steps为空可因provider直接fill，不直接判无路由；有hop时allocPpb为十亿分比，1000000000为整单，拆分份额须保留结构。instruction短字段p=program、a=有序账户及s/w、d=数据；检查已有ComputeBudget指令后才判断重复，本文不组装。
检查结果：推荐provider能对应map成员，空steps原因有限解释，保留指令/账户顺序与编码。
5. 将过期与预检范围写入记录
contextSlot、expiresAtMs/ expiresAfterSlot是不同字段，provider设过期才有hard expiry；缺字段不当永不过期。titanSwapVersion默认3，transactionFormat默认0(V0)；选择1需cluster支持及V3，不能因V3 swap默认推断V1交易可用。
simulate默认true只是报价预检；maxPriceDeviationBps默认1000，>=10000关闭检查且参考价缺失fail open。outAmount是滑点前预期值，steps.feeMint/feeAmount仅when reported。缺fee字段不是免费，预检也不是确认成交。
检查结果：分别记录报价状态、program/transaction版本及缺费用/参考价未知；未把预期数当到账。
6. 按错误层与共享额度完成问题记录
错误体区分平台error.code、edge Missing Authentication Token、参数plain text和engine code；403该文字是未知path/method，勿一律归因key。404 -7读quoteId.tag及metadata.errors，缺provider errors可为验证先失败；保留x-amzn-requestid和quote响应id用于定位。
429 rate_limited按retry-after等待；allowance_exhausted重试无效。官方每请求当前1credit且状态不影响计费，组织所有key/region共享滚动60秒；月额自购买日起而非日历月。不发请求即可按已有脱敏回执分类。
检查结果：输出能区分路由不可建、参数、凭据、限额与月额，并保留可定位的脱敏ID。
怎样确认完成
- 形成provider、venue、pool、指令与时点的一份报价记录。
- 结果属于规格/历史回执核验，未证明当前任何指定资产可成交。
常见错误与边界
- 把ONyc发行方capital reserve/资格写成Titan自身保证。
- 把ExpectedWinner当最大outAmount，或空steps当失败。
- HTTP403 Missing Authentication Token不一定凭据问题；allowance耗尽不靠重试恢复。