LayerZero Bridge 완벽 가이드

(TGE 따리)

스캐너에서 직접 브릿지를 실행하는 방법

⚠️

신규 토큰 상장 시 DEX 사전 판매 및 수동 브릿지가 필요한 경우가 있습니다

🐦 @BufferSloth

유용한 크립토 정보를 계속 공유할 예정입니다. 팔로우 부탁드립니다 🙏

브릿지란 무엇인가?

📊 DEX 사전 판매

업비트, 빗썸 등 중앙화 거래소(CEX) 상장 전, 토큰은 먼저 탈중앙화 거래소(DEX)에서 거래됩니다.

🌉 크로스체인 브릿지

서로 다른 블록체인 네트워크 간 자산을 이동시키는 기술입니다. LayerZero는 이를 안전하게 처리합니다.

🔧 수동 브릿지

일부 토큰은 자동 브릿지를 지원하지 않아, 사용자가 직접 스캐너에서 컨트랙트를 실행해야 합니다.

🚀 브릿지 실행 전 준비사항

✅ 필수 체크리스트

  • MetaMask 등 Web3 지갑 준비
  • 충분한 네이티브 토큰 보유 (ETH, BNB 등 가스비용)
  • 브릿지할 토큰 보유
  • 올바른 네트워크 선택

🔍 컨트랙트 주소 찾기

💡

OFT 컨트랙트 주소 찾는 방법

업비트/빗썸 상장 공지가 나오면 토큰 이름과 티커를 확인할 수 있습니다:

  1. 상장 공지에서 토큰 이름/티커 확인 (예: MAGIC, ARB)
  2. CoinGecko 또는 CoinMarketCap 접속
  3. 토큰 검색 → "Contract" 또는 "Explorers" 섹션
  4. 해당 네트워크의 컨트랙트 주소 복사
💡 Pro Tip: 대부분의 LayerZero OFT 토큰은 메인 토큰 컨트랙트와 동일합니다!

🌐 체인별 Endpoint ID

🔷 Ethereum: 30101
🟡 BSC: 30102
🟣 Polygon: 30109
🔵 Arbitrum: 30110
🔴 Optimism: 30111
🔺 Avalanche: 30106

📚 더 많은 체인 ID는 LayerZero 공식 문서에서 확인하세요

📋 단계별 브릿지 실행 가이드

Step 1

스캐너 접속 및 컨트랙트 찾기

1. 해당 체인의 스캐너 사이트 접속

🔷 Etherscan (Ethereum) 🟡 BscScan (BSC) 🟣 PolygonScan 🔵 Arbiscan

2. 검색창에 OFT 컨트랙트 주소 입력

0x1234567890abcdef1234567890abcdef12345678
Step 2

Contract 탭 찾기

토큰 컨트랙트 페이지에서 여러 탭이 보입니다:

Transfers
Holders
Info
Contract ✅
Analytics

Contract 탭을 클릭하세요!

Step 3

브릿지 수수료 이해하기

💰 권장 수수료 값 (대부분의 경우 작동)

일반적인 브릿지 수수료:

  • Ethereum → 타 체인: 0.005 ~ 0.01 ETH
  • BSC → 타 체인: 0.01 ~ 0.02 BNB
  • Arbitrum/Optimism → 타 체인: 0.001 ~ 0.003 ETH
  • Polygon → 타 체인: 1 ~ 3 MATIC

🎯 실전 팁: 넉넉하게 설정하기

예시: 0.01 ETH (대부분의 경우 충분)

  • nativeFee: 10000000000000000 (Wei)
  • payableAmount: 0.01 (ETH)

💡 초과 수수료는 _refundAddress로 자동 환불됩니다!

고급: quoteSend()로 정확한 수수료 조회하기 (선택사항)

정확한 수수료를 알고 싶다면 Read Contract 탭에서 quoteSend() 함수를 사용할 수 있습니다:

1. Code
2. Read Contract ✅
3. Write Contract

📊 quoteSend() 함수 실행

24. quoteSend (0x2f603ae24)

⚠️ 중요: Etherscan에서 tuple 입력 방법

  1. Etherscan에서는 tuple을 한번에 입력할 수 없습니다
  2. _sendParam 옆의 화살표(▶)를 클릭하면 7개의 개별 입력 필드가 나타납니다
  3. 각 필드에 아래 값들을 하나씩 복사해서 입력하세요

각 필드에 입력할 값들:

dstEid: 30110 (Arbitrum 예시)

to: 0x000000000000000000000000[본인지갑주소_0x제외] ⚠️ 본인 주소로 변경 필요! (0x와 [ ] 제거하고 앞에 24개의 0 추가)

amountLD: 1000000000000000000 (1 토큰)

minAmountLD: 950000000000000000 (0.95 토큰)

extraOptions: 0x

composeMsg: 0x

oftCmd: 0x

⚠️ 주의: to 주소는 일반 주소에서 0x를 제거하고 앞에 24개의 0을 추가한 형식입니다!
← 대부분 false 입력
결과값:
msgFee tuple: [
  nativeFee: 157890868107790 ← 이 값을 복사!
  lzTokenFee: 0
]
⚠️ 이 nativeFee 값을 Step 5에서 사용합니다.
Step 4

Write Contract 선택 및 지갑 연결

이제 Write Contract 탭으로 이동합니다:

1. Code
2. Read Contract
3. Write Contract ✅

Write Contract 페이지 상단의 버튼을 클릭:

