opentool 0.19.0 → 0.19.2

package/dist/adapters/news/index.d.ts

@@ -6,6 +6,9 @@ type NewsPropositionStatus = NewsPropositionAnswer | "no_matching_event";
 type NewsContinuationAction = "continue" | "skip" | "pause";
 type NewsPredictionMarketMatchedMarket = {
     marketId: string;
+    eventId?: string | null;
+    eventSlug?: string | null;
+    eventTitle?: string | null;
     conditionId?: string | null;
     title: string;
     slug?: string | null;

package/dist/adapters/news/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/news/signals.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["const DEFAULT_OPENPOND_GATEWAY_URL = \"https://gateway.openpond.dev\";\n\nexport type NewsEventState =\n  | \"monitoring\"\n  | \"escalation\"\n  | \"de_escalation\"\n  | \"resolved\"\n  | \"contradiction\";\n\nexport type NewsSignalValue =\n  | \"none\"\n  | \"escalation\"\n  | \"de_escalation\"\n  | \"resolved\"\n  | \"contradiction\";\n\nexport type NewsPropositionAnswer = \"yes\" | \"no\" | \"unclear\";\nexport type NewsPropositionStatus = NewsPropositionAnswer | \"no_matching_event\";\nexport type NewsContinuationAction = \"continue\" | \"skip\" | \"pause\";\n\nexport type NewsPredictionMarketMatchedMarket = {\n  marketId: string;\n  conditionId?: string | null;\n  title: string;\n  slug?: string | null;\n  category?: string | null;\n  yesProbability?: number | null;\n  noProbability?: number | null;\n  leadingOutcome?: string | null;\n  leadingProbability?: number | null;\n  volume?: number | null;\n  liquidity?: number | null;\n  openInterest?: number | null;\n  probabilityDelta1h?: number | null;\n  probabilityDelta24h?: number | null;\n  fetchedAt: string;\n};\n\nexport type NewsPredictionMarketContext = {\n  matchedMarkets: NewsPredictionMarketMatchedMarket[];\n  consensusProbability?: number | null;\n  probabilityDelta1h?: number | null;\n  probabilityDelta24h?: number | null;\n  liquidityWeightedScore?: number | null;\n  predictionDisagreementScore?: number | null;\n  dataAgeMs?: number | null;\n} | null;\n\nexport type NewsSignalEvidence = {\n  articleId: string;\n  sourceId: string;\n  sourceName: string;\n  title: string;\n  canonicalUrl: string;\n  claimType: string;\n  claimPolarity: string;\n  evidenceConfidence: number;\n  evidenceAt: string;\n  summary?: string | null;\n  contentPreview?: string | null;\n};\n\nexport type NewsSignalConfidenceBreakdown = {\n  baseScore: number;\n  winningBucketScore: number;\n  opposingPenalty: number;\n  contradictionPenalty: number;\n  stateBonus: number;\n  finalScore: number;\n};\n\nexport type NewsEventSignalPolicy = {\n  minConfidence: number;\n  minIndependentSources: number;\n  minTierASources: number;\n  cooldownMinutes: number;\n  allowedSourceIds?: string[];\n};\n\nexport type NewsEventSignal = {\n  eventId: string;\n  eventKey: string;\n  title: string | null;\n  eventState: NewsEventState;\n  eventConfidence: number;\n  confidenceBreakdown: NewsSignalConfidenceBreakdown;\n  signal: NewsSignalValue;\n  triggerPassed: boolean;\n  policyRisk: \"low\" | \"medium\" | \"high\";\n  effectivePolicy: NewsEventSignalPolicy;\n  whyNotTriggered: string | null;\n  warnings: string[];\n  contradictionCount: number;\n  supportingSourceCount: number;\n  tierASourceCount: number;\n  rebuttingSourceSummary: Array<{\n    sourceId: string;\n    sourceName: string;\n    title: string;\n  }>;\n  evidence: NewsSignalEvidence[];\n  dataAgeMs: number | null;\n  predictionMarketContext: NewsPredictionMarketContext;\n};\n\nexport type NewsPropositionSignal = {\n  question: string;\n  query: string | null;\n  propositionType: string | null;\n  propositionStatus: NewsPropositionStatus;\n  answer: NewsPropositionAnswer;\n  propositionConfidence: number;\n  reasoning: string;\n  evidenceWindowSummary: string;\n  resolvedEventId: string | null;\n  resolvedEventKey: string | null;\n  resolvedEventTitle: string | null;\n  eventState: NewsEventState | null;\n  eventConfidence: number | null;\n  confidenceBreakdown: NewsSignalConfidenceBreakdown | null;\n  supportingEvidence: NewsSignalEvidence[];\n  rebuttingEvidence: NewsSignalEvidence[];\n  supportingEvidenceArticleIds: string[];\n  rebuttingEvidenceArticleIds: string[];\n  operatorReviewRecommended: boolean;\n  dataAgeMs: number | null;\n  predictionMarketContext: NewsPredictionMarketContext;\n};\n\nexport type NewsEventSignalRequest = {\n  gatewayBase?: string | null;\n  fetchImplementation?: typeof fetch;\n  query?: string;\n  eventKey?: string;\n  asOf?: string | Date | null;\n  includePredictionMarkets?: boolean;\n  ingestOnRequest?: boolean;\n  maxAgeHours?: number;\n  minConfidence?: number;\n  minIndependentSources?: number;\n  minTierASources?: number;\n};\n\nexport type NewsPropositionSignalRequest = {\n  gatewayBase?: string | null;\n  fetchImplementation?: typeof fetch;\n  question: string;\n  query?: string;\n  eventKey?: string;\n  propositionType?: string;\n  asOf?: string | Date | null;\n  includePredictionMarkets?: boolean;\n  ingestOnRequest?: boolean;\n  maxAgeHours?: number;\n  candidateLimit?: number;\n};\n\nexport type NewsSignalClientConfig = {\n  gatewayBase?: string | null;\n  fetchImplementation?: typeof fetch;\n};\n\nexport type NewsEventContinuationGate = {\n  mode: \"event\";\n  minConfidence?: number;\n  maxDataAgeMs?: number;\n  minIndependentSources?: number;\n  minTierASources?: number;\n  requireTriggerPassed?: boolean;\n  onBlocked?: Exclude<NewsContinuationAction, \"continue\">;\n};\n\nexport type NewsPropositionContinuationGate = {\n  mode: \"proposition\";\n  expectedAnswer?: NewsPropositionAnswer;\n  minConfidence?: number;\n  maxDataAgeMs?: number;\n  requireResolvedEvent?: boolean;\n  onBlocked?: Exclude<NewsContinuationAction, \"continue\">;\n};\n\nexport type NewsContinuationGate =\n  | NewsEventContinuationGate\n  | NewsPropositionContinuationGate;\n\nexport type NewsContinuationGateResult = {\n  allowed: boolean;\n  action: NewsContinuationAction;\n  reason: string;\n  matchedRule: NewsContinuationGate[\"mode\"];\n  blockingFactors: string[];\n};\n\nfunction resolveFetchImplementation(override?: typeof fetch): typeof fetch {\n  const fetchImplementation = override ?? globalThis.fetch;\n  if (!fetchImplementation) {\n    throw new Error(\n      \"No fetch implementation available. Provide one via NewsSignalClientConfig.fetchImplementation.\",\n    );\n  }\n  return fetchImplementation;\n}\n\nexport function resolveNewsGatewayBase(override?: string | null): string {\n  const value = override ?? process.env.OPENPOND_GATEWAY_URL ?? DEFAULT_OPENPOND_GATEWAY_URL;\n  if (typeof value !== \"string\") {\n    throw new Error(\"OPENPOND_GATEWAY_URL is required.\");\n  }\n  const trimmed = value.trim();\n  if (!trimmed) {\n    throw new Error(\"OPENPOND_GATEWAY_URL is required.\");\n  }\n  return trimmed.replace(/\\/$/, \"\");\n}\n\nfunction normalizeAsOf(value?: string | Date | null): string | undefined {\n  if (value == null) return undefined;\n  const date = value instanceof Date ? value : new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    throw new Error(\"asOf must be a valid ISO-8601 datetime or Date.\");\n  }\n  return date.toISOString();\n}\n\nasync function postGatewayJson<T>(params: {\n  path: string;\n  body: Record<string, unknown>;\n  gatewayBase?: string | null | undefined;\n  fetchImplementation?: typeof fetch | undefined;\n}): Promise<T> {\n  const gatewayBase = resolveNewsGatewayBase(params.gatewayBase);\n  const fetchImplementation = resolveFetchImplementation(params.fetchImplementation);\n  const response = await fetchImplementation(`${gatewayBase}${params.path}`, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\" },\n    body: JSON.stringify(params.body),\n  });\n  const text = await response.text().catch(() => \"\");\n  let payload: unknown = null;\n  try {\n    payload = text ? (JSON.parse(text) as unknown) : null;\n  } catch {\n    payload = text;\n  }\n  if (!response.ok) {\n    throw new Error(\n      `Gateway request failed (${response.status}) for ${params.path}: ${\n        typeof payload === \"string\" && payload ? payload : \"no_body\"\n      }`,\n    );\n  }\n  return payload as T;\n}\n\nexport async function fetchNewsEventSignal(\n  params: NewsEventSignalRequest,\n): Promise<NewsEventSignal> {\n  if (!params.query?.trim() && !params.eventKey?.trim()) {\n    throw new Error(\"query or eventKey is required.\");\n  }\n\n  return postGatewayJson<NewsEventSignal>({\n    path: \"/v1/news/event-signal\",\n    gatewayBase: params.gatewayBase,\n    fetchImplementation: params.fetchImplementation,\n    body: {\n      ...(params.query?.trim() ? { query: params.query.trim() } : {}),\n      ...(params.eventKey?.trim() ? { eventKey: params.eventKey.trim() } : {}),\n      ...(normalizeAsOf(params.asOf) ? { asOf: normalizeAsOf(params.asOf) } : {}),\n      ...(typeof params.includePredictionMarkets === \"boolean\"\n        ? { includePredictionMarkets: params.includePredictionMarkets }\n        : {}),\n      ...(typeof params.ingestOnRequest === \"boolean\"\n        ? { ingestOnRequest: params.ingestOnRequest }\n        : {}),\n      ...(typeof params.maxAgeHours === \"number\" ? { maxAgeHours: params.maxAgeHours } : {}),\n      policy: {\n        ...(typeof params.minConfidence === \"number\"\n          ? { minConfidence: params.minConfidence }\n          : {}),\n        ...(typeof params.minIndependentSources === \"number\"\n          ? { minIndependentSources: params.minIndependentSources }\n          : {}),\n        ...(typeof params.minTierASources === \"number\"\n          ? { minTierASources: params.minTierASources }\n          : {}),\n      },\n    },\n  });\n}\n\nexport async function fetchNewsPropositionSignal(\n  params: NewsPropositionSignalRequest,\n): Promise<NewsPropositionSignal> {\n  const question = params.question.trim();\n  if (!question) {\n    throw new Error(\"question is required.\");\n  }\n\n  return postGatewayJson<NewsPropositionSignal>({\n    path: \"/v1/news/event-proposition-signal\",\n    gatewayBase: params.gatewayBase,\n    fetchImplementation: params.fetchImplementation,\n    body: {\n      question,\n      ...(params.query?.trim() ? { query: params.query.trim() } : {}),\n      ...(params.eventKey?.trim() ? { eventKey: params.eventKey.trim() } : {}),\n      ...(params.propositionType?.trim()\n        ? { propositionType: params.propositionType.trim() }\n        : {}),\n      ...(normalizeAsOf(params.asOf) ? { asOf: normalizeAsOf(params.asOf) } : {}),\n      ...(typeof params.includePredictionMarkets === \"boolean\"\n        ? { includePredictionMarkets: params.includePredictionMarkets }\n        : {}),\n      ...(typeof params.ingestOnRequest === \"boolean\"\n        ? { ingestOnRequest: params.ingestOnRequest }\n        : {}),\n      ...(typeof params.maxAgeHours === \"number\" ? { maxAgeHours: params.maxAgeHours } : {}),\n      ...(typeof params.candidateLimit === \"number\"\n        ? { candidateLimit: params.candidateLimit }\n        : {}),\n    },\n  });\n}\n\nexport function evaluateNewsContinuationGate(\n  signal: NewsEventSignal | NewsPropositionSignal,\n  gate: NewsContinuationGate,\n): NewsContinuationGateResult {\n  const blockedAction = gate.onBlocked ?? \"skip\";\n  const blockingFactors: string[] = [];\n\n  if (gate.mode === \"event\") {\n    const eventSignal = signal as NewsEventSignal;\n    if (gate.requireTriggerPassed !== false && !eventSignal.triggerPassed) {\n      blockingFactors.push(\"trigger_not_passed\");\n    }\n    if (\n      typeof gate.minConfidence === \"number\" &&\n      eventSignal.eventConfidence < gate.minConfidence\n    ) {\n      blockingFactors.push(\"confidence_below_threshold\");\n    }\n    if (\n      typeof gate.maxDataAgeMs === \"number\" &&\n      typeof eventSignal.dataAgeMs === \"number\" &&\n      eventSignal.dataAgeMs > gate.maxDataAgeMs\n    ) {\n      blockingFactors.push(\"signal_too_stale\");\n    }\n    if (\n      typeof gate.minIndependentSources === \"number\" &&\n      eventSignal.supportingSourceCount < gate.minIndependentSources\n    ) {\n      blockingFactors.push(\"insufficient_supporting_sources\");\n    }\n    if (\n      typeof gate.minTierASources === \"number\" &&\n      eventSignal.tierASourceCount < gate.minTierASources\n    ) {\n      blockingFactors.push(\"insufficient_tier_a_sources\");\n    }\n  } else {\n    const propositionSignal = signal as NewsPropositionSignal;\n    if (\n      gate.requireResolvedEvent !== false &&\n      propositionSignal.propositionStatus === \"no_matching_event\"\n    ) {\n      blockingFactors.push(\"no_matching_event\");\n    }\n    if (\n      gate.expectedAnswer &&\n      propositionSignal.answer !== gate.expectedAnswer\n    ) {\n      blockingFactors.push(\"unexpected_answer\");\n    }\n    if (\n      typeof gate.minConfidence === \"number\" &&\n      propositionSignal.propositionConfidence < gate.minConfidence\n    ) {\n      blockingFactors.push(\"confidence_below_threshold\");\n    }\n    if (\n      typeof gate.maxDataAgeMs === \"number\" &&\n      typeof propositionSignal.dataAgeMs === \"number\" &&\n      propositionSignal.dataAgeMs > gate.maxDataAgeMs\n    ) {\n      blockingFactors.push(\"signal_too_stale\");\n    }\n  }\n\n  if (blockingFactors.length === 0) {\n    return {\n      allowed: true,\n      action: \"continue\",\n      reason: \"All continuation gate checks passed.\",\n      matchedRule: gate.mode,\n      blockingFactors: [],\n    };\n  }\n\n  return {\n    allowed: false,\n    action: blockedAction,\n    reason: `Blocked by continuation gate: ${blockingFactors.join(\", \")}.`,\n    matchedRule: gate.mode,\n    blockingFactors,\n  };\n}\n\nexport class NewsSignalClient {\n  private readonly gatewayBase: string;\n  private readonly fetchImplementation: typeof fetch;\n\n  constructor(config: NewsSignalClientConfig = {}) {\n    this.gatewayBase = resolveNewsGatewayBase(config.gatewayBase);\n    this.fetchImplementation = resolveFetchImplementation(config.fetchImplementation);\n  }\n\n  eventSignal(\n    params: Omit<NewsEventSignalRequest, \"gatewayBase\" | \"fetchImplementation\">,\n  ) {\n    return fetchNewsEventSignal({\n      ...params,\n      gatewayBase: this.gatewayBase,\n      fetchImplementation: this.fetchImplementation,\n    });\n  }\n\n  propositionSignal(\n    params: Omit<NewsPropositionSignalRequest, \"gatewayBase\" | \"fetchImplementation\">,\n  ) {\n    return fetchNewsPropositionSignal({\n      ...params,\n      gatewayBase: this.gatewayBase,\n      fetchImplementation: this.fetchImplementation,\n    });\n  }\n}\n\nexport { DEFAULT_OPENPOND_GATEWAY_URL };\n"]}
+{"version":3,"sources":["../../../src/adapters/news/signals.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["const DEFAULT_OPENPOND_GATEWAY_URL = \"https://gateway.openpond.dev\";\n\nexport type NewsEventState =\n  | \"monitoring\"\n  | \"escalation\"\n  | \"de_escalation\"\n  | \"resolved\"\n  | \"contradiction\";\n\nexport type NewsSignalValue =\n  | \"none\"\n  | \"escalation\"\n  | \"de_escalation\"\n  | \"resolved\"\n  | \"contradiction\";\n\nexport type NewsPropositionAnswer = \"yes\" | \"no\" | \"unclear\";\nexport type NewsPropositionStatus = NewsPropositionAnswer | \"no_matching_event\";\nexport type NewsContinuationAction = \"continue\" | \"skip\" | \"pause\";\n\nexport type NewsPredictionMarketMatchedMarket = {\n  marketId: string;\n  eventId?: string | null;\n  eventSlug?: string | null;\n  eventTitle?: string | null;\n  conditionId?: string | null;\n  title: string;\n  slug?: string | null;\n  category?: string | null;\n  yesProbability?: number | null;\n  noProbability?: number | null;\n  leadingOutcome?: string | null;\n  leadingProbability?: number | null;\n  volume?: number | null;\n  liquidity?: number | null;\n  openInterest?: number | null;\n  probabilityDelta1h?: number | null;\n  probabilityDelta24h?: number | null;\n  fetchedAt: string;\n};\n\nexport type NewsPredictionMarketContext = {\n  matchedMarkets: NewsPredictionMarketMatchedMarket[];\n  consensusProbability?: number | null;\n  probabilityDelta1h?: number | null;\n  probabilityDelta24h?: number | null;\n  liquidityWeightedScore?: number | null;\n  predictionDisagreementScore?: number | null;\n  dataAgeMs?: number | null;\n} | null;\n\nexport type NewsSignalEvidence = {\n  articleId: string;\n  sourceId: string;\n  sourceName: string;\n  title: string;\n  canonicalUrl: string;\n  claimType: string;\n  claimPolarity: string;\n  evidenceConfidence: number;\n  evidenceAt: string;\n  summary?: string | null;\n  contentPreview?: string | null;\n};\n\nexport type NewsSignalConfidenceBreakdown = {\n  baseScore: number;\n  winningBucketScore: number;\n  opposingPenalty: number;\n  contradictionPenalty: number;\n  stateBonus: number;\n  finalScore: number;\n};\n\nexport type NewsEventSignalPolicy = {\n  minConfidence: number;\n  minIndependentSources: number;\n  minTierASources: number;\n  cooldownMinutes: number;\n  allowedSourceIds?: string[];\n};\n\nexport type NewsEventSignal = {\n  eventId: string;\n  eventKey: string;\n  title: string | null;\n  eventState: NewsEventState;\n  eventConfidence: number;\n  confidenceBreakdown: NewsSignalConfidenceBreakdown;\n  signal: NewsSignalValue;\n  triggerPassed: boolean;\n  policyRisk: \"low\" | \"medium\" | \"high\";\n  effectivePolicy: NewsEventSignalPolicy;\n  whyNotTriggered: string | null;\n  warnings: string[];\n  contradictionCount: number;\n  supportingSourceCount: number;\n  tierASourceCount: number;\n  rebuttingSourceSummary: Array<{\n    sourceId: string;\n    sourceName: string;\n    title: string;\n  }>;\n  evidence: NewsSignalEvidence[];\n  dataAgeMs: number | null;\n  predictionMarketContext: NewsPredictionMarketContext;\n};\n\nexport type NewsPropositionSignal = {\n  question: string;\n  query: string | null;\n  propositionType: string | null;\n  propositionStatus: NewsPropositionStatus;\n  answer: NewsPropositionAnswer;\n  propositionConfidence: number;\n  reasoning: string;\n  evidenceWindowSummary: string;\n  resolvedEventId: string | null;\n  resolvedEventKey: string | null;\n  resolvedEventTitle: string | null;\n  eventState: NewsEventState | null;\n  eventConfidence: number | null;\n  confidenceBreakdown: NewsSignalConfidenceBreakdown | null;\n  supportingEvidence: NewsSignalEvidence[];\n  rebuttingEvidence: NewsSignalEvidence[];\n  supportingEvidenceArticleIds: string[];\n  rebuttingEvidenceArticleIds: string[];\n  operatorReviewRecommended: boolean;\n  dataAgeMs: number | null;\n  predictionMarketContext: NewsPredictionMarketContext;\n};\n\nexport type NewsEventSignalRequest = {\n  gatewayBase?: string | null;\n  fetchImplementation?: typeof fetch;\n  query?: string;\n  eventKey?: string;\n  asOf?: string | Date | null;\n  includePredictionMarkets?: boolean;\n  ingestOnRequest?: boolean;\n  maxAgeHours?: number;\n  minConfidence?: number;\n  minIndependentSources?: number;\n  minTierASources?: number;\n};\n\nexport type NewsPropositionSignalRequest = {\n  gatewayBase?: string | null;\n  fetchImplementation?: typeof fetch;\n  question: string;\n  query?: string;\n  eventKey?: string;\n  propositionType?: string;\n  asOf?: string | Date | null;\n  includePredictionMarkets?: boolean;\n  ingestOnRequest?: boolean;\n  maxAgeHours?: number;\n  candidateLimit?: number;\n};\n\nexport type NewsSignalClientConfig = {\n  gatewayBase?: string | null;\n  fetchImplementation?: typeof fetch;\n};\n\nexport type NewsEventContinuationGate = {\n  mode: \"event\";\n  minConfidence?: number;\n  maxDataAgeMs?: number;\n  minIndependentSources?: number;\n  minTierASources?: number;\n  requireTriggerPassed?: boolean;\n  onBlocked?: Exclude<NewsContinuationAction, \"continue\">;\n};\n\nexport type NewsPropositionContinuationGate = {\n  mode: \"proposition\";\n  expectedAnswer?: NewsPropositionAnswer;\n  minConfidence?: number;\n  maxDataAgeMs?: number;\n  requireResolvedEvent?: boolean;\n  onBlocked?: Exclude<NewsContinuationAction, \"continue\">;\n};\n\nexport type NewsContinuationGate = NewsEventContinuationGate | NewsPropositionContinuationGate;\n\nexport type NewsContinuationGateResult = {\n  allowed: boolean;\n  action: NewsContinuationAction;\n  reason: string;\n  matchedRule: NewsContinuationGate[\"mode\"];\n  blockingFactors: string[];\n};\n\nfunction resolveFetchImplementation(override?: typeof fetch): typeof fetch {\n  const fetchImplementation = override ?? globalThis.fetch;\n  if (!fetchImplementation) {\n    throw new Error(\n      \"No fetch implementation available. Provide one via NewsSignalClientConfig.fetchImplementation.\",\n    );\n  }\n  return fetchImplementation;\n}\n\nexport function resolveNewsGatewayBase(override?: string | null): string {\n  const value = override ?? process.env.OPENPOND_GATEWAY_URL ?? DEFAULT_OPENPOND_GATEWAY_URL;\n  if (typeof value !== \"string\") {\n    throw new Error(\"OPENPOND_GATEWAY_URL is required.\");\n  }\n  const trimmed = value.trim();\n  if (!trimmed) {\n    throw new Error(\"OPENPOND_GATEWAY_URL is required.\");\n  }\n  return trimmed.replace(/\\/$/, \"\");\n}\n\nfunction normalizeAsOf(value?: string | Date | null): string | undefined {\n  if (value == null) return undefined;\n  const date = value instanceof Date ? value : new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    throw new Error(\"asOf must be a valid ISO-8601 datetime or Date.\");\n  }\n  return date.toISOString();\n}\n\nasync function postGatewayJson<T>(params: {\n  path: string;\n  body: Record<string, unknown>;\n  gatewayBase?: string | null | undefined;\n  fetchImplementation?: typeof fetch | undefined;\n}): Promise<T> {\n  const gatewayBase = resolveNewsGatewayBase(params.gatewayBase);\n  const fetchImplementation = resolveFetchImplementation(params.fetchImplementation);\n  const response = await fetchImplementation(`${gatewayBase}${params.path}`, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\" },\n    body: JSON.stringify(params.body),\n  });\n  const text = await response.text().catch(() => \"\");\n  let payload: unknown = null;\n  try {\n    payload = text ? (JSON.parse(text) as unknown) : null;\n  } catch {\n    payload = text;\n  }\n  if (!response.ok) {\n    throw new Error(\n      `Gateway request failed (${response.status}) for ${params.path}: ${\n        typeof payload === \"string\" && payload ? payload : \"no_body\"\n      }`,\n    );\n  }\n  return payload as T;\n}\n\nexport async function fetchNewsEventSignal(\n  params: NewsEventSignalRequest,\n): Promise<NewsEventSignal> {\n  if (!params.query?.trim() && !params.eventKey?.trim()) {\n    throw new Error(\"query or eventKey is required.\");\n  }\n\n  return postGatewayJson<NewsEventSignal>({\n    path: \"/v1/news/event-signal\",\n    gatewayBase: params.gatewayBase,\n    fetchImplementation: params.fetchImplementation,\n    body: {\n      ...(params.query?.trim() ? { query: params.query.trim() } : {}),\n      ...(params.eventKey?.trim() ? { eventKey: params.eventKey.trim() } : {}),\n      ...(normalizeAsOf(params.asOf) ? { asOf: normalizeAsOf(params.asOf) } : {}),\n      ...(typeof params.includePredictionMarkets === \"boolean\"\n        ? { includePredictionMarkets: params.includePredictionMarkets }\n        : {}),\n      ...(typeof params.ingestOnRequest === \"boolean\"\n        ? { ingestOnRequest: params.ingestOnRequest }\n        : {}),\n      ...(typeof params.maxAgeHours === \"number\" ? { maxAgeHours: params.maxAgeHours } : {}),\n      policy: {\n        ...(typeof params.minConfidence === \"number\"\n          ? { minConfidence: params.minConfidence }\n          : {}),\n        ...(typeof params.minIndependentSources === \"number\"\n          ? { minIndependentSources: params.minIndependentSources }\n          : {}),\n        ...(typeof params.minTierASources === \"number\"\n          ? { minTierASources: params.minTierASources }\n          : {}),\n      },\n    },\n  });\n}\n\nexport async function fetchNewsPropositionSignal(\n  params: NewsPropositionSignalRequest,\n): Promise<NewsPropositionSignal> {\n  const question = params.question.trim();\n  if (!question) {\n    throw new Error(\"question is required.\");\n  }\n\n  return postGatewayJson<NewsPropositionSignal>({\n    path: \"/v1/news/event-proposition-signal\",\n    gatewayBase: params.gatewayBase,\n    fetchImplementation: params.fetchImplementation,\n    body: {\n      question,\n      ...(params.query?.trim() ? { query: params.query.trim() } : {}),\n      ...(params.eventKey?.trim() ? { eventKey: params.eventKey.trim() } : {}),\n      ...(params.propositionType?.trim() ? { propositionType: params.propositionType.trim() } : {}),\n      ...(normalizeAsOf(params.asOf) ? { asOf: normalizeAsOf(params.asOf) } : {}),\n      ...(typeof params.includePredictionMarkets === \"boolean\"\n        ? { includePredictionMarkets: params.includePredictionMarkets }\n        : {}),\n      ...(typeof params.ingestOnRequest === \"boolean\"\n        ? { ingestOnRequest: params.ingestOnRequest }\n        : {}),\n      ...(typeof params.maxAgeHours === \"number\" ? { maxAgeHours: params.maxAgeHours } : {}),\n      ...(typeof params.candidateLimit === \"number\"\n        ? { candidateLimit: params.candidateLimit }\n        : {}),\n    },\n  });\n}\n\nexport function evaluateNewsContinuationGate(\n  signal: NewsEventSignal | NewsPropositionSignal,\n  gate: NewsContinuationGate,\n): NewsContinuationGateResult {\n  const blockedAction = gate.onBlocked ?? \"skip\";\n  const blockingFactors: string[] = [];\n\n  if (gate.mode === \"event\") {\n    const eventSignal = signal as NewsEventSignal;\n    if (gate.requireTriggerPassed !== false && !eventSignal.triggerPassed) {\n      blockingFactors.push(\"trigger_not_passed\");\n    }\n    if (\n      typeof gate.minConfidence === \"number\" &&\n      eventSignal.eventConfidence < gate.minConfidence\n    ) {\n      blockingFactors.push(\"confidence_below_threshold\");\n    }\n    if (\n      typeof gate.maxDataAgeMs === \"number\" &&\n      typeof eventSignal.dataAgeMs === \"number\" &&\n      eventSignal.dataAgeMs > gate.maxDataAgeMs\n    ) {\n      blockingFactors.push(\"signal_too_stale\");\n    }\n    if (\n      typeof gate.minIndependentSources === \"number\" &&\n      eventSignal.supportingSourceCount < gate.minIndependentSources\n    ) {\n      blockingFactors.push(\"insufficient_supporting_sources\");\n    }\n    if (\n      typeof gate.minTierASources === \"number\" &&\n      eventSignal.tierASourceCount < gate.minTierASources\n    ) {\n      blockingFactors.push(\"insufficient_tier_a_sources\");\n    }\n  } else {\n    const propositionSignal = signal as NewsPropositionSignal;\n    if (\n      gate.requireResolvedEvent !== false &&\n      propositionSignal.propositionStatus === \"no_matching_event\"\n    ) {\n      blockingFactors.push(\"no_matching_event\");\n    }\n    if (gate.expectedAnswer && propositionSignal.answer !== gate.expectedAnswer) {\n      blockingFactors.push(\"unexpected_answer\");\n    }\n    if (\n      typeof gate.minConfidence === \"number\" &&\n      propositionSignal.propositionConfidence < gate.minConfidence\n    ) {\n      blockingFactors.push(\"confidence_below_threshold\");\n    }\n    if (\n      typeof gate.maxDataAgeMs === \"number\" &&\n      typeof propositionSignal.dataAgeMs === \"number\" &&\n      propositionSignal.dataAgeMs > gate.maxDataAgeMs\n    ) {\n      blockingFactors.push(\"signal_too_stale\");\n    }\n  }\n\n  if (blockingFactors.length === 0) {\n    return {\n      allowed: true,\n      action: \"continue\",\n      reason: \"All continuation gate checks passed.\",\n      matchedRule: gate.mode,\n      blockingFactors: [],\n    };\n  }\n\n  return {\n    allowed: false,\n    action: blockedAction,\n    reason: `Blocked by continuation gate: ${blockingFactors.join(\", \")}.`,\n    matchedRule: gate.mode,\n    blockingFactors,\n  };\n}\n\nexport class NewsSignalClient {\n  private readonly gatewayBase: string;\n  private readonly fetchImplementation: typeof fetch;\n\n  constructor(config: NewsSignalClientConfig = {}) {\n    this.gatewayBase = resolveNewsGatewayBase(config.gatewayBase);\n    this.fetchImplementation = resolveFetchImplementation(config.fetchImplementation);\n  }\n\n  eventSignal(params: Omit<NewsEventSignalRequest, \"gatewayBase\" | \"fetchImplementation\">) {\n    return fetchNewsEventSignal({\n      ...params,\n      gatewayBase: this.gatewayBase,\n      fetchImplementation: this.fetchImplementation,\n    });\n  }\n\n  propositionSignal(\n    params: Omit<NewsPropositionSignalRequest, \"gatewayBase\" | \"fetchImplementation\">,\n  ) {\n    return fetchNewsPropositionSignal({\n      ...params,\n      gatewayBase: this.gatewayBase,\n      fetchImplementation: this.fetchImplementation,\n    });\n  }\n}\n\nexport { DEFAULT_OPENPOND_GATEWAY_URL };\n"]}

