Yakha Futhi Lungiselela I-bot Yokukopisha Ukuhweba ye-Polymarket nge-TypeScript

Okwenziwa yi-Polymarket CodeX CopyTrading Bot

I-Polymarket CodeX CopyTrading Bot wuhlelo lwe-TypeScript oluqapha umsebenzi wamawallet alandelwayo oyedwa noma amaningi bese lwenza ama-oda ahambisanayo e-Polymarket. Ifunda umsebenzi we-wallet nge-Data API yomphakathi futhi isebenzisa i-@polymarket/clob-client-v2 ukuhweba bukhoma nge-central limit order book ye-Polymarket.

I-bot ingakopisha ukuthenga nokuthengisa isebenzisa amanani e-USD angashintshi noma ukubalwa okusekelwe kumaphesenti. Iphinde igcine irekhodi lendawo lama-trade abonwe, ama-oda akhiqiziwe, ama-oda asetshenzisiwe noma alingisiwe, kanye nezikhundla zamathokheni ezilinganisiwe.

Isixwayiso sengozi: Lena isofthiwe yokuhweba. Inzuzo ayiqinisekisiwe. Qala ngokusebenzisa ukulingisa, hlola wonke amanani wokumisa, futhi usebenzise amanani amancane kakhulu ngaphambi kokucabanga ngokusebenzisa ukuhweba bukhoma.

Izici Eziyinhloko

• Iqapha ama-wallet alandelwayo amaningi.
• Isiza izindlela zokukopisha ezinenani elingashintshi nezisekelwe kumaphesenti.
• Ihlinzeka ngokusetshenziswa okulingisiwe nge-npm run test.
• Ihlinzeka ngokusetshenziswa kwemakethe bukhoma nge-npm start.
• Ingakwazi ukulandela umsebenzi wokuthengisa isebenzisa isikhundla esilandelwa yi-bot endaweni.
• Isebenzisa imikhawulo ye-oda elincane, i-oda elikhulu, isikhundla, kanye nenani lansuku zonke.
• Ihlinzeka ngokuvikelwa kwentengo ongakukhetha okuhlobene nentengo yokugcwaliswa kwe-trade elandelwayo.
• Igcina isimo kufayela le-JSON lendawo.

Izidingo

Ngaphambi kokumisa i-bot, faka le software elandelayo:

• Inguqulo ye-Node.js engu-20.10 noma entsha.
• npm.

Thola ikhodi yomthombo yephrojekthi, vula i-terminal kufolda yayo, bese ufaka okuncikile kwephakheji:

npm install

I-bot incike kuphakheji engeyona eye-beta i-@polymarket/clob-client-v2 ukuze isebenzise ama-oda, kanye ne-Polymarket Data API yomphakathi ukuze ihlole umsebenzi wama-wallet.

Misa Imininingwane Yokungena Yokuhweba Bukhoma

Dala noma uhlele ifayela lephrojekthi elithi .env. Faka i-CLOB host, i-Polygon chain ID, uhlobo lwesiginesha, i-private key, kanye ne-deposit wallet:

POLYMARKET_CLOB_HOST=https://clob.polymarket.com
POLYMARKET_CHAIN_ID=137
POLYMARKET_SIGNATURE_TYPE=POLY_1271
POLYMARKET_PRIVATE_KEY=0x...
POLYMARKET_DEPOSIT_WALLET=0x...

Ungalokothi ufake i-private key yangempela noma ifayela lemininingwane yokungena ku-version control. Phatha i-private key kanye nanoma yimiphi imininingwane ye-CLOB njengezimfihlo.

Khetha Uhlobo Olufanele Lwesiginesha

POLYMARKET_SIGNATURE_TYPE yamukela la manani alandelayo:

• EOA
• POLY_PROXY
• POLY_GNOSIS_SAFE
• POLY_1271

Ngokwemibhalo yephrojekthi, i-POLY_1271 ivamise ukufaneleka kubasebenzisi abasha be-deposit wallet. Uma uhweba ngokuqondile nge-akhawunti ephethwe ngaphandle, khetha i-EOA; kulokho, POLYMARKET_DEPOSIT_WALLET ingashiywa ingafakwanga.

Sebenzisa Imininingwane Ekhona Ye-L2

I-bot ingakhiqiza imininingwane yokungena ngesikhathi iqala. Ukuze ugweme leso sinyathelo, nikeza imininingwane ekhona ye-L2 ku-.env:

CLOB_API_KEY=...
CLOB_SECRET=...
CLOB_PASS_PHRASE=...

Ukusetshenziswa bukhoma kusebenzisa i-createAndPostMarketOrder. Ngaphambi kokuqala ukuhweba bukhoma, qinisekisa ukuthi i-wallet yokuhweba inemali eyanele futhi inezimvume ezidingekayo ze-Polymarket. I-bot ayiwakhi ama-wallet futhi ayivumeli ngokuzenzakalelayo ukusetshenziswa kwamathokheni.

Misa Usayizi Wokukopisha

