Tham khảo mã lỗi

Khi có lỗi, J Tools hiện một tiêu đề ngắn, kèm một dòng cho biết chuyện gì đã xảy ra và nên làm gì tiếp. Đằng sau mỗi thông báo là một mã lỗi, ví dụ AFF_WITHDRAW_MIN hoặc VALIDATION_ERROR, là thứ phản hồi API mang theo và bộ phận hỗ trợ dùng để truy vết. Trang này giải thích những lỗi bạn dễ gặp nhất và cách xử lý từng lỗi.

Mã lỗi affiliate có tiền tố AFF_ và nằm trong phần Chương trình affiliate. Còn lại là thông báo của công cụ hoặc giao dịch, xếp theo nơi phát sinh: Swap và giao dịch, Ví và chuyển tiền, Giao dịch và ký, và Chung và khác. Nếu bạn chỉ thấy một thông báo thường không kèm mã, phần “Vấn đề thường gặp” trên trang của chính công cụ đó thường cũng có hướng dẫn.

J Tools không lưu giữ tài sản, nên mọi thứ bắt đầu trong ví của bạn cũng kết thúc trong ví của bạn. Không có gì di chuyển cho tới khi bạn ký.

Chương trình affiliate

#chuong-trinh-affiliate

Các mã này xuất hiện quanh bảng điều khiển affiliate: khi đăng ký, yêu cầu rút tiền hoặc được ghi nhận hoa hồng từ lượt giới thiệu.

Tài khoản và quyền truy cập

Mã	Ý nghĩa	Cách xử lý
AFF_NOT_FOUND	Không có tài khoản affiliate nào gắn với ví này.	Đăng ký làm đối tác trước, hoặc kết nối lại đúng ví sở hữu tài khoản đối tác. Xem Cách chương trình affiliate hoạt động.
AFF_BANNED	Tài khoản đối tác đang bị tạm ngưng, nên không vào được bảng điều khiển. Cửa sổ đăng nhập báo tài khoản đang bị tạm ngưng; các yêu cầu khác trả về “Access denied.”	Liên hệ hỗ trợ. Đối tác bị tạm ngưng không dùng được bảng điều khiển, không yêu cầu rút tiền được và không nhận thêm hoa hồng mới.
AFF_ALREADY_REGISTERED	Ví này đã là đối tác rồi.	Đăng nhập bằng ví hiện có thay vì đăng ký lại.
AFF_WALLET_REQUIRED	Thiếu địa chỉ ví, hoặc địa chỉ không phải địa chỉ Solana hợp lệ.	Kết nối ví, hoặc nhập một địa chỉ Solana hợp lệ (khoảng 32 đến 44 ký tự base58).
AFF_TERMS_REQUIRED	Yêu cầu đăng ký được gửi mà chưa chấp nhận điều khoản affiliate hiện hành.	Đánh dấu ô điều khoản trong cửa sổ đăng ký, rồi đăng ký lại.

Rút tiền

Mã	Ý nghĩa	Cách xử lý
AFF_WITHDRAW_MIN	Số tiền thấp hơn mức rút tối thiểu.	Yêu cầu ít nhất bằng mức tối thiểu hiện trong bảng điều khiển. Xem Rút tiền.
AFF_WITHDRAW_MAX	Số tiền lớn hơn số dư khả dụng.	Giảm xuống bằng số dư có thể rút hiện tại, hoặc chờ thêm hoa hồng được xác nhận.
AFF_SOCIAL_REQUIRED	Chưa có link mạng xã hội nào đã xác minh, trong khi rút tiền cần ít nhất một link.	Thêm một link trong Cài đặt, chờ đội ngũ của chúng tôi xác minh, rồi thử lại.
AFF_WITHDRAW_PENDING	Bạn đang có một yêu cầu rút tiền chờ xử lý.	Chờ tới khi yêu cầu đó được thanh toán hoặc bị từ chối. Mỗi lúc chỉ có một yêu cầu được mở.
AFF_WITHDRAW_REJECTED	Quản trị viên đã từ chối yêu cầu mà không ghi lý do. Bảng điều khiển hiện yêu cầu là bị từ chối, không kèm lý do, và số tiền đã quay về số dư của bạn.	Liên hệ hỗ trợ để biết chi tiết, rồi gửi yêu cầu rút tiền mới.

