PyTONLib
This is standalone Python library based on libtonlibjson, the functionality is similar to the ton-http-api
with the following restrictions:
- a client can connect to only one LiteServer;
- a client is asyncronious;
- no requests cache.
Installation
From PyPi
Currently, the library works for Windows, Mac and Linux only on Intel CPUs:
- (Windows) Install OpenSSL v1.1.1 for Win64 from here.
- Install Python 3 package:
pip3 install pytonlib.
Docker
In this repo Compose file is provided to deploy the example of service with pytonlib:
docker-compose -f docker-compose.jupyter.yaml build
docker-compose -f docker-compose.jupyter.yaml up -d
Jupyter Notebook will be available on port 3100 (http://localhost:3100).
Examples
We recommend to use IPython or Jupyter Notebook for prototyping because they allow to run async code. An example of running async code from script could be found in the end of this section.
- Connecting to the first LiteServer in mainnet config:
import requests
import asyncio
from pathlib import Path
from pytonlib import TonlibClient
# downloading mainnet config
ton_config = requests.get('https://ton.org/global.config.json').json()
# create keystore directory for tonlib
keystore_dir = '/tmp/ton_keystore'
Path(keystore_dir).mkdir(parents=True, exist_ok=True)
# init TonlibClient
client = TonlibClient(ls_index=0, # choose LiteServer index to connect
config=ton_config,
keystore=keystore_dir)
# init tonlibjson
await client.init()
- Reading blocks info:
masterchain_info = await client.get_masterchain_info()
block_header = await client.get_block_header(**masterchain_info['last'])
shards = await client.get_shards(master_seqno=masterchain_info['last']['seqno'])
- Reading Block Transactions for masterchain block:
masterchain_info = await client.get_masterchain_info()
txs = await client.get_block_transactions(**masterchain_info['last'], count=10)
- Running async code from script:
import requests
import asyncio
from pathlib import Path
from pytonlib import TonlibClient
async def main():
loop = asyncio.get_running_loop()
ton_config = requests.get('https://ton.org/global.config.json').json()
# create keystore directory for tonlib
keystore_dir = '/tmp/ton_keystore'
Path(keystore_dir).mkdir(parents=True, exist_ok=True)
# init TonlibClient
client = TonlibClient(ls_index=0, # choose LiteServer index to connect
config=ton_config,
keystore=keystore_dir,
loop=loop)
# init tonlibjson
await client.init()
# reading masterchain info
masterchain_info = await client.get_masterchain_info()
# closing session
await client.close()
if __name__ == '__main__':
asyncio.run(main())
Running tests
To run tests in asyncio mode use the following command:
PYTHONPATH=./ pytest --asyncio-mode=strict tests/
Metadata
Release files for pytonlib 0.0.72
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pytonlib-0.0.72.tar.gz | 33.3 MB | Without provenance | Details for pytonlib-0.0.72.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pytonlib-0.0.72-py3-none-any.whl | Python 3 | none | any | Details for pytonlib-0.0.72-py3-none-any.whl |
Total release size: 66.8 MB
Release files / pytonlib-0.0.72.tar.gz
| Download URL | pytonlib-0.0.72.tar.gz |
|---|---|
| Size | 33.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
377ad3f8490f5f4eae9a09085851d2c57a4c94f5dde6f1db5830a10228254989
|
|
BLAKE2b-256 checksum How to use checksums |
a03585aa09ab554ba1fe5308ef54f14c5440bb0aa65e5007eb176616c2ef71c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Release files / pytonlib-0.0.72-py3-none-any.whl
| Download URL | pytonlib-0.0.72-py3-none-any.whl |
|---|---|
| Size | 33.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
815d0762af2e2953c837c8318e8bf06611d54df5d0e6e04c2afdeb0c08bc3b14
|
|
BLAKE2b-256 checksum How to use checksums |
678d7d04d0d3d4f84a324da253b3790d263d1f89fae1d773a912a469b5a70f85
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Security for pytonlib 0.0.72
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.