Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: Relayer হচ্ছে গ্যাস-স্টেশন স্তর যা প্রতিটি অন-চেইন ব্যবহারকারী ক্রিয়াকলাপ স্পন্সর করে যাতে ব্যবসায়ীরা কখনও গ্যাস দিতে না হয়। এই গাইডটি ডেভেলপার এবং কৌতূহলী ব্যবহারকারীদের জন্য Relayer-এর দায়িত্ব, ডেভেলপার-সমুখীন SDK, সাধারণ ট্রানজেকশন ফ্লো (ওয়ালেট ডিপ্লয়মেন্ট, ERC-20 approvals, CTF split/merge/redeem, ট্রান্সফার এবং অর্ডার প্লেসমেন্ট), এবং এমন অপারেশনাল সীমা ব্যাখ্যা করে যা আপনাকে দৃঢ় টুলিং গড়ে তুলতে সাহায্য করবে।

Key takeaways

• Relayer হচ্ছে একটি gas-station network স্তর যা Polygon PoS লেনদেন স্পনসর করে যাতে ব্যবহারকারীরা pUSD দিয়ে গ্যাসলেসভাবে লেনদেন করতে পারে।
• Relayer দ্বারা কাভার করা সাধারণ ফ্লো: Proxy ওয়ালেট ডিপ্লয়মেন্ট, ERC‑20 approvals, CTF split/merge/redeem, ট্রান্সফার এবং CLOB অর্ডার প্লেসমেন্ট।
• আপনি যে API সারফেস এবং SDK ব্যবহার করা উচিত: Relayer Client SDK (TypeScript/Python) এবং মার্কেট ও ডাটা রিডের জন্য তিনটি পাবলিক REST API।
• Builders Polymarket-এর মাধ্যমে অর্ডার রাউট করে attribution পেতে পারে এবং builder ফি আয় করতে পারে; টিয়ার-ভিত্তিক সীমা প্রযোজ্য।
• সর্বদা non-deterministic execution ধরা নিয়ে ডিজাইন করুন: UMA resolution বিতর্ক, স্লিপেজ, আংশিক ফিলস, এবং সেটেলমেন্ট টেকনিক্যাল টাইমিং অপারেশনাল ঝুঁকি হিসেবে থেকে যায়।

Why the Relayer exists

Polymarket চলে Polygon PoS-এ (chain ID 137) এবং settlement অ্যাসেট হিসাবে pUSD (Polymarket-এর wrapped USDC) ব্যবহার করে। Relayer গ্যাস স্পন্সর করে যাতে শেষ ব্যবহারকারীদের POL ধরে রাখতে না হয় বা অন-চেইন অপারেশনের জন্য গ্যাস দিতে না হয়। এটা ব্যবহারকারীর ফ্রিকশান কমায় এবং MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase এবং যেকোনো EIP-6963-কম্প্যাটিবল ওয়ালেটের জন্য ট্রেডিং নেটিভ অভিজ্ঞতা বানায়।

High-level architecture

Relayer কাজ করে Gas Station Network (GSN) হিসেবে — এটি অফ-চেইনে সই করা ব্যবহারকারীর ইন্টেন্ট গ্রহণ করে, সেগুলোকে স্পন্সর করা ট্রানজেকশনে মোড়ায় এবং সেগুলো Polygon-এ সাবমিট করে। ডেভেলপার দৃষ্টিকোণ থেকে, আপনি দুই শ্রেণীর ইন্টারফেসের সাথে ইন্টারঅ্যাক্ট করবেন:

• পাবলিক রিড API এবং একটি WebSocket মার্কেট ও বুক ডেটার জন্য (Gamma, Data, CLOB, এবং Market WS). নিচে সঠিক বেস URL গুলো দেখুন।
• Relayer Client SDK (TypeScript এবং Python) যা ওয়ালেট ডিপ্লয়মেন্ট, approvals, CTF অপারেশন এবং স্পন্সরড ফ্লো দিয়ে অর্ডার প্লেসমেন্ট হ্যান্ডেল করে।

