@nomicfoundation/solidity-analyzer
v0.1.2
Published
`@nomicfoundation/solidity-analyzer` is an N-API library built in Rust, which exposes a single function, which takes the contents of a Solidity source file and returns its imports and version pragmas.
Downloads
651,604
Keywords
Readme
@nomicfoundation/solidity-analyzer
@nomicfoundation/solidity-analyzer
is an N-API library built in Rust, which exposes a single function, which takes the contents of a Solidity source file and returns its imports and version pragmas.
Installation
npm install @nomicfoundation/solidity-analyzer
API
export interface AnalysisResult {
versionPragmas: Array<string>;
imports: Array<string>;
}
export function analyze(input: string): AnalysisResult;
Example
analyze(`
pragma solidity ^0.8.0;
import "./file.sol";
`);
// { versionPragmas: [ '^0.8.0' ], imports: [ './file.sol' ] }
Goals
This library has two different goals:
- Being fast
- Being error-tolerant
Both are achieved by not parsing the Solidity source but just tokenizing it instead. This allows us to create a simple state machine that only recognizes imports and pragmas, ignoring everything else, and recovering from malformed tokens or expressions.
Browser support
This library doesn't work in a browser.
Testing
This project has some JavaScript unit tests in __test__
, and it's also tested using the entire smart-contract-sanctuary
.
You can find the scripts to test with the sanctuary in test-with-sanctuary/
.
Regenerating index.js
and index.d.ts
These files have to be committed because of our current Github Actions, yet, they are autogenerated.
You can run cargo clean
, yarn clean
, and yarn build
to recreate them.