npm install @openkitx403/client

npm install @openkitx403/server

pip install openkitx403

or
poetry add openkitx403

import { OpenKit403Client } from '@openkitx403/client';

const client = new OpenKit403Client();

// Connect wallet
await client.connect('phantom');

// Authenticate with API
const response = await client.authenticate({
    resource: 'https://api.example.com/protected',
    method: 'GET'
});

if (response.ok) {
    const data = await response.json();
    console.log('✅ Authenticated as:', client.getAddress());
    console.log('Data:', data);
} else {
    console.error('❌ Authentication failed:', response.status);
}

import express from 'express';
import { createOpenKit403, inMemoryLRU } from '@openkitx403/server';

const app = express();

const openkit = createOpenKit403({
    issuer: 'my-api-v1',
    audience: 'https://api.example.com',
    ttlSeconds: 60,
    bindMethodPath: true,
    replayStore: inMemoryLRU()
});

app.use(openkit.middleware());

app.get('/protected', (req, res) => {
const user = req.openkitx403User;
res.json({ message: 'Hello!', wallet: user.address });
});

app.listen(3000);

from fastapi import FastAPI, Depends
from openkitx403 import OpenKit403Middleware, require_openkitx403_user

app = FastAPI()

app.add_middleware(
OpenKit403Middleware,
    audience="https://api.example.com",
    issuer="my-api-v1",
    ttl_seconds=60,
    bind_method_path=True,
    replay_backend="memory"
)

@app.get("/protected")
async def protected(user=Depends(require_openkitx403_user)):
    return {"message": "Hello!", "wallet": user.address}

import { SolanaWalletAuthTool } from '@openkitx403/langchain';
import { initializeAgentExecutorWithOptions } from 'langchain/agents';

const tools = [new SolanaWalletAuthTool()];
const executor = await initializeAgentExecutorWithOptions(tools, model, {
    agentType: "zero-shot-react-description"
});

const result = await executor.call({
    input: "Connect my wallet and fetch my NFT collection"
});

Install dependencies
npm install

Build all packages
npm run build

Run tests
npm run test
npm run test --workspace=packages/ts-client
npm run test --workspace=packages/ts-server

Python tests
cd packages/py-server
pytest

const openkit = createOpenKit403({
    issuer: 'my-api',
    audience: 'https://api.example.com',
    tokenGate: async (address: string) => {
        // Check if wallet holds required NFT/token
        const hasToken = await checkTokenHolding(address);
        return hasToken;
    }
});

class RedisReplayStore implements ReplayStore {
    async check(key: string, ttl: number): Promise<boolean> {
        return await redis.exists(key);
    }

    async store(key: string, ttl: number): Promise<void> {
        await redis.setex(key, ttl, '1');
    }
}

const openkit = createOpenKit403({
    replayStore: new RedisReplayStore()
});