@temporalabs/treasury 0.1.1 → 0.1.3

package/NOTICE

@@ -3,8 +3,10 @@ Copyright 2026 Tempora Labs
 
 This product includes software developed by Tempora Labs.
 
-The third-party components bundled into dist/mcp-server.mjs keep their own licences. Each is
-reproduced in full, for the exact version bundled, in THIRD_PARTY_NOTICES.md.
+The third-party components bundled into dist/treasury.mjs keep their own licences. Each is
+reproduced in full, for the exact version bundled, in THIRD_PARTY_NOTICES.md. The same holds for
+dist/connect-page.js, the page `treasury connect` serves, whose components are reproduced in
+THIRD_PARTY_NOTICES.connect-page.md.
 
 "Tempora", "Tempora Labs" and "Agent Treasury" are names of Tempora Labs. The Apache License
 (section 6) does not grant permission to use them beyond describing where the work came from.

package/README.md

@@ -11,16 +11,28 @@
 
 
 Open Agent Treasury (OAT) helps agents manage on-chain capital. Its first skill, **Earn**, lets
-agents inspect Tempora-curated vaults on Base, track USDC positions, and prepare deposits and
-withdrawals. It ships as an agent plugin, an MCP server, and a TypeScript/JavaScript library.
+agents inspect vaults curated by Tempora Labs on Base, Arbitrum One, Robinhood Chain, Ethereum, Monad and Solana, track positions, and prepare deposits and
+withdrawals. It ships as an agent plugin, a command-line program, and a TypeScript/JavaScript library.
 
-**OAT prepares transactions. Your signer executes them.** It never holds private keys, signs,
-or sends transactions. You decide how much capital an agent may put to work.
+**OAT prepares transactions. Your wallet executes them.** It never holds private keys or signs: with
+`treasury connect` your agent opens a page where you connect your own wallet — a browser wallet, or
+an email or social login — and confirm each transaction; or it hands you unsigned calls for any signer.
+A transaction goes out only from your own wallet, after you approve it there. You decide how much capital an agent may put to work.
 
 > **Experimental — pre-1.0. Real funds, real risk.** Returns are variable, capital is at risk,
 > and withdrawals depend on available liquidity. Review every transaction before signing and
 > read the [risks](docs/risks.md) before depositing.
 
+## Two ways to use the vaults
+
+- **In a browser, at [app.temporalabs.com](https://app.temporalabs.com).** Connect a wallet, then deposit
+  and withdraw from the page. The app shows the Cash Plus vaults it currently supports, which can be fewer
+  than OAT offers.
+- **With an agent, through OAT.** Your agent quotes, prepares and confirms deposits and withdrawals through
+  the plugin or the CLI, and you approve each transaction in your own wallet.
+
+Either way the vaults are the same on-chain contracts.
+
 ## What you can do
 
 - **Inspect vaults:** check assets, fees, and deposit access.
@@ -28,51 +40,50 @@ or sends transactions. You decide how much capital an agent may put to work.
 - **Track a position:** see its value, deposits, and earnings from on-chain records.
 - **Prepare a withdrawal:** check how much is withdrawable now and build unsigned calls.
 
-Earn currently supports **USDC in, USDC out** through Tempora's ERC-4626 vaults on Base.
-See the [eight `earn_*` tools](docs/tools.md) for inputs, outputs, and limits.
+Earn currently supports **USDC in, USDC out** through Tempora Labs' ERC-4626 vaults on Base,
+Arbitrum One, Ethereum and Monad, through a Kamino vault on Solana, and **USDG in, USDG out** on Robinhood Chain. Base is the default chain, and Test 2B its
+default vault; the agent asks which chain when you have not said, and the funds have to be on that
+chain already. See [Vaults](#vaults).
+See the [command reference](docs/tools.md), the eight `earn` commands and the five `connect` commands, for inputs, outputs, and limits.
 
 ## Quick start
 
-**Requires Node.js 22+ on your `PATH`.** Use a keyed Base RPC; the public fallback rate-limits quickly.
+**Requires Node.js 22+ on your `PATH`.** Use a keyed RPC for each chain you use; the public fallbacks rate-limit quickly.
 
 ### Claude Code
 
 ```bash
-export TREASURY_RPC_BASE=https://...  # replace with your Base RPC URL
-claude plugin marketplace add TemporaLabs/treasury@v0.1.1
+export TREASURY_RPC_BASE=https://...      # replace with your Base RPC URL
+export TREASURY_RPC_ARBITRUM=https://...  # only if you will use a vault on Arbitrum One
+export TREASURY_RPC_ROBINHOOD=https://... # only if you will use a vault on Robinhood Chain
+export TREASURY_RPC_ETHEREUM=https://...  # only if you will use a vault on Ethereum
+export TREASURY_RPC_MONAD=https://...     # only if you will use a vault on Monad
+export TREASURY_RPC_SOLANA=https://...    # only if you will use the vault on Solana
+claude plugin marketplace add TemporaLabs/treasury@v0.1.3
 claude plugin install treasury@treasury
 ```
 
-Restart your Claude Code session after installing so the MCP tools connect. Keep the `TemporaLabs/treasury@v0.1.1` ref
+Start a new Claude Code session after installing so the Earn skill loads. Keep the `TemporaLabs/treasury@v0.1.3` ref
 explicit so the install stays on a release rather than tracking the default branch. Upgrading an
 earlier install? Run `claude plugin marketplace remove treasury` first, then the two `claude plugin` lines above
 ([details](docs/install.md#upgrading-an-earlier-install)).
 
 The plugin is the [`plugin/`](plugin/) folder of this repository: its manifests, the Earn skill, and a
-copy of this repository's own server bundle, made in the same commit.
+copy of this repository's own CLI bundle and the page `treasury connect` serves, made in the same commit. The skill runs it with `node`, one
+command at a time; nothing stays running.
 
-### Other MCP hosts
+### Any agent with a shell
 
 ```bash
-npm install @temporalabs/treasury@0.1.1
-```
-
-Add the server to your host's MCP configuration, replacing the path and RPC URL:
-
-```json
-{
-  "mcpServers": {
-    "treasury": {
-      "command": "node",
-      "args": ["<absolute-project-path>/node_modules/@temporalabs/treasury/dist/mcp-server.mjs"],
-      "env": { "TREASURY_RPC_BASE": "https://..." }
-    }
-  }
-}
+npm install --save-exact @temporalabs/treasury@0.1.3
+npx --no-install treasury earn --help     # every command and flag, as JSON
 ```
 
-Running the bundle by path, as shown, works for every version; from v0.1.1 the `treasury-mcp` command also starts the server.
-For library usage, host setup, and troubleshooting, see [installation](docs/install.md).
+Each command prints one JSON document; a refusal exits 1 with `{ "error": … }` on stderr.
+`treasury --help` points to [`llms.txt`](llms.txt), the guide an agent without the plugin should read first: the rules the
+plugin's Earn skill carries (which questions to ask the operator, what to show before a first deposit) and every command with its flags.
+It is generated from that skill and the command descriptions, and CI fails when it drifts.
+For library usage, other hosts, and troubleshooting, see [installation](docs/install.md).
 
 ### Try it
 
@@ -80,20 +91,64 @@ Ask your agent:
 
 > Show me the available vaults and their risks. Then prepare a 25 USDC deposit into the default vault.
 
-OAT returns unsigned calls for your signer to review and execute. Preparing a deposit moves no money.
+To try the demo vault or another chain, name it: *“…into the demo vault”*, or *“…on Arbitrum”*.
+
+With a browser on the machine, you sign in once with `treasury connect`. For each deposit the agent first
+shows you a fixed confirmation text, and only on your yes opens a page where you confirm each call in your
+own wallet. Otherwise OAT returns unsigned calls for your signer. Preparing a deposit moves no money.
 Later, ask: **“What is my position worth, and how much can I withdraw now?”**
 
 ## Vaults
 
-The default, **Cash Plus USDC (Test 2)**, uses Morpho Vault V2 and is open to any account.
-
-Explore the default vault in the [Morpho dashboard](https://app.morpho.org/base/vault/0x040fCA12673778FEED5DA7b2ccFbbAb0cc0134Cf/tempora-labs-cash-plus-usdc-test-2#overview) for a visual overview.
-
-**Cash Plus USDC (Test 2A)** uses IPOR Fusion and requires whitelist access. Both are experimental
-vaults using real USDC, not bank savings accounts. Neither currently has a lock-up, but liquidity
-can limit withdrawals.
-
-Tempora Labs curates these vaults and can set fees. OAT offers Tempora's vaults; it does not compare
+A command that names no vault or chain uses **Cash Plus USDC (Test 2B)** on Base; the agent still asks
+which chain first when you have not said. These are Tempora Labs' curated test vaults, on six chains: Base,
+Arbitrum One, Robinhood Chain, Ethereum, Monad and Solana. There are other options, and a demo.
+
+| | vault | chain | choose it by |
+|---|---|---|---|
+| **Default** | **Cash Plus USDC (Test 2B)** | <img src="docs/assets/chains/base.webp" alt="" width="20" height="20"> Base | naming nothing, or `--chain base` |
+| **Demo** | **Cash Plus USDC (Test 2)** | <img src="docs/assets/chains/base.webp" alt="" width="20" height="20"> Base | `--vault tlCashPlusUSDC2` |
+| Option | **Cash Plus USDC (Test 2C)** | <img src="docs/assets/chains/arbitrum.webp" alt="" width="20" height="20"> Arbitrum One | `--chain arbitrum` |
+| Option | **Cash Plus USDG (Test 2D)** | <img src="docs/assets/chains/robinhood.webp" alt="" width="20" height="20"> Robinhood Chain | `--chain robinhood` |
+| Option | **Cash Plus USDC (Test 2E)** | <img src="docs/assets/chains/ethereum.webp" alt="" width="20" height="20"> Ethereum | `--chain ethereum` |
+| Option | **Cash Plus USDC (Test 2F)** | <img src="docs/assets/chains/monad.webp" alt="" width="20" height="20"> Monad | `--chain monad` |
+| Option | **Cash Plus USDC (Test 2G)** | <img src="docs/assets/chains/solana.webp" alt="" width="20" height="20"> Solana | `--chain solana` |
+| Option | **Cash Plus USDC (Test 2A)** | <img src="docs/assets/chains/base.webp" alt="" width="20" height="20"> Base | `--vault tlCashPlusUSDC2A` (whitelist only) |
+
+Chain logos are the marks of their respective owners, shown only to identify the chains; the icons come from
+[DefiLlama](https://defillama.com)'s chain icon set.
+
+- **Test 2B, the default.** A Morpho Vault V2 on Base, open to any account. Its first position is a
+  savings-rate token rather than a lending vault, and its other two positions differ from Test 2's too
+  ([how](docs/vaults.md#offered-today)). [BaseScan](https://basescan.org/address/0x91BcEbA5feCB9E92d80F1845B55cC56621E9352F);
+  Morpho's own app has no page for it.
+- **Test 2, the demo.** The same kind of vault, and the one to show people: it has a page on Morpho's
+  app, [here](https://app.morpho.org/base/vault/0x040fCA12673778FEED5DA7b2ccFbbAb0cc0134Cf/tempora-labs-cash-plus-usdc-test-2#overview).
+  Its three positions are different vaults from Test 2B's, and the first is a lending vault. Open to any
+  account, but an agent uses it only when it is named.
+- **Test 2C, Arbitrum One.** A Morpho Vault V2 over native USDC, open to any account.
+  [Arbiscan](https://arbiscan.io/address/0x4057a63953142Ac2b3E5dB1954Fc14d578662587). The USDC has to
+  be on Arbitrum already; OAT does not bridge.
+- **Test 2D, Robinhood Chain.** A Morpho Vault V2 over **USDG**, not USDC, open to any account.
+  [Blockscout](https://robinhoodchain.blockscout.com/address/0x758f00731943aA88e8C7fB709e0B727903B4F833).
+  The USDG has to be on Robinhood Chain already.
+- **Test 2E, Ethereum.** A Morpho Vault V2 over USDC, open to any account.
+  [Etherscan](https://etherscan.io/address/0x2AA9B1F12bbFE1E01dcb4DD52E6836d68416e3B6). Gas on
+  Ethereum costs far more than on the other chains, which matters for a small deposit.
+- **Test 2F, Monad.** A Morpho Vault V2 over USDC, open to any account.
+  [MonadScan](https://monadscan.com/address/0x163295A4d4381745A205DC5E9A436a3f51791593).
+- **Test 2G, Solana.** A Kamino vault over USDC, open to any account.
+  [Solscan](https://solscan.io/account/8qV54zrW2piQgBbVaUUtGajf4KuVDKLUDquHv9VZBfS7). It takes a Solana
+  wallet (`treasury connect wallet --chain solana`), the account needs a little SOL for fees, and every
+  withdrawal keeps up to 0.001 USDC in the vault per instruction (a charge Kamino sets for every vault on its program, and can change).
+- **Test 2A.** IPOR Fusion, listed so an admitted account can read and exit its position.
+
+When you have not said which chain, the agent shows these and asks before it prepares a deposit.
+
+All of them are experimental vaults using real funds (USDC, or USDG on Robinhood Chain), not bank savings accounts. None currently has a
+lock-up, but liquidity can limit withdrawals.
+
+Tempora Labs curates these vaults and can set fees. OAT offers Tempora Labs' vaults; it does not compare
 them against the market or promise the best yield. It reports your position's value and earnings,
 not a quoted APY.
 
@@ -101,14 +156,15 @@ See [vault details](docs/vaults.md) for addresses, access rules, fees, and dated
 
 ## Security
 
-- **No keys or custody:** your wallet holds the position; only your signer can move funds.
-- **Direct RPC access:** no Tempora service in the request path and no telemetry. Keyed RPC URLs are redacted.
+- **No keys or custody:** your wallet holds the position; Treasury never holds a key. With an email or social login, that wallet's keys are managed by Privy; see [risks](docs/risks.md).
+- **Direct RPC access:** the `earn` commands talk only to the chain's RPC (yours, or the chain's public endpoint when none is set or a history scan needs it; see [configuration](docs/configuration.md)), with no Tempora Labs service in the request path and no telemetry. Keyed RPC URLs are redacted.
+- **Sign-in through Privy:** `treasury connect` signs you in through [Privy](https://privy.io), using Tempora Labs' Privy app unless you set `PRIVY_APP_ID`. Privy, and Tempora Labs as that app's owner, see your login and wallet address, and Privy's script on the page sends its own analytics. The page also loads Cloudflare's bot check (challenges.cloudflare.com) for Privy's sign-in.
 - **Verifiable builds:** CI checks the committed bundle; [verify its provenance](docs/runbooks/verify_the_bundle.md).
 - **Private vulnerability reporting:** follow [SECURITY.md](SECURITY.md), not a public issue.
 
 ## Documentation
 
-- [Tool reference](docs/tools.md) · [Configuration](docs/configuration.md)
+- [Command reference](docs/tools.md) · [Configuration](docs/configuration.md)
 - [Risks](docs/risks.md) · [Security model](docs/security-model.md)
 - [Signing and sending](docs/runbooks/sign_and_send.md) · [All docs](docs/README.md) · [Changelog](CHANGELOG.md)
 
@@ -121,6 +177,6 @@ certifying the [Developer Certificate of Origin](DCO.md).
 ## Licence
 
 [Apache-2.0](LICENSE). Keep [LICENSE](LICENSE) and [NOTICE](NOTICE) when redistributing.
-The licence does not grant rights to Tempora's names or marks; forks must not claim to be the
-official distribution. Tempora's fund-operations infrastructure is separate from this repository.
+The licence does not grant rights to Tempora Labs' names or marks ("Tempora", "Tempora Labs" and "Agent Treasury", as NOTICE lists them); forks must not claim to be the
+official distribution. Tempora Labs' fund-operations infrastructure is separate from this repository.
 See [licensing](docs/licensing.md) for details.