@zkp2p/sdk 0.10.0-rc.1 → 0.10.0-rc.3

package/README.md

@@ -265,18 +265,35 @@ OrchestratorV3 signals are ungated: the SDK encodes an empty gating signature
 and zero expiration without calling the curator signing endpoint. Existing
 OrchestratorV2 signaling remains gated.
 
+An explicit `orchestratorAddress` is caller-pinned. The SDK honors it even when
+the address is outside the client's configured deployment context, using the
+OrchestratorV3 ABI for signal, cancel, and fulfill preparation. This lets
+integrators snapshot the target when a payment is created and keep every
+lifecycle transaction on that target across later SDK or deployment changes.
+
 Keeper writes are direct and prepareable:
 
 ```ts
 const sweep = await client.releaseMaturedPositions.prepare({
   intentHashes: [intentHash],
+  riskManagerAddress: snapshottedRiskManagerAddress,
+});
+const settlement = await client.reconcileSettlement.prepare({
+  intentHash,
+  riskManagerAddress: snapshottedRiskManagerAddress,
 });
-const settlement = await client.reconcileSettlement.prepare({ intentHash });
 const cancellations = await client.reconcileCancellations.prepare({
   intentHashes: [intentHash],
+  riskManagerAddress: snapshottedRiskManagerAddress,
 });
 ```
 
+Like `orchestratorAddress`, an explicit `riskManagerAddress` is caller-pinned
+and may be outside the client's configured deployment context. All five keeper
+methods honor it for direct and `.prepare()` calls, allowing sweepers to group
+positions by their snapshotted RiskManager deployment without a later SDK
+configuration change rerouting them.
+
 For receipt classification, import `RISK_POSITION_SETTLED_EVENT_ABI` and
 `DEFERRED_PAYOUT_RECORDED_EVENT_ABI` and pass them to viem's
 `decodeEventLog()`.

package/dist/index.cjs

@@ -76536,7 +76536,8 @@ var IntentOperations = class {
     const currentEscrow = this.config.getEscrowV2Address();
     const currentOrchestrator = this.config.getOrchestratorV2Address();
     const isOrchestratorV3 = orchestratorContext.version === "v3";
-    if (currentEscrow && escrowContext.address.toLowerCase() !== currentEscrow.toLowerCase()) {
+    const hasPinnedV3Target = isOrchestratorV3 && params.orchestratorAddress !== void 0;
+    if (!hasPinnedV3Target && currentEscrow && escrowContext.address.toLowerCase() !== currentEscrow.toLowerCase()) {
       throw new Error("signalIntent is only supported on the current EscrowV2 deployment");
     }
     if (!isOrchestratorV3 && currentOrchestrator && orchestratorContext.address.toLowerCase() !== currentOrchestrator.toLowerCase()) {
@@ -81831,15 +81832,30 @@ var Zkp2pClient = class {
       "clearStakeOwner",
       () => []
     );
-    /** Release one or more RiskManager positions whose chargeback window matured. */
+    /**
+     * Release one or more RiskManager positions whose chargeback window matured.
+     * Pass `riskManagerAddress` to pin the transaction to a snapshotted deployment.
+     */
     this.releaseMaturedPositions = this.buildRiskManagerMethod("releaseMaturedPositions", (params) => [params.intentHashes]);
-    /** Reconcile one failed OrchestratorV3 settlement callback. */
+    /**
+     * Reconcile one failed OrchestratorV3 settlement callback.
+     * Pass `riskManagerAddress` to pin the transaction to a snapshotted deployment.
+     */
     this.reconcileSettlement = this.buildRiskManagerMethod("reconcileSettlement", (params) => [params.intentHash]);
-    /** Reconcile multiple failed OrchestratorV3 settlement callbacks. */
+    /**
+     * Reconcile multiple failed OrchestratorV3 settlement callbacks.
+     * Pass `riskManagerAddress` to pin the transaction to a snapshotted deployment.
+     */
     this.reconcileSettlements = this.buildRiskManagerMethod("reconcileSettlements", (params) => [params.intentHashes]);
-    /** Reconcile one failed OrchestratorV3 cancellation callback. */
+    /**
+     * Reconcile one failed OrchestratorV3 cancellation callback.
+     * Pass `riskManagerAddress` to pin the transaction to a snapshotted deployment.
+     */
     this.reconcileCancellation = this.buildRiskManagerMethod("reconcileCancellation", (params) => [params.intentHash]);
-    /** Reconcile multiple failed OrchestratorV3 cancellation callbacks. */
+    /**
+     * Reconcile multiple failed OrchestratorV3 cancellation callbacks.
+     * Pass `riskManagerAddress` to pin the transaction to a snapshotted deployment.
+     */
     this.reconcileCancellations = this.buildRiskManagerMethod("reconcileCancellations", (params) => [params.intentHashes]);
     // ╔═══════════════════════════════════════════════════════════════════════════╗
     // ║ CORE: DEPOSIT MANAGEMENT                                                 ║
@@ -83064,10 +83080,13 @@ var Zkp2pClient = class {
     const explicit = this.getOrchestratorContextByAddress(options?.orchestratorAddress);
     if (explicit) return explicit;
     if (options?.orchestratorAddress) {
-      const addr = options.orchestratorAddress;
-      const abi = this.orchestratorV2Abi ?? this.orchestratorAbi;
+      const abi = this.orchestratorV3Abi ?? this.orchestratorAbi ?? this.orchestratorV2Abi;
       if (!abi) throw new Error("Orchestrator not available");
-      return { address: addr, abi, version: "v2" };
+      return {
+        address: options.orchestratorAddress,
+        abi,
+        version: this.orchestratorV3Abi ? "v3" : "v2"
+      };
     }
     if (options?.intentHash) {
       try {
@@ -83253,7 +83272,7 @@ var Zkp2pClient = class {
   buildContractMethod(resolveContract, functionName, buildArgs, buildValue) {
     return Object.assign(
       async (params) => {
-        const contract = resolveContract();
+        const contract = resolveContract(params);
         if (!contract.address || !contract.abi) {
           throw new Error(`${contract.label} not available`);
         }
@@ -83269,7 +83288,7 @@ var Zkp2pClient = class {
       },
       {
         prepare: async (params) => {
-          const contract = resolveContract();
+          const contract = resolveContract(params);
           if (!contract.address || !contract.abi) {
             throw new Error(`${contract.label} not available`);
           }
@@ -83304,8 +83323,8 @@ var Zkp2pClient = class {
   }
   buildRiskManagerMethod(functionName, buildArgs) {
     return this.buildContractMethod(
-      () => ({
-        address: this.riskManagerAddress,
+      (params) => ({
+        address: params.riskManagerAddress ?? this.riskManagerAddress,
         abi: this.riskManagerAbi,
         label: "RiskManager"
       }),