# rairprotocol/rair-sdk

Simple developer SDK for RAIRprotocol

Repository: https://github.com/rairprotocol/rair-sdk
Canonical: https://ross.abutalabs.com/products/rair-sdk
Language: TypeScript
License: Apache-2.0
License Family: permissive
Last push: 2025-07-14T14:27:40+00:00

## Health v2 (maintenance only)
Score: 36/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 31, release rhythm 35, longevity 50
- inputs: {"age_days": 705, "days_push": 415, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1280, forks 4 (observed 2026-08-28T04:04:13.789616+00:00)

## What it is
A TypeScript SDK that wraps the RAIRprotocol API, letting developers build decentralized applications (dApps) with wallet-based authentication, user management, notifications, and NFT interactions. It ships with prebuilt request modules, a sample frontend that can be deployed to Netlify in one click, and requires an Admin NFT minted on Base to get started.

## Use cases
- build a dApp on top of RAIRprotocol
- add wallet login with Metamask to my web app
- integrate NFT minting and collections into my frontend
- call RAIRprotocol API endpoints from TypeScript without writing raw requests
- query users and notifications from a RAIR backend
- bootstrap a web3 frontend quickly with a deployable template

## When to choose
- you are building a frontend or dApp specifically on RAIRprotocol
- you want ready-made TypeScript wrappers for RAIR's auth, users, notifications, and NFT endpoints instead of hand-rolling HTTP calls
- you need a fast path to a working web3 app, such as the included sample frontend with one-click Netlify deployment

## When to avoid
- you need a general-purpose Ethereum or EVM library rather than something tied to the RAIRprotocol service - use ethers.js or viem instead
- you need to run or modify the protocol backend itself - use the rair-node project, as this SDK only talks to an existing server
- you are not willing to mint an Admin NFT and cover Base gas fees, which are required to use the protocol
- your stack is not JavaScript/TypeScript or does not run in a browser/Node environment

## Facets
- artifact type: library
- maturity: active
- function: sdk, auth, http-client, websocket
- domain: blockchain, web-development, developer-tools, apis
- platform: browser, cross-platform
- tags: nft, web3, dapp, rair-protocol, metamask, wallet-authentication, api-client, typescript-sdk, digital-collectibles, blockchain-gaming, cryptocurrency, nodejs, web-server

## Member repositories
- rairprotocol/rair-sdk (main) score 36

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:13.789616+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:02:38.643263+00:00, confidence not recorded.
  - readme: https://github.com/rairprotocol/rair-sdk (fetched 2026-08-28T04:04:13.789616+00:00, sha 090880b67ab8)
- Data as of 2026-08-30T08:39:29.467469+00:00.