dexe-mcp 0.21.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,113 @@
 # Changelog
 
+## 0.23.0 — 2026-07-08
+
+### SIMPLE-mode DAO creation: configurable min-votes and early completion
+
+`dexe_dao_create` SIMPLE mode gains two optional fields, so common governance
+requirements no longer force a hand-built ADVANCED `params` struct:
+
+- **`minVotesTokens`** (whole tokens, default `"1"`) — the minimum token balance
+  to both vote and create proposals (sets `minVotesForVoting` =
+  `minVotesForCreating`). Scaled to 18-dec wei. The deploy's existing min-votes
+  guard still rejects a value above the largest holder's allocation, with
+  remediation. The default `"1"` is clamped to the distributed amount on dust
+  supplies — unchanged behavior.
+- **`earlyCompletion`** (default `true`) — end voting as soon as quorum is
+  reached.
+
+Both thread through the synthesized, coherence-checked config; the reachable-
+quorum and ≥50%-floor safety proofs are unchanged. ADVANCED mode already exposed
+these via the full `params` struct. No tool-count change (159 / 19 groups).
+
+## 0.22.0 — 2026-07-07
+
+### "Works like charm": full proposal-type coverage, auto-deposit voting, reliability hardening, AI playbook
+
+The production-readiness release. Goal: an AI assistant serves "create a DAO /
+create a proposal / vote / run an OTC sale" without investigating anything —
+and every failure tells you exactly what to do next.
+
+**Every proposal type, one call**
+- `dexe_proposal_create` now wires **all 33 catalog types** (was 10):
+  new external builders `manage_validators`, `validators_allocation`,
+  `delegate_to_expert`/`revoke_from_expert` (+ catalog-style aliases),
+  `add/remove_local/global_expert`, `token_sale_recover`, `token_sale_whitelist`,
+  `create_staking_tier`, `change_math_model`, `blacklist`, `reward_multiplier`,
+  `apply_to_dao`, `new_proposal_type`/`enable_staking` — byte-parity with the
+  `dexe_proposal_build_*` tools (shared ABI fragments, no copies).
+- Internal proposals (`change_validator_balances`, `change_validator_settings`,
+  `monthly_withdraw`, `offchain_internal_proposal`) auto-route to
+  `GovValidators.createInternalProposal` — the correct validators-only path.
+- Off-chain types are rejected with the exact backend flow to run instead.
+- `proposalType` is a **strict enum**: unknown values fail at validation with
+  the full valid list (previously errored mid-flow).
+
+**Voting that just works**
+- `dexe_proposal_vote_and_execute`: `depositFirst` is now `boolean|'auto'`,
+  **default `'auto'`** — deposits exactly the missing amount from the wallet
+  (approve UserKeeper → deposit → vote), matching the frontend's bundled flow.
+  `false` restores never-deposit.
+- Non-Voting state errors name the per-state remedy (Defeated → new proposal;
+  Succeeded/Locked → re-run with autoExecute; Executed → done).
+
+**Human units everywhere**
+- Every amount accepts raw smallest units (digits-only, unchanged) **or**
+  human units with a decimal point (`"12.5"`), scaled by the token's REAL
+  on-chain decimals — `voteAmount`, `token_transfer`/`withdraw_treasury`/
+  `apply_to_dao` params, OTC buy.
+- OTC `dexe_otc_buyer_buy` now converts the 18-dec-normalized amount to the
+  payment token's native decimals for the balance check and the exact-amount
+  approve — a <18-decimals payment token can no longer silently under-pay.
+
+**Protocol compatibility**
+- **SphereX fix (bug #35)**: newly deployed GovPools ship with SphereX
+  protection that rejects the old `multicall([deposit, createProposalAndVote])`
+  bundle with `"SphereX error: disallowed tx pattern"` — proposal creation on
+  any fresh DAO was broken. `dexe_proposal_create` (and the OTC open-sale
+  composite that rides it) now sends deposit and createProposalAndVote as
+  separate sequential transactions; the partial-failure ledger makes the
+  two-step sequence safely resumable. Caught by the new testnet golden-path
+  E2E (`scripts/e2e-testnet.mjs`), verified live on chain 97.
+
+**Reliability (the P1 batch)**
+- Transport-level **RPC retry + fallback rotation**: all RPC env vars accept
+  comma-separated URL lists; the zero-config public fallback ships multiple
+  endpoints per chain; the signer path uses the same resilient factory (it
+  previously bypassed even the flaky-RPC hint).
+- **Mining-wait timeout** (`DEXE_TX_WAIT_TIMEOUT_MS`, default 180 s): a stuck
+  tx returns "check dexe_tx_status" instead of hanging the tool forever.
+- **Reverted ≠ success**: `receipt.status === 0` now surfaces as a failure
+  everywhere (`dexe_tx_send` sets `isError` + `reverted:true`; composites stop
+  before dependent steps run on unchanged state).
+- **Partial-failure ledger**: composite flows return `mode:"failed"` with
+  `failure.{failedStep, error, landedSteps, resume}` — fix the cause and
+  re-run the same call; completed steps are detected on-chain and skipped.
+- **Startup env validation**: invalid `DEXE_*` values now fail fast at boot
+  with the var name (doctor already flagged them). New schema vars:
+  `DEXE_TX_WAIT_TIMEOUT_MS`, `DEXE_MAX_DESCRIPTION_LEN`, `DEXE_PROTOCOL_REF`.
+- **`chainId` on every read**: 19 read tools no longer hardcode the default
+  chain (proposal/vote/read_*/gov/inbox/dao/forecast/OTC status + list).
+
+**AI ergonomics**
+- **`docs/PLAYBOOK.md`** (new): intent → exact-call table, all-33 proposalType
+  params reference, error → remedy table, unit conventions, toolset map,
+  signer bootstrap + faucets. Served as MCP resource `dexe://playbook`;
+  drift-guarded by tests.
+- `dexe_context` reports enabled vs hidden toolsets and what each hidden set
+  unlocks, plus the exact `DEXE_TOOLSETS` fix.
+- MCP handshake now reports the real package version (was hardcoded `0.1.5`).
+- Missing-Pinata errors are a numbered 3-step guide; the OTC open-sale
+  description stops pointing at a dev-gated tool.
+
+**Migration notes** (details in `docs/MIGRATION.md`)
+- Unknown `proposalType` strings are rejected at validation.
+- Scripts that treated mined-but-reverted txs as success must check
+  `isError`/`reverted`.
+- `depositFirst` default changed `false` → `'auto'` (may broadcast
+  approve+deposit when power is short; pass `false` for the old behavior).
+- Invalid `.env` values now stop startup.
+
 ## 0.21.0 — 2026-07-06
 
 ### One-call avatar updates + file-path uploads

package/README.md

@@ -177,8 +177,9 @@ No variable is required to start the server; tools that need a missing one fail
 
 ## Documentation
 
+- [docs/PLAYBOOK.md](./docs/PLAYBOOK.md) — the AI playbook: intent → exact call, per-type params, error → remedy. Also served as the MCP resource `dexe://playbook`.
 - [docs/TOOLS.md](./docs/TOOLS.md) — all 159 tools, grouped, with one-line descriptions and required env vars.
-- [docs/USAGE.md](./docs/USAGE.md) — ten worked examples with copy-pasteable JSON.
+- [docs/USAGE.md](./docs/USAGE.md) — worked examples with copy-pasteable JSON.
 - [docs/ENVIRONMENT.md](./docs/ENVIRONMENT.md) — full env-var reference and common pitfalls.
 - [docs/INSTALL.md](./docs/INSTALL.md) — install instructions per MCP client.
 - [docs/SETUP.md](./docs/SETUP.md) / [docs/DOCTOR.md](./docs/DOCTOR.md) — setup wizard and diagnostic reference.

package/dexe-plugin/skills/dexe-create-dao/SKILL.md

@@ -64,8 +64,10 @@ dexe_dao_create({
   quorumPercent: 51,          // must be ≥50 AND ≤ (100 − treasuryPercent)
   voteModel: "LINEAR",        // 1 token = 1 vote (default); or "POLYNOMIAL"
   durationSeconds: 86400,     // 1 day
+  minVotesTokens: "1",        // min balance to vote AND create, whole tokens (≤ largest holder)
+  earlyCompletion: true,      // end voting as soon as quorum is reached
   daoDescription: "A community treasury DAO.",
-  avatarCID: "bafy…"          // optional
+  avatarCID: "bafy…"          // optional; or avatarPath: local image path the server uploads
 })
 ```
 
@@ -75,6 +77,9 @@ This returns `mode: "preview"` with the **resolved config** (who holds what) and
 4. **Confirm:** re-call with the **same arguments plus `confirm: true`** to broadcast.
    The deployer holds the entire distributed portion; the treasury is an **implicit
    remainder** (the govPool address is never a token recipient).
+   When the user has **already approved** the deploy up front, pass
+   `confirm: true` on the **first** call — preview and broadcast collapse into
+   one call.
 
 ## Recipe — ADVANCED mode (full control)
 
@@ -122,4 +127,9 @@ SIMPLE fields. The coherence guards still run. Key rules for hand-built params:
 The result includes `predictedGovPool` — the DAO's GovPool address once the tx
 confirms. Use it for `dexe_proposal_create` / `dexe_proposal_vote_and_execute`.
 
+DAOs deployed by `dexe_dao_create` have the **TokenSale + Distribution
+executors and all 5 settings groups auto-wired** (since v0.19) — the OTC
+journey ([[dexe-otc]]) works immediately after deploy, no extra settings
+proposal needed.
+
 Related: [[dexe-create-proposal]], [[dexe-vote-execute]].

package/dexe-plugin/skills/dexe-create-proposal/SKILL.md

@@ -23,8 +23,13 @@ When the user already told you the DAO and what to do, go straight to
 
 **Do not hand-sequence** approve/deposit/create, and do not hand-build the IPFS
 metadata — the composite does both correctly. **Do not guess ABIs/selectors**;
-the wired builders encode canonical calldata. Only reach for `dexe_get_methods`
-when composing a truly custom call.
+the wired builders encode canonical calldata. For a truly custom call use the
+`custom_abi` type; `dexe_proposal_catalog` (or the playbook — MCP resource
+`dexe://playbook`, `docs/PLAYBOOK.md`) lists every type and its params.
+
+**Amounts:** a digits-only string is raw wei; a string with a decimal point
+(`"1000.0"`) is human units, scaled by the token's **real on-chain decimals**
+(never assumed 18). Both forms work in every `params` amount and `voteAmount`.
 
 ## Pick a proposalType
 
@@ -43,8 +48,24 @@ Pass `proposalType` + the type's inputs in `params`:
 | `modify_dao_profile` | top-level `newDaoName/newDaoDescription/newWebsiteUrl/newSocialLinks`; avatar via `newAvatarPath` (local image path — the server uploads + validates it; do NOT read the file yourself) or `newAvatarCID` |
 | `custom` | top-level `actionsOnFor:[{executor,value,data}]` (+ optional `category`) |
 
-Any other catalog type → the tool errors and names the dedicated
-`dexe_proposal_build_*` tool. Discover all 33 types with `dexe_proposal_catalog`.
+**All 33 catalog types are wired** — `proposalType` is a strict enum; an
+unknown string is rejected at validation with the list of valid types. Beyond
+the table above: treasury/tokens (`apply_to_dao`, `token_sale_recover`,
+`token_sale_whitelist`), governance config (`new_proposal_type`,
+`enable_staking`, `change_math_model`, `manage_validators` /
+`validators_allocation`), experts/delegation (`delegate_to_expert` /
+`revoke_from_expert`, plus catalog-style aliases like
+`delegate_tokens_to_expert` and `add_local_expert` / `add_global_expert`),
+token controls (`blacklist`, `reward_multiplier`), and staking
+(`create_staking_tier`).
+
+Internal validator types (`change_validator_balances`,
+`change_validator_settings`, `monthly_withdraw`, `offchain_internal_proposal`)
+**auto-route to `GovValidators.createInternalProposal`** — validators only, no
+deposit or UserKeeper approve. Off-chain types (`offchain_single_option` /
+`_multi_option` / `_for_against`) are rejected with the exact backend flow
+(`dexe_proposal_build_offchain_*` → auth nonce/login → authorized POST).
+Discover every type + params with `dexe_proposal_catalog`.
 
 ## Example: transfer treasury tokens
 
@@ -55,7 +76,7 @@ dexe_proposal_create({
   proposalType: "token_transfer",
   title: "Pay contributor grant",
   description: "Q3 grant to @alice.",
-  params: { token: "0xGovToken", recipient: "0xAlice", amount: "1000000000000000000" }
+  params: { token: "0xGovToken", recipient: "0xAlice", amount: "1000.0" }  // human units
 })
 ```
 

package/dexe-plugin/skills/dexe-otc/SKILL.md

@@ -41,6 +41,11 @@ Validate on **BSC testnet (chain 97)** first. Full recipe + runnable proof:
 
 ## Critical gotchas
 
+- **Buyer amounts accept human units** — a decimal string (`"50.0"`) is scaled
+  by the token's real on-chain decimals; digits-only stays raw wei.
+  `dexe_otc_buyer_buy` converts the 18-dec-normalized buy amount to the
+  **payment token's native decimals** for the balance check and the exact
+  approve — no silent under-pay on <18-dec payment tokens.
 - **Exchange rate is PRECISION 1e25**, not 1e18. 1:1 = `"10000000000000000000000000"`.
 - **Native BNB = `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE`** (ETHEREUM_ADDRESS),
   never `0x0…0` — a zero-address purchase token makes the tier unbuyable. Buy

package/dexe-plugin/skills/dexe-vote-execute/SKILL.md

@@ -24,14 +24,27 @@ dexe_proposal_vote_and_execute({
   chainId: 97,
   proposalId: 1,            // 1-indexed
   isVoteFor: true,
-  depositFirst: false,      // set true to deposit wallet tokens before voting
+  depositFirst: "auto",     // the default — deposits the shortfall automatically
   autoExecute: true         // execute automatically once it passes
 })
 ```
 
+- **`depositFirst` is `boolean | "auto"`, default `"auto"`:** when your deposited
+  power is short of `voteAmount`, the tool deposits **exactly the missing
+  amount** from your wallet (approve UserKeeper → deposit → vote). Pass `false`
+  to never deposit (the old behavior), `true` to force a deposit.
 - Already past voting (state `SucceededFor` / `SucceededAgainst` / `Locked`) →
-  the tool skips the vote and goes straight to execute.
-- `voteAmount` defaults to all available deposited power. Pass it to vote with less.
+  the tool skips the vote and goes straight to execute. Any other non-`Voting`
+  state errors with a **per-state remedy** (execute / wait / new proposal).
+- `voteAmount` defaults to all available deposited power. Pass it to vote with
+  less — human units (`"250.5"`) or raw wei both work.
+
+## Partial failure → fix and re-run the SAME call
+
+A failed step returns `mode: "failed"` with a `failure` ledger:
+`failedStep`, an actionable `error`, `landedSteps` (txs that DID land — gas
+already spent), and `resume` guidance. Fix the cause and re-run the same call —
+completed steps (approve/deposit) are detected on-chain and skipped.
 
 ## Canonical ProposalState ordering (failure mode 9)
 

package/dist/config.d.ts

@@ -21,7 +21,14 @@ export declare const DEFAULTS: {
 };
 export interface ChainConfig {
     chainId: number;
+    /** Primary RPC endpoint — always `rpcUrls[0]`. Kept for back-compat reads. */
     rpcUrl: string;
+    /**
+     * Full endpoint list for this chain: primary first, then transport-failure
+     * fallbacks (comma-separated in env, or the baked public list). Consumed by
+     * `createChainProvider` (src/rpc.ts) for retry + rotation.
+     */
+    rpcUrls: string[];
     /** Optional `ContractsRegistry` override scoped to this chain. */
     registryOverride?: string;
 }

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ;;;;;;CAUX,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IAErB,uEAAuE;IACvE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CA6TtD;AAcD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAW9E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ;;;;;;CAUX,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IAErB,uEAAuE;IACvE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAgWtD;AAcD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAW9E"}

package/dist/config.js

@@ -2,6 +2,14 @@ import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { resolveProtocolPath, isBuildReady } from "./bootstrap.js";
 import { resolveStatePath } from "./lib/stateStore.js";
+import { parseEnv } from "./env/parse.js";
+/**
+ * Split an RPC env value into its endpoint list: `url` or `url1,url2,…`.
+ * First entry is the primary; the rest are transport-failure fallbacks.
+ */
+function splitRpcUrls(raw) {
+    return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
 /**
  * Baked zero-config defaults — public, non-secret endpoints (plus a semi-public
  * WalletConnect project id) so a fresh install works cold with no `.env`. A user
@@ -31,6 +39,21 @@ export const DEFAULTS = {
  * that lazily from inside build/test tools.
  */
 export async function loadConfig() {
+    // ---- schema-validate the DEXE_* env surface up front (R5) ---------------
+    // parse.ts walks ENV_SPEC; an invalid value (malformed URL, non-integer,
+    // bad enum) is a config error the user should see at startup, not a
+    // confusing late failure deep inside a tool call. Doctor performs the same
+    // validation; this makes startup honest about it too.
+    {
+        const { issues } = parseEnv();
+        const errors = issues.filter((i) => i.severity === "error");
+        for (const issue of issues) {
+            process.stderr.write(`[dexe-mcp] env ${issue.severity}: ${issue.message}\n`);
+        }
+        if (errors.length > 0) {
+            fatal(`invalid environment: ${errors.map((i) => i.key).join(", ")} — fix the value(s) in .env and restart. Run 'npx dexe-mcp doctor' for details.`);
+        }
+    }
     const protocolPath = resolve(resolveProtocolPath());
     // Soft warning only — don't block startup. The lazy bootstrap will either
     // create the checkout (auto-managed path) or surface a clear error when a
@@ -51,11 +74,13 @@ export async function loadConfig() {
     const registryOverride = process.env.DEXE_CONTRACTS_REGISTRY?.trim() || undefined;
     const rpcTestnet = process.env.DEXE_RPC_URL_TESTNET?.trim() || undefined;
     if (rpcTestnet) {
-        chains.set(97, { chainId: 97, rpcUrl: rpcTestnet });
+        const urls = splitRpcUrls(rpcTestnet);
+        chains.set(97, { chainId: 97, rpcUrl: urls[0], rpcUrls: urls });
     }
     const rpcMainnet = process.env.DEXE_RPC_URL_MAINNET?.trim() || undefined;
     if (rpcMainnet) {
-        chains.set(56, { chainId: 56, rpcUrl: rpcMainnet });
+        const urls = splitRpcUrls(rpcMainnet);
+        chains.set(56, { chainId: 56, rpcUrl: urls[0], rpcUrls: urls });
     }
     // Generic per-chain RPC: DEXE_RPC_URL_<chainId> (e.g. DEXE_RPC_URL_1,
     // DEXE_RPC_URL_10). Enables chains beyond BSC — notably the external
@@ -69,7 +94,8 @@ export async function loadConfig() {
         if (!url)
             continue;
         const cid = Number(m[1]);
-        chains.set(cid, { chainId: cid, rpcUrl: url });
+        const urls = splitRpcUrls(url);
+        chains.set(cid, { chainId: cid, rpcUrl: urls[0], rpcUrls: urls });
     }
     // Legacy single-chain env (still supported)
     const legacyRpc = process.env.DEXE_RPC_URL?.trim() || undefined;
@@ -82,13 +108,15 @@ export async function loadConfig() {
         legacyChainId = n;
     }
     if (legacyRpc) {
+        const legacyUrls = splitRpcUrls(legacyRpc);
         // Resolve legacy chainId. If unset, infer from URL hostname; fall back to 56.
-        const inferred = legacyChainId ?? inferChainIdFromRpcUrl(legacyRpc) ?? 56;
+        const inferred = legacyChainId ?? inferChainIdFromRpcUrl(legacyUrls[0]) ?? 56;
         // Apply registryOverride only when this is the legacy chain (per-chain
         // override via DEXE_CONTRACTS_REGISTRY has always been single-chain).
         chains.set(inferred, {
             chainId: inferred,
-            rpcUrl: legacyRpc,
+            rpcUrl: legacyUrls[0],
+            rpcUrls: legacyUrls,
             registryOverride,
         });
     }
@@ -100,14 +128,26 @@ export async function loadConfig() {
     // rate-limit and lack archive history, so we surface a hint (below) nudging
     // the user to set their own RPC for anything serious. Opt out entirely with
     // DEXE_DISABLE_PUBLIC_RPC=1. When the user set any RPC, this does nothing.
+    // Multiple public endpoints per chain: ResilientRpcProvider rotates to the
+    // next one when the primary rate-limits (R1), so zero-config reads survive a
+    // single flaky dataseed node.
     const PUBLIC_RPC_FALLBACK = {
-        56: "https://bsc-dataseed.bnbchain.org",
-        97: "https://data-seed-prebsc-1-s1.bnbchain.org:8545",
+        56: [
+            "https://bsc-dataseed.bnbchain.org",
+            "https://bsc-dataseed1.bnbchain.org",
+            "https://bsc-dataseed2.bnbchain.org",
+            "https://bsc-rpc.publicnode.com",
+        ],
+        97: [
+            "https://data-seed-prebsc-1-s1.bnbchain.org:8545",
+            "https://data-seed-prebsc-2-s1.bnbchain.org:8545",
+            "https://bsc-testnet-rpc.publicnode.com",
+        ],
     };
     let usedPublicFallback = false;
     if (process.env.DEXE_DISABLE_PUBLIC_RPC?.trim() !== "1" && chains.size === 0) {
-        for (const [cid, url] of Object.entries(PUBLIC_RPC_FALLBACK)) {
-            chains.set(Number(cid), { chainId: Number(cid), rpcUrl: url });
+        for (const [cid, urls] of Object.entries(PUBLIC_RPC_FALLBACK)) {
+            chains.set(Number(cid), { chainId: Number(cid), rpcUrl: urls[0], rpcUrls: urls });
         }
         usedPublicFallback = true;
     }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/env/schema.d.ts

@@ -76,11 +76,11 @@ export declare const ENV_SPEC: {
         readonly doc: "Override path for the persistent operational-state JSON (known DAOs / recent proposals surfaced by dexe_context). Default ~/.dexe-mcp/state.json. Must be in a writable directory.";
     };
     readonly DEXE_RPC_URL: {
-        readonly schema: z.ZodOptional<z.ZodString>;
+        readonly schema: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         readonly category: "rpc";
         readonly required: false;
         readonly example: "https://bsc-dataseed.binance.org";
-        readonly doc: "Legacy single-chain RPC. Prefer DEXE_RPC_URL_TESTNET / _MAINNET / _<chainId>.";
+        readonly doc: "Legacy single-chain RPC. Prefer DEXE_RPC_URL_TESTNET / _MAINNET / _<chainId>. Accepts a comma-separated fallback list.";
         readonly enablesFlows: readonly ["read", "broadcast"];
     };
     readonly DEXE_CHAIN_ID: {
@@ -91,21 +91,28 @@ export declare const ENV_SPEC: {
         readonly doc: "Chain id for legacy DEXE_RPC_URL. Inferred from hostname when unset.";
     };
     readonly DEXE_RPC_URL_TESTNET: {
-        readonly schema: z.ZodOptional<z.ZodString>;
+        readonly schema: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         readonly category: "rpc";
         readonly required: false;
         readonly example: "https://data-seed-prebsc-1-s1.bnbchain.org:8545";
-        readonly doc: "RPC URL for BSC testnet (chain 97).";
+        readonly doc: "RPC URL for BSC testnet (chain 97). Accepts a comma-separated fallback list — the first is primary, the rest rotate on transport failures.";
         readonly enablesFlows: readonly ["read", "broadcast"];
     };
     readonly DEXE_RPC_URL_MAINNET: {
-        readonly schema: z.ZodOptional<z.ZodString>;
+        readonly schema: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         readonly category: "rpc";
         readonly required: false;
         readonly example: "https://bsc-dataseed.bnbchain.org";
-        readonly doc: "RPC URL for BSC mainnet (chain 56).";
+        readonly doc: "RPC URL for BSC mainnet (chain 56). Accepts a comma-separated fallback list — the first is primary, the rest rotate on transport failures.";
         readonly enablesFlows: readonly ["read", "broadcast"];
     };
+    readonly DEXE_TX_WAIT_TIMEOUT_MS: {
+        readonly schema: z.ZodOptional<z.ZodString>;
+        readonly category: "rpc";
+        readonly required: false;
+        readonly example: "180000";
+        readonly doc: "Max milliseconds to wait for a broadcast tx to mine before returning a check-with-dexe_tx_status error. Default 180000 (3 min).";
+    };
     readonly DEXE_DEFAULT_CHAIN_ID: {
         readonly schema: z.ZodOptional<z.ZodString>;
         readonly category: "rpc";
@@ -288,6 +295,20 @@ export declare const ENV_SPEC: {
         readonly example: "";
         readonly doc: "Optional fork block pin (Phase B).";
     };
+    readonly DEXE_MAX_DESCRIPTION_LEN: {
+        readonly schema: z.ZodOptional<z.ZodString>;
+        readonly category: "core";
+        readonly required: false;
+        readonly example: "20000";
+        readonly doc: "Max characters accepted for proposal/DAO description markdown before conversion (guards IPFS payload size). Default 20000.";
+    };
+    readonly DEXE_PROTOCOL_REF: {
+        readonly schema: z.ZodOptional<z.ZodString>;
+        readonly category: "dev";
+        readonly required: false;
+        readonly example: "";
+        readonly doc: "Git ref (branch/tag/commit) checked out for the auto-managed DeXe-Protocol clone. Default: the pinned release the MCP ships with.";
+    };
 };
 /**
  * Re-export with the structural interface so consumers see optional fields

package/dist/env/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/env/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,UAAU,GACV,eAAe,GACf,MAAM,GACN,SAAS,GACT,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,MAAM,GACN,WAAW,GACX,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,SAAS,GACT,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiRwB,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAY,CAAC;AAE/D,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE3C,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,CAEpD;AAED,wBAAgB,OAAO,IAAI,MAAM,EAAE,CAElC;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAyB,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/env/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,UAAU,GACV,eAAe,GACf,MAAM,GACN,SAAS,GACT,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,MAAM,GACN,WAAW,GACX,aAAa,GACb,WAAW,GACX,eAAe,GACf,YAAY,GACZ,SAAS,GACT,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAmBD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsSwB,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAY,CAAC;AAE/D,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE3C,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,CAEpD;AAED,wBAAgB,OAAO,IAAI,MAAM,EAAE,CAElC;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAyB,CAAC"}

package/dist/env/schema.js

@@ -3,6 +3,15 @@ const hex64 = /^0x[0-9a-fA-F]{64}$/;
 const hex40 = /^0x[0-9a-fA-F]{40}$/;
 const intStr = z.string().regex(/^\d+$/);
 const optionalUrl = z.string().url().optional();
+/**
+ * One URL, or a comma-separated list of URLs. The first is the primary
+ * endpoint; the rest are transport-failure fallbacks rotated by
+ * ResilientRpcProvider (src/rpc.ts).
+ */
+const optionalUrlList = z
+    .string()
+    .refine((v) => v.split(",").map((s) => s.trim()).filter(Boolean).every((u) => z.string().url().safeParse(u).success), { message: "must be a URL or a comma-separated list of URLs" })
+    .optional();
 export const ENV_SPEC = {
     // ─── core / dev ───────────────────────────────────────────────────────────
     DEXE_PROTOCOL_PATH: {
@@ -49,11 +58,11 @@ export const ENV_SPEC = {
     },
     // ─── rpc ──────────────────────────────────────────────────────────────────
     DEXE_RPC_URL: {
-        schema: optionalUrl,
+        schema: optionalUrlList,
         category: "rpc",
         required: false,
         example: "https://bsc-dataseed.binance.org",
-        doc: "Legacy single-chain RPC. Prefer DEXE_RPC_URL_TESTNET / _MAINNET / _<chainId>.",
+        doc: "Legacy single-chain RPC. Prefer DEXE_RPC_URL_TESTNET / _MAINNET / _<chainId>. Accepts a comma-separated fallback list.",
         enablesFlows: ["read", "broadcast"],
     },
     DEXE_CHAIN_ID: {
@@ -64,21 +73,28 @@ export const ENV_SPEC = {
         doc: "Chain id for legacy DEXE_RPC_URL. Inferred from hostname when unset.",
     },
     DEXE_RPC_URL_TESTNET: {
-        schema: optionalUrl,
+        schema: optionalUrlList,
         category: "rpc",
         required: false,
         example: "https://data-seed-prebsc-1-s1.bnbchain.org:8545",
-        doc: "RPC URL for BSC testnet (chain 97).",
+        doc: "RPC URL for BSC testnet (chain 97). Accepts a comma-separated fallback list — the first is primary, the rest rotate on transport failures.",
         enablesFlows: ["read", "broadcast"],
     },
     DEXE_RPC_URL_MAINNET: {
-        schema: optionalUrl,
+        schema: optionalUrlList,
         category: "rpc",
         required: false,
         example: "https://bsc-dataseed.bnbchain.org",
-        doc: "RPC URL for BSC mainnet (chain 56).",
+        doc: "RPC URL for BSC mainnet (chain 56). Accepts a comma-separated fallback list — the first is primary, the rest rotate on transport failures.",
         enablesFlows: ["read", "broadcast"],
     },
+    DEXE_TX_WAIT_TIMEOUT_MS: {
+        schema: intStr.optional(),
+        category: "rpc",
+        required: false,
+        example: "180000",
+        doc: "Max milliseconds to wait for a broadcast tx to mine before returning a check-with-dexe_tx_status error. Default 180000 (3 min).",
+    },
     DEXE_DEFAULT_CHAIN_ID: {
         schema: intStr.optional(),
         category: "rpc",
@@ -268,6 +284,20 @@ export const ENV_SPEC = {
         example: "",
         doc: "Optional fork block pin (Phase B).",
     },
+    DEXE_MAX_DESCRIPTION_LEN: {
+        schema: intStr.optional(),
+        category: "core",
+        required: false,
+        example: "20000",
+        doc: "Max characters accepted for proposal/DAO description markdown before conversion (guards IPFS payload size). Default 20000.",
+    },
+    DEXE_PROTOCOL_REF: {
+        schema: z.string().optional(),
+        category: "dev",
+        required: false,
+        example: "",
+        doc: "Git ref (branch/tag/commit) checked out for the auto-managed DeXe-Protocol clone. Default: the pinned release the MCP ships with.",
+    },
 };
 /**
  * Re-export with the structural interface so consumers see optional fields