Pagu.info 마스코트 Pagu.info 디파이 정보 홈

Uniswap V3 LP를 공식 사이트 없이 출금하는 절차

계약 주소와 필수 확인 사항을 먼저 읽고 순서대로 확인합니다.

핵심 · 총 4단계입니다. 실행 전 주소·단위 확인을 마치세요.

V3의 LP 포지션은 NFT입니다. 회수는 두 번에 나뉩니다 — decreaseLiquidity로 유동성을 풀고, collect로 토큰을 받아옵니다. 두 번 다 해야 합니다.

← 풀 추적으로 공식 사이트

01

먼저 읽어 주세요

쓰기 함수를 부르기 전에 꼭 지켜야 하는 주의입니다.

이 페이지는 설명서일 뿐입니다. Pagu.info는 지갑을 연결하지 않고, 서명이나 거래를 만들지도 않습니다. 아래 절차는 사용자가 Etherscan에서 직접 수행합니다.

  • 주소를 눈으로 믿지 마세요. 각 주소 옆에 "읽기 전용으로 확인하는 방법"을 적어 뒀습니다. 먼저 그 확인을 통과한 뒤에 쓰기 함수를 부르세요. 비슷한 주소로 만든 가짜 컨트랙트가 있습니다.
  • 서두르지 마세요. 프론트엔드가 멈춰도 자금은 컨트랙트에 그대로 있습니다. 프론트는 창구일 뿐입니다. 먼저 공식 트위터·디스코드에서 알려진 사고인지 확인하는 편이 거의 항상 낫습니다.
  • 이 문서는 투자 조언이 아니고, 결과를 보장하지 않습니다. 금액과 단위를 잘못 넣어 생긴 손실은 되돌릴 수 없습니다.

02

컨트랙트 주소

쓰기 전에 "확인 방법"의 읽기 함수를 먼저 불러 보세요.

2곳

컨트랙트 주소

5체인

네트워크

4단계

빼는 절차

이름체인주소확인 방법
Position Manager Ethereum · Arbitrum · Polygon · OP Mainnet 0xC36442b4a4522E871399CD717aBDD847Ab11FE88 symbol() → UNI-V3-POS, factory() → 0x1F98431c8aD98523631AE4a59f267346ea31F984. 네 체인 모두 확인했다.
Position Manager Base 0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1 Base는 주소가 다르다. symbol() → UNI-V3-POS, factory() → 0x33128a8fC17869897dcE68Ed026d694621f6FDfD. 확인했다.
다른 체인·포크의 주소 찾는 법

다른 체인(BSC·Avalanche 등)이나 Uniswap 포크(PancakeSwap 등)는 주소가 또 다릅니다. 확실한 찾는 법: Etherscan에서 내 지갑 → NFT 목록을 보면 내 포지션 NFT가 있고, 그 NFT의 컨트랙트 주소가 내가 써야 할 Position Manager입니다. symbol()이 UNI-V3-POS인지 확인하세요.

03

빼는 절차

번호 순서대로 진행합니다.

Fig. 1

한눈에 보는 순서

  1. 1tokenId 찾기
  2. 2decreaseLiquidity
  3. 3collect
  4. 4NFT 정리
총 4단계입니다. 실행 전 주소·단위 확인을 마치세요.

1내 포지션 번호(tokenId)를 찾는다

Etherscan에서 내 지갑 주소를 열고 NFT Transfers 또는 NFT 목록에서 Uniswap V3 Positions 항목을 찾습니다. 거기 적힌 숫자가 tokenId입니다.

Position Manager → Read Contract → positions(tokenId)로 확인합니다. token0·token1·fee·liquidity· tokensOwed0·tokensOwed1이 나옵니다.

읽은 값을 어디에 쓰는지

liquidity가 0이 아니면 아직 풀 안에 돈이 있다는 뜻입니다. 이 값을 적어 두세요 — 다음 단계에서 씁니다.

2decreaseLiquidity로 유동성을 푼다

Write Contract → decreaseLiquidity. 이 함수는 값을 한 묶음(튜플)으로 받습니다. Etherscan은 칸을 하나씩 보여주거나 (a,b,c,d,e) 형태로 한 줄에 받습니다. 순서는 아래와 같습니다.

  • tokenId — 1단계에서 찾은 번호
  • liquidity — positions에서 읽은 liquidity 값 (전량 회수)
  • amount0Min, amount1Min — 최소 수령량. 둘 다 0으로 두면 가장 단순합니다. 내 포지션 하나를 줄이는 것뿐이라 다른 사람이 끼어들어 손해를 입히기 어려워, 여기서는 0이 일반적입니다.
  • deadline — 이 시각(Unix 초)까지만 유효. 지금 시각 + 1200(20분) 정도로 넉넉히 넣습니다. 과거 시각을 넣으면 무조건 실패합니다. 현재 Unix 시각은 Etherscan 블록 화면이나 검색으로 확인할 수 있습니다.

이 함수는 토큰을 내 지갑으로 보내지 않습니다. 포지션 안에 "받을 돈"으로 적어 둘 뿐입니다. 그래서 다음 단계가 꼭 필요합니다.

3collect로 실제로 받아온다

Write Contract → collect. 역시 튜플입니다.

  • tokenId — 같은 번호
  • recipient — 받을 주소 (내 지갑)
  • amount0Max, amount1Max — 받을 상한. 전액을 받으려면 둘 다 340282366920938463463374607431768211455(uint128 최대값)를 넣습니다.
수수료만 거둘 때

여기서 그동안 쌓인 수수료까지 함께 나옵니다. 2단계를 건너뛰고 collect만 부르면 수수료만 받고 원금은 그대로 남습니다 — 수수료만 거둘 때는 그렇게 쓰면 됩니다.

4확인하고, 원하면 NFT를 정리한다

positions(tokenId)를 다시 읽어 liquidity와 tokensOwed0/1이 모두 0인지 봅니다. 0이면 회수가 끝났습니다.

빈 NFT 정리

빈 NFT는 그냥 둬도 아무 문제가 없습니다. 지우고 싶으면 burn(tokenId)를 부를 수 있지만, 세 값이 모두 0이 아니면 되돌려집니다.

04

Etherscan에서 함수를 부르는 법 (공통)

어느 설명서에서 부르든 같은 다섯 단계입니다.

0을 하나 더 붙이거나 덜 붙이는 것이 이 작업에서 가장 흔한 사고입니다. 먼저 아주 작은 금액으로 한 번 성공시킨 다음 전액을 처리하는 편이 안전합니다.

다섯 단계 전부 보기

1맞는 탐색기를 연다

체인마다 탐색기가 다릅니다. Ethereum은 etherscan.io, Arbitrum은 arbiscan.io, Base는 basescan.org, Polygon은 polygonscan.com, OP Mainnet은 optimistic.etherscan.io입니다. 주소창에 컨트랙트 주소를 붙여넣습니다.

2먼저 Read로 진짜인지 확인한다

Contract → Read Contract(프록시면 Read as Proxy)에서 아래 표의 "확인 방법"에 적힌 읽기 함수를 불러 봅니다. 기대한 값이 나오지 않으면 그 주소는 쓰지 않습니다. 읽기는 가스가 들지 않고 위험도 없습니다.

3Write Contract로 넘어간다

Contract → Write Contract를 누르고 Connect to Web3로 지갑을 연결합니다. 연결은 Etherscan에서 하는 것이고 Pagu.info와는 아무 상관이 없습니다. 화면에 Write as Proxy 탭이 있으면 그쪽을 써야 합니다 — 프록시로 배포된 컨트랙트는 일반 Write 탭에 실제 함수가 보이지 않습니다. 이 문서에서 Aave V3 Pool과 Lido 출금 큐가 프록시임을 직접 확인했습니다.

4금액은 소수점 자리만큼 0을 붙인다

컨트랙트는 소수점을 모릅니다. 토큰의 decimals()만큼 0을 붙인 정수를 넣습니다.

  • USDC·USDT (6자리): 100 USDC → 100000000
  • DAI·WETH·stETH 등 (18자리): 1개 → 1000000000000000000
  • WBTC (8자리): 0.5개 → 50000000

자리수를 모르면 그 토큰 컨트랙트의 decimals()를 Read로 먼저 확인하세요. 0을 하나 더 붙이거나 덜 붙이는 것이 이 작업에서 가장 흔한 사고입니다. 먼저 아주 작은 금액으로 한 번 성공시킨 다음 전액을 처리하는 편이 안전합니다.

5"전액"에 쓰는 숫자

프로토콜에 따라 특정 최대값이 "전액"을 뜻합니다.

  • uint256 최대값: 115792089237316195423570985008687907853269984665640564039457584007913129639935
  • uint128 최대값: 340282366920938463463374607431768211455

단, 아무 함수에나 최대값을 넣으면 되는 것은 아닙니다. 각 설명서에서 허용한다고 적은 곳에만 씁니다.

온체인 확인 이 페이지의 주소는 2026-10-13에 공개 RPC로 직접 호출해 확인했습니다. 주소에 코드가 있는지만 본 것이 아니라, 각 컨트랙트가 서로를 가리키는지(예: aToken이 그 Pool을 가리키는지)까지 맞춰 봤습니다. 그래도 쓰기 전에 각자 Read로 다시 확인하세요. 컨트랙트는 교체될 수 있습니다.