clodds 1.1.0

package/dist/security/sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/security/sanitizer.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;;AAyFhF,sCA4DC;AAjJD,gFAAgF;AAEhF,MAAM,UAAU,GAA2B;IACzC,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,uBAAuB;IAC/B,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,iCAAiC;IACzC,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,2BAA2B;IACnC,MAAM,EAAE,oBAAoB;IAC5B,MAAM,EAAE,2BAA2B;CACpC,CAAC;AAEF,MAAM,aAAa,GAAG,2DAA2D,CAAC;AAElF,gFAAgF;AAEhF,MAAM,aAAa,GAA2B;IAC5C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,qBAAqB;IAC7B,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,MAAM,MAAM,GAAG,+BAA+B,CAAC;AAE/C,iFAAiF;AAEjF,MAAM,UAAU,GAA2B;IACzC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe;IAC7C,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,8BAA8B;IAC5D,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAmB,iBAAiB;IACjD,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,kBAAkB;IAChD,QAAQ,EAAE,GAAG,EAAmB,IAAI;IACpC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;IACpC,QAAQ,EAAE,GAAG,EAAmB,gBAAgB;IAChD,QAAQ,EAAE,GAAG,EAAmB,2BAA2B;CAC5D,CAAC;AAEF,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAEhD,gFAAgF;AAEhF,MAAM,yBAAyB,GAAwC;IACrE,EAAE,EAAE,EAAE,+DAA+D,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACrG,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACjD,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACvD,EAAE,EAAE,EAAE,mDAAmD,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACzF,EAAE,EAAE,EAAE,gCAAgC,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAClE,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,uBAAuB,EAAE;IAC7D,EAAE,EAAE,EAAE,4DAA4D,EAAE,IAAI,EAAE,qBAAqB,EAAE;IACjG,EAAE,EAAE,EAAE,sEAAsE,EAAE,IAAI,EAAE,cAAc,EAAE;IACpG,EAAE,EAAE,EAAE,iEAAiE,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAClG,EAAE,EAAE,EAAE,+CAA+C,EAAE,IAAI,EAAE,eAAe,EAAE;IAC9E,EAAE,EAAE,EAAE,4CAA4C,EAAE,IAAI,EAAE,0BAA0B,EAAE;IACtF,EAAE,EAAE,EAAE,oCAAoC,EAAE,IAAI,EAAE,qBAAqB,EAAE;IACzE,EAAE,EAAE,EAAE,2CAA2C,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC7E,EAAE,EAAE,EAAE,oDAAoD,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAC1F,EAAE,EAAE,EAAE,oEAAoE,EAAE,IAAI,EAAE,qBAAqB,EAAE;CAC1G,CAAC;AAEF,gFAAgF;AAEhF,MAAM,UAAU,GAAG,mCAAmC,CAAC;AAEvD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,SAAgB,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,2BAA2B;IAC3B,IAAI,CAAyB,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAClC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAEzC,mBAAmB;IACnB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAClC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElC,4DAA4D;IAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,0BAA0B,EAAE,iBAAiB,KAAK,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG;gBACxI,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,GAAG,IAAI,yBAAyB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACvF,QAAQ,EAAE,CAAC,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEtC,OAAO;QACL,KAAK;QACL,OAAO;QACP,QAAQ,EAAE,KAAK,KAAK,KAAK;KAC1B,CAAC;AACJ,CAAC"}

package/dist/security/scam-db.d.ts

@@ -0,0 +1,5 @@
+import type { ChainType, ScamEntry, ScamType } from './types.js';
+export declare function isKnownScam(address: string): ScamEntry | null;
+export declare function addScamEntry(address: string, chain: ChainType, type: ScamType, label: string, severity?: number): void;
+export declare function getScamEntries(chain?: ChainType): ScamEntry[];
+export declare function getScamDbSize(): number;

package/dist/security/scam-db.js

