Polymarket relayer ipinaliwanag: paano gumagana ang gasless model ng Polymarket

Polymarket relayer ipinaliwanag: ang Relayer ay ang gas-station layer na nagsusponsor ng bawat on-chain na aksyon ng user kaya hindi kailanman nagbabayad ng gas ang mga trader. Nilalakbay ng gabay na ito ang mga developer at mausisang user sa mga responsibilidad ng Relayer, ang mga SDK para sa developer, tipikal na transaction flows (wallet deployment, ERC-20 approvals, CTF split/merge/redeem, transfers, at order placement), at ang mga operational na limitasyon na kailangan mong isaalang-alang para makabuo ng matatag na tooling.

Pangunahing takeaway

• Ang Relayer ay isang gas-station network layer na nagsusponsor ng Polygon PoS na mga transaksyon kaya makakapag-transact ng gaslessly ang mga user gamit ang pUSD.
• Karaniwang flows na sakop ng Relayer: Proxy wallet deployment, ERC‑20 approvals, CTF‑split/merge/redeem, transfers, at CLOB order placement.
• May mga API surface at SDK na dapat mong gamitin: ang Relayer Client SDK (TypeScript/Python) at ang tatlong public REST APIs para sa market at data reads.
• Maaaring mag-route ng mga order ang mga Builder sa pamamagitan ng Polymarket na may attribution at kumita ng builder fees; may tiered limits.
• Laging magdisenyo para sa non-deterministic na pagpapatupad: UMA resolution disputes, slippage, partial fills, at settlement timing ay nananatiling operational na panganib.

Bakit umiiral ang Relayer

