@sherwoodagent/cli 0.29.0 → 0.38.2

package/dist/chunk-RGOTBJIN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/config.ts"],"sourcesContent":["/**\n * Local config management — ~/.sherwood/config.json\n *\n * Stores group ID cache, per-chain contract addresses, and wallet config.\n */\n\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nconst CONFIG_DIR = path.join(os.homedir(), \".sherwood\");\nconst CONFIG_PATH = path.join(CONFIG_DIR, \"config.json\");\n\n/** Per-chain user-specific addresses (stored by chainId). */\nexport interface ChainContracts {\n  vault?: string; // user's default vault address\n}\n\n/** A syndicate the agent belongs to (creator or member). */\nexport interface SyndicateMembership {\n  subdomain: string;\n  vault: string;\n  role: \"creator\" | \"agent\";\n}\n\nexport interface SherwoodConfig {\n  dbEncryptionKey?: string; // legacy — no longer used, XMTP CLI manages its own DB\n  privateKey?: string; // wallet private key (0x-prefixed)\n  xmtpInboxId?: string;\n  groupCache: Record<string, string>; // subdomain → XMTP group ID\n  veniceApiKey?: string; // Venice AI inference API key\n  agentId?: number; // ERC-8004 identity token ID\n  contracts?: Record<string, ChainContracts>; // chainId → user addresses\n  syndicates?: Record<string, SyndicateMembership[]>; // chainId → syndicate memberships\n  primarySyndicate?: Record<string, string>; // chainId → subdomain of the active syndicate\n  rpc?: Record<string, string>; // network name → custom RPC URL\n  notifyTo?: string; // destination for cron summaries (Telegram chat ID, phone, etc.)\n  uniswapApiKey?: string; // Uniswap Trading API key (from developers.uniswap.org)\n  positions?: unknown[];        // open trade positions (typed in positions.ts)\n  closedPositions?: unknown[];  // historical closed positions\n  _xmtpMigrated?: boolean;     // one-time flag: revoked stale installations from ~/.xmtp/ era\n  /** Cached swap routes per chain: chainId → { tokenPair → SwapRoute } */\n  swapRoutes?: Record<string, Record<string, SwapRoute>>;\n}\n\n/** Persisted swap route detected by the CLI during portfolio strategy proposal. */\nexport interface SwapRoute {\n  mode: \"direct\" | \"multi-hop\";\n  feeTier: number;                  // direct pool fee tier\n  hop?: { via: string; feeIn: number; feeOut: number }; // multi-hop details\n  detectedAt: number;               // unix timestamp\n}\n\nexport function loadConfig(): SherwoodConfig {\n  if (fs.existsSync(CONFIG_PATH)) {\n    const config = JSON.parse(fs.readFileSync(CONFIG_PATH, \"utf-8\"));\n    if (!config.groupCache) config.groupCache = {};\n    return config;\n  }\n\n  return { groupCache: {} };\n}\n\nexport function saveConfig(config: SherwoodConfig): void {\n  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });\n  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });\n}\n\nexport function cacheGroupId(subdomain: string, groupId: string): void {\n  const config = loadConfig();\n  config.groupCache[subdomain] = groupId;\n  saveConfig(config);\n}\n\nexport function getCachedGroupId(subdomain: string): string | undefined {\n  const config = loadConfig();\n  return config.groupCache[subdomain];\n}\n\nexport function setVeniceApiKey(apiKey: string): void {\n  const config = loadConfig();\n  config.veniceApiKey = apiKey;\n  saveConfig(config);\n}\n\nexport function getVeniceApiKey(): string | undefined {\n  return loadConfig().veniceApiKey ?? process.env.VENICE_API_KEY;\n}\n\nexport function setAgentId(agentId: number): void {\n  const config = loadConfig();\n  config.agentId = agentId;\n  saveConfig(config);\n}\n\nexport function getAgentId(): number | undefined {\n  return loadConfig().agentId;\n}\n\nexport function setPrivateKey(key: string): void {\n  const config = loadConfig();\n  config.privateKey = key.startsWith(\"0x\") ? key : `0x${key}`;\n  saveConfig(config);\n}\n\nexport function getPrivateKey(): string | undefined {\n  return loadConfig().privateKey;\n}\n\n// ── Uniswap Trading API Key ──\n\nexport function setUniswapApiKey(apiKey: string): void {\n  const config = loadConfig();\n  config.uniswapApiKey = apiKey;\n  saveConfig(config);\n}\n\nexport function getUniswapApiKey(): string | undefined {\n  return loadConfig().uniswapApiKey ?? process.env.UNISWAP_API_KEY;\n}\n\n// ── Per-network RPC URLs ──\n\nexport function getConfigRpcUrl(network: string): string | undefined {\n  return loadConfig().rpc?.[network];\n}\n\nexport function setConfigRpcUrl(network: string, url: string): void {\n  const config = loadConfig();\n  if (!config.rpc) config.rpc = {};\n  config.rpc[network] = url;\n  saveConfig(config);\n}\n\n// ── Per-chain contract addresses ──\n\nexport function getChainContracts(chainId: number): ChainContracts {\n  const config = loadConfig();\n  return config.contracts?.[String(chainId)] ?? {};\n}\n\nexport function getNotifyTo(): string | undefined {\n  return loadConfig().notifyTo;\n}\n\nexport function setNotifyTo(id: string): void {\n  const config = loadConfig();\n  config.notifyTo = id;\n  saveConfig(config);\n}\n\nexport function setChainContract(\n  chainId: number,\n  key: keyof ChainContracts,\n  value: string,\n): void {\n  const config = loadConfig();\n  if (!config.contracts) config.contracts = {};\n  const cid = String(chainId);\n  if (!config.contracts[cid]) config.contracts[cid] = {};\n  config.contracts[cid][key] = value;\n  saveConfig(config);\n}\n\n// ── Syndicate Membership ──\n\n/**\n * Add (or update) a syndicate membership. Deduplicates by subdomain.\n * Automatically sets it as primary if it's the first syndicate on this chain.\n */\nexport function addSyndicate(\n  chainId: number,\n  membership: SyndicateMembership,\n): void {\n  const config = loadConfig();\n  const cid = String(chainId);\n  if (!config.syndicates) config.syndicates = {};\n  if (!config.syndicates[cid]) config.syndicates[cid] = [];\n\n  // Upsert — replace existing entry with same subdomain\n  const idx = config.syndicates[cid].findIndex(\n    (s) => s.subdomain === membership.subdomain,\n  );\n  if (idx >= 0) {\n    config.syndicates[cid][idx] = membership;\n  } else {\n    config.syndicates[cid].push(membership);\n  }\n\n  // Auto-set as primary if it's the first syndicate (or no primary set)\n  if (!config.primarySyndicate) config.primarySyndicate = {};\n  if (!config.primarySyndicate[cid]) {\n    config.primarySyndicate[cid] = membership.subdomain;\n  }\n\n  saveConfig(config);\n}\n\n/** Get all syndicate memberships for a chain. */\nexport function getSyndicates(chainId: number): SyndicateMembership[] {\n  const config = loadConfig();\n  return config.syndicates?.[String(chainId)] ?? [];\n}\n\n/** Set which syndicate is the active/primary one for CLI commands. */\nexport function setPrimarySyndicate(\n  chainId: number,\n  subdomain: string,\n): void {\n  const config = loadConfig();\n  if (!config.primarySyndicate) config.primarySyndicate = {};\n  config.primarySyndicate[String(chainId)] = subdomain;\n  saveConfig(config);\n}\n\n/**\n * Get the primary syndicate for this chain.\n * Falls back to ChainContracts.vault for backwards compat with older configs.\n */\nexport function getPrimarySyndicate(\n  chainId: number,\n): SyndicateMembership | undefined {\n  const config = loadConfig();\n  const cid = String(chainId);\n\n  // Check new syndicates store first\n  const primarySubdomain = config.primarySyndicate?.[cid];\n  if (primarySubdomain && config.syndicates?.[cid]) {\n    const found = config.syndicates[cid].find(\n      (s) => s.subdomain === primarySubdomain,\n    );\n    if (found) return found;\n  }\n\n  // Backwards compat: if syndicates list has entries but no primary, use the first one\n  if (config.syndicates?.[cid]?.length) {\n    return config.syndicates[cid][0];\n  }\n\n  // Legacy fallback: config only has a vault address, no subdomain\n  const vault = config.contracts?.[cid]?.vault;\n  if (vault) {\n    return { subdomain: \"\", vault, role: \"creator\" };\n  }\n\n  return undefined;\n}\n\n// ── Swap Route Cache ──\n\nfunction swapRouteKey(asset: string, token: string): string {\n  return `${asset.toLowerCase()}→${token.toLowerCase()}`;\n}\n\n/** Get a cached swap route for a token pair on a chain. */\nexport function getCachedSwapRoute(chainId: number, asset: string, token: string): SwapRoute | undefined {\n  const config = loadConfig();\n  return config.swapRoutes?.[String(chainId)]?.[swapRouteKey(asset, token)];\n}\n\n/** Save a detected swap route to the config cache. */\nexport function cacheSwapRoute(chainId: number, asset: string, token: string, route: SwapRoute): void {\n  const config = loadConfig();\n  const cid = String(chainId);\n  if (!config.swapRoutes) config.swapRoutes = {};\n  if (!config.swapRoutes[cid]) config.swapRoutes[cid] = {};\n  config.swapRoutes[cid][swapRouteKey(asset, token)] = route;\n  saveConfig(config);\n}\n\n/** Clear all cached swap routes for a chain (e.g. after pool migration). */\nexport function clearSwapRoutes(chainId: number): void {\n  const config = loadConfig();\n  delete config.swapRoutes?.[String(chainId)];\n  saveConfig(config);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-WRG7GAIA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/client.ts","../src/lib/errors.ts"],"sourcesContent":["/**\n * viem client factory — resolves chain and RPC from the network module.\n * Private key is read from ~/.sherwood/config.json (set via `sherwood config set --private-key`),\n * with PRIVATE_KEY env var as fallback.\n */\n\n// dotenv loaded at entrypoint\nimport type { Hex, TransactionReceipt } from \"viem\";\nimport { createPublicClient, createWalletClient, http } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport { getChain, getRpcUrl } from \"./network.js\";\nimport { loadConfig } from \"./config.js\";\nimport { formatContractError } from \"./errors.js\";\nexport { formatContractError } from \"./errors.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet _publicClient: any = null;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet _walletClient: any = null;\n\n/**\n * Resolve the private key: config → env → error.\n */\nfunction getPrivateKey(): `0x${string}` {\n  // 1. Config (~/.sherwood/config.json)\n  const config = loadConfig();\n  if (config.privateKey) {\n    const k = config.privateKey;\n    return (k.startsWith(\"0x\") ? k : `0x${k}`) as `0x${string}`;\n  }\n\n  // 2. Env var fallback\n  const env = process.env.PRIVATE_KEY;\n  if (env) {\n    return (env.startsWith(\"0x\") ? env : `0x${env}`) as `0x${string}`;\n  }\n\n  throw new Error(\n    \"Private key not found. Run 'sherwood config set --private-key <key>' or set PRIVATE_KEY env var.\",\n  );\n}\n\nexport function getPublicClient() {\n  const chain = getChain();\n  // Auto-invalidate if network changed since last creation\n  if (_publicClient && _publicClient.chain?.id !== chain.id) {\n    _publicClient = null;\n  }\n  if (!_publicClient) {\n    _publicClient = createPublicClient({\n      chain,\n      transport: http(getRpcUrl()),\n    });\n  }\n  return _publicClient as ReturnType<typeof createPublicClient>;\n}\n\nexport function getWalletClient() {\n  const chain = getChain();\n  // Auto-invalidate if network changed since last creation\n  if (_walletClient && _walletClient.chain?.id !== chain.id) {\n    _walletClient = null;\n  }\n  if (!_walletClient) {\n    const account = privateKeyToAccount(getPrivateKey());\n    _walletClient = createWalletClient({\n      account,\n      chain,\n      transport: http(getRpcUrl()),\n    });\n  }\n  return _walletClient as ReturnType<typeof createWalletClient>;\n}\n\n/**\n * Reset cached clients. Required for tests that call setNetwork()\n * after a client was already created.\n */\nexport function resetClients() {\n  _publicClient = null;\n  _walletClient = null;\n}\n\nexport function getAccount() {\n  return privateKeyToAccount(getPrivateKey());\n}\n\n/**\n * Estimate EIP-1559 fees with a 20% buffer to avoid stuck txs on Base gas spikes.\n */\nexport async function estimateFeesWithBuffer() {\n  const client = getPublicClient();\n  const { maxFeePerGas, maxPriorityFeePerGas } =\n    await client.estimateFeesPerGas();\n  return {\n    maxFeePerGas: (maxFeePerGas * 120n) / 100n,\n    maxPriorityFeePerGas: (maxPriorityFeePerGas * 120n) / 100n,\n  };\n}\n\n// ── Nonce management + retry helpers ──\n//\n// Handles: nonce collisions, underpriced replacements, stuck pending txs.\n// Gas bump ceiling: base * 1.2 (buffer) * 1.1^3 (max retries) ≈ 1.6x base fee.\n\nconst MAX_RETRIES = 3;\nconst RETRY_DELAY_MS = 1500; // backoff between retries\nconst STUCK_NONCE_CONFIRM_DELAY_MS = 2500; // staleness check delay\nconst GAS_BUMP_NUMERATOR = 110n;\nconst GAS_BUMP_DENOMINATOR = 100n;\n\nfunction isUnderpricedError(msg: string): boolean {\n  return msg.includes(\"replacement transaction underpriced\");\n}\n\nfunction isNonceStaleError(msg: string): boolean {\n  return msg.includes(\"nonce too low\") || msg.includes(\"NONCE_EXPIRED\");\n}\n\nfunction isRetryableError(err: unknown): boolean {\n  const msg = err instanceof Error ? err.message : String(err);\n  return isUnderpricedError(msg) || isNonceStaleError(msg);\n}\n\nfunction bumpFees(fees: { maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }) {\n  return {\n    maxFeePerGas: (fees.maxFeePerGas * GAS_BUMP_NUMERATOR) / GAS_BUMP_DENOMINATOR,\n    maxPriorityFeePerGas: (fees.maxPriorityFeePerGas * GAS_BUMP_NUMERATOR) / GAS_BUMP_DENOMINATOR,\n  };\n}\n\n// ── Stuck nonce detection ──\n\n/**\n * Check if the wallet has a stuck nonce (pending tx count > confirmed tx count).\n * Returns the stuck nonce number, or null if the wallet is clean.\n *\n * Includes a staleness guard: if pending > confirmed, waits ~2.5s and re-checks\n * to avoid false positives from propagation delays.\n */\nexport async function detectStuckNonce(): Promise<number | null> {\n  const client = getPublicClient();\n  const address = getAccount().address;\n  const [confirmed, pending] = await Promise.all([\n    client.getTransactionCount({ address, blockTag: \"latest\" }),\n    client.getTransactionCount({ address, blockTag: \"pending\" }),\n  ]);\n  if (pending <= confirmed) return null;\n\n  // Staleness guard: re-check after a short delay to avoid false positives\n  await new Promise((r) => setTimeout(r, STUCK_NONCE_CONFIRM_DELAY_MS));\n  const [confirmed2, pending2] = await Promise.all([\n    client.getTransactionCount({ address, blockTag: \"latest\" }),\n    client.getTransactionCount({ address, blockTag: \"pending\" }),\n  ]);\n  return pending2 > confirmed2 ? confirmed2 : null;\n}\n\n/**\n * Clear a single stuck nonce by sending a 0-value self-transfer with aggressively bumped gas.\n * Uses 5x the buffered fee estimate to guarantee replacement even if the original tx\n * was sent during a gas spike (EIP-1559 requires >= 110% of original maxPriorityFeePerGas).\n */\nasync function unstickWalletSingle(): Promise<Hex> {\n  const stuckNonce = await detectStuckNonce();\n  if (stuckNonce === null) {\n    throw new Error(\"No stuck nonce detected — wallet is clean.\");\n  }\n\n  console.warn(`  Unsticking wallet: replacing stuck tx at nonce ${stuckNonce}...`);\n  const wallet = getWalletClient();\n  const account = getAccount();\n\n  // Use 5x gas buffer to guarantee replacement even for txs sent during gas spikes\n  const { maxFeePerGas, maxPriorityFeePerGas } = await estimateFeesWithBuffer();\n  const hash = await wallet.sendTransaction({\n    account,\n    chain: wallet.chain,\n    to: account.address,\n    value: 0n,\n    nonce: stuckNonce,\n    maxFeePerGas: maxFeePerGas * 5n,\n    maxPriorityFeePerGas: maxPriorityFeePerGas * 5n,\n  });\n\n  const client = getPublicClient();\n  await client.waitForTransactionReceipt({ hash });\n  console.warn(`  Wallet unstuck (nonce ${stuckNonce} replaced).`);\n  return hash;\n}\n\n/**\n * Unstick a wallet by clearing ALL stuck nonces, not just the first one.\n * Loops until pending == confirmed nonce count.\n */\nexport async function unstickWallet(): Promise<Hex[]> {\n  const hashes: Hex[] = [];\n  while ((await detectStuckNonce()) !== null) {\n    hashes.push(await unstickWalletSingle());\n  }\n  if (hashes.length === 0) {\n    throw new Error(\"No stuck nonce detected — wallet is clean.\");\n  }\n  return hashes;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype TxSender = (params: any) => Promise<Hex>;\n\n/**\n * Shared retry loop: explicit nonce + EIP-1559 fee buffer + gas-bump on underpriced errors.\n * On \"nonce too low\" / \"NONCE_EXPIRED\", re-fetches nonce from pending state before retrying.\n * Also detects stuck nonces before sending and auto-unsticks the wallet.\n */\nasync function withRetry(send: TxSender, txParams: Record<string, unknown>): Promise<Hex> {\n  const client = getPublicClient();\n  const account = getAccount();\n  let fees = await estimateFeesWithBuffer();\n\n  // Auto-detect and clear ALL stuck nonces before attempting the tx\n  while ((await detectStuckNonce()) !== null) {\n    await unstickWalletSingle();\n  }\n\n  let nonce = await client.getTransactionCount({ address: account.address, blockTag: \"pending\" });\n\n  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {\n    try {\n      return await send({ ...txParams, ...fees, nonce });\n    } catch (err) {\n      if (attempt >= MAX_RETRIES || !isRetryableError(err)) {\n        // Decode contract revert into a human-readable message before throwing\n        throw new Error(formatContractError(err));\n      }\n\n      const msg = err instanceof Error ? err.message : String(err);\n      console.warn(`  Retry ${attempt + 1}/${MAX_RETRIES}: ${isNonceStaleError(msg) ? \"refreshing nonce\" : \"bumping gas\"}...`);\n\n      // Backoff between retries to let mempool settle\n      await new Promise((r) => setTimeout(r, RETRY_DELAY_MS));\n\n      if (isNonceStaleError(msg)) {\n        // Fresh nonce = fresh tx, no replacement needed — only bump fees for underpriced errors\n        nonce = await client.getTransactionCount({ address: account.address, blockTag: \"pending\" });\n      } else {\n        fees = bumpFees(fees);\n      }\n    }\n  }\n  throw new Error(\"withRetry: exhausted retries\");\n}\n\n/**\n * Send a raw transaction with automatic gas-bump retry on nonce/underpriced errors.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function sendTxWithRetry(txParams: Record<string, any>): Promise<Hex> {\n  const wallet = getWalletClient();\n  return withRetry((p) => wallet.sendTransaction(p), txParams);\n}\n\n/**\n * Call writeContract with automatic gas-bump retry on nonce/underpriced errors.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function writeContractWithRetry(txParams: Record<string, any>): Promise<Hex> {\n  const wallet = getWalletClient();\n  return withRetry((p) => wallet.writeContract(p), txParams);\n}\n\n/**\n * Wait for a tx receipt. On timeout, checks for stuck nonce and auto-unsticks.\n *\n * **Important**: After unsticking, the error is still re-thrown because the original\n * tx is lost. Callers should use `writeContractWithRetry` / `sendTxWithRetry` which\n * re-fetch nonces automatically. Do NOT manually retry after this throws — use the\n * retry-aware wrappers instead.\n */\nexport async function waitForReceipt(hash: Hex): Promise<TransactionReceipt> {\n  const client = getPublicClient();\n  try {\n    return await client.waitForTransactionReceipt({ hash });\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  } catch (err: any) {\n    // If receipt wait times out, check for stuck nonce\n    const msg = err instanceof Error ? err.message : String(err);\n    if (msg.includes(\"timeout\") || msg.includes(\"Timed out\")) {\n      if ((await detectStuckNonce()) !== null) {\n        console.warn(`  Tx ${hash} appears stuck — attempting to unstick wallet...`);\n        while ((await detectStuckNonce()) !== null) {\n          await unstickWalletSingle();\n        }\n      }\n    }\n    throw err;\n  }\n}\n","/**\n * Contract error decoding — turns raw reverts into human-readable messages.\n *\n * Uses viem's decodeErrorResult() against a combined ABI of all custom errors\n * from SyndicateVault, SyndicateGovernor, GovernorParameters, SyndicateFactory,\n * and strategy contracts.\n */\n\nimport { type Hex, decodeErrorResult, BaseError } from \"viem\";\n\n// ── Combined error-only ABI for decoding ──\n\nexport const CONTRACT_ERRORS_ABI = [\n  // ── SyndicateVault ──\n  { type: \"error\", name: \"InvalidOwner\", inputs: [] },\n  { type: \"error\", name: \"InvalidExecutorImpl\", inputs: [] },\n  { type: \"error\", name: \"NotActiveAgent\", inputs: [] },\n  { type: \"error\", name: \"SimulationFailed\", inputs: [] },\n  { type: \"error\", name: \"InvalidDepositor\", inputs: [] },\n  { type: \"error\", name: \"DepositorAlreadyApproved\", inputs: [] },\n  { type: \"error\", name: \"DepositorNotApproved\", inputs: [] },\n  { type: \"error\", name: \"NotApprovedDepositor\", inputs: [] },\n  { type: \"error\", name: \"AgentAlreadyRegistered\", inputs: [] },\n  { type: \"error\", name: \"AgentNotActive\", inputs: [] },\n  { type: \"error\", name: \"InvalidAgentRegistry\", inputs: [] },\n  { type: \"error\", name: \"NotAgentOwner\", inputs: [] },\n  { type: \"error\", name: \"NotGovernor\", inputs: [] },\n  { type: \"error\", name: \"RedemptionsLocked\", inputs: [] },\n  { type: \"error\", name: \"DepositsLocked\", inputs: [] },\n  { type: \"error\", name: \"InvalidAgentAddress\", inputs: [] },\n  { type: \"error\", name: \"TransferFailed\", inputs: [] },\n  { type: \"error\", name: \"ZeroAddress\", inputs: [] },\n  { type: \"error\", name: \"CannotRescueAsset\", inputs: [] },\n  { type: \"error\", name: \"NotFactory\", inputs: [] },\n\n  // ── SyndicateGovernor ──\n  { type: \"error\", name: \"VaultNotRegistered\", inputs: [] },\n  { type: \"error\", name: \"VaultAlreadyRegistered\", inputs: [] },\n  { type: \"error\", name: \"NotRegisteredAgent\", inputs: [] },\n  { type: \"error\", name: \"PerformanceFeeTooHigh\", inputs: [] },\n  { type: \"error\", name: \"StrategyDurationTooLong\", inputs: [] },\n  { type: \"error\", name: \"StrategyDurationTooShort\", inputs: [] },\n  { type: \"error\", name: \"EmptyExecuteCalls\", inputs: [] },\n  { type: \"error\", name: \"EmptySettlementCalls\", inputs: [] },\n  { type: \"error\", name: \"NotWithinVotingPeriod\", inputs: [] },\n  { type: \"error\", name: \"NoVotingPower\", inputs: [] },\n  { type: \"error\", name: \"AlreadyVoted\", inputs: [] },\n  { type: \"error\", name: \"ProposalNotFound\", inputs: [] },\n  { type: \"error\", name: \"ProposalNotApproved\", inputs: [] },\n  { type: \"error\", name: \"ExecutionWindowExpired\", inputs: [] },\n  { type: \"error\", name: \"StrategyAlreadyActive\", inputs: [] },\n  { type: \"error\", name: \"CooldownNotElapsed\", inputs: [] },\n  { type: \"error\", name: \"ProposalNotExecuted\", inputs: [] },\n  { type: \"error\", name: \"ProposalNotCancellable\", inputs: [] },\n  { type: \"error\", name: \"NotProposer\", inputs: [] },\n  { type: \"error\", name: \"InvalidVotingPeriod\", inputs: [] },\n  { type: \"error\", name: \"InvalidExecutionWindow\", inputs: [] },\n  { type: \"error\", name: \"InvalidVetoThresholdBps\", inputs: [] },\n  { type: \"error\", name: \"InvalidMaxPerformanceFeeBps\", inputs: [] },\n  { type: \"error\", name: \"InvalidStrategyDurationBounds\", inputs: [] },\n  { type: \"error\", name: \"InvalidCooldownPeriod\", inputs: [] },\n  { type: \"error\", name: \"InvalidVault\", inputs: [] },\n  { type: \"error\", name: \"NotVaultOwner\", inputs: [] },\n  { type: \"error\", name: \"StrategyDurationNotElapsed\", inputs: [] },\n  { type: \"error\", name: \"InvalidProtocolFeeBps\", inputs: [] },\n  { type: \"error\", name: \"InvalidProtocolFeeRecipient\", inputs: [] },\n  { type: \"error\", name: \"NotCoProposer\", inputs: [] },\n  { type: \"error\", name: \"CollaborationExpired\", inputs: [] },\n  { type: \"error\", name: \"AlreadyApproved\", inputs: [] },\n  { type: \"error\", name: \"InvalidSplits\", inputs: [] },\n  { type: \"error\", name: \"TooManyCoProposers\", inputs: [] },\n  { type: \"error\", name: \"SplitTooLow\", inputs: [] },\n  { type: \"error\", name: \"LeadSplitTooLow\", inputs: [] },\n  { type: \"error\", name: \"DuplicateCoProposer\", inputs: [] },\n  { type: \"error\", name: \"NotDraftState\", inputs: [] },\n  { type: \"error\", name: \"InvalidCollaborationWindow\", inputs: [] },\n  { type: \"error\", name: \"NotAuthorized\", inputs: [] },\n  { type: \"error\", name: \"InvalidMaxCoProposers\", inputs: [] },\n  { type: \"error\", name: \"Reentrancy\", inputs: [] },\n\n  // ── GovernorParameters (timelock) ──\n  { type: \"error\", name: \"ChangeAlreadyPending\", inputs: [] },\n  { type: \"error\", name: \"NoChangePending\", inputs: [] },\n  { type: \"error\", name: \"ChangeNotReady\", inputs: [] },\n  { type: \"error\", name: \"InvalidParameterChangeDelay\", inputs: [] },\n  { type: \"error\", name: \"InvalidParameterKey\", inputs: [] },\n\n  // ── SyndicateFactory ──\n  { type: \"error\", name: \"InvalidVaultImpl\", inputs: [] },\n  { type: \"error\", name: \"InvalidENSRegistrar\", inputs: [] },\n  { type: \"error\", name: \"SubdomainTooShort\", inputs: [] },\n  { type: \"error\", name: \"SubdomainTaken\", inputs: [] },\n  { type: \"error\", name: \"NotCreator\", inputs: [] },\n  { type: \"error\", name: \"InvalidGovernor\", inputs: [] },\n  { type: \"error\", name: \"InsufficientCreationFee\", inputs: [] },\n  { type: \"error\", name: \"InvalidFeeToken\", inputs: [] },\n  { type: \"error\", name: \"ManagementFeeTooHigh\", inputs: [] },\n  { type: \"error\", name: \"UpgradesDisabled\", inputs: [] },\n  { type: \"error\", name: \"VaultNotDeployed\", inputs: [] },\n  { type: \"error\", name: \"StrategyActive\", inputs: [] },\n\n  // ── BaseStrategy ──\n  { type: \"error\", name: \"AlreadyInitialized\", inputs: [] },\n  { type: \"error\", name: \"NotVault\", inputs: [] },\n  { type: \"error\", name: \"NotExecuted\", inputs: [] },\n  { type: \"error\", name: \"AlreadyExecuted\", inputs: [] },\n  { type: \"error\", name: \"AlreadySettled\", inputs: [] },\n\n  // ── MoonwellSupplyStrategy / WstETHMoonwellStrategy ──\n  { type: \"error\", name: \"InvalidAmount\", inputs: [] },\n  { type: \"error\", name: \"MintFailed\", inputs: [] },\n  { type: \"error\", name: \"RedeemFailed\", inputs: [] },\n\n  // ── AerodromeLPStrategy ──\n  { type: \"error\", name: \"GaugeMismatch\", inputs: [] },\n\n  // ── WstETHMoonwellStrategy / VeniceInferenceStrategy ──\n  { type: \"error\", name: \"SwapFailed\", inputs: [] },\n  { type: \"error\", name: \"AlreadySettledParams\", inputs: [] },\n\n  // ── VeniceInferenceStrategy ──\n  { type: \"error\", name: \"NoAgent\", inputs: [] },\n] as const;\n\n// ── Human-readable error messages ──\n\nconst ERROR_MESSAGES: Record<string, string> = {\n  // Vault — permissions / state\n  InvalidOwner: \"The caller is not the vault owner.\",\n  NotActiveAgent: \"Your wallet is not registered as an active agent on this vault. Ask the creator to run: sherwood syndicate approve --agent-id <id> --wallet <your-address>\",\n  NotApprovedDepositor: \"Your address is not on the depositor whitelist. Ask the vault creator to approve you.\",\n  NotGovernor: \"This operation can only be called by the governor contract.\",\n  NotFactory: \"This operation can only be called by the factory contract.\",\n  RedemptionsLocked: \"Redemptions are locked while a strategy is executing. Wait for the proposal to be settled.\",\n  DepositsLocked: \"Deposits are locked while an active proposal exists. Wait for settlement.\",\n  InvalidDepositor: \"Invalid depositor address.\",\n  DepositorAlreadyApproved: \"This depositor is already on the whitelist.\",\n  DepositorNotApproved: \"This depositor is not on the whitelist.\",\n  AgentAlreadyRegistered: \"This agent wallet is already registered on the vault.\",\n  AgentNotActive: \"This agent is registered but not active.\",\n  InvalidAgentRegistry: \"Agent registry address is invalid.\",\n  NotAgentOwner: \"You do not own this ERC-8004 agent identity NFT.\",\n  InvalidAgentAddress: \"Invalid agent wallet address (cannot be zero).\",\n  InvalidExecutorImpl: \"Executor implementation address is invalid.\",\n  SimulationFailed: \"Transaction simulation failed — the batch calls would revert onchain.\",\n  TransferFailed: \"ERC-20 token transfer failed. Check token balance and approvals.\",\n  ZeroAddress: \"A required address parameter is the zero address.\",\n  CannotRescueAsset: \"Cannot rescue the vault's underlying asset — use redeem() instead.\",\n\n  // Governor — proposal lifecycle\n  VaultNotRegistered: \"This vault is not registered with the governor. The factory registers vaults automatically on creation.\",\n  VaultAlreadyRegistered: \"This vault is already registered with the governor.\",\n  NotRegisteredAgent: \"Your wallet is not a registered agent on this vault. Register first via: sherwood syndicate approve\",\n  PerformanceFeeTooHigh: \"Performance fee exceeds the governor's maxPerformanceFeeBps. Check: sherwood governor info\",\n  StrategyDurationTooLong: \"Strategy duration exceeds the governor's maxStrategyDuration. Check: sherwood governor info\",\n  StrategyDurationTooShort: \"Strategy duration is below the governor's minStrategyDuration. Check: sherwood governor info\",\n  EmptyExecuteCalls: \"Proposal must include at least one execute call.\",\n  EmptySettlementCalls: \"Proposal must include at least one settlement call.\",\n  NotWithinVotingPeriod: \"Voting period has not started or has already ended. Check: sherwood proposal show <id>\",\n  NoVotingPower: \"You have no voting power (zero vault shares at the snapshot time).\",\n  AlreadyVoted: \"You have already voted on this proposal.\",\n  ProposalNotFound: \"Proposal does not exist. Check the proposal ID.\",\n  ProposalNotApproved: \"Proposal is not in Approved state. It may still be in voting or was rejected.\",\n  ExecutionWindowExpired: \"The execution window has closed. The proposal is now Expired.\",\n  StrategyAlreadyActive: \"Another strategy is currently executing on this vault. Settle it first before executing a new proposal.\",\n  CooldownNotElapsed: \"A proposal was recently settled. Wait for the cooldown period to elapse. Check: sherwood governor info\",\n  ProposalNotExecuted: \"Proposal has not been executed yet. Execute it first.\",\n  ProposalNotCancellable: \"This proposal cannot be cancelled in its current state.\",\n  NotProposer: \"Only the original proposer can perform this action.\",\n  StrategyDurationNotElapsed: \"Strategy duration has not elapsed yet. Only the proposer can settle early.\",\n\n  // Governor — parameter validation\n  InvalidVotingPeriod: \"Voting period is outside allowed bounds (check governor constants).\",\n  InvalidExecutionWindow: \"Execution window is outside allowed bounds.\",\n  InvalidVetoThresholdBps: \"Veto threshold must be between the allowed bounds (in bps).\",\n  InvalidMaxPerformanceFeeBps: \"Max performance fee is outside allowed bounds.\",\n  InvalidStrategyDurationBounds: \"Strategy duration bounds are invalid (min must be < max).\",\n  InvalidCooldownPeriod: \"Cooldown period is outside allowed bounds.\",\n  InvalidVault: \"Invalid vault address.\",\n  NotVaultOwner: \"Only the vault owner can perform this action.\",\n  InvalidProtocolFeeBps: \"Protocol fee exceeds the 10% maximum (1000 bps).\",\n  InvalidProtocolFeeRecipient: \"Protocol fee recipient must be set before enabling protocol fees.\",\n\n  // Governor — collaborative proposals\n  NotCoProposer: \"You are not listed as a co-proposer on this proposal.\",\n  CollaborationExpired: \"The collaboration window has expired.\",\n  AlreadyApproved: \"This co-proposer has already approved.\",\n  InvalidSplits: \"Co-proposer fee splits must sum correctly with the lead proposer split.\",\n  TooManyCoProposers: \"Exceeds the maximum number of co-proposers. Check: sherwood governor info\",\n  SplitTooLow: \"A co-proposer's fee split is below the minimum.\",\n  LeadSplitTooLow: \"The lead proposer's fee split is below the minimum.\",\n  DuplicateCoProposer: \"Duplicate co-proposer address in the list.\",\n  NotDraftState: \"Proposal must be in Draft state for this operation.\",\n  InvalidCollaborationWindow: \"Collaboration window is outside allowed bounds.\",\n  NotAuthorized: \"You are not authorized to perform this action.\",\n  InvalidMaxCoProposers: \"Max co-proposers value is outside allowed bounds.\",\n  Reentrancy: \"Reentrancy detected — this call cannot be made during another call.\",\n\n  // Governor — parameter timelock\n  ChangeAlreadyPending: \"A parameter change is already pending for this parameter. Finalize or cancel it first.\",\n  NoChangePending: \"No parameter change is pending for this key.\",\n  ChangeNotReady: \"Parameter change timelock has not elapsed yet. Wait for the delay to pass, then finalize.\",\n  InvalidParameterChangeDelay: \"Parameter change delay is outside allowed bounds.\",\n  InvalidParameterKey: \"Unknown parameter key.\",\n\n  // Factory\n  InvalidVaultImpl: \"Vault implementation address is invalid.\",\n  InvalidENSRegistrar: \"ENS registrar address is invalid.\",\n  SubdomainTooShort: \"Subdomain must be at least 3 characters.\",\n  SubdomainTaken: \"This subdomain is already taken. Choose a different name.\",\n  NotCreator: \"Only the syndicate creator can perform this action.\",\n  InvalidGovernor: \"Governor address is invalid.\",\n  InsufficientCreationFee: \"Insufficient creation fee. Check the required fee amount.\",\n  InvalidFeeToken: \"Invalid fee token address.\",\n  ManagementFeeTooHigh: \"Management fee exceeds the maximum allowed.\",\n  UpgradesDisabled: \"Vault upgrades are currently disabled by the factory owner.\",\n  VaultNotDeployed: \"Vault has not been deployed yet.\",\n  StrategyActive: \"Cannot perform this action while a strategy is actively executing.\",\n\n  // Strategy — base\n  AlreadyInitialized: \"This strategy clone was already initialized. Deploy a fresh clone.\",\n  NotVault: \"Only the vault can call this strategy function.\",\n  NotExecuted: \"Strategy has not been executed yet.\",\n  AlreadyExecuted: \"Strategy has already been executed.\",\n  AlreadySettled: \"Strategy has already been settled.\",\n\n  // Strategy — Moonwell / WstETH\n  InvalidAmount: \"Invalid amount — must be greater than zero.\",\n  MintFailed: \"Moonwell cToken mint failed. The underlying supply may have hit the market cap.\",\n  RedeemFailed: \"Moonwell cToken redeem failed. Check that sufficient liquidity is available.\",\n\n  // Strategy — Aerodrome\n  GaugeMismatch: \"Aerodrome gauge does not match the expected pool.\",\n\n  // Strategy — WstETH / Venice\n  SwapFailed: \"Token swap failed. Check slippage tolerance and pool liquidity.\",\n  AlreadySettledParams: \"Settlement parameters have already been set.\",\n\n  // Strategy — Venice\n  NoAgent: \"No agent is registered on the vault. Register an agent first.\",\n};\n\n// ── Decoding ──\n\n/**\n * Attempt to decode a hex revert selector into a human-readable error message.\n * Returns null if the selector doesn't match any known contract error.\n */\nexport function decodeContractError(data: Hex): { name: string; message: string } | null {\n  try {\n    const decoded = decodeErrorResult({\n      abi: CONTRACT_ERRORS_ABI,\n      data,\n    });\n    const message = ERROR_MESSAGES[decoded.errorName] || `Contract error: ${decoded.errorName}`;\n    return { name: decoded.errorName, message };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract a hex error selector from a viem error's walk chain.\n * viem wraps contract call reverts in ContractFunctionRevertedError which\n * contains a `data` field with the raw 4-byte (or longer) revert payload.\n */\nfunction extractRevertData(err: unknown): Hex | null {\n  if (!(err instanceof BaseError)) return null;\n\n  // Walk the viem error chain to find revert data\n  const revertError = err.walk((e) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (e as any).data !== undefined;\n  });\n\n  if (revertError) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const data = (revertError as any).data;\n    // data can be the hex string directly, or an object with a data field\n    if (typeof data === \"string\" && data.startsWith(\"0x\")) {\n      return data as Hex;\n    }\n    if (typeof data === \"object\" && data?.data && typeof data.data === \"string\") {\n      return data.data as Hex;\n    }\n  }\n\n  // Fallback: extract 0x + hex from the error message (e.g. \"reverted with 0x62df0545\")\n  const msg = err.message || \"\";\n  const match = msg.match(/(?:signature|data)\\s*\"?(0x[0-9a-fA-F]+)\"?/);\n  if (match) return match[1] as Hex;\n\n  return null;\n}\n\n// ── Known common EVM / ERC-20 revert strings ──\n\nconst KNOWN_REVERT_STRINGS: Record<string, string> = {\n  \"ERC20: transfer amount exceeds balance\": \"Insufficient token balance for this transfer.\",\n  \"ERC20: transfer amount exceeds allowance\": \"Token allowance insufficient. An approval step may have been skipped.\",\n  \"ERC20: insufficient allowance\": \"Token allowance insufficient. An approval step may have been skipped.\",\n  \"Ownable: caller is not the owner\": \"Only the contract owner can call this function.\",\n  \"Pausable: paused\": \"The contract is currently paused.\",\n};\n\n/**\n * Format any caught error into a user-friendly message.\n *\n * Tries (in order):\n * 1. Decode custom error selector from our contract ABIs\n * 2. Match known EVM/ERC-20 revert reason strings\n * 3. Identify nonce / gas issues with actionable advice\n * 4. Fall back to the raw error message\n */\nexport function formatContractError(err: unknown): string {\n  // 1. Try to decode custom contract error\n  const revertData = extractRevertData(err);\n  if (revertData && revertData.length >= 10) {\n    const decoded = decodeContractError(revertData);\n    if (decoded) return decoded.message;\n  }\n\n  const rawMsg = err instanceof Error ? err.message : String(err);\n\n  // 2. Check for known revert reason strings\n  for (const [pattern, message] of Object.entries(KNOWN_REVERT_STRINGS)) {\n    if (rawMsg.includes(pattern)) return message;\n  }\n\n  // 3. Nonce / gas issues — already handled by retry, but surface clearly if they bubble up\n  if (rawMsg.includes(\"replacement transaction underpriced\")) {\n    return \"A previous transaction is stuck. The CLI retried with higher gas but the error persists. Try again in a moment.\";\n  }\n  if (rawMsg.includes(\"nonce too low\") || rawMsg.includes(\"NONCE_EXPIRED\")) {\n    return \"Transaction nonce conflict — a previous transaction is still pending. Wait a moment and retry.\";\n  }\n  if (rawMsg.includes(\"insufficient funds for gas\")) {\n    return \"Insufficient ETH for gas fees. Top up your wallet with ETH on Base.\";\n  }\n\n  // 4. Clean up common viem wrapper noise\n  // Strip \"ContractFunctionRevertedError:\" prefix and \"Docs:\" links\n  let cleaned = rawMsg\n    .replace(/ContractFunctionRevertedError:\\s*/g, \"\")\n    .replace(/Docs:\\s*https:\\/\\/\\S+/g, \"\")\n    .replace(/Version:\\s*viem@\\S+/g, \"\")\n    .replace(/Request Arguments:[\\s\\S]*$/m, \"\")\n    .replace(/Contract Call:[\\s\\S]*?(?=\\n\\n|\\n[A-Z]|$)/m, \"\")\n    .trim();\n\n  // If we still have \"reverted with the following signature: 0x...\" try one more decode\n  const sigMatch = cleaned.match(/signature[:\\s]+\"?(0x[0-9a-fA-F]{8,})\"?/);\n  if (sigMatch) {\n    const decoded = decodeContractError(sigMatch[1] as Hex);\n    if (decoded) return decoded.message;\n    // If we can't decode it, at least explain what it is\n    cleaned = `Contract reverted with unknown error selector ${sigMatch[1]}. Check the transaction on Basescan for details.`;\n  }\n\n  return cleaned;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZPYN5ZAI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/network.ts"],"sourcesContent":["/**\n * Network state singleton.\n *\n * Called once at CLI startup via the --chain flag's preAction hook.\n * Every other module reads from here — never hardcodes a chain.\n */\n\nimport { type Chain, defineChain } from \"viem\";\nimport { base, baseSepolia } from \"viem/chains\";\nimport { getConfigRpcUrl } from \"./config.js\";\n\n// ── Robinhood L2 Testnet (Arbitrum Orbit, chain ID 46630) ──\n\nexport const robinhoodTestnet = defineChain({\n  id: 46630,\n  name: \"Robinhood Chain Testnet\",\n  nativeCurrency: { name: \"Ethereum\", symbol: \"ETH\", decimals: 18 },\n  rpcUrls: {\n    default: { http: [\"https://rpc.testnet.chain.robinhood.com\"] },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Blockscout\",\n      url: \"https://explorer.testnet.chain.robinhood.com\",\n    },\n  },\n  testnet: true,\n});\n\n// ── HyperEVM (Hyperliquid L1, chain ID 999) ──\n\nexport const hyperevm = defineChain({\n  id: 999,\n  name: \"HyperEVM\",\n  nativeCurrency: { name: \"Ethereum\", symbol: \"ETH\", decimals: 18 },\n  rpcUrls: {\n    default: { http: [\"https://rpc.hyperliquid.xyz/evm\"] },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Routescan\",\n      url: \"https://hyperevmscan.io\",\n    },\n  },\n  testnet: false,\n});\n\n// ── HyperEVM Testnet (chain ID 998) ──\n\nexport const hyperevmTestnet = defineChain({\n  id: 998,\n  name: \"HyperEVM Testnet\",\n  nativeCurrency: { name: \"Ethereum\", symbol: \"ETH\", decimals: 18 },\n  rpcUrls: {\n    default: { http: [\"https://rpc.hyperliquid-testnet.xyz/evm\"] },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Routescan\",\n      url: \"https://explorer.hyperliquid-testnet.xyz\",\n    },\n  },\n  testnet: true,\n});\n\n// ── Types ──\n\nexport type Network = \"base\" | \"base-sepolia\" | \"robinhood-testnet\" | \"hyperevm\" | \"hyperevm-testnet\";\n\nexport interface ChainConfig {\n  chain: Chain;\n  rpcFallback: string;\n  /** Legacy env var for backwards compat (base / base-sepolia only) */\n  rpcEnvVar?: string;\n  explorerHost: string;\n  /** EAS GraphQL endpoint — null if EAS is not available on this chain */\n  easGraphqlUrl: string | null;\n  /** EAS scan host — null if unavailable */\n  easScanHost: string | null;\n  xmtpEnv: \"production\" | \"dev\";\n  isTestnet: boolean;\n}\n\n// ── Chain Registry ──\n\nexport const CHAIN_REGISTRY: Record<Network, ChainConfig> = {\n  base: {\n    chain: base,\n    rpcFallback: \"https://mainnet.base.org\",\n    rpcEnvVar: \"BASE_RPC_URL\",\n    explorerHost: \"basescan.org\",\n    easGraphqlUrl: \"https://base.easscan.org/graphql\",\n    easScanHost: \"base.easscan.org\",\n    xmtpEnv: \"production\",\n    isTestnet: false,\n  },\n  \"base-sepolia\": {\n    chain: baseSepolia,\n    rpcFallback: \"https://sepolia.base.org\",\n    rpcEnvVar: \"BASE_SEPOLIA_RPC_URL\",\n    explorerHost: \"sepolia.basescan.org\",\n    easGraphqlUrl: \"https://base-sepolia.easscan.org/graphql\",\n    easScanHost: \"base-sepolia.easscan.org\",\n    xmtpEnv: \"dev\",\n    isTestnet: true,\n  },\n  \"robinhood-testnet\": {\n    chain: robinhoodTestnet,\n    rpcFallback: \"https://rpc.testnet.chain.robinhood.com\",\n    explorerHost: \"explorer.testnet.chain.robinhood.com\",\n    easGraphqlUrl: null,\n    easScanHost: null,\n    xmtpEnv: \"dev\",\n    isTestnet: true,\n  },\n  hyperevm: {\n    chain: hyperevm,\n    rpcFallback: \"https://rpc.hyperliquid.xyz/evm\",\n    rpcEnvVar: \"HYPEREVM_RPC_URL\",\n    explorerHost: \"hyperevmscan.io\",\n    easGraphqlUrl: null,\n    easScanHost: null,\n    xmtpEnv: \"production\",\n    isTestnet: false,\n  },\n  \"hyperevm-testnet\": {\n    chain: hyperevmTestnet,\n    rpcFallback: \"https://rpc.hyperliquid-testnet.xyz/evm\",\n    rpcEnvVar: \"HYPEREVM_TESTNET_RPC_URL\",\n    explorerHost: \"explorer.hyperliquid-testnet.xyz\",\n    easGraphqlUrl: null,\n    easScanHost: null,\n    xmtpEnv: \"dev\",\n    isTestnet: true,\n  },\n};\n\nexport const VALID_NETWORKS = Object.keys(CHAIN_REGISTRY) as Network[];\n\n// ── Singleton state ──\n\nlet _network: Network = \"base\";\n\nexport function setNetwork(n: Network) {\n  const config = CHAIN_REGISTRY[n];\n  if (!config) {\n    throw new Error(\n      `Unknown network: ${n}. Valid: ${VALID_NETWORKS.join(\", \")}`,\n    );\n  }\n  if (config.isTestnet && process.env.ENABLE_TESTNET !== \"true\") {\n    throw new Error(\n      `Testnet \"${n}\" is disabled. Set ENABLE_TESTNET=true to enable.`,\n    );\n  }\n  _network = n;\n}\n\nexport function getNetwork(): Network {\n  return _network;\n}\n\nexport function getChainConfig(): ChainConfig {\n  return CHAIN_REGISTRY[_network];\n}\n\nexport function getChain(): Chain {\n  return CHAIN_REGISTRY[_network].chain;\n}\n\nexport function getRpcUrl(): string {\n  // 1. User config (~/.sherwood/config.json)\n  const fromConfig = getConfigRpcUrl(_network);\n  if (fromConfig) return fromConfig;\n\n  // 2. Legacy env var (backwards compat for base / base-sepolia)\n  const cfg = CHAIN_REGISTRY[_network];\n  if (cfg.rpcEnvVar && process.env[cfg.rpcEnvVar]) {\n    return process.env[cfg.rpcEnvVar]!;\n  }\n\n  // 3. Public fallback\n  return cfg.rpcFallback;\n}\n\nexport function getExplorerUrl(txHash: string): string {\n  return `https://${CHAIN_REGISTRY[_network].explorerHost}/tx/${txHash}`;\n}\n\nexport function isTestnet(): boolean {\n  return CHAIN_REGISTRY[_network].isTestnet;\n}\n"],"mappings":";;;;;AAOA,SAAqB,mBAAmB;AACxC,SAAS,MAAM,mBAAmB;AAK3B,IAAM,mBAAmB,YAAY;AAAA,EAC1C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,YAAY,QAAQ,OAAO,UAAU,GAAG;AAAA,EAChE,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,yCAAyC,EAAE;AAAA,EAC/D;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,SAAS;AACX,CAAC;AAIM,IAAM,WAAW,YAAY;AAAA,EAClC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,YAAY,QAAQ,OAAO,UAAU,GAAG;AAAA,EAChE,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,iCAAiC,EAAE;AAAA,EACvD;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,SAAS;AACX,CAAC;AAIM,IAAM,kBAAkB,YAAY;AAAA,EACzC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB,EAAE,MAAM,YAAY,QAAQ,OAAO,UAAU,GAAG;AAAA,EAChE,SAAS;AAAA,IACP,SAAS,EAAE,MAAM,CAAC,yCAAyC,EAAE;AAAA,EAC/D;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,SAAS;AACX,CAAC;AAsBM,IAAM,iBAA+C;AAAA,EAC1D,MAAM;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,WAAW;AAAA,IACX,cAAc;AAAA,IACd,eAAe;AAAA,IACf,aAAa;AAAA,IACb,SAAS;AAAA,IACT,WAAW;AAAA,EACb;AAAA,EACA,gBAAgB;AAAA,IACd,OAAO;AAAA,IACP,aAAa;AAAA,IACb,WAAW;AAAA,IACX,cAAc;AAAA,IACd,eAAe;AAAA,IACf,aAAa;AAAA,IACb,SAAS;AAAA,IACT,WAAW;AAAA,EACb;AAAA,EACA,qBAAqB;AAAA,IACnB,OAAO;AAAA,IACP,aAAa;AAAA,IACb,cAAc;AAAA,IACd,eAAe;AAAA,IACf,aAAa;AAAA,IACb,SAAS;AAAA,IACT,WAAW;AAAA,EACb;AAAA,EACA,UAAU;AAAA,IACR,OAAO;AAAA,IACP,aAAa;AAAA,IACb,WAAW;AAAA,IACX,cAAc;AAAA,IACd,eAAe;AAAA,IACf,aAAa;AAAA,IACb,SAAS;AAAA,IACT,WAAW;AAAA,EACb;AAAA,EACA,oBAAoB;AAAA,IAClB,OAAO;AAAA,IACP,aAAa;AAAA,IACb,WAAW;AAAA,IACX,cAAc;AAAA,IACd,eAAe;AAAA,IACf,aAAa;AAAA,IACb,SAAS;AAAA,IACT,WAAW;AAAA,EACb;AACF;AAEO,IAAM,iBAAiB,OAAO,KAAK,cAAc;AAIxD,IAAI,WAAoB;AAEjB,SAAS,WAAW,GAAY;AACrC,QAAM,SAAS,eAAe,CAAC;AAC/B,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR,oBAAoB,CAAC,YAAY,eAAe,KAAK,IAAI,CAAC;AAAA,IAC5D;AAAA,EACF;AACA,MAAI,OAAO,aAAa,QAAQ,IAAI,mBAAmB,QAAQ;AAC7D,UAAM,IAAI;AAAA,MACR,YAAY,CAAC;AAAA,IACf;AAAA,EACF;AACA,aAAW;AACb;AAEO,SAAS,aAAsB;AACpC,SAAO;AACT;AAEO,SAAS,iBAA8B;AAC5C,SAAO,eAAe,QAAQ;AAChC;AAEO,SAAS,WAAkB;AAChC,SAAO,eAAe,QAAQ,EAAE;AAClC;AAEO,SAAS,YAAoB;AAElC,QAAM,aAAa,gBAAgB,QAAQ;AAC3C,MAAI,WAAY,QAAO;AAGvB,QAAM,MAAM,eAAe,QAAQ;AACnC,MAAI,IAAI,aAAa,QAAQ,IAAI,IAAI,SAAS,GAAG;AAC/C,WAAO,QAAQ,IAAI,IAAI,SAAS;AAAA,EAClC;AAGA,SAAO,IAAI;AACb;AAEO,SAAS,eAAe,QAAwB;AACrD,SAAO,WAAW,eAAe,QAAQ,EAAE,YAAY,OAAO,MAAM;AACtE;AAEO,SAAS,YAAqB;AACnC,SAAO,eAAe,QAAQ,EAAE;AAClC;","names":[]}

