@agenttoll/sdk 1.0.1 → 1.0.2

package/README.md

@@ -4,45 +4,81 @@ One-line micropayment integration for AI agents.
 
 ## Installation
 
-### From npm (recommended)
 ```bash
 npm install @agenttoll/sdk
 ```
 
-### From GitHub (if npm is unavailable)
-```bash
-npm install github:agenttoll/sdk
+## Quick Start
+
+### 1. Get Your API Key
+
+```javascript
+// Via API
+const response = await fetch('https://toll.agenttoll.io/api/publisher/register', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    name: 'My API',
+    email: 'you@example.com',
+    wallet_address: 'YourSolanaWallet'
+  })
+});
+const { api_key } = await response.json();
 ```
 
-### Direct download
-Copy [tollbooth.js](./tollbooth.js) into your project.
+Or use the web form at [toll.agenttoll.io](https://toll.agenttoll.io)
 
-## Usage
+### 2. Add to Your Server
 
-### Express
 ```javascript
 import tollbooth from '@agenttoll/sdk';
-// or if installed locally:
-// import tollbooth from './tollbooth.js';
 
-app.use(tollbooth('pk_live_xxx'));
+// Toll all agents, let humans through free
+app.use(tollbooth(process.env.AGENTTOLL_KEY, {
+  amount: 0.005,        // USDC per request
+  freeForHumans: true   // Browsers pass free
+}));
+
+// Or use the convenience method
+app.use(tollbooth.agentsOnly(process.env.AGENTTOLL_KEY));
 ```
 
-### Cloudflare Workers
+## SDK Options
+
 ```javascript
-import { tollgate } from '@agenttoll/sdk/edge';
+tollbooth(apiKey, {
+  amount: 0.005,           // USDC to charge (default: 0.005)
+  freeForHumans: false,    // Let browsers through free
+  paths: ['*'],            // Routes to toll (glob patterns)
+  walletAddress: null,     // Override default wallet
+  bypassHeader: null       // Header for internal bypass
+});
+```
 
-export default tollgate('pk_live_xxx', { amount: 0.005 });
+## Convenience Methods
+
+```javascript
+// Toll only AI agents
+tollbooth.agentsOnly(apiKey, options)
+
+// Protect single route
+tollbooth.protect(apiKey, options)
+
+// Check if paid
+tollbooth.hasPaid(req)  // boolean
+
+// Check if AI agent
+tollbooth.isAgent(req)  // boolean
 ```
 
-### Agent Tool (for AI agents)
+## Cloudflare Workers / Edge
+
 ```javascript
-import { payTollTool } from '@agenttoll/sdk/tool';
+import { tollgate } from '@agenttoll/sdk/edge';
 
-// Add to your agent's tools
-tools: [payTollTool]
+export default tollgate(PUBLISHER_KEY, { amount: 0.01 });
 ```
 
-## API Reference
+## Full Documentation
 
-See [https://agenttoll.io/docs](https://agenttoll.io/docs) for full documentation.
+See [toll.agenttoll.io/docs](https://toll.agenttoll.io/docs)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenttoll/sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "One-line micropayment integration for AI agents - Express, Cloudflare Workers, Vercel Edge",
   "main": "tollbooth.js",
   "exports": {