Uhlelo lusekela izindlela ezimbili zokukopisha. Khetha indlela ehambisana nenani lokuzibeka engcupheni ofuna i-bot ilithathe.

Imodi Yenani Elingashintshi

Imodi yenani elingashintshi inikeza umsebenzi wokuthenga nokuthengisa okokopishiwe inani le-USD elinqunywe kusengaphambili:

COPY_MODE=fixed
FIXED_BUY_AMOUNT_USD=5
FIXED_SELL_AMOUNT_USD=5

Kulesi sibonelo, ukuthenga nokuthengisa okufanele kukopishwe kusetshenziswa inani elimisiwe lama-dollar ase-US amahlanu.

Imodi Yamaphesenti

Imodi yamaphesenti ibala osayizi bama-oda isebenzisa umsebenzi we-wallet elandelwayo:

COPY_MODE=percentage
COPY_PERCENTAGE=0.10

Ekuthengeni, i-bot ikopisha iphesenti elimisiwe lenani le-USD le-trade elandelwayo. Ekuthengiseni, ikopisha iphesenti elimisiwe lamasheya athengiswe yi-wallet elandelwayo. Ukuthengisa kukhawulelwa yisikhundla esilandelwa manje esimweni sendawo se-bot.

Isibonelo, 0.10 imele amaphesenti ayishumi. I-oda langempela kusafanele lidlule ezilawulweni zengozi ezimisiwe.

Misa Izilawuli Zengozi

Chaza imikhawulo yama-oda nokuzibeka engcupheni ku-.env ngaphambi kokusebenzisa ukuhweba okulingisiwe noma bukhoma:

MIN_ORDER_USD=1
MAX_ORDER_USD=25
MAX_POSITION_USD_PER_TOKEN=100
DAILY_MAX_NOTIONAL_USD=250
ORDER_TYPE=FAK
PRICE_PROTECTION_BPS=0

• MIN_ORDER_USD ibeka inani elincane elivunyelwe le-oda.
• MAX_ORDER_USD ikhawulela inani le-oda elilodwa.
• MAX_POSITION_USD_PER_TOKEN ikhawulela ukuzibeka engcupheni okulinganisiwe kwethokheni ngayinye.
• DAILY_MAX_NOTIONAL_USD ikhawulela umsebenzi ophelele wansuku zonke.
• ORDER_TYPE ilawula indlela yokugcwaliswa kwe-oda.
• PRICE_PROTECTION_BPS ikhawulela ngokuzithandela ukusetshenziswa okuhlobene nentengo yokugcwaliswa elandelwayo.

Qonda Ama-oda e-FAK ne-FOK

Nge-ORDER_TYPE=FAK, i-oda lingagcwaliswa kancane, bese ingxenye engakagcwaliswa ikhanselwa. Nge-ORDER_TYPE=FOK, lonke i-oda kufanele ligcwaliswe; ngaphandle kwalokho, i-oda liyehluleka.

I-FAK ingafaneleka lapho ukusetshenziswa okuyingxenye kwamukelekile. I-FOK iqinile kakhulu, kodwa ingabangela ukuthi ama-oda amaningi ehluleke lapho kungatholakali imali eyanele ephelele emakethe.

Sebenzisa Ukuvikelwa Kwentengo

Uma PRICE_PROTECTION_BPS=0, iklayenti le-CLOB lilinganisa intengo yemakethe embi kakhulu engasetshenziswa. Uma kumiswe inani elingelona u-zero, i-bot ibala umkhawulo wentengo embi kakhulu ongaphezu kwentengo yokugcwaliswa elandelwayo ekuthengeni, naphansi kwayo ekuthengiseni.

Ukuvikelwa kwentengo kunganciphisa ukunyakaza kwentengo okwamukelekayo, kodwa i-README ayiqinisekisi ukuthi i-oda lizogcwaliswa lapho lesi silungiselelo sivuliwe.

Qala Ngokwenza Ukulingisa

Qala ngomyalo wokuhlola wephrojekthi:

npm run test

Le modi ikhiqiza ama-oda alingisiwe esikhundleni sama-oda emakethe abukhoma. Yisebenzise ukuze uqinisekise ukuqashwa kwe-wallet, indlela yokubala ubukhulu, imikhawulo yobungozi, nezilungiselelo zemvelo ngaphandle kokuthumela ngokushesha ukuhweba okubukhoma.

Ngesikhathi sokuhlola, qinisekisa ukuthi:

1. Ama-wallet ahlosiwe ayaqashwa.
2. Imicimbi yokuthenga nokuthengisa ilungiswa ngendlela efanele.
3. Imodi yokukopisha ekhethiwe ikhiqiza obukhulu obulindelekile.
4. Ama-oda ahlonipha imikhawulo encane, emikhulu, yesikhundla, neyansuku zonke.
5. Ubukhulu bokuthengisa abudluli isikhundla esilandelwa endaweni.
6. Isimo sigcinwa ngaphansi kwe-./data/state.json.

Qala Ukuhweba Okubukhoma

Ngemva kokubuyekeza imiphumela yokulingisa, imali ye-wallet, izimvume, imininingwane yokungena, nazo zonke izilungiselelo zobungozi, qala ukwenziwa okubukhoma usebenzisa:

