Metadata-Version: 2.4
Name: wallet-doctor
Version: 0.2.2
Summary: Solana blockchain forensics SDK for AI agents. Pay-per-call, no API keys. x402 v2 compliant.
Author-email: Wallet Doctor <wallet-doctor@smartlivingcircle-lab.org>
License: MIT
Project-URL: Homepage, https://wallet-doctor-agents.pages.dev
Project-URL: Repository, https://github.com/zikriz/wallet-doctor-sdk
Project-URL: Documentation, https://github.com/zikriz/wallet-doctor-sdk/blob/main/README.md
Project-URL: Bug Tracker, https://github.com/zikriz/wallet-doctor-sdk/issues
Keywords: solana,blockchain,forensics,ai-agents,x402,model-context-protocol,mcp,wallet,tracer,wallet-doctor,ai
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"
Requires-Dist: httpx>=0.27; extra == "mcp"
Provides-Extra: registry
Requires-Dist: requests>=2.31; extra == "registry"

<!-- mcp-name: io.github.zikriz/wallet-doctor -->
# Wallet Doctor — Solana forensics for AI agents

13 pay-per-call Solana blockchain forensics services. Pay with **SOL, USDC on Base, or USDC on Polygon**. No API keys. Builds in 10 seconds.

## Install

```bash
pip install wallet-doctor
```

## Quickstart

```python
from wallet_doctor import WalletDoctorClient

client = WalletDoctorClient()
print(client.services())     # price list

# After sending a 0.001 SOL tx to the service payTo address:
result = client.balance("<target-wallet>", tx_hash="<your_solana_tx_signature>")
print(result["data"])
```

## Services & pricing (SOL)

| Service | Price (SOL) | Description |
|---------|-------------|-------------|
| balance | 0.001 | SOL + SPL token balances |
| txtrace | 0.005 | Last 20 transactions, parsed |
| approvals | 0.005 | Token approvals + risk flags |
| token_safety | 0.005 | Honeypot, mint/freeze authority |
| drain_forensics | 0.025 | Full drain attack analysis |
| portfolio_audit | 0.025 | Complete security audit |
| nft_audit | 0.005 | NFT holdings + risk flags |
| smart_money | 0.01 | Whale / smart wallet detection |
| price_oracle | 0.001 | DEX price for any SPL token |
| token_holders | 0.01 | Top 10 holders + concentration |
| liquidity_check | 0.015 | LP depth + lock status |
| launch_analysis | 0.02 | New token launch risk |
| wallet_labels | 0.005 | Known scam interactions |

## Payment

x402 v2 protocol across three networks:
- **Solana mainnet**: `4dX3VmkGFJHj1XZbWN1MbRYnCaxYWEEN21LjkmCe9JRE`
- **Base mainnet**: `0x689FC7087aACB915593e3Da5763cdfac2A04ef9C`
- **Polygon mainnet**: same as Base

## Live API endpoints

- Manifest: https://wallet-doctor-agents.pages.dev/agent.json
- llms.txt: https://wallet-doctor-agents.pages.dev/llms.txt
- Browse: https://github.com/zikriz/wallet-doctor-sdk
- MCP server: https://github.com/zikriz/wallet-doctor-sdk#mcp-server

## MCP registry

Publish to official MCP registry:

```bash
python -m wallet_doctor.publish
```

## License

MIT © Wallet Doctor
