@coinbase/cdp-core 0.0.0 → 0.0.5

package/dist/esm/index5.js

@@ -0,0 +1,194 @@
+import { logOutEndUser as c, refreshAccessToken as o, registerTemporaryWalletSecret as u } from "@coinbase/cdp-api-client";
+import { SignJWT as S } from "./index18.js";
+import { toAuthState as w } from "./index6.js";
+import { createKeyPair as f } from "./index19.js";
+import { generateRandomId as n } from "./index20.js";
+import { hash as d } from "./index21.js";
+import { sortKeys as y } from "./index12.js";
+const h = 60 * 1e3;
+class E {
+  projectId;
+  authState = null;
+  walletSecret = null;
+  authStateChangeCallbacks = [];
+  initPromise = null;
+  /**
+   * Initializes the token manager.
+   *
+   * @param projectId - The project ID.
+   */
+  constructor(t) {
+    this.projectId = t, this.initPromise = this._doInitialize();
+  }
+  /**
+   * Gets the current user, or null if there is no user signed in.
+   *
+   * @returns The current user.
+   */
+  async getUser() {
+    return this.authState?.user ?? null;
+  }
+  /**
+   * Returns whether the user is signed in - i.e., whether there is an unexpired
+   * access token and user.
+   *
+   * @returns True if the user is signed in, false otherwise.
+   */
+  async isSignedIn() {
+    return this.authState ? Promise.resolve(this.authState.expiresAt > Date.now()) : Promise.resolve(!1);
+  }
+  /**
+   * Signs out the user, clearing all authentication state.
+   */
+  async signOut() {
+    try {
+      await c(this.projectId);
+    } catch {
+    } finally {
+      await this.clearAuthState();
+    }
+  }
+  /**
+   * Adds a callback to be called when the auth state changes.
+   *
+   * @param callback - The function to call when the auth state changes.
+   */
+  addAuthStateChangeCallback(t) {
+    this.authStateChangeCallbacks.push(t), t(this.authState?.user ?? null);
+  }
+  /**
+   * Gets the access token, refreshing it if it is expired. Returns null if the user is not
+   * signed in.
+   *
+   * @returns The access token.
+   */
+  async getToken() {
+    return this.shouldRefreshToken() && await this.refreshAccessToken(), this.authState?.accessToken ?? null;
+  }
+  /**
+   * Gets the currently registered wallet secret ID. Rejects if the user is not signed in.
+   *
+   * @param authState - The auth state to use. If not provided, the current auth state will be used.
+   *
+   * @returns The wallet secret ID.
+   */
+  async getWalletSecretId(t) {
+    return this.shouldRefreshWalletSecret() && await this.refreshWalletSecret(t), this.walletSecret.walletSecretId;
+  }
+  /**
+   * Gets the X-Wallet-Auth header. Rejects if the user is not signed in.
+   *
+   * @param options - The options for the request.
+   * @param options.requestMethod - The HTTP method of the request.
+   * @param options.requestHost - The host of the request.
+   * @param options.requestPath - The path of the request.
+   * @param options.requestData - The data of the request.
+   * @returns The X-Wallet-Auth header.
+   */
+  async getXWalletAuth(t) {
+    this.shouldRefreshWalletSecret() && await this.refreshWalletSecret();
+    const e = `${t.requestMethod} ${t.requestHost}${t.requestPath}`, a = Math.floor(Date.now() / 1e3), r = {
+      uris: [e]
+    };
+    if (t.requestData && Object.keys(t.requestData).length > 0) {
+      const s = y(t.requestData);
+      r.reqHash = await d(new TextEncoder().encode(JSON.stringify(s)));
+    }
+    return await new S(r).setProtectedHeader({ alg: "ES256", typ: "JWT" }).setIssuedAt(a).setNotBefore(a).setJti(await n()).sign(this.walletSecret.keyPair.privateKey);
+  }
+  /**
+   * Sets the authentication state.
+   *
+   * @param authState - The authentication state.
+   */
+  async setAuthState(t) {
+    this.authState = t, this.authStateChangeCallbacks.forEach((e) => e(this.authState?.user ?? null));
+  }
+  /**
+   * Clears the authentication state.
+   */
+  async clearAuthState() {
+    this.authState = null, this.walletSecret = null, this.authStateChangeCallbacks.forEach((t) => t(null));
+  }
+  /**
+   * Ensures the AuthManager is initialized before proceeding.
+   * If initialization is already in progress, waits for it to complete.
+   */
+  async ensureInitialized() {
+    if (this.initPromise) {
+      await this.initPromise;
+      return;
+    }
+    throw new Error("AuthManager not initialized");
+  }
+  /**
+   * Internal async initialization logic.
+   */
+  async _doInitialize() {
+    try {
+      await this.refreshAccessToken();
+    } catch (t) {
+      console.warn("Failed to refresh access token during initialization:", t);
+    }
+  }
+  /**
+   * Returns whether the token should be refreshed.
+   *
+   * @returns True if the token should be refreshed, false otherwise.
+   */
+  shouldRefreshToken() {
+    return !(this.authState && this.authState.expiresAt > Date.now() + h);
+  }
+  /**
+   * Refreshes the access token and transitions the auth state accordingly.
+   * If a refresh is already in progress, it will wait for that refresh to complete.
+   *
+   * @returns The new access token.
+   */
+  async refreshAccessToken() {
+    try {
+      const t = await o(this.projectId, {
+        grantType: "refresh_token"
+      }), e = w(
+        t.accessToken,
+        t.validUntil,
+        t.endUser
+      );
+      await this.setAuthState(e);
+    } catch {
+      await this.clearAuthState();
+    }
+  }
+  /**
+   * Returns whether the wallet secret should be refreshed.
+   *
+   * @returns True if the wallet secret should be refreshed, false otherwise.
+   */
+  shouldRefreshWalletSecret() {
+    return !(this.walletSecret && this.walletSecret.expiresAt > Date.now() + h);
+  }
+  /**
+   * Refreshes the wallet secret.
+   *
+   * @param authState - The auth state to use. If not provided, the current auth state will be used.
+   * @returns The wallet secret.
+   */
+  async refreshWalletSecret(t) {
+    if (!t && !await this.isSignedIn())
+      throw new Error("Cannot refresh wallet secret if the auth state is not present or expired");
+    const e = t ?? this.authState, a = this.walletSecret?.walletSecretId ?? await n(), r = this.walletSecret?.keyPair ?? await f(), s = e.expiresAt, l = new Date(s).toISOString();
+    this.walletSecret = { walletSecretId: a, keyPair: r, expiresAt: s };
+    try {
+      await u(this.projectId, e.user.userId, {
+        walletSecretId: a,
+        publicKey: r.publicKeyBase64,
+        validUntil: l
+      });
+    } catch (i) {
+      throw this.walletSecret = null, i;
+    }
+  }
+}
+export {
+  E as AuthManager
+};

