錯誤代碼參考

出錯時，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-HK?ref=CODE` 格式的現行連結。代碼可能屬於一位已不再活躍的合作夥伴。見佣金如何記入。
`AFF_RATE_LIMITED`	短時間內有太多請求打到聯盟端點（HTTP 429）。	等大約一分鐘再試。這個限制保護公開端點免受濫用。

兌換與交易

#兌換與交易

這些訊息會在你兌換或轉移手上的代幣時出現。

訊息	代表甚麼	如何處理
代幣不足	你想發送、兌換或銷毀的代幣數量，多於錢包實際持有的數量。	把數量調低至你實際持有的水平，或檢查你是否選對了代幣。

錢包與轉帳

#錢包與轉帳

這些大多來自錢包本身：錢包未連接、連到錯誤的網絡，或你輸入的地址有誤。

訊息	代表甚麼	如何處理
你在錢包取消了	交易在錢包的批准畫面被拒絕。沒有發送任何東西，也沒有收取任何費用。	準備好批准時再執行一次。
錢包未連接	工具需要已連接的錢包才能簽署。	先連接錢包。見連接你的錢包。
批准用時太耐	錢包提示仍未關閉時，交易已經過期。	再執行一次，並盡快批准。
錢包連錯網絡	錢包設定的網絡與工具預期的不同。	把錢包切換到 Solana 主網，然後重試。
你在錢包警告畫面退出了	你的錢包對交易顯示警告，而你拒絕了。沒有發送任何東西。	閱讀下面的說明。如果以你的設定而言，那個警告看來不對勁，請向支援團隊報告，讓我們檢查工具組裝了甚麼交易。
錢包地址無效	收款人或錢包欄位不是有效的 Solana 地址（大約 32 至 44 個 base58 字元）。	重新貼上完整地址。留意錯字、多餘字元或複製時被截斷。

交易與簽署

#交易與簽署

這些訊息在交易組裝或廣播期間出現：為交易提供資金、連上網絡，或通過工具的檢查時。

餘額與資金

訊息	代表甚麼	如何處理
SOL 不足	錢包不足以支付平台手續費加上這個操作的網絡成本。	為錢包增值後重試。見下面的費用說明。
有帳戶會跌落租金下限	每個 Solana 帳戶都必須保留免租金最低額。可能是餘額不足以達到這個數額，也可能是發送金額會令發送錢包只剩下零碎餘額。	增加 SOL、調低金額，或把發送錢包完全清空。

網絡與 RPC

訊息	代表甚麼	如何處理
交易已過期	交易上鏈前 blockhash 已經過期，通常是因為網絡繁忙。	再執行一次。過期的交易從未上鏈，所以沒有收取任何費用。
連接不到 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`	伺服器無法歸類的意外錯誤。工具會顯示「發生錯誤」。	重試一次。如果再次出現，把確切字句和你當時在做甚麼發給支援團隊。

仍然卡住？

#仍然卡住

應用程式內的訊息永遠是最終依據。如果某個代碼不在此列、字句有出入，或上面的方法解決不了，請以應用程式為準並聯絡我們。把你看到的確切訊息、當時使用的工具，以及出錯前正在做甚麼發給我們。這些資料通常足以讓我們迅速找出問題。