# TokenFi Shield

### 1. What Is TokenFi Shield?

TokenFi Shield helps developers, projects, and enterprises quickly identify risks and optimize their smart contracts before launch.

It performs AI-powered semantic and code-level analysis on Solidity and Rust contracts deployed on EVM or Solana, providing categorized insights and expert recommendations in minutes.

{% hint style="success" %}
Our goal is to give you instant, reliable insights before committing to a costly manual review, or to help you assess lower-risk projects at your own discretion.
{% endhint %}

#### Why It Matters

Manual audits are often time-consuming and expensive. The AI Auditor bridges the gap by providing faster, automated feedback that helps you detect issues early and prepare for manual reviews with confidence.

{% hint style="info" %}
The AI Auditor is not a replacement for human audits.

Always double-check results and validate critical contracts with professional auditors.
{% endhint %}

***

### 2. How It Works

Follow these steps to run an audit with the TokenFi AI Smart Contract Auditor:

***

#### Step 1 — Add Project Info

Tell the AI about your smart contract project.

Fields:

* Project Name → Enter the name of your project (e.g., *Presale Airdrop*).
* How would you describe your project? → Briefly explain what your contract does and its main function.
  * Example: “This contract manages token presale distribution and vesting schedules.”

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2FAMiAlN66ZYdeDNjYLFjS%2Fimage.png?alt=media&#x26;token=6d4e1b2f-eff8-4fa5-990c-23a836b5b60d" alt=""><figcaption><p>Add your project details, including name and a short description.</p></figcaption></figure></div>

***

#### Step 2 — Choose Contract Type

Select the environment your smart contract is built on.

* EVM (Solidity) → For Ethereum, BNB Chain, Polygon, and other EVM-compatible networks.
* Solana (Rust) → For projects deployed or being developed on Solana.

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2F2QKLPtenjdoZ3ZUFcgBi%2Fimage.png?alt=media&#x26;token=a78ad200-a9e1-4a5a-ba88-c8915aefc7df" alt=""><figcaption><p>Select the blockchain environment for your contract — EVM for Solidity-based projects or Solana for Rust-based development.</p></figcaption></figure></div>

***

#### Step 3 — Add Optional Files

**Project Logo (Optional)**

Add a logo to personalize your audit report.

* Supported formats: JPEG, PNG (up to 2MB).

**Documentation (Optional)**

Attach files that help the AI better understand your project’s business logic.

Accepted formats: .pdf, .doc, .txt, .md (up to 2MB).

Examples:

* Project requirements
* Whitepaper or tokenomics
* Function and permission specs
* Transaction flow diagrams

{% hint style="success" %}
Uploading documentation improves audit accuracy and helps the AI tailor its analysis to your specific logic and goals.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2FRAzWlusuz2XmmJGDnoDB%2Fimage.png?alt=media&#x26;token=9ae8bbec-ee3e-472d-b866-a553d1bad458" alt=""><figcaption><p>Upload optional assets like your project logo or documentation to help the AI better understand your business logic and generate more accurate audit results.</p></figcaption></figure></div>

***

#### Step 4 — Provide Contract Code

Choose how you want to provide your contract:

**Option A — Upload Files**

Upload your smart contract files directly.

* Supported format: .sol (Solidity) or .rs (Rust)
* File size limit: up to 10MB

{% hint style="success" %}
If your project includes multiple files (e.g., imported ERC20 contracts or custom libraries), use Upload Files to include them all at once.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2F1CA0cw40DrYYNjijZC4p%2Fimage.png?alt=media&#x26;token=4ce963d3-01ea-4937-9e15-4d01b3aeae30" alt=""><figcaption><p>Upload your smart contract file.</p></figcaption></figure></div>

**Option B — Paste Code**

Paste your full smart contract code directly into the editor.

* Make sure all dependencies are included.
* The AI instantly parses and begins the analysis after submission.

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2Fy10M2lJMbSVdU2bPCRYV%2Fimage.png?alt=media&#x26;token=e1087cf7-aa85-480a-b332-a184241789df" alt=""><figcaption><p>Paste your smart contract code directly into the editor .</p></figcaption></figure></div>

***

#### Step 5 — Run Audit

Once all required fields are filled:

1. Review your information.
2. Click Run Audit.
3. The AI will analyze your contract and generate a categorized report within minutes.

***

#### Step 6 — View Your Audit Results

Once the audit is complete, your project dashboard displays all findings, grouped by severity:

