Download the PHP package amashukov/toncenter-client-php without Composer
On this page you can find all versions of the php package amashukov/toncenter-client-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download amashukov/toncenter-client-php
More information about amashukov/toncenter-client-php
Files in amashukov/toncenter-client-php
Package toncenter-client-php
Short Description Typed toncenter v2 HTTP client for The Open Network — {ok, result} envelope unwrapping, retry-aware via any PSR-18 client, typed Value Objects (masterchain info, account state, run-get-method stack reader, transactions). Pluggable wallet RPC adapter.
License MIT
Homepage https://github.com/AndreyMashukov/toncenter-client-php
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 toncenter-client-php
amashukov/toncenter-client-php
Typed PHP toncenter v2 client for The Open Network — PSR-18 transport, {ok, result} envelope unwrapping, retry-aware, typed Value Objects.
A typed PHP client for the toncenter v2 HTTP API on The Open Network (TON). It speaks any PSR-18 HTTP client, unwraps the {ok, result} envelope into typed exceptions in one place, and returns Value Objects instead of loose arrays — masterchain info, account state, a run-get-method stack reader, and typed transactions. TON balances exceed PHP_INT_MAX past ~9,223 TON, so every nano-TON value comes back as a decimal string, never a lossy float. Includes ToncenterWalletRpc, a drop-in WalletRpcInterface adapter for ton-wallet-php.
Features
{ok, result}envelope unwrapping in one place — a non-200status,ok: false, or a missingresultbecomes aTonRpcException; business code never touches the envelope.- Typed Value Objects — masterchain info, account state, run-get-method stack reader, and a five-state transaction status (
Pending,Success,ComputePhaseFailed,ActionPhaseFailed,Aborted) derived from the TVM compute / action phases. - Decimal-string big numbers — balances and gas values are returned as decimal strings, safe past
PHP_INT_MAX. - Transport-agnostic — bring your own PSR-18 client and PSR-17 factories. The retry policy and the
X-Api-Keyrate-limit header are middleware concerns, not baked into the client. - 542 / 429 retry decider — toncenter emits transient
542("no workers available") and429; the recommended retry status set is documented so a retry middleware can target exactly those. - Wallet RPC adapter —
ToncenterWalletRpcimplementsAmashukov\TonWallet\WalletRpcInterface(getSeqno+sendBoc) so aton-wallet-phpwallet broadcasts through toncenter with no glue code.
Why amashukov/toncenter-client-php
The common alternative is hand-rolled Guzzle calls scattered across a service layer, each re-implementing envelope checks, bigint parsing, and 542/429 retry logic. This package centralizes all of that behind a typed surface with PHPStan level 9, returns Value Objects instead of arrays, and stays transport-agnostic so retry / API-key concerns live in your PSR-18 pipeline.
Installation
Usage
Any PSR-18 client and PSR-17 factory pair works. The example below wires
amashukov/http-client-php
(cURL transport + retry / header-injection middleware) with
nyholm/psr7 for the PSR-7 messages:
Reading get-method results
The stack reader is a cursor over a TON TupleItem sum-type
(TonTupleItemInt / Cell / Slice / Builder / Null / Tuple) and
decodes both decimal and 0x-prefixed bigints via GMP.
Broadcasting a wallet transfer
API
| Method | Returns |
|---|---|
getMasterchainInfo() |
TonMasterchainInfo |
getBalance(string $address) |
string (decimal nano-TON) |
getAddressInformation(string $address) |
TonAccountInfo |
isContractDeployed(string $address) |
bool |
getTypedTransactions(string $address, array $opts = []) |
list<TonTransaction> |
getTypedTransaction(string $address, string $lt, string $hash) |
TonTransaction |
runMethod(string $address, string $method, array $stack = []) |
TonRunMethodResult |
sendBoc(string $bocBase64) |
TonSendBocResult |
Requirements
- PHP 8.3+
ext-gmp(bigint decoding of get-method stack values)- A PSR-18 client + PSR-17 request / stream factories
Related packages
| Package | Role |
|---|---|
| amashukov/ton-wallet-php | Wallet v4r2 + WalletRpcInterface this client adapts (dependency) |
| amashukov/http-client-php | PSR-18 cURL client + retry / header-injection middleware |
| amashukov/ton-cell-php | TLB Cell / Builder / BOC layer |
| amashukov/ton-php | TON meta-package |
| amashukov/blockchain-context-bundle | Symfony bundle wiring the whole family |
Quality
- PHPStan level 9, clean.
- php-cs-fixer
@PER-CSruleset. - GitHub Actions CI on every push.
License
MIT — see LICENSE.
All versions of toncenter-client-php with dependencies
ext-gmp Version *
amashukov/ton-wallet-php Version ^0.1.0
psr/http-client Version ^1.0
psr/http-factory Version ^1.1
psr/http-message Version ^2.0