package/dist/esm/index50.js

@@ -0,0 +1,17 @@
+import { InvalidSerializableTransactionError as f } from "./index51.js";
+function d(e) {
+  if (e.type)
+    return e.type;
+  if (typeof e.authorizationList < "u")
+    return "eip7702";
+  if (typeof e.blobs < "u" || typeof e.blobVersionedHashes < "u" || typeof e.maxFeePerBlobGas < "u" || typeof e.sidecars < "u")
+    return "eip4844";
+  if (typeof e.maxFeePerGas < "u" || typeof e.maxPriorityFeePerGas < "u")
+    return "eip1559";
+  if (typeof e.gasPrice < "u")
+    return typeof e.accessList < "u" ? "eip2930" : "legacy";
+  throw new f({ transaction: e });
+}
+export {
+  d as getTransactionType
+};

package/dist/esm/index51.js

@@ -0,0 +1,45 @@
+import { BaseError as t } from "./index44.js";
+function i(n) {
+  const r = Object.entries(n).map(([a, e]) => e === void 0 || e === !1 ? null : [a, e]).filter(Boolean), o = r.reduce((a, [e]) => Math.max(a, e.length), 0);
+  return r.map(([a, e]) => `  ${`${a}:`.padEnd(o + 1)}  ${e}`).join(`
+`);
+}
+class c extends t {
+  constructor({ v: r }) {
+    super(`Invalid \`v\` value "${r}". Expected 27 or 28.`, {
+      name: "InvalidLegacyVError"
+    });
+  }
+}
+class d extends t {
+  constructor({ transaction: r }) {
+    super("Cannot infer a transaction type from provided transaction.", {
+      metaMessages: [
+        "Provided Transaction:",
+        "{",
+        i(r),
+        "}",
+        "",
+        "To infer the type, either provide:",
+        "- a `type` to the Transaction, or",
+        "- an EIP-1559 Transaction with `maxFeePerGas`, or",
+        "- an EIP-2930 Transaction with `gasPrice` & `accessList`, or",
+        "- an EIP-4844 Transaction with `blobs`, `blobVersionedHashes`, `sidecars`, or",
+        "- an EIP-7702 Transaction with `authorizationList`, or",
+        "- a Legacy Transaction with `gasPrice`"
+      ],
+      name: "InvalidSerializableTransactionError"
+    });
+  }
+}
+class l extends t {
+  constructor({ storageKey: r }) {
+    super(`Size for storage key "${r}" is invalid. Expected 32 bytes. Got ${Math.floor((r.length - 2) / 2)} bytes.`, { name: "InvalidStorageKeySizeError" });
+  }
+}
+export {
+  c as InvalidLegacyVError,
+  d as InvalidSerializableTransactionError,
+  l as InvalidStorageKeySizeError,
+  i as prettyPrint
+};

