@flapsdk/vault-runtime 0.1.0 → 0.1.2

package/README.md

@@ -6,9 +6,9 @@ This package is the shared runtime surface that local preview, Artifact Workbenc
 
 ## Exports
 
-- `./sdk`: component-facing SDK hooks, helpers, types, and provider
+- `./sdk`: component-facing SDK hooks, helpers, types, provider, and local oracle reader helper
 - `./ui`: shared UI primitives
 - `./host`: host/runtime preflight helpers
-- `./server`: server-side presentation and host-proxy helpers
+- `./server`: server-side presentation plus runtime oracle-registry helpers
 
 See `runtime-contract.json` for the machine-readable subpath contract.

package/host.d.mts

@@ -1,9 +1,9 @@
-import { a as Address, x as TokenRuntimeSnapshot, w as TokenMetadataSnapshot, n as HostRuntimeInput, H as HostRuntimeAddresses, r as HostRuntimeResult, c as CreateVaultRuntimeContextInput, G as VaultRuntimeContext } from './types-CX7pLmiT.mjs';
-export { A as ActionAvailabilityStage, C as ContractReadRequest, b as ContractWriteRequest, E as EndpointPolicy, F as FeeMode, d as FlapFeeVaultInfo, e as FlapI18n, f as FlapNotify, g as FlapTaxInfo, h as FlapTokenInfo, i as FlapVaultPortalInfo, j as FlapVaultSdk, k as FlapWallet, l as HostRuntimeDataSource, m as HostRuntimeDegradeReason, o as HostRuntimePolicy, p as HostRuntimePresentationFetcher, q as HostRuntimePresentationRequest, s as HostRuntimeSources, t as HostRuntimeStatus, u as HostRuntimeWarning, v as HostTokenPresentation, M as ManifestBindingEntry, P as PaymentToken, S as SimulateResult, T as TokenMarketPhase, y as TxReceipt, V as VaultComponentProps, z as VaultHostContext, B as VaultManifest, D as VaultRenderSurface, I as VaultRuntimeContextOverrides, J as VaultRuntimeExtraConfig } from './types-CX7pLmiT.mjs';
-export { C as CreateTaxInfoHostContextInput, R as ResolveRenderSurfaceInput, a as RuntimeMatchInput, T as TaxVaultHostSnapshot, b as TxErrorKind, V as VaultBindingPolicy, Z as ZERO_ADDRESS, c as createTaxInfoHostContext, f as formatCountdown, d as formatPercentBps, e as formatTokenAmount, g as getTupleField, h as getTxErrorKind, i as handleTxError, j as isActionAvailableForPhase, k as isCustomVaultTaxToken, l as isManifestRuntimeMatch, m as isSameAddress, n as isValidAddress, o as isVaultBindingMatch, p as normalizeAddress, q as parseFeeVaultInfo, r as parsePortalTokenInfo, s as parseTaxTokenInfo, t as parseTokenAmount, u as parseVaultPortalInfo, v as readTaxVaultHostContext, w as resolveFeeMode, x as resolveManifestBinding, y as resolveTaxInfoRenderSurface, z as resolveTokenMarketPhase, A as resolveVaultBinding, B as shortenAddress, D as standardErc20Abi } from './txError-1lPZHdqI.mjs';
+import { a as Address, B as TokenRuntimeSnapshot, z as TokenMetadataSnapshot, n as HostRuntimeInput, H as HostRuntimeAddresses, r as HostRuntimeResult, c as CreateVaultRuntimeContextInput, K as VaultRuntimeContext } from './types-DzTX2u7q.mjs';
+export { A as ActionAvailabilityStage, C as ContractReadRequest, b as ContractWriteRequest, E as EndpointPolicy, F as FeeMode, d as FlapFeeVaultInfo, e as FlapI18n, f as FlapNotify, g as FlapTaxInfo, h as FlapTokenInfo, i as FlapVaultPortalInfo, j as FlapVaultSdk, k as FlapWallet, l as HostRuntimeDataSource, m as HostRuntimeDegradeReason, o as HostRuntimePolicy, p as HostRuntimePresentationFetcher, q as HostRuntimePresentationRequest, s as HostRuntimeSources, t as HostRuntimeStatus, u as HostRuntimeWarning, v as HostTokenPresentation, M as ManifestBindingEntry, w as ManifestExternalContract, O as OracleProvision, x as OracleReadRequest, y as OracleReader, P as PaymentToken, R as RuntimeOracleRegistry, S as SimulateResult, T as TokenMarketPhase, D as TxReceipt, V as VaultComponentProps, G as VaultHostContext, I as VaultManifest, J as VaultRenderSurface, L as VaultRuntimeContextOverrides, N as VaultRuntimeExtraConfig } from './types-DzTX2u7q.mjs';
+export { C as CreateTaxInfoHostContextInput, O as OracleReadError, R as ResolveRenderSurfaceInput, a as RuntimeMatchInput, T as TaxVaultHostSnapshot, b as TxErrorKind, V as VaultBindingPolicy, Z as ZERO_ADDRESS, c as buildLocalOracleUrl, d as createLocalOracleReader, e as createTaxInfoHostContext, f as fetchOracleJson, g as fetchProvisionedOracle, h as formatCountdown, i as formatPercentBps, j as formatTokenAmount, k as getTupleField, l as getTxErrorKind, m as handleTxError, n as isActionAvailableForPhase, o as isCustomVaultTaxToken, p as isManifestRuntimeMatch, q as isSameAddress, r as isValidAddress, s as isVaultBindingMatch, t as normalizeAddress, u as parseFeeVaultInfo, v as parsePortalTokenInfo, w as parseTaxTokenInfo, x as parseTokenAmount, y as parseVaultPortalInfo, z as readTaxVaultHostContext, A as resolveFeeMode, B as resolveManifestBinding, D as resolveTaxInfoRenderSurface, E as resolveTokenMarketPhase, F as resolveVaultBinding, G as shortenAddress, H as standardErc20Abi } from './txError-BmDt5Z4B.mjs';
 import { PublicClient } from 'viem';
 export { erc20Abi } from 'viem';
