@chipi-stack/chipi-react 14.7.0 → 14.8.0

package/dist/multisig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/multisig/action-template.ts","../src/multisig/oe.ts","../src/multisig/proposals.ts","../src/multisig/use-hooks.ts"],"names":["MAX_OE_VALIDITY_WINDOW_SECONDS","buildOutsideExecution","ANY_CALLER_FELT","computeOeHash","buildThresholdEnvelope","serializeExecuteFromOutsideV2Calldata","useQueryClient","useMutation","useQuery"],"mappings":"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","file":"multisig.js","sourcesContent":["/**\n * Framework-agnostic action-template engine for SHHH multisig governance.\n *\n * An {@link ActionTemplate} maps friendly, typed form fields → an\n * OutsideExecution call list + a human-readable title. It's the seam that\n * turns \"call any contract\" (powerful, scary) into \"fill in this form\"\n * (founder-grade) — and the whitelabel seam: every integrator registers\n * its own templates (Roca: create_pool / borrow / repay), while `Vote`\n * ships built-in. The raw-call escape hatch lives in the UI layer, not\n * here, because its arguments are open-ended.\n *\n * Pure: no React, no network — so the same template renders the proposer's\n * form, every approver's inbox, and the notification, from one source of\n * truth, and `toCalls` is deterministic (proposer and executor build the\n * identical OE → the hash matches).\n */\n\nexport type FeltLike = string | number | bigint;\n\n/** One call in an action — the shape the OE builder consumes. */\nexport interface CallSpec {\n  to: string;\n  entrypoint: string;\n  /** Flat 0x-hex felts. */\n  calldata: string[];\n}\n\n/** A typed input in an action template. */\nexport type FieldSpec =\n  | { name: string; label: string; type: \"amount\"; decimals: number; help?: string }\n  | { name: string; label: string; type: \"address\"; help?: string }\n  | { name: string; label: string; type: \"number\" | \"bps\" | \"days\" | \"felt\"; help?: string }\n  | {\n      name: string;\n      label: string;\n      type: \"select\";\n      options: { label: string; value: string }[];\n      help?: string;\n    }\n  | { name: string; label: string; type: \"text\"; help?: string };\n\nexport interface ActionTemplate<V = Record<string, unknown>> {\n  /** Stable id, persisted on the proposal. */\n  key: string;\n  /** Display label (\"Create pool\"). */\n  label: string;\n  description?: string;\n  /** Typed inputs rendered by `<ProposeAction>`. */\n  fields: FieldSpec[];\n  /** Pure: validated field values → the OE call list. */\n  toCalls: (v: V) => CallSpec[];\n  /** Pure: the plain-language title shown in the preview, inbox, and email. */\n  title: (v: V) => string;\n  /** Optional metadata persisted with the proposal so the approver's app\n   *  can render business context (e.g. `{ poolId }`). */\n  meta?: (v: V) => Record<string, string | number>;\n}\n\n/** Starknet felt252 field prime — args must be a non-negative felt below it. */\nexport const FELT_PRIME = BigInt(\n  \"0x800000000000011000000000000000000000000000000000000000000000001\"\n);\n\nconst U128_MASK = (1n << 128n) - 1n;\n\n/** Parse a decimal or 0x-hex value to a canonical `0x` felt. Throws on a\n *  non-numeric or out-of-range value. */\nexport function toFelt(v: FeltLike): string {\n  let n: bigint;\n  try {\n    n = BigInt(typeof v === \"string\" ? v.trim() : v);\n  } catch {\n    throw new Error(`Not a felt: ${String(v)}`);\n  }\n  if (n < 0n || n >= FELT_PRIME) {\n    throw new Error(`Felt out of range: ${String(v)}`);\n  }\n  return \"0x\" + n.toString(16);\n}\n\n/** Split a u256 value into its `[low, high]` felts (Cairo calling convention). */\nexport function u256(v: FeltLike): [string, string] {\n  const n = BigInt(typeof v === \"string\" ? v.trim() : v);\n  if (n < 0n) throw new Error(\"u256 must be non-negative\");\n  return [\"0x\" + (n & U128_MASK).toString(16), \"0x\" + (n >> 128n).toString(16)];\n}\n\n/** Convert a human amount (\"10.5\") to base units given a token's decimals. */\nexport function amountToBase(amount: string, decimals: number): bigint {\n  const t = amount.trim();\n  if (!/^\\d+(\\.\\d+)?$/.test(t)) throw new Error(`Invalid amount: ${amount}`);\n  const [whole, frac = \"\"] = t.split(\".\");\n  if (frac.length > decimals) {\n    throw new Error(`Too many decimal places (max ${decimals})`);\n  }\n  const padded = (frac + \"0\".repeat(decimals)).slice(0, decimals);\n  return BigInt(whole) * 10n ** BigInt(decimals) + BigInt(padded || \"0\");\n}\n\n/**\n * Identity + light validation for a template registry: keys are present\n * and unique. Returns the same array (typed) so call sites keep inference.\n */\nexport function defineActions<T extends ActionTemplate<any>[]>(templates: [...T]): [...T] {\n  const seen = new Set<string>();\n  for (const t of templates) {\n    if (!t.key) throw new Error(\"ActionTemplate.key is required\");\n    if (seen.has(t.key)) throw new Error(`Duplicate ActionTemplate key: ${t.key}`);\n    seen.add(t.key);\n  }\n  return templates;\n}\n\nexport interface VoteValues {\n  contract: string;\n  proposalId: string;\n  choice: string; // felt: \"0x1\" yes / \"0x0\" no / \"0x2\" abstain\n}\n\nconst VOTE_CHOICES = [\n  { label: \"Yes\", value: \"0x1\" },\n  { label: \"No\", value: \"0x0\" },\n  { label: \"Abstain\", value: \"0x2\" },\n];\n\n/**\n * Built-in `Vote` template — `vote(proposalId, choice)` on a governance\n * contract. Pin the contract and/or entrypoint up front (then they drop\n * out of the form), or leave them for the proposer to fill.\n */\nexport function voteTemplate(opts?: {\n  governanceContract?: string;\n  entrypoint?: string;\n}): ActionTemplate<VoteValues> {\n  const fields: FieldSpec[] = [];\n  if (!opts?.governanceContract) {\n    fields.push({ name: \"contract\", label: \"Governance contract\", type: \"address\" });\n  }\n  fields.push(\n    { name: \"proposalId\", label: \"Proposal ID\", type: \"felt\" },\n    { name: \"choice\", label: \"Your vote\", type: \"select\", options: VOTE_CHOICES }\n  );\n  const labelFor = (v: string) => VOTE_CHOICES.find((c) => c.value === v)?.label ?? v;\n  return {\n    key: \"vote\",\n    label: \"Vote\",\n    description: \"Vote on a governance proposal.\",\n    fields,\n    toCalls: (v) => [\n      {\n        to: opts?.governanceContract ?? v.contract,\n        entrypoint: opts?.entrypoint ?? \"vote\",\n        calldata: [toFelt(v.proposalId), toFelt(v.choice)],\n      },\n    ],\n    title: (v) => `Vote ${labelFor(v.choice)} on Proposal #${v.proposalId}`,\n  };\n}\n","/**\n * Signer- and transport-agnostic OutsideExecution core for SHHH multisig\n * governance. Build an OE over an arbitrary call list, sign it per-owner\n * (the key never leaves the caller — passkey/MetaMask/Phantom/STARK), and\n * once enough approvals are collected, rebuild the exact OE and wrap the\n * inner envelopes in a V2_THRESHOLD envelope for execution.\n *\n * Deterministic rebuild is the load-bearing property: caller = ANY_CALLER,\n * and the persisted nonce + executeAfter + executeBefore mean the executor\n * reconstructs the identical OE hash the owners signed. executeAfter is\n * pinned to ~now (not 0) so the validity window stays within the contract\n * cap (audit M-2) — so it MUST be persisted, not assumed constant.\n */\nimport {\n  ANY_CALLER_FELT,\n  MAX_OE_VALIDITY_WINDOW_SECONDS,\n  buildOutsideExecution,\n  buildThresholdEnvelope,\n  computeOeHash,\n  serializeExecuteFromOutsideV2Calldata,\n} from \"@chipi-stack/backend\";\nimport type { CallSpec } from \"./action-template\";\n\n/** shortString.encodeShortString(\"SN_MAIN\") — Starknet mainnet. */\nexport const SN_MAIN_CHAIN_ID = \"0x534e5f4d41494e\";\n\n/**\n * Max on-chain OE validity window (`executeBefore - executeAfter`), capped\n * by the SHHH contract audit (M-2). This is the longest a proposal stays\n * EXECUTABLE — distinct from how long its record lives in the coordination\n * backend. NOTE: with `executeAfter` pinned to 0 the window would be the\n * whole epoch and the contract rejects it, so `executeAfter` is set to ~now\n * and persisted alongside the nonce + `executeBefore`.\n */\nexport const OE_WINDOW_SECONDS = Number(MAX_OE_VALIDITY_WINDOW_SECONDS);\n/** Small clock-skew cushion so the OE is valid by the next block. */\nconst OE_AFTER_SKEW_SECONDS = 60;\n\n/**\n * Signs an OE message hash for one owner → that owner's inner V2_SNIP12\n * envelope (an array of felts). Implementations wrap a passkey / MetaMask /\n * Phantom / STARK signer; the private key never leaves the implementation.\n */\nexport type OeSigner = (params: {\n  messageHash: bigint;\n  ownerIndex: bigint;\n}) => Promise<bigint[]> | bigint[];\n\ninterface OeCall {\n  contractAddress: string;\n  entrypoint: string;\n  calldata: string[];\n}\n\nfunction toOeCalls(calls: CallSpec[]): OeCall[] {\n  return calls.map((c) => ({\n    contractAddress: c.to,\n    entrypoint: c.entrypoint,\n    calldata: c.calldata,\n  }));\n}\n\n/** Serialize an inner envelope (felt[]) to the comma-joined 0x-hex string\n *  the coordination backend stores per signature. */\nexport function serializeEnvelope(env: bigint[]): string {\n  return env.map((f) => \"0x\" + f.toString(16)).join(\",\");\n}\n\nexport function deserializeEnvelope(s: string): bigint[] {\n  return s\n    .split(\",\")\n    .filter(Boolean)\n    .map((f) => BigInt(f));\n}\n\n/**\n * OE replay nonce: ms timestamp shifted left 24 bits, ORed with a 24-bit\n * random suffix. `nowMs`/`rand` are injectable for deterministic tests.\n */\nexport function newOeNonce(nowMs: number, rand: number): bigint {\n  return (BigInt(nowMs) << 24n) | BigInt(Math.floor(rand * 0xffffff));\n}\n\nexport interface ActionProposal {\n  oeMessageHash: string;\n  oeNonce: string;\n  oeExecuteBefore: string;\n  /** The proposer's inner V2_SNIP12 envelope, comma-joined 0x-hex. */\n  proposerSignature: string;\n}\n\n/** Derive the OE's executeAfter from its persisted executeBefore. The\n *  window is a fixed constant (the contract cap), so the executor needs\n *  only executeBefore to reconstruct the exact signed OE — no separate\n *  executeAfter persistence (and no backend column). */\nexport function deriveExecuteAfter(oeExecuteBefore: string): bigint {\n  return BigInt(oeExecuteBefore) - BigInt(OE_WINDOW_SECONDS);\n}\n\n/**\n * Build an OE over `calls`, sign it as the proposer (owner 0 by default),\n * and return everything a propose endpoint needs. The OE params (nonce +\n * executeBefore) are returned; executeAfter is `executeBefore - OE_WINDOW`,\n * so only executeBefore needs persisting. The window is the contract cap\n * (the longest executable window M-2 allows).\n */\nexport async function buildActionProposal(params: {\n  walletAddress: string;\n  calls: CallSpec[];\n  sign: OeSigner;\n  ownerIndex?: bigint;\n  chainId?: string;\n  nowMs?: number;\n  rand?: number;\n}): Promise<ActionProposal> {\n  const nowMs = params.nowMs ?? Date.now();\n  const nonce = newOeNonce(nowMs, params.rand ?? Math.random());\n  // executeAfter ~now (minus skew); the window = executeBefore - executeAfter\n  // is the fixed contract cap, so executeAfter can't be 0 (which would make\n  // the window the whole epoch and the contract reject it). Deriving it from\n  // executeBefore at execute time means we persist only executeBefore.\n  const executeAfter = BigInt(Math.floor(nowMs / 1000) - OE_AFTER_SKEW_SECONDS);\n  const executeBefore = executeAfter + BigInt(OE_WINDOW_SECONDS);\n  const oe = buildOutsideExecution({\n    nonce,\n    calls: toOeCalls(params.calls),\n    caller: ANY_CALLER_FELT,\n    executeAfter,\n    executeBefore,\n  });\n  const messageHash = computeOeHash(oe, params.walletAddress, params.chainId ?? SN_MAIN_CHAIN_ID);\n  const inner = await params.sign({\n    messageHash,\n    ownerIndex: params.ownerIndex ?? 0n,\n  });\n  return {\n    oeMessageHash: \"0x\" + messageHash.toString(16),\n    oeNonce: \"0x\" + nonce.toString(16),\n    oeExecuteBefore: executeBefore.toString(),\n    proposerSignature: serializeEnvelope(inner),\n  };\n}\n\n/** Sign an existing proposal's OE hash as an approver → inner envelope string. */\nexport async function signActionApproval(params: {\n  oeMessageHash: string;\n  ownerIndex: bigint;\n  sign: OeSigner;\n}): Promise<string> {\n  const inner = await params.sign({\n    messageHash: BigInt(params.oeMessageHash),\n    ownerIndex: params.ownerIndex,\n  });\n  return serializeEnvelope(inner);\n}\n\n/**\n * Rebuild the exact OE from the persisted params + collected signatures and\n * serialize the `execute` calldata. A 1-of-N wallet uses the single inner\n * envelope; N≥2 wraps the inner envelopes in a V2_THRESHOLD envelope.\n */\nexport function assembleActionExecuteCalldata(params: {\n  calls: CallSpec[];\n  oeNonce: string;\n  oeExecuteBefore: string;\n  signatures: string[];\n  requiredApprovals: number;\n}): string[] {\n  const oe = buildOutsideExecution({\n    nonce: BigInt(params.oeNonce),\n    calls: toOeCalls(params.calls),\n    caller: ANY_CALLER_FELT,\n    executeAfter: deriveExecuteAfter(params.oeExecuteBefore),\n    executeBefore: BigInt(params.oeExecuteBefore),\n  });\n  const inner = params.signatures.map(deserializeEnvelope);\n  if (inner.length < Math.max(1, params.requiredApprovals)) {\n    throw new Error(\n      `Not enough signatures: have ${inner.length}, need ${params.requiredApprovals}.`\n    );\n  }\n  const signature =\n    params.requiredApprovals <= 1 ? inner[0] : buildThresholdEnvelope({ innerEnvelopes: inner });\n  return serializeExecuteFromOutsideV2Calldata({\n    outsideExecution: oe,\n    signature,\n  });\n}\n","/**\n * Pure orchestration for the multisig governance flow — build a propose\n * body, build an approval, assemble execute calldata. No React, no network:\n * the hooks (`use-hooks.ts`) wrap these in mutations/queries, and they're\n * directly unit-testable with a mock signer + injected `nowMs`/`rand`.\n */\nimport type { ActionTemplate } from \"./action-template\";\nimport { buildActionProposal, signActionApproval, assembleActionExecuteCalldata } from \"./oe\";\nimport type { MultisigSigner, ProposeBody, ProposalSignature, TreasuryProposal } from \"./types\";\n\n/**\n * Build a propose body for a template + its validated field values: derive\n * the call(s) + title (+ meta), build & proposer-sign the OE, and shape the\n * body the coordination backend expects. For an action the payment fields\n * are placeholders (recipient/token = the first call's target, amount \"0\");\n * the real intent rides in `calls` + `title`.\n */\nexport async function createProposal<V>(params: {\n  template: ActionTemplate<V>;\n  values: V;\n  walletAddress: string;\n  requiredApprovals: number;\n  signer: MultisigSigner;\n  chainId?: string;\n  nowMs?: number;\n  rand?: number;\n}): Promise<ProposeBody> {\n  const calls = params.template.toCalls(params.values);\n  if (calls.length === 0) {\n    throw new Error(\"Template produced no calls\");\n  }\n  const title = params.template.title(params.values);\n  const meta = params.template.meta?.(params.values);\n  const proposerOwnerId = params.signer.proposerOwnerIndex ?? 0;\n\n  const proposal = await buildActionProposal({\n    walletAddress: params.walletAddress,\n    calls,\n    sign: params.signer.sign,\n    ownerIndex: BigInt(proposerOwnerId),\n    chainId: params.chainId,\n    nowMs: params.nowMs,\n    rand: params.rand,\n  });\n\n  return {\n    proposerOwnerId,\n    recipient: calls[0].to,\n    tokenAddress: calls[0].to,\n    amount: \"0\",\n    title,\n    calls,\n    ...(meta ? { meta } : {}),\n    oeMessageHash: proposal.oeMessageHash,\n    oeNonce: proposal.oeNonce,\n    oeExecuteBefore: proposal.oeExecuteBefore,\n    requiredApprovals: params.requiredApprovals,\n    proposerSignature: proposal.proposerSignature,\n    proposerSignerKind: params.signer.signerKind,\n  };\n}\n\n/**\n * Build an approver's signature on an existing proposal: resolve this\n * device's owner index from chain, then sign the SAME OE hash.\n */\nexport async function buildApproval(params: {\n  proposal: Pick<TreasuryProposal, \"oeMessageHash\">;\n  walletAddress: string;\n  signer: MultisigSigner;\n}): Promise<{ ownerId: number; signature: string; signerKind: string }> {\n  const ownerId = await params.signer.resolveOwnerIndex(params.walletAddress);\n  const signature = await signActionApproval({\n    oeMessageHash: params.proposal.oeMessageHash,\n    ownerIndex: BigInt(ownerId),\n    sign: params.signer.sign,\n  });\n  return { ownerId, signature, signerKind: params.signer.signerKind };\n}\n\n/**\n * Assemble the execute calldata from a proposal's persisted call(s) + its\n * collected signatures (sorted by owner index). Requires `calls` — this is\n * the generalized-action flow; a host with payment-only proposals supplies\n * the transfer calls.\n */\nexport function buildExecuteCalldata(proposal: TreasuryProposal): string[] {\n  if (!proposal.calls || proposal.calls.length === 0) {\n    throw new Error(\"Proposal has no calls to execute\");\n  }\n  if (!proposal.oeNonce || !proposal.oeExecuteBefore) {\n    throw new Error(\"Proposal is missing OE params (nonce / executeBefore)\");\n  }\n  const signatures = [...proposal.signatures]\n    .sort((a: ProposalSignature, b: ProposalSignature) => a.ownerId - b.ownerId)\n    .map((s) => s.signature);\n  return assembleActionExecuteCalldata({\n    calls: proposal.calls,\n    oeNonce: proposal.oeNonce,\n    oeExecuteBefore: proposal.oeExecuteBefore,\n    signatures,\n    requiredApprovals: proposal.requiredApprovals,\n  });\n}\n","/**\n * React hooks for the multisig governance flow — the reusable orchestration\n * the dashboard (and integrators) build their UI on. They wrap the pure\n * functions in `proposals.ts` with @tanstack/react-query, parameterized by\n * an injectable {@link MultisigTransport} (authed coordination backend) and\n * {@link MultisigSigner} (per-owner OE signer). The host owns the UI.\n */\nimport { useMutation, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type { ActionTemplate } from \"./action-template\";\nimport { createProposal, buildApproval, buildExecuteCalldata } from \"./proposals\";\nimport type { MultisigSigner, MultisigTransport, TreasuryProposal } from \"./types\";\n\nconst proposalsKey = (walletAddress: string) => [\"chipi-multisig-proposals\", walletAddress];\n\nexport interface ProposeInput {\n  template: ActionTemplate<any>;\n  values: any;\n}\n\n/**\n * Propose a templated action: build the call(s) + title from the template,\n * passkey-/key-sign the OE as the proposer, and submit it. `getRequiredApprovals`\n * supplies the wallet's threshold (the host reads it from chain — the package\n * stays chain-agnostic).\n */\nexport function useProposeAction(config: {\n  walletAddress: string;\n  transport: MultisigTransport;\n  signer: MultisigSigner;\n  getRequiredApprovals: () => Promise<number>;\n  chainId?: string;\n}) {\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: ProposeInput) => {\n      const requiredApprovals = await config.getRequiredApprovals();\n      const body = await createProposal({\n        template: input.template,\n        values: input.values,\n        walletAddress: config.walletAddress,\n        requiredApprovals,\n        signer: config.signer,\n        chainId: config.chainId,\n      });\n      return config.transport.propose(body);\n    },\n    onSuccess: () =>\n      qc.invalidateQueries({\n        queryKey: proposalsKey(config.walletAddress),\n      }),\n  });\n}\n\n/**\n * List a treasury's proposals and expose approve / execute mutations. An\n * approver signs the same OE hash as their resolved owner index; once enough\n * approvals are collected, execute rebuilds the OE from the persisted call(s)\n * and relays it.\n */\nexport function useTreasuryProposals(config: {\n  walletAddress: string;\n  transport: MultisigTransport;\n  signer: MultisigSigner;\n}) {\n  const qc = useQueryClient();\n  const invalidate = () => qc.invalidateQueries({ queryKey: proposalsKey(config.walletAddress) });\n\n  const proposals = useQuery({\n    queryKey: proposalsKey(config.walletAddress),\n    staleTime: 30 * 1000,\n    queryFn: () => config.transport.list(),\n  });\n\n  const approve = useMutation({\n    mutationFn: async (proposal: TreasuryProposal) => {\n      const body = await buildApproval({\n        proposal,\n        walletAddress: config.walletAddress,\n        signer: config.signer,\n      });\n      return config.transport.sign(proposal.id, body);\n    },\n    onSuccess: invalidate,\n  });\n\n  const execute = useMutation({\n    mutationFn: (proposal: TreasuryProposal) =>\n      config.transport.execute(proposal.id, buildExecuteCalldata(proposal)),\n    onSuccess: invalidate,\n  });\n\n  return { proposals, approve, execute };\n}\n"]}