package/dist/esm/index52.js

@@ -0,0 +1,81 @@
+import { versionedHashVersionKzg as c } from "./index53.js";
+import { maxUint256 as m } from "./index54.js";
+import { InvalidAddressError as s } from "./index55.js";
+import { BaseError as h } from "./index44.js";
+import { EmptyBlobError as P, InvalidVersionedHashSizeError as p, InvalidVersionedHashVersionError as x } from "./index56.js";
+import { InvalidChainIdError as n } from "./index57.js";
+import { FeeCapTooHighError as w, TipAboveFeeCapError as E } from "./index58.js";
+import { isAddress as f } from "./index29.js";
+import { size as F } from "./index34.js";
+import { slice as I } from "./index35.js";
+import { hexToNumber as G } from "./index40.js";
+function C(t) {
+  const { authorizationList: e } = t;
+  if (e)
+    for (const o of e) {
+      const { chainId: r } = o, i = o.address;
+      if (!f(i))
+        throw new s({ address: i });
+      if (r < 0)
+        throw new n({ chainId: r });
+    }
+  d(t);
+}
+function L(t) {
+  const { blobVersionedHashes: e } = t;
+  if (e) {
+    if (e.length === 0)
+      throw new P();
+    for (const o of e) {
+      const r = F(o), i = G(I(o, 0, 1));
+      if (r !== 32)
+        throw new p({ hash: o, size: r });
+      if (i !== c)
+        throw new x({
+          hash: o,
+          version: i
+        });
+    }
+  }
+  d(t);
+}
+function d(t) {
+  const { chainId: e, maxPriorityFeePerGas: o, maxFeePerGas: r, to: i } = t;
+  if (e <= 0)
+    throw new n({ chainId: e });
+  if (i && !f(i))
+    throw new s({ address: i });
+  if (r && r > m)
+    throw new w({ maxFeePerGas: r });
+  if (o && r && o > r)
+    throw new E({ maxFeePerGas: r, maxPriorityFeePerGas: o });
+}
+function B(t) {
+  const { chainId: e, maxPriorityFeePerGas: o, gasPrice: r, maxFeePerGas: i, to: a } = t;
+  if (e <= 0)
+    throw new n({ chainId: e });
+  if (a && !f(a))
+    throw new s({ address: a });
+  if (o || i)
+    throw new h("`maxFeePerGas`/`maxPriorityFeePerGas` is not a valid EIP-2930 Transaction attribute.");
+  if (r && r > m)
+    throw new w({ maxFeePerGas: r });
+}
+function K(t) {
+  const { chainId: e, maxPriorityFeePerGas: o, gasPrice: r, maxFeePerGas: i, to: a } = t;
+  if (a && !f(a))
+    throw new s({ address: a });
+  if (typeof e < "u" && e <= 0)
+    throw new n({ chainId: e });
+  if (o || i)
+    throw new h("`maxFeePerGas`/`maxPriorityFeePerGas` is not a valid Legacy Transaction attribute.");
+  if (r && r > m)
+    throw new w({ maxFeePerGas: r });
+}
+export {
+  d as assertTransactionEIP1559,
+  B as assertTransactionEIP2930,
+  L as assertTransactionEIP4844,
+  C as assertTransactionEIP7702,
+  K as assertTransactionLegacy
+};

