@open-matrix/sdk (1.1.33)
Installation
@open-matrix:registry=npm install @open-matrix/sdk@1.1.33"@open-matrix/sdk": "1.1.33"About this package
@open-matrix/sdk
Public Matrix actor SDK facade for package authors.
Prefer narrow package imports when a package only needs one layer:
import { MatrixActor } from '@open-matrix/core';
Use this umbrella package when a package intentionally needs the combined actor, browser host, contracts, federation, and Omega kernel facade.
Import browser app build utilities directly from @open-matrix/browser-kit so
headless actor packages can import @open-matrix/sdk without loading
browser-only custom element code.
HiveCast-Managed Transport
For HiveCast-backed actors, use a HiveCast API key to exchange for short-lived actor-scoped NATS credentials:
import { exchangeHiveCastActorCredential } from '@open-matrix/sdk';
const credential = await exchangeHiveCastActorCredential({
cloud: process.env.MATRIX_CLOUD!,
space: process.env.MATRIX_SPACE!,
apiKey: process.env.MATRIX_API_KEY!,
}, {
mount: 'fresh.server.echo',
accepts: { echo: { description: 'Echo a message', message: 'string' } },
});
The exchange returns NATS URLs plus a JWT/seed pair for the requested mount.
Server actors use NatsTransport with credential.transport.natsUrl; browser
actors use createBrowserNatsTransport with
credential.transport.natsWsUrl.
Runnable package examples belong outside /home/ubuntu/hivecast-projects/matrix-sdk.
The clean HiveCast tree keeps the SDK package focused on the SDK surface, not
embedded demos.
Dependencies
Dependencies
| ID | Version |
|---|---|
| @open-matrix/browser-host | 1.1.33 |
| @open-matrix/browser-kit | 1.1.33 |
| @open-matrix/contracts | 1.1.33 |
| @open-matrix/core | 1.1.33 |
| @open-matrix/federation | 1.1.33 |
| @open-matrix/omega-core | 1.1.33 |
Development Dependencies
| ID | Version |
|---|---|
| @types/node | ^25.0.10 |
| typescript | ^5.7.0 |