@fileverse-dev/formulajs 4.4.11-mod-23 → 4.4.11-mod-24

package/lib/cjs/index.cjs

@@ -13104,13 +13104,17 @@ const ERROR_MESSAGES_FLAG = {
   MISSING_KEY: '_MISSING',
   INVALID_CHAIN: '_INVALID_CHAIN',
   INVALID_TYPE: '_INVALID_TYPE',
-  INVALID_ADDRESS: '_INVALID_ADDRESS'
+  INVALID_ADDRESS: '_INVALID_ADDRESS',
+  INVALID_PARAM: '_INVALID_PARAM'
 };
 
 const SERVICE_API_KEY = {
   Etherscan: "ETHERSCAN_API_KEY",
   Coingecko: "COINGECKO_API_KEY",
   Safe: "SAFE_API_KEY",
+  Basescan: "BASESCAN_API_KEY",
+  Gnosisscan: "GNOSIS_API_KEY",
+  Firefly: "FIRE_FLY_API_KEY"
 };
 
 const fromTimeStampToBlock = async (timestamp, chain, apiKey) => {
@@ -13123,6 +13127,131 @@ if(!timestamp || !chain || !apiKey) return
 
   };
 
+async function handleScanRequest({
+  scanKey,
+  baseUrl,
+  type,
+  chain,
+  address,
+  startDate,
+  endDate,
+}) {
+  const API_KEY = window.localStorage.getItem(scanKey);
+  if (!API_KEY) return `${scanKey}${ERROR_MESSAGES_FLAG.MISSING_KEY}`;
+  if (API_KEY === 'xxxx') return `${scanKey}${ERROR_MESSAGES_FLAG.RATE_LIMIT}`;
+
+  const chainId = CHAIN_ID_MAP[chain?.toLowerCase()];
+  if (!chainId) return `${scanKey}${ERROR_MESSAGES_FLAG.INVALID_CHAIN}`;
+
+  const ACTION_MAP = {
+    'all-txns': 'txlist',
+    'token-txns': 'tokentx',
+    'nft-txns': 'tokennfttx',
+    'gas': 'gastracker',
+  };
+
+  const action = ACTION_MAP[type];
+  if (!action) return `${scanKey}${ERROR_MESSAGES_FLAG.INVALID_TYPE}`;
+
+  let url = `${baseUrl}?chainid=${chainId}&module=account&action=${action}&apikey=${API_KEY}`;
+
+  if (['all-txns', 'token-txns', 'nft-txns'].includes(type)) {
+    if (!address) return `${scanKey}${ERROR_MESSAGES_FLAG.INVALID_ADDRESS}`;
+    url += `&address=${address}&startblock=0&endblock=99999999&sort=asc`;
+
+    if (!isNaN(startDate) && !isNaN(endDate)) {
+      const [startBlock, endBlock] = await Promise.all([
+        fromTimeStampToBlock(startDate, chain, API_KEY),
+        fromTimeStampToBlock(endDate, chain, API_KEY),
+      ]);
+      url += `&startblock=${startBlock}&endblock=${endBlock}`;
+    }
+  }
+
+  try {
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`HTTP error: ${res.status}`);
+    const json = await res.json();
+
+    if (typeof json.result === 'string') {
+      if (json.result.includes('Invalid API Key')) return `${scanKey}${ERROR_MESSAGES_FLAG.INVALID_API_KEY}`;
+      if (json.result.includes('Max rate limit reached')) return `${scanKey}${ERROR_MESSAGES_FLAG.RATE_LIMIT}`;
+    }
+
+    return json.result;
+  } catch (err) {
+    console.error(`[${scanKey}]`, err);
+    return ERROR_MESSAGES_FLAG.DEFAULT;
+  }
+}
+
+async function FIREFLY(platform, contentType, identifier) {
+  const API_KEY = window.localStorage.getItem(SERVICE_API_KEY.Firefly);
+  if (!API_KEY) return `${SERVICE_API_KEY.Firefly}${ERROR_MESSAGES_FLAG.MISSING_KEY}`;
+
+  const baseUrl = "https://openapi.firefly.land/v1/fileverse/fetch";
+  const headers = {
+    "x-api-key": API_KEY,
+  };
+
+  let query = "";
+  let type = "";
+
+  // normalize input
+  const normalizedId = identifier.trim().replace(/.*\/([^\/]+)$/, "$1"); // extract last part of URL if needed
+
+  if (platform === "farcaster") {
+    if (contentType === "posts") {
+      type = "farcasterid";
+      query = normalizedId;
+    } else if (contentType === "replies") {
+      type = "farcasterpostid";
+      query = normalizedId.startsWith("0x") ? normalizedId : Number(normalizedId).toString();
+    } else {
+      return `${SERVICE_API_KEY.Firefly}${ERROR_MESSAGES_FLAG.INVALID_TYPE}`;
+    }
+  } else if (platform === "lens") {
+    if (contentType === "posts") {
+      type = "lensid";
+      query = normalizedId;
+    } else if (contentType === "replies") {
+      type = "lenspostid";
+      query = normalizedId;
+    } else {
+      return `${SERVICE_API_KEY.Firefly}${ERROR_MESSAGES_FLAG.INVALID_TYPE}`;
+    }
+  } else {
+    return `${SERVICE_API_KEY.Firefly}${ERROR_MESSAGES_FLAG.INVALID_PARAM}`;
+  }
+
+  const url = new URL(baseUrl);
+  url.searchParams.set("query", query);
+  url.searchParams.set("type", type);
+  url.searchParams.set("size", "10");
+  url.searchParams.set("cursor", "0");
+
+  try {
+    const res = await fetch(url.toString(), { headers });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const json = await res.json();
+    const flattened = Array.isArray(json?.data)
+      ? json.data.map(item => ({
+          id: item?.id || null,
+          author: item?.author?.username || item?.author?.handle || "",
+          text: item?.text || item?.metadata?.content?.content || "",
+          createdAt: item?.createdAt || "",
+          platform: platform,
+        }))
+      : [];
+
+    return flattened;
+  } catch (err) {
+    console.error("FIREFLY fetch error:", err);
+    return ERROR_MESSAGES_FLAG.DEFAULT;
+  }
+}
+
+
 async function BLOCKSCOUT(address, type, chain, startTimestamp, endTimestamp, page, offset) {
   if (!chain) {
     chain = 'ethereum';
@@ -13192,73 +13321,146 @@ async function BLOCKSCOUT(address, type, chain, startTimestamp, endTimestamp, pa
   }
 }
 
-async function ETHERSCAN(...args) {
+async function BASESCAN(...args) {
+  const [type, chain, address, startDate, endDate] = args;
+  return handleScanRequest({
+    scanKey: SERVICE_API_KEY.Basescan,
+    baseUrl: 'https://api.basescan.org/api',
+    type,
+    chain,
+    address,
+    startDate,
+    endDate,
+  });
+}
+async function GNOSISSCAN(...args) {
   const [type, chain, address, startDate, endDate] = args;
+  return handleScanRequest({
+    scanKey: SERVICE_API_KEY.Gnosisscan,
+    baseUrl: 'https://api.gnosisscan.io/api',
+    type,
+    chain,
+    address,
+    startDate,
+    endDate,
+  });
+}
 
-  const API_KEY = window.localStorage.getItem(SERVICE_API_KEY.Etherscan);
-  if (!API_KEY) {
-    return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.MISSING_KEY}`;
-  }
-  // TO REMOVE - TEMORARY ADDED TO TEST RATE LIMIT FLOW
-  if (API_KEY === 'xxxx') {
-    return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.RATE_LIMIT}`;
-  }
+async function NEYNAR( 
+  fid, 
+  viewerFid, 
+  sortType, 
+  limit, 
+  cursor 
+) {
+  const API_KEY = window.localStorage.getItem(SERVICE_API_KEY.Neynar);
+  if (!API_KEY) return `${SERVICE_API_KEY.Neynar}${ERROR_MESSAGES_FLAG.MISSING_KEY}`;
 
-  const chainId = CHAIN_ID_MAP[chain?.toLowerCase()];
-  if (!chainId) {
-    return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.INVALID_CHAIN}`;
-  }
 
-  let action;
-  switch (type) {
-    case 'all-txns':
-      action = 'txlist';
-      break;
-    case 'token-txns':
-      action = 'tokentx';
-      break;
-    case 'nft-txns':
-      action = 'tokennfttx';
-      break;
-    case 'gas':
-      action = 'gastracker';
-      break;
-    default:
-      return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.INVALID_TYPE}`;
+  const url = new URL('https://api.neynar.com/v2/farcaster/followers');
+  url.searchParams.set('fid', fid.toString());
+  url.searchParams.set('sort_type', sortType);
+  url.searchParams.set('limit', limit.toString());
+  if (viewerFid !== null) url.searchParams.set('viewer_fid', viewerFid.toString());
+  if (cursor) url.searchParams.set('cursor', cursor);
+
+  try {
+    const response = await fetch(url.toString(), {
+      headers: {
+        'x-api-key': API_KEY,
+        'x-neynar-experimental': 'false'
+      }
+    });
+    if (!response.ok) throw new Error(`HTTP ${response.status}`);
+    const json = await response.json();
+    if (!json?.users?.length) return [];
+
+    return json.users.map(({ user }) => ({
+      username: user.username,
+      custody_address: user.custody_address,
+      follower_count: user.follower_count,
+      country: user.profile?.location?.address?.country || '',
+      city: user.profile?.location?.address?.city || ''
+    }));
+  } catch (err) {
+    console.error('NEYNAR_FETCH_FOLLOWERS error:', err);
+    return ERROR_MESSAGES_FLAG.DEFAULT;
   }
+}
+async function GNOSIS({
+  cardId,
+  startDate,
+  endDate,
+  limit = 20,
+  offset = 0,
+}) {
+  const apiKeyKey = SERVICE_API_KEY.GnosisPay;
+  const API_KEY = window.localStorage.getItem(apiKeyKey);
+  if (!API_KEY) return `${apiKeyKey}${ERROR_MESSAGES_FLAG.MISSING_KEY}`;
+  if (!cardId) return `${apiKeyKey}${ERROR_MESSAGES_FLAG.INVALID_PARAM}`;
 
-  let url = `https://api.etherscan.io/v2/api?chainid=${chainId}&module=account&action=${action}&apikey=${API_KEY}`;
+  const url = new URL(`https://api.gnosispay.com/cards/${cardId}/transactions`);
+  url.searchParams.set('limit', limit.toString());
+  url.searchParams.set('offset', offset.toString());
 
-  if (['all-txns', 'token-txns', 'nft-txns'].includes(type)) {
-    if (!address) return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.INVALID_ADDRESS}`;
-    url += `&address=${address}&startblock=0&endblock=99999999&sort=asc`;
-    if (startDate && endDate && !isNaN(startDate) && !isNaN(endDate)) {
-      const startBlock = await fromTimeStampToBlock(startDate, chain, API_KEY);
-      const endBlock = await fromTimeStampToBlock(endDate, chain, API_KEY);
-      url += `&startblock=${startBlock}&endblock=${endBlock}`;
-    }
+  if (!isNaN(startDate)) {
+    url.searchParams.set('startDate', new Date(startDate * 1000).toISOString());
   }
 
-  try {
-    const response = await fetch(url);
-    if (!response.ok) throw new Error(`HTTP error! Status: ${response.status}`);
-    const json = await response.json();
-
-    if (typeof json.result === 'string' && json.result.includes('Invalid API Key')) {
-      return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.INVALID_API_KEY}`;
-    }
+  if (!isNaN(endDate)) {
+    url.searchParams.set('endDate', new Date(endDate * 1000).toISOString());
+  }
 
-    if (typeof json.result === 'string' && json.result.includes('Max rate limit reached')) {
-      return `${SERVICE_API_KEY.Etherscan}${ERROR_MESSAGES_FLAG.RATE_LIMIT}`;
-    }
+  try {
+    const res = await fetch(url.toString(), {
+      headers: {
+        Authorization: `Bearer ${API_KEY}`,
+        'Content-Type': 'application/json',
+      },
+    });
 
-    return json.result;
-  } catch (error) {
+    if (!res.ok) throw new Error(`HTTP error! Status: ${res.status}`);
+
+    const json = await res.json();
+
+    if (!Array.isArray(json)) return [];
+
+    return json.map(tx => ({
+      createdAt: tx.createdAt,
+      clearedAt: tx.clearedAt,
+      country: tx.country,
+      merchant: tx.merchant,
+      billingAmount: tx.billingAmount,
+      billingCurrency: tx.billingCurrency,
+      transactionAmount: tx.transactionAmount,
+      transactionCurrency: tx.transactionCurrency,
+      transactionType: tx.transactionType,
+      kind: tx.kind,
+      status: tx.status || null,
+      mcc: tx.mcc,
+    }));
+  } catch (err) {
+    console.error('GNOSISPAY_CARD_TXNS error:', err);
     return ERROR_MESSAGES_FLAG.DEFAULT;
   }
 }
 
 
