@tgsnake/skema 1.13.0 → 2.0.0

package/dist/src/raw/core/primitive/Bool.d.ts

@@ -0,0 +1,104 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { BytesIO, Buffer } from '../../../deps.js';
+/**
+ * Represents the false boolean constructor in the Telegram MTProto schema.
+ *
+ * @extends TLObject
+ */
+export declare class BoolFalse extends TLObject {
+    /**
+     * Unique Class ID representing `BoolFalse` (0xbc799737).
+     */
+    static ID: number;
+    /**
+     * The underlying native boolean value representation.
+     */
+    static value: boolean;
+    /**
+     * Serializes the `BoolFalse` class ID into a 4-byte buffer (little-endian).
+     *
+     * @override
+     * @returns A Buffer containing the serialized Class ID.
+     */
+    static write(): Buffer;
+    /**
+     * Reads the boolean value from a stream (always resolves to `false`).
+     *
+     * @param _data - Unused BytesIO stream.
+     * @param _arg - Unused arguments.
+     * @returns A promise resolving to `false`.
+     */
+    static read(_data: BytesIO, ..._arg: Array<any>): Promise<boolean>;
+}
+/**
+ * Represents the true boolean constructor in the Telegram MTProto schema.
+ *
+ * @extends BoolFalse
+ */
+export declare class BoolTrue extends BoolFalse {
+    /**
+     * Unique Class ID representing `BoolTrue` (0x997275b5).
+     */
+    static ID: number;
+    /**
+     * The underlying native boolean value representation.
+     */
+    static value: boolean;
+    /**
+     * Serializes the `BoolTrue` class ID into a 4-byte buffer (little-endian).
+     *
+     * @override
+     * @returns A Buffer containing the serialized Class ID.
+     */
+    static write(): Buffer;
+    /**
+     * Reads the boolean value from a stream (always resolves to `true`).
+     *
+     * @param _data - Unused BytesIO stream.
+     * @param _arg - Unused arguments.
+     * @returns A promise resolving to `true`.
+     */
+    static read(_data: BytesIO, ..._arg: Array<any>): Promise<boolean>;
+}
+/**
+ * Dynamic dispatcher class representing MTProto abstract boolean values.
+ *
+ * @remarks
+ * In MTProto, boolean values are represented as explicit class instances (`BoolTrue` or `BoolFalse`)
+ * rather than raw bits or primitive bytes. This class coordinates dynamic serialization and
+ * deserialization between native JavaScript boolean values (`true`/`false`) and the corresponding MTProto constructors.
+ *
+ * @extends TLObject
+ * @example
+ * ```typescript
+ * const buffer = Bool.write(true); // Serializes `true` to a Buffer using BoolTrue
+ * const val = await Bool.read(bytesIO); // Deserializes from stream to native boolean
+ * ```
+ */
+export declare class Bool extends TLObject {
+    className: string;
+    /**
+     * Serializes a native JS boolean value into a Buffer using the appropriate constructor.
+     *
+     * @param value - The boolean value to serialize.
+     * @returns A Buffer containing the serialized `BoolTrue` or `BoolFalse` representation.
+     */
+    static write(value: boolean): Buffer;
+    /**
+     * Reads a 32-bit boolean constructor identifier from the stream and resolves it to a native boolean.
+     *
+     * @param data - The `BytesIO` stream to read from.
+     * @param _arg - Unused arguments.
+     * @returns A promise resolving to the decoded boolean value.
+     */
+    static read(data: BytesIO, ..._arg: Array<any>): Promise<boolean>;
+}

package/dist/src/raw/core/primitive/Bool.js