Ghi nhận người giới thiệu

Mã	Ý nghĩa	Cách xử lý
AFF_REF_INVALID	Mã giới thiệu sai định dạng, hoặc không có đối tác nào đang hoạt động sở hữu mã này.	Dùng một link hiện hành có dạng https://j.tools/vi?ref=CODE. Mã có thể thuộc về một đối tác không còn hoạt động. Xem Cách ghi nhận hoa hồng hoạt động.
AFF_RATE_LIMITED	Có quá nhiều yêu cầu gửi tới các endpoint affiliate trong thời gian ngắn (HTTP 429).	Chờ khoảng một phút rồi thử lại. Giới hạn này giúp các endpoint công khai tránh bị lạm dụng.

Thận trọng

Hoa hồng giới thiệu được gắn với một ví vào lần đầu tiên ví đó trả phí nền tảng trong lúc mã link của một đối tác đang được lưu trên trình duyệt (mã được giữ trong 7 ngày), và chỉ thuộc về đối tác đầu tiên đó. Ví đã trả phí trước khi mở link của bất kỳ ai sẽ chưa được ghi nhận cho tới khi một giao dịch trả phí sau đó mang theo mã. Hãy đọc Cách ghi nhận hoa hồng hoạt động trước khi chờ hoa hồng.

Swap và giao dịch

#swap-va-giao-dich

Các lỗi này xuất hiện khi bạn swap hoặc chuyển một token đang giữ.

Thông báo	Ý nghĩa	Cách xử lý
Không đủ token	Bạn đang cố gửi, swap hoặc đốt nhiều token hơn số ví đang giữ.	Giảm số lượng xuống bằng số bạn thực sự có, hoặc kiểm tra xem đã chọn đúng token chưa.

Ví và chuyển tiền

#vi-va-chuyen-tien

Phần lớn các lỗi này đến từ chính ví: ví chưa kết nối, đang trỏ sai cluster, hoặc địa chỉ bạn nhập bị sai.

Thông báo	Ý nghĩa	Cách xử lý
Bạn đã hủy trong ví	Giao dịch bị từ chối trên màn hình duyệt của ví. Không có gì được gửi đi và không bị trừ tiền.	Chạy lại khi bạn sẵn sàng duyệt.
Chưa kết nối ví	Công cụ cần một ví đã kết nối thì mới ký được.	Kết nối ví trước. Xem Kết nối ví của bạn.
Bước duyệt kéo dài quá lâu	Giao dịch đã hết hạn trong lúc cửa sổ duyệt của ví vẫn đang mở.	Chạy lại và duyệt ngay, đừng để lâu.
Ví đang ở sai mạng	Ví đang đặt ở một cluster khác với cluster công cụ cần.	Chuyển ví sang Solana mainnet, rồi thử lại.
Bạn đã lùi lại ở một cảnh báo của ví	Ví hiện cảnh báo cho giao dịch và bạn đã từ chối. Không có gì được gửi đi.	Đọc ghi chú bên dưới. Nếu cảnh báo có vẻ không khớp với những gì bạn đã thiết lập, hãy báo cho bộ phận hỗ trợ để chúng tôi kiểm tra giao dịch mà công cụ đã dựng.
Địa chỉ ví không hợp lệ	Ô người nhận hoặc ô ví không chứa địa chỉ Solana hợp lệ (khoảng 32 đến 44 ký tự base58).	Dán lại toàn bộ địa chỉ. Chú ý lỗi gõ, ký tự thừa hoặc địa chỉ bị cắt mất khi sao chép.

