{"_id":"@blueprint.xyz/goat-plugin-solentic","name":"@blueprint.xyz/goat-plugin-solentic","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@blueprint.xyz/goat-plugin-solentic","version":"0.1.0","description":"Native Solana staking with Blueprint validator via Solentic API","type":"module","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","clean":"rm -rf dist"},"dependencies":{"zod":"^3.23.0"},"peerDependencies":{"@goat-sdk/core":">=0.5.0","@goat-sdk/wallet-solana":">=0.2.0"},"devDependencies":{"@goat-sdk/core":"^0.5.0","@goat-sdk/wallet-solana":"^0.2.0","tsup":"^8.3.5","typescript":"^5.9.3"},"keywords":["goat","solana","staking","defi","ai-agent","solentic","blueprint","validator"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/blueprint-infrastructure/goat-plugin-solentic.git"},"homepage":"https://solentic.theblueprint.xyz","bugs":{"url":"https://github.com/blueprint-infrastructure/goat-plugin-solentic/issues"},"publishConfig":{"access":"public"},"gitHead":"74793823e52d1ca0fa8979c49a077fc4ec53de9d","_id":"@blueprint.xyz/goat-plugin-solentic@0.1.0","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-GY7nYxrSiSWbbUdGsZKdAaUsPwZKZcF5m2uZP+7bFiVTZJ/npE7fHpyAB4soEAanN0Jqy1FPigHFKmDJ2PRWBA==","shasum":"b70dbde9f50269123ea908ca9b3d37436eaaa284","tarball":"https://registry.npmjs.org/@blueprint.xyz/goat-plugin-solentic/-/goat-plugin-solentic-0.1.0.tgz","fileCount":8,"unpackedSize":65820,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF4K/1cQb2wZ32KsxRO1jIbT5Xhdy1U0edLFF+dryasRAiEAsNM3RRGmG6EdJLfydIEgiXbvsckJCcz0L79XSVzRUAI="}]},"_npmUser":{"name":"blueprint.xyz","email":"matt@brassey.io"},"directories":{},"maintainers":[{"name":"blueprint.xyz","email":"matt@brassey.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/goat-plugin-solentic_0.1.0_1776149119133_0.6835159576529781"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-14T06:45:18.994Z","0.1.0":"2026-04-14T06:45:19.306Z","modified":"2026-04-14T06:45:19.495Z"},"maintainers":[{"name":"blueprint.xyz","email":"matt@brassey.io"}],"description":"Native Solana staking with Blueprint validator via Solentic API","homepage":"https://solentic.theblueprint.xyz","keywords":["goat","solana","staking","defi","ai-agent","solentic","blueprint","validator"],"repository":{"type":"git","url":"git+https://github.com/blueprint-infrastructure/goat-plugin-solentic.git"},"bugs":{"url":"https://github.com/blueprint-infrastructure/goat-plugin-solentic/issues"},"license":"MIT","readme":"# @goat-sdk/plugin-solentic\n\nNative Solana staking with [Blueprint validator](https://solentic.theblueprint.xyz) via the [GOAT SDK](https://github.com/goat-sdk/goat). Stake, unstake, withdraw, and monitor SOL staking positions through AI agents.\n\n## Installation\n\n```bash\nnpm install @goat-sdk/plugin-solentic\n```\n\nMake sure you also have the required peer dependencies:\n\n```bash\nnpm install @goat-sdk/core @goat-sdk/wallet-solana\n```\n\n## Usage\n\n```typescript\nimport { getOnChainTools } from \"@goat-sdk/adapter-vercel-ai\";\nimport { solana } from \"@goat-sdk/wallet-solana\";\nimport { solentic } from \"@goat-sdk/plugin-solentic\";\n\nconst tools = await getOnChainTools({\n  wallet: solana({ /* wallet config */ }),\n  plugins: [solentic()],\n});\n\n// Use with your LLM framework of choice (Vercel AI, LangChain, etc.)\n```\n\n### Custom API URL\n\n```typescript\nsolentic({ baseUrl: \"https://your-solentic-instance.com\" })\n```\n\n## Available Tools\n\n### Transaction Tools\n\n| Tool | Description |\n|------|-------------|\n| `stakeSol` | Stake SOL with Blueprint validator. Builds, signs, and submits in one call. |\n| `unstakeSol` | Deactivate a stake account. SOL becomes withdrawable after the epoch ends (~2-3 days). |\n| `withdrawStake` | Withdraw SOL from a fully deactivated stake account back to the wallet. |\n\n### Read-Only Tools\n\n| Tool | Description |\n|------|-------------|\n| `getValidatorInfo` | Full validator details: commission, rank, APY, performance, infrastructure. |\n| `getStakingApy` | APY breakdown: base staking APY, Jito MEV APY, total combined APY. |\n| `getStakeAccounts` | List all stake accounts for a wallet delegated to Blueprint validator. |\n| `checkWithdrawReady` | Check which stake accounts are ready for withdrawal after unstaking. |\n| `simulateStake` | Project staking returns for a given amount and duration without transacting. |\n\n## Security\n\n- **Zero custody**: The plugin never handles private keys. All transactions are built as unsigned base64 payloads by the Solentic API and signed by the GOAT wallet client.\n- **No key storage**: Private keys remain in the wallet client and are never sent to the Solentic API.\n- **Verifiable**: The Solentic API provides a `verify_code_integrity` tool for auditing the server-side transaction building code.\n\n## Staking Lifecycle\n\n1. **Stake**: Call `stakeSol` with an amount. Returns a transaction signature and new stake account address. The stake activates at the next epoch boundary.\n2. **Monitor**: Use `getStakeAccounts` to see status. Use `simulateStake` to project returns.\n3. **Unstake**: Call `unstakeSol` with the stake account address. Begins the cooldown (deactivation) period.\n4. **Withdraw**: After the epoch ends, call `checkWithdrawReady` to verify, then `withdrawStake` to reclaim SOL.\n\n## Links\n\n- [Solentic API](https://solentic.theblueprint.xyz)\n- [API Documentation](https://solentic.theblueprint.xyz/docs)\n- [GOAT SDK](https://github.com/goat-sdk/goat)\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-0c2ed3a6199814b3a6df2897b42c2073"}