@private.me/xbind 1.2.15 → 1.2.17

package/dist-standalone/cjs/security-policy.js

@@ -16,10 +16,12 @@ exports.describeSecurityModeStructured = describeSecurityModeStructured;
  * Default security policy for basic XBind.
  *
  * Rules:
- * - Transfers over $100,000: High security (3 shares, 2-of-3 threshold)
- * - Cross-entity communication: High security (3 shares, 2-of-3 threshold)
- * - Explicit 'high' override: High security (3 shares, 2-of-3 threshold)
- * - Explicit 'critical' override: Critical security (5 shares, 3-of-5 threshold)
+ * - Explicit risk tags: low → 2-of-2, medium → 2-of-3, high/critical → 3-of-5
+ * - Fiat transfers: USD/EUR/GBP >$100k → 2-of-3, >$1M → 3-of-5
+ * - Crypto transfers: Require explicit risk tag (no numeric auto-detection)
+ * - Sensitive scopes: custody/admin/settlement → 2-of-3
+ * - Cross-entity communication: 2-of-3
+ * - Explicit 'high' override: 2-of-3, 'critical' override: 3-of-5
  * - Everything else: Standard encrypted transport (V3 hybrid PQ)
  *
  * Enterprise and Government variants extend this with custom rules.
@@ -31,6 +33,7 @@ class DefaultSecurityPolicy {
      *
      * @param options - Optional configuration
      * @param options.highValueThreshold - Amount threshold for high security (default: 100000)
+     * @param options.criticalValueThreshold - Amount threshold for critical security (default: 1000000)
      * @param options.enableXchange - Allow Xchange mode for performance (default: false)
      */
     constructor(options = {}) {
@@ -38,7 +41,8 @@ class DefaultSecurityPolicy {
     }
     classify(context) {
         const { action, params, securityOverride } = context;
-        const threshold = this.options.highValueThreshold ?? 100_000;
+        const highThreshold = this.options.highValueThreshold ?? 100_000;
+        const criticalThreshold = this.options.criticalValueThreshold ?? 1_000_000;
         // Explicit override: critical
         if (securityOverride === 'critical') {
             return {
@@ -63,15 +67,52 @@ class DefaultSecurityPolicy {
                 wasOverridden: true,
             };
         }
-        // Auto-detection: High-value transfer
-        if ((action === 'transfer' || action === 'execute') &&
-            typeof params.amount === 'number' &&
-            params.amount > threshold) {
-            return {
-                mode: { type: 'split', shares: 3, threshold: 2 },
-                reason: `High-value transfer ($${params.amount.toLocaleString()}) requires multi-party approval (2 of 3)`,
-                wasOverridden: false,
-            };
+        // Risk tag detection (preferred for crypto: BTC, ETH, etc.)
+        const riskTag = typeof params.risk === 'string' ? params.risk.toLowerCase() : undefined;
+        if (riskTag) {
+            if (riskTag === 'critical' || riskTag === 'high') {
+                return {
+                    mode: { type: 'split', shares: 5, threshold: 3 },
+                    reason: `Explicit risk tag "${riskTag}" requires 3-of-5 threshold`,
+                    wasOverridden: false,
+                };
+            }
+            else if (riskTag === 'medium') {
+                return {
+                    mode: { type: 'split', shares: 3, threshold: 2 },
+                    reason: `Explicit risk tag "medium" requires 2-of-3 threshold`,
+                    wasOverridden: false,
+                };
+            }
+            else if (riskTag === 'low') {
+                return {
+                    mode: { type: 'split', shares: 2, threshold: 2 },
+                    reason: `Explicit risk tag "low" requires 2-of-2 threshold`,
+                    wasOverridden: false,
+                };
+            }
+        }
+        // Numeric thresholds ONLY for fiat currencies (USD, EUR, GBP)
+        // Crypto (BTC, ETH) should use risk tags instead
+        if ((action === 'transfer' || action === 'execute') && typeof params.amount === 'number') {
+            const currency = typeof params.currency === 'string' ? params.currency.toUpperCase() : 'USD';
+            const isFiat = ['USD', 'EUR', 'GBP'].includes(currency);
+            if (isFiat) {
+                if (params.amount >= criticalThreshold) {
+                    return {
+                        mode: { type: 'split', shares: 5, threshold: 3 },
+                        reason: `Critical-value transfer (${currency} ${params.amount.toLocaleString()}) requires 3-of-5 threshold`,
+                        wasOverridden: false,
+                    };
+                }
+                else if (params.amount >= highThreshold) {
+                    return {
+                        mode: { type: 'split', shares: 3, threshold: 2 },
+                        reason: `High-value transfer (${currency} ${params.amount.toLocaleString()}) requires 2-of-3 threshold`,
+                        wasOverridden: false,
+                    };
+                }
+            }
         }
         // Auto-detection: Cross-entity communication
         if (params.crossEntity === true) {

package/dist-standalone/errors.d.ts

@@ -45,6 +45,10 @@ export declare class XBindSplitChannelError extends XBindError {
 export declare class XBindAgentError extends XBindError {
     constructor(code: string, message: string);
 }
+/** Billing and payment errors (subscriptions, limits, verification). */
+export declare class XBindBillingError extends XBindError {
+    constructor(code: string, message: string);
+}
 /**
  * Create detailed error information for a given error code.
  *