-export { T as TaxVaultHostChainConfig, g as getTaxVaultHostChainConfig } from './hostRuntimeConfig-BOEJo2nq.mjs';
+export { T as TaxVaultHostChainConfig, g as getTaxVaultHostChainConfig } from './hostRuntimeConfig-8d2c6qsO.mjs';
 
 declare function readErc20TokenMetadata(publicClient: PublicClient, tokenAddress?: Address | null): Promise<TokenMetadataSnapshot | null>;
 declare function loadTokenRuntimeSnapshot(publicClient: PublicClient, chainId: number, tokenAddress?: Address | null): Promise<TokenRuntimeSnapshot | null>;

package/host.js

@@ -28,9 +28,11 @@ function formatCountdown(targetTimeMs) {
   if (!targetTimeMs) return "-";
   const diff = Math.max(0, targetTimeMs - Date.now());
   const totalSeconds = Math.floor(diff / 1e3);
-  const hours = Math.floor(totalSeconds / 3600);
+  const days = Math.floor(totalSeconds / 86400);
+  const hours = Math.floor(totalSeconds % 86400 / 3600);
   const minutes = Math.floor(totalSeconds % 3600 / 60);
   const seconds = totalSeconds % 60;
+  if (days > 0) return `${days}d ${hours}h ${minutes}m`;
   if (hours > 0) return `${hours}h ${minutes}m ${seconds}s`;
   return `${minutes}m ${seconds}s`;
 }
@@ -181,26 +183,52 @@ function resolveManifestBinding(manifest, input) {
     if (candidates.length === 1) return candidates[0];
     return null;
   };
