گردشی سپلائی کا تناسب کیسے نکالیں؟

Circulating ratio ایک آسان percentage لگتی ہے، مگر numerator اور denominator کی definitions غلط ہوں تو نتیجہ research کے بجائے decoration بن جاتا ہے۔ یہ worksheet circulating، total اور maximum supply کو الگ record کرتی ہے، raw on-chain units کو decimals کے ساتھ convert کراتی ہے، اور locked، burned، treasury یا bridged tokens کے treatment کو visible بناتی ہے۔ کوئی live API استعمال نہیں ہوتا۔

مختصر جواب: Circulating ratio کیا ہے؟

Circulating ratio = circulating supply ÷ selected supply base × 100%

Selected base عموماً total یا max supply ہو سکتی ہے، لیکن دونوں ratios الگ سوالوں کے جواب ہیں:

• C ÷ T: موجودہ issued supply میں گردش کا حصہ
• C ÷ Smax: ممکنہ maximum کے مقابل موجودہ گردش

Ratio کے نام میں denominator ضرور لکھیں۔ صرف “40% circulating” کہنا مبہم ہے۔

تین supply labels ایک table میں رکھیں

CoinGecko Supply Methodology اپنے platform کے labels کی تفصیل دیتی ہے۔ CoinMarketCap supply definitions دوسری provider methodology دکھاتی ہیں۔ دونوں کو compare کرتے وقت terminology ملتی جلتی ہونے کے باوجود exclusions مختلف ہو سکتی ہیں۔

Step 1: Asset identity بند کریں

Ticker نہیں، full contract یا mint address استعمال کریں۔ Chain، decimals، token standard، migration status اور bridge relation لکھیں۔ Wrapped token اور native asset کو ایک row میں نہ ملائیں۔ اگر official sources دو addresses دکھائیں تو پہلے migration یا multi-chain architecture حل کریں۔

Identity record:

• official project URL
• chain + chain ID
• complete contract/mint
• symbol/name
• decimals
• native/wrapped/bridged
• verified source status
• capture timestamp

Explorer پر “verified” source-code publication ہو سکتی ہے، circulating methodology یا investment safety نہیں۔

Step 2: On-chain total کو human units میں بدلیں

یہ 2026-08 میں محفوظ کی گئی Ethereum.org ERC-20 standard overview کی حقیقی تصویر ہے۔ Page total supply کو token functionality کے طور پر بیان کرتی ہے؛ circulating supply کا universal contract method نہیں دیتی۔

EIP-20 interface میں totalSupply() شامل ہے۔ Raw integer کو display amount میں بدلنے کے لیے:

Display supply = raw totalSupply ÷ 10^decimals

Example صرف arithmetic کے لیے: raw value 750000000000 اور decimals 6 ہوں تو display supply 750,000 بنتی ہے۔ Decimals 9 فرض کرنے سے answer ہزار گنا بدل جائے گا۔ Raw string، decimals source اور converted value تینوں محفوظ کریں۔

Step 3: Burn کا accounting سمجھیں

OpenZeppelin ERC20Burnable burn اور burnFrom mechanics کی implementation reference دیتی ہے۔ Contract-level burn total supply کم کر سکتی ہے۔ Dead address transfer میں balance inaccessible سمجھا جا سکتا ہے مگر contract total field لازماً کم نہیں ہوتا۔ Provider ان دونوں کو الگ treat کر سکتا ہے۔

Burn row میں لکھیں:

• transaction/event source
• amount اور decimals
• block/time
• totalSupply() before/after
• receiving address، اگر transfer-based burn ہو
• provider نے total یا circulating سے کیا subtract کیا

Announcement، buyback plan اور completed burn کو ایک status نہ دیں۔

Step 4: Circulating exclusions درج کریں

Circulating supply methodology-based estimate ہے۔ Wallet classification کے بغیر صرف number copy نہ کریں۔ کم از کم یہ categories الگ رکھیں:

• team/insider vesting
• treasury/reserve
• foundation/ecosystem
• staking/reward contracts
• bridge vaults
• liquidity pools
• centralized exchange custody
• burn/dead addresses
• unknown large wallets

Unknown wallet کو team یا exchange label نہ کریں جب تک public name tag، official disclosure یا transaction evidence نہ ہو۔ Holder balance identity نہیں۔

Step 5: Denominator منتخب کریں

Current issued circulation ratio

