text-translate/README.md
flemming-it 5b798c1bf2
Some checks failed
CI / Linux x86_64 (Forgejo) (push) Failing after 2s
docs/ci: chain-*-sdk references (renamed SDK)
Signed-off-by: flemming-it <sf@flemming.it>
2026-06-16 11:32:28 +02:00

46 lines
1.1 KiB
Markdown

# text-translate
Provides the `text.translate` capability for Ch∆In.
## Build
```bash
cargo build --release --target wasm32-wasip2
```
## Test
```bash
cargo test # host-side unit + integration tests
fai test . # load the wasm component in the runtime sandbox
```
## Authoring with chain-module-sdk
The module body is one decorated function:
```rust
#[fai_module]
pub fn invoke(_ctx: Context, inputs: Inputs) -> Result<Outputs, ModuleError> {
let message = inputs.require_text("message")?;
Ok(Outputs::new().with_text("reply", format!("got: {message}")))
}
```
The macro hides the wit_bindgen call, the Guest impl, the
Payload variant matching, and the `wit_bindgen::export!`
invocation. See `chain-module-sdk` documentation for the full
surface.
## SDK source
The Cargo.toml git-deps `chain-module-sdk` from
`https://git.flemming.ws/fai/module-sdk.git`. If your environment requires
authentication for that host (e.g. Forgejo with
`REQUIRE_SIGNIN_VIEW=true`), set up `git config insteadOf` with
your PAT, or use `cargo:net.git-fetch-with-cli=true` plus a
credential helper.
## License
Apache-2.0