@layerzerolabs/common-canton 1.2.62 → 1.2.64

package/dist/{FADZDRWB.js → LCM7LWM5.js}

@@ -1,13 +1,21 @@
 import { CANTON_DEFERRED_VALUE_SUFFIX, isCantonDeferredSentinel } from './QSQZYJB6.js';
 import { __name } from './VUOMXK5T.js';
-import { trim0x } from '@layerzerolabs/common-encoding-utils';
+import { hexZeroPad, trim0x } from '@layerzerolabs/common-encoding-utils';
 
 var CANTON_PARTY_ID_REGEX = /^(.+)::([0-9a-fA-F]+)$/;
 var CANTON_CONTRACT_ID_HEX_LENGTH = 138;
 var CANTON_PARTY_ADDRESS_PREFIX = "<<CANTON_PARTY::";
 var CANTON_CID_ADDRESS_PREFIX = "<<CANTON_CID::";
+var CANTON_GLOBAL_ADDRESS_PREFIX = "<<CANTON_GLOBAL::";
 var cantonPartyAddress = /* @__PURE__ */ __name((hint, fingerprint) => `${CANTON_PARTY_ADDRESS_PREFIX}${hint}::${fingerprint}${CANTON_DEFERRED_VALUE_SUFFIX}`, "cantonPartyAddress");
 var cantonCidAddress = /* @__PURE__ */ __name((contractId) => `${CANTON_CID_ADDRESS_PREFIX}${contractId}${CANTON_DEFERRED_VALUE_SUFFIX}`, "cantonCidAddress");
