@zkp2p/contracts-v2 0.3.0 → 0.3.1-rc.0

package/README.md

@@ -33,6 +33,10 @@ import type { Escrow, Orchestrator } from "@zkp2p/contracts-v2/types"
 // Import utility functions
 import { getKeccak256Hash, calculateIntentHash } from "@zkp2p/contracts-v2/utils/protocolUtils"
 
+// Import stable source ABIs for the hard-cut risk-settlement boundary and exact bigint math helpers
+import { IIntentRiskHook, OrchestratorV3, RiskManager } from "@zkp2p/contracts-v2/abis/contracts"
+import { calculateRequiredReservation } from "@zkp2p/contracts-v2/utils/riskMath"
+
 // Example: Create contract instance with ethers
 import { ethers } from 'ethers';
 
@@ -160,10 +164,12 @@ All modules are directly accessible via subpath exports:
 
 - `@zkp2p/contracts-v2/addresses` - Contract addresses for all networks
 - `@zkp2p/contracts-v2/abis/<network>` - Contract ABIs per network (e.g., `/abis/baseStaging`)
+- `@zkp2p/contracts-v2/abis/contracts` - Stable source ABIs for approved but not-yet-deployed contracts
 - `@zkp2p/contracts-v2/abis/<network>/<contract>.json` - Direct JSON import for specific contracts
 - `@zkp2p/contracts-v2/constants/<network>` - Constants per network
 - `@zkp2p/contracts-v2/paymentMethods` - Payment method configs
 - `@zkp2p/contracts-v2/utils/protocolUtils` - Protocol utilities
+- `@zkp2p/contracts-v2/utils/riskMath` - Exact bigint capacity, reservation, and penalty formulas
 - `@zkp2p/contracts-v2/types` - TypeScript types
 
 ### Export Format Details

package/_cjs/abis/base/index.js