Tatakbo ang Polymarket sa Polygon PoS (chain ID 137) at gagamit ng pUSD (Polymarket's wrapped USDC) bilang settlement asset. Sinusponsor ng Relayer ang gas kaya hindi kailangang maghawak ng POL o magbayad ng gas ang end users para sa on-chain na operasyon. Inaalis nito ang isang layer ng friction para sa user at ginagawa ang trading na parang native para sa mga wallet gaya ng MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase at anumang EIP-6963-compatible wallet.

High-level architecture

Gumagana ang Relayer bilang isang Gas Station Network (GSN) — tumatanggap ito ng naka-sign na user intents off-chain, binabalot ang mga ito sa sponsored transactions, at isinusumite ang mga transaksiyon na iyon sa Polygon. Mula sa pananaw ng developer, makikipag-ugnayan ka sa dalawang klase ng interface:

• Public read APIs at isang WebSocket para sa market at book data (Gamma, Data, CLOB, at ang Market WS). Tingnan ang eksaktong base URLs sa ibaba.
• Ang Relayer Client SDK (TypeScript at Python) na humahawak ng wallet deployment, approvals, CTF operations, at order placement gamit ang sponsored flow.

Mahalagang public endpoints at surfaces

• 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 — tandaan na ang trading ay nangangailangan ng API key + HMAC para sa builders; ang reads ay public
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

Ang eksaktong paggamit ng API at rate limits ay dinodokumento ng Polymarket; gamitin ang Gamma /markets endpoint para sa market listings (limit hanggang 1000, gumamit ng after_cursor para sa pagination).

Karaniwang sponsored flows (pananaw ng developer)

1. Wallet deployment

Sinusuportahan ng Polymarket ang Gnosis Safe (pre-deployed) at Proxy wallets (auto-deployed sa unang transaksyon). Binabayaran ng Relayer ang gas cost para sa proxy deployment kapag ginawa mo ang iyong unang sponsored action. Mula sa SDK ito ay karaniwang awtomatiko: nadedetect ng SDK na walang wallet at hihilingin ang Relayer na magsumite ng deployment tx na naka-sign ng user.

2. ERC-20 approvals

Ang mga user ay nagta-trade lamang gamit ang pUSD. Ang Relayer-sponsored approval flow ay nagsusumite ng ERC-20 approvals (at mga kaugnay na allowances) sa ngalan ng user upang makipag-ugnayan sila sa CTF at Exchange contracts nang hindi naghawak ng POL. Kadalasan binabatch at minamaneho ng SDK ang mga approvals upang bawasan ang friction.

3. CTF operations: split / merge / redeem

Ang mga outcome shares ay ERC-1155 tokens na minimint gamit ang Gnosis Conditional Token Framework (CTF). Karaniwang CTF operations — split (mag-mint ng kompletong set mula sa $1.00 ng pUSD), merge (sunugin ang set pabalik sa pUSD), at redeem (sunugin ang panalong tokens para sa $1.00 pagkatapos ng resolution) — ay lahat sinusuportahan sa pamamagitan ng Relayer. Ang mga on-chain na interaksiyon na ito ay isinusumite bilang sponsored transactions ng Relayer.

4. Transfers at withdrawals

Ang mga transfer ng outcome tokens at pUSD, pati na rin ang anumang ekspisitong hakbang sa withdrawal, ay isinasagawa sa pamamagitan ng Relayer-backed transactions kaya maaaring gumalaw ang mga user ng pondo nang hindi nagbabayad ng gas. Magbigay ng UX signals para sa pending na relayed transactions — on-chain ang mga ito ngunit maaaring makitang mas huli sa pamamagitan ng Data API.

5. Order placement sa CLOB

Ang paglalagay ng order (limit o market/FAK orders) ay nir-route sa pamamagitan ng CLOB. Ang mga Builder na nagra-route ng mga order ay gumagamit ng API keys + HMAC para sa authenticated trading na may attribution headers. Ina-integrate ng Relayer Client SDK ang paglikha ng order at, kung naaangkop, hinahandle nito ang FAK semantics para sa market orders. Zero ang maker fees; nag-iiba-iba ang taker fees ayon sa category.

Builder program at attribution

Maaaring mag-route ng mga order sa pamamagitan ng CLOB at kumita ng builder fees (credited sa basis points) ang mga third party. Kabilang sa tiers ang Unverified (daily relayer limit 100), Verified (daily limit 10,000 at lingguhang USDC rewards), at Partner (walang limit). Nakukuha ang builder credentials sa https://polymarket.com/settings at ipinapatupad ng Relayer Client SDK ang authentication at attribution headers na kailangan para makilahok.

Praktikal na mga alalahanin para sa developer

• Idempotency at retries: Dahil nagsusumite ang Relayer ng on-chain na mga transaksyon para sa iyo, magdisenyo ng idempotent na mga flow at matibay na retry logic. Tinutulungan ka ng SDK ngunit dapat mag-de-dupe ang iyong backend ng signed intents.
• UX para sa pending state: Ipakita nang malinaw ang pending/cancelled/confirmed na mga estado. Ang mga relayed transactions ay totoong blockchain transactions; gamitin ang Data API at Market WS upang ipakita ang finality.
• Rate limits: Ang Gamma's /markets endpoint ay may rate limit (300 req / 10 s para sa /markets; pinagsamang /markets + /events listing limit 900 req / 10 s). Ang pangkalahatang API limit ay 4000 req / 10 s. Irespeto ang mga ito sa polling o indexing jobs.
• Security: Ang Relayer ay nagpirma at nagsusumite ng mga transaksyon gamit ang sariling infrastructure. Huwag asahang custodial ang private key; dapat pa rin humingi ng user signatures ang iyong app para sa intents.
• Geo restrictions: Ang Polymarket ay nag-geoblock ng mga order ayon sa IP. Dapat igalang ng iyong application ang mga paghihigpit na ito; huwag magmungkahi ng VPN workarounds.

Testing at local development

Nagbibigay ang Polymarket ng client SDKs sa TypeScript at Python. Gamitin ang SDK para i-mock ang sponsored flows sa development. Para sa market reads gamitin ang Gamma, Data, at CLOB public endpoints at ang Market WS para sa real-time feeds. Tandaan na nag-eemit ang WebSocket ng PING kada 10 segundo at sumusuporta hanggang 500 instruments kada connection.

Operational limits at edge cases

• Tick size changes: Ang tick size ay humihigpit mula $0.01 hanggang $0.001 kapag malapit sa extreme prices; nag-eemit ang WebSocket ng tick_size_change events. Dapat kayanin ito ng iyong matching at price-display logic.
• UMA disputes at resolution delays: Hindi kayang alisin ng Relayer ang oracle o resolution risk. Maaaring ipahinto ng UMA disputes ang settlement; magplano ng UX para sa delayed redemption.
• Fees at economics: Zero-fee ang makers; ang taker fees ay nag-iiba-iba ayon sa category (0%–1.8%). Hindi binabago ng Relayer ang market fee economics.

Paano nito naaapektuhan ang iyong trading tools at bots

Kung gagawa ka ng tools na mag-eexecute sa Polymarket, umasa sa Relayer Client SDK para sa user flows at magreserba ng server-side na proseso para sa signing, idempotency, at attribution header management para sa mga builders. Gamitin ang public APIs para sa market data at ang Market WS para sa low-latency book updates. Isaalang-alang ang non-deterministic na mga resulta (slippage, partial fills, resolution delays) at ipakita nang malinaw ito sa iyong UI.

Pagtatapos

Polymarket relayer ipinaliwanag: ito ang operational layer na nagpaparamdam ng gasless ang Polymarket. Para sa mga developer, pinagsasentro nito ang wallet deployment, approvals, CTF ops, transfers, at order submission sa likod ng isang SDK at sponsored transaction flow. Gamitin ang public APIs at ang Relayer Client SDK para makabuo ng predictable, user-friendly na trading experiences habang iginagalang ang rate limits at geo restrictions.

Karagdagang babasahin

• Developer-focused guides: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Arbitrage reference: /guides/polymarket-arbitrage-complete-guide

Frequently asked questions

Ano eksakto ang sinusuportahan ng Polymarket Relayer?

Sinusponsor ng Relayer ang on-chain gas para sa user-facing operations sa Polygon PoS, kasama ang Proxy wallet deployment, ERC‑20 approvals para sa pUSD, CTF split/merge/redeem, token transfers, at order placement sa CLOB. Epektibong binabalot ng Relayer ang mga user-signed intents sa sponsored transactions na isinusumite sa Polygon.

Kailangan ko pa ba ng pUSD para makapag-trade kung sinusuportahan ang gas?

Oo. Gumagamit ang Polymarket ng pUSD (Polymarket's wrapped USDC) bilang settlement currency. Ang Relayer ay nagsusponsor lang ng gas; kailangan mo pa rin ng sapat na pUSD balance at anumang kinakailangang approvals upang makipag-ugnayan sa mga market.

Maaari bang mag-route ng mga order ang mga builders sa Relayer at kumita ng fees?

Oo. Pinapayagan ng Builder Program ang mga third party na mag-route ng mga order sa pamamagitan ng CLOB na may attribution headers at kumita ng builder fees sa basis points. May mga tiers (Unverified, Verified, Partner) na nagtatakda ng daily relayer limits at magkakaibang rewards. Pinamamahalaan ang builder credentials sa https://polymarket.com/settings.

Saan ako kukuha ng market data at real-time book updates?

Gamitin ang public REST APIs at WebSocket: Gamma (https://gamma-api.polymarket.com) para sa markets, Data (https://data-api.polymarket.com) para sa positions at trades, CLOB (https://clob.polymarket.com) para sa order-book reads, at ang Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) para sa real-time book events.

Anong operational risks ang nananatili kahit may Relayer?

Inaalis ng sponsored gas ang pangangailangan na maghawak ng POL, pero may ibang panganib na nananatili: UMA resolution disputes na nagdudulot ng pagkaantala sa settlement, slippage at partial fills sa CLOB, pagbabago sa fee structure ng Polymarket, smart-contract risk, at geo-restrictions na nagba-block ng mga order ayon sa IP.