package/dist/multisig.mjs

@@ -0,0 +1,257 @@
+import { MAX_OE_VALIDITY_WINDOW_SECONDS, buildOutsideExecution, ANY_CALLER_FELT, computeOeHash, buildThresholdEnvelope, serializeExecuteFromOutsideV2Calldata } from '@chipi-stack/backend';
+import { useQueryClient, useMutation, useQuery } from '@tanstack/react-query';
+
+// src/multisig/action-template.ts
+var FELT_PRIME = BigInt(
+  "0x800000000000011000000000000000000000000000000000000000000000001"
+);
+var U128_MASK = (1n << 128n) - 1n;
+function toFelt(v) {
+  let n;
+  try {
+    n = BigInt(typeof v === "string" ? v.trim() : v);
+  } catch {
+    throw new Error(`Not a felt: ${String(v)}`);
+  }
+  if (n < 0n || n >= FELT_PRIME) {
+    throw new Error(`Felt out of range: ${String(v)}`);
+  }
+  return "0x" + n.toString(16);
+}
+function u256(v) {
+  const n = BigInt(typeof v === "string" ? v.trim() : v);
+  if (n < 0n) throw new Error("u256 must be non-negative");
+  return ["0x" + (n & U128_MASK).toString(16), "0x" + (n >> 128n).toString(16)];
+}
+function amountToBase(amount, decimals) {
+  const t = amount.trim();
+  if (!/^\d+(\.\d+)?$/.test(t)) throw new Error(`Invalid amount: ${amount}`);
+  const [whole, frac = ""] = t.split(".");
+  if (frac.length > decimals) {
+    throw new Error(`Too many decimal places (max ${decimals})`);
+  }
+  const padded = (frac + "0".repeat(decimals)).slice(0, decimals);
+  return BigInt(whole) * 10n ** BigInt(decimals) + BigInt(padded || "0");
+}
+function defineActions(templates) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const t of templates) {
+    if (!t.key) throw new Error("ActionTemplate.key is required");
+    if (seen.has(t.key)) throw new Error(`Duplicate ActionTemplate key: ${t.key}`);
+    seen.add(t.key);
+  }
+  return templates;
+}
+var VOTE_CHOICES = [
+  { label: "Yes", value: "0x1" },
+  { label: "No", value: "0x0" },
+  { label: "Abstain", value: "0x2" }
+];
+function voteTemplate(opts) {
+  const fields = [];
+  if (!opts?.governanceContract) {
+    fields.push({ name: "contract", label: "Governance contract", type: "address" });
+  }
+  fields.push(
+    { name: "proposalId", label: "Proposal ID", type: "felt" },
+    { name: "choice", label: "Your vote", type: "select", options: VOTE_CHOICES }
+  );
+  const labelFor = (v) => VOTE_CHOICES.find((c) => c.value === v)?.label ?? v;
+  return {
+    key: "vote",
+    label: "Vote",
+    description: "Vote on a governance proposal.",
+    fields,
+    toCalls: (v) => [
+      {
+        to: opts?.governanceContract ?? v.contract,
+        entrypoint: opts?.entrypoint ?? "vote",
+        calldata: [toFelt(v.proposalId), toFelt(v.choice)]
+      }
+    ],
+    title: (v) => `Vote ${labelFor(v.choice)} on Proposal #${v.proposalId}`
+  };
+}
+var SN_MAIN_CHAIN_ID = "0x534e5f4d41494e";
+var OE_WINDOW_SECONDS = Number(MAX_OE_VALIDITY_WINDOW_SECONDS);
+var OE_AFTER_SKEW_SECONDS = 60;
+function toOeCalls(calls) {
+  return calls.map((c) => ({
+    contractAddress: c.to,
+    entrypoint: c.entrypoint,
+    calldata: c.calldata
+  }));
+}
+function serializeEnvelope(env) {
+  return env.map((f) => "0x" + f.toString(16)).join(",");
+}
+function deserializeEnvelope(s) {
+  return s.split(",").filter(Boolean).map((f) => BigInt(f));
+}
+function newOeNonce(nowMs, rand) {
+  return BigInt(nowMs) << 24n | BigInt(Math.floor(rand * 16777215));
+}
+function deriveExecuteAfter(oeExecuteBefore) {
+  return BigInt(oeExecuteBefore) - BigInt(OE_WINDOW_SECONDS);
+}
+async function buildActionProposal(params) {
+  const nowMs = params.nowMs ?? Date.now();
+  const nonce = newOeNonce(nowMs, params.rand ?? Math.random());
+  const executeAfter = BigInt(Math.floor(nowMs / 1e3) - OE_AFTER_SKEW_SECONDS);
+  const executeBefore = executeAfter + BigInt(OE_WINDOW_SECONDS);
+  const oe = buildOutsideExecution({
+    nonce,
+    calls: toOeCalls(params.calls),
+    caller: ANY_CALLER_FELT,
+    executeAfter,
+    executeBefore
+  });
+  const messageHash = computeOeHash(oe, params.walletAddress, params.chainId ?? SN_MAIN_CHAIN_ID);
+  const inner = await params.sign({
+    messageHash,
+    ownerIndex: params.ownerIndex ?? 0n
+  });
+  return {
+    oeMessageHash: "0x" + messageHash.toString(16),
+    oeNonce: "0x" + nonce.toString(16),
+    oeExecuteBefore: executeBefore.toString(),
+    proposerSignature: serializeEnvelope(inner)
+  };
+}
+async function signActionApproval(params) {
+  const inner = await params.sign({
+    messageHash: BigInt(params.oeMessageHash),
+    ownerIndex: params.ownerIndex
+  });
+  return serializeEnvelope(inner);
+}
+function assembleActionExecuteCalldata(params) {
+  const oe = buildOutsideExecution({
+    nonce: BigInt(params.oeNonce),
+    calls: toOeCalls(params.calls),
+    caller: ANY_CALLER_FELT,
+    executeAfter: deriveExecuteAfter(params.oeExecuteBefore),
+    executeBefore: BigInt(params.oeExecuteBefore)
+  });
+  const inner = params.signatures.map(deserializeEnvelope);
+  if (inner.length < Math.max(1, params.requiredApprovals)) {
+    throw new Error(
+      `Not enough signatures: have ${inner.length}, need ${params.requiredApprovals}.`
+    );
+  }
+  const signature = params.requiredApprovals <= 1 ? inner[0] : buildThresholdEnvelope({ innerEnvelopes: inner });
+  return serializeExecuteFromOutsideV2Calldata({
+    outsideExecution: oe,
+    signature
+  });
+}
+
+// src/multisig/proposals.ts
+async function createProposal(params) {
+  const calls = params.template.toCalls(params.values);
+  if (calls.length === 0) {
+    throw new Error("Template produced no calls");
+  }
+  const title = params.template.title(params.values);
+  const meta = params.template.meta?.(params.values);
+  const proposerOwnerId = params.signer.proposerOwnerIndex ?? 0;
+  const proposal = await buildActionProposal({
+    walletAddress: params.walletAddress,
+    calls,
+    sign: params.signer.sign,
+    ownerIndex: BigInt(proposerOwnerId),
+    chainId: params.chainId,
+    nowMs: params.nowMs,
+    rand: params.rand
+  });
+  return {
+    proposerOwnerId,
+    recipient: calls[0].to,
+    tokenAddress: calls[0].to,
+    amount: "0",
+    title,
+    calls,
+    ...meta ? { meta } : {},
+    oeMessageHash: proposal.oeMessageHash,
+    oeNonce: proposal.oeNonce,
+    oeExecuteBefore: proposal.oeExecuteBefore,
+    requiredApprovals: params.requiredApprovals,
+    proposerSignature: proposal.proposerSignature,
+    proposerSignerKind: params.signer.signerKind
+  };
+}
+async function buildApproval(params) {
+  const ownerId = await params.signer.resolveOwnerIndex(params.walletAddress);
+  const signature = await signActionApproval({
+    oeMessageHash: params.proposal.oeMessageHash,
+    ownerIndex: BigInt(ownerId),
+    sign: params.signer.sign
+  });
+  return { ownerId, signature, signerKind: params.signer.signerKind };
+}
+function buildExecuteCalldata(proposal) {
+  if (!proposal.calls || proposal.calls.length === 0) {
+    throw new Error("Proposal has no calls to execute");
+  }
+  if (!proposal.oeNonce || !proposal.oeExecuteBefore) {
+    throw new Error("Proposal is missing OE params (nonce / executeBefore)");
+  }
+  const signatures = [...proposal.signatures].sort((a, b) => a.ownerId - b.ownerId).map((s) => s.signature);
+  return assembleActionExecuteCalldata({
+    calls: proposal.calls,
+    oeNonce: proposal.oeNonce,
+    oeExecuteBefore: proposal.oeExecuteBefore,
+    signatures,
+    requiredApprovals: proposal.requiredApprovals
+  });
+}
+var proposalsKey = (walletAddress) => ["chipi-multisig-proposals", walletAddress];
+function useProposeAction(config) {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: async (input) => {
+      const requiredApprovals = await config.getRequiredApprovals();
+      const body = await createProposal({
+        template: input.template,
+        values: input.values,
+        walletAddress: config.walletAddress,
+        requiredApprovals,
+        signer: config.signer,
+        chainId: config.chainId
+      });
+      return config.transport.propose(body);
+    },
+    onSuccess: () => qc.invalidateQueries({
+      queryKey: proposalsKey(config.walletAddress)
+    })
+  });
+}
+function useTreasuryProposals(config) {
+  const qc = useQueryClient();
+  const invalidate = () => qc.invalidateQueries({ queryKey: proposalsKey(config.walletAddress) });
+  const proposals = useQuery({
+    queryKey: proposalsKey(config.walletAddress),
+    staleTime: 30 * 1e3,
+    queryFn: () => config.transport.list()
+  });
+  const approve = useMutation({
+    mutationFn: async (proposal) => {
+      const body = await buildApproval({
+        proposal,
+        walletAddress: config.walletAddress,
+        signer: config.signer
+      });
+      return config.transport.sign(proposal.id, body);
+    },
+    onSuccess: invalidate
+  });
+  const execute = useMutation({
+    mutationFn: (proposal) => config.transport.execute(proposal.id, buildExecuteCalldata(proposal)),
+    onSuccess: invalidate
+  });
+  return { proposals, approve, execute };
+}
+
+export { FELT_PRIME, OE_WINDOW_SECONDS, SN_MAIN_CHAIN_ID, amountToBase, assembleActionExecuteCalldata, buildActionProposal, buildApproval, buildExecuteCalldata, createProposal, defineActions, deriveExecuteAfter, deserializeEnvelope, newOeNonce, serializeEnvelope, signActionApproval, toFelt, u256, useProposeAction, useTreasuryProposals, voteTemplate };
+//# sourceMappingURL=multisig.mjs.map
+//# sourceMappingURL=multisig.mjs.map