@@ -1,23 +1,52 @@
-exports.AcrossBridgeHook = require('./AcrossBridgeHook.json');
-exports.AcrossBridgeHookV2 = require('./AcrossBridgeHookV2.json');
-exports.ChainlinkOracleAdapter = require('./ChainlinkOracleAdapter.json');
-exports.Escrow = require('./Escrow.json');
-exports.EscrowRegistry = require('./EscrowRegistry.json');
-exports.EscrowV2 = require('./EscrowV2.json');
-exports.MultiAttestationVerifier = require('./MultiAttestationVerifier.json');
-exports.NullifierRegistry = require('./NullifierRegistry.json');
-exports.Orchestrator = require('./Orchestrator.json');
-exports.OrchestratorRegistry = require('./OrchestratorRegistry.json');
-exports.OrchestratorV2 = require('./OrchestratorV2.json');
-exports.PaymentVerifierRegistry = require('./PaymentVerifierRegistry.json');
-exports.PostIntentHookRegistry = require('./PostIntentHookRegistry.json');
-exports.ProtocolViewer = require('./ProtocolViewer.json');
-exports.ProtocolViewerV2 = require('./ProtocolViewerV2.json');
-exports.PythOracleAdapter = require('./PythOracleAdapter.json');
-exports.RateManagerV1 = require('./RateManagerV1.json');
-exports.RelayerRegistry = require('./RelayerRegistry.json');
-exports.SignatureGatingPreIntentHook = require('./SignatureGatingPreIntentHook.json');
-exports.SimpleAttestationVerifier = require('./SimpleAttestationVerifier.json');
-exports.UnifiedPaymentVerifier = require('./UnifiedPaymentVerifier.json');
-exports.UnifiedPaymentVerifierV2 = require('./UnifiedPaymentVerifierV2.json');
-exports.WhitelistPreIntentHook = require('./WhitelistPreIntentHook.json');
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhitelistPreIntentHook = exports.UnifiedPaymentVerifierV2 = exports.UnifiedPaymentVerifier = exports.SimpleAttestationVerifier = exports.SignatureGatingPreIntentHook = exports.RelayerRegistry = exports.RateManagerV1 = exports.PythOracleAdapter = exports.ProtocolViewerV2 = exports.ProtocolViewer = exports.PostIntentHookRegistry = exports.PaymentVerifierRegistry = exports.OrchestratorV2 = exports.OrchestratorRegistry = exports.Orchestrator = exports.NullifierRegistry = exports.MultiAttestationVerifier = exports.EscrowV2 = exports.EscrowRegistry = exports.Escrow = exports.ChainlinkOracleAdapter = exports.AcrossBridgeHookV2 = exports.AcrossBridgeHook = void 0;
+var AcrossBridgeHook_json_1 = require("./AcrossBridgeHook.json");
+Object.defineProperty(exports, "AcrossBridgeHook", { enumerable: true, get: function () { return __importDefault(AcrossBridgeHook_json_1).default; } });
+var AcrossBridgeHookV2_json_1 = require("./AcrossBridgeHookV2.json");
+Object.defineProperty(exports, "AcrossBridgeHookV2", { enumerable: true, get: function () { return __importDefault(AcrossBridgeHookV2_json_1).default; } });
+var ChainlinkOracleAdapter_json_1 = require("./ChainlinkOracleAdapter.json");
+Object.defineProperty(exports, "ChainlinkOracleAdapter", { enumerable: true, get: function () { return __importDefault(ChainlinkOracleAdapter_json_1).default; } });
+var Escrow_json_1 = require("./Escrow.json");
+Object.defineProperty(exports, "Escrow", { enumerable: true, get: function () { return __importDefault(Escrow_json_1).default; } });
+var EscrowRegistry_json_1 = require("./EscrowRegistry.json");
+Object.defineProperty(exports, "EscrowRegistry", { enumerable: true, get: function () { return __importDefault(EscrowRegistry_json_1).default; } });
+var EscrowV2_json_1 = require("./EscrowV2.json");
+Object.defineProperty(exports, "EscrowV2", { enumerable: true, get: function () { return __importDefault(EscrowV2_json_1).default; } });
+var MultiAttestationVerifier_json_1 = require("./MultiAttestationVerifier.json");
+Object.defineProperty(exports, "MultiAttestationVerifier", { enumerable: true, get: function () { return __importDefault(MultiAttestationVerifier_json_1).default; } });
+var NullifierRegistry_json_1 = require("./NullifierRegistry.json");
+Object.defineProperty(exports, "NullifierRegistry", { enumerable: true, get: function () { return __importDefault(NullifierRegistry_json_1).default; } });
+var Orchestrator_json_1 = require("./Orchestrator.json");
+Object.defineProperty(exports, "Orchestrator", { enumerable: true, get: function () { return __importDefault(Orchestrator_json_1).default; } });
+var OrchestratorRegistry_json_1 = require("./OrchestratorRegistry.json");
+Object.defineProperty(exports, "OrchestratorRegistry", { enumerable: true, get: function () { return __importDefault(OrchestratorRegistry_json_1).default; } });
+var OrchestratorV2_json_1 = require("./OrchestratorV2.json");
+Object.defineProperty(exports, "OrchestratorV2", { enumerable: true, get: function () { return __importDefault(OrchestratorV2_json_1).default; } });
+var PaymentVerifierRegistry_json_1 = require("./PaymentVerifierRegistry.json");
+Object.defineProperty(exports, "PaymentVerifierRegistry", { enumerable: true, get: function () { return __importDefault(PaymentVerifierRegistry_json_1).default; } });
+var PostIntentHookRegistry_json_1 = require("./PostIntentHookRegistry.json");
+Object.defineProperty(exports, "PostIntentHookRegistry", { enumerable: true, get: function () { return __importDefault(PostIntentHookRegistry_json_1).default; } });
+var ProtocolViewer_json_1 = require("./ProtocolViewer.json");
+Object.defineProperty(exports, "ProtocolViewer", { enumerable: true, get: function () { return __importDefault(ProtocolViewer_json_1).default; } });
+var ProtocolViewerV2_json_1 = require("./ProtocolViewerV2.json");
+Object.defineProperty(exports, "ProtocolViewerV2", { enumerable: true, get: function () { return __importDefault(ProtocolViewerV2_json_1).default; } });
+var PythOracleAdapter_json_1 = require("./PythOracleAdapter.json");
+Object.defineProperty(exports, "PythOracleAdapter", { enumerable: true, get: function () { return __importDefault(PythOracleAdapter_json_1).default; } });
+var RateManagerV1_json_1 = require("./RateManagerV1.json");
+Object.defineProperty(exports, "RateManagerV1", { enumerable: true, get: function () { return __importDefault(RateManagerV1_json_1).default; } });
+var RelayerRegistry_json_1 = require("./RelayerRegistry.json");
+Object.defineProperty(exports, "RelayerRegistry", { enumerable: true, get: function () { return __importDefault(RelayerRegistry_json_1).default; } });
+var SignatureGatingPreIntentHook_json_1 = require("./SignatureGatingPreIntentHook.json");
+Object.defineProperty(exports, "SignatureGatingPreIntentHook", { enumerable: true, get: function () { return __importDefault(SignatureGatingPreIntentHook_json_1).default; } });
+var SimpleAttestationVerifier_json_1 = require("./SimpleAttestationVerifier.json");
+Object.defineProperty(exports, "SimpleAttestationVerifier", { enumerable: true, get: function () { return __importDefault(SimpleAttestationVerifier_json_1).default; } });
+var UnifiedPaymentVerifier_json_1 = require("./UnifiedPaymentVerifier.json");
+Object.defineProperty(exports, "UnifiedPaymentVerifier", { enumerable: true, get: function () { return __importDefault(UnifiedPaymentVerifier_json_1).default; } });
+var UnifiedPaymentVerifierV2_json_1 = require("./UnifiedPaymentVerifierV2.json");
+Object.defineProperty(exports, "UnifiedPaymentVerifierV2", { enumerable: true, get: function () { return __importDefault(UnifiedPaymentVerifierV2_json_1).default; } });
+var WhitelistPreIntentHook_json_1 = require("./WhitelistPreIntentHook.json");
+Object.defineProperty(exports, "WhitelistPreIntentHook", { enumerable: true, get: function () { return __importDefault(WhitelistPreIntentHook_json_1).default; } });

