@joai/warps-wallet-gaupa 1.0.0-beta.11

package/README.md

@@ -0,0 +1,87 @@
+# @joai/warps-wallet-gaupa
+
+Gaupa wallet provider for Warps SDK. This package enables you to use Gaupa agentic wallets with the Warps SDK.
+
+## Installation
+
+```bash
+npm install @joai/warps-wallet-gaupa
+```
+
+## Prerequisites
+
+- `@joai/warps` core package installed
+- Appropriate chain adapter package(s) for your target blockchain(s)
+- Gaupa API credentials (API key and public key)
+
+## Usage
+
+```typescript
+import { createGaupaWalletProvider } from '@joai/warps-wallet-gaupa'
+import { WarpClient } from '@joai/warps'
+import { getAllChainAdapters } from '@joai/warps-adapter-<chain>'
+
+const config = {
+  env: 'devnet', // or 'mainnet'
+  walletProviders: {
+    <chain>: {
+      gaupa: createGaupaWalletProvider({
+        apiKey: 'your-api-key',
+        publicKey: 'your-public-key',
+      }),
+    },
+  },
+}
+
+const client = new WarpClient(config, {
+  chains: getAllChainAdapters(),
+})
+```
+
+## API
+
+### `GaupaWalletProvider`
+
+Implements the `WalletProvider` interface from `@joai/warps`.
+
+**Methods:**
+
+- `getAddress(): Promise<string | null>` - Get the wallet address from configuration
+- `getPublicKey(): Promise<string | null>` - Derive public key from the wallet address
+- `signTransaction(tx: Transaction): Promise<Transaction>` - Sign a transaction using the Gaupa API's `sign-agentic-message` endpoint. The transaction is serialized as JSON and signed as a message.
+- `signMessage(message: string): Promise<string>` - Sign a message using the Gaupa API
+- `generate(): Promise<WarpWalletDetails>` - Create a new agentic wallet via the Gaupa API
+
+**Unsupported Methods:**
+
+- `importFromMnemonic()` - Not supported. Use `generate()` to create wallets via Gaupa API.
+- `importFromPrivateKey()` - Not supported. Use `generate()` to create wallets via Gaupa API.
+- `export()` - Not supported. Private keys are managed by Gaupa and cannot be exported.
+
+## How It Works
+
+1. **API Configuration**: The API URL is automatically configured based on the environment:
+   - `devnet`: `https://devnet-login.gaupa.xyz/api`
+   - `mainnet` or other: `https://login.gaupa.xyz/api`
+
+2. **Wallet Creation**: Use `generate()` to create a new agentic wallet via the Gaupa API. The wallet address is stored in your Warps configuration.
+
+3. **Transaction Signing**: When signing a transaction, the provider:
+   - Serializes the transaction data as JSON
+   - Calls the Gaupa API's `sign-agentic-message` endpoint with the serialized transaction
+   - Converts the returned hex signature to a `Uint8Array` and applies it to the transaction
+
+4. **Message Signing**: Messages are signed directly via the `sign-agentic-message` endpoint.
+
+## Configuration
+
+The wallet configuration is stored in your Warps config under `user.wallets.<chain>`:
+
+```json
+{
+  "provider": "gaupa",
+  "address": "erd1..."
+}
+```
+
+The address is set automatically when you call `generate()` or can be configured manually.

package/dist/index.d.cts