+var cantonGlobalAddress = /* @__PURE__ */ __name((address) => {
+  if (!/^(?:0x)?[0-9a-fA-F]{1,64}$/.test(address)) {
+    throw new Error(`Invalid Canton global bytes32 address: ${address}`);
+  }
+  return `${CANTON_GLOBAL_ADDRESS_PREFIX}${hexZeroPad(address, 32).toLowerCase()}${CANTON_DEFERRED_VALUE_SUFFIX}`;
+}, "cantonGlobalAddress");
+var isCantonGlobalAddress = /* @__PURE__ */ __name((value) => /^<<CANTON_GLOBAL::0x[0-9a-fA-F]{64}>>$/.test(value), "isCantonGlobalAddress");
 var cantonDeferredAddress = /* @__PURE__ */ __name((sentinel) => sentinel, "cantonDeferredAddress");
 var toCantonAddress = /* @__PURE__ */ __name((raw) => {
   if (isCantonDeferredSentinel(raw)) {
@@ -24,8 +32,8 @@ var toCantonAddress = /* @__PURE__ */ __name((raw) => {
   }
   throw new Error(`Not a Canton-native address: ${raw}`);
 }, "toCantonAddress");
-var isCantonAddress = /* @__PURE__ */ __name((value) => value.startsWith(CANTON_PARTY_ADDRESS_PREFIX) || value.startsWith(CANTON_CID_ADDRESS_PREFIX) || isCantonDeferredSentinel(value), "isCantonAddress");
+var isCantonAddress = /* @__PURE__ */ __name((value) => value.startsWith(CANTON_PARTY_ADDRESS_PREFIX) || value.startsWith(CANTON_CID_ADDRESS_PREFIX) || isCantonDeferredSentinel(value) || isCantonGlobalAddress(value), "isCantonAddress");
 
-export { CANTON_CID_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonPartyAddress, isCantonAddress, toCantonAddress };
-//# sourceMappingURL=FADZDRWB.js.map
-//# sourceMappingURL=FADZDRWB.js.map
+export { CANTON_CID_ADDRESS_PREFIX, CANTON_GLOBAL_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonGlobalAddress, cantonPartyAddress, isCantonAddress, isCantonGlobalAddress, toCantonAddress };
+//# sourceMappingURL=LCM7LWM5.js.map
+//# sourceMappingURL=LCM7LWM5.js.map

package/dist/LCM7LWM5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/address.ts"],"names":["CANTON_PARTY_ID_REGEX","CANTON_CONTRACT_ID_HEX_LENGTH","CANTON_PARTY_ADDRESS_PREFIX","CANTON_CID_ADDRESS_PREFIX","CANTON_GLOBAL_ADDRESS_PREFIX","cantonPartyAddress","hint","fingerprint","CANTON_DEFERRED_VALUE_SUFFIX","cantonCidAddress","contractId","cantonGlobalAddress","address","test","Error","hexZeroPad","toLowerCase","isCantonGlobalAddress","value","cantonDeferredAddress","sentinel","toCantonAddress","raw","isCantonDeferredSentinel","partyMatch","exec","bare","trim0x","length","startsWith","isCantonAddress"],"mappings":";;;;AAKA,IAAMA,qBAAAA,GAAwB,wBAAA;AAC9B,IAAMC,6BAAAA,GAAgC,GAAA;AAE/B,IAAMC,2BAAAA,GAA8B;AACpC,IAAMC,yBAAAA,GAA4B;AAClC,IAAMC,4BAAAA,GAA+B;AAMrC,IAAMC,kBAAAA,mBAAqB,MAAA,CAAA,CAACC,IAAAA,EAAcC,WAAAA,KAC7C,CAAA,EAAGL,2BAAAA,CAAAA,EAA8BI,IAAAA,CAAAA,EAAAA,EAASC,WAAAA,CAAAA,EAAcC,4BAAAA,CAAAA,CAAAA,EAD1B,oBAAA;AAI3B,IAAMC,gBAAAA,2BAAoBC,UAAAA,KAC7B,CAAA,EAAGP,yBAAAA,CAAAA,EAA4BO,UAAAA,CAAAA,EAAaF,4BAAAA,CAAAA,CAAAA,EADhB,kBAAA;AAIzB,IAAMG,mBAAAA,2BAAuBC,OAAAA,KAAAA;AAChC,EAAA,IAAI,CAAC,4BAAA,CAA6BC,IAAAA,CAAKD,OAAAA,CAAAA,EAAU;AAC7C,IAAA,MAAM,IAAIE,KAAAA,CAAM,CAAA,uCAAA,EAA0CF,OAAAA,CAAAA,CAAS,CAAA;AACvE,EAAA;AACA,EAAA,OAAO,CAAA,EAAGR,4BAAAA,CAAAA,EAA+BW,UAAAA,CAAWH,OAAAA,EAAS,EAAA,CAAA,CAAII,WAAAA,EAAW,CAAA,EAAKR,4BAAAA,CAAAA,CAAAA;AACrF,CAAA,EALmC,qBAAA;AAO5B,IAAMS,wCAAwB,MAAA,CAAA,CAACC,KAAAA,KAClC,wCAAA,CAAyCL,IAAAA,CAAKK,KAAAA,CAAAA,EADb,uBAAA;AAI9B,IAAMC,qBAAAA,mBAAwB,MAAA,CAAA,CAACC,QAAAA,KAAoCA,QAAAA,EAArC,uBAAA;AAG9B,IAAMC,eAAAA,2BAAmBC,GAAAA,KAAAA;AAC5B,EAAA,IAAIC,wBAAAA,CAAyBD,GAAAA,CAAAA,EAAM;AAC/B,IAAA,OAAOH,sBAAsBG,GAAAA,CAAAA;AACjC,EAAA;AACA,EAAA,MAAME,UAAAA,GAAaxB,qBAAAA,CAAsByB,IAAAA,CAAKH,GAAAA,CAAAA;AAC9C,EAAA,IAAIE,UAAAA,EAAY;AACZ,IAAA,MAAM,GAAGlB,IAAAA,EAAMC,WAAAA,CAAAA,GAAeiB,UAAAA;AAC9B,IAAA,OAAOnB,kBAAAA,CAAmBC,MAAOC,WAAAA,CAAAA;AACrC,EAAA;AACA,EAAA,MAAMmB,IAAAA,GAAOC,OAAOL,GAAAA,CAAAA;AACpB,EAAA,IAAII,KAAKE,MAAAA,KAAW3B,6BAAAA,IAAiCyB,IAAAA,CAAKG,UAAAA,CAAW,IAAA,CAAA,EAAO;AACxE,IAAA,OAAOpB,iBAAiBiB,IAAAA,CAAAA;AAC5B,EAAA;AACA,EAAA,MAAM,IAAIZ,KAAAA,CAAM,CAAA,6BAAA,EAAgCQ,GAAAA,CAAAA,CAAK,CAAA;AACzD,CAAA,EAd+B,iBAAA;AAiBxB,IAAMQ,kCAAkB,MAAA,CAAA,CAACZ,KAAAA,KAC5BA,KAAAA,CAAMW,UAAAA,CAAW3B,2BAAAA,CAAAA,IACjBgB,KAAAA,CAAMW,UAAAA,CAAW1B,yBAAAA,KACjBoB,wBAAAA,CAAyBL,KAAAA,CAAAA,IACzBD,qBAAAA,CAAsBC,KAAAA,CAAAA,EAJK,iBAAA","file":"LCM7LWM5.js","sourcesContent":["import { hexZeroPad, trim0x } from '@layerzerolabs/common-encoding-utils';\nimport type { Branded } from '@layerzerolabs/typescript-utils';\n\nimport { CANTON_DEFERRED_VALUE_SUFFIX, isCantonDeferredSentinel } from './deferredValue';\n\nconst CANTON_PARTY_ID_REGEX = /^(.+)::([0-9a-fA-F]+)$/;\nconst CANTON_CONTRACT_ID_HEX_LENGTH = 138; // 69 bytes\n\nexport const CANTON_PARTY_ADDRESS_PREFIX = '<<CANTON_PARTY::';\nexport const CANTON_CID_ADDRESS_PREFIX = '<<CANTON_CID::';\nexport const CANTON_GLOBAL_ADDRESS_PREFIX = '<<CANTON_GLOBAL::';\n\n/** A Canton ledger or VER global address, with an explicit sentinel prefix. */\nexport type CantonAddress = Branded<string, 'CantonAddress'>;\n\n/** Construct a party `CantonAddress` from hint and fingerprint. */\nexport const cantonPartyAddress = (hint: string, fingerprint: string): CantonAddress =>\n    `${CANTON_PARTY_ADDRESS_PREFIX}${hint}::${fingerprint}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;\n\n/** Construct a contract-ID `CantonAddress` from the raw 69-byte hex contract id. */\nexport const cantonCidAddress = (contractId: string): CantonAddress =>\n    `${CANTON_CID_ADDRESS_PREFIX}${contractId}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;\n\n/** Explicitly wrap an already-derived VER global address. This does not hash the input. */\nexport const cantonGlobalAddress = (address: string): CantonAddress => {\n    if (!/^(?:0x)?[0-9a-fA-F]{1,64}$/.test(address)) {\n        throw new Error(`Invalid Canton global bytes32 address: ${address}`);\n    }\n    return `${CANTON_GLOBAL_ADDRESS_PREFIX}${hexZeroPad(address, 32).toLowerCase()}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;\n};\n\nexport const isCantonGlobalAddress = (value: string): value is CantonAddress =>\n    /^<<CANTON_GLOBAL::0x[0-9a-fA-F]{64}>>$/.test(value);\n\n/** Wrap a deferred-ref sentinel (`<<CANTON_DEFERRED:{json}>>`) as a `CantonAddress`. */\nexport const cantonDeferredAddress = (sentinel: string): CantonAddress => sentinel as CantonAddress;\n\n/** Wrap a raw Canton ledger value (party id, contract id, or deferred sentinel) as `CantonAddress`. */\nexport const toCantonAddress = (raw: string): CantonAddress => {\n    if (isCantonDeferredSentinel(raw)) {\n        return cantonDeferredAddress(raw);\n    }\n    const partyMatch = CANTON_PARTY_ID_REGEX.exec(raw);\n    if (partyMatch) {\n        const [, hint, fingerprint] = partyMatch;\n        return cantonPartyAddress(hint!, fingerprint!);\n    }\n    const bare = trim0x(raw);\n    if (bare.length === CANTON_CONTRACT_ID_HEX_LENGTH && bare.startsWith('00')) {\n        return cantonCidAddress(bare);\n    }\n    throw new Error(`Not a Canton-native address: ${raw}`);\n};\n\n/** Returns true if `value` is a valid `CantonAddress` sentinel string. */\nexport const isCantonAddress = (value: string): value is CantonAddress =>\n    value.startsWith(CANTON_PARTY_ADDRESS_PREFIX) ||\n    value.startsWith(CANTON_CID_ADDRESS_PREFIX) ||\n    isCantonDeferredSentinel(value) ||\n    isCantonGlobalAddress(value);\n"]}

package/dist/address.d.ts

@@ -1,12 +1,16 @@
 import type { Branded } from '@layerzerolabs/typescript-utils';
 export declare const CANTON_PARTY_ADDRESS_PREFIX = "<<CANTON_PARTY::";
 export declare const CANTON_CID_ADDRESS_PREFIX = "<<CANTON_CID::";
-/** A Canton native address — a branded string with one of three sentinel-prefix forms. */
+export declare const CANTON_GLOBAL_ADDRESS_PREFIX = "<<CANTON_GLOBAL::";
+/** A Canton ledger or VER global address, with an explicit sentinel prefix. */
 export type CantonAddress = Branded<string, 'CantonAddress'>;
 /** Construct a party `CantonAddress` from hint and fingerprint. */
 export declare const cantonPartyAddress: (hint: string, fingerprint: string) => CantonAddress;
 /** Construct a contract-ID `CantonAddress` from the raw 69-byte hex contract id. */
 export declare const cantonCidAddress: (contractId: string) => CantonAddress;
+/** Explicitly wrap an already-derived VER global address. This does not hash the input. */
+export declare const cantonGlobalAddress: (address: string) => CantonAddress;
+export declare const isCantonGlobalAddress: (value: string) => value is CantonAddress;
 /** Wrap a deferred-ref sentinel (`<<CANTON_DEFERRED:{json}>>`) as a `CantonAddress`. */
 export declare const cantonDeferredAddress: (sentinel: string) => CantonAddress;
 /** Wrap a raw Canton ledger value (party id, contract id, or deferred sentinel) as `CantonAddress`. */

package/dist/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAO/D,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAC9D,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAE1D,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,aACoC,CAAC;AAE5G,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,aACyC,CAAC;AAEhG,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,aAA0C,CAAC;AAEpG,uGAAuG;AACvG,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,aAc7C,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,aAGtB,CAAC"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAO/D,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAC9D,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAC1D,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,aACoC,CAAC;AAE5G,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,aACyC,CAAC;AAEhG,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,aAKrD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,aACP,CAAC;AAEzD,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,aAA0C,CAAC;AAEpG,uGAAuG;AACvG,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,aAc7C,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,aAIzB,CAAC"}

package/dist/address.js

@@ -1,4 +1,4 @@
-export { CANTON_CID_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonPartyAddress, isCantonAddress, toCantonAddress } from './FADZDRWB.js';
+export { CANTON_CID_ADDRESS_PREFIX, CANTON_GLOBAL_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonGlobalAddress, cantonPartyAddress, isCantonAddress, isCantonGlobalAddress, toCantonAddress } from './LCM7LWM5.js';
 import './QSQZYJB6.js';
 import './VUOMXK5T.js';
 //# sourceMappingURL=address.js.map

package/dist/browser.js

@@ -1,4 +1,4 @@
-export { CANTON_CID_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonPartyAddress, isCantonAddress, toCantonAddress } from './FADZDRWB.js';
+export { CANTON_CID_ADDRESS_PREFIX, CANTON_GLOBAL_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonGlobalAddress, cantonPartyAddress, isCantonAddress, isCantonGlobalAddress, toCantonAddress } from './LCM7LWM5.js';
 export { SECP256K1_SPKI_DER_HEADER, SECP256K1_SPKI_DER_HEADER_HEX, derEncodeSignature, publicKeyToSpkiDer } from './CMDFOA7C.js';
 export { assertHexLength, codePointLength, formatDamlDecimal, intToHex, keccak256Hex, padLeft, showBool, showInt, textToHex, timeToUnixSeconds, toBigInt } from './EZIA6KIP.js';
 export { CANTON_DEFERRED_SENDER, CANTON_DEFERRED_VALUE_PREFIX, CANTON_DEFERRED_VALUE_SUFFIX, cantonActiveContractIdRef, cantonActiveContractIdsRef, cantonAmuletContextRef, cantonAmuletRulesCidRef, cantonDeferredSenderSchema, cantonDeferredValueSchema, cantonExpectedSignatoriesSchema, cantonRefreshPartyFilterSchema, cantonSenderPartyRef, encodeCantonDeferredValue, isCantonDeferredSender, isCantonDeferredSentinel, isCantonPlaceholder, parseCantonDeferredValue, parseCantonDeferredValueOrThrow } from './QSQZYJB6.js';

package/dist/index.js

@@ -1,11 +1,11 @@
-import './5GUYLHA7.js';
-export { CantonSdk } from './D52OIJDY.js';
 import './AQJMQQ4W.js';
 export { buildCantonDeployedContractAddressRef, qualifiedTemplateName, templateIdMatches } from './XWKAFAGE.js';
 export { resolveCantonTransaction } from './AM6OIKMW.js';
 export { createContractAddressResolver, isConcreteActiveContractRef, isRefAlive, matchesContractStateFilter, queryLiveContractIdsForRef, queryLiveContractsForRef, resolveContractStateFilter, resolveExpectedSignatories } from './75B7Y26B.js';
 export { wrapLzSdk } from './HF5HP2EX.js';
 export { substituteCidsToRefs, substituteRefsToCids } from './WLHCBBAJ.js';
+import './5GUYLHA7.js';
+export { CantonSdk } from './D52OIJDY.js';
 import './7JX6NIYS.js';
 export { buildMultiTransactionSignatures, buildSignedTransaction } from './WKC6X2E3.js';
 import './IIWYAFUO.js';
@@ -309,7 +309,7 @@ import './RSV7WS7X.js';
 export { LocalTokenProvider } from './YF7P4UQM.js';
 export { ClientCredentialsTokenProvider } from './V2H2WXKE.js';
 export { parseAmuletAmount, parseAmuletDecimal } from './CXTOAS7N.js';
-export { CANTON_CID_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonPartyAddress, isCantonAddress, toCantonAddress } from './FADZDRWB.js';
+export { CANTON_CID_ADDRESS_PREFIX, CANTON_GLOBAL_ADDRESS_PREFIX, CANTON_PARTY_ADDRESS_PREFIX, cantonCidAddress, cantonDeferredAddress, cantonGlobalAddress, cantonPartyAddress, isCantonAddress, isCantonGlobalAddress, toCantonAddress } from './LCM7LWM5.js';
 export { SECP256K1_SPKI_DER_HEADER, SECP256K1_SPKI_DER_HEADER_HEX, derEncodeSignature, publicKeyToSpkiDer } from './CMDFOA7C.js';
 export { assertHexLength, codePointLength, formatDamlDecimal, intToHex, keccak256Hex, padLeft, showBool, showInt, textToHex, timeToUnixSeconds, toBigInt } from './EZIA6KIP.js';
 export { CANTON_DEFERRED_SENDER, CANTON_DEFERRED_VALUE_PREFIX, CANTON_DEFERRED_VALUE_SUFFIX, cantonActiveContractIdRef, cantonActiveContractIdsRef, cantonAmuletContextRef, cantonAmuletRulesCidRef, cantonDeferredSenderSchema, cantonDeferredValueSchema, cantonExpectedSignatoriesSchema, cantonRefreshPartyFilterSchema, cantonSenderPartyRef, encodeCantonDeferredValue, isCantonDeferredSender, isCantonDeferredSentinel, isCantonPlaceholder, parseCantonDeferredValue, parseCantonDeferredValueOrThrow } from './QSQZYJB6.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/common-canton",
-  "version": "1.2.62",
+  "version": "1.2.64",
   "private": false,
   "description": "Canton VM client and utilities",
   "license": "MIT",
@@ -37,10 +37,10 @@
     "@protobuf-ts/runtime-rpc": "^2.11.1",
     "es-toolkit": "^1.39.10",
     "zod": "4.3.5",
-    "@layerzerolabs/common-encoding-utils": "1.2.62",
-    "@layerzerolabs/common-chain-model": "1.2.62",
-    "@layerzerolabs/typescript-utils": "1.2.62",
-    "@layerzerolabs/common-error-utils": "1.2.62"
+    "@layerzerolabs/common-chain-model": "1.2.64",
+    "@layerzerolabs/common-error-utils": "1.2.64",
+    "@layerzerolabs/common-encoding-utils": "1.2.64",
+    "@layerzerolabs/typescript-utils": "1.2.64"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
@@ -48,11 +48,11 @@
     "tsup": "^8.4.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@layerzerolabs/eslint-configuration": "^1.2.62",
-    "@layerzerolabs/typescript-configuration": "1.2.62",
-    "@layerzerolabs/vitest-configuration": "1.2.62",
-    "@layerzerolabs/tsup-configuration": "1.2.62",
-    "@layerzerolabs/vm-tooling-canton": "1.2.62"
+    "@layerzerolabs/eslint-configuration": "^1.2.64",
+    "@layerzerolabs/tsup-configuration": "1.2.64",
+    "@layerzerolabs/vitest-configuration": "1.2.64",
+    "@layerzerolabs/typescript-configuration": "1.2.64",
+    "@layerzerolabs/vm-tooling-canton": "1.2.64"
   },
   "publishConfig": {
     "access": "public",

package/src/address.ts

@@ -1,4 +1,4 @@
-import { trim0x } from '@layerzerolabs/common-encoding-utils';
+import { hexZeroPad, trim0x } from '@layerzerolabs/common-encoding-utils';
 import type { Branded } from '@layerzerolabs/typescript-utils';
 
 import { CANTON_DEFERRED_VALUE_SUFFIX, isCantonDeferredSentinel } from './deferredValue';
@@ -8,8 +8,9 @@ const CANTON_CONTRACT_ID_HEX_LENGTH = 138; // 69 bytes
 
 export const CANTON_PARTY_ADDRESS_PREFIX = '<<CANTON_PARTY::';
 export const CANTON_CID_ADDRESS_PREFIX = '<<CANTON_CID::';
+export const CANTON_GLOBAL_ADDRESS_PREFIX = '<<CANTON_GLOBAL::';
 
-/** A Canton native address — a branded string with one of three sentinel-prefix forms. */
+/** A Canton ledger or VER global address, with an explicit sentinel prefix. */
 export type CantonAddress = Branded<string, 'CantonAddress'>;
 
 /** Construct a party `CantonAddress` from hint and fingerprint. */
@@ -20,6 +21,17 @@ export const cantonPartyAddress = (hint: string, fingerprint: string): CantonAdd
 export const cantonCidAddress = (contractId: string): CantonAddress =>
     `${CANTON_CID_ADDRESS_PREFIX}${contractId}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;
 
+/** Explicitly wrap an already-derived VER global address. This does not hash the input. */
+export const cantonGlobalAddress = (address: string): CantonAddress => {
+    if (!/^(?:0x)?[0-9a-fA-F]{1,64}$/.test(address)) {
+        throw new Error(`Invalid Canton global bytes32 address: ${address}`);
+    }
+    return `${CANTON_GLOBAL_ADDRESS_PREFIX}${hexZeroPad(address, 32).toLowerCase()}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;
+};
+
+export const isCantonGlobalAddress = (value: string): value is CantonAddress =>
+    /^<<CANTON_GLOBAL::0x[0-9a-fA-F]{64}>>$/.test(value);
+
 /** Wrap a deferred-ref sentinel (`<<CANTON_DEFERRED:{json}>>`) as a `CantonAddress`. */
 export const cantonDeferredAddress = (sentinel: string): CantonAddress => sentinel as CantonAddress;
 
