@reptilianhq/launch-on-block-sdk 0.4.0

package/README.md

@@ -0,0 +1,116 @@
+# Launch On Block SDK
+
+Public TypeScript SDK, contract interfaces, ABIs, and deployment metadata for integrating with the
+Launch On Block protocol on Robinhood Chain.
+
+The package is runtime-neutral. It provides deterministic transaction requests and verification tools,
+but it does not select a wallet, RPC provider, gas policy, nonce policy, application backend, or user
+authorization model.
+
+## What it provides
+
+- Narrow, generated ABI subsets with literal `as const` types.
+- Typed, chain-scoped deployment metadata and replay boundaries.
+- Transaction builders and calldata verification.
+- Receipt verification tied to the expected contract and transaction envelope.
+- Deployment compatibility checks for runtime bytecode, proxies, and cross-contract wiring.
+- Stable SDK error codes and deterministic protocol arithmetic.
+
+## Installation
+
+The successor package is `@reptilianhq/launch-on-block-sdk`. Registry publication is fail-closed until
+the public npm scope, public GitHub source, protected release environment, and npm trusted publisher are
+configured. Until then, repository checks produce a complete npm tarball that consumers can evaluate
+without publishing it. See [`docs/RELEASING.md`](docs/RELEASING.md).
+
+Version `0.4.0` establishes the initial public package API in this dedicated repository.
+
+## Usage
+
+Import ABIs from narrow package subpaths so TypeScript preserves their literal types:
+
+```ts
+import { launchpadAbi, launchTokenAbi } from "@reptilianhq/launch-on-block-sdk/abis";
+```
+
+Build and verify transactions without binding the SDK to a wallet implementation:
+
+```ts
+import {
+  buildCurveBuyTransaction,
+  getDeployment,
+  verifyBuyReceipt,
+} from "@reptilianhq/launch-on-block-sdk";
+
+const deployment = getDeployment(4663);
+const request = buildCurveBuyTransaction(deployment.contracts.launchpad, {
+  token,
+  minTokensOut,
+  value,
+});
+
+const hash = await walletClient.sendTransaction(request);
+const receipt = await publicClient.waitForTransactionReceipt({ hash });
+const buy = verifyBuyReceipt(receipt, deployment.contracts.launchpad, { token });
+```
+
+Builders return `{ to, data, value }`. Consumers remain responsible for wallet selection, simulation,
+gas estimation, submission, confirmation depth, and reorg policy.
+
+Before enabling writes, prove that the selected RPC serves the deployment described by the SDK:
+
+```ts
+import { assertCompatibleDeployment } from "@reptilianhq/launch-on-block-sdk/compatibility";
+import { robinhoodMainnet } from "@reptilianhq/launch-on-block-sdk/deployments";
+
+await assertCompatibleDeployment(publicClient, robinhoodMainnet);
+```
+
+Compatibility checks prove deployment identity and wiring. They do not prove current operational health,
+pause state, balances, finality, or external governance safety.
+
+SDK validation errors expose stable codes:
+
+```ts
+import { isSdkError } from "@reptilianhq/launch-on-block-sdk/errors";
+
+try {
+  verifyCurveBuyTransaction(transaction, launchpad, account, expectedBuy);
+} catch (error) {
+  if (isSdkError(error) && error.code === "CALLDATA_MISMATCH") {
+    // Map application behavior by code; messages may evolve.
+  }
+  throw error;
+}
+```
+
+## Development
+
+Consumers require Node.js 22 or newer. Repository development and release automation use Node.js 24
+with npm and the committed lockfile.
+
+```sh
+npm ci
+npm test
+```
+
+`npm test` verifies the imported artifact hashes, builds the package, runs the unit suite, and packs the
+exact public exports from a clean `dist` directory.
+
+Do not import Foundry artifact JSON or copy ABI fragments into consumer applications. Foundry artifacts
+contain deployment bytecode and compiler metadata that application bundles do not need, while copied
+fragments drift independently from the SDK's compatibility checks.
+
+## Contract artifact boundary
+
+The Launch On Block contract repository remains authoritative for Solidity source, deployment scripts,
+and production activation. It exports reviewed ABI and deployment inputs through the handoff documented
+in [`docs/ARTIFACT_HANDOFF.md`](docs/ARTIFACT_HANDOFF.md).
+
+This repository never reads a sibling contract checkout during build or release. Generated inputs are
+committed, hash-bound to their producer identity, reviewed here, and then published as part of an SDK
+release.
+
+## License
+
+GPL-3.0-only. See [`LICENSE`](LICENSE).

