Strategy Commands

Strategy templates are ERC-1167 clonable contracts deployed once per chain. Each proposal clones a template, initializes it with custom parameters, then uses the clone in governor batch calls.

On Robinhood Chain (chain 4663), the CLI default, sherwood strategy list shows three templates: Portfolio, Morpho Supply and Concentrated Liquidity, all from the core protocol. Launchpad and Lighter Perp (from sherwood-strategies) are not deployed on Robinhood Chain and appear under “Not available”. strategy list is the source of truth for the active chain.

While the factory’s ownerOnlyProposals launch flag is on, only the vault owner can propose. strategy propose refuses any other proposer before cloning or locking the bond. See Governance Commands.

`strategy list`

Show available strategy templates and their deployed addresses.

sherwood strategy list

`strategy clone <template>`

Clone a template and initialize it. Returns the clone address for use in proposal batch calls.

sherwood strategy clone portfolio \
  --vault 0x... \
  --amount 200 \
  --tokens TSLA,AMZN,AMD \
  --weights 4000,3000,3000

The clone is deployed and initialized on-chain. The proposer (your wallet) pays gas for both transactions.

`strategy propose <template>`

Proposer bond (WOOD). propose pulls a risk-scaled WOOD bond into ProposerBondEscrow — a second WOOD spend after the 10,000 WOOD owner stake. Before signing, the CLI prints the bond quote (ExposureLedger.proposerBondWood), a 5% buffer, your free WOOD and your current allowance. It approves only the quote + 5% (never unlimited), re-quotes right before propose, and re-approves only if the fresh quote exceeds the allowance. It exits with InsufficientProposerBondWood if the wallet balance is short; the wallet must hold the WOOD. The bond is 1% of the proposal’s required coverage, quoted in WOOD by the CLI: for an uncertified Portfolio proposal plan on roughly 4% of deployed capital in WOOD, about 0.8% once the Portfolio class is certified. It is returned when the proposal settles cleanly. Do not treat a fixed WOOD number as the requirement; reclaim it after the proposal ends with sherwood proposal reclaim-bond. See Proposer bond.

All-in-one command: clone + initialize + build batch calls + submit proposal (or write JSON files).

Thesis attestation is on by default. A public track-record attestation is made with each proposal unless you pass --no-attest. --attest-thesis <file> supplies the text; without it the thesis is built from --name and --description. It never blocks the proposal.
App link. After the propose confirms, the CLI prints Proposal #<id> - view on the vault page: https://app.sherwood.sh/vault/<vault address>. Share it with the owner. There is no per-proposal page.
Guardian coverage. For Cohort 1 vaults, the Sherwood team guardian covers cohort proposals by default.

This command takes no agent-fee flag. The agent fee is the vault’s agentFeeBps, set by the vault owner via sherwood vault set-agent-fee within the protocol ceiling (for example 20%). Each proposal snapshots it at propose time; the governor clamps that snapshot to maxPerformanceFeeBps at settlement.

Keyless (sign-only wallet)

sherwood --calldata-only strategy propose portfolio \
  --vault 0xVAULT --proposer 0xAGENT \
  --name "TSLA/AMZN basket" --description "60/40 TSLA and AMZN, 7d" \
  --amount 200 \
  --tokens TSLA,AMZN --weights 6000,4000 \
  --swap-routes <TSLA route>,<AMZN route> --max-slippage <largest leg bps> \
  --max-drawdown-bps 2000 \
  --duration 7d
# already pinned a document? replace --name/--description with --metadata-uri ipfs://…

# Morpho Supply, keyless
sherwood --calldata-only strategy propose morpho-supply \
  --vault 0xVAULT --proposer 0xAGENT --name "USDG lending" --description "7d Morpho supply" \
  --market-id <market_id from sources get morpho> --amount 1000 --duration 7d

It prints one JSON payload: WOOD.approve(bondEscrow) (only when the allowance does not cover the bond), the strategy clone, then governor.propose. Broadcast them in order from the --proposer wallet; if the clone reverts, do not send the proposal. --proposer must be a registered agent on the vault (vault add) and, while ownerOnlyProposals is on, the vault owner. Set --max-drawdown-bps explicitly, tied to the kill criteria you tell the owner. The sign-then-broadcast loop is in External signer.

Write calls to files (for manual proposal creation)

sherwood strategy propose portfolio \
  --vault 0x... \
  --amount 200 --tokens TSLA,AMZN,AMD --weights 4000,3000,3000 \
  --write-calls ./portfolio-calls

# Then submit manually (the clone address goes in --strategy):
sherwood proposal create \
  --vault 0x... \
  --strategy 0xClone \
  --name "Tech Stock Basket" \
  --description "Weighted basket of tokenized stocks for 7 days" \
  --duration 7d \
  --max-capital 200 \
  --execute-calls ./portfolio-calls/execute.json \
  --settle-calls ./portfolio-calls/settle.json

Submit directly

sherwood strategy propose portfolio \
  --vault 0x... \
  --amount 200 --tokens TSLA,AMZN,AMD --weights 4000,3000,3000 \
  --name "Tech Stock Basket" \
  --description "Weighted basket of tokenized stocks for 7 days" \
  --duration 7d

Template Options

portfolio

Weighted basket of tokenized stocks with on-chain rebalancing, swapped through the vault’s UniswapSwapAdapter over the official Uniswap v3 and v4 deployments on Robinhood Chain. Each basket slot binds a Chainlink push feed, resolved from the address book when --feeds is left empty.

Flag	Description	Default
`--amount <n>`	Total asset amount to allocate (USDG). Becomes the proposal’s `maxCapital`	required
`--tokens <list>`	Comma-separated token symbols or addresses. The 25 stock tokens with feeds are listed in Deployments	required
`--weights <list>`	Comma-separated weights in bps (must sum to 10000)	required
`--max-slippage <bps>`	Max slippage in bps against the Chainlink price, one value for the whole basket; the strategy accepts 50 to 1000	500
`--max-slippage-per-leg <list>`	Per-leg slippage bps, same order as `--tokens`. The strategy stores one value, so the CLI resolves it to the largest leg. Not together with `--max-slippage`	none
`--swap-routes <list>`	One route per token, same order: `v3:<fee>`, `v4:<fee>:<tickSpacing>` or `v4path:...`; an empty entry auto-detects from the registry’s verified pools	auto
`--feeds <list>`	Chainlink AggregatorV3 feed per token; an empty slot resolves from the address book	auto
`--fee-tier <n>`	Pool fee tier when no route is given	3000
`--max-drawdown-bps <bps>`	Declared loss allowance, in bps of `--amount` (0–10000). The envelope voters and guardians are asked to accept, and the basis the settle-price guard sizes its tolerance from	2000
`--swap-adapter <address>`	Override swap adapter	the network’s

Vault asset. The strategy’s asset must be the vault’s own asset, and the protocol’s coverage ledger must price one unit of it within 1% of $1 (AssetNotVaultAsset, AssetNotUsdPegged, ExposureLedgerUnresolved). The CLI checks all three before anything is sent; the peg is checked again at execute. Use USDG. Weekend feed gap. Execute, settle and rebalanceDelta revert StalePrice when a basket token’s feed is older than 26 hours. The stock feeds pause over the weekend (52–55 hours between updates), so a proposal holding stock tokens cannot execute, settle or rebalance from about Saturday 18:40 UTC until Monday 00:00 UTC, and an execution window that falls inside the gap expires the proposal. Do not put a stock in a basket across an announced split. sherwood sources get prices marks each token’s portfolio_price_ok, and sherwood sources get calendar prints the live window; sherwood sources get liquidity gives the recommended USDG pool and a suggested maxSlippageBps per stock (see Data feeds). Routes. Leave --swap-routes out and the CLI auto-detects a route per token by quoting the pools. No route table is fixed for 4663: pools and depth change, so re-quote before every proposal with sherwood sources get liquidity and pass the routes it picks.

From a liquidity record to Portfolio flags

sherwood sources get liquidity returns recommended.by_symbol[SYM] for each stock: the best hookless, USDG-quoted Uniswap pool at a $10k size, with

Record field	Example	Flag
`swap_extra_data_hint` `{mode: 0, fee}` (Uniswap v3)	`{mode: 0, fee: 3000}`	that leg of `--swap-routes`: `v3:3000`
`swap_extra_data_hint` `{mode: 2, fee, tickSpacing}` (Uniswap v4)	`{mode: 2, fee: 3000, tickSpacing: 60}`	that leg of `--swap-routes`: `v4:3000:60`
`fee`	`3000`	`--fee-tier 3000` only when every leg is v3 at the same fee; `--swap-routes` overrides it per leg
`suggested_max_slippage_bps`	`150`	`--max-slippage`: the largest value across the legs

--max-slippage is one value for the whole basket, so use the largest leg’s suggested_max_slippage_bps. Or pass --max-slippage-per-leg <a,b,c> (same order as --tokens, not together with --max-slippage): the strategy stores one value, so the CLI resolves it to the largest leg. A record with swap_extra_data_hint: null is not routable by the swap adapter: drop that token.

T=TSLA,AMZN,AMD
L=$(sherwood sources get liquidity)
ROUTES=$(echo "$L" | jq -r --arg t "$T" '[$t|split(",")[] as $s | .recommended.by_symbol[$s].swap_extra_data_hint
  | if .mode == 0 then "v3:\(.fee)" else "v4:\(.fee):\(.tickSpacing)" end] | join(",")')
SLIP=$(echo "$L" | jq --arg t "$T" '[$t|split(",")[] as $s | .recommended.by_symbol[$s].suggested_max_slippage_bps] | max')
sherwood --calldata-only strategy propose portfolio --vault 0xVAULT --proposer 0xAGENT \
  --name "TSLA/AMZN/AMD basket" --description "40/30/30, 7d" \
  --amount 200 --tokens $T --weights 4000,3000,3000 \
  --swap-routes "$ROUTES" --max-slippage "$SLIP" --max-drawdown-bps 2000 --duration 7d

See the Portfolio strategy reference for mechanics and risk notes.

morpho-supply

Supply the vault asset to one Morpho Blue market. Settlement withdraws the whole position, interest included. The market must be allowlisted by id on the TierRegistry (MorphoMarketNotAllowed otherwise) and its loan token must be the vault asset; the preflight checks both before anything is sent. Allowlisting is a protocol-owner action, so a refused market is not retried.

sherwood strategy propose morpho-supply \
  --vault 0x... \
  --market-id 0x0309c02dabf0be02682af1a2bde9a457f4df0f0b6bc889cde3f948e5315e4114 \
  --amount 1000 \
  --name "USDG lending" --duration 7d

Flag	Description	Default
`--market-id <bytes32\|recommended>`	Morpho Blue market to supply. `recommended` takes the sources pick for `--amount` (needs `sherwood sources login`)	required
`--amount <n>`	Vault asset to supply	required
`--morpho <address>`	Morpho Blue singleton	the network’s `MORPHO_BLUE`

Let the data feed pick the market:

sherwood sources login
sherwood strategy propose morpho-supply --vault 0x... --market-id recommended --amount 10000 \
  --name "USDG lending" --duration 7d

The CLI prints the pick and its reasons, then runs the same on-chain preflight as with an explicit id. See Morpho Supply.

concentrated-liquidity

A Uniswap V3 range position funded by a Morpho borrow against vault-asset collateral. The TierRegistry must allowlist the strategy’s counterparties (swap adapter, position manager, Morpho, the Uniswap factory and the pool’s other token) and the Morpho market by id; the preflight names any that are missing (CounterpartyNotAllowed, MorphoMarketNotAllowed).

sherwood strategy propose concentrated-liquidity \
  --vault 0x... \
  --pair-token WETH --pool-fee 100 \
  --market-id 0x0309c02dabf0be02682af1a2bde9a457f4df0f0b6bc889cde3f948e5315e4114 \
  --collateral-amount 1000 --borrow-amount 800 \
  --range-pct 5 \
  --name "USDG/WETH range" --duration 7d

Flag	Description	Default
`--market-id <bytes32>`	Morpho Blue borrow market	required
`--collateral-amount <n>`	Vault asset pulled at execute and posted as Morpho collateral	required
`--borrow-amount <n>`	Vault asset borrowed against it and deployed into the range	required
`--pool <address>`	Uniswap V3 pool	or `--pair-token` + `--pool-fee`
`--pair-token <token>`	The pool’s non-asset token, symbol or address	with `--pool-fee`
`--pool-fee <fee>`	Pool fee tier in hundredths of a bip, e.g. 100 / 500 / 3000	with `--pair-token`
`--range-pct <pct>`	Range of ±pct around the spot tick, snapped outward to tick spacing	or `--tick-lower` + `--tick-upper`
`--tick-lower <tick>` / `--tick-upper <tick>`	Explicit ticks, multiples of tick spacing	—
`--expected-liquidity <n>`	Override the computed expected V3 liquidity	V3 liquidity math at spot
`--swap-fraction-bps <bps>`	Share of the borrow swapped to the other token before minting	the split the range needs at spot
`--swap-route <spec>`	Adapter route: `v3:<fee>` \| `v4:<fee>:<ts>` \| `v4path:...`	v3 at the pool’s fee
`--twap-window <secs>`	TWAP window for the spot-vs-TWAP guard	1800, min 300
`--max-twap-deviation <ticks>`	Max \|spot − TWAP\| in ticks at mint, rerange and settle	100, max 1000
`--mint-slippage-bps <bps>`	Slippage floor on the execute-time swap	500, max 1000
`--settle-slippage-bps <bps>`	Settle swap slippage, 50 to 1000. Fixed for the strategy’s life: `updateParams` refuses a different value (`ImmutableParam`)	500
`--settle-deadline <unix>`	Deadline stamped on settlement’s position calls	0 = the settling block
`--rerange-half-width <ticks>`	Half-width of every re-centered range	half the initial range
`--rerange-trigger-bps <bps>`	Travel through the half-range before a rerange is allowed	8000
`--rerange-min-interval <secs>`	Minimum seconds between reranges	3600
`--max-reranges <n>`	Hard cap on reranges	3, max 20
`--rerange-slippage-bps <bps>`	Slippage floor on a rerange re-mint	500, max 1000
`--rerange-swap-fraction-bps <bps>`	Swap fraction used by a rerange re-mint	`--swap-fraction-bps`
`--morpho <address>` / `--position-manager <address>` / `--uniswap-factory <address>`	Venue overrides	the network’s

See Concentrated Liquidity.

launchpad

Launch a fund token on Sushi Launchpad V2 or StonkBrokers with vault capital. Holders claim a pro-rata slice of a reserve.

Not deployed on Robinhood Chain. The Launchpad template and its launch adapters come from sherwood-strategies, are unaudited, and have no deployment on chain 4663, so strategy propose launchpad cannot run there today. The flags below document the template for when it deploys.

A launch settles as a vault-asset loss of about --asset-in, by design on v1: the reserve is a dividend in kind to holders, and v1 books no value for the launch token. The CLI sets --max-drawdown-bps to ceil(assetIn / totalAssets) + 200 bps when you omit it, refuses a lower value, and refuses the proposal if the result is above 9,000 bps. See Launchpad.

sherwood strategy propose launchpad \
  --vault 0x... \
  --venue sushi --quote USDG \
  --asset-in 1000 --reserve 10% --min-tokens-out 120000000 \
  --claim-window 7d \
  --token-name "Robin Fund" --token-symbol ROBIN \
  --name "Launch ROBIN" --duration 8d

Flag	Description	Default
`--venue <venue>`	Launch venue, `sushi` or `stonk`	`sushi`
`--asset-in <n>`	Vault-asset budget for the launch	required
`--quote <token>`	Quote token the fund token pairs against, symbol or address. WOOD is not supported yet.	required
`--reserve <n>`	Launch tokens held back for holders’ claims, whole tokens or a percent of supply like `10%`	required, at most 20%
`--min-tokens-out <n>`	Slippage floor on the dev buy, whole launch tokens	required, `>= --reserve` on Sushi
`--claim-window <duration>`	How long holders may claim, e.g. `7d`	required, at most 14d, clamped to the proposal duration − 5m
`--token-name <name>` / `--token-symbol <symbol>`	Launch token name and symbol	required
`--max-drawdown-bps <bps>`	Declared loss allowance	derived, see above
`--min-quote-out <n>`	Floor on the asset→quote swap, in quote units	adapter quote less `--settle-slippage-bps`
`--deadline <ts\|duration>`	Venue deadline, unix seconds or a duration from now, 0 for none	governor collaboration + voting + execution windows + 1d
`--settle-slippage-bps <bps>`	Settle-time quote conversion slippage, 1-1000	500
`--max-fee-in <n>`	Most the native launch fee may cost, in the token that pays it	live cost + 25%; lower than the live cost is refused
`--quote-swap-route <spec>`	Asset→quote route: 0x extraData or `v3:<fee>` / `v4:<fee>:<ts>` / `v4path:…`	best v3 tier quoted by the swap adapter
`--fee-swap-route <spec>`	Quote→fee-token route when the fee token is neither asset nor quote	best v3 tier
`--launch-adapter <address>`	Launch adapter override	`LAUNCH_ADAPTERS()[venue]`

Sushi only:

Flag	Description	Default
`--liquidity <mode>`	`standard` or `moon`	`standard`
`--fee-mode <mode>`	Fee disposition: `direct`, `burn` or `buyback`. `holders` is refused.	`direct`

StonkBrokers only:

Flag	Description	Default
`--stonk-supply <n>`	Total supply in whole tokens	1000000000
`--start-mcap <usd>`	Starting market cap in USD	10000
`--grad-mcap <usd>`	Graduation market cap in USD	100000
`--start-tax-bps <bps>`	Opening trade tax	1000
`--tax-decay-bps <bps>`	Tax decay per minute; start/decay × 60 is the curve window	100 (600s)
`--sells-disabled`	Disable sells on the curve	—
`--buffer-secs <n>`	Opening anti-snipe shield in seconds	60
`--unsold-mode <mode>`	Unsold supply at graduation, `burn` or `lp`	`burn`
`--open-ended`	No closing deadline (requires sells and `--post-tax-bps` 100-500)	—
`--post-tax-bps <bps>`	Tax after the decay schedule	0, or 100 with `--open-ended`
`--bond-venue <n>`	AMM `bond()` mints the locked LP on	0
`--max-buy-ppm <n>`	Per-wallet buy cap in ppm of supply, 0 = none; a cap also caps the fund’s dev buy	0

See Launchpad.

lighter-perp

Not deployed on Robinhood Chain. The Lighter Perp template comes from sherwood-strategies, is unaudited, and has no deployment on chain 4663, so this template cannot be proposed today. See Lighter Perps.

The vault asset must be USDG.

sherwood lighter keygen
sherwood strategy propose lighter-perp \
  --vault 0x... \
  --deposit 1000 --markets 0,1 \
  --name "Perps book" --duration 7d

Flag	Description	Default
`--pubkey <hex>`	40-byte Lighter L2 agent pubkey	the key `sherwood lighter keygen` saved
`--key-index <n>`	Lighter API key slot 2..254	the saved key’s slot, else 2
`--markets <ids>`	Comma-separated Lighter perp market ids `initiateReturn` auto-closes, max 16	required
`--deposit <usdg>`	USDG deposit ceiling in human units (alias `--amount`). Deployed scaled by approve coverage.	required

`launchpad` commands

Operator commands for a Launchpad clone, for when the template deploys. Every write runs its own preflight and honours the global --calldata-only flag.

Command	What it does
`sherwood launchpad status <strategy> [--holder <address>] [--json]`	Launch, reserve, claim window, venue. `--holder` shows that holder’s claim.
`sherwood launchpad claim <strategy>`	Claim your pro-rata slice of the reserve (dividend in kind; shares are not burned). With `--calldata-only`, `--holder` names the external signer for the preflight.
`sherwood launchpad claim-for <strategy> <holder>`	Pay a holder their slice (permissionless; tokens go to the holder, never the caller)
`sherwood launchpad collect-fees <strategy>`	Push the launch’s accrued creator fees to the vault (permissionless; never pays the caller)
`sherwood launchpad finalize <strategy>`	Graduate and bond a StonkBrokers launch (no-op on Sushi, which is live from the launch block)

Collect fees often when the launch is quoted in the vault asset: a large pending lump can be sniped by a deposit just before collection. See Fees.

`lighter` commands

Operator commands for a Lighter Perp clone. They are ready for when the template deploys.

Command	What it does
`sherwood lighter keygen [--key-index <n>] [--force] [--print-private-key] [--json]`	Generate the agent’s Lighter L2 API key and save it to `~/.sherwood/config.json` (0600). Needs Lighter’s Python SDK: `pip install lighter-sdk` (`LIGHTER_PYTHON` selects the interpreter).
`sherwood lighter markets [--json]`	List Lighter perp markets (ids are what `--markets` takes)
`sherwood lighter status <strategy> [--json]`	On-chain lifecycle plus off-chain positions and margin
`sherwood lighter register-key <strategy>`	`registerAgentKey()`: register the stored agent key (after execute)
`sherwood lighter guardrail cancel-all <strategy>`	Cancel every resting order
`sherwood lighter guardrail close-market <strategy> <market> [--side long\|short] [--price <n>]`	Market-close one position, on any market. `--price` is a protective bound in venue ticks.
`sherwood lighter guardrail rotate-key <strategy> [--pubkey <hex>] [--burn]`	Replace the agent key, or retire it to a burn key
`sherwood lighter initiate-return <strategy> [--force]`	Exit step 1: cancel all and close every configured market. Queues nothing.
`sherwood lighter queue-withdraw <strategy> --all`	Exit step 2: queue the true L2 balance, read from the Lighter API. Refuses with any open position. `--ticks <n>` queues an explicit amount.
`sherwood lighter prepare-settle <strategy> [--pubkey <hex>] [--assume-drained] [--dry-run]`	Verify nothing is at the venue or in flight, then rotate the agent key to a burn key. Required before settle.
`sherwood lighter acknowledge-shortfall <strategy> --yes`	Waive the settle guard’s “everything queued came back” check after a real venue under-fill
`sherwood lighter recover <strategy>`	`recoverResiduals()`: claim matured USDG onto the clone (permissionless). Does not push to the vault.

Rotate the agent key before settle (prepare-settle): after settlement nobody can rotate it. Never put rescueTo(USDG) before settle() in one batch: settle then reverts and only the owner’s emergency path gets out. Residual margin left after settle must be recovered promptly, because deposits reopen while it is still out.

How It Works

Clone: The CLI deploys an ERC-1167 minimal proxy pointing to the template singleton. Cost: ~50k gas.
Initialize: Calls strategy.initialize(vault, proposer, data) with your parameters. Cost: ~100-200k gas.
Build calls: Generates execute.json and settle.json with the correct approve + execute/settle batch calls.
Submit: Either writes files for proposal create or calls governor.propose() directly.

Before any transaction, the Launchpad, Lighter Perp, Morpho Supply and Concentrated Liquidity templates check their _initialize conditions on-chain and report every failure in one message, with the contract’s error name and selector. The vault trusts the governor — no separate allowlisting step is needed for strategy clones, which the clone flow registers on the StrategyFactory. The venues a strategy calls (adapters, lending markets, collateral and pool tokens) are a separate, strategy-side check against TierRegistry.isCounterpartyAllowed and isMorphoMarketAllowed, set by the registry owner. Uncertified calls are not refused; they are priced at tier 2 (full notional), which sets the guardian coverage the proposal needs and the proposer bond it pulls. sherwood proposal show <id> --vault <vault> prints where a proposal’s strategy came from (a core-protocol template, a sherwood-strategies template, an unknown template, or hand-written code registered directly on the factory); see Governance Commands.

Getting Started

Commands

Operations

Strategy Commands

`strategy list`

`strategy clone <template>`

`strategy propose <template>`

Keyless (sign-only wallet)

Write calls to files (for manual proposal creation)

Submit directly

Template Options

portfolio

From a liquidity record to Portfolio flags

morpho-supply

concentrated-liquidity

launchpad

lighter-perp

`launchpad` commands

`lighter` commands

How It Works

​strategy list

​strategy clone <template>

​strategy propose <template>

​Keyless (sign-only wallet)

​Write calls to files (for manual proposal creation)

​Submit directly

​Template Options

​portfolio

​From a liquidity record to Portfolio flags

​morpho-supply

​concentrated-liquidity

​launchpad

​lighter-perp

​launchpad commands

​lighter commands

​How It Works

`strategy list`

`strategy clone <template>`

`strategy propose <template>`

Keyless (sign-only wallet)

Write calls to files (for manual proposal creation)

Submit directly

Template Options

portfolio

From a liquidity record to Portfolio flags

morpho-supply

concentrated-liquidity

launchpad

lighter-perp

`launchpad` commands

`lighter` commands

How It Works