Download the PHP package amashukov/ton-crypto-php without Composer
On this page you can find all versions of the php package amashukov/ton-crypto-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download amashukov/ton-crypto-php
More information about amashukov/ton-crypto-php
Files in amashukov/ton-crypto-php
Package ton-crypto-php
Short Description Ed25519 keypairs and TON-style mnemonic seed derivation for The Open Network, in pure PHP on top of ext-sodium.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package ton-crypto-php
amashukov/ton-crypto-php
Correct TON mnemonic + Ed25519 keypair derivation for The Open Network in pure PHP.
TON cryptography for PHP: Ed25519 keypairs (sign / verify via libsodium) and TON-flavoured mnemonic seed derivation for The Open Network. The TON mnemonic format is PBKDF2-HMAC-SHA512 with salt "TON default seed" and 100 000 iterations — it is not BIP-39. The wordlist and derivation procedure mirror the TON reference implementation, so the same 24-word phrase produces the same Ed25519 keypair (and therefore the same wallet address) across all TON tooling.
Features
- TON-correct mnemonic → seed → Ed25519 keypair derivation (PBKDF2-HMAC-SHA512, salt
"TON default seed", 100 000 iterations). - Ed25519 keypair generation, sign and verify on top of
ext-sodium. - Deterministic phrase normalisation (trims, collapses tab/newline/whitespace runs to a single space).
- Optional password passthrough on the HMAC step.
- Zero composer dependencies — only PHP core extensions.
- PHPStan level 9 clean,
final readonlyvalue objects,strict_types.
Why amashukov/ton-crypto-php
BIP-39 mnemonic libraries derive the wrong key for TON. TON does not use the BIP-39 PBKDF2 salt ("mnemonic") or iteration scheme — it uses a distinct entropy → seed pipeline (hash_hmac pass feeding PBKDF2-HMAC-SHA512 with salt "TON default seed", 100 000 iterations). Feeding a TON phrase to a generic BIP-39 library yields a seed and address that do not match TON wallets. This package implements the TON procedure exactly, so derived addresses match official TON tooling byte-for-byte.
Installation
Usage
Derive a keypair from a mnemonic phrase
toSeed() and toKeyPair() normalise the phrase (trims leading/trailing whitespace, collapses any inter-word run of whitespace — including tabs and newlines — to a single space). Both accept an optional $password argument that is fed through the HMAC step.
Generate a fresh keypair
Sign + verify
verify() returns false for any signature whose length is not exactly 64 bytes, in addition to the cryptographic check.
KeyPair layout
KeyPair::SEED_BYTES= 32 (libsodiumSODIUM_CRYPTO_SIGN_SEEDBYTES)KeyPair::PUBLIC_KEY_BYTES= 32KeyPair::SECRET_KEY_BYTES= 64 (libsodium layout:seed ‖ publicKey)KeyPair::SIGNATURE_BYTES= 64
TON mnemonic parameters
- Salt:
TON default seed - KDF: PBKDF2-HMAC-SHA512
- Iterations: 100 000
- Output: 64 bytes; first 32 bytes are the Ed25519 seed
- HMAC pass:
hash_hmac('sha512', $password, $normalizedPhrase, true)produces the entropy fed into PBKDF2
These constants are exposed on Mnemonic::DEFAULT_SALT, Mnemonic::PBKDF2_ITERATIONS, Mnemonic::PBKDF2_OUTPUT_BYTES.
Requirements
- PHP 8.3+
ext-sodiumext-hash(bundled with PHP core; used for HMAC-SHA512 + PBKDF2)
No composer dependencies.
Related packages
| Package | Tier | Purpose |
|---|---|---|
| amashukov/ton-cell-php | leaf | TLB Cell / BoC serialization |
| amashukov/ton-wallet-php | composite | TON wallet contracts + address derivation |
| amashukov/toncenter-client-php | RPC | toncenter v2/v3 API client |
| amashukov/ton-php | meta | TON umbrella package |
| amashukov/keccak-php | leaf | keccak-256 hashing |
Quality
- PHPStan level 9.
- php-cs-fixer with the
@PER-CSruleset. - GitHub Actions CI on every push.
- Derived seeds and addresses validated against the TON reference implementation.
License
MIT.
All versions of ton-crypto-php with dependencies
ext-sodium Version *
ext-hash Version *