Getting Started

npm install @wraith-protocol/sdk

import { Wraith, Chain } from "@wraith-protocol/sdk";

const wraith = new Wraith({
  apiKey: "wraith_live_abc123",
});

// 1. Sign a message with the owner wallet to prove ownership
const message = "Sign to create Wraith agent";
const signature = await wallet.signMessage(message);

// 2. Create the agent
const agent = await wraith.createAgent({
  name: "alice",
  chain: Chain.Horizen,
  wallet: "0xYourWalletAddress",
  signature: signature,
  message: message,
});

console.log(agent.info.id);                          // UUID
console.log(agent.info.addresses[Chain.Horizen]);     // "0x..."
console.log(agent.info.metaAddresses[Chain.Horizen]); // "st:eth:0x..."

const response = await agent.chat("fund my wallet");
// Agent requests testnet tokens from the faucet

const response = await agent.chat("send 0.1 ETH to bob.wraith");

console.log(response.response);
// "Payment sent — 0.1 ETH to bob.wraith via stealth address 0x7a3f..."

console.log(response.toolCalls);
// [{ name: "send_payment", status: "success", detail: "..." }]

const response = await agent.chat("scan for incoming payments");
// Agent scans the chain for announcements matching your stealth keys

const response = await agent.chat("what's my balance?");
// Agent reports native + token balances

const balance = await agent.getBalance();
console.log(balance.native);  // "1.5"
console.log(balance.tokens);  // { ZEN: "100.0", USDC: "50.0" }

const response = await agent.chat("withdraw all to 0xMyWallet");
// Agent warns about privacy risks before executing

// By agent ID
const agent = wraith.agent("agent-uuid-here");

// By owner wallet
const agent = await wraith.getAgentByWallet("0xYourWallet");

// By .wraith name
const agent = await wraith.getAgentByName("alice");

try {
  await agent.chat("send 100 ETH to bob.wraith");
} catch (err) {
  console.error(err.message); // "Insufficient balance"
}