Download

Install Tollgate SDKs

Both SDKs are MIT-licensed and published to npm. SUI peer dependency required. Install only what your side of the market needs.

ai-paywall-sdk-sui

Publisher SDK

Drop-in middleware for Express. Provide your SUI package ID and server key — payments are verified on-chain via Move. No database, no custodian.

Install

npm install ai-paywall-sdk-sui @mysten/sui

Express

import { createPaywall } from "ai-paywall-sdk-sui"; import { expressMiddleware } from "ai-paywall-sdk-sui/express";

Minimum config

const paywall = createPaywall({
  packageId: process.env.SUI_PACKAGE_ID,
  serverKey: process.env.SUI_SERVER_SECRET_KEY,
  network: "testnet",
  priceMist: 1_000_000, // 0.001 SUI per crawl
});

app.use(expressMiddleware(paywall));
// req.suiPayment set on paid requests

ai-paywall-agent-sdk-sui

Agent SDK

Drop-in SUI paywall client for AI agents. Automatically detects, pays, and retries HTTP 402 challenges via pay_and_unlock PTBs.

Install

npm install ai-paywall-agent-sdk-sui @mysten/sui

Signers

import { fromKeypairFile, fromSecretKeyBech32 } from "ai-paywall-agent-sdk-sui";

Error types

import { BudgetExceededError, PaymentRefusedError } from "ai-paywall-agent-sdk-sui";

Minimum config

import { createSuiAgentClient, fromKeypairFile } from "ai-paywall-agent-sdk-sui";

const client = createSuiAgentClient({
  network: "testnet",
  signer: fromKeypairFile(),       // ~/.sui/sui_config/sui.keystore
  maxPerRequestMist: 10_000_000,   // hard cap: 0.01 SUI/request
  maxTotalMist: 1_000_000_000,     // session budget: 1 SUI
});

const res = await client.fetch("https://site.com/article");
console.log("spent:", client.spend(), "MIST");