solvoid 1.1.7 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (256) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +110 -90
  3. package/SECURITY.md +42 -0
  4. package/bin/solvoid-scan +2 -0
  5. package/dist/cli/commands/ghost.d.ts +11 -0
  6. package/dist/cli/commands/ghost.d.ts.map +1 -0
  7. package/dist/cli/commands/ghost.js +161 -0
  8. package/dist/cli/commands/ghost.js.map +1 -0
  9. package/dist/cli/commands/rescue.d.ts +7 -0
  10. package/dist/cli/commands/rescue.d.ts.map +1 -0
  11. package/dist/cli/commands/rescue.js +203 -0
  12. package/dist/cli/commands/rescue.js.map +1 -0
  13. package/dist/cli/comprehensive-rpc-list.d.ts +31 -0
  14. package/dist/cli/comprehensive-rpc-list.d.ts.map +1 -0
  15. package/dist/cli/comprehensive-rpc-list.js +341 -0
  16. package/dist/cli/comprehensive-rpc-list.js.map +1 -0
  17. package/dist/cli/demo-scan.d.ts +6 -0
  18. package/dist/cli/demo-scan.d.ts.map +1 -0
  19. package/dist/cli/demo-scan.js +178 -0
  20. package/dist/cli/demo-scan.js.map +1 -0
  21. package/dist/cli/enhanced-privacy-scan.d.ts +46 -0
  22. package/dist/cli/enhanced-privacy-scan.d.ts.map +1 -0
  23. package/dist/cli/enhanced-privacy-scan.js +422 -0
  24. package/dist/cli/enhanced-privacy-scan.js.map +1 -0
  25. package/dist/cli/ghost-test.d.ts +7 -0
  26. package/dist/cli/ghost-test.d.ts.map +1 -0
  27. package/dist/cli/ghost-test.js +192 -0
  28. package/dist/cli/ghost-test.js.map +1 -0
  29. package/dist/cli/simple-scan.d.ts +6 -0
  30. package/dist/cli/simple-scan.d.ts.map +1 -0
  31. package/dist/cli/simple-scan.js +250 -0
  32. package/dist/cli/simple-scan.js.map +1 -0
  33. package/dist/cli/solvoid-scan.d.ts +7 -0
  34. package/dist/cli/solvoid-scan.d.ts.map +1 -0
  35. package/dist/cli/solvoid-scan.js +263 -0
  36. package/dist/cli/solvoid-scan.js.map +1 -0
  37. package/dist/cli/ultimate-privacy-scan.d.ts +54 -0
  38. package/dist/cli/ultimate-privacy-scan.d.ts.map +1 -0
  39. package/dist/cli/ultimate-privacy-scan.js +543 -0
  40. package/dist/cli/ultimate-privacy-scan.js.map +1 -0
  41. package/dist/cli/utils/asset-scanner.d.ts +76 -0
  42. package/dist/cli/utils/asset-scanner.d.ts.map +1 -0
  43. package/dist/cli/utils/asset-scanner.js +224 -0
  44. package/dist/cli/utils/asset-scanner.js.map +1 -0
  45. package/dist/cli/utils/badge-generator.d.ts +33 -0
  46. package/dist/cli/utils/badge-generator.d.ts.map +1 -0
  47. package/dist/cli/utils/badge-generator.js +263 -0
  48. package/dist/cli/utils/badge-generator.js.map +1 -0
  49. package/dist/cli/utils/enhanced-monitoring.d.ts +13 -0
  50. package/dist/cli/utils/enhanced-monitoring.d.ts.map +1 -0
  51. package/dist/cli/utils/enhanced-monitoring.js +46 -0
  52. package/dist/cli/utils/enhanced-monitoring.js.map +1 -0
  53. package/dist/cli/utils/enhanced-pyth-feed.d.ts +20 -0
  54. package/dist/cli/utils/enhanced-pyth-feed.d.ts.map +1 -0
  55. package/dist/cli/utils/enhanced-pyth-feed.js +64 -0
  56. package/dist/cli/utils/enhanced-pyth-feed.js.map +1 -0
  57. package/dist/cli/utils/enhanced-threat-intel.d.ts +20 -0
  58. package/dist/cli/utils/enhanced-threat-intel.d.ts.map +1 -0
  59. package/dist/cli/utils/enhanced-threat-intel.js +57 -0
  60. package/dist/cli/utils/enhanced-threat-intel.js.map +1 -0
  61. package/dist/cli/utils/env-validator.d.ts +17 -0
  62. package/dist/cli/utils/env-validator.d.ts.map +1 -0
  63. package/dist/cli/utils/env-validator.js +257 -0
  64. package/dist/cli/utils/env-validator.js.map +1 -0
  65. package/dist/cli/utils/ghost-art.d.ts +14 -0
  66. package/dist/cli/utils/ghost-art.d.ts.map +1 -0
  67. package/dist/cli/utils/ghost-art.js +285 -0
  68. package/dist/cli/utils/ghost-art.js.map +1 -0
  69. package/dist/cli/utils/ghost-calculator.d.ts +52 -0
  70. package/dist/cli/utils/ghost-calculator.d.ts.map +1 -0
  71. package/dist/cli/utils/ghost-calculator.js +207 -0
  72. package/dist/cli/utils/ghost-calculator.js.map +1 -0
  73. package/dist/cli/utils/jito-mev-bundle.d.ts +9 -0
  74. package/dist/cli/utils/jito-mev-bundle.d.ts.map +1 -0
  75. package/dist/cli/utils/jito-mev-bundle.js +40 -0
  76. package/dist/cli/utils/jito-mev-bundle.js.map +1 -0
  77. package/dist/cli/utils/rescue-engine.d.ts +57 -0
  78. package/dist/cli/utils/rescue-engine.d.ts.map +1 -0
  79. package/dist/cli/utils/rescue-engine.js +192 -0
  80. package/dist/cli/utils/rescue-engine.js.map +1 -0
  81. package/dist/cli/utils/shadow-bridge.d.ts +20 -0
  82. package/dist/cli/utils/shadow-bridge.d.ts.map +1 -0
  83. package/dist/cli/utils/shadow-bridge.js +33 -0
  84. package/dist/cli/utils/shadow-bridge.js.map +1 -0
  85. package/dist/cli/utils/threat-detector.d.ts +48 -0
  86. package/dist/cli/utils/threat-detector.d.ts.map +1 -0
  87. package/dist/cli/utils/threat-detector.js +304 -0
  88. package/dist/cli/utils/threat-detector.js.map +1 -0
  89. package/dist/relayer/key-manager.d.ts +52 -0
  90. package/dist/relayer/key-manager.d.ts.map +1 -0
  91. package/dist/relayer/key-manager.js +356 -0
  92. package/dist/relayer/key-manager.js.map +1 -0
  93. package/dist/relayer/replay-protection.d.ts +94 -0
  94. package/dist/relayer/replay-protection.d.ts.map +1 -0
  95. package/dist/relayer/replay-protection.js +189 -0
  96. package/dist/relayer/replay-protection.js.map +1 -0
  97. package/dist/relayer/secure-service.d.ts +46 -0
  98. package/dist/relayer/secure-service.d.ts.map +1 -0
  99. package/dist/relayer/secure-service.js +538 -0
  100. package/dist/relayer/secure-service.js.map +1 -0
  101. package/dist/relayer/service.d.ts +25 -0
  102. package/dist/relayer/service.d.ts.map +1 -0
  103. package/dist/relayer/service.js +380 -0
  104. package/dist/relayer/service.js.map +1 -0
  105. package/dist/{client.d.ts → sdk/client.d.ts} +17 -0
  106. package/dist/sdk/client.d.ts.map +1 -0
  107. package/dist/{client.js → sdk/client.js} +69 -2
  108. package/dist/sdk/client.js.map +1 -0
  109. package/dist/sdk/crypto/poseidon.d.ts.map +1 -0
  110. package/dist/sdk/crypto/poseidon.js.map +1 -0
  111. package/dist/sdk/events/bus.d.ts.map +1 -0
  112. package/dist/sdk/events/bus.js.map +1 -0
  113. package/dist/sdk/index.d.ts.map +1 -0
  114. package/dist/sdk/index.js.map +1 -0
  115. package/dist/sdk/integrity.d.ts.map +1 -0
  116. package/dist/sdk/integrity.js.map +1 -0
  117. package/dist/sdk/network/shadow-rpc.d.ts.map +1 -0
  118. package/dist/sdk/network/shadow-rpc.js.map +1 -0
  119. package/dist/sdk/passport/manager.d.ts.map +1 -0
  120. package/dist/sdk/passport/manager.js.map +1 -0
  121. package/dist/sdk/pipeline.d.ts.map +1 -0
  122. package/dist/{pipeline.js → sdk/pipeline.js} +69 -12
  123. package/dist/sdk/pipeline.js.map +1 -0
  124. package/dist/sdk/polyfill.d.ts +8 -0
  125. package/dist/sdk/polyfill.d.ts.map +1 -0
  126. package/dist/sdk/polyfill.js +21 -0
  127. package/dist/sdk/polyfill.js.map +1 -0
  128. package/dist/sdk/privacy/relayer.d.ts.map +1 -0
  129. package/dist/sdk/privacy/relayer.js.map +1 -0
  130. package/dist/sdk/privacy/shield.d.ts.map +1 -0
  131. package/dist/sdk/privacy/shield.js.map +1 -0
  132. package/dist/sdk/privacy-engine.d.ts.map +1 -0
  133. package/dist/sdk/privacy-engine.js.map +1 -0
  134. package/dist/sdk/registry/idl-fetcher.d.ts.map +1 -0
  135. package/dist/sdk/registry/idl-fetcher.js.map +1 -0
  136. package/dist/sdk/registry/programs.d.ts.map +1 -0
  137. package/dist/sdk/registry/programs.js.map +1 -0
  138. package/dist/sdk/rescue/analyzer.d.ts.map +1 -0
  139. package/dist/sdk/rescue/analyzer.js.map +1 -0
  140. package/dist/sdk/rescue/builder.d.ts.map +1 -0
  141. package/dist/sdk/rescue/builder.js.map +1 -0
  142. package/dist/sdk/security/key-rotation.d.ts.map +1 -0
  143. package/dist/sdk/security/key-rotation.js.map +1 -0
  144. package/dist/{semantics → sdk/semantics}/analyzer.d.ts.map +1 -1
  145. package/dist/{semantics → sdk/semantics}/analyzer.js.map +1 -1
  146. package/dist/sdk/semantics/decoder.d.ts.map +1 -0
  147. package/dist/sdk/semantics/decoder.js.map +1 -0
  148. package/dist/{semantics → sdk/semantics}/graph.d.ts.map +1 -1
  149. package/dist/{semantics → sdk/semantics}/graph.js.map +1 -1
  150. package/dist/sdk/semantics/idl-registry.d.ts.map +1 -0
  151. package/dist/sdk/semantics/idl-registry.js.map +1 -0
  152. package/dist/sdk/semantics/types.d.ts.map +1 -0
  153. package/dist/sdk/semantics/types.js.map +1 -0
  154. package/dist/sdk/types.d.ts.map +1 -0
  155. package/dist/{semantics → sdk}/types.js.map +1 -1
  156. package/dist/sdk/utils/address.d.ts.map +1 -0
  157. package/dist/sdk/utils/address.js.map +1 -0
  158. package/dist/sdk/utils/config.d.ts.map +1 -0
  159. package/dist/sdk/utils/config.js.map +1 -0
  160. package/dist/sdk/utils/logger.d.ts.map +1 -0
  161. package/dist/sdk/utils/logger.js.map +1 -0
  162. package/dist/simple-scan.js +249 -0
  163. package/package.json +103 -36
  164. package/CHANGELOG.md +0 -33
  165. package/dist/client.d.ts.map +0 -1
  166. package/dist/client.js.map +0 -1
  167. package/dist/crypto/poseidon.d.ts.map +0 -1
  168. package/dist/crypto/poseidon.js.map +0 -1
  169. package/dist/events/bus.d.ts.map +0 -1
  170. package/dist/events/bus.js.map +0 -1
  171. package/dist/index.d.ts.map +0 -1
  172. package/dist/index.js.map +0 -1
  173. package/dist/integrity.d.ts.map +0 -1
  174. package/dist/integrity.js.map +0 -1
  175. package/dist/network/shadow-rpc.d.ts.map +0 -1
  176. package/dist/network/shadow-rpc.js.map +0 -1
  177. package/dist/passport/manager.d.ts.map +0 -1
  178. package/dist/passport/manager.js.map +0 -1
  179. package/dist/pipeline.d.ts.map +0 -1
  180. package/dist/pipeline.js.map +0 -1
  181. package/dist/privacy/relayer.d.ts.map +0 -1
  182. package/dist/privacy/relayer.js.map +0 -1
  183. package/dist/privacy/shield.d.ts.map +0 -1
  184. package/dist/privacy/shield.js.map +0 -1
  185. package/dist/privacy-engine.d.ts.map +0 -1
  186. package/dist/privacy-engine.js.map +0 -1
  187. package/dist/registry/idl-fetcher.d.ts.map +0 -1
  188. package/dist/registry/idl-fetcher.js.map +0 -1
  189. package/dist/registry/programs.d.ts.map +0 -1
  190. package/dist/registry/programs.js.map +0 -1
  191. package/dist/rescue/analyzer.d.ts.map +0 -1
  192. package/dist/rescue/analyzer.js.map +0 -1
  193. package/dist/rescue/builder.d.ts.map +0 -1
  194. package/dist/rescue/builder.js.map +0 -1
  195. package/dist/security/key-rotation.d.ts.map +0 -1
  196. package/dist/security/key-rotation.js.map +0 -1
  197. package/dist/semantics/decoder.d.ts.map +0 -1
  198. package/dist/semantics/decoder.js.map +0 -1
  199. package/dist/semantics/idl-registry.d.ts.map +0 -1
  200. package/dist/semantics/idl-registry.js.map +0 -1
  201. package/dist/semantics/types.d.ts.map +0 -1
  202. package/dist/types.d.ts.map +0 -1
  203. package/dist/types.js.map +0 -1
  204. package/dist/utils/address.d.ts.map +0 -1
  205. package/dist/utils/address.js.map +0 -1
  206. package/dist/utils/config.d.ts.map +0 -1
  207. package/dist/utils/config.js.map +0 -1
  208. package/dist/utils/logger.d.ts.map +0 -1
  209. package/dist/utils/logger.js.map +0 -1
  210. /package/dist/{crypto → sdk/crypto}/poseidon.d.ts +0 -0
  211. /package/dist/{crypto → sdk/crypto}/poseidon.js +0 -0
  212. /package/dist/{events → sdk/events}/bus.d.ts +0 -0
  213. /package/dist/{events → sdk/events}/bus.js +0 -0
  214. /package/dist/{index.d.ts → sdk/index.d.ts} +0 -0
  215. /package/dist/{index.js → sdk/index.js} +0 -0
  216. /package/dist/{integrity.d.ts → sdk/integrity.d.ts} +0 -0
  217. /package/dist/{integrity.js → sdk/integrity.js} +0 -0
  218. /package/dist/{network → sdk/network}/shadow-rpc.d.ts +0 -0
  219. /package/dist/{network → sdk/network}/shadow-rpc.js +0 -0
  220. /package/dist/{passport → sdk/passport}/manager.d.ts +0 -0
  221. /package/dist/{passport → sdk/passport}/manager.js +0 -0
  222. /package/dist/{pipeline.d.ts → sdk/pipeline.d.ts} +0 -0
  223. /package/dist/{privacy → sdk/privacy}/relayer.d.ts +0 -0
  224. /package/dist/{privacy → sdk/privacy}/relayer.js +0 -0
  225. /package/dist/{privacy → sdk/privacy}/shield.d.ts +0 -0
  226. /package/dist/{privacy → sdk/privacy}/shield.js +0 -0
  227. /package/dist/{privacy-engine.d.ts → sdk/privacy-engine.d.ts} +0 -0
  228. /package/dist/{privacy-engine.js → sdk/privacy-engine.js} +0 -0
  229. /package/dist/{registry → sdk/registry}/idl-fetcher.d.ts +0 -0
  230. /package/dist/{registry → sdk/registry}/idl-fetcher.js +0 -0
  231. /package/dist/{registry → sdk/registry}/programs.d.ts +0 -0
  232. /package/dist/{registry → sdk/registry}/programs.js +0 -0
  233. /package/dist/{rescue → sdk/rescue}/analyzer.d.ts +0 -0
  234. /package/dist/{rescue → sdk/rescue}/analyzer.js +0 -0
  235. /package/dist/{rescue → sdk/rescue}/builder.d.ts +0 -0
  236. /package/dist/{rescue → sdk/rescue}/builder.js +0 -0
  237. /package/dist/{security → sdk/security}/key-rotation.d.ts +0 -0
  238. /package/dist/{security → sdk/security}/key-rotation.js +0 -0
  239. /package/dist/{semantics → sdk/semantics}/analyzer.d.ts +0 -0
  240. /package/dist/{semantics → sdk/semantics}/analyzer.js +0 -0
  241. /package/dist/{semantics → sdk/semantics}/decoder.d.ts +0 -0
  242. /package/dist/{semantics → sdk/semantics}/decoder.js +0 -0
  243. /package/dist/{semantics → sdk/semantics}/graph.d.ts +0 -0
  244. /package/dist/{semantics → sdk/semantics}/graph.js +0 -0
  245. /package/dist/{semantics → sdk/semantics}/idl-registry.d.ts +0 -0
  246. /package/dist/{semantics → sdk/semantics}/idl-registry.js +0 -0
  247. /package/dist/{semantics → sdk/semantics}/types.d.ts +0 -0
  248. /package/dist/{semantics → sdk/semantics}/types.js +0 -0
  249. /package/dist/{types.d.ts → sdk/types.d.ts} +0 -0
  250. /package/dist/{types.js → sdk/types.js} +0 -0
  251. /package/dist/{utils → sdk/utils}/address.d.ts +0 -0
  252. /package/dist/{utils → sdk/utils}/address.js +0 -0
  253. /package/dist/{utils → sdk/utils}/config.d.ts +0 -0
  254. /package/dist/{utils → sdk/utils}/config.js +0 -0
  255. /package/dist/{utils → sdk/utils}/logger.d.ts +0 -0
  256. /package/dist/{utils → sdk/utils}/logger.js +0 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Privacy-Zero Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,22 +1,14 @@
1
- # SolVoid TypeScript SDK: Institutional Privacy Integration
2
-
3
- The official integration layer for the **SolVoid Privacy Protocol**. This SDK provides a comprehensive software interface for decentralized applications requiring Zero-Knowledge (ZK) transaction anonymity, identity obfuscation, and privacy auditing on Solana.
1
+ # SolVoid: Institutional-Grade Privacy Infrastructure for Solana
4
2
 
5
3
  <div align="center">
6
- <img src="https://github.com/brainless3178/SolVoid/raw/main/solvoid_assets.png" alt="SolVoid Architecture Infographic" width="800">
4
+ <img src="./solvoid_assets.png" alt="SolVoid Architecture Infographic" width="800">
7
5
  </div>
8
6
 
9
- [![NPM Version](https://img.shields.io/npm/v/solvoid.svg)](https://www.npmjs.com/package/solvoid)
10
- [![Protocol Status](https://img.shields.io/badge/Protocol-Beta-cyan.svg)](https://github.com/brainless3178/SolVoid)
7
+ [![Protocol Status](https://img.shields.io/badge/Protocol-Beta-cyan.svg)](https://solvoid.io)
11
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-gray.svg)](https://opensource.org/licenses/MIT)
9
+ [![Security: ZK-Optimized](https://img.shields.io/badge/Security-ZK--Optimized-blue.svg)](./ZK_REFERENCE.md)
12
10
 
13
- ---
14
-
15
- ## 🏛 Full Ecosystem Context
16
-
17
- While this package provides the SDK, SolVoid is a multi-layered privacy infrastructure. To access the full ecosystem—including the **ZK circuits**, **Shadow Relayer**, **Atomic Rescue CLI**, and **Web Dashboard**—refer to the primary repository:
18
-
19
- 🔗 **[github.com/brainless3178/SolVoid](https://github.com/brainless3178/SolVoid)**
11
+ SolVoid is a high-performance, non-custodial privacy protocol designed for the Solana ecosystem. By leveraging **Groth16 Zero-Knowledge Proofs** and circuit-optimized **Poseidon-3 hashing**, SolVoid enables cryptographically unlinkable asset transfers and identity obfuscation with sub-second latency.
20
12
 
21
13
  ---
22
14
 
@@ -38,113 +30,141 @@ graph TD
38
30
 
39
31
  ---
40
32
 
41
- ## 🚀 Key Ecosystem Infrastructure & Features
33
+ ## Project Lifecycle & Orchestration
42
34
 
43
- ### 1. Advanced Zero-Knowledge Stack
44
- - **Groth16 Proving Pipeline**: High-performance proving implementation on the **BN254 curve**.
45
- - **Poseidon-3 Hashing**: Standardized sponge construction ensuring 100% hash parity across **Circom (circuits)**, **Rust (Anchor program)**, and **TypeScript (SDK)**.
46
- - **20-Level Merkle Tree**: Optimized sparse tree supporting over 1.04M unique commitments per pool.
35
+ ### 1. Environment & Deployment Hub
36
+ The foundation for building, testing, and deploying the SolVoid protocol.
47
37
 
48
- ### 2. Specialized ZK Circuitry
49
- - **`withdraw.circom`**: Orchestrates nullifier verification, Merkle membership checks, and public signal binding.
50
- - **`rescue.circom`**: A specialized emergency circuit for the Atomic Rescue Engine, enabling private migration of assets from compromised identities.
51
-
52
- ### 3. Privacy Ghost Score (Anonymity Auditing)
53
- An integrated heuristic diagnostic engine that quantifies on-chain privacy risk (0-100).
54
- - **Leak Detection**: Identifies identity linkage via common fee-funding sources, ATA creation history, and transaction-graph entropy.
55
- - **ZK-Verified Badges**: Generate cryptographically verifiable reputation artifacts without revealing underlying data.
56
-
57
- ### 4. Shadow Relayer Network (Onion Routing)
58
- A decentralized network for gasless, unlinkable withdrawals.
59
- - **RSA-OAEP Encryption**: Protects withdrawal payloads using recursive encryption layers.
60
- - **Onion Routing**: Decouples the destination address from the withdrawal request, preventing IP-based linkage or RPC-level tracking.
38
+ ```bash
39
+ # Repository Initialization
40
+ git clone https://github.com/brainless3178/SolVoid.git
41
+ cd SolVoid
42
+ npm install
43
+
44
+ # ZK Cryptographic Pipeline
45
+ # Compiles circuits and generates proving/verification keys
46
+ ./scripts/build-zk.sh
47
+
48
+ # On-Chain Program Lifecycle (Anchor)
49
+ anchor build
50
+ anchor deploy --provider.cluster devnet
51
+
52
+ # Quality Assurance Suite
53
+ npm test # Execute full test matrix
54
+ npm run lint # Static code analysis
55
+ npm run dashboard:dev # Launch local UI environment
56
+ ```
61
57
 
62
- ### 5. Atomic Rescue Engine (MEV Protection)
63
- - **Jito Integration**: Leverages the **Jito-Solana mev-bundle** for sub-2s critical execution, protecting assets from front-running and sandwich attacks during emergency rotations.
58
+ ### 2. CLI Command Specification (`solvoid`)
59
+ The primary interface for protocol interaction, auditing, and emergency response.
64
60
 
65
- ---
61
+ #### **Surgical Shielding (Deposit)**
62
+ ```bash
63
+ solvoid shield <amount>
64
+ ```
65
+ * **Args**: `<amount>` (SOL to shield)
66
+ * **Protocol Action**: Generates `Secret` and `Nullifier` keys and commits hashed state to the Merkle tree.
66
67
 
67
- ## 📦 Installation
68
+ #### **Unlinkable Withdrawal**
69
+ ```bash
70
+ solvoid withdraw <secret> <nullifier> <recipient> <amount> [options]
71
+ ```
72
+ | Option | Description | Default |
73
+ |:---|:---|:---|
74
+ | `--relayer <url>`| Target Shadow Relayer endpoint | `.env` default |
75
+ | `--rpc <url>` | Override default Solana RPC | `.env` default |
68
76
 
77
+ #### **Privacy Ghost Score (Audit)**
78
+ ```bash
79
+ solvoid ghost <address> [options]
80
+ ```
81
+ | Option | Description |
82
+ |:---|:---|
83
+ | `--badge` | Generate a ZK-verified Privacy Badge artifact |
84
+ | `--share` | Generate social metadata for X/Discord platforms |
85
+ | `--verify <p>` | Cryptographically validate an external privacy proof |
86
+ | `--json` | Return raw audit data for programmatic ingestion |
87
+
88
+ #### **Atomic Rescue (MEV Protection)**
69
89
  ```bash
70
- npm install solvoid
90
+ solvoid rescue <wallet> [options]
71
91
  ```
92
+ | Option | Description |
93
+ |:---|:---|
94
+ | `--to <addr>` | Specified recovery destination address |
95
+ | `--auto-generate`| Initialize a fresh, secure remediation wallet |
96
+ | `--jito-bundle` | Utilize Jito-Solana MEV bundles for atomic execution |
97
+ | `--emergency` | Priority fee escalation for sub-2s critical rotation |
98
+ | `--dry-run` | Simulate orchestration without network broadcast |
99
+ | `--monitor` | Activate real-time post-remediation threat alerts |
100
+
101
+ #### **Protocol Administration (Emergency Controls)**
102
+ ```bash
103
+ solvoid admin <command> [args]
104
+ ```
105
+ | Command | Action |
106
+ |:---|:---|
107
+ | `pause` | Trigger the ZK Circuit Breaker to suspend withdrawals |
108
+ | `resume` | Reset breaker and resume protocol operations |
109
+ | `trigger-emergency` | Escalates protocol-wide fee multipliers (x1-x10) |
110
+ | `disable-emergency` | Resets protocol fees to baseline state |
72
111
 
73
112
  ---
74
113
 
75
- ## 🛠 SDK Integration Patterns
114
+ ### 3. SDK Integration Patterns
115
+ A professional integration layer for third-party dApps and services.
76
116
 
77
- ### 1. Client Initialization
78
117
  ```typescript
79
118
  import { SolVoidClient } from 'solvoid';
80
119
 
81
- const config = {
82
- rpcUrl: 'https://api.mainnet-beta.solana.com',
83
- programId: 'Fg6PaFpoGXkYsidMpSsu3SWJYEHp7rQU9YSTFNDQ4F5i',
84
- relayerUrl: 'https://relayer.solvoid.network'
85
- };
120
+ // 1. Client Orchestration
121
+ const client = new SolVoidClient(config, wallet);
86
122
 
87
- const client = new SolVoidClient(config, walletAdapter);
88
- ```
123
+ // 2. Surgical Shielding
124
+ const { commitmentData } = await client.shield(1.5 * LAMPORTS_PER_SOL);
89
125
 
90
- ### 2. Executing a Private Deposit (Surgical Shielding)
91
- ```typescript
92
- const amountLamports = 1_000_000_000; // 1.0 SOL
93
- const { commitmentData, status } = await client.shield(amountLamports);
126
+ // 3. Privacy Auditing
127
+ const passport = await client.getPassport(address);
128
+ console.log(`Ghost Score: ${passport.overallScore}/100`);
94
129
 
95
- console.log('Secret/Nullifier Primitives:', commitmentData.secret, commitmentData.nullifier);
130
+ // 4. Low-level Proof Generation
131
+ const proof = await client.prepareWithdrawal(secret, nullifier, ...);
96
132
  ```
97
133
 
98
- ### 3. Executing an Unlinkable Withdrawal (ZK Proving)
99
- ```typescript
100
- const result = await client.prepareWithdrawal(
101
- secret,
102
- nullifier,
103
- amountLamports,
104
- recipientPubkey,
105
- commitmentsBuffer, // Hex-encoded commitment set
106
- wasmPath,
107
- zkeyPath
108
- );
109
-
110
- // Submit via Shadow Relayer for gasless execution
111
- const txid = await client.submitWithdrawal(result);
112
- ```
134
+ ---
113
135
 
114
- ### 4. Privacy Auditing (Ghost Score)
115
- ```typescript
116
- const passport = await client.getPassport(address);
117
- console.log(`Current Ghost Score: ${passport.overallScore}/100`);
118
- passport.recommendations.forEach(rec => console.log(`Audit Note: ${rec}`));
119
- ```
136
+ ### 4. Shadow Relayer API Specification
137
+ Technical endpoints for the decentralized relay network.
138
+
139
+ | Endpoint | Method | Functional Requirement |
140
+ |:---|:---|:---|
141
+ | `/status` | `GET` | Health monitoring & protocol metrics |
142
+ | `/commitments` | `GET` | Multi-hop Merkle state synchronization |
143
+ | `/relay` | `POST` | `transaction` (base64) & `hops` (onion routing depth 1-5) |
120
144
 
121
145
  ---
122
146
 
123
- ## 🔒 Security & Performance
124
- - **Sub-second Latency**: Optimized for Solana's 400ms block times.
125
- - **Browser-Side Proving**: Execute Groth16 witness generation directly in the client environment via `snarkjs`.
126
- - **Data Integrity Enforcement (DIE)**: Zod-powered schema validation at every operational boundary (CLI, API, SDK).
147
+ ## Key Ecosystem Infrastructure
127
148
 
128
- ---
149
+ * **Groth16 ZK-SNARKs**: High-performance proving implementation on the **BN254 curve**.
150
+ * **Poseidon-3 Hashing**: Standardized sponge construction for 100% parity across Rust, TS, and Circom.
151
+ * **Jito-MEV Integration**: Advanced front-running protection for critical asset rotations.
152
+ * **Data Integrity Enforcement (DIE)**: Zod-powered schema validation at every operational boundary.
153
+ * **Global Dashboard**: Institutional Next.js interface providing real-time technical telemetry.
129
154
 
130
- ## 🛠 Project Orchestration (CLI & Operations)
155
+ ---
131
156
 
132
- While this package focus on the SDK, the following tools are available in the main repository:
157
+ ## 📖 Project Documentation
133
158
 
134
- ### CLI Command Summary (`solvoid`)
135
- ```bash
136
- solvoid shield <amount> # Surgical Shielding
137
- solvoid withdraw <args> # Unlinkable Withdrawal
138
- solvoid ghost <address> # Privacy Audit
139
- solvoid rescue <wallet> # Atomic Remediation
140
- solvoid admin pause/resume # Emergency Controls
141
- ```
159
+ - **Core:** [DOCS.md](DOCS.md) | [ZK_REFERENCE.md](ZK_REFERENCE.md) | [GHOST_REFERENCE.md](GHOST_REFERENCE.md)
160
+ - **Integration:** [SDK_REFERENCE.md](SDK_REFERENCE.md) | [CLI_REFERENCE.md](CLI_REFERENCE.md) | [API_REFERENCE.md](API_REFERENCE.md)
161
+ - **Ops:** [CICD_REFERENCE.md](CICD_REFERENCE.md) | [SYSTEM_STATUS.md](SYSTEM_STATUS.md) | [DEPLOYMENT.md](DEPLOYMENT.md)
142
162
 
143
163
  ---
144
164
 
145
- ## 📄 Licensing
146
-
147
- Distributed under the MIT License. SolVoid is an engineering-first initiative focused on digital sovereignty.
165
+ ## 🔒 Security Compliance
166
+ - **Status:** Experimental Beta
167
+ - **Policy:** Refer to [SECURITY.md](SECURITY.md) for disclosure protocols.
148
168
 
149
169
  ---
150
- *For the complete protocol documentation, circuits, and CLI, visit the [Main Repository](https://github.com/brainless3178/SolVoid).*
170
+ *Engineering-First. Privacy-Preserving. Solana-Native.*
package/SECURITY.md ADDED
@@ -0,0 +1,42 @@
1
+ # Security Standards: Protocol Integrity & Disclosure
2
+
3
+ ## Vulnerability Disclosure Policy
4
+
5
+ The SolVoid project recognizes that protocol security is an ongoing engineering process. In the event of vulnerability identification, we prioritize responsible, coordinated disclosure to ensure the continuous protection of the collective anonymity set.
6
+
7
+ ### Reporting Methodology
8
+ - **Communication Channel:** [security@solvoid.io] (Contact registry placeholder).
9
+ - **Cryptographic Protection:** Encrypt all sensitive disclosures using the project's PGP identifier (Link placeholder).
10
+ - **Response Protocol:** The engineering team will acknowledge reports within 48 hours and establish a remediation timeline. We request that reporters maintain confidentiality until a verified patch has been deployed across the network.
11
+
12
+ ---
13
+
14
+ ## Technical Security Best Practices
15
+
16
+ 1. **Primitive Sequestration:** The secret and nullifier keys constitute the sole access vectors for shielded liquidity. Execution of the protocol implies user responsibility for the secure, off-chain storage of these cryptographical primitives.
17
+ 2. **Identity Decoupling:** To maintain maximum anonymity, withdrawal destination addresses should have zero historical on-chain linkage to the depositor's primary identity.
18
+ 3. **Environment Verification:** Verify the integrity of the local build or ensure the use of the canonical `solvoid.io` interface to mitigate man-in-the-middle or phishing attacks.
19
+ 4. **Gas Funding Risks:** When not utilizing the Shadow Relayer network, funding a fresh destination wallet with SOL gas may introduce timing-based or graph-based linkage vulnerabilities.
20
+
21
+ ---
22
+
23
+ ## Critical Security Considerations & Risk Factors
24
+
25
+ 1. **Audit Status:** The current protocol implementation has **not** undergone a third-party security audit. Usage is restricted to experimental or testing environments.
26
+ 2. **Proving Ceremony Requirements:** Proving keys currently in use are intended for development cycles. A production-grade Multi-Party Computation (MPC) ceremony is mandatory before Mainnet architectural finalization.
27
+ 3. **Circuit Constraints:** Circom circuit constraints are undergoing continuous peer review and refinement to ensure comprehensive boundary coverage.
28
+ 4. **Relayer Trust Model:** Relayer entities are restricted by ZK-bindings from asset theft, but retain the capacity for IP logging or localized Denial of Service (DoS).
29
+
30
+ ---
31
+
32
+ ## Version Support Matrix
33
+
34
+ | Specification | Support Status | Maintenance Type |
35
+ |---------------|----------------|------------------|
36
+ | 0.2.x | Active | Feature/Security |
37
+ | 0.1.x | Deprecated | Critical Fixes |
38
+
39
+ ---
40
+
41
+ ## Bug Bounty Initiative
42
+ We operate a "Coordinated Vulnerability Research" program. Reports of critical vulnerabilities that adhere to disclosure requirements are prioritized for retroactive rewards as the protocol ecosystem matures.
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ require('../dist/cli/solvoid-scan.js');
@@ -0,0 +1,11 @@
1
+ import { Command } from 'commander';
2
+ /**
3
+ * Registry for the Privacy Ghost Score command suite.
4
+ * Provides visual privacy metrics and ZK-verified reputation artifacts.
5
+ */
6
+ export declare function registerGhostCommand(program: Command): void;
7
+ /**
8
+ * Provides technical documentation for the ghost command module.
9
+ */
10
+ export declare function getGhostCommandHelp(): string;
11
+ //# sourceMappingURL=ghost.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ghost.d.ts","sourceRoot":"","sources":["../../../cli/commands/ghost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAsEpD;AAoED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA2B5C"}
@@ -0,0 +1,161 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.registerGhostCommand = registerGhostCommand;
7
+ exports.getGhostCommandHelp = getGhostCommandHelp;
8
+ const web3_js_1 = require("@solana/web3.js");
9
+ const client_1 = require("../../sdk/client");
10
+ const ghost_calculator_1 = require("../utils/ghost-calculator");
11
+ const ghost_art_1 = require("../utils/ghost-art");
12
+ const badge_generator_1 = require("../utils/badge-generator");
13
+ const chalk_1 = __importDefault(require("chalk"));
14
+ /**
15
+ * Registry for the Privacy Ghost Score command suite.
16
+ * Provides visual privacy metrics and ZK-verified reputation artifacts.
17
+ */
18
+ function registerGhostCommand(program) {
19
+ program
20
+ .command('ghost')
21
+ .description('Generate Privacy Ghost Score and ZK-verified reputation artifacts')
22
+ .argument('<address>', 'Wallet address for privacy analysis')
23
+ .option('--badge', 'Generate a cryptographically verifiable privacy badge')
24
+ .option('--json', 'Return raw score data in JSON format')
25
+ .option('--share', 'Generate social metadata and sharing strings')
26
+ .option('--verify <proof>', 'Validate an external ZK privacy proof')
27
+ .option('--rpc <url>', 'Specify Solana RPC endpoint')
28
+ .option('--program <id>', 'Specify SolVoid program ID')
29
+ .option('--relayer <url>', 'Specify Shadow Relayer API URL')
30
+ .action(async (address, options) => {
31
+ try {
32
+ if (options.verify) {
33
+ handleProofVerification(options.verify);
34
+ return;
35
+ }
36
+ console.log(chalk_1.default.cyan(' Initiating wallet privacy analysis...\n'));
37
+ /** Use standardized protocol configuration from options or global environment. */
38
+ const client = new client_1.SolVoidClient({
39
+ rpcUrl: options.rpc || process.env.RPC_URL || 'https://api.devnet.solana.com',
40
+ programId: options.program || process.env.PROGRAM_ID || '3QcKRYWquzbBR3UpKeh4aKVCSpoHy89UT8gyovzRzzan',
41
+ relayerUrl: options.relayer || process.env.SHADOW_RELAYER_URL || 'http://localhost:3000'
42
+ }, {});
43
+ console.log(chalk_1.default.gray(' Scanning transaction history for anonymity leaks...'));
44
+ const scanResults = await client.protect(new web3_js_1.PublicKey(address));
45
+ console.log(chalk_1.default.gray(' Executing Ghost Score calculation logic...'));
46
+ const ghostScore = ghost_calculator_1.GhostScoreCalculator.calculate(scanResults);
47
+ console.log(chalk_1.default.gray(' Finalizing visual report generation...\n'));
48
+ if (options.json) {
49
+ console.log(JSON.stringify({
50
+ address,
51
+ ghostScore,
52
+ timestamp: Date.now(),
53
+ scanResults
54
+ }, null, 2));
55
+ return;
56
+ }
57
+ /** Render terminal-optimized visualization of privacy metrics. */
58
+ console.log(ghost_art_1.GhostArt.formatGhostScore(ghostScore));
59
+ if (options.badge || options.share) {
60
+ await handleBadgeGeneration(address, ghostScore, options.share);
61
+ }
62
+ console.log(chalk_1.default.cyan('\n Protocol Recommendations:'));
63
+ if (ghostScore.score < 70) {
64
+ console.log(chalk_1.default.yellow(' Shielding additional transactions is recommended to increase anonymity set.'));
65
+ console.log(chalk_1.default.yellow(' Execution: solvoid shield <amount>'));
66
+ }
67
+ else {
68
+ console.log(chalk_1.default.green(' Privacy threshold met. ZK badge generation is recommended.'));
69
+ console.log(chalk_1.default.green(' Execution: solvoid ghost <address> --badge --share'));
70
+ }
71
+ }
72
+ catch (error) {
73
+ console.error(chalk_1.default.red('\n Critical error during score generation:'), error.message);
74
+ process.exit(1);
75
+ }
76
+ });
77
+ }
78
+ /**
79
+ * Orchestrates cryptographically verifiable badge generation.
80
+ */
81
+ async function handleBadgeGeneration(address, ghostScore, showShare) {
82
+ console.log(chalk_1.default.cyan('\n Initializing ZK Privacy Badge generation...\n'));
83
+ const badge = await badge_generator_1.BadgeGenerator.generate(address, ghostScore);
84
+ console.log(ghost_art_1.GhostArt.formatBadge(badge));
85
+ if (showShare) {
86
+ console.log(chalk_1.default.bold(' Social Metadata (X/Twitter):'));
87
+ console.log(chalk_1.default.gray(''.repeat(60)));
88
+ console.log(chalk_1.default.blue(badge.twitterText));
89
+ console.log(chalk_1.default.gray(''.repeat(60)));
90
+ console.log();
91
+ console.log(chalk_1.default.bold(' Integration Metadata (Discord):'));
92
+ console.log(chalk_1.default.gray(''.repeat(60)));
93
+ console.log(badge.discordText);
94
+ console.log(chalk_1.default.gray(''.repeat(60)));
95
+ console.log();
96
+ console.log(chalk_1.default.bold(' ZK Privacy Proof:'));
97
+ console.log(chalk_1.default.gray(''.repeat(60)));
98
+ console.log(chalk_1.default.gray(badge.proofData.slice(0, 80) + '...'));
99
+ console.log(chalk_1.default.dim('\n(Cryptographic attestation of score threshold.'));
100
+ console.log(chalk_1.default.dim('Does not reveal identity-linked data)'));
101
+ console.log(chalk_1.default.gray(''.repeat(60)));
102
+ console.log();
103
+ console.log(chalk_1.default.cyan(' Verification Protocol:'));
104
+ console.log(`Third-party verification available via:`);
105
+ console.log(chalk_1.default.green(`solvoid ghost --verify "${badge.proofData.slice(0, 40)}..."`));
106
+ console.log();
107
+ }
108
+ }
109
+ /**
110
+ * Validates the cryptographic integrity of a privacy badge.
111
+ */
112
+ function handleProofVerification(proofData) {
113
+ console.log(chalk_1.default.cyan('\n Executing ZK Proof Verification...\n'));
114
+ const verification = badge_generator_1.BadgeGenerator.verifyBadge(proofData);
115
+ if (verification) {
116
+ console.log(chalk_1.default.green(' Proof Status: VALID\n'));
117
+ console.log(chalk_1.default.bold('Attestation Details:'));
118
+ console.log(` Verification State: ${chalk_1.default.cyan('SUCCESSFUL')}`);
119
+ console.log(chalk_1.default.green('A wallet holder has proven their privacy score range'));
120
+ console.log(chalk_1.default.green('without exposing identity-linked transaction history.'));
121
+ }
122
+ else {
123
+ console.log(chalk_1.default.red(' Proof Status: INVALID or EXPIRED\n'));
124
+ console.log(chalk_1.default.yellow('Failure Modes:'));
125
+ console.log(' • Data corruption identified in proof payload');
126
+ console.log(' • Proof integrity compromised via tampering');
127
+ }
128
+ console.log();
129
+ }
130
+ /**
131
+ * Provides technical documentation for the ghost command module.
132
+ */
133
+ function getGhostCommandHelp() {
134
+ return `
135
+ ${chalk_1.default.bold.cyan('Privacy Ghost Scoring System')}
136
+
137
+ Executes a comprehensive privacy analysis (0-100) of the target wallet.
138
+
139
+ ${chalk_1.default.bold('Implementation:')}
140
+ solvoid ghost <address> Execute basic analysis
141
+ solvoid ghost <address> --badge Generate ZK-verified badge
142
+ solvoid ghost <address> --share Generate sharing metadata
143
+ solvoid ghost <address> --json Return raw automation data
144
+ solvoid ghost --verify <proof> Validate external proof
145
+
146
+ ${chalk_1.default.bold('Examples:')}
147
+ # Core Analysis
148
+ solvoid ghost 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
149
+
150
+ # Reputation Generation
151
+ solvoid ghost 9WzDXw... --badge
152
+
153
+ ${chalk_1.default.bold('Anonymity Thresholds:')}
154
+ 90-100 ${chalk_1.default.green(' Invisible')} - Maximum anonymity set
155
+ 70-89 ${chalk_1.default.cyan(' Translucent')} - High privacy standard
156
+ 50-69 ${chalk_1.default.yellow(' Visible')} - Minimal protection confirmed
157
+ 30-49 ${chalk_1.default.red(' Exposed')} - Privacy leaks detected
158
+ 0-29 ${chalk_1.default.red.bold(' Glass House')} - Critical identity linkage
159
+ `;
160
+ }
161
+ //# sourceMappingURL=ghost.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ghost.js","sourceRoot":"","sources":["../../../cli/commands/ghost.ts"],"names":[],"mappings":";;;;;AAYA,oDAsEC;AAuED,kDA2BC;AAnLD,6CAA4C;AAC5C,6CAAiD;AACjD,gEAAiE;AACjE,kDAA8C;AAC9C,8DAA0D;AAC1D,kDAA0B;AAE1B;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mEAAmE,CAAC;SAChF,QAAQ,CAAC,WAAW,EAAE,qCAAqC,CAAC;SAC5D,MAAM,CAAC,SAAS,EAAE,uDAAuD,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,sCAAsC,CAAC;SACxD,MAAM,CAAC,SAAS,EAAE,8CAA8C,CAAC;SACjE,MAAM,CAAC,kBAAkB,EAAE,uCAAuC,CAAC;SACnE,MAAM,CAAC,aAAa,EAAE,6BAA6B,CAAC;SACpD,MAAM,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;SACtD,MAAM,CAAC,iBAAiB,EAAE,gCAAgC,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;YAEpE,kFAAkF;YAClF,MAAM,MAAM,GAAG,IAAI,sBAAa,CAC9B;gBACE,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,+BAA+B;gBAC7E,SAAS,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,8CAA8C;gBACtG,UAAU,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;aACzF,EACD,EAAS,CACV,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC,CAAC;YAClF,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,mBAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAEjE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,uCAAoB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAE/D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,CAAC;YAEvE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;oBACzB,OAAO;oBACP,UAAU;oBACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,WAAW;iBACZ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACb,OAAO;YACT,CAAC;YAED,kEAAkE;YAClE,OAAO,CAAC,GAAG,CAAC,oBAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;YAEnD,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;YACxD,IAAI,UAAU,CAAC,KAAK,GAAG,EAAE,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,gFAAgF,CAAC,CAAC,CAAC;gBAC5G,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,uCAAuC,CAAC,CAAC,CAAC;YACrE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC,CAAC;gBAC1F,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC;YACpF,CAAC;QAEH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAAe,EACf,UAAe,EACf,SAAkB;IAElB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,MAAM,gCAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEjE,OAAO,CAAC,GAAG,CAAC,oBAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAEzC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,2BAA2B,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,SAAiB;IAChD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG,gCAAc,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAE3D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,yBAAyB,eAAK,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO;EACP,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC;;;;EAI/C,eAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;;;;;;;EAO7B,eAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;;;;;EAOvB,eAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC;YACzB,eAAK,CAAC,KAAK,CAAC,YAAY,CAAC;YACzB,eAAK,CAAC,IAAI,CAAC,eAAe,CAAC;YAC3B,eAAK,CAAC,MAAM,CAAC,WAAW,CAAC;YACzB,eAAK,CAAC,GAAG,CAAC,UAAU,CAAC;YACrB,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC;CACzC,CAAC;AACF,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { Command } from 'commander';
2
+ /**
3
+ * Registry for the Atomic Rescue command suite.
4
+ * Provides emergency remediation protocols for high-threat wallet environments.
5
+ */
6
+ export declare function registerRescueCommand(program: Command): void;
7
+ //# sourceMappingURL=rescue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rescue.d.ts","sourceRoot":"","sources":["../../../cli/commands/rescue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAgIrD"}