1
0
mirror of https://github.com/danog/MadelineProto.git synced 2024-12-12 17:47:22 +01:00
MadelineProto/ton/README.md

47 lines
1.9 KiB
Markdown
Raw Normal View History

2019-12-22 12:57:49 +01:00
# TON integration
MadelineProto is now capable of integrating with the [Telegram TON blockchain](https://test.ton.org), thanks to a fully native implementation of ADNL and the lite-client protocol.
It allows **async** interaction with liteservers in the same manner as the official `lite-client`, only with way more abstractions and ease of use.
Please note that the project is in alpha stage.
2019-12-22 13:08:40 +01:00
For a **fully separate and standalone** pure JS client-side implementation of the TON protocol check out [madelineTon.js](https://github.com/danog/madelineTon.js): interact **directly with the TON blockchain** with no middlemans, directly from your browser!
2019-12-22 12:57:49 +01:00
## Instantiation
2019-12-23 16:21:52 +01:00
```php
2019-12-22 12:57:49 +01:00
use danog\MadelineProto\TON\API;
$API = new API(
[
'logger' => [
'logger' => Logger::ECHO_LOGGER
]
]
);
```
## Usage
2019-12-23 16:21:52 +01:00
```php
2019-12-22 12:57:49 +01:00
$API->async(true);
$API->loop(
function () use ($API) {
2023-03-09 13:12:56 +01:00
$API->connect(__DIR__.'/ton-lite-client-test1.config.json');
var_dump($API->liteServer->getTime());
2019-12-22 12:57:49 +01:00
}
);
```
For a full overview of async in MadelineProtoTon, take a look at the [MadelineProto async docs](https://docs.madelineproto.xyz/docs/ASYNC.html).
2023-01-27 14:20:47 +01:00
For a full list of methods that can be used, simply look at the PHPDOC suggestions in your favorite IDE, or take a look at the `---functions---` section of the [lite TL scheme](https://github.com/danog/MadelineProto/blob/master/src/TON/schemes/lite_api.tl).
2019-12-22 12:57:49 +01:00
This API can be used to build web-facing HTTP APIs that query the TON blockchain (using the async [http-client](https://github.com/amphp/http-client)), off-chain elements for TON applications and so much more!
2019-12-22 13:08:40 +01:00
For a **fully separate and standalone** pure JS client-side implementation of the TON protocol check out [madelineTon.js](https://github.com/danog/madelineTon.js): interact **directly with the TON blockchain** with no middlemans, directly from your browser!