feat(kit): repivot public surface to establishWallet + earn primitive#16
Conversation
Per kernel decision DEC-2026-06-04: the narrow public Kit wedge is establishWallet_plus_earn. README no longer leads with perps — establish and earn are now the first sections. Perps content is preserved but demoted to a named section after earn. Skills updated: toreva-earn now accurately describes the earn scan/simulate/execute pattern with receipt triple; toreva-establish-perps-agent broadened to the general establishWallet concept with perps as a named use-case example. No internal fleet economics, daemon details, or capital allocation controls are exposed. Dispatched-By: kernel Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: f89311cad0
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| -> Pacifica API agent wallet when Pacifica is selected | ||
| ```bash | ||
| # Minimum — attach delegated authority to your wallet | ||
| toreva_establish({ walletAddress: "your-wallet-address" }) |
There was a problem hiding this comment.
Use a real shell example for establish
This snippet is fenced as bash, but toreva_establish({ ... }) is an MCP tool-style function call, not a shell command; I checked packages/cli/src/index.ts and there is no establish CLI subcommand to handle it. In the new lead README section, users copying the minimum setup example into a terminal will get a shell syntax error before reaching Toreva, so this should either use a non-shell fence/pseudocode label or show an actual supported MCP/CLI invocation.
Useful? React with 👍 / 👎.
Summary
## Establish your walletand## Earnsections; perps content preserved but demoted to a named section after earnskills/toreva-earn.mdrewritten to accurately describe the earn scan/simulate/execute pattern with receipt triple (Kamino + Marginfi)skills/toreva-establish-perps-agent.mdbroadened to cover generalestablishWalletconcept, with perps as a named use-case example rather than the entire framingDecision alignment
Implements kernel decision
DEC-2026-06-04-establishwallet-public-boundary: public Kit wedge =establishWallet_plus_earn. No internal fleet economics, daemon/dispatch details, capital allocation controls, or unpublished strategy exposed.Blocked on Docs/PO
Test plan
pnpm typecheck— 4/4 packages cleanpnpm test— 115/115 tests passDispatched-By: kernel
🤖 Generated with Claude Code