-  if (input.chainId && input.factoryAddress) {
-    return resolveUnique(bindings.filter((binding) => binding.chainId === input.chainId && isSameAddress(binding.factoryAddress, input.factoryAddress)));
+  const matchesChain = (binding) => !input.chainId || binding.chainId === input.chainId;
+  const matchesToken = (binding) => !input.tokenAddress || !binding.tokenAddresses?.length || binding.tokenAddresses.some((address) => isSameAddress(address, input.tokenAddress));
+  const isVaultScopedBinding = (binding) => !binding.factoryAddress && Boolean(binding.vaultAddresses?.length);
+  if (input.factoryAddress) {
+    const factoryMatch = resolveUnique(
+      bindings.filter((binding) => matchesChain(binding) && Boolean(binding.factoryAddress) && isSameAddress(binding.factoryAddress, input.factoryAddress) && matchesToken(binding))
+    );
+    if (factoryMatch || !input.vaultAddress) return factoryMatch;
+  }
+  if (input.vaultAddress) {
+    const vaultMatch = resolveUnique(
+      bindings.filter(
+        (binding) => matchesChain(binding) && isVaultScopedBinding(binding) && Boolean(binding.vaultAddresses?.some((address) => isSameAddress(address, input.vaultAddress))) && matchesToken(binding)
+      )
+    );
+    if (vaultMatch) return vaultMatch;
+  }
+  if (input.factoryAddress || input.vaultAddress) {
+    return null;
   }
   if (input.chainId) {
-    return resolveUnique(bindings.filter((binding) => binding.chainId === input.chainId));
+    return resolveUnique(bindings.filter((binding) => binding.chainId === input.chainId && matchesToken(binding)));
   }
-  if (input.factoryAddress) {
-    return resolveUnique(bindings.filter((binding) => isSameAddress(binding.factoryAddress, input.factoryAddress)));
+  if (input.tokenAddress) {
+    return resolveUnique(bindings.filter((binding) => binding.tokenAddresses?.some((address) => isSameAddress(address, input.tokenAddress))));
   }
   return null;
 }
 function isManifestRuntimeMatch(manifest, input) {
-  if (!input.chainId || !input.factoryAddress) return false;
+  if (!input.chainId || !input.factoryAddress && !input.vaultAddress) return false;
   const matchingBinding = resolveManifestBinding(manifest, input);
   if (!matchingBinding) return false;
-  return matchingBinding.chainId === input.chainId && isSameAddress(matchingBinding.factoryAddress, input.factoryAddress);
+  if (matchingBinding.chainId !== input.chainId) return false;
+  if (matchingBinding.factoryAddress) return isSameAddress(matchingBinding.factoryAddress, input.factoryAddress);
+  const vaultAddress = matchingBinding.vaultAddresses?.[0];
+  if (!vaultAddress || !isSameAddress(vaultAddress, input.vaultAddress)) return false;
+  if (input.tokenAddress && matchingBinding.tokenAddresses?.length) {
+    return matchingBinding.tokenAddresses.some((address) => isSameAddress(address, input.tokenAddress));
+  }
+  return true;
 }
 function isVaultBindingMatch(binding, input) {
   if (!input.chainId || binding.chainId !== input.chainId) return false;
-  if (!input.factoryAddress || !isSameAddress(binding.factoryAddress, input.factoryAddress)) return false;
+  if (binding.factoryAddress) return Boolean(input.factoryAddress && isSameAddress(binding.factoryAddress, input.factoryAddress));
+  const vaultAddress = binding.vaultAddresses?.[0];
+  if (!vaultAddress || !input.vaultAddress || !isSameAddress(vaultAddress, input.vaultAddress)) return false;
   return true;
 }
 function resolveVaultBinding(bindings, input) {
@@ -482,8 +510,15 @@ async function readErc20TokenMetadata(publicClient, tokenAddress) {
 }
 async function loadTokenRuntimeSnapshot(publicClient, chainId, tokenAddress) {
   if (!tokenAddress || !isValidAddress(tokenAddress) || tokenAddress === ZERO_ADDRESS) return null;
-  const metadata = await readErc20TokenMetadata(publicClient, tokenAddress);
   const chainConfig = getTaxVaultHostChainConfig(chainId);
+  const metadataPromise = readErc20TokenMetadata(publicClient, tokenAddress);
+  const portalPromise = chainConfig ? publicClient.readContract({
+    address: chainConfig.portal,
+    abi: portalAbi,
+    functionName: "getTokenV7",
+    args: [tokenAddress]
+  }).then((data) => ({ ok: true, data })).catch(() => ({ ok: false })) : Promise.resolve(null);
+  const [metadata, portalResult] = await Promise.all([metadataPromise, portalPromise]);
   const baseSnapshot = {
     tokenSymbol: metadata?.tokenSymbol,
     tokenName: metadata?.tokenName,
@@ -497,15 +532,7 @@ async function loadTokenRuntimeSnapshot(publicClient, chainId, tokenAddress) {
       hostReadFromChain: false
     };
   }
-  let tokenData;
-  try {
-    tokenData = await publicClient.readContract({
-      address: chainConfig.portal,
-      abi: portalAbi,
-      functionName: "getTokenV7",
-      args: [tokenAddress]
-    });
-  } catch {
+  if (!portalResult || !portalResult.ok) {
     return {
       ...baseSnapshot,
       hasTaxVaults: Boolean(chainConfig.vaultPortal),
@@ -514,6 +541,7 @@ async function loadTokenRuntimeSnapshot(publicClient, chainId, tokenAddress) {
       giftVaultFactory: chainConfig.giftVaultFactory
     };
   }
+  const tokenData = portalResult.data;
   const tokenInfo = parsePortalTokenInfo(tokenData);
   const hasTaxVaults = Boolean(chainConfig.vaultPortal);
   if (!tokenInfo) {
@@ -607,8 +635,8 @@ function resolveAddresses(input, snapshot) {
     tokenAddress: input.tokenAddress,
     factoryAddressHint: input.factoryAddressHint,
     vaultAddressHint: input.vaultAddressHint,
-    factoryAddress: pickAddress(input.factoryAddressHint, snapshot?.vaultInfo?.vaultFactory, snapshot?.taxInfo?.vaultInfo?.factory ?? void 0),
-    vaultAddress: pickAddress(input.vaultAddressHint, snapshot?.vaultInfo?.vault, snapshot?.taxInfo?.vaultInfo?.addr ?? void 0)
+    factoryAddress: pickAddress(snapshot?.vaultInfo?.vaultFactory, snapshot?.taxInfo?.vaultInfo?.factory ?? void 0, input.factoryAddressHint),
+    vaultAddress: pickAddress(snapshot?.vaultInfo?.vault, snapshot?.taxInfo?.vaultInfo?.addr ?? void 0, input.vaultAddressHint)
   };
 }
 function hasPresentationMetadata(result) {
@@ -700,11 +728,12 @@ async function runHostRuntime(input) {
   let presentationFailure;
   if (input.presentationFetcher) {
     try {
+      const resolvedAddrs = resolveAddresses(input, snapshot);
       presentation = await input.presentationFetcher({
         chainId: input.chainId,
         tokenAddress: input.tokenAddress,
-        factoryAddress: resolveAddresses(input, snapshot).factoryAddress,
-        vaultAddress: resolveAddresses(input, snapshot).vaultAddress,
+        factoryAddress: resolvedAddrs.factoryAddress,
+        vaultAddress: resolvedAddrs.vaultAddress,
         snapshot
       });
       if (!presentation) {
@@ -752,6 +781,73 @@ async function runHostRuntime(input) {
   return result;
 }
 
+// src/sdk/oracle.ts
+var DEFAULT_LOCAL_ORACLE_ENDPOINT_BASE = "/api/runtime/oracle";
+var OracleReadError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.name = "OracleReadError";
+    this.status = status;
+  }
+};
+function appendSearchParams(url, params) {
+  for (const [key, value] of Object.entries(params ?? {})) {
+    url.searchParams.set(key, value);
+  }
+}
+function toOracleProvision(provision) {
+  return typeof provision === "string" ? { endpoint: provision } : provision;
+}
+function buildLocalOracleUrl(oracleId, params, endpointBase = DEFAULT_LOCAL_ORACLE_ENDPOINT_BASE) {
+  const normalizedBase = endpointBase.replace(/\/+$/, "");
+  const url = new URL(`${normalizedBase}/${encodeURIComponent(oracleId)}`, "http://localhost");
+  appendSearchParams(url, params);
+  return `${url.pathname}${url.search}`;
+}
+async function fetchOracleJson({
+  endpoint,
+  params,
+  fetchImpl,
+  headers
+}) {
+  const fallbackOrigin = typeof window !== "undefined" ? window.location.origin : "http://localhost";
+  const url = new URL(endpoint, fallbackOrigin);
+  appendSearchParams(url, params);
+  const response = await (fetchImpl ?? fetch)(url.toString(), {
+    cache: "no-store",
+    headers,
+    method: "GET"
+  });
+  if (!response.ok) {
+    throw new OracleReadError(`Oracle request returned ${response.status}.`, response.status);
+  }
+  return await response.json();
+}
+async function fetchProvisionedOracle({
+  provision,
+  params,
+  fetchImpl
+}) {
+  const normalizedProvision = toOracleProvision(provision);
+  const filteredParams = normalizedProvision.allowedParams && normalizedProvision.allowedParams.length ? Object.fromEntries(Object.entries(params ?? {}).filter(([key]) => normalizedProvision.allowedParams?.includes(key))) : params;
+  return fetchOracleJson({
+    endpoint: normalizedProvision.endpoint,
+    params: filteredParams,
+    fetchImpl,
+    headers: normalizedProvision.headers
+  });
+}
+function createLocalOracleReader(options = {}) {
+  const endpointBase = options.endpointBase ?? DEFAULT_LOCAL_ORACLE_ENDPOINT_BASE;
+  const fetchImpl = options.fetchImpl;
+  return async function readLocalOracle({ oracleId, params }) {
+    return fetchOracleJson({
+      endpoint: buildLocalOracleUrl(oracleId, params, endpointBase),
+      fetchImpl
+    });
+  };
+}
+
 // src/sdk/runtimeContext.ts
 var zeroAddress = "0x0000000000000000000000000000000000000000";
 function explorerForChain(chainId) {
@@ -782,7 +878,9 @@ function createVaultRuntimeContext(input) {
   const runtimeOverrides = input.runtimeOverrides;
   const resolvedBinding = resolveManifestBinding(input.manifest, {
     chainId: runtimeOverrides?.chainId ?? input.connectedChainId ?? input.hostRuntimeResult?.addresses.chainId,
-    factoryAddress: runtimeOverrides?.factoryAddress ?? input.hostRuntimeResult?.addresses.factoryAddress
+    factoryAddress: runtimeOverrides?.factoryAddress ?? input.hostRuntimeResult?.addresses.factoryAddress,
+    vaultAddress: runtimeOverrides?.vaultAddress ?? input.hostRuntimeResult?.addresses.vaultAddress,
+    tokenAddress: runtimeOverrides?.tokenAddress ?? input.hostRuntimeResult?.addresses.tokenAddress
   });
   const effectiveChainId = runtimeOverrides?.chainId ?? input.hostRuntimeResult?.addresses.chainId ?? input.connectedChainId ?? resolvedBinding?.chainId ?? input.manifest.match.bindings[0]?.chainId ?? 56;
   return {
@@ -866,6 +964,6 @@ function handleTxError(error, messages) {
   return messages?.[kind] ?? defaultMessages[kind];
 }
 
-export { ZERO_ADDRESS, chainLabelForChain, createTaxInfoHostContext, createVaultRuntimeContext, explorerForChain, formatCountdown, formatPercentBps, formatTokenAmount, getTaxVaultHostChainConfig, getTupleField, getTxErrorKind, handleTxError, isActionAvailableForPhase, isCustomVaultTaxToken, isManifestRuntimeMatch, isSameAddress, isValidAddress, isVaultBindingMatch, loadTokenRuntimeSnapshot, normalizeAddress, parseFeeVaultInfo, parsePortalTokenInfo, parseTaxTokenInfo, parseTokenAmount, parseVaultPortalInfo, readErc20TokenMetadata, readTaxVaultHostContext, resolveFeeMode, resolveHostRuntimeAddresses, resolveManifestBinding, resolveTaxInfoRenderSurface, resolveTokenMarketPhase, resolveVaultBinding, runHostRuntime, shortenAddress, standardErc20Abi };
+export { OracleReadError, ZERO_ADDRESS, buildLocalOracleUrl, chainLabelForChain, createLocalOracleReader, createTaxInfoHostContext, createVaultRuntimeContext, explorerForChain, fetchOracleJson, fetchProvisionedOracle, formatCountdown, formatPercentBps, formatTokenAmount, getTaxVaultHostChainConfig, getTupleField, getTxErrorKind, handleTxError, isActionAvailableForPhase, isCustomVaultTaxToken, isManifestRuntimeMatch, isSameAddress, isValidAddress, isVaultBindingMatch, loadTokenRuntimeSnapshot, normalizeAddress, parseFeeVaultInfo, parsePortalTokenInfo, parseTaxTokenInfo, parseTokenAmount, parseVaultPortalInfo, readErc20TokenMetadata, readTaxVaultHostContext, resolveFeeMode, resolveHostRuntimeAddresses, resolveManifestBinding, resolveTaxInfoRenderSurface, resolveTokenMarketPhase, resolveVaultBinding, runHostRuntime, shortenAddress, standardErc20Abi };
 //# sourceMappingURL=host.js.map
 //# sourceMappingURL=host.js.map