package/dist/research-NCESMYXK.js

@@ -1,14 +0,0 @@
-import {
-  MessariProvider,
-  NansenProvider,
-  getResearchProvider
-} from "./chunk-QGEIK4H5.js";
-import "./chunk-WRG7GAIA.js";
-import "./chunk-ZPYN5ZAI.js";
-import "./chunk-RGOTBJIN.js";
-export {
-  MessariProvider,
-  NansenProvider,
-  getResearchProvider
-};
-//# sourceMappingURL=research-NCESMYXK.js.map

package/dist/xmtp-XTJ7HDVG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/xmtp.ts"],"sourcesContent":["/**\n * XMTP client and group operations for syndicate chat.\n *\n * Uses @xmtp/node-sdk directly with a singleton Client instance.\n * Deterministic DB path (~/.sherwood/xmtp/) and encryption key derived\n * from the sherwood private key via keccak256.\n *\n * This replaces the previous @xmtp/cli subprocess architecture which\n * caused stale MLS installations (issue #110).\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { homedir } from \"node:os\";\nimport {\n  Client,\n  ConsentState,\n  Group,\n  GroupPermissionsOptions,\n  IdentifierKind,\n  type CreateGroupOptions,\n  type DecodedMessage,\n  type Identifier,\n  type NetworkOptions,\n  type Signer,\n  type XmtpEnv,\n} from \"@xmtp/node-sdk\";\nimport { keccak256, toBytes } from \"viem\";\nimport {\n  loadConfig,\n  saveConfig,\n  cacheGroupId,\n  getCachedGroupId,\n} from \"./config.js\";\nimport { getTextRecord } from \"./ens.js\";\nimport { getChainConfig } from \"./network.js\";\nimport type { ChatEnvelope } from \"./types.js\";\nimport { getAccount } from \"./client.js\";\n\n// ── Types ──\n\nexport interface XmtpMessage {\n  id: string;\n  conversationId: string;\n  senderInboxId: string;\n  contentType: string;\n  content: string;\n  sentAt: Date;\n}\n\nexport interface XmtpMember {\n  inboxId: string;\n  permissionLevel: string;\n}\n\n// ── Internal helpers ──\n\nlet _client: Client | null = null;\n\nfunction getXmtpEnv(): string {\n  return getChainConfig().xmtpEnv;\n}\n\nfunction getDbEncryptionKey(privateKey: string): Uint8Array {\n  const hash = keccak256(toBytes(privateKey + \"xmtp-db-key\"));\n  return toBytes(hash);\n}\n\nfunction getDbPath(): string {\n  const dir = path.join(homedir(), \".sherwood\", \"xmtp\");\n  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });\n  return path.join(dir, \"xmtp.db3\");\n}\n\nfunction ethIdentifier(address: string): Identifier {\n  return {\n    identifier: address.toLowerCase(),\n    identifierKind: IdentifierKind.Ethereum,\n  };\n}\n\nasync function getOrCreateClient(): Promise<Client> {\n  if (_client) return _client;\n\n  const config = loadConfig();\n  if (!config.privateKey) {\n    throw new Error(\n      'No private key configured. Run \"sherwood config set --private-key 0x...\"',\n    );\n  }\n\n  const account = getAccount();\n\n  const signer: Signer = {\n    type: \"EOA\",\n    getIdentifier: () => ({\n      identifier: account.address.toLowerCase(),\n      identifierKind: IdentifierKind.Ethereum,\n    }),\n    signMessage: async (message: string) => {\n      const signature = await account.signMessage({ message });\n      return toBytes(signature);\n    },\n  };\n\n  const clientOptions: NetworkOptions = {\n    env: getXmtpEnv() as XmtpEnv,\n  };\n  _client = await Client.create(signer, {\n    ...clientOptions,\n    dbEncryptionKey: getDbEncryptionKey(config.privateKey),\n    dbPath: getDbPath(),\n  });\n\n  // Sync all conversations on first connect (processes MLS welcome messages)\n  await _client.conversations.syncAll([ConsentState.Allowed]);\n\n  // One-time migration: revoke stale installations from the old ~/.xmtp/ era\n  if (!config._xmtpMigrated) {\n    try {\n      await _client.revokeAllOtherInstallations();\n    } catch {\n      // Non-fatal — stale installations are a UX issue, not a blocker\n    }\n    config._xmtpMigrated = true;\n    saveConfig(config);\n  }\n\n  return _client;\n}\n\n// ── Client ──\n\nexport async function getXmtpClient(): Promise<string> {\n  const client = await getOrCreateClient();\n\n  // Cache inbox ID\n  const config = loadConfig();\n  if (!config.xmtpInboxId && client.inboxId) {\n    config.xmtpInboxId = client.inboxId;\n    saveConfig(config);\n  }\n\n  return client.inboxId;\n}\n\n// ── Group Creation ──\n\nexport async function createSyndicateGroup(\n  _client: string,\n  subdomain: string,\n  isPublic: boolean = false,\n): Promise<string> {\n  const client = await getOrCreateClient();\n\n  const group = await client.conversations.createGroup([], {\n    name: subdomain,\n    description: `Sherwood syndicate: ${subdomain}.sherwoodagent.eth`,\n    permissionLevel: GroupPermissionsOptions.AdminOnly,\n  } as CreateGroupOptions);\n\n  const groupId = group.id;\n  if (!groupId) {\n    throw new Error(\"Failed to create XMTP group — no group ID returned\");\n  }\n\n  // Add spectator if requested — enables dashboard live feed\n  const SPECTATOR_ADDRESS =\n    process.env.DASHBOARD_SPECTATOR_ADDRESS ||\n    \"0x9f6518e69a62c526ead155ad2661f5957b6b2fc3\";\n  if (isPublic) {\n    await addMember(groupId, SPECTATOR_ADDRESS);\n  }\n\n  // Cache locally\n  cacheGroupId(subdomain, groupId);\n\n  return groupId;\n}\n\n// ── Group Lookup ──\n\nexport async function getGroup(\n  _client: string,\n  subdomain: string,\n): Promise<string> {\n  const client = await getOrCreateClient();\n\n  // Sync to get latest conversations (including MLS welcome messages)\n  await client.conversations.syncAll([ConsentState.Allowed]);\n\n  // Try local cache\n  let groupId: string | undefined = getCachedGroupId(subdomain);\n\n  // Validate cached ID actually exists in the local DB\n  if (groupId) {\n    const conv = await client.conversations.getConversationById(groupId);\n    if (!conv) {\n      cacheGroupId(subdomain, \"\"); // invalidate stale entry\n      groupId = undefined;\n    }\n  }\n\n  // Fall back to on-chain ENS text record\n  if (!groupId) {\n    const ensId = await getTextRecord(subdomain, \"xmtpGroupId\");\n    if (ensId) {\n      const conv = await client.conversations.getConversationById(ensId);\n      if (conv) {\n        groupId = ensId;\n        cacheGroupId(subdomain, groupId);\n      }\n    }\n  }\n\n  // Last resort: search synced conversations by name\n  if (!groupId) {\n    const groups = client.conversations.listGroups();\n    const match = groups.find(\n      (g) =>\n        g.name === subdomain ||\n        g.description?.includes(`${subdomain}.sherwoodagent.eth`),\n    );\n    if (match) {\n      groupId = match.id;\n      cacheGroupId(subdomain, groupId);\n    }\n  }\n\n  if (!groupId) {\n    throw new Error(\n      `No XMTP group found for syndicate \"${subdomain}\". Run \"sherwood chat ${subdomain} init\" to create one.`,\n    );\n  }\n\n  return groupId;\n}\n\n// ── Member Management ──\n\nexport async function addMember(\n  groupId: string,\n  address: string,\n): Promise<void> {\n  const client = await getOrCreateClient();\n\n  // Verify the target has an active XMTP identity before adding\n  const reachable = await client.canMessage([ethIdentifier(address)]);\n  // Try both original and lowercased as map key\n  const isReachable =\n    reachable.get(address) ?? reachable.get(address.toLowerCase()) ?? false;\n  if (!isReachable) {\n    throw new Error(\n      `${address} is not reachable on XMTP. They need to initialize their client first.`,\n    );\n  }\n\n  await client.conversations.syncAll([ConsentState.Allowed]);\n  const conv = await client.conversations.getConversationById(groupId);\n  if (!conv) throw new Error(`Conversation ${groupId} not found`);\n\n  // Cast to Group — we know syndicate conversations are always groups\n  const group = conv as Group;\n  await group.addMembersByIdentifiers([ethIdentifier(address)]);\n\n  // Set consent to \"allowed\" so subsequent operations don't skip this conversation\n  try {\n    group.updateConsentState(ConsentState.Allowed);\n  } catch {\n    // Non-fatal — consent state is a filtering concern, not a blocker\n  }\n}\n\nexport async function removeMember(\n  groupId: string,\n  address: string,\n): Promise<void> {\n  const client = await getOrCreateClient();\n  await client.conversations.syncAll([ConsentState.Allowed]);\n\n  const conv = await client.conversations.getConversationById(groupId);\n  if (!conv) throw new Error(`Conversation ${groupId} not found`);\n\n  // Cast to Group — we know syndicate conversations are always groups\n  const group = conv as Group;\n  await group.removeMembersByIdentifiers([ethIdentifier(address)]);\n}\n\n// ── Messaging ──\n\nexport async function sendEnvelope(\n  groupId: string,\n  envelope: ChatEnvelope,\n): Promise<void> {\n  const client = await getOrCreateClient();\n  const conv = await client.conversations.getConversationById(groupId);\n  if (!conv) throw new Error(`Conversation ${groupId} not found`);\n\n  const text = JSON.stringify(envelope);\n  await conv.sendText(text);\n}\n\nexport async function sendMarkdown(\n  groupId: string,\n  markdown: string,\n): Promise<void> {\n  const envelope: ChatEnvelope = {\n    type: \"MESSAGE\",\n    from: getAccount().address,\n    text: markdown,\n    data: { format: \"markdown\" },\n    timestamp: Math.floor(Date.now() / 1000),\n  };\n  await sendEnvelope(groupId, envelope);\n}\n\nexport async function sendReaction(\n  groupId: string,\n  messageId: string,\n  emoji: string,\n): Promise<void> {\n  const envelope: ChatEnvelope = {\n    type: \"REACTION\",\n    from: getAccount().address,\n    data: { reference: messageId, emoji },\n    timestamp: Math.floor(Date.now() / 1000),\n  };\n  await sendEnvelope(groupId, envelope);\n}\n\n// ── Streaming ──\n\nexport async function streamMessages(\n  groupId: string,\n  onMessage: (msg: XmtpMessage) => void,\n): Promise<() => void> {\n  const client = await getOrCreateClient();\n\n  const stream = await client.conversations.streamAllMessages({\n    consentStates: [ConsentState.Allowed],\n  });\n\n  let stopped = false;\n\n  // Consume stream in background\n  (async () => {\n    try {\n      for await (const message of stream) {\n        if (stopped) break;\n        // Filter to our group\n        if (message.conversationId !== groupId) continue;\n\n        onMessage({\n          id: message.id || \"\",\n          conversationId: message.conversationId || \"\",\n          senderInboxId: message.senderInboxId || \"\",\n          contentType:\n            typeof message.contentType === \"object\"\n              ? (message.contentType as { typeId?: string })?.typeId || \"text\"\n              : String(message.contentType || \"text\"),\n          content:\n            typeof message.content === \"string\"\n              ? message.content\n              : JSON.stringify(message.content),\n          sentAt: message.sentAt || new Date(),\n        });\n      }\n    } catch {\n      // Stream ended or errored — expected on cleanup\n    }\n  })();\n\n  // Return cleanup function\n  return () => {\n    stopped = true;\n    try {\n      // AsyncStreamProxy exposes end() to terminate the stream\n      if (typeof (stream as any).end === \"function\") {\n        (stream as any).end();\n      } else if (typeof (stream as any).return === \"function\") {\n        (stream as any).return();\n      }\n    } catch {\n      // Best-effort cleanup\n    }\n  };\n}\n\n// ── Message History ──\n\nexport async function getRecentMessages(\n  groupId: string,\n  limit: number = 20,\n): Promise<XmtpMessage[]> {\n  const client = await getOrCreateClient();\n  const conv = await client.conversations.getConversationById(groupId);\n  if (!conv) throw new Error(`Conversation ${groupId} not found`);\n\n  // Sync to get latest messages\n  await conv.sync();\n\n  const rawMessages = await conv.messages({ limit });\n\n  return rawMessages.map((m) => ({\n    id: m.id || \"\",\n    conversationId: m.conversationId || \"\",\n    senderInboxId: m.senderInboxId || \"\",\n    contentType:\n      typeof m.contentType === \"object\"\n        ? (m.contentType as { typeId?: string })?.typeId || \"text\"\n        : String(m.contentType || \"text\"),\n    content:\n      typeof m.content === \"string\"\n        ? m.content\n        : JSON.stringify(m.content),\n    sentAt: m.sentAt || new Date(),\n  }));\n}\n\n// ── Members ──\n\nexport async function getMembers(\n  groupId: string,\n): Promise<XmtpMember[]> {\n  const client = await getOrCreateClient();\n  const conv = await client.conversations.getConversationById(groupId);\n  if (!conv) throw new Error(`Conversation ${groupId} not found`);\n\n  const members = await conv.members();\n\n  return (Array.isArray(members) ? members : []).map((m: any) => ({\n    inboxId: String(m.inboxId || \"\"),\n    permissionLevel:\n      m.permissionLevel === 2\n        ? \"super_admin\"\n        : m.permissionLevel === 1\n          ? \"admin\"\n          : \"member\",\n  }));\n}\n"],"mappings":"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","names":["_client"]}