SDKs & Tools
Xian ships tooling for three distinct jobs:
- building and testing contracts
- integrating applications and wallets
- operating higher-level services around a Xian network
Core SDKs And Apps
| Tool | Main use |
|---|---|
| xian-cli | operator CLI plus JSON-first wallet, query, and transaction automation |
| xian-js | TypeScript client, provider contract, relayer clients, and browser integration |
| xian-wallet-browser | browser wallet extension and injected provider |
| xian-wallet-mobile | mobile wallet application |
| xian-py | Python client, watchers, indexed reads, and relayer clients |
| xian-zk | proving toolkit, shielded wallet model, bundle generation, local prover service |
| xian-intentkit | agent-facing automation stack for Xian-native workflows |
| xian-dex-automation | deterministic DEX event automation service for rule-based trades |
Developer Productivity Tools
| Tool | Main use |
|---|---|
| Playgrounds | browser dapp example plus the dedicated contract playground |
| Contracting Hub | curated contract catalog, inspection, ratings, and deployment UI |
| Linter | static validation for contract source before deployment |
| MCP Server | local AI-assistant bridge for wallets, reads, submissions, and DEX flows |
Common Install Paths
TypeScript / browser tooling:
bash
npm install @xian-tech/client @xian-tech/providerPython application SDK:
bash
uv add xian-tech-pyCLI automation and operator tooling:
bash
uv tool install xian-tech-cliLocal contract runtime and testing:
bash
uv add xian-tech-contractingShielded proving toolkit:
bash
uv add xian-tech-zkHow To Choose
- use
xian-tech-contractingwhen you are writing or testing contracts - use
xian-cliwhen you want shell-first automation or operator workflows - use
xian-pyorxian-jswhen you are building apps, services, wallets, or library-level integrations - use
xian-zkwhen you are working with shielded-note or shielded-command flows - use
xian-dex-automationwhen a DEX rule should execute predictably without an AI model deciding the action - use the hub, playground, or MCP server when you want a higher-level developer surface instead of starting from raw SDK calls