telepass 1.1.0

Telegram Mini App init data validation and parsing
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# telepass

Telegram Mini Apps [init data](https://core.telegram.org/bots/webapps#webappinitdata) validation and parsing for Rust.

## Installation

```bash
cargo add telepass
```

## Usage

### Validating Init Data

```rust
use telepass::init_data::InitData;
use std::time::Duration;

fn handle_request(raw_init_data: &str, bot_token: &str) {
    match InitData::validate(raw_init_data, bot_token, Duration::from_secs(86400)) {
        Ok(data) => println!("Valid init data: {}", data),
        Err(e) => eprintln!("Validation failed: {}", e),
    }
}
```

### Parsing Init Data

```rust
use telepass::init_data::InitData;

let init_data = InitData::parse(raw_init_data).expect("failed to parse init data");

println!("User: {:?}", init_data.user);
println!("Chat: {:?}", init_data.chat);
println!("Auth date: {:?}", init_data.get_auth_date());
```

### Validate Then Parse

```rust
use telepass::init_data::InitData;
use std::time::Duration;

let raw = InitData::validate(raw_init_data, bot_token, Duration::from_secs(86400))
.expect("invalid init data");

let parsed = InitData::parse( & raw).expect("failed to parse");

if let Some(user) = & parsed.user {
println!("Hello, {}!", user.first_name);
}
```

## Errors

| Error              | Description                          |
|--------------------|--------------------------------------|
| `AuthDateMissing`  | `auth_date` parameter is missing     |
| `AuthDateInvalid`  | `auth_date` is not a valid timestamp |
| `SignMissing`      | `hash` parameter is missing          |
| `SignInvalid`      | HMAC signature does not match        |
| `UnexpectedFormat` | Init data could not be parsed        |
| `Expired`          | Init data has expired                |