Sololc Webhook SDK Workspace
Provides a multi-crate mono-repository workspace containing a zero-dependency, ultra-high-performance WASI-HTTP Webhook SDK optimized for the Vortex and Sololc WebAssembly runtimes.
This workspace decouples standard WebAssembly Component Model (WASIp2) protocol layers from higher-level user application logic. It enables microservice developers to build sandboxed, edge-native webhooks using declarative macros with near-zero runtime and compile-time overhead.
🏗️ Workspace Architecture
The repository orchestrates multiple interlocking sub-packages alongside the official Component Model Interface (.wit) specifications to establish an ergonomic translation layer across guest-host boundaries:
Host Runtime Boundary (Sololc)
│
▼ [wasi:http/incoming-handler]
┌─────────────────────────────────────────────────────────────────────────┐
│ Sololc Webhook SDK Workspace (Guest Component) │
│ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ 1. wit/ (Protocol Boundary) │ │
│ │ Defines fields, incoming-requests, and response-outparams. │ │
│ └─────────────────────────────────┬─────────────────────────────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ 2. sololc-webhook-macros (Compile-time Synthesizer) │ │
│ │ Parses code natively; generates high-speed token routing glue. │ │
│ └─────────────────────────────────┬─────────────────────────────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ 3. sololc-webhook-sdk (Ergonomic Core Engine) │ │
│ │ Wraps resource-managed streams into clean Request / Response. │ │
│ └───────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
📦 Repository Layout
This workspace utilizes Cargo Monorepo patterns to separate code-generation utilities from raw implementation details:
wit/: Contains the officialwasi:http@0.2.0component definitions (webhook.wit).sololc-webhook-sdk/: Contains the primary runtime development kit, providing higher-level, safe wrappers (Request,Response) around raw WASI handles.sololc-webhook-macros/: Contains a zero-dependency procedural macro suite running entirely on native compiler TokenStreams for sub-second hot-reloads.
🛠️ Prerequisites & Installation
To actively compile, test, or implement plugins utilizing this workspace, ensure the following WebAssembly toolchains are initialized on your local environment:
# 1. Update your Rust compiler toolchain to the latest stable channel
# 2. Add the specialized WebAssembly WebSystem target layer
# 3. Install the unified WebAssembly Component builder tooling
🚀 Step-by-Step Local Validation
Follow these diagnostic steps within the root directory to verify structural integrity and build capabilities:
- Execute Code Integrity Assurances Validates compilation correctness across the entire workspace structure without emitting full binary objects:
- Compile Optimization Units Compiles the target infrastructure and its code-generators into concrete release-ready dependencies:
📝 Usage Example
Downstream plugin applications can seamlessly build on top of this workspace. Below is an example matching the routing mechanisms synthesized by this SDK:
use ;
/// Processes secure payload synchronizations dispatched from remote edge nodes.
async
⚖️ License
Licensed under either of:
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)