@coinbase/cdp-hooks 0.0.36 → 0.0.37

package/README.md

@@ -451,6 +451,49 @@ function SolanaTransactionSigner() {
 }
 ```
 
+#### Sign a Solana Message
+
+Use the `useSignSolanaMessage` hook to sign arbitrary messages with Solana accounts:
+
+```tsx lines
+import { useSignSolanaMessage, useSolanaAddress } from "@coinbase/cdp-hooks";
+
+function SolanaMessageSigner() {
+  const { signSolanaMessage } = useSignSolanaMessage();
+  const { solanaAddress } = useSolanaAddress();
+
+  const handleSignMessage = async () => {
+    if (!solanaAddress) return;
+
+    try {
+      const message = Buffer.from("Hello, Solana!", "utf8").toString("base64");
+      const result = await signSolanaMessage({
+        solanaAccount: solanaAddress,
+        message // Base64 encoded message to sign
+      });
+
+      console.log("Message Signature:", result.signature);
+      // The signature can be used for authentication or verification purposes
+    } catch (error) {
+      console.error("Failed to sign message:", error);
+    }
+  };
+
+  if (!solanaAddress) {
+    return <div>Please connect your Solana wallet first</div>;
+  }
+
+  return (
+    <div>
+      <h3>Sign Solana Message</h3>
+      <button onClick={handleSignMessage}>
+        Sign Message
+      </button>
+    </div>
+  );
+}
+```
+
 #### Send a Solana Transaction
 
 Use the `useSendSolanaTransaction` hook to sign and send Solana transactions in a single action. This is supported on:
@@ -667,14 +710,16 @@ function SignData() {
 }
 ```
 
-### Export Private Key
+### Export Private Keys
+
+End users can export their private keys from their embedded wallet, allowing them to import them into compatible wallets of their choice.
 
-End users can export their private keys from their embedded wallet, allowing them to import it into an EVM-compatible wallet of their choice.
+#### Export EVM Private Key
 
 ```tsx lines
 import { useExportEvmAccount, useEvmAddress } from "@coinbase/cdp-hooks";
 
-function ExportKey() {
+function ExportEvmKey() {
   const { exportEvmAccount: exportAccount } = useExportEvmAccount();
   const { evmAddress } = useEvmAddress();
 
@@ -686,14 +731,48 @@ function ExportKey() {
         evmAccount: evmAddress
       });
 
-      console.log("Private Key:", privateKey);
+      console.log("EVM Private Key:", privateKey);
+      // Warning: Handle private keys with extreme care!
+    } catch (error) {
+      console.error("Export failed:", error);
+    }
+  };
+
+  return <button onClick={handleExport}>Export EVM Private Key</button>;
+}
+```
+
+#### Export Solana Private Key
+
+When your application is configured with `solana: { createOnLogin: true }`, you can export Solana private keys:
+
+```tsx lines
+import { useExportSolanaAccount, useSolanaAddress } from "@coinbase/cdp-hooks";
+
+function ExportSolanaKey() {
+  const { exportSolanaAccount: exportAccount } = useExportSolanaAccount();
+  const { solanaAddress } = useSolanaAddress();
+
+  const handleExport = async () => {
+    if (!solanaAddress) return;
+
+    try {
+      const { privateKey } = await exportAccount({
+        solanaAccount: solanaAddress
+      });
+
+      console.log("Solana Private Key:", privateKey);
       // Warning: Handle private keys with extreme care!
     } catch (error) {
       console.error("Export failed:", error);
     }
   };
 
-  return <button onClick={handleExport}>Export Private Key</button>;
+  if (!solanaAddress) {
+    return <div>Please connect your Solana wallet first</div>;
+  }
+
+  return <button onClick={handleExport}>Export Solana Private Key</button>;
 }
 ```
 

package/dist/esm/index.js

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

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
 };