Ghi chú

Về cảnh báo của ví. Một số công cụ gom nhiều lệnh vào một giao dịch, ví dụ tạo token và metadata cùng lúc. Phantom có thể hiện dải cảnh báo cho những giao dịch này. Nếu công cụ đã báo trước là sẽ có cảnh báo thì điều đó không có nghĩa là có gì sai. Hãy đọc kỹ nội dung bạn sắp ký, rồi duyệt nếu nó khớp với những gì bạn đã thiết lập. Nếu hiện ra một cảnh báo mà công cụ không hề nhắc tới, hãy từ chối và báo cho bộ phận hỗ trợ.

Giao dịch và ký

#giao-dich-va-ky

Các lỗi này xuất hiện khi giao dịch đang được dựng hoặc gửi đi: lúc nạp tiền cho giao dịch, lúc kết nối tới mạng, hoặc lúc qua các bước kiểm tra của công cụ.

Số dư và tiền

Thông báo	Ý nghĩa	Cách xử lý
Không đủ SOL	Ví không đủ tiền để trả phí nền tảng cộng chi phí mạng của thao tác này.	Nạp thêm vào ví, rồi thử lại. Xem lưu ý về phí bên dưới.
Một tài khoản sẽ tụt xuống dưới mức rent tối thiểu	Mọi tài khoản Solana đều phải giữ mức rent tối thiểu. Hoặc là số dư không đủ mức đó, hoặc là số lượng bạn nhập sẽ để lại một khoản bụi trong ví gửi.	Thêm SOL, giảm số lượng, hoặc rút sạch hoàn toàn ví gửi.

Thận trọng

Về phí. Mỗi thao tác có hai khoản chi phí: phí mạng Solana trả cho validator, và phí nền tảng J Tools. Phí nền tảng luôn hiện trong ứng dụng trước khi bạn xác nhận, và không có khoản nào bị trừ cho đến khi bạn ký. Mức phí có thể thay đổi theo thời gian, nên hãy tin phần tóm tắt trong ứng dụng hơn là một con số bạn từng thấy trước đây.

Mạng và RPC

Thông báo	Ý nghĩa	Cách xử lý
Giao dịch đã hết hạn	Blockhash đã quá hạn trước khi giao dịch vào block, thường do mạng đông.	Chạy lại. Giao dịch hết hạn chưa bao giờ vào block, nên không bị trừ tiền.
Không kết nối được mạng Solana	Endpoint RPC không phản hồi.	Chờ khoảng 30 giây rồi thử lại. Nếu vẫn lặp lại, hãy thử một kết nối mạng khác (ví dụ tắt VPN quá chặt).
Quá nhiều yêu cầu	Nhà cung cấp RPC hoặc một endpoint dùng chung nhận quá nhiều lệnh gọi trong thời gian ngắn (HTTP 429).	Chờ vài giây rồi thử lại.
Không có xác nhận nào về kịp	Giao dịch đã được gửi, nhưng công cụ đã ngừng chờ kết quả. Giao dịch có thể vẫn đã vào block.	Kiểm tra ví hoặc trình khám phá blockchain trước khi gửi lại, để không chạy hai lần.

Kiểm tra dữ liệu nhập

Thông báo	Ý nghĩa	Cách xử lý
Địa chỉ mint đó không hợp lệ	Địa chỉ token sai định dạng, hoặc không trỏ tới một mint token.	Chọn token bằng bộ chọn thay vì dán địa chỉ.
Còn ô bắt buộc đang trống	Biểu mẫu còn thiếu thông tin mà lượt chạy này cần.	Điền các ô được đánh dấu rồi gửi lại.
Số lượng không hợp lệ	Số lượng bằng 0, là số âm hoặc không phải là số.	Nhập số lượng lớn hơn 0. Nếu công cụ hiện giới hạn cạnh ô nhập, hãy nhập trong giới hạn đó.
Please check your input and try again	Một bước kiểm tra phía máy chủ đã từ chối dữ liệu nhập, và phản hồi cố ý giữ chi tiết chung chung để an toàn.	Xem lại các ô đã nhập. Nếu không thấy gì sai, tải lại trang và nhập lại.

