@haven_ai/sdk 0.0.0-dev.202609291949.4e52d4b → 0.0.0-dev.202609302044.2340eeb

package/README.md

@@ -470,9 +470,11 @@ answers HTTP 410 at every agent-payment entry point.
 If an agent requests a payment outside that policy, Haven **declines it before
 any money moves** — during prepare, before anything is written and before the
 agent is asked to sign. `POST /payments` answers `403` when no active delegation
-authorizes that token and recipient, and `502` when the on-chain caveat check
-rejects the amount, recipient or expiry; the x402 authorize path answers `403
-delegation_budget_exceeded`. In every case the SDK raises `HavenApiError` and no
+authorizes that token and recipient, `403 delegation_budget_exceeded` when the
+remaining period budget cannot cover the amount (#3503; the x402 authorize path
+answers the same), and `502` when the on-chain caveat check rejects a
+redemption anyway (a recipient outside a pin or an expired grant already gets
+the first `403`, since no active delegation matches). In every case the SDK raises `HavenApiError` and no
 `payment_id` exists to poll.
 
 Surface that to the user as a decline, not a wait: **nothing will arrive later.**

package/dist/{base64-VVxgYQAD.d.cts → base64-DYd43iOS.d.cts}

@@ -1531,6 +1531,19 @@ interface PaymentStatusResult {
      * row records its response); absent = unknown. See the raw field's doc.
      */
     delivered?: boolean;
+    /**
+     * #3475 follow-up: which settlement branch this x402 payment runs (#946).
+     * `null` on the legacy rail, on any x402 intent whose scheme metadata
+     * predates #946, or any stored value outside this enum.
+     */
+    settlementScheme?: 'eip3009' | 'erc7710' | null;
+    /**
+     * #3475 follow-up: `true` only when an eip3009 payment's merchant
+     * settlement transaction is already recorded and on-chain-verified.
+     * Absent — never `false` — when unknown or on erc7710, matching
+     * `delivered`'s own honesty rule.
+     */
+    merchantSettlementRecorded?: boolean;
     /** Platform fee surfaced so it's never silently collected (#386). */
     fee?: PaymentFee | null;
     amountAtomic?: string | null;
@@ -2077,7 +2090,7 @@ declare function buildSweepAuthorizationMessage(auth: SweepAuthorization): strin
  * This SDK's own version. Owned by `scripts/release-bump.mjs`, which rewrites
  * it with the package version on every release — never hand-edit it.
  */
-declare const SDK_VERSION = "0.0.0-dev.202609291949.4e52d4b";
+declare const SDK_VERSION = "0.0.0-dev.202609302044.2340eeb";
 /** The request header every published Haven client sends. */
 declare const HAVEN_CLIENT_HEADER = "X-Haven-Client";
 /** `<package>/<version>` — the value of {@link HAVEN_CLIENT_HEADER}. */

package/dist/{base64-VVxgYQAD.d.ts → base64-DYd43iOS.d.ts}

@@ -1531,6 +1531,19 @@ interface PaymentStatusResult {
      * row records its response); absent = unknown. See the raw field's doc.
      */
     delivered?: boolean;
+    /**
+     * #3475 follow-up: which settlement branch this x402 payment runs (#946).
+     * `null` on the legacy rail, on any x402 intent whose scheme metadata
+     * predates #946, or any stored value outside this enum.
+     */
+    settlementScheme?: 'eip3009' | 'erc7710' | null;
+    /**
+     * #3475 follow-up: `true` only when an eip3009 payment's merchant
+     * settlement transaction is already recorded and on-chain-verified.
+     * Absent — never `false` — when unknown or on erc7710, matching
+     * `delivered`'s own honesty rule.
+     */
+    merchantSettlementRecorded?: boolean;
     /** Platform fee surfaced so it's never silently collected (#386). */
     fee?: PaymentFee | null;
     amountAtomic?: string | null;
@@ -2077,7 +2090,7 @@ declare function buildSweepAuthorizationMessage(auth: SweepAuthorization): strin
  * This SDK's own version. Owned by `scripts/release-bump.mjs`, which rewrites
  * it with the package version on every release — never hand-edit it.
  */
-declare const SDK_VERSION = "0.0.0-dev.202609291949.4e52d4b";
+declare const SDK_VERSION = "0.0.0-dev.202609302044.2340eeb";
 /** The request header every published Haven client sends. */
 declare const HAVEN_CLIENT_HEADER = "X-Haven-Client";
 /** `<package>/<version>` — the value of {@link HAVEN_CLIENT_HEADER}. */