package/dist/esm/index53.js

@@ -0,0 +1,4 @@
+const e = 1;
+export {
+  e as versionedHashVersionKzg
+};

package/dist/esm/index54.js

@@ -0,0 +1,4 @@
+const n = 2n ** 256n - 1n;
+export {
+  n as maxUint256
+};

package/dist/esm/index55.js

@@ -0,0 +1,15 @@
+import { BaseError as r } from "./index44.js";
+class d extends r {
+  constructor({ address: s }) {
+    super(`Address "${s}" is invalid.`, {
+      metaMessages: [
+        "- Address must be a hex value of 20 bytes (40 hex characters).",
+        "- Address must match its checksum counterpart."
+      ],
+      name: "InvalidAddressError"
+    });
+  }
+}
+export {
+  d as InvalidAddressError
+};

package/dist/esm/index56.js

@@ -0,0 +1,40 @@
+import { versionedHashVersionKzg as a } from "./index53.js";
+import { BaseError as s } from "./index44.js";
+class t extends s {
+  constructor({ maxSize: e, size: r }) {
+    super("Blob size is too large.", {
+      metaMessages: [`Max: ${e} bytes`, `Given: ${r} bytes`],
+      name: "BlobSizeTooLargeError"
+    });
+  }
+}
+class d extends s {
+  constructor() {
+    super("Blob data must not be empty.", { name: "EmptyBlobError" });
+  }
+}
+class l extends s {
+  constructor({ hash: e, size: r }) {
+    super(`Versioned hash "${e}" size is invalid.`, {
+      metaMessages: ["Expected: 32", `Received: ${r}`],
+      name: "InvalidVersionedHashSizeError"
+    });
+  }
+}
+class c extends s {
+  constructor({ hash: e, version: r }) {
+    super(`Versioned hash "${e}" version is invalid.`, {
+      metaMessages: [
+        `Expected: ${a}`,
+        `Received: ${r}`
+      ],
+      name: "InvalidVersionedHashVersionError"
+    });
+  }
+}
+export {
+  t as BlobSizeTooLargeError,
+  d as EmptyBlobError,
+  l as InvalidVersionedHashSizeError,
+  c as InvalidVersionedHashVersionError
+};

package/dist/esm/index57.js

@@ -0,0 +1,9 @@
+import { BaseError as i } from "./index44.js";
+class o extends i {
+  constructor({ chainId: r }) {
+    super(typeof r == "number" ? `Chain ID "${r}" is invalid.` : "Chain ID is invalid.", { name: "InvalidChainIdError" });
+  }
+}
+export {
+  o as InvalidChainIdError
+};

