@intentlayer/sdk 0.1.0 → 0.1.2

package/dist/index.js

@@ -1668,11 +1668,13 @@ function buildV2ConstraintsFromAgent(constraints) {
   if (constraints.allowedRecipients && constraints.allowedRecipients.length === 1) {
     v2Params.allowedRecipient = constraints.allowedRecipients[0];
   }
-  if (constraints.maxDailyUsd) {
-    v2Params.cap = (0, import_viem18.parseEther)(String(constraints.maxDailyUsd));
-    v2Params.periodType = "daily";
-  } else if (constraints.maxPerTxUsd) {
-    v2Params.cap = (0, import_viem18.parseEther)(String(constraints.maxPerTxUsd));
+  const capResolution = resolveCapConfig(constraints);
+  if (capResolution.leafCap) {
+    const asset = constraints.allowedAssets?.[0];
+    v2Params.cap = capToWei(capResolution.leafCap.capValue, asset, constraints);
+    if (capResolution.leafCap.hasPeriod) {
+      v2Params.periodType = "daily";
+    }
   }
   if (constraints.deadline) {
     v2Params.deadline = constraints.deadline;
@@ -1685,6 +1687,11 @@ function buildV2ConstraintsFromAgent(constraints) {
   }
   const leaf = buildV2LeafFromConstraints(v2Params);
   const root = (0, import_viem18.keccak256)(leaf);
+  let dailyCapWei;
+  if (capResolution.dailyCapValue !== void 0) {
+    const asset = constraints.allowedAssets?.[0];
+    dailyCapWei = capToWei(capResolution.dailyCapValue, asset, constraints);
+  }
   let recipientLeaves;
   if (constraints.allowedRecipients && constraints.allowedRecipients.length === 1) {
     const recipient = constraints.allowedRecipients[0].toLowerCase();
@@ -1692,12 +1699,12 @@ function buildV2ConstraintsFromAgent(constraints) {
     const key = `${recipient}-${asset}`;
     recipientLeaves = { [key]: leaf };
   }
-  return { leaf, root, recipientLeaves };
+  return { leaf, root, recipientLeaves, dailyCapWei };
 }
 function buildMultiRecipientV2Constraints(constraints) {
   const recipients = constraints.allowedRecipients;
   const builder = new CompoundLeafBuilder();
-  const cap = constraints.maxDailyUsd ? (0, import_viem18.parseEther)(String(constraints.maxDailyUsd)) : constraints.maxPerTxUsd ? (0, import_viem18.parseEther)(String(constraints.maxPerTxUsd)) : void 0;
+  const capResolution = resolveCapConfig(constraints);
   const dummyWallet = "0x0000000000000000000000000000000000000001";
   const assets = constraints.allowedAssets;
   const hasMultipleAssets = assets && assets.length > 1;
@@ -1709,7 +1716,7 @@ function buildMultiRecipientV2Constraints(constraints) {
         recipientAssetCombinations.push({
           recipient,
           asset,
-          maxAmount: cap,
+          maxAmount: capResolution.leafCap ? capToWei(capResolution.leafCap.capValue, asset, constraints) : void 0,
           deadline: constraints.deadline
         });
       }
@@ -1717,14 +1724,20 @@ function buildMultiRecipientV2Constraints(constraints) {
     multiPolicy = builder.createMultiRecipientPolicy(dummyWallet, recipientAssetCombinations);
   } else {
     const asset = assets?.[0];
+    const cap = capResolution.leafCap ? capToWei(capResolution.leafCap.capValue, asset, constraints) : void 0;
     multiPolicy = builder.createMultiRecipientPolicy(dummyWallet, {
       allowedRecipients: recipients,
       allowedAsset: asset,
       maxAmount: cap,
       deadline: constraints.deadline,
-      periodCode: constraints.maxDailyUsd ? PERIOD_DAILY : void 0
+      periodCode: capResolution.leafCap?.hasPeriod ? PERIOD_DAILY : void 0
     });
   }
+  let dailyCapWei;
+  if (capResolution.dailyCapValue !== void 0) {
+    const asset = assets?.[0];
+    dailyCapWei = capToWei(capResolution.dailyCapValue, asset, constraints);
+  }
   const defaultAsset = assets?.[0] ? assets[0].toLowerCase() : "*";
   const defaultKey = `${recipients[0].toLowerCase()}-${defaultAsset}`;
   const defaultLeafAndProof = multiPolicy.leafProofs[defaultKey];
@@ -1735,8 +1748,9 @@ function buildMultiRecipientV2Constraints(constraints) {
     leaf: defaultLeafAndProof,
     // This is actually leafAndProof (leaf + merkle proof)
     root: multiPolicy.merkleRoot,
-    recipientLeaves: multiPolicy.leafProofs
+    recipientLeaves: multiPolicy.leafProofs,
     // Map of recipient-asset -> leafAndProof
+    dailyCapWei
   };
 }
 function constraintsToV2Params(constraints, recipient) {
@@ -1746,11 +1760,13 @@ function constraintsToV2Params(constraints, recipient) {
   } else if (constraints.allowedRecipients && constraints.allowedRecipients.length === 1) {
     params.allowedRecipient = constraints.allowedRecipients[0];
   }
-  if (constraints.maxDailyUsd) {
-    params.cap = (0, import_viem18.parseEther)(String(constraints.maxDailyUsd));
-    params.periodType = "daily";
-  } else if (constraints.maxPerTxUsd) {
-    params.cap = (0, import_viem18.parseEther)(String(constraints.maxPerTxUsd));
+  const capResolution = resolveCapConfig(constraints);
+  if (capResolution.leafCap) {
+    const asset = constraints.allowedAssets?.[0];
+    params.cap = capToWei(capResolution.leafCap.capValue, asset, constraints);
+    if (capResolution.leafCap.hasPeriod) {
+      params.periodType = "daily";
+    }
   }
   if (constraints.deadline) {
     params.deadline = constraints.deadline;
@@ -1763,6 +1779,31 @@ function constraintsToV2Params(constraints, recipient) {
   }
   return params;
 }
+function resolveCapConfig(constraints) {
+  const periodCap = constraints.capPerPeriod ?? constraints.maxDailyUsd;
+  const txCap = constraints.capPerTx ?? constraints.maxPerTxUsd;
+  if (txCap && periodCap) {
+    return {
+      leafCap: { capValue: txCap, hasPeriod: false },
+      dailyCapValue: periodCap
+    };
+  } else if (periodCap) {
+    return {
+      leafCap: { capValue: periodCap, hasPeriod: true },
+      dailyCapValue: void 0
+    };
+  } else if (txCap) {
+    return {
+      leafCap: { capValue: txCap, hasPeriod: false },
+      dailyCapValue: void 0
+    };
+  }
+  return { leafCap: void 0, dailyCapValue: void 0 };
+}
+function capToWei(capValue, asset, constraints) {
+  const decimals = asset && constraints.tokenDecimals ? constraints.tokenDecimals[asset.toLowerCase()] ?? 18 : 18;
+  return (0, import_viem18.parseUnits)(String(capValue), decimals);
+}
 function bigintToBytes32(value) {
   return `0x${value.toString(16).padStart(64, "0")}`;
 }
@@ -5310,7 +5351,7 @@ var RelayerRuntime = class {
    *
    * @example
    * ```ts
-   * import { GLOBAL_FLAG_NO_BRIDGE } from '@iel/sdk';
+   * import { GLOBAL_FLAG_NO_BRIDGE } from '@intentlayer/sdk';
    *
    * // Enable bridge blocking (invalidates pending intents)
    * const { headerVersion, txHash } = await runtime.updatePolicyGlobalFlags(
@@ -5415,13 +5456,16 @@ var IELCloudClient = class {
    */
   async request(method, path, body) {
     const token = await this.getAuthToken();
+    const headers = {
+      Authorization: `Bearer ${token}`
+    };
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
     const response = await fetch(`${this.baseUrl}${path}`, {
       method,
-      headers: {
-        Authorization: `Bearer ${token}`,
-        "Content-Type": "application/json"
-      },
-      body: body ? JSON.stringify(body) : void 0
+      headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
     });
     const data = await response.json();
     if (!response.ok) {
@@ -5683,6 +5727,120 @@ var IELCloudClient = class {
     );
   }
   // ══════════════════════════════════════════════════════════════════════════
+  // Request Operations (Policy, AgentWallet, Fund)
+  // ══════════════════════════════════════════════════════════════════════════
+  /**
+   * Create a request (policy, agent_wallet, or fund).
+   * Agents use this to request new permissions from the wallet owner.
+   */
+  async createRequest(body, idempotencyKey) {
+    const token = await this.getAuthToken();
+    const headers = {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json"
+    };
+    if (idempotencyKey) {
+      headers["Idempotency-Key"] = idempotencyKey;
+    }
+    const response = await fetch(`${this.baseUrl}/v1/requests`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const error = data;
+      throw new CloudAPIError(
+        response.status,
+        error.code ?? "UNKNOWN_ERROR",
+        error.message ?? "Unknown error",
+        error.details
+      );
+    }
+    return data;
+  }
+  /**
+   * List requests with optional filters.
+   */
+  async listRequests(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.type) params.set("type", options.type);
+    if (options?.walletId) params.set("walletId", options.walletId);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.request(
+      "GET",
+      `/v1/requests${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Get a request by ID.
+   */
+  async getRequest(requestId) {
+    return this.request("GET", `/v1/requests/${requestId}`);
+  }
+  /**
+   * Get a human-readable summary of a request.
+   */
+  async getRequestSummary(requestId) {
+    return this.request("GET", `/v1/requests/${requestId}/summary`);
+  }
+  /**
+   * Approve a request. Returns the EIP-712 typed data for the owner to sign.
+   * Only callable by owner (API key holder).
+   */
+  async approveRequest(requestId) {
+    return this.request(
+      "POST",
+      `/v1/requests/${requestId}/approve`
+    );
+  }
+  /**
+   * Deny a request with an optional reason.
+   * Only callable by owner (API key holder).
+   */
+  async denyRequest(requestId, reason) {
+    return this.request(
+      "POST",
+      `/v1/requests/${requestId}/deny`,
+      reason ? { reason } : void 0
+    );
+  }
+  /**
+   * Execute an approved request by submitting the owner's EIP-712 signature.
+   * Triggers on-chain execution via the bootstrap pipeline.
+   * Only callable by owner (API key holder).
+   */
+  async executeRequest(requestId, signature, txHash, policyId, walletAddress) {
+    const body = { signature };
+    if (txHash) body.txHash = txHash;
+    if (policyId) body.policyId = policyId;
+    if (walletAddress) body.walletAddress = walletAddress;
+    return this.request(
+      "POST",
+      `/v1/requests/${requestId}/execute`,
+      body
+    );
+  }
+  /**
+   * Compile policy constraints for a policy request.
+   * Returns the final constraints that will be bootstrapped after approval,
+   * along with any warnings about clamped/excluded items.
+   *
+   * Use this to show users exactly what they're approving before signing.
+   *
+   * @param requestId - Policy request ID
+   * @returns Compiled policy with finalConstraints, warnings, and diff
+   */
+  async compilePolicyRequest(requestId) {
+    return this.request(
+      "GET",
+      `/v1/requests/${requestId}/compile-policy`
+    );
+  }
+  // ══════════════════════════════════════════════════════════════════════════
   // Convenience Methods
   // ══════════════════════════════════════════════════════════════════════════
   /**
@@ -6788,6 +6946,8 @@ var CloudRuntimeClient = class {
       nonce,
       policyId,
       root: v2Result.root,
+      dailyCap: v2Result.dailyCapWei,
+      // Policy-level daily cap (dual-cap: capPerTx in leaf + capPerPeriod here)
       delegate: params.delegate ?? this.runtime.defaultDelegate,
       validFor: 3600,
       // 1 hour validity
@@ -7407,7 +7567,6 @@ init_v2LeafBuilder();
 // src/policy/policyHeaderBuilder.ts
 var import_viem21 = require("viem");
 init_types();
-init_types();
 function stringLabelToBytes32(label) {
   const bytes = (0, import_viem21.stringToBytes)(label);
   if (bytes.length > 32) {
@@ -7794,7 +7953,7 @@ async function combinedBootstrap(config, runtime) {
   if (constraints.forbidBridges) {
     globalFlags |= GLOBAL_FLAG_NO_BRIDGE;
   }
-  const dailyCap = dailyCapWei ?? (constraints.maxDailyUsd ? (0, import_viem23.parseEther)(String(constraints.maxDailyUsd)) : 0n);
+  const dailyCap = dailyCapWei ?? v2Result.dailyCapWei ?? (constraints.maxDailyUsd ? (0, import_viem23.parseEther)(String(constraints.maxDailyUsd)) : 0n);
   const nonce = await runtime.getNonce(walletAddress);
   const currentTimestamp = await runtime.getCurrentTimestamp();
   const needsVendorHeader = constraints.vendorMembershipRequired && constraints.vendorRegistry;
@@ -7913,7 +8072,7 @@ async function createSubWallet(params, runtime) {
   const walletAddress = await runtime.predictWalletAddress(params.parentWallet, salt);
   const isDeployed = await runtime.isWalletDeployed(walletAddress);
   if (!isDeployed) {
-    await runtime.deployWallet(params.parentWallet, salt);
+    await runtime.deployWallet(params.parentWallet, salt, params.agentName);
   }
   const constraintData = buildAgentConstraints(
     params.constraints,
@@ -7945,7 +8104,8 @@ async function createSubWallet(params, runtime) {
   if (params.constraints.forbidBridges && !constraintsRequireV3(params.constraints)) {
     globalFlags |= GLOBAL_FLAG_NO_BRIDGE;
   }
-  const dailyCapWei = params.constraints.maxDailyUsd ? (0, import_viem24.parseEther)(String(params.constraints.maxDailyUsd)) : 0n;
+  const capValue = params.constraints.capPerPeriod ?? params.constraints.maxDailyUsd;
+  const dailyCapWei = capValue ? (0, import_viem24.parseEther)(String(capValue)) : 0n;
   const bootstrapIntent = buildMinimalPolicyBootstrapIntent({
     wallet: walletAddress,
     chainId: BigInt(runtime.chainId),
@@ -9214,8 +9374,9 @@ function buildPresetSummary(type, description, constraints) {
   if (constraints.allowedRecipients) {
     summary.recipients = constraints.allowedRecipients.map(formatAddress);
   }
-  if (constraints.maxDailyUsd) {
-    summary.cap = formatUsd(constraints.maxDailyUsd);
+  const capValue = constraints.capPerPeriod ?? constraints.maxDailyUsd;
+  if (capValue) {
+    summary.cap = formatUsd(capValue);
     summary.period = getPeriodName(constraints.periodCode);
   }
   if (constraints.bucketId) {
@@ -9265,6 +9426,7 @@ var SELECTORS = {
   UNISWAP_EXACT_OUTPUT_SINGLE: "0xdb3e2198"
 };
 function tradingAgent(config) {
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   const venueTargets = [config.swapContract];
   const venueSelectors = [...config.swapSelectors ?? []];
   if (config.treasuryReturn) {
@@ -9275,8 +9437,9 @@ function tradingAgent(config) {
     venueSelectors.push(SELECTORS.TRANSFER);
   }
   return {
-    maxDailyUsd: config.maxDailyUsd,
+    capPerPeriod: cap,
     allowedRecipients: config.treasuryReturn ? [config.treasuryReturn] : void 0,
+    allowedAssets: config.tokenContract ? [config.tokenContract] : void 0,
     venueTargets,
     venueSelectors,
     // Multi-op format now supports venue validation:
@@ -9294,9 +9457,11 @@ function paymentAgent(config) {
     venueTargets.push(config.tokenContract);
     venueSelectors.push(SELECTORS.TRANSFER);
   }
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   return {
     allowedRecipients: config.vendors,
-    maxDailyUsd: config.maxDailyUsd,
+    allowedAssets: config.tokenContract ? [config.tokenContract] : void 0,
+    capPerPeriod: cap,
     venueTargets,
     venueSelectors,
     requireVenue: true
@@ -9304,6 +9469,9 @@ function paymentAgent(config) {
   };
 }
 function treasuryOps(config) {
+  if (config.tokenContracts && config.tokenContracts.length === 0) {
+    throw new Error("treasuryOps: tokenContracts must not be empty when provided");
+  }
   const venueTargets = [...config.protocolContracts];
   const venueSelectors = [...config.protocolSelectors];
   if (config.treasuryAddresses) {
@@ -9314,14 +9482,16 @@ function treasuryOps(config) {
     venueSelectors.push(SELECTORS.TRANSFER);
     venueSelectors.push(SELECTORS.APPROVE);
   }
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   const protocolCount = config.protocolContracts.length;
   const bridgeStatus = config.allowBridges ? "" : ", NO_BRIDGE";
-  const description = `Treasury Ops: ${protocolCount} protocols, ${formatUsd(config.maxDailyUsd)}/day${bridgeStatus}`;
+  const description = `Treasury Ops: ${protocolCount} protocols, ${cap ?? "?"}/day${bridgeStatus}`;
   const constraints = {
     description,
     presetType: "treasuryOps",
-    maxDailyUsd: config.maxDailyUsd,
+    capPerPeriod: cap,
     allowedRecipients: config.treasuryAddresses,
+    allowedAssets: config.tokenContracts,
     venueTargets,
     venueSelectors,
     // Multi-op format now supports venue validation:
@@ -9335,6 +9505,9 @@ function treasuryOps(config) {
   return constraints;
 }
 function lendingOps(config) {
+  if (!config.tokenContracts || config.tokenContracts.length === 0) {
+    throw new Error("lendingOps requires at least one token contract");
+  }
   const lendingSelectors = config.lendingSelectors ?? [
     SELECTORS.AAVE_SUPPLY,
     SELECTORS.AAVE_WITHDRAW,
@@ -9348,17 +9521,19 @@ function lendingOps(config) {
     venueSelectors.push(SELECTORS.APPROVE);
     venueSelectors.push(SELECTORS.TRANSFER);
   }
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   const tokenCount = config.tokenContracts?.length ?? 0;
   const bridgeStatus = config.allowBridges ? "" : ", NO_BRIDGE";
-  const description = `Lending Ops: ${tokenCount} tokens, ${formatUsd(config.maxDailyUsd)}/day${bridgeStatus}`;
+  const description = `Lending Ops: ${tokenCount} tokens, ${cap ?? "?"}/day${bridgeStatus}`;
   const constraints = {
     description,
     presetType: "lendingOps",
-    maxDailyUsd: config.maxDailyUsd,
+    capPerPeriod: cap,
     venueTargets,
     venueSelectors,
     requireVenue: true,
-    forbidBridges: !config.allowBridges
+    forbidBridges: !config.allowBridges,
+    allowedAssets: config.tokenContracts
   };
   logPresetSummary(buildPresetSummary("Lending Ops", description, constraints));
   return constraints;
@@ -9366,13 +9541,14 @@ function lendingOps(config) {
 function stablecoinTransfer(config) {
   const venueTargets = [...config.stablecoins];
   const venueSelectors = [SELECTORS.TRANSFER];
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   const recipientCount = config.recipients.length;
   const stablecoinCount = config.stablecoins.length;
-  const description = `Stablecoin Transfer: ${recipientCount} recipients, ${stablecoinCount} stablecoins, ${formatUsd(config.maxDailyUsd)}/day`;
+  const description = `Stablecoin Transfer: ${recipientCount} recipients, ${stablecoinCount} stablecoins, ${cap ?? "?"}/day`;
   const constraints = {
     description,
     presetType: "stablecoinTransfer",
-    maxDailyUsd: config.maxDailyUsd,
+    capPerPeriod: cap,
     allowedRecipients: config.recipients,
     allowedAssets: config.stablecoins,
     venueTargets,
@@ -9402,15 +9578,15 @@ function payroll(config) {
     venueTargets.push(config.tokenContract);
     venueSelectors.push(SELECTORS.TRANSFER);
   }
+  const cap = config.capPerPeriod ?? config.maxMonthlyUsd;
   const employeeCount = config.employees.length;
-  const description = `Payroll: ${employeeCount} employees, ${formatUsd(config.maxMonthlyUsd)}/month`;
+  const description = `Payroll: ${employeeCount} employees, ${cap ?? "?"}/month`;
   const constraints = {
     description,
     presetType: "payroll",
     allowedRecipients: config.employees,
     allowedAssets,
-    // Use maxMonthlyUsd directly as the cap value with PERIOD_MONTH30
-    maxDailyUsd: config.maxMonthlyUsd,
+    capPerPeriod: cap,
     periodCode: PERIOD_MONTH30,
     periodOffsetMinutes: 0,
     // UTC
@@ -9439,12 +9615,13 @@ function transferOnly(config) {
     venueTargets.push(config.tokenContract);
     venueSelectors.push(SELECTORS.TRANSFER);
   }
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   const recipientCount = config.recipients.length;
-  const description = `Transfer Only: ${recipientCount} recipients, ${formatUsd(config.maxDailyUsd)}/day`;
+  const description = `Transfer Only: ${recipientCount} recipients, ${cap ?? "?"}/day`;
   const constraints = {
     description,
     presetType: "transferOnly",
-    maxDailyUsd: config.maxDailyUsd,
+    capPerPeriod: cap,
     allowedRecipients: config.recipients,
     allowedAssets,
     venueTargets,
@@ -9462,15 +9639,15 @@ function marketingBucket(config) {
     venueSelectors.push(SELECTORS.TRANSFER);
   }
   const bucketIdHex = config.bucketId.startsWith("0x") && config.bucketId.length === 66 ? config.bucketId : (0, import_viem27.keccak256)((0, import_viem27.toHex)(config.bucketId));
+  const cap = config.capPerPeriod ?? config.maxMonthlyUsd;
   const recipientCount = config.recipients.length;
   const bucketName = typeof config.bucketId === "string" && !config.bucketId.startsWith("0x") ? config.bucketId : bucketIdHex.slice(0, 10) + "...";
-  const description = `Marketing: ${recipientCount} vendors share ${formatUsd(config.maxMonthlyUsd)}/month`;
+  const description = `Marketing: ${recipientCount} vendors share ${cap ?? "?"}/month`;
   const constraints = {
     description,
     presetType: "marketingBucket",
     allowedRecipients: config.recipients,
-    // Use maxMonthlyUsd as the cap with PERIOD_MONTH30
-    maxDailyUsd: config.maxMonthlyUsd,
+    capPerPeriod: cap,
     periodCode: PERIOD_MONTH30,
     periodOffsetMinutes: 0,
     bucketId: bucketIdHex,
@@ -9490,13 +9667,14 @@ function vendorCard(config) {
   }
   const vendorGroupIdBigint = typeof config.vendorGroupId === "bigint" ? config.vendorGroupId : BigInt(config.vendorGroupId);
   const hasVendorRegistry = config.vendorRegistry && config.vendorProfileId;
+  const cap = config.capPerPeriod ?? config.maxDailyUsd;
   const vendorProof = hasVendorRegistry ? " (with Merkle proof)" : "";
-  const description = `Vendor Card: Dynamic vendor list, ${formatUsd(config.maxDailyUsd)}/day${vendorProof}`;
+  const description = `Vendor Card: Dynamic vendor list, ${cap ?? "?"}/day${vendorProof}`;
   const constraints = {
     description,
     presetType: "vendorCard",
     vendorGroupId: vendorGroupIdBigint,
-    maxDailyUsd: config.maxDailyUsd,
+    capPerPeriod: cap,
     periodCode: PERIOD_DAILY,
     periodOffsetMinutes: 0,
     venueTargets: venueTargets.length > 0 ? venueTargets : void 0,