@opensea/wallet-adapters 0.2.1 → 0.3.1

package/dist/index.js

@@ -51,6 +51,14 @@ var BankrAdapter = class _BankrAdapter {
     this.cachedAddress = evmWallet.address;
     return evmWallet.address;
   }
+  async getWalletInfo() {
+    const address = await this.getAddress();
+    return {
+      provider: "bankr",
+      address,
+      scopeIntrospectable: false
+    };
+  }
   async sendTransaction(tx) {
     this.onRequest?.("sendTransaction", tx);
     const startTime = Date.now();
@@ -413,6 +421,15 @@ var FireblocksAdapter = class _FireblocksAdapter {
     this.cachedAddress = data[0].address;
     return data[0].address;
   }
+  async getWalletInfo() {
+    const address = await this.getAddress();
+    return {
+      provider: "fireblocks",
+      address,
+      vaultId: this.config.vaultId,
+      roleIntrospectable: false
+    };
+  }
   async sendTransaction(tx) {
     this.onRequest?.("sendTransaction", tx);
     const startTime = Date.now();
@@ -703,6 +720,38 @@ var TurnkeyAdapter = class _TurnkeyAdapter {
   async getAddress() {
     return this.config.walletAddress;
   }
+  async getWalletInfo() {
+    const whoamiResponse = await this.signedRequest("/public/v1/query/whoami", {
+      organizationId: this.config.organizationId
+    });
+    if (!whoamiResponse.ok) {
+      const body = await whoamiResponse.text();
+      throw new Error(
+        `Turnkey getWalletInfo whoami failed (${whoamiResponse.status}): ${body}`
+      );
+    }
+    const whoami = await whoamiResponse.json();
+    const orgResponse = await this.signedRequest(
+      "/public/v1/query/get_organization",
+      { organizationId: this.config.organizationId }
+    );
+    if (!orgResponse.ok) {
+      const body = await orgResponse.text();
+      throw new Error(
+        `Turnkey getWalletInfo get_organization failed (${orgResponse.status}): ${body}`
+      );
+    }
+    const orgData = await orgResponse.json();
+    const rootUserIds = orgData.organizationData?.rootQuorum?.userIds ?? [];
+    return {
+      provider: "turnkey",
+      address: this.config.walletAddress,
+      organizationId: whoami.organizationId,
+      userId: whoami.userId,
+      username: whoami.username ?? "",
+      isRootUser: rootUserIds.includes(whoami.userId)
+    };
+  }
   async sendTransaction(tx) {
     this.onRequest?.("sendTransaction", tx);
     const startTime = Date.now();
@@ -1072,9 +1121,6 @@ var PrivateKeyAdapter = class _PrivateKeyAdapter {
     if (!privateKey) {
       throw new Error("PRIVATE_KEY environment variable is required");
     }
-    if (!rpcUrl) {
-      throw new Error("RPC_URL environment variable is required");
-    }
     const clean = privateKey.startsWith("0x") ? privateKey.slice(2) : privateKey;
     if (!/^[0-9a-fA-F]{64}$/.test(clean)) {
       throw new Error(
@@ -1102,7 +1148,12 @@ var PrivateKeyAdapter = class _PrivateKeyAdapter {
     this.onRequest?.("sendTransaction", tx);
     const startTime = Date.now();
     const from = await this.getAddress();
-    const { rpcUrl } = this.config;
+    const rpcUrl = this.config.rpcUrl;
+    if (!rpcUrl) {
+      throw new Error(
+        "RPC_URL is required for sending transactions. Set the RPC_URL environment variable or pass --rpc-url."
+      );
+    }
     let nonce;
     let gasLimit;
     let maxFeePerGas;
@@ -1290,6 +1341,7 @@ function encodeEcdsaSignature(r, s, v) {
 
 // src/adapters/privy.ts
 var PRIVY_API_BASE = "https://api.privy.io";
+var PRIVY_401_ECHO_HINT = ` (hint: if you're verifying credentials via curl, use 'printf %s "$PRIVY_APP_ID:$PRIVY_APP_SECRET" | base64' \u2014 'echo' adds a trailing newline that breaks basic auth)`;
 var PrivyAdapter = class _PrivyAdapter {
   name = "privy";
   capabilities = {
@@ -1322,13 +1374,14 @@ var PrivyAdapter = class _PrivyAdapter {
       appId,
       appSecret,
       walletId,
-      baseUrl: process.env.PRIVY_API_BASE_URL
+      baseUrl: process.env.PRIVY_API_BASE_URL,
+      authSigningKey: process.env.PRIVY_AUTH_SIGNING_KEY
     });
   }
   get baseUrl() {
     return this.config.baseUrl ?? PRIVY_API_BASE;
   }
-  get authHeaders() {
+  get basicAuthHeaders() {
     const credentials = Buffer.from(
       `${this.config.appId}:${this.config.appSecret}`
     ).toString("base64");
@@ -1338,46 +1391,105 @@ var PrivyAdapter = class _PrivyAdapter {
       "Content-Type": "application/json"
     };
   }
+  /**
+   * Build headers for a POST /rpc call, including the authorization
+   * signature when `authSigningKey` is configured. Lazy-imports
+   * `@privy-io/node` so users who don't enable auth-key signing don't
+   * need the optional peer dependency installed.
+   */
+  async rpcHeaders(body, rpcUrl) {
+    const headers = { ...this.basicAuthHeaders };
+    if (!this.config.authSigningKey) return headers;
+    let generateAuthorizationSignature;
+    try {
+      ;
+      ({ generateAuthorizationSignature } = await import("@privy-io/node"));
+    } catch (cause) {
+      throw new Error(
+        "PRIVY_AUTH_SIGNING_KEY is set but @privy-io/node is not installed. Install it with `pnpm add @privy-io/node` (or your package manager equivalent).",
+        { cause }
+      );
+    }
+    const signature = generateAuthorizationSignature({
+      authorizationPrivateKey: this.config.authSigningKey,
+      input: {
+        version: 1,
+        method: "POST",
+        url: rpcUrl,
+        body,
+        headers: { "privy-app-id": this.config.appId }
+      }
+    });
+    headers["privy-authorization-signature"] = signature;
+    return headers;
+  }
   async getAddress() {
     if (this.cachedAddress) return this.cachedAddress;
     const response = await fetch(
       `${this.baseUrl}/v1/wallets/${this.config.walletId}`,
-      { headers: this.authHeaders }
+      { headers: this.basicAuthHeaders }
     );
     if (!response.ok) {
       const body = await response.text();
-      throw new Error(`Privy getAddress failed (${response.status}): ${body}`);
+      const hint = response.status === 401 && body.includes("Invalid app ID or app secret") ? PRIVY_401_ECHO_HINT : "";
+      throw new Error(
+        `Privy getAddress failed (${response.status}): ${body}${hint}`
+      );
     }
     const data = await response.json();
     this.cachedAddress = data.address;
     return data.address;
   }
+  async getWalletInfo() {
+    const response = await fetch(
+      `${this.baseUrl}/v1/wallets/${this.config.walletId}`,
+      { headers: this.basicAuthHeaders }
+    );
+    if (!response.ok) {
+      const body = await response.text();
+      const hint = response.status === 401 && body.includes("Invalid app ID or app secret") ? PRIVY_401_ECHO_HINT : "";
+      throw new Error(
+        `Privy getWalletInfo failed (${response.status}): ${body}${hint}`
+      );
+    }
+    const data = await response.json();
+    this.cachedAddress = data.address;
+    const ownerKeyId = data.owner_id ?? null;
+    return {
+      provider: "privy",
+      address: data.address,
+      chainType: data.chain_type,
+      policyIds: data.policy_ids ?? [],
+      ownerKeyId,
+      additionalSignerCount: data.additional_signers?.length ?? 0,
+      ownerEnforcesAuthKey: ownerKeyId !== null
+    };
+  }
   async sendTransaction(tx) {
     this.onRequest?.("sendTransaction", tx);
     const startTime = Date.now();
     const caip2 = `eip155:${tx.chainId}`;
-    const response = await fetch(
-      `${this.baseUrl}/v1/wallets/${this.config.walletId}/rpc`,
-      {
-        method: "POST",
-        headers: this.authHeaders,
-        body: JSON.stringify({
-          method: "eth_sendTransaction",
-          caip2,
-          params: {
-            transaction: {
-              to: tx.to,
-              data: tx.data,
-              value: tx.value
-            }
-          }
-        })
+    const rpcUrl = `${this.baseUrl}/v1/wallets/${this.config.walletId}/rpc`;
+    const body = {
+      method: "eth_sendTransaction",
+      caip2,
+      params: {
+        transaction: {
+          to: tx.to,
+          data: tx.data,
+          value: tx.value
+        }
       }
-    );
+    };
+    const response = await fetch(rpcUrl, {
+      method: "POST",
+      headers: await this.rpcHeaders(body, rpcUrl),
+      body: JSON.stringify(body)
+    });
     if (!response.ok) {
-      const body = await response.text();
+      const responseBody = await response.text();
       throw new Error(
-        `Privy sendTransaction failed (${response.status}): ${body}`
+        `Privy sendTransaction failed (${response.status}): ${responseBody}`
       );
     }
     const data = await response.json();
@@ -1388,21 +1500,23 @@ var PrivyAdapter = class _PrivyAdapter {
   async signMessage(request) {
     this.onRequest?.("signMessage", request);
     const startTime = Date.now();
-    const message = typeof request.message === "string" ? request.message : `0x${Buffer.from(request.message).toString("hex")}`;
-    const response = await fetch(
-      `${this.baseUrl}/v1/wallets/${this.config.walletId}/rpc`,
-      {
-        method: "POST",
-        headers: this.authHeaders,
-        body: JSON.stringify({
-          method: "personal_sign",
-          params: { message }
-        })
-      }
-    );
+    const isBytes = typeof request.message !== "string";
+    const message = isBytes ? `0x${Buffer.from(request.message).toString("hex")}` : request.message;
+    const rpcUrl = `${this.baseUrl}/v1/wallets/${this.config.walletId}/rpc`;
+    const body = {
+      method: "personal_sign",
+      params: { message, encoding: isBytes ? "hex" : "utf-8" }
+    };
+    const response = await fetch(rpcUrl, {
+      method: "POST",
+      headers: await this.rpcHeaders(body, rpcUrl),
+      body: JSON.stringify(body)
+    });
     if (!response.ok) {
-      const body = await response.text();
-      throw new Error(`Privy signMessage failed (${response.status}): ${body}`);
+      const responseBody = await response.text();
+      throw new Error(
+        `Privy signMessage failed (${response.status}): ${responseBody}`
+      );
     }
     const data = await response.json();
     this.onResponse?.(
@@ -1415,28 +1529,27 @@ var PrivyAdapter = class _PrivyAdapter {
   async signTypedData(request) {
     this.onRequest?.("signTypedData", request);
     const startTime = Date.now();
-    const response = await fetch(
-      `${this.baseUrl}/v1/wallets/${this.config.walletId}/rpc`,
-      {
-        method: "POST",
-        headers: this.authHeaders,
-        body: JSON.stringify({
-          method: "eth_signTypedData_v4",
-          params: {
-            typedData: JSON.stringify({
-              domain: request.domain,
-              types: request.types,
-              primaryType: request.primaryType,
-              message: request.message
-            })
-          }
+    const rpcUrl = `${this.baseUrl}/v1/wallets/${this.config.walletId}/rpc`;
+    const body = {
+      method: "eth_signTypedData_v4",
+      params: {
+        typedData: JSON.stringify({
+          domain: request.domain,
+          types: request.types,
+          primaryType: request.primaryType,
+          message: request.message
         })
       }
-    );
+    };
+    const response = await fetch(rpcUrl, {
+      method: "POST",
+      headers: await this.rpcHeaders(body, rpcUrl),
+      body: JSON.stringify(body)
+    });
     if (!response.ok) {
-      const body = await response.text();
+      const responseBody = await response.text();
       throw new Error(
-        `Privy signTypedData failed (${response.status}): ${body}`
+        `Privy signTypedData failed (${response.status}): ${responseBody}`
       );
     }
     const data = await response.json();
@@ -1467,7 +1580,7 @@ function createWalletFromEnv() {
     return PrivateKeyAdapter.fromEnv();
   }
   throw new Error(
-    "No wallet provider configured. Set environment variables for one of:\n  \u2022 Privy: PRIVY_APP_ID, PRIVY_APP_SECRET, PRIVY_WALLET_ID\n  \u2022 Fireblocks: FIREBLOCKS_API_KEY, FIREBLOCKS_API_SECRET, FIREBLOCKS_VAULT_ID\n  \u2022 Turnkey: TURNKEY_API_PUBLIC_KEY, TURNKEY_API_PRIVATE_KEY, TURNKEY_ORGANIZATION_ID, TURNKEY_WALLET_ADDRESS, TURNKEY_RPC_URL\n  \u2022 Bankr: BANKR_API_KEY\n  \u2022 PrivateKey: PRIVATE_KEY, RPC_URL"
+    "No wallet provider configured. Set environment variables for one of:\n  \u2022 Privy: PRIVY_APP_ID, PRIVY_APP_SECRET, PRIVY_WALLET_ID\n  \u2022 Fireblocks: FIREBLOCKS_API_KEY, FIREBLOCKS_API_SECRET, FIREBLOCKS_VAULT_ID\n  \u2022 Turnkey: TURNKEY_API_PUBLIC_KEY, TURNKEY_API_PRIVATE_KEY, TURNKEY_ORGANIZATION_ID, TURNKEY_WALLET_ADDRESS, TURNKEY_RPC_URL\n  \u2022 Bankr: BANKR_API_KEY\n  \u2022 PrivateKey: PRIVATE_KEY (optionally RPC_URL for sending transactions)"
   );
 }
 function createWalletForProvider(provider) {