package/dist/esm/index58.js

@@ -0,0 +1,37 @@
+import { formatGwei as a } from "./index64.js";
+import { BaseError as o } from "./index44.js";
+class n extends o {
+  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(n, "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 h extends o {
+  constructor({ cause: r, maxPriorityFeePerGas: e, maxFeePerGas: t } = {}) {
+    super([
+      `The provided tip (\`maxPriorityFeePerGas\`${e ? ` = ${a(e)} gwei` : ""}) cannot be higher than the fee cap (\`maxFeePerGas\`${t ? ` = ${a(t)} gwei` : ""}).`
+    ].join(`
+`), {
+      cause: r,
+      name: "TipAboveFeeCapError"
+    });
+  }
+}
+Object.defineProperty(h, "nodeMessage", {
+  enumerable: !0,
+  configurable: !0,
+  writable: !0,
+  value: /max priority fee per gas higher than max fee per gas|tip higher than fee cap/
+});
+export {
+  n as FeeCapTooHighError,
+  h as TipAboveFeeCapError
+};

package/dist/esm/index59.js

@@ -0,0 +1,11 @@
+import { hexToBytes as i } from "./index26.js";
+import { bytesToHex as f } from "./index24.js";
+function y(o) {
+  const { kzg: s } = o, n = o.to ?? (typeof o.blobs[0] == "string" ? "hex" : "bytes"), m = typeof o.blobs[0] == "string" ? o.blobs.map((t) => i(t)) : o.blobs, b = [];
+  for (const t of m)
+    b.push(Uint8Array.from(s.blobToKzgCommitment(t)));
+  return n === "bytes" ? b : b.map((t) => f(t));
+}
+export {
+  y as blobsToCommitments
+};

package/dist/esm/index6.js

@@ -0,0 +1,14 @@
+const u = (e, s, t) => {
+  const c = new Date(s).getTime(), o = {
+    userId: t.userId,
+    evmAccounts: t.evmAccounts?.map((r) => r) ?? []
+  };
+  return {
+    accessToken: e,
+    expiresAt: c,
+    user: o
+  };
+};
+export {
+  u as toAuthState
+};

package/dist/esm/index60.js

@@ -0,0 +1,13 @@
+import { hexToBytes as b } from "./index26.js";
+import { bytesToHex as y } from "./index24.js";
+function h(t) {
+  const { kzg: m } = t, c = t.to ?? (typeof t.blobs[0] == "string" ? "hex" : "bytes"), s = typeof t.blobs[0] == "string" ? t.blobs.map((o) => b(o)) : t.blobs, i = typeof t.commitments[0] == "string" ? t.commitments.map((o) => b(o)) : t.commitments, n = [];
+  for (let o = 0; o < s.length; o++) {
+    const f = s[o], l = i[o];
+    n.push(Uint8Array.from(m.computeBlobKzgProof(f, l)));
+  }
+  return c === "bytes" ? n : n.map((o) => y(o));
+}
+export {
+  h as blobsToProofs
+};

package/dist/esm/index61.js

@@ -0,0 +1,14 @@
+import { commitmentToVersionedHash as i } from "./index76.js";
+function r(o) {
+  const { commitments: t, version: n } = o, e = o.to ?? (typeof t[0] == "string" ? "hex" : "bytes"), s = [];
+  for (const m of t)
+    s.push(i({
+      commitment: m,
+      to: e,
+      version: n
+    }));
+  return s;
+}
+export {
+  r as commitmentsToVersionedHashes
+};

package/dist/esm/index62.js

@@ -0,0 +1,16 @@
+import { blobsToCommitments as f } from "./index59.js";
+import { blobsToProofs as l } from "./index60.js";
+import { toBlobs as p } from "./index75.js";
+function k(t) {
+  const { data: i, kzg: n, to: m } = t, s = t.blobs ?? p({ data: i, to: m }), b = t.commitments ?? f({ blobs: s, kzg: n, to: m }), r = t.proofs ?? l({ blobs: s, commitments: b, kzg: n, to: m }), c = [];
+  for (let o = 0; o < s.length; o++)
+    c.push({
+      blob: s[o],
+      commitment: b[o],
+      proof: r[o]
+    });
+  return c;
+}
+export {
+  k as toBlobSidecars
+};

package/dist/esm/index63.js

@@ -0,0 +1,21 @@
+import { InvalidAddressError as s } from "./index55.js";
+import { InvalidStorageKeySizeError as l } from "./index51.js";
+import { isAddress as f } from "./index29.js";
+function a(r) {
+  if (!r || r.length === 0)
+    return [];
+  const n = [];
+  for (let o = 0; o < r.length; o++) {
+    const { address: i, storageKeys: e } = r[o];
+    for (let t = 0; t < e.length; t++)
+      if (e[t].length - 2 !== 64)
+        throw new l({ storageKey: e[t] });
+    if (!f(i, { strict: !1 }))
+      throw new s({ address: i });
+    n.push([i, e]);
+  }
+  return n;
+}
+export {
+  a as serializeAccessList
+};

package/dist/esm/index64.js

@@ -0,0 +1,8 @@
+import { gweiUnits as i } from "./index65.js";
+import { formatUnits as o } from "./index66.js";
+function f(r, t = "wei") {
+  return o(r, i[t]);
+}
+export {
+  f as formatGwei
+};

package/dist/esm/index65.js

@@ -0,0 +1,7 @@
+const e = {
+  ether: -9,
+  wei: 9
+};
+export {
+  e as gweiUnits
+};

package/dist/esm/index66.js

@@ -0,0 +1,13 @@
+function a(r, n) {
+  let t = r.toString();
+  const i = t.startsWith("-");
+  i && (t = t.slice(1)), t = t.padStart(n, "0");
+  let [l, e] = [
+    t.slice(0, t.length - n),
+    t.slice(t.length - n)
+  ];
+  return e = e.replace(/(0+)$/, ""), `${i ? "-" : ""}${l || "0"}${e ? `.${e}` : ""}`;
+}
+export {
+  a as formatUnits
+};

package/dist/esm/index67.js

@@ -0,0 +1,19 @@
+import { FlattenedSign as n } from "./index78.js";
+class o {
+  #e;
+  constructor(e) {
+    this.#e = new n(e);
+  }
+  setProtectedHeader(e) {
+    return this.#e.setProtectedHeader(e), this;
+  }
+  async sign(e, r) {
+    const t = await this.#e.sign(e, r);
+    if (t.payload === void 0)
+      throw new TypeError("use the flattened module for creating JWS with b64: false");
+    return `${t.protected}.${t.payload}.${t.signature}`;
+  }
+}
+export {
+  o as CompactSign
+};

package/dist/esm/index68.js

@@ -0,0 +1,25 @@
+class c extends Error {
+  static code = "ERR_JOSE_GENERIC";
+  code = "ERR_JOSE_GENERIC";
+  constructor(s, e) {
+    super(s, e), this.name = this.constructor.name, Error.captureStackTrace?.(this, this.constructor);
+  }
+}
+class E extends c {
+  static code = "ERR_JOSE_NOT_SUPPORTED";
+  code = "ERR_JOSE_NOT_SUPPORTED";
+}
+class o extends c {
+  static code = "ERR_JWS_INVALID";
+  code = "ERR_JWS_INVALID";
+}
+class r extends c {
+  static code = "ERR_JWT_INVALID";
+  code = "ERR_JWT_INVALID";
+}
+export {
+  c as JOSEError,
+  E as JOSENotSupported,
+  o as JWSInvalid,
+  r as JWTInvalid
+};