@layerzerolabs/common-canton 1.2.67 → 1.2.69

package/dist/index.js

@@ -1,51 +1,54 @@
-import './AQJMQQ4W.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 './6UDREB6T.js';
+export { wrapLzSdk } from './HF5HP2EX.js';
+export { resolveCantonTransaction } from './K3ZNKULN.js';
+export { substituteCidsToRefs, substituteRefsToCids } from './WLHCBBAJ.js';
+export { resolveCantonActiveContracts, resolveCantonRefreshPlan, selectContractsByGte } from './SIBBQMZE.js';
+export { createContractAddressResolver, isConcreteActiveContractRef, isRefAlive, matchesContractStateFilter, queryLiveContractIdsForRef, queryLiveContractsForRef, resolveContractStateFilter, resolveExpectedSignatories } from './42L4RKH6.js';
 import './7JX6NIYS.js';
 export { buildMultiTransactionSignatures, buildSignedTransaction } from './WKC6X2E3.js';
 import './IIWYAFUO.js';
 export { parseMinFeeValue } from './M3GPMXME.js';
-export { createCantonChainProvider, parseCantonChainUri } from './UVTS5LAN.js';
-export { CantonClient } from './46AEW4RY.js';
-import './5HH7PZW3.js';
+export { createCantonChainProvider, parseCantonChainUri } from './XPBJWESZ.js';
+export { CantonClient } from './MI3L7BKC.js';
+import './B42Y5JOK.js';
 import './6CPYXAOF.js';
+import './4MFKSIYK.js';
+import './5KFMHJZB.js';
+import './76PPVRJ6.js';
 import './F6OBDGNC.js';
 import './Q3CWBD5A.js';
 import './DUQWP47Z.js';
 import './3YMFQHQ2.js';
 import './YG6MDQAI.js';
-import './WSLU3JGO.js';
-import './QYQWHMQM.js';
-import './76PPVRJ6.js';
 import './6K3YSZCK.js';
 import './Y7ND62EN.js';
-import './UQMKPY2S.js';
-import './FB6G6OD4.js';
 import './PGQCNYFD.js';
+import './TAI7WDMG.js';
+import './FB6G6OD4.js';
 import './ZGWBZC76.js';
-import './UBHUOSK3.js';
-import './2UKHG3HM.js';
-import './FCOOEGLV.js';
-import './V6WKCZKX.js';
-import './KSW67SU5.js';
+import './BLWJ63ZZ.js';
+import './JG3CGXAA.js';
+import './EITKKRM7.js';
+import './HGLH54M2.js';
+import './X5Q5IDTX.js';
 import './RW5PUYQM.js';
 import './UZEQR4K7.js';
+import './KSW67SU5.js';
 import './JOKWDCVQ.js';
-import './BLWJ63ZZ.js';
-import './JXKVPYCE.js';
-import './T6UKLW2J.js';
-import './4GB3DPXG.js';
-import './UYKPXKW5.js';
+import './JH2I4JGJ.js';
 import './FEAZ4ULP.js';
 import './SZLSOCSR.js';
 import './QCG5SPPK.js';
 import './NU7VYPQS.js';
+import './T6UKLW2J.js';
+import './4GB3DPXG.js';
+import './UYKPXKW5.js';
 import './X4YPYKWZ.js';
-import './7GI6QGS6.js';
+import './5PL2GRP6.js';
+import './DNH3CRBL.js';
+import './VBS2IYYS.js';
 import './KKCWYT6E.js';
 import './S7OPYTA6.js';
 import './KFPAEUU7.js';
@@ -54,42 +57,33 @@ import './NOXVUNXQ.js';
 import './ZBDCYY5O.js';
 import './TKTYXEED.js';
 import './QKX6RB6N.js';
-import './5PL2GRP6.js';
-import './DNH3CRBL.js';
-import './3T46OKQU.js';
-import './LL7Z56UN.js';
 import './KCRFOKIB.js';
-import './LYW3PRU5.js';
-import './ZPOY5WJ2.js';
-import './BL22CZFA.js';
-import './EWDK2D2A.js';
-import './H5WF7YON.js';
+import './ZQ2F7HPB.js';
+import './53STMMNU.js';
+import './3T46OKQU.js';
+import './IHOOPR5Q.js';
+import './LS6TAA3S.js';
+import './BA56KCNU.js';
+import './ZILWPZLS.js';
+import './Z2TOQ5RW.js';
 import './2633VCK5.js';