@@ -0,0 +1,120 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { Buffer } from '../../../deps.js';
+/**
+ * Represents the false boolean constructor in the Telegram MTProto schema.
+ *
+ * @extends TLObject
+ */
+export class BoolFalse extends TLObject {
+    /**
+     * Unique Class ID representing `BoolFalse` (0xbc799737).
+     */
+    static ID = 0xbc799737;
+    /**
+     * The underlying native boolean value representation.
+     */
+    static value = false;
+    /**
+     * Serializes the `BoolFalse` class ID into a 4-byte buffer (little-endian).
+     *
+     * @override
+     * @returns A Buffer containing the serialized Class ID.
+     */
+    static write() {
+        const buff = Buffer.alloc(4);
+        buff.writeUInt32LE(BoolFalse.ID);
+        return buff;
+    }
+    /**
+     * Reads the boolean value from a stream (always resolves to `false`).
+     *
+     * @param _data - Unused BytesIO stream.
+     * @param _arg - Unused arguments.
+     * @returns A promise resolving to `false`.
+     */
+    static async read(_data, ..._arg) {
+        return BoolFalse.value;
+    }
+}
+/**
+ * Represents the true boolean constructor in the Telegram MTProto schema.
+ *
+ * @extends BoolFalse
+ */
+export class BoolTrue extends BoolFalse {
+    /**
+     * Unique Class ID representing `BoolTrue` (0x997275b5).
+     */
+    static ID = 0x997275b5;
+    /**
+     * The underlying native boolean value representation.
+     */
+    static value = true;
+    /**
+     * Serializes the `BoolTrue` class ID into a 4-byte buffer (little-endian).
+     *
+     * @override
+     * @returns A Buffer containing the serialized Class ID.
+     */
+    static write() {
+        const buff = Buffer.alloc(4);
+        buff.writeUInt32LE(BoolTrue.ID);
+        return buff;
+    }
+    /**
+     * Reads the boolean value from a stream (always resolves to `true`).
+     *
+     * @param _data - Unused BytesIO stream.
+     * @param _arg - Unused arguments.
+     * @returns A promise resolving to `true`.
+     */
+    static async read(_data, ..._arg) {
+        return BoolTrue.value;
+    }
+}
+/**
+ * Dynamic dispatcher class representing MTProto abstract boolean values.
+ *
+ * @remarks
+ * In MTProto, boolean values are represented as explicit class instances (`BoolTrue` or `BoolFalse`)
+ * rather than raw bits or primitive bytes. This class coordinates dynamic serialization and
+ * deserialization between native JavaScript boolean values (`true`/`false`) and the corresponding MTProto constructors.
+ *
+ * @extends TLObject
+ * @example
+ * ```typescript
+ * const buffer = Bool.write(true); // Serializes `true` to a Buffer using BoolTrue
+ * const val = await Bool.read(bytesIO); // Deserializes from stream to native boolean
+ * ```
+ */
+export class Bool extends TLObject {
+    className = 'Bool';
+    /**
+     * Serializes a native JS boolean value into a Buffer using the appropriate constructor.
+     *
+     * @param value - The boolean value to serialize.
+     * @returns A Buffer containing the serialized `BoolTrue` or `BoolFalse` representation.
+     */
+    static write(value) {
+        return value ? BoolTrue.write() : BoolFalse.write();
+    }
+    /**
+     * Reads a 32-bit boolean constructor identifier from the stream and resolves it to a native boolean.
+     *
+     * @param data - The `BytesIO` stream to read from.
+     * @param _arg - Unused arguments.
+     * @returns A promise resolving to the decoded boolean value.
+     */
+    static async read(data, ..._arg) {
+        return data.readUInt32LE(4) === BoolTrue.ID;
+    }
+}

package/dist/src/raw/core/primitive/Bytes.d.ts

@@ -0,0 +1,45 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { BytesIO, Buffer } from '../../../deps.js';
+/**
+ * Serializer and deserializer for raw, variable-length byte arrays.
+ *
+ * @remarks
+ * In MTProto, raw byte arrays are serialized with a custom length-prefix scheme:
+ * - If the array is 253 bytes or shorter:
+ *   - The first byte contains the exact length.
+ *   - Followed by the raw payload bytes.
+ *   - Followed by `0-3` padding bytes to align the entire block to a 4-byte boundary.
+ * - If the array is longer than 253 bytes:
+ *   - The first byte is written as exactly `254` (0xfe).
+ *   - The next 3 bytes contain the little-endian length.
+ *   - Followed by the raw payload bytes.
+ *   - Followed by `0-3` padding bytes to align the entire block to a 4-byte boundary.
+ *
+ * @extends TLObject
+ */
+export declare class Bytes extends TLObject {
+    /**
+     * Serializes a Node.js Buffer value into a length-prefixed and padded MTProto binary structure.
+     *
+     * @param value - The input Buffer to serialize.
+     * @returns A Buffer containing the formatted prefix, data, and padding bytes.
+     */
+    static write(value: Buffer): Buffer;
+    /**
+     * Reads, decodes, and aligns a variable-length byte array from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the byte array from.
+     * @param _args - Unused additional parameters.
+     * @returns A promise resolving to the decoded Node.js Buffer.
+     */
+    static read(data: BytesIO, ..._args: Array<any>): Promise<Buffer>;
+}

package/dist/src/raw/core/primitive/Bytes.js