npm start

Lo myalo uvula ama-oda emakethe abukhoma. Qala ngobukhulu obuncane kakhulu futhi uqaphe kokubili okukhiphayo kwe-terminal ne-akhawunti ye-Polymarket. Ungacabangi ukuthi imiphumela elingisiwe izofana ncamashi nokugcwaliswa okubukhoma, ukutholakala kwemali, noma ukunyakaza kwentengo.

Qonda Isimo Sendawo

I-bot igcina isimo sayo sendawo ku:

./data/state.json

Leli fayela lilandelela ukuhweba osekuvele kubonwe, ama-oda alingisiwe noma asetshenzisiwe, kanye nezikhundla ezilinganiselwayo. Lisiza ukuvimbela umsebenzi osuvele ucutshunguliwe ukuthi uphathwe njengomusha futhi linikeza umqondo wokulandela ukuthengisa umbono wendawo wezikhundla ezitholakalayo.

Izikhundla zilinganiselwa kuphela ngoba ama-oda emakethe angagcwaliswa ngokwengxenye. Ngakho-ke, isimo sendawo singahluka kokuphethwe yi-akhawunti yangempela.

Amathiphu Okusebenza Athuthukile

Engeza Ukuvumelanisa Kwezikhundla

Ekusetshenzisweni kokukhiqiza, i-README incoma ukwengeza umsebenzi wokuvumelanisa ngezikhathi ezithile. Lo msebenzi kufanele ubuze i-/positions endpoint ye-Data API usebenzisa i-POLYMARKET_DEPOSIT_WALLET bese uqhathanisa izikhundla ezibuyisiwe nesimo sendawo.

Lokhu kubaluleke kakhulu ngemva kokugcwaliswa okuyingxenye, ama-oda ahlulekile, ukuhweba okwenziwe ngesandla, ukuqalisa kabusha, noma noma yimuphi umsebenzi owenziwe ngaphandle kwe-bot.

Vikela Ifayela Lesimo

Yenza ikhophi eyisipele ye-./data/state.json ngaphambi kokuthuthukisa noma ukwenza izinguquko zokusebenza. Gwema ukulihlela ngenkathi i-bot isebenza. Njengoba lirekhoda umsebenzi obonwe nezikhundla ezilinganiselwayo, ukulisusa noma ukulonakalisa kungathinta ukutholwa kokuphindaphinda nokubalwa kobukhulu bokuthengisa.

Sebenzisa Imikhawulo Eqaphile

Qala nge-MAX_ORDER_USD, MAX_POSITION_USD_PER_TOKEN, kanye ne-DAILY_MAX_NOTIONAL_USD ephansi. Yinyuse kuphela ngemva kokubheka i-bot ngaphansi kwezimo zemakethe ezingokoqobo. Imikhawulo yobungozi inciphisa ukuvezwa, kodwa ayibususi ubungozi bokwenziwa, bokutholakala kwemali, bemakethe, noma besoftware.

Buyekeza Amafayela Omthombo Afanele

Indawo yokugcina ikhodi ihlukanisa izibopho zokucushwa, ukupholwa, isu, ukwenziwa, nokugcinwa kwesimo:

• src/config.ts iphatha ukuhlaziywa kwemvelo nokuhlolwa kokuphepha.
• src/index.ts iqukethe iluphu enkulu yokupholwa.
• src/polymarket/dataApi.ts yenza ukufundwa komphakathi kwe-Data API.
• src/watchers/walletWatcher.ts iphola umsebenzi wama-wallet amaningi.
• src/polymarket/tradeParser.ts ilungisa imicimbi yomsebenzi.
• src/strategy/copyStrategy.ts isebenzisa ukubalwa kobukhulu obugxilile nobusekelwe kumaphesenti.
• src/strategy/riskManager.ts iphoqelela imikhawulo yama-oda, yansuku zonke, neyezikhundla.
• src/polymarket/orderExecutor.ts iphatha ukwenziwa okulingisiwe nokubukhoma.
• src/storage/stateStore.ts ilawula isimo sendawo se-JSON.

Ukubuyekeza lawa mafayela kuyasiza ngaphambi kokusetshenziswa okubukhoma, ikakhulukazi uma udinga ukuqonda indlela yokupholwa, ukuhlolwa kokuphepha, ukulungiswa kwemicimbi, noma ukubalwa kobukhulu bama-oda.

Isiphetho

I-Polymarket CodeX CopyTrading Bot inikeza ukuhamba komsebenzi kwe-TypeScript kokuqapha ama-wallet amaningi nokukopisha ukuthenga nokuthengisa okufanelekile ngobukhulu obugxilile noma obusekelwe kumaphesenti. Lungisa imininingwane yokungena ngokucophelela, sebenzisa imikhawulo yobungozi eqaphile, qinisekisa ukuziphatha nge-npm run test, futhi uvumelanise izikhundla zendawo ngaphambi kokuthembela ku-npm start ekuhwebeni okubukhoma.