-import './A3YRP3CP.js';
+import './EWDK2D2A.js';
+import './MLPZRNZP.js';
+import './HCWCELIY.js';
 import './IIQYRITU.js';
 import './CDHOTGTN.js';
-import './HLWLB4AY.js';
-import './Q3RL6UXD.js';
-import './53STMMNU.js';
-import './MZMRFQTR.js';
-import './QZJONP6W.js';
-import './7STDATVZ.js';
-import './34I4OGQK.js';
-import './MXJ2SKCA.js';
-import './6GAFSKMN.js';
-import './6GU7J47E.js';
-import './MOQL7EDE.js';
-import './K3RKYYAJ.js';
-import './WQJNYC3S.js';
+import './NMK4KJVK.js';
+import './J26F3LZM.js';
 import './N2H3JQGZ.js';
-import './MFVQ6EHM.js';
-import './KTNEUXUI.js';
-import './5RZS7DZN.js';
-import './YMURVGWI.js';
+import './WQJNYC3S.js';
+import './T5O5EZO2.js';
+import './5GUS3R4R.js';
 import './GSEDMLUC.js';
 import './KBZ6YXX4.js';
-import './5N747JZQ.js';
+import './5RZS7DZN.js';
+import './YMURVGWI.js';
 import './73I7CBP3.js';
+import './5N747JZQ.js';
 import './TDLALQCM.js';
 import './DDITSIMP.js';
 import './4GYCD3G4.js';
@@ -99,19 +93,39 @@ import './MS6MVDLI.js';
 import './YUSKGBOM.js';
 import './ELKKWJ73.js';
 import './SSIXD5B2.js';
+import './L4NQUCEZ.js';
+import './5235KHHW.js';
 import './C7EKAFQT.js';
 import './FB4MMBJU.js';
 import './WE3VOYW4.js';
 import './BITUOW7N.js';
-import './L4NQUCEZ.js';
-import './5235KHHW.js';
 import './WXYN3MFC.js';
 import './KVXEYMWG.js';
 import './GJNXH4RV.js';
 import './T7UHDP5T.js';
 import './2UG7UYH5.js';
+import './HLEDC536.js';
+import './VWP2ORHR.js';
+import './MZMRFQTR.js';
+import './QZJONP6W.js';
+import './7STDATVZ.js';
+import './LQ3LPE4G.js';
+import './LJWTM73C.js';
+import './A7U4VVQK.js';
+import './WRPKZZ4E.js';
+import './3JWW6VWI.js';
+import './BWCLX6XE.js';
+import './HTXBXFKR.js';
+import './JJLCFUQT.js';
+import './PVD6NHYE.js';
+import './34I4OGQK.js';
+import './MXJ2SKCA.js';
+import './LXIBC5QC.js';
+import './6GAFSKMN.js';
 import './JKQLMXRN.js';
-import './ALC4M7WK.js';
+import './2QISQFNQ.js';
+import './3R25GDYP.js';
+import './CM3AEJH2.js';
 import './RV24CYI3.js';
 import './XINHRIWA.js';
 import './TJBQSG4B.js';
@@ -121,87 +135,80 @@ import './DB3ADDKC.js';
 import './DCWJXAUI.js';
 import './VJINT4U6.js';
 import './OPRFXRK5.js';
-import './LXIBC5QC.js';
-import './CLAE73FR.js';
-import './LQ3LPE4G.js';
-import './LJWTM73C.js';
-import './A7U4VVQK.js';
-import './WRPKZZ4E.js';
-import './3JWW6VWI.js';
-import './BWCLX6XE.js';
-import './HTXBXFKR.js';
-import './PVD6NHYE.js';
-import './JJLCFUQT.js';
 import './NIN7X4D3.js';
 import './IROQTIJZ.js';
 import './GBFMX33M.js';
-import './2QISQFNQ.js';
-import './3R25GDYP.js';
-import './45YQNHS2.js';
+import './WLJJ4FDL.js';
+import './2PMOI5F3.js';
+import './C46IODEA.js';
 import './VQXHCSJ4.js';
