@sparkdotfi/abi-cli 0.2.0-20251031.00360a84 → 0.2.0-20260317.e49bd3f1

package/dist/src/abi-registry/abi-fetcher/AbiFetcherClient.js

@@ -26,12 +26,22 @@ export class AbiFetcherClient {
         return result.abi;
     }
 }
-async function loadAbiUsingWhatsAbi(args) {
-    const { address, domain, client, etherscanApiKey } = args;
-    const loader = new whatsabi.loaders.EtherscanV2ABILoader({
+function createAbiLoader(domain, etherscanApiKey) {
+    // Etherscan v2 API's contract/getabi module is broken for Gnosis (returns "Unknown Exception"),
+    // so we use Blockscout directly for Gnosis.
+    if (domain === 'gnosis') {
+        return new whatsabi.loaders.BlockscoutABILoader({
+            baseURL: 'https://gnosis.blockscout.com/api',
+        });
+    }
+    return new whatsabi.loaders.EtherscanV2ABILoader({
         apiKey: etherscanApiKey,
         chainId: domainToChainId[domain],
     });
+}
+async function loadAbiUsingWhatsAbi(args) {
+    const { address, domain, client, etherscanApiKey } = args;
+    const loader = createAbiLoader(domain, etherscanApiKey);
     const data = await lazyPipe(() => whatsabi.autoload(address, {
         provider: client,
         followProxies: true,
@@ -44,7 +54,8 @@ async function loadAbiUsingWhatsAbi(args) {
     if (data.abi.length === 0) {
         throw new Error(`Abi not found for ${domain}:${address}`);
     }
-    if (!data.abiLoadedFrom || !data.abiLoadedFrom.name.toLowerCase().includes('etherscan')) {
+    const loaderName = data.abiLoadedFrom?.name.toLowerCase() ?? '';
+    if (!data.abiLoadedFrom || !(loaderName.includes('etherscan') || loaderName.includes('blockscout'))) {
         throw new Error(`Abi not found for ${domain}:${address}`);
     }
     return data;

package/dist/src/abi-registry/getAbiForContract.js

@@ -12,10 +12,49 @@ export function getAbiForContract(abiRegistry, config, name) {
     }));
     assert(instances.length > 0);
     const rootAbi = instances[0].abi;
-    const rootAbiStringified = JSON.stringify(rootAbi);
+    const rootNormalized = normalizeAbiForComparison(rootAbi);
     const notMatchingAbi = instances.find(({ abi }) => {
-        return JSON.stringify(abi) !== rootAbiStringified;
+        return normalizeAbiForComparison(abi) !== rootNormalized;
     });
     assert(!notMatchingAbi, `Found not matching abis: ${notMatchingAbi?.name}`);
     return rootAbi;
 }
+/**
+ * Normalizes an ABI for comparison by removing source-specific differences:
+ * - Strips `internalType` fields (compiler metadata, not part of ABI spec)
+ * - Sorts entries by type + name for consistent ordering
+ * Different ABI sources (Etherscan, Blockscout) may return the same ABI with cosmetic differences.
+ */
+function normalizeAbiForComparison(abi) {
+    const normalized = abi.map((entry) => {
+        const clone = structuredClone(entry);
+        // Constructors and fallback/receive without stateMutability are implicitly "nonpayable"
+        if ((clone.type === 'constructor' || clone.type === 'fallback' || clone.type === 'receive') &&
+            !clone.stateMutability) {
+            clone.stateMutability = 'nonpayable';
+        }
+        return normalizeAbiEntry(clone);
+    });
+    normalized.sort((a, b) => {
+        const typeCmp = (a.type ?? '').localeCompare(b.type ?? '');
+        if (typeCmp !== 0)
+            return typeCmp;
+        return (a.name ?? '').localeCompare(b.name ?? '');
+    });
+    return JSON.stringify(normalized);
+}
+function normalizeAbiEntry(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(normalizeAbiEntry);
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const key of Object.keys(obj).sort()) {
+            if (key === 'internalType')
+                continue;
+            result[key] = normalizeAbiEntry(obj[key]);
+        }
+        return result;
+    }
+    return obj;
+}

package/dist/src/manifest/manifest.js

@@ -1,13 +1,12 @@
-import { CheckedAddress, getUnsafeChainIdToDomain } from '@sparkdotfi/common-universal';
+import { checkedAddressSchema, getUnsafeChainIdToDomain, } from '@sparkdotfi/common-universal';
 import { entries, mapKeys } from 'remeda';
 import { z } from 'zod';
-export const CheckedAddressSchema = z.string().transform(CheckedAddress);
 export const FullAddressSchema = z.object({
-    address: CheckedAddressSchema,
+    address: checkedAddressSchema,
     skipAbiVerification: z.boolean().default(false),
 });
 export const NakedOrFullAddressSchema = z
-    .union([CheckedAddressSchema, FullAddressSchema])
+    .union([checkedAddressSchema, FullAddressSchema])
     .transform((union) => {
     if (typeof union === 'string') {
         return { address: union, skipAbiVerification: false };

package/dist/types/src/manifest/manifest.d.ts

@@ -1,8 +1,5 @@
 import { CheckedAddress, SparkDomain } from '@sparkdotfi/common-universal';
 import { z } from 'zod';
-export declare const CheckedAddressSchema: z.ZodEffects<z.ZodString, `0x${string}` & {
-    readonly __TAG__: "CheckedAddress";
-}, string>;
 export declare const FullAddressSchema: z.ZodObject<{
     address: z.ZodEffects<z.ZodString, `0x${string}` & {
         readonly __TAG__: "CheckedAddress";
@@ -873,10 +870,6 @@ export declare const ManifestSchema: z.ZodObject<{
         };
         useCheckedAddress?: boolean | undefined;
     };
-    eoa?: Record<string, Record<string, string | {
-        address: string;
-        skipAbiVerification?: boolean | undefined;
-    }>> | undefined;
     contracts?: Record<string, Record<string, string | {
         address: string;
         skipAbiVerification?: boolean | undefined;
@@ -884,6 +877,10 @@ export declare const ManifestSchema: z.ZodObject<{
         address: string;
         skipAbiVerification?: boolean | undefined;
     }>>> | undefined;
+    eoa?: Record<string, Record<string, string | {
+        address: string;
+        skipAbiVerification?: boolean | undefined;
+    }>> | undefined;
     interfaces?: Record<string, {
         addresses: Record<string, string | {
             address: string;

package/dist/types/src/manifest/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/manifest/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA4B,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAEpG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,oBAAoB;;UAAuC,CAAA;AACxE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAG5B,CAAA;AACF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAA;AAEJ,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAO9C,CAAA;AAEJ,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK5C,CAAA;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAKxC,CAAA;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAuD,CAAA;AAE9E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAA2D,CAAA;AAEvF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIpC,CAAA;AACF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAkD,CAAA;AAE/E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYzB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAA;AACtD,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;AACvC,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC5E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC/F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qCAAqC,CAAC,CAAA;AAE5F,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAA"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/manifest/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAGd,WAAW,EACZ,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAG5B,CAAA;AACF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAA;AAEJ,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAO9C,CAAA;AAEJ,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK5C,CAAA;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAKxC,CAAA;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAuD,CAAA;AAE9E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAA2D,CAAA;AAEvF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIpC,CAAA;AACF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAkD,CAAA;AAE/E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYzB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAA;AACtD,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;AACvC,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC5E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC/F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qCAAqC,CAAC,CAAA;AAE5F,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkdotfi/abi-cli",
-  "version": "0.2.0-20251031.00360a84",
+  "version": "0.2.0-20260317.e49bd3f1",
   "engines": {
     "node": ">=22.0.0"
   },
@@ -45,6 +45,6 @@
     "prettier": "^3.6.2",
     "remeda": "^2.30.0",
     "viem": "^2.0.0",
-    "zod": "^3.0.0"
+    "zod": "^3.24.0"
   }
 }