@blueprint.xyz/goat-plugin-solentic

Native Solana staking with Blueprint validator via Solentic API

latest

Source

npm

Version: 0.1.0

Version published: 5 months ago

Maintainers: 1

Created: 5 months ago

Source

@goat-sdk/plugin-solentic

Native Solana staking with Blueprint validator via the GOAT SDK. Stake, unstake, withdraw, and monitor SOL staking positions through AI agents.

Installation

npm install @goat-sdk/plugin-solentic

Make sure you also have the required peer dependencies:

npm install @goat-sdk/core @goat-sdk/wallet-solana

Usage

import { getOnChainTools } from "@goat-sdk/adapter-vercel-ai";
import { solana } from "@goat-sdk/wallet-solana";
import { solentic } from "@goat-sdk/plugin-solentic";

const tools = await getOnChainTools({
  wallet: solana({ /* wallet config */ }),
  plugins: [solentic()],
});

// Use with your LLM framework of choice (Vercel AI, LangChain, etc.)

Custom API URL

solentic({ baseUrl: "https://your-solentic-instance.com" })

Available Tools

Transaction Tools

Tool	Description
`stakeSol`	Stake SOL with Blueprint validator. Builds, signs, and submits in one call.
`unstakeSol`	Deactivate a stake account. SOL becomes withdrawable after the epoch ends (~2-3 days).
`withdrawStake`	Withdraw SOL from a fully deactivated stake account back to the wallet.

Read-Only Tools

Tool	Description
`getValidatorInfo`	Full validator details: commission, rank, APY, performance, infrastructure.
`getStakingApy`	APY breakdown: base staking APY, Jito MEV APY, total combined APY.
`getStakeAccounts`	List all stake accounts for a wallet delegated to Blueprint validator.
`checkWithdrawReady`	Check which stake accounts are ready for withdrawal after unstaking.
`simulateStake`	Project staking returns for a given amount and duration without transacting.

Security

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.
No key storage: Private keys remain in the wallet client and are never sent to the Solentic API.
Verifiable: The Solentic API provides a verify_code_integrity tool for auditing the server-side transaction building code.

Staking Lifecycle

Stake: Call stakeSol with an amount. Returns a transaction signature and new stake account address. The stake activates at the next epoch boundary.
Monitor: Use getStakeAccounts to see status. Use simulateStake to project returns.
Unstake: Call unstakeSol with the stake account address. Begins the cooldown (deactivation) period.
Withdraw: After the epoch ends, call checkWithdrawReady to verify, then withdrawStake to reclaim SOL.