@coinbase/cdp-hooks 0.0.66 → 0.0.68

package/README.md

@@ -195,6 +195,30 @@ function App() {
 
 * When `solana.createOnLogin` is set to `true`, new users will automatically get a Solana account instead of EVM accounts.
 
+#### Deferred Account Creation
+
+You can omit `createOnLogin` entirely to prevent automatic account creation and instead create accounts manually when needed:
+
+```tsx lines
+function App() {
+  return (
+    <CDPHooksProvider
+      config={{
+        projectId: "your-project-id",
+        // No ethereum or solana createOnLogin configuration
+      }}
+    >
+      <App />
+    </CDPHooksProvider>
+  );
+}
+```
+
+When `createOnLogin` is omitted, the SDK will:
+1. Not create any accounts automatically upon user login
+2. Require manual account creation using the account creation hooks (see below)
+3. Give you full control over when and what types of accounts to create
+
 ### Sign In a User
 
 End user authentication proceeds in two steps:
@@ -699,6 +723,133 @@ function UserInformation() {
 }
 ```
 
+### Create Accounts Manually
+
+If you configured your provider without `createOnLogin`, you can manually create accounts for authenticated users when needed using these hooks.
+
+#### Create an EOA Account
+
+Use the `useCreateEoaAccount` hook to create an EOA (Externally Owned Account) for the current user:
+
+```tsx lines
+import { useCreateEoaAccount, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function CreateEoaAccount() {
+  const { createEoaAccount } = useCreateEoaAccount();
+  const { currentUser } = useCurrentUser();
+
+  const handleCreateAccount = async () => {
+    try {
+      const evmAddress = await createEoaAccount();
+      console.log("Created EOA:", evmAddress);
+      // The user object is automatically updated
+    } catch (error) {
+      console.error("Failed to create EOA:", error);
+    }
+  };
+
+  return (
+    <button
+      onClick={handleCreateAccount}
+      disabled={!currentUser || currentUser.evmAccounts?.length > 0}
+    >
+      Create EOA Account
+    </button>
+  );
+}
+```
+
+**Note:** This will throw an error if the user already has an EOA account.
+
+#### Create a Smart Account
+
+Use the `useCreateSmartAccount` hook to create a Smart Account for the current user:
+
+```tsx lines
+import { useCreateSmartAccount, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function CreateSmartAccount() {
+  const { createSmartAccount } = useCreateSmartAccount();
+  const { currentUser } = useCurrentUser();
+
+  const handleCreateAccount = async () => {
+    try {
+      // Create Smart Account (will automatically create EOA first if needed)
+      const smartAccountAddress = await createSmartAccount();
+      console.log("Created Smart Account:", smartAccountAddress);
+      // The user object is automatically updated
+    } catch (error) {
+      console.error("Failed to create Smart Account:", error);
+    }
+  };
+
+  const handleCreateWithSpendPermissions = async () => {
+    try {
+      // Create Smart Account with spend permissions enabled
+      const smartAccountAddress = await createSmartAccount({
+        enableSpendPermissions: true
+      });
+      console.log("Created Smart Account with spend permissions:", smartAccountAddress);
+    } catch (error) {
+      console.error("Failed to create Smart Account:", error);
+    }
+  };
+
+  return (
+    <div>
+      <button
+        onClick={handleCreateAccount}
+        disabled={!currentUser || currentUser.evmSmartAccounts?.length > 0}
+      >
+        Create Smart Account
+      </button>
+      <button
+        onClick={handleCreateWithSpendPermissions}
+        disabled={!currentUser || currentUser.evmSmartAccounts?.length > 0}
+      >
+        Create Smart Account with Spend Permissions
+      </button>
+    </div>
+  );
+}
+```
+
+**Note:** This will throw an error if the user already has a Smart Account. If the user doesn't have an EOA, one will be automatically created first to serve as the Smart Account owner.
+
+#### Create a Solana Account
+
+Use the `useCreateSolanaAccount` hook to create a Solana account for the current user:
+
+```tsx lines
+import { useCreateSolanaAccount, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function CreateSolanaAccount() {
+  const { createSolanaAccount } = useCreateSolanaAccount();
+  const { currentUser } = useCurrentUser();
+
+  const handleCreateAccount = async () => {
+    try {
+      const solanaAddress = await createSolanaAccount();
+      console.log("Created Solana account:", solanaAddress);
+      // The user object is automatically updated
+    } catch (error) {
+      console.error("Failed to create Solana account:", error);
+    }
+  };
+
+  return (
+    <button
+      onClick={handleCreateAccount}
+      disabled={!currentUser || currentUser.solanaAccounts?.length > 0}
+    >
+      Create Solana Account
+    </button>
+  );
+}
+```
+
+**Note:** This will throw an error if the user already has a Solana account.
+
 ### Working with Solana
 
 When your application is configured with `solana: { createOnLogin: true }`, you can use Solana-specific hooks to interact with Solana accounts.

package/dist/esm/index.js

@@ -1,9 +1,9 @@
-import { APIError as u, OAuth2ProviderType as a } from "@coinbase/cdp-core";
+import { APIError as i, OAuth2ProviderType as a } from "@coinbase/cdp-core";
 import { Analytics as e } from "./index2.js";
 import "react";
 import { VERSION as s } from "./index3.js";
-import { CDPContext as S, CDPHooksProvider as p } from "./index4.js";
-import { useAuthenticateWithJWT as c, useConfig as d, useCurrentUser as g, useEnforceAuthenticated as E, useEnforceUnauthenticated as x, useEvmAddress as A, useExportEvmAccount as h, useExportSolanaAccount as l, useGetAccessToken as P, useIsInitialized as k, useIsSignedIn as v, useOAuthState as O, useSendEvmTransaction as T, useSendSolanaTransaction as I, useSendUserOperation as C, useSignEvmHash as L, useSignEvmMessage as W, useSignEvmTransaction as y, useSignEvmTypedData as U, useSignInWithEmail as V, useSignInWithOAuth as D, useSignInWithSms as G, useSignOut as H, useSignSolanaMessage as M, useSignSolanaTransaction as R, useSolanaAddress as z, useVerifyEmailOTP as F, useVerifySmsOTP as J, useWaitForUserOperation as N } from "./index5.js";
+import { CDPContext as p, CDPHooksProvider as S } from "./index4.js";
+import { useAuthenticateWithJWT as f, useConfig as E, useCurrentUser as x, useEnforceAuthenticated as d, useEnforceUnauthenticated as g, useEvmAddress as A, useExportEvmAccount as h, useExportSolanaAccount as l, useGetAccessToken as v, useIsInitialized as P, useIsSignedIn as k, useOAuthState as O, useSendEvmTransaction as T, useSendSolanaTransaction as C, useSendUserOperation as I, useSignEvmHash as L, useSignEvmMessage as W, useSignEvmTransaction as y, useSignEvmTypedData as U, useSignInWithEmail as V, useSignInWithOAuth as D, useSignInWithSms as G, useSignOut as H, useSignSolanaMessage as M, useSignSolanaTransaction as R, useSolanaAddress as z, useVerifyEmailOTP as F, useVerifySmsOTP as J, useWaitForUserOperation as N } from "./index5.js";
 import { useCreateSpendPermission as b } from "./index6.js";
 import { useListSpendPermissions as q } from "./index7.js";
 import { useRevokeSpendPermission as B } from "./index8.js";
@@ -12,25 +12,31 @@ import { useLinkApple as Z } from "./index10.js";
 import { useLinkSms as $ } from "./index11.js";
 import { useLinkEmail as se } from "./index12.js";
 import { useLinkOAuth as re } from "./index13.js";
-import { useX402 as te } from "./index14.js";
+import { useCreateEvmEoaAccount as ne } from "./index14.js";
+import { useCreateEvmSmartAccount as ie } from "./index15.js";
+import { useCreateSolanaAccount as me } from "./index16.js";
+import { useX402 as Se } from "./index17.js";
 e.registerPackageVersion("hooks", s);
 export {
-  u as APIError,
-  S as CDPContext,
-  p as CDPHooksProvider,
+  i as APIError,
+  p as CDPContext,
+  S as CDPHooksProvider,
   a as OAuth2ProviderType,
-  c as useAuthenticateWithJWT,
-  d as useConfig,
+  f as useAuthenticateWithJWT,
+  E as useConfig,
+  ne as useCreateEvmEoaAccount,
+  ie as useCreateEvmSmartAccount,
+  me as useCreateSolanaAccount,
   b as useCreateSpendPermission,
-  g as useCurrentUser,
-  E as useEnforceAuthenticated,
-  x as useEnforceUnauthenticated,
+  x as useCurrentUser,
+  d as useEnforceAuthenticated,
+  g as useEnforceUnauthenticated,
   A as useEvmAddress,
   h as useExportEvmAccount,
   l as useExportSolanaAccount,
-  P as useGetAccessToken,
-  k as useIsInitialized,
-  v as useIsSignedIn,
+  v as useGetAccessToken,
+  P as useIsInitialized,
+  k as useIsSignedIn,
   Z as useLinkApple,
   se as useLinkEmail,
   Q as useLinkGoogle,
@@ -40,8 +46,8 @@ export {
   O as useOAuthState,
   B as useRevokeSpendPermission,
   T as useSendEvmTransaction,
-  I as useSendSolanaTransaction,
-  C as useSendUserOperation,
+  C as useSendSolanaTransaction,
+  I as useSendUserOperation,
   L as useSignEvmHash,
   W as useSignEvmMessage,
   y as useSignEvmTransaction,
@@ -56,5 +62,5 @@ export {
   F as useVerifyEmailOTP,
   J as useVerifySmsOTP,
   N as useWaitForUserOperation,
-  te as useX402
+  Se as useX402
 };

package/dist/esm/index10.js

@@ -1,5 +1,5 @@
 import "./index2.js";
-import { useSendHookCallOnce as t } from "./index15.js";
+import { useSendHookCallOnce as t } from "./index18.js";
 import "react";
 import { useLinkOAuth as o } from "./index13.js";
 function u() {

package/dist/esm/index100.js

@@ -1,217 +1,58 @@
-import { parseAccount as E } from "./index26.js";
-import { panicReasons as $ } from "./index101.js";
-import { decodeErrorResult as A } from "./index102.js";
-import { formatAbiItem as y } from "./index95.js";
-import { formatAbiItemWithArgs as v } from "./index103.js";
-import { getAbiItem as C } from "./index104.js";
-import { formatEther as P } from "./index105.js";
-import { formatGwei as p } from "./index106.js";
-import { AbiErrorSignatureNotFoundError as j } from "./index94.js";
-import { BaseError as m } from "./index97.js";
-import { prettyStateOverride as x } from "./index107.js";
-import { prettyPrint as w } from "./index108.js";
-import { getContractAddress as O } from "./index109.js";
-class z extends m {
-  constructor(e, { account: o, docsPath: u, chain: s, data: c, gas: a, gasPrice: i, maxFeePerGas: r, maxPriorityFeePerGas: t, nonce: n, to: l, value: d, stateOverride: f }) {
-    const h = o ? E(o) : void 0;
-    let g = w({
-      from: h?.address,
-      to: l,
-      value: typeof d < "u" && `${P(d)} ${s?.nativeCurrency?.symbol || "ETH"}`,
-      data: c,
-      gas: a,
-      gasPrice: typeof i < "u" && `${p(i)} gwei`,
-      maxFeePerGas: typeof r < "u" && `${p(r)} gwei`,
-      maxPriorityFeePerGas: typeof t < "u" && `${p(t)} gwei`,
-      nonce: n
-    });
-    f && (g += `
-${x(f)}`), super(e.shortMessage, {
-      cause: e,
-      docsPath: u,
-      metaMessages: [
-        ...e.metaMessages ? [...e.metaMessages, " "] : [],
-        "Raw Call Arguments:",
-        g
-      ].filter(Boolean),
-      name: "CallExecutionError"
-    }), Object.defineProperty(this, "cause", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), this.cause = e;
-  }
-}
-class G extends m {
-  constructor(e, { abi: o, args: u, contractAddress: s, docsPath: c, functionName: a, sender: i }) {
-    const r = C({ abi: o, args: u, name: a }), t = r ? v({
-      abiItem: r,
-      args: u,
-      includeFunctionName: !1,
-      includeName: !1
-    }) : void 0, n = r ? y(r, { includeName: !0 }) : void 0, l = w({
-      address: s && O(s),
-      function: n,
-      args: t && t !== "()" && `${[...Array(a?.length ?? 0).keys()].map(() => " ").join("")}${t}`,
-      sender: i
-    });
-    super(e.shortMessage || `An unknown error occurred while executing the contract function "${a}".`, {
-      cause: e,
-      docsPath: c,
-      metaMessages: [
-        ...e.metaMessages ? [...e.metaMessages, " "] : [],
-        l && "Contract Call:",
-        l
-      ].filter(Boolean),
-      name: "ContractFunctionExecutionError"
-    }), Object.defineProperty(this, "abi", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), Object.defineProperty(this, "args", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), Object.defineProperty(this, "cause", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), Object.defineProperty(this, "contractAddress", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), Object.defineProperty(this, "formattedArgs", {
+import { version as o } from "./index101.js";
+let r = {
+  getDocsUrl: ({ docsBaseUrl: s, docsPath: t = "", docsSlug: e }) => t ? `${s ?? "https://viem.sh"}${t}${e ? `#${e}` : ""}` : void 0,
+  version: `viem@${o}`
+};
+class u extends Error {
+  constructor(t, e = {}) {
+    const i = e.cause instanceof u ? e.cause.details : e.cause?.message ? e.cause.message : e.details, n = e.cause instanceof u && e.cause.docsPath || e.docsPath, a = r.getDocsUrl?.({ ...e, docsPath: n }), l = [
+      t || "An error occurred.",
+      "",
+      ...e.metaMessages ? [...e.metaMessages, ""] : [],
+      ...a ? [`Docs: ${a}`] : [],
+      ...i ? [`Details: ${i}`] : [],
+      ...r.version ? [`Version: ${r.version}`] : []
+    ].join(`
+`);
+    super(l, e.cause ? { cause: e.cause } : void 0), Object.defineProperty(this, "details", {
       enumerable: !0,
       configurable: !0,
       writable: !0,
       value: void 0
-    }), Object.defineProperty(this, "functionName", {
+    }), Object.defineProperty(this, "docsPath", {
       enumerable: !0,
       configurable: !0,
       writable: !0,
       value: void 0
-    }), Object.defineProperty(this, "sender", {
+    }), Object.defineProperty(this, "metaMessages", {
       enumerable: !0,
       configurable: !0,
       writable: !0,
       value: void 0
-    }), this.abi = o, this.args = u, this.cause = e, this.contractAddress = s, this.functionName = a, this.sender = i;
-  }
-}
-class H extends m {
-  constructor({ abi: e, data: o, functionName: u, message: s }) {
-    let c, a, i, r;
-    if (o && o !== "0x")
-      try {
-        a = A({ abi: e, data: o });
-        const { abiItem: n, errorName: l, args: d } = a;
-        if (l === "Error")
-          r = d[0];
-        else if (l === "Panic") {
-          const [f] = d;
-          r = $[f];
-        } else {
-          const f = n ? y(n, { includeName: !0 }) : void 0, h = n && d ? v({
-            abiItem: n,
-            args: d,
-            includeFunctionName: !1,
-            includeName: !1
-          }) : void 0;
-          i = [
-            f ? `Error: ${f}` : "",
-            h && h !== "()" ? `       ${[...Array(l?.length ?? 0).keys()].map(() => " ").join("")}${h}` : ""
-          ];
-        }
-      } catch (n) {
-        c = n;
-      }
-    else s && (r = s);
-    let t;
-    c instanceof j && (t = c.signature, i = [
-      `Unable to decode signature "${t}" as it was not found on the provided ABI.`,
-      "Make sure you are using the correct ABI and that the error exists on it.",
-      `You can look up the decoded signature here: https://openchain.xyz/signatures?query=${t}.`
-    ]), super(r && r !== "execution reverted" || t ? [
-      `The contract function "${u}" reverted with the following ${t ? "signature" : "reason"}:`,
-      r || t
-    ].join(`
-`) : `The contract function "${u}" reverted.`, {
-      cause: c,
-      metaMessages: i,
-      name: "ContractFunctionRevertedError"
-    }), Object.defineProperty(this, "data", {
+    }), Object.defineProperty(this, "shortMessage", {
       enumerable: !0,
       configurable: !0,
       writable: !0,
       value: void 0
-    }), Object.defineProperty(this, "raw", {
+    }), Object.defineProperty(this, "version", {
       enumerable: !0,
       configurable: !0,
       writable: !0,
       value: void 0
-    }), Object.defineProperty(this, "reason", {
+    }), Object.defineProperty(this, "name", {
       enumerable: !0,
       configurable: !0,
       writable: !0,
-      value: void 0
-    }), Object.defineProperty(this, "signature", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), this.data = a, this.raw = o, this.reason = r, this.signature = t;
+      value: "BaseError"
+    }), this.details = i, this.docsPath = n, this.metaMessages = e.metaMessages, this.name = e.name ?? this.name, this.shortMessage = t, this.version = o;
   }
