{"_id":"@agentpayy/sdk","_rev":"2-ab137af6ec9ca2f2368d011896b31106","name":"@agentpayy/sdk","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.1":{"name":"@agentpayy/sdk","version":"1.0.1","keywords":["ai","agents","payments","ethereum","web3","wallet"],"license":"MIT","_id":"@agentpayy/sdk@1.0.1","maintainers":[{"name":"agentpayy","email":"lawrence@siestamarkets.com"}],"homepage":"https://github.com/AgentPayy/AgentPayy#readme","bugs":{"url":"https://github.com/AgentPayy/AgentPayy/issues"},"dist":{"shasum":"849e1013ef3ebc4f4743f99f04537ce247ce15a6","tarball":"https://registry.npmjs.org/@agentpayy/sdk/-/sdk-1.0.1.tgz","fileCount":70,"integrity":"sha512-ZM9N77v4KOBRMcYUVfuC1pRFIdN+klECUG0yJJWeIFtRpn6gmRORtw+ntXCJSqIaaU4BkvqDE8YR1dYgIgZ6Fw==","signatures":[{"sig":"MEQCIFo6WHCmSJXK3XZN8/x44camOA2Yzo22DJEoa7D9gsNtAiAqARM1E4mTyL45zobaLskLD4e71rmgVORgmwwk91kNGw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":302904},"jest":{"preset":"ts-jest","testMatch":["**/__tests__/**/*.test.ts"],"testEnvironment":"node","collectCoverageFrom":["src/**/*.ts","!src/**/*.d.ts"]},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"eb52d011145274be097137c79af5601f7e77cc00","scripts":{"dev":"tsc --watch","test":"jest","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agentpayy","email":"lawrence@siestamarkets.com"},"repository":{"url":"git+https://github.com/AgentPayy/AgentPayy.git","type":"git","directory":"sdk/typescript"},"_npmVersion":"10.9.2","description":"AgentPayyKit TypeScript SDK","directories":{},"_nodeVersion":"18.20.8","dependencies":{"viem":"^2.21.0","axios":"^1.6.0","wagmi":"^2.12.0","ethers":"^6.8.0","@zerodev/sdk":"^5.0.0","permissionless":"^0.2.0","@alchemy/aa-core":"^3.0.0","@biconomy/account":"^4.0.0","@zerodev/ecdsa-validator":"^5.0.0","@walletconnect/universal-provider":"^2.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","ts-jest":"^29.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.1_1749926313608_0.11324396981776119","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agentpayy/sdk","version":"1.0.2","description":"AgentPayyKit TypeScript SDK","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch","test":"jest","prepublishOnly":"npm run build"},"keywords":["ai","agents","payments","ethereum","web3","wallet"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/AgentPayy/AgentPayy.git","directory":"sdk/typescript"},"homepage":"https://github.com/AgentPayy/AgentPayy#readme","publishConfig":{"access":"public"},"dependencies":{"ethers":"^6.8.0","axios":"^1.6.0","viem":"^2.21.0","wagmi":"^2.12.0","permissionless":"^0.2.0","@biconomy/account":"^4.0.0","@zerodev/sdk":"^5.0.0","@zerodev/ecdsa-validator":"^5.0.0","@alchemy/aa-core":"^3.0.0","@walletconnect/universal-provider":"^2.11.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0","jest":"^29.0.0","@types/jest":"^29.0.0","ts-jest":"^29.0.0"},"jest":{"preset":"ts-jest","testEnvironment":"node","testMatch":["**/__tests__/**/*.test.ts"],"collectCoverageFrom":["src/**/*.ts","!src/**/*.d.ts"]},"_id":"@agentpayy/sdk@1.0.2","gitHead":"5a023b0448ae1d79bd276743de47f9289a53ee9d","bugs":{"url":"https://github.com/AgentPayy/AgentPayy/issues"},"_nodeVersion":"18.20.8","_npmVersion":"10.9.2","dist":{"integrity":"sha512-kkO2QQzq6uETj81Mw+QV7x2QfBPKsxrA9p2Hd9FBjbxMGyatJUTMrTM/extV8cvWXLf/BwAVkRNuqyYZ/kU26w==","shasum":"871fcd76c395aaaf7790e95ec10d670d9faa1e35","tarball":"https://registry.npmjs.org/@agentpayy/sdk/-/sdk-1.0.2.tgz","fileCount":70,"unpackedSize":302982,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDQGpkBXICeQ6MseQRJHoDioASjn83G6xee/qbWin38UAiBpWyS83vURD8FXS3XiVPfRMOWW67EOppzR3l2wwJVXpA=="}]},"_npmUser":{"name":"agentpayy","email":"lawrence@siestamarkets.com"},"directories":{},"maintainers":[{"name":"agentpayy","email":"lawrence@siestamarkets.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.0.2_1749927726704_0.3087576075291043"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-14T18:38:33.541Z","modified":"2025-06-14T19:02:07.123Z","1.0.1":"2025-06-14T18:38:33.813Z","1.0.2":"2025-06-14T19:02:06.926Z"},"bugs":{"url":"https://github.com/AgentPayy/AgentPayy/issues"},"license":"MIT","homepage":"https://github.com/AgentPayy/AgentPayy#readme","keywords":["ai","agents","payments","ethereum","web3","wallet"],"repository":{"type":"git","url":"git+https://github.com/AgentPayy/AgentPayy.git","directory":"sdk/typescript"},"description":"AgentPayyKit TypeScript SDK","maintainers":[{"name":"agentpayy","email":"lawrence@siestamarkets.com"}],"readme":"<div align=\"center\">\n  <img src=\"../../AgentPayy-Logo-agent-native-open-framework-for-ai-and-api-payments.png\" alt=\"AgentPayy Logo\" width=\"120\"/>\n</div>\n\n# AgentPayy TypeScript SDK\n\n**Single package with all features included**. Connect to the AgentPayy payment network with zero setup.\n\n## Install\n```bash\nnpm install @agentpayy/sdk\n```\n\n## Basic Usage\n```typescript\nimport { AgentPayyKit } from '@agentpayy/sdk';\n\nconst agentPay = new AgentPayyKit({\n  network: 'base', // Connects to deployed AgentPayy contracts\n  privateKey: process.env.PRIVATE_KEY\n});\n\n// Pay for API call\nconst result = await agentPay.callAPI(\n  'https://api.example.com',\n  { input: 'data' },\n  'model-id'\n);\n```\n\n## All Features Included\n\n### Core Payment System\n```typescript\n// Basic API payment\nconst result = await agentPay.callAPI(endpoint, data, modelId);\n\n// Payment validation (for API providers)\nconst isValid = await agentPay.validatePayment(txHash, inputData);\nawait agentPay.markValidated(txHash);\n```\n\n### Advanced Features\n```typescript\n// Import specialized modules\nimport { \n  AgentPayyKit,\n  ReputationModule,\n  AttributionModule,\n  AgentPayyWall,\n  APIRegistry \n} from '@agentpayy/sdk';\n\n// Attribution payments (revenue sharing)\nconst attributions = [\n  { recipient: '0xAgent1', basisPoints: 6000 },  // 60%\n  { recipient: '0xAgent2', basisPoints: 4000 }   // 40%\n];\n\nconst result = await agentPay.payWithAttribution(\n  'complex-analysis',\n  { data: 'input' },\n  attributions,\n  { price: '0.10' }\n);\n\n// Balance management\nawait agentPay.depositBalance('10.0'); // Deposit $10 USDC\nconst balance = await agentPay.getUserBalance();\nawait agentPay.withdrawBalance('5.0'); // Withdraw specific amount\nawait agentPay.withdraw(); // Withdraw all earnings\n\n// Reputation system\nconst reputation = new ReputationModule(gatewayUrl);\nconst agentRep = await reputation.getReputation(agentAddress);\nconst specialists = await reputation.findAgentsBySpecialty('weather-data', 4.0);\n\n// API marketplace\nconst registry = new APIRegistry(gatewayUrl);\nawait registry.registerModel({\n  modelId: 'weather-api-v1',\n  endpoint: 'https://api.myservice.com/weather',\n  price: '0.02',\n  category: 'Weather & Environment'\n});\n\nconst weatherAPIs = await registry.getAPIsByCategory('Weather & Environment');\n```\n\n## API Provider Integration\n```typescript\n// Validate payments in your API\nconst isValid = await agentPay.validatePayment(txHash, inputData);\n\n// Mark payment as processed\nawait agentPay.markValidated(txHash);\n\n// Register your API for monetization\nawait agentPay.registerModel({\n  modelId: 'my-api',\n  endpoint: 'https://api.myservice.com',\n  price: '0.05'\n});\n```\n\n## API Discovery & Marketplace\n```typescript\n// Register API with full metadata\nawait agentPay.registerModel({\n  modelId: 'weather-forecast-v2',\n  endpoint: 'https://api.weather.com/forecast',\n  price: '0.03',\n  category: 'Weather & Environment',\n  tags: ['weather', 'forecast', 'climate'],\n  description: 'Advanced weather forecasting API'\n});\n\n// Discover APIs by category\nconst weatherAPIs = await agentPay.getAPIsByCategory('Weather & Environment');\n\n// Search APIs by tags\nconst aiAPIs = await agentPay.searchAPIsByTag('ai');\n\n// Get marketplace statistics\nconst stats = await agentPay.getMarketplaceStats();\nconsole.log(`${stats.totalAPIs} APIs, ${stats.totalDevelopers} developers`);\n\n// Get trending APIs\nconst trending = await agentPay.getTrendingAPIs(10);\n```\n\n## Available Networks\n- **base**: Base mainnet (recommended)\n- **arbitrum**: Arbitrum One\n- **optimism**: Optimism mainnet\n- **polygon**: Polygon mainnet\n\n## Key Features\n- **Single Package**: All features included, no separate installs\n- **Zero Setup**: Uses deployed AgentPayy contracts (no deployment needed)\n- **Privacy-First**: Only payment hashes stored on-chain\n- **Sub-Cent Costs**: Enable $0.001-$0.01 API calls economically\n- **Multi-Chain**: Works across Base, Arbitrum, Optimism L2s\n- **Complete Toolkit**: Core payments + attribution + reputation + marketplace\n- **Framework Ready**: Works with Express, FastAPI, CrewAI, and more\n\n## Package Contents\n- **AgentPayyKit**: Main payment class\n- **ReputationModule**: Agent discovery and scoring\n- **AttributionModule**: Multi-party revenue sharing  \n- **AgentPayyWall**: Express.js middleware for API monetization\n- **APIRegistry**: On-chain API marketplace\n- **Wallet Adapters**: MetaMask, Coinbase, WalletConnect, Smart Accounts\n- **Core Utilities**: Crypto functions, contract interfaces, type definitions ","readmeFilename":"README.md"}