package/dist/{chunk-J6SS36ZD.cjs → chunk-AEUE6UJM.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkSZHKBOCZ_cjs = require('./chunk-SZHKBOCZ.cjs');
+var chunkFZB5XARP_cjs = require('./chunk-FZB5XARP.cjs');
 var viem = require('viem');
 var crypto = require('crypto');
 var secp256k1 = require('@noble/curves/secp256k1');
 var accounts = require('viem/accounts');
 
 var TYPED_DATA_NOT_ALLOWED = "TYPED_DATA_NOT_ALLOWED";
-var HavenTypedDataRefusedError = class extends chunkSZHKBOCZ_cjs.HavenSigningError {
+var HavenTypedDataRefusedError = class extends chunkFZB5XARP_cjs.HavenSigningError {
   constructor(message) {
     super(message);
     this.code = TYPED_DATA_NOT_ALLOWED;
@@ -48,7 +48,7 @@ function assertBoundDirectPaymentUserOp(typedData, delegateAddress) {
       `This signer only signs direct payments on chains the delegation rail has pinned contracts for (${[...DIRECT_PAYMENT_CHAIN_IDS].join(", ")}); this typed data names chain ${String(domain.chainId)}. Refusing.`
     );
   }
-  const ownAccount = chunkSZHKBOCZ_cjs.deriveDelegateAccountAddress(delegateAddress);
+  const ownAccount = chunkFZB5XARP_cjs.deriveDelegateAccountAddress(delegateAddress);
   const sender = typeof message.sender === "string" ? message.sender : "";
   if (sender.toLowerCase() !== ownAccount.toLowerCase()) {
     throw new HavenTypedDataRefusedError(
@@ -78,9 +78,9 @@ function assertBoundDirectPaymentUserOp(typedData, delegateAddress) {
       "This UserOperation's execute() call does not re-encode to the exact callData bytes (trailing or non-canonical bytes). Refusing."
     );
   }
-  if (decoded.target.toLowerCase() !== chunkSZHKBOCZ_cjs.DELEGATION_MANAGER.toLowerCase()) {
+  if (decoded.target.toLowerCase() !== chunkFZB5XARP_cjs.DELEGATION_MANAGER.toLowerCase()) {
     throw new HavenTypedDataRefusedError(
-      `This UserOperation's execute() calls ${decoded.target}, not the DelegationManager (${chunkSZHKBOCZ_cjs.DELEGATION_MANAGER}). A direct payment only ever redeems the agent's own budget delegation \u2014 refusing what looks like a self-call (e.g. transferOwnership, updateSigners, upgradeToAndCall) or a call to an unrelated contract.`
+      `This UserOperation's execute() calls ${decoded.target}, not the DelegationManager (${chunkFZB5XARP_cjs.DELEGATION_MANAGER}). A direct payment only ever redeems the agent's own budget delegation \u2014 refusing what looks like a self-call (e.g. transferOwnership, updateSigners, upgradeToAndCall) or a call to an unrelated contract.`
     );
   }
   if (decoded.value !== 0n) {
@@ -89,20 +89,20 @@ function assertBoundDirectPaymentUserOp(typedData, delegateAddress) {
     );
   }
   try {
-    chunkSZHKBOCZ_cjs.assertRedeemsOwnBudgetDelegation(decoded.callData, ownAccount);
+    chunkFZB5XARP_cjs.assertRedeemsOwnBudgetDelegation(decoded.callData, ownAccount);
   } catch (err) {
     throw new HavenTypedDataRefusedError(err instanceof Error ? err.message : String(err));
   }
 }
 function assertOwnSettlementChild(typedData, expectation, delegateAddress) {
   try {
-    chunkSZHKBOCZ_cjs.verifySettlementChild(typedData, {
+    chunkFZB5XARP_cjs.verifySettlementChild(typedData, {
       ...expectation,
-      delegatorAccount: chunkSZHKBOCZ_cjs.deriveDelegateAccountAddress(delegateAddress)
+      delegatorAccount: chunkFZB5XARP_cjs.deriveDelegateAccountAddress(delegateAddress)
     });
   } catch (err) {
     if (err instanceof HavenTypedDataRefusedError) throw err;
-    if (err instanceof chunkSZHKBOCZ_cjs.HavenSigningError) throw new HavenTypedDataRefusedError(err.message);
+    if (err instanceof chunkFZB5XARP_cjs.HavenSigningError) throw new HavenTypedDataRefusedError(err.message);
     throw new HavenTypedDataRefusedError(
       `Refusing to sign the x402 settlement child: it is malformed (${err instanceof Error ? err.message : String(err)}).`
     );
@@ -131,7 +131,7 @@ function assertFundingLegPaysDelegate(typedData, expected) {
   try {
     const { args: executeArgs } = viem.decodeFunctionData({ abi: EXECUTE_ABI, data: message.callData });
     const inner = executeArgs[0].callData;
-    const { args } = viem.decodeFunctionData({ abi: chunkSZHKBOCZ_cjs.REDEEM_DELEGATIONS_ABI, data: inner });
+    const { args } = viem.decodeFunctionData({ abi: chunkFZB5XARP_cjs.REDEEM_DELEGATIONS_ABI, data: inner });
     const executions = args[2];
     executionCallData = executions[0];
   } catch {
@@ -250,7 +250,7 @@ var TRANSFER_WITH_AUTHORIZATION_TYPES = {
 function sweepUsdcAddress(chainId) {
   const address = USDC_ADDRESS_BY_CHAIN[chainId];
   if (!address) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+    throw new chunkFZB5XARP_cjs.HavenSigningError(
       `Sweep is not supported on chain ${chainId}. Supported: ${SWEEPABLE_CHAIN_IDS.join(", ")}.`
     );
   }
@@ -259,7 +259,7 @@ function sweepUsdcAddress(chainId) {
 function sweepUsdcDomain(chainId) {
   const domain = USDC_EIP712_DOMAIN_BY_CHAIN[chainId];
   if (!domain) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+    throw new chunkFZB5XARP_cjs.HavenSigningError(
       `Sweep is not supported on chain ${chainId}. Supported: ${SWEEPABLE_CHAIN_IDS.join(", ")}.`
     );
   }
@@ -272,12 +272,12 @@ function buildSweepTypedData(auth) {
   const domain = sweepUsdcDomain(auth.chainId);
   const expectedToken = sweepUsdcAddress(auth.chainId);
   if (!sameAddress(auth.token, expectedToken)) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+    throw new chunkFZB5XARP_cjs.HavenSigningError(
       `Sweep token ${auth.token} is not the canonical USDC contract for chain ${auth.chainId}.`
     );
   }
   if (!/^0x[0-9a-fA-F]{64}$/.test(auth.nonce)) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError("Sweep nonce must be a 0x-prefixed 32-byte hex string.");
+    throw new chunkFZB5XARP_cjs.HavenSigningError("Sweep nonce must be a 0x-prefixed 32-byte hex string.");
   }
   return {
     domain,
@@ -787,7 +787,7 @@ function stableStringify2(value) {
 }
 
 // src/client-identity.ts
-var SDK_VERSION = "0.0.0-dev.202609291949.4e52d4b";
+var SDK_VERSION = "0.0.0-dev.202609302044.2340eeb";
 var HAVEN_CLIENT_HEADER = "X-Haven-Client";
 function havenClientIdentity(pkg, version) {
   return `${pkg}/${version}`;
@@ -820,7 +820,7 @@ function addressFromKey(privateKey) {
   try {
     return accounts.privateKeyToAddress(`0x${hexBytes(privateKey, 32, "private key")}`);
   } catch (err) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+    throw new chunkFZB5XARP_cjs.HavenSigningError(
       `Invalid private key: ${err instanceof Error ? err.message : String(err)}`
     );
   }
@@ -834,7 +834,7 @@ function signHash(privateKey, hash) {
       yParity: recovery
     });
   } catch (err) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+    throw new chunkFZB5XARP_cjs.HavenSigningError(
       `Failed to sign hash: ${err instanceof Error ? err.message : String(err)}`
     );
   }
@@ -870,7 +870,7 @@ var TAX_DECLARATION_TYPES = {
 var X_TAX_DECLARATION_HEADER = "X-Tax-Declaration";
 function validateContent(content) {
   if (typeof content !== "object" || content === null || Array.isArray(content)) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError("Tax declaration content must be an object.");
+    throw new chunkFZB5XARP_cjs.HavenSigningError("Tax declaration content must be an object.");
   }
   const record = content;
   for (const field of ["principalId", "principalAttributionHash"]) {
@@ -923,7 +923,7 @@ function taxPrincipalId(network, delegateAddress) {
   if (network.startsWith("eip155:")) {
     return `did:pkh:${network}:${delegateAddress}`;
   }
-  const chainId = chunkSZHKBOCZ_cjs.chainIdForNetwork(network);
+  const chainId = chunkFZB5XARP_cjs.chainIdForNetwork(network);
   if (chainId === void 0) {
     throw new TaxDeclarationRefusedError(
       `The accepted payment option's network '${network}' is not a CAIP-2 eip155 chain this SDK can name; refusing to build a tax principal without the settlement network.`
@@ -968,12 +968,12 @@ function addressFromKeyForTax(delegateKey) {
   try {
     return addressFromKey(delegateKey);
   } catch (err) {
-    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+    throw new chunkFZB5XARP_cjs.HavenSigningError(
       `Invalid delegate key for tax declaration signing: ${err instanceof Error ? err.message : String(err)}`
     );
   }
 }
-var TaxDeclarationRefusedError = class extends chunkSZHKBOCZ_cjs.HavenSigningError {
+var TaxDeclarationRefusedError = class extends chunkFZB5XARP_cjs.HavenSigningError {
   code = "TAX_DECLARATION_REFUSED";
   constructor(message) {
     super(message);
@@ -1125,10 +1125,10 @@ function assertOwnTaskChild(typedData, expected, delegateAddress, now = Date.now
   if (td?.primaryType !== "Delegation") {
     refuseTaskChild("it is not a Delegation payload", `primaryType was '${String(td?.primaryType)}'.`);
   }
-  if (!same(td.domain?.verifyingContract, chunkSZHKBOCZ_cjs.DELEGATION_MANAGER)) {
+  if (!same(td.domain?.verifyingContract, chunkFZB5XARP_cjs.DELEGATION_MANAGER)) {
     refuseTaskChild(
       "the EIP-712 domain names an unknown DelegationManager",
-      `Expected ${chunkSZHKBOCZ_cjs.DELEGATION_MANAGER}, got ${td.domain?.verifyingContract}.`
+      `Expected ${chunkFZB5XARP_cjs.DELEGATION_MANAGER}, got ${td.domain?.verifyingContract}.`
     );
   }
   if (td.domain?.name !== DELEGATION_DOMAIN_NAME || td.domain?.version !== DELEGATION_DOMAIN_VERSION) {
@@ -1156,7 +1156,7 @@ function assertOwnTaskChild(typedData, expected, delegateAddress, now = Date.now
       `Expected chain ${expected.chainId}; the child says ${td.domain?.chainId}.`
     );
   }
-  const ownAccount = chunkSZHKBOCZ_cjs.deriveDelegateAccountAddress(delegateAddress);
+  const ownAccount = chunkFZB5XARP_cjs.deriveDelegateAccountAddress(delegateAddress);
   const delegator = td.message?.delegator;
   if (typeof delegator !== "string" || !same(delegator, ownAccount)) {
     refuseTaskChild(
@@ -1175,7 +1175,7 @@ function assertOwnTaskChild(typedData, expected, delegateAddress, now = Date.now
   if (typeof authority !== "string" || !/^0x[0-9a-fA-F]{64}$/.test(authority)) {
     refuseTaskChild("its authority is not a 32-byte delegation hash", `Got ${String(authority)}.`);
   }
-  if (authority.toLowerCase() === chunkSZHKBOCZ_cjs.ROOT_AUTHORITY) {
+  if (authority.toLowerCase() === chunkFZB5XARP_cjs.ROOT_AUTHORITY) {
     refuseTaskChild(
       "it is a ROOT delegation, not a re-delegation of the agent budget",
       "A task budget always chains under the agent budget delegation."
@@ -1188,7 +1188,7 @@ function assertOwnTaskChild(typedData, expected, delegateAddress, now = Date.now
     );
   }
   const caveats = td.message?.caveats ?? [];
-  const transfer = findCaveat(caveats, chunkSZHKBOCZ_cjs.CAVEAT_ENFORCERS.erc20TransferAmount);
+  const transfer = findCaveat(caveats, chunkFZB5XARP_cjs.CAVEAT_ENFORCERS.erc20TransferAmount);
   if (!transfer) {
     refuseTaskChild(
       "it has no ERC-20 transfer-amount caveat",
@@ -1206,7 +1206,7 @@ function assertOwnTaskChild(typedData, expected, delegateAddress, now = Date.now
       `Expected ${expected.maxAmountAtomic}; the child allows ${amount.toString()}.`
     );
   }
-  const timestamp = findCaveat(caveats, chunkSZHKBOCZ_cjs.CAVEAT_ENFORCERS.timestamp);
+  const timestamp = findCaveat(caveats, chunkFZB5XARP_cjs.CAVEAT_ENFORCERS.timestamp);
   if (!timestamp) {
     refuseTaskChild("it never expires", "A task-budget child without a timestamp caveat is open-ended.");
   }
@@ -1227,7 +1227,7 @@ function assertOwnTaskChild(typedData, expected, delegateAddress, now = Date.now
       `Expected ${expected.expiresAt}; the child says ${beforeThreshold}.`
     );
   }
-  const calldata = findCaveat(caveats, chunkSZHKBOCZ_cjs.CAVEAT_ENFORCERS.allowedCalldata);
+  const calldata = findCaveat(caveats, chunkFZB5XARP_cjs.CAVEAT_ENFORCERS.allowedCalldata);
   if (expected.recipientAddress) {
     if (!calldata) {
       refuseTaskChild(
@@ -1264,7 +1264,7 @@ var DISABLE_DELEGATION_ABI = [
   {
     type: "function",
     name: "disableDelegation",
-    inputs: [{ name: "delegation", type: "tuple", components: chunkSZHKBOCZ_cjs.DELEGATION_TUPLE_COMPONENTS }],
+    inputs: [{ name: "delegation", type: "tuple", components: chunkFZB5XARP_cjs.DELEGATION_TUPLE_COMPONENTS }],
     outputs: [],
     stateMutability: "nonpayable"
   }
@@ -1283,7 +1283,7 @@ function assertOwnTaskBudgetCloseUserOp(typedData, expected, delegateAddress) {
       `This signer only signs a task-budget close on chains the delegation rail has pinned contracts for (${[...DIRECT_PAYMENT_CHAIN_IDS].join(", ")}); this typed data names chain ${String(domain.chainId)}. Refusing.`
     );
   }
-  const ownAccount = chunkSZHKBOCZ_cjs.deriveDelegateAccountAddress(delegateAddress);
+  const ownAccount = chunkFZB5XARP_cjs.deriveDelegateAccountAddress(delegateAddress);
   const sender = typeof message.sender === "string" ? message.sender : "";
   if (sender.toLowerCase() !== ownAccount.toLowerCase()) {
     throw new HavenTypedDataRefusedError(
@@ -1306,9 +1306,9 @@ function assertOwnTaskBudgetCloseUserOp(typedData, expected, delegateAddress) {
       "This close UserOperation's execute() call does not re-encode to the exact callData bytes (trailing or non-canonical bytes). Refusing."
     );
   }
-  if (decoded.target.toLowerCase() !== chunkSZHKBOCZ_cjs.DELEGATION_MANAGER.toLowerCase()) {
+  if (decoded.target.toLowerCase() !== chunkFZB5XARP_cjs.DELEGATION_MANAGER.toLowerCase()) {
     throw new HavenTypedDataRefusedError(
-      `This close UserOperation's execute() calls ${decoded.target}, not the DelegationManager (${chunkSZHKBOCZ_cjs.DELEGATION_MANAGER}). Refusing what looks like a self-call or a call to an unrelated contract.`
+      `This close UserOperation's execute() calls ${decoded.target}, not the DelegationManager (${chunkFZB5XARP_cjs.DELEGATION_MANAGER}). Refusing what looks like a self-call or a call to an unrelated contract.`
     );
   }
   if (decoded.value !== 0n) {
@@ -1345,7 +1345,7 @@ function assertOwnTaskBudgetCloseUserOp(typedData, expected, delegateAddress) {
       `This close UserOperation disables a delegation granted to ${delegation.delegate}, not this signer's own account (${ownAccount}) \u2014 a task-budget child is always self-delegated. Refusing.`
     );
   }
-  if (delegation.authority.toLowerCase() === chunkSZHKBOCZ_cjs.ROOT_AUTHORITY) {
+  if (delegation.authority.toLowerCase() === chunkFZB5XARP_cjs.ROOT_AUTHORITY) {
     throw new HavenTypedDataRefusedError(
       "This close UserOperation disables a ROOT delegation, not a re-delegation of the agent budget. A task-budget child always chains under the agent budget delegation. Refusing."
     );
@@ -1475,5 +1475,5 @@ exports.x402FacilitatorAddresses = x402FacilitatorAddresses;
 exports.x402PaymentHeaderNamesFor = x402PaymentHeaderNamesFor;
 exports.x402PaymentHeaderNamesSent = x402PaymentHeaderNamesSent;
 exports.x402V2PaymentEnvelope = x402V2PaymentEnvelope;
-//# sourceMappingURL=chunk-J6SS36ZD.cjs.map
-//# sourceMappingURL=chunk-J6SS36ZD.cjs.map
+//# sourceMappingURL=chunk-AEUE6UJM.cjs.map
+//# sourceMappingURL=chunk-AEUE6UJM.cjs.map