@reality.eth/contracts 3.2.25 → 3.2.26

package/scripts/generate_ponder_config.js

@@ -0,0 +1,222 @@
+/**
+ * Generates packages/ponder/ponder.config.ts from packages/contracts/generated/contracts.json.
+ * Chain names are derived from the network_name field in generated/chains.json (populated from
+ * chains/supported.json and chainlist.org data).
+ *
+ * Usage:
+ *   cd packages/contracts && node scripts/generate_ponder_config.js
+ */
+
+'use strict';
+const fs   = require('fs');
+const path = require('path');
+
+const projectBase = path.resolve(__dirname, '..');
+const ponderPkg   = path.resolve(projectBase, '../ponder');
+const contracts   = JSON.parse(fs.readFileSync(path.join(projectBase, 'generated/contracts.json'), 'utf8'));
+const chains      = JSON.parse(fs.readFileSync(path.join(projectBase, 'generated/chains.json'),    'utf8'));
+
+// Ponder chain name derived from chains.json network_name:
+// lowercase, hyphens/spaces → underscores. Falls back to "chain_{id}".
+function cname(id) {
+  const nn = chains[id] && chains[id].network_name;
+  if (!nn) return `chain_${id}`;
+  return nn.toLowerCase().replace(/[-\s.]+/g, '_');
+}
+
+// Polling intervals (ms) keyed by chain ID.
+// Derived from block time, but capped to avoid excessive RPC calls on fast chains.
+const POLL_MS = {
+  1:        12_000,
+  4:        15_000,
+  5:        15_000,
+  8:        30_000,
+  10:       30_000,
+  40:       30_000,
+  56:        3_000,
+  69:       15_000,
+  77:       15_000,
+  97:        3_000,
+  100:       5_000,
+  130:       8_000,
+  137:      15_000,
+  143:      10_000,
+  280:      15_000,
+  300:      30_000,
+  324:      30_000,
+  534353:   15_000,
+  690:      30_000,
+  777:      15_000,
+  1101:     30_000,
+  1301:     10_000,
+  1337702:  15_000,
+  8453:     30_000,
+  10200:    15_000,
+  17000:    30_000,
+  42161:   300_000,  // Arbitrum produces blocks very fast; poll slowly to avoid RPC hammering
+  42220:    30_000,
+  43114:    30_000,
+  80001:    15_000,
+  84532:    30_000,
+  421611:   15_000,
+  421613:   30_000,
+  421614:   30_000,
+  11155111: 30_000,
+  11155420: 30_000,
+  88558801: 10_000,
+};
+
+const cpoll = id => POLL_MS[id] || 15_000;
+// Format a number with _ as thousands separator (e.g. 12000 → "12_000")
+const fnum  = n => String(n).replace(/\B(?=(\d{3})+(?!\d))/g, '_');
+
+// Versions to skip entirely (arbitrators, release candidates)
+const SKIP_VERSIONS = new Set(['Arbitrator', 'Arbitrator_RealityETH-2.1', 'RealityETH-2.1-rc1']);
+
+// Convert a native version string to a ponder contract name (null = skip)
+function nativePonderName(ver) {
+  if (SKIP_VERSIONS.has(ver)) return null;
+  const m = ver.match(/^RealityETH-(\d+)\.(\d+)$/);
+  return m ? `RealityETH_v${m[1]}_${m[2]}` : null;
+}
+
+const isERC20 = ver => ver.startsWith('RealityETH_ERC20-');
+
+// ── Collect data ──────────────────────────────────────────────────────────────
+
+// native: ponderName → { chainId → [ { address, block } ] }
+// (array because a chain can have multiple tokens for the same version, e.g. Scroll Alpha ETH+SETH)
+const native  = {};
+// erc20: chainId → [ { address, block } ]
+const erc20   = {};
+const chainIds = new Set();
+
+for (const [cidStr, byToken] of Object.entries(contracts)) {
+  const cid = Number(cidStr);
+  for (const byVersion of Object.values(byToken)) {
+    for (const [ver, data] of Object.entries(byVersion)) {
+      if (!data.address) continue;
+      if (isERC20(ver)) {
+        if (!erc20[cid]) erc20[cid] = [];
+        erc20[cid].push({ address: data.address, block: data.block || 0 });
+        chainIds.add(cid);
+      } else {
+        const pn = nativePonderName(ver);
+        if (!pn) continue;
+        if (!native[pn]) native[pn] = {};
+        if (!native[pn][cid]) native[pn][cid] = [];
+        native[pn][cid].push({ address: data.address, block: data.block || 0 });
+        chainIds.add(cid);
+      }
+    }
+  }
+}
+
+// ── Sort order ────────────────────────────────────────────────────────────────
+
+// Priority chains come first in output (major production chains)
+const PRIORITY_CHAINS = [1, 100, 10, 8453, 42161, 56, 130, 137, 11155111];
+const sortedCids = [...chainIds].sort((a, b) => {
+  const ai = PRIORITY_CHAINS.indexOf(a), bi = PRIORITY_CHAINS.indexOf(b);
+  if (ai >= 0 && bi >= 0) return ai - bi;
+  if (ai >= 0) return -1;
+  if (bi >= 0) return 1;
+  return a - b;
+});
+
+// Preferred version output order
+const VER_ORDER = ['RealityETH_v3_2', 'RealityETH_v3_0', 'RealityETH_v2_1', 'RealityETH_v2_0'];
+const sortedNative = Object.keys(native).sort((a, b) => {
+  const ai = VER_ORDER.indexOf(a), bi = VER_ORDER.indexOf(b);
+  if (ai >= 0 && bi >= 0) return ai - bi;
+  if (ai >= 0) return -1;
+  if (bi >= 0) return 1;
+  return a.localeCompare(b);
+});
+
+// ── Build output lines ────────────────────────────────────────────────────────
+
+const lines = [];
+const p = (...args) => lines.push(...args);
+
+p(
+  '// AUTO-GENERATED by packages/contracts/scripts/generate_ponder_config.js',
+  '// Do not edit by hand — run `cd packages/contracts && npm run generate-ponder-config`',
+  'import { createConfig } from "ponder";',
+  'import type { Abi } from "abitype";',
+  'import rawAbi from "@reality.eth/contracts/abi/solc-0.8.6/RealityETH-3.2.abi.json";',
+  'const abi = rawAbi as unknown as Abi;',
+  '',
+);
+
+// Use double-quoted strings so ${id} is literal in the TypeScript output
+p(
+  "const has = (id: number) => !!process.env[`PONDER_RPC_URL_${id}`];",
+  "const rpc = (id: number) => process.env[`PONDER_RPC_URL_${id}`] as string;",
+  "const rps = (id: number) => process.env[`PONDER_RPC_MAX_RPS_${id}`] ? { maxRequestsPerSecond: Number(process.env[`PONDER_RPC_MAX_RPS_${id}`]) } : {};",
+  '',
+  'export default createConfig({',
+  '  chains: {',
+);
+
+for (const cid of sortedCids) {
+  const n    = cname(cid);
+  const pi   = fnum(cpoll(cid));
+  p(`    ...(has(${cid}) && { ${n}: { id: ${cid}, rpc: rpc(${cid}), pollingInterval: ${pi}, ...rps(${cid}) } }),`);
+}
+
+p('  },', '  contracts: {');
+
+// Native contracts
+for (const pn of sortedNative) {
+  const chainMap     = native[pn];
+  const relevantCids = sortedCids.filter(cid => chainMap[cid]);
+  if (!relevantCids.length) continue;
+
+  const guardExpr = relevantCids.length === 1
+    ? `has(${relevantCids[0]})`
+    : `(${relevantCids.map(c => `has(${c})`).join(' || ')})`;
+
+  p(`    ...(${guardExpr} && { ${pn}: {`);
+  p(`      abi,`);
+  p(`      chain: {`);
+  for (const cid of relevantCids) {
+    const entries    = chainMap[cid].sort((a, b) => a.block - b.block);
+    const startBlock = entries[0].block;
+    const addrVal    = entries.length === 1
+      ? `"${entries[0].address}"`
+      : `[\n          ${entries.map(e => `"${e.address}"`).join(',\n          ')},\n        ]`;
+    p(`        ...(has(${cid}) && { ${cname(cid)}: { address: ${addrVal}, startBlock: ${startBlock} } }),`);
+  }
+  p(`      },`);
+  p(`    }}),`);
+  p('');
+}
+
+// ERC20 contracts, grouped by chain
+for (const cid of sortedCids) {
+  if (!erc20[cid]) continue;
+  const sorted       = [...erc20[cid]].sort((a, b) => a.block - b.block);
+  const n            = cname(cid);
+  const contractName = `RealityETH_ERC20_${n}`;
+  const startBlock   = sorted[0].block;
+  const addrVal      = sorted.length === 1
+    ? `"${sorted[0].address}"`
+    : `[\n          ${sorted.map(x => `"${x.address}"`).join(',\n          ')},\n        ]`;
+
+  p(`    ...(has(${cid}) && { ${contractName}: {`);
+  p(`      abi,`);
+  p(`      chain: {`);
+  p(`        ${n}: { address: ${addrVal}, startBlock: ${startBlock} },`);
+  p(`      },`);
+  p(`    }}),`);
+  p('');
+}
+
+p('  },', '});', '');
+
+// ── Write ─────────────────────────────────────────────────────────────────────
+
+const outPath = path.join(ponderPkg, 'ponder.config.ts');
+fs.writeFileSync(outPath, lines.join('\n'));
+console.log('Wrote', outPath);

package/scripts/generate_website_data.js

@@ -0,0 +1,68 @@
+/*
+ * Bundles all website data files into a single JS file that can be loaded
+ * as a <script> tag, enabling the site to run from file:// (IPFS).
+ *
+ * Usage:
+ *   node scripts/generate_website_data.js           # writes to generated/website-data.js
+ *   node scripts/generate_website_data.js --install # also copies to packages/frontend/webroot/js/
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const project_base = path.resolve(__dirname, '..');
+const webroot = path.resolve(project_base, '../../packages/frontend/webroot');
+const install = process.argv.includes('--install');
+
+const chains       = JSON.parse(fs.readFileSync(path.join(project_base, 'generated/chains.json'),    'utf8'));
+const contracts    = JSON.parse(fs.readFileSync(path.join(project_base, 'generated/contracts.json'), 'utf8'));
+const factories    = JSON.parse(fs.readFileSync(path.join(project_base, 'generated/factories.json'), 'utf8'));
+const tokens       = JSON.parse(fs.readFileSync(path.join(project_base, 'generated/tokens.json'),    'utf8'));
+const integrations = JSON.parse(fs.readFileSync(path.join(webroot,       'integrations.json'),        'utf8'));
+
+// Flat map: chainId (string) → native token symbol. Covers all chains in chains.json.
+const nativeTokenByChain = {};
+for (const [chainId, chainData] of Object.entries(chains)) {
+    const symbol = chainData.nativeCurrency?.symbol;
+    if (symbol) nativeTokenByChain[chainId] = symbol;
+}
+
+// Flat map: chainId (string) → small bond in wei (as number, safe as IEEE-754 double).
+const smallBondByChain = {};
+for (const [chainId, symbol] of Object.entries(nativeTokenByChain)) {
+    const t = tokens[symbol];
+    if (t?.small_number != null) smallBondByChain[chainId] = t.small_number;
+}
+
+// Flat index: lowercase contract address → metadata. Derived from contracts.json.
+const contractsByAddress = {};
+for (const [chainId, chainContracts] of Object.entries(contracts)) {
+    for (const [tokenTicker, tokenVersions] of Object.entries(chainContracts)) {
+        const tokenDecimals = tokens[tokenTicker]?.decimals ?? 18;
+        for (const [versionName, versionData] of Object.entries(tokenVersions)) {
+            if (!versionData.address) continue;
+            const majorMatch = versionName.match(/-(\d+)\./);
+            contractsByAddress[versionData.address.toLowerCase()] = {
+                majorVersion: majorMatch ? parseInt(majorMatch[1]) : null,
+                startBlock:   versionData.block ?? 0,
+                tokenTicker,
+                tokenDecimals,
+                tokenAddress: versionData.token_address ?? null,
+                chainId:      parseInt(chainId),
+            };
+        }
+    }
+}
+
+const data = { chains, contracts, factories, tokens, integrations, nativeTokenByChain, smallBondByChain, contractsByAddress };
+const output = 'window.RealityWebsiteData = ' + JSON.stringify(data) + ';\n';
+
+const generatedPath = path.join(project_base, 'generated/website-data.js');
+fs.writeFileSync(generatedPath, output);
+console.log('Wrote', generatedPath);
+
+if (install) {
+    const installPath = path.join(webroot, 'js/vendor/website-data.js');
+    fs.writeFileSync(installPath, output);
+    console.log('Installed to', installPath);
+}

package/scripts/update_token_prices.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+// Fetches approximate USD values for all tokens and writes approx_1_usd to each token JSON.
+//
+// approx_1_usd: how many of this token equals ~$1 USD.
+// Used for sorting bonds by USD value: usd_value = bond_in_units / approx_1_usd
+//
+// Testnet-only tokens are valued at 1/1,000,000 of the mainnet token they represent.
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const TOKENS_DIR = path.join(__dirname, '..', 'tokens');
+
+// Maps our token symbol to a CoinGecko coin ID.
+// OETH and ARETH are just ETH on L2 chains — same price.
+const COINGECKO_IDS = {
+  ETH:   'ethereum',
+  OETH:  'ethereum',
+  ARETH: 'ethereum',
+  BNB:   'binancecoin',
+  GNO:   'gnosis',
+  XDAI:  'xdai',
+  MATIC: 'matic-network',
+  AVAX:  'avalanche-2',
+  CELO:  'celo',
+  FOX:   'shapeshift-fox-token',
+  SWISE: 'stakewise',
+  POLK:  'polkamarkets',
+  DEXE:  'dexe',
+  SUKU:  'suku',
+  TRST:  'wetrust',
+  UBQ:   'ubiq',
+  TLOS:  'telos',
+};
+
+// Testnet-only tokens. Value = (mainnet base price) / 1,000,000.
+// The base coin is what they nominally represent for ordering purposes.
+const TESTNET_BASE = {
+  BOND:  'ethereum',   // arbitrary Sepolia ERC20
+  DAOOS: 'ethereum',   // dead Rinkeby test token
+  MONAD: 'ethereum',   // Monad testnet, mainnet not launched
+  ZBS:   'ethereum',   // dev-chain token
+  CTH:   'ethereum',   // dev-chain token
+};
+
+// Hardcoded fallback prices (USD per token) used when CoinGecko is unavailable.
+// Values are approximate and should be refreshed periodically by running this script.
+const FALLBACKS = {
+  ethereum:               3500,
+  binancecoin:             650,
+  gnosis:                  250,
+  xdai:                      1,
+  'matic-network':          0.45,
+  'avalanche-2':            38,
+  celo:                     0.60,
+  'shapeshift-fox-token':   0.03,
+  stakewise:                0.15,
+  polkamarkets:             0.008,
+  dexe:                    12,
+  suku:                     0.007,
+  wetrust:                  0.004,
+  ubiq:                     0.02,
+  telos:                    0.06,
+};
+
+async function fetchCoinGeckoPrices(ids) {
+  const url = 'https://api.coingecko.com/api/v3/simple/price?ids=' + ids.join(',') + '&vs_currencies=usd';
+  const res = await fetch(url, {
+    headers: { Accept: 'application/json' },
+    signal: AbortSignal.timeout(12000),
+  });
+  if (!res.ok) throw new Error('HTTP ' + res.status);
+  return res.json();
+}
+
+async function main() {
+  const allCgIds = [...new Set([
+    ...Object.values(COINGECKO_IDS),
+    ...Object.values(TESTNET_BASE),
+  ])];
+
+  let cgPrices = {};
+  let liveData = false;
+
+  console.log('Fetching prices from CoinGecko...');
+  try {
+    const data = await fetchCoinGeckoPrices(allCgIds);
+    cgPrices = data;
+    liveData = true;
+    console.log('Live prices fetched.\n');
+  } catch (err) {
+    console.warn('CoinGecko unavailable (' + err.message + '), using hardcoded fallbacks.\n');
+    for (const [id, usd] of Object.entries(FALLBACKS)) {
+      cgPrices[id] = { usd };
+    }
+  }
+
+  function getPrice(cgId) {
+    return (cgPrices[cgId] && cgPrices[cgId].usd) || FALLBACKS[cgId] || null;
+  }
+
+  const tokenFiles = fs.readdirSync(TOKENS_DIR).filter(f => f.endsWith('.json')).sort();
+
+  for (const file of tokenFiles) {
+    const symbol = file.replace('.json', '');
+    const filePath = path.join(TOKENS_DIR, file);
+    const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+
+    let priceUsd = null;
+    let note = '';
+
+    if (COINGECKO_IDS[symbol]) {
+      const cgId = COINGECKO_IDS[symbol];
+      priceUsd = getPrice(cgId);
+      note = liveData ? 'live (' + cgId + ')' : 'fallback (' + cgId + ')';
+    } else if (TESTNET_BASE[symbol]) {
+      const baseId = TESTNET_BASE[symbol];
+      const basePrice = getPrice(baseId);
+      if (basePrice) {
+        priceUsd = basePrice / 1_000_000;
+        note = 'testnet 1/1M of ' + baseId + ' ($' + basePrice + ')';
+      }
+    }
+
+    if (!priceUsd || priceUsd <= 0) {
+      console.warn('  ' + symbol + ': no price found, skipping');
+      continue;
+    }
+
+    const approx1Usd = parseFloat((1 / priceUsd).toPrecision(6));
+    data.approx_1_usd = approx1Usd;
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 4) + '\n');
+    console.log('  ' + symbol.padEnd(6) + ' $' + priceUsd.toPrecision(4).padStart(10) + '/token  →  approx_1_usd = ' + approx1Usd + '  (' + note + ')');
+  }
+
+  console.log('\nDone.');
+  if (!liveData) {
+    console.log('NOTE: hardcoded fallbacks used. Re-run when network is available for live prices.');
+  }
+}
+
+main().catch(err => { console.error(err); process.exit(1); });

package/tests/python/requirements.txt

@@ -4,7 +4,6 @@ asn1crypto==1.5.1
 async-timeout==4.0.3
 attrs==23.2.0
 bitarray==2.9.2
-bitcoin==1.1.42
 cached-property==1.5.2
 certifi==2023.11.17
 cffi==1.16.0
@@ -21,7 +20,6 @@ eth-rlp==1.0.0
 eth-tester==0.10.0b1
 eth-typing==3.5.2
 eth-utils==2.3.1
-ethereum==2.3.2
 frozenlist==1.4.1
 future==0.18.3
 hexbytes==0.3.1
@@ -41,14 +39,12 @@ py-evm==0.8.0b1
 pycparser==2.21
 pycryptodome==3.19.1
 pyethash==0.1.27
-pysha3==1.0.2
 pyunormalize==15.1.0
 PyYAML==6.0.1
 referencing==0.32.1
 regex==2023.12.25
 repoze.lru==0.7
 requests==2.31.0
-rlp==3.0.0
 rpds-py==0.16.2
 scrypt==0.8.20
 semantic-version==2.10.0