@relai-fi/x402 0.5.24 → 0.5.26

package/README.md

@@ -300,6 +300,13 @@ import {
   fromAtomicUnits,
 } from '@relai-fi/x402/utils';
 
+// Management API — create/manage APIs, pricing, analytics, agent bootstrap
+import {
+  createManagementClient,
+  bootstrapAgentKeySolana,
+  bootstrapAgentKeyEvm,
+} from '@relai-fi/x402/management';
+
 // Types & constants
 import {
   RELAI_NETWORKS,
@@ -461,6 +468,82 @@ app.get('/api/solana-data', relai.protect({
 
 ---
 
+## Management API
+
+Programmatically create and manage monetised APIs, update pricing, and read analytics. Designed for agents and CI/CD — no browser needed.
+
+```typescript
+import { createManagementClient } from '@relai-fi/x402/management';
+
+const mgmt = createManagementClient({ serviceKey: process.env.RELAI_SERVICE_KEY! });
+
+// Create a monetised API
+const api = await mgmt.createApi({
+  name: 'My ML API',
+  baseUrl: 'https://inference.example.com',
+  merchantWallet: '0xYourWallet',
+  network: 'base',
+  endpoints: [
+    { path: '/v1/predict', method: 'post', usdPrice: 0.05 },
+    { path: '/v1/status',  method: 'get',  usdPrice: 0.001 },
+  ],
+});
+
+// List / get / update / delete
+const all   = await mgmt.listApis();
+const one   = await mgmt.getApi(api.apiId);
+await mgmt.updateApi(api.apiId, { description: 'Updated description' });
+await mgmt.deleteApi(api.apiId);
+
+// Pricing
+await mgmt.setPricing(api.apiId, [{ path: '/v1/predict', method: 'post', usdPrice: 0.10 }]);
+const pricing = await mgmt.getPricing(api.apiId);
+
+// Analytics
+const stats    = await mgmt.getStats(api.apiId);
+const payments = await mgmt.getPayments(api.apiId, { limit: 20, from: '2025-01-01' });
+const logs     = await mgmt.getLogs(api.apiId, { limit: 20 });
+```
+
+### Agent self-setup (autonomous key provisioning)
+
+Agents can provision their own service key with zero human involvement — no dashboard, no JWT, no copy-paste. Run once and store the key.
+
+```typescript
+import { bootstrapAgentKeySolana, bootstrapAgentKeyEvm } from '@relai-fi/x402/management';
+import { Keypair } from '@solana/web3.js';
+
+// Solana agent
+const keypair = Keypair.fromSecretKey(Buffer.from(process.env.AGENT_PRIVATE_KEY!, 'base64'));
+const { key } = await bootstrapAgentKeySolana(keypair, 'my-agent');
+// → key: "sk_live_..."  — store securely, never re-run
+
+// EVM agent (ethers.js Wallet)
+import { ethers } from 'ethers';
+const wallet = new ethers.Wallet(process.env.AGENT_PRIVATE_KEY!);
+const { key: evmKey } = await bootstrapAgentKeyEvm(wallet, 'my-evm-agent');
+```
+
+Once you have a service key, combine it with `createX402Client` for a fully autonomous agent:
+
+```typescript
+import { createX402Client } from '@relai-fi/x402/client';
+import { createManagementClient } from '@relai-fi/x402/management';
+
+const serviceKey = process.env.RELAI_SERVICE_KEY!;
+
+// Pay for APIs
+const client = createX402Client({
+  wallets: { solana: agentWallet },
+  defaultHeaders: { 'X-Service-Key': serviceKey },
+});
+
+// Manage APIs
+const mgmt = createManagementClient({ serviceKey });
+```
+
+---
+
 ## Utilities
 
 ```typescript

package/dist/management.cjs

@@ -0,0 +1,150 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/management.ts
+var management_exports = {};
+__export(management_exports, {
+  bootstrapAgentKeyEvm: () => bootstrapAgentKeyEvm,
+  bootstrapAgentKeySolana: () => bootstrapAgentKeySolana,
+  createManagementClient: () => createManagementClient
+});
+module.exports = __toCommonJS(management_exports);
+var RELAI_API_BASE = "https://api.relai.fi";
+var BOOTSTRAP_URL = `${RELAI_API_BASE}/mcp/management/bootstrap/agent`;
+async function bootstrapAgentKeySolana(keypair, label = "agent") {
+  const { sign } = await import("tweetnacl");
+  const publicKey = keypair.publicKey.toBase58();
+  const challengeRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey })
+  });
+  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);
+  const { message } = await challengeRes.json();
+  const msgBytes = new TextEncoder().encode(message);
+  const sigBytes = sign.detached(msgBytes, keypair.secretKey);
+  const signature = Buffer.from(sigBytes).toString("base64");
+  const keyRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey, signature, message, label })
+  });
+  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);
+  return keyRes.json();
+}
+async function bootstrapAgentKeyEvm(wallet, label = "agent") {
+  const publicKey = wallet.address;
+  const challengeRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey })
+  });
+  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);
+  const { message } = await challengeRes.json();
+  const signature = await wallet.signMessage(message);
+  const keyRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey, signature, message, label })
+  });
+  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);
+  return keyRes.json();
+}
+function createManagementClient(config) {
+  const base = (config.baseUrl ?? RELAI_API_BASE).replace(/\/$/, "");
+  const headers = {
+    "X-Service-Key": config.serviceKey,
+    "Content-Type": "application/json"
+  };
+  async function req(method, path, body) {
+    const res = await fetch(`${base}${path}`, {
+      method,
+      headers,
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`[relai-mgmt] ${method} ${path} \u2192 ${res.status}: ${text}`);
+    }
+    return res.json();
+  }
+  return {
+    // ── APIs ──────────────────────────────────────────────────────────────
+    createApi(input) {
+      return req("POST", "/v1/apis", input);
+    },
+    async listApis() {
+      const data = await req("GET", "/v1/apis");
+      return data.apis;
+    },
+    getApi(apiId) {
+      return req("GET", `/v1/apis/${apiId}`);
+    },
+    updateApi(apiId, input) {
+      return req("PATCH", `/v1/apis/${apiId}`, input);
+    },
+    deleteApi(apiId) {
+      return req("DELETE", `/v1/apis/${apiId}`);
+    },
+    // ── Pricing ──────────────────────────────────────────────────────────
+    getPricing(apiId) {
+      return req("GET", `/v1/apis/${apiId}/pricing`);
+    },
+    setPricing(apiId, endpoints) {
+      return req("PUT", `/v1/apis/${apiId}/pricing`, { endpoints });
+    },
+    // ── Analytics ────────────────────────────────────────────────────────
+    getStats(apiId) {
+      return req("GET", `/v1/apis/${apiId}/stats`);
+    },
+    getPayments(apiId, options = {}) {
+      const params = new URLSearchParams();
+      if (options.limit) params.set("limit", String(options.limit));
+      if (options.from) params.set("from", options.from);
+      if (options.cursor) params.set("cursor", options.cursor);
+      const qs = params.toString() ? `?${params}` : "";
+      return req("GET", `/v1/apis/${apiId}/payments${qs}`);
+    },
+    getLogs(apiId, options = {}) {
+      const params = new URLSearchParams();
+      if (options.limit) params.set("limit", String(options.limit));
+      if (options.from) params.set("from", options.from);
+      if (options.cursor) params.set("cursor", options.cursor);
+      const qs = params.toString() ? `?${params}` : "";
+      return req("GET", `/v1/apis/${apiId}/logs${qs}`);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bootstrapAgentKeyEvm,
+  bootstrapAgentKeySolana,
+  createManagementClient
+});
+//# sourceMappingURL=management.cjs.map

package/dist/management.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/management.ts"],"sourcesContent":["// src/management.ts\n// RelAI Management API client — create and manage monetised APIs programmatically.\n// Docs: https://relai.fi/documentation/management-api\n\nconst RELAI_API_BASE = 'https://api.relai.fi';\nconst BOOTSTRAP_URL = `${RELAI_API_BASE}/mcp/management/bootstrap/agent`;\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ManagementClientConfig {\n  /** Service key (sk_live_...) for authenticating management API calls */\n  serviceKey: string;\n  /** Override base URL (default: https://api.relai.fi) */\n  baseUrl?: string;\n}\n\nexport interface RelaiApi {\n  apiId: string;\n  name: string;\n  description?: string;\n  baseUrl: string;\n  subdomain?: string | null;\n  network: string;\n  facilitator: string;\n  x402Version: number;\n  status: string;\n  merchantWallet: string;\n  websiteUrl?: string;\n  logoUrl?: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ApiEndpointInput {\n  path: string;\n  method: string;\n  usdPrice: number;\n  enabled?: boolean;\n}\n\nexport interface ApiEndpoint extends ApiEndpointInput {\n  network: string;\n  enabled: boolean;\n}\n\nexport interface CreateApiInput {\n  name: string;\n  baseUrl: string;\n  merchantWallet: string;\n  network: string;\n  description?: string;\n  websiteUrl?: string;\n  logoUrl?: string;\n  endpoints?: ApiEndpointInput[];\n}\n\nexport interface UpdateApiInput {\n  name?: string;\n  description?: string;\n  baseUrl?: string;\n  merchantWallet?: string;\n  websiteUrl?: string;\n  logoUrl?: string;\n}\n\nexport interface ApiStats {\n  apiId: string;\n  totalRequests: number;\n  totalRevenue: number;\n  currency: string;\n}\n\nexport interface ApiPayment {\n  transaction: string;\n  path: string;\n  method: string;\n  amount: number;\n  currency: string;\n  network: string;\n  status: string;\n  success: boolean;\n  payer: string;\n  createdAt: string;\n}\n\nexport interface ApiPaymentsResult {\n  apiId: string;\n  payments: ApiPayment[];\n  nextCursor: string | null;\n}\n\nexport interface ApiLogItem {\n  id: string;\n  timestamp: string;\n  method: string;\n  path: string;\n  status: string;\n  cost: number;\n  currency: string;\n  duration: number;\n  transaction: string;\n  network: string;\n  success: boolean;\n  payer: string;\n}\n\nexport interface ApiLogsResult {\n  items: ApiLogItem[];\n  nextCursor: string | null;\n}\n\nexport interface AgentBootstrapResult {\n  key: string;\n  label: string;\n  active: boolean;\n  createdAt: string;\n}\n\n// ============================================================================\n// Agent bootstrap (autonomous key provisioning)\n// ============================================================================\n\n/**\n * Bootstrap a service key for a Solana agent.\n * Run once — store the returned key securely.\n *\n * @param keypair  A Solana Keypair (from @solana/web3.js)\n * @param label    Human-readable label for the key\n */\nexport async function bootstrapAgentKeySolana(\n  keypair: { publicKey: { toBase58(): string }; secretKey: Uint8Array },\n  label = 'agent',\n): Promise<AgentBootstrapResult> {\n  const { sign } = await import('tweetnacl');\n\n  const publicKey = keypair.publicKey.toBase58();\n\n  // Step 1 — request challenge\n  const challengeRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey }),\n  });\n  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);\n  const { message } = await challengeRes.json() as { message: string };\n\n  // Step 2 — sign\n  const msgBytes = new TextEncoder().encode(message);\n  const sigBytes = sign.detached(msgBytes, keypair.secretKey);\n  const signature = Buffer.from(sigBytes).toString('base64');\n\n  // Step 3 — get service key\n  const keyRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey, signature, message, label }),\n  });\n  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);\n  return keyRes.json() as Promise<AgentBootstrapResult>;\n}\n\n/**\n * Bootstrap a service key for an EVM agent.\n * Run once — store the returned key securely.\n *\n * @param wallet  An ethers.js Wallet or Signer with address + signMessage\n * @param label   Human-readable label for the key\n */\nexport async function bootstrapAgentKeyEvm(\n  wallet: { address: string; signMessage(message: string): Promise<string> },\n  label = 'agent',\n): Promise<AgentBootstrapResult> {\n  const publicKey = wallet.address;\n\n  // Step 1 — request challenge\n  const challengeRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey }),\n  });\n  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);\n  const { message } = await challengeRes.json() as { message: string };\n\n  // Step 2+3 — sign and get key\n  const signature = await wallet.signMessage(message);\n  const keyRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey, signature, message, label }),\n  });\n  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);\n  return keyRes.json() as Promise<AgentBootstrapResult>;\n}\n\n// ============================================================================\n// Management client\n// ============================================================================\n\nexport interface RelaiManagementClient {\n  // APIs\n  createApi(input: CreateApiInput): Promise<RelaiApi>;\n  listApis(): Promise<RelaiApi[]>;\n  getApi(apiId: string): Promise<RelaiApi>;\n  updateApi(apiId: string, input: UpdateApiInput): Promise<RelaiApi>;\n  deleteApi(apiId: string): Promise<{ success: boolean; apiId: string }>;\n\n  // Pricing\n  getPricing(apiId: string): Promise<{ apiId: string; endpoints: ApiEndpoint[] }>;\n  setPricing(apiId: string, endpoints: ApiEndpointInput[]): Promise<{ success: boolean; apiId: string; updated: number }>;\n\n  // Analytics\n  getStats(apiId: string): Promise<ApiStats>;\n  getPayments(apiId: string, options?: { limit?: number; from?: string; cursor?: string }): Promise<ApiPaymentsResult>;\n  getLogs(apiId: string, options?: { limit?: number; from?: string; cursor?: string }): Promise<ApiLogsResult>;\n}\n\n/**\n * Create a RelAI Management API client.\n *\n * @example\n * ```typescript\n * import { createManagementClient } from '@relai-fi/x402/management';\n *\n * const mgmt = createManagementClient({ serviceKey: process.env.RELAI_SERVICE_KEY! });\n *\n * const api = await mgmt.createApi({\n *   name: 'My ML API',\n *   baseUrl: 'https://inference.example.com',\n *   merchantWallet: '0xYourWallet',\n *   network: 'base',\n *   endpoints: [{ path: '/v1/predict', method: 'post', usdPrice: 0.05 }],\n * });\n * ```\n */\nexport function createManagementClient(config: ManagementClientConfig): RelaiManagementClient {\n  const base = (config.baseUrl ?? RELAI_API_BASE).replace(/\\/$/, '');\n  const headers = {\n    'X-Service-Key': config.serviceKey,\n    'Content-Type': 'application/json',\n  };\n\n  async function req<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await fetch(`${base}${path}`, {\n      method,\n      headers,\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => '');\n      throw new Error(`[relai-mgmt] ${method} ${path} → ${res.status}: ${text}`);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  return {\n    // ── APIs ──────────────────────────────────────────────────────────────\n\n    createApi(input) {\n      return req<RelaiApi>('POST', '/v1/apis', input);\n    },\n\n    async listApis() {\n      const data = await req<{ apis: RelaiApi[] }>('GET', '/v1/apis');\n      return data.apis;\n    },\n\n    getApi(apiId) {\n      return req<RelaiApi>('GET', `/v1/apis/${apiId}`);\n    },\n\n    updateApi(apiId, input) {\n      return req<RelaiApi>('PATCH', `/v1/apis/${apiId}`, input);\n    },\n\n    deleteApi(apiId) {\n      return req<{ success: boolean; apiId: string }>('DELETE', `/v1/apis/${apiId}`);\n    },\n\n    // ── Pricing ──────────────────────────────────────────────────────────\n\n    getPricing(apiId) {\n      return req<{ apiId: string; endpoints: ApiEndpoint[] }>('GET', `/v1/apis/${apiId}/pricing`);\n    },\n\n    setPricing(apiId, endpoints) {\n      return req<{ success: boolean; apiId: string; updated: number }>('PUT', `/v1/apis/${apiId}/pricing`, { endpoints });\n    },\n\n    // ── Analytics ────────────────────────────────────────────────────────\n\n    getStats(apiId) {\n      return req<ApiStats>('GET', `/v1/apis/${apiId}/stats`);\n    },\n\n    getPayments(apiId, options = {}) {\n      const params = new URLSearchParams();\n      if (options.limit)  params.set('limit',  String(options.limit));\n      if (options.from)   params.set('from',   options.from);\n      if (options.cursor) params.set('cursor', options.cursor);\n      const qs = params.toString() ? `?${params}` : '';\n      return req<ApiPaymentsResult>('GET', `/v1/apis/${apiId}/payments${qs}`);\n    },\n\n    getLogs(apiId, options = {}) {\n      const params = new URLSearchParams();\n      if (options.limit)  params.set('limit',  String(options.limit));\n      if (options.from)   params.set('from',   options.from);\n      if (options.cursor) params.set('cursor', options.cursor);\n      const qs = params.toString() ? `?${params}` : '';\n      return req<ApiLogsResult>('GET', `/v1/apis/${apiId}/logs${qs}`);\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,IAAM,iBAAiB;AACvB,IAAM,gBAAgB,GAAG,cAAc;AA8HvC,eAAsB,wBACpB,SACA,QAAQ,SACuB;AAC/B,QAAM,EAAE,KAAK,IAAI,MAAM,OAAO,WAAW;AAEzC,QAAM,YAAY,QAAQ,UAAU,SAAS;AAG7C,QAAM,eAAe,MAAM,MAAM,eAAe;AAAA,IAC9C,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,EACpC,CAAC;AACD,MAAI,CAAC,aAAa,GAAI,OAAM,IAAI,MAAM,6BAA6B,aAAa,MAAM,EAAE;AACxF,QAAM,EAAE,QAAQ,IAAI,MAAM,aAAa,KAAK;AAG5C,QAAM,WAAW,IAAI,YAAY,EAAE,OAAO,OAAO;AACjD,QAAM,WAAW,KAAK,SAAS,UAAU,QAAQ,SAAS;AAC1D,QAAM,YAAY,OAAO,KAAK,QAAQ,EAAE,SAAS,QAAQ;AAGzD,QAAM,SAAS,MAAM,MAAM,eAAe;AAAA,IACxC,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,EAAE,WAAW,WAAW,SAAS,MAAM,CAAC;AAAA,EAC/D,CAAC;AACD,MAAI,CAAC,OAAO,GAAI,OAAM,IAAI,MAAM,4BAA4B,OAAO,MAAM,EAAE;AAC3E,SAAO,OAAO,KAAK;AACrB;AASA,eAAsB,qBACpB,QACA,QAAQ,SACuB;AAC/B,QAAM,YAAY,OAAO;AAGzB,QAAM,eAAe,MAAM,MAAM,eAAe;AAAA,IAC9C,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,EACpC,CAAC;AACD,MAAI,CAAC,aAAa,GAAI,OAAM,IAAI,MAAM,6BAA6B,aAAa,MAAM,EAAE;AACxF,QAAM,EAAE,QAAQ,IAAI,MAAM,aAAa,KAAK;AAG5C,QAAM,YAAY,MAAM,OAAO,YAAY,OAAO;AAClD,QAAM,SAAS,MAAM,MAAM,eAAe;AAAA,IACxC,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,EAAE,WAAW,WAAW,SAAS,MAAM,CAAC;AAAA,EAC/D,CAAC;AACD,MAAI,CAAC,OAAO,GAAI,OAAM,IAAI,MAAM,4BAA4B,OAAO,MAAM,EAAE;AAC3E,SAAO,OAAO,KAAK;AACrB;AA0CO,SAAS,uBAAuB,QAAuD;AAC5F,QAAM,QAAQ,OAAO,WAAW,gBAAgB,QAAQ,OAAO,EAAE;AACjE,QAAM,UAAU;AAAA,IACd,iBAAiB,OAAO;AAAA,IACxB,gBAAgB;AAAA,EAClB;AAEA,iBAAe,IAAO,QAAgB,MAAc,MAA4B;AAC9E,UAAM,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI;AAAA,MACxC;AAAA,MACA;AAAA,MACA,GAAI,SAAS,SAAY,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI,CAAC;AAAA,IAC7D,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,EAAE;AAC5C,YAAM,IAAI,MAAM,gBAAgB,MAAM,IAAI,IAAI,WAAM,IAAI,MAAM,KAAK,IAAI,EAAE;AAAA,IAC3E;AACA,WAAO,IAAI,KAAK;AAAA,EAClB;AAEA,SAAO;AAAA;AAAA,IAGL,UAAU,OAAO;AACf,aAAO,IAAc,QAAQ,YAAY,KAAK;AAAA,IAChD;AAAA,IAEA,MAAM,WAAW;AACf,YAAM,OAAO,MAAM,IAA0B,OAAO,UAAU;AAC9D,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,OAAO,OAAO;AACZ,aAAO,IAAc,OAAO,YAAY,KAAK,EAAE;AAAA,IACjD;AAAA,IAEA,UAAU,OAAO,OAAO;AACtB,aAAO,IAAc,SAAS,YAAY,KAAK,IAAI,KAAK;AAAA,IAC1D;AAAA,IAEA,UAAU,OAAO;AACf,aAAO,IAAyC,UAAU,YAAY,KAAK,EAAE;AAAA,IAC/E;AAAA;AAAA,IAIA,WAAW,OAAO;AAChB,aAAO,IAAiD,OAAO,YAAY,KAAK,UAAU;AAAA,IAC5F;AAAA,IAEA,WAAW,OAAO,WAAW;AAC3B,aAAO,IAA0D,OAAO,YAAY,KAAK,YAAY,EAAE,UAAU,CAAC;AAAA,IACpH;AAAA;AAAA,IAIA,SAAS,OAAO;AACd,aAAO,IAAc,OAAO,YAAY,KAAK,QAAQ;AAAA,IACvD;AAAA,IAEA,YAAY,OAAO,UAAU,CAAC,GAAG;AAC/B,YAAM,SAAS,IAAI,gBAAgB;AACnC,UAAI,QAAQ,MAAQ,QAAO,IAAI,SAAU,OAAO,QAAQ,KAAK,CAAC;AAC9D,UAAI,QAAQ,KAAQ,QAAO,IAAI,QAAU,QAAQ,IAAI;AACrD,UAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,YAAM,KAAK,OAAO,SAAS,IAAI,IAAI,MAAM,KAAK;AAC9C,aAAO,IAAuB,OAAO,YAAY,KAAK,YAAY,EAAE,EAAE;AAAA,IACxE;AAAA,IAEA,QAAQ,OAAO,UAAU,CAAC,GAAG;AAC3B,YAAM,SAAS,IAAI,gBAAgB;AACnC,UAAI,QAAQ,MAAQ,QAAO,IAAI,SAAU,OAAO,QAAQ,KAAK,CAAC;AAC9D,UAAI,QAAQ,KAAQ,QAAO,IAAI,QAAU,QAAQ,IAAI;AACrD,UAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,YAAM,KAAK,OAAO,SAAS,IAAI,IAAI,MAAM,KAAK;AAC9C,aAAO,IAAmB,OAAO,YAAY,KAAK,QAAQ,EAAE,EAAE;AAAA,IAChE;AAAA,EACF;AACF;","names":[]}

package/dist/management.d.cts

@@ -0,0 +1,172 @@
+interface ManagementClientConfig {
+    /** Service key (sk_live_...) for authenticating management API calls */
+    serviceKey: string;
+    /** Override base URL (default: https://api.relai.fi) */
+    baseUrl?: string;
+}
+interface RelaiApi {
+    apiId: string;
+    name: string;
+    description?: string;
+    baseUrl: string;
+    subdomain?: string | null;
+    network: string;
+    facilitator: string;
+    x402Version: number;
+    status: string;
+    merchantWallet: string;
+    websiteUrl?: string;
+    logoUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ApiEndpointInput {
+    path: string;
+    method: string;
+    usdPrice: number;
+    enabled?: boolean;
+}
+interface ApiEndpoint extends ApiEndpointInput {
+    network: string;
+    enabled: boolean;
+}
+interface CreateApiInput {
+    name: string;
+    baseUrl: string;
+    merchantWallet: string;
+    network: string;
+    description?: string;
+    websiteUrl?: string;
+    logoUrl?: string;
+    endpoints?: ApiEndpointInput[];
+}
+interface UpdateApiInput {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    merchantWallet?: string;
+    websiteUrl?: string;
+    logoUrl?: string;
+}
+interface ApiStats {
+    apiId: string;
+    totalRequests: number;
+    totalRevenue: number;
+    currency: string;
+}
+interface ApiPayment {
+    transaction: string;
+    path: string;
+    method: string;
+    amount: number;
+    currency: string;
+    network: string;
+    status: string;
+    success: boolean;
+    payer: string;
+    createdAt: string;
+}
+interface ApiPaymentsResult {
+    apiId: string;
+    payments: ApiPayment[];
+    nextCursor: string | null;
+}
+interface ApiLogItem {
+    id: string;
+    timestamp: string;
+    method: string;
+    path: string;
+    status: string;
+    cost: number;
+    currency: string;
+    duration: number;
+    transaction: string;
+    network: string;
+    success: boolean;
+    payer: string;
+}
+interface ApiLogsResult {
+    items: ApiLogItem[];
+    nextCursor: string | null;
+}
+interface AgentBootstrapResult {
+    key: string;
+    label: string;
+    active: boolean;
+    createdAt: string;
+}
+/**
+ * Bootstrap a service key for a Solana agent.
+ * Run once — store the returned key securely.
+ *
+ * @param keypair  A Solana Keypair (from @solana/web3.js)
+ * @param label    Human-readable label for the key
+ */
+declare function bootstrapAgentKeySolana(keypair: {
+    publicKey: {
+        toBase58(): string;
+    };
+    secretKey: Uint8Array;
+}, label?: string): Promise<AgentBootstrapResult>;
+/**
+ * Bootstrap a service key for an EVM agent.
+ * Run once — store the returned key securely.
+ *
+ * @param wallet  An ethers.js Wallet or Signer with address + signMessage
+ * @param label   Human-readable label for the key
+ */
+declare function bootstrapAgentKeyEvm(wallet: {
+    address: string;
+    signMessage(message: string): Promise<string>;
+}, label?: string): Promise<AgentBootstrapResult>;
+interface RelaiManagementClient {
+    createApi(input: CreateApiInput): Promise<RelaiApi>;
+    listApis(): Promise<RelaiApi[]>;
+    getApi(apiId: string): Promise<RelaiApi>;
+    updateApi(apiId: string, input: UpdateApiInput): Promise<RelaiApi>;
+    deleteApi(apiId: string): Promise<{
+        success: boolean;
+        apiId: string;
+    }>;
+    getPricing(apiId: string): Promise<{
+        apiId: string;
+        endpoints: ApiEndpoint[];
+    }>;
+    setPricing(apiId: string, endpoints: ApiEndpointInput[]): Promise<{
+        success: boolean;
+        apiId: string;
+        updated: number;
+    }>;
+    getStats(apiId: string): Promise<ApiStats>;
+    getPayments(apiId: string, options?: {
+        limit?: number;
+        from?: string;
+        cursor?: string;
+    }): Promise<ApiPaymentsResult>;
+    getLogs(apiId: string, options?: {
+        limit?: number;
+        from?: string;
+        cursor?: string;
+    }): Promise<ApiLogsResult>;
+}
+/**
+ * Create a RelAI Management API client.
+ *
+ * @example
+ * ```typescript
+ * import { createManagementClient } from '@relai-fi/x402/management';
+ *
+ * const mgmt = createManagementClient({ serviceKey: process.env.RELAI_SERVICE_KEY! });
+ *
+ * const api = await mgmt.createApi({
+ *   name: 'My ML API',
+ *   baseUrl: 'https://inference.example.com',
+ *   merchantWallet: '0xYourWallet',
+ *   network: 'base',
+ *   endpoints: [{ path: '/v1/predict', method: 'post', usdPrice: 0.05 }],
+ * });
+ * ```
+ */
+declare function createManagementClient(config: ManagementClientConfig): RelaiManagementClient;
+
+export { type AgentBootstrapResult, type ApiEndpoint, type ApiEndpointInput, type ApiLogItem, type ApiLogsResult, type ApiPayment, type ApiPaymentsResult, type ApiStats, type CreateApiInput, type ManagementClientConfig, type RelaiApi, type RelaiManagementClient, type UpdateApiInput, bootstrapAgentKeyEvm, bootstrapAgentKeySolana, createManagementClient };

package/dist/management.d.ts

@@ -0,0 +1,172 @@
+interface ManagementClientConfig {
+    /** Service key (sk_live_...) for authenticating management API calls */
+    serviceKey: string;
+    /** Override base URL (default: https://api.relai.fi) */
+    baseUrl?: string;
+}
+interface RelaiApi {
+    apiId: string;
+    name: string;
+    description?: string;
+    baseUrl: string;
+    subdomain?: string | null;
+    network: string;
+    facilitator: string;
+    x402Version: number;
+    status: string;
+    merchantWallet: string;
+    websiteUrl?: string;
+    logoUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ApiEndpointInput {
+    path: string;
+    method: string;
+    usdPrice: number;
+    enabled?: boolean;
+}
+interface ApiEndpoint extends ApiEndpointInput {
+    network: string;
+    enabled: boolean;
+}
+interface CreateApiInput {
+    name: string;
+    baseUrl: string;
+    merchantWallet: string;
+    network: string;
+    description?: string;
+    websiteUrl?: string;
+    logoUrl?: string;
+    endpoints?: ApiEndpointInput[];
+}
+interface UpdateApiInput {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    merchantWallet?: string;
+    websiteUrl?: string;
+    logoUrl?: string;
+}
+interface ApiStats {
+    apiId: string;
+    totalRequests: number;
+    totalRevenue: number;
+    currency: string;
+}
+interface ApiPayment {
+    transaction: string;
+    path: string;
+    method: string;
+    amount: number;
+    currency: string;
+    network: string;
+    status: string;
+    success: boolean;
+    payer: string;
+    createdAt: string;
+}
+interface ApiPaymentsResult {
+    apiId: string;
+    payments: ApiPayment[];
+    nextCursor: string | null;
+}
+interface ApiLogItem {
+    id: string;
+    timestamp: string;
+    method: string;
+    path: string;
+    status: string;
+    cost: number;
+    currency: string;
+    duration: number;
+    transaction: string;
+    network: string;
+    success: boolean;
+    payer: string;
+}
+interface ApiLogsResult {
+    items: ApiLogItem[];
+    nextCursor: string | null;
+}
+interface AgentBootstrapResult {
+    key: string;
+    label: string;
+    active: boolean;
+    createdAt: string;
+}
+/**
+ * Bootstrap a service key for a Solana agent.
+ * Run once — store the returned key securely.
+ *
+ * @param keypair  A Solana Keypair (from @solana/web3.js)
+ * @param label    Human-readable label for the key
+ */
+declare function bootstrapAgentKeySolana(keypair: {
+    publicKey: {
+        toBase58(): string;
+    };
+    secretKey: Uint8Array;
+}, label?: string): Promise<AgentBootstrapResult>;
+/**
+ * Bootstrap a service key for an EVM agent.
+ * Run once — store the returned key securely.
+ *
+ * @param wallet  An ethers.js Wallet or Signer with address + signMessage
+ * @param label   Human-readable label for the key
+ */
+declare function bootstrapAgentKeyEvm(wallet: {
+    address: string;
+    signMessage(message: string): Promise<string>;
+}, label?: string): Promise<AgentBootstrapResult>;
+interface RelaiManagementClient {
+    createApi(input: CreateApiInput): Promise<RelaiApi>;
+    listApis(): Promise<RelaiApi[]>;
+    getApi(apiId: string): Promise<RelaiApi>;
+    updateApi(apiId: string, input: UpdateApiInput): Promise<RelaiApi>;
+    deleteApi(apiId: string): Promise<{
+        success: boolean;
+        apiId: string;
+    }>;
+    getPricing(apiId: string): Promise<{
+        apiId: string;
+        endpoints: ApiEndpoint[];
+    }>;
+    setPricing(apiId: string, endpoints: ApiEndpointInput[]): Promise<{
+        success: boolean;
+        apiId: string;
+        updated: number;
+    }>;
+    getStats(apiId: string): Promise<ApiStats>;
+    getPayments(apiId: string, options?: {
+        limit?: number;
+        from?: string;
+        cursor?: string;
+    }): Promise<ApiPaymentsResult>;
+    getLogs(apiId: string, options?: {
+        limit?: number;
+        from?: string;
+        cursor?: string;
+    }): Promise<ApiLogsResult>;
+}
+/**
+ * Create a RelAI Management API client.
+ *
+ * @example
+ * ```typescript
+ * import { createManagementClient } from '@relai-fi/x402/management';
+ *
+ * const mgmt = createManagementClient({ serviceKey: process.env.RELAI_SERVICE_KEY! });
+ *
+ * const api = await mgmt.createApi({
+ *   name: 'My ML API',
+ *   baseUrl: 'https://inference.example.com',
+ *   merchantWallet: '0xYourWallet',
+ *   network: 'base',
+ *   endpoints: [{ path: '/v1/predict', method: 'post', usdPrice: 0.05 }],
+ * });
+ * ```
+ */
+declare function createManagementClient(config: ManagementClientConfig): RelaiManagementClient;
+
+export { type AgentBootstrapResult, type ApiEndpoint, type ApiEndpointInput, type ApiLogItem, type ApiLogsResult, type ApiPayment, type ApiPaymentsResult, type ApiStats, type CreateApiInput, type ManagementClientConfig, type RelaiApi, type RelaiManagementClient, type UpdateApiInput, bootstrapAgentKeyEvm, bootstrapAgentKeySolana, createManagementClient };

package/dist/management.js

@@ -0,0 +1,113 @@
+// src/management.ts
+var RELAI_API_BASE = "https://api.relai.fi";
+var BOOTSTRAP_URL = `${RELAI_API_BASE}/mcp/management/bootstrap/agent`;
+async function bootstrapAgentKeySolana(keypair, label = "agent") {
+  const { sign } = await import("tweetnacl");
+  const publicKey = keypair.publicKey.toBase58();
+  const challengeRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey })
+  });
+  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);
+  const { message } = await challengeRes.json();
+  const msgBytes = new TextEncoder().encode(message);
+  const sigBytes = sign.detached(msgBytes, keypair.secretKey);
+  const signature = Buffer.from(sigBytes).toString("base64");
+  const keyRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey, signature, message, label })
+  });
+  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);
+  return keyRes.json();
+}
+async function bootstrapAgentKeyEvm(wallet, label = "agent") {
+  const publicKey = wallet.address;
+  const challengeRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey })
+  });
+  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);
+  const { message } = await challengeRes.json();
+  const signature = await wallet.signMessage(message);
+  const keyRes = await fetch(BOOTSTRAP_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ publicKey, signature, message, label })
+  });
+  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);
+  return keyRes.json();
+}
+function createManagementClient(config) {
+  const base = (config.baseUrl ?? RELAI_API_BASE).replace(/\/$/, "");
+  const headers = {
+    "X-Service-Key": config.serviceKey,
+    "Content-Type": "application/json"
+  };
+  async function req(method, path, body) {
+    const res = await fetch(`${base}${path}`, {
+      method,
+      headers,
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`[relai-mgmt] ${method} ${path} \u2192 ${res.status}: ${text}`);
+    }
+    return res.json();
+  }
+  return {
+    // ── APIs ──────────────────────────────────────────────────────────────
+    createApi(input) {
+      return req("POST", "/v1/apis", input);
+    },
+    async listApis() {
+      const data = await req("GET", "/v1/apis");
+      return data.apis;
+    },
+    getApi(apiId) {
+      return req("GET", `/v1/apis/${apiId}`);
+    },
+    updateApi(apiId, input) {
+      return req("PATCH", `/v1/apis/${apiId}`, input);
+    },
+    deleteApi(apiId) {
+      return req("DELETE", `/v1/apis/${apiId}`);
+    },
+    // ── Pricing ──────────────────────────────────────────────────────────
+    getPricing(apiId) {
+      return req("GET", `/v1/apis/${apiId}/pricing`);
+    },
+    setPricing(apiId, endpoints) {
+      return req("PUT", `/v1/apis/${apiId}/pricing`, { endpoints });
+    },
+    // ── Analytics ────────────────────────────────────────────────────────
+    getStats(apiId) {
+      return req("GET", `/v1/apis/${apiId}/stats`);
+    },
+    getPayments(apiId, options = {}) {
+      const params = new URLSearchParams();
+      if (options.limit) params.set("limit", String(options.limit));
+      if (options.from) params.set("from", options.from);
+      if (options.cursor) params.set("cursor", options.cursor);
+      const qs = params.toString() ? `?${params}` : "";
+      return req("GET", `/v1/apis/${apiId}/payments${qs}`);
+    },
+    getLogs(apiId, options = {}) {
+      const params = new URLSearchParams();
+      if (options.limit) params.set("limit", String(options.limit));
+      if (options.from) params.set("from", options.from);
+      if (options.cursor) params.set("cursor", options.cursor);
+      const qs = params.toString() ? `?${params}` : "";
+      return req("GET", `/v1/apis/${apiId}/logs${qs}`);
+    }
+  };
+}
+export {
+  bootstrapAgentKeyEvm,
+  bootstrapAgentKeySolana,
+  createManagementClient
+};
+//# sourceMappingURL=management.js.map

package/dist/management.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/management.ts"],"sourcesContent":["// src/management.ts\n// RelAI Management API client — create and manage monetised APIs programmatically.\n// Docs: https://relai.fi/documentation/management-api\n\nconst RELAI_API_BASE = 'https://api.relai.fi';\nconst BOOTSTRAP_URL = `${RELAI_API_BASE}/mcp/management/bootstrap/agent`;\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ManagementClientConfig {\n  /** Service key (sk_live_...) for authenticating management API calls */\n  serviceKey: string;\n  /** Override base URL (default: https://api.relai.fi) */\n  baseUrl?: string;\n}\n\nexport interface RelaiApi {\n  apiId: string;\n  name: string;\n  description?: string;\n  baseUrl: string;\n  subdomain?: string | null;\n  network: string;\n  facilitator: string;\n  x402Version: number;\n  status: string;\n  merchantWallet: string;\n  websiteUrl?: string;\n  logoUrl?: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ApiEndpointInput {\n  path: string;\n  method: string;\n  usdPrice: number;\n  enabled?: boolean;\n}\n\nexport interface ApiEndpoint extends ApiEndpointInput {\n  network: string;\n  enabled: boolean;\n}\n\nexport interface CreateApiInput {\n  name: string;\n  baseUrl: string;\n  merchantWallet: string;\n  network: string;\n  description?: string;\n  websiteUrl?: string;\n  logoUrl?: string;\n  endpoints?: ApiEndpointInput[];\n}\n\nexport interface UpdateApiInput {\n  name?: string;\n  description?: string;\n  baseUrl?: string;\n  merchantWallet?: string;\n  websiteUrl?: string;\n  logoUrl?: string;\n}\n\nexport interface ApiStats {\n  apiId: string;\n  totalRequests: number;\n  totalRevenue: number;\n  currency: string;\n}\n\nexport interface ApiPayment {\n  transaction: string;\n  path: string;\n  method: string;\n  amount: number;\n  currency: string;\n  network: string;\n  status: string;\n  success: boolean;\n  payer: string;\n  createdAt: string;\n}\n\nexport interface ApiPaymentsResult {\n  apiId: string;\n  payments: ApiPayment[];\n  nextCursor: string | null;\n}\n\nexport interface ApiLogItem {\n  id: string;\n  timestamp: string;\n  method: string;\n  path: string;\n  status: string;\n  cost: number;\n  currency: string;\n  duration: number;\n  transaction: string;\n  network: string;\n  success: boolean;\n  payer: string;\n}\n\nexport interface ApiLogsResult {\n  items: ApiLogItem[];\n  nextCursor: string | null;\n}\n\nexport interface AgentBootstrapResult {\n  key: string;\n  label: string;\n  active: boolean;\n  createdAt: string;\n}\n\n// ============================================================================\n// Agent bootstrap (autonomous key provisioning)\n// ============================================================================\n\n/**\n * Bootstrap a service key for a Solana agent.\n * Run once — store the returned key securely.\n *\n * @param keypair  A Solana Keypair (from @solana/web3.js)\n * @param label    Human-readable label for the key\n */\nexport async function bootstrapAgentKeySolana(\n  keypair: { publicKey: { toBase58(): string }; secretKey: Uint8Array },\n  label = 'agent',\n): Promise<AgentBootstrapResult> {\n  const { sign } = await import('tweetnacl');\n\n  const publicKey = keypair.publicKey.toBase58();\n\n  // Step 1 — request challenge\n  const challengeRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey }),\n  });\n  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);\n  const { message } = await challengeRes.json() as { message: string };\n\n  // Step 2 — sign\n  const msgBytes = new TextEncoder().encode(message);\n  const sigBytes = sign.detached(msgBytes, keypair.secretKey);\n  const signature = Buffer.from(sigBytes).toString('base64');\n\n  // Step 3 — get service key\n  const keyRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey, signature, message, label }),\n  });\n  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);\n  return keyRes.json() as Promise<AgentBootstrapResult>;\n}\n\n/**\n * Bootstrap a service key for an EVM agent.\n * Run once — store the returned key securely.\n *\n * @param wallet  An ethers.js Wallet or Signer with address + signMessage\n * @param label   Human-readable label for the key\n */\nexport async function bootstrapAgentKeyEvm(\n  wallet: { address: string; signMessage(message: string): Promise<string> },\n  label = 'agent',\n): Promise<AgentBootstrapResult> {\n  const publicKey = wallet.address;\n\n  // Step 1 — request challenge\n  const challengeRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey }),\n  });\n  if (!challengeRes.ok) throw new Error(`Challenge request failed: ${challengeRes.status}`);\n  const { message } = await challengeRes.json() as { message: string };\n\n  // Step 2+3 — sign and get key\n  const signature = await wallet.signMessage(message);\n  const keyRes = await fetch(BOOTSTRAP_URL, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ publicKey, signature, message, label }),\n  });\n  if (!keyRes.ok) throw new Error(`Key provisioning failed: ${keyRes.status}`);\n  return keyRes.json() as Promise<AgentBootstrapResult>;\n}\n\n// ============================================================================\n// Management client\n// ============================================================================\n\nexport interface RelaiManagementClient {\n  // APIs\n  createApi(input: CreateApiInput): Promise<RelaiApi>;\n  listApis(): Promise<RelaiApi[]>;\n  getApi(apiId: string): Promise<RelaiApi>;\n  updateApi(apiId: string, input: UpdateApiInput): Promise<RelaiApi>;\n  deleteApi(apiId: string): Promise<{ success: boolean; apiId: string }>;\n\n  // Pricing\n  getPricing(apiId: string): Promise<{ apiId: string; endpoints: ApiEndpoint[] }>;\n  setPricing(apiId: string, endpoints: ApiEndpointInput[]): Promise<{ success: boolean; apiId: string; updated: number }>;\n\n  // Analytics\n  getStats(apiId: string): Promise<ApiStats>;\n  getPayments(apiId: string, options?: { limit?: number; from?: string; cursor?: string }): Promise<ApiPaymentsResult>;\n  getLogs(apiId: string, options?: { limit?: number; from?: string; cursor?: string }): Promise<ApiLogsResult>;\n}\n\n/**\n * Create a RelAI Management API client.\n *\n * @example\n * ```typescript\n * import { createManagementClient } from '@relai-fi/x402/management';\n *\n * const mgmt = createManagementClient({ serviceKey: process.env.RELAI_SERVICE_KEY! });\n *\n * const api = await mgmt.createApi({\n *   name: 'My ML API',\n *   baseUrl: 'https://inference.example.com',\n *   merchantWallet: '0xYourWallet',\n *   network: 'base',\n *   endpoints: [{ path: '/v1/predict', method: 'post', usdPrice: 0.05 }],\n * });\n * ```\n */\nexport function createManagementClient(config: ManagementClientConfig): RelaiManagementClient {\n  const base = (config.baseUrl ?? RELAI_API_BASE).replace(/\\/$/, '');\n  const headers = {\n    'X-Service-Key': config.serviceKey,\n    'Content-Type': 'application/json',\n  };\n\n  async function req<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await fetch(`${base}${path}`, {\n      method,\n      headers,\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n    });\n    if (!res.ok) {\n      const text = await res.text().catch(() => '');\n      throw new Error(`[relai-mgmt] ${method} ${path} → ${res.status}: ${text}`);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  return {\n    // ── APIs ──────────────────────────────────────────────────────────────\n\n    createApi(input) {\n      return req<RelaiApi>('POST', '/v1/apis', input);\n    },\n\n    async listApis() {\n      const data = await req<{ apis: RelaiApi[] }>('GET', '/v1/apis');\n      return data.apis;\n    },\n\n    getApi(apiId) {\n      return req<RelaiApi>('GET', `/v1/apis/${apiId}`);\n    },\n\n    updateApi(apiId, input) {\n      return req<RelaiApi>('PATCH', `/v1/apis/${apiId}`, input);\n    },\n\n    deleteApi(apiId) {\n      return req<{ success: boolean; apiId: string }>('DELETE', `/v1/apis/${apiId}`);\n    },\n\n    // ── Pricing ──────────────────────────────────────────────────────────\n\n    getPricing(apiId) {\n      return req<{ apiId: string; endpoints: ApiEndpoint[] }>('GET', `/v1/apis/${apiId}/pricing`);\n    },\n\n    setPricing(apiId, endpoints) {\n      return req<{ success: boolean; apiId: string; updated: number }>('PUT', `/v1/apis/${apiId}/pricing`, { endpoints });\n    },\n\n    // ── Analytics ────────────────────────────────────────────────────────\n\n    getStats(apiId) {\n      return req<ApiStats>('GET', `/v1/apis/${apiId}/stats`);\n    },\n\n    getPayments(apiId, options = {}) {\n      const params = new URLSearchParams();\n      if (options.limit)  params.set('limit',  String(options.limit));\n      if (options.from)   params.set('from',   options.from);\n      if (options.cursor) params.set('cursor', options.cursor);\n      const qs = params.toString() ? `?${params}` : '';\n      return req<ApiPaymentsResult>('GET', `/v1/apis/${apiId}/payments${qs}`);\n    },\n\n    getLogs(apiId, options = {}) {\n      const params = new URLSearchParams();\n      if (options.limit)  params.set('limit',  String(options.limit));\n      if (options.from)   params.set('from',   options.from);\n      if (options.cursor) params.set('cursor', options.cursor);\n      const qs = params.toString() ? `?${params}` : '';\n      return req<ApiLogsResult>('GET', `/v1/apis/${apiId}/logs${qs}`);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relai-fi/x402",
-  "version": "0.5.24",
+  "version": "0.5.26",
   "description": "Unified x402 payment SDK for Solana, Base, Avalanche, SKALE Base, SKALE BITE, Polygon, and Ethereum. Automatic 402 handling with zero gas fees.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -85,6 +85,11 @@
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.js",
       "require": "./dist/utils/index.cjs"
+    },
+    "./management": {
+      "types": "./dist/management.d.ts",
+      "import": "./dist/management.js",
+      "require": "./dist/management.cjs"
     }
   }
 }