usecannon · dbeal-eth · Aug 19, 2025 · Apr 25, 2025 · Apr 27, 2025 · Apr 28, 2025
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 Cannon is a DevOps tool for EVM chains. It's a tool for testing, deploying, and publishing of smart contracts.
 
-This is the monorepo for Cannon. If you're just interested in using the project, [visit the website](https://usecannon.com).
+This is the monorepo for Cannon. If you're just interested in using the project, [visit the website](https://usecannon.com/learn).
 
 **⚠️ Cannon is under active development. While the interface and functionality are generally stable, use the tool with caution when conducting high-risk deployments.**
 

diff --git a/examples/sample-hardhat-project/package.json b/examples/sample-hardhat-project/package.json
@@ -11,17 +11,17 @@
     "@typechain/ethers-v5": "^7.2.0",
     "@typechain/hardhat": "^2.3.1",
     "@types/chai": "^4.3.0",
-    "@types/mocha": "^9.1.0",
-    "@types/node": "^16.0.0",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.14.0",
     "chai": "^4.3.6",
     "dotenv": "^10.0.0",
     "ethers": "^5.7.1",
     "hardhat-cannon": "workspace:*",
     "hardhat": "^2.13.1",
     "hardhat-gas-reporter": "^1.0.9",
     "solidity-coverage": "^0.8.5",
-    "ts-node": "^10.5.0",
+    "ts-node": "^10.9.2",
     "typechain": "^5.2.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.8.3"
   }
 }
diff --git a/examples/sample-hardhat-toolbox/package.json b/examples/sample-hardhat-toolbox/package.json
@@ -9,6 +9,6 @@
     "@nomicfoundation/hardhat-toolbox": "^4.0.0",
     "hardhat": "^2.19.2",
     "hardhat-cannon": "workspace:*",
-    "viem": "^2.21.15"
+    "viem": "^2.25.1"
   }
 }
diff --git a/package.json b/package.json
@@ -43,8 +43,9 @@
     "release-please": "^15.12.0",
     "solhint": "^3.4.1",
     "solhint-plugin-prettier": "^0.0.5",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.3.3"
+    "syncpack": "^13.0.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
   },
   "license": "GNU GPL V3.0",
   "dependencies": {

diff --git a/packages/api/package.json b/packages/api/package.json
@@ -34,13 +34,13 @@
     "helmet": "^7.1.0",
     "prom-client": "^15.1.2",
     "redis": "^4.6.13",
-    "viem": "^2.23.1"
+    "viem": "^2.25.1"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
-    "@types/node": "^20.12.7",
+    "@types/node": "^22.14.0",
     "ts-node-dev": "^2.0.0",
-    "typescript": "^5.4.5"
+    "typescript": "^5.8.3"
   }
 }
diff --git a/packages/api/src/db/transformers.ts b/packages/api/src/db/transformers.ts
@@ -1,7 +1,7 @@
 import { PackageReference } from '@usecannon/builder';
 import * as viem from 'viem';
 import { isChainId, isContractName, isFunctionSelector } from '../helpers';
-import { ApiFunction, ApiPackage, IpfsUrl, RedisDocument, RedisFunction, RedisPackage, RedisTag } from '../types';
+import { ApiSelectorResult, ApiPackage, IpfsUrl, RedisDocument, RedisFunction, RedisPackage, RedisTag } from '../types';
 
 export function findPackageByTag(documents: { value: RedisDocument }[], tag: RedisTag) {
   const result = documents.find(
@@ -53,21 +53,32 @@ export function transformFunction(value: RedisFunction) {
   if (typeof value.name !== 'string' || !value.name) return;
   if (!isFunctionSelector(value.selector)) return;
   if (typeof value.timestamp !== 'string' || !value.timestamp) return;
-  if (!PackageReference.isValid(value.package)) return;
-  if (!isChainId(value.chainId)) return;
-  if (!viem.isAddress(value.address)) return;
-  if (!isContractName(value.contractName)) return;
+  if (value.package && !PackageReference.isValid(value.package)) return;
+  if (value.chainId && !isChainId(value.chainId)) return;
+  if (value.address && !viem.isAddress(value.address)) return;
+  if (value.contractName && !isContractName(value.contractName)) return;
 
-  const ref = new PackageReference(value.package);
-  return {
-    type: 'function',
-    name: value.name,
-    selector: value.selector,
-    contractName: value.contractName,
-    chainId: Number.parseInt(value.chainId),
-    address: viem.getAddress(value.address),
-    packageName: ref.name,
-    preset: ref.preset,
-    version: ref.version,
-  } satisfies ApiFunction;
+  if (value.package) {
+    const ref = new PackageReference(value.package);
+    return {
+      type: 'function',
+      name: value.name,
+      selector: value.selector,
+      contractName: value.contractName,
+      chainId: Number.parseInt(value.chainId),
+      address: viem.getAddress(value.address),
+      packageName: ref.name,
+      preset: ref.preset,
+      version: ref.version,
+    } satisfies ApiSelectorResult;
+  } else {
+    return {
+      type: 'function',
+      name: value.name,
+      selector: value.selector,
+      contractName: value.contractName,
+      chainId: value.chainId ? Number.parseInt(value.chainId) : undefined,
+      address: value.address ? viem.getAddress(value.address) : undefined,
+    } satisfies ApiSelectorResult;
+  }
 }
diff --git a/packages/api/src/index.ts b/packages/api/src/index.ts
@@ -32,6 +32,7 @@ app.use(
   })
 );
 
