Error codes

DAT implementations انسانی-readable messages سے الگ stable error codes فراہم کرتی ہیں۔ Programs کو message strings کا موازنہ کرنے کے بجائے code اور retry classification سے فیصلے کرنے چاہییں۔

Code format

text

DAT_<AREA>_<CAUSE>

Prefix	Area
`DAT_TOKEN_`	DAT strings اور expiration
`DAT_CERT_`	Certificate strings اور state
`DAT_SIG_`	Signatures اور verification
`DAT_CRYPTO_`	Encryption اور decryption
`DAT_KEY_`	Key formats اور authority
`DAT_MANAGER_`	Certificate managers
`DAT_CONFIG_`	Call arguments اور configuration
`DAT_INTERNAL_`	Runtime internals
`DAT_CMS_`	CMS client synchronization
`DAT_AUTH_`, `DAT_REQ_`, `DAT_STORE_`	CMS server

_UNKNOWN صرف تب استعمال ہوتا ہے جب error کو اپنے area کے کسی دوسرے code میں classify نہ کیا جا سکے۔ ایک ہی cause تمام areas میں ایک ہی نام استعمال کرتی ہے۔

Retry classifications

Classification	مطلب	طریقہ
Transient	بیرونی حالت بحال ہونے پر کامیاب ہو سکتا ہے	backoff کے ساتھ محدود بار retry کریں
State	certificate synchronization یا وقت بدلنے کے بعد کامیاب ہو سکتا ہے	مطلوبہ state refresh کرکے retry کریں
Permanent	اسی input کے ساتھ پھر ناکام ہوگا	input، configuration یا code درست کریں

Tokens اور certificates

DAT_TOKEN_MALFORMEDکوئی اثر نہیںمستقل

DAT کا field count، numeric value یا Base64Url representation غلط ہے۔ input ضائع کر دیں۔

DAT_TOKEN_EXPIREDکوئی اثر نہیںمستقل

DAT کا expiration time موجودہ وقت کے برابر یا پہلے ہے۔ نیا DAT حاصل کریں۔

DAT_CERT_MALFORMEDکوئی اثر نہیںمستقل

Certificate string کی structure یا field representation غلط ہے۔

DAT_CERT_NOT_FOUNDکوئی اثر نہیںState

کوئی certificate DAT کے `cid` سے نہیں ملتا۔ certificate synchronization state چیک کریں۔

DAT_CERT_NOT_SYNCEDکوئی اثر نہیںState

مطلوبہ certificate شاید ابھی service تک نہ پہنچا ہو۔ فوراً synchronize کرکے دوبارہ جانچیں۔

DAT_CERT_NOT_YET_VALIDکوئی اثر نہیںState

Certificate کا start time ابھی نہیں آیا۔ system clock اور certificate distribution timing چیک کریں۔

DAT_CERT_EXPIREDکوئی اثر نہیںمستقل

Certificate کی verification period ختم ہو گئی ہے۔

DAT_CERT_DUPLICATEجزویمستقل

ایک import list میں ایک ہی `cid` ایک سے زیادہ بار ہے۔ پورا import رد کریں۔

Signatures، encryption اور keys

DAT_SIG_MISMATCHکوئی اثر نہیںمستقلshieldمشکوک

Signature body سے نہیں ملتا۔ DAT بدلا گیا ہے یا مختلف key سے signed ہے۔

DAT_CRYPTO_TAG_MISMATCHکوئی اثر نہیںمستقلshieldمشکوک

AES-GCM authentication tag نہیں ملتا۔ ciphertext tampering یا certificate mismatch چیک کریں۔

DAT_KEY_INVALIDکوئی اثر نہیںمستقل

Key length، format یا algorithm combination غلط ہے۔

DAT_SIG_KEY_MISSINGکوئی اثر نہیںمستقل

Verify-only certificate سے DAT issue کرنے کی کوشش ہوئی۔ issuing service کو full certificate چاہیے۔

DAT_SIG_MISMATCH اور DAT_CRYPTO_TAG_MISMATCH public security-event API میں true classify ہونے والے errors ہیں۔ ایک invalid input service outage نہیں، مگر بار بار ہونے کو security observation سمجھنا چاہیے۔