+import './LEDX6CMV.js';
+import './2BIDSJF6.js';
+import './G4FJL7ZV.js';
+import './WJFNYWLV.js';
 import './D5KKWJ4T.js';
-import './4AM6UVPL.js';
-import './W53LLP7R.js';
-import './YN7J2UOM.js';
-import './25GNLJIH.js';
-import './TL2NURGK.js';
-import './CLFKYN43.js';
+import './UUJVV37M.js';
+import './NAKXSYHE.js';
+import './5O7CQ3B5.js';
+import './XFM6ATM3.js';
+import './7QVLLG7J.js';
+import './H2QNCZZP.js';
+import './P6RLTY4Q.js';
 import './RPOQ54PG.js';
 import './OH7SHQF6.js';
-import './VVR6BIVE.js';
-import './WLJJ4FDL.js';
-import './5OA7RJHH.js';
+import './SPMIXP6R.js';
+import './AXXLRBOT.js';
+import './OMKZNVQ6.js';
 import './PBBQTZR5.js';
 import './FXR2Z54G.js';
 import './KOUK7GBL.js';
 import './HZG6J4V4.js';
 import './RY2LC7P3.js';
 import './GJPYFCRF.js';
-import './LEDX6CMV.js';
-import './2BIDSJF6.js';
-import './UUJVV37M.js';
-import './G4FJL7ZV.js';
-import './WJFNYWLV.js';
+import './DAP5XJGH.js';
+import './65PSGOOO.js';
+import './57DRTFD5.js';
+import './JDRCVB2P.js';
+import './2CWG6G2U.js';
 import './LX4D3IC6.js';
 import './I2M5WSEM.js';
 import './QDOJTBN4.js';
 import './BXDXCO3L.js';
-import './NWXHRFA3.js';
-import './ICTUC6FF.js';
+import './VNAH76JJ.js';
+import './UZTJVHNP.js';
 import './SF7H2DPL.js';
-import './4UM5TVKI.js';
-import './OMKZNVQ6.js';
+import './4XJYWTSD.js';
 import './R6RFWKWB.js';
-import './DAP5XJGH.js';
-import './65PSGOOO.js';
-import './57DRTFD5.js';
-import './JDRCVB2P.js';
-import './2CWG6G2U.js';
 import './42XERBT4.js';
 import './KLGD7ZKC.js';
 import './FSI4ML2J.js';
+import './UKPTMFE5.js';
 import './JRFMLEIC.js';
-import './37DZS34C.js';
-import './CXFHE5WB.js';
+import './UOJYTAJA.js';
+import './TKPU3I2P.js';
 import './NXFOIDBZ.js';
 import './YYZ6GHBF.js';
 import './WEB5TZQE.js';
 import './6HBTMZ2U.js';
-import './4XJYWTSD.js';
 import './AMLJTQWB.js';
 import './AONQHJ67.js';
 import './223ZGSPH.js';
 import './W3V3QO3M.js';
-import './UKPTMFE5.js';
+import './7QB5CK2R.js';
 import './5KFH4GBA.js';
-import './JQKAQ6XO.js';
+import './JRALW2JZ.js';
+import './5C4DHFKJ.js';
 import './6DNDE3V5.js';
 import './VEDIQN4O.js';
-import './5C4DHFKJ.js';
 import './N4ZM4N2T.js';
-import './NS763D57.js';
-import './HRZTWWO4.js';
-import './K2SFNQJC.js';
+import './JNFIJ7LA.js';
+import './YJ63OODS.js';
+import './TGNRKR6H.js';
+import './WS55YOW3.js';
+import './S5X72W5R.js';
+import './NXLM7ANC.js';
+import './ZGT2WRBJ.js';
+import './CWZMBPM3.js';
 import './YQIQBEDK.js';
 import './RT5FBW5C.js';
 import './AHL4CCNO.js';
@@ -209,16 +216,17 @@ import './KHRPAP5A.js';
 import './2F66XH7X.js';
 import './OLOOZCJ6.js';
 import './UFRAGOR4.js';
