错误代码参考

出错时，J Tools 会显示一个简短的标题，再用一行说明发生了什么、下一步该怎么做。每条提示背后都有一个代码，例如 AFF_WITHDRAW_MIN 或 VALIDATION_ERROR，API 响应里带的就是它，客服也靠它追查问题。本页解释你最可能遇到的那些，以及每一种该怎么处理。

联盟计划的代码以 AFF_ 开头，列在联盟计划下。其余都是工具或交易的提示，按来源分类：兑换与交易、钱包与转账、交易与签名，以及通用与其他。如果你只看到一条没有代码的普通提示，工具页面上的“常见问题”一节通常也有说明。

J Tools 是非托管的，从你钱包发起的一切，最终都回到你的钱包。你签名之前，任何资产都不会移动。

联盟计划

#联盟计划

这些代码出现在联盟面板相关的操作中：注册、申请提款，或者因推荐获得佣金时。

账户与访问

代码	含义	解决办法
AFF_NOT_FOUND	这个钱包没有关联的联盟账户。	先注册成为合作伙伴，或者重新连接拥有合作伙伴账户的那个钱包。参见联盟计划如何运作。
AFF_BANNED	合作伙伴账户已被暂停，面板对它关闭。登录窗口会提示账户已被暂停；其他请求则返回 “Access denied.”。	联系客服。被暂停的合作伙伴无法使用面板、申请提款，也无法赚取新的佣金。
AFF_ALREADY_REGISTERED	这个钱包已经是合作伙伴。	用现有钱包登录，不要重复注册。
AFF_WALLET_REQUIRED	钱包地址缺失，或者不是有效的 Solana 地址。	连接钱包，或输入有效的 Solana 地址（大约 32 到 44 个 base58 字符）。
AFF_TERMS_REQUIRED	注册请求发出时，没有接受当前的联盟条款。	在注册窗口中勾选条款复选框，然后重新注册。

提款

代码	含义	解决办法
AFF_WITHDRAW_MIN	金额低于最低提款额。	至少申请面板上显示的最低额。参见提款。
AFF_WITHDRAW_MAX	金额超过你的可用余额。	把金额调低到当前可提款的余额以内，或者等更多已确认的佣金到账。
AFF_SOCIAL_REQUIRED	没有已认证的社交链接，而提款至少需要一个。	在“设置”中添加一个链接，等我们团队认证后再重试。
AFF_WITHDRAW_PENDING	你已经有一笔提款申请在等待处理。	等它被打款或被驳回。同一时间只能有一笔未完成的申请。
AFF_WITHDRAW_REJECTED	管理员拒绝了这笔申请，但没有记录原因。面板会显示为已拒绝、无原因，金额已退回你的余额。	联系客服了解详情，然后重新提交提款申请。

推荐归属

代码	含义	解决办法
AFF_REF_INVALID	推荐码格式不对，或者没有活跃的合作伙伴拥有它。	使用形如 https://j.tools/zh-CN?ref=CODE 的最新链接。这个代码可能属于一位已不再活跃的合作伙伴。参见佣金如何归属。
AFF_RATE_LIMITED	短时间内向联盟接口发出的请求太多（HTTP 429）。	等大约一分钟再试。这个限制用来保护公共接口不被滥用。

警告

推荐佣金会绑定到这样一个钱包：它第一次支付平台费用时，浏览器里存着某位合作伙伴的链接代码（代码保存 7 天）；之后它只归这第一位合作伙伴。在任何人的链接被打开之前就付过费的钱包，会一直保持未归属状态，直到之后某笔付费交易带上了代码。在指望拿到佣金之前，请先阅读佣金如何归属。

兑换与交易

#兑换与交易

在兑换或转移你持有的代币时会出现这些提示。

提示	含义	解决办法
代币不足	你要发送、兑换或销毁的代币数量超过了钱包的持有量。	把数量调低到你实际持有的数量，或者检查是否选对了代币。

钱包与转账

#钱包与转账

这些提示大多来自钱包本身：钱包没有连接、指向了错误的集群，或者你输入的地址有误。

提示	含义	解决办法
你在钱包中取消了	交易在钱包的批准界面上被拒绝了。没有发出任何交易，也没有扣任何费用。	准备好批准时再运行一次。
钱包未连接	工具需要先连接钱包才能签名。	先连接钱包。参见连接你的钱包。
批准时间太长	钱包弹窗还开着的时候，交易已经过期。	重新运行，批准时不要停顿太久。
钱包位于错误的网络上	钱包设置的集群和工具预期的不一致。	把钱包切换到 Solana 主网，然后重试。
你退出了钱包警告	钱包对这笔交易显示了警告，而你拒绝了。没有发出任何交易。	阅读下面的说明。如果这个警告与你的设置明显不符，请告诉客服，方便我们检查工具构建的交易。
钱包地址无效	接收者或钱包字段不是有效的 Solana 地址（大约 32 到 44 个 base58 字符）。	重新粘贴完整地址。留意错字、多余字符或复制不完整。

