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 |
cargo install ton_lc
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
echo 1234 | RUST_LOG=debug ton_lc send-message -
prints:
[2022年03月15日T10: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月15日T10: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