package/_cjs/abis/baseStaging/BoundedCall.js

@@ -0,0 +1,93 @@
+const data = [
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "availableGas",
+        "type": "uint256"
+      },
+      {
+        "internalType": "uint256",
+        "name": "requiredGas",
+        "type": "uint256"
+      }
+    ],
+    "name": "InsufficientGasForRiskCallback",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "hook",
+        "type": "address"
+      },
+      {
+        "internalType": "bytes",
+        "name": "revertData",
+        "type": "bytes"
+      }
+    ],
+    "name": "RiskHookAdmissionFailed",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "hook",
+        "type": "address"
+      },
+      {
+        "internalType": "bytes",
+        "name": "revertData",
+        "type": "bytes"
+      }
+    ],
+    "name": "RiskHookSettlementFailed",
+    "type": "error"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "riskHook",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes4",
+        "name": "callbackSelector",
+        "type": "bytes4"
+      },
+      {
+        "indexed": false,
+        "internalType": "bytes",
+        "name": "revertData",
+        "type": "bytes"
+      }
+    ],
+    "name": "RiskHookCallbackFailed",
+    "type": "event"
+  }
+];
+module.exports = data;
+module.exports.default = data;

package/_cjs/abis/baseStaging/BoundedCall.json

@@ -0,0 +1,91 @@
+[
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "availableGas",
+        "type": "uint256"
+      },
+      {
+        "internalType": "uint256",
+        "name": "requiredGas",
+        "type": "uint256"
+      }
+    ],
+    "name": "InsufficientGasForRiskCallback",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "hook",
+        "type": "address"
+      },
+      {
+        "internalType": "bytes",
+        "name": "revertData",
+        "type": "bytes"
+      }
+    ],
+    "name": "RiskHookAdmissionFailed",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "hook",
+        "type": "address"
+      },
+      {
+        "internalType": "bytes",
+        "name": "revertData",
+        "type": "bytes"
+      }
+    ],
+    "name": "RiskHookSettlementFailed",
+    "type": "error"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "riskHook",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes4",
+        "name": "callbackSelector",
+        "type": "bytes4"
+      },
+      {
+        "indexed": false,
+        "internalType": "bytes",
+        "name": "revertData",
+        "type": "bytes"
+      }
+    ],
+    "name": "RiskHookCallbackFailed",
+    "type": "event"
+  }
+]