💡 연결 성공 시 버튼이 지갑 주소로 변경됩니다
예: Connected: 0xC0F9...3421
Step 5

send() 함수 찾기 및 파라미터 입력

함수 목록을 스크롤하여 send 함수를 찾습니다:

1. approve(address,uint256)
2. decreaseAllowance(address,uint256)
4. send((uint32,bytes32,uint256,uint256,bytes,bytes,bytes), (uint256,uint256), address) ✅
5. sendFrom(address,uint16,bytes32,uint256,address)

send 함수 옆의 화살표(▶)를 클릭하면 입력 필드가 나타납니다:

▼ 6. send (0xc7c7f5b3)

Execute the send operation.MessagingReceipt. LayerZero msg receipt → guid: The unique identifier for the sent message. → nonce: The nonce of the sent message. → fee: The LayerZero fee incurred for the message.

📝 send 파라미터 입력

← nativeFee를 ETH 단위로! (Wei ÷ 10^18)

The parameters for the send operation.

← 대상 체인 ID (예: Arbitrum = 30110)
← 받는 주소 (0x와 [ ] 제거하고 앞에 24개의 0 추가)

예: 본인 주소가 0xc0f93ba136e8cec236711b397cd4f8b274803421이면
→ 0x000000000000000000000000c0f93ba136e8cec236711b397cd4f8b274803421

← 보낼 토큰 양 (Wei 단위, 1토큰 = 10^18 Wei)
← 최소 수신량 (슬리피지 보호, 보통 95%)
← 추가 옵션 (보통 0x 입력)
← 컴포즈 메시지 (보통 0x 입력)
← OFT 명령어 (보통 0x 입력)

The calculated fee for the send() operation. - nativeFee: The native fee. - lzTokenFee: The lzToken fee.

← ⚠️ Step 3의 quoteSend 결과값을 여기 입력!
← LayerZero 토큰 수수료 (보통 0)

The address to receive any excess funds.

← ⚠️ 본인 지갑 주소 입력 (0x 포함, 초과 수수료 환불 받을 주소)
⚠️ payableAmount를 반드시 입력하세요! 이것을 빼먹으면 트랜잭션이 실패합니다.
Step 6

트랜잭션 실행 및 확인

모든 값을 입력했다면 Write 버튼을 클릭합니다.

  1. MetaMask 팝업에서 트랜잭션 확인
  2. 가스비와 payableAmount가 포함된 총 비용 확인
  3. Confirm 클릭하여 트랜잭션 실행
💡 트랜잭션이 완료되면 LayerZero Scan에서 브릿지 상태를 확인할 수 있습니다:
https://layerzeroscan.com/tx/[YOUR_TX_HASH]

🛠️ 유용한 변환 도구

주소 변환기 (Address → bytes32)

Wei 변환기 (Token → Wei)

⚠️ 자주하는 실수들

❌
quoteSend 안하고 send 실행

반드시 수수료를 먼저 조회하세요

❌
payableAmount 빼먹기

맨 아래 payableAmount 필드 필수!

❌
Wei와 Ether 단위 혼동

nativeFee는 Wei, payableAmount는 Ether

❌
잘못된 주소 형식

to는 bytes32, refundAddress는 address

자주 묻는 질문 (FAQ)

Q: 왜 일부 토큰은 수동 브릿지가 필요한가요?

A: 모든 토큰이 자동 브릿지 UI를 제공하지 않습니다. 특히 신규 상장 토큰이나 소규모 프로젝트는 사용자가 직접 컨트랙트를 실행해야 합니다.

Q: nativeFee는 어떻게 계산하나요?

A: 반드시 quoteSend() 또는 estimateFee() 함수를 먼저 실행하여 정확한 수수료를 조회해야 합니다. 이 값은 네트워크 상황에 따라 변동됩니다.

Q: 브릿지가 실패하면 어떻게 되나요?

A: 트랜잭션이 실패하면 토큰은 원래 지갑으로 돌아옵니다. 단, 가스비는 소모됩니다. refundAddress로 초과 수수료가 환불됩니다.

Q: 브릿지 시간은 얼마나 걸리나요?

A: 체인과 네트워크 상황에 따라 1-30분 정도 소요됩니다. LayerZero Scan에서 실시간 상태를 확인할 수 있습니다.

Q: extraOptions는 언제 사용하나요?

A: 대부분의 경우 0x로 충분합니다. 특별한 가스 설정이나 고급 기능이 필요한 경우에만 사용합니다.

Q: 어느 체인을 지원하나요?

A: LayerZero는 Ethereum, BSC, Avalanche, Polygon, Arbitrum, Optimism 등 40개 이상의 체인을 지원합니다.

주의사항

🔴

반드시 공식 컨트랙트 주소인지 확인하세요

🔴

큰 금액은 먼저 소액으로 테스트하세요

🔴

수수료 계산을 반드시 먼저 실행하세요

🔴

주소 형식을 정확히 입력하세요

🔐 컨트랙트 검증 방법

1
Contract 탭에서 초록색 체크 ✅ 확인

Verified 표시가 있어야 안전한 컨트랙트입니다

2
공식 채널에서 주소 확인

프로젝트 공식 웹사이트, 문서, 트위터에서 컨트랙트 주소 대조

3
CoinGecko/CoinMarketCap에서 확인

토큰 페이지의 Contract 섹션에서 공식 컨트랙트 주소 확인