Проверка подписи
Передавайте в validate исходную строку и токен бота MAX. Серверный пакет декодирует параметры, исключает hash, сортирует остальные ключи и проверяет подпись через HMAC-SHA256. Только после успешной проверки подписи он интерпретирует вложенные данные пользователя и чата. Алгоритм MAX
validate и safeValidate
validate возвращает InitData или отклоняет Promise. safeValidate удобен для обычного разбора запроса. При ошибке входных данных он возвращает { ok: false, error }. При успешной проверке возвращает { ok: true, data }. Ошибки конфигурации и среды выполнения отклоняют Promise и в этом варианте.
import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';
import { safeValidate } from '@mwa.js/init-data';
const MAX_BODY_BYTES = 64 * 1024;
function json(response: ServerResponse, status: number, body: object) {
response.writeHead(status, {
'content-type': 'application/json; charset=utf-8',
'cache-control': 'no-store',
});
response.end(JSON.stringify(body));
}
async function readBody(request: IncomingMessage): Promise<Buffer | undefined> {
let bytes = 0;
const chunks: Buffer[] = [];
for await (const chunk of request.iterator({ destroyOnReturn: false }) as AsyncIterable<Buffer>) {
bytes += chunk.length;
if (bytes > MAX_BODY_BYTES) {
request.resume();
return undefined;
}
chunks.push(chunk);
}
return Buffer.concat(chunks, bytes);
}
export function createValidationServer(botToken: string) {
if (!botToken.trim()) throw new Error('Set MAX_BOT_TOKEN before starting the server.');
async function handle(request: IncomingMessage, response: ServerResponse) {
if (request.url !== '/api/validate') {
request.resume();
return json(response, 404, { error: 'not_found' });
}
if (request.method !== 'POST') {
request.resume();
response.setHeader('allow', 'POST');
return json(response, 405, { error: 'method_not_allowed' });
}
const contentType = request.headers['content-type']?.split(';', 1)[0]?.trim().toLowerCase();
if (contentType !== 'text/plain') {
request.resume();
return json(response, 415, { error: 'unsupported_media_type' });
}
const body = await readBody(request);
if (!body) return json(response, 413, { error: 'body_too_large' });
let raw: string;
try {
raw = new TextDecoder('utf-8', { fatal: true }).decode(body);
} catch {
return json(response, 400, { error: 'invalid_encoding' });
}
const result = await safeValidate(raw, botToken);
if (!result.ok || !result.data.user) {
return json(response, 401, { error: 'invalid_init_data' });
}
json(response, 200, { userId: result.data.user.id });
}
return createServer((request, response) => {
void handle(request, response).catch(() => {
if (!response.headersSent && !response.destroyed) {
json(response, 500, { error: 'internal_error' });
}
});
});
}Срок действия
expiresIn задаёт максимально допустимый возраст в секундах. По умолчанию применяется один час. Для своего сценария можно указать другое целое неотрицательное значение. expiresIn: 0 отключает проверку возраста, а проверка подписи остаётся включённой.
import { validate } from '@mwa.js/init-data';
export function validateRecentLaunch(raw: string, botToken: string) {
return validate(raw, botToken, { expiresIn: 300 });
}Проверьте протокол целиком по руководству авторизации. Для диагностики используйте коды ошибок.