Skip to main content

​
Quickstart

Using your own instance? Start with Self-Hosting, Docker Deployment, or the root deployment guide. The project also runs api.steward.fi for trusted testers.
This guide walks you through creating your first agent with an encrypted wallet, setting policies, and signing a transaction — all using the @stwd/sdk.

​
1. Install the SDK

npm install @stwd/sdk

​
2. Initialize the Client

import { StewardClient } from "@stwd/sdk";

const steward = new StewardClient({
  baseUrl: "https://api.steward.fi",
  apiKey: "your-tenant-api-key",
});
You’ll receive your tenant API key when your tenant is created. This key authenticates all tenant-level operations (agent CRUD, policy management). See API Overview for authentication details.

​
3. Create an Agent with a Wallet

const agent = await steward.createWallet("my-first-agent", "My First Agent");

console.log(agent);
// {
//   id: "my-first-agent",
//   name: "My First Agent",
//   tenantId: "your-tenant-id",
//   walletAddresses: {
//     evm: "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
//     solana: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
//   },
//   createdAt: "2026-03-26T12:00:00.000Z"
// }
Steward automatically generates encrypted EVM and Solana keypairs. The private keys are encrypted with AES-256-GCM and never leave the vault.

​
4. Set Policies

Before an agent can sign transactions, it needs policies. Steward uses default deny — without policies, all operations are rejected. 
await steward.setPolicies("my-first-agent", [
  {
    id: "spending-limit",
    type: "spending-limit",
    enabled: true,
    config: {
      maxPerTransaction: "100000000000000000",  // 0.1 ETH
      maxPerDay: "500000000000000000",          // 0.5 ETH
    },
  },
  {
    id: "approved-addresses",
    type: "approved-addresses",
    enabled: true,
    config: {
      addresses: ["0xDEX_ROUTER_ADDRESS"],
    },
  },
  {
    id: "auto-approve",
    type: "auto-approve-threshold",
    enabled: true,
    config: {
      maxValue: "50000000000000000", // 0.05 ETH — auto-approve below this
    },
  },
]);

​
5. Sign a Transaction

const result = await steward.signTransaction("my-first-agent", {
  to: "0xDEX_ROUTER_ADDRESS",
  value: "10000000000000000", // 0.01 ETH
  chainId: 8453,             // Base mainnet
});

if ("txHash" in result) {
  console.log(`Transaction broadcast! Hash: ${result.txHash}`);
} else if ("status" in result && result.status === "pending_approval") {
  console.log("Transaction requires manual approval:", result.results);
}
If the transaction exceeds the auto-approve threshold but is within spending limits, it enters the approval queue. A tenant admin must call POST /vault/:agentId/approve/:txId to release it. See Vault API for details.

​
6. Check Balance

const balance = await steward.getBalance("my-first-agent", 8453);

console.log(balance);
// {
//   agentId: "my-first-agent",
//   walletAddress: "0x742d35Cc...",
//   balances: {
//     native: "1000000000000000000",
//     nativeFormatted: "1.0",
//     chainId: 8453,
//     symbol: "ETH"
//   }
// }

​
What’s Next?

Architecture

Understand Steward’s three-pillar design.

Policy Guide

Learn about all policy types and configurations.

ElizaOS Plugin

Integrate Steward into an ElizaOS agent.

Self-Hosting

Deploy your own Steward instance.