Enables AI agents to perform secure, self-custody Ethereum transactions with automated risk analysis and multi-chain support.
Also known as temrjan/rustok, rustok, rustok-agent-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.2
- Last commit
- Sep 8, 2026
- License
- AGPL-3.0
What is Rustok Wallet MCP?
Rustok Wallet enables AI agents to perform secure, self-custody Ethereum transactions with automated risk analysis and multi-chain support.
Summary generated from the project's README
About Rustok Wallet MCP server
Rustok Wallet provides a self-custody solution for Ethereum and various layer-2 networks including Arbitrum, Base, Optimism, and zkSync. It is designed for both human users via a mobile application and AI agents through specialized MCP tools. The system uses a single BIP39 seed phrase to manage addresses across multiple chains, offering unified balance tracking and routing.
Security is central to the architecture through the txguard engine. This component performs pre-sign analysis by decoding calldata, simulating execution with revm, and applying specific security rules to identify risks like unlimited approvals or known scams. Developers can interact with these capabilities using a CLI, a public HTTP API, or the mobile interface. The platform supports a tiered trust model for autonomous agents, allowing for read, preview, and execution gates that can require console approval or phone-based signatures.
What you can do with it
- 1Analyze transaction securityA developer can use the CLI to perform a full security scan on raw EVM transaction data to check for risks.
- 2Manage multi-chain assetsUsers can check their total balance across Ethereum, Arbitrum, Base, Optimism, and zkSync using a single command.
- 3Automate agentic transactionsAI agents can utilize MCP tools with fail-closed capabilities to manage on-chain actions through a trust ladder.
- 4Decode smart contract interactionsThe system can decode ERC-20 approve calldata to help developers understand specific contract instructions.
Written from the project's README. Every use case is checked against a quote from it.
How to install Rustok Wallet MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Rustok Wallet MCP in Claude Code
$ claude mcp add --env 'RUSTOK_AGENT_PASSWORD=<YOUR_RUSTOK_AGENT_PASSWORD>' rustok -- npx -y rustok-agent-mcpInstall Rustok Wallet MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"rustok": {
"command": "npx",
"args": [
"-y",
"rustok-agent-mcp"
],
"env": {
"RUSTOK_AGENT_PASSWORD": "<YOUR_RUSTOK_AGENT_PASSWORD>"
}
}
}
}Install Rustok Wallet MCP in VS Code
.vscode/mcp.json
{
"servers": {
"rustok": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rustok-agent-mcp"
],
"env": {
"RUSTOK_AGENT_PASSWORD": "<YOUR_RUSTOK_AGENT_PASSWORD>"
}
}
}
}Install Rustok Wallet MCP in VS Code CLI
$ code --add-mcp '{"name":"rustok","type":"stdio","command":"npx","args":["-y","rustok-agent-mcp"],"env":{"RUSTOK_AGENT_PASSWORD":"<YOUR_RUSTOK_AGENT_PASSWORD>"}}'Install Rustok Wallet MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"rustok": {
"command": "npx",
"args": [
"-y",
"rustok-agent-mcp"
],
"env": {
"RUSTOK_AGENT_PASSWORD": "<YOUR_RUSTOK_AGENT_PASSWORD>"
}
}
}
}Install Rustok Wallet MCP in Codex
$ codex mcp add rustok --env 'RUSTOK_AGENT_PASSWORD=<YOUR_RUSTOK_AGENT_PASSWORD>' -- npx -y rustok-agent-mcpInstall Rustok Wallet MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.rustok] command = "npx" args = ["-y", "rustok-agent-mcp"] [mcp_servers.rustok.env] RUSTOK_AGENT_PASSWORD = "<YOUR_RUSTOK_AGENT_PASSWORD>"
Install Rustok Wallet MCP in Gemini CLI
$ gemini mcp add -s user -e 'RUSTOK_AGENT_PASSWORD=<YOUR_RUSTOK_AGENT_PASSWORD>' rustok npx -- -y rustok-agent-mcpInstall Rustok Wallet MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"rustok": {
"command": "npx",
"args": [
"-y",
"rustok-agent-mcp"
],
"env": {
"RUSTOK_AGENT_PASSWORD": "<YOUR_RUSTOK_AGENT_PASSWORD>"
}
}
}
}Configuration
RUSTOK_AGENT_PASSWORDRequiredSecretPassword to unlock the agent wallet
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletemrjan/rustok is public and reachablegithub.com/temrjan/rustok ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-08github.com/temrjan/rustok ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from rustok-agent-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubRustok
Ethereum wallet with chain abstraction and transaction security engine.
Status: Production — Phase 7 DONE — Android verified on Sepolia; iOS supported. React Native app with real on-chain transactions, full onboarding, and txguard live analysis.
Website: rustokwallet.com | X: @rustokwallet | Agent editions: github.com/rustok-org
What is this?
Rustok is a self-custody Ethereum wallet built around two ideas:
- Your keys, your chains — one seed phrase controls addresses across Ethereum, Arbitrum, Base, Optimism, and zkSync. Balance and routing are unified; you pick the chain, the wallet handles the rest.
- Trust but verify — every transaction is analyzed by
txguardbefore signing. It decodes calldata, runs security rules, simulates execution viarevm, and enriches findings with threat intelligence.
The mobile app (Android + iOS) is the primary interface. A public HTTP API and CLI are available for headless txguard analysis.
2026 evolution: the same self-custody core now ships as a wallet for AI agents — MCP tools with fail-closed capability gating (read / preview / execute) and a three-rung trust ladder (autonomous agent → console-approved → phone-signed). See rustokwallet.com and the rustok-org repositories (mcp, console, mobile, paraswap-mcp, uniswap).
Features
- Multi-chain wallet — unified balance, send, and receive across 5 mainnet chains + Sepolia testnet
- BIP39 seed phrase — MetaMask-compatible path (
m/44'/60'/0'/0/0), cross-device recovery - txguard analysis — pre-sign security scan with risk badge and per-finding breakdown
- PIN + Biometric lock — Argon2id-hashed PIN, Face ID / fingerprint unlock, background auto-lock
- Onboarding — create wallet (4-step wizard + phrase quiz), import from seed phrase, or recover from lockout / biometric change
- Activity history — real transaction feed with pending-state tracking and explorer links
- Theme — light / dark / system with design-token consistency across the UI
Architecture
┌─────────────────────────────────────────────────────────────┐
│ Mobile App (Android / iOS) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌────────────────┐ │
│ │ Wallet │ │ Activity│ │ TxGuard │ │ Settings │ │
│ │ Tab │ │ Tab │ │ Tab │ │ (Appearance, │ │
│ │ │ │ │ │ │ │ Biometric, │ │
│ │ • Hero │ │ • TX │ │ • Risk │ │ Auto-lock, │ │
│ │ card │ │ list │ │ badge │ │ Network) │ │
│ │ • Send │ │ • Pull │ │ • Per- │ │ │ │
│ │ • QR │ │ refresh│ │ finding│ │ │ │
│ └─────────┘ └─────────┘ └─────────┘ └────────────────┘ │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ React Navigation v7 • Zustand 5 • NativeWind v4 ││
│ │ Reanimated 4 • MMKV • Keychain • Argon2id ││
│ └─────────────────────────────────────────────────────────┘│
└───────────────────────────┬─────────────────────────────────┘
│ JS ↔ Rust Bridge
┌───────────────────────────▼─────────────────────────────────┐
│ react-native-rustok-bridge │
│ (uniffi-bindgen-react-native 0.31) │
└───────────────────────────┬─────────────────────────────────┘
│ FFI
┌───────────────────────────▼─────────────────────────────────┐
│ Rust Workspace │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ rustok-core │ │ txguard │ │ rustok-api │ │
│ │ │ │ │ │ │ │
│ │ • keyring │ │ • parser │ │ Axum HTTP server │ │
│ │ • provider │ │ • rules │ │ /health │ │
│ │ • router │ │ • simulator │ │ /check-address │ │
│ │ • send │ │ • enrichment│ │ /decode │ │
│ │ • explorer │ │ │ │ │ │
│ │ • explainer │ │ 8 security │ │ Self-hosted │ │
│ │ • convert │ │ rules │ │ (see deploy/) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ rustok-cli │ │ rustok-types│ │rustok-mobile-bindings│ │
│ │ │ │ │ │ │ │
│ │ CLI binary │ │ Shared DTOs │ │ uniffi FFI exports │ │
│ │ (decode, │ │ (no crypto │ │ for iOS / Android │ │
│ │ analyze, │ │ deps) │ │ │ │
│ │ wallet, │ │ │ │ │ │
│ │ send) │ │ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Tech Stack
| Layer | Technology |
|---|---|
| Mobile | React Native 0.85.2, React 19.2.3, TypeScript 5.8 |
| Navigation | React Navigation v7 (bottom-tabs, native-stack) |
| Styling | NativeWind v4, TailwindCSS 3.4, design-token system |
| State | Zustand 5, MMKV (persistent), React Native Keychain (secrets) |
| Animations | Reanimated 4.3, React Native Worklets, Gesture Handler |
| Bridge | uniffi-bindgen-react-native 0.31.0-2 |
| Language | Rust (edition 2024) |
| EVM | revm v36, alloy-evm v0.30 |
| Ethereum | alloy-rs v1.8 (provider, signer, primitives, consensus) |
| Crypto | BIP39 (m/44'/60'/0'/0/0), AES-256-GCM, Argon2id, secp256k1 |
| HTTP | Axum 0.8, Tower HTTP (CORS, trace) |
| Async | Tokio, Futures |
| Serialization | Serde, Serde JSON |
| CLI | clap v4 |
| Logging | tracing, tracing-subscriber |
Quick Start
Mobile App
Prerequisites: Node.js ≥ 22.11, Android SDK (for Android) or Xcode + CocoaPods (for iOS).
# Install dependencies
cd mobile && npm install
# Start Metro bundler
npx react-native start --port 8081
# Android (separate terminal)
cd android && ./gradlew app:installDebug -PreactNativeDevServerPort=8081
# Windows: .\gradlew.bat app:installDebug -PreactNativeDevServerPort=8081
# iOS (macOS only, separate terminal)
cd ios && pod install && cd .. && npx react-native run-ios
For physical Android devices:
adb reverse tcp:8081 tcp:8081
Detailed mobile docs: See
mobile/README.mdfor onboarding flow, bridge surface, DEV escape hatches, and Android/Windows specifics.
Rust Workspace
# Run all tests
cargo test --workspace
# Build CLI
cargo build -p rustok --release
# Run API server locally
cargo run -p rustok-api
CLI Examples
Transaction Security Analysis
# Decode ERC-20 approve calldata
rustok decode \
--to 0xdAC17F958D2ee523a2206206994597C13D831ec7 \
--data 0x095ea7b3000000000000000000000000000000000000000000000000000000000000dead00000000000000000000000000000000000000000000000000000000000f4240
# Full security analysis (parse + rules + verdict)
# Exit codes: 0=allow, 1=warn, 2=block
rustok analyze \
--to 0xdAC17F958D2ee523a2206206994597C13D831ec7 \
--data 0x095ea7b3ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
Wallet Operations
# Generate a new encrypted wallet
rustok wallet new --password "your-secure-password"
# Check unified balance across Ethereum, Arbitrum, Base, Optimism, zkSync
rustok wallet balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# Show wallet info from keystore file
rustok wallet info --keystore 0xabc...def.json --password "your-password"
# Send ETH (txguard security check mandatory, testnet by default)
rustok wallet send --keystore wallet.json --password "pwd" --to 0xd8dA...6045 --amount 0.1
Security Rules (txguard)
| Rule | Severity | Trigger |
|---|---|---|
unlimited_approval |
Warning | approve(spender, type(uint256).max) |
set_approval_for_all |
Warning | setApprovalForAll(operator, true) |
permit_to_unknown |
Danger | EIP-2612 permit to unknown spender |
permit_unlimited |
Warning | Permit with value == U256::MAX |
known_scam |
Forbidden | Address in scam database |
unknown_function |
Warning | Unrecognized function selector |
value_with_calldata |
Warning | ETH sent with contract call |
send_to_contract |
Info | Transfer to contract address |
Supported Chains
| Chain | ID | Status |
|---|---|---|
| Ethereum | 1 | Active |
| Arbitrum One | 42161 | Active |
| Base | 8453 | Active |
| Optimism | 10 | Active |
| zkSync Era | 324 | Active |
| Sepolia | 11155111 | Testnet |
txguard API
Public API for transaction security analysis (rustok-api, Axum). Self-hosted — see deploy/.
| Endpoint | Method | Description |
|---|---|---|
/health |
GET | Health check |
/check-address |
POST | Address security check via GoPlus (malicious flag, risk level, risks) |
/decode |
POST | Decode and analyze raw EVM transaction (action, risk score, findings) |
# Check address
curl -X POST https://your-rustok-api-host/check-address \
-H "Content-Type: application/json" \
-d '{"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"}'
# Decode transaction
curl -X POST https://your-rustok-api-host/decode \
-H "Content-Type: application/json" \
-d '{"to": "0xdAC17F958D2ee523a2206206994597C13D831ec7", "data": "0x095ea7b3000000000000000000000000000000000000000000000000000000000000dead00000000000000000000000000000000000000000000000000000000000f4240"}'
Deployed via Docker + Caddy on 185.197.195.191 (deploy/).
Tests
517 tests, 0 failures
- Rust workspace: 231 tests (txguard, core, types, mobile-bindings)
- Mobile (Jest): 286 tests (components, stores, hooks, screens)
Pre-commit gates:
# Rust
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
# Mobile
cd mobile && npm run typecheck && npm run lint && npm run test
Project Layout
rustok/
├── mobile/ # React Native app (primary UI)
│ ├── src/
│ │ ├── screens/ # Wallet, Activity, TxGuard, Settings, Onboarding
│ │ ├── components/ # Design system primitives
│ │ ├── navigation/ # AppShell, navigators
│ │ ├── stores/ # Zustand + MMKV state
│ │ ├── hooks/ # Selectors and logic
│ │ ├── lib/ # Bridge, formatting, explorers
│ │ └── theme/ # Design tokens
│ ├── android/ # Gradle project
│ └── ios/ # Xcode project
│
├── packages/
│ └── react-native-rustok-bridge/ # uniffi JS ↔ Rust bridge package
│
├── crates/ # Rust workspace
│ ├── txguard/ # Transaction security engine
│ ├── core/ # Wallet logic (keyring, provider, router, send)
│ ├── types/ # Shared DTOs
│ ├── api/ # Axum HTTP server
│ ├── cli/ # CLI binary
│ └── rustok-mobile-bindings/ # uniffi FFI exports
│
├── deploy/ # Docker + Caddy deployment
└── docs/ # Architecture, phase handoffs, incident reports
License
Rustok is dual-licensed:
- AGPL-3.0-or-later — open source. Free for any use that complies with AGPL terms, including making source code of derivative works and network-accessible services available to users.
- Commercial License — available from the copyright holder for uses that cannot comply with AGPL-3.0 (e.g. closed-source Apple App Store or Google Play distribution, bundling into proprietary products).
See NOTICE.md for a summary of licensing, trademarks, and contribution terms.
Trademarks
"Rustok" and "txguard" are trademarks of Temrjan Khasenov. Source code is AGPL-3.0, but the marks are not — see TRADEMARK.md.
Visual assets
Logos, icons, and brand imagery are not under AGPL-3.0. See ASSETS-LICENSE.md.
Contributing
Contributions are accepted under the Developer Certificate of Origin (DCO). See CONTRIBUTING.md.
Copyright (c) 2025-2026 Temrjan Khasenov.
Rustok Wallet MCP questions
How do I add Rustok Wallet MCP to Claude Code?
Run claude mcp add --env 'RUSTOK_AGENT_PASSWORD=<YOUR_RUSTOK_AGENT_PASSWORD>' rustok -- npx -y rustok-agent-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Rustok Wallet MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What chains are supported by Rustok?
The wallet supports Ethereum, Arbitrum, Base, Optimism, and zkSync, along with the Sepolia testnet.
How does the transaction security engine work?
The txguard engine analyzes transactions by decoding calldata, running security rules, and simulating execution via revm to provide risk assessments.
Can I use Rustok for AI agents?
Yes, the core is evolving into a wallet for AI agents featuring MCP tools with gated execution capabilities.
Is there a way to analyze transactions via API?
Yes, a public HTTP API is available for headless txguard analysis, including endpoints for address checks and transaction decoding.