@@ -0,0 +1,76 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { Buffer } from '../../../deps.js';
+import { bufferToBigint, bigintToBuffer, mod } from '../../../helpers.js';
+/**
+ * Serializer and deserializer for raw, variable-length byte arrays.
+ *
+ * @remarks
+ * In MTProto, raw byte arrays are serialized with a custom length-prefix scheme:
+ * - If the array is 253 bytes or shorter:
+ *   - The first byte contains the exact length.
+ *   - Followed by the raw payload bytes.
+ *   - Followed by `0-3` padding bytes to align the entire block to a 4-byte boundary.
+ * - If the array is longer than 253 bytes:
+ *   - The first byte is written as exactly `254` (0xfe).
+ *   - The next 3 bytes contain the little-endian length.
+ *   - Followed by the raw payload bytes.
+ *   - Followed by `0-3` padding bytes to align the entire block to a 4-byte boundary.
+ *
+ * @extends TLObject
+ */
+export class Bytes extends TLObject {
+    /**
+     * Serializes a Node.js Buffer value into a length-prefixed and padded MTProto binary structure.
+     *
+     * @param value - The input Buffer to serialize.
+     * @returns A Buffer containing the formatted prefix, data, and padding bytes.
+     */
+    static write(value) {
+        const length = Buffer.byteLength(value);
+        if (length <= 253) {
+            return Buffer.concat([
+                Buffer.from([length]),
+                value,
+                Buffer.alloc(mod(-(length + 1), 4)),
+            ]);
+        }
+        else {
+            return Buffer.concat([
+                Buffer.from([254]),
+                bigintToBuffer(BigInt(length), 3),
+                value,
+                Buffer.alloc(mod(-length, 4)),
+            ]);
+        }
+    }
+    /**
+     * Reads, decodes, and aligns a variable-length byte array from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the byte array from.
+     * @param _args - Unused additional parameters.
+     * @returns A promise resolving to the decoded Node.js Buffer.
+     */
+    static async read(data, ..._args) {
+        let length = data.read(1)[0];
+        if (length <= 253) {
+            const x = data.read(length);
+            data.read(mod(-(length + 1), 4));
+            return x;
+        }
+        else {
+            length = Number(bufferToBigint(data.read(3)));
+            const x = data.read(length);
+            data.read(mod(-length, 4));
+            return x;
+        }
+    }
+}

package/dist/src/raw/core/primitive/Double.d.ts

@@ -0,0 +1,37 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { BytesIO, Buffer } from '../../../deps.js';
+/**
+ * Serializer and deserializer for double-precision 64-bit floating-point numbers (IEEE 754).
+ *
+ * @remarks
+ * In MTProto, double-precision floats are represented as 8 bytes, typically in little-endian order.
+ *
+ * @extends TLObject
+ */
+export declare class Double extends TLObject {
+    /**
+     * Serializes a JS `number` into an 8-byte buffer.
+     *
+     * @param value - The floating-point number to serialize.
+     * @param little - Set to `true` to use little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A Buffer containing the 8-byte representation of the double.
+     */
+    static write(value: number, little?: boolean): Buffer;
+    /**
+     * Reads and decodes a double-precision floating-point number from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the double from.
+     * @param little - Set to `true` to read in little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A promise resolving to the decoded number value.
+     */
+    static read(data: BytesIO, little?: boolean): Promise<number>;
+}

package/dist/src/raw/core/primitive/Double.js

@@ -0,0 +1,51 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { Buffer } from '../../../deps.js';
+/**
+ * Serializer and deserializer for double-precision 64-bit floating-point numbers (IEEE 754).
+ *
+ * @remarks
+ * In MTProto, double-precision floats are represented as 8 bytes, typically in little-endian order.
+ *
+ * @extends TLObject
+ */
+export class Double extends TLObject {
+    /**
+     * Serializes a JS `number` into an 8-byte buffer.
+     *
+     * @param value - The floating-point number to serialize.
+     * @param little - Set to `true` to use little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A Buffer containing the 8-byte representation of the double.
+     */
+    static write(value, little = true) {
+        const buffer = Buffer.alloc(8);
+        if (little) {
+            buffer.writeDoubleLE(value);
+        }
+        else {
+            buffer.writeDoubleBE(value);
+        }
+        return buffer;
+    }
+    /**
+     * Reads and decodes a double-precision floating-point number from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the double from.
+     * @param little - Set to `true` to read in little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A promise resolving to the decoded number value.
+     */
+    static async read(data, little = true) {
+        if (little) {
+            return data.readDoubleLE();
+        }
+        return data.readDoubleBE();
+    }
+}

