Overview

Complete API reference documentation for the @tagwise/tip-sdk TypeScript client.

Welcome to the @tagwise/tip-sdk reference documentation.

This SDK provides a fully typed TypeScript client for interacting with the Tagwise Identity Protocol, resolving handles, managing profiles, executing non-custodial SIWS authentication, and performing direct on-chain PDA reads over RPC.

Reference Sections

TipClient Class

Exhaustive reference for the TipClient class constructor, read methods, write methods, and auth flow.

On-Chain Resolution

Direct RPC resolution methods (resolveOnChain) and PDA seed derivation utilities (deriveTagPda).

Tag Utilities & Constants

Local tag validation (normalizeTag, isValidTag, isReservedTag) and exported constants.

Types & Models

Complete list of TypeScript interfaces, parameters, and response structures.

Errors & Exceptions

SDK exception class hierarchy (TipError, TagNotFoundError, NoSessionError, etc.) and handling patterns.

Installation

pnpm add @tagwise/tip-sdk

Package Entrypoint Exports

import {
  TipClient,
  DEFAULT_BASE_URL,
  normalizeTag,
  isValidTag,
  isReservedTag,
  deriveTagPda,
  TipError,
  TagNotFoundError,
  // ... types
} from "@tagwise/tip-sdk";