@intentlayer/sdk 0.1.0 → 0.1.2

package/dist/index.mjs

@@ -77,7 +77,7 @@ import {
   init_constraints,
   isRecipientAllowed,
   v2ConstraintsToLeafParams
-} from "./chunk-GRBEB2EV.mjs";
+} from "./chunk-BN6IO64L.mjs";
 import {
   __esm,
   __export,
@@ -3590,7 +3590,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(
@@ -3695,13 +3695,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) {
@@ -3963,6 +3966,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
   // ══════════════════════════════════════════════════════════════════════════
   /**
@@ -5032,7 +5149,7 @@ var CloudRuntimeClient = class {
     const walletData = await this.getWalletData();
     const { buildPolicyBootstrapIntent: buildPolicyBootstrapIntent2, generatePolicyId: generatePolicyId2 } = await import("./policyBootstrapBuilder-RJOUS67N.mjs");
     const { buildRegistryBootstrapIntent: buildRegistryBootstrapIntent2, generateProfileId: generateProfileId2 } = await import("./registryBootstrapBuilder-AUWE7EWJ.mjs");
-    const { buildV2ConstraintsFromAgent: buildV2ConstraintsFromAgent3 } = await import("./agentConstraintBuilder-CK56UDUI.mjs");
+    const { buildV2ConstraintsFromAgent: buildV2ConstraintsFromAgent3 } = await import("./agentConstraintBuilder-CWXPHBNY.mjs");
     const v2Result = buildV2ConstraintsFromAgent3(params.constraints);
     const policyId = generatePolicyId2(walletData.walletAddress, params.name);
     const venueProfileId = generateProfileId2(`${walletData.walletAddress}`, `venue_${params.name}`);
@@ -5067,6 +5184,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
@@ -6061,7 +6180,7 @@ async function combinedBootstrap(config, runtime) {
   if (constraints.forbidBridges) {
     globalFlags |= GLOBAL_FLAG_NO_BRIDGE;
   }
-  const dailyCap = dailyCapWei ?? (constraints.maxDailyUsd ? parseEther2(String(constraints.maxDailyUsd)) : 0n);
+  const dailyCap = dailyCapWei ?? v2Result.dailyCapWei ?? (constraints.maxDailyUsd ? parseEther2(String(constraints.maxDailyUsd)) : 0n);
   const nonce = await runtime.getNonce(walletAddress);
   const currentTimestamp = await runtime.getCurrentTimestamp();
   const needsVendorHeader = constraints.vendorMembershipRequired && constraints.vendorRegistry;
@@ -6180,7 +6299,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,
@@ -6212,7 +6331,8 @@ async function createSubWallet(params, runtime) {
   if (params.constraints.forbidBridges && !constraintsRequireV3(params.constraints)) {
     globalFlags |= GLOBAL_FLAG_NO_BRIDGE;
   }
-  const dailyCapWei = params.constraints.maxDailyUsd ? parseEther3(String(params.constraints.maxDailyUsd)) : 0n;
+  const capValue = params.constraints.capPerPeriod ?? params.constraints.maxDailyUsd;
+  const dailyCapWei = capValue ? parseEther3(String(capValue)) : 0n;
   const bootstrapIntent = buildMinimalPolicyBootstrapIntent({
     wallet: walletAddress,
     chainId: BigInt(runtime.chainId),
@@ -7481,8 +7601,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) {
@@ -7532,6 +7653,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) {
@@ -7542,8 +7664,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:
@@ -7561,9 +7684,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
@@ -7571,6 +7696,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) {
@@ -7581,14 +7709,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:
@@ -7602,6 +7732,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,
@@ -7615,17 +7748,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;
@@ -7633,13 +7768,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,
@@ -7669,15 +7805,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
@@ -7706,12 +7842,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,
@@ -7729,15 +7866,15 @@ function marketingBucket(config) {
     venueSelectors.push(SELECTORS.TRANSFER);
   }
   const bucketIdHex = config.bucketId.startsWith("0x") && config.bucketId.length === 66 ? config.bucketId : keccak2569(toHex3(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,
@@ -7757,13 +7894,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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentlayer/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TypeScript SDK for building, signing, and verifying intents on Intent Layer",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",