브릿지 터널 목록 조회

사용 가능한 브릿지 터널 목록을 조회합니다.

브릿지 터널이란?

브릿지 터널은 어느 플랫폼에서 어느 플랫폼으로 어떤 코인을 보낼 수 있는지를 사전 등록해둔 단위입니다. 옥텟이 미리 검증·승인해놓은 경로만 노출되며, 한 터널은 다음 정보를 묶어서 갖습니다.

1) 라우팅

필드의미
sourcePlatform / destinationPlatform보내는/받는 체인 (예: Ethereum, Arbitrum)
sourceCoin / destinationCoin보내는/받는 코인 (예: USDC)

2) 사용 protocol

bridgeProtocol 필드. 어느 브릿지 서비스를 거쳐 자산을 옮기는지를 의미합니다.
예: CCTP(Circle, USDC 한정), Stargate(LayerZero 기반), Wormhole 등. protocol마다 동작 방식·수수료 구조가 다릅니다 (CCTP: burn → attestation → mint / Stargate: LP 풀 사용 / Wormhole: guardian 서명 등).

3) 필요한 트랜잭션 단계 (need* 플래그들)

need* 플래그는 브릿지 1건이 끝까지 가는 동안 어떤 단계가 실행돼야 하는지를 의미합니다. 옥텟 스케줄러가 자동 수행하지만, 입력/잔액 검증과 destination 주소 정책이 이 플래그에 따라 달라집니다.

플래그발생 체인의미
needApproveErc20Sourcesource브릿지 컨트랙트가 토큰을 가져갈 수 있도록 ERC20 approve 트랜잭션이 필요한지 여부
needBridgeSourcesourcesource 체인에서 브릿지 실행 트랜잭션이 필요한지 여부 (예: CCTP depositForBurn, Stargate send)
needActivateAddressDestinationdestinationdestination 체인에서 받는 주소를 활성화/등록하는 트랜잭션이 필요한지 여부 (일부 체인은 신규 주소가 처음 사용되기 전 활성화가 필요)
needBridgeDestinationdestinationdestination 체인에서 자산을 받기 위한 마무리 트랜잭션이 필요한지 여부 (예: CCTP receiveMessage로 mint)

브릿지의 destination 주소는 항상 같은 회사의 대표주소여야 합니다. needActivateAddressDestination / needBridgeDestination 중 하나라도 true이면 옥텟이 destination 체인에서 트랜잭션을 보내야 하므로 destination 잔액 검증이 필요하며, 받는 지갑의 키 관리가 멀티시그(공동관리) 방식인 경우 destination 키(encryptedDestinationUserKey) 제출도 필요합니다.

신청 흐름과의 연결

브릿지 신청 API에는 bridgeTunnelIdx 입력이 필수인데, 이 API의 응답에서 원하는 경로를 찾아 그 idx를 입력해야 합니다.

선택 필터

  • sourcePlatformIdx : 보내는 쪽 플랫폼으로 필터 (예: Ethereum)
  • destinationPlatformIdx : 받는 쪽 플랫폼으로 필터 (예: Arbitrum)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
number
Defaults to 0

조회를 시작할 데이터의 번호
(기본값 : 0)

number
1 to 200
Defaults to 10

조회할 데이터의 개수
(기본값 : 10, 최솟값 : 1, 최댓값 : 200)

number

source 플랫폼 idx로 필터링합니다.

number

destination 플랫폼 idx로 필터링합니다.

Headers
string
required
Defaults to Bearer

API token

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json