Metadata-Version: 2.4
Name: TikSign
Version: 0.5.9999999
Summary: TikSign - Python toolkit for request signing utilities
Home-page: https://github.com/Gisnsl
Author: Ahmed Al-Harani
Author-email: alhranyahmed@gmail.com
License: MIT
Keywords: python,signing,crypto,security,api,requests
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pycryptodome
Requires-Dist: uuid
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# TikSign - TikTok Signature & Encryption Library

![Version](https://img.shields.io/badge/version-0.5.9999999-blue)
![Python](https://img.shields.io/badge/python-3.8%2B-green)
![License](https://img.shields.io/badge/license-MIT-lightgrey)

مكتبة بايثون متكاملة لتوليد توقيعات ورؤوس حماية TikTok API.

---

## ✨ المميزات

- 🔐 **توليد X-Gorgon** - خوارزمية التوقيع الأساسية
- 🛡️ **توليد X-Argus** - تشفير متقدم للطلبات
- 🔑 **توليد X-Ladon** - مفتاح حماية إضافي
- 🎯 **توليد X-TT-Trace-ID** - تتبع الطلبات
- 📱 **User-Agent عشوائي** - دعم 18+ علامة تجارية للأجهزة
- 🧩 **تشفير XOR** - تشفير/فك تشفير بسيط
- 📦 **Protobuf** - ترميز/فك ترميز Protocol Buffers
- 🔒 **AES-256** - تشفير مخصص (ECB/CBC)
- 🔁 **SHA-512** - دالة هاش مخصصة

---

## 📦 التثبيت

```bash
pip install TikSign==0.5.9999999
```

لأجهزة Pydroid 3/Termux:

```bash
pip install TikSign==0.5.9999999 --extra-index-url https://pypi.org/simple/
```

---

🚀 الاستخدام السريع

```python
from TikSign import sign

# توقيع طلب API
headers = sign(
    url="https://api.tiktok.com/endpoint",
    params={"aid": "1233"},
    data={"key": "value"}
)

print(headers)
# {
#     'x-gorgon': '8404...',
#     'x-argus': '8gHi...',
#     'x-ladon': 'tG9v...',
#     'x-khronos': '1712345678',
#     'x-tt-trace-id': '00-...-01',
#     'x-ss-stub': 'A1B2C3...'
# }
```

---

📚 الدوال الرئيسية

sign(url, params, data, cookie, payload)

توليد جميع رؤوس الحماية لطلب واحد.

المعامل النوع الوصف
url str رابط API
params dict/str معاملات الرابط
data str/dict بيانات الطلب
cookie str/dict كوكيز الطلب
payload str بديل للبيانات

المخرجات: dict يحتوي على:

· x-gorgon
· x-argus
· x-ladon
· x-khronos
· x-tt-trace-id
· x-ss-stub (إذا وجدت بيانات)
· x-ss-req-ticket

---

UserAgentTik(params)

توليد User-Agent عشوائي واقعي.

```python
from TikSign import UserAgentTik

ua = UserAgentTik()
print(ua['User-Agent'])
# com.zhiliaoapp.musically/2024602030 (Linux; U; Android 13; ar_YE; Galaxy S24 Ultra; ...)
```

الأجهزة المدعومة: Samsung, Xiaomi, Huawei, Honor, Google Pixel, OnePlus, Oppo, Realme, Vivo, Sony, Motorola, Nokia, Asus, Infinix, Tecno, Lenovo, ZTE, Meizu

---

Newparams(params)

إضافة بارامترات عشوائية للطلب.

```python
from TikSign import Newparams

params = Newparams({"aid": "1233"})
print(params)
# {'aid': '1233', '_rticket': 1712345678000, 'cdid': 'uuid-here', 'ts': 1712345678, ...}
```

---

xor_encrypt(text, key=5) / xor_decrypt(hex_str, key=5)

تشفير وفك تشفير XOR بسيط.

```python
from TikSign import xor_encrypt, xor_decrypt

enc = xor_encrypt("Hello", key=5)  # "6d616a6a6f"
dec = xor_decrypt(enc, key=5)      # "Hello"
```

---

دوال مساعدة

الدالة الوصف
AID(params) استخراج aid من البارامترات
version_code(params) استخراج version_code
version_name(params) استخراج version_name
generate_stub(data) توليد x-ss-stub من البيانات

---

🧩 الوحدات الداخلية

الوحدة الوصف
TikSign.py الدوال الرئيسية والـ API العام
gorgon.py خوارزمية X-Gorgon
argus.py خوارزمية X-Argus + AES + Protobuf + SHA-512
ladon.py خوارزمية X-Ladon
tracetik.py توليد X-TT-Trace-ID
xor.py تشفير XOR بسيط
guard.py وحدة مساعدة للتشفير

---

⚙️ المتطلبات

· Python >= 3.8
· pycryptodome

---

👤 المطور

Ahmed Alhrrani

· GitHub: @Gisnsl
· Telegram: @maho_s9

---

⚠️ تنبيه

هذه المكتبة لأغراض تعليمية وبحثية فقط. استخدامها يجب أن يتوافق مع شروط خدمة TikTok.

---

📄 الترخيص

MIT License - انظر ملف LICENSE