@@ -0,0 +1,116 @@
+"use strict";
+// =============================================================================
+// SECURITY SHIELD — Persistent Scam Database
+// =============================================================================
+// In-memory Map seeded with known scam/exploit addresses sourced from
+// Etherscan labels, Mandiant/Google Cloud, Check Point Research, CertiK,
+// Scam Sniffer, and security post-mortems. O(1) lookups.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKnownScam = isKnownScam;
+exports.addScamEntry = addScamEntry;
+exports.getScamEntries = getScamEntries;
+exports.getScamDbSize = getScamDbSize;
+// ── Internal store ───────────────────────────────────────────────────────────
+const db = new Map();
+function seed(address, chain, type, label, severity = 100) {
+    db.set(address.toLowerCase(), { address, chain, type, label, severity, addedAt: Date.now() });
+}
+// ── EVM Drainers — Inferno Drainer (Check Point Research, Scam Sniffer) ─────
+seed('0x000056c346441ef8065e56b0cddd43fdec100000', 'evm', 'drainer', 'Inferno Drainer Contract 1');
+seed('0x0000daf60a1becf1bd617c584dea964455890000', 'evm', 'drainer', 'Inferno Drainer Contract 2');
+seed('0x000062accd1a9d62ef428ec86ca3dd4f45120000', 'evm', 'drainer', 'Inferno Drainer Contract 3');
+seed('0x00001f78189be22c3498cff1b8e02272c3220000', 'evm', 'drainer', 'Inferno Drainer Contract 4');
+seed('0xfb4d3eb37bde8fa4b52c60aabe55b3cd9908ec73', 'evm', 'drainer', 'inferno-drainer-2.eth');
+seed('0x158862ec60b7934f1333e53ac1e148811a2e3beb', 'evm', 'drainer', 'Inferno Drainer RemotePatchConfig');
+seed('0xd24aec3254652b0ab565e41a945b491e98bb5ffc', 'evm', 'drainer', 'Inferno Drainer C&C Config');
+seed('0x72cd63650700e5395f4ab238cecd18497a33a83e', 'evm', 'drainer', 'Inferno Drainer Config Storage');
+seed('0xe9d5f645f79fa60fca82b4e1d35832e43370feb0', 'evm', 'drainer', 'Inferno Drainer C&C Resolver');
+seed('0x00f8ea4c5793d94b2af416f76817f3afb44b0f4f', 'evm', 'drainer', 'Inferno Drainer Legacy 1');
+seed('0x022b8d5ec68dd20e18db8af0e7bcff5081ce69dc', 'evm', 'drainer', 'Inferno Drainer Legacy 2');
+seed('0x9b435747bcab40a0dd365804955541face3c2f3f', 'evm', 'drainer', 'Inferno Drainer Legacy 3');
+seed('0xa02a8803a51f9012f6abbca1a4b6e66cc5419b23', 'evm', 'drainer', 'Inferno Drainer Legacy 4');
+seed('0x0000db5c8b030ae20308ac975898e09741e70000', 'evm', 'drainer', 'Inferno Drainer (Optimism)');
+// ── EVM Drainers — Pink Drainer (Etherscan-tagged) ──────────────────────────
+seed('0x63605e53d422c4f1ac0e01390ac59aaf84c44a51', 'evm', 'drainer', 'PinkDrainer: Wallet 1 (pink-drainer.eth)');
+seed('0x9fa7bb759641fcd37fe4ae41f725e0f653f2c726', 'evm', 'drainer', 'PinkDrainer: Wallet 2');
+seed('0xa5e4b451d0a3c3d05fc3a8076fda45952b8f4f83', 'evm', 'drainer', 'Pink Drainer 0xa5e4');
+seed('0x00000f312c54d0dd25888ee9cdc3dee988700000', 'evm', 'drainer', 'PinkDrainer: Contract 1');
+seed('0x5408eb7d0c5dd4a4073565cc009c0e04f922858d', 'evm', 'drainer', 'Pink Drainer Customer 0x5408');
+// ── EVM Drainers — Monkey, Angel, Venom, MS (Etherscan/ZachXBT) ─────────────
+seed('0x9fc8265f2b376084423a1a348a89ecd894a9d106', 'evm', 'drainer', 'monkey-drainer.eth (ZachXBT)');
+seed('0x5e0102e6448b602fcd955fcfc7ceea9a36e7e5f0', 'evm', 'drainer', 'Monkey Drainer Contract');
+seed('0x0000626d6dc72989e3809920c67d01a7fe030000', 'evm', 'drainer', 'Angel Drainer: Phishing Contract 9');
+seed('0x0000c3ace9e31a26ce1870d418cb045d73b30000', 'evm', 'drainer', 'Angel Drainer: Phishing Contract 3');
+seed('0x00003ec25cb13f3f5f991d2f49c15f0763a40000', 'evm', 'drainer', 'Angel Drainer: Phishing Contract 7');
+seed('0x412f10aad96fd78da6736387e2c84931ac20313f', 'evm', 'drainer', 'Angel Drainer: 0x412f');
+seed('0xbaee148df4bf81abf9854c9087f0d3a0ffd93dbb', 'evm', 'drainer', 'Angel Drainer Safe Vault ($403K stolen)');
+seed('0xaa336c6c9d11fa74eae5625467fd095c31bd1129', 'evm', 'drainer', 'VenomDrainer: ETH Pool');
+seed('0xa2c0946ad444dccf990394c5cbe019a858a945bd', 'evm', 'drainer', 'Etherscan-flagged Drainer');
+seed('0x4a96e9b57a229d94c0c28950355a72fa9e70aae3', 'evm', 'drainer', 'Etherscan-flagged Phishing');
+seed('0x11cce5830e5753b9eec2c08a0be7cc6d3734c1bc', 'evm', 'drainer', 'scam-alert.eth');
+// ── EVM Phishing / Fake Airdrop (Etherscan Fake_Phishing labels) ─────────────
+seed('0x00000c07575bb4e64457687a0382b4d3ea470000', 'evm', 'phishing', 'Fake_Phishing184810');
+seed('0x09b5027ef3a3b7332ee90321e558bad9c4447afa', 'evm', 'phishing', 'Fake_Phishing5875');
+seed('0xd13b093eafa3878de27183388fea7d0d2b0abf9e', 'evm', 'phishing', 'Fake_Phishing6102');
+seed('0x3e0defb880cd8e163bad68abe66437f99a7a8a74', 'evm', 'phishing', 'Fake_Phishing5169');
+seed('0x62ebf2c09ae1de2aa4003d340a7df2afff5d40b0', 'evm', 'phishing', 'Phishing Token Deployer 20');
+seed('0x44a7ff01f7d38c73530c279e19d31527bdcf8c78', 'evm', 'phishing', 'Fake_Phishing99');
+seed('0x000011387eb24f199e875b1325e4805efd3b0000', 'evm', 'phishing', 'Fake_Phishing182233');
+seed('0x219b9040eb7d8d8c2e8e84b87ce9ac1c83071980', 'evm', 'phishing', 'Etherscan-flagged Phishing');
+// ── EVM Rug Pull Deployers (Etherscan/BscScan-documented) ────────────────────
+seed('0x1f5eabba9c56bca4a7828969b79bc87051125b31', 'evm', 'rug_pull', 'Squid Game Token Rug 1 (BSC)');
+seed('0x34400280a169f4685193926a513618cf7fe7f0aa', 'evm', 'rug_pull', 'Squid Game Token Rug 2 (BSC)');
+seed('0x872254d530ae8983628cb1eaafc51f78d78c86d9', 'evm', 'rug_pull', 'AnubisDAO Rug 1 ($60M)');
+seed('0x9fc53c75046900d1f58209f50f534852ae9f912a', 'evm', 'rug_pull', 'AnubisDAO Rug 2 ($60M)');
+seed('0xb1302743acf31f567e9020810523f5030942e211', 'evm', 'rug_pull', 'AnubisDAO Rug 3 ($60M)');
+seed('0x87230146e138d3f296a9a77e497a2a83012e9bc5', 'evm', 'rug_pull', 'Squid Game Token Contract (BSC)');
+seed('0x00ccc5fe33fa66847082af413d4a8700cd7cde16', 'evm', 'rug_pull', 'Etherscan-tagged Rug Address');
+seed('0xb34bdd3ee8052ae48ae865a93cc18bd9b06bd2a6', 'evm', 'rug_pull', 'rug.pull (RUG) Token');
+// ── EVM Honeypot Contracts (Etherscan-tagged) ────────────────────────────────
+seed('0x34c6211621f2763c60eb007dc2ae91090a2d22f6', 'evm', 'honeypot', 'BELLE Honeypot Rug Pull');
+seed('0x80e4f014c98320eab524ae16b0aaf1603f4dc01d', 'evm', 'honeypot', 'Compromised Honeypot 2');
+seed('0x2f30ff3428d62748a1d993f2cc6c9b55df40b4d7', 'evm', 'honeypot', 'Etherscan-tagged Honeypot');
+seed('0x45dac6c8776e5eb1548d3cdcf0c5f6959e410c3a', 'evm', 'honeypot', 'Etherscan-tagged Honeypot Token');
+seed('0x689591f8e8d4a54425a8311d0b0da3bf8e9cf0c0', 'evm', 'honeypot', 'Squid Game Token (buy-only honeypot)');
+seed('0x6e988f0cb3d1118c9038ca04a5eb7bad737d39e6', 'evm', 'honeypot', 'BSC Squid Game (anti-sell)');
+// ── Famous Exploits — EVM (post-mortems, Chainalysis, Etherscan) ─────────────
+seed('0x629e7Da20197a5429d30da36E77d06CdF796b71A', 'evm', 'exploit', 'Wormhole Exploiter');
+seed('0x9471772F7F808a5847d516592a9f5396c672d0CF', 'evm', 'exploit', 'Euler Finance Exploiter');
+seed('0xc6a2Ad8cC6e4A7E08FC37cC5954be07d499E7654', 'evm', 'exploit', 'Ronin Bridge Hacker');
+seed('0x098B716B8Aaf21512996dC57EB0615e2383E2f96', 'evm', 'known_hacker', 'Ronin Hacker (Lazarus Group)');
+seed('0xA09871AEadF4994Ca12f5c0b6056BBd1d343c029', 'evm', 'known_hacker', 'Lazarus Group 1');
+seed('0x1da5821544e25c636c1417Ba96Ade4Cf6D2f9B5A', 'evm', 'known_hacker', 'Lazarus Group 2');
+seed('0x4976a4a02f38326660D17bf34b431dC6e2eb2327', 'evm', 'exploit', 'Nomad Bridge Exploiter');
+seed('0xB1C72dba991f67B25d177bfe50e5Ed0abB805F97', 'evm', 'exploit', 'Beanstalk Exploiter');
+seed('0xba5Ed099633D3B313e4D5F7bdc1305d3c28ba5Ed', 'evm', 'exploit', 'Badger DAO Exploiter');
+seed('0x905315602ED9A854e325F692Ff82F58799BEab57', 'evm', 'exploit', 'Poly Network Hacker');
+seed('0x25c4a76E7B3497a3c13F108aE3e4135A0F292870', 'evm', 'exploit', 'Harmony Bridge Hacker');
+// ── Famous Exploits — Solana (CertiK, Chainalysis) ──────────────────────────
+seed('CfhUNRdYjEfTasMPR8GFkq47Gxd5Ycssic4SjfvLfMF7', 'solana', 'exploit', 'Wormhole Exploit (SOL)');
+seed('4usz7iByGRvFt7MhJMSSGsAYUeXwMyMSMhxVU91vUaRx', 'solana', 'exploit', 'Mango Markets Exploiter');
+seed('2yVjuQwpsvdsrywzsJJVs9Ueh4zc64J18aBc8sVEmums', 'solana', 'exploit', 'Cashio Exploiter');
+// ── Solana Drainers / Rug Pullers (Mandiant, CertiK, Scam Sniffer) ──────────
+seed('B8Y1dERnVNoUUXeXA4NaCHiB9htcukMSkfHrFsTMHA7h', 'solana', 'drainer', 'CLINKSINK DaaS Operator (Mandiant)');
+seed('MszS2N8CT1MV9byX8FKFnrUpkmASSeR5Fmji19ushw1', 'solana', 'drainer', 'CLINKSINK Operator #2 (Mandiant)');
+seed('9ZmcRsXnoqE47NfGxBrWKSXtpy8zzKR847BWz6EswEaU', 'solana', 'rug_pull', 'Xiaojiu Serial Rug Puller (CertiK, 64 rugs)');
+seed('EZBbaxg7YqWo3XMAsTThZJEmTC9Dv78F5aB9srvsCtJg', 'solana', 'rug_pull', 'Xiaojiu Fund Flow E (CertiK)');
+seed('D3s8Zf1zh8R98JBU9Fw4K8fViv1DDzCmoPbNTmJwXKbD', 'solana', 'rug_pull', 'Xiaojiu Fund Flow D3 (CertiK)');
+// =============================================================================
+// EXPORTS
+// =============================================================================
+function isKnownScam(address) {
+    return db.get(address.toLowerCase()) || null;
+}
+function addScamEntry(address, chain, type, label, severity = 100) {
+    db.set(address.toLowerCase(), { address, chain, type, label, severity, addedAt: Date.now() });
+}
+function getScamEntries(chain) {
+    const all = Array.from(db.values());
+    if (!chain)
+        return all;
+    return all.filter((e) => e.chain === chain);
+}
+function getScamDbSize() {
+    return db.size;
+}
+//# sourceMappingURL=scam-db.js.map