Chung và khác

#chung-va-khac

Một vài phản hồi API mang một mã chuỗi ngắn thay vì một thông báo theo chủ đề. Các mã này cố ý chung chung để không làm lộ chi tiết máy chủ.

Mã	Ý nghĩa	Cách xử lý
VALIDATION_ERROR	Một hoặc nhiều dữ liệu nhập không qua bước kiểm tra phía máy chủ. Công cụ hiện lỗi này là “Còn ô bắt buộc đang trống”.	Sửa các ô được đánh dấu rồi gửi lại. Cách xử lý giống các thông báo kiểm tra dữ liệu ở trên.
RATE_LIMITED	Bạn đã chạm giới hạn yêu cầu trên một endpoint dùng chung (HTTP 429). Công cụ hiện lỗi này là “Quá nhiều yêu cầu”.	Chờ một chút rồi thử lại.
UNAUTHORIZED	Phiên đăng nhập bị thiếu hoặc đã hết hạn.	Đăng nhập hoặc kết nối lại, rồi làm lại thao tác.
NOT_FOUND	Thứ bạn yêu cầu không có sẵn, hoặc chưa từng tồn tại.	Kiểm tra lại link hoặc mã định danh bạn đã dùng.
GENERIC_ERROR	Lỗi bất ngờ mà máy chủ không phân loại được. Công cụ hiện “Đã có gì đó không ổn”.	Thử lại một lần. Nếu vẫn lặp lại, gửi cho bộ phận hỗ trợ đúng nguyên văn thông báo và việc bạn đang làm.

Vẫn chưa xử lý được?

#van-chua-xu-ly-duoc

Thông báo trong ứng dụng luôn là nguồn chính xác nhất. Nếu một mã không có ở đây, nội dung thông báo khác, hoặc cách xử lý ở trên không hiệu quả, hãy làm theo ứng dụng và liên hệ với chúng tôi. Gửi cho chúng tôi nguyên văn thông báo bạn thấy, công cụ bạn đang dùng và việc bạn làm ngay trước đó. Thường chừng đó là đủ để chúng tôi tìm ra vấn đề nhanh chóng.

• Hỗ trợ Cách liên hệ đội ngũ J Tools, cần gửi kèm những gì để vấn đề được xử lý nhanh, và những thông tin bạn không bao giờ được đưa cho bất kỳ ai tự xưng là hỗ trợ.
• Biểu phí Mọi khoản phí nền tảng của J Tools trong một bảng, theo công cụ và danh mục, cùng điểm khác nhau giữa phí mạng Solana, khoản rent đặt cọc và phí J Tools thu.

Mẹo

J Tools không lưu giữ tài sản. Chúng tôi không bao giờ lưu trữ private key của ví bạn và không bao giờ hỏi seed phrase. Mỗi giao dịch bạn duyệt trong một ví đã kết nối đều được ký ngay trong ví đó, và key của ví không bao giờ tới máy chủ của chúng tôi. Một vài công cụ đa ví cho phép bạn dán private key của các ví nóng dùng một lần; các key này nằm lại trong tab trình duyệt của bạn và ký ngay tại đó. Tăng số lượng holder là công cụ duy nhất giao một key cho worker của chúng tôi: đó là ví phân phối mới mà công cụ tạo cho mỗi lượt chạy, được mã hóa trước khi gửi đi. Đừng bao giờ dán key gắn với tài sản bạn giữ lâu dài, và nếu có trang nào hỏi seed phrase của bạn, hãy dừng lại và đóng trang đó.