@@ -0,0 +1,30 @@
+import { Transaction } from '@multiversx/sdk-core';
+import { WalletProvider, WarpWalletProvider, WarpClientConfig, WarpChainInfo, WarpWalletDetails, WalletProviderFactory } from '@joai/warps';
+
+type ProviderConfig = {
+    apiKey: string;
+    publicKey: string;
+};
+
+declare class GaupaWalletProvider implements WalletProvider {
+    private readonly config;
+    private readonly chain;
+    private readonly gaupaConfig;
+    static readonly PROVIDER_NAME: WarpWalletProvider;
+    private readonly client;
+    private cachedAddress;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo, gaupaConfig: ProviderConfig);
+    getAddress(): Promise<string | null>;
+    getPublicKey(): Promise<string | null>;
+    signTransaction(tx: Transaction): Promise<Transaction>;
+    signMessage(message: string): Promise<string>;
+    importFromMnemonic(mnemonic: string): Promise<WarpWalletDetails>;
+    importFromPrivateKey(privateKey: string): Promise<WarpWalletDetails>;
+    export(): Promise<WarpWalletDetails>;
+    generate(): Promise<WarpWalletDetails>;
+    private formatTransactionForApi;
+}
+
+declare const createGaupaWalletProvider: (gaupaConfig: ProviderConfig) => WalletProviderFactory;
+
+export { GaupaWalletProvider, type ProviderConfig, createGaupaWalletProvider };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { Transaction } from '@multiversx/sdk-core';
+import { WalletProvider, WarpWalletProvider, WarpClientConfig, WarpChainInfo, WarpWalletDetails, WalletProviderFactory } from '@joai/warps';
+
+type ProviderConfig = {
+    apiKey: string;
+    publicKey: string;
+};
+
+declare class GaupaWalletProvider implements WalletProvider {
+    private readonly config;
+    private readonly chain;
+    private readonly gaupaConfig;
+    static readonly PROVIDER_NAME: WarpWalletProvider;
+    private readonly client;
+    private cachedAddress;
+    constructor(config: WarpClientConfig, chain: WarpChainInfo, gaupaConfig: ProviderConfig);
+    getAddress(): Promise<string | null>;
+    getPublicKey(): Promise<string | null>;
+    signTransaction(tx: Transaction): Promise<Transaction>;
+    signMessage(message: string): Promise<string>;
+    importFromMnemonic(mnemonic: string): Promise<WarpWalletDetails>;
+    importFromPrivateKey(privateKey: string): Promise<WarpWalletDetails>;
+    export(): Promise<WarpWalletDetails>;
+    generate(): Promise<WarpWalletDetails>;
+    private formatTransactionForApi;
+}
+
+declare const createGaupaWalletProvider: (gaupaConfig: ProviderConfig) => WalletProviderFactory;
+
+export { GaupaWalletProvider, type ProviderConfig, createGaupaWalletProvider };

package/dist/index.js

