Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: Relayer는 모든 온체인 사용자 작업의 가스를 후원하는 가스 스테이션 계층입니다. 트레이더는 가스를 지불할 필요가 없습니다. 이 가이드는 개발자와 관심 있는 사용자를 위해 Relayer의 책임 범위, 개발자용 SDK, 전형적인 트랜잭션 흐름(지갑 배포, ERC-20 승인, CTF split/merge/redeem, 전송 및 주문 배치)과 견고한 툴을 만들기 위해 알아야 할 운영 한계를 설명합니다.

주요 요점

• Relayer는 사용자가 pUSD로 가스 없이 거래할 수 있도록 Polygon PoS 트랜잭션을 후원하는 가스 스테이션 네트워크 계층입니다.
• Relayer가 다루는 일반 흐름: Proxy 지갑 배포, ERC‑20 승인, CTF split/merge/redeem, 토큰 전송 및 CLOB 주문 배치입니다.
• 사용해야 할 API 표면과 SDK가 있습니다: Relayer Client SDK(TypeScript/Python)와 마켓 및 데이터 조회를 위한 세 개의 공개 REST API입니다.
• Builder는 주문을 Polymarket을 통해 라우팅하고 어트리뷰션을 통해 빌더 수수료를 벌 수 있습니다. 등급별 제한이 적용됩니다.
• 비결정적 실행을 항상 설계에 반영하세요: UMA 해상도 분쟁, 슬리피지, 부분 체결, 정산 시점 지연은 여전히 운영 리스크입니다.

Relayer가 필요한 이유

Polymarket은 Polygon PoS(chain ID 137)에서 운영되며 결제 자산으로 pUSD(Polymarket의 래핑된 USDC)를 사용합니다. Relayer는 가스를 후원하여 최종 사용자가 POL을 보유하거나 온체인 작업에 가스를 지불할 필요를 없앱니다. 이는 사용자 마찰을 제거하고 MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase 및 EIP-6963 호환 지갑에서 네이티브한 거래 경험을 제공합니다.

상위 수준 아키텍처

Relayer는 Gas Station Network(GSN)처럼 동작합니다 — 오프체인에서 서명된 사용자 의도를 받아 이를 후원 트랜잭션으로 래핑하고 Polygon에 제출합니다. 개발자 관점에서 다음 두 클래스의 인터페이스와 상호작용합니다:

• 마켓 및 북 데이터용 공개 읽기 API와 WebSocket(Gamma, Data, CLOB, Market WS). 아래에 정확한 기본 URL을 보십시오.
• 지갑 배포, 승인, CTF 연산 및 주문 배치를 후원 흐름으로 처리하는 Relayer Client SDK(TypeScript 및 Python).

중요한 공개 엔드포인트 및 표면

• Gamma API (markets, events, tags): https://gamma-api.polymarket.com
• Data API (positions, trades, holders, open interest): https://data-api.polymarket.com
• CLOB API (order book and trading): https://clob.polymarket.com — 주의: 빌더의 거래는 API key + HMAC이 필요하며 읽기 작업은 공개입니다
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

정확한 API 사용법과 레이트 리밋은 Polymarket 문서에 상세히 나와 있습니다; 마켓 목록에는 Gamma의 /markets 엔드포인트를 사용하세요(limit 최대 1000, 페이징에는 after_cursor 사용).

일반적인 후원 흐름(개발자 관점)

1. 지갑 배포

Polymarket은 Gnosis Safe(사전 배포)와 Proxy 지갑(첫 트랜잭션 시 자동 배포)을 지원합니다. Relayer는 첫 후원 액션에서 프록시 배포 가스비를 지불합니다. SDK에서는 보통 자동으로 처리됩니다: SDK가 지갑이 없음을 감지하면 사용자가 서명한 배포 tx를 Relayer에 제출하도록 요청합니다.

2. ERC-20 승인