package/dist/src/raw/core/primitive/Float.d.ts

@@ -0,0 +1,37 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { BytesIO, Buffer } from '../../../deps.js';
+/**
+ * Serializer and deserializer for single-precision 32-bit floating-point numbers (IEEE 754).
+ *
+ * @remarks
+ * In MTProto, single-precision floats are represented as 4 bytes, typically in little-endian order.
+ *
+ * @extends TLObject
+ */
+export declare class Float extends TLObject {
+    /**
+     * Serializes a JS `number` into a 4-byte buffer.
+     *
+     * @param value - The floating-point number to serialize.
+     * @param little - Set to `true` to use little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A Buffer containing the 4-byte representation of the float.
+     */
+    static write(value: number, little?: boolean): Buffer;
+    /**
+     * Reads and decodes a single-precision floating-point number from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the float from.
+     * @param little - Set to `true` to read in little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A promise resolving to the decoded number value.
+     */
+    static read(data: BytesIO, little?: boolean): Promise<number>;
+}

package/dist/src/raw/core/primitive/Float.js

@@ -0,0 +1,51 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { Buffer } from '../../../deps.js';
+/**
+ * Serializer and deserializer for single-precision 32-bit floating-point numbers (IEEE 754).
+ *
+ * @remarks
+ * In MTProto, single-precision floats are represented as 4 bytes, typically in little-endian order.
+ *
+ * @extends TLObject
+ */
+export class Float extends TLObject {
+    /**
+     * Serializes a JS `number` into a 4-byte buffer.
+     *
+     * @param value - The floating-point number to serialize.
+     * @param little - Set to `true` to use little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A Buffer containing the 4-byte representation of the float.
+     */
+    static write(value, little = true) {
+        const buffer = Buffer.alloc(4);
+        if (little) {
+            buffer.writeFloatLE(value);
+        }
+        else {
+            buffer.writeFloatBE(value);
+        }
+        return buffer;
+    }
+    /**
+     * Reads and decodes a single-precision floating-point number from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the float from.
+     * @param little - Set to `true` to read in little-endian byte ordering; set to `false` for big-endian. Defaults to `true`.
+     * @returns A promise resolving to the decoded number value.
+     */
+    static async read(data, little = true) {
+        if (little) {
+            return data.readFloatLE();
+        }
+        return data.readFloatBE();
+    }
+}

package/dist/src/raw/core/primitive/Int.d.ts