package/dist/multisig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/multisig/action-template.ts","../src/multisig/oe.ts","../src/multisig/proposals.ts","../src/multisig/use-hooks.ts"],"names":[],"mappings":"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","file":"multisig.mjs","sourcesContent":["/**\n * Framework-agnostic action-template engine for SHHH multisig governance.\n *\n * An {@link ActionTemplate} maps friendly, typed form fields → an\n * OutsideExecution call list + a human-readable title. It's the seam that\n * turns \"call any contract\" (powerful, scary) into \"fill in this form\"\n * (founder-grade) — and the whitelabel seam: every integrator registers\n * its own templates (Roca: create_pool / borrow / repay), while `Vote`\n * ships built-in. The raw-call escape hatch lives in the UI layer, not\n * here, because its arguments are open-ended.\n *\n * Pure: no React, no network — so the same template renders the proposer's\n * form, every approver's inbox, and the notification, from one source of\n * truth, and `toCalls` is deterministic (proposer and executor build the\n * identical OE → the hash matches).\n */\n\nexport type FeltLike = string | number | bigint;\n\n/** One call in an action — the shape the OE builder consumes. */\nexport interface CallSpec {\n  to: string;\n  entrypoint: string;\n  /** Flat 0x-hex felts. */\n  calldata: string[];\n}\n\n/** A typed input in an action template. */\nexport type FieldSpec =\n  | { name: string; label: string; type: \"amount\"; decimals: number; help?: string }\n  | { name: string; label: string; type: \"address\"; help?: string }\n  | { name: string; label: string; type: \"number\" | \"bps\" | \"days\" | \"felt\"; help?: string }\n  | {\n      name: string;\n      label: string;\n      type: \"select\";\n      options: { label: string; value: string }[];\n      help?: string;\n    }\n  | { name: string; label: string; type: \"text\"; help?: string };\n\nexport interface ActionTemplate<V = Record<string, unknown>> {\n  /** Stable id, persisted on the proposal. */\n  key: string;\n  /** Display label (\"Create pool\"). */\n  label: string;\n  description?: string;\n  /** Typed inputs rendered by `<ProposeAction>`. */\n  fields: FieldSpec[];\n  /** Pure: validated field values → the OE call list. */\n  toCalls: (v: V) => CallSpec[];\n  /** Pure: the plain-language title shown in the preview, inbox, and email. */\n  title: (v: V) => string;\n  /** Optional metadata persisted with the proposal so the approver's app\n   *  can render business context (e.g. `{ poolId }`). */\n  meta?: (v: V) => Record<string, string | number>;\n}\n\n/** Starknet felt252 field prime — args must be a non-negative felt below it. */\nexport const FELT_PRIME = BigInt(\n  \"0x800000000000011000000000000000000000000000000000000000000000001\"\n);\n\nconst U128_MASK = (1n << 128n) - 1n;\n\n/** Parse a decimal or 0x-hex value to a canonical `0x` felt. Throws on a\n *  non-numeric or out-of-range value. */\nexport function toFelt(v: FeltLike): string {\n  let n: bigint;\n  try {\n    n = BigInt(typeof v === \"string\" ? v.trim() : v);\n  } catch {\n    throw new Error(`Not a felt: ${String(v)}`);\n  }\n  if (n < 0n || n >= FELT_PRIME) {\n    throw new Error(`Felt out of range: ${String(v)}`);\n  }\n  return \"0x\" + n.toString(16);\n}\n\n/** Split a u256 value into its `[low, high]` felts (Cairo calling convention). */\nexport function u256(v: FeltLike): [string, string] {\n  const n = BigInt(typeof v === \"string\" ? v.trim() : v);\n  if (n < 0n) throw new Error(\"u256 must be non-negative\");\n  return [\"0x\" + (n & U128_MASK).toString(16), \"0x\" + (n >> 128n).toString(16)];\n}\n\n/** Convert a human amount (\"10.5\") to base units given a token's decimals. */\nexport function amountToBase(amount: string, decimals: number): bigint {\n  const t = amount.trim();\n  if (!/^\\d+(\\.\\d+)?$/.test(t)) throw new Error(`Invalid amount: ${amount}`);\n  const [whole, frac = \"\"] = t.split(\".\");\n  if (frac.length > decimals) {\n    throw new Error(`Too many decimal places (max ${decimals})`);\n  }\n  const padded = (frac + \"0\".repeat(decimals)).slice(0, decimals);\n  return BigInt(whole) * 10n ** BigInt(decimals) + BigInt(padded || \"0\");\n}\n\n/**\n * Identity + light validation for a template registry: keys are present\n * and unique. Returns the same array (typed) so call sites keep inference.\n */\nexport function defineActions<T extends ActionTemplate<any>[]>(templates: [...T]): [...T] {\n  const seen = new Set<string>();\n  for (const t of templates) {\n    if (!t.key) throw new Error(\"ActionTemplate.key is required\");\n    if (seen.has(t.key)) throw new Error(`Duplicate ActionTemplate key: ${t.key}`);\n    seen.add(t.key);\n  }\n  return templates;\n}\n\nexport interface VoteValues {\n  contract: string;\n  proposalId: string;\n  choice: string; // felt: \"0x1\" yes / \"0x0\" no / \"0x2\" abstain\n}\n\nconst VOTE_CHOICES = [\n  { label: \"Yes\", value: \"0x1\" },\n  { label: \"No\", value: \"0x0\" },\n  { label: \"Abstain\", value: \"0x2\" },\n];\n\n/**\n * Built-in `Vote` template — `vote(proposalId, choice)` on a governance\n * contract. Pin the contract and/or entrypoint up front (then they drop\n * out of the form), or leave them for the proposer to fill.\n */\nexport function voteTemplate(opts?: {\n  governanceContract?: string;\n  entrypoint?: string;\n}): ActionTemplate<VoteValues> {\n  const fields: FieldSpec[] = [];\n  if (!opts?.governanceContract) {\n    fields.push({ name: \"contract\", label: \"Governance contract\", type: \"address\" });\n  }\n  fields.push(\n    { name: \"proposalId\", label: \"Proposal ID\", type: \"felt\" },\n    { name: \"choice\", label: \"Your vote\", type: \"select\", options: VOTE_CHOICES }\n  );\n  const labelFor = (v: string) => VOTE_CHOICES.find((c) => c.value === v)?.label ?? v;\n  return {\n    key: \"vote\",\n    label: \"Vote\",\n    description: \"Vote on a governance proposal.\",\n    fields,\n    toCalls: (v) => [\n      {\n        to: opts?.governanceContract ?? v.contract,\n        entrypoint: opts?.entrypoint ?? \"vote\",\n        calldata: [toFelt(v.proposalId), toFelt(v.choice)],\n      },\n    ],\n    title: (v) => `Vote ${labelFor(v.choice)} on Proposal #${v.proposalId}`,\n  };\n}\n","/**\n * Signer- and transport-agnostic OutsideExecution core for SHHH multisig\n * governance. Build an OE over an arbitrary call list, sign it per-owner\n * (the key never leaves the caller — passkey/MetaMask/Phantom/STARK), and\n * once enough approvals are collected, rebuild the exact OE and wrap the\n * inner envelopes in a V2_THRESHOLD envelope for execution.\n *\n * Deterministic rebuild is the load-bearing property: caller = ANY_CALLER,\n * and the persisted nonce + executeAfter + executeBefore mean the executor\n * reconstructs the identical OE hash the owners signed. executeAfter is\n * pinned to ~now (not 0) so the validity window stays within the contract\n * cap (audit M-2) — so it MUST be persisted, not assumed constant.\n */\nimport {\n  ANY_CALLER_FELT,\n  MAX_OE_VALIDITY_WINDOW_SECONDS,\n  buildOutsideExecution,\n  buildThresholdEnvelope,\n  computeOeHash,\n  serializeExecuteFromOutsideV2Calldata,\n} from \"@chipi-stack/backend\";\nimport type { CallSpec } from \"./action-template\";\n\n/** shortString.encodeShortString(\"SN_MAIN\") — Starknet mainnet. */\nexport const SN_MAIN_CHAIN_ID = \"0x534e5f4d41494e\";\n\n/**\n * Max on-chain OE validity window (`executeBefore - executeAfter`), capped\n * by the SHHH contract audit (M-2). This is the longest a proposal stays\n * EXECUTABLE — distinct from how long its record lives in the coordination\n * backend. NOTE: with `executeAfter` pinned to 0 the window would be the\n * whole epoch and the contract rejects it, so `executeAfter` is set to ~now\n * and persisted alongside the nonce + `executeBefore`.\n */\nexport const OE_WINDOW_SECONDS = Number(MAX_OE_VALIDITY_WINDOW_SECONDS);\n/** Small clock-skew cushion so the OE is valid by the next block. */\nconst OE_AFTER_SKEW_SECONDS = 60;\n\n/**\n * Signs an OE message hash for one owner → that owner's inner V2_SNIP12\n * envelope (an array of felts). Implementations wrap a passkey / MetaMask /\n * Phantom / STARK signer; the private key never leaves the implementation.\n */\nexport type OeSigner = (params: {\n  messageHash: bigint;\n  ownerIndex: bigint;\n}) => Promise<bigint[]> | bigint[];\n\ninterface OeCall {\n  contractAddress: string;\n  entrypoint: string;\n  calldata: string[];\n}\n\nfunction toOeCalls(calls: CallSpec[]): OeCall[] {\n  return calls.map((c) => ({\n    contractAddress: c.to,\n    entrypoint: c.entrypoint,\n    calldata: c.calldata,\n  }));\n}\n\n/** Serialize an inner envelope (felt[]) to the comma-joined 0x-hex string\n *  the coordination backend stores per signature. */\nexport function serializeEnvelope(env: bigint[]): string {\n  return env.map((f) => \"0x\" + f.toString(16)).join(\",\");\n}\n\nexport function deserializeEnvelope(s: string): bigint[] {\n  return s\n    .split(\",\")\n    .filter(Boolean)\n    .map((f) => BigInt(f));\n}\n\n/**\n * OE replay nonce: ms timestamp shifted left 24 bits, ORed with a 24-bit\n * random suffix. `nowMs`/`rand` are injectable for deterministic tests.\n */\nexport function newOeNonce(nowMs: number, rand: number): bigint {\n  return (BigInt(nowMs) << 24n) | BigInt(Math.floor(rand * 0xffffff));\n}\n\nexport interface ActionProposal {\n  oeMessageHash: string;\n  oeNonce: string;\n  oeExecuteBefore: string;\n  /** The proposer's inner V2_SNIP12 envelope, comma-joined 0x-hex. */\n  proposerSignature: string;\n}\n\n/** Derive the OE's executeAfter from its persisted executeBefore. The\n *  window is a fixed constant (the contract cap), so the executor needs\n *  only executeBefore to reconstruct the exact signed OE — no separate\n *  executeAfter persistence (and no backend column). */\nexport function deriveExecuteAfter(oeExecuteBefore: string): bigint {\n  return BigInt(oeExecuteBefore) - BigInt(OE_WINDOW_SECONDS);\n}\n\n/**\n * Build an OE over `calls`, sign it as the proposer (owner 0 by default),\n * and return everything a propose endpoint needs. The OE params (nonce +\n * executeBefore) are returned; executeAfter is `executeBefore - OE_WINDOW`,\n * so only executeBefore needs persisting. The window is the contract cap\n * (the longest executable window M-2 allows).\n */\nexport async function buildActionProposal(params: {\n  walletAddress: string;\n  calls: CallSpec[];\n  sign: OeSigner;\n  ownerIndex?: bigint;\n  chainId?: string;\n  nowMs?: number;\n  rand?: number;\n}): Promise<ActionProposal> {\n  const nowMs = params.nowMs ?? Date.now();\n  const nonce = newOeNonce(nowMs, params.rand ?? Math.random());\n  // executeAfter ~now (minus skew); the window = executeBefore - executeAfter\n  // is the fixed contract cap, so executeAfter can't be 0 (which would make\n  // the window the whole epoch and the contract reject it). Deriving it from\n  // executeBefore at execute time means we persist only executeBefore.\n  const executeAfter = BigInt(Math.floor(nowMs / 1000) - OE_AFTER_SKEW_SECONDS);\n  const executeBefore = executeAfter + BigInt(OE_WINDOW_SECONDS);\n  const oe = buildOutsideExecution({\n    nonce,\n    calls: toOeCalls(params.calls),\n    caller: ANY_CALLER_FELT,\n    executeAfter,\n    executeBefore,\n  });\n  const messageHash = computeOeHash(oe, params.walletAddress, params.chainId ?? SN_MAIN_CHAIN_ID);\n  const inner = await params.sign({\n    messageHash,\n    ownerIndex: params.ownerIndex ?? 0n,\n  });\n  return {\n    oeMessageHash: \"0x\" + messageHash.toString(16),\n    oeNonce: \"0x\" + nonce.toString(16),\n    oeExecuteBefore: executeBefore.toString(),\n    proposerSignature: serializeEnvelope(inner),\n  };\n}\n\n/** Sign an existing proposal's OE hash as an approver → inner envelope string. */\nexport async function signActionApproval(params: {\n  oeMessageHash: string;\n  ownerIndex: bigint;\n  sign: OeSigner;\n}): Promise<string> {\n  const inner = await params.sign({\n    messageHash: BigInt(params.oeMessageHash),\n    ownerIndex: params.ownerIndex,\n  });\n  return serializeEnvelope(inner);\n}\n\n/**\n * Rebuild the exact OE from the persisted params + collected signatures and\n * serialize the `execute` calldata. A 1-of-N wallet uses the single inner\n * envelope; N≥2 wraps the inner envelopes in a V2_THRESHOLD envelope.\n */\nexport function assembleActionExecuteCalldata(params: {\n  calls: CallSpec[];\n  oeNonce: string;\n  oeExecuteBefore: string;\n  signatures: string[];\n  requiredApprovals: number;\n}): string[] {\n  const oe = buildOutsideExecution({\n    nonce: BigInt(params.oeNonce),\n    calls: toOeCalls(params.calls),\n    caller: ANY_CALLER_FELT,\n    executeAfter: deriveExecuteAfter(params.oeExecuteBefore),\n    executeBefore: BigInt(params.oeExecuteBefore),\n  });\n  const inner = params.signatures.map(deserializeEnvelope);\n  if (inner.length < Math.max(1, params.requiredApprovals)) {\n    throw new Error(\n      `Not enough signatures: have ${inner.length}, need ${params.requiredApprovals}.`\n    );\n  }\n  const signature =\n    params.requiredApprovals <= 1 ? inner[0] : buildThresholdEnvelope({ innerEnvelopes: inner });\n  return serializeExecuteFromOutsideV2Calldata({\n    outsideExecution: oe,\n    signature,\n  });\n}\n","/**\n * Pure orchestration for the multisig governance flow — build a propose\n * body, build an approval, assemble execute calldata. No React, no network:\n * the hooks (`use-hooks.ts`) wrap these in mutations/queries, and they're\n * directly unit-testable with a mock signer + injected `nowMs`/`rand`.\n */\nimport type { ActionTemplate } from \"./action-template\";\nimport { buildActionProposal, signActionApproval, assembleActionExecuteCalldata } from \"./oe\";\nimport type { MultisigSigner, ProposeBody, ProposalSignature, TreasuryProposal } from \"./types\";\n\n/**\n * Build a propose body for a template + its validated field values: derive\n * the call(s) + title (+ meta), build & proposer-sign the OE, and shape the\n * body the coordination backend expects. For an action the payment fields\n * are placeholders (recipient/token = the first call's target, amount \"0\");\n * the real intent rides in `calls` + `title`.\n */\nexport async function createProposal<V>(params: {\n  template: ActionTemplate<V>;\n  values: V;\n  walletAddress: string;\n  requiredApprovals: number;\n  signer: MultisigSigner;\n  chainId?: string;\n  nowMs?: number;\n  rand?: number;\n}): Promise<ProposeBody> {\n  const calls = params.template.toCalls(params.values);\n  if (calls.length === 0) {\n    throw new Error(\"Template produced no calls\");\n  }\n  const title = params.template.title(params.values);\n  const meta = params.template.meta?.(params.values);\n  const proposerOwnerId = params.signer.proposerOwnerIndex ?? 0;\n\n  const proposal = await buildActionProposal({\n    walletAddress: params.walletAddress,\n    calls,\n    sign: params.signer.sign,\n    ownerIndex: BigInt(proposerOwnerId),\n    chainId: params.chainId,\n    nowMs: params.nowMs,\n    rand: params.rand,\n  });\n\n  return {\n    proposerOwnerId,\n    recipient: calls[0].to,\n    tokenAddress: calls[0].to,\n    amount: \"0\",\n    title,\n    calls,\n    ...(meta ? { meta } : {}),\n    oeMessageHash: proposal.oeMessageHash,\n    oeNonce: proposal.oeNonce,\n    oeExecuteBefore: proposal.oeExecuteBefore,\n    requiredApprovals: params.requiredApprovals,\n    proposerSignature: proposal.proposerSignature,\n    proposerSignerKind: params.signer.signerKind,\n  };\n}\n\n/**\n * Build an approver's signature on an existing proposal: resolve this\n * device's owner index from chain, then sign the SAME OE hash.\n */\nexport async function buildApproval(params: {\n  proposal: Pick<TreasuryProposal, \"oeMessageHash\">;\n  walletAddress: string;\n  signer: MultisigSigner;\n}): Promise<{ ownerId: number; signature: string; signerKind: string }> {\n  const ownerId = await params.signer.resolveOwnerIndex(params.walletAddress);\n  const signature = await signActionApproval({\n    oeMessageHash: params.proposal.oeMessageHash,\n    ownerIndex: BigInt(ownerId),\n    sign: params.signer.sign,\n  });\n  return { ownerId, signature, signerKind: params.signer.signerKind };\n}\n\n/**\n * Assemble the execute calldata from a proposal's persisted call(s) + its\n * collected signatures (sorted by owner index). Requires `calls` — this is\n * the generalized-action flow; a host with payment-only proposals supplies\n * the transfer calls.\n */\nexport function buildExecuteCalldata(proposal: TreasuryProposal): string[] {\n  if (!proposal.calls || proposal.calls.length === 0) {\n    throw new Error(\"Proposal has no calls to execute\");\n  }\n  if (!proposal.oeNonce || !proposal.oeExecuteBefore) {\n    throw new Error(\"Proposal is missing OE params (nonce / executeBefore)\");\n  }\n  const signatures = [...proposal.signatures]\n    .sort((a: ProposalSignature, b: ProposalSignature) => a.ownerId - b.ownerId)\n    .map((s) => s.signature);\n  return assembleActionExecuteCalldata({\n    calls: proposal.calls,\n    oeNonce: proposal.oeNonce,\n    oeExecuteBefore: proposal.oeExecuteBefore,\n    signatures,\n    requiredApprovals: proposal.requiredApprovals,\n  });\n}\n","/**\n * React hooks for the multisig governance flow — the reusable orchestration\n * the dashboard (and integrators) build their UI on. They wrap the pure\n * functions in `proposals.ts` with @tanstack/react-query, parameterized by\n * an injectable {@link MultisigTransport} (authed coordination backend) and\n * {@link MultisigSigner} (per-owner OE signer). The host owns the UI.\n */\nimport { useMutation, useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type { ActionTemplate } from \"./action-template\";\nimport { createProposal, buildApproval, buildExecuteCalldata } from \"./proposals\";\nimport type { MultisigSigner, MultisigTransport, TreasuryProposal } from \"./types\";\n\nconst proposalsKey = (walletAddress: string) => [\"chipi-multisig-proposals\", walletAddress];\n\nexport interface ProposeInput {\n  template: ActionTemplate<any>;\n  values: any;\n}\n\n/**\n * Propose a templated action: build the call(s) + title from the template,\n * passkey-/key-sign the OE as the proposer, and submit it. `getRequiredApprovals`\n * supplies the wallet's threshold (the host reads it from chain — the package\n * stays chain-agnostic).\n */\nexport function useProposeAction(config: {\n  walletAddress: string;\n  transport: MultisigTransport;\n  signer: MultisigSigner;\n  getRequiredApprovals: () => Promise<number>;\n  chainId?: string;\n}) {\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: ProposeInput) => {\n      const requiredApprovals = await config.getRequiredApprovals();\n      const body = await createProposal({\n        template: input.template,\n        values: input.values,\n        walletAddress: config.walletAddress,\n        requiredApprovals,\n        signer: config.signer,\n        chainId: config.chainId,\n      });\n      return config.transport.propose(body);\n    },\n    onSuccess: () =>\n      qc.invalidateQueries({\n        queryKey: proposalsKey(config.walletAddress),\n      }),\n  });\n}\n\n/**\n * List a treasury's proposals and expose approve / execute mutations. An\n * approver signs the same OE hash as their resolved owner index; once enough\n * approvals are collected, execute rebuilds the OE from the persisted call(s)\n * and relays it.\n */\nexport function useTreasuryProposals(config: {\n  walletAddress: string;\n  transport: MultisigTransport;\n  signer: MultisigSigner;\n}) {\n  const qc = useQueryClient();\n  const invalidate = () => qc.invalidateQueries({ queryKey: proposalsKey(config.walletAddress) });\n\n  const proposals = useQuery({\n    queryKey: proposalsKey(config.walletAddress),\n    staleTime: 30 * 1000,\n    queryFn: () => config.transport.list(),\n  });\n\n  const approve = useMutation({\n    mutationFn: async (proposal: TreasuryProposal) => {\n      const body = await buildApproval({\n        proposal,\n        walletAddress: config.walletAddress,\n        signer: config.signer,\n      });\n      return config.transport.sign(proposal.id, body);\n    },\n    onSuccess: invalidate,\n  });\n\n  const execute = useMutation({\n    mutationFn: (proposal: TreasuryProposal) =>\n      config.transport.execute(proposal.id, buildExecuteCalldata(proposal)),\n    onSuccess: invalidate,\n  });\n\n  return { proposals, approve, execute };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chipi-stack/chipi-react",
-  "version": "14.7.0",
+  "version": "14.8.0",
   "description": "React hooks and components for Chipi SDK",
   "keywords": [
     "chipi",
@@ -69,6 +69,16 @@
         "default": "./dist/components.js"
       }
     },
+    "./multisig": {
+      "import": {
+        "types": "./dist/multisig.d.mts",
+        "default": "./dist/multisig.mjs"
+      },
+      "require": {
+        "types": "./dist/multisig.d.ts",
+        "default": "./dist/multisig.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
@@ -92,11 +102,11 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.85.0",
-    "@chipi-stack/backend": "^14.7.0",
+    "@chipi-stack/backend": "^14.8.0",
     "@chipi-stack/chipi-passkey": "^2.2.0",
     "@chipi-stack/core": "^0.3.1",
-    "@chipi-stack/shared": "^14.7.0",
-    "@chipi-stack/types": "^14.7.0"
+    "@chipi-stack/shared": "^14.8.0",
+    "@chipi-stack/types": "^14.8.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",