TON lite_api

Implementation of low-level lite_api and lite-client in Rust using adnl-rs.

Feature	Status
lite_api client	✅ Implemented
lite_api server	✅ Implemented
lite-client cli	✅ Implemented
async	✅ Implemented

Installation

cargo install ton_lc

Usage

Without any options, mainnet config will be used. For testnet, use -t / --testnet flag. To use your own config, pass -c / --config <FILE> option. Also you can use --address and --public-key to connect to specific liteserver.

Send an external message to TON:

echo 1234 | ton_lc send-message -  # accept message bytes from stdin
ton_lc send-message ./query.boc  # read from file

It prints:

[ERROR] Server error [code=0]: cannot apply external message to current state : failed to parse external message cannot deserialize bag-of-cells: invalid header, error 0

OPTIONS:
        --address <ADDRESS>          Liteserver address (IP:PORT)
    -c, --config <FILE>              Local network config from file
    -h, --help                       Print help information
        --public-key <PUBLIC_KEY>    Liteserver public key (hex-encoded)
    -t, --testnet                    Use testnet config, if not provided use mainnet config
    -V, --version                    Print version information

SUBCOMMANDS:
    get-account-state           Download account state at specified block
    get-all-shards-info
    get-block                   Downloads and dumps specified block
    get-block-header            Download block header with specified merkle proofs
    get-block-proof             Download masterchain proof
    get-config-all              Download all config params
    get-config-params           Download specified config params
    get-libraries               Download specified libraries
    get-masterchain-info        Get masterchain info
    get-masterchain-info-ext    Get masterchain info with additional data
    get-one-transaction
    get-shard-info
    get-state                   Download state for masterchain block seqnos < 1000
    get-time                    Get server time
    get-transactions            Iterate through transactions for an account
    get-validator-stats
    get-version                 Shows server time, version and capabilities
    help                        Print this message or the help of the given subcommand(s)
    list-block-transactions     List transactions for a specified block
    lookup-block                Find block by seqno, lt or utime, block header will be
                                    downloaded with specified merkle proofs
    run-smc-method              Run get-method for smart contract
    send-message                Send external message

Debug logging

echo 1234 | RUST_LOG=debug ton_lc send-message -

prints:

[2022-03-15T10:43:55Z DEBUG liteclient::private] Sending query:
    Length: 20 (0x14) bytes
    0000:   df 06 8c 79  0c 82 d4 0a  69 05 31 32  33 34 0a 00   ...y....i.1234..
    0010:   00 00 00 00                                          ....
[2022-03-15T10:43:55Z DEBUG liteclient::private] Received:
    Length: 148 (0x94) bytes
    0000:   48 e1 a9 bb  00 00 00 00  8a 63 61 6e  6e 6f 74 20   H........cannot
    0010:   61 70 70 6c  79 20 65 78  74 65 72 6e  61 6c 20 6d   apply external m
    0020:   65 73 73 61  67 65 20 74  6f 20 63 75  72 72 65 6e   essage to curren
    0030:   74 20 73 74  61 74 65 20  3a 20 66 61  69 6c 65 64   t state : failed
    0040:   20 74 6f 20  70 61 72 73  65 20 65 78  74 65 72 6e    to parse extern
    0050:   61 6c 20 6d  65 73 73 61  67 65 20 63  61 6e 6e 6f   al message canno
    0060:   74 20 64 65  73 65 72 69  61 6c 69 7a  65 20 62 61   t deserialize ba
    0070:   67 2d 6f 66  2d 63 65 6c  6c 73 3a 20  69 6e 76 61   g-of-cells: inva
    0080:   6c 69 64 20  68 65 61 64  65 72 2c 20  65 72 72 6f   lid header, erro
    0090:   72 20 30 00                                          r 0.
[ERROR] Server error [code=0]: cannot apply external message to current state : failed to parse external message cannot deserialize bag-of-cells: invalid header, error 0