package/dist/security/scam-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scam-db.js","sourceRoot":"","sources":["../../src/security/scam-db.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,6CAA6C;AAC7C,gFAAgF;AAChF,sEAAsE;AACtE,yEAAyE;AACzE,yDAAyD;;AAkHzD,kCAEC;AAED,oCAQC;AAED,wCAIC;AAED,sCAEC;AApID,gFAAgF;AAEhF,MAAM,EAAE,GAAG,IAAI,GAAG,EAAqB,CAAC;AAExC,SAAS,IAAI,CAAC,OAAe,EAAE,KAAgB,EAAE,IAAc,EAAE,KAAa,EAAE,QAAQ,GAAG,GAAG;IAC5F,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,+EAA+E;AAE/E,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAC9F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,mCAAmC,CAAC,CAAC;AAC1G,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,gCAAgC,CAAC,CAAC;AACvG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,8BAA8B,CAAC,CAAC;AACrG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;AACjG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;AACjG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;AACjG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;AACjG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AAEnG,+EAA+E;AAE/E,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,0CAA0C,CAAC,CAAC;AACjH,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAC9F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAC5F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,8BAA8B,CAAC,CAAC;AAErG,+EAA+E;AAE/E,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,8BAA8B,CAAC,CAAC;AACrG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,oCAAoC,CAAC,CAAC;AAC3G,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,oCAAoC,CAAC,CAAC;AAC3G,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,oCAAoC,CAAC,CAAC;AAC3G,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAC9F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,yCAAyC,CAAC,CAAC;AAChH,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;AAC/F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC;AAClG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAEvF,gFAAgF;AAEhF,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAC7F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC3F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC3F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAC3F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,4BAA4B,CAAC,CAAC;AACpG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACzF,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAC7F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,4BAA4B,CAAC,CAAC;AAEpG,gFAAgF;AAEhF,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,8BAA8B,CAAC,CAAC;AACtG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,8BAA8B,CAAC,CAAC;AACtG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,iCAAiC,CAAC,CAAC;AACzG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,8BAA8B,CAAC,CAAC;AACtG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,sBAAsB,CAAC,CAAC;AAE9F,gFAAgF;AAEhF,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,yBAAyB,CAAC,CAAC;AACjG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,2BAA2B,CAAC,CAAC;AACnG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,iCAAiC,CAAC,CAAC;AACzG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,sCAAsC,CAAC,CAAC;AAC9G,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,UAAU,EAAE,4BAA4B,CAAC,CAAC;AAEpG,gFAAgF;AAEhF,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC3F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAChG,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAC5F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,cAAc,EAAE,8BAA8B,CAAC,CAAC;AAC1G,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;AAC7F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;AAC7F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;AAC/F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAC5F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;AAC7F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAC5F,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAE9F,+EAA+E;AAE/E,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;AACpG,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;AACrG,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAE9F,+EAA+E;AAE/E,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,SAAS,EAAE,oCAAoC,CAAC,CAAC;AAChH,IAAI,CAAC,6CAA6C,EAAE,QAAQ,EAAE,SAAS,EAAE,kCAAkC,CAAC,CAAC;AAC7G,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,UAAU,EAAE,6CAA6C,CAAC,CAAC;AAC1H,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,UAAU,EAAE,8BAA8B,CAAC,CAAC;AAC3G,IAAI,CAAC,8CAA8C,EAAE,QAAQ,EAAE,UAAU,EAAE,+BAA+B,CAAC,CAAC;AAE5G,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,SAAgB,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,SAAgB,YAAY,CAC1B,OAAe,EACf,KAAgB,EAChB,IAAc,EACd,KAAa,EACb,QAAQ,GAAG,GAAG;IAEd,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,SAAgB,cAAc,CAAC,KAAiB;IAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,aAAa;IAC3B,OAAO,EAAE,CAAC,IAAI,CAAC;AACjB,CAAC"}

