@quantabit/security-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuantaBit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# @quantabit/security-sdk
+
+> QuantaBit Security & Risk Control SDK - Risk detection, device fingerprinting, and verification challenges
+
+## 📦 Installation
+
+```bash
+npm install @quantabit/security-sdk
+# or
+yarn add @quantabit/security-sdk
+```
+
+## 🚀 Quick Start
+
+### 1. Setup Provider
+
+```jsx
+import { SecurityProvider } from "@quantabit/security-sdk";
+import "@quantabit/security-sdk/styles.css";
+
+function App() {
+  return (
+    <SecurityProvider
+      apiUrl="https://api.example.com/v1"
+      token="your-auth-token"
+      onRiskDetected={(risk) => console.log("Risk detected:", risk)}
+      onBlocked={(result) => console.log("Action blocked:", result)}
+    >
+      <YourComponent />
+    </SecurityProvider>
+  );
+}
+```
+
+### 2. Risk Detection
+
+```jsx
+import { useSecurity } from "@quantabit/security-sdk";
+
+function PaymentButton() {
+  const { checkRisk, verificationRequired } = useSecurity();
+
+  const handlePayment = async () => {
+    const result = await checkRisk("payment", { amount: 1000 });
+
+    if (result.allowed) {
+      // Proceed with payment
+      processPayment();
+    } else if (result.verification) {
+      // Verification required, modal will show automatically
+    } else {
+      // Blocked
+      alert(result.reason);
+    }
+  };
+
+  return <button onClick={handlePayment}>Pay</button>;
+}
+```
+
+### 3. Using Components
+
+```jsx
+import { RiskBadge, VerificationModal } from "@quantabit/security-sdk";
+
+// Risk level badge
+<RiskBadge level="medium" />;
+
+// Verification modal
+{
+  verificationRequired && (
+    <VerificationModal
+      type={verificationRequired}
+      onSuccess={() => continueAction()}
+      onCancel={() => cancelAction()}
+    />
+  );
+}
+```
+
+### 4. Encryption Tools
+
+```javascript
+import {
+  sha256,
+  encryptAES,
+  decryptAES,
+  getFingerprint,
+} from "@quantabit/security-sdk";
+
+// SHA256 hash
+const hash = await sha256("data");
+
+// AES encrypt/decrypt
+const encrypted = await encryptAES("plaintext", key);
+const decrypted = await decryptAES(encrypted, key);
+
+// Get device fingerprint
+const fingerprint = await getFingerprint();
+```
+
+## 🛡️ Risk Levels
+
+```javascript
+import { RiskLevel } from "@quantabit/security-sdk";
+
+RiskLevel.LOW; // Low risk - Allow
+RiskLevel.MEDIUM; // Medium risk - May require verification
+RiskLevel.HIGH; // High risk - Verification required
+RiskLevel.CRITICAL; // Critical risk - Block
+```
+
+## 📄 License
+
+MIT License
+
+
+
+---
+
+## 🌐 Brand & Links
+- Official Mainnet: [QuantaBit Chain](https://qbitchain.io/)
+- Developer Platform: [Developer Platform](https://developer.quantabit.io/)
+- Open Platform: [Open Platform](https://open.quantabit.io/)
+- Payment Platform: [Pay Platform](https://pay.qbitwallet.io/)
+- Feedback: [Feedback](https://xwin.live/qbit)