* 🔴 Critical — Must fix before deployment
* 🟠 High — Security risks with potential exploits
* 🟡 Medium — Functional or efficiency issues
* 🔵 Low — Minor improvements or style notes

Each issue includes:

* Description — What was detected and where
* Recommendation — AI-generated fix or best-practice advice
* Severity Tag — Helps you prioritize work
* Mark as Resolved — Track which findings you’ve already fixed

**You can switch between three tabs to explore your results:**

| Findings | Full list of detected issues with explanations and code-level recommendations. |
| -------- | ------------------------------------------------------------------------------ |
| Report   | Summary of all findings with statistics and security overview.                 |
| History  | Timeline of audits, showing when each version was created and analyzed.        |

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2F9R2v2zEWSNamnmiQmLD6%2Fimage.png?alt=media&#x26;token=4bd47c4a-38e5-4b86-babb-aa10d9123e09" alt=""><figcaption><p>Navigate between the Findings, Report, and History tabs to review detailed issues, summaries, and your full audit timeline.</p></figcaption></figure></div>

{% hint style="info" %}
Tip: Use Generate PDF to export your report for sharing or internal documentation
{% endhint %}

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2FgCYJypvUm9RzV4XCIKOP%2Fimage.png?alt=media&#x26;token=145ba3d0-d39a-4f3d-b38e-14fe4f9ff0ff" alt=""><figcaption><p>Review your audit results by severity level and explore each finding with detailed descriptions, AI recommendations, and options to mark issues as resolved.</p></figcaption></figure></div>

***

#### Step 7 — Re-Audit and Iterate

After addressing the reported issues, you can re-run the audit directly from your project screen.

1. Click Re-run Audit.
2. Upload or paste the updated smart contract.

Each iteration improves both your contract and our AI model.

Your history keeps every version, making it easy to track progress and share verification evidence.

{% hint style="warning" %}
Each re-audit counts toward your daily audit limit.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://4148298149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F73azcO5XoRCtlZLD2krN%2Fuploads%2FbIy2Z0Df9TkcvxzjMb3v%2Fimage.png?alt=media&#x26;token=abc910ab-3b92-492b-83cf-0362816ea215" alt=""><figcaption><p>Re-run your audit anytime after making fixes. The History tab tracks every version, showing your progress and helping verify improvements over time.</p></figcaption></figure></div>

***

### 3. Key Features

| Instant Report           | Get detailed audit feedback in minutes.              |
| ------------------------ | ---------------------------------------------------- |
| Expert-Level Suggestions | Actionable improvements written in clear language.   |
| Re-Audit & Versioning    | Compare old and new reports easily.                  |
| Audit History            | Access all past audits anytime.                      |
| User Dashboard           | Manage reports, download results, and track changes. |

### 4. Benefits

| Cost Efficiency     | Catch issues early and reduce time spent on manual audits. |
| ------------------- | ---------------------------------------------------------- |
| Accessibility       | Free to use during beta (10 audits/day).                   |
| Continuous Learning | AI improves through every new analysis.                    |

### 5. Use Cases & Ideal Users

| Developers           | Check code before mainnet deployment.               |
| -------------------- | --------------------------------------------------- |
| Projects             | Run internal audits before other manual audits.     |
| Launchpads           | Quickly validate partner smart contracts.           |
| Educators & Students | Learn security best practices in Solidity and Rust. |

### 6. AI Usage Limits

| Beta Access | 10 audits/day | Resets daily at 00:00 UTC |
| ----------- | ------------- | ------------------------- |

### 7. Supported Languages & Chains

| Solidity | Ethereum, BNB Chain, Polygon, Avalanche |
| -------- | --------------------------------------- |
| Rust     | Solana                                  |

### 8. Security & Privacy

* Non-custodial — contracts never leave your account environment
* End-to-end encrypted during upload and processing
* Reports stored securely for your account only
* You can delete any report at any time

#### Accuracy & Model Improvement

Our AI continuously learns from new patterns and user feedback.

{% hint style="info" %}
TokenFi Shield  complements manual audits but does not replace them. Always double-check findings before deployment.
{% endhint %}

### 9. Support & Contact

Need help or want to report a bug?

* Visit [docs.tokenfi.com](https://docs.tokenfi.com/)
* Join the [TokenFi Telegram Community](https://t.me/tokenfi)
* Email our team at **<hi@tokenfi.com>**