@buildersgarden/siwa 0.0.15 → 0.0.16

package/dist/signer/bankr.d.ts

@@ -0,0 +1,51 @@
+/**
+ * bankr.ts
+ *
+ * Bankr wallet signer implementation.
+ *
+ * Uses the Bankr Agent API (https://api.bankr.bot) for signing operations.
+ * Wallet address is fetched via GET /agent/me, messages are signed via POST /agent/sign.
+ */
+import type { Signer } from "./types.js";
+/**
+ * Configuration for the Bankr SIWA signer.
+ */
+export interface BankrSiwaSignerConfig {
+    /** Bankr API key (or BANKR_API_KEY env var) */
+    apiKey?: string;
+    /** Bankr API base URL (defaults to https://api.bankr.bot) */
+    baseUrl?: string;
+}
+/**
+ * Creates a SIWA Signer that wraps the Bankr Agent API.
+ *
+ * This signer implements the core Signer interface for SIWA message signing.
+ * It supports both standard message signing (EIP-191) and raw hex signing
+ * for ERC-8128 HTTP message signatures.
+ *
+ * The wallet address is fetched from the Bankr API on creation.
+ *
+ * @param config - Bankr API configuration
+ * @returns A Promise that resolves to a Signer compatible with SIWA's signSIWAMessage function
+ *
+ * @example
+ * ```typescript
+ * import { signSIWAMessage } from '@buildersgarden/siwa';
+ * import { createBankrSiwaSigner } from '@buildersgarden/siwa/signer';
+ *
+ * const signer = await createBankrSiwaSigner({
+ *   apiKey: process.env.BANKR_API_KEY!,
+ * });
+ *
+ * const { message, signature, address } = await signSIWAMessage({
+ *   domain: 'example.com',
+ *   uri: 'https://example.com/login',
+ *   agentId: 123,
+ *   agentRegistry: 'eip155:84532:0x...',
+ *   chainId: 84532,
+ *   nonce: generateNonce(),
+ *   issuedAt: new Date().toISOString(),
+ * }, signer);
+ * ```
+ */
+export declare function createBankrSiwaSigner(config?: BankrSiwaSignerConfig): Promise<Signer>;

package/dist/signer/bankr.js

