@zkp2p/sdk 0.10.0-rc.5 → 0.10.0-rc.7

package/README.md

@@ -94,7 +94,7 @@ Indexer defaults by environment:
 | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Deposits                       | `createDeposit`, `addFunds`, `removeFunds`, `withdrawDeposit`, `ensureAllowance`, `setAcceptingIntents`, `setIntentRange`, `setCurrencyMinRate`, `setRetainOnEmpty`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Payment methods and currencies | `addPaymentMethods`, `removePaymentMethod`, `setPaymentMethodActive`, `addCurrencies`, `removeCurrency`, `deactivateCurrency`, `pruneExpiredIntents`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| Intents                        | `signalIntent`, `fulfillIntent`, `cancelIntent`, `releaseFundsToPayer`, `getFulfillIntentInputs`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| Intents                        | `signalIntent`, `fulfillIntent`, `cancelIntent`, `releaseFundsToPayer`, `getFulfillIntentInputs`, `getIntentGuardianPolicy`, `quoteIntentExtension`, `getIntentGuardianPayerFunding`, `extendIntentLifetime`                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | Prepared transactions          | `client.prepareCreateDeposit(...)`, `client.signalIntent.prepare(...)`, `client.fulfillIntent.prepare(...)`, `client.setVaultFee.prepare(...)`, and equivalent prepare flows across the rest of the prepareable write surface                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | Payee and quote APIs           | `registerPayeeDetails`, `resolvePayeeHash`, `getQuote`, `getQuotesBestByPlatform`, `getTakerTier`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | Seller automated release       | `uploadSellerCredential`, `getSellerCredentialStatus`, `verifySellerPayment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
@@ -284,6 +284,53 @@ await client.releaseFundsToPayer({
 
 Use `referralFees[]` for multi-recipient fee distribution on OrchestratorV2.
 
+## Extend an Intent Lifetime
+
+The standalone `IntentGuardian` lets any payer buy more time for a live intent.
+The fee is owner-governed, so read a fresh quote immediately before signing and
+use `maxCost` as the payer's hard ceiling.
+
+```ts
+const policy = await client.getIntentGuardianPolicy();
+if (!policy.extensionsEnabled) {
+  throw new Error('Intent extensions are disabled');
+}
+
+const quote = await client.quoteIntentExtension({
+  intentAmount: 250_000n,
+  additionalTime: 60n * 60n,
+});
+
+const depositToken = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+const payer = walletClient.account.address;
+const funding = await client.getIntentGuardianPayerFunding({
+  payer,
+  token: depositToken,
+});
+
+if (funding.balance < quote.cost) {
+  throw new Error('Insufficient token balance');
+}
+
+await client.ensureAllowance({
+  token: depositToken,
+  spender: policy.guardian,
+  amount: quote.cost,
+});
+
+await client.extendIntentLifetime({
+  escrow: '0xEscrow',
+  depositId: 42n,
+  intentHash,
+  additionalTime: 60n * 60n,
+  maxCost: quote.cost,
+});
+```
+
+The guardian charges the target deposit's token and pays the deposit owner.
+Extension payments are prepaid and non-refundable. `extendIntentLifetime.prepare()`
+returns calldata without sending it.
+
 ## Referral Account API
 
 Apps can read referral data publicly by wallet address and can write with either