@@ -0,0 +1,168 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  GaupaWalletProvider: () => GaupaWalletProvider,
+  createGaupaWalletProvider: () => createGaupaWalletProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/GaupaWalletProvider.ts
+var import_sdk_core = require("@multiversx/sdk-core");
+var import_warps = require("@joai/warps");
+
+// src/config.ts
+var getGaupaApiUrl = (env) => {
+  if (env === "devnet") return "https://devnet-login.gaupa.xyz/api";
+  return "https://login.gaupa.xyz/api";
+};
+
+// src/GaupaApiClient.ts
+var GaupaApiClient = class {
+  constructor(apiKey, apiUrl, publicKey) {
+    this.apiKey = apiKey;
+    this.publicKey = publicKey;
+    this.baseUrl = apiUrl.replace(/\/$/, "");
+  }
+  async createAgenticWallet(request) {
+    return this.request("/manage/create-agentic-wallet", {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  async signMessage(request) {
+    return this.request("/manage/sign-agentic-message", {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  async request(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey,
+      "Public-Key": this.publicKey
+    };
+    const response = await fetch(url, {
+      ...options,
+      headers
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(`Gaupa API error (${response.status}): ${errorText}`);
+    }
+    return response.json();
+  }
+};
+
+// src/GaupaWalletProvider.ts
+var _GaupaWalletProvider = class _GaupaWalletProvider {
+  constructor(config, chain, gaupaConfig) {
+    this.config = config;
+    this.chain = chain;
+    this.gaupaConfig = gaupaConfig;
+    this.cachedAddress = null;
+    const apiUrl = getGaupaApiUrl(config.env);
+    this.client = new GaupaApiClient(gaupaConfig.apiKey, apiUrl, gaupaConfig.publicKey);
+  }
+  async getAddress() {
+    if (this.cachedAddress) return this.cachedAddress;
+    const address = (0, import_warps.getWarpWalletAddressFromConfig)(this.config, this.chain.name);
+    if (!address) return null;
+    this.cachedAddress = address;
+    return address;
+  }
+  async getPublicKey() {
+    const address = await this.getAddress();
+    if (!address) return null;
+    const pubKey = import_sdk_core.Address.newFromBech32(address).getPublicKey().toString("hex");
+    return pubKey;
+  }
+  async signTransaction(tx) {
+    const walletAddress = await this.getAddress();
+    if (!walletAddress) throw new Error("GaupaWalletProvider: Wallet address not found");
+    const transactionData = this.formatTransactionForApi(tx);
+    const message = JSON.stringify(transactionData);
+    const result = await this.client.signMessage({
+      message,
+      walletAddress
+    });
+    tx.signature = new Uint8Array(Buffer.from(result.signature, "hex"));
+    return tx;
+  }
+  async signMessage(message) {
+    const walletAddress = await this.getAddress();
+    if (!walletAddress) throw new Error("GaupaWalletProvider: Wallet address not found");
+    const result = await this.client.signMessage({
+      message,
+      walletAddress
+    });
+    if (!result.signature) throw new Error("Gaupa API did not return signature");
+    return result.signature;
+  }
+  async importFromMnemonic(mnemonic) {
+    throw new Error("GaupaWalletProvider: importFromMnemonic() is not supported. Use generate() to create a new wallet via Gaupa API.");
+  }
+  async importFromPrivateKey(privateKey) {
+    throw new Error("GaupaWalletProvider: importFromPrivateKey() is not supported. Use generate() to create a new wallet via Gaupa API.");
+  }
+  async export() {
+    throw new Error("GaupaWalletProvider: export() is not supported. Private keys are managed by Gaupa and cannot be exported.");
+  }
+  async generate() {
+    try {
+      const wallet = await this.client.createAgenticWallet({});
+      if (!wallet.success || !wallet.wallet.address_multiversx) throw new Error("Gaupa API did not return a valid wallet");
+      const walletDetails = {
+        provider: _GaupaWalletProvider.PROVIDER_NAME,
+        address: wallet.wallet.address_multiversx
+      };
+      (0, import_warps.setWarpWalletInConfig)(this.config, this.chain.name, walletDetails);
+      this.cachedAddress = wallet.wallet.address_multiversx;
+      return walletDetails;
+    } catch (error) {
+      throw new Error(`GaupaWalletProvider: Failed to generate wallet: ${error}`);
+    }
+  }
+  formatTransactionForApi(tx) {
+    return {
+      receiver: tx.receiver.toBech32(),
+      value: tx.value.toString(),
+      ...tx.data?.length && { data: Buffer.from(tx.data).toString("base64") },
+      gasLimit: Number(tx.gasLimit),
+      gasPrice: Number(tx.gasPrice),
+      ...tx.nonce !== void 0 && { nonce: Number(tx.nonce) }
+    };
+  }
+};
+_GaupaWalletProvider.PROVIDER_NAME = "gaupa";
+var GaupaWalletProvider = _GaupaWalletProvider;
+
+// src/helpers.ts
+var createGaupaWalletProvider = (gaupaConfig) => {
+  return (config, chain) => new GaupaWalletProvider(config, chain, gaupaConfig);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GaupaWalletProvider,
+  createGaupaWalletProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/GaupaWalletProvider.ts","../src/config.ts","../src/GaupaApiClient.ts","../src/helpers.ts"],"sourcesContent":["export * from './GaupaWalletProvider'\nexport * from './helpers'\nexport * from './types'\n","import { Address, Transaction } from '@multiversx/sdk-core'\nimport {\n  getWarpWalletAddressFromConfig,\n  setWarpWalletInConfig,\n  WalletProvider,\n  WarpChainInfo,\n  WarpClientConfig,\n  WarpWalletDetails,\n  WarpWalletProvider,\n} from '@joai/warps'\nimport { getGaupaApiUrl } from './config'\nimport { GaupaApiClient } from './GaupaApiClient'\nimport { ProviderConfig } from './types'\n\nexport class GaupaWalletProvider implements WalletProvider {\n  static readonly PROVIDER_NAME: WarpWalletProvider = 'gaupa'\n  private readonly client: GaupaApiClient\n  private cachedAddress: string | null = null\n\n  constructor(\n    private readonly config: WarpClientConfig,\n    private readonly chain: WarpChainInfo,\n    private readonly gaupaConfig: ProviderConfig\n  ) {\n    const apiUrl = getGaupaApiUrl(config.env)\n    this.client = new GaupaApiClient(gaupaConfig.apiKey, apiUrl, gaupaConfig.publicKey)\n  }\n\n  async getAddress(): Promise<string | null> {\n    if (this.cachedAddress) return this.cachedAddress\n    const address = getWarpWalletAddressFromConfig(this.config, this.chain.name)\n    if (!address) return null\n    this.cachedAddress = address\n    return address\n  }\n\n  async getPublicKey(): Promise<string | null> {\n    const address = await this.getAddress()\n    if (!address) return null\n    const pubKey = Address.newFromBech32(address).getPublicKey().toString('hex')\n    return pubKey\n  }\n\n  async signTransaction(tx: Transaction): Promise<Transaction> {\n    const walletAddress = await this.getAddress()\n    if (!walletAddress) throw new Error('GaupaWalletProvider: Wallet address not found')\n\n    const transactionData = this.formatTransactionForApi(tx)\n    const message = JSON.stringify(transactionData)\n\n    const result = await this.client.signMessage({\n      message,\n      walletAddress,\n    })\n\n    tx.signature = new Uint8Array(Buffer.from(result.signature, 'hex'))\n\n    return tx\n  }\n\n  async signMessage(message: string): Promise<string> {\n    const walletAddress = await this.getAddress()\n    if (!walletAddress) throw new Error('GaupaWalletProvider: Wallet address not found')\n\n    const result = await this.client.signMessage({\n      message,\n      walletAddress,\n    })\n\n    if (!result.signature) throw new Error('Gaupa API did not return signature')\n\n    return result.signature\n  }\n\n  async importFromMnemonic(mnemonic: string): Promise<WarpWalletDetails> {\n    throw new Error('GaupaWalletProvider: importFromMnemonic() is not supported. Use generate() to create a new wallet via Gaupa API.')\n  }\n\n  async importFromPrivateKey(privateKey: string): Promise<WarpWalletDetails> {\n    throw new Error('GaupaWalletProvider: importFromPrivateKey() is not supported. Use generate() to create a new wallet via Gaupa API.')\n  }\n\n  async export(): Promise<WarpWalletDetails> {\n    throw new Error('GaupaWalletProvider: export() is not supported. Private keys are managed by Gaupa and cannot be exported.')\n  }\n\n  async generate(): Promise<WarpWalletDetails> {\n    try {\n      const wallet = await this.client.createAgenticWallet({})\n      if (!wallet.success || !wallet.wallet.address_multiversx) throw new Error('Gaupa API did not return a valid wallet')\n\n      const walletDetails: WarpWalletDetails = {\n        provider: GaupaWalletProvider.PROVIDER_NAME,\n        address: wallet.wallet.address_multiversx,\n      }\n\n      setWarpWalletInConfig(this.config, this.chain.name, walletDetails)\n      this.cachedAddress = wallet.wallet.address_multiversx\n\n      return walletDetails\n    } catch (error) {\n      throw new Error(`GaupaWalletProvider: Failed to generate wallet: ${error}`)\n    }\n  }\n\n  private formatTransactionForApi(tx: Transaction) {\n    return {\n      receiver: tx.receiver.toBech32(),\n      value: tx.value.toString(),\n      ...(tx.data?.length && { data: Buffer.from(tx.data).toString('base64') }),\n      gasLimit: Number(tx.gasLimit),\n      gasPrice: Number(tx.gasPrice),\n      ...(tx.nonce !== undefined && { nonce: Number(tx.nonce) }),\n    }\n  }\n}\n","import { WarpChainEnv } from '@joai/warps'\n\nexport const getGaupaApiUrl = (env: WarpChainEnv): string => {\n  if (env === 'devnet') return 'https://devnet-login.gaupa.xyz/api'\n  return 'https://login.gaupa.xyz/api'\n}\n","type CreateAgenticWalletRequest = { shard?: number }\ntype CreateAgenticWalletResponse = {\n  success: boolean\n  wallet: { address_multiversx: string; address_evm?: string; shard?: number | null }\n}\ntype SignMessageRequest = { message: string; walletAddress: string }\ntype SignMessageResponse = { address: string; signature: string; message: string; version: number; signer: string; txHash?: string }\n\nexport class GaupaApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n  private readonly publicKey: string\n\n  constructor(apiKey: string, apiUrl: string, publicKey: string) {\n    this.apiKey = apiKey\n    this.publicKey = publicKey\n    this.baseUrl = apiUrl.replace(/\\/$/, '')\n  }\n\n  async createAgenticWallet(request: CreateAgenticWalletRequest): Promise<CreateAgenticWalletResponse> {\n    return this.request<CreateAgenticWalletResponse>('/manage/create-agentic-wallet', {\n      method: 'POST',\n      body: JSON.stringify(request),\n    })\n  }\n\n  async signMessage(request: SignMessageRequest): Promise<SignMessageResponse> {\n    return this.request<SignMessageResponse>('/manage/sign-agentic-message', {\n      method: 'POST',\n      body: JSON.stringify(request),\n    })\n  }\n\n  private async request<T>(endpoint: string, options: RequestInit = {}): Promise<T> {\n    const url = `${this.baseUrl}${endpoint}`\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      'x-api-key': this.apiKey,\n      'Public-Key': this.publicKey,\n    }\n\n    const response = await fetch(url, {\n      ...options,\n      headers,\n    })\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => 'Unknown error')\n      throw new Error(`Gaupa API error (${response.status}): ${errorText}`)\n    }\n\n    return response.json()\n  }\n}\n","import { WalletProviderFactory, WarpChainInfo, WarpClientConfig } from '@joai/warps'\nimport { GaupaWalletProvider } from './GaupaWalletProvider'\nimport { ProviderConfig } from './types'\n\nexport const createGaupaWalletProvider = (gaupaConfig: ProviderConfig): WalletProviderFactory => {\n  return (config: WarpClientConfig, chain: WarpChainInfo) => new GaupaWalletProvider(config, chain, gaupaConfig)\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,143 @@
+// src/GaupaWalletProvider.ts
+import { Address } from "@multiversx/sdk-core";
+import {
+  getWarpWalletAddressFromConfig,
+  setWarpWalletInConfig
+} from "@joai/warps";
+
+// src/config.ts
+var getGaupaApiUrl = (env) => {
+  if (env === "devnet") return "https://devnet-login.gaupa.xyz/api";
+  return "https://login.gaupa.xyz/api";
+};
+
+// src/GaupaApiClient.ts
+var GaupaApiClient = class {
+  constructor(apiKey, apiUrl, publicKey) {
+    this.apiKey = apiKey;
+    this.publicKey = publicKey;
+    this.baseUrl = apiUrl.replace(/\/$/, "");
+  }
+  async createAgenticWallet(request) {
+    return this.request("/manage/create-agentic-wallet", {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  async signMessage(request) {
+    return this.request("/manage/sign-agentic-message", {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  async request(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey,
+      "Public-Key": this.publicKey
+    };
+    const response = await fetch(url, {
+      ...options,
+      headers
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(`Gaupa API error (${response.status}): ${errorText}`);
+    }
+    return response.json();
+  }
+};
+
+// src/GaupaWalletProvider.ts
+var _GaupaWalletProvider = class _GaupaWalletProvider {
+  constructor(config, chain, gaupaConfig) {
+    this.config = config;
+    this.chain = chain;
+    this.gaupaConfig = gaupaConfig;
+    this.cachedAddress = null;
+    const apiUrl = getGaupaApiUrl(config.env);
+    this.client = new GaupaApiClient(gaupaConfig.apiKey, apiUrl, gaupaConfig.publicKey);
+  }
+  async getAddress() {
+    if (this.cachedAddress) return this.cachedAddress;
+    const address = getWarpWalletAddressFromConfig(this.config, this.chain.name);
+    if (!address) return null;
+    this.cachedAddress = address;
+    return address;
+  }
+  async getPublicKey() {
+    const address = await this.getAddress();
+    if (!address) return null;
+    const pubKey = Address.newFromBech32(address).getPublicKey().toString("hex");
+    return pubKey;
+  }
+  async signTransaction(tx) {
+    const walletAddress = await this.getAddress();
+    if (!walletAddress) throw new Error("GaupaWalletProvider: Wallet address not found");
+    const transactionData = this.formatTransactionForApi(tx);
+    const message = JSON.stringify(transactionData);
+    const result = await this.client.signMessage({
+      message,
+      walletAddress
+    });
+    tx.signature = new Uint8Array(Buffer.from(result.signature, "hex"));
+    return tx;
+  }
+  async signMessage(message) {
+    const walletAddress = await this.getAddress();
+    if (!walletAddress) throw new Error("GaupaWalletProvider: Wallet address not found");
+    const result = await this.client.signMessage({
+      message,
+      walletAddress
+    });
+    if (!result.signature) throw new Error("Gaupa API did not return signature");
+    return result.signature;
+  }
+  async importFromMnemonic(mnemonic) {
+    throw new Error("GaupaWalletProvider: importFromMnemonic() is not supported. Use generate() to create a new wallet via Gaupa API.");
+  }
+  async importFromPrivateKey(privateKey) {
+    throw new Error("GaupaWalletProvider: importFromPrivateKey() is not supported. Use generate() to create a new wallet via Gaupa API.");
+  }
+  async export() {
+    throw new Error("GaupaWalletProvider: export() is not supported. Private keys are managed by Gaupa and cannot be exported.");
+  }
+  async generate() {
+    try {
+      const wallet = await this.client.createAgenticWallet({});
+      if (!wallet.success || !wallet.wallet.address_multiversx) throw new Error("Gaupa API did not return a valid wallet");
+      const walletDetails = {
+        provider: _GaupaWalletProvider.PROVIDER_NAME,
+        address: wallet.wallet.address_multiversx
+      };
+      setWarpWalletInConfig(this.config, this.chain.name, walletDetails);
+      this.cachedAddress = wallet.wallet.address_multiversx;
+      return walletDetails;
+    } catch (error) {
+      throw new Error(`GaupaWalletProvider: Failed to generate wallet: ${error}`);
+    }
+  }
+  formatTransactionForApi(tx) {
+    return {
+      receiver: tx.receiver.toBech32(),
+      value: tx.value.toString(),
+      ...tx.data?.length && { data: Buffer.from(tx.data).toString("base64") },
+      gasLimit: Number(tx.gasLimit),
+      gasPrice: Number(tx.gasPrice),
+      ...tx.nonce !== void 0 && { nonce: Number(tx.nonce) }
+    };
+  }
+};
+_GaupaWalletProvider.PROVIDER_NAME = "gaupa";
+var GaupaWalletProvider = _GaupaWalletProvider;
+
+// src/helpers.ts
+var createGaupaWalletProvider = (gaupaConfig) => {
+  return (config, chain) => new GaupaWalletProvider(config, chain, gaupaConfig);
+};
+export {
+  GaupaWalletProvider,
+  createGaupaWalletProvider
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/GaupaWalletProvider.ts","../src/config.ts","../src/GaupaApiClient.ts","../src/helpers.ts"],"sourcesContent":["import { Address, Transaction } from '@multiversx/sdk-core'\nimport {\n  getWarpWalletAddressFromConfig,\n  setWarpWalletInConfig,\n  WalletProvider,\n  WarpChainInfo,\n  WarpClientConfig,\n  WarpWalletDetails,\n  WarpWalletProvider,\n} from '@joai/warps'\nimport { getGaupaApiUrl } from './config'\nimport { GaupaApiClient } from './GaupaApiClient'\nimport { ProviderConfig } from './types'\n\nexport class GaupaWalletProvider implements WalletProvider {\n  static readonly PROVIDER_NAME: WarpWalletProvider = 'gaupa'\n  private readonly client: GaupaApiClient\n  private cachedAddress: string | null = null\n\n  constructor(\n    private readonly config: WarpClientConfig,\n    private readonly chain: WarpChainInfo,\n    private readonly gaupaConfig: ProviderConfig\n  ) {\n    const apiUrl = getGaupaApiUrl(config.env)\n    this.client = new GaupaApiClient(gaupaConfig.apiKey, apiUrl, gaupaConfig.publicKey)\n  }\n\n  async getAddress(): Promise<string | null> {\n    if (this.cachedAddress) return this.cachedAddress\n    const address = getWarpWalletAddressFromConfig(this.config, this.chain.name)\n    if (!address) return null\n    this.cachedAddress = address\n    return address\n  }\n\n  async getPublicKey(): Promise<string | null> {\n    const address = await this.getAddress()\n    if (!address) return null\n    const pubKey = Address.newFromBech32(address).getPublicKey().toString('hex')\n    return pubKey\n  }\n\n  async signTransaction(tx: Transaction): Promise<Transaction> {\n    const walletAddress = await this.getAddress()\n    if (!walletAddress) throw new Error('GaupaWalletProvider: Wallet address not found')\n\n    const transactionData = this.formatTransactionForApi(tx)\n    const message = JSON.stringify(transactionData)\n\n    const result = await this.client.signMessage({\n      message,\n      walletAddress,\n    })\n\n    tx.signature = new Uint8Array(Buffer.from(result.signature, 'hex'))\n\n    return tx\n  }\n\n  async signMessage(message: string): Promise<string> {\n    const walletAddress = await this.getAddress()\n    if (!walletAddress) throw new Error('GaupaWalletProvider: Wallet address not found')\n\n    const result = await this.client.signMessage({\n      message,\n      walletAddress,\n    })\n\n    if (!result.signature) throw new Error('Gaupa API did not return signature')\n\n    return result.signature\n  }\n\n  async importFromMnemonic(mnemonic: string): Promise<WarpWalletDetails> {\n    throw new Error('GaupaWalletProvider: importFromMnemonic() is not supported. Use generate() to create a new wallet via Gaupa API.')\n  }\n\n  async importFromPrivateKey(privateKey: string): Promise<WarpWalletDetails> {\n    throw new Error('GaupaWalletProvider: importFromPrivateKey() is not supported. Use generate() to create a new wallet via Gaupa API.')\n  }\n\n  async export(): Promise<WarpWalletDetails> {\n    throw new Error('GaupaWalletProvider: export() is not supported. Private keys are managed by Gaupa and cannot be exported.')\n  }\n\n  async generate(): Promise<WarpWalletDetails> {\n    try {\n      const wallet = await this.client.createAgenticWallet({})\n      if (!wallet.success || !wallet.wallet.address_multiversx) throw new Error('Gaupa API did not return a valid wallet')\n\n      const walletDetails: WarpWalletDetails = {\n        provider: GaupaWalletProvider.PROVIDER_NAME,\n        address: wallet.wallet.address_multiversx,\n      }\n\n      setWarpWalletInConfig(this.config, this.chain.name, walletDetails)\n      this.cachedAddress = wallet.wallet.address_multiversx\n\n      return walletDetails\n    } catch (error) {\n      throw new Error(`GaupaWalletProvider: Failed to generate wallet: ${error}`)\n    }\n  }\n\n  private formatTransactionForApi(tx: Transaction) {\n    return {\n      receiver: tx.receiver.toBech32(),\n      value: tx.value.toString(),\n      ...(tx.data?.length && { data: Buffer.from(tx.data).toString('base64') }),\n      gasLimit: Number(tx.gasLimit),\n      gasPrice: Number(tx.gasPrice),\n      ...(tx.nonce !== undefined && { nonce: Number(tx.nonce) }),\n    }\n  }\n}\n","import { WarpChainEnv } from '@joai/warps'\n\nexport const getGaupaApiUrl = (env: WarpChainEnv): string => {\n  if (env === 'devnet') return 'https://devnet-login.gaupa.xyz/api'\n  return 'https://login.gaupa.xyz/api'\n}\n","type CreateAgenticWalletRequest = { shard?: number }\ntype CreateAgenticWalletResponse = {\n  success: boolean\n  wallet: { address_multiversx: string; address_evm?: string; shard?: number | null }\n}\ntype SignMessageRequest = { message: string; walletAddress: string }\ntype SignMessageResponse = { address: string; signature: string; message: string; version: number; signer: string; txHash?: string }\n\nexport class GaupaApiClient {\n  private readonly baseUrl: string\n  private readonly apiKey: string\n  private readonly publicKey: string\n\n  constructor(apiKey: string, apiUrl: string, publicKey: string) {\n    this.apiKey = apiKey\n    this.publicKey = publicKey\n    this.baseUrl = apiUrl.replace(/\\/$/, '')\n  }\n\n  async createAgenticWallet(request: CreateAgenticWalletRequest): Promise<CreateAgenticWalletResponse> {\n    return this.request<CreateAgenticWalletResponse>('/manage/create-agentic-wallet', {\n      method: 'POST',\n      body: JSON.stringify(request),\n    })\n  }\n\n  async signMessage(request: SignMessageRequest): Promise<SignMessageResponse> {\n    return this.request<SignMessageResponse>('/manage/sign-agentic-message', {\n      method: 'POST',\n      body: JSON.stringify(request),\n    })\n  }\n\n  private async request<T>(endpoint: string, options: RequestInit = {}): Promise<T> {\n    const url = `${this.baseUrl}${endpoint}`\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      'x-api-key': this.apiKey,\n      'Public-Key': this.publicKey,\n    }\n\n    const response = await fetch(url, {\n      ...options,\n      headers,\n    })\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => 'Unknown error')\n      throw new Error(`Gaupa API error (${response.status}): ${errorText}`)\n    }\n\n    return response.json()\n  }\n}\n","import { WalletProviderFactory, WarpChainInfo, WarpClientConfig } from '@joai/warps'\nimport { GaupaWalletProvider } from './GaupaWalletProvider'\nimport { ProviderConfig } from './types'\n\nexport const createGaupaWalletProvider = (gaupaConfig: ProviderConfig): WalletProviderFactory => {\n  return (config: WarpClientConfig, chain: WarpChainInfo) => new GaupaWalletProvider(config, chain, gaupaConfig)\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@joai/warps-wallet-gaupa",
+  "version": "1.0.0-beta.11",
+  "description": "Gaupa wallet provider for multiple chains",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "jest --config jest.config.mjs",
+    "lint": "tsc --noEmit",
+    "preversion": "npm run lint && npm run build"
+  },
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@joai/warps": "^3.0.0-beta.198"
+  }
+}