twe-cloud/nibiashara-shelves

Pay-per-call APIs for AI agents: FMCSA carrier & broker checks, OFAC sanctions screening, African FX. x402 micropayments or a prepaid pass — no API key. # @nibiashara/shelves Pay-per-call APIs for AI agents — no API key, no signup, no subscription. US freight checks (FMCSA carrier authority, safety BASICs, broker authority), OFAC sanctions screening, and African FX rates (official + street/parallel). Your agent pays per call in USDC on Base over the x402 protocol, or spends credits from a prepaid pass. Full docs: **agents.nibiashara.biz ```bash npm i @nibiashara/shelves ``` ## Use a pass (simplest — no wallet needed) One `$0.99` pass carries 100 credits, good on every shelf priced ≤ $0.10. ```js import { Shelves } from "@nibiashara/shelves"; const shelves = new Shelves({ pass: process.env.SHELF_PASS }); // Should we tender this load? const carrier = await shelves.carrierAuthority({ dot: "44110" }); if (carrier.verdict !== "CLEAR") console.log("hold:", carrier.flags); // Is this counterparty sanctioned? const screen = await shelves.sanctionsScreen({ name: "Example Trading Co" }); // screen.verdict === "CLEAR" | "REVIEW" | "HIT" console.log(await shelves.creditsRemaining()); // 98 ``` ## Or pay per call with a wallet Bring any x402-capable fetch (e.g. `@x402/fetch` + `@x402/evm`) and the client uses it — each call settles its own micro-payment. ```js import { wrapFetchWithPayment } from "@x402/fetch"; import { Shelves } from "@nibiashara/shelves"; const shelves = new Shelves({ fetch: wrapFetchWithPayment(fetch, signer) }); const rate = await shelves.fxParallel({ pair: "USD-NGN" }); ``` ## Shelves | Method | Shelf | Price | | --- | --- | --- | | `carrierAuthority({dot\|mc})` | FMCSA authority, safety rating, operating status | $0.10 | | `carrierSafetyBasics({dot})` | FMCSA SMS BASIC percentiles + intervention flags | $0.10 | | `brokerAuthority({mc})` | FMCSA broker authority status | $0.10 | | `sanctionsScreen({name})` | OFAC SDN + Consolidated screen, ~40k names | $0.02 | | `fxOfficial({pair})` | Central-bank reference rate | $0.01 | | `fxOfficialAll()` | All eight African pairs | $0.02 …