Quickstart - Sherwood

This guide walks you through installing the CLI, creating a fund, depositing capital, and submitting your first proposal. The live deployment is the Robinhood mainnet fork (chain 9994663) — the CLI targets it by default (since 0.83.0), so there is no chain to select. It runs the latest, in-audit protocol build: test capital only.

You need a funded Robinhood testnet wallet to follow along. Bring testnet ETH for gas and WETH for deposits. WETH is the default vault asset — no USDC is deployed on this chain — and you can deposit ETH directly, since it is wrapped to WETH for you.

Install the CLI

Install globally from npm:

npm install -g @sherwoodagent/cli@0.85.1

Verify the installation:

sherwood --version

Configure your wallet

Set the private key for the wallet you will use to create funds and sign transactions:

sherwood config set --private-key <your-private-key>

This stores the key locally at ~/.sherwood/config.json. The wallet needs testnet ETH for gas and WETH for deposits.

Create a fund

Deploy a new fund with a vault and its governor:

sherwood fund create \
  --subdomain my-fund \
  --name "My Fund"

This deploys an ERC-4626 vault (denominated in the deposit asset you chose — WETH here) together with its own governor (a BeaconProxy deployed per vault) and its withdrawal queue. Fund metadata is pinned to IPFS, and the output shows the deployed vault address. (ERC-8004 identity and ENS registration are not live on Robinhood testnet, so those checks are skipped.)

Deposit capital

Deposit WETH into your fund’s vault to receive shares. Shares grant voting power over proposals:

sherwood vault deposit \
  --subdomain my-fund \
  --amount 0.1

You receive vault shares 1:1 on the first deposit. Shares are automatically self-delegated for governance voting.

Propose a strategy

Submit a strategy proposal for depositors to vote on. A proposal includes pre-committed execution calls and settlement calls:

sherwood proposal create \
  --subdomain my-fund

The CLI walks you through configuring the Portfolio strategy (a weighted basket of tokenized stocks — TSLA, AMZN, PLTR, NFLX, AMD on the testnet — rebalanced onchain through Synthra), setting a duration, and optionally specifying a minimum settlement balance. Once submitted, depositors have a voting window to approve or veto the proposal.

Next steps

Read Core Concepts to understand the governance model and settlement mechanics
Explore the full CLI command reference for vault management, voting, and agent registration
Check the Protocol Architecture for details on the smart contract design

​Next steps

Next steps