Important public endpoints and 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 — নোট করুন builders-এর জন্য ট্রেডিং API key + HMAC প্রয়োজন; রিডগুলো পাবলিক
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

Exact API usage and rate limits are documented by Polymarket; use the Gamma /markets endpoint for market listings (limit up to 1000, use after_cursor for pagination).

Common sponsored flows (developer view)

1. Wallet deployment

Polymarket Gnosis Safe (pre-deployed) এবং Proxy wallets (প্রথম ট্রানজেকশনে auto-deployed) সমর্থন করে। Relayer প্রথম স্পন্সর করা অ্যাকশনের সময় proxy ডিপ্লয়মেন্টের গ্যাস খরচ বহন করে। SDK থেকে এটি সাধারণত স্বয়ংক্রিয়: SDK কোনো ওয়ালেট খুঁজে না পেলে Relayer-কে ব্যবহারকারীর সই করা একটি deployment tx সাবমিট করতে বলে।

2. ERC-20 approvals

ব্যবহারকারীরা একচেটিয়াভাবে pUSD দিয়ে ট্রেড করেন। Relayer-স্পন্সর্ড approval ফ্লো ব্যবহারকারীর পক্ষ থেকে ERC-20 approvals (এবং সংশ্লিষ্ট allowances) সাবমিট করে যাতে তারা CTF এবং Exchange কনট্রাক্টের সাথে POL না ধরে ইন্টারঅ্যাক্ট করতে পারে। SDK সাধারণত approvals ব্যাচ করে এবং friction কমাতে এগুলো ম্যানেজ করে।

3. CTF operations: split / merge / redeem

Outcome শেয়ারগুলো ERC-1155 টোকেন যা Gnosis Conditional Token Framework (CTF) দিয়ে mint করা হয়। Tipical CTF অপারেশনগুলো — split (pUSD $1.00 থেকে সম্পূর্ণ সেট mint করা), merge (এক সেট পুড়িয়ে pUSD ফেরত দেওয়া), এবং redeem (রেজল্যুশনের পরে জয়ী টোকেন পুড়িয়ে $1.00 পাওয়া) — সবগুলি Relayer-এর মাধ্যমে সমর্থিত। এই অন-চেইন ইন্টারঅ্যাকশনগুলো Relayer স্পন্সর করা ট্রানজেকশন হিসেবে সাবমিট করে।

4. Transfers and withdrawals

Outcome টোকেন এবং pUSD-র ট্রান্সফার, এবং যে কোনও স্পষ্ট withdrawal স্টেপগুলো Relayer-ব্যাকড ট্রানজেকশনের মাধ্যমে এক্সিকিউট করা হয় যাতে ব্যবহারকারীরা গ্যাস না দিয়ে তহবিল স্থানান্তর করতে পারে। pending relayed ট্রানজেকশানগুলির জন্য UX সংকেত রাখুন — এগুলো অন-চেইন কিন্তু Data API-এর মাধ্যমে পরে অবজার্ভ করা যেতে পারে।

5. Order placement on the CLOB

অর্ডার প্লেসমেন্ট (limit বা market/FAK অর্ডার) CLOB-এর মাধ্যমে রাউট করা হয়। অর্ডার রাউট করা builders-রা attribution headers দিয়ে API key + HMAC ব্যবহার করে authenticated ট্রেডিং করে। Relayer Client SDK অর্ডার ক্রিয়েশন ইন্টিগ্রেট করে এবং প্রযোজ্য হলে market অর্ডারের জন্য FAK সেম্যান্টিকস হ্যান্ডেল করে। Maker ফি শূন্য; taker ফি ক্যাটাগরি অনুযায়ী পরিবর্তিত হয়।

Builder program and attribution

থার্ড-পার্টিরা CLOB-এ অর্ডার রাউট করে basis points-এ builder ফি উপার্জন করতে পারে। টিয়ারসমূহের মধ্যে আছে Unverified (দৈনিক relayer সীমা 100), Verified (দৈনিক সীমা 10,000 এবং সাপ্তাহিক USDC রিওয়ার্ড), এবং Partner (অসীম)। Builder credential গুলো https://polymarket.com/settings থেকে ম্যানেজ করা হয় এবং Relayer Client SDK অংশগ্রহণের জন্য প্রয়োজনীয় authentication ও attribution headers ইমপ্লিমেন্ট করে।

Practical developer concerns

• Idempotency and retries: Relayer আপনার পক্ষ থেকে অন-চেইন ট্রানজেকশন সাবমিট করে, তাই idempotent ফ্লো এবং দৃঢ় retry লজিক ডিজাইন করুন। SDK সাহায্য করে কিন্তু আপনার ব্যাকএন্ডকে signed intents ডি-ডুপ করা উচিত।
• UX for pending state: স্পষ্ট pending/cancelled/confirmed স্টেট দেখান। Relayed ট্রানজেকশনগুলো বাস্তব ব্লকচেইন ট্রানজেকশন; Data API এবং Market WS ব্যবহার করে ফাইনালিটি প্রতিফলিত করুন।
• Rate limits: Gamma-এর /markets endpoint rate limited (300 req / 10 s for /markets; combined /markets + /events listing limit 900 req / 10 s). Overall API limit is 4000 req / 10 s. Polling বা indexing জবগুলোতে এগুলো সম্মান করুন।
• Security: Relayer তার ইনফ্রাস্ট্রাকচার ব্যবহার করে ট্রানজেকশন সাইন ও সাবমিট করে। প্রাইভেট-কি কস্টডি ধরে নেবেন না; আপনার অ্যাপ এখনও ব্যবহারকারী সিগনেচার চাইবে intents-এর জন্য।
• Geo restrictions: Polymarket IP-ভিত্তিকভাবে অর্ডার ব্লক করে। আপনার অ্যাপ্লিকেশনকে এসব সীমাবদ্ধতা মেনে চলতে হবে; VPN ওভাররাইট করার পরামর্শ দেবেন না।

Testing and local development

Polymarket TypeScript এবং Python-এ client SDK প্রদান করে। ডেভেলপমেন্টের সময় স্পন্সরড ফ্লো মক করতে SDK ব্যবহার করুন। মার্কেট রিডের জন্য Gamma, Data, এবং CLOB পাবলিক endpoint ব্যবহার করুন এবং রিয়েল-টাইম ফিডের জন্য Market WS ব্যবহার করুন। মনে রাখবেন WebSocket প্রতি 10 সেকেন্ডে একটি PING ইমিট করে এবং প্রতিটি কানেকশনে সর্বোচ্চ 500 ইনস্ট্রুমেন্ট সাপোর্ট করে।

Operational limits and edge cases

• Tick size changes: পিক্সের এক্সট্রিম এলাকা নিকটে tick size $0.01 থেকে $0.001-এ সংকীর্ণ হয়; WebSocket tick_size_change ইভেন্ট ইমিট করে। আপনার ম্যাচিং এবং প্রাইস-ডিসপ্লে লজিককে এটি হ্যান্ডেল করতে হবে।
• UMA disputes and resolution delays: Relayer ওরাকল বা রেজল্যুশন ঝুঁকি দূর করতে পারে না। UMA বিতর্ক সেটেলমেন্ট পজ করতে পারে; delayed redemption-এর UX-এর জন্য পরিকল্পনা করুন।
• Fees and economics: Maker ফি শূন্য; taker ফি ক্যাটাগরি অনুযায়ী পরিবর্তিত (0%–1.8%)। Relayer মার্কেট ফি অর্থনীতিতে পরিবর্তন আনে না।