@@ -44,4 +56,5 @@ export const toCantonAddress = (raw: string): CantonAddress => {
 export const isCantonAddress = (value: string): value is CantonAddress =>
     value.startsWith(CANTON_PARTY_ADDRESS_PREFIX) ||
     value.startsWith(CANTON_CID_ADDRESS_PREFIX) ||
-    isCantonDeferredSentinel(value);
+    isCantonDeferredSentinel(value) ||
+    isCantonGlobalAddress(value);

package/dist/FADZDRWB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/address.ts"],"names":["CANTON_PARTY_ID_REGEX","CANTON_CONTRACT_ID_HEX_LENGTH","CANTON_PARTY_ADDRESS_PREFIX","CANTON_CID_ADDRESS_PREFIX","cantonPartyAddress","hint","fingerprint","CANTON_DEFERRED_VALUE_SUFFIX","cantonCidAddress","contractId","cantonDeferredAddress","sentinel","toCantonAddress","raw","isCantonDeferredSentinel","partyMatch","exec","bare","trim0x","length","startsWith","Error","isCantonAddress","value"],"mappings":";;;;AAKA,IAAMA,qBAAAA,GAAwB,wBAAA;AAC9B,IAAMC,6BAAAA,GAAgC,GAAA;AAE/B,IAAMC,2BAAAA,GAA8B;AACpC,IAAMC,yBAAAA,GAA4B;AAMlC,IAAMC,kBAAAA,mBAAqB,MAAA,CAAA,CAACC,IAAAA,EAAcC,WAAAA,KAC7C,CAAA,EAAGJ,2BAAAA,CAAAA,EAA8BG,IAAAA,CAAAA,EAAAA,EAASC,WAAAA,CAAAA,EAAcC,4BAAAA,CAAAA,CAAAA,EAD1B,oBAAA;AAI3B,IAAMC,gBAAAA,2BAAoBC,UAAAA,KAC7B,CAAA,EAAGN,yBAAAA,CAAAA,EAA4BM,UAAAA,CAAAA,EAAaF,4BAAAA,CAAAA,CAAAA,EADhB,kBAAA;AAIzB,IAAMG,qBAAAA,mBAAwB,MAAA,CAAA,CAACC,QAAAA,KAAoCA,QAAAA,EAArC,uBAAA;AAG9B,IAAMC,eAAAA,2BAAmBC,GAAAA,KAAAA;AAC5B,EAAA,IAAIC,wBAAAA,CAAyBD,GAAAA,CAAAA,EAAM;AAC/B,IAAA,OAAOH,sBAAsBG,GAAAA,CAAAA;AACjC,EAAA;AACA,EAAA,MAAME,UAAAA,GAAaf,qBAAAA,CAAsBgB,IAAAA,CAAKH,GAAAA,CAAAA;AAC9C,EAAA,IAAIE,UAAAA,EAAY;AACZ,IAAA,MAAM,GAAGV,IAAAA,EAAMC,WAAAA,CAAAA,GAAeS,UAAAA;AAC9B,IAAA,OAAOX,kBAAAA,CAAmBC,MAAOC,WAAAA,CAAAA;AACrC,EAAA;AACA,EAAA,MAAMW,IAAAA,GAAOC,OAAOL,GAAAA,CAAAA;AACpB,EAAA,IAAII,KAAKE,MAAAA,KAAWlB,6BAAAA,IAAiCgB,IAAAA,CAAKG,UAAAA,CAAW,IAAA,CAAA,EAAO;AACxE,IAAA,OAAOZ,iBAAiBS,IAAAA,CAAAA;AAC5B,EAAA;AACA,EAAA,MAAM,IAAII,KAAAA,CAAM,CAAA,6BAAA,EAAgCR,GAAAA,CAAAA,CAAK,CAAA;AACzD,CAAA,EAd+B,iBAAA;AAiBxB,IAAMS,eAAAA,mBAAkB,MAAA,CAAA,CAACC,KAAAA,KAC5BA,KAAAA,CAAMH,UAAAA,CAAWlB,2BAAAA,CAAAA,IACjBqB,KAAAA,CAAMH,UAAAA,CAAWjB,yBAAAA,CAAAA,IACjBW,wBAAAA,CAAyBS,KAAAA,CAAAA,EAHE,iBAAA","file":"FADZDRWB.js","sourcesContent":["import { trim0x } from '@layerzerolabs/common-encoding-utils';\nimport type { Branded } from '@layerzerolabs/typescript-utils';\n\nimport { CANTON_DEFERRED_VALUE_SUFFIX, isCantonDeferredSentinel } from './deferredValue';\n\nconst CANTON_PARTY_ID_REGEX = /^(.+)::([0-9a-fA-F]+)$/;\nconst CANTON_CONTRACT_ID_HEX_LENGTH = 138; // 69 bytes\n\nexport const CANTON_PARTY_ADDRESS_PREFIX = '<<CANTON_PARTY::';\nexport const CANTON_CID_ADDRESS_PREFIX = '<<CANTON_CID::';\n\n/** A Canton native address — a branded string with one of three sentinel-prefix forms. */\nexport type CantonAddress = Branded<string, 'CantonAddress'>;\n\n/** Construct a party `CantonAddress` from hint and fingerprint. */\nexport const cantonPartyAddress = (hint: string, fingerprint: string): CantonAddress =>\n    `${CANTON_PARTY_ADDRESS_PREFIX}${hint}::${fingerprint}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;\n\n/** Construct a contract-ID `CantonAddress` from the raw 69-byte hex contract id. */\nexport const cantonCidAddress = (contractId: string): CantonAddress =>\n    `${CANTON_CID_ADDRESS_PREFIX}${contractId}${CANTON_DEFERRED_VALUE_SUFFIX}` as CantonAddress;\n\n/** Wrap a deferred-ref sentinel (`<<CANTON_DEFERRED:{json}>>`) as a `CantonAddress`. */\nexport const cantonDeferredAddress = (sentinel: string): CantonAddress => sentinel as CantonAddress;\n\n/** Wrap a raw Canton ledger value (party id, contract id, or deferred sentinel) as `CantonAddress`. */\nexport const toCantonAddress = (raw: string): CantonAddress => {\n    if (isCantonDeferredSentinel(raw)) {\n        return cantonDeferredAddress(raw);\n    }\n    const partyMatch = CANTON_PARTY_ID_REGEX.exec(raw);\n    if (partyMatch) {\n        const [, hint, fingerprint] = partyMatch;\n        return cantonPartyAddress(hint!, fingerprint!);\n    }\n    const bare = trim0x(raw);\n    if (bare.length === CANTON_CONTRACT_ID_HEX_LENGTH && bare.startsWith('00')) {\n        return cantonCidAddress(bare);\n    }\n    throw new Error(`Not a Canton-native address: ${raw}`);\n};\n\n/** Returns true if `value` is a valid `CantonAddress` sentinel string. */\nexport const isCantonAddress = (value: string): value is CantonAddress =>\n    value.startsWith(CANTON_PARTY_ADDRESS_PREFIX) ||\n    value.startsWith(CANTON_CID_ADDRESS_PREFIX) ||\n    isCantonDeferredSentinel(value);\n"]}