@layerzerolabs/lz-contract-addresses 1.2.90 → 1.2.92

package/README.md

@@ -0,0 +1,8 @@
+# Protocol address snapshot
+
+`src/generated/<env>.json` holds the protocol contract addresses owned by the deploy & wire registry. Generate it from the registry with `export-address-snapshot` (`apps/projects/deploy-wire-protocol-project-app/scripts`); don't edit it by hand.
+
+CI does not check it against the registry yet: that gate is step 2 of `apps/projects/deploy-wire-protocol-project-app/docs/cutover.md` (`export-address-snapshot --check` per environment). Until then, these tests guard it:
+
+- `tests/deploymentInfo.test.ts` compares the snapshot to the deploymentInfo files still committed under `deployments/layerzero/<env>` (the published Canton mainnet and testnet packages).
+- `tests/addressResolutionParity.test.ts` checks that every address main resolved still resolves the same, which covers the rest (EVM, Starknet, Stellar and the other VMs).

package/dist/index.d.ts

@@ -1,6 +1,18 @@
 import type { NormalizedHexString } from '@layerzerolabs/common-chain-model';
 import type { ChainName } from '@layerzerolabs/layerzero-definitions';
 import { Environment } from '@layerzerolabs/layerzero-definitions';
+import { ProtocolContracts } from '@layerzerolabs/protocol-model';
+export type ProtocolSnapshotContract = ProtocolContracts.ENDPOINT_V2 | ProtocolContracts.ULN_V302_SEND | ProtocolContracts.ULN_V302_RECEIVE | ProtocolContracts.DVN | ProtocolContracts.EXECUTOR | ProtocolContracts.PRICE_FEED | ProtocolContracts.TREASURY | ProtocolContracts.EXECUTOR_FEELIB | ProtocolContracts.DVN_FEELIB | ProtocolContracts.BLOCKED_MESSAGE_LIB | ProtocolContracts.SIMPLE_MESSAGE_LIB | ProtocolContracts.OMNI_COUNTER;
+export declare const PROTOCOL_CONTRACT_SNAPSHOT_NAMES: Record<ProtocolSnapshotContract, string>;
+export declare const getProtocolSnapshotAddress: (contractName: string, chainName: ChainName, environment: Environment) => NormalizedHexString;
+export declare const listLZContractNames: () => string[];
+/** Address from the registry snapshot, else the frozen legacy table. */
 export declare const getLZContractAddressFromConfig: (contractName: string, chainName: ChainName, environment: Environment) => NormalizedHexString | undefined;
+/**
+ * Address getter for `contractName`: the tables first, then `alternativeAddressGetter`
+ * (an artifact package such as lz-evm-sdk-v2) for chains and contracts the registry does
+ * not cover. It falls back whenever the tables have no address, including for a protocol
+ * contract on a chain the registry snapshot covers.
+ */
 export declare const createLZContractAddressGetter: (contractName: string, alternativeAddressGetter: (chainName: ChainName, environment: Environment) => NormalizedHexString) => (chainName: ChainName, environment: Environment) => NormalizedHexString;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAkBnE,eAAO,MAAM,8BAA8B,iBACzB,MAAM,aACT,SAAS,eACP,WAAW,KACzB,mBAAmB,GAAG,SAGxB,CAAC;AAEF,eAAO,MAAM,6BAA6B,iBACxB,MAAM,4BACM,CACtB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,KACvB,mBAAmB,iBAEL,SAAS,eAAe,WAAW,wBAWzD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAuBlE,MAAM,MAAM,wBAAwB,GAC9B,iBAAiB,CAAC,WAAW,GAC7B,iBAAiB,CAAC,aAAa,GAC/B,iBAAiB,CAAC,gBAAgB,GAClC,iBAAiB,CAAC,GAAG,GACrB,iBAAiB,CAAC,QAAQ,GAC1B,iBAAiB,CAAC,UAAU,GAC5B,iBAAiB,CAAC,QAAQ,GAC1B,iBAAiB,CAAC,eAAe,GACjC,iBAAiB,CAAC,UAAU,GAC5B,iBAAiB,CAAC,mBAAmB,GACrC,iBAAiB,CAAC,kBAAkB,GACpC,iBAAiB,CAAC,YAAY,CAAC;AAErC,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAarF,CAAC;AAEF,eAAO,MAAM,0BAA0B,iBACrB,MAAM,aACT,SAAS,eACP,WAAW,KACzB,mBAQF,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,MAAM,EAQ5C,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,iBACzB,MAAM,aACT,SAAS,eACP,WAAW,KACzB,mBAAmB,GAAG,SAKxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,iBACxB,MAAM,4BACM,CACtB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,KACvB,mBAAmB,iBAEL,SAAS,eAAe,WAAW,wBAWzD,CAAC"}