Skip to main content
Choose this path when you are building a backend service, job, or CLI with the Node SDK.

Choose the authentication mode

  • Use private-key mode when the process owns a space and must sign in or create delegations.
  • Use session-only mode when the process only consumes access delegated by another principal.

Get to a first write

Go directly to the Node SDK quickstart. It shows the wallet-backed path from installing the SDK to signing in and writing a KV record, then introduces session-only mode as the alternative.

After the first write

  • Use Node sign-in when you need to compare the two authentication modes in detail.
  • Read DID formats before choosing a persistent owner DID or ephemeral session DID as a delegation target.
  • Read Spaces when the service must provision additional data containers.
  • Continue with Delegations when the service acts on behalf of another principal.
  • Use the Node SDK reference for the current constructor options and primary methods.

Source note

Use tc.did after signIn() when you need the owner DID for delegations. In session-only mode, the delegation must target the instance’s session DID.