{"_id":"@apexfusion/agent-sdk","_rev":"2-f0e92e86d63087c3d52eb4cdf034cbc0","name":"@apexfusion/agent-sdk","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@apexfusion/agent-sdk","version":"0.1.0","keywords":["vector","blockchain","cardano","apex-fusion","ai-agent","utxo","sdk"],"author":{"name":"Apex Fusion"},"license":"MIT","_id":"@apexfusion/agent-sdk@0.1.0","maintainers":[{"name":"apexfusion","email":"security@hal8.io"}],"homepage":"https://github.com/Apex-Fusion/vector-agent-sdk-ts#readme","bugs":{"url":"https://github.com/Apex-Fusion/vector-agent-sdk-ts/issues"},"dist":{"shasum":"6b5f815d5c39407734adc7574b38db6352e0970f","tarball":"https://registry.npmjs.org/@apexfusion/agent-sdk/-/agent-sdk-0.1.0.tgz","fileCount":8,"integrity":"sha512-Y0vBagvrfBseV/s8Y93qKremloG2o/nUmjAN7bM0BoJDyv6m8JqwHTqG829FaPj42CreMUZTk5TPT7XOt6LwBw==","signatures":[{"sig":"MEQCIHtjEvmPq8dlSeWZzqFzDF2ROUJDIzrsW5t3JWZ/pB6KAiAluWUzfZ6mC1cNUjAbXj30POTQBXzxr1bGQxJ4G0LwQw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":365077},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"4cb6eae09f71ae7eb696e69e99443c878abd5217","scripts":{"test":"vitest run","build":"tsup","clean":"rm -rf dist","typecheck":"tsc --noEmit","test:watch":"vitest","postinstall":"ln -sf ../../../libsodium-sumo/dist/modules-sumo-esm/libsodium-sumo.mjs node_modules/libsodium-wrappers-sumo/dist/modules-sumo-esm/libsodium-sumo.mjs 2>/dev/null || true","prepublishOnly":"npm run build","test:integration":"vitest run --config vitest.integration.config.ts"},"_npmUser":{"name":"apexfusion","email":"security@hal8.io"},"repository":{"url":"git+https://github.com/Apex-Fusion/vector-agent-sdk-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"TypeScript Agent SDK for Vector blockchain (Apex Fusion L2)","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.24.1","cross-fetch":"^4.0.0","@noble/hashes":"^1.7.1","@lucid-evolution/lucid":"^0.4.29"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^3.0.0","typescript":"^5.7.3","@types/node":"^22.13.1"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.1.0_1773998588216_0.9963859415446876","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@apexfusion/agent-sdk","version":"0.1.1","description":"TypeScript Agent SDK for Vector blockchain (Apex Fusion L2)","type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"postinstall":"ln -sf ../../../libsodium-sumo/dist/modules-sumo-esm/libsodium-sumo.mjs node_modules/libsodium-wrappers-sumo/dist/modules-sumo-esm/libsodium-sumo.mjs 2>/dev/null || true","build":"tsup","typecheck":"tsc --noEmit","test":"vitest run","test:integration":"vitest run --config vitest.integration.config.ts","test:watch":"vitest","clean":"rm -rf dist","prepublishOnly":"npm run build"},"keywords":["vector","blockchain","cardano","apex-fusion","ai-agent","utxo","sdk"],"author":{"name":"Apex Fusion"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Apex-Fusion/agent-sdk-ts.git"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"dependencies":{"@lucid-evolution/lucid":"^0.4.29","@noble/hashes":"^1.7.1","cross-fetch":"^4.0.0","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.13.1","tsup":"^8.5.1","typescript":"^5.7.3","vitest":"^3.0.0"},"_id":"@apexfusion/agent-sdk@0.1.1","gitHead":"82ee65f342803409403357ff678682732ae0db3f","bugs":{"url":"https://github.com/Apex-Fusion/agent-sdk-ts/issues"},"homepage":"https://github.com/Apex-Fusion/agent-sdk-ts#readme","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-GKVwBRpndgOJfRtEbmMZSueJMF02EQs9dw9uxFkWfPrhqDQaJeihhiKv9TQvds3QiM55gdy1E37LlOURC5zwDg==","shasum":"292be8c99e6e25e2a3cb65cd1242b38e3592fff4","tarball":"https://registry.npmjs.org/@apexfusion/agent-sdk/-/agent-sdk-0.1.1.tgz","fileCount":8,"unpackedSize":365070,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCF+r0E6miqpS56sXc+5UXAHD1WQHSNUbHig+LtnF2YOgIgbXPpGWgGs+yqIMMvmFOB7cxxUhIzuax6HsMv6ap86eo="}]},"_npmUser":{"name":"apexfusion","email":"security@hal8.io"},"directories":{},"maintainers":[{"name":"apexfusion","email":"security@hal8.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-sdk_0.1.1_1774004254176_0.3695601195415643"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T09:23:08.155Z","modified":"2026-03-20T10:57:34.444Z","0.1.0":"2026-03-20T09:23:08.401Z","0.1.1":"2026-03-20T10:57:34.337Z"},"bugs":{"url":"https://github.com/Apex-Fusion/agent-sdk-ts/issues"},"author":{"name":"Apex Fusion"},"license":"MIT","homepage":"https://github.com/Apex-Fusion/agent-sdk-ts#readme","keywords":["vector","blockchain","cardano","apex-fusion","ai-agent","utxo","sdk"],"repository":{"type":"git","url":"git+https://github.com/Apex-Fusion/agent-sdk-ts.git"},"description":"TypeScript Agent SDK for Vector blockchain (Apex Fusion L2)","maintainers":[{"name":"apexfusion","email":"security@hal8.io"}],"readme":"# @apexfusion/agent-sdk\n\nTypeScript Agent SDK for the Vector blockchain (Apex Fusion L2). Built on Lucid Evolution + Ogmios.\n\n## Quick Start\n\n```typescript\nimport { VectorAgent } from '@apexfusion/agent-sdk';\n\nconst agent = new VectorAgent({\n  mnemonic: 'your fifteen word mnemonic phrase here ...',\n});\n\nconst address = await agent.getAddress();\nconst balance = await agent.getBalance();\nconst tx = await agent.send({ to: 'addr1...', ada: 5 });\n\nawait agent.close();\n```\n\n## Installation\n\n```bash\nnpm install @apexfusion/agent-sdk\n```\n\n## Features\n\n- **Wallet management** — HD wallets (BIP39 mnemonic) and cardano-cli signing keys\n- **Balance & UTxO queries** — ADA and native token balances\n- **Transactions** — send ADA, send tokens, multi-output, dry-run\n- **Smart contracts** — deploy and interact with Plutus/Aiken contracts\n- **Agent registry** — on-chain agent registration, discovery, messaging\n- **Safety controls** — per-transaction and daily spend limits, audit logging\n- **Rate limiting** — sliding window rate limiter\n\n## Configuration\n\nConfiguration is resolved from constructor params, then environment variables, then defaults:\n\n```typescript\nconst agent = new VectorAgent({\n  ogmiosUrl: 'https://ogmios.vector.testnet.apexfusion.org',\n  submitUrl: 'https://submit.vector.testnet.apexfusion.org/api/submit/tx',\n  koiosUrl: 'https://koios.vector.testnet.apexfusion.org/',\n  explorerUrl: 'https://vector.testnet.apexscan.org',\n  mnemonic: process.env.VECTOR_MNEMONIC,\n  accountIndex: 0,\n  spendLimitPerTx: 100_000_000,  // 100 ADA\n  spendLimitDaily: 500_000_000,  // 500 ADA\n});\n```\n\nEnvironment variables: `VECTOR_OGMIOS_URL`, `VECTOR_SUBMIT_URL`, `VECTOR_KOIOS_URL`, `VECTOR_EXPLORER_URL`, `VECTOR_MNEMONIC`, `VECTOR_SKEY_PATH`, `VECTOR_ACCOUNT_INDEX`, `VECTOR_SPEND_LIMIT_PER_TX`, `VECTOR_SPEND_LIMIT_DAILY`.\n\n## API\n\n### Queries\n\n```typescript\nawait agent.getAddress()\nawait agent.getBalance(address?)\nawait agent.getUtxos(address?)\nawait agent.getProtocolParameters()\nawait agent.getSpendLimits()\n```\n\n### Transactions\n\n```typescript\nawait agent.send({ to, lovelace?, ada?, metadata? })\nawait agent.sendTokens({ to, policyId, assetName, quantity, ada? })\nawait agent.dryRun({ to, lovelace?, ada? })\nawait agent.buildTransaction({ outputs, metadata?, submit? })\nawait agent.getTransactionHistory({ address?, limit?, offset? })\n```\n\n### Smart Contracts\n\n```typescript\nawait agent.deployContract({ scriptCbor, scriptType?, initialDatum?, lovelace? })\nawait agent.interactContract({ scriptCbor, scriptType?, action?, redeemer?, datum?, lovelace?, utxoRef? })\n```\n\n### Agent Registry\n\n```typescript\nawait agent.registerAgent({ name, description, capabilities, framework, endpoint })\nawait agent.discoverAgents({ capability?, framework?, limit? })\nawait agent.getAgentProfile(agentId)\nawait agent.updateAgent(agentId, { name?, description?, capabilities?, framework?, endpoint? })\nawait agent.deregisterAgent(agentId)\nawait agent.transferAgent(agentId, newOwnerAddress)\nawait agent.messageAgent(agentId, { type, payload })\n```\n\n## Advanced Usage\n\nSub-modules are exported for direct access:\n\n```typescript\nimport { OgmiosProvider, SafetyLayer, HDWallet, SkeyWallet, AgentRegistry } from '@apexfusion/agent-sdk';\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}