atmflow55/agentshield-js
GitHub: atmflow55/agentshield-js
这是一个面向自主 AI 代理的智能合约安全协议 JavaScript SDK，提供合约验证、钱包监控及威胁阻断功能。
Stars: 0 | Forks: 0
# AgentShield JS SDK
[AgentShield](https://agentshield.win) 的官方 JavaScript SDK —— 为自主 AI 代理提供智能合约安全防护。包含 20 种方法，涵盖验证、扫描、钱包监控、威胁报告和排行榜。
[](https://www.npmjs.com/package/agentshield-js)
[](https://opensource.org/licenses/MIT)
## 安装
```
npm install agentshield-js
```
## 快速开始
```
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
```
## 全部 20 种方法
### 安全
| Method | Description |
|--------|-------------|
| `verify(contract, chain)` | 快速安全检查 —— 蜜罐、撤资（rug pull）、税收、所有权 |
| `scan(contract, chain)` | 全面 14+ 项威胁扫描 —— 铸造权限、冻结、代理、流动性 |
| `deepScan(contract, chain)` | 取证分析 —— 字节码、所有权图谱、漏洞利用 |
| `verifyBatch(contracts, chain)` | 批量验证最多 50 个合约 |
| `contractDiff(contract, chain)` | 检测合约快照之间的变化 |
| `safeInteract(contract, chain)` | 验证并在遇到危险时抛出异常（在任何交易前使用）|
| `safeScan(contract, chain)` | 扫描并在遇到危险时抛出异常 |
### 钱包保护
| Method | Description |
|--------|-------------|
| `monitor({ wallet, callback_url })` | 实时盗取检测，支持自动冻结 |
| `freeze({ wallet, reason })` | 紧急冻结所有代理钱包 |
| `alerts(wallet, limit)` | 获取最近的盗取警报 |
### 社区
| Method | Description |
|--------|-------------|
| `report({ contract, reason, evidence })` | 举报恶意合约（+50 次奖励调用）|
| `reputation(agent)` | 获取社区信誉评分 |
| `webhook({ contract, callback_url })` | 监控代理升级、所有权转移 |
| `dashboard()` | 您的使用情况、账单、webhooks |
| `stats()` | 平台级统计数据 |
| `integrations()` | 可用的集成 |
### 社交与排行榜
| Method | Description |
|--------|-------------|
| `leaderboard()` | 冲击 100 万 —— 前 10 名赢得 $500 USDC |
| `setAgentName(name)` | 设置排行榜显示名称 |
| `giveaway()` | 查看活跃的赠品活动 |
| `giveawayEnter(name)` | 参与赠品活动（仅限付费订阅者）|
| `referral(action, code)` | 创建/兑换推荐码（20% 佣金）|
## 支持的链
Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Solana
## 定价
| Tier | Price | Calls |
|------|-------|-------|
| Free | $0 | 每天 10 次 verify + 5 次 scan + 2 次 deep |
| Pay-per-call | $0.001 | 通过 x402 无限制调用（USDC 或 SOL）|
| Starter | $4.99/mo | 5,000 次调用 |
| Pro | $19.99/mo | 100,000 次调用 + 无限制 deep scan |
| Builder | $49.99/mo | 全部无限制 |
## MCP Server
对于使用 Model Context Protocol 的 AI 代理：
```
npx agentshield-mcp
```
查看 [agentshield-mcp](https://www.npmjs.com/package/agentshield-mcp) 了解 19 种 MCP 工具。
## License
MIT
标签：AgentShield, AI代理安全, Base, Cilium, CMS安全, DeFi安全, Ethereum, JavaScript, MITM代理, Node.js库, NPM, Rug Pull检测, Solana, Web3安全, 交易防护, 代币验证, 以太坊, 区块链安全, 合约审计, 安全协议, 数据可视化, 智能合约安全, 权限分析, 流动性检查, 自动化交易防护, 自定义脚本, 蜜罐检测, 钱包监控, 风险扫描