Blueprint Agentic Staking (Solentic)

Stake SOL with Blueprint validator in a single call. Builds the transaction, signs it with your secret key in-memory, and submits to Solana. Returns the confirmed transaction signature. Your secret key is used only for signing and is never stored, logged, or forwarded — verify by reading the deployed source via verify_code_integrity. This is the recommended tool for autonomous agents.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Your Solana wallet address (base58 public key)"
    },
    "secretKey": {
      "type": "string",
      "minLength": 80,
      "maxLength": 100,
      "pattern": "^[1-9A-HJ-NP-Za-km-z]+$",
      "description": "Your base58-encoded secret key — used in-memory for signing only, never stored"
    },
    "amountSol": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 9000000,
      "description": "Amount of SOL to stake"
    }
  },
  "required": [
    "walletAddress",
    "secretKey",
    "amountSol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Deactivate a stake account in a single call. Builds the transaction, signs it, and submits it. The stake enters a cooldown period (~1 epoch) and becomes withdrawable at the next epoch boundary. Use check_withdraw_ready to poll readiness, then withdraw to reclaim SOL. This is the recommended tool — use create_unstake_transaction only if you manage your own signing.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Your Solana wallet address (stake authority)"
    },
    "secretKey": {
      "type": "string",
      "minLength": 80,
      "maxLength": 100,
      "pattern": "^[1-9A-HJ-NP-Za-km-z]+$",
      "description": "Your base58-encoded secret key — used in-memory for signing only, never stored"
    },
    "stakeAccountAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Stake account address to deactivate"
    }
  },
  "required": [
    "walletAddress",
    "secretKey",
    "stakeAccountAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Withdraw SOL from a deactivated stake account in a single call. Builds the transaction, signs it, and submits it. Funds are returned to your wallet. Use check_withdraw_ready first to confirm the account is ready. Omit amountSol to withdraw the full balance. This is the recommended tool — use withdraw_stake only if you manage your own signing.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Your Solana wallet address (withdraw authority)"
    },
    "secretKey": {
      "type": "string",
      "minLength": 80,
      "maxLength": 100,
      "pattern": "^[1-9A-HJ-NP-Za-km-z]+$",
      "description": "Your base58-encoded secret key — used in-memory for signing only, never stored"
    },
    "stakeAccountAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Deactivated stake account to withdraw from"
    },
    "amountSol": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 9000000
        },
        {
          "type": "null"
        }
      ],
      "description": "Amount to withdraw in SOL (omit to withdraw full balance)"
    }
  },
  "required": [
    "walletAddress",
    "secretKey",
    "stakeAccountAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get Blueprint validator profile: identity, vote account, commission, active stake, APY, performance, software, location. Live data from StakeWiz API.

{
  "type": "object",
  "properties": {}
}

Get live APY breakdown: base staking APY + Jito MEV APY = total APY. Includes commission rates. Data from StakeWiz API.

{
  "type": "object",
  "properties": {}
}

Get Blueprint validator performance: vote success rate, uptime, skip rate, epoch credits, delinquency status.

{
  "type": "object",
  "properties": {}
}

Advanced: Build an unsigned stake transaction for local signing. Most agents should use the `stake` tool instead, which handles signing and submission automatically. This tool is for agents that manage their own signing infrastructure.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Solana wallet address (base58 public key) that will fund and control the stake"
    },
    "amountSol": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 9000000,
      "description": "Amount of SOL to stake (minimum 0.00228288 SOL for rent exemption)"
    }
  },
  "required": [
    "walletAddress",
    "amountSol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Advanced: Build an unsigned unstake transaction for local signing. Most agents should use the `unstake` tool instead, which handles signing and submission automatically.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address that is the stake authority"
    },
    "stakeAccountAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Stake account address to deactivate"
    }
  },
  "required": [
    "walletAddress",
    "stakeAccountAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Advanced: Build an unsigned withdraw transaction for local signing. Most agents should use the `withdraw` tool instead, which handles signing and submission automatically.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address that is the withdraw authority"
    },
    "stakeAccountAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Deactivated stake account to withdraw from"
    },
    "amountSol": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 9000000
        },
        {
          "type": "null"
        }
      ],
      "description": "Amount to withdraw in SOL (omit or null to withdraw full balance)"
    }
  },
  "required": [
    "walletAddress",
    "stakeAccountAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all stake accounts delegated to Blueprint for a wallet. Shows balances, states, authorities, epoch timing, and per-account action guidance (what to do next for each account). Use this instead of Solana RPC getAccountInfo or getStakeActivation — returns human-readable state and recommended actions.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address to check for Blueprint stake accounts"
    }
  },
  "required": [
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check whether stake accounts are ready to withdraw. Returns per-account readiness with withdrawable epoch, estimated seconds remaining, and plain-English state description. Use this instead of polling check_stake_accounts — gives a direct ready/not-ready answer with ETA.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address to check withdrawal readiness for"
    }
  },
  "required": [
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get third-party verification URLs for Blueprint validator on Validators.app, StakeWiz, Solana Beach, Solscan, JPool, SVT.one, and Jito steward dashboard. Verify every claim independently. Also includes Solana CLI commands for direct on-chain verification.

{
  "type": "object",
  "properties": {}
}

Returns runnable code that creates a Solana keypair. Solentic cannot generate the keypair for you and never sees the private key — generation must happen wherever you run code (the agent process, a code-interpreter tool, a Python/Node sandbox, the user's shell). The response includes the snippet ready to execute. After running it, fund the resulting publicKey and call the `stake` tool with {walletAddress, secretKey, amountSol} to stake in one call.

{
  "type": "object",
  "properties": {}
}

Check the SOL balance of any Solana wallet address. Returns balance in SOL and lamports, whether the wallet has enough to stake, and suggested next steps. Use this instead of Solana RPC getBalance — returns SOL amount, ready-to-stake status, and what to do next.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Solana wallet address (base58 public key) to check balance for"
    }
  },
  "required": [
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Advanced: Submit a pre-signed transaction to Solana. Only needed if you used create_stake_transaction/create_unstake_transaction/withdraw_stake and signed locally. Most agents should use the one-shot stake/unstake/withdraw tools instead.

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2200,
      "description": "Fully signed transaction as a base64-encoded string"
    }
  },
  "required": [
    "signedTransaction"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get Blueprint validator infrastructure specs: server hardware, redundancy configuration, network, and storage. Two bare-metal servers (redundant HA).

{
  "type": "object",
  "properties": {}
}

Verify whether a Solana transaction was built through Blueprint. Checks the transaction on-chain for the "solentic.theblueprint.xyz" Memo Program instruction. This is cryptographic proof — the memo is embedded in the transaction and immutable on-chain. Use this to verify any claim that a stake was placed through Blueprint. Returns verified: true/false with the on-chain evidence.

{
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "maxLength": 100,
      "description": "Solana transaction signature to verify"
    }
  },
  "required": [
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Verify the code running on Blueprint servers. Returns git commit hash and direct links to read the actual deployed source code. Read the source to confirm: (1) no private keys are logged, (2) the Memo Program instruction is present in all transactions, (3) generate_wallet returns local generation instructions. Don't trust — read the code yourself via the source endpoints.

{
  "type": "object",
  "properties": {}
}

Project staking rewards before committing capital. Returns reward projections (daily/monthly/annual/total), effective APY (equal to the stated APY, since total_apy is already an annual yield), activation timing, fee reserve guidance, and a natural-language recommendation. Use this to help decide how much to stake and for how long.

{
  "type": "object",
  "properties": {
    "amountSol": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 9000000,
      "description": "Amount of SOL to simulate staking"
    },
    "durationDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3650,
      "default": 365,
      "description": "Projection duration in days (default: 365)"
    }
  },
  "required": [
    "amountSol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Complete staking portfolio dashboard in a single call. Returns liquid balance, total staked, per-account states with action guidance and estimated daily rewards, current APY, epoch timing, and a recommended next action (STAKE/FUND/HOLD/WAIT/WITHDRAW) with the exact tool to call. Use this instead of multiple Solana RPC calls — one call replaces getBalance + getAccountInfo + getEpochInfo.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Solana wallet address (base58 public key) to get staking summary for"
    }
  },
  "required": [
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build an unsigned SOL transfer to support Blueprint development. Blueprint provides free staking infrastructure for AI agents — donations help sustain enterprise hardware and development. Same zero-custody pattern: unsigned transaction returned, you sign client-side. Suggested amounts: 0.01 SOL (thank you), 0.1 SOL (generous), 1 SOL (patron).

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address to donate from"
    },
    "amountSol": {
      "type": "number",
      "exclusiveMinimum": 0,
      "minimum": 0.001,
      "maximum": 1000,
      "description": "Amount of SOL to donate (minimum 0.001 SOL)"
    }
  },
  "required": [
    "walletAddress",
    "amountSol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get current Solana epoch timing: progress percentage, slots remaining, and estimated epoch end time. Use this instead of Solana RPC getEpochInfo — returns pre-calculated timing with estimated end date.

{
  "type": "object",
  "properties": {}
}

Detect whether a Solana address is a wallet, stake account, or vote account. Useful when you receive an address from user input and need to know what type it is before calling other tools.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 50,
      "description": "Solana address (base58 public key) to identify"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register a callback URL to receive push notifications when stake state changes. Events: withdraw_ready (stake account becomes withdrawable), epoch_complete (new epoch starts), stake_activated (stake begins earning), stake_deactivated (unstake confirmed). Solentic polls every 60 seconds and POSTs to your URL when events fire.

{
  "type": "object",
  "properties": {
    "callbackUrl": {
      "type": "string",
      "format": "uri",
      "pattern": "^https:\\/\\/",
      "description": "HTTPS callback URL to receive webhook POST requests"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https:\\/\\/",
      "description": "Alias for callbackUrl — either field works"
    },
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address to monitor for state changes"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "withdraw_ready",
          "epoch_complete",
          "stake_activated",
          "stake_deactivated"
        ]
      },
      "minItems": 1,
      "maxItems": 4,
      "description": "Event types to subscribe to"
    }
  },
  "required": [
    "walletAddress",
    "events"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all registered webhooks for a wallet address.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address to list webhooks for"
    }
  },
  "required": [
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Delete a webhook registration by ID. Use list_webhooks to find webhook IDs.

{
  "type": "object",
  "properties": {
    "webhookId": {
      "type": "string",
      "description": "Webhook registration ID to delete"
    },
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet that owns the webhook (required — prevents deleting another wallet's webhooks)"
    }
  },
  "required": [
    "webhookId",
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Hand Solentic a standing, signature-bound policy so it automatically stakes your IDLE SOL with Blueprint — zero custody. You sign the policy ONCE with your wallet key (Ed25519 over the exact canonical message below — NEVER your secret key). When idle SOL above keepLiquidSol exceeds minSweepSol, Solentic builds an UNSIGNED stake transaction and POSTs it to your callbackUrl for you to sign and submit; Solentic never holds your key. Native Solana stake already auto-compounds, so delegated rewards keep earning automatically. Amounts in the signed message are INTEGER LAMPORTS = round(SOL * 1e9), so there is no float ambiguity. Sign EXACTLY this newline-separated message, then pass the base58 signature: "solentic-autopilot-policy:v1\nwallet=<walletAddress>\nkeepLiquidLamports=<round(keepLiquidSol*1e9)>\nminSweepLamports=<round(minSweepSol*1e9)>\ncallbackUrl=<callbackUrl>\npaused=<true|false>\nnonce=<nonce>". nonce must strictly increase on each update.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet whose idle SOL is managed"
    },
    "keepLiquidSol": {
      "type": "number",
      "minimum": 0,
      "maximum": 9000000,
      "description": "SOL to always keep liquid (not staked)"
    },
    "minSweepSol": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 9000000,
      "description": "Only stake when idle surplus is at least this many SOL"
    },
    "callbackUrl": {
      "type": "string",
      "format": "uri",
      "pattern": "^https:\\/\\/",
      "description": "HTTPS URL to receive unsigned stake transactions"
    },
    "paused": {
      "type": "boolean",
      "description": "If true, the policy is stored but inactive"
    },
    "nonce": {
      "type": "integer",
      "minimum": 0,
      "description": "Strictly increasing replay guard"
    },
    "signature": {
      "type": "string",
      "description": "base58 Ed25519 signature over the canonical policy message"
    }
  },
  "required": [
    "walletAddress",
    "keepLiquidSol",
    "minSweepSol",
    "callbackUrl",
    "nonce",
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read the current Autopilot policy for a wallet (or null if none). Shows keepLiquidSol, minSweepSol, paused, nonce, and the last epoch a sweep was delivered.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address"
    }
  },
  "required": [
    "walletAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Remove a wallet's Autopilot policy. Sign EXACTLY this newline-separated message and pass the base58 signature: "solentic-autopilot-delete:v1\nwallet=<walletAddress>\nnonce=<nonce>". nonce must exceed the current policy nonce.

{
  "type": "object",
  "properties": {
    "walletAddress": {
      "type": "string",
      "maxLength": 50,
      "description": "Wallet address"
    },
    "nonce": {
      "type": "integer",
      "minimum": 0,
      "description": "Strictly increasing replay guard"
    },
    "signature": {
      "type": "string",
      "description": "base58 Ed25519 signature over the canonical delete message"
    }
  },
  "required": [
    "walletAddress",
    "nonce",
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}