Feature/jss 78 move our contract abis out of the constants package #963

Ansonhkg · 2025-10-18T01:34:37Z

WHAT

switch the constants mapper to load datil/datil-dev/datil-test ABIs from the scoped @lit-protocol/contracts export map (legacy root import left commented for reference)
add verify-contracts-bundle.sh script to inspect bundle size for constants and contracts-sdk pcakges for browser + node targets

Also see: #962 (comment)

TEST

NPM

A snapshot has been published to @lit-protocol/[email protected]

Test repo: https://github.com/LIT-Protocol/pr-962-bundle-size-test

Before

https://test-962-contracts-sdk-bundle-size.vercel.app/bundle-report-lit-sdk.html

After

https://test-962-contracts-sdk-bundle-size.vercel.app/bundle-report-contracts-sdk-new.html

Locally

./verify-contracts-bundle.sh

BEFORE

import { datil, datilDev, datilTest } from '@lit-protocol/contracts';

⭐️ @lit-protocol/constants bundles:

  Browser includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/dev/datil.js -> 352.55 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-dev.js -> 352.60 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-test.js -> 370.70 KiB
    node_modules/@lit-protocol/contracts/dist/dev/cayenne.js -> 352.37 KiB
    node_modules/@lit-protocol/contracts/dist/dev/habanero.js -> 352.59 KiB
    node_modules/@lit-protocol/contracts/dist/dev/internalDev.js -> 352.63 KiB
    node_modules/@lit-protocol/contracts/dist/dev/manzano.js -> 352.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/cayenne.js -> 338.36 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    node_modules/@lit-protocol/contracts/dist/prod/habanero.js -> 338.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/internalDev.js -> 338.63 KiB
    node_modules/@lit-protocol/contracts/dist/prod/manzano.js -> 338.57 KiB
    node_modules/@lit-protocol/contracts/dist/index.js -> 0.74 KiB
    Total -> 4.760 MiB
    (Total reflects the sum of those files before compression/minification)

  Node includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/dev/datil.js -> 352.55 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-dev.js -> 352.60 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-test.js -> 370.70 KiB
    node_modules/@lit-protocol/contracts/dist/dev/cayenne.js -> 352.37 KiB
    node_modules/@lit-protocol/contracts/dist/dev/habanero.js -> 352.59 KiB
    node_modules/@lit-protocol/contracts/dist/dev/internalDev.js -> 352.63 KiB
    node_modules/@lit-protocol/contracts/dist/dev/manzano.js -> 352.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/cayenne.js -> 338.36 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    node_modules/@lit-protocol/contracts/dist/prod/habanero.js -> 338.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/internalDev.js -> 338.63 KiB
    node_modules/@lit-protocol/contracts/dist/prod/manzano.js -> 338.57 KiB
    node_modules/@lit-protocol/contracts/dist/index.js -> 0.74 KiB
    Total -> 4.760 MiB
    (Total reflects the sum of those files before compression/minification)