사용자는 오직 pUSD로 거래합니다. Relayer가 후원하는 승인 흐름은 사용자를 대신해 ERC-20 승인(및 관련 허용량)을 제출하여 사용자가 POL을 보유하지 않고도 CTF 및 Exchange 계약과 상호작용할 수 있게 합니다. SDK는 보통 마찰을 줄이기 위해 승인 배치 및 관리를 수행합니다.

3. CTF 연산: split / merge / redeem

결과물(Outcome) 토큰은 Gnosis Conditional Token Framework(CTF)를 통해 ERC-1155로 발행됩니다. 일반적인 CTF 연산 — split( $1.00의 pUSD로 완전 세트 민트), merge(세트를 pUSD로 소각), redeem(해상도 후 승리한 토큰을 $1.00으로 소각하여 인출) — 은 모두 Relayer를 통해 지원됩니다. 이러한 온체인 상호작용은 Relayer가 후원하는 트랜잭션으로 제출됩니다.

4. 전송 및 인출

결과 토큰과 pUSD의 전송 및 명시적 인출 단계는 모두 Relayer가 지원하는 트랜잭션으로 실행되므로 사용자는 가스를 지불하지 않고 자금을 이동할 수 있습니다. 보류 중인 relayed 트랜잭션에 대한 UX 신호를 유지하세요 — 이들은 온체인이지만 Data API를 통해 나중에 관찰될 수 있습니다.

5. CLOB에서의 주문 배치

주문 배치(리밋 또는 마켓/FAK 주문)는 CLOB을 통해 라우팅됩니다. 주문을 라우팅하는 Builder는 인증된 거래를 위해 API 키 + HMAC을 사용하며 어트리뷰션 헤더를 포함합니다. Relayer Client SDK는 주문 생성 통합을 제공하며, 적절한 경우 마켓 주문의 FAK 의미를 처리합니다. Maker 수수료는 0이며, Taker 수수료는 카테고리별로 다릅니다.

Builder 프로그램과 어트리뷰션

서드파티는 CLOB를 통해 주문을 라우팅하고 베이시스 포인트 단위의 빌더 수수료를 벌 수 있습니다. 등급은 Unverified(일일 Relayer 제한 100), Verified(일일 제한 10,000 및 주간 USDC 보상), Partner(무제한)입니다. 빌더 자격 증명은 https://polymarket.com/settings 에서 확보하며 Relayer Client SDK가 참여에 필요한 인증 및 어트리뷰션 헤더를 구현합니다.

실무적 개발자 고려사항

• 멱등성 및 재시도: Relayer가 온체인 트랜잭션을 제출하므로 멱등성 있는 흐름과 견고한 재시도 로직을 설계하세요. SDK가 도움을 주지만 백엔드는 서명된 의도(intent)를 중복 제거해야 합니다.
• 보류 상태 UX: 명확한 보류/취소/확정 상태를 표시하세요. Relayed 트랜잭션은 실제 블록체인 트랜잭션이므로 Data API와 Market WS를 사용해 최종 상태를 반영하세요.
• 레이트 리밋: Gamma의 /markets 엔드포인트는 레이트 제한이 있습니다(/markets: 300 req / 10 s; /markets + /events 조합: 900 req / 10 s). 전체 API 제한은 4000 req / 10 s입니다. 폴링이나 인덱싱 작업에서 이를 준수하세요.
• 보안: Relayer는 자체 인프라로 트랜잭션에 서명하고 제출합니다. 비밀 키 보관을 가정하지 마세요; 앱은 여전히 사용자 서명을 요구해야 합니다.
• 지리적 제한: Polymarket은 IP로 주문을 차단합니다. 애플리케이션은 이 제한을 준수해야 하며 VPN 우회 사용을 권장하지 마세요.

테스트 및 로컬 개발

Polymarket은 TypeScript와 Python용 클라이언트 SDK를 제공합니다. 개발 중에는 SDK를 사용해 후원 흐름을 모킹하세요. 마켓 조회에는 Gamma, Data, CLOB 공개 엔드포인트와 실시간 피드를 위한 Market WS를 사용하세요. WebSocket은 10초마다 PING을 전송하고 연결당 최대 500개 종목을 지원한다는 점을 기억하세요.

