Skip to content

Adapters

An adapter is a thin binding over the core’s ports. It has three jobs:

  1. Validate every value that crosses the foreign function interface (FFI) boundary, treating it as untrusted.
  2. Call the core through its ports.
  3. Carry out the effects the core returns.

Adapters never make authentication or authorization decisions of their own. Framework integrations such as Express or FastAPI sit on top of the adapter as separate, thin layers.

Language Binding Source Status
Node.js / TypeScript napi-rs adapters/node Scaffolded
Python PyO3 adapters/python Scaffolded
Go UniFFI adapters/go Scaffolded
Java JNI adapters/java Scaffolded
Rust Native SDK adapters/rust Scaffolded

“Scaffolded” means the crate exists but doesn’t expose an API yet. The roadmap says when each one lands.

Every adapter must pass the conformance suite before it’s released.

The steps are in CONTRIBUTING.md under “Adding a new language adapter”. Put the new adapter in adapters/<language>/, following the directory conventions.