-import './ZGT2WRBJ.js';
-import './CWZMBPM3.js';
 import './FKJBUIAF.js';
 import './ZDVQJMLH.js';
 import './5ZZP4T75.js';
 import './6L7QPUXX.js';
 import './2I2KZ57G.js';
 import './4ABHRM2Z.js';
-import './REC34FNU.js';
-import './YAMAXOF4.js';
+import './KYQVWBET.js';
+import './2NZC3LBF.js';
+import './I42TYLNY.js';
+import './Z2PCDUTA.js';
+import './VZY2QLIH.js';
 import './E3S4Q7BW.js';
 import './OVI22V4D.js';
 import './X74MS4NY.js';
@@ -226,41 +234,39 @@ import './T2TBHOJW.js';
 import './V6YYBQQ7.js';
 import './VMMOYWRH.js';
 import './M4ENXXGH.js';
-import './I42TYLNY.js';
-import './Z2PCDUTA.js';
-import './VZY2QLIH.js';
 import './FBZYVJHN.js';
-import './7QB5CK2R.js';
-import './O6E7FCNL.js';
+import './JVRWQ36T.js';
+import './OU6ZGOI7.js';
 import './6CDYG5J4.js';
 import './YO6M5EI2.js';
 import './4FVB5LZE.js';
-import './JNFIJ7LA.js';
-import './YJ63OODS.js';
-import './TGNRKR6H.js';
-import './K7VI5TVN.js';
-import './TIKYUQ7Z.js';
-import './WH4AALW7.js';
-import './CXV5NOWI.js';
+import './SUQRZQJZ.js';
+import './OV57R5W2.js';
+import './24YQIQ26.js';
+import './AADTV7OJ.js';
+import './CPODYNES.js';
+import './CYUO5SRQ.js';
+import './5LBZE3FZ.js';
 import './P4OZVLZ5.js';
-import './Z74KDZ47.js';
-import './4XVTGYYU.js';
+import './JEVZBCKB.js';
 import './B5NXLJBP.js';
-import './57SJMVEE.js';
 import './XHRPB5KB.js';
+import './57SJMVEE.js';
+import './4XVTGYYU.js';
+import './2Y3QRNON.js';
 import './TQODWV5P.js';
 import './GEKUWBT6.js';
-import './2Y3QRNON.js';
 import './KIXMSGXW.js';
 import './PXLKEN6Q.js';
 import './QMG5HIWM.js';
-import './ZLGKSCEZ.js';
-import './OV57R5W2.js';
-import './24YQIQ26.js';
-import './AADTV7OJ.js';
 import './BMVKXYRP.js';
-import './JVRWQ36T.js';
-import './JSG7MGHH.js';
+import './ZLGKSCEZ.js';
+import './I6JD5SVF.js';
+import './OR2CV5NU.js';
+import './LQUUIINH.js';
+import './FV6OZTC6.js';
+import './EIJI6ZMQ.js';
+import './H5NCYXPN.js';
 import './BZIM4HLD.js';
 import './X6CZGKDI.js';
 import './UO7AO4TN.js';
@@ -271,10 +277,8 @@ import './WSW75GTU.js';
 import './O6CDI3U6.js';
 import './I3OMGYUX.js';
 import './QYESYTLQ.js';
-import './LQUUIINH.js';
-import './FV6OZTC6.js';
-import './EIJI6ZMQ.js';
-import './H5NCYXPN.js';
+import './TSE2DUDN.js';
+import './EE2Y3CQ3.js';
 import './5NV4O3K7.js';
 import './XOLOXB7M.js';
 import './QNJSSXUH.js';
@@ -282,7 +286,6 @@ import './S3CSDPDX.js';
 import './IXH2E5MF.js';
 import './KNH4DSGV.js';
 import './ZAFXW6OP.js';
-import './I6JD5SVF.js';
 import './TVDUWBAO.js';
 import './Q7CJWR7Y.js';
 import './V6427LHF.js';
@@ -292,14 +295,12 @@ import './AJ4M7JFK.js';
 import './26MNW5VA.js';
 import './BHV6BRHZ.js';
 import './PY4KJ4FA.js';
-import './TSE2DUDN.js';
-import './EE2Y3CQ3.js';
 export { Configuration, ResponseError } from './KBNUN3MF.js';
 export { AMULET_INSTRUMENT_ID, fetchAcceptContext, fetchAmuletContext, fetchAmuletRules, fetchDsoParty, fetchOpenAndIssuingMiningRounds, injectExternalPartyAmuletRules, toDisclosedContract } from './SEKD553P.js';
