A multichain agent has one .wraith name with independent stealth identities on every chain you specify. The AI agent routes operations to the correct chain based on context — you describe what you want and it figures out where to execute it.
Creating a multichain agent
Pass an array of chains to createAgent instead of a single chain value.
import { Wraith, Chain } from "@wraith-protocol/sdk";
const wraith = new Wraith({ apiKey: "wraith_live_abc123" });
const agent = await wraith.createAgent({
name: "alice",
chain: [Chain.Horizen, Chain.Stellar, Chain.Ethereum],
wallet: "0xYourWallet",
signature: "0xSignature",
});
console.log(agent.info.chains);
// [Chain.Horizen, Chain.Stellar, Chain.Ethereum]
console.log(agent.info.addresses);
// {
// horizen: "0xabc...",
// stellar: "GABC...",
// ethereum: "0xdef..."
// }
console.log(agent.info.metaAddresses);
// {
// horizen: "st:eth:0x...",
// stellar: "st:xlm:...",
// ethereum: "st:eth:0x..."
// }
Deploy on all chains
Use Chain.All to deploy on every chain the platform supports in a single call.
const agent = await wraith.createAgent({
name: "alice",
chain: Chain.All,
wallet: "0xYourWallet",
signature: "0xSignature",
});
Chain-aware chat
The AI agent infers the target chain from your message. When it can’t determine the chain unambiguously, it asks.
Explicit chain
Inferred chain
Ambiguous cases
Specify the chain directly in your message for guaranteed routing.await agent.chat("send 0.1 ETH to bob.wraith on horizen");
await agent.chat("send 10 XLM to carol.wraith on stellar");
When a currency only exists on one supported chain, the agent infers the chain automatically.await agent.chat("send 10 XLM to carol.wraith");
// XLM -> Stellar (unambiguous)
await agent.chat("send 100 ZEN to bob.wraith");
// ZEN -> Horizen (unambiguous)
When a currency exists on multiple chains, the agent asks for clarification rather than guessing.await agent.chat("send 0.1 ETH to bob.wraith");
// "ETH exists on both Horizen and Ethereum. Which chain do you mean?"
await agent.chat("horizen");
// "Payment sent — 0.1 ETH to bob.wraith on Horizen..."
The agent never executes an ambiguous operation without confirmation. Provide the chain name in your follow-up to continue.
Cross-chain balance
Check balances across all chains with a single message.
await agent.chat("what's my balance on all chains?");
// "Balances:
// Horizen: 1.5 ETH, 100 ZEN, 50 USDC
// Stellar: 500 XLM
// Ethereum: 0.3 ETH"
Cross-chain scanning
Scan for incoming stealth payments on every chain at once.
await agent.chat("scan for payments on all chains");
// "Incoming payments:
// Horizen:
// - 0.1 ETH at 0xabc...
// Stellar:
// - 10 XLM at GABC..."
Privacy across chains
Each chain maintains independent stealth address activity. Payments on Horizen are not visible on Stellar and the privacy check analyzes each chain separately.
await agent.chat("run privacy check on all chains");
// "Privacy Analysis:
// Horizen: Score 85/100
// - 5 unspent stealth addresses
// Stellar: Score 95/100
// - All clear"
Privacy is isolated per chain by design. An observer on Ethereum cannot correlate your activity on Horizen, even if both chains are registered to the same agent name.
How it works under the hood
A multichain agent is a single entity with multiple chain registrations. The TEE derives a distinct key pair per chain using a chain-specific derivation path:
wraith/agent/{agentId}/horizen -> secp256k1 keys
wraith/agent/{agentId}/stellar -> ed25519 keys
wraith/agent/{agentId}/ethereum -> secp256k1 keys
Single vs. multichain comparison
| Feature | Single-chain | Multichain |
|---|
| Chains | One | Multiple (array or Chain.All) |
| Addresses | One | One per chain |
| Stealth meta-addresses | One | One per chain |
| Chat routing | Direct, no inference needed | AI infers chain from context |
| Key derivation | One path | One path per chain |
| Privacy analysis | Single chain | Per-chain, independent |
| SDK interface | agent.chat(), agent.getBalance(), etc. | Identical — same interface |
The SDK interface is identical for single and multichain agents. Migrate from single to multichain by changing the chain parameter at creation time — nothing else in your code changes.