@sherwoodagent/cli 0.86.1 → 0.87.1

package/dist/chunk-EA65CDQH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/events.ts"],"sourcesContent":["/**\n * On-chain event reader — fetches vault and governor events via viem getLogs.\n *\n * Uses HTTP RPC (no WebSocket needed). Block ranges are capped at 10,000\n * per call to avoid RPC timeouts (~83 minutes on Base at 2 blocks/sec).\n */\n\nimport type { Address, Log } from \"viem\";\nimport { parseAbiItem } from \"viem\";\nimport { getPublicClient } from \"./client.js\";\nimport { getProposal, PROPOSAL_STATES } from \"./governor.js\";\nimport { resolveMetadataSummary } from \"./ipfs.js\";\n\nconst MAX_BLOCK_RANGE = 10_000n;\n\n// ── Event signatures (parseAbiItem format for getLogs) ──\n\nexport const VAULT_EVENTS = [\n  parseAbiItem(\"event AgentRegistered(uint256 indexed agentId, address indexed agentAddress)\"),\n  parseAbiItem(\"event AgentRemoved(address indexed agentAddress)\"),\n  parseAbiItem(\"event DepositorApproved(address indexed depositor)\"),\n  parseAbiItem(\"event DepositorRemoved(address indexed depositor)\"),\n  parseAbiItem(\"event RedemptionsLockedEvent()\"),\n  parseAbiItem(\"event RedemptionsUnlockedEvent()\"),\n  // ISyndicateVault.SandboxRun — a proposal's sandbox was minted, funded and run.\n  // NAME COLLISION WARNING: ICallSandbox also declares a `SandboxRun` event with a\n  // DIFFERENT shape (SandboxRun(address,uint256,uint256), topic0 0x2638b671…) than\n  // this vault-side one (topic0 0x6fbfaa03…). Downstream consumers (the\n  // sherwood-monitor Hermes plugin) route by the `type` string, so ONLY the vault\n  // event may be emitted as \"SandboxRun\". If the ICallSandbox event is ever wired\n  // here, it MUST get a distinct type string (e.g. \"CallSandboxRun\").\n  parseAbiItem(\"event SandboxRun(uint256 indexed pid, address indexed sandbox, uint256 funding)\"),\n] as const;\n\nexport const GOVERNOR_EVENTS = [\n  parseAbiItem(\"event ProposalCreated(uint256 indexed proposalId, address indexed proposer, address indexed vault, uint256 performanceFeeBps, uint256 strategyDuration, uint256 executeCallCount, uint256 settlementCallCount, string metadataURI)\"),\n  parseAbiItem(\"event VoteCast(uint256 indexed proposalId, address indexed voter, uint8 support, uint256 weight)\"),\n  parseAbiItem(\"event ProposalExecuted(uint256 indexed proposalId, address indexed vault, uint256 capitalSnapshot)\"),\n  parseAbiItem(\"event ProposalSettled(uint256 indexed proposalId, address indexed vault, int256 pnl, uint256 performanceFee, uint256 duration)\"),\n  parseAbiItem(\"event ProposalCancelled(uint256 indexed proposalId, address indexed cancelledBy)\"),\n  // ISyndicateGovernor.SandboxPayloadStored — a proposeWithSandbox payload was\n  // stored for proposalId. The call set itself is not in the log (read it via\n  // `sandboxPayload`); the counts are the cheap off-chain signal.\n  parseAbiItem(\"event SandboxPayloadStored(uint256 indexed proposalId, uint256 funding, uint256 callCount, uint256 tokenCount)\"),\n] as const;\n\n// IGuardianRegistry — guardian review lifecycle for proposals.\nexport const GUARDIAN_REGISTRY_EVENTS = [\n  parseAbiItem(\"event ReviewOpened(uint256 indexed proposalId, uint128 totalStakeAtOpen)\"),\n  parseAbiItem(\"event ReviewResolved(uint256 indexed proposalId, bool blocked, uint256 slashedAmount)\"),\n] as const;\n\n// StakedWood — approver slashes for blocked proposals.\nexport const STAKED_WOOD_EVENTS = [\n  parseAbiItem(\"event GuardianSlashed(bytes32 indexed reviewKey, address indexed approver, uint256 ownSlash, uint256 delegatedSlash)\"),\n] as const;\n\n/** Normalized event returned by the session check. */\nexport interface ChainEvent {\n  source: \"chain\";\n  type: string;\n  block: number;\n  tx: string;\n  args: Record<string, string>;\n}\n\nfunction logToChainEvent(log: Log, eventName: string): ChainEvent {\n  const args: Record<string, string> = {};\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const decoded = (log as any).args;\n  if (decoded) {\n    for (const [key, value] of Object.entries(decoded)) {\n      args[key] = String(value);\n    }\n  }\n\n  return {\n    source: \"chain\",\n    type: eventName,\n    block: Number(log.blockNumber),\n    tx: log.transactionHash || \"\",\n    args,\n  };\n}\n\n/**\n * Fetch events in chunks to stay within RPC limits.\n * Returns all logs from `fromBlock` to `toBlock` inclusive.\n * Exported for reuse (e.g. vault.ts getNetDeposited's 0→latest scan).\n */\nexport async function getLogsChunked(params: {\n  address: Address;\n  events: readonly ReturnType<typeof parseAbiItem>[];\n  fromBlock: bigint;\n  toBlock: bigint;\n}): Promise<Log[]> {\n  const client = getPublicClient();\n  const { address, events, fromBlock, toBlock } = params;\n\n  const allLogs: Log[] = [];\n  let cursor = fromBlock;\n\n  while (cursor <= toBlock) {\n    const end =\n      cursor + MAX_BLOCK_RANGE - 1n > toBlock\n        ? toBlock\n        : cursor + MAX_BLOCK_RANGE - 1n;\n\n    const logs = await client.getLogs({\n      address,\n      events: events as never,\n      fromBlock: cursor,\n      toBlock: end,\n    });\n\n    allLogs.push(...logs);\n    cursor = end + 1n;\n  }\n\n  return allLogs;\n}\n\n/** Fetch vault events (AgentRegistered, Ragequit, etc.) */\nexport async function getVaultEvents(\n  vaultAddress: Address,\n  fromBlock: bigint,\n  toBlock: bigint,\n): Promise<ChainEvent[]> {\n  const logs = await getLogsChunked({\n    address: vaultAddress,\n    events: VAULT_EVENTS,\n    fromBlock,\n    toBlock,\n  });\n\n  return logs.map((log) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const eventName = (log as any).eventName || \"UnknownVaultEvent\";\n    return logToChainEvent(log, eventName);\n  });\n}\n\n/** Fetch governor events filtered to a specific vault. */\nexport async function getGovernorEvents(\n  governorAddress: Address,\n  vaultAddress: Address,\n  fromBlock: bigint,\n  toBlock: bigint,\n): Promise<ChainEvent[]> {\n  if (governorAddress === \"0x0000000000000000000000000000000000000000\") {\n    return []; // Governor not deployed yet\n  }\n\n  const logs = await getLogsChunked({\n    address: governorAddress,\n    events: GOVERNOR_EVENTS,\n    fromBlock,\n    toBlock,\n  });\n\n  // Filter governor events to only those involving our vault\n  return logs\n    .filter((log) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const args = (log as any).args;\n      if (!args) return true;\n      // ProposalCreated, ProposalExecuted, ProposalSettled have `vault` in args\n      if (args.vault) {\n        return (args.vault as string).toLowerCase() === vaultAddress.toLowerCase();\n      }\n      // VoteCast, ProposalCancelled don't have vault — include them\n      // (agents care about all votes/cancellations on their governor)\n      return true;\n    })\n    .map((log) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const eventName = (log as any).eventName || \"UnknownGovernorEvent\";\n      return logToChainEvent(log, eventName);\n    });\n}\n\n/**\n * Fetch guardian review events (ReviewOpened, ReviewResolved) from the\n * GuardianRegistry. Returns [] when the registry is not deployed (zero address).\n * Not filterable per vault — proposalIds are governor-scoped, so callers get\n * every review on the chain's registry (mirrors the VoteCast rationale above).\n */\nexport async function getGuardianRegistryEvents(\n  registryAddress: Address,\n  fromBlock: bigint,\n  toBlock: bigint,\n): Promise<ChainEvent[]> {\n  if (registryAddress === \"0x0000000000000000000000000000000000000000\") {\n    return []; // GuardianRegistry not deployed on this chain\n  }\n\n  const logs = await getLogsChunked({\n    address: registryAddress,\n    events: GUARDIAN_REGISTRY_EVENTS,\n    fromBlock,\n    toBlock,\n  });\n\n  return logs.map((log) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const eventName = (log as any).eventName || \"UnknownGuardianRegistryEvent\";\n    return logToChainEvent(log, eventName);\n  });\n}\n\n/**\n * Fetch guardian slash events (GuardianSlashed) from StakedWood.\n * Returns [] when sWOOD is not deployed (zero address).\n */\nexport async function getStakedWoodEvents(\n  stakedWoodAddress: Address,\n  fromBlock: bigint,\n  toBlock: bigint,\n): Promise<ChainEvent[]> {\n  if (stakedWoodAddress === \"0x0000000000000000000000000000000000000000\") {\n    return []; // StakedWood not deployed on this chain\n  }\n\n  const logs = await getLogsChunked({\n    address: stakedWoodAddress,\n    events: STAKED_WOOD_EVENTS,\n    fromBlock,\n    toBlock,\n  });\n\n  return logs.map((log) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const eventName = (log as any).eventName || \"UnknownStakedWoodEvent\";\n    return logToChainEvent(log, eventName);\n  });\n}\n\n/** Get current block number from the RPC. */\nexport async function getCurrentBlock(): Promise<bigint> {\n  const client = getPublicClient();\n  return client.getBlockNumber();\n}\n\n// ── Proposal event enrichment ──\n\nconst PROPOSAL_EVENT_TYPES = new Set([\n  \"ProposalCreated\",\n  \"VoteCast\",\n  \"ProposalExecuted\",\n  \"ProposalSettled\",\n  \"ProposalCancelled\",\n]);\n\n/**\n * Enrich proposal-related events with IPFS metadata (name, description)\n * and current on-chain state. Best-effort — events are returned un-enriched\n * if RPC or IPFS calls fail.\n *\n * `vault` identifies which per-vault governor to read proposal state from\n * (proposal IDs are scoped to a vault's governor in the per-vault design).\n *\n * An optional metadataCache avoids redundant IPFS fetches across poll cycles\n * in streaming mode (proposal metadata is immutable once pinned).\n */\nexport async function enrichProposalEvents(\n  vault: Address,\n  events: ChainEvent[],\n  metadataCache?: Map<string, { name: string; description: string }>,\n): Promise<ChainEvent[]> {\n  const cache = metadataCache ?? new Map<string, { name: string; description: string }>();\n\n  const proposalEvents = events.filter((e) => PROPOSAL_EVENT_TYPES.has(e.type));\n  if (proposalEvents.length === 0) return events;\n\n  // Collect unique proposalIds and their metadata sources\n  const idsNeedingLookup = new Set<string>();\n  const createdURIs = new Map<string, string>(); // proposalId → metadataURI from event args\n\n  for (const event of proposalEvents) {\n    const pid = event.args.proposalId;\n    if (!pid) continue;\n\n    if (event.type === \"ProposalCreated\" && event.args.metadataURI) {\n      createdURIs.set(pid, event.args.metadataURI);\n    } else if (!cache.has(pid)) {\n      idsNeedingLookup.add(pid);\n    }\n  }\n\n  // Fetch on-chain proposal data for non-Created events (parallel, deduplicated)\n  const proposalData = new Map<string, { metadataURI: string; state: number }>();\n\n  await Promise.all(\n    Array.from(idsNeedingLookup).map(async (pid) => {\n      try {\n        const p = await getProposal(vault, BigInt(pid));\n        proposalData.set(pid, { metadataURI: p.metadataURI, state: p.state });\n      } catch {\n        // RPC failure — skip enrichment for this proposalId\n      }\n    }),\n  );\n\n  // Resolve IPFS metadata (parallel, deduplicated, uses cache)\n  const allURIs = new Map<string, string>();\n  for (const [pid, uri] of createdURIs) allURIs.set(pid, uri);\n  for (const [pid, data] of proposalData) {\n    if (!allURIs.has(pid)) allURIs.set(pid, data.metadataURI);\n  }\n\n  await Promise.all(\n    Array.from(allURIs.entries()).map(async ([pid, uri]) => {\n      if (cache.has(pid) || !uri) return;\n      const summary = await resolveMetadataSummary(uri);\n      if (summary) cache.set(pid, summary);\n    }),\n  );\n\n  // Inject enrichment fields into event args\n  return events.map((event) => {\n    if (!PROPOSAL_EVENT_TYPES.has(event.type)) return event;\n    const pid = event.args.proposalId;\n    if (!pid) return event;\n\n    const meta = cache.get(pid);\n    const pData = proposalData.get(pid);\n    const enrichedArgs = { ...event.args };\n\n    if (meta) {\n      enrichedArgs.proposalName = meta.name;\n      enrichedArgs.proposalDescription = meta.description;\n    }\n\n    if (event.type === \"ProposalCreated\") {\n      enrichedArgs.proposalState = \"Pending\";\n    } else if (pData) {\n      enrichedArgs.proposalState = PROPOSAL_STATES[pData.state] || \"Unknown\";\n    }\n\n    return { ...event, args: enrichedArgs };\n  });\n}\n"],"mappings":"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","names":[]}