오류 코드 참고
작업이 실패하면 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 주소(base58 문자 대략 32자에서 44자)를 입력하세요. |
AFF_TERMS_REQUIRED | 현재 제휴 이용약관에 동의하지 않은 채 가입 요청이 전송되었습니다. | 가입 창에서 약관 체크박스를 선택한 뒤 다시 가입하세요. |
출금
| 코드 | 의미 | 해결 방법 |
|---|---|---|
AFF_WITHDRAW_MIN | 금액이 최소 출금 금액보다 적습니다. | 패널에 표시된 최소 금액 이상으로 요청하세요. 출금을 참고하세요. |
AFF_WITHDRAW_MAX | 금액이 출금 가능 잔액보다 많습니다. | 현재 출금 가능 잔액에 맞게 줄이거나, 확인된 커미션이 더 쌓일 때까지 기다리세요. |
AFF_SOCIAL_REQUIRED | 인증된 소셜 링크가 없습니다. 출금하려면 적어도 하나가 필요합니다. | 설정에서 링크를 추가하고, 저희 팀의 인증을 기다린 뒤 다시 시도하세요. |
AFF_WITHDRAW_PENDING | 이미 대기 중인 출금 요청이 있습니다. | 그 요청이 지급되거나 거부될 때까지 기다리세요. 진행 중인 요청은 한 번에 하나만 가능합니다. |
AFF_WITHDRAW_REJECTED | 관리자가 사유를 기록하지 않고 요청을 거절했습니다. 패널에는 사유 없이 거절된 요청으로 표시되며, 금액은 잔액으로 돌아와 있습니다. | 지원팀에 자세한 내용을 문의한 뒤 새로 출금을 요청하세요. |
추천 연결
| 코드 | 의미 | 해결 방법 |
|---|---|---|
AFF_REF_INVALID | 추천 코드 형식이 잘못되었거나, 그 코드를 가진 활성 파트너가 없습니다. | https://j.tools/ko?ref=CODE 형식의 현재 링크를 사용하세요. 더 이상 활동하지 않는 파트너의 코드일 수 있습니다. 적립 방식을 참고하세요. |
AFF_RATE_LIMITED | 짧은 시간에 제휴 엔드포인트로 요청이 너무 많이 들어왔습니다(HTTP 429). | 1분 정도 기다린 뒤 다시 시도하세요. 이 제한은 공개 엔드포인트를 악용으로부터 보호합니다. |
스왑 및 거래
#스왑-및-거래보유한 토큰을 스왑하거나 옮길 때 나타나는 메시지입니다.
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| 토큰이 충분하지 않습니다. | 지갑에 있는 것보다 많은 토큰을 보내거나, 스왑하거나, 소각하려고 했습니다. | 실제 보유량에 맞게 수량을 줄이거나, 토큰을 제대로 골랐는지 확인하세요. |
지갑 및 전송
#지갑-및-전송대부분 지갑 자체에서 생기는 문제입니다. 지갑이 연결되지 않았거나, 다른 클러스터를 가리키고 있거나, 입력한 주소가 잘못된 경우입니다.
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| 지갑에서 취소했습니다. | 지갑의 승인 화면에서 트랜잭션을 거절했습니다. 아무것도 전송되지 않았고 청구된 비용도 없습니다. | 승인할 준비가 되면 다시 실행하세요. |
| 지갑이 연결되지 않았습니다 | 도구가 서명하려면 지갑이 연결되어 있어야 합니다. | 먼저 지갑을 연결하세요. 지갑 연결을 참고하세요. |
| 승인에 시간이 너무 오래 걸림 | 지갑 승인 창이 열려 있는 동안 트랜잭션이 만료되었습니다. | 다시 실행하고, 오래 멈추지 말고 승인하세요. |
| 지갑이 잘못된 네트워크에 있습니다. | 지갑이 도구가 기대하는 것과 다른 클러스터로 설정되어 있습니다. | 지갑을 Solana 메인넷으로 바꾼 뒤 다시 시도하세요. |
| 지갑에서 탈퇴했다는 경고가 표시됩니다. | 지갑이 트랜잭션에 경고를 표시했고, 그 경고 화면에서 거절했습니다. 아무것도 전송되지 않았습니다. | 아래 안내를 읽어 보세요. 설정한 내용에 비해 경고가 이상해 보였다면, 도구가 만든 트랜잭션을 저희가 확인할 수 있도록 지원팀에 알려 주세요. |
| 잘못된 지갑 주소 | 수신자나 지갑 입력란의 값이 유효한 Solana 주소(base58 문자 대략 32자에서 44자)가 아닙니다. | 전체 주소를 다시 붙여넣으세요. 오타, 불필요한 문자, 잘린 복사본이 없는지 확인하세요. |
트랜잭션 및 서명
#트랜잭션-및-서명트랜잭션을 만들거나 전송하는 단계, 곧 자금을 채우고, 네트워크에 닿고, 도구의 검사를 통과하는 단계에서 나타나는 메시지입니다.
잔액과 자금
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| SOL이 충분하지 않습니다 | 지갑에 이 작업의 플랫폼 수수료와 네트워크 비용을 합한 만큼의 SOL이 없습니다. | 지갑을 충전한 뒤 다시 시도하세요. 아래 수수료 안내를 참고하세요. |
| 계정은 최소 임대료 미만으로 남게 됩니다. | Solana 계정은 모두 임대료 면제 최소 금액을 유지해야 합니다. 잔액이 그 금액에 못 미치거나, 입력한 금액대로 보내면 보내는 지갑에 먼지 같은 소액만 남게 됩니다. | SOL을 추가하거나, 금액을 줄이거나, 보내는 지갑을 완전히 비우세요. |
네트워크 및 RPC
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| 거래가 만료되었습니다. | 트랜잭션이 체결되기 전에 블록해시가 만료되었습니다. 대개 네트워크가 붐빌 때 생깁니다. | 다시 실행하세요. 만료된 트랜잭션은 체결되지 않았으므로 청구된 비용이 없습니다. |
| 솔라나 네트워크에 접속할 수 없습니다 | RPC 엔드포인트가 응답하지 않았습니다. | 30초쯤 기다린 뒤 다시 시도하세요. 계속 반복되면 다른 네트워크 연결로 시도해 보세요(예: 제한이 엄격한 VPN 끄기). |
| 요청이 너무 많습니다. | RPC 제공업체나 공유 엔드포인트에 짧은 시간 동안 호출이 너무 많이 들어왔습니다(HTTP 429). | 몇 초 기다린 뒤 다시 시도하세요. |
| 제 시간에 확인이 도착하지 않았습니다 | 트랜잭션은 전송되었지만 도구가 결과를 더 기다리지 않고 멈췄습니다. 실제로는 체결되었을 수도 있습니다. | 두 번 실행하지 않도록, 다시 보내기 전에 지갑이나 탐색기에서 확인하세요. |
입력값 검사
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| 해당 민트 주소는 유효하지 않습니다. | 토큰 주소 형식이 잘못되었거나, 토큰 민트를 가리키지 않습니다. | 붙여넣지 말고 선택기에서 토큰을 고르세요. |
| 필수 입력란이 비어 있습니다. | 이번 실행에 필요한 항목이 양식에 빠져 있습니다. | 강조 표시된 입력란을 채우고 다시 제출하세요. |
| 잘못된 금액 | 금액이 0이거나, 음수이거나, 숫자가 아닙니다. | 0보다 큰 금액을 입력하세요. 입력란 옆에 한도가 표시되어 있다면 그 안에서 입력하세요. |
| Please check your input and try again | 서버 측 검사가 입력값을 거부했고, 보안을 위해 응답에는 자세한 내용을 담지 않았습니다. | 입력란을 다시 확인하세요. 문제가 없어 보이면 새로고침한 뒤 값을 다시 입력하세요. |
일반 및 기타
#일반-및-기타일부 API 응답은 주제별 메시지 대신 짧은 문자열 코드를 돌려줍니다. 서버 정보가 새어 나가지 않도록 일부러 포괄적으로 만든 코드입니다.
| 코드 | 의미 | 해결 방법 |
|---|---|---|
VALIDATION_ERROR | 입력값 하나 이상이 서버 측 검사를 통과하지 못했습니다. 도구에는 “필수 입력란이 비어 있습니다.”로 표시됩니다. | 강조 표시된 입력란을 고치고 다시 제출하세요. 위의 입력값 검사 메시지와 같은 경우입니다. |
RATE_LIMITED | 공유 엔드포인트의 요청 한도에 도달했습니다(HTTP 429). 도구에는 “요청이 너무 많습니다.”로 표시됩니다. | 잠시 기다린 뒤 다시 시도하세요. |
UNAUTHORIZED | 세션이 없거나 만료되었습니다. | 로그인하거나 다시 연결한 뒤 작업을 반복하세요. |
NOT_FOUND | 요청한 항목을 사용할 수 없거나 원래 존재하지 않습니다. | 사용한 링크나 식별자를 다시 확인하세요. |
GENERIC_ERROR | 서버가 분류하지 못한 예기치 않은 오류입니다. 도구에는 “문제가 발생했습니다.”로 표시됩니다. | 한 번 다시 시도하세요. 또 나타나면 정확한 문구와 하던 작업을 지원팀에 보내 주세요. |
그래도 해결되지 않나요?
#그래도-해결되지-않나요기준은 언제나 앱에 표시된 메시지입니다. 여기에 없는 코드이거나, 문구가 다르거나, 위 방법으로 해결되지 않았다면 앱의 안내를 따르고 저희에게 연락하세요. 본 메시지 그대로, 사용하던 도구, 직전에 하던 작업을 보내 주시면 대개 빠르게 원인을 찾을 수 있습니다.
© 2026 J Tools