AgentShield JS SDK

Trust no contract. Verify before you transact.

Official JavaScript SDK for AgentShield — smart contract security for autonomous AI agents. 20 methods covering verification, scanning, wallet monitoring, threat reporting, and leaderboards.

Install

npm install agentshield-js

Quick Start

const AgentShield = require('agentshield-js');
const shield = new AgentShield({ apiKey: 'your-key' }); // optional for free tier

// Verify a contract before trading
const result = await shield.verify('0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D', 'ethereum');
console.log(result.risk_level);    // "low" | "medium" | "high" | "critical"
console.log(result.is_honeypot);   // false
console.log(result.risks_found);   // []

// Full scan (14+ checks)
const scan = await shield.scan('DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263', 'solana');
console.log(scan.mint_authority);  // false
console.log(scan.freeze_authority); // false

// Safe wrapper — throws on dangerous contracts
await shield.safeInteract('0x...', 'base'); // throws if honeypot/rug

All 20 Methods

Security

| Method | Description | |--------|-------------| | verify(contract, chain) | Quick safety check — honeypots, rug pulls, taxes, ownership | | scan(contract, chain) | Full 14+ threat scan — mint auth, freeze, proxies, liquidity | | deepScan(contract, chain) | Forensic analysis — bytecode, ownership graph, exploits | | verifyBatch(contracts, chain) | Batch verify up to 50 contracts | | contractDiff(contract, chain) | Detect changes between contract snapshots | | safeInteract(contract, chain) | Verify + throw on danger (use before any tx) | | safeScan(contract, chain) | Scan + throw on danger |

Wallet Protection

| Method | Description | |--------|-------------| | monitor({ wallet, callback_url }) | Real-time drain detection with auto-freeze | | freeze({ wallet, reason }) | Emergency freeze all agent wallets | | alerts(wallet, limit) | Get recent drain alerts |

Community

| Method | Description | |--------|-------------| | report({ contract, reason, evidence }) | Report malicious contracts (+50 bonus calls) | | reputation(agent) | Get community reputation score | | webhook({ contract, callback_url }) | Watch for proxy upgrades, ownership transfers | | dashboard() | Your usage, billing, webhooks | | stats() | Platform-wide statistics | | integrations() | Available integrations |

Social & Leaderboard

| Method | Description | |--------|-------------| | leaderboard() | Race to 1M — top 10 win $500 USDC | | setAgentName(name) | Set leaderboard display name | | giveaway() | View active giveaways | | giveawayEnter(name) | Enter giveaway (paid subscribers only) | | referral(action, code) | Create/redeem referral codes (20% commission) |

Supported Chains

Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Solana

Pricing

| Tier | Price | Calls | |------|-------|-------| | Free | $0 | 10 verify + 5 scan + 2 deep per day | | Pay-per-call | $0.001 | Unlimited via x402 (USDC or SOL) | | Starter | $4.99/mo | 5,000 calls | | Pro | $19.99/mo | 100,000 + unlimited deep scans | | Builder | $49.99/mo | Unlimited everything |

MCP Server

For AI agents using Model Context Protocol:

npx agentshield-mcp

See agentshield-mcp for 19 MCP tools.

License

MIT