-export { CantonGrpcClient } from './BFQYTMKD.js';
+export { CantonGrpcClient } from './6AK25YSE.js';
+export { computeDecentralizedNamespace, computeMultiTransactionHash } from './PL4H5XEA.js';
 import './RVQWP4JU.js';
 import './VJ4PVZYL.js';
-export { computeDecentralizedNamespace, computeMultiTransactionHash } from './PL4H5XEA.js';
 export { cantonMultihash, computeCantonFingerprint, computePublicKeyFingerprint, extractTransactions } from './WLV6EHDB.js';
 export { CommandStatus, IntLikeSchema, buildTemplateId, canonicalizeDamlDecimal, smallestUnitsToDamlDecimal } from './4WZTQJXP.js';
 import './35ELVFTS.js';
@@ -311,9 +312,10 @@ export { CANTON_CID_ADDRESS_PREFIX, CANTON_GLOBAL_ADDRESS_PREFIX, CANTON_PARTY_A
 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 { CantonApiError, CantonError, CantonProtocolError, CantonTransportError, cantonApiErrorFromResponse, isRetryableCantonError } from './3K5JL2TP.js';
-export { cantonDeploymentSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx, getExercisedEvent, waitForArchival } from './3OGBXJQ5.js';
+export { cantonDeploymentSucceeded, fetchCreatedEvents, findMatchingCreatedEvent, findMatchingCreatedEventFromTx, getExercisedEvent, waitForArchival } from './3EBJKA4R.js';
 export { buildCantonDeployedContractAddressRef, qualifiedTemplateName, templateIdMatches } from './PXHLNX4K.js';
-export { buildCantonTransaction, cantonAssignedTransactionSchema, cantonCommandSchema, cantonDisclosedContractSchema, cantonMinedTransactionSchema, cantonSignedTransactionSchema, cantonTransactionSchema, cantonTransactionWithResultSchema, unresolvedCantonCommandSchema } from './4AR5H4U6.js';
+export { buildCantonTransaction, cantonAssignedTransactionSchema, cantonCommandSchema, cantonDisclosedContractSchema, cantonMinedTransactionSchema, cantonSignedTransactionSchema, cantonTransactionSchema, cantonTransactionWithResultSchema, unresolvedCantonCommandSchema } from './SYYLQ25A.js';
+export { cantonActiveContractSelectionSchema, cantonArgumentRefreshTargetSchema, cantonRefreshPathSchema, cantonRefreshPathSegmentSchema, cantonRefreshPlanSchema, cantonRefreshSchema, cantonRefreshTargetSchema } from './TIYP6NEB.js';
 export { areExpectedSignatories, getCreateArgumentField, isSignatoryOrigin, isTrustedOrigin } from './SWY4QT4I.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';
 import './VUOMXK5T.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/common-canton",
-  "version": "1.2.67",
+  "version": "1.2.69",
   "private": false,
   "description": "Canton VM client and utilities",
   "license": "MIT",
@@ -29,10 +29,10 @@
     "@canton-network/core-ledger-proto": "^1.7.0",
     "@daml/types": "3.4.8",
     "@grpc/grpc-js": "^1.12.0",
-    "@layerzerolabs/common-chain-model": "1.2.67",
-    "@layerzerolabs/common-encoding-utils": "1.2.67",
-    "@layerzerolabs/common-error-utils": "1.2.67",
-    "@layerzerolabs/typescript-utils": "1.2.67",
+    "@layerzerolabs/common-chain-model": "1.2.69",
+    "@layerzerolabs/common-encoding-utils": "1.2.69",
+    "@layerzerolabs/common-error-utils": "1.2.69",
+    "@layerzerolabs/typescript-utils": "1.2.69",
     "@mojotech/json-type-validation": "^3.1.0",
     "@noble/hashes": "^1.8.0",
     "@noble/secp256k1": "1.7.1",
@@ -43,11 +43,11 @@
     "zod": "4.3.5"
   },
   "devDependencies": {
-    "@layerzerolabs/eslint-configuration": "^1.2.67",
-    "@layerzerolabs/tsup-configuration": "1.2.67",
-    "@layerzerolabs/typescript-configuration": "1.2.67",
-    "@layerzerolabs/vitest-configuration": "1.2.67",
-    "@layerzerolabs/vm-tooling-canton": "1.2.67",
+    "@layerzerolabs/eslint-configuration": "^1.2.69",
+    "@layerzerolabs/tsup-configuration": "1.2.69",
+    "@layerzerolabs/typescript-configuration": "1.2.69",
+    "@layerzerolabs/vitest-configuration": "1.2.69",
+    "@layerzerolabs/vm-tooling-canton": "1.2.69",
     "@vitest/coverage-v8": "4.1.10",
     "eslint": "9.39.1",
     "tsup": "^8.4.0",

package/src/refresh/README.md

@@ -0,0 +1,119 @@
+---
+owner: Protocol team
+reviewed: 2026-10-01
+---
+
+# Canton refresh plans
+
+A transaction producer or activity can attach a `refreshPlan` to
+`CantonPopulatedTransaction` when command inputs may become stale before signing. Protocol SDKs
+should still build ordinary Canton commands with current values; they should not emit deferred
+sentinels or define refresh policy.
+
+At sign time, the common Canton transaction layer:
+
+1. clones `unresolvedCommands`;
+2. resolves each refresh against current ledger, wallet, or clock state;
+3. applies replacements only to the declared command targets;
+4. replaces refresh-owned disclosures and deduplicates the result; and
+5. passes the resulting `commands` and `disclosedContracts` to `prepareForSigning`.
+
+The persisted unresolved values remain the immutable baseline. Do not combine a `refreshPlan` with
+legacy `CANTON_DEFERRED` sentinels.
+
+## Defining a plan
+
+```ts
+const populatedTransaction: CantonPopulatedTransaction = {
+    unresolvedCommands: prepared.commands,
+    unresolvedDisclosedContracts: prepared.disclosedContracts,
+    actAs: prepared.actAs,
+    refreshPlan: {
+        commands: [
+            {
+                resolver: {
+                    type: 'activeContract',
+                    selector: {
+                        queryAs: { party: executorParty },
+                        templateId: '#layerzero-executor:Executor:Executor',
+                        expectedSignatories: [executorParty],
+                    },
+                    selection: { kind: 'exactlyOne' },
+                },
+                targets: [
+                    {
+                        commandIndex: 0,
+                        command: 'exercise',
+                        field: 'contractId',
+                    },
+                ],
+            },
+            {
+                resolver: {
+                    type: 'timestamp',
+                },
+                targets: [
+                    {
+                        commandIndex: 0,
+                        command: 'exercise',
+                        choice: 'DelegateLzReceive',
+                        arguments: [{ path: [{ field: 'timestamp' }] }],
+                    },
+                ],
+            },
+        ],
+    },
+};
+```
+
+`refreshPlan.commands` contains the instructions that resolve and patch volatile Canton command
+values. Each instruction groups one `resolver` with every command target that consumes its output,
+so external reads and correlated timestamps are shared. Some resolvers also emit the fresh
+disclosures required by their values.
+
+`commandIndex` selects an entry in `unresolvedCommands`. `command` validates that the entry has the
+required create or exercise shape. Each target groups its nested `arguments` under one guarded
+command: exercise targets require `choice`, while create targets require `template`.
+An exercise `contractId` target remains a separate variant and does not have a choice guard.
+
+Nested paths support:
+
+- `{ field: 'name' }` for object fields;
+- `{ index: 0 }` for array entries; and
+- `{ damlMapKey: 'timestamp' }` for entries in Daml maps represented as key-value tuples.
+
+Path segments can be mixed and repeated, so nested Daml maps use consecutive `damlMapKey` segments.
+Timestamp `offsetMs` is configured per argument.
+
+Only an `activeContract` refresh with `selection.kind: 'exactlyOne'` can target an exercise
+`contractId`. Collection-valued `activeContract` selections and `amuletContext` refreshes target
+choice or create arguments. Timestamp refreshes also require a non-empty nested argument path.
+
+## Command resolvers
+
+- `activeContract`: queries authenticated active contracts, then selects `exactlyOne`, `all`, or
+  enough contracts for a numeric field to be greater than or equal to a requested value:
+  `{ kind: 'gte', field: 'amount', value: feeAmount }`.
+- `amuletContext`: refreshes the wallet-provided context, ExternalPartyAmuletRules CID, and
+  disclosures.
+- `timestamp`: refreshes one or more Canton Time values from the same current instant; `offsetMs`
+  can derive an expiry from that instant. Timestamp refreshes run after all ledger and wallet
+  refreshes regardless of declaration order.
+
+`gte.field` may be a dotted create-argument path. Its value may be a Daml Decimal string or an
+Amulet-style record containing `initialAmount`.
+
+When the persisted baseline contains disclosures owned by a command refresh, list their contract
+IDs under `refreshPlan.disclosures.excludeBaselineCids`. The IDs must be unique and must exist in
+`unresolvedDisclosedContracts`. Those baseline records are excluded before fresh resolver
+disclosures are added; the IDs identify old records, not their replacements.
+
+Active-contract queries always request `createdEventBlob`, and conflicting disclosures for the
+same CID fail.
+
+Keep `queryAs` (ledger visibility) separate from `expectedSignatories` (authority), and use
+`stateFilter` for semantic payload identity such as an owner. Missing filter paths fail closed.
+
+See
+[`createExecuteTransaction()`](../../../../../../migrated/offchain-monorepo/packages/sdks/executor-sdk/src/canton/index.ts)
+for the first complete activity-side example.

package/src/refresh/address-resolver.ts

@@ -1,5 +1,3 @@
-import type { ContractId } from '@daml/types';
-
 import { NonRetryableError } from '@layerzerolabs/common-error-utils';
 
 import type { ICantonClient } from '../client/interface';
@@ -123,7 +121,12 @@ export const queryLiveContractsForRef = async (
         ref.templateId,
     );
     const contractStateFilter = resolveContractStateFilter(ref.contractStateFilter, party);
-    return (await client.queryActiveContracts(party, offset, { templateIds: [ref.templateId] }))
+    return (
+        await client.queryActiveContracts(party, offset, {
+            templateIds: [ref.templateId],
+            includeCreatedEventBlob: true,
+        })
+    )
         .filter((contract) => matchesContractStateFilter(contract, contractStateFilter))
         .filter(
             (contract) =>
@@ -201,22 +204,21 @@ export const createContractAddressResolver = (deps: ContractAddressResolverDeps)
         const toDisclose = contracts.filter(needsDisclosure);
         if (toDisclose.length === 0) return;
 
-        const party = resolveQueryParty(ref);
-        const disclosures = await Promise.all(
-            toDisclose.map(async (contract) => {
-                const contractId = contract.createdEvent.contractId;
-                const disclosure = await client.createDisclosure(
-                    contractId as ContractId<unknown>,
-                    [party],
+        const disclosures = toDisclose.map((contract) => {
+            const contractId = contract.createdEvent.contractId;
+            const createdEventBlob = contract.createdEvent.createdEventBlob;
+            if (!createdEventBlob) {
+                throw new NonRetryableError(
+                    `Could not disclose ${contractId} (template ${ref.templateId}) — ACS result omitted createdEventBlob`,
                 );
-                if (!disclosure) {
-                    throw new NonRetryableError(
-                        `Could not disclose ${contractId} (template ${ref.templateId}) — no longer active`,
-                    );
-                }
-                return disclosure;
-            }),
-        );
+            }
+            return {
+                contractId,
+                templateId: contract.createdEvent.templateId,
+                createdEventBlob,
+                synchronizerId: contract.synchronizerId,
+            };
+        });
         appendDisclosures(disclosures);
     };
 
@@ -237,5 +239,11 @@ export const createContractAddressResolver = (deps: ContractAddressResolverDeps)
         return contracts.map((contract) => contract.createdEvent.contractId);
     };
 
-    return { resolveActiveContractId, resolveActiveContractIds, requireSenderParty: requireSender };
+    return {
+        resolveActiveContractId,
+        resolveActiveContractIds,
+        resolveActiveContracts: queryAsParty,
+        discloseActiveContracts: discloseContracts,
+        requireSenderParty: requireSender,
+    };
 };