Build with the TSN SDK

Use TypeScript helpers for TIN identity, network readiness, wallet authorization, and payment status.

The TSN TypeScript SDK helps an application connect to configured TSN services, work with TIP identities, prepare wallet-authorized payment intents, and follow their status. The application supplies its service endpoints and wallet integration; the SDK does not start or manage TSN infrastructure.

The SDK is maintained as a private workspace package and is not currently available through the public npm registry. Workspace build and service-operation instructions belong in the repository documentation. The pages here focus on application-facing functions and expected request behavior.

Developer handbook

Start with installation and initialization, then configuration, payment preparation, integration roles, troubleshooting and the complete source-derived API. The handbook preserves the existing Mintlify routes and links internal engineering evidence.

Check configured network services

The application chooses the endpoints and passes them to the SDK. Keep environment-specific URLs in the application configuration rather than hard-coding them into shared package code.

import { getTsnNetworkStatus } from "@trustlink/tsn-sdk";

const status = await getTsnNetworkStatus({
  live: {
    node: process.env.TSN_NODE_URL,
    receiver: process.env.TSN_RECEIVER_URL,
    rpc: process.env.TSN_RPC_URL,
  },
});

if (!status.readyForNativeTransactions) {
  throw new Error("TSN is not ready for native transactions");
}

Network readiness only reports whether configured dependencies respond. It does not authorize a payment or confirm settlement.

Application guides

TIN identity

Resolve a recipient identity and understand wallet recovery.

Payment lifecycle

Follow a signed intent through verification and chain confirmation.

Network status

Configure endpoint selection and interpret readiness results.

SDK reference

Browse the application-facing TypeScript functions.

For a code-level API reference, see TSN SDK and TIN SDK. For implementation decisions and service operations, use the repository’s root documentation.