blueprint-webhooks 0.2.0-alpha.4

Webhook producer for Blueprint SDK — trigger jobs from external HTTP events
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

# blueprint-webhooks

Webhook gateway for Blueprint SDK.

This crate exposes HTTP endpoints that authenticate inbound requests and inject `JobCall`s into a running Blueprint.

## What it provides

- `WebhookGateway` background service (axum)
- `WebhookProducer` stream that converts verified webhook events into `JobCall`s
- Per-endpoint route mapping (`path -> job_id`)
- Auth modes:
  - `none`
  - `bearer`
  - `hmac-sha256`
  - `api-key`
- Health endpoint:
  - `GET /webhooks/health`

## Quick integration

```rust,ignore
use blueprint_webhooks::{WebhookConfig, WebhookGateway};
use blueprint_runner::BlueprintRunner;

let config = WebhookConfig::from_toml("webhooks.toml")?;
let (gateway, producer) = WebhookGateway::new(config)?;

BlueprintRunner::builder((), env)
    .router(router)
    .producer(producer)
    .background_service(gateway)
    .run()
    .await?;
```

## Related links

- Source: https://github.com/tangle-network/blueprint/tree/main/crates/webhooks
- Docs site page: https://docs.tangle.tools/developers/blueprint-runner/webhooks
- Trigger model context (cron/on-chain/webhooks/x402): https://docs.tangle.tools/developers/blueprint-runner/job-triggers