@stwd/eliza-plugin

The @stwd/eliza-plugin package provides drop-in Steward wallet management for ElizaOS agents.

Installation

npm install @stwd/eliza-plugin

pnpm add @stwd/eliza-plugin

bun add @stwd/eliza-plugin

Plugin Structure

import { stewardPlugin } from "@stwd/eliza-plugin";

// stewardPlugin: Plugin
// {
//   name: "@stwd/eliza-plugin",
//   services: [StewardService],
//   actions: [signTransactionAction, transferAction, providerAction],
//   providers: [walletStatusProvider, balanceProvider, providerActionsProvider],
//   evaluators: [approvalRequiredEvaluator],
// }

Exports

// Default export
export default stewardPlugin;

// Named exports
export { stewardPlugin } from "@stwd/eliza-plugin";
export { StewardService } from "@stwd/eliza-plugin";
export type { StewardPluginConfig } from "@stwd/eliza-plugin";
export { signTransactionAction } from "@stwd/eliza-plugin";
export { transferAction } from "@stwd/eliza-plugin";
export { providerAction, providerActionsProvider } from "@stwd/eliza-plugin";
export { walletStatusProvider } from "@stwd/eliza-plugin";
export { balanceProvider } from "@stwd/eliza-plugin";
export { approvalRequiredEvaluator } from "@stwd/eliza-plugin";

StewardService

The core service that initializes the Steward SDK connection.

class StewardService extends Service {
  getClient(): StewardClient;
}

Configuration via environment variables:

Variable	Required	Description
`STEWARD_API_URL`	Yes	Steward API base URL
`STEWARD_API_KEY`	No*	Tenant API key
`STEWARD_JWT`	No*	Agent JWT (required for provider actions)
`STEWARD_AGENT_ID`	Yes	Agent ID in Steward
`STEWARD_TENANT_ID`	For registration	Tenant to register the agent in
`STEWARD_AUTO_REGISTER`	No	Set to `true` to explicitly register a missing agent; defaults to `false`

*At least one of STEWARD_API_KEY or STEWARD_JWT is required. Use the agent JWT for first-class provider actions. The plugin stays disabled when the API URL, authentication, or agent identity is missing. Auto-registration additionally requires both an API key and tenant ID. There is no local-signing fallback: an unavailable Steward service leaves wallet operations unavailable. Accessing from runtime:

const service = runtime.getService<StewardService>("steward");
const client = service.getClient();

// Use the client directly
const balance = await client.getBalance(agentId, 8453);

Actions

signTransactionAction

Signs and broadcasts an EVM transaction through Steward. Trigger: Agent determines a blockchain transaction is needed (via LLM reasoning). Parameters extracted from conversation:

to — Destination address
value — Amount in wei
data — Optional calldata
chainId — Target chain

Example conversation:

User: "Approve 100 USDC on Uniswap"
Agent: I'll sign an approval transaction for USDC on Uniswap.
       [Calls signTransactionAction]
       ✅ Transaction signed! Hash: 0x8d7592b...

transferAction

Transfers native tokens (ETH/SOL) to an address. Parameters:

to — Recipient address
amount — Amount (human-readable, e.g., “0.1 ETH”)

Example:

User: "Send 0.05 ETH to 0x742d35Cc..."
Agent: Sending 0.05 ETH to 0x742d35Cc...
       [Calls transferAction]
       ✅ Sent! TX: 0xa1b2c3...

providerAction

Invokes the v2 workspace-scoped provider authority flow. This is distinct from the legacy capability proxy: the action is bound to a registered workspace, provider account, operation, exact request digest, and case id.

// Action parameters supplied by the runtime/agent
{
  workspaceId: "workspace_123",
  providerAccountId: "provider_account_123",
  operationKey: "github.issue.list",
  arguments: { owner: "Steward-Fi", repo: "steward" },
  idempotencyKey: "stable-retry-key"
}

When policy requires approval, the action reports blocked: true and explicitly says it has not executed. A policy/access denial is also surfaced as a persisted action id rather than mislabeled as an unsubmitted request. If idempotencyKey is omitted, the plugin derives a stable retry key from the Eliza message id and canonical public parameters; without either stable identity it fails closed. It never accepts provider credentials as parameters.

Providers

walletStatusProvider

Injects wallet context into the agent’s prompt:

Steward Wallet Status:
- Agent ID: my-trading-agent
- EVM Address: 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18
- Solana Address: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
- Status: Connected

balanceProvider

Injects current balance into the agent’s prompt:

Current Balance:
- ETH (Base): 1.05 ETH

providerActionsProvider

Polls the agent-scoped status API for actions invoked during the current runtime and injects their status and case id into agent state. It does not call the protected approval, case-manifest, or evidence routes; those retain their human session and recent-MFA gates.

Evaluators

approvalRequiredEvaluator

Checks for pending transactions in the Steward approval queue. When a transaction requires manual approval, it injects context for the agent to inform the user.

Usage in Character Config

import { stewardPlugin } from "@stwd/eliza-plugin";

export default {
  name: "TradingBot",
  plugins: [stewardPlugin],
  system: `You are a trading agent with a Steward-managed wallet.
You can check balances, sign transactions, and transfer tokens.
Always confirm transaction details before signing.`,
  settings: {
    model: "gpt-4o",
  },
};

ElizaOS Integration Guide — Step-by-step setup
StewardClient Reference — Underlying SDK client
Agent Setup Guide — Creating agents with policies

​@stwd/eliza-plugin

​Installation

​Plugin Structure

​Exports

​StewardService

​Actions

​signTransactionAction

​transferAction

​providerAction

​Providers

​walletStatusProvider

​balanceProvider

​providerActionsProvider

​Evaluators

​approvalRequiredEvaluator

​Usage in Character Config

​Related