+
+async function ETHERSCAN(...args) {
+  const [type, chain, address, startDate, endDate] = args;
+  return handleScanRequest({
+    scanKey: SERVICE_API_KEY.Etherscan,
+    baseUrl: 'https://api.etherscan.io/v2/api',
+    type,
+    chain,
+    address,
+    startDate,
+    endDate,
+  });
+}
+
+
 async function COINGECKO(token, vs_currencies) {
   const API_KEY = window.localStorage.getItem(SERVICE_API_KEY.Coingecko);
   const url = `https://api.coingecko.com/api/v3/simple/price?vs_currencies=${vs_currencies}&ids=${token}`;
@@ -13429,6 +13631,7 @@ exports.AVERAGEA = AVERAGEA;
 exports.AVERAGEIF = AVERAGEIF;
 exports.AVERAGEIFS = AVERAGEIFS;
 exports.BASE = BASE;
+exports.BASESCAN = BASESCAN;
 exports.BESSELI = BESSELI;
 exports.BESSELJ = BESSELJ;
 exports.BESSELK = BESSELK;
@@ -13545,6 +13748,7 @@ exports.FDISTRT = FDISTRT;
 exports.FIND = FIND;
 exports.FINV = FINV;
 exports.FINVRT = FINVRT;
+exports.FIREFLY = FIREFLY;
 exports.FISHER = FISHER;
 exports.FISHERINV = FISHERINV;
 exports.FIXED = FIXED;
@@ -13566,6 +13770,8 @@ exports.GAUSS = GAUSS;
 exports.GCD = GCD;
 exports.GEOMEAN = GEOMEAN;
 exports.GESTEP = GESTEP;
+exports.GNOSIS = GNOSIS;
+exports.GNOSISSCAN = GNOSISSCAN;
 exports.GROWTH = GROWTH;
 exports.HARMEAN = HARMEAN;
 exports.HEX2BIN = HEX2BIN;
@@ -13666,6 +13872,7 @@ exports.NEGBINOMDIST = NEGBINOMDIST;
 exports.NETWORKDAYS = NETWORKDAYS;
 exports.NETWORKDAYSINTL = NETWORKDAYSINTL;
 exports.NETWORKDAYS_INTL = NETWORKDAYS_INTL;
+exports.NEYNAR = NEYNAR;
 exports.NOMINAL = NOMINAL;
 exports.NORM = NORM;
 exports.NORMDIST = NORMDIST;

package/lib/esm/crypto-constants.mjs

@@ -23,16 +23,135 @@ var ERROR_MESSAGES_FLAG = {
   MISSING_KEY: "_MISSING",
   INVALID_CHAIN: "_INVALID_CHAIN",
   INVALID_TYPE: "_INVALID_TYPE",
-  INVALID_ADDRESS: "_INVALID_ADDRESS"
+  INVALID_ADDRESS: "_INVALID_ADDRESS",
+  INVALID_PARAM: "_INVALID_PARAM"
 };
 
 // src/crypto-constants.js
 var SERVICE_API_KEY = {
   Etherscan: "ETHERSCAN_API_KEY",
   Coingecko: "COINGECKO_API_KEY",
-  Safe: "SAFE_API_KEY"
+  Safe: "SAFE_API_KEY",
+  Basescan: "BASESCAN_API_KEY",
+  Gnosisscan: "GNOSIS_API_KEY",
+  Firefly: "FIRE_FLY_API_KEY"
 };
 var FUNCTION_LOCALE = [
+  {
+    API_KEY: SERVICE_API_KEY.Firefly,
+    LOGO: "https://firefly.social/android-chrome-192x192.png",
+    BRAND_COLOR: "#f8f5fc",
+    BRAND_SECONDARY_COLOR: "#855dcd",
+    n: "FIREFLY",
+    t: 20,
+    d: "Fetches posts or replies from Farcaster or Lens using Firefly's OpenAPI and returns simplified text content.",
+    a: "Retrieves posts or replies from Firefly OpenAPI by username, user ID, or post ID/hash for Farcaster and Lens platforms. Returns a flattened array of content with id, author, text, createdAt, and platform.",
+    p: [
+      {
+        name: "platform",
+        detail: "The social platform to query. Supports 'farcaster' or 'lens'.",
+        example: `"farcaster"`,
+        require: "m",
+        type: "string"
+      },
+      {
+        name: "contentType",
+        detail: "The type of content to fetch. Can be 'posts' or 'replies'.",
+        example: `"posts"`,
+        require: "m",
+        type: "string"
+      },
+      {
+        name: "identifier",
+        detail: "The username, user ID, or post ID/hash depending on platform and contentType.",
+        example: `"toka" or "0xcb6cab2048..."`,
+        require: "m",
+        type: "string"
+      }
+    ]
+  },
+  {
+    API_KEY: SERVICE_API_KEY.Neynar,
+    LOGO: "https://framerusercontent.com/images/OS5YeZ2Y7DmszAxL6Zf06pXtKzc.svg",
+    BRAND_COLOR: "##e8e6ff",
+    BRAND_SECONDARY_COLOR: "#28204A",
+    n: "NEYNAR",
+    t: 20,
+    d: "Fetches followers for a given Farcaster FID using Neynar's API.",
+    a: "Retrieves followers of a Farcaster user, with support for sorting, pagination, and optional viewer context.",
+    p: [
+      {
+        name: "fid",
+        detail: "The Farcaster FID of the user whose followers should be fetched.",
+        example: `123`,
+        require: "m",
+        type: "number"
+      },
+      {
+        name: "viewerFid",
+        detail: "FID of the viewer, to include contextual info like mutual follows (optional).",
+        example: `456`,
+        require: "o",
+        type: "number"
+      },
+      {
+        name: "sortType",
+        detail: "Sorting type: either 'desc_chron' (default) or 'algorithmic'.",
+        example: `"desc_chron"`,
+        require: "o",
+        type: "string"
+      },
+      {
+        name: "limit",
+        detail: "Number of followers to return (max 100).",
+        example: `20`,
+        require: "o",
+        type: "number"
+      },
+      {
+        name: "cursor",
+        detail: "Cursor string for paginating the result set.",
+        example: `"eyJvZmZzZXQiOjIwLCJsYXN0SWQiOjEyMzQ1Nn0="`,
+        require: "o",
+        type: "string"
+      }
+    ]
+  },
+  {
+    API_KEY: SERVICE_API_KEY.Basescan,
+    LOGO: "https://raw.githubusercontent.com/mritunjayz/github-storage/refs/heads/main/1689874988430.jpeg",
+    // public Base logo
+    BRAND_COLOR: "#f1f5ff",
+    BRAND_SECONDARY_COLOR: "#2752ff",
+    n: "BASESCAN",
+    t: 20,
+    d: "Fetches Base network data via Basescan: native txns, ERC-20 transfers, ERC-721 transfers, and gas metrics.",
+    a: "Pulls on-chain activity for Base (chainid 8453) using Basescan\u2019s API \u2014 supports full tx history, token/NFT transfers, and live gas info.",
+    p: [
+      { name: "type", detail: "Data category: 'all-txns' | 'token-txns' | 'nft-txns' | 'gas'.", example: `"token-txns"`, require: "m", type: "string" },
+      { name: "chain", detail: "Must be 'base'.", example: `"base"`, require: "m", type: "string" },
+      { name: "address", detail: "Target wallet (omit for 'gas').", example: `"0x1234\u2026abcd"`, require: "o", type: "string" },
+      { name: "startDate", detail: "Start UNIX timestamp (sec).", example: `"1704067200"`, require: "o", type: "rangenumber" },
+      { name: "endDate", detail: "End UNIX timestamp (sec).", example: `"1706659200"`, require: "o", type: "rangenumber" }
+    ]
+  },
+  {
+    API_KEY: SERVICE_API_KEY.Gnosisscan,
+    LOGO: "https://raw.githubusercontent.com/mritunjayz/github-storage/refs/heads/main/1689874988430.jpeg",
+    BRAND_COLOR: "#f6f7f6",
+    BRAND_SECONDARY_COLOR: "#133629",
+    n: "GNOSISSCAN",
+    t: 20,
+    d: "Fetches Gnosis Chain data via Gnosisscan: txns, token transfers, NFT transfers, and gas metrics.",
+    a: "Queries Gnosis Chain (chainid 100) through Gnosisscan\u2019s API to return txns, token/NFT transfers, or gas info for a wallet.",
+    p: [
+      { name: "type", detail: "Data category: 'all-txns' | 'token-txns' | 'nft-txns' | 'gas'.", example: `"nft-txns"`, require: "m", type: "string" },
+      { name: "chain", detail: "Must be 'gnosis'.", example: `"gnosis"`, require: "m", type: "string" },
+      { name: "address", detail: "Target wallet (omit for 'gas').", example: `"0x6789\u2026efab"`, require: "o", type: "string" },
+      { name: "startDate", detail: "Start UNIX timestamp (sec).", example: `"1704067200"`, require: "o", type: "rangenumber" },
+      { name: "endDate", detail: "End UNIX timestamp (sec).", example: `"1706659200"`, require: "o", type: "rangenumber" }
+    ]
+  },
   {
     LOGO: "https://cdn.prod.website-files.com/65f94dfd53db8b337c808067/68485baa72714ae58f350ce2_bs-logo.png",
     BRAND_COLOR: "#f8f8fd",
@@ -583,7 +702,7 @@ var FUNCTION_LOCALE = [
   },
   {
     API_KEY: SERVICE_API_KEY.Etherscan,
-    LOGO: "https://safe-transaction-mainnet.safe.global/static/safe/favicon.png",
+    LOGO: "https://gnosisscan.io/assets/generic/html/favicon-light.ico",
     BRAND_COLOR: "#f6f7f6",
     BRAND_SECONDARY_COLOR: "#133629",
     n: "GNOSIS",