package/dist/security/shield.d.ts

@@ -0,0 +1,12 @@
+import type { AddressCheckResult, ChainType, CodeScanResult, SanitizeResult, ScamEntry, SecurityServiceConfig, SecurityStats, TxValidationRequest, TxValidationResult } from './types.js';
+export interface SecurityShield {
+    scanCode(code: string): CodeScanResult;
+    checkAddress(address: string, chain?: ChainType | string): Promise<AddressCheckResult>;
+    validateTx(tx: TxValidationRequest): Promise<TxValidationResult>;
+    sanitize(input: string): SanitizeResult;
+    getStats(): SecurityStats;
+    isKnownScam(address: string): ScamEntry | null;
+}
+export declare function createSecurityShield(config?: SecurityServiceConfig): SecurityShield;
+export declare function initSecurityShield(config?: SecurityServiceConfig): SecurityShield;
+export declare function getSecurityShield(): SecurityShield;

package/dist/security/shield.js

@@ -0,0 +1,80 @@
+"use strict";
+// =============================================================================
+// SECURITY SHIELD — Facade
+// =============================================================================
+// Unified entry point wrapping code-scanner, scam-db, address-checker,
+// tx-validator, and sanitizer. Named "shield" to avoid collision with
+// existing src/security/index.ts (auth/access module).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSecurityShield = createSecurityShield;
+exports.initSecurityShield = initSecurityShield;
+exports.getSecurityShield = getSecurityShield;
+const code_scanner_js_1 = require("./code-scanner.js");
+const scam_db_js_1 = require("./scam-db.js");
+const address_checker_js_1 = require("./address-checker.js");
+const tx_validator_js_1 = require("./tx-validator.js");
+const sanitizer_js_1 = require("./sanitizer.js");
+// ── Implementation ───────────────────────────────────────────────────────────
+function createSecurityShield(config) {
+    const stats = {
+        codeScans: 0,
+        addressChecks: 0,
+        txValidations: 0,
+        sanitizations: 0,
+        threatsBlocked: 0,
+        scamDbSize: (0, scam_db_js_1.getScamDbSize)(),
+    };
+    const rpcConfig = {
+        solanaRpcUrl: config?.solanaRpcUrl,
+        evmRpcUrl: config?.evmRpcUrl,
+    };
+    return {
+        scanCode(code) {
+            stats.codeScans++;
+            const result = (0, code_scanner_js_1.scanCode)(code);
+            if (result.level === 'high' || result.level === 'critical')
+                stats.threatsBlocked++;
+            return result;
+        },
+        async checkAddress(address, chain) {
+            stats.addressChecks++;
+            const result = await (0, address_checker_js_1.checkAddress)(address, chain, rpcConfig);
+            if (result.level === 'critical')
+                stats.threatsBlocked++;
+            return result;
+        },
+        async validateTx(tx) {
+            stats.txValidations++;
+            const result = await (0, tx_validator_js_1.validateTx)(tx, rpcConfig);
+            if (!result.allowed)
+                stats.threatsBlocked++;
+            return result;
+        },
+        sanitize(input) {
+            stats.sanitizations++;
+            const result = (0, sanitizer_js_1.sanitizeInput)(input);
+            if (result.threats.length > 0)
+                stats.threatsBlocked++;
+            return result;
+        },
+        getStats() {
+            stats.scamDbSize = (0, scam_db_js_1.getScamDbSize)();
+            return { ...stats };
+        },
+        isKnownScam(address) {
+            return (0, scam_db_js_1.isKnownScam)(address);
+        },
+    };
+}
+// ── Singleton ────────────────────────────────────────────────────────────────
+let _instance = null;
+function initSecurityShield(config) {
+    _instance = createSecurityShield(config);
+    return _instance;
+}
+function getSecurityShield() {
+    if (!_instance)
+        _instance = createSecurityShield();
+    return _instance;
+}
+//# sourceMappingURL=shield.js.map