-}
-class U extends m {
-  constructor({ functionName: e }) {
-    super(`The contract function "${e}" returned no data ("0x").`, {
-      metaMessages: [
-        "This could be due to any of the following:",
-        `  - The contract does not have the function "${e}",`,
-        "  - The parameters passed to the contract function may be invalid, or",
-        "  - The address is not a contract."
-      ],
-      name: "ContractFunctionZeroDataError"
-    });
+  walk(t) {
+    return c(this, t);
   }
 }
-class Y extends m {
-  constructor({ factory: e }) {
-    super(`Deployment for counterfactual contract call failed${e ? ` for factory "${e}".` : ""}`, {
-      metaMessages: [
-        "Please ensure:",
-        "- The `factory` is a valid contract deployment factory (ie. Create2 Factory, ERC-4337 Factory, etc).",
-        "- The `factoryData` is a valid encoded function call for contract deployment function on the factory."
-      ],
-      name: "CounterfactualDeploymentFailedError"
-    });
-  }
-}
-class J extends m {
-  constructor({ data: e, message: o }) {
-    super(o || "", { name: "RawContractError" }), Object.defineProperty(this, "code", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: 3
-    }), Object.defineProperty(this, "data", {
-      enumerable: !0,
-      configurable: !0,
-      writable: !0,
-      value: void 0
-    }), this.data = e;
-  }
+function c(s, t) {
+  return t?.(s) ? s : s && typeof s == "object" && "cause" in s && s.cause !== void 0 ? c(s.cause, t) : t ? null : s;
 }
 export {
-  z as CallExecutionError,
-  G as ContractFunctionExecutionError,
-  H as ContractFunctionRevertedError,
-  U as ContractFunctionZeroDataError,
-  Y as CounterfactualDeploymentFailedError,
-  J as RawContractError
+  u as BaseError
 };

package/dist/esm/index101.js

@@ -1,34 +1,4 @@
-const e = {
-  1: "An `assert` condition failed.",
-  17: "Arithmetic operation resulted in underflow or overflow.",
-  18: "Division or modulo by zero (e.g. `5 / 0` or `23 % 0`).",
-  33: "Attempted to convert to an invalid type.",
-  34: "Attempted to access a storage byte array that is incorrectly encoded.",
-  49: "Performed `.pop()` on an empty array",
-  50: "Array index is out of bounds.",
-  65: "Allocated too much memory or created an array which is too large.",
-  81: "Attempted to call a zero-initialized variable of internal function type."
-}, o = {
-  inputs: [
-    {
-      name: "message",
-      type: "string"
-    }
-  ],
-  name: "Error",
-  type: "error"
-}, t = {
-  inputs: [
-    {
-      name: "reason",
-      type: "uint256"
-    }
-  ],
-  name: "Panic",
-  type: "error"
-};
+const o = "2.33.0";
 export {
-  e as panicReasons,
-  o as solidityError,
-  t as solidityPanic
+  o as version
 };

package/dist/esm/index102.js

@@ -1,24 +1,10 @@
-import { solidityError as m, solidityPanic as s } from "./index101.js";
-import { AbiDecodingZeroDataError as c, AbiErrorSignatureNotFoundError as d } from "./index94.js";
-import { slice as e } from "./index136.js";
-import { toFunctionSelector as u } from "./index140.js";
-import { decodeAbiParameters as f } from "./index133.js";
-import { formatAbiItem as p } from "./index95.js";
-function y(n) {
-  const { abi: a, data: t } = n, o = e(t, 0, 4);
-  if (o === "0x")
-    throw new c();
-  const r = [...a || [], m, s].find((i) => i.type === "error" && o === u(p(i)));
-  if (!r)
-    throw new d(o, {
-      docsPath: "/docs/contract/decodeErrorResult"
-    });
-  return {
-    abiItem: r,
-    args: "inputs" in r && r.inputs && r.inputs.length > 0 ? f(r.inputs, e(t, 4)) : void 0,
-    errorName: r.name
-  };
+import { BaseError as e } from "./index100.js";
+class d extends e {
+  constructor({ blockHash: r, blockNumber: t }) {
+    let o = "Block";
+    r && (o = `Block at hash "${r}"`), t && (o = `Block at number "${t}"`), super(`${o} could not be found.`, { name: "BlockNotFoundError" });
+  }
 }
 export {
-  y as decodeErrorResult
+  d as BlockNotFoundError
 };