package/dist/abis.d.ts

@@ -0,0 +1,2 @@
+export { ABI_REVISION, abiSignatures, feeControllerAbi, graduationPoolAbi, launchpadAbi, launchTokenAbi, lbFactoryIdentityAbi, lbRouterIdentityAbi, routerAbi, } from "./generated/abis.js";
+//# sourceMappingURL=abis.d.ts.map

package/dist/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,GACV,MAAM,qBAAqB,CAAC"}

package/dist/abis.js

@@ -0,0 +1,2 @@
+export { ABI_REVISION, abiSignatures, feeControllerAbi, graduationPoolAbi, launchpadAbi, launchTokenAbi, lbFactoryIdentityAbi, lbRouterIdentityAbi, routerAbi, } from "./generated/abis.js";
+//# sourceMappingURL=abis.js.map

package/dist/abis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.js","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,GACV,MAAM,qBAAqB,CAAC"}

package/dist/compatibility.d.ts

@@ -0,0 +1,50 @@
+import { type Address, type PublicClient } from "viem";
+import type { Deployment, ProtocolContracts } from "./deployments.js";
+import { SdkError, type SdkErrorCode } from "./errors.js";
+export type DeploymentCompatibilityErrorCode = Extract<SdkErrorCode, "ADMIN_MISMATCH" | "ABI_REVISION_MISMATCH" | "CHAIN_MISMATCH" | "CODE_MISSING" | "CODE_HASH_MISMATCH" | "IMPLEMENTATION_MISMATCH" | "POINTER_MISMATCH">;
+export declare class DeploymentCompatibilityError extends SdkError {
+    readonly path: string;
+    readonly expected: string;
+    readonly actual: string;
+    readonly code: DeploymentCompatibilityErrorCode;
+    constructor(code: DeploymentCompatibilityErrorCode, path: string, expected: string, actual: string);
+}
+export interface DeploymentCompatibilityReport {
+    chainId: number;
+    blockNumber: bigint;
+    releaseId: string;
+    abiRevision: string;
+    codeHashes: ProtocolContracts["runtimeCodeHashes"];
+    pointers: {
+        launchpadFeeController: Address;
+        launchpadWNative: Address;
+        launchpadGovernance: Address;
+        launchpadGraduationPoolDeployer: Address;
+        launchpadEscrowDeployer: Address;
+        launchpadDefaultCurveId: number;
+        launchpadDefaultCurve: Address;
+        escrowImplementation: Address;
+        feeControllerLaunchpad: Address;
+        feeControllerLbFactory: Address;
+        feeControllerProxyAdmin: Address;
+        feeControllerProxyAdminOwner: Address;
+        proxyUpgradeGateTimelock: Address;
+        routerLaunchpad: Address;
+        routerLbFactory: Address;
+        routerWNative: Address;
+        lbFactoryFeeRecipient: Address;
+        lbFactoryPairImplementation: Address;
+        lbRouterFactory: Address;
+        lbRouterWNative: Address;
+    };
+}
+/**
+ * Proves that an RPC is serving the manifest-bound release before a consumer trusts it.
+ * This checks identity and wiring, not operational state such as pause status or balances.
+ */
+export declare function assertCompatibleDeployment(client: PublicClient, deployment: Deployment & {
+    contracts: ProtocolContracts;
+}, options?: {
+    blockNumber?: bigint;
+}): Promise<DeploymentCompatibilityReport>;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EAEZ,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAYd,OAAO,KAAK,EAAoB,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAO1D,MAAM,MAAM,gCAAgC,GAAG,OAAO,CAAC,YAAY,EAC/D,gBAAgB,GAChB,uBAAuB,GACvB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,yBAAyB,GACzB,kBAAkB,CAAC,CAAC;AAExB,qBAAa,4BAA6B,SAAQ,QAAQ;aAKtC,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,MAAM;IANhC,SAAwB,IAAI,EAAE,gCAAgC,CAAC;gBAG7D,IAAI,EAAE,gCAAgC,EACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CASjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IACnD,QAAQ,EAAE;QACR,sBAAsB,EAAE,OAAO,CAAC;QAChC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,mBAAmB,EAAE,OAAO,CAAC;QAC7B,+BAA+B,EAAE,OAAO,CAAC;QACzC,uBAAuB,EAAE,OAAO,CAAC;QACjC,uBAAuB,EAAE,MAAM,CAAC;QAChC,qBAAqB,EAAE,OAAO,CAAC;QAC/B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,sBAAsB,EAAE,OAAO,CAAC;QAChC,sBAAsB,EAAE,OAAO,CAAC;QAChC,uBAAuB,EAAE,OAAO,CAAC;QACjC,4BAA4B,EAAE,OAAO,CAAC;QACtC,wBAAwB,EAAE,OAAO,CAAC;QAClC,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;QACvB,qBAAqB,EAAE,OAAO,CAAC;QAC/B,2BAA2B,EAAE,OAAO,CAAC;QACrC,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GAAG;IAAE,SAAS,EAAE,iBAAiB,CAAA;CAAE,EACzD,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,OAAO,CAAC,6BAA6B,CAAC,CAoQxC"}

