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

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