Rust SDK#

net-mesh-sdk is the native Rust API. It exposes both the event bus and the capability-oriented mesh surface without a language binding between your code and the runtime.

cargo add net-mesh-sdk

The crate imports as net_sdk.

Choose the entry point#

• Net is the event bus. Use emit and subscribe_typed with a memory, mesh, Redis, or JetStream transport.
• Mesh provides capabilities, tools, and nRPC. Use it to announce work, discover providers, and invoke them.

Follow the capability path#

1. Quickstart
2. Announce
3. Discover
4. Invoke
5. Watch
6. Artifacts
7. Errors

Protected services#

Two authority surfaces sit on top of the mesh, both marshaling-free in Rust:

• Organization auth (concepts) — the provider registers with mesh.serve_org(service, OrgAccess::…, handler) for unary, or serve_org_streaming / serve_org_client_stream / serve_org_duplex for the three streaming shapes; the caller binds once with mesh.org(credentials)? and uses call(service, &req) beside call_streaming / call_client_stream / call_duplex. The service is invisible outside its audience, not merely refused.
• Subnet authority (concepts) — a provider inside a protected subnet exports one service against a named export configured on the builder (.subnet_export(..)): mesh.serve_subnet_exported(service, export_name, handler). The caller stays an ordinary org client and uses org.call_exported(service, &req) — it never joins the provider's subnet. Runtime gateway administration lives under net_sdk::subnet::admin.

Every signed artifact for either surface is minted offline by net-mesh org / net-mesh subnet; nothing in the SDK signs.

Runnable examples live under sdk/examples/. Use Concepts for the model and this section for Rust call shapes and lifecycle.