StewardClient
TheStewardClient class provides typed methods for all Steward API operations.
Constructor
When both
apiKey and bearerToken are provided, bearerToken takes priority. Use apiKey for tenant operations and bearerToken for agent operations.Agent Methods
createWallet
Creates a new agent with encrypted EVM and Solana wallets.listAgents
Lists all agents for the authenticated tenant. The SDK walks stable API pages at the maximum page size and fails closed on duplicate or non-progressing pages, while retaining the historical array return type.getAgent
Gets a single agent by ID.createWalletBatch
Creates multiple agents in one request with optional shared policies.Signing Methods
signTransaction
Signs and optionally broadcasts an EVM transaction.signTypedData
Signs EIP-712 structured data.signSolanaTransaction
Signs a serialized Solana transaction.signBitcoinPsbt
Signs a scoped Bitcoin PSBT for an agent wallet. Steward returns a signed PSBT and a StewardtransactionId; it does not broadcast.
referenceId and, where accepted by
your deployment, the same Idempotency-Key header. If finalize: true returns
finalizedTxHex, avoid blindly retrying broadcast attempts; first check whether
the returned Bitcoin txId is already known to your broadcaster or indexer.
signMessage
Signs an arbitrary message.Encrypted Key Import Methods
Agent-vault import helpers require a tenant owner/admin bearer session with recent MFA. User-wallet import helpers require the authenticated user’s bearer session with recent MFA. Both flows use a server X25519 init response and then submit only an encrypted envelope; do not include a plaintextprivateKey
field.
aad. Wrong-agent and wrong-wallet-index submits fail without consuming the
original session; validated submits consume the session atomically, so replay
fails.
Query Methods
getBalance
Gets the native token balance for an agent’s wallet.getAddresses
Gets all wallet addresses across chain families.getHistory
Gets the complete transaction history for an agent. The SDK walks every bounded API page before returning the historical array result.rpcPassthrough
Proxies a read-only RPC call.Global Wallet Methods
Global wallet helpers require a user bearer token. PasswalletIndex when the
user selected a non-default embedded wallet; the server binds consent, scan,
confirmation, audit, and execution to that same wallet index plus wallet agent
id/address. Omitting walletIndex selects index 0.
App Client Methods
Tenant app-client helpers expose the sameTenantAppClient shape documented in
the control-plane API. Native app clients can set iOS and Android allowlists
with allowedBundleIds and allowedPackageNames; device-code auth then checks
X-Steward-Native-Bundle-Id, X-Steward-Native-Package-Name, or matching JSON
fields against the enabled client.
Tenant User Methods
bulkRemediateTenantWalletPolicyViolations
Removes selected EVM/Solana linked wallet accounts from tenant members after an owner/admin has reviewed a one-third-party-wallet policy violation report. Requires a user bearer token scoped to the tenant with recent MFA.Policy Methods
getPolicies
Gets all policies for an agent.setPolicies
Replaces all policies for an agent.Additional API Areas
This page covers the coreStewardClient methods. The archived root SDK reference also covered webhook, tenant configuration, dashboard, and approval APIs; those surfaces now live in the API reference:
Error Handling
All methods throwStewardApiError on failure: