Add with-vaultsfyi example

[ryanrodenbaugh]

Summary

Adds a new examples/with-vaultsfyi companion example for the vaults.fyi cookbook recipe (tkhq/docs#652). vaults.fyi is one API for DeFi yield discovery, ready-to-sign transaction payloads, and position tracking across 80+ protocols.

The example mirrors with-morpho's structure (CLI scripts, @turnkey/viem + @turnkey/sdk-server workspace deps, viem 2.x, dotenv) and adds @vaultsfyi/sdk as a third-party dep, matching the SDK calls used in the cookbook.

Scripts

• discover.ts — list top vaults vaults.fyi recommends for the user's wallet, ranked by APY across every supported protocol
• createPolicy.ts — dry-run deposit + redeem against vaults.fyi, extract the actual tx.to addresses, and build one Turnkey policy from them. Works for ERC-4626 vaults that target the vault directly (Morpho, Aave, Euler) and for protocols that route through intermediary contracts (Veda Boring Vaults via a Teller, queue-based redemptions, etc.)
• deposit.ts — sign the ordered transactions vaults.fyi returns for a deposit (typically approve + deposit), waiting for confirmations between steps
• balance.ts — list every vault position the user holds across every supported network and protocol
• redeem.ts — redeem the full position with all=true
• claimRewards.ts — two-step rewards/context → rewards/claim flow

Why one address allowlist

vaults.fyi handles all protocol-specific encoding internally, so an address allowlist is sufficient. The dry-run pattern in createPolicy.ts discovers the right addresses for any vault without hardcoding them.

Notes

• Uses lib: ["es2022"] in tsconfig.json because @vaultsfyi/sdk transitively pulls in ox@0.11.3 which uses Error.cause and override modifiers.
• @vaultsfyi/sdk v2.3.1 is the published version; SDK method names (getActions, getDepositOptions, getPositions, getRewardsTransactionsContext, getRewardsClaimActions) are all verified against @vaultsfyi/sdk's client.d.ts.

Test plan

• pnpm install -r — clean
• pnpm build-all — clean
• pnpm typecheck — clean (in examples/with-vaultsfyi/)
• End-to-end run on Base mainnet with a real Turnkey wallet and vaults.fyi API key (pending)

🤖 Generated with Claude Code

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​vaultsfyi/​sdk@​2.3.1

View full report

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit 17e3928:

Sandbox	Source
@turnkey/example-react-components	Configuration