package/_cjs/abis/baseStaging/DeferredPayoutHook.js

@@ -0,0 +1,247 @@
+const data = [
+  {
+    "inputs": [
+      {
+        "internalType": "contract IERC20",
+        "name": "_payoutToken",
+        "type": "address"
+      },
+      {
+        "internalType": "contract IStakeVault",
+        "name": "_stakeVault",
+        "type": "address"
+      },
+      {
+        "internalType": "contract IRiskManager",
+        "name": "_riskManager",
+        "type": "address"
+      },
+      {
+        "internalType": "contract IOrchestratorRegistry",
+        "name": "_orchestratorRegistry",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "constructor"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "expected",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "actual",
+        "type": "address"
+      }
+    ],
+    "name": "InvalidPayoutToken",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "caller",
+        "type": "address"
+      }
+    ],
+    "name": "UnauthorizedOrchestrator",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "ZeroAddress",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "ZeroAmount",
+    "type": "error"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "intentHash",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "beneficiary",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "vault",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "name": "PayoutDeferred",
+    "type": "event"
+  },
+  {
+    "inputs": [
+      {
+        "components": [
+          {
+            "internalType": "bytes32",
+            "name": "intentHash",
+            "type": "bytes32"
+          },
+          {
+            "internalType": "address",
+            "name": "token",
+            "type": "address"
+          },
+          {
+            "internalType": "uint256",
+            "name": "executableAmount",
+            "type": "uint256"
+          },
+          {
+            "components": [
+              {
+                "internalType": "address",
+                "name": "owner",
+                "type": "address"
+              },
+              {
+                "internalType": "address",
+                "name": "to",
+                "type": "address"
+              },
+              {
+                "internalType": "address",
+                "name": "escrow",
+                "type": "address"
+              },
+              {
+                "internalType": "uint256",
+                "name": "depositId",
+                "type": "uint256"
+              },
+              {
+                "internalType": "uint256",
+                "name": "amount",
+                "type": "uint256"
+              },
+              {
+                "internalType": "uint256",
+                "name": "timestamp",
+                "type": "uint256"
+              },
+              {
+                "internalType": "bytes32",
+                "name": "paymentMethod",
+                "type": "bytes32"
+              },
+              {
+                "internalType": "bytes32",
+                "name": "fiatCurrency",
+                "type": "bytes32"
+              },
+              {
+                "internalType": "uint256",
+                "name": "conversionRate",
+                "type": "uint256"
+              },
+              {
+                "internalType": "bytes32",
+                "name": "payeeId",
+                "type": "bytes32"
+              },
+              {
+                "internalType": "bytes",
+                "name": "signalHookData",
+                "type": "bytes"
+              }
+            ],
+            "internalType": "struct IPostIntentHookV2.HookIntentContext",
+            "name": "intent",
+            "type": "tuple"
+          }
+        ],
+        "internalType": "struct IPostIntentHookV2.HookExecutionContext",
+        "name": "_ctx",
+        "type": "tuple"
+      },
+      {
+        "internalType": "bytes",
+        "name": "",
+        "type": "bytes"
+      }
+    ],
+    "name": "execute",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "orchestratorRegistry",
+    "outputs": [
+      {
+        "internalType": "contract IOrchestratorRegistry",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "payoutToken",
+    "outputs": [
+      {
+        "internalType": "contract IERC20",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "riskManager",
+    "outputs": [
+      {
+        "internalType": "contract IRiskManager",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "stakeVault",
+    "outputs": [
+      {
+        "internalType": "contract IStakeVault",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  }
+];
+module.exports = data;
+module.exports.default = data;