⭐️ @lit-protocol/contracts-sdk bundles:

  Browser includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/dev/datil.js -> 352.55 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-dev.js -> 352.60 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-test.js -> 370.70 KiB
    node_modules/@lit-protocol/contracts/dist/dev/cayenne.js -> 352.37 KiB
    node_modules/@lit-protocol/contracts/dist/dev/habanero.js -> 352.59 KiB
    node_modules/@lit-protocol/contracts/dist/dev/internalDev.js -> 352.63 KiB
    node_modules/@lit-protocol/contracts/dist/dev/manzano.js -> 352.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/cayenne.js -> 338.36 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    node_modules/@lit-protocol/contracts/dist/prod/habanero.js -> 338.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/internalDev.js -> 338.63 KiB
    node_modules/@lit-protocol/contracts/dist/prod/manzano.js -> 338.57 KiB
    node_modules/@lit-protocol/contracts/dist/index.js -> 0.74 KiB
    Total -> 4.760 MiB
    (Total reflects the sum of those files before compression/minification)

  Node includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/dev/datil.js -> 352.55 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-dev.js -> 352.60 KiB
    node_modules/@lit-protocol/contracts/dist/dev/datil-test.js -> 370.70 KiB
    node_modules/@lit-protocol/contracts/dist/dev/cayenne.js -> 352.37 KiB
    node_modules/@lit-protocol/contracts/dist/dev/habanero.js -> 352.59 KiB
    node_modules/@lit-protocol/contracts/dist/dev/internalDev.js -> 352.63 KiB
    node_modules/@lit-protocol/contracts/dist/dev/manzano.js -> 352.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/cayenne.js -> 338.36 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    node_modules/@lit-protocol/contracts/dist/prod/habanero.js -> 338.58 KiB
    node_modules/@lit-protocol/contracts/dist/prod/internalDev.js -> 338.63 KiB
    node_modules/@lit-protocol/contracts/dist/prod/manzano.js -> 338.57 KiB
    node_modules/@lit-protocol/contracts/dist/index.js -> 0.74 KiB
    Total -> 4.760 MiB
    (Total reflects the sum of those files before compression/minification)

Artifacts written to /Users/anson/Projects/datil-sdk/tmp/bundle-test

AFTER

// @ts-ignore -- TypeScript can't resolve the subpath because this package compiles to CJS, but runtime bundlers can.
import { datil as datilContext } from '@lit-protocol/contracts/prod/datil.js';
// @ts-ignore -- see note above.
import { datilDev as datilDevContext } from '@lit-protocol/contracts/prod/datil-dev.js';
// @ts-ignore -- see note above.
import { datilTest as datilTestContext } from '@lit-protocol/contracts/prod/datil-test.js';

⭐️ @lit-protocol/constants bundles:

  Browser includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    Total -> 1.010 MiB
    (Total reflects the sum of those files before compression/minification)

  Node includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    Total -> 1.010 MiB
    (Total reflects the sum of those files before compression/minification)

⭐️ @lit-protocol/contracts-sdk bundles:

  Browser includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    Total -> 1.010 MiB
    (Total reflects the sum of those files before compression/minification)

  Node includes:
    (Every line below lists a bundled @lit-protocol/contracts file and its raw size)
    node_modules/@lit-protocol/contracts/dist/prod/datil.js -> 338.55 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-dev.js -> 338.60 KiB
    node_modules/@lit-protocol/contracts/dist/prod/datil-test.js -> 356.70 KiB
    Total -> 1.010 MiB
    (Total reflects the sum of those files before compression/minification)

Artifacts written to /Users/anson/Projects/datil-sdk/tmp/bundle-test

…ify their sizes

…l contracts

Copilot

Pull Request Overview

This PR refactors contract ABI imports to use scoped subpath exports from @lit-protocol/contracts instead of the root package import, reducing bundle sizes by only including necessary network artifacts (datil/datil-dev/datil-test). A verification script is added to validate that bundles contain only the intended contract artifacts.

Key changes:

Switched from root @lit-protocol/contracts import to scoped subpath imports for specific networks
Added bundle verification script to audit included contract artifacts
Removed caret from contracts dependency version for stricter version control

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
verify-contracts-bundle.sh	New script that bundles test entries for constants and contracts-sdk packages, then analyzes which contract artifacts are included
packages/constants/src/lib/constants/mappers.ts	Refactored to import network-specific contract contexts via subpath exports instead of root import
package.json	Changed @lit-protocol/contracts dependency from ^0.0.74 to 0.0.74 (removed caret)

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

verify-contracts-bundle.sh

packages/constants/src/lib/constants/mappers.ts

Copilot · 2025-10-18T01:35:17Z

packages/constants/src/lib/constants/mappers.ts

