Solana DEX与Phantom钱包交互报0x179d自定义程序错误原因咨询

前端标注的#1 Unknown program instruction是Phantom钱包的通用报错标签，不代表调用了不存在的链上程序，实际报错来自Zeta DEX链上程序（程序ID：Zo1ggzTUKMY5bYnDvT5mtVeZxzf2FaLTbKkmvGUhUQk），核心错误为自定义程序错误0x179d，对应链上日志如下：

Program log: free_supply: 14100789713994
Program log: Custom program error: 0x179d
Program Zo1ggzTUKMY5bYnDvT5mtVeZxzf2FaLTbKkmvGUhUQk consumed 41719 of 1400000 compute units
Program returned error: custom program error: 0x179d

从日志特征看，交易仅消耗了不到3%的计算额度，说明错误触发在程序执行的最早期入口校验阶段，还未进入核心交易逻辑，可能的触发原因包括：

• 接口版本不兼容：你使用的DEX前端、交易脚本或者跨DEX聚合器版本过旧，仍在调用Zeta程序已经废弃的旧版指令，传入的指令标识符不在当前链上程序支持的指令列表内，直接被程序拦截。
• 交易构造不符合规则：构造交易时传入的账户顺序错误、缺少必需的程序派生地址（PDA）、关联代币账户和交易代币不匹配、钱包缺少必要的交易签名，都会在入口校验阶段触发该类错误。
• 供应量校验不通过：日志打印free_supply字段说明程序当时正在校验对应交易标的的可流通/可交易供应量，你提交的交易请求（如下单、提币、添加流动性）涉及的资产数量超过了当前协议可用的空闲供应量，或者超过了协议设置的单用户持仓/交易额度上限。
• 权限校验失败：你当前使用的钱包地址没有对应操作的权限，比如尝试调用仅治理账户可用的指令、或者对应头寸已经被清算/冻结无法发起交易。

内容的提问来源于stack exchange，提问作者Максим Кривенко