+app.use(routes.selector);
 app.use(routes.metrics);
 app.use(routes.chains);
 app.use(routes.packages);

diff --git a/packages/api/src/queries/functions.ts → packages/api/src/queries/selectors.ts b/packages/api/src/queries/functions.ts → packages/api/src/queries/selectors.ts
@@ -2,17 +2,19 @@ import * as viem from 'viem';
 import * as keys from '../db/keys';
 import { transformFunction } from '../db/transformers';
 import { useRedis } from '../redis';
-import { ApiFunction, RedisFunction } from '../types';
+import { ApiSelectorResult, RedisFunction } from '../types';
 
-async function _queryAbiFunctions(params: { query: string; limit?: number }) {
+async function _querySelectors(params: { query: string; limit?: number }) {
   const redis = await useRedis();
 
-  const results = (await redis.ft.search(keys.RKEY_ABI_SEARCHABLE, params.query)) as unknown as {
+  const results = (await redis.ft.search(keys.RKEY_ABI_SEARCHABLE, params.query, {
+    SORTBY: { BY: 'timestamp', DIRECTION: 'ASC' },
+  })) as unknown as {
     total: number;
     documents: { value: RedisFunction }[];
   };
 
-  const data: ApiFunction[] = [];
+  const data: ApiSelectorResult[] = [];
 
   for (const { value } of results.documents) {
     const parsed = transformFunction(value);
@@ -37,16 +39,20 @@ async function _queryAbiFunctions(params: { query: string; limit?: number }) {
     data,
   } satisfies {
     total: number;
-    data: ApiFunction[];
+    data: ApiSelectorResult[];
   };
 }
 
-export async function findFunctionsBySelector(params: { selector: viem.Hex; limit: number }) {
-  return _queryAbiFunctions({ query: `@selector:{${params.selector}}`, limit: params.limit });
+export async function findSelector(params: { selector: viem.Hex; type?: 'function' | 'event' | 'error'; limit: number }) {
+  let query = `@selector:{${params.selector}}`;
+  if (params.type) {
+    query += `,@type:{${params.type}}`;
+  }
+  return _querySelectors({ query, limit: params.limit });
 }
 
 export async function searchFunctions(params: { query: string; limit: number }) {
-  return _queryAbiFunctions({
+  return _querySelectors({
     query: `@name:'${params.query}' | @name:${params.query}* | @name:*${params.query}*`,
     limit: params.limit,
   });

diff --git a/packages/api/src/routes/index.ts b/packages/api/src/routes/index.ts
@@ -2,3 +2,4 @@ export { metrics } from './metrics';
 export { chains } from './chains';
 export { packages } from './packages';
 export { search } from './search';
+export { selector } from './selector';
diff --git a/packages/api/src/routes/search.ts b/packages/api/src/routes/search.ts
@@ -11,7 +11,7 @@ import {
   parseTextQuery,
 } from '../helpers';
 import { findContractsByAddress, searchContracts } from '../queries/contracts';
-import { findFunctionsBySelector, searchFunctions } from '../queries/functions';
+import { findSelector, searchFunctions } from '../queries/selectors';
 import { findPackagesByPartialRef, searchPackages } from '../queries/packages';
 import { ApiDocument } from '../types';
 
@@ -76,15 +76,15 @@ search.get('/search', async (req, res) => {
   } else if (response.isHex) {
     if (query.length >= 10) {
       const selector = query.slice(0, 10);
-      const result = await findFunctionsBySelector({
+      const result = await findSelector({
         selector: selector as viem.Hex,
         limit: 20,
       });
 
       _pushResults(response, result);
     }
   } else if (response.isFunctionSelector) {
-    const result = await findFunctionsBySelector({
+    const result = await findSelector({
       selector: query as viem.Hex,
       limit: 20,
     });

diff --git a/packages/api/src/routes/selector.ts b/packages/api/src/routes/selector.ts
@@ -0,0 +1,34 @@
+import * as viem from 'viem';
+import { Request, Response, Router } from 'express';
+import { BadRequestError } from '../errors';
+import { findSelector } from '../queries/selectors';
+import { ApiSelectorResult } from '../types';
+
+const selector: Router = Router();
+
+selector.get('/selector', async (req: Request, res: Response) => {
+  if (typeof req.query.q !== 'string') {
+    throw new BadRequestError('Query selector not specified');
+  }
+  const selectors = req.query.q.split(',') as viem.Hex[];
+  const type = req.query.type as 'function' | 'event' | 'error';
+
+  const results: Record<string, ApiSelectorResult[]> = {};
+
+  for (const selector of selectors) {
+    results[selector] = (
+      await findSelector({
+        selector,
+        type,
+        limit: 10,
+      })
+    ).data;
+  }
+
+  res.json({
+    status: 200,
+    results,
+  });
+});
+
+export { selector };
diff --git a/packages/api/src/types.ts b/packages/api/src/types.ts
@@ -67,19 +67,19 @@ export interface ApiContract {
   version: string;
 }
 
-export interface ApiFunction {
-  type: 'function';
+export interface ApiSelectorResult {
+  type: 'function' | 'event' | 'error';
   name: string;
   selector: string;
-  contractName: string;
-  chainId: number;
-  address: Address;
-  packageName: string;
-  preset: string;
-  version: string;
+  contractName?: string;
+  chainId?: number;
+  address?: Address;
+  packageName?: string;
+  preset?: string;
+  version?: string;
 }
 
-export type ApiDocument = ApiNamespace | ApiPackage | ApiContract | ApiFunction;
+export type ApiDocument = ApiNamespace | ApiPackage | ApiContract | ApiSelectorResult;
 
 type ExtractType<T> = T extends { type: infer U } ? U : never;
 export type ApiDocumentType = ExtractType<ApiDocument>;
diff --git a/packages/builder/package.json b/packages/builder/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usecannon/builder",
-  "version": "2.24.0",
+  "version": "2.23.0",
   "description": "Assembles cannonfile.toml manifests into cannon packages.",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -49,7 +49,7 @@
     "@usecannon/router": "^4.1.3",
     "@usecannon/web-solc": "0.5.1",
     "acorn": "^8.14.1",
-    "axios": "^1.8.4",
+    "axios": "^1.9.0",
     "axios-retry": "^4.5.0",
     "buffer": "^6.0.3",
     "chalk": "^4.1.2",
@@ -63,7 +63,7 @@
     "rfdc": "^1.4.1",
     "ses": "^1.12.0",
     "typestub-ipfs-only-hash": "^4.0.0",
-    "viem": "^2.25.0",
+    "viem": "^2.25.1",
     "zod": "^3.24.2"
   },
   "engines": {

diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@usecannon/cli",
-  "version": "2.24.0",
+  "version": "2.23.0",
   "description": "Utility for instantly loading cannon packages in standalone contexts",
   "main": "dist/src/index.js",
   "scripts": {
@@ -50,7 +50,7 @@
     "@types/prompts": "^2.4.9",
     "@types/semver": "^7.7.0",
     "@types/sinon": "^17.0.4",
-    "axios": "^1.8.4",
+    "axios": "^1.9.0",
     "jest": "^29.7.0",
     "mock-fs": "^5.5.0",
     "tmp-promise": "^3.0.3",
@@ -80,7 +80,7 @@
     "table": "^6.9.0",
     "tildify": "3.0.0",
     "untildify": "^4.0.0",
-    "viem": "^2.25.0",
+    "viem": "^2.25.1",
     "znv": "^0.4.0",
     "zod": "^3.24.2"
   },

diff --git a/packages/cli/src/commands/verify.ts b/packages/cli/src/commands/verify.ts
@@ -43,7 +43,7 @@ export async function verify(packageRef: string, cliSettings: CliSettings, chain
     getMainLoader(cliSettings)
   );
 
-  const etherscanApi = cliSettings.etherscanApiUrl || 'https://api.etherscan.io/api';
+  const etherscanApi = cliSettings.etherscanApiUrl || 'https://api.etherscan.io/v2/api';
 
   if (!etherscanApi) {
     throw new Error(
@@ -100,7 +100,7 @@ export async function verify(packageRef: string, cliSettings: CliSettings, chain
         continue;
       }
 
-      if (await isVerified(contractInfo.address, etherscanApi, cliSettings.etherscanApiKey, chainId)) {
+      if (await isVerified(contractInfo.address, chainId, etherscanApi, cliSettings.etherscanApiKey)) {
         log(`✅ ${c}: Contract source code already verified`);
         await sleep(500);
         continue;

diff --git a/packages/cli/src/util/verify.ts b/packages/cli/src/util/verify.ts
@@ -37,7 +37,7 @@ export type EtherscanGetSourceCodeResponse = EtherscanGetSourceCodeNotOkResponse
  * @returns True if the contract is verified, false otherwise.
  */
 
-export async function isVerified(address: string, apiUrl: string, apiKey: string, chainId: number): Promise<boolean> {
+export async function isVerified(address: string, chainId: number, apiUrl: string, apiKey: string): Promise<boolean> {
   const parameters = new URLSearchParams({
     apikey: apiKey,
     chainid: chainId.toString(),