+import { datil as datilContext } from '@lit-protocol/contracts/prod/datil.js';
+// @ts-ignore -- see note above.
+import { datilDev as datilDevContext } from '@lit-protocol/contracts/prod/datil-dev.js';
+// @ts-ignore -- see note above.
+import { datilTest as datilTestContext } from '@lit-protocol/contracts/prod/datil-test.js';
+
+type DatilContext = typeof datilContext;
+type DatilDevContext = typeof datilDevContext;
+type DatilTestContext = typeof datilTestContext;
+
+const datil: DatilContext = datilContext;
+const datilDev: DatilDevContext = datilDevContext;
+const datilTest: DatilTestContext = datilTestContext;
+


These re-assignments from imported contexts to new constants appear unnecessary. The imports could be renamed directly using import { datil as datilContext } from ... and then used as datilContext throughout the code, or imported as datil directly to maintain the existing variable names. The current approach adds extra indirection without clear benefit.

Suggested change

import { datil as datilContext } from '@lit-protocol/contracts/prod/datil.js';

// @ts-ignore -- see note above.

import { datilDev as datilDevContext } from '@lit-protocol/contracts/prod/datil-dev.js';

// @ts-ignore -- see note above.

import { datilTest as datilTestContext } from '@lit-protocol/contracts/prod/datil-test.js';

type DatilContext = typeof datilContext;

type DatilDevContext = typeof datilDevContext;

type DatilTestContext = typeof datilTestContext;

const datil: DatilContext = datilContext;

const datilDev: DatilDevContext = datilDevContext;

const datilTest: DatilTestContext = datilTestContext;

import { datil } from '@lit-protocol/contracts/prod/datil.js';

// @ts-ignore -- see note above.

import { datilDev } from '@lit-protocol/contracts/prod/datil-dev.js';

// @ts-ignore -- see note above.

import { datilTest } from '@lit-protocol/contracts/prod/datil-test.js';

it seems like you prob need the typedefs here, and copilot is wrong?

glitch003

very excited to see this!! thx for getting this in @Ansonhkg - will be a big improvement for devs. up to you if you wanna implement any of the copilot changes or not. the only one i saw that might make sense is https://github.com/LIT-Protocol/js-sdk/pull/963/files#r2441514234 but i don't think it really matters, just might be a little cleaner, but whatevs

Ansonhkg added 5 commits October 18, 2025 02:09

fix(constants): import contract abis from scoped exports

02b7719

feat(verify): add script to bundle constants and contracts SDK to ver…

3d2757f

…ify their sizes

fix(mappers): update import paths to include file extensions for dati…

cc9b36f

…l contracts

feat(verify): improve logs

9cdbfdd

chore(package): pin version

7e310af

Copilot AI review requested due to automatic review settings October 18, 2025 01:34

Copilot AI reviewed Oct 18, 2025

View reviewed changes

Ansonhkg marked this pull request as draft October 18, 2025 01:54

Ansonhkg self-assigned this Oct 18, 2025

Ansonhkg requested a review from glitch003 October 18, 2025 02:06

Ansonhkg marked this pull request as ready for review October 18, 2025 02:07

Ansonhkg added ✨ Enhancement New feature or request v7 | Datil labels Oct 18, 2025

Ansonhkg requested review from DashKash54, FedericoAmura, MaximusHaximus, awisniew207 and spacesailor24 October 18, 2025 02:21

Ansonhkg mentioned this pull request Oct 20, 2025

add lazy loaders for .cjs file #962

Closed

glitch003 approved these changes Oct 24, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Feature/jss 78 move our contract abis out of the constants package #963

Feature/jss 78 move our contract abis out of the constants package #963

Ansonhkg commented Oct 18, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI Oct 18, 2025

Uh oh!

glitch003 Oct 24, 2025

Uh oh!

glitch003 left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Feature/jss 78 move our contract abis out of the constants package #963

Are you sure you want to change the base?

Feature/jss 78 move our contract abis out of the constants package #963

Conversation

Ansonhkg commented Oct 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

WHAT

TEST

NPM

Before

After

Locally

BEFORE

AFTER

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Copilot AI Oct 18, 2025

Choose a reason for hiding this comment

Uh oh!

glitch003 Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

glitch003 left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Ansonhkg commented Oct 18, 2025 •

edited

Loading