사용 가능한 브릿지 터널 목록을 조회합니다.
브릿지 터널이란?
브릿지 터널은 어느 플랫폼에서 어느 플랫폼으로 어떤 코인을 보낼 수 있는지를 사전 등록해둔 단위입니다. 옥텟이 미리 검증·승인해놓은 경로만 노출되며, 한 터널은 다음 정보를 묶어서 갖습니다.
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* 플래그들)각 need* 플래그는 브릿지 1건이 끝까지 가는 동안 어떤 단계가 실행돼야 하는지를 의미합니다. 옥텟 스케줄러가 자동 수행하지만, 입력/잔액 검증과 destination 주소 정책이 이 플래그에 따라 달라집니다.
| 플래그 | 발생 체인 | 의미 |
|---|---|---|
needApproveErc20Source | source | 브릿지 컨트랙트가 토큰을 가져갈 수 있도록 ERC20 approve 트랜잭션이 필요한지 여부 |
needBridgeSource | source | source 체인에서 브릿지 실행 트랜잭션이 필요한지 여부 (예: CCTP depositForBurn, Stargate send) |
needActivateAddressDestination | destination | destination 체인에서 받는 주소를 활성화/등록하는 트랜잭션이 필요한지 여부 (일부 체인은 신규 주소가 처음 사용되기 전 활성화가 필요) |
needBridgeDestination | destination | destination 체인에서 자산을 받기 위한 마무리 트랜잭션이 필요한지 여부 (예: CCTP receiveMessage로 mint) |
브릿지의 destination 주소는 항상 같은 회사의 대표주소여야 합니다. needActivateAddressDestination / needBridgeDestination 중 하나라도 true이면 옥텟이 destination 체인에서 트랜잭션을 보내야 하므로 destination 잔액 검증이 필요하며, 받는 지갑의 키 관리가 멀티시그(공동관리) 방식인 경우 destination 키(encryptedDestinationUserKey) 제출도 필요합니다.
신청 흐름과의 연결
브릿지 신청 API에는 bridgeTunnelIdx 입력이 필수인데, 이 API의 응답에서 원하는 경로를 찾아 그 idx를 입력해야 합니다.
선택 필터
sourcePlatformIdx: 보내는 쪽 플랫폼으로 필터 (예: Ethereum)destinationPlatformIdx: 받는 쪽 플랫폼으로 필터 (예: Arbitrum)
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
