@haven_ai/sdk 0.0.0-dev.202609291912.efd0772 → 0.0.0-dev.202609291949.4e52d4b

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

@@ -2077,7 +2077,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.202609291912.efd0772";
+declare const SDK_VERSION = "0.0.0-dev.202609291949.4e52d4b";
 /** 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-DyOPH887.d.ts → base64-VVxgYQAD.d.ts}

@@ -2077,7 +2077,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.202609291912.efd0772";
+declare const SDK_VERSION = "0.0.0-dev.202609291949.4e52d4b";
 /** 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-MJ2IMB5H.cjs → chunk-J6SS36ZD.cjs}

@@ -3,6 +3,8 @@
 var chunkSZHKBOCZ_cjs = require('./chunk-SZHKBOCZ.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 {
@@ -785,7 +787,7 @@ function stableStringify2(value) {
 }
 
 // src/client-identity.ts
-var SDK_VERSION = "0.0.0-dev.202609291912.efd0772";
+var SDK_VERSION = "0.0.0-dev.202609291949.4e52d4b";
 var HAVEN_CLIENT_HEADER = "X-Haven-Client";
 function havenClientIdentity(pkg, version) {
   return `${pkg}/${version}`;
@@ -807,6 +809,177 @@ function readClientUpdate(value) {
     notes_url: typeof v.notes_url === "string" ? v.notes_url : null
   };
 }
+var HALF_N = BigInt("0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0");
+function hexBytes(value, bytes, what) {
+  if (!/^0x[0-9a-fA-F]+$/.test(value) || value.length !== 2 + bytes * 2) {
+    throw new Error(`${what} must be a 0x-prefixed ${bytes}-byte hex string`);
+  }
+  return value.slice(2);
+}
+function addressFromKey(privateKey) {
+  try {
+    return accounts.privateKeyToAddress(`0x${hexBytes(privateKey, 32, "private key")}`);
+  } catch (err) {
+    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+      `Invalid private key: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function signHash(privateKey, hash) {
+  try {
+    const { r, s, recovery } = secp256k1.secp256k1.sign(hexBytes(hash, 32, "hash"), hexBytes(privateKey, 32, "private key"), { lowS: true });
+    return viem.serializeSignature({
+      r: `0x${r.toString(16).padStart(64, "0")}`,
+      s: `0x${s.toString(16).padStart(64, "0")}`,
+      yParity: recovery
+    });
+  } catch (err) {
+    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+      `Failed to sign hash: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function verifySignature(hash, signature, expectedAddress) {
+  try {
+    const sig = hexBytes(signature, 65, "signature");
+    const hashHex = hexBytes(hash, 32, "hash");
+    if (BigInt(`0x${sig.slice(64, 128)}`) > HALF_N) return false;
+    const yParityOrV = Number.parseInt(sig.slice(128), 16);
+    const recoveryBit = yParityOrV === 0 || yParityOrV === 27 ? 0 : yParityOrV === 1 || yParityOrV === 28 ? 1 : -1;
+    if (recoveryBit < 0) return false;
+    const publicKey = secp256k1.secp256k1.Signature.fromCompact(sig.slice(0, 128)).addRecoveryBit(recoveryBit).recoverPublicKey(hashHex).toHex(false);
+    const recovered = accounts.publicKeyToAddress(`0x${publicKey}`);
+    return recovered.toLowerCase() === expectedAddress.toLowerCase();
+  } catch {
+    return false;
+  }
+}
+var TAX_DECLARATION_DOMAIN = { name: "x402 Tax Declaration", version: "1" };
+var TAX_DECLARATION_PRIMARY_TYPE = "TaxDeclaration";
+var TAX_DECLARATION_TYPES = {
+  TaxDeclaration: [
+    { name: "version", type: "string" },
+    { name: "jurisdiction", type: "string" },
+    { name: "taxableStatus", type: "string" },
+    { name: "taxId", type: "string" },
+    { name: "validUntil", type: "uint256" },
+    { name: "principalId", type: "string" },
+    { name: "principalAttributionHash", type: "string" }
+  ]
+};
+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.");
+  }
+  const record = content;
+  for (const field of ["principalId", "principalAttributionHash"]) {
+    if (record[field] !== void 0) {
+      throw new TaxDeclarationRefusedError(
+        `Tax declaration content arrives with ${field} already set; that field is computed locally from the delegate key and the accepted payment option, never accepted from Haven.`
+      );
+    }
+  }
+  const allowed = /* @__PURE__ */ new Set(["version", "jurisdiction", "taxableStatus", "taxId", "validUntil"]);
+  for (const key of Object.keys(record)) {
+    if (!allowed.has(key)) {
+      throw new TaxDeclarationRefusedError(
+        `Tax declaration content carries an unknown field '${key}'; the signed shape is built locally from the \xA72.1 fields only.`
+      );
+    }
+  }
+  const strings = ["version", "jurisdiction", "taxableStatus", "taxId"];
+  for (const key of strings) {
+    if (typeof record[key] !== "string" || record[key].length === 0) {
+      throw new TaxDeclarationRefusedError(
+        `Tax declaration content field '${key}' must be a non-empty string.`
+      );
+    }
+  }
+  if (typeof record.validUntil !== "number" || !Number.isInteger(record.validUntil) || record.validUntil <= 0) {
+    throw new TaxDeclarationRefusedError(
+      "Tax declaration content field 'validUntil' must be a positive integer (milliseconds)."
+    );
+  }
+  return {
+    version: record.version,
+    jurisdiction: record.jurisdiction,
+    taxableStatus: record.taxableStatus,
+    taxId: record.taxId,
+    validUntil: record.validUntil
+  };
+}
+function jcsCanonicalBytes(value) {
+  const keys = Object.keys(value).sort();
+  const members = keys.map((key) => `${JSON.stringify(key)}:${JSON.stringify(value[key])}`);
+  return `{${members.join(",")}}`;
+}
+function principalAttributionHash(principalId) {
+  const canonical = jcsCanonicalBytes({ principalId });
+  const hex2 = crypto.createHash("sha256").update(canonical, "utf8").digest("hex");
+  return `sha-256:${hex2}`;
+}
+function taxPrincipalId(network, delegateAddress) {
+  if (network.startsWith("eip155:")) {
+    return `did:pkh:${network}:${delegateAddress}`;
+  }
+  const chainId = chunkSZHKBOCZ_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.`
+    );
+  }
+  return `did:pkh:eip155:${chainId}:${delegateAddress}`;
+}
+function buildSignedTaxDeclaration(input) {
+  const content = validateContent(input.content);
+  const principalId = taxPrincipalId(input.network, addressFromKeyForTax(input.delegateKey));
+  const attributionHash = principalAttributionHash(principalId);
+  const declaration = { ...content, principalId, principalAttributionHash: attributionHash };
+  const message = { ...declaration, validUntil: BigInt(declaration.validUntil) };
+  const digest = viem.hashTypedData({
+    domain: TAX_DECLARATION_DOMAIN,
+    types: TAX_DECLARATION_TYPES,
+    primaryType: TAX_DECLARATION_PRIMARY_TYPE,
+    message
+  });
+  const signature = signHash(input.delegateKey, digest);
+  return { declaration, signature };
+}
+function verifyTaxDeclarationSignature(declaration, signature, expectedAddress) {
+  const message = { ...declaration, validUntil: BigInt(declaration.validUntil) };
+  const digest = viem.hashTypedData({
+    domain: TAX_DECLARATION_DOMAIN,
+    types: TAX_DECLARATION_TYPES,
+    primaryType: TAX_DECLARATION_PRIMARY_TYPE,
+    message
+  });
+  return verifySignature(digest, signature, expectedAddress);
+}
+function encodeTaxDeclarationHeader(result) {
+  const json = JSON.stringify({ ...result.declaration, signature: result.signature });
+  return base64Url(json);
+}
+function base64Url(value) {
+  const standard = typeof Buffer !== "undefined" ? Buffer.from(value, "utf8").toString("base64") : btoa(String.fromCharCode(...new TextEncoder().encode(value)));
+  return standard.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function addressFromKeyForTax(delegateKey) {
+  try {
+    return addressFromKey(delegateKey);
+  } catch (err) {
+    throw new chunkSZHKBOCZ_cjs.HavenSigningError(
+      `Invalid delegate key for tax declaration signing: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+var TaxDeclarationRefusedError = class extends chunkSZHKBOCZ_cjs.HavenSigningError {
+  code = "TAX_DECLARATION_REFUSED";
+  constructor(message) {
+    super(message);
+    this.name = "TaxDeclarationRefusedError";
+  }
+};
 
 // src/next-step.ts
 var NEXT_TOOL_SERVER_NAMES = {
@@ -1232,8 +1405,12 @@ exports.SWEEP_BASE_CHAIN_ID = SWEEP_BASE_CHAIN_ID;
 exports.SWEEP_BASE_SEPOLIA_CHAIN_ID = SWEEP_BASE_SEPOLIA_CHAIN_ID;
 exports.SWEEP_BASE_SEPOLIA_USDC_ADDRESS = SWEEP_BASE_SEPOLIA_USDC_ADDRESS;
 exports.SWEEP_BASE_USDC_ADDRESS = SWEEP_BASE_USDC_ADDRESS;
+exports.TAX_DECLARATION_DOMAIN = TAX_DECLARATION_DOMAIN;
+exports.TAX_DECLARATION_PRIMARY_TYPE = TAX_DECLARATION_PRIMARY_TYPE;
+exports.TAX_DECLARATION_TYPES = TAX_DECLARATION_TYPES;
 exports.TRANSFER_WITH_AUTHORIZATION_TYPES = TRANSFER_WITH_AUTHORIZATION_TYPES;
 exports.TYPED_DATA_NOT_ALLOWED = TYPED_DATA_NOT_ALLOWED;
+exports.TaxDeclarationRefusedError = TaxDeclarationRefusedError;
 exports.X402PaymentHeaderValidationError = X402PaymentHeaderValidationError;
 exports.X402_LEGACY_PAYMENT_HEADER_NAME = X402_LEGACY_PAYMENT_HEADER_NAME;
 exports.X402_MAX_AUTHORIZATION_WINDOW_SECONDS = X402_MAX_AUTHORIZATION_WINDOW_SECONDS;
@@ -1243,11 +1420,14 @@ exports.X402_PAYMENT_HEADER_NAMES_SENT = X402_PAYMENT_HEADER_NAMES_SENT;
 exports.X402_PAYMENT_REQUIRED_HEADER_NAME = X402_PAYMENT_REQUIRED_HEADER_NAME;
 exports.X402_PAYMENT_RESPONSE_HEADER_NAME = X402_PAYMENT_RESPONSE_HEADER_NAME;
 exports.X402_SETTLEMENT_FORWARD_MARGIN_SECONDS = X402_SETTLEMENT_FORWARD_MARGIN_SECONDS;
+exports.X_TAX_DECLARATION_HEADER = X_TAX_DECLARATION_HEADER;
+exports.addressFromKey = addressFromKey;
 exports.assertBoundDirectPaymentUserOp = assertBoundDirectPaymentUserOp;
 exports.assertFundingLegPaysDelegate = assertFundingLegPaysDelegate;
 exports.assertOwnSettlementChild = assertOwnSettlementChild;
 exports.assertOwnTaskBudgetCloseUserOp = assertOwnTaskBudgetCloseUserOp;
 exports.assertOwnTaskChild = assertOwnTaskChild;
+exports.buildSignedTaxDeclaration = buildSignedTaxDeclaration;
 exports.buildSweepAuthorizationMessage = buildSweepAuthorizationMessage;
 exports.buildSweepTypedData = buildSweepTypedData;
 exports.buildX402ExpectedMessage = buildX402ExpectedMessage;
@@ -1260,6 +1440,7 @@ exports.defaultNextToolFor = defaultNextToolFor;
 exports.encodeBase64Json = encodeBase64Json;
 exports.encodeBase64Utf8 = encodeBase64Utf8;
 exports.encodePaymentProof = encodePaymentProof;
+exports.encodeTaxDeclarationHeader = encodeTaxDeclarationHeader;
 exports.hashDelegation = hashDelegation;
 exports.havenClientIdentity = havenClientIdentity;
 exports.isErc7710Option = isErc7710Option;
@@ -1270,6 +1451,7 @@ exports.normalizePaymentRequired = normalizePaymentRequired;
 exports.parseNextTool = parseNextTool;
 exports.parsePaymentRequired = parsePaymentRequired;
 exports.parsePaymentRequiredResponse = parsePaymentRequiredResponse;
+exports.principalAttributionHash = principalAttributionHash;
 exports.readClientUpdate = readClientUpdate;
 exports.renderNextTool = renderNextTool;
 exports.resolveTokenBySymbol = resolveTokenBySymbol;
@@ -1278,16 +1460,20 @@ exports.selectErc7710PaymentOption = selectErc7710PaymentOption;
 exports.selectPaymentOption = selectPaymentOption;
 exports.selectStandardPaymentOption = selectStandardPaymentOption;
 exports.selectX402SettlementScheme = selectX402SettlementScheme;
+exports.signHash = signHash;
 exports.sweepUsdcAddress = sweepUsdcAddress;
 exports.sweepUsdcDomain = sweepUsdcDomain;
+exports.taxPrincipalId = taxPrincipalId;
 exports.toStandardPaymentRequirements = toStandardPaymentRequirements;
 exports.unsupportedNodeVersionMessage = unsupportedNodeVersionMessage;
 exports.validateStandardX402PaymentHeader = validateStandardX402PaymentHeader;
+exports.verifySignature = verifySignature;
+exports.verifyTaxDeclarationSignature = verifyTaxDeclarationSignature;
 exports.x402AssetTransferMethod = x402AssetTransferMethod;
 exports.x402AuthorizationAmount = x402AuthorizationAmount;
 exports.x402FacilitatorAddresses = x402FacilitatorAddresses;
 exports.x402PaymentHeaderNamesFor = x402PaymentHeaderNamesFor;
 exports.x402PaymentHeaderNamesSent = x402PaymentHeaderNamesSent;
 exports.x402V2PaymentEnvelope = x402V2PaymentEnvelope;
-//# sourceMappingURL=chunk-MJ2IMB5H.cjs.map
-//# sourceMappingURL=chunk-MJ2IMB5H.cjs.map
+//# sourceMappingURL=chunk-J6SS36ZD.cjs.map
+//# sourceMappingURL=chunk-J6SS36ZD.cjs.map