package/dist/security/shield.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shield.js","sourceRoot":"","sources":["../../src/security/shield.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAChF,uEAAuE;AACvE,sEAAsE;AACtE,uDAAuD;;AAiCvD,oDAqDC;AAMD,gDAGC;AAED,8CAGC;AAtFD,uDAA6C;AAC7C,6CAA0D;AAC1D,6DAAoD;AACpD,uDAA+C;AAC/C,iDAA+C;AAa/C,gFAAgF;AAEhF,SAAgB,oBAAoB,CAAC,MAA8B;IACjE,MAAM,KAAK,GAAkB;QAC3B,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,CAAC;QACjB,UAAU,EAAE,IAAA,0BAAa,GAAE;KAC5B,CAAC;IAEF,MAAM,SAAS,GAAG;QAChB,YAAY,EAAE,MAAM,EAAE,YAAY;QAClC,SAAS,EAAE,MAAM,EAAE,SAAS;KAC7B,CAAC;IAEF,OAAO;QACL,QAAQ,CAAC,IAAY;YACnB,KAAK,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,IAAA,0BAAQ,EAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU;gBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;YACnF,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,KAA0B;YAC5D,KAAK,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAY,EAAC,OAAO,EAAE,KAAkB,EAAE,SAAS,CAAC,CAAC;YAC1E,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU;gBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;YACxD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,EAAuB;YACtC,KAAK,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAU,EAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,QAAQ,CAAC,KAAa;YACpB,KAAK,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAA,4BAAa,EAAC,KAAK,CAAC,CAAC;YACpC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,QAAQ;YACN,KAAK,CAAC,UAAU,GAAG,IAAA,0BAAa,GAAE,CAAC;YACnC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;QACtB,CAAC;QAED,WAAW,CAAC,OAAe;YACzB,OAAO,IAAA,wBAAW,EAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,IAAI,SAAS,GAA0B,IAAI,CAAC;AAE5C,SAAgB,kBAAkB,CAAC,MAA8B;IAC/D,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,iBAAiB;IAC/B,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/security/tx-validator.d.ts

