sealevel-insight 0.8.1

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.
package/DISCLOSURE ADDED
@@ -0,0 +1,5 @@
1
+ Sealevel Insight is a defensive, local code-analysis utility for Solana programs. It is published as dual-use software because its reports include security-relevant architecture and audit-scoping evidence such as externally reachable instructions, account privileges, CPIs, PDA signing, state mutation, and token or asset-flow relationships.
2
+
3
+ The CLI parses source and metadata locally and produces deterministic JSON, Markdown, or HTML reports. It does not execute analyzed programs, exploit systems, access wallets or private keys, contact Solana RPC endpoints, upload source code, collect telemetry, invoke AI services, or provide offensive payloads. The intended use is software architecture review, audit scoping, defensive research, and reproducible CI quality checks on code the user is authorized to inspect.
4
+
5
+ Dynamic dispatch, opaque macros, unavailable dependencies, and runtime-selected values remain explicit unresolved evidence rather than being guessed or acted upon.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sealevel Insight 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 ADDED
@@ -0,0 +1,62 @@
1
+ # Sealevel Insight CLI
2
+
3
+ Sealevel Insight is a local, deterministic architecture and code-metrics CLI for Solana programs. It reads Rust, Anchor, Native Rust, Pinocchio, Steel, Quasar, Solang Solidity, and hand-written sBPF assembly source without executing the target program or contacting a network.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install --global sealevel-insight
9
+ ```
10
+
11
+ For a one-off run:
12
+
13
+ ```bash
14
+ npx sealevel-insight analyze . --format json --output report.json
15
+ ```
16
+
17
+ Node.js 18 or newer is required. Analysis is local and offline; the parser grammars are shipped in the package. The optional real-world validation scripts in the source repository are separate development workflows and are not run by the CLI.
18
+
19
+ ## Commands
20
+
21
+ ```text
22
+ sealevel-insight analyze [root] [options]
23
+ sealevel-insight scope [root] [options]
24
+ sealevel-insight diff <before.json> <after.json> [--format json|markdown|html]
25
+ sealevel-insight baseline save [root] [--output baseline.json]
26
+ sealevel-insight cache clear [root]
27
+ ```
28
+
29
+ Useful options include `--enable-idl`, `--cargo-metadata`, `--target`, repeated `--cfg`, `--cfg-complete`, `--no-cache`, `--format`, and `--output`. Exit code `0` means success, `1` means an analysis/configuration failure, and `2` means a configured quality policy failed.
30
+
31
+ Reports include metrics, programs, modules, functions, instruction reachability, call paths, accounts, CPIs, PDAs, state and asset-flow evidence, IDL reconciliation, semantic coverage, and explicit unresolved limitations. Review signals are not vulnerability findings or a security verdict.
32
+
33
+ ## Publishing
34
+
35
+ The source repository also contains the VS Code extension, so its root manifest is private. The public CLI is generated and validated separately:
36
+
37
+ ```bash
38
+ npm run package:cli
39
+ npm run test:cli-package
40
+ npm publish ./dist-cli-package --access public
41
+ ```
42
+
43
+ The generated package declares its dual-use content policy and includes `DISCLOSURE` at its root. Use npm's required interactive two-factor-authenticated publish or staged publishing flow for this package.
44
+
45
+ ## Cargo workspaces
46
+
47
+ The CLI understands Cargo workspaces and reads `Cargo.toml` files without running Cargo. For reproducible CI, provide saved metadata with `--cargo-metadata cargo-metadata.json`. A Rust installation is not required to run the analyzer.
48
+
49
+ To create that metadata outside the analyzer, use Cargo's locked/offline mode when the dependency cache is available, then pass the resulting file to Sealevel Insight:
50
+
51
+ ```bash
52
+ cargo metadata --format-version 1 --locked --offline > cargo-metadata.json
53
+ sealevel-insight analyze . --cargo-metadata cargo-metadata.json --no-cache
54
+ ```
55
+
56
+ Cargo is an input and metadata source here, not a runtime dependency. The published CLI remains a Node.js package; a future `cargo install` package would require a separately maintained native Rust engine or launcher.
57
+
58
+ ## Privacy and safety
59
+
60
+ Normal execution reads the selected local files and writes the requested report/cache. It does not upload source code, use telemetry, access wallets or private keys, call Solana RPC, invoke AI APIs, or execute the analyzed program.
61
+
62
+ See the repository's `SECURITY.md`, `SUPPORT.md`, and `THIRD_PARTY_NOTICES.md` for reporting and dependency information.
package/SECURITY.md ADDED
@@ -0,0 +1,5 @@
1
+ # Security policy
2
+
3
+ Report security issues in Sealevel Insight privately through the repository security contact or issue tracker described in the project repository. Include the extension version, VS Code version, operating system, reproduction steps, and a minimal fixture when possible.
4
+
5
+ Sealevel Insight reports review-surface signals in analyzed Solana code. Those signals are not vulnerability findings. A bug in the extension itself, such as unsafe source handling or arbitrary command execution, is a product security issue and should be reported separately.
package/SUPPORT.md ADDED
@@ -0,0 +1,3 @@
1
+ # Support
2
+
3
+ Use the repository issue tracker for questions and reproducible bugs. Include the Sealevel Insight version, VS Code version, operating system, relevant settings, command used, and a small project or synthetic fixture that reproduces the behavior. Do not upload private source code or secrets.
@@ -0,0 +1,57 @@
1
+ # Third-party notices
2
+
3
+ Sealevel Insight bundles `@iarna/toml` and `web-tree-sitter` into its JavaScript entrypoints and distributes the Web Tree-sitter runtime plus Tree-sitter Rust and Solidity grammars as WebAssembly assets. It does not redistribute third-party source repositories.
4
+
5
+ ## @iarna/toml 3.0.0
6
+
7
+ Source: https://github.com/iarna/iarna-toml
8
+
9
+ Copyright (c) 2016, Rebecca Turner <me@re-becca.org>
10
+
11
+ Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
12
+
13
+ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14
+
15
+ ## web-tree-sitter 0.25.10
16
+
17
+ Source: https://github.com/tree-sitter/tree-sitter/tree/master/lib/binding_web
18
+
19
+ The MIT License (MIT)
20
+
21
+ Copyright (c) 2018-2024 Max Brunsfeld
22
+
23
+ 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:
24
+
25
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
26
+
27
+ 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.
28
+
29
+ ## tree-sitter-solidity 1.2.13
30
+
31
+ Source: https://github.com/JoranHonig/tree-sitter-solidity
32
+
33
+ Reproducible source package: `tree-sitter-solidity@1.2.13`, npm integrity `sha512-nO2AbcAuz2Qba8JnPNe/3FVjRRvGY3ApxSJ8UPIzfynJm4PYCMbBoXxxbprvMgjCbGYR/ZrHGIPKzXV7zBa+lQ==`
34
+
35
+ Copyright (c) 2020 Joran Honig
36
+
37
+ 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:
38
+
39
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
40
+
41
+ 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.
42
+
43
+ ## tree-sitter-rust 0.24.0
44
+
45
+ Source: https://github.com/tree-sitter/tree-sitter-rust
46
+
47
+ The MIT License (MIT)
48
+
49
+ Copyright (c) 2017 Maxim Sokolov
50
+
51
+ 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:
52
+
53
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
54
+
55
+ 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.
56
+
57
+ The Marketplace icon is original artwork generated specifically for Sealevel Insight and does not copy a third-party logo.