운영 한계 및 엣지 케이스

• 틱 사이즈 변경: 가격 극단 구간에서 틱 사이즈가 $0.01에서 $0.001로 조여집니다; WebSocket은 tick_size_change 이벤트를 방출합니다. 매칭 및 가격 표시 로직은 이를 처리해야 합니다.
• UMA 분쟁 및 해상도 지연: Relayer는 오라클 또는 해상도 리스크를 제거할 수 없습니다. UMA 분쟁은 정산을 일시 중단할 수 있으므로 지연된 redeem에 대한 UX를 계획하세요.
• 수수료 및 경제성: Maker는 수수료가 0이며 Taker 수수료는 카테고리별(0%–1.8%)로 다릅니다. Relayer는 시장 수수료 구조를 변경하지 않습니다.

이것이 당신의 거래 도구와 봇에 미치는 영향

Polymarket에서 실행하는 도구를 구축한다면 사용자 흐름에는 Relayer Client SDK를 사용하고 서명, 멱등성, 빌더의 어트리뷰션 헤더 관리는 서버 측 프로세스에 맡기세요. 마켓 데이터에는 공개 API를 사용하고 저지연 북 업데이트에는 Market WS를 사용하세요. 비결정적 결과(슬리피지, 부분 체결, 해상도 지연)를 고려하고 UI에 명확히 표시하세요.

마무리

Polymarket relayer explained: 이것이 Polymarket을 가스리스로 느껴지게 하는 운영 계층입니다. 개발자에게는 지갑 배포, 승인, CTF 연산, 전송 및 주문 제출을 SDK와 후원 트랜잭션 흐름 뒤에 중앙화해 줍니다. 공개 API와 Relayer Client SDK를 사용해 레이트 리밋과 지리적 제한을 준수하면서 예측 가능하고 사용자 친화적인 거래 경험을 구축하세요.

더 읽을거리

• 개발자용 가이드: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• 재정거래 참고: /guides/polymarket-arbitrage-complete-guide

Frequently asked questions

What exactly does the Polymarket Relayer sponsor?

Relayer는 Proxy 지갑 배포, pUSD용 ERC‑20 승인, CTF split/merge/redeem, 토큰 전송, 그리고 CLOB에서의 주문 배치 등 Polygon PoS에서의 사용자 대상 온체인 가스를 후원합니다. Relayer는 사용자가 서명한 의도를 후원 트랜잭션으로 래핑하여 Polygon에 제출합니다.

Do I still need pUSD to trade if gas is sponsored?

예. Polymarket은 결제 통화로 pUSD(Polymarket의 래핑된 USDC)를 사용합니다. Relayer는 가스만 후원하므로 시장과 상호작용하려면 충분한 pUSD 잔액과 필요한 승인 권한이 여전히 필요합니다.

Can builders route orders through the Relayer and earn fees?

예. Builder Program은 서드파티가 CLOB를 통해 주문을 라우팅하고 어트리뷰션 헤더로 빌더 수수료(베이시스 포인트)를 획득하게 합니다. 등급(Unverified, Verified, Partner)은 일일 Relayer 제한과 보상이 다릅니다. 빌더 자격 증명은 https://polymarket.com/settings 에서 관리됩니다.

Where do I get market data and real-time book updates?

공개 REST API와 WebSocket을 사용하세요: 마켓은 Gamma(https://gamma-api.polymarket.com), 포지션·거래는 Data(https://data-api.polymarket.com), 오더북 조회는 CLOB(https://clob.polymarket.com), 실시간 북 이벤트는 Market WS(wss://ws-subscriptions-clob.polymarket.com/ws/market)에서 제공합니다.

What operational risks remain even with the Relayer?

후원 가스는 POL 보유 필요성을 제거하지만 다음과 같은 리스크는 남습니다: UMA 해상도 분쟁으로 인한 정산 지연, CLOB에서의 슬리피지와 부분 체결, Polymarket의 수수료 구조 변경 가능성, 스마트 컨트랙트 리스크, 그리고 IP 기반의 지리적 제한.