{"_id":"@centinel-risk-protocol/eliza-plugin-centinel","_rev":"2-2ef1a5d540be49b69781736795bb6d2c","name":"@centinel-risk-protocol/eliza-plugin-centinel","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@centinel-risk-protocol/eliza-plugin-centinel","version":"1.0.0","keywords":["eliza","elizaos","plugin","risk","base","defi","audit","agent"],"author":{"name":"Centinel Risk Protocol"},"license":"MIT","_id":"@centinel-risk-protocol/eliza-plugin-centinel@1.0.0","maintainers":[{"name":"jbcrp","email":"najabrgr@gmail.com"}],"dist":{"shasum":"4ae7a15dfdde64c4c8dfe8650505d38fae6a6c8e","tarball":"https://registry.npmjs.org/@centinel-risk-protocol/eliza-plugin-centinel/-/eliza-plugin-centinel-1.0.0.tgz","fileCount":6,"integrity":"sha512-AutjfS+hjUh84CuiMU+EkCHhTsmJY0K4sM83Soc/+WOsKfRjfasLobsogBPL5W4n1l+H/HzRHn9IEezPPjgEUQ==","signatures":[{"sig":"MEUCIQDJPGJoPJ6Eg8bCYGv9TObMcZIA9HDbzi4TJv5/UfTDngIgeYBIrW3aRjZAWyNSIjXHElY+1hkVrJAgO4EUAUZpdnc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39362},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6acc11a9b9c2994fc69e501af5f99a3840e974c0","scripts":{"dev":"tsup --watch","lint":"eslint src","build":"tsup","prepare":"npm run build"},"_npmUser":{"name":"jbcrp","email":"najabrgr@gmail.com"},"_npmVersion":"11.9.0","description":"Centinel Risk Protocol integration for ElizaOS","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"3.23.3","bignumber.js":"^9.1.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"latest","@ai16z/eliza":"0.1.6-alpha.4"},"peerDependencies":{"@ai16z/eliza":"0.1.6-alpha.4"},"_npmOperationalInternal":{"tmp":"tmp/eliza-plugin-centinel_1.0.0_1778881469537_0.2535434101716316","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@centinel-risk-protocol/eliza-plugin-centinel","version":"1.0.1","description":"Centinel Risk Protocol integration for ElizaOS","type":"module","main":"dist/index.js","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsup","dev":"tsup --watch","lint":"eslint src","prepare":"npm run build"},"publishConfig":{"access":"public"},"keywords":["eliza","elizaos","plugin","risk","base","defi","audit","agent"],"author":{"name":"Centinel Risk Protocol"},"license":"MIT","dependencies":{"zod":"3.23.3","bignumber.js":"^9.1.2"},"devDependencies":{"tsup":"^8.0.0","typescript":"latest","@ai16z/eliza":"0.1.6-alpha.4"},"peerDependencies":{"@ai16z/eliza":"0.1.6-alpha.4"},"gitHead":"6acc11a9b9c2994fc69e501af5f99a3840e974c0","_id":"@centinel-risk-protocol/eliza-plugin-centinel@1.0.1","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-n83R2joNj0rDLpIXsMZw4oW8wsLSghlcV4aHcalYOjXUIQLqQoaRmf5AD7N0ZGZqd88Aq/Ot9bLBWXOthk3++g==","shasum":"6130ba97952ace7107eeefe39901460857f5e959","tarball":"https://registry.npmjs.org/@centinel-risk-protocol/eliza-plugin-centinel/-/eliza-plugin-centinel-1.0.1.tgz","fileCount":6,"unpackedSize":39144,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGf/SHQrWNzNVSwOCDT77D0HCPCdJSBKc7k7ZEOb7W4WAiEA9dmbHjd3nP5xaNQaFAQUuTgkWK2Y/4N0DznwPsgigRQ="}]},"_npmUser":{"name":"jbcrp","email":"najabrgr@gmail.com"},"directories":{},"maintainers":[{"name":"jbcrp","email":"najabrgr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/eliza-plugin-centinel_1.0.1_1778899533935_0.46820351905394353"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-15T21:44:29.392Z","modified":"2026-05-16T02:45:34.215Z","1.0.0":"2026-05-15T21:44:29.682Z","1.0.1":"2026-05-16T02:45:34.090Z"},"author":{"name":"Centinel Risk Protocol"},"license":"MIT","keywords":["eliza","elizaos","plugin","risk","base","defi","audit","agent"],"description":"Centinel Risk Protocol integration for ElizaOS","maintainers":[{"name":"jbcrp","email":"najabrgr@gmail.com"}],"readme":"# 🛡️ @centinel-risk-protocol/eliza-plugin-centinel\r\n\r\n\r\n\r\n\r\n---\r\n\r\n> **The \"Safety Switch\" for Autonomous Agents on Base Network.**\r\n\r\nPrevent your agent from going to zero. Integrate the **Centinel Risk Protocol (CRP)**: a high-fidelity risk oracle that provides real-time solvency auditing, solvency simulations(Stress-Test), and tactical liquidation triggers (Dynamic Risk Threshold) for the A2A (Agent-to-Agent) economy.\r\n\r\n\r\n🧠 Why your Agent needs this\r\n---\r\n\r\nStandard DeFi agents follow static rules. **Centinel Agents follow market physics.**\r\n\r\n* **Adaptive Health Factor:** Real-time monitoring of borrowing positions.\r\n* **Tactical Trigger Price:** Know the exact price point where your agent must de-leverage before it's too late.\r\n* **Stress-Test Simulations:** Real-time impact analysis of -10% flash crashes and -20% volatility shocks.\r\n* **Institutional Reports:** Bloomberg-style terminal reports (PDF) for compliance and auditing.\r\n\r\n\r\n 🚀 Installation\r\n ---\r\n\r\nbash\r\npnpm add @centinel-risk-protocol/eliza-plugin-centinel\r\n\r\n🔑 Authentication & Endpoints\r\n---\r\nTo ensure maximum security, Centinel uses dedicated endpoints for different service tiers.\r\n\r\n| Service | Endpoint URL | API Key | Access |\r\n| :--- | :--- | :--- | :--- |\r\n| **Pulse (Free)** | `See .env configuration` | `CENTINEL_PUBLIC_API_KEY` | Public / Rate-limited |\r\n| **Brain/Pulse (Premium)** | `Obtained after registration` | *Your Personal Key* | [Register here](https://dev.centinelrisk.tech) |\r\n\r\n### 🛠️ How to configure your .env\r\n\r\nCopy and paste the following variables into your agent's `.env` file. Replace `your_private_key_here` with the key obtained from our developer portal.\r\n\r\n```bash\r\n# ========================================================\r\n# CENTINEL RISK PROTOCOL - CONFIGURATION\r\n# ========================================================\r\n\r\n\r\n# Public Endpoint for Routine Pulse Checks (Free Tier)\r\nCENTINEL_API_URL=https://api.centinelrisk.tech/v1/eliza/plugin/crp2026\r\n\r\n# Public Key for Routine Free Checks\r\nCENTINEL_PUBLIC_API_KEY=Centinel_Internal_OZ_98s\r\n\r\n# Private Endpoint for Strategic Brain Audits and second Pulse use per day (Premium Tier)\r\n# Register at dev.centinelrisk.tech to get your private URL and Key\r\nCENTINEL_PRIVATE_API_KEY=your_private_key_here\r\n```\r\n\r\n\r\n🛠️ Configuration\r\n---\r\n📦 Core Actions\r\n\r\n**1.🛡️ GET_PULSE_REPORT (Routine Check)**\r\n\r\n* Cost: One Free per day or $2 USD (Second use per day).\r\n* Output: Immediate solvency score, Health Factor (HF) check, and maintenance recommendations.\r\n* Security Note: Generates a private URL with an institutional terminal view. The access_url is ephemeral and expires in 24h.\r\n \r\n \r\nClick for all JSON details in GET_PULSE_REPORT
\r\n \r\n ```json\r\n {\r\n \r\n \"full_data\": {\r\n \"audit_id\": \"AUD-Pulse-32..5\",\r\n \"timestamp\": \"2026-05-13T00:24:19.627Z\",\r\n \"plan\": \"Pulse\",\r\n \"status\": \"SUCCESS\",\r\n \"wallet\": \"0x0d...34\",\r\n \"transaction_hash\": \"FREE_TRIAL\",\r\n \"system_status\": \"Operational\",\r\n \"data\": {\r\n \"health_factor\": \"1.7644\",\r\n \"equity\": \"10009.09\",\r\n \"btc_price\": 80571\r\n },\r\n \"risk_engine\": {\r\n \"score_st\": \"3.86\",\r\n \"color_st\": \"YELLOW (Optimal Peak)\"\r\n },\r\n \"execution\": {\r\n \"liquidation_price\": \"45664.82\"\r\n },\r\n \"pulse\": {\r\n \"action_required\": \"Yes\",\r\n \"Action\": \"MONITOR_CYCLE_24H.\",\r\n \"Compliance_note\": \"[Vulnerability:NO], [Volatility_risk:No], [Safe Operating Solvency]\"\r\n },\r\n \"access_url\": \"https://centinelrisk.tech/report?id=28...960\",\r\n \"expires_at\": \"2026-05-14T00:24:19.650Z\"\r\n }\r\n }\r\n```\r\n\r\n \r\n\r\n**2. 🧠 GET_BRAIN_AUDIT (Strategic Deep-Dive)**\r\n\r\n* Cost: $8 USD.\r\n* Output: Strategy Reallocate Position module, designed to minimize exposure through precise adjustment vectors for repay and borrow operations. The system delivers a Full Stress-Test (-10% crash simulation), Long-Term (LT) risk score, and Tactical Trigger Price for de-leveraging.\r\n* Compliance: Generates a private URL with an institutional terminal view.\r\n\r\nStrategic for automated de-leveraging Agents. Use 'trigger_price' to set safety stops.\r\n\r\n\r\nClick for all JSON details in GET_BRAIN_AUDIT
\r\n\r\n```json\r\n {\r\n \"audit_id\": \"AUD-Brain-18..60\",\r\n \"timestamp\": \"2026-05-13T12:41:05.745Z\",\r\n \"plan\": \"BRAIN\",\r\n \"status\": \"SUCCESS\",\r\n \"wallet\": \"0x0a776abba....bea4b99b\",\r\n \"system_status\": \"Operational\",\r\n \"data\": {\r\n \"health_factor\": \"2.1567\",\r\n \"equity\": \"256855.06\",\r\n \"btc_price\": 79894\r\n },\r\n \"risk_engine\": {\r\n \"score_lt\": \"3.15\",\r\n \"color_lt\": \"GREEN (Growth Zone)\",\r\n \"maximum_drop_support\": \"53.63%\",\r\n \"score_st\": \"2.98\",\r\n \"color_st\": \"GREEN (Growth Zone)\"\r\n },\r\n \"stress_test\": {\r\n \"crash_test_10pct\": \"HF Post-Crash: 1.94 | Impact: Low\",\r\n \"volatility_test_20pct\": \"Score Proj: 2.98 | Impact: Low\",\r\n \"vulnerability_index\": \"LOW (0.00%)\"\r\n },\r\n \"execution\": {\r\n \"order_type\": \"BORROW\",\r\n \"amount_usd\": \"27460.10\",\r\n \"trigger_price\": \"45529.33\",\r\n \"liquidation_price\": \"37044.56\"\r\n },\r\n \"compliance_note\": \"Order BORROW justified: Consolidation phase. Under-allocation risk. Quiet Market. Vulnerability: LOW (0.00%).\",\r\n \"access_url\": \"https://centinelrisk.tech/report?id=28...960\",\r\n \"expires_at\": \"2026-05-14T00:24:19.650Z\"\r\n}\r\n```\r\n\r\n \r\n\r\n🕹️ How to Trigger (Usage Instructions)\r\n---\r\nTo ensure the Agent correctly identifies the requested audit type, users should follow these patterns:\r\n\r\n* For Pulse (Free/Routine):\r\nMust include the word \"Pulse\" + the Wallet Address (0x...).\r\nExample: \"Can you run a pulse check on 0x123...?\"\r\n\r\n* For Brain/Pulse (2nd Pulse day/Deep-Dive):\r\n Must include the Wallet addresss and Transaction Hash (64 characters).\r\nExample: \"Run an audit on 0x0...754 and hash 0x30....bf23\"\r\n\r\n🤖 Action Definitions\r\n---\r\nTo ensure high accuracy, this plugin implements specific intent recognition:\r\n\r\n**GET_PULSE_REPORT**\r\n* Triggers: \"check pulse [address]\", \"pulse check [address]\"\r\n* Requirements: A valid EVM address on base network and AAVE open position.\r\n\r\n**GET_BRAIN_AUDIT**\r\n* Triggers: \"brain audit [address] hash [hash]\"\r\n* Requirements: A valid EVM address on base network and AAVE open position + Transaction Hash (as Proof of Payment).\r\n\r\n💻 Quick Start: Integration\r\n---\r\nRegister the plugin in your ElizaOS entry point (usually index.ts or agent.ts):\r\n\r\n```TypeScript\r\nimport { centinelPlugin } from \"@centinel-risk-protocol/eliza-plugin-centinel\";\r\n\r\nconst runtime = new AgentRuntime({\r\n plugins: [centinelPlugin],\r\n // ... other configuration\r\n});\r\n```\r\n🧠 The \"Preventive Engine\"\r\n---\r\nThe plugin features a basic built-in RiskEvaluator (CENTINEL_PREVENTIVE_ENGINE) that acts as a proactive financial sentinel. Unlike standard actions, this evaluator monitors context in real-time to protect the user's solvency.\r\n\r\n**How it works:**\r\n* **Automatic Detection:** Scans for keywords like liquidation, health factor, collateral, Aave or borrow.\r\n* **Intelligent Advisory:** When risk is detected, the agent shifts into Senior Risk Analyst mode, injecting a system advisory to guide the conversation toward safety.\r\n* **Direct Action:** Proactively suggests a Centinel Pulse or Brain Audit to verify solvency.\r\n\r\n**Example Interaction:**\r\n**User:** \"I'm worried about my Aave position, the market looks shaky.\"\r\n\r\n**Agent (Centinel Activated):** \"I'd like to offer you a Free Audit Pulse to analyze your position. I can run a Centinel Pulse check on your Base wallet right now to verify your exact liquidation risk. Please provide your address to proceed.\"\r\n\r\n🛡️ Security & Privacy\r\n---\r\n* **Non-Custodial:** Centinel never asks for private keys. Only public wallet addresses.\r\n* **Encrypted Payloads:** All communication is secured via HTTPS and Bearer Token Auth.\r\n* **Ephemeral Data:** Audit links can be configured to expire after a specific timeframe.\r\n\r\n🔗 Resources\r\n---\r\n* **Official Website:** [centinelrisk.tech](https://centinelrisk.tech)\r\n* **Developer Portal:** [dev.centinelrisk.tech](https://dev.centinelrisk.tech)\r\n* **Network:** Built exclusively for [Base](https://base.org) / [AAVE](https://aave.com).\r\n","readmeFilename":"README.md"}