Sign in with Adunai
The OAuth-shaped grant flow that powers both build and verify patterns. One handshake. Two SDK surfaces.
Read the flow →Adunai docs.
Identity, attestations, payments, savings — open digital infrastructure for African economic life, on Base. Two SDK surfaces. One handshake. Sign in with Adunai is the OAuth-shaped grant flow that powers both integration patterns.
§
You are in the docs property. Marketing positioning, the Charter, and the decisions log live on adunai.org. These pages are developer-facing reference.
Start here
@adunai/sdk
For protocol builders. OAuth-shaped grant flow on the substrate, read/write to protocol primitives, payments routing, attestation issuance.
@adunai/sdk quickstart →@adunai/verify
For institutional relying parties. Sign in with Adunai, scoped attestation reads, local issuer-signature verification against a trust policy. No on-chain writes.
@adunai/verify quickstart →Contract registry
All thirty-five contracts, addresses, status, Basescan links. The full surface live on Base testnet today.
Open the registry →Install
@adunai/sdk is the protocol SDK, TypeScript-first, Apache-2.0, developed in the protocol repository. npm publication lands with the Phase 1 public SDK release; today you build from the repo. @adunai/verify is the planned relying-party package, an API design, not yet published.
shellnpm
# Phase 0: build against the SDK in the protocol repository git clone <protocol repo> && cd sdk && pnpm install # npm publication (@adunai/sdk) lands with the Phase 1 public release
The SDK targets Base Sepolia (testnet): there is no Adunai mainnet deployment yet; the audit gates mainnet:
typescriptconfig
import { Adunai } from "@adunai/sdk"; const adunai = new Adunai({ network: "base-sepolia"// Phase 0 testnet rpc: "https://sepolia.base.org"});
Two patterns at a glance
| Capability | @adunai/sdk · build | @adunai/verify · integrate |
|---|---|---|
| Audience | Protocol builders | Institutional relying parties |
| Deploys contracts | Yes · Base | No |
| Reads attestations | Yes | Yes |
| Issues attestations | If attester | If attester |
| Holds tokens | Gas only | No |
| Sign in with Adunai | Yes | Yes |
Coming in Pass 5
This documentation set is the v0.4 minimum. Concepts, guides, recipes, full API reference, governance reference, and the changelog land alongside the mainnet deployment.
§
Architecturally enabled at mainnet. Operational institutional ecosystem activates through Phase 1+ as the partnership track matures. Pattern #18(b): architectural readiness is never blurred with operational maturity.
Phase 0 · Base Sepolia testnet