How this affects your trading tools and bots

Polymarket-এ এক্সিকিউট করে এমন টুল বানালে Relayer Client SDK-র উপর ব্যবহারকারীর ফ্লো নির্ভর করুন এবং সার্ভার-সাইড প্রসেসগুলো সাইনিং, idempotency, এবং builders-এর attribution header ম্যানেজমেন্টের জন্য রিজার্ভ করুন। মার্কেট ডেটার জন্য পাবলিক APIs এবং লো-লেটেন্সি বুক আপডেটের জন্য Market WS ব্যবহার করুন। non-deterministic ফলাফল (স্লিপেজ, আংশিক ফিল, রেজল্যুশন বিলম্ব) বিবেচনা করে এগুলো স্পষ্টভাবে UI-তে দেখান।

Closing

Polymarket relayer explained: এটি অপারেশনাল স্তর যা Polymarket-কে গ্যাসলেস অনুভব করায়। ডেভেলপারদের জন্য এটি ওয়ালেট ডিপ্লয়মেন্ট, approvals, CTF অপারেশন, ট্রান্সফার এবং অর্ডার সাবমিশনকে একটি SDK এবং স্পন্সরড ট্রানজেকশন ফ্লোর পিছনে কেন্দ্রীভূত করে। predictable, ব্যবহারকারী-বান্ধব ট্রেডিং অভিজ্ঞতা গড়তে পাবলিক APIs এবং Relayer Client SDK ব্যবহার করুন, পাশাপাশি rate limits এবং geo restrictions সম্মান করুন।

Further reading

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

Frequently asked questions

What exactly does the Polymarket Relayer sponsor?

Relayer Polygon PoS-এ ব্যবহারকারী-ফেসিং অপারেশনের অন-চেইন গ্যাস স্পন্সর করে, যার মধ্যে Proxy ওয়ালেট ডিপ্লয়মেন্ট, pUSD-এর জন্য ERC‑20 approvals, CTF split/merge/redeem, টোকেন ট্রান্সফার এবং CLOB-এ অর্ডার প্লেসমেন্ট অন্তর্ভুক্ত। Relayer কার্যত ব্যবহারকারীর সই করা intents গুলোকে স্পন্সর করা ট্রানজেকশনে র্যাপ করে Polygon-এ সাবমিট করে।

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

হ্যাঁ। Polymarket settlement মুদ্রা হিসেবে pUSD (Polymarket-এর wrapped USDC) ব্যবহার করে। Relayer শুধুই গ্যাস স্পন্সর করে; মার্কেটে ইন্টারঅ্যাক্ট করতে এখনও আপনার পর্যাপ্ত pUSD ব্যালান্স এবং প্রয়োজনীয় approvals থাকতে হবে।

Can builders route orders through the Relayer and earn fees?

হ্যাঁ। Builder Program তৃতীয়-পার্টিদের CLOB-এ অর্ডার রাউট করে attribution headers ব্যবহার করে এবং basis points-এ builder ফি উপার্জন করতে দেয়। টিয়ারসমূহ (Unverified, Verified, Partner) দৈনিক relayer সীমা এবং বিভিন্ন রিওয়ার্ড আরোপ করে। Builder credential গুলো https://polymarket.com/settings-এ ম্যানেজ করা হয়।

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

পাবলিক REST APIs এবং 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?

Sponsored গ্যাস POL রাখার প্রয়োজন দূর করে, কিন্তু অন্যান্য ঝুঁকি থেকে যায়: UMA resolution বিতর্ক যা সেটেলমেন্ট বিলম্ব করতে পারে, CLOB-এ স্লিপেজ এবং আংশিক ফিল, Polymarket দ্বারা ফি স্ট্রাকচারে পরিবর্তন, স্মার্ট-কনট্র্যাক্ট ঝুঁকি, এবং IP-ভিত্তিক geo-restrictions যা অর্ডার ব্লক করে।