Skip to main content
The types in this reference are exported from @telnyx/edge-runtime (TypeScript).
The Stateful Actor surface at a glance — follow a link for the full page:
SurfaceWhere it livesWhat it’s for
StatefulActor<E>@telnyx/edge-runtimeBase class you extend. Holds this.ctx and this.env.
ActorContextthis.ctx (runtime-injected)Per-instance identity, storage, single alarm, one-shot init.
ActorStoragethis.ctx.storagePer-key persistent storage.
ActorNamespaceenv.<BINDING>The handle from your function. Returns stubs you call methods on.
ActorStubfrom idFromName / newUniqueIdPer-name handle; an RPC to one instance.
Alarmsctx.storage + alarm()Single per-actor alarm; at-least-once delivery.
Configurationtelnyx.toml [[actors]]Declaring the actor binding.
Errors@telnyx/edge-runtimeBlockConcurrencyTimeoutError, ActorOutputGateError, timeout and codec errors.
  • Bindings — how bindings resolve on env
  • KV — globally distributed key-value storage
  • Execution Model — function lifecycle and concurrency