@coinbase/cdp-hooks 0.0.21 → 0.0.23

package/README.md

@@ -359,13 +359,13 @@ Smart Accounts provide advanced account abstraction features with React hooks.
 
 #### Send User Operations
 
-Send user operations from Smart Accounts with support for multiple calls and paymaster sponsorship:
+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:
 
 ```tsx
 import { useSendUserOperation, useCurrentUser } from "@coinbase/cdp-hooks";
 
 function SendUserOperation() {
-  const { sendUserOperation, data } = useSendUserOperation();
+  const { sendUserOperation, status, data, error } = useSendUserOperation();
   const { currentUser } = useCurrentUser();
 
   const handleSendUserOperation = async () => {
@@ -392,36 +392,32 @@ function SendUserOperation() {
 
   return (
     <div>
-      {(() => {
-        switch (data.status) {
-          case "idle":
-            return <p>Ready to send user operation</p>;
-          case "pending":
-            return (
-              <div>
-                <p>User operation pending...</p>
-                <p>Hash: {data.hash}</p>
-              </div>
-            );
-          case "success":
-            return (
-              <div>
-                <p>User operation successful!</p>
-                <p>Transaction Hash: {data.result.transactionHash}</p>
-              </div>
-            );
-          case "error":
-            return (
-              <div>
-                <p>User operation failed</p>
-                <p>Error: {data.error.message}</p>
-              </div>
-            );
-        }
-      })()}
+      {status === "idle" && <p>Ready to send user operation</p>}
+      
+      {status === "pending" && (
+        <div>
+          <p>User operation pending...</p>
+          {data && <p>User Op Hash: {data.userOpHash}</p>}
+        </div>
+      )}
+      
+      {status === "success" && data && (
+        <div>
+          <p>User operation successful!</p>
+          <p>Transaction Hash: {data.transactionHash}</p>
+          <p>Status: {data.status}</p>
+        </div>
+      )}
+      
+      {status === "error" && (
+        <div>
+          <p>User operation failed</p>
+          <p>Error: {error?.message}</p>
+        </div>
+      )}
       
-      <button onClick={handleSendUserOperation}>
-        Send User Operation
+      <button onClick={handleSendUserOperation} disabled={status === "pending"}>
+        {status === "pending" ? "Sending..." : "Send User Operation"}
       </button>
     </div>
   );
@@ -430,57 +426,75 @@ function SendUserOperation() {
 
 #### Track User Operation Status
 
-Use the `useWaitForUserOperation` hook to poll for user operation status and provide real-time updates:
+Use the `useWaitForUserOperation` hook to poll for user operation status and provide real-time updates. This hook immediately fires off a query to get the result of the user operation:
 
 ```tsx
-import { useWaitForUserOperation, useCurrentUser } from "@coinbase/cdp-hooks";
+import { useWaitForUserOperation, useState } from "react";
 
 function WaitForUserOperation() {
-  const { waitForUserOperation, data } = useWaitForUserOperation();
-
-  const handleWaitForOperation = () => {
-    // Start waiting for a specific user operation
-    waitForUserOperation({
-      userOperationHash: "0x1234...",
-      evmSmartAccount: "0x1234567890123456789012345678901234567890",
-      network: "base-sepolia"
-    });
-  };
+  const { status, data, error } = useWaitForUserOperation({
+    userOperationHash: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    evmSmartAccount: "0x1234567890123456789012345678901234567890",
+    network: "base-sepolia"
+  });
+
+  return (
+    <div>
+      {status === "idle" && <p>No user operation being tracked</p>}
+      
+      {status === "pending" && (
+        <div>
+          <p>User operation pending...</p>
+          {data && <p>User Op Hash: {data.userOpHash}</p>}
+        </div>
+      )}
+      
+      {status === "success" && data && (
+        <div>
+          <p>User operation successful!</p>
+          <p>Transaction Hash: {data.transactionHash}</p>
+          <p>Status: {data.status}</p>
+        </div>
+      )}
+      
+      {status === "error" && (
+        <div>
+          <p>User operation failed</p>
+          <p>Error: {error?.message}</p>
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+#### Conditional Polling
+
+You can control when the `useWaitForUserOperation` hook should start polling using the `enabled` parameter:
+
+```tsx
+function ConditionalWaitForUserOperation() {
+  const [shouldPoll, setShouldPoll] = useState(false);
+  
+  const { status, data, error } = useWaitForUserOperation({
+    userOperationHash: "0x1234...",
+    evmSmartAccount: "0x5678...", 
+    network: "base-sepolia",
+    enabled: shouldPoll // Only poll when this is true
+  });
 
   return (
     <div>
-      <button onClick={handleWaitForOperation}>
-        Wait for User Operation
+      <button onClick={() => setShouldPoll(true)}>
+        Start Polling
+      </button>
+      <button onClick={() => setShouldPoll(false)}>
+        Stop Polling  
       </button>
       
-      {(() => {
-        switch (data.status) {
-          case "idle":
-            return <p>No user operation being tracked</p>;
-          case "pending":
-            return (
-              <div>
-                <p>User operation pending...</p>
-                <p>Hash: {data.hash}</p>
-              </div>
-            );
-          case "success":
-            return (
-              <div>
-                <p>User operation successful!</p>
-                <p>Transaction Hash: {data.result.transactionHash}</p>
-                <p>Status: {data.result.status}</p>
-              </div>
-            );
-          case "error":
-            return (
-              <div>
-                <p>User operation failed</p>
-                <p>Error: {data.error.message}</p>
-              </div>
-            );
-        }
-      })()}
+      <p>Status: {status}</p>
+      {data && <p>User Operation Status: {data.status}</p>}
+      {error && <p>Error: {error.message}</p>}
     </div>
   );
 }

package/dist/esm/index10.js

@@ -1,35 +1,12 @@
-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 { contracts as o } from "./index190.js";
+import { formatters as r } from "./index191.js";
+import { serializers as t } from "./index192.js";
+const e = {
+  blockTime: 2e3,
+  contracts: o,
+  formatters: r,
+  serializers: t
+};
 export {
-  O as createClient
+  e as chainConfig
 };

package/dist/esm/index100.js

@@ -1,37 +1,29 @@
-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
+import { BaseError as o } from "./index84.js";
+class i extends o {
+  constructor({ max: e, min: r, signed: s, size: a, value: t }) {
+    super(`Number "${t}" is not in safe ${a ? `${a * 8}-bit ${s ? "signed" : "unsigned"} ` : ""}integer range ${e ? `(${r} to ${e})` : `(above ${r})`}`, { name: "IntegerOutOfRangeError" });
+  }
+}
+class u extends o {
+  constructor(e) {
+    super(`Bytes value "${e}" is not a valid boolean. The bytes array must contain a single byte of either a 0 or 1 value.`, {
+      name: "InvalidBytesBooleanError"
     });
-    super(e.shortMessage, {
-      cause: e,
-      docsPath: n,
-      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;
+  }
+}
+class c extends o {
+  constructor(e) {
+    super(`Hex value "${e}" is not a valid boolean. The hex value must be "0x0" (false) or "0x1" (true).`, { name: "InvalidHexBooleanError" });
+  }
+}
+class v extends o {
+  constructor({ givenSize: e, maxSize: r }) {
+    super(`Size cannot exceed ${r} bytes. Given size: ${e} bytes.`, { name: "SizeOverflowError" });
   }
 }
 export {
-  x as EstimateGasExecutionError
+  i as IntegerOutOfRangeError,
+  u as InvalidBytesBooleanError,
+  c as InvalidHexBooleanError,
+  v as SizeOverflowError
 };

package/dist/esm/index101.js

@@ -1,196 +1,36 @@
-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 { BaseError as r } from "./index84.js";
+class s extends r {
+  constructor({ data: a }) {
+    super("Unable to extract image from metadata. The metadata may be malformed or invalid.", {
       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."
+        "- Metadata must be a JSON object with at least an `image`, `image_url` or `image_data` property.",
+        "",
+        `Provided data: ${JSON.stringify(a)}`
       ],
-      name: "InsufficientFundsError"
+      name: "EnsAvatarInvalidMetadataError"
     });
   }
 }
-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"
+class o extends r {
+  constructor({ reason: a }) {
+    super(`ENS NFT avatar URI is invalid. ${a}`, {
+      name: "EnsAvatarInvalidNftUriError"
     });
   }
 }
-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"
-    });
+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" });
   }
 }
-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"
-    });
+class i extends r {
+  constructor({ namespace: a }) {
+    super(`ENS NFT avatar namespace "${a}" is not supported. Must be "erc721" or "erc1155".`, { name: "EnsAvatarUnsupportedNamespaceError" });
   }
 }
 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
+  s as EnsAvatarInvalidMetadataError,
+  o as EnsAvatarInvalidNftUriError,
+  i as EnsAvatarUnsupportedNamespaceError,
+  n as EnsAvatarUriResolutionError
 };

package/dist/esm/index102.js

@@ -1,11 +1,37 @@
-import { BaseError as e } from "./index82.js";
-class p extends e {
-  constructor(r) {
-    super(`Filter type "${r}" is not supported.`, {
-      name: "FilterTypeNotSupportedError"
+import { formatEther as E } from "./index92.js";
+import { formatGwei as t } from "./index93.js";
+import { BaseError as y } from "./index84.js";
+import { prettyPrint as l } from "./index95.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: [
+        ...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 {
-  p as FilterTypeNotSupportedError
+  x as EstimateGasExecutionError
 };