Download the PHP package amashukov/ton-cell-php without Composer

amashukov/ton-cell-php

Pure-PHP TLB Cell, Builder, Slice and canonical BOC encoder for The Open Network (TON) — byte-for-byte parity with @ton/core.

amashukov/ton-cell-php implements the TLB (Type Language - Binary) cell layer for The Open Network (TON) in pure PHP: Cell, Builder, Slice, and a canonical BOC (Bag of Cells) serializer. It is a byte-exact equivalent of the @ton/core cell layer used across TON SDKs, suitable for building and parsing jetton transfers, contract messages and any TLB-encoded payload from PHP.

Features

• Builder — fluent cell construction: bits, unsigned/signed ints, coins, addresses, refs, string tails.
• Slice — TLB parser mirroring the builder surface.
• Canonical BOC serializer — emits @ton/core v15's canonical wire format (has_crc32c=1, little-endian CRC32C tail) with offset_byte_size auto-promotion from 1 to 2 when cell data exceeds 255 bytes.
• Byte-for-byte parity with @ton/core v15 — validated against upstream fixtures.
• Big integers via ext-gmp — values crossing PHP_INT_MAX flow in and out as decimal strings.
• Cell hashing — 32-byte SHA-256 of the recursive TLB representation for Ed25519 signing and address derivation.
• PHPStan level 9 clean, @PER-CS formatted, CI-tested.

Why amashukov/ton-cell-php

TON SDKs are written in TypeScript (@ton/core) and a PHP project either shells out to Node or reimplements the cell layer ad hoc. amashukov/ton-cell-php gives you the cell / BOC primitives natively in PHP with byte-for-byte parity against @ton/core v15, so a BOC built in PHP is wire-identical to one built by the canonical SDK — no Node sidecar, no FFI.

Installation

Usage

Build a cell

Builder exposes storeBit, storeUint(int|string $value, int $bits), storeInt, storeCoins, storeBits, storeBuffer, storeAddress, storeRef, storeStringTail, storeStringRefTail, storeBuilder, storeCellInline. Bigint values cross PHP_INT_MAX safely via ext-gmp (decimal-string in, decimal-string out).

Parse a cell

Slice exposes loadBit, loadUint, loadUintString, loadCoins, loadAddress, loadBits, loadRef, loadStringTail, loadStringRefTail, remainingBits, remainingRefs. Anycast and non-addr_std$10 shapes are rejected with RuntimeException.

Compute the cell hash

Used for Ed25519 message signing and TON address derivation. Memoised across calls.

Serialise to BOC

The BOC encoder emits @ton/core v15's canonical format (has_crc32c=1, little-endian CRC32C tail) and auto-promotes offset_byte_size from 1 to 2 when total cell-data size exceeds 255 bytes. Hard cap is 65 535 bytes per BOC; extend the encoder, not the rule.

AddressData value object

AddressData is a minimal wc + hashPart carrier — just enough for the cell layer to serialise the addr_std$10 TLB shape. Full address parsing (user-friendly EQ… / UQ… base64 forms, CRC-16 checksum, testnet flag) belongs to a downstream wallet package and lives on top of this VO.

BitReader

Bit-level reader over a binary string with a known precise bit length — useful for parsing TLB fields that aren't byte-aligned (for example, contract-emitted event payloads). readUint(bits) and readInt(bits) cover [0, 32] with strict overrun + range guards.

Requirements

• PHP 8.3+
• ext-gmp

No composer dependencies.

Related packages

Part of a modular pure-PHP blockchain toolkit:

Quality

• PHPStan level 9.
• php-cs-fixer with the @PER-CS ruleset.
• GitHub Actions CI on every push.
• Byte-for-byte parity tests against @ton/core v15 fixtures.

Reference

• TL-B language: https://docs.ton.org/develop/data-formats/tl-b-language
• Cell representation + BOC format: https://docs.ton.org/develop/data-formats/cell-boc

License

MIT License.