keeperagent/crypto-key-guard

Was macht crypto-key-guard?

Erkennt, schwärzt und blockiert Krypto-Private-Keys und Seed-Phrasen in Text. Verhindert, dass sensible Geheimnisse an LLMs, KI-Agenten, Logs und externe Dienste gelangen.

Funktionen

• Erkennung – Identifiziert Private-Keys und Seed-Phrasen aus den gängigsten Kryptowährungen (Bitcoin, Ethereum, Solana, Litecoin, Dogecoin, Ripple, Stellar, Cosmos, Polkadot, Tezos, Horizen, Zcash, Tron, Cardano, Monero, Algorand, Bitcoin SV, EOS, Internet Computer, Neo, VeChain, Theta).
• Schwärzung – Ersetzt erkannte Keys und Phrasen durch einen Platzhalter (z. B. [REDACTED_KEY] oder [REDACTED_SEED]), sodass der umgebende Text lesbar bleibt.
• Blockierung – Unterbindet die Verarbeitung von Nachrichten, die erkannte Keys enthalten, und gibt eine Fehlermeldung aus.
• Flexible Modi – Wählbar zwischen Schwärzungs- oder Blockierungsmodus je nach Sicherheitsanforderung.
• Umfassender Schutz – Unterstützt Erkennung von:
  • Private-Keys (Base58, Hex, Bech32, und andere Formate)
  • BIP39-Mnemonik-Seed-Phrasen (12, 18, 24 Wörter)
  • Unverschlüsselte Keystore-Dateien (JSON)
• Einfache Integration – Keine externen Abhängigkeiten außer Node.js; keine API-Schlüssel erforderlich.

Verwendung

Installation

npm install @keeperagent/crypto-key-guard

Einfache Erkennung

const { detect, redact, block } = require('@keeperagent/crypto-key-guard');

const text = 'Mein privater Schlüssel ist 5KQwrPbwL4QH3h4f8W3f3f9W3f3f9W3f3f9W3f3f9W3f';

// Prüfen, ob ein Key vorhanden ist
if (detect(text)) {
  console.log('Private Key gefunden!');
}

// Schwärzen
const redacted = redact(text);
console.log(redacted);
// Ausgabe: 'Mein privater Schlüssel ist [REDACTED_KEY]'

// Blockieren
block(text); // Wirft einen Fehler: 'Private-Key erkannt: Verarbeitung blockiert'

Integration in KI-Agenten

Claude Code

const { redact } = require('@keeperagent/crypto-key-guard');

async function requestLLM(prompt) {
  // Vor Verarbeitung durch den Agenten schwärzen
  const safePrompt = redact(prompt);
  // Sende safePrompt an Claude Code
  const response = await claude.send(safePrompt);
  return response;
}

Cursor

Verwende die integrierte Pre-Processing-Funktion:

// config.js
const { redact } = require('@keeperagent/crypto-key-guard');

module.exports = {
  preProcessPrompt: (prompt) => redact(prompt)
};

Codex

const { block } = require('@keeperagent/crypto-key-guard');

// Im Prompt-Handler vor dem Senden an Codex
app.use('/api/codex', (req, res, next) => {
  try {
    block(req.body.prompt);
    next();
  } catch (e) {
    res.status(400).json({ error: e.message });
  }
});

Konfiguration

Optional können Erkennungs- und Verarbeitungsregeln angepasst werden:

const guard = require('@keeperagent/crypto-key-guard');
guard.configure({
  mode: 'block',           // 'redact' oder 'block'
  keys: true,              // Private-Keys erkennen
  seeds: true,             // Seed-Phrasen erkennen
  keystore: false,         // Keystore-Dateien erkennen (standardmäßig deaktiviert)
  placeholder: '[REDACTED]' // Benutzerdefinierter Platzhalter
});

Unterstützte Formate

Typ	Beispiele
Bitcoin	5KQwrPbwL4QH3h4f..., 1A1zP1eP5QGefi2D...
Ethereum	0x742d35Cc6634C0532925a3b844Bc...
Solana	4vU4M7Q5n6c5...
Seed-Phrasen	abandon ability able about above absent absorb abstract absurd abuse access accident account accuse achieve
Litecoin	LcLq7F7...
Dogecoin	D9dX8...

Warnung

Sicherheitswarnung: Dieser Skill ersetzt nicht die ordnungsgemäße Verwaltung von Krypto-Keys. Er dient als zusätzliche Schutzschicht für KI-Umgebungen, in denen versehentliches Leaken möglich ist. Bewahre Private-Keys niemals im Klartext in Code, Logs oder Konversationen auf.