Zynjyrara analitika

(Bölüm: Ekosistema we Tor)

1) Zynjyrara seljerme näme we näme üçin zerur?

• Gymmatlygyň we işjeňligiň bitewi hasaba alnyşy: göwrümler, likwidlik, komissiýalar, retenşn.
• Köprüleriň we P2P-baglanyşyklaryň syn edilmegi: gutarmak, laglar, reorg/challenge wakalary.
• Traffigiň we konwersiýalaryň atributiýasy: çeýn → çeýn, kanal → önüm.
• Töwekgelçilik we gabat gelmek: AML, sanksiýalar, özüni alyp baryş frody, mazmuny kesgitlemek.
• Çözgütleri kabul etmek: OKR/býujetler, çäkler, täzelenmeleriň we likwidligiň düzgünleri.

2) Maglumatlaryň çeşmeleri we wakalary (kanoniki sanaw)

1. Zynjyrlar/sanawlar: bloklar, amallar, wakalaryň ýazgylary, akylly-şertnamalaryň ýagdaýlary.
2. Köprüler: arzalar, kwitansiýalar, subutnamalar (light/optimistic/ZK), gutarnykly statuslar.
3. Töleg üpjün edijileri/KS: barlaglaryň geçmegi, çäklendirmeler, tölegleriň ýagdaýy.
4. Önüm hadysalary: onbording, goýumlar/stawkalar/netijeler, oýun we özüni alyp baryş metrikleri.
5. P2P-ulag: Pub/Sub kwitansiýalary, RPC-üstünlik, latency.
6. Gollanmalar: torlar, aktiwler, decimals, chainId, şertnamalaryň salgylary, SDK wersiýalary.

3) Maglumatlaryň arhitekturasy (akymlar we ammar)

Ingest (akym): nodlara/indekserlere birikdirijiler, köprüleriň webhooks, operasiýa DB-den CDC.
Çig gatlaklar (Bronze/Raw): 'observed _ at' we çeşmäniň meta-maglumatlary bilen üýtgewsiz partiýa.
Arassalamak/kadalaşmak (Kümüş): dedup, semantik baýlaşdyrmak, taýmzonlary deňleşdirmek, aktiwleriň mappingi.
Ýadro modelleri (Gold/Core): birleşdirmek faktlary 'transfers', 'bridges', 'onchain _ events', 'kyc _ status', 'payouts'.
Penjireler (Marts): maliýe (GTV/TVL/Take Rate), önüm (retenşn/huni), töwekgelçilik (skoring), operasiýa (SLO).
Keş/Serve: Dashbordlar we API üçin OLAP/HTAP, we/tx salgylary boýunça aýratyn gözleg.

Ulag: Kafka/Pulsar (idempotentligiň üstündäki exactly-once semantics), çig mal üçin obýekt ammary, analitika üçin parket/sütün formatlary.

4) Gutarmak, reorglar we idempotentlik

Ýagdaýlary: 'observed' → 'confirmed (k)' → 'finalized' → 'invalidated (reorg)'.
Tassyklama düzgüni (K-confirmations): tora/aktiw görnüşine görä sazlanýar.
Optimistic/Challenge penjireleri: köprüler üçin "jedelli" statusy goldamak.
Idempotentlik: 'idempotency _ key = chainId' block 'tx' logIndex 'topic' (ýa-da peýdaly ýüküň heş).
Çalmak (replay): meýilleşdirilen backfill we indekseri üýtgedeniňizde dikeldiş.

5) Şahsyýet we tebigat modeli (entity resolution)

Adres → Aktor: salgylar, açarlar, gapjyklar, hasap/gurama/üpjün ediji.
Kross-zynjyr grafasy: salgylaryň bir eýesi tarapyndan baglanyşygy (ewristika, gol, onbording-maglumatlar).
Ynam derejesi: hard-link (KYC, on-chain goly), soft-link (özüni alyp barşyň baglanyşyklary).
Lakamlaşdyrma: analitikada PII ýerine durnukly kesgitleýjileri (PID) saklaň.

6) Wakalaryň bitewi shemasy (ýönekeýleşdirilen)

yaml event:
id: string # global UUID observed_at: timestamp # when they saw chain_id: string # 'eth-mainnet', 'solana-mainnet',...
block_height: long tx_hash: string log_index: int event_type: string    # transfer    bridge. lock    bridge. mint    kyc. pass    payout. done...
status: string      # observed    confirmed    finalized    invalid actor_src: string # address/peer-id/source organization actor_dst: string # address/peer-id/destination organization asset: string # canonical symbol (e. g., USDC), + decimals amount: decimal usd_value: decimal # rate normalization at the observed_at bridge_ref: string # link with the application/receipt of the metadata bridge: object # network/contract/version/gac/fee, etc.
idempotency_key: string

7) Aktiwleriň we bahalaryň kadalaşmagy

Aktiwleriň kanoniki gollanmasy: nyşan, decimals, chain mapping, şertnama salgylary.
FX kadalaşma: "observed _ at" taýtstempi boýunça aktiwleriň taryhy nyrhlary we bahalary.
Köp aktiw bandllar: "örtülen" we milli aktiwleri toparlanyň.

8) Esasy metrikler we penjireler

8. 1 Maliýe we likwidlik

Torlar/aktiwler/köprüler boýunça GTV (Gross Transaction Volume).
TVL we Net Flow köprüler we howuzlar boýunça.
Take Rate/göwrümi üçin komissiýa; Transfer üçin Cost-to-Serve.
Payout SLA Hit Rate, Finality p50/p95, Pending Backlog.

8. 2 Önüm we ulanyjy

Cross-chain MAU/DAU (dedup по PID),

Retention D1/D7/D30 multiçain işjeňligini göz öňünde tutup,

Funnel: giriş ulgamy → köpri → maksatly önüm → hereket.
QoT (traffigiň hili): anti-froddan soň traffigiň walidi.

8. 3 Töwekgelçilik we gabat gelmek

Fraud/Dispute Rate, High-Risk Score%, Sanctions Hit%.
Anomaly rate boýunça geçirimler patterni, velocity-çek, clustering.
KYB/KYC Pass% we taýmingler.

8. 4 Operasiýa we SLO

Bridge Success-Rate, p95 Finality, Relay Availability,

Reorg/Challenge events, Error budget burn.

9) SQL/psevdo-haýyşlaryň mysallary

GTV jübüt zynjyrlar boýunça

sql
SELECT src. chain_id AS src_chain,
dst. chain_id AS dst_chain,
date_trunc('day', e. observed_at) AS d,
SUM(e. usd_value) AS gtv_usd
FROM events e
JOIN bridges b ON e. bridge_ref = b. id
JOIN networks src ON b. src_chain_id = src. id
JOIN networks dst ON b. dst_chain_id = dst. id
WHERE e. status = 'finalized' AND e. event_type IN ('bridge. lock','bridge. mint','transfer')
GROUP BY 1,2,3;

Cross-chain retention D7

sql
WITH first_touch AS (
SELECT pid, MIN(observed_at) AS t0
FROM product_events
WHERE event IN ('signup','first_deposit')
GROUP BY pid
),
week_activity AS (
SELECT DISTINCT pid
FROM product_events pe
JOIN first_touch ft USING(pid)
WHERE pe. observed_at BETWEEN ft.t0 + INTERVAL '1 day'
AND ft.t0 + INTERVAL '7 day'
)
SELECT 100. 0 COUNT() / (SELECT COUNT() FROM first_touch) AS d7_retention_pct
FROM week_activity;

SLO köprüsi üçin vitrin

sql
SELECT date_trunc('hour', observed_at) AS h,
100. 0 SUM(CASE WHEN status='finalized' THEN 1 END)/COUNT() AS success_rate,
percentile_cont(0. 95) WITHIN GROUP (ORDER BY (finalized_at - observed_at)) AS p95_finality_min,
SUM(CASE WHEN challenge_event THEN 1 END) AS challenges
FROM bridge_events
WHERE observed_at >= now() - INTERVAL '7 days'
GROUP BY 1;

10) Atributiýa we köp kanally ýol

Tor, köpri we önüm çeşmesi üçin agramly last-touch/position-based modeli.
UTM → On-chain: Tıklamalary/salgylanmalary onbording wagtynda onchain salgysy bilen baglanyşdyryň (razylyk bilen).
Assosiatiw modeller: "Tor → köpri → önüm" çylşyrymly ýollary üçin Şapley/Markow.

11) Anti-frod we özüni alyp baryş signallary

Grafiki alamatlar: umumy kontragentler, tegelek terjimeler, çalt dolanyşyk.
"Velocity" çäkleri we anomaliýalary: partlamalar, "bölekler", gijeki toparlar.
Köprülerde galplyk shemalary: gaýtadan tabşyrmak, KYC-den aýlanyp geçmek synanyşyklary, likwidligi bolan sendwiç-patternler.
Modeller: gradient güýçlendiriji/graph-embeddings; wakalary bellemekde öwrediň.

12) Gizlinlik we gabat gelmek (privacy-by-design)

PII minimalizasiýa: Göni kesgitleýjileriň ýerine PID, tokenizasiýa.
Data residency: sebitler boýunça partiýa ýerleşdirmek, "rahat/ýolda" şifrlemek.
Aýyrmak hukugy: subut edilip bilinjek tombstone/redaction-wakalar.
Giriş we audit: rol ACL, okamak magazinesurnallary, barlamak üçin gol çekilen hasabatlar.

13) Analitik paýlamalar üçin SLI/SLO

• Freshness ('observed _ at' -dan "Gold" -da peýda bolýança),
• Completeness (K-confirmations garaşýan deşiksiz wakalaryň%),
• Korrectness (shema/düzgünleriň tassyklamasyndan geçen wakalaryň%),
• Reorg handling success (% dogry maýyplyk/oýnamak),
• Serve latency (penjirelere/dashbordlara p95 soraglar).

• Freshness p95 ≤ 3 min (akym), ≤ 15 min (batch).
• Completeness ≥ 99. 7%, Correctness ≥ 99. 9%.
• Reorg handling success ≥ 99. 9%.
• Serve p95 ≤ 500 ms (esasy penjireler).

14) Maglumatlaryň syn edilmegi we lineage

Data Lineage: Dashborddan çig waka çenli (column-level).
Hil signallary: completeness, uniqueness, referential integrity, schema drift.
Alertler: "sessiz şowsuzlyklar" (täze maglumat ýok), paýlanyşyň bökmegi, 'unknown' meýdançalarynyň ösüşi.

15) Daşbordlar (şablonlar)

• Success-Rate, p95 Finality, Relay Availability, Challenge/Reorg, backlog, error budget burn.

• TVL, Net Flow per chain, cost-per-transfer, utilization, ätiýaçlandyryş gaznasy.

• MAU/DAU (dedup), cross-chain retention, kanal hunileri, QoT.

• Fraud/Dispute Rate, sanctions hits, high-risk share, kazyýet işiniň tizligi.

16) Amal düzgünleri we playbook

Waka: tazelik> SLO

Konnektorlary/indekserleri barlaň, ätiýaçlyga geçiň, degradasiýa düzgünini açyň (penjireler "iň soňky gutarnykly" görkezýär), çeşmäniň eýesine eskalate.

Waka: reorg/challenge

K-confirmations/jedel penjiresini köpeltmek, uly mukdarda "delayed finalization" -y açmak, köprä/operatorlara habar bermek.

Waka: walýuta/aktiw tapawudy

Täsir eden jübütleri doňdurmak, gollanmany yzyna gaýtarmak, USD-kadalaşmagy gaýtadan hasaplamak, hasabaty çap etmek.

Waka: Fraud/Dispute bökmek

Çäklendirmeleri/skoringleri berkitmek, ýokary töwekgelçiligi el bilen sarsdyrmak, modeli täze nusgada tamamlamak.

17) Konfigurasiýa mysaly (psevdo-YAML)

Jemleýji penjireler

yaml finality:
eth-mainnet: 12  # блоков polygon: 256 solana: "optimistic: 32 slots"
optimistic-bridge: { challenge_minutes: 20 }
zk-bridge: { proof_time_sla: 180 }

Idempotentlik we atamyň düzgünleri

yaml dedup:
key_template: "${chain_id}    ${block_height}    ${tx_hash}    ${log_index}    ${event_type}"
ttl_hours: 48

Payplaynlaryň SLO

yaml pipelines:
ingest_stream:
freshness_p95_min: 3 completeness_min_pct: 99. 7 gold_build:
correctness_min_pct: 99. 9 reorg_success_min_pct: 99. 9

18) Girizmegiň çek-sanawy

1. Çeşmeleri, shemalary, jemleýji penjireleri we eýelerini belläň.
2. Duýgurlygy we reorg-handling (states + replay).
3. Modelleriň özenini guruň (transfers/bridges/onchain_events/kyc/payouts).
4. Aktiw gollanmalaryny we FX kadalaşmagyny sazlaň.
5. SLI/SLO paýlaýjylary we daşbordlary kesgitläň.
6. Entity resolution we privacy-by-design programmalaryny durmuşa geçiriň.
7. Anti-frod skoringleri we hadysalaryň düzgünlerini açyň.
8. Taryhy reorg/challenge ýagdaýlarynda backfill we synaglary geçiriň.
9. Shemalary, metrikleriň agramyny we çeşmelerini yzygiderli gözden geçiriň.

19) Sözlük

Finality - ýagdaýyň/wakanyň yzyna gaýtarylmazlygy.
Reorg - bloklaryň bir böleginiň ýatyrylmagyna sebäp bolýan zynjyryň gaýtadan ýygnalmagy.
Challenge period - optimistik modellerde jedel penjiresi.
Entity resolution - ýeke-täk manynyň salgylaryny/hasaplaryny deňeşdirmek.
GTV/TVL - geleşikleriň mukdary/petiklenen bahasy.
Completeness/Freshness/Correctness - maglumatlaryň hiliniň esasy metrikleri.

Netije: zynjyrara seljerme diňe bir metrikleriň gysgaça mazmuny däl, eýsem dolandyrylýan düzgün-nyzam: wakalaryň ýeke-täk shemasy, dogry gutarnykly, durnukly paýlanyş, gizlinlik, anti-frod we düşnükli penjireler. Bu freýmworka eýerip, ekosistema çig blokdan başlap, iş çözgüdine çenli gymmata, töwekgelçiliklere we ösüşe hakykatdanam "ahyrky" garaýyş alýar.