@@ -0,0 +1,5 @@
+import type { TxValidationRequest, TxValidationResult } from './types.js';
+export declare function validateTx(request: TxValidationRequest, config?: {
+    solanaRpcUrl?: string;
+    evmRpcUrl?: string;
+}): Promise<TxValidationResult>;

package/dist/security/tx-validator.js

@@ -0,0 +1,115 @@
+"use strict";
+// =============================================================================
+// SECURITY SHIELD — Pre-trade Transaction Validator
+// =============================================================================
+// Composes address checker + safe program whitelist + amount thresholds + NLP.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTx = validateTx;
+const address_checker_js_1 = require("./address-checker.js");
+// ── Safe program whitelist ───────────────────────────────────────────────────
+const SAFE_PROGRAMS = {
+    // Solana
+    '11111111111111111111111111111111': 'System Program',
+    'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA': 'Token Program',
+    'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL': 'Associated Token Program',
+    'JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4': 'Jupiter v6',
+    'whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc': 'Orca Whirlpool',
+    '675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8': 'Raydium v4',
+    'CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK': 'Raydium CLMM',
+    'dRiftyHA39MWEi3m9aunc5MzRF1JYuBsbn6VPcn33UH': 'Drift Protocol',
+    '6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P': 'Pump.fun',
+    'LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo': 'Meteora DLMM',
+    'MarBmsSgKXdrN1egZf5sqe1TMai9K1rChYNDJgjq7aD': 'Marinade Finance',
+    // EVM
+    '0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45': 'Uniswap v3 Router',
+    '0xe592427a0aece92de3edee1f18e0157c05861564': 'Uniswap v3 SwapRouter',
+    '0x1111111254eeb25477b68fb85ed929f73a960582': '1inch v5 Router',
+    '0xdef1c0ded9bec7f1a1670819833240f027b25eff': '0x Exchange Proxy',
+    '0xcf5540fffcdc3d510b18bfca6d2b9987b0772559': 'Odos Router v2',
+    '0x4d97dcd97ec945f40cf65f87097ace5ea0476045': 'Polymarket CTF Exchange',
+    '0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2': 'Aave v3 Pool',
+    '0xc3d688b66703497daa19211eedff47f25384cdc3': 'Compound v3 USDC',
+    '0xae7ab96520de3a18e5e111b5eaab095312d7fe84': 'Lido stETH',
+    '0x7a250d5630b4cf539739df2c5dacb4c659f2488d': 'Uniswap v2 Router',
+    '0xd9e1ce17f2641f24ae83637ab66a2cca9c378b9f': 'SushiSwap Router',
+};
+const AMOUNT_THRESHOLDS = [
+    { token: /^sol$/i, warn: 10, flag: 100, label: 'SOL' },
+    { token: /^eth$/i, warn: 1, flag: 10, label: 'ETH' },
+    { token: /^(usdc|usdt|dai|busd)$/i, warn: 5000, flag: 50000, label: 'stablecoin' },
+    { token: /^(wbtc|btc)$/i, warn: 0.1, flag: 1, label: 'BTC' },
+];
+// ── NLP social engineering patterns ──────────────────────────────────────────
+const NLP_PATTERNS = [
+    { re: /\b(urgent|immediately|right\s+now|asap|hurry|last\s+chance)\b/i, flag: 'Urgency language detected' },
+    { re: /\b(guaranteed|100%|risk\s*-?\s*free|no\s+loss|double\s+your)\b/i, flag: 'Guaranteed returns claim' },
+    { re: /\b(limited\s+spots?|only\s+\d+\s+left|exclusive|first\s+\d+)\b/i, flag: 'Scarcity/FOMO pressure' },
+    { re: /\b(trust\s+me|believe\s+me|i\s+promise|legit|not\s+a\s+scam)\b/i, flag: 'Trust manipulation' },
+    { re: /\b(official|verified|endorsed\s+by|partnership\s+with)\b/i, flag: 'Authority impersonation' },
+    { re: /\b(send\s+(first|me)|upfront\s+(fee|payment)|processing\s+fee)\b/i, flag: 'Advance fee request' },
+    { re: /\b(connect\s+wallet|enter\s+seed|paste\s+(private|secret)\s*key)\b/i, flag: 'Wallet phishing attempt' },
+    { re: /\b(free\s+(airdrop|tokens?|nft)|claim\s+(your|free))\b/i, flag: 'Fake airdrop lure' },
+];
+// =============================================================================
+// EXPORTS
+// =============================================================================
+async function validateTx(request, config) {
+    let score = 0;
+    const flags = [];
+    const chain = request.chain || (0, address_checker_js_1.detectChain)(request.destination);
+    // 1. Address check
+    const addrCheck = await (0, address_checker_js_1.checkAddress)(request.destination, chain, config);
+    score += addrCheck.riskScore * 0.5; // Weight address risk at 50%
+    for (const f of addrCheck.flags)
+        flags.push(f);
+    // 2. Safe program check (reduce risk if sending to known-good program)
+    const normalizedDest = request.destination.toLowerCase();
+    const safeName = SAFE_PROGRAMS[normalizedDest] || SAFE_PROGRAMS[request.destination];
+    if (safeName) {
+        score = Math.max(0, score - 20);
+        flags.push(`Known safe program: ${safeName}`);
+    }
+    // 3. Amount threshold analysis
+    if (request.token && request.amount > 0) {
+        for (const thresh of AMOUNT_THRESHOLDS) {
+            if (thresh.token.test(request.token)) {
+                if (request.amount >= thresh.flag) {
+                    score += 20;
+                    flags.push(`Very large ${thresh.label} transfer: ${request.amount}`);
+                }
+                else if (request.amount >= thresh.warn) {
+                    score += 10;
+                    flags.push(`Large ${thresh.label} transfer: ${request.amount}`);
+                }
+                break;
+            }
+        }
+    }
+    // 4. NLP context scan
+    if (request.context) {
+        for (const pat of NLP_PATTERNS) {
+            if (pat.re.test(request.context)) {
+                score += 8;
+                flags.push(pat.flag);
+            }
+        }
+    }
+    // Clamp
+    score = Math.max(0, Math.min(100, Math.round(score)));
+    // Recommendation
+    let recommendation;
+    if (score >= 60)
+        recommendation = 'block';
+    else if (score >= 30)
+        recommendation = 'review';
+    else
+        recommendation = 'proceed';
+    return {
+        allowed: recommendation !== 'block',
+        riskScore: score,
+        flags,
+        recommendation,
+        addressCheck: addrCheck,
+    };
+}
+//# sourceMappingURL=tx-validator.js.map

