hcaptcha-no-wasm 3.0.1

hCaptcha client response verification. Validate the hCaptcha response submitted from to your server from the client.
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# Rust library hcaptcha

The rust library hcaptcha is used with your backend service to verify the hcaptcha response provided from the client.

This fork doesn't implement wasm as a target in order to keep the types `Send`.

## Installation

To use hcaptcha, add the following to your `Cargo.toml`:

```toml
[dependencies]
hcaptcha-no-wasm = "3.0.0"

```

## Breaking changes with version 3.0.0

- The `Hcaptcha` prefix has been removed from all types.
- The default feature now uses `rustls-backend` and not the `nativetls-backend`.
- The `verify_client_response` method has been deprecated in favour or the `verify` method.

## Usage

Derive a validation method on the data structure representing your data, marking the captcha components in the data structure.

``` rust
# use hcaptcha_no_wasm::Hcaptcha;

#[derive(Debug, Deserialize, Hcaptcha)]
pub struct ContactForm {
    name: String,
    phone: String,
    email: String,
    message: String,
    #[captcha]
    token: String,
}

```

Validate the captcha data.

``` rust
    # #[tokio::main]
    # async main() -> Result<(), Box<dyn std::error::Error>> {
    let contact_form: ContactForm = serde_json::from_str(e.body_string())?;
    contact_form.valid_response(&secret, None).await?;
    # }
    # fn get_your_secret() -> String {
    #   "0x123456789abcde0f123456789abcdef012345678".to_string()
    # }

```

See the examples folder for an AWS Lambda contact form example.

## Web Assembly

Hcaptcha has been tested in a web assembly project using wasm-bindgen and node.

See the `hcaptcha-wasm` example for a sample project which can be run using `wasm-pack test --node`.

## License

Licensed under either of

- Apache License, Version 2.0 (LICENSE-APACHE or <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license (LICENSE-MIT or <http://opensource.org/licenses/MIT>)
at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.

## Credits

Initial version based on [recaptcha-rs](https://github.com/panicbit/recaptcha-rs) by panicbit.