# 월렛

<details>

<summary><strong>코코넛 월렛이 일렉트럼 서버와 연결되지 않는 이유는 무엇인가요?</strong></summary>

코코넛 월렛은 Electrum 프로토콜로 서버와 통신합니다.

개인 노드를 사용하기 위해 VPN을 켰다가 끄는 과정에서 기기/앱의 라우팅·DNS 설정이 일시적으로 꼬이거나, VPN 프로필이 부분적으로 남아 연결이 실패하는 경우가 종종 있습니다.

***

#### ✔️ 먼저 확인할 것 (가장 흔한 원인)

* VPN이 완전히 꺼져 있는지 확인해 주세요. (VPN 앱/프로필이 백그라운드에서 트래픽을 계속 처리하는 경우가 있습니다.)
* 다른 VPN/프록시 앱이 동시에 켜져 있지 않은지 확인해 주세요.
* 가능하면 네트워크를 한 번 리셋해 주세요.
  * Wi-Fi 껐다 켜기 / 비행기 모드 10초 켰다 끄기
  * 그래도 안 되면 기기 재부팅

***

#### ✔️ 접속 가이드

* **코코넛 공식 Electrum 서버에 접속하려면 VPN을 끄고 다시 시도해 주세요.**

  (VPN 잔여 설정 때문에 TLS 443 연결이 차단/우회되며 실패할 수 있습니다.)
* **개인 노드에 연결하려면 VPN을 사용해도 괜찮습니다.**

  다만, 노드가 있는 네트워크로 라우팅이 제대로 되고 있는지(사설망/포트/도메인) 먼저 확인해 주세요.

</details>

<details>

<summary><strong>해외에서 코코넛 일렉트럼 서버와 연결되지 않는 경우가 있어요. 왜 그런가요?</strong></summary>

해외(또는 특정 네트워크 환경)에서는 로밍·현지 통신사·공용 Wi-Fi의 보안 정책(캡티브 포털, 프록시, 방화벽, 포트 제한 등) 때문에 Electrum 연결이 차단될 수 있습니다. 특히 호텔/회사 Wi-Fi처럼 웹(HTTP/HTTPS) 트래픽만 허용하거나, 보안 장비가 TLS 트래픽을 검사하는 환경에서 자주 발생합니다.

***

#### **✔️ 해결 방법**

* (1) **캡티브 포털 확인**: Wi-Fi 연결 후 브라우저로 아무 사이트나 열어 로그인/약관 동의가 필요한지 확인

  VPN 사용 중이면 끄거나/켜서 다시 시도
* (2) **네트워크 변경**: 다른 Wi-Fi 또는 모바일 데이터로 변경
* (3) **VPN/보안 필터 점검**: VPN·광고차단 DNS·보안 앱 사용 중이면 잠시 끄고 재시도
* (4) **우회 접속**: VPN을 사용하여 한국에서 접속하도록 우회
* (5) **개인 노드 사용**: 개인 일렉트럼 서버가 있다면 VPN과 일렉트럼 서버 등록하여 사용

</details>

<details>

<summary><strong>새로운 트랜잭션이 보이지 않아요.</strong></summary>

코코넛 월렛은 **마지막으로 사용한 주소 기준 20개까지만** 미리 스캔합니다.

이것을 **갭 리밋(gap limit)**&#xC774;라고 합니다.

그래서 **사용하지 않은 주소를 너무 많이 건너뛰어 입금**하면, 새 트랜잭션이 보이지 않을 수 있어요.

***

#### **✔️ 해결 방법**

**기존에 쓰던 주소를 순서대로 다시 사용**하세요. 누락된 주소가 갭 리밋 안으로 들어오면서 잔액이 정상 표시됩니다.

***

#### **✔️ 참고**

갭 리밋을 크게 늘릴 수도 있지만, 그러면 **동기화가 느려지고 리소스가 낭비**되는 단점이 있어 권장 사항대로 현재 20개로 유지하고 있습니다.

더 나은 방식을 도입하기 위해 장기적으로 검토 중입니다.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tutorial.coconut.onl/faq/wallet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