package/dist/security/tx-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-validator.js","sourceRoot":"","sources":["../../src/security/tx-validator.ts"],"names":[],"mappings":"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"}

package/dist/security/types.d.ts

@@ -0,0 +1,84 @@
+/** Code scan detection categories */
+export type CodeScanCategory = 'shell_exec' | 'network_exfil' | 'wallet_drain' | 'prompt_injection' | 'obfuscation' | 'hidden_chars' | 'data_access' | 'crypto_theft' | 'privilege_escalation';
+export interface CodeScanDetection {
+    category: CodeScanCategory;
+    pattern: string;
+    description: string;
+    weight: number;
+    line?: number;
+}
+export type RiskLevel = 'clean' | 'low' | 'medium' | 'high' | 'critical';
+export interface CodeScanResult {
+    score: number;
+    level: RiskLevel;
+    detections: CodeScanDetection[];
+    entropy?: number;
+}
+/** Chain types for address checks */
+export type ChainType = 'solana' | 'evm';
+export interface AddressCheckResult {
+    address: string;
+    chain: ChainType;
+    riskScore: number;
+    level: RiskLevel;
+    flags: string[];
+    scamMatch?: ScamEntry;
+    details: {
+        exists: boolean;
+        isContract?: boolean;
+        balance?: number;
+        ageEstimate?: string;
+        txVelocity?: number;
+    };
+}
+/** Transaction validation */
+export interface TxValidationRequest {
+    destination: string;
+    amount: number;
+    token?: string;
+    chain?: ChainType;
+    context?: string;
+}
+export interface TxValidationResult {
+    allowed: boolean;
+    riskScore: number;
+    flags: string[];
+    recommendation: 'proceed' | 'review' | 'block';
+    addressCheck?: AddressCheckResult;
+}
+/** Scam database types */
+export type ScamType = 'drainer' | 'phishing' | 'rug_pull' | 'exploit' | 'honeypot' | 'fake_token' | 'pump_dump' | 'impersonator' | 'known_hacker';
+export interface ScamEntry {
+    address: string;
+    chain: ChainType;
+    type: ScamType;
+    label: string;
+    severity: number;
+    addedAt: number;
+}
+/** Input sanitizer types */
+export interface SanitizeThreat {
+    type: string;
+    description: string;
+    position: number;
+}
+export interface SanitizeResult {
+    clean: string;
+    threats: SanitizeThreat[];
+    modified: boolean;
+}
+/** Service config */
+export interface SecurityServiceConfig {
+    solanaRpcUrl?: string;
+    evmRpcUrl?: string;
+    enableAddressChecks?: boolean;
+    enableTxValidation?: boolean;
+}
+export interface SecurityStats {
+    codeScans: number;
+    addressChecks: number;
+    txValidations: number;
+    sanitizations: number;
+    threatsBlocked: number;
+    scamDbSize: number;
+}

