@opensea/wallet-adapters 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,3 +1,145 @@
+// src/adapters/bankr.ts
+var BANKR_API_BASE = "https://api.bankr.bot";
+var BankrAdapter = class _BankrAdapter {
+  name = "bankr";
+  capabilities = {
+    signMessage: true,
+    signTypedData: true,
+    managedGas: true,
+    managedNonce: true
+  };
+  onRequest;
+  onResponse;
+  config;
+  cachedAddress;
+  constructor(config) {
+    this.config = config;
+  }
+  static fromEnv() {
+    const apiKey = process.env.BANKR_API_KEY;
+    if (!apiKey) {
+      throw new Error("BANKR_API_KEY environment variable is required");
+    }
+    return new _BankrAdapter({
+      apiKey,
+      baseUrl: process.env.BANKR_API_BASE_URL
+    });
+  }
+  get baseUrl() {
+    return this.config.baseUrl ?? BANKR_API_BASE;
+  }
+  get authHeaders() {
+    return {
+      "X-API-Key": this.config.apiKey,
+      "Content-Type": "application/json"
+    };
+  }
+  async getAddress() {
+    if (this.cachedAddress) return this.cachedAddress;
+    const response = await fetch(`${this.baseUrl}/wallet/me`, {
+      headers: this.authHeaders
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`Bankr getAddress failed (${response.status}): ${body}`);
+    }
+    const data = await response.json();
+    const evmWallet = data.wallets.find((w) => w.chain === "evm");
+    if (!evmWallet) {
+      throw new Error("Bankr wallet has no EVM address");
+    }
+    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();
+    const transaction = {
+      to: tx.to,
+      data: tx.data,
+      value: tx.value,
+      chainId: tx.chainId
+    };
+    if (tx.gas) transaction.gas = tx.gas;
+    if (tx.nonce !== void 0) transaction.nonce = tx.nonce;
+    if (tx.maxFeePerGas) transaction.maxFeePerGas = tx.maxFeePerGas;
+    if (tx.maxPriorityFeePerGas)
+      transaction.maxPriorityFeePerGas = tx.maxPriorityFeePerGas;
+    const response = await fetch(`${this.baseUrl}/wallet/submit`, {
+      method: "POST",
+      headers: this.authHeaders,
+      body: JSON.stringify({
+        transaction,
+        waitForConfirmation: true
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(
+        `Bankr sendTransaction failed (${response.status}): ${body}`
+      );
+    }
+    const data = await response.json();
+    const result = { hash: data.transactionHash };
+    this.onResponse?.("sendTransaction", result, Date.now() - startTime);
+    return result;
+  }
+  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}/wallet/sign`, {
+      method: "POST",
+      headers: this.authHeaders,
+      body: JSON.stringify({
+        signatureType: "personal_sign",
+        message
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`Bankr signMessage failed (${response.status}): ${body}`);
+    }
+    const data = await response.json();
+    this.onResponse?.("signMessage", data.signature, Date.now() - startTime);
+    return data.signature;
+  }
+  async signTypedData(request) {
+    this.onRequest?.("signTypedData", request);
+    const startTime = Date.now();
+    const response = await fetch(`${this.baseUrl}/wallet/sign`, {
+      method: "POST",
+      headers: this.authHeaders,
+      body: JSON.stringify({
+        signatureType: "eth_signTypedData_v4",
+        typedData: {
+          domain: request.domain,
+          types: request.types,
+          primaryType: request.primaryType,
+          message: request.message
+        }
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(
+        `Bankr signTypedData failed (${response.status}): ${body}`
+      );
+    }
+    const data = await response.json();
+    this.onResponse?.("signTypedData", data.signature, Date.now() - startTime);
+    return data.signature;
+  }
+};
+
 // src/util/eip712.ts
 import { keccak_256 } from "@noble/hashes/sha3.js";
 function hashTypedData(domain, primaryType, message, types) {
@@ -143,7 +285,7 @@ function hexToBytes(hex) {
   return bytes;
 }
 
-// src/adapters/fireblocks.ts
+// src/adapters/fireblocks.generated.ts
 var CHAIN_TO_FIREBLOCKS_ASSET = {
   1: "ETH",
   10: "ETH-OPT",
@@ -161,6 +303,8 @@ var CHAIN_TO_FIREBLOCKS_ASSET = {
   81457: "BLAST_ETH",
   7777777: "ZORA_ETH"
 };
+
+// src/adapters/fireblocks.ts
 var FIREBLOCKS_API_BASE = "https://api.fireblocks.io";
 var FireblocksAdapter = class _FireblocksAdapter {
   name = "fireblocks";
@@ -277,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();
@@ -567,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();
@@ -1154,6 +1339,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 = {
@@ -1186,13 +1372,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");
@@ -1202,46 +1389,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();
@@ -1252,21 +1498,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?.(
@@ -1279,28 +1527,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();
@@ -1324,15 +1571,20 @@ function createWalletFromEnv() {
   if (process.env.TURNKEY_API_PUBLIC_KEY && process.env.TURNKEY_WALLET_ADDRESS) {
     return TurnkeyAdapter.fromEnv();
   }
+  if (process.env.BANKR_API_KEY) {
+    return BankrAdapter.fromEnv();
+  }
   if (process.env.PRIVATE_KEY) {
     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 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, RPC_URL"
   );
 }
 function createWalletForProvider(provider) {
   switch (provider) {
+    case "bankr":
+      return BankrAdapter.fromEnv();
     case "privy":
       return PrivyAdapter.fromEnv();
     case "fireblocks":
@@ -1351,6 +1603,7 @@ function detectProvider() {
     return "fireblocks";
   if (process.env.TURNKEY_API_PUBLIC_KEY && process.env.TURNKEY_WALLET_ADDRESS)
     return "turnkey";
+  if (process.env.BANKR_API_KEY) return "bankr";
   if (process.env.PRIVATE_KEY) return "private-key";
   return null;
 }
@@ -1360,9 +1613,11 @@ var WALLET_PROVIDERS = [
   "privy",
   "turnkey",
   "fireblocks",
+  "bankr",
   "private-key"
 ];
 export {
+  BankrAdapter,
   CHAIN_TO_FIREBLOCKS_ASSET,
   FireblocksAdapter,
   PrivateKeyAdapter,