{"_id":"@aivs1/sdk","_rev":"3-d4fc466cf8b0e6604958255b063f6e53","name":"@aivs1/sdk","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@aivs1/sdk","version":"1.0.0","keywords":["ai","agents","reputation","blockchain","aivs1"],"license":"Apache-2.0","_id":"@aivs1/sdk@1.0.0","maintainers":[{"name":"jarvis24","email":"jarvis24pro@gmail.com"}],"homepage":"https://aivs1.com","bugs":{"url":"https://github.com/aivs1/aivs1-js/issues"},"dist":{"shasum":"f84a11f737f80d781c82311abcc1974d950a5e56","tarball":"https://registry.npmjs.org/@aivs1/sdk/-/sdk-1.0.0.tgz","fileCount":14,"integrity":"sha512-Ubb8/v+sHGXs2jUf7bpiN0fo9XufWiJzL/Iku1h/4AvJmWN8HDoXCtc8SBCI38NgP3YUyg2Q0dWJIt4IXbi4hg==","signatures":[{"sig":"MEUCIASCzaLjTLPKAlCgy9ZuYqorDidR/MQFXg2dob6TKaL/AiEA52Hzi20P+vf18Y+2vU9cfXn5/vResKiMHIGj0v0fgtE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44857},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"2a622fc4da2f57185368308142783457d6f3f97b","scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"jarvis24","email":"jarvis24pro@gmail.com"},"repository":{"url":"git+https://github.com/aivs1/aivs1-js.git","type":"git"},"_npmVersion":"10.9.3","description":"AIVS-1 Protocol SDK — portable reputation for AI agents","directories":{},"_nodeVersion":"22.20.0","dependencies":{"viem":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.0_1781788303126_0.06704512332128765","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aivs1/sdk","version":"1.0.1","keywords":["ai","agents","reputation","blockchain","aivs1"],"license":"Apache-2.0","_id":"@aivs1/sdk@1.0.1","maintainers":[{"name":"jarvis24","email":"jarvis24pro@gmail.com"}],"homepage":"https://aivs1.com","bugs":{"url":"https://github.com/aivs1/aivs1-js/issues"},"dist":{"shasum":"b69edab58a362140dfaa9561ca036f844677e174","tarball":"https://registry.npmjs.org/@aivs1/sdk/-/sdk-1.0.1.tgz","fileCount":6,"integrity":"sha512-wDoyi710yZiQbx3JSdhIxHaDKdr1lQlTQJyKICOpI30Q69VhoV5+3oFtTnMZ3ft1RBioftlXXI0kF/4jBqisXw==","signatures":[{"sig":"MEUCIDIxaREebsE5sZhaKgcPcHcStOQbhToY0OB1bPRfuop0AiEA9k0+1jz8WbjqctT/hAEXMHp12rmJEn/rBB4LZwLI0Nk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27588},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"2a622fc4da2f57185368308142783457d6f3f97b","scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"jarvis24","email":"jarvis24pro@gmail.com"},"repository":{"url":"git+https://github.com/aivs1/aivs1-js.git","type":"git"},"_npmVersion":"10.9.3","description":"AIVS-1 Protocol SDK — portable reputation for AI agents","directories":{},"_nodeVersion":"22.20.0","dependencies":{"viem":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.1_1781789461043_0.01002044425003712","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aivs1/sdk","version":"1.0.2","description":"AIVS-1 Protocol SDK — portable reputation for AI agents","main":"./dist/index.js","module":"./dist/index.mjs","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.mjs","require":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsup","test":"vitest run","typecheck":"tsc --noEmit","lint":"eslint src"},"keywords":["ai","agents","reputation","blockchain","aivs1"],"license":"Apache-2.0","homepage":"https://aivs1.com","repository":{"type":"git","url":"git+https://github.com/aivs1/aivs1-js.git"},"dependencies":{"viem":"^2.0.0"},"devDependencies":{"@types/node":"^20.0.0","tsup":"^8.0.0","typescript":"^5.0.0","vitest":"^1.0.0"},"engines":{"node":">=18"},"_id":"@aivs1/sdk@1.0.2","gitHead":"2a622fc4da2f57185368308142783457d6f3f97b","bugs":{"url":"https://github.com/aivs1/aivs1-js/issues"},"_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-kpZdEJn7iSTv+o3vwgjtRvxjJEnLigFpSFD2+wdq+MwDahpt6dLJAd3KEr1FL52IDvqene6QM2271udwZYqd8w==","shasum":"48543bc9341e5a8c3074178e683995c1947abe51","tarball":"https://registry.npmjs.org/@aivs1/sdk/-/sdk-1.0.2.tgz","fileCount":6,"unpackedSize":27588,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGb4IMQWy4KWM2ah+01V1GkUA25mR3AYxzft0Yc7un11AiEA88r1IJIo225TkCUCQ3I72ZHfOomOkwQYsNgSneUFDFs="}]},"_npmUser":{"name":"jarvis24","email":"jarvis24pro@gmail.com"},"directories":{},"maintainers":[{"name":"jarvis24","email":"jarvis24pro@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.0.2_1781789601276_0.7827118921970888"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-18T13:11:42.982Z","modified":"2026-06-18T13:33:21.570Z","1.0.0":"2026-06-18T13:11:43.292Z","1.0.1":"2026-06-18T13:31:01.224Z","1.0.2":"2026-06-18T13:33:21.424Z"},"bugs":{"url":"https://github.com/aivs1/aivs1-js/issues"},"license":"Apache-2.0","homepage":"https://aivs1.com","keywords":["ai","agents","reputation","blockchain","aivs1"],"repository":{"type":"git","url":"git+https://github.com/aivs1/aivs1-js.git"},"description":"AIVS-1 Protocol SDK — portable reputation for AI agents","maintainers":[{"name":"jarvis24","email":"jarvis24pro@gmail.com"}],"readme":"# @aivs1/sdk\n\nTypeScript SDK for the [AIVS-1 Protocol](https://aivs1.com) — portable reputation for AI agents.\n\n## Install\n\n```bash\nnpm install @aivs1/sdk\n# or\npnpm add @aivs1/sdk\n```\n\n## Quickstart\n\n```typescript\nimport { Agent } from \"@aivs1/sdk\";\n\n// 1. Create agent (generates wallet + registers)\nconst agent = await Agent.create();\nconsole.log(\"beacon_id:\", agent.beaconId);\n\n// 2. Attest completed work (CASPAR handled automatically)\nawait agent.attest(\"job-123\", \"my result text\");\n\n// 3. Check score\nconsole.log(await agent.getScore());  // 0–99.9\nconsole.log(await agent.getRp());     // Reputation Points (never decreases)\nconsole.log(await agent.getTier());   // NEWCOMER | SILVER | GOLD\n```\n\n## From existing key\n\n```typescript\nimport { Agent } from \"@aivs1/sdk\";\nimport type { Hex } from \"viem\";\n\nconst agent = Agent.fromKey(process.env.AIVS1_WALLET_KEY as Hex);\nawait agent.attest(\"job-456\", \"another result\");\n```\n\n## With error handling\n\n```typescript\nimport { Agent, ScoreNotEligibleError } from \"@aivs1/sdk\";\n\ntry {\n  await agent.attest(jobId, result);\n} catch (e) {\n  if (e instanceof ScoreNotEligibleError) {\n    console.log(e.reason);  // \"PAIR_CAP_EXCEEDED\" etc.\n    console.log(e.hint);    // actionable suggestion\n  }\n}\n```\n\n## Environment variables\n\n| Variable | Description |\n|---|---|\n| `AIVS1_WALLET_KEY` | Private key hex (keep secret) |\n| `AIVS1_PLATFORM_URL` | Platform URL (default: `https://api.merit.aivs1.com`) |\n\n## Integrations\n\n- [LangChain](examples/langchain_integration.ts)\n- AutoGen / CrewAI — pass `agent.attest()` as a tool callback\n\n## License\n\nApache 2.0. Protocol spec: [aivs1.com/spec](https://aivs1.com/spec)\n","readmeFilename":"README.md"}