@coinbase/cdp-hooks 0.0.42 → 0.0.44

package/README.md

@@ -780,6 +780,77 @@ function ExportSolanaKey() {
 
 Smart Accounts provide advanced account abstraction features with React hooks.
 
+#### Create Spend Permissions
+
+Spend permissions allow Smart Accounts to delegate spending authority to other accounts within specified limits and time periods. The `useCreateSpendPermission` hook provides an easy way to create spend permissions with automatic user operation tracking.
+
+```tsx lines
+import { useCreateSpendPermission, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function CreateSpendPermission() {
+  const { createSpendPermission, status, data, error } = useCreateSpendPermission();
+  const { currentUser } = useCurrentUser();
+
+  const handleCreateSpendPermission = async () => {
+    try {
+      const result = await createSpendPermission({
+        network: "base-sepolia",
+        spender: "0x742D35Cc6634C0532925a3b8D6Ec6F1C2b9c1E46", // Address that can spend tokens
+        token: "usdc", // Token symbol ("eth", "usdc") or contract address
+        allowance: "10000000", // 10 USDC (6 decimals)
+        periodInDays: 7, // Weekly recurring allowance
+        useCdpPaymaster: true, // Use CDP paymaster for gas sponsorship
+      });
+
+      console.log("User Operation Hash:", result.userOperationHash);
+    } catch (error) {
+      console.error("Failed to create spend permission:", error);
+    }
+  };
+
+  return (
+    <div>
+      {status === "idle" && <p>Ready to create spend permission</p>}
+
+      {status === "pending" && (
+        <div>
+          <p>Creating spend permission...</p>
+          {data && <p>User Op Hash: {data.userOpHash}</p>}
+        </div>
+      )}
+
+      {status === "success" && data && (
+        <div>
+          <p>Spend permission created successfully!</p>
+          <p>Transaction Hash: {data.transactionHash}</p>
+          <p>Status: {data.status}</p>
+        </div>
+      )}
+
+      {status === "error" && (
+        <div>
+          <p>Failed to create spend permission</p>
+          <p>Error: {error?.message}</p>
+        </div>
+      )}
+
+      <button
+        onClick={handleCreateSpendPermission}
+        disabled={status === "pending" || !currentUser?.evmSmartAccounts?.[0]}
+      >
+        {status === "pending" ? "Creating..." : "Create Spend Permission"}
+      </button>
+    </div>
+  );
+}
+```
+
+The hook automatically:
+- Detects the user's Smart Account (or allows you to specify `evmSmartAccount`)
+- Converts `periodInDays` to seconds
+- Resolves token symbols like "eth" and "usdc" to contract addresses
+- Tracks the user operation status and provides real-time updates
+
 #### Send User Operations
 
 Send user operations from Smart Accounts with support for multiple calls and paymaster sponsorship. The hook returns a method to execute the user operation and `status`, `data`, and `error` properties to read the result of the user operation:

package/dist/esm/index.js

@@ -1,29 +1,31 @@
 import { APIError as n } from "@coinbase/cdp-core";
-import { CDPContext as u, CDPHooksProvider as o } from "./index2.js";
-import { useConfig as i, useCurrentUser as t, useEnforceAuthenticated as S, useEnforceUnauthenticated as c, useEvmAddress as m, useExportEvmAccount as E, useExportSolanaAccount as d, useGetAccessToken as g, useIsInitialized as f, useIsSignedIn as l, useSendEvmTransaction as p, useSendSolanaTransaction as v, useSendUserOperation as T, useSignEvmHash as A, useSignEvmMessage as I, useSignEvmTransaction as x, useSignEvmTypedData as P, useSignInWithEmail as h, useSignInWithSms as C, useSignOut as O, useSignSolanaMessage as U, useSignSolanaTransaction as y, useSolanaAddress as D, useVerifyEmailOTP as W, useVerifySmsOTP as k, useWaitForUserOperation as H } from "./index3.js";
+import { CDPContext as o, CDPHooksProvider as a } from "./index2.js";
+import { useConfig as i, useCurrentUser as t, useEnforceAuthenticated as S, useEnforceUnauthenticated as m, useEvmAddress as c, useExportEvmAccount as d, useExportSolanaAccount as E, useGetAccessToken as g, useIsInitialized as p, useIsSignedIn as f, useSendEvmTransaction as l, useSendSolanaTransaction as v, useSendUserOperation as T, useSignEvmHash as x, useSignEvmMessage as A, useSignEvmTransaction as I, useSignEvmTypedData as P, useSignInWithEmail as C, useSignInWithSms as h, useSignOut as O, useSignSolanaMessage as U, useSignSolanaTransaction as y, useSolanaAddress as D, useVerifyEmailOTP as W, useVerifySmsOTP as k, useWaitForUserOperation as H } from "./index3.js";
+import { useCreateSpendPermission as V } from "./index4.js";
 export {
   n as APIError,
-  u as CDPContext,
-  o as CDPHooksProvider,
+  o as CDPContext,
+  a as CDPHooksProvider,
   i as useConfig,
+  V as useCreateSpendPermission,
   t as useCurrentUser,
   S as useEnforceAuthenticated,
-  c as useEnforceUnauthenticated,
-  m as useEvmAddress,
-  E as useExportEvmAccount,
-  d as useExportSolanaAccount,
+  m as useEnforceUnauthenticated,
+  c as useEvmAddress,
+  d as useExportEvmAccount,
+  E as useExportSolanaAccount,
   g as useGetAccessToken,
-  f as useIsInitialized,
-  l as useIsSignedIn,
-  p as useSendEvmTransaction,
+  p as useIsInitialized,
+  f as useIsSignedIn,
+  l as useSendEvmTransaction,
   v as useSendSolanaTransaction,
   T as useSendUserOperation,
-  A as useSignEvmHash,
-  I as useSignEvmMessage,
-  x as useSignEvmTransaction,
+  x as useSignEvmHash,
+  A as useSignEvmMessage,
+  I as useSignEvmTransaction,
   P as useSignEvmTypedData,
-  h as useSignInWithEmail,
-  C as useSignInWithSms,
+  C as useSignInWithEmail,
+  h as useSignInWithSms,
   O as useSignOut,
   U as useSignSolanaMessage,
   y as useSignSolanaTransaction,

package/dist/esm/index10.js

@@ -1,35 +1,58 @@
-import { parseAccount as I } from "./index11.js";
-import { uid as M } from "./index12.js";
-function O(n) {
-  const { batch: s, chain: e, ccipRead: u, key: d = "base", name: f = "Base Client", type: m = "base" } = n, o = n.experimental_blockTag ?? (typeof e?.experimental_preconfirmationTime == "number" ? "pending" : void 0), b = e?.blockTime ?? 12e3, p = Math.min(Math.max(Math.floor(b / 2), 500), 4e3), t = n.pollingInterval ?? p, g = n.cacheTime ?? t, x = n.account ? I(n.account) : void 0, { config: h, request: T, value: k } = n.transport({
-    chain: e,
-    pollingInterval: t
-  }), _ = { ...h, ...k }, c = {
-    account: x,
-    batch: s,
-    cacheTime: g,
-    ccipRead: u,
-    chain: e,
-    key: d,
-    name: f,
-    pollingInterval: t,
-    request: T,
-    transport: _,
-    type: m,
-    uid: M(),
-    ...o ? { experimental_blockTag: o } : {}
-  };
-  function i(l) {
-    return (v) => {
-      const a = v(l);
-      for (const y in c)
-        delete a[y];
-      const r = { ...l, ...a };
-      return Object.assign(r, { extend: i(r) });
-    };
-  }
-  return Object.assign(c, { extend: i(c) });
-}
+import { chainConfig as a } from "./index190.js";
+import { defineChain as t } from "./index173.js";
+const e = 11155111, r = /* @__PURE__ */ t({
+  ...a,
+  id: 84532,
+  network: "base-sepolia",
+  name: "Base Sepolia",
+  nativeCurrency: { name: "Sepolia Ether", symbol: "ETH", decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ["https://sepolia.base.org"]
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Basescan",
+      url: "https://sepolia.basescan.org",
+      apiUrl: "https://api-sepolia.basescan.org/api"
+    }
+  },
+  contracts: {
+    ...a.contracts,
+    disputeGameFactory: {
+      [e]: {
+        address: "0xd6E6dBf4F7EA0ac412fD8b65ED297e64BB7a06E1"
+      }
+    },
+    l2OutputOracle: {
+      [e]: {
+        address: "0x84457ca9D0163FbC4bbfe4Dfbb20ba46e48DF254"
+      }
+    },
+    portal: {
+      [e]: {
+        address: "0x49f53e41452c74589e85ca1677426ba426459e85",
+        blockCreated: 4446677
+      }
+    },
+    l1StandardBridge: {
+      [e]: {
+        address: "0xfd0Bf71F60660E2f608ed56e1659C450eB113120",
+        blockCreated: 4446677
+      }
+    },
+    multicall3: {
+      address: "0xca11bde05977b3631167028862be2a173976ca11",
+      blockCreated: 1059647
+    }
+  },
+  testnet: !0,
+  sourceId: e
+});
+({
+  ...r
+});
 export {
-  O as createClient
+  r as baseSepolia
 };

package/dist/esm/index100.js

@@ -1,37 +1,36 @@
-import { formatEther as E } from "./index90.js";
-import { formatGwei as t } from "./index91.js";
-import { BaseError as y } from "./index82.js";
-import { prettyPrint as l } from "./index93.js";
-class x extends y {
-  constructor(e, { account: a, docsPath: n, chain: m, data: f, gas: u, gasPrice: r, maxFeePerGas: o, maxPriorityFeePerGas: s, nonce: d, to: p, value: i }) {
-    const g = l({
-      from: a?.address,
-      to: p,
-      value: typeof i < "u" && `${E(i)} ${m?.nativeCurrency?.symbol || "ETH"}`,
-      data: f,
-      gas: u,
-      gasPrice: typeof r < "u" && `${t(r)} gwei`,
-      maxFeePerGas: typeof o < "u" && `${t(o)} gwei`,
-      maxPriorityFeePerGas: typeof s < "u" && `${t(s)} gwei`,
-      nonce: d
-    });
-    super(e.shortMessage, {
-      cause: e,
-      docsPath: n,
+import { BaseError as r } from "./index83.js";
+class s extends r {
+  constructor({ data: a }) {
+    super("Unable to extract image from metadata. The metadata may be malformed or invalid.", {
       metaMessages: [
-        ...e.metaMessages ? [...e.metaMessages, " "] : [],
-        "Estimate Gas Arguments:",
-        g
-      ].filter(Boolean),
-      name: "EstimateGasExecutionError"
-    }), Object.defineProperty(this, "cause", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), this.cause = e;
+        "- Metadata must be a JSON object with at least an `image`, `image_url` or `image_data` property.",
+        "",
+        `Provided data: ${JSON.stringify(a)}`
+      ],
+      name: "EnsAvatarInvalidMetadataError"
+    });
+  }
+}
+class o extends r {
+  constructor({ reason: a }) {
+    super(`ENS NFT avatar URI is invalid. ${a}`, {
+      name: "EnsAvatarInvalidNftUriError"
+    });
+  }
+}
+class n extends r {
+  constructor({ uri: a }) {
+    super(`Unable to resolve ENS avatar URI "${a}". The URI may be malformed, invalid, or does not respond with a valid image.`, { name: "EnsAvatarUriResolutionError" });
+  }
+}
+class i extends r {
+  constructor({ namespace: a }) {
+    super(`ENS NFT avatar namespace "${a}" is not supported. Must be "erc721" or "erc1155".`, { name: "EnsAvatarUnsupportedNamespaceError" });
   }
 }
 export {
-  x as EstimateGasExecutionError
+  s as EnsAvatarInvalidMetadataError,
+  o as EnsAvatarInvalidNftUriError,
+  i as EnsAvatarUnsupportedNamespaceError,
+  n as EnsAvatarUriResolutionError
 };

package/dist/esm/index101.js

@@ -1,196 +1,37 @@
-import { formatGwei as a } from "./index91.js";
-import { BaseError as t } from "./index82.js";
-class s extends t {
-  constructor({ cause: r, message: e } = {}) {
-    const n = e?.replace("execution reverted: ", "")?.replace("execution reverted", "");
-    super(`Execution reverted ${n ? `with reason: ${n}` : "for an unknown reason"}.`, {
-      cause: r,
-      name: "ExecutionRevertedError"
-    });
-  }
-}
-Object.defineProperty(s, "code", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: 3
-});
-Object.defineProperty(s, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /execution reverted/
-});
-class c extends t {
-  constructor({ cause: r, maxFeePerGas: e } = {}) {
-    super(`The fee cap (\`maxFeePerGas\`${e ? ` = ${a(e)} gwei` : ""}) cannot be higher than the maximum allowed value (2^256-1).`, {
-      cause: r,
-      name: "FeeCapTooHighError"
-    });
-  }
-}
-Object.defineProperty(c, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /max fee per gas higher than 2\^256-1|fee cap higher than 2\^256-1/
-});
-class i extends t {
-  constructor({ cause: r, maxFeePerGas: e } = {}) {
-    super(`The fee cap (\`maxFeePerGas\`${e ? ` = ${a(e)}` : ""} gwei) cannot be lower than the block base fee.`, {
-      cause: r,
-      name: "FeeCapTooLowError"
-    });
-  }
-}
-Object.defineProperty(i, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /max fee per gas less than block base fee|fee cap less than block base fee|transaction is outdated/
-});
-class u extends t {
-  constructor({ cause: r, nonce: e } = {}) {
-    super(`Nonce provided for the transaction ${e ? `(${e}) ` : ""}is higher than the next one expected.`, { cause: r, name: "NonceTooHighError" });
-  }
-}
-Object.defineProperty(u, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /nonce too high/
-});
-class l extends t {
-  constructor({ cause: r, nonce: e } = {}) {
-    super([
-      `Nonce provided for the transaction ${e ? `(${e}) ` : ""}is lower than the current nonce of the account.`,
-      "Try increasing the nonce or find the latest nonce with `getTransactionCount`."
-    ].join(`
-`), { cause: r, name: "NonceTooLowError" });
-  }
-}
-Object.defineProperty(l, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /nonce too low|transaction already imported|already known/
-});
-class d extends t {
-  constructor({ cause: r, nonce: e } = {}) {
-    super(`Nonce provided for the transaction ${e ? `(${e}) ` : ""}exceeds the maximum allowed nonce.`, { cause: r, name: "NonceMaxValueError" });
-  }
-}
-Object.defineProperty(d, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /nonce has max value/
-});
-class h extends t {
-  constructor({ cause: r } = {}) {
-    super([
-      "The total cost (gas * gas fee + value) of executing this transaction exceeds the balance of the account."
-    ].join(`
-`), {
-      cause: r,
+import { formatEther as E } from "./index91.js";
+import { formatGwei as t } from "./index92.js";
+import { BaseError as y } from "./index83.js";
+import { prettyPrint as l } from "./index94.js";
+class x extends y {
+  constructor(e, { account: a, docsPath: n, chain: m, data: f, gas: u, gasPrice: r, maxFeePerGas: o, maxPriorityFeePerGas: s, nonce: d, to: p, value: i }) {
+    const g = l({
+      from: a?.address,
+      to: p,
+      value: typeof i < "u" && `${E(i)} ${m?.nativeCurrency?.symbol || "ETH"}`,
+      data: f,
+      gas: u,
+      gasPrice: typeof r < "u" && `${t(r)} gwei`,
+      maxFeePerGas: typeof o < "u" && `${t(o)} gwei`,
+      maxPriorityFeePerGas: typeof s < "u" && `${t(s)} gwei`,
+      nonce: d
+    });
+    super(e.shortMessage, {
+      cause: e,
+      docsPath: n,
       metaMessages: [
-        "This error could arise when the account does not have enough funds to:",
-        " - pay for the total gas fee,",
-        " - pay for the value to send.",
-        " ",
-        "The cost of the transaction is calculated as `gas * gas fee + value`, where:",
-        " - `gas` is the amount of gas needed for transaction to execute,",
-        " - `gas fee` is the gas fee,",
-        " - `value` is the amount of ether to send to the recipient."
-      ],
-      name: "InsufficientFundsError"
-    });
-  }
-}
-Object.defineProperty(h, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /insufficient funds|exceeds transaction sender account balance/
-});
-class f extends t {
-  constructor({ cause: r, gas: e } = {}) {
-    super(`The amount of gas ${e ? `(${e}) ` : ""}provided for the transaction exceeds the limit allowed for the block.`, {
-      cause: r,
-      name: "IntrinsicGasTooHighError"
-    });
-  }
-}
-Object.defineProperty(f, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /intrinsic gas too high|gas limit reached/
-});
-class p extends t {
-  constructor({ cause: r, gas: e } = {}) {
-    super(`The amount of gas ${e ? `(${e}) ` : ""}provided for the transaction is too low.`, {
-      cause: r,
-      name: "IntrinsicGasTooLowError"
-    });
-  }
-}
-Object.defineProperty(p, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /intrinsic gas too low/
-});
-class g extends t {
-  constructor({ cause: r }) {
-    super("The transaction type is not supported for this chain.", {
-      cause: r,
-      name: "TransactionTypeNotSupportedError"
-    });
-  }
-}
-Object.defineProperty(g, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /transaction type not valid/
-});
-class b extends t {
-  constructor({ cause: r, maxPriorityFeePerGas: e, maxFeePerGas: n } = {}) {
-    super([
-      `The provided tip (\`maxPriorityFeePerGas\`${e ? ` = ${a(e)} gwei` : ""}) cannot be higher than the fee cap (\`maxFeePerGas\`${n ? ` = ${a(n)} gwei` : ""}).`
-    ].join(`
-`), {
-      cause: r,
-      name: "TipAboveFeeCapError"
-    });
-  }
-}
-Object.defineProperty(b, "nodeMessage", {
-  enumerable: !0,
-  configurable: !0,
-  writable: !0,
-  value: /max priority fee per gas higher than max fee per gas|tip higher than fee cap/
-});
-class x extends t {
-  constructor({ cause: r }) {
-    super(`An error occurred while executing: ${r?.shortMessage}`, {
-      cause: r,
-      name: "UnknownNodeError"
-    });
+        ...e.metaMessages ? [...e.metaMessages, " "] : [],
+        "Estimate Gas Arguments:",
+        g
+      ].filter(Boolean),
+      name: "EstimateGasExecutionError"
+    }), Object.defineProperty(this, "cause", {
+      enumerable: !0,
+      configurable: !0,
+      writable: !0,
+      value: void 0
+    }), this.cause = e;
   }
 }
 export {
-  s as ExecutionRevertedError,
-  c as FeeCapTooHighError,
-  i as FeeCapTooLowError,
-  h as InsufficientFundsError,
-  f as IntrinsicGasTooHighError,
-  p as IntrinsicGasTooLowError,
-  d as NonceMaxValueError,
-  u as NonceTooHighError,
-  l as NonceTooLowError,
-  b as TipAboveFeeCapError,
-  g as TransactionTypeNotSupportedError,
-  x as UnknownNodeError
+  x as EstimateGasExecutionError
 };