npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

clawpump-sentinel

v0.2.1

Published

Sentinel SDK: a security gateway between your AI agent and its Solana wallet. Token scan, transaction simulation, owner policies, kill-switch.

Readme

clawpump-sentinel

A security gateway between your AI agent and its Solana wallet. Before anything is signed, Sentinel scans the token, simulates the transaction and applies the owner's policies. Built for the ClawPump ecosystem.

npm i clawpump-sentinel @solana/web3.js

One line for the agent

import { Sentinel } from 'clawpump-sentinel';
import { Connection, Keypair } from '@solana/web3.js';

const sentinel = new Sentinel({ policy: { limits: { per_tx_sol: 2, per_day_sol: 10 } } });

const res = await sentinel.executeAndSend(
  { type: 'buy', wallet: agent.publicKey.toBase58(), mint: '<token CA>', sol: 0.5 },
  agent,        // Keypair: the agent signs, Sentinel never sees the key
  connection,
);

if (res.decision !== 'allow') console.log('Not sent:', res.reasons.map((r) => r.message));

executeAndSend signs and sends only when the decision is allow. Anything else comes back unsigned with the reasons:

| decision | meaning | |---|---| | allow | passed every check, signed and sent | | confirm | needs the owner's approval first | | block | failed a check, for example a rug token or an over-limit trade | | freeze | the kill-switch fired, for example a drain attempt |

Local check before signing

You should not have to trust the Sentinel server with what you sign. Before executeAndSend and guard.run sign anything, the SDK simulates the transaction on your own connection and compares the result with your intent:

  • SOL leaving the wallet stays within the intent amount plus 0.005 SOL for fees and rent
  • no other token balance drops; on a sell, at most the amount you asked to sell leaves
  • on a buy the token you asked for arrives; on a transfer the recipient you named gets paid
  • no token account gets a delegate or a new owner, and the wallet is not reassigned

If anything is off, it throws VerificationError and nothing is signed. On a guarded wallet the same check runs on the vault before the agent signs the execution, and the proposal step may only spend the agent's rent.

You can run it yourself on any transaction:

import { verifyTransaction, expectationFor } from 'clawpump-sentinel';
await verifyTransaction(connection, base64Tx, expectationFor(intent, wallet));

Turning it off ({ verify: false }) means trusting the server with what you sign.

When Sentinel is unreachable

The SDK fails closed. A network error, a timeout (30 s by default, new Sentinel({ timeoutMs })) or any non-2xx answer throws SentinelError, and nothing is signed. A guarded wallet cannot move funds without Sentinel's vote at all, while the owner keeps every permission and can still move funds or remove the agent. The hosted API allows 30 requests per minute per IP.

Guarded wallets (on-chain enforcement)

A guarded wallet is a Squads multisig where the agent can only propose, Sentinel can only approve and the owner keeps full control. The agent cannot move funds without Sentinel's vote, even if it is compromised.

// Owner, once:
const setup = await sentinel.guard.setup({ owner, agent, fundSol: 1 });
// sign setup.transaction with the owner wallet and send it
// open setup.telegramLink to get approval requests and kill-switch alerts

// Agent, per trade: propose + execute in one call
const run = await sentinel.guard.run(
  { multisig: setup.multisig, intent: { type: 'buy', agent: agentKey.publicKey.toBase58(), mint, sol: 0.5 } },
  agentKey,
  connection,
);
run.executed;     // true when Sentinel approved and it ran
run.approvalUrl;  // set when the owner must approve

Other calls

await sentinel.scan(mint);                       // 0-100 risk score with flags
await sentinel.execute(intent);                  // decision + unsigned transaction
await sentinel.check(myTransaction, { wallet }); // judge a transaction you built
await sentinel.guard.status(multisig);           // members, balance, frozen?
await sentinel.journal({ wallet });              // decision log

Prefer MCP? Connect https://www.santinelguard.online/api/mcp as a custom connector.

Docs: https://www.santinelguard.online/docs · Updates: @Sent1nelAgency

Scores and decisions are risk indicators, not financial advice.