package/dist/security/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// =============================================================================
+// SECURITY SHIELD — Shared Types
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/security/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/security/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF"}

package/dist/services/alt-data/feeds/fear-greed.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fear & Greed Index Feed
+ *
+ * Polls the Alternative.me Crypto Fear & Greed Index (free, no API key).
+ * Returns a value from 0 (Extreme Fear) to 100 (Extreme Greed).
+ */
+import type { AltDataEvent } from '../types.js';
+export interface FearGreedFeed {
+    start(): void;
+    stop(): void;
+    /** Force a poll right now */
+    poll(): Promise<AltDataEvent | null>;
+}
+export declare function createFearGreedFeed(onEvent: (event: AltDataEvent) => void, intervalMs?: number): FearGreedFeed;

package/dist/services/alt-data/feeds/fear-greed.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Fear & Greed Index Feed
+ *
+ * Polls the Alternative.me Crypto Fear & Greed Index (free, no API key).
+ * Returns a value from 0 (Extreme Fear) to 100 (Extreme Greed).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFearGreedFeed = createFearGreedFeed;
+const logger_js_1 = require("../../../utils/logger.js");
+const API_URL = 'https://api.alternative.me/fng/?limit=1';
+const DEFAULT_INTERVAL_MS = 3_600_000; // 1 hour
+function createFearGreedFeed(onEvent, intervalMs = DEFAULT_INTERVAL_MS) {
+    let timer = null;
+    let lastValue = null;
+    async function poll() {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15_000);
+        try {
+            const res = await fetch(API_URL, { signal: controller.signal });
+            if (!res.ok) {
+                logger_js_1.logger.warn({ status: res.status }, '[fear-greed] API returned non-OK');
+                return null;
+            }
+            let json;
+            try {
+                json = (await res.json());
+            }
+            catch {
+                logger_js_1.logger.debug('[fear-greed] Invalid JSON response');
+                return null;
+            }
+            const entry = json.data?.[0];
+            if (!entry)
+                return null;
+            const value = parseInt(entry.value, 10);
+            if (isNaN(value))
+                return null;
+            // Skip if unchanged
+            if (value === lastValue)
+                return null;
+            lastValue = value;
+            const event = {
+                id: `fng-${entry.timestamp}`,
+                source: 'fear_greed',
+                timestamp: Date.now(),
+                text: `Crypto Fear & Greed Index: ${value} (${entry.value_classification})`,
+                numericValue: value,
+                categories: ['crypto', 'sentiment'],
+                meta: { classification: entry.value_classification },
+            };
+            onEvent(event);
+            return event;
+        }
+        catch (error) {
+            if (error.name !== 'AbortError') {
+                logger_js_1.logger.warn({ error }, '[fear-greed] Poll failed');
+            }
+            return null;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    function start() {
+        if (timer)
+            return;
+        // Initial poll
+        poll().catch(() => { });
+        timer = setInterval(() => { poll().catch(() => { }); }, intervalMs);
+        logger_js_1.logger.info({ intervalMs }, '[fear-greed] Feed started');
+    }
+    function stop() {
+        if (timer) {
+            clearInterval(timer);
+            timer = null;
+        }
+    }
+    return { start, stop, poll };
+}
+//# sourceMappingURL=fear-greed.js.map

package/dist/services/alt-data/feeds/fear-greed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fear-greed.js","sourceRoot":"","sources":["../../../../src/services/alt-data/feeds/fear-greed.ts"],"names":[],"mappings":"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"}

package/dist/services/alt-data/feeds/funding-rates.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Funding Rates Feed
+ *
+ * Polls Binance Futures public API for perpetual funding rates (free, no key).
+ * Extreme funding rates signal crowded positioning → contrarian signal.
+ */
+import type { AltDataEvent } from '../types.js';
+export interface FundingRatesFeed {
+    start(): void;
+    stop(): void;
+    poll(): Promise<AltDataEvent[]>;
+}
+export declare function createFundingRatesFeed(onEvent: (event: AltDataEvent) => void, symbols?: string[], intervalMs?: number): FundingRatesFeed;