package/dist/compatibility.js

@@ -0,0 +1,244 @@
+import { getAddress, keccak256, } from "viem";
+import { ABI_REVISION } from "./generated/abis.js";
+import { feeControllerAbi, launchpadAbi, launchEscrowDeployerAbi, lbFactoryIdentityAbi, lbRouterIdentityAbi, proxyAdminIdentityAbi, proxyUpgradeGateIdentityAbi, routerAbi, } from "./generated/abis.js";
+import { SdkError } from "./errors.js";
+const EIP1967_IMPLEMENTATION_SLOT = "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc";
+const EIP1967_ADMIN_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export class DeploymentCompatibilityError extends SdkError {
+    path;
+    expected;
+    actual;
+    constructor(code, path, expected, actual) {
+        super(code, `${path} is incompatible: expected ${expected}, got ${actual}`, {
+            path,
+            expected,
+            actual,
+        });
+        this.path = path;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = "DeploymentCompatibilityError";
+    }
+}
+/**
+ * Proves that an RPC is serving the manifest-bound release before a consumer trusts it.
+ * This checks identity and wiring, not operational state such as pause status or balances.
+ */
+export async function assertCompatibleDeployment(client, deployment, options = {}) {
+    const contracts = deployment.contracts;
+    if (contracts.abiRevision !== ABI_REVISION) {
+        throw new DeploymentCompatibilityError("ABI_REVISION_MISMATCH", "contracts.abiRevision", ABI_REVISION, contracts.abiRevision);
+    }
+    const chainId = await client.getChainId();
+    if (chainId !== deployment.chainId) {
+        throw new DeploymentCompatibilityError("CHAIN_MISMATCH", "chainId", String(deployment.chainId), String(chainId));
+    }
+    const blockNumber = options.blockNumber ?? (await client.getBlock({ blockTag: "safe" })).number;
+    if (blockNumber === null) {
+        throw new DeploymentCompatibilityError("CODE_MISSING", "blockNumber", "a numbered safe block", "null");
+    }
+    const codeTargets = [
+        ["launchpad", contracts.launchpad, contracts.runtimeCodeHashes.launchpad],
+        ["feeController", contracts.feeController, contracts.runtimeCodeHashes.feeController],
+        ["router", contracts.router, contracts.runtimeCodeHashes.router],
+        ["lbFactory", contracts.lbFactory, contracts.runtimeCodeHashes.lbFactory],
+        ["lbPairImplementation", contracts.lbPairImplementation, contracts.runtimeCodeHashes.lbPairImplementation],
+        ["lbRouter", contracts.lbRouter, contracts.runtimeCodeHashes.lbRouter],
+        ["defaultCurve", contracts.defaultCurve.address, contracts.defaultCurve.runtimeCodeHash],
+        ["graduationPoolDeployer", contracts.graduationPoolDeployer.address, contracts.graduationPoolDeployer.runtimeCodeHash],
+        ["launchEscrowDeployer", contracts.launchEscrowDeployer.address, contracts.launchEscrowDeployer.runtimeCodeHash],
+        ["launchEscrowDeployer.implementation", contracts.launchEscrowDeployer.implementation.address,
+            contracts.launchEscrowDeployer.implementation.runtimeCodeHash],
+        ["proxyUpgradeGate", contracts.proxyUpgradeGate.address, contracts.proxyUpgradeGate.runtimeCodeHash],
+        ["feeControllerAdmin", contracts.feeControllerAdmin.address, contracts.feeControllerAdmin.runtimeCodeHash],
+    ];
+    await Promise.all(codeTargets.map(([path, address, expectedHash]) => assertCodeHash(client, `contracts.${path}`, address, expectedHash, blockNumber)));
+    if (contracts.launchpadType !== "immutable") {
+        throw new DeploymentCompatibilityError("IMPLEMENTATION_MISMATCH", "contracts.launchpadType", "immutable", contracts.launchpadType);
+    }
+    const launchpadImplementation = contracts.implementations.launchpad;
+    if (launchpadImplementation !== null) {
+        throw new DeploymentCompatibilityError("IMPLEMENTATION_MISMATCH", "contracts.launchpad.implementation", "immutable launchpad with no implementation", launchpadImplementation.address);
+    }
+    const feeControllerImplementation = contracts.implementations.feeController;
+    if (feeControllerImplementation === null) {
+        throw new DeploymentCompatibilityError("IMPLEMENTATION_MISMATCH", "contracts.feeController.implementation", "a pinned implementation", "missing implementation metadata");
+    }
+    await Promise.all([
+        assertImplementationIdentity(client, "contracts.launchpad", contracts.launchpad, contracts.implementations.launchpad, blockNumber),
+        assertImplementationIdentity(client, "contracts.feeController", contracts.feeController, feeControllerImplementation, blockNumber),
+        assertAdminIdentity(client, "contracts.launchpad", contracts.launchpad, null, blockNumber),
+        assertAdminIdentity(client, "contracts.feeController", contracts.feeController, contracts.feeControllerAdmin.address, blockNumber),
+    ]);
+    if (deployment.addresses.wNative === null) {
+        throw new DeploymentCompatibilityError("CODE_MISSING", "addresses.wNative", "a configured contract", "null");
+    }
+    const wNativeCode = await client.getBytecode({ address: deployment.addresses.wNative, blockNumber });
+    if (!wNativeCode || wNativeCode === "0x") {
+        throw new DeploymentCompatibilityError("CODE_MISSING", "addresses.wNative", "deployed bytecode", "0x");
+    }
+    const [launchpadFeeController, launchpadWNative, launchpadGovernance, launchpadGraduationPoolDeployer, launchpadEscrowDeployer, launchpadDefaultCurveId, launchpadDefaultCurve, escrowImplementation, feeControllerLaunchpad, feeControllerLbFactory, feeControllerProxyAdminOwner, proxyUpgradeGateTimelock, routerLaunchpad, routerLbFactory, routerWNative, lbFactoryFeeRecipient, lbFactoryPairImplementation, lbRouterFactory, lbRouterWNative,] = await Promise.all([
+        client.readContract({ address: contracts.launchpad, abi: launchpadAbi, functionName: "feeController", blockNumber }),
+        client.readContract({ address: contracts.launchpad, abi: launchpadAbi, functionName: "wNative", blockNumber }),
+        client.readContract({ address: contracts.launchpad, abi: launchpadAbi, functionName: "governance", blockNumber }),
+        client.readContract({
+            address: contracts.launchpad,
+            abi: launchpadAbi,
+            functionName: "graduationPoolDeployer",
+            blockNumber,
+        }),
+        client.readContract({
+            address: contracts.launchpad,
+            abi: launchpadAbi,
+            functionName: "launchEscrowDeployer",
+            blockNumber,
+        }),
+        client.readContract({ address: contracts.launchpad, abi: launchpadAbi, functionName: "DEFAULT_CURVE_ID", blockNumber }),
+        client.readContract({
+            address: contracts.launchpad,
+            abi: launchpadAbi,
+            functionName: "curveImplementation",
+            args: [contracts.defaultCurve.id],
+            blockNumber,
+        }),
+        client.readContract({
+            address: contracts.launchEscrowDeployer.address,
+            abi: launchEscrowDeployerAbi,
+            functionName: "implementation",
+            blockNumber,
+        }),
+        client.readContract({ address: contracts.feeController, abi: feeControllerAbi, functionName: "launchpad", blockNumber }),
+        client.readContract({ address: contracts.feeController, abi: feeControllerAbi, functionName: "lbFactory", blockNumber }),
+        client.readContract({
+            address: contracts.feeControllerAdmin.address,
+            abi: proxyAdminIdentityAbi,
+            functionName: "owner",
+            blockNumber,
+        }),
+        client.readContract({
+            address: contracts.proxyUpgradeGate.address,
+            abi: proxyUpgradeGateIdentityAbi,
+            functionName: "timelock",
+            blockNumber,
+        }),
+        client.readContract({ address: contracts.router, abi: routerAbi, functionName: "launchpad", blockNumber }),
+        client.readContract({ address: contracts.router, abi: routerAbi, functionName: "lbFactory", blockNumber }),
+        client.readContract({ address: contracts.router, abi: routerAbi, functionName: "wNative", blockNumber }),
+        client.readContract({
+            address: contracts.lbFactory,
+            abi: lbFactoryIdentityAbi,
+            functionName: "getFeeRecipient",
+            blockNumber,
+        }),
+        client.readContract({
+            address: contracts.lbFactory,
+            abi: lbFactoryIdentityAbi,
+            functionName: "getLBPairImplementation",
+            blockNumber,
+        }),
+        client.readContract({
+            address: contracts.lbRouter,
+            abi: lbRouterIdentityAbi,
+            functionName: "getFactory",
+            blockNumber,
+        }),
+        client.readContract({
+            address: contracts.lbRouter,
+            abi: lbRouterIdentityAbi,
+            functionName: "getWNATIVE",
+            blockNumber,
+        }),
+    ]);
+    const expectedWNative = deployment.addresses.wNative;
+    const pointers = {
+        launchpadFeeController,
+        launchpadWNative,
+        launchpadGovernance,
+        launchpadGraduationPoolDeployer,
+        launchpadEscrowDeployer,
+        launchpadDefaultCurveId,
+        launchpadDefaultCurve,
+        escrowImplementation,
+        feeControllerLaunchpad,
+        feeControllerLbFactory,
+        feeControllerProxyAdmin: contracts.feeControllerAdmin.address,
+        feeControllerProxyAdminOwner,
+        proxyUpgradeGateTimelock,
+        routerLaunchpad,
+        routerLbFactory,
+        routerWNative,
+        lbFactoryFeeRecipient,
+        lbFactoryPairImplementation,
+        lbRouterFactory,
+        lbRouterWNative,
+    };
+    assertAddress("pointers.launchpadFeeController", launchpadFeeController, contracts.feeController);
+    assertAddress("pointers.launchpadWNative", launchpadWNative, expectedWNative);
+    assertAddress("pointers.launchpadGraduationPoolDeployer", launchpadGraduationPoolDeployer, contracts.graduationPoolDeployer.address);
+    assertAddress("pointers.launchpadEscrowDeployer", launchpadEscrowDeployer, contracts.launchEscrowDeployer.address);
+    if (launchpadDefaultCurveId !== contracts.defaultCurve.id) {
+        throw new DeploymentCompatibilityError("POINTER_MISMATCH", "pointers.launchpadDefaultCurveId", String(contracts.defaultCurve.id), String(launchpadDefaultCurveId));
+    }
+    assertAddress("pointers.launchpadDefaultCurve", launchpadDefaultCurve, contracts.defaultCurve.address);
+    assertAddress("pointers.escrowImplementation", escrowImplementation, contracts.launchEscrowDeployer.implementation.address);
+    assertAddress("pointers.feeControllerLaunchpad", feeControllerLaunchpad, contracts.launchpad);
+    assertAddress("pointers.feeControllerLbFactory", feeControllerLbFactory, contracts.lbFactory);
+    assertAddress("pointers.feeControllerProxyAdminOwner", feeControllerProxyAdminOwner, contracts.proxyUpgradeGate.address);
+    assertAddress("pointers.proxyUpgradeGateTimelock", proxyUpgradeGateTimelock, launchpadGovernance);
+    assertAddress("pointers.routerLaunchpad", routerLaunchpad, contracts.launchpad);
+    assertAddress("pointers.routerLbFactory", routerLbFactory, contracts.lbFactory);
+    assertAddress("pointers.routerWNative", routerWNative, expectedWNative);
+    assertAddress("pointers.lbFactoryFeeRecipient", lbFactoryFeeRecipient, contracts.feeController);
+    assertAddress("pointers.lbFactoryPairImplementation", lbFactoryPairImplementation, contracts.lbPairImplementation);
+    assertAddress("pointers.lbRouterFactory", lbRouterFactory, contracts.lbFactory);
+    assertAddress("pointers.lbRouterWNative", lbRouterWNative, expectedWNative);
+    return {
+        chainId,
+        blockNumber,
+        releaseId: contracts.releaseId,
+        abiRevision: contracts.abiRevision,
+        codeHashes: contracts.runtimeCodeHashes,
+        pointers,
+    };
+}
+async function assertAdminIdentity(client, path, contract, expected, blockNumber) {
+    const actual = await readEip1967Address(client, contract, EIP1967_ADMIN_SLOT, blockNumber);
+    if (expected === null ? actual !== null : actual === null || actual.toLowerCase() !== expected.toLowerCase()) {
+        throw new DeploymentCompatibilityError("ADMIN_MISMATCH", `${path}.admin`, expected ?? "direct deployment (empty EIP-1967 admin slot)", actual ?? "missing storage");
+    }
+}
+async function assertCodeHash(client, path, address, expectedHash, blockNumber) {
+    const code = await client.getBytecode({ address, blockNumber });
+    if (!code || code === "0x") {
+        throw new DeploymentCompatibilityError("CODE_MISSING", path, "deployed bytecode", "0x");
+    }
+    const actualHash = keccak256(code);
+    if (actualHash.toLowerCase() !== expectedHash.toLowerCase()) {
+        throw new DeploymentCompatibilityError("CODE_HASH_MISMATCH", path, expectedHash, actualHash);
+    }
+}
+async function assertImplementationIdentity(client, path, contract, expected, blockNumber) {
+    const actual = await readEip1967Address(client, contract, EIP1967_IMPLEMENTATION_SLOT, blockNumber);
+    if (expected === null) {
+        if (actual !== null) {
+            throw new DeploymentCompatibilityError("IMPLEMENTATION_MISMATCH", `${path}.implementation`, "direct deployment (empty EIP-1967 implementation slot)", actual);
+        }
+        return;
+    }
+    if (actual === null || actual.toLowerCase() !== expected.address.toLowerCase()) {
+        throw new DeploymentCompatibilityError("IMPLEMENTATION_MISMATCH", `${path}.implementation`, expected.address, actual ?? "missing storage");
+    }
+    await assertCodeHash(client, `${path}.implementation`, expected.address, expected.runtimeCodeHash, blockNumber);
+}
+async function readEip1967Address(client, contract, slot, blockNumber) {
+    const storage = await client.getStorageAt({ address: contract, slot, blockNumber });
+    return storage && storage !== "0x" && BigInt(storage) !== 0n
+        ? getAddress(`0x${storage.slice(-40)}`)
+        : null;
+}
+function assertAddress(path, actual, expected) {
+    if (actual.toLowerCase() !== expected.toLowerCase()) {
+        throw new DeploymentCompatibilityError("POINTER_MISMATCH", path, expected, actual);
+    }
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"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"}