package/dist/adapters/polymarket/index.d.ts

@@ -1,5 +1,5 @@
 import { h as WalletFullContext } from '../../types-BaTmu0gS.js';
-import 'viem';
+import { PublicClient } from 'viem';
 import 'viem/accounts';
 
 type PolymarketEnvironment = "mainnet" | "testnet";
@@ -200,6 +200,7 @@ declare function createOrDerivePolymarketApiKey(args: PolymarketApiKeyRequestArg
 declare function placePolymarketOrder(args: {
     wallet: WalletFullContext;
     credentials?: PolymarketApiCredentials;
+    apiKeyNonce?: number;
     order: PolymarketOrderIntent;
     orderType?: PolymarketOrderType;
     environment?: PolymarketEnvironment;
@@ -209,6 +210,7 @@ declare function cancelPolymarketOrder(args: {
     wallet?: WalletFullContext;
     walletAddress?: `0x${string}`;
     credentials?: PolymarketApiCredentials;
+    apiKeyNonce?: number;
     environment?: PolymarketEnvironment;
 }): Promise<Record<string, unknown>>;
 declare function cancelPolymarketOrders(args: {
@@ -216,12 +218,14 @@ declare function cancelPolymarketOrders(args: {
     wallet?: WalletFullContext;
     walletAddress?: `0x${string}`;
     credentials?: PolymarketApiCredentials;
+    apiKeyNonce?: number;
     environment?: PolymarketEnvironment;
 }): Promise<Record<string, unknown>>;
 declare function cancelAllPolymarketOrders(args: {
     wallet?: WalletFullContext;
     walletAddress?: `0x${string}`;
     credentials?: PolymarketApiCredentials;
+    apiKeyNonce?: number;
     environment?: PolymarketEnvironment;
 }): Promise<Record<string, unknown>>;
 declare function cancelMarketPolymarketOrders(args: {
@@ -229,16 +233,19 @@ declare function cancelMarketPolymarketOrders(args: {
     wallet?: WalletFullContext;
     walletAddress?: `0x${string}`;
     credentials?: PolymarketApiCredentials;
+    apiKeyNonce?: number;
     environment?: PolymarketEnvironment;
 }): Promise<Record<string, unknown>>;
 declare class PolymarketExchangeClient {
     private readonly wallet;
     private readonly credentials;
+    private readonly apiKeyNonce;
     private readonly environment;
     private cachedCredentials;
     constructor(args: {
         wallet: WalletFullContext;
         credentials?: PolymarketApiCredentials;
+        apiKeyNonce?: number;
         environment?: PolymarketEnvironment;
     });
     private getCredentials;
@@ -456,4 +463,69 @@ declare function fetchPolymarketPublicProfile(params: {
     environment?: PolymarketEnvironment;
 }): Promise<PolymarketPublicProfile | null>;
 
-export { POLYMARKET_CHAIN_ID, POLYMARKET_CLOB_AUTH_DOMAIN, POLYMARKET_CLOB_DOMAIN, POLYMARKET_ENDPOINTS, POLYMARKET_EXCHANGE_ADDRESSES, type PolymarketActivityType, type PolymarketApiCredentials, PolymarketApiError, type PolymarketApiKeyResponse, PolymarketAuthError, type PolymarketClosedPosition, type PolymarketClosedPositionParams, type PolymarketEnvironment, PolymarketExchangeClient, PolymarketInfoClient, type PolymarketMarket, type PolymarketOrderIntent, type PolymarketOrderType, type PolymarketOrderbook, type PolymarketPlaceOrderResponse, type PolymarketPositionValue, type PolymarketPositionValueParams, type PolymarketPriceHistoryPoint, type PolymarketPublicProfile, type PolymarketPublicProfileUser, type PolymarketSide, type PolymarketSignatureType, type PolymarketSignedOrderPayload, type PolymarketUserActivity, type PolymarketUserActivityParams, type PolymarketUserPosition, type PolymarketUserPositionParams, buildHmacSignature, buildL1Headers, buildL2Headers, buildPolymarketOrderAmounts, buildSignedOrderPayload, cancelAllPolymarketOrders, cancelMarketPolymarketOrders, cancelPolymarketOrder, cancelPolymarketOrders, createOrDerivePolymarketApiKey, createPolymarketApiKey, derivePolymarketApiKey, fetchPolymarketActivity, fetchPolymarketClosedPositions, fetchPolymarketMarket, fetchPolymarketMarkets, fetchPolymarketMidpoint, fetchPolymarketOrderbook, fetchPolymarketPositionValue, fetchPolymarketPositions, fetchPolymarketPrice, fetchPolymarketPriceHistory, fetchPolymarketPublicProfile, normalizeNumberArrayish, normalizeStringArrayish, placePolymarketOrder, resolveExchangeAddress, resolvePolymarketBaseUrl };
+interface PolymarketBootstrapContracts {
+    usdc: `0x${string}`;
+    ctf: `0x${string}`;
+    negRiskAdapter: `0x${string}`;
+    safeFactory: `0x${string}`;
+    safeMultisend: `0x${string}`;
+    relayerUrl: string;
+    bridgeUrl: string;
+}
+interface PolymarketBootstrapTransaction {
+    to: `0x${string}`;
+    data: `0x${string}`;
+    value: string;
+    description: string;
+}
+interface PolymarketDepositAddressSet {
+    evm?: string | null;
+    svm?: string | null;
+    btc?: string | null;
+    sol?: string | null;
+    [key: string]: unknown;
+}
+interface PolymarketDepositAddressesResponse {
+    address?: PolymarketDepositAddressSet | null;
+    note?: string | null;
+    [key: string]: unknown;
+}
+interface PolymarketApprovalState {
+    funder: `0x${string}`;
+    usdcAllowance: bigint;
+    usdcApproved: boolean;
+    ctfExchangeApproved: boolean;
+    negRiskExchangeApproved: boolean;
+    approvalsReady: boolean;
+}
+declare function resolvePolymarketBootstrapContracts(environment: PolymarketEnvironment): PolymarketBootstrapContracts;
+declare function buildPolymarketUsdcApprovalTransaction(args?: {
+    environment?: PolymarketEnvironment;
+    amount?: bigint;
+}): PolymarketBootstrapTransaction;
+declare function buildPolymarketOutcomeTokenApprovalTransactions(args?: {
+    environment?: PolymarketEnvironment;
+    includeNegRisk?: boolean;
+}): PolymarketBootstrapTransaction[];
+declare function buildPolymarketApprovalTransactions(args?: {
+    environment?: PolymarketEnvironment;
+    amount?: bigint;
+    includeNegRisk?: boolean;
+}): PolymarketBootstrapTransaction[];
+declare function fetchPolymarketApprovalState(args: {
+    publicClient: Pick<PublicClient, "readContract">;
+    funder: `0x${string}`;
+    environment?: PolymarketEnvironment;
+    includeNegRisk?: boolean;
+}): Promise<PolymarketApprovalState>;
+declare function fetchPolymarketDepositAddresses(args: {
+    address: string;
+    environment?: PolymarketEnvironment;
+}): Promise<PolymarketDepositAddressesResponse>;
+declare function decodePolymarketBootstrapTransaction(transaction: PolymarketBootstrapTransaction): {
+    to: `0x${string}`;
+    functionName: string;
+    args: readonly unknown[];
+};
+
+export { POLYMARKET_CHAIN_ID, POLYMARKET_CLOB_AUTH_DOMAIN, POLYMARKET_CLOB_DOMAIN, POLYMARKET_ENDPOINTS, POLYMARKET_EXCHANGE_ADDRESSES, type PolymarketActivityType, type PolymarketApiCredentials, PolymarketApiError, type PolymarketApiKeyResponse, type PolymarketApprovalState, PolymarketAuthError, type PolymarketBootstrapContracts, type PolymarketBootstrapTransaction, type PolymarketClosedPosition, type PolymarketClosedPositionParams, type PolymarketDepositAddressSet, type PolymarketDepositAddressesResponse, type PolymarketEnvironment, PolymarketExchangeClient, PolymarketInfoClient, type PolymarketMarket, type PolymarketOrderIntent, type PolymarketOrderType, type PolymarketOrderbook, type PolymarketPlaceOrderResponse, type PolymarketPositionValue, type PolymarketPositionValueParams, type PolymarketPriceHistoryPoint, type PolymarketPublicProfile, type PolymarketPublicProfileUser, type PolymarketSide, type PolymarketSignatureType, type PolymarketSignedOrderPayload, type PolymarketUserActivity, type PolymarketUserActivityParams, type PolymarketUserPosition, type PolymarketUserPositionParams, buildHmacSignature, buildL1Headers, buildL2Headers, buildPolymarketApprovalTransactions, buildPolymarketOrderAmounts, buildPolymarketOutcomeTokenApprovalTransactions, buildPolymarketUsdcApprovalTransaction, buildSignedOrderPayload, cancelAllPolymarketOrders, cancelMarketPolymarketOrders, cancelPolymarketOrder, cancelPolymarketOrders, createOrDerivePolymarketApiKey, createPolymarketApiKey, decodePolymarketBootstrapTransaction, derivePolymarketApiKey, fetchPolymarketActivity, fetchPolymarketApprovalState, fetchPolymarketClosedPositions, fetchPolymarketDepositAddresses, fetchPolymarketMarket, fetchPolymarketMarkets, fetchPolymarketMidpoint, fetchPolymarketOrderbook, fetchPolymarketPositionValue, fetchPolymarketPositions, fetchPolymarketPrice, fetchPolymarketPriceHistory, fetchPolymarketPublicProfile, normalizeNumberArrayish, normalizeStringArrayish, placePolymarketOrder, resolveExchangeAddress, resolvePolymarketBaseUrl, resolvePolymarketBootstrapContracts };

package/dist/adapters/polymarket/index.js

@@ -1,5 +1,5 @@
 import { createHmac, randomBytes } from 'crypto';
-import { parseUnits } from 'viem';
+import { parseUnits, encodeFunctionData, maxUint256, erc20Abi, decodeFunctionData } from 'viem';
 
 // src/adapters/polymarket/base.ts
 var PolymarketApiError = class extends Error {
@@ -159,7 +159,7 @@ async function buildL1Headers(args) {
   const nonce = args.nonce ?? Date.now();
   const chainId = POLYMARKET_CHAIN_ID[args.environment ?? "mainnet"];
   const address = args.wallet.address;
-  const message = args.message ?? "Create or derive a Polymarket API key";
+  const message = args.message ?? "This message attests that I control the given wallet";
   const signature = await args.wallet.walletClient.signTypedData({
     account: args.wallet.account,
     domain: {
@@ -313,14 +313,32 @@ async function buildSignedOrderPayload(args) {
 }
 
 // src/adapters/polymarket/exchange.ts
+function requireApiKeyNonce(nonce, message = "Polymarket API key operations require an explicit nonce.") {
+  if (!Number.isSafeInteger(nonce) || nonce == null || nonce < 0) {
+    throw new PolymarketAuthError(message);
+  }
+  return nonce;
+}
 async function resolveAuthContext(args) {
   if (args.wallet) {
-    const credentials = args.credentials ?? await createOrDerivePolymarketApiKey({
+    const credentials = args.credentials;
+    if (credentials) {
+      return {
+        credentials,
+        address: args.wallet.address
+      };
+    }
+    const apiKeyNonce = requireApiKeyNonce(
+      args.apiKeyNonce,
+      "Polymarket auto-auth requires apiKeyNonce when credentials are not provided."
+    );
+    const derivedCredentials = await derivePolymarketApiKey({
       wallet: args.wallet,
-      ...args.environment ? { environment: args.environment } : {}
+      ...args.environment ? { environment: args.environment } : {},
+      nonce: apiKeyNonce
     });
     return {
-      credentials,
+      credentials: derivedCredentials,
       address: args.wallet.address
     };
   }
@@ -366,11 +384,12 @@ async function requestPolymarketApiKey(args) {
   const environment = args.environment ?? "mainnet";
   const baseUrl = resolvePolymarketBaseUrl("clob", environment);
   const url = args.mode === "create" ? `${baseUrl}/auth/api-key` : `${baseUrl}/auth/derive-api-key`;
+  const nonce = requireApiKeyNonce(args.nonce);
   const headers = await buildL1Headers({
     wallet: args.wallet,
     environment,
     ...args.timestamp !== void 0 ? { timestamp: args.timestamp } : {},
-    ...args.nonce !== void 0 ? { nonce: args.nonce } : {},
+    nonce,
     ...args.message !== void 0 ? { message: args.message } : {}
   });
   return await requestJson(url, {
@@ -401,13 +420,29 @@ async function derivePolymarketApiKey(args) {
   return normalized;
 }
 async function createOrDerivePolymarketApiKey(args) {
+  let deriveError;
+  try {
+    const derived = normalizeApiKeyResponse(
+      await requestPolymarketApiKey({ ...args, mode: "derive" })
+    );
+    if (derived) {
+      return derived;
+    }
+  } catch (error) {
+    deriveError = error;
+  }
   const created = normalizeApiKeyResponse(
     await requestPolymarketApiKey({ ...args, mode: "create" })
   );
   if (created) {
     return created;
   }
-  return derivePolymarketApiKey(args);
+  if (deriveError) {
+    throw deriveError;
+  }
+  throw new PolymarketAuthError(
+    "Failed to derive or create Polymarket API key."
+  );
 }
 async function placePolymarketOrder(args) {
   const environment = args.environment ?? "mainnet";
@@ -421,7 +456,8 @@ async function placePolymarketOrder(args) {
   const auth = await resolveAuthContext({
     wallet: args.wallet,
     ...args.credentials ? { credentials: args.credentials } : {},
-    environment
+    environment,
+    ...args.apiKeyNonce !== void 0 ? { apiKeyNonce: args.apiKeyNonce } : {}
   });
   const body = {
     order: signedOrder,
@@ -453,7 +489,8 @@ async function cancelPolymarketOrder(args) {
     ...args.wallet ? { wallet: args.wallet } : {},
     ...args.walletAddress ? { walletAddress: args.walletAddress } : {},
     ...args.credentials ? { credentials: args.credentials } : {},
-    environment
+    environment,
+    ...args.apiKeyNonce !== void 0 ? { apiKeyNonce: args.apiKeyNonce } : {}
   });
   const headers = buildL2Headers({
     credentials: auth.credentials,
@@ -480,7 +517,8 @@ async function cancelPolymarketOrders(args) {
     ...args.wallet ? { wallet: args.wallet } : {},
     ...args.walletAddress ? { walletAddress: args.walletAddress } : {},
     ...args.credentials ? { credentials: args.credentials } : {},
-    environment
+    environment,
+    ...args.apiKeyNonce !== void 0 ? { apiKeyNonce: args.apiKeyNonce } : {}
   });
   const headers = buildL2Headers({
     credentials: auth.credentials,
@@ -506,7 +544,8 @@ async function cancelAllPolymarketOrders(args) {
     ...args.wallet ? { wallet: args.wallet } : {},
     ...args.walletAddress ? { walletAddress: args.walletAddress } : {},
     ...args.credentials ? { credentials: args.credentials } : {},
-    environment
+    environment,
+    ...args.apiKeyNonce !== void 0 ? { apiKeyNonce: args.apiKeyNonce } : {}
   });
   const headers = buildL2Headers({
     credentials: auth.credentials,
@@ -531,7 +570,8 @@ async function cancelMarketPolymarketOrders(args) {
     ...args.wallet ? { wallet: args.wallet } : {},
     ...args.walletAddress ? { walletAddress: args.walletAddress } : {},
     ...args.credentials ? { credentials: args.credentials } : {},
-    environment
+    environment,
+    ...args.apiKeyNonce !== void 0 ? { apiKeyNonce: args.apiKeyNonce } : {}
   });
   const headers = buildL2Headers({
     credentials: auth.credentials,
@@ -553,6 +593,7 @@ var PolymarketExchangeClient = class {
   constructor(args) {
     this.wallet = args.wallet;
     this.credentials = args.credentials;
+    this.apiKeyNonce = args.apiKeyNonce;
     this.environment = args.environment ?? "mainnet";
   }
   async getCredentials() {
@@ -560,7 +601,8 @@ var PolymarketExchangeClient = class {
     const resolved = await resolveAuthContext({
       wallet: this.wallet,
       ...this.credentials ? { credentials: this.credentials } : {},
-      environment: this.environment
+      environment: this.environment,
+      ...this.apiKeyNonce !== void 0 ? { apiKeyNonce: this.apiKeyNonce } : {}
     });
     this.cachedCredentials = resolved.credentials;
     return resolved.credentials;
@@ -1113,7 +1155,176 @@ async function fetchPolymarketPublicProfile(params) {
   const data = await requestJson2(url.toString());
   return normalizePublicProfile(data);
 }
+var POLYMARKET_SET_APPROVAL_FOR_ALL_ABI = [
+  {
+    inputs: [
+      { name: "operator", type: "address" },
+      { name: "approved", type: "bool" }
+    ],
+    name: "setApprovalForAll",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { name: "account", type: "address" },
+      { name: "operator", type: "address" }
+    ],
+    name: "isApprovedForAll",
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+var POLYMARKET_BOOTSTRAP_CONTRACTS_BY_ENV = {
+  mainnet: {
+    usdc: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
+    ctf: "0x4D97DCd97eC945f40cF65F87097ACe5EA0476045",
+    negRiskAdapter: "0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296",
+    safeFactory: "0xaacFeEa03eb1561C4e67d661e40682Bd20E3541b",
+    safeMultisend: "0xA238CBeb142c10Ef7Ad8442C6D1f9E89e07e7761",
+    relayerUrl: "https://relayer-v2.polymarket.com",
+    bridgeUrl: "https://bridge.polymarket.com"
+  }
+};
+async function requestJson3(url, init) {
+  const response = await fetch(url, init);
+  const text = await response.text().catch(() => "");
+  let data = null;
+  try {
+    data = text ? JSON.parse(text) : null;
+  } catch {
+    data = text;
+  }
+  if (!response.ok) {
+    throw new PolymarketApiError(
+      `Polymarket request failed (${response.status}).`,
+      data ?? { status: response.status }
+    );
+  }
+  return data;
+}
+function resolvePolymarketBootstrapContracts(environment) {
+  const contracts = POLYMARKET_BOOTSTRAP_CONTRACTS_BY_ENV[environment];
+  if (!contracts) {
+    throw new Error(
+      `Polymarket bootstrap contracts are not configured for ${environment}.`
+    );
+  }
+  return contracts;
+}
+function buildPolymarketUsdcApprovalTransaction(args) {
+  const environment = args?.environment ?? "mainnet";
+  const contracts = resolvePolymarketBootstrapContracts(environment);
+  return {
+    to: contracts.usdc,
+    data: encodeFunctionData({
+      abi: erc20Abi,
+      functionName: "approve",
+      args: [contracts.ctf, args?.amount ?? maxUint256]
+    }),
+    value: "0",
+    description: "Approve USDC.e for CTF"
+  };
+}
+function buildPolymarketOutcomeTokenApprovalTransactions(args) {
+  const environment = args?.environment ?? "mainnet";
+  const includeNegRisk = args?.includeNegRisk ?? true;
+  const contracts = resolvePolymarketBootstrapContracts(environment);
+  const transactions = [
+    {
+      to: contracts.ctf,
+      data: encodeFunctionData({
+        abi: POLYMARKET_SET_APPROVAL_FOR_ALL_ABI,
+        functionName: "setApprovalForAll",
+        args: [POLYMARKET_EXCHANGE_ADDRESSES[environment].ctf, true]
+      }),
+      value: "0",
+      description: "Approve outcome tokens for CTF Exchange"
+    }
+  ];
+  if (includeNegRisk) {
+    transactions.push({
+      to: contracts.ctf,
+      data: encodeFunctionData({
+        abi: POLYMARKET_SET_APPROVAL_FOR_ALL_ABI,
+        functionName: "setApprovalForAll",
+        args: [POLYMARKET_EXCHANGE_ADDRESSES[environment].negRisk, true]
+      }),
+      value: "0",
+      description: "Approve outcome tokens for Neg Risk Exchange"
+    });
+  }
+  return transactions;
+}
+function buildPolymarketApprovalTransactions(args) {
+  return [
+    buildPolymarketUsdcApprovalTransaction(args),
+    ...buildPolymarketOutcomeTokenApprovalTransactions(args)
+  ];
+}
+async function fetchPolymarketApprovalState(args) {
+  const environment = args.environment ?? "mainnet";
+  const includeNegRisk = args.includeNegRisk ?? true;
+  const contracts = resolvePolymarketBootstrapContracts(environment);
+  const ctfExchange = POLYMARKET_EXCHANGE_ADDRESSES[environment].ctf;
+  const negRiskExchange = POLYMARKET_EXCHANGE_ADDRESSES[environment].negRisk;
+  const [allowance, ctfExchangeApproved, negRiskExchangeApproved] = await Promise.all([
+    args.publicClient.readContract({
+      address: contracts.usdc,
+      abi: erc20Abi,
+      functionName: "allowance",
+      args: [args.funder, contracts.ctf]
+    }),
+    args.publicClient.readContract({
+      address: contracts.ctf,
+      abi: POLYMARKET_SET_APPROVAL_FOR_ALL_ABI,
+      functionName: "isApprovedForAll",
+      args: [args.funder, ctfExchange]
+    }),
+    includeNegRisk ? args.publicClient.readContract({
+      address: contracts.ctf,
+      abi: POLYMARKET_SET_APPROVAL_FOR_ALL_ABI,
+      functionName: "isApprovedForAll",
+      args: [args.funder, negRiskExchange]
+    }) : Promise.resolve(true)
+  ]);
+  return {
+    funder: args.funder,
+    usdcAllowance: allowance,
+    usdcApproved: allowance > 0n,
+    ctfExchangeApproved,
+    negRiskExchangeApproved,
+    approvalsReady: allowance > 0n && ctfExchangeApproved && negRiskExchangeApproved
+  };
+}
+async function fetchPolymarketDepositAddresses(args) {
+  const environment = args.environment ?? "mainnet";
+  const contracts = resolvePolymarketBootstrapContracts(environment);
+  return await requestJson3(`${contracts.bridgeUrl}/deposit`, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify({
+      address: args.address
+    })
+  });
+}
+function decodePolymarketBootstrapTransaction(transaction) {
+  const abi = transaction.to.toLowerCase() === resolvePolymarketBootstrapContracts("mainnet").usdc.toLowerCase() ? erc20Abi : POLYMARKET_SET_APPROVAL_FOR_ALL_ABI;
+  const decoded = decodeFunctionData({
+    abi,
+    data: transaction.data
+  });
+  return {
+    to: transaction.to,
+    functionName: decoded.functionName,
+    args: decoded.args ?? []
+  };
+}
 
-export { POLYMARKET_CHAIN_ID, POLYMARKET_CLOB_AUTH_DOMAIN, POLYMARKET_CLOB_DOMAIN, POLYMARKET_ENDPOINTS, POLYMARKET_EXCHANGE_ADDRESSES, PolymarketApiError, PolymarketAuthError, PolymarketExchangeClient, PolymarketInfoClient, buildHmacSignature, buildL1Headers, buildL2Headers, buildPolymarketOrderAmounts, buildSignedOrderPayload, cancelAllPolymarketOrders, cancelMarketPolymarketOrders, cancelPolymarketOrder, cancelPolymarketOrders, createOrDerivePolymarketApiKey, createPolymarketApiKey, derivePolymarketApiKey, fetchPolymarketActivity, fetchPolymarketClosedPositions, fetchPolymarketMarket, fetchPolymarketMarkets, fetchPolymarketMidpoint, fetchPolymarketOrderbook, fetchPolymarketPositionValue, fetchPolymarketPositions, fetchPolymarketPrice, fetchPolymarketPriceHistory, fetchPolymarketPublicProfile, normalizeNumberArrayish, normalizeStringArrayish, placePolymarketOrder, resolveExchangeAddress, resolvePolymarketBaseUrl };
+export { POLYMARKET_CHAIN_ID, POLYMARKET_CLOB_AUTH_DOMAIN, POLYMARKET_CLOB_DOMAIN, POLYMARKET_ENDPOINTS, POLYMARKET_EXCHANGE_ADDRESSES, PolymarketApiError, PolymarketAuthError, PolymarketExchangeClient, PolymarketInfoClient, buildHmacSignature, buildL1Headers, buildL2Headers, buildPolymarketApprovalTransactions, buildPolymarketOrderAmounts, buildPolymarketOutcomeTokenApprovalTransactions, buildPolymarketUsdcApprovalTransaction, buildSignedOrderPayload, cancelAllPolymarketOrders, cancelMarketPolymarketOrders, cancelPolymarketOrder, cancelPolymarketOrders, createOrDerivePolymarketApiKey, createPolymarketApiKey, decodePolymarketBootstrapTransaction, derivePolymarketApiKey, fetchPolymarketActivity, fetchPolymarketApprovalState, fetchPolymarketClosedPositions, fetchPolymarketDepositAddresses, fetchPolymarketMarket, fetchPolymarketMarkets, fetchPolymarketMidpoint, fetchPolymarketOrderbook, fetchPolymarketPositionValue, fetchPolymarketPositions, fetchPolymarketPrice, fetchPolymarketPriceHistory, fetchPolymarketPublicProfile, normalizeNumberArrayish, normalizeStringArrayish, placePolymarketOrder, resolveExchangeAddress, resolvePolymarketBaseUrl, resolvePolymarketBootstrapContracts };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map