Managers اور configuration

DAT_MANAGER_NO_CERTIFICATEجزویState

Manager کے پاس certificates نہیں۔ certificates import کریں یا CMS synchronization مکمل کریں۔

DAT_MANAGER_NO_ISSUABLE_CERTIFICATEجزویState

Manager کے پاس certificates ہیں، مگر کوئی full certificate ابھی issuable نہیں۔ expiration، start time یا verify-only state کے لیے cause chain دیکھیں۔

DAT_CONFIG_ARGUMENT_INVALIDکوئی اثر نہیںمستقل

Call argument یا configuration value جائز range سے باہر ہے۔

DAT_INTERNAL_UNAVAILABLEسنگینمستقل

موجودہ platform کو درکار cryptographic یا network capability دستیاب نہیں۔

CMS clients

Code	مطلب	عام طریقہ
`DAT_CMS_URI_INVALID`	غلط CMS URI	configuration درست کریں
`DAT_CMS_UNAUTHORIZED`	authentication ناکام	token درست کریں
`DAT_CMS_FORBIDDEN`	token role کے پاس permission نہیں	token role چیک کریں
`DAT_CMS_ENDPOINT_NOT_FOUND`	path غائب یا مختلف ہے	CMS URL اور path چیک کریں
`DAT_CMS_NETWORK`	connection یا transfer ناکام	network چیک کرکے backoff کریں
`DAT_CMS_TIMEOUT`	time limit تجاوز	network اور timeout settings بدلیں
`DAT_CMS_SERVER_ERROR`	CMS server error	server state چیک کرکے backoff کریں
`DAT_CMS_RESPONSE_INVALID`	کامیاب response format غلط	server-client contract چیک کریں
`DAT_CMS_VERSION_RESET`	server version پیچھے گیا	CMS data اور deployment state چیک کریں
`DAT_CMS_IMPORT_FAILED`	موصول certificates apply نہ ہوئے	cause chain دیکھیں
`DAT_CMS_STOPPED`	stopped manager استعمال ہوا	نیا manager بنائیں یا call order درست کریں

Best-effort initial synchronization والی libraries error کو last-error field میں رکھتی ہیں۔ startup ناکام کرنا ہو تو error براہِ راست return یا throw کرنے والا immediate synchronization API استعمال کریں۔

CMS server

Code	HTTP	مطلب
`DAT_AUTH_UNAUTHORIZED`	401	token غائب یا invalid ہے
`DAT_AUTH_FORBIDDEN`	403	token role request کی اجازت نہیں دیتا
`DAT_REQ_ALG_UNSUPPORTED`	400	Unsupported algorithm name
`DAT_REQ_NOT_FOUND`	404·405	Path یا method mismatch
`DAT_REQ_TOO_LARGE`	413	oversized request body کے لیے reserved code
`DAT_STORE_UNAVAILABLE`	503	storage عارضی طور پر unavailable
`DAT_STORE_UNKNOWN`	500	unclassified storage-processing error

موجودہ clients non-2xx JSON responses کا server code براہِ راست expose نہیں کرتے بلکہ HTTP status کو DAT_CMS_* code میں بدلتے ہیں۔ اس لیے server logs اور client error codes مختلف ہو سکتے ہیں۔

زبان کے لحاظ سے access

Environment	Error code	Retry classification
Rust	`err.code()`	`err.retry()`
Go	`dat.Code(err)`	`dat.Retry(err)`
JavaScript / TypeScript	`error.code`	`error.retry`
Python	`error.code`	`error.retry`
Ruby	`error.code`	`error.retry`
Java / Kotlin	`error.code`	`error.retry`
C#	`error.Code`	`error.Retry`
C / C++	`dat_error_code(error)`	`dat_error_retry(error)`

Lower-level cause والے errors کے لیے زبان کی exception chain یا cause-access API دیکھیں۔

Error codes ​

Code format ​

Retry classifications ​

Tokens اور certificates ​

Signatures، encryption اور keys ​

Managers اور configuration ​

CMS clients ​

CMS server ​

زبان کے لحاظ سے access ​