注意

关于钱包警告。 有些工具会把多条指令打包进一笔交易，例如同时创建代币和它的元数据。Phantom 可能会为这类交易显示警示横幅。如果工具事先告诉你会出现横幅，它并不代表出了问题。先读清楚你要签名的内容，与你的设置一致再批准。如果出现了工具没有提到的警告，请拒绝签名并告知客服。

交易与签名

#交易与签名

这些提示出现在交易构建或广播的阶段：为交易准备资金、连接网络，或者通过工具的检查时。

余额与资金

提示	含义	解决办法
不够 SOL	钱包里的 SOL 不够支付这次操作的平台费用加上网络成本。	给钱包充值后重试。参见下方的费用说明。
账户将低于最低租金	每个 Solana 账户都必须保留免租金最低额。要么余额不够这个最低额，要么这个金额会让发送钱包只剩下粉尘。	充值 SOL、调低金额，或者把发送钱包完全清空。

警告

关于费用。 每个操作都有两项成本：支付给验证者的 Solana 网络费，以及 J Tools 平台费用。平台费用总会在你确认前显示在应用里，你签名之前不会扣任何费用。费用可能随时调整，请以应用内的费用摘要为准，不要依赖你以前看到过的某个数字。

网络与 RPC

提示	含义	解决办法
交易已过期	交易落地之前区块哈希已经失效，通常是因为网络繁忙。	重新运行。过期的交易从未落地，所以没有扣任何费用。
Solana 网络无法访问	RPC 端点没有响应。	等大约 30 秒再重试。如果一直这样，换一个网络连接试试（例如关掉严格的 VPN）。
请求太多	RPC 服务商或某个共享接口在短时间内收到了太多调用（HTTP 429）。	等几秒钟再试。
没有及时到达确认	交易已经发出，但工具停止了等待结果。它可能已经落地。	重新发送之前，先在钱包或区块浏览器里查看，免得重复执行。

输入校验

提示	含义	解决办法
该铸币地址地址无效	代币地址格式错误，或者指向的不是代币铸币。	用选择器选择代币，不要手动粘贴。
必填字段为空	表单缺少这次运行需要的内容。	填好高亮标出的字段，再次提交。
金额无效	金额为零、为负数，或者不是数字。	输入大于零的金额。如果工具在字段旁边标出了限额，请在限额范围内填写。
Please check your input and try again	服务器端的检查拒绝了输入，出于安全考虑，回复只给出笼统的说明。	检查各个字段。如果看不出问题，刷新页面后重新输入。

通用与其他

#通用与其他

少数 API 响应返回的是一个简短的字符串代码，而不是具体分类的提示。这些代码故意写得很宽泛，以免泄露服务器细节。

代码	含义	解决办法
VALIDATION_ERROR	一个或多个输入没有通过服务器端检查。工具中显示为“必填字段为空”。	修正高亮标出的字段后重新提交。和上面的输入校验提示是同一类问题。
RATE_LIMITED	你在某个共享接口上触发了请求限制（HTTP 429）。工具中显示为“请求太多”。	稍等一会儿再重试。
UNAUTHORIZED	你的会话不存在或已过期。	登录或重新连接，然后再做一次。
NOT_FOUND	你请求的内容不可用，或者从未存在。	再核对一下你用的链接或标识符。
GENERIC_ERROR	服务器无法归类的意外错误。工具中显示为“出了点问题”。	重试一次。如果还出现，把确切的提示文字和你当时在做的操作发给客服。

还是没解决？

#还是没解决

应用里的提示始终是最准确的依据。如果某个代码这里没有列出、措辞不一样，或者上面的办法没能解决，请以应用为准并联系我们。把你看到的确切提示、当时使用的工具，以及出错前正在做的操作发给我们。通常这些就足够我们快速定位问题。

• 支持 如何联系 J Tools 团队，提交问题时写明哪些信息能更快解决，以及哪些信息绝不能交给自称客服的人。
• 费用表 一张表列出 J Tools 按工具和类别划分的全部平台费用，并说明 Solana 网络费和租金押金与 J Tools 收费有什么不同。

提示

J Tools 是非托管的。 我们从不存储你钱包的私钥，也从不索要你的助记词。你在已连接钱包中批准的每笔交易，都在该钱包内签名，钱包私钥从不会到达我们的服务器。少数多钱包工具允许你粘贴一次性热钱包的私钥，这些私钥只留在你的浏览器标签页中，也在那里签名。持有者增长是唯一会把私钥交给我们后台程序的工具：交出的是它每次运行新建的分发钱包私钥，并且加密发送。切勿粘贴与长期持仓相关的私钥；如果某个页面向你索要助记词，请立即停止并关闭页面。