serejaris/telegram-skills / skills/tg-miniapp-launch-auth
tg-miniapp-launch-auth
VerifiedUse when choosing how a Telegram Mini App opens (keyboard, inline or menu button, main app, direct link, startapp, join request) or when a server must trust a Mini App user: validating initData by HMAC or Ed25519, signature in the check string, auth_date, isVersionAtLeast gating, origin protection, test environment and debugging.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.0 KB |
| references/testing-debug.md | markdown | 2.3 KB |
| scripts/init_data.py | script | 2.9 KB |
| tests/test_ed25519.py | script | 1.2 KB |
| tests/test_init_data.py | script | 5.7 KB |
| tests/vectors.py | script | 1.1 KB |
scripts/init_data.py
View on GitHubimport base64
import hashlib
import hmac
import re
import time
from urllib.parse import parse_qsl
DEFAULT_MAX_AGE = 86400
_HASH = re.compile(r'[0-9a-fA-F]{64}')
_SIGNATURE = re.compile(r'[A-Za-z0-9_-]+={0,2}')
class InitDataError(ValueError):
def __init__(self, code):
super().__init__(code)
self.code = code
def parse_init_data(raw):
if not isinstance(raw, str) or not raw:
raise InitDataError('malformed')
try:
pairs = parse_qsl(raw, keep_blank_values=True, strict_parsing=True,
encoding='utf-8', errors='strict')
except (ValueError, UnicodeError) as error:
raise InitDataError('malformed') from error
fields = dict(pairs)
if len(fields) != len(pairs) or '' in fields:
raise InitDataError('malformed')
return fields
def _check_string(fields, excluded):
return '\n'.join(f'{key}={fields[key]}' for key in sorted(fields) if key not in excluded)
def data_check_string(fields):
return _check_string(fields, {'hash'})
def compute_hash(fields, bot_token):
if not isinstance(bot_token, str) or not bot_token:
raise InitDataError('malformed')
secret_key = hmac.new(b'WebAppData', bot_token.encode(), hashlib.sha256).digest()
return hmac.new(secret_key, data_check_string(fields).encode(), hashlib.sha256).hexdigest()
def validate(raw, bot_token, max_age=DEFAULT_MAX_AGE, now=None):
fields = parse_init_data(raw)
received = fields.get('hash')
if received is None:
raise InitDataError('missing_hash')
if not _HASH.fullmatch(received):
raise InitDataError('malformed')
if not hmac.compare_digest(compute_hash(fields, bot_token), received.lower()):
raise InitDataError('invalid_hash')
auth_date = fields.get('auth_date', '')
if not (auth_date.isascii() and auth_date.isdecimal()):
raise InitDataError('invalid_auth_date')
if isinstance(max_age, bool) or not isinstance(max_age, int) or max_age < 0:
raise InitDataError('malformed')
current = time.time() if now is None else now
if max_age and current - int(auth_date) > max_age:
raise InitDataError('expired')
return fields
def third_party_payload(raw, bot_id):
if isinstance(bot_id, bool) or not isinstance(bot_id, int) or bot_id <= 0:
raise InitDataError('malformed')
fields = parse_init_data(raw)
signature = fields.get('signature')
if signature is None:
raise InitDataError('missing_signature')
if not _SIGNATURE.fullmatch(signature):
raise InitDataError('malformed')
stripped = signature.rstrip('=')
try:
decoded = base64.urlsafe_b64decode(stripped + '=' * (-len(stripped) % 4))
except ValueError as error:
raise InitDataError('malformed') from error
if len(decoded) != 64:
raise InitDataError('malformed')
message = f'{bot_id}:WebAppData\n' + _check_string(fields, {'hash', 'signature'})
return message.encode(), decoded
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |