@openzeppelin/relayer-plugin-channels 0.5.0 → 0.7.0

package/README.md

@@ -16,6 +16,7 @@ A plugin for OpenZeppelin Relayer that enables parallel transaction submission o
 - [Development](#development)
 - [Overview](#overview)
 - [Architecture](#architecture)
+- [Contract Capacity Limits](#contract-capacity-limits)
 - [Management API](#management-api)
   - [List Channel Accounts](#list-channel-accounts)
   - [Set Channel Accounts](#set-channel-accounts)
@@ -109,7 +110,7 @@ mkdir -p plugins/channels
 `plugins/channels/index.ts`
 
 ```ts
-export { handler } from "@openzeppelin/relayer-plugin-channels";
+export { handler } from '@openzeppelin/relayer-plugin-channels';
 ```
 
 ### Configure the Relayer
@@ -224,6 +225,10 @@ export LOCK_TTL_SECONDS=10              # default: 30, min: 3, max: 30
 export FEE_LIMIT=1000000                  # Default max fee per API key in stroops (disabled if not set)
 export FEE_RESET_PERIOD_SECONDS=86400     # Reset fee consumption every N seconds (e.g., 86400 = 24 hours)
 export API_KEY_HEADER="x-api-key"         # Header name to extract API key (default: x-api-key)
+
+# Contract capacity limits (optional)
+export LIMITED_CONTRACTS="CDL74RF5BLYR2YBLCCI7F5FB6TPSCLKEJUBSD2RSVWZ4YHF3VMFAIGWA"  # Comma-separated contract addresses
+export CONTRACT_CAPACITY_RATIO=0.8        # Max ratio of pool for limited contracts (default: 0.8 = 80%)
 ```
 
 Your Relayer should now contain:
@@ -291,6 +296,41 @@ The Channels plugin accepts Soroban operations and handles all the complexity of
 - **Channel Accounts**: Provide unique sequence numbers for parallel transaction submission
 - The channel account is the transaction source and signer; the fund account wraps it in a fee bump
 
+## Contract Capacity Limits
+
+High-volume contracts can monopolize the channel pool, starving other traffic. Contract capacity limits allow you to reserve a portion of the pool for non-limited contracts.
+
+### Configuration
+
+```bash
+# Comma-separated list of contract addresses to limit (case-insensitive)
+export LIMITED_CONTRACTS="CDL74RF5BLYR2YBLCCI7F5FB6TPSCLKEJUBSD2RSVWZ4YHF3VMFAIGWA,CABC123..."
+
+# Maximum ratio of pool that limited contracts can use (default: 0.8)
+export CONTRACT_CAPACITY_RATIO=0.8
+```
+
+### How It Works
+
+- **Limited contracts** can only acquire from a deterministic subset of channels (e.g., 80% of pool)
+- **Unlisted contracts** have full access to all channels
+- The subset is selected deterministically using a hash-based partition, ensuring stable channel assignment
+- Minimum 1 channel is always guaranteed, even at very low ratios
+
+### Example
+
+With 10 channel accounts and `CONTRACT_CAPACITY_RATIO=0.8`:
+
+- Limited contracts can use up to 8 channels (`floor(10 * 0.8)`)
+- 2 channels are always reserved for non-limited traffic
+- If all 8 limited slots are in use, limited contracts get `POOL_CAPACITY` error while non-limited contracts can still acquire
+
+### Notes
+
+- Contract IDs are matched case-insensitively (normalized to uppercase internally)
+- If contract ID cannot be extracted from the request (non-`invokeContract` operations), no limit is applied
+- Zero runtime overhead for unlimited contracts
+
 ## Management API
 
 The Channels plugin provides a management API to dynamically configure channel accounts. This API requires authentication via the `PLUGIN_ADMIN_SECRET` environment variable.
@@ -492,20 +532,20 @@ pnpm add @openzeppelin/relayer-plugin-channels
 ### Quick Start
 
 ```typescript
-import { ChannelsClient } from "@openzeppelin/relayer-plugin-channels";
+import { ChannelsClient } from '@openzeppelin/relayer-plugin-channels';
 
 // Connecting to OpenZeppelin's managed Channels service
 const client = new ChannelsClient({
-  baseUrl: "https://channels.openzeppelin.com",
-  apiKey: "your-api-key",
+  baseUrl: 'https://channels.openzeppelin.com',
+  apiKey: 'your-api-key',
 });
 
 // Connecting to your own Relayer with Channels plugin
 const relayerClient = new ChannelsClient({
-  baseUrl: "http://localhost:8080",
-  pluginId: "channels",
-  apiKey: "your-relayer-api-key",
-  adminSecret: "your-admin-secret", // Optional: Required for management operations
+  baseUrl: 'http://localhost:8080',
+  pluginId: 'channels',
+  apiKey: 'your-relayer-api-key',
+  adminSecret: 'your-admin-secret', // Optional: Required for management operations
 });
 ```
 
@@ -518,14 +558,14 @@ When connecting to OpenZeppelin's managed Channels service (which runs behind Cl
 ```typescript
 // Mainnet
 const client = new ChannelsClient({
-  baseUrl: "https://channels.openzeppelin.com",
-  apiKey: "your-api-key",
+  baseUrl: 'https://channels.openzeppelin.com',
+  apiKey: 'your-api-key',
 });
 
 // Testnet
 const testnetClient = new ChannelsClient({
-  baseUrl: "https://channels.openzeppelin.com/testnet",
-  apiKey: "your-api-key",
+  baseUrl: 'https://channels.openzeppelin.com/testnet',
+  apiKey: 'your-api-key',
 });
 ```
 
@@ -540,10 +580,10 @@ When connecting directly to your own OpenZeppelin Relayer instance, include the
 
 ```typescript
 const client = new ChannelsClient({
-  baseUrl: "http://localhost:8080",
-  pluginId: "channels",
-  apiKey: "your-relayer-api-key",
-  adminSecret: "your-admin-secret", // Optional: Required for management operations
+  baseUrl: 'http://localhost:8080',
+  pluginId: 'channels',
+  apiKey: 'your-relayer-api-key',
+  adminSecret: 'your-admin-secret', // Optional: Required for management operations
 });
 ```
 
@@ -556,7 +596,7 @@ The client automatically routes requests appropriately based on whether `pluginI
 ```typescript
 // Submit a complete, signed transaction
 const result = await client.submitTransaction({
-  xdr: "AAAAAgAAAAC...", // Complete transaction envelope XDR
+  xdr: 'AAAAAgAAAAC...', // Complete transaction envelope XDR
 });
 
 console.log(result.hash); // Transaction hash
@@ -569,8 +609,8 @@ console.log(result.transactionId); // Relayer transaction ID
 ```typescript
 // Submit func+auth (uses channel accounts and simulation)
 const result = await client.submitSorobanTransaction({
-  func: "AAAABAAAAAEAAAAGc3ltYm9s...", // Host function XDR (base64)
-  auth: ["AAAACAAAAAEAAAA..."], // Auth entry XDRs (base64)
+  func: 'AAAABAAAAAEAAAAGc3ltYm9s...', // Host function XDR (base64)
+  auth: ['AAAACAAAAAEAAAA...'], // Auth entry XDRs (base64)
 });
 
 console.log(result.hash);
@@ -581,10 +621,10 @@ console.log(result.hash);
 ```typescript
 // Initialize client with admin secret
 const adminClient = new ChannelsClient({
-  baseUrl: "http://localhost:8080",
-  apiKey: "your-api-key",
-  pluginId: "channels",
-  adminSecret: "your-admin-secret", // Required for management operations
+  baseUrl: 'http://localhost:8080',
+  apiKey: 'your-api-key',
+  pluginId: 'channels',
+  adminSecret: 'your-admin-secret', // Required for management operations
 });
 
 // List configured channel accounts
@@ -596,11 +636,7 @@ console.log(accounts.relayerIds); // ['channel-001', 'channel-002', ...]
 
 ```typescript
 // Configure channel accounts (requires adminSecret)
-const result = await adminClient.setChannelAccounts([
-  "channel-001",
-  "channel-002",
-  "channel-003",
-]);
+const result = await adminClient.setChannelAccounts(['channel-001', 'channel-002', 'channel-003']);
 
 console.log(result.ok); // true
 console.log(result.appliedRelayerIds); // ['channel-001', 'channel-002', 'channel-003']
@@ -610,7 +646,7 @@ console.log(result.appliedRelayerIds); // ['channel-001', 'channel-002', 'channe
 
 ```typescript
 // Query fee consumption for an API key (requires adminSecret)
-const usage = await adminClient.getFeeUsage("client-api-key");
+const usage = await adminClient.getFeeUsage('client-api-key');
 
 console.log(usage.consumed); // 500000 (stroops)
 console.log(usage.limit); // 1000000 (effective limit)
@@ -623,7 +659,7 @@ console.log(usage.periodEndsAt); // '2024-01-16T00:00:00.000Z'
 
 ```typescript
 // Query fee limit configuration for an API key (requires adminSecret)
-const limitInfo = await adminClient.getFeeLimit("client-api-key");
+const limitInfo = await adminClient.getFeeLimit('client-api-key');
 
 console.log(limitInfo.limit); // 500000 (custom limit if set, otherwise default)
 ```
@@ -632,7 +668,7 @@ console.log(limitInfo.limit); // 500000 (custom limit if set, otherwise default)
 
 ```typescript
 // Set a custom fee limit for an API key (requires adminSecret)
-const result = await adminClient.setFeeLimit("client-api-key", 500000);
+const result = await adminClient.setFeeLimit('client-api-key', 500000);
 
 console.log(result.ok); // true
 console.log(result.limit); // 500000
@@ -642,7 +678,7 @@ console.log(result.limit); // 500000
 
 ```typescript
 // Remove custom fee limit, revert to default (requires adminSecret)
-const result = await adminClient.deleteFeeLimit("client-api-key");
+const result = await adminClient.deleteFeeLimit('client-api-key');
 
 console.log(result.ok); // true
 ```
@@ -656,22 +692,22 @@ import {
   PluginTransportError,
   PluginExecutionError,
   PluginUnexpectedError,
-} from "@openzeppelin/relayer-plugin-channels";
+} from '@openzeppelin/relayer-plugin-channels';
 
 try {
-  const result = await client.submitTransaction({ xdr: "..." });
+  const result = await client.submitTransaction({ xdr: '...' });
 } catch (error) {
   if (error instanceof PluginTransportError) {
     // Network/HTTP failures (connection refused, timeout, 500/502/503)
-    console.error("Transport error:", error.message);
-    console.error("Status code:", error.statusCode);
+    console.error('Transport error:', error.message);
+    console.error('Status code:', error.statusCode);
   } else if (error instanceof PluginExecutionError) {
     // Plugin rejected the request (validation, business logic, on-chain failure)
-    console.error("Execution error:", error.message);
-    console.error("Details:", error.errorDetails);
+    console.error('Execution error:', error.message);
+    console.error('Details:', error.errorDetails);
   } else if (error instanceof PluginUnexpectedError) {
     // Client-side parsing/validation errors
-    console.error("Unexpected error:", error.message);
+    console.error('Unexpected error:', error.message);
   }
 }
 ```
@@ -681,12 +717,12 @@ try {
 Responses include optional metadata (logs and traces) when the plugin is configured with `emit_logs` and `emit_traces`:
 
 ```typescript
-const result = await client.submitTransaction({ xdr: "..." });
+const result = await client.submitTransaction({ xdr: '...' });
 
 // Access metadata if available
 if (result.metadata) {
-  console.log("Logs:", result.metadata.logs);
-  console.log("Traces:", result.metadata.traces);
+  console.log('Logs:', result.metadata.logs);
+  console.log('Traces:', result.metadata.traces);
 }
 ```
 
@@ -705,7 +741,7 @@ import type {
   GetFeeLimitResponse,
   SetFeeLimitResponse,
   DeleteFeeLimitResponse,
-} from "@openzeppelin/relayer-plugin-channels";
+} from '@openzeppelin/relayer-plugin-channels';
 ```
 
 ### Configuration Options

package/dist/client/channels-client.d.ts

@@ -1,4 +1,4 @@
-import type { ChannelsClientConfig, ChannelsXdrRequest, ChannelsFuncAuthRequest, ChannelsTransactionResponse, ListChannelAccountsResponse, SetChannelAccountsResponse, GetFeeUsageResponse, GetFeeLimitResponse, SetFeeLimitResponse, DeleteFeeLimitResponse } from "./types";
+import type { ChannelsClientConfig, ChannelsXdrRequest, ChannelsFuncAuthRequest, ChannelsTransactionResponse, ListChannelAccountsResponse, SetChannelAccountsResponse, GetFeeUsageResponse, GetFeeLimitResponse, SetFeeLimitResponse, DeleteFeeLimitResponse } from './types';
 /**
  * Client for interacting with the Channels plugin
  *

package/dist/client/channels-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels-client.d.ts","sourceRoot":"","sources":["../../src/client/channels-client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,MAAM,EAAE,oBAAoB;IAiCxC;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,2BAA2B,CAAC;IAIvC;;;;;;;;;;;;;;;OAeG;IACG,wBAAwB,CAC5B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC;IAIvC;;;;;;;;;;;;OAYG;IACG,mBAAmB,IAAI,OAAO,CAAC,2BAA2B,CAAC;IASjE;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAUtC;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAU/D;;;;;;;;;OASG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAU/D;;;;;;;;;;OAUG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAW/B;;;;;;;;;OASG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAUrE;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;OAOG;IAEH,OAAO,CAAC,eAAe;IAoBvB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;;;;;OAQG;YACW,IAAI;IA6BlB;;;;;;OAMG;YACW,QAAQ;CAYvB"}
+{"version":3,"file":"channels-client.d.ts","sourceRoot":"","sources":["../../src/client/channels-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,MAAM,EAAE,oBAAoB;IAiCxC;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAI1F;;;;;;;;;;;;;;;OAeG;IACG,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAItG;;;;;;;;;;;;OAYG;IACG,mBAAmB,IAAI,OAAO,CAAC,2BAA2B,CAAC;IASjE;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAUnF;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAU/D;;;;;;;;;OASG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAU/D;;;;;;;;;;OAUG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAW9E;;;;;;;;;OASG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAUrE;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;;;;;OAOG;IAEH,OAAO,CAAC,eAAe;IAgBvB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;;;;;OAQG;YACW,IAAI;IAwBlB;;;;;;OAMG;YACW,QAAQ;CASvB"}

package/dist/client/channels-client.js

@@ -31,9 +31,9 @@ class ChannelsClient {
     constructor(config) {
         this.adminSecret = config.adminSecret;
         // Route through Relayer plugin system if pluginId provided, otherwise connect directly
-        if ("pluginId" in config && config.pluginId) {
+        if ('pluginId' in config && config.pluginId) {
             this.pluginId = config.pluginId;
-            const apiKeyHeader = config.apiKeyHeader || "x-api-key";
+            const apiKeyHeader = config.apiKeyHeader || 'x-api-key';
             const relayerConfig = new relayer_sdk_1.Configuration({
                 basePath: config.baseUrl,
                 accessToken: config.apiKey,
@@ -44,14 +44,14 @@ class ChannelsClient {
             this.pluginsApi = new relayer_sdk_1.PluginsApi(relayerConfig);
         }
         else {
-            if (!("baseUrl" in config) || !config.baseUrl) {
-                throw new Error("baseUrl is required when pluginId is not provided");
+            if (!('baseUrl' in config) || !config.baseUrl) {
+                throw new Error('baseUrl is required when pluginId is not provided');
             }
             this.axiosClient = axios_1.default.create({
                 baseURL: config.baseUrl,
                 timeout: config.timeout || 30000,
                 headers: {
-                    "Content-Type": "application/json",
+                    'Content-Type': 'application/json',
                     Authorization: `Bearer ${config.apiKey}`,
                 },
             });
@@ -109,7 +109,7 @@ class ChannelsClient {
     async listChannelAccounts() {
         return this.call({
             management: {
-                action: "listChannelAccounts",
+                action: 'listChannelAccounts',
                 adminSecret: this.requireAdminSecret(),
             },
         });
@@ -133,7 +133,7 @@ class ChannelsClient {
     async setChannelAccounts(relayerIds) {
         return this.call({
             management: {
-                action: "setChannelAccounts",
+                action: 'setChannelAccounts',
                 adminSecret: this.requireAdminSecret(),
                 relayerIds,
             },
@@ -156,7 +156,7 @@ class ChannelsClient {
     async getFeeUsage(apiKey) {
         return this.call({
             management: {
-                action: "getFeeUsage",
+                action: 'getFeeUsage',
                 adminSecret: this.requireAdminSecret(),
                 apiKey,
             },
@@ -175,7 +175,7 @@ class ChannelsClient {
     async getFeeLimit(apiKey) {
         return this.call({
             management: {
-                action: "getFeeLimit",
+                action: 'getFeeLimit',
                 adminSecret: this.requireAdminSecret(),
                 apiKey,
             },
@@ -195,7 +195,7 @@ class ChannelsClient {
     async setFeeLimit(apiKey, limit) {
         return this.call({
             management: {
-                action: "setFeeLimit",
+                action: 'setFeeLimit',
                 adminSecret: this.requireAdminSecret(),
                 apiKey,
                 limit,
@@ -215,7 +215,7 @@ class ChannelsClient {
     async deleteFeeLimit(apiKey) {
         return this.call({
             management: {
-                action: "deleteFeeLimit",
+                action: 'deleteFeeLimit',
                 adminSecret: this.requireAdminSecret(),
                 apiKey,
             },
@@ -229,7 +229,7 @@ class ChannelsClient {
      */
     requireAdminSecret() {
         if (!this.adminSecret) {
-            throw new Error("adminSecret required for management operations. Provide it in client config.");
+            throw new Error('adminSecret required for management operations. Provide it in client config.');
         }
         return this.adminSecret;
     }
@@ -262,12 +262,12 @@ class ChannelsClient {
      * @throws {PluginUnexpectedError} For invalid/malformed responses
      */
     validateResponse(responseBody) {
-        if (!responseBody || typeof responseBody !== "object") {
-            throw new errors_1.PluginUnexpectedError("Empty or invalid response from plugin");
+        if (!responseBody || typeof responseBody !== 'object') {
+            throw new errors_1.PluginUnexpectedError('Empty or invalid response from plugin');
         }
         const response = responseBody;
         if (response.success === undefined) {
-            throw new errors_1.PluginUnexpectedError("Malformed response: missing success field");
+            throw new errors_1.PluginUnexpectedError('Malformed response: missing success field');
         }
         return response;
     }
@@ -278,7 +278,8 @@ class ChannelsClient {
      * @param metadata Optional metadata (logs and traces)
      * @returns Data with metadata merged if present
      */
-    mergeMetadata(data, metadata) {
+    mergeMetadata(data, metadata // eslint-disable-line @typescript-eslint/no-explicit-any
+    ) {
         if (!metadata || (!metadata.logs && !metadata.traces)) {
             return data;
         }
@@ -307,10 +308,8 @@ class ChannelsClient {
         const response = this.validateResponse(responseBody);
         // Handle execution errors
         if (!response.success) {
-            const errorDetails = response.metadata
-                ? { ...response.data, metadata: response.metadata }
-                : response.data;
-            throw new errors_1.PluginExecutionError(response.error || "Plugin execution failed", errorDetails);
+            const errorDetails = response.metadata ? { ...response.data, metadata: response.metadata } : response.data;
+            throw new errors_1.PluginExecutionError(response.error || 'Plugin execution failed', errorDetails);
         }
         // Return data with metadata if present
         return this.mergeMetadata(response.data, response.metadata);
@@ -327,7 +326,7 @@ class ChannelsClient {
             const response = await this.pluginsApi.callPlugin(this.pluginId, payload);
             return response.data;
         }
-        const response = await this.axiosClient.post("/", payload);
+        const response = await this.axiosClient.post('/', payload);
         return response.data;
     }
 }

package/dist/client/errors.d.ts

@@ -2,7 +2,7 @@
  * Base class for all plugin-related errors
  */
 export declare abstract class PluginClientError extends Error {
-    abstract readonly category: "transport" | "execution" | "client";
+    abstract readonly category: 'transport' | 'execution' | 'client';
 }
 /**
  * HTTP/Network transport failures

package/dist/client/errors.js

@@ -16,12 +16,13 @@ exports.PluginClientError = PluginClientError;
  * - Invalid responses (malformed JSON)
  */
 class PluginTransportError extends PluginClientError {
-    constructor(message, statusCode, errorDetails) {
+    constructor(message, statusCode, errorDetails // eslint-disable-line @typescript-eslint/no-explicit-any
+    ) {
         super(message);
         this.statusCode = statusCode;
         this.errorDetails = errorDetails;
-        this.category = "transport";
-        this.name = "PluginTransportError";
+        this.category = 'transport';
+        this.name = 'PluginTransportError';
     }
 }
 exports.PluginTransportError = PluginTransportError;
@@ -34,11 +35,12 @@ exports.PluginTransportError = PluginTransportError;
  * - On-chain failures (transaction reverted)
  */
 class PluginExecutionError extends PluginClientError {
-    constructor(message, errorDetails) {
+    constructor(message, errorDetails // eslint-disable-line @typescript-eslint/no-explicit-any
+    ) {
         super(message);
         this.errorDetails = errorDetails;
-        this.category = "execution";
-        this.name = "PluginExecutionError";
+        this.category = 'execution';
+        this.name = 'PluginExecutionError';
     }
 }
 exports.PluginExecutionError = PluginExecutionError;
@@ -51,11 +53,12 @@ exports.PluginExecutionError = PluginExecutionError;
  * - Unexpected response structure
  */
 class PluginUnexpectedError extends PluginClientError {
-    constructor(message, errorDetails) {
+    constructor(message, errorDetails // eslint-disable-line @typescript-eslint/no-explicit-any
+    ) {
         super(message);
         this.errorDetails = errorDetails;
-        this.category = "client";
-        this.name = "PluginUnexpectedError";
+        this.category = 'client';
+        this.name = 'PluginUnexpectedError';
     }
 }
 exports.PluginUnexpectedError = PluginUnexpectedError;

package/dist/client/index.d.ts

@@ -4,7 +4,7 @@
  * Unified client for interacting with the channels plugin
  * in both direct HTTP mode and OpenZeppelin Relayer mode.
  */
-export { ChannelsClient } from "./channels-client";
-export { ChannelsClientConfig, DirectHttpConfig, RelayerConfig, ChannelsXdrRequest, ChannelsFuncAuthRequest, ChannelsTransactionResponse, ListChannelAccountsResponse, SetChannelAccountsResponse, GetFeeUsageResponse, GetFeeLimitResponse, SetFeeLimitResponse, DeleteFeeLimitResponse, } from "./types";
-export { PluginClientError, PluginTransportError, PluginExecutionError, PluginUnexpectedError, } from "./errors";
+export { ChannelsClient } from './channels-client';
+export { ChannelsClientConfig, DirectHttpConfig, RelayerConfig, ChannelsXdrRequest, ChannelsFuncAuthRequest, ChannelsTransactionResponse, ListChannelAccountsResponse, SetChannelAccountsResponse, GetFeeUsageResponse, GetFeeLimitResponse, SetFeeLimitResponse, DeleteFeeLimitResponse, } from './types';
+export { PluginClientError, PluginTransportError, PluginExecutionError, PluginUnexpectedError } from './errors';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/types.d.ts

@@ -1,4 +1,4 @@
-import type { LogEntry } from "@openzeppelin/relayer-sdk";
+import type { LogEntry } from '@openzeppelin/relayer-sdk';
 /**
  * Configuration for ChannelsClient in direct HTTP mode
  */

package/dist/index.d.ts

@@ -4,6 +4,6 @@
  * Main entry point for the @openzeppelin/relayer-plugin-channels package
  * Re-exports both the client (for external use) and the plugin handler
  */
-export * from "./client";
-export * from "./plugin";
+export * from './client';
+export * from './plugin';
 //# sourceMappingURL=index.d.ts.map

package/dist/plugin/build.d.ts

@@ -3,7 +3,7 @@
  *
  * Transaction rebuild logic to use channel account as source.
  */
-import { Transaction } from "@stellar/stellar-sdk";
+import { Transaction } from '@stellar/stellar-sdk';
 export interface RebuildParams {
     inputXdr: string;
     channelAddress: string;

package/dist/plugin/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/plugin/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAe,MAAM,sBAAsB,CAAC;AAIhE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CA6GrE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/plugin/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAe,MAAM,sBAAsB,CAAC;AAIhE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CA2FrE"}

package/dist/plugin/build.js

@@ -16,30 +16,28 @@ const constants_1 = require("./constants");
  * - Copy operations ensuring their source equals the fund address
  */
 function rebuildWithChannel(params) {
-    const { inputXdr, channelAddress, channelSequence, fundAddress, networkPassphrase, } = params;
+    const { inputXdr, channelAddress, channelSequence, fundAddress, networkPassphrase } = params;
     // Parse input transaction
     let inputTx;
     try {
-        const envelope = stellar_sdk_1.xdr.TransactionEnvelope.fromXDR(inputXdr, "base64");
+        const envelope = stellar_sdk_1.xdr.TransactionEnvelope.fromXDR(inputXdr, 'base64');
         // Ensure it's a regular transaction envelope (not fee bump)
         if (envelope.switch() !== stellar_sdk_1.xdr.EnvelopeType.envelopeTypeTx()) {
-            throw (0, relayer_sdk_1.pluginError)("Input must be a regular transaction envelope (not fee bump)", {
-                code: "INVALID_ENVELOPE_TYPE",
+            throw (0, relayer_sdk_1.pluginError)('Input must be a regular transaction envelope (not fee bump)', {
+                code: 'INVALID_ENVELOPE_TYPE',
                 status: constants_1.HTTP_STATUS.BAD_REQUEST,
             });
         }
         inputTx = new stellar_sdk_1.Transaction(envelope, networkPassphrase);
     }
     catch (error) {
-        if (error.code === "INVALID_ENVELOPE_TYPE") {
+        if (error.code === 'INVALID_ENVELOPE_TYPE') {
             throw error;
         }
-        throw (0, relayer_sdk_1.pluginError)("Failed to parse input transaction XDR", {
-            code: "INVALID_XDR",
+        throw (0, relayer_sdk_1.pluginError)('Failed to parse input transaction XDR', {
+            code: 'INVALID_XDR',
             status: constants_1.HTTP_STATUS.BAD_REQUEST,
-            details: {
-                message: error instanceof Error ? error.message : String(error),
-            },
+            details: { message: error instanceof Error ? error.message : String(error) },
         });
     }
     // Validate timeBounds
@@ -50,7 +48,7 @@ function rebuildWithChannel(params) {
             const maxAllowedTime = now + constants_1.TIME.MAX_TIME_BOUND_OFFSET_SECONDS;
             if (maxTime > maxAllowedTime) {
                 throw (0, relayer_sdk_1.pluginError)(`Transaction maxTime is too far in the future. Max allowed: ${constants_1.TIME.MAX_TIME_BOUND_OFFSET_SECONDS} seconds from now`, {
-                    code: "INVALID_TIME_BOUNDS",
+                    code: 'INVALID_TIME_BOUNDS',
                     status: constants_1.HTTP_STATUS.BAD_REQUEST,
                     details: { maxTime, maxAllowedTime },
                 });
@@ -62,13 +60,9 @@ function rebuildWithChannel(params) {
         const op = inputTx.operations[i];
         if (op.source && op.source !== fundAddress) {
             throw (0, relayer_sdk_1.pluginError)(`Operation ${i} has source ${op.source} but must be ${fundAddress} or omitted`, {
-                code: "INVALID_OPERATION_SOURCE",
+                code: 'INVALID_OPERATION_SOURCE',
                 status: constants_1.HTTP_STATUS.BAD_REQUEST,
-                details: {
-                    operationIndex: i,
-                    operationSource: op.source,
-                    expectedSource: fundAddress,
-                },
+                details: { operationIndex: i, operationSource: op.source, expectedSource: fundAddress },
             });
         }
     }

package/dist/plugin/config.d.ts

@@ -5,12 +5,14 @@
  */
 export interface ChannelAccountsConfig {
     fundRelayerId: string;
-    network: "testnet" | "mainnet";
+    network: 'testnet' | 'mainnet';
     lockTtlSeconds: number;
     adminSecret?: string;
     feeLimit?: number;
     feeResetPeriodMs?: number;
     apiKeyHeader: string;
+    limitedContracts: Set<string>;
+    contractCapacityRatio: number;
 }
 /**
  * Load configuration from environment variables
@@ -19,5 +21,5 @@ export declare function loadConfig(): ChannelAccountsConfig;
 /**
  * Get the network passphrase based on the configuration
  */
-export declare function getNetworkPassphrase(network: "testnet" | "mainnet"): string;
+export declare function getNetworkPassphrase(network: 'testnet' | 'mainnet'): string;
 //# sourceMappingURL=config.d.ts.map

package/dist/plugin/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/plugin/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAwDD;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAkBlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/plugin/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAoFD;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAoBlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAE3E"}