An open, non-custodial identity layer on Solana that maps short, human-readable handles (e.g. @alice) to wallet addresses and rich off-chain profile metadata.

• Human-Readable Handles — Pay @alice instead of copying a 44-character base58 address.
• Zero Lock-In — The Solana program's PDAs are the immutable source of truth. Any dApp can resolve tags directly on-chain without the API.
• Off-Chain Speed & Rich Profiles — A real-time mirror powers instant search, avatars, bios, and preferred token metadata.
• Non-Custodial Auth — Sign-In With Solana (SIWS) ensures zero key exposure.
• Multi-Asset & Solana Pay — Built-in support for SOL, SPL tokens, payment links, and QR codes.

┌────────────────────────────────────────────────────────────────┐
│                         Client / dApp                          │
└────────────┬─────────────────────────────────────┬─────────────┘
             │  REST API                           │  Direct fallback (RPC)
             ▼                                     ▼
┌────────────────────────┐           ┌───────────────────────────┐
│   apps/api  (NestJS)   │           │   Solana Blockchain       │
│   Redis Cache          │           │   tip_registry program    │
│   PostgreSQL Mirror    │           └───────────────────────────┘
└────────────┬───────────┘                      ▲
             │ sync & invalidate cache          │ watch logs
             ▼                                  │
┌────────────────────────┐                      │
│  apps/indexer          │──────────────────────┘
│  (event listener)      │
└────────────────────────┘

This is a pnpm + Turborepo monorepo. All apps/* and packages/* directories are pnpm workspace members. programs/tip-registry is a Rust/Anchor Solana program managed separately with its own Cargo toolchain and is not part of the JS workspace.

.
├── apps/
│   ├── api/          HTTP REST API (NestJS + Fastify)
│   ├── docs/         Documentation site (Next.js + Fumadocs)
│   ├── indexer/      On-chain event indexer
│   └── web/          Web frontend
├── packages/
│   ├── core/         Shared business logic (cache keys, utilities)
│   ├── db/           Database layer (Prisma + PostgreSQL)
│   ├── moderation/   Content moderation shared logic
│   └── sdk/          Public TypeScript client SDK (@tagwise/tip-sdk)
└── programs/
    └── tip-registry/ Solana program (Rust/Anchor) — outside the JS workspace

git clone https://github.com/devfreeguy/tagwise-identity-protocol.git
cd tagwise-identity-protocol
corepack enable
pnpm install

Each app has its own .env.example. Copy and fill in values for the services you are running:

cp apps/api/.env.example apps/api/.env
# Edit apps/api/.env with your DATABASE_URL, REDIS_URL, JWT_SECRET, etc.

Key variables for apps/api:

See apps/api/.env.example for the full list with detailed descriptions.

pnpm dev

Turborepo starts all apps concurrently in watch mode, respecting build order.

All top-level scripts delegate to Turborepo and run across workspace packages in dependency order.

The public SDK (@tagwise/tip-sdk) is the recommended way to integrate TIP into your application.

npm install @tagwise/tip-sdk
# or
pnpm add @tagwise/tip-sdk

import { TipClient } from "@tagwise/tip-sdk";

const client = new TipClient({ baseUrl: "https://api.tagwise.me" });

// Resolve a tag to a wallet address and profile
const profile = await client.resolve("alice");
console.log(profile.wallet); // "4vcgr..."

// Check tag availability
const available = await client.checkAvailability("myhandle");

→ Full SDK documentation at docs.tagwise.me/sdk-reference

Full protocol documentation is available at docs.tagwise.me:

Contributions are welcome. Please open an issue first to discuss any significant change.

1. Fork the repository
2. Create your feature branch: git checkout -b feat/my-feature
3. Commit your changes following Conventional Commits: git commit -m 'feat: add my feature'
4. Push to your branch: git push origin feat/my-feature
5. Open a Pull Request

Please ensure pnpm typecheck and pnpm test pass before submitting.

MIT © 2026 devfreeguy