@@ -0,0 +1,123 @@
+/**
+ * bankr.ts
+ *
+ * Bankr wallet signer implementation.
+ *
+ * Uses the Bankr Agent API (https://api.bankr.bot) for signing operations.
+ * Wallet address is fetched via GET /agent/me, messages are signed via POST /agent/sign.
+ */
+function resolveConfig(config) {
+    const apiKey = config.apiKey ?? process.env.BANKR_API_KEY;
+    if (!apiKey) {
+        throw new Error("Bankr API key is required. Provide apiKey in config or set BANKR_API_KEY env var.");
+    }
+    return {
+        apiKey,
+        baseUrl: config.baseUrl ?? "https://api.bankr.bot",
+    };
+}
+/**
+ * Fetches the EVM wallet address from the Bankr API.
+ */
+async function fetchWalletAddress(config) {
+    const response = await fetch(`${config.baseUrl}/agent/me`, {
+        headers: {
+            "X-API-Key": config.apiKey,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Bankr API /agent/me failed: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    const evmWallet = data.wallets?.find((w) => w.chain === "evm");
+    if (!evmWallet?.address) {
+        throw new Error("No EVM wallet found in Bankr account");
+    }
+    return evmWallet.address;
+}
+/**
+ * Signs a message using the Bankr Agent API.
+ */
+async function bankrSign(config, signatureType, payload) {
+    const response = await fetch(`${config.baseUrl}/agent/sign`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": config.apiKey,
+        },
+        body: JSON.stringify({ signatureType, ...payload }),
+    });
+    if (!response.ok) {
+        throw new Error(`Bankr sign failed: ${response.status} ${response.statusText}`);
+    }
+    const result = await response.json();
+    if (!result.success || !result.signature) {
+        throw new Error(`Bankr sign failed: ${result.error ?? "no signature returned"}`);
+    }
+    return {
+        signature: result.signature,
+        signer: result.signer,
+    };
+}
+/**
+ * Creates a SIWA Signer that wraps the Bankr Agent API.
+ *
+ * This signer implements the core Signer interface for SIWA message signing.
+ * It supports both standard message signing (EIP-191) and raw hex signing
+ * for ERC-8128 HTTP message signatures.
+ *
+ * The wallet address is fetched from the Bankr API on creation.
+ *
+ * @param config - Bankr API configuration
+ * @returns A Promise that resolves to a Signer compatible with SIWA's signSIWAMessage function
+ *
+ * @example
+ * ```typescript
+ * import { signSIWAMessage } from '@buildersgarden/siwa';
+ * import { createBankrSiwaSigner } from '@buildersgarden/siwa/signer';
+ *
+ * const signer = await createBankrSiwaSigner({
+ *   apiKey: process.env.BANKR_API_KEY!,
+ * });
+ *
+ * const { message, signature, address } = await signSIWAMessage({
+ *   domain: 'example.com',
+ *   uri: 'https://example.com/login',
+ *   agentId: 123,
+ *   agentRegistry: 'eip155:84532:0x...',
+ *   chainId: 84532,
+ *   nonce: generateNonce(),
+ *   issuedAt: new Date().toISOString(),
+ * }, signer);
+ * ```
+ */
+export async function createBankrSiwaSigner(config = {}) {
+    const resolved = resolveConfig(config);
+    const walletAddress = await fetchWalletAddress(resolved);
+    return {
+        /**
+         * Returns the wallet address.
+         */
+        async getAddress() {
+            return walletAddress;
+        },
+        /**
+         * Signs a message using EIP-191 personal_sign.
+         * Used for standard SIWA message signing.
+         */
+        async signMessage(message) {
+            const result = await bankrSign(resolved, "personal_sign", { message });
+            return result.signature;
+        },
+        /**
+         * Signs raw hex bytes.
+         * Used by ERC-8128 for HTTP message signatures.
+         */
+        async signRawMessage(rawHex) {
+            const result = await bankrSign(resolved, "personal_sign", {
+                message: rawHex,
+            });
+            return result.signature;
+        },
+    };
+}

package/dist/signer/index.d.ts

@@ -13,6 +13,7 @@
  *   - createCircleSiwaSigner(config)           — Circle developer-controlled wallet
  *   - createCircleSiwaSignerFromClient(config) — Circle with existing client
  *   - createPrivySiwaSigner(config)            — Privy server wallet
+ *   - createBankrSiwaSigner(config)            — Bankr Agent API wallet
  *
  * Usage:
  *   import { signSIWAMessage, createLocalAccountSigner } from '@buildersgarden/siwa';
@@ -28,3 +29,4 @@ export { createLocalAccountSigner } from './local-account.js';
 export { createWalletClientSigner } from './wallet-client.js';
 export { createCircleSiwaSigner, createCircleSiwaSignerFromClient, type CircleSiwaSignerConfig, type CircleSiwaSignerClientConfig, } from './circle.js';
 export { createPrivySiwaSigner, type PrivySiwaSignerConfig, } from './privy.js';
+export { createBankrSiwaSigner, type BankrSiwaSignerConfig, } from './bankr.js';

package/dist/signer/index.js

@@ -13,6 +13,7 @@
  *   - createCircleSiwaSigner(config)           — Circle developer-controlled wallet
  *   - createCircleSiwaSignerFromClient(config) — Circle with existing client
  *   - createPrivySiwaSigner(config)            — Privy server wallet
+ *   - createBankrSiwaSigner(config)            — Bankr Agent API wallet
  *
  * Usage:
  *   import { signSIWAMessage, createLocalAccountSigner } from '@buildersgarden/siwa';
@@ -28,3 +29,4 @@ export { createLocalAccountSigner } from './local-account.js';
 export { createWalletClientSigner } from './wallet-client.js';
 export { createCircleSiwaSigner, createCircleSiwaSignerFromClient, } from './circle.js';
 export { createPrivySiwaSigner, } from './privy.js';
+export { createBankrSiwaSigner, } from './bankr.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildersgarden/siwa",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "type": "module",
   "exports": {
     ".": {