{"_id":"@candledottv/agent-sdk","_rev":"9-93a057c4bd119ef07fe3a910d310afbc","name":"@candledottv/agent-sdk","dist-tags":{"latest":"0.4.3"},"versions":{"0.1.0":{"name":"@candledottv/agent-sdk","version":"0.1.0","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.1.0","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/agent-sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"bdb4a62e7b3ec9b9c8615e757e9d32e983d4e1a3","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.1.0.tgz","fileCount":24,"integrity":"sha512-1eq9hy0CrGT1DfES73HXQMzREMwOR54xL10GDn6pGA9yfBiM3hoWMQk8Tfps1VV2XbdY0/T5/tj1Z7z6kT8YLA==","signatures":[{"sig":"MEYCIQCubBsxNHYuxO0jCt/bM1yiky7R1aJ10+OpkEqXxqFl7QIhALqOOG9bwYgoBo5JCcLYqeNlzS2S4UQpf0S/7Mf3bot7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":170630},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"a6386742e8b2eb261c9b36eea6a516740db0333a","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.1.0_1787535600652_0.46296577463092414","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@candledottv/agent-sdk","version":"0.2.0","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.2.0","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/agent-sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"f1aa0e2a3733a35a6cc68ff817bff43f029cab2a","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.2.0.tgz","fileCount":26,"integrity":"sha512-qCg5jPoAwaOc/AC1WcArv/lK2g55jUfG0DLBB9bti0rDLlSz2C7fPH+lP9ZqaizPkgQAoBUnlmm+c/0SV3/3Yg==","signatures":[{"sig":"MEYCIQD07amfa/ZUZrq7Bz7lQb5aSfpMa7+BUCiaMVtSQUm8RwIhAJ4cZfaVQVNryaOYp20bTOlQQq9eVuBAudeHCO5UT71y","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":181749},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"534487d05996e86d601f6016f06082fea5021ae4","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.2.0_1787864399883_0.9882158462142259","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@candledottv/agent-sdk","version":"0.3.0","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.3.0","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"017ab806e0e04dfa86ca68d10ad9b7cf3eda1cd7","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.3.0.tgz","fileCount":28,"integrity":"sha512-ZsK4Wk2GKVDtROb+w0wZV+Q+aIh//5CbXBYkdlzjWr0ium0GY5aQJtLK5eWcMbEvbvzBTHiBlTijzZa+Ga27kg==","signatures":[{"sig":"MEUCIC1Bppiuqyk+sa8V0XgT2ZpgqIMgnZaAfkjvEOwmOfupAiEAt7SJOcNF2jU2hs50zxxiRuWqvZ3nek+5aFcnyYNs5mE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":187552},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"8b94b1078374e662ccf54e9c544855174794fea3","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.3.0_1788115563884_0.37184570191581234","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@candledottv/agent-sdk","version":"0.3.1","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.3.1","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"183018edfcfa6bb1bada296fa44371b54d40e902","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.3.1.tgz","fileCount":28,"integrity":"sha512-4UEz6oPs8EBdoJJZ2lxMzzoDsoJDdZVqDkthjaMaSF3q8N1icb7WfX/fpMkC2wi4ivwzHFpxqfapMvA70scBQA==","signatures":[{"sig":"MEQCIErtqjcxAMKJbAzsT3XVgnf+dWSXHW0VUit4bIMsXh7sAiBY/xXmbVceeIk7kZsCpVH6o0OX3C/BVRA5phcXoy0pZg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":188795},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"4c70bf3e342e9c11fb5eaa9c05a322650f6d78a5","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.3.1_1788294777176_0.681110313063306","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@candledottv/agent-sdk","version":"0.3.2","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.3.2","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"76ee2d2c1f13044e6719571dd5e0c0dcef839fd1","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.3.2.tgz","fileCount":28,"integrity":"sha512-PFBqgqwcjM43kReIV3GFm3OqSbsv7BFpdpNZApoWXMo2QBYD1dpkWhvM5Rz5aBhdFw63fGLMQEJMhXN9EKN3tw==","signatures":[{"sig":"MEYCIQCm2eoRmAL0e6cZ1WRZWnFyreh5KM+AIv8x2olXlUu89QIhAKwH7Ac3IDDZrUyknbfhHaldXkzkD2AeBLthwOH2PXSZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":189983},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"8019923d70b63cafefb22cda01ca594400882e54","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.3.2_1788301505476_0.3731462118738289","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@candledottv/agent-sdk","version":"0.4.0","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.4.0","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"85d3f2b60f18a42ffd8798afa2520ed5616049b7","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.4.0.tgz","fileCount":28,"integrity":"sha512-nZsG8bUWVqCh1UekPusz5sc4blj6JOyMhb7gST8RBnZlqguZVCPGm6k6devYWYTqUC8D88NTPZpesSL75HRB0A==","signatures":[{"sig":"MEYCIQDP0htZR31M1rCsnV1vWdXiHfHilAZK5eUFY0cU3N31OgIhALczvH1kKMeZLv51HbOhvXIS/Kq3Z3Sgjxai8VshM/my","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":206241},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"01c7b28079c06a0bdadf32ecc04aebc677b4ad75","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.4.0_1788967123333_0.6493916044219383","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@candledottv/agent-sdk","version":"0.4.1","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.4.1","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"85d404adba8a164b6a513bd7c977020f60020dbc","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.4.1.tgz","fileCount":28,"integrity":"sha512-MCZPpUPJNshjjCwwlTBGfbcYmusRiV9ZfyZhnKl+CqY9ivg0YRWlZzjCGJMdDTLm5UYyHyDKA42T8QSWj/PA6g==","signatures":[{"sig":"MEYCIQDrmV2gdnkiFAgeCJnkNn/vkGG35efTAv9GZcudzT1XMQIhAPrCnnLdfq6dl2+83P7sizsPAT84cV+T9LCPFT1TEwFa","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":206773},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"cedefac93d08586eb240d73861eaf54841c7beb3","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.4.1_1789067589441_0.22231236698624945","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@candledottv/agent-sdk","version":"0.4.2","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"license":"MIT","_id":"@candledottv/agent-sdk@0.4.2","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"homepage":"https://docs.candle.tv/developers/sdk","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"e48e591fcbc47374c70b65ee00cf184de281ef7e","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.4.2.tgz","fileCount":28,"integrity":"sha512-4xFYNjnWYDwIw26/aw2r9Z/HH5oUjo0/CgClN+TNq+gerig3fvnUroD3yx0zOBNl42CH/R0/njdmKdNNpIpfHQ==","signatures":[{"sig":"MEUCIHLghKP3fXBxY/pLTXoPwX+CdhJQOHfJIpamMeY/OtlhAiEAxw5DfiHkCuKRePOBvG8tQBaYc2Xgi8QdHNWdxbGCFis=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCICN59KkgubRcYZHLu/YhT7qeo/+VhneqzHE+kbdnT8MoAiAvMLUT5YZJESEVX9thphaln0e1euPImYpdBbOlxIAB+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":227900},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"9f06a0281b5ab2dc8197e3a43cb30e009e329f17","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.8","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"_nodeVersion":"22.23.2","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_0.4.2_1790645957338_0.31472756770577526","host":"s3://npm-registry-packages-npm-production"}},"0.4.3":{"_id":"@candledottv/agent-sdk@0.4.3","bugs":{"url":"https://github.com/candledottv/agentic/issues"},"dist":{"shasum":"d19d6fe825e20598c9de0a65013db68a66662c50","tarball":"https://registry.npmjs.org/@candledottv/agent-sdk/-/agent-sdk-0.4.3.tgz","fileCount":28,"integrity":"sha512-/6hjq50pv47jfp78zdUZCiEywaUhBii+YBDBna7Vuy5x30Aks/KxPiEOd+M9Rl9ABlWqFrxYIj+PsYtPyEc2RQ==","signatures":[{"sig":"MEQCIGoJcmbkvRPVMDqN38XQvoa2pKgtb52/29a9J/RsYG+MAiAK/+IQSr0EZ2yprq08wo+zGkv5uOeYOJpCD+Lj/eeDhg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIADAbqtjke7Zb4jC9SXtsT4lj92oEFA7DnJd8Xd7bOo4AiB0jwWkh+Ab1iVUQSmVcWAhsojgfaI4Q8SyegQJrEPVSg=="}],"unpackedSize":230552},"main":"./dist/index.js","name":"@candledottv/agent-sdk","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"dd85c4af272551a2f2ff0b2422c0fddf2f2fa1c8","license":"MIT","scripts":{"lint":"biome check .","test":"bun test","build":"bun run build:js && bun run build:types","clean":"rm -rf dist","build:js":"bun build src/index.ts --target=node --format=esm --packages=external --outfile=dist/index.js","typecheck":"tsc --noEmit","build:types":"tsc -p tsconfig.build.json"},"version":"0.4.3","_npmUser":{"name":"candletv","email":"andrew@candle.tv"},"homepage":"https://docs.candle.tv/developers/sdk","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"_npmVersion":"10.9.9","description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","directories":{},"maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"_nodeVersion":"22.23.3","dependencies":{"@hpke/core":"^1.7.2","@scure/base":"^1.2.6","canonicalize":"^2.1.0","@hpke/chacha20poly1305":"^1.6.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.1.14","typescript":"^5.7.2","@privy-io/server-auth":"^1.32.5"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-sdk_0.4.3_1790789657326_0.9588673788245354"}}},"time":{"created":"2026-08-24T01:40:00.504Z","modified":"2026-09-30T17:34:17.651Z","0.1.0":"2026-08-24T01:40:00.785Z","0.2.0":"2026-08-27T21:00:00.036Z","0.3.0":"2026-08-30T18:46:04.015Z","0.3.1":"2026-09-01T20:32:57.331Z","0.3.2":"2026-09-01T22:25:05.651Z","0.4.0":"2026-09-09T15:18:43.470Z","0.4.1":"2026-09-10T19:13:09.575Z","0.4.2":"2026-09-29T01:39:17.426Z","0.4.3":"2026-09-30T17:34:17.464Z"},"bugs":{"url":"https://github.com/candledottv/agentic/issues"},"license":"MIT","homepage":"https://docs.candle.tv/developers/sdk","keywords":["candle","solana","agent","sdk","token-launch","ai-agent"],"repository":{"url":"git+https://github.com/candledottv/agentic.git","type":"git","directory":"packages/sdk"},"description":"TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification","maintainers":[{"name":"candletv","email":"andrew@candle.tv"}],"readme":"# @candledottv/agent-sdk\n\nA typed TypeScript SDK for the Candle agent rail. It wraps the REST surface documented in\n`docs/headless-launch.md` (headless launches, jobs, dry runs, market state, quotes, feeds,\nverification, presets, agent profiles, image uploads), ships the webhook signature verifier,\nand drives the client-side HPKE seal behind linked-wallet import, so an agent integrates\nagainst typed methods instead of hand-rolled HTTP.\n\nBuilt on the global `fetch`; runs on Bun and Node 18+. Three runtime dependencies --\n`@hpke/core`, `@hpke/chacha20poly1305`, and `@scure/base` -- exist solely to power\n`importWallet()`'s client-side HPKE seal and base58 decode (see \"Importing a wallet\" below);\nnothing else in the SDK needs them. The one `node:` builtin used is `node:crypto` (webhook\nverification only), which Bun also provides. Edge runtimes without `node:crypto` would need a\nWeb Crypto port of the verifier; that is a deliberate later concern.\n\n> **Not yet published to npm.** Publishing `@candledottv/agent-sdk` (and `@candledottv/mcp`)\n> is the post-Phase-2 follow-up. Until then, consume it as a workspace package:\n> `import { CandleClient } from \"@candledottv/agent-sdk\"`.\n\n## Quick start\n\n```ts\nimport { CandleClient } from \"@candledottv/agent-sdk\"\n\nconst candle = new CandleClient({\n  apiUrl: \"https://api.alpha.candle.tv\",\n  apiKey: process.env.CANDLE_AGENT_API_KEY, // cndl_live_... / cndl_test_...\n})\n\n// Public reads need no key.\nconst market = await candle.getMarket(\"solana\", \"So11...mint\")\nconst quote = await candle.getQuote(\"solana\", \"So11...mint\", { side: \"buy\", amountIn: \"1000000000\" })\nconst feed = await candle.getFeed(\"new\", \"solana\")\nconst verdict = await candle.verify(\"hood\", \"0xToken\")\n\n// Presets: fetch once, expand locally into a launch body.\nconst presets = await candle.getPresets()\nconst request = candle.expandPreset(presets, \"solana-open-sol\", {\n  name: \"Trend Coin\",\n  symbol: \"TREND\",\n  imageUrl: \"https://example.com/logo.png\",\n})\n```\n\nThe API key is attached as `x-api-key` on every request when configured. The keyed methods\n(`launch`, `launchAsync`, `dryRunLaunch`, `getLaunchJob`, `reportActivity`, `uploadImage`)\nrefuse to fetch without one and throw a plain `Error` locally instead of a server 401.\n\n## Launching with built-in idempotent retries\n\n`launch()` fills in a `clientLaunchId` (`\"sdk-\" + crypto.randomUUID()`) when you omit one, and\nretries transient failures by re-sending the SAME id, which the server's idempotency ledger\nresolves safely (no double mint, ever). Retries cover network errors, non-envelope 5xx\nresponses, retryable 5xx envelopes, and the retryable in-flight 409; a non-retryable envelope\n(validation errors, an id reused with a different body, `LAUNCH_DISABLED`) is thrown\nimmediately. Backoff is 250ms doubling per attempt, jittered, capped at 8s, bounded by\n`maxRetries` (default 3).\n\n```ts\nimport { CandleApiError } from \"@candledottv/agent-sdk\"\n\ntry {\n  const result = await candle.launch({\n    name: \"Trend Coin\",\n    symbol: \"TREND\",\n    imageUrl: \"https://example.com/logo.png\",\n    chain: \"solana\",\n    buyAmount: 100_000_000, // lamports\n  })\n  console.log(\"minted\", result.mint, \"explorer:\", result.links.explorer)\n} catch (error) {\n  if (error instanceof CandleApiError) {\n    // Branch on code, never on message. error.status, error.retryable, error.field ride along.\n    console.error(\"launch failed:\", error.code)\n  } else {\n    throw error\n  }\n}\n```\n\nPrefer not to block? `launchAsync()` sends `async: true`, returns the 202 body, and\n`waitForLaunch()` polls the jobs endpoint until the attempt is terminal:\n\n```ts\nconst accepted = await candle.launchAsync({ name: \"Trend Coin\", symbol: \"TREND\", imageUrl: \"https://...\" })\nconst job = await candle.waitForLaunch(accepted.clientLaunchId, { timeoutMs: 180_000, pollMs: 2_000 })\nif (job.status === \"confirmed\") console.log(\"minted\", job.mint)\nelse console.error(\"failed:\", job.errorCode)\n```\n\nNeed a hosted image first? `uploadImage(bytes, contentType)` posts raw bytes to\n`/api/v1/uploads/agent-image` and returns `{ imageUrl }`, ready for the launch body.\n\n## Importing a wallet\n\n`importWallet()` drives Candle's ciphertext-only wallet import end to end: it fetches Privy's\nHPKE receiver public key (`/wallets/import/init`), seals the private key locally with\n`encryptWalletKeyForImport()` (RFC 9180 Base mode, `DHKEM(P-256, HKDF-SHA256)` /\n`HKDF-SHA256` / `ChaCha20-Poly1305`), and submits only the resulting ciphertext and\nencapsulated key (`/wallets/import/submit`). **The plaintext private key never leaves the\ncalling process, and Candle never receives, stores, or logs it at any point** -- the server is\na ciphertext-only proxy to Privy's HPKE endpoint.\n\n```ts\nimport { CandleClient, generateSignerKeypair } from \"@candledottv/agent-sdk\"\n\nconst candle = new CandleClient({\n  apiUrl: \"https://api.alpha.candle.tv\",\n  apiKey: process.env.CANDLE_AGENT_API_KEY,\n})\n\n// A fresh P-256 (ECDSA) signer keypair. Only the public half ever leaves this process.\nconst { privateKeyPem, publicKeyDerBase64 } = await generateSignerKeypair()\n// privateKeyPem is yours to store and sign with later; the SDK never transmits it anywhere.\n\nconst result = await candle.importWallet({\n  chain: \"solana\", // or \"evm\"\n  address: \"9xQe...wallet\",\n  privateKey: existingWalletPrivateKey, // base58 for \"solana\", hex (\"0x\"-optional) for \"evm\"\n  signerPublicKey: publicKeyDerBase64,\n  label: \"trading wallet\",\n})\nconsole.log(\"linked\", result.id, result.privyWalletId)\n```\n\n`generateSignerKeypair()` generates the signer Privy registers as the imported wallet's 1-of-1\nkey quorum; `importWallet()` is the only place in this SDK that ever holds the wallet's\nplaintext private key, and only for the duration of the local HPKE seal.\n\n## Verifying webhooks\n\nCandle signs every webhook delivery with\n`x-candle-signature: t=<unix seconds>,v1=<hex hmac-sha256(secret, \"<t>.<body>\")>`. Verify the\nRAW request body string (do not re-serialize parsed JSON; key order changes break the digest):\n\n```ts\nimport { verifyWebhookSignature } from \"@candledottv/agent-sdk\"\n\n// Example with a Bun/Node fetch-style handler:\nasync function handleWebhook(req: Request): Promise<Response> {\n  const rawBody = await req.text()\n  const ok = verifyWebhookSignature(\n    process.env.CANDLE_WEBHOOK_SECRET ?? \"\",\n    req.headers.get(\"x-candle-signature\"),\n    rawBody,\n    Math.floor(Date.now() / 1000),\n    300, // tolerance in seconds (default)\n  )\n  if (!ok) return new Response(\"invalid signature\", { status: 401 })\n\n  const event = JSON.parse(rawBody)\n  // handle launch.confirmed, launch.failed, curve.graduated, migration.completed, migration.delayed\n  return new Response(\"ok\")\n}\n```\n\nThe verifier never throws: malformed headers, stale timestamps, wrong secrets, and tampered\nbodies all return `false`. Comparison is constant-time (`timingSafeEqual`).\n\n## Errors\n\nEvery non-2xx response throws `CandleApiError` with `code`, `status`, `retryable`, and\n(for field-level validation) `field`. Structured envelopes map straight through; the few\nlegacy endpoints without envelopes (activity, users) surface as `code: \"HTTP_<status>\"`.\nThe full code table lives in `docs/headless-launch.md`.\n\n## Development\n\n```bash\nbun test          # pure tests against an injected fake fetch; no server, no network\nbun run typecheck # tsc --noEmit\n```\n","readmeFilename":"README.md"}