@@ -0,0 +1,144 @@
+/**
+ * tgsnake - Telegram MTProto library for javascript or typescript.
+ * Copyright (C) 2026 tgsnake <https://github.com/tgsnake>
+ *
+ * THIS FILE IS PART OF TGSNAKE
+ *
+ * tgsnake is a free software: you can redistribute it and/or modify
+ * it under the terms of the MIT License as published.
+ */
+import { TLObject } from '../TLObject.js';
+import { BytesIO, Buffer } from '../../../deps.js';
+/**
+ * Serializer and deserializer for standard 32-bit (4-byte) signed or unsigned integers.
+ *
+ * @extends TLObject
+ */
+export declare class Int extends TLObject {
+    /**
+     * The byte size of a standard 32-bit integer (4 bytes).
+     */
+    static SIZE: number;
+    /**
+     * Serializes a 32-bit integer into a Buffer.
+     *
+     * @param value - The integer value to write (accepts `number` or `bigint`).
+     * @param signed - Set to `true` if the integer is signed; set to `false` if unsigned. Defaults to `true`.
+     * @param little - Set to `true` to write in little-endian format; set to `false` for big-endian. Defaults to `true`.
+     * @returns A Buffer containing the 4-byte representation of the integer.
+     */
+    static write(value: number | bigint, signed?: boolean, little?: boolean): Buffer;
+    /**
+     * Reads and decodes a 32-bit integer from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the integer from.
+     * @param signed - Set to `true` to parse as a signed integer; set to `false` for unsigned. Defaults to `true`.
+     * @param little - Set to `true` to read in little-endian format; set to `false` for big-endian. Defaults to `true`.
+     * @param size - The exact number of bytes to read from the stream. Defaults to `Int.SIZE`.
+     * @returns A promise resolving to the decoded number.
+     */
+    static read(data: BytesIO, signed?: boolean, little?: boolean, size?: number): Promise<number>;
+}
+/**
+ * Serializer and deserializer for 64-bit (8-byte) signed or unsigned integers.
+ *
+ * @remarks
+ * In MTProto, 64-bit integers are heavily used for message IDs, session IDs, chat IDs,
+ * and salt values. Because standard JS numbers only support safe integers up to 53 bits,
+ * this class operates on native JavaScript `bigint` values.
+ *
+ * @extends TLObject
+ */
+export declare class Long extends TLObject {
+    /**
+     * The byte size of a 64-bit long integer (8 bytes).
+     */
+    static SIZE: number;
+    /**
+     * Reads and decodes a 64-bit integer from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the long integer from.
+     * @param signed - Set to `true` to parse as a signed integer; set to `false` for unsigned. Defaults to `true`.
+     * @param little - Set to `true` to read in little-endian format; set to `false` for big-endian. Defaults to `true`.
+     * @param size - The exact number of bytes to read from the stream. Defaults to `Long.SIZE`.
+     * @returns A promise resolving to the decoded native `bigint`.
+     */
+    static read(data: BytesIO, signed?: boolean, little?: boolean, size?: number): Promise<bigint>;
+    /**
+     * Serializes a 64-bit integer value into a Buffer.
+     *
+     * @param value - The native `bigint` value to serialize.
+     * @param signed - Set to `true` if the integer is signed; set to `false` if unsigned. Defaults to `true`.
+     * @param little - Set to `true` to write in little-endian format; set to `false` for big-endian. Defaults to `true`.
+     * @returns A Buffer containing the 8-byte representation of the 64-bit integer.
+     */
+    static write(value: bigint, signed?: boolean, little?: boolean): Buffer;
+}
+/**
+ * Serializer and deserializer for 128-bit (16-byte) integers.
+ *
+ * @remarks
+ * Used in MTProto cryptographic handshakes, secure nonces, and session key generation.
+ * Operates on native JavaScript `bigint` values.
+ *
+ * @extends Long
+ */
+export declare class Int128 extends Long {
+    /**
+     * The byte size of a 128-bit integer (16 bytes).
+     */
+    static SIZE: number;
+    /**
+     * Reads and decodes a 128-bit integer from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the integer from.
+     * @param signed - Set to `true` to parse as signed; set to `false` for unsigned. Defaults to `true`.
+     * @param little - Set to `true` to read in little-endian format; set to `false` for big-endian. Defaults to `true`.
+     * @param size - The exact number of bytes to read from the stream. Defaults to `Int128.SIZE`.
+     * @returns A promise resolving to the decoded native `bigint`.
+     */
+    static read(data: BytesIO, signed?: boolean, little?: boolean, size?: number): Promise<bigint>;
+    /**
+     * Serializes a 128-bit integer into a Buffer.
+     *
+     * @param value - The native `bigint` to serialize.
+     * @param _signed - Unused parameter.
+     * @param _little - Unused parameter.
+     * @returns A Buffer containing the 16-byte representation of the 128-bit integer.
+     */
+    static write(value: bigint, _signed?: boolean, _little?: boolean): Buffer;
+}
+/**
+ * Serializer and deserializer for 256-bit (32-byte) integers.
+ *
+ * @remarks
+ * Extensively used in cryptographic tasks, DH (Diffie-Hellman) parameters, and authorization key hashing.
+ * Operates on native JavaScript `bigint` values.
+ *
+ * @extends Long
+ */
+export declare class Int256 extends Long {
+    /**
+     * The byte size of a 256-bit integer (32 bytes).
+     */
+    static SIZE: number;
+    /**
+     * Reads and decodes a 256-bit integer from a binary stream.
+     *
+     * @param data - The `BytesIO` stream to read the integer from.
+     * @param signed - Set to `true` to parse as signed; set to `false` for unsigned. Defaults to `true`.
+     * @param little - Set to `true` to read in little-endian format; set to `false` for big-endian. Defaults to `true`.
+     * @param size - The exact number of bytes to read from the stream. Defaults to `Int256.SIZE`.
+     * @returns A promise resolving to the decoded native `bigint`.
+     */
+    static read(data: BytesIO, signed?: boolean, little?: boolean, size?: number): Promise<bigint>;
+    /**
+     * Serializes a 256-bit integer into a Buffer.
+     *
+     * @param value - The native `bigint` to serialize.
+     * @param _signed - Unused parameter.
+     * @param _little - Unused parameter.
+     * @returns A Buffer containing the 32-byte representation of the 256-bit integer.
+     */
+    static write(value: bigint, _signed?: boolean, _little?: boolean): Buffer;
+}