Rtotal = C ÷ T × 100

یہ بتاتا ہے کہ current total supply کا کتنا حصہ provider گردش میں شمار کرتا ہے۔

Maximum-cap circulation ratio

Rmax = C ÷ Smax × 100

یہ potential maximum کے مقابل current circulation دکھاتا ہے۔ Max code-enforced نہ ہو تو اسے policy/scenario ratio کہیں۔

Non-circulating share

N = 100 − R

Non-circulating share فوری sell pressure نہیں۔ Release dates، beneficiaries، transferability اور liquidity کے بغیر یہ صرف classification gap ہے۔

فرضی example: دونوں ratios کیوں مختلف ہیں؟

یہ فرضی numbers کسی حقیقی token کی current state نہیں:

• circulating C = 18 billion
• current total T = 30 billion
• documented max Smax = 60 billion

Rtotal = 18 ÷ 30 × 100 = 60%

Rmax = 18 ÷ 60 × 100 = 30%

“60% circulating” اور “30% of max circulating” دونوں arithmetic طور پر درست ہیں، مگر سوال الگ ہے۔ پہلی value current issued base دیکھتی ہے؛ دوسری future possible base۔ Report میں denominator چھپانے سے reader انہیں contradiction سمجھ سکتا ہے۔

Step 6: Multi-chain supply reconcile کریں

Multi-chain token میں ہر chain کی value جمع کرنا ہمیشہ درست نہیں۔ Architecture معلوم کریں:

1. Native issuance: ہر chain پر independently minted units ہو سکتے ہیں۔
2. Lock-and-mint bridge: source vault میں locked units destination representation back کرتی ہیں؛ جمع کرنے سے double count ہو سکتا ہے۔
3. Burn پھر destination mint: دونوں events کے درمیان وقت کا فرق عارضی mismatch بنا سکتا ہے۔
4. Canonical migration: old contract balances اور new contract issuance overlap دکھا سکتے ہیں۔

CoinGecko Supply Update FAQ multi-chain supply update کے methodological cases بیان کرتی ہے۔ Asset-specific bridge contracts اور official documentation پھر بھی ضروری ہیں۔

Step 7: Provider اختلاف کی وجہ لکھیں

دو circulating figures مختلف ہوں تو یہ checklist چلائیں:

• contract/mint same؟
• chain scope same؟
• capture time same؟
• decimals same؟
• burn treatment same؟
• locked wallet list same؟
• treasury/staking treatment same؟
• bridge backing same؟
• update cadence same؟

فرق کو percentage میں دکھا سکتے ہیں:

Relative difference = |C1 − C2| ÷ max(C1,C2) × 100

یہ metric صرف gap کا سائز ہے؛ کون سا source صحیح ہے، خود نہیں بتاتا۔ Methodology اور evidence فیصلہ کریں گے۔

Blockscout field کو circulating نہ سمجھیں

Blockscout token info API total_supply سمیت explorer fields دکھاتی ہے۔ Field name کو provider circulating label سے match نہ کریں۔ Explorer chain state، aggregator methodology اور project-reported allocation تین evidence layers ہیں۔

اپنے sheet میں columns رکھیں:

Wallet classification drill

Circulating estimate کی سب سے کمزور جگہ اکثر wallet labels ہوتی ہیں۔ Top holders export کر کے ہر address کو evidence category دیں، مگر نامعلوم wallet کے بارے میں کہانی نہ بنائیں۔

ہر label کے ساتھ source URL اور “last checked” time لکھیں۔ Public labels بدل سکتے ہیں، exchange wallets rotate ہو سکتے ہیں، اور bridge upgrades نئے vaults بنا سکتے ہیں۔ Classification confidence confirmed / supported / tentative / unknown رکھیں۔ Tentative wallet کو excluded circulating میں شامل یا خارج کرنے کے دونوں scenarios calculate کریں۔

مثلاً provider A کسی 4-billion wallet کو treasury کہہ کر exclude کرتا ہے مگر provider B اسے circulating میں رکھتا ہے۔ Identity evidence نامکمل ہو تو دو results دیں:

• Scenario A: wallet excluded
• Scenario B: wallet included

Difference کو uncertainty band کہیں، error correction نہیں۔

Rounding اور precision

Provider page “9.5B” دکھا سکتی ہے جبکہ API raw value زیادہ precision رکھتی ہے۔ Rounded values سے ratio نکال کر decimal places بڑھانا false precision ہے۔ Input جتنی significant digits دیتی ہے، output بھی اتنی ہی مناسب precision میں رکھیں۔ Display billions کو calculation سے پہلے exact field سے بدلیں، اور exact field نہ ملے تو result پر approx. label لگائیں۔

Percentage comparison میں denominator صفر، null یا uncapped ہو تو formula روکیں۔ Infinity یا 0% دکھانا مفید answer نہیں۔ Max supply undefined ہو تو current-total ratio دیں اور maximum ratio کو not applicable / unresolved رکھیں۔

Snapshot-to-snapshot movement

دو dates کے درمیان circulating increase:

ΔC = Cnew − Cold

Growth % = ΔC ÷ Cold × 100

Growth دیکھ کر فوراً mint conclusion نہ نکالیں۔ Provider نے پہلے سے issued wallet کو circulating reclassify کیا ہو سکتا ہے۔ On-chain total unchanged اور circulating بڑھی ہو تو classification/unlock possibility دیکھیں؛ total بھی بڑھی ہو تو mint/emission evidence check کریں؛ total گھٹی ہو تو burn mechanism دیکھیں۔

Unlock ratio الگ calculate کریں

اگر اگلے event میں U tokens circulation میں داخل ہونے کے قابل ہوں:

Potential increase % = U ÷ Ccurrent × 100

یہ maximum exposure ہے، guaranteed circulating increase نہیں۔ Tokens locked wallet سے نکل کر دوسرے restricted contract میں جا سکتے ہیں، recipient hold کر سکتا ہے یا schedule بدل سکتا ہے۔ Token unlock/dilution guide event verification کا الگ workflow دیتی ہے۔

Market cap میں کون سی supply لگائیں؟

Current market cap کے لیے methodology-based circulating supply استعمال ہوتی ہے۔ Total یا max supply لگانے سے result FDV یا alternate scenario بن جاتا ہے۔ Label بدلے بغیر denominator بدلنا misleading ہے۔ Market-cap worksheet price اور supply snapshot کو ایک record میں جوڑتی ہے۔

Common failure modes

• total اور circulating کو synonym سمجھنا
• 100 − ratio کو فوری unlock کہنا
• dead-address balance اور burn function کو ایک سمجھنا
• max supply null ہو تو total کو max بنا دینا
• multiple chains blindly جمع کرنا
• raw units پر decimals نہ لگانا
• unknown holder کو insider label کرنا
• old whitepaper allocation کو current balance کہنا
• provider update time نظرانداز کرنا
• rounded billions سے exact percentage دکھانا

Result statement template

“Contract ___ کے لیے source ___ نے وقت ___ پر circulating supply ___ دی۔ On-chain total ___ ہے اور selected denominator ___ ہے۔ اس لیے ratio ___% بنتی ہے۔ Provider methodology ___ wallets کو exclude کرتی ہے۔ Bridge، burn یا locked balance میں یہ items unresolved ہیں: ___۔”

یہ structure ratio کو evidence اور uncertainty سے جوڑتی ہے۔

آخری verification checklist

• full address اور chain محفوظ
• raw supply اور decimals دونوں check
• circulating provider methodology linked
• denominator name واضح
• total اور max الگ
• burn mechanism classify
• locked/treasury wallets list
• multi-chain bridge model read
• snapshot times compare
• ratio دوبارہ calculate
• non-circulating کو immediate sell pressure نہیں کہا
• unresolved assumptions visible

OpenZeppelin ERC-20 documentation standard implementations کا context دیتی ہے، جبکہ Ethereum ERC-20 contract tutorial supply-related code کو سمجھنے میں مدد دیتا ہے۔ یہ references کسی خاص token کی current circulating figure certify نہیں کرتے۔

یہ manual research worksheet ہے، live calculator یا financial advice نہیں۔ غلط supply، centralized control، bridge accounting اور کم liquidity مکمل loss کا خطرہ بڑھا سکتے ہیں۔ اہل صارف Binance دعوتی کوڈ BN8812 اپنی صوابدید پر استعمال کر سکتا ہے۔ سائٹ آپریٹر کے مطابق spot trading fee پر زیادہ سے زیادہ 20% رعایت ممکن ہے؛ اصل rate، eligibility، regional availability اور current terms Binance پر خود verify کریں۔