4 releases (2 breaking)
0.3.1 | Aug 7, 2024 |
---|---|
0.3.0 | Aug 7, 2024 |
0.2.0 | Aug 6, 2024 |
0.1.0 | Jul 8, 2024 |
#10 in #arbitrum
123 downloads per month
19KB
275 lines
Geti SDK
The Geti SDK is a comprehensive tool for auditing Arbitrum Stylus Rust smart contracts. This guide will help you get started with installation and usage of the SDK for auditing your smart contracts.
Installation
To use the Geti SDK, ensure you have Rust and Cargo installed. If you don't have Rust installed, follow the instructions on the official Rust website.
Add the Geti SDK to your project's Cargo.toml
file:
[dependencies]
geti = "0.1.0" # Ensure this matches the version on crates.io
Then, run:
cargo build
Usage
The Geti SDK provides several functionalities to assist with auditing Rust smart contracts. Here are the steps to use the SDK:
CLI Tool
The CLI tool allows you to interact with the SDK via command-line commands.
Commands
-
Extract Smart Contract Files
Extracts Rust smart contract files from a specified directory.
cargo run -- extract --path <directory-path>
Example:
cargo run -- extract --path ./contracts
-
Read and Display a Markdown File
Reads and displays the content of a specified markdown file.
cargo run -- read-markdown --path <file-path>
Example:
cargo run -- read-markdown --path ./docs/project-description.md
-
Perform Audit
Performs an audit by extracting contract files from a specified directory and reading a markdown file. The response includes a link to the audit report.
cargo run -- audit --contract-path <directory-path> --markdown-path <file-path>
Example:
cargo run -- audit --contract-path ./contracts --markdown-path ./docs/project-description.md
After running the audit, you will receive a response with a link to the audit report. Click the link to view the detailed audit results.
Example Workflow
-
Extract Contracts
To extract contract files from the
contracts
directory:cargo run -- extract --path ./contracts
-
Read Markdown File
To read the content of
project-description.md
:cargo run -- read-markdown --path ./docs/project-description.md
-
Perform an Audit
To perform an audit with contract files in the
contracts
directory and a markdown file atproject-description.md
:cargo run -- audit --contract-path ./contracts --markdown-path ./docs/project-description.md
This will provide a link to the audit report.
Contributing
We welcome contributions to improve the Geti SDK. If you have suggestions or find bugs, please open an issue or submit a pull request on the GitHub repository.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Thank you for using the Geti SDK! If you have any questions or need further assistance, feel free to contact us or open an issue on GitHub.
Dependencies
~11–24MB
~351K SLoC