@openzeppelin/relayer-plugin-channels 0.5.0 → 0.7.0

package/dist/plugin/config.js

@@ -12,9 +12,9 @@ const relayer_sdk_1 = require("@openzeppelin/relayer-sdk");
 const constants_1 = require("./constants");
 function requireEnv(name) {
     const v = process.env[name];
-    if (!v || v.trim() === "") {
+    if (!v || v.trim() === '') {
         throw (0, relayer_sdk_1.pluginError)(`Missing required environment variable: ${name}`, {
-            code: "CONFIG_MISSING",
+            code: 'CONFIG_MISSING',
             status: constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR,
             details: { name },
         });
@@ -33,9 +33,7 @@ function parseLockTtl() {
     if (!raw)
         return constants_1.CONFIG.DEFAULT_LOCK_TTL_SECONDS;
     const n = Number(raw);
-    if (!Number.isFinite(n) ||
-        n < constants_1.CONFIG.MIN_LOCK_TTL_SECONDS ||
-        n > constants_1.CONFIG.MAX_LOCK_TTL_SECONDS) {
+    if (!Number.isFinite(n) || n < constants_1.CONFIG.MIN_LOCK_TTL_SECONDS || n > constants_1.CONFIG.MAX_LOCK_TTL_SECONDS) {
         return constants_1.CONFIG.DEFAULT_LOCK_TTL_SECONDS;
     }
     return Math.floor(n);
@@ -57,34 +55,66 @@ function parseFeeResetPeriod() {
 function parseApiKeyHeader() {
     const raw = process.env.API_KEY_HEADER;
     if (!raw)
-        return "x-api-key";
+        return 'x-api-key';
     const trimmed = raw.trim().toLowerCase();
-    return trimmed.length > 0 ? trimmed : "x-api-key";
+    return trimmed.length > 0 ? trimmed : 'x-api-key';
+}
+function parseLimitedContracts() {
+    const raw = process.env.LIMITED_CONTRACTS;
+    if (!raw)
+        return new Set();
+    const contracts = raw
+        .split(',')
+        .map((s) => s.trim().toUpperCase())
+        .filter((s) => s.length > 0);
+    // Validate each contract address
+    for (const contract of contracts) {
+        if (!stellar_sdk_1.StrKey.isValidContract(contract)) {
+            throw (0, relayer_sdk_1.pluginError)(`Invalid contract address in LIMITED_CONTRACTS: ${contract}`, {
+                code: 'CONFIG_INVALID',
+                status: constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR,
+                details: { contract },
+            });
+        }
+    }
+    return new Set(contracts);
+}
+function parseContractCapacityRatio() {
+    const raw = process.env.CONTRACT_CAPACITY_RATIO;
+    if (!raw)
+        return constants_1.CONFIG.DEFAULT_CONTRACT_CAPACITY_RATIO;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0 || n > 1) {
+        return constants_1.CONFIG.DEFAULT_CONTRACT_CAPACITY_RATIO;
+    }
+    return n;
 }
 /**
  * Load configuration from environment variables
  */
 function loadConfig() {
-    const networkRaw = requireEnv("STELLAR_NETWORK").toLowerCase();
-    if (networkRaw !== "testnet" && networkRaw !== "mainnet") {
+    const networkRaw = requireEnv('STELLAR_NETWORK').toLowerCase();
+    if (networkRaw !== 'testnet' && networkRaw !== 'mainnet') {
         throw (0, relayer_sdk_1.pluginError)('STELLAR_NETWORK must be "testnet" or "mainnet"', {
-            code: "UNSUPPORTED_NETWORK",
+            code: 'UNSUPPORTED_NETWORK',
             status: constants_1.HTTP_STATUS.BAD_REQUEST,
         });
     }
     return {
-        fundRelayerId: requireEnv("FUND_RELAYER_ID"),
+        fundRelayerId: requireEnv('FUND_RELAYER_ID'),
         network: networkRaw,
         lockTtlSeconds: parseLockTtl(),
-        adminSecret: parseOptionalString("PLUGIN_ADMIN_SECRET"),
+        adminSecret: parseOptionalString('PLUGIN_ADMIN_SECRET'),
         feeLimit: parseFeeLimit(),
         feeResetPeriodMs: parseFeeResetPeriod(),
         apiKeyHeader: parseApiKeyHeader(),
+        limitedContracts: parseLimitedContracts(),
+        contractCapacityRatio: parseContractCapacityRatio(),
     };
 }
 /**
  * Get the network passphrase based on the configuration
  */
 function getNetworkPassphrase(network) {
-    return network === "mainnet" ? stellar_sdk_1.Networks.PUBLIC : stellar_sdk_1.Networks.TESTNET;
+    return network === 'mainnet' ? stellar_sdk_1.Networks.PUBLIC : stellar_sdk_1.Networks.TESTNET;
 }

package/dist/plugin/constants.d.ts

@@ -18,6 +18,7 @@ export declare const CONFIG: {
     readonly DEFAULT_LOCK_TTL_SECONDS: 30;
     readonly MIN_LOCK_TTL_SECONDS: 3;
     readonly MAX_LOCK_TTL_SECONDS: 30;
+    readonly DEFAULT_CONTRACT_CAPACITY_RATIO: 0.8;
 };
 export declare const POOL: {
     readonly MUTEX_TTL_SECONDS: 1;
@@ -39,8 +40,6 @@ export declare const POLLING: {
     readonly TIMEOUT_MS: 25000;
 };
 export declare const FEE: {
-    readonly MIN_BASE_FEE: 205;
-    readonly MAX_BASE_FEE: 605;
     readonly NON_SOROBAN_FEE: 100000;
 };
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/plugin/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAGX,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAGX,eAAO,MAAM,IAAI;;;;;CAOP,CAAC;AAGX,eAAO,MAAM,IAAI;;CAEP,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAGX,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAEX,eAAO,MAAM,GAAG;;;;CAKN,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/plugin/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAGX,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAGX,eAAO,MAAM,IAAI;;;;;CAOP,CAAC;AAGX,eAAO,MAAM,IAAI;;CAEP,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAGX,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAEX,eAAO,MAAM,GAAG;;CAGN,CAAC"}

package/dist/plugin/constants.js

@@ -23,6 +23,7 @@ exports.CONFIG = {
     DEFAULT_LOCK_TTL_SECONDS: 30,
     MIN_LOCK_TTL_SECONDS: 3,
     MAX_LOCK_TTL_SECONDS: 30,
+    DEFAULT_CONTRACT_CAPACITY_RATIO: 0.8,
 };
 // Pool Constants
 exports.POOL = {
@@ -39,7 +40,7 @@ exports.TIME = {
 };
 // Simulation-related defaults
 exports.SIMULATION = {
-    DEFAULT_FEE: "100",
+    DEFAULT_FEE: '100',
     MIN_TIME_BOUND: 0,
     MAX_TIME_BOUND_OFFSET_SECONDS: 30,
     MAX_FUTURE_TIME_BOUND_SECONDS: 30,
@@ -50,8 +51,6 @@ exports.POLLING = {
     TIMEOUT_MS: 25000,
 };
 exports.FEE = {
-    MIN_BASE_FEE: 205,
-    MAX_BASE_FEE: 605,
     // For non-Soroban txs: 100,000 stroops (0.01 XLM) per Stellar best practice
     NON_SOROBAN_FEE: 100000,
 };

package/dist/plugin/fee-tracking.d.ts

@@ -5,7 +5,7 @@
  * Supports custom per-key limits with fallback to default.
  * Supports periodic reset of consumption.
  */
-import { PluginKVStore } from "@openzeppelin/relayer-sdk";
+import { PluginKVStore } from '@openzeppelin/relayer-sdk';
 /** KV data structure for fee consumption */
 export interface FeeData {
     consumed: number;
@@ -22,7 +22,7 @@ export interface UsageInfo {
 /** Configuration for FeeTracker */
 export interface FeeTrackerConfig {
     kv: PluginKVStore;
-    network: "testnet" | "mainnet";
+    network: 'testnet' | 'mainnet';
     apiKey: string;
     defaultLimit?: number;
     resetPeriodMs?: number;

package/dist/plugin/fee-tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fee-tracking.d.ts","sourceRoot":"","sources":["../../src/plugin/fee-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAGvE,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,aAAa,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,gBAAgB;IAUpC;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAqBxC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKnD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;;OAGG;YACW,WAAW;IASzB;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,OAAO,GAElB;CACF"}
+{"version":3,"file":"fee-tracking.d.ts","sourceRoot":"","sources":["../../src/plugin/fee-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAGvE,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,aAAa,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,MAAM,EAAE,gBAAgB;IAUpC;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAexC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKnD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC;;;OAGG;YACW,WAAW;IASzB;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,OAAO,GAElB;CACF"}

package/dist/plugin/fee-tracking.js

@@ -31,7 +31,7 @@ class FeeTracker {
         if (consumed + fee > limit) {
             const remaining = limit - consumed;
             throw (0, relayer_sdk_1.pluginError)(`Transaction fee (${fee} stroops) exceeds remaining budget (${remaining} stroops). Consumed: ${consumed}/${limit} stroops.`, {
-                code: "FEE_LIMIT_EXCEEDED",
+                code: 'FEE_LIMIT_EXCEEDED',
                 status: constants_1.HTTP_STATUS.TOO_MANY_REQUESTS,
                 details: { consumed, fee, remaining, limit },
             });
@@ -54,7 +54,7 @@ class FeeTracker {
                         periodStart: state.periodStart ?? now,
                     });
                     return true;
-                }, { ttlSec: 5, onBusy: "skip" });
+                }, { ttlSec: 5, onBusy: 'skip' });
                 if (result !== null)
                     return;
                 // Lock busy, retry with jitter
@@ -71,17 +71,12 @@ class FeeTracker {
      * Get complete usage info for management API.
      */
     async getUsageInfo() {
-        const [state, limit] = await Promise.all([
-            this.getFeeState(),
-            this.getEffectiveLimit(),
-        ]);
+        const [state, limit] = await Promise.all([this.getFeeState(), this.getEffectiveLimit()]);
         return {
             consumed: state.consumed,
             limit,
             remaining: limit !== undefined ? Math.max(0, limit - state.consumed) : undefined,
-            periodStartAt: state.periodStart
-                ? new Date(state.periodStart).toISOString()
-                : undefined,
+            periodStartAt: state.periodStart ? new Date(state.periodStart).toISOString() : undefined,
             periodEndsAt: state.periodStart && this.resetPeriodMs
                 ? new Date(state.periodStart + this.resetPeriodMs).toISOString()
                 : undefined,

package/dist/plugin/fee.d.ts

@@ -1,10 +1,21 @@
 /**
  * fee.ts
  *
- * Dynamic fee calculation for fee bump submissions.
- * - For Soroban transactions: use resourceFee + random inclusion fee
- * - For non-Soroban: use NON_SOROBAN_FEE
+ * Static fee calculation for fee bump submissions matching launchtube.
+ * - For Soroban transactions: use resourceFee + inclusion fee (BASE_FEE * 2 + 3)
+ * - For non-Soroban: use NON_SOROBAN_FEE + inclusion fee
+ * - Limited contracts (from LIMITED_CONTRACTS env) get reduced fee (BASE_FEE * 2 + 1)
  */
-import { Transaction } from "@stellar/stellar-sdk";
-export declare function calculateMaxFee(transaction: Transaction): number;
+import { Transaction, xdr } from '@stellar/stellar-sdk';
+export declare const INCLUSION_FEE_DEFAULT: number;
+export declare const INCLUSION_FEE_LIMITED: number;
+/**
+ * Extract contract ID from a HostFunction (for func+auth flow)
+ */
+export declare function getContractIdFromFunc(func: xdr.HostFunction): string | undefined;
+/**
+ * Extract contract ID from a Transaction (for XDR flow)
+ */
+export declare function getContractIdFromTransaction(transaction: Transaction): string | undefined;
+export declare function calculateMaxFee(transaction: Transaction, limitedContracts?: Set<string>): number;
 //# sourceMappingURL=fee.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/plugin/fee.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAO,MAAM,sBAAsB,CAAC;AAGxD,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAsBhE"}
+{"version":3,"file":"fee.d.ts","sourceRoot":"","sources":["../../src/plugin/fee.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,WAAW,EAAE,GAAG,EAAqB,MAAM,sBAAsB,CAAC;AAGrF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAC9D,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAE9D;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,GAAG,MAAM,GAAG,SAAS,CAUhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAYzF;AASD,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,gBAAgB,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,MAAM,CAoB3G"}

package/dist/plugin/fee.js

@@ -2,15 +2,59 @@
 /**
  * fee.ts
  *
- * Dynamic fee calculation for fee bump submissions.
- * - For Soroban transactions: use resourceFee + random inclusion fee
- * - For non-Soroban: use NON_SOROBAN_FEE
+ * Static fee calculation for fee bump submissions matching launchtube.
+ * - For Soroban transactions: use resourceFee + inclusion fee (BASE_FEE * 2 + 3)
+ * - For non-Soroban: use NON_SOROBAN_FEE + inclusion fee
+ * - Limited contracts (from LIMITED_CONTRACTS env) get reduced fee (BASE_FEE * 2 + 1)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.INCLUSION_FEE_LIMITED = exports.INCLUSION_FEE_DEFAULT = void 0;
+exports.getContractIdFromFunc = getContractIdFromFunc;
+exports.getContractIdFromTransaction = getContractIdFromTransaction;
 exports.calculateMaxFee = calculateMaxFee;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const constants_1 = require("./constants");
-function calculateMaxFee(transaction) {
+exports.INCLUSION_FEE_DEFAULT = Number(stellar_sdk_1.BASE_FEE) * 2 + 3;
+exports.INCLUSION_FEE_LIMITED = Number(stellar_sdk_1.BASE_FEE) * 2 + 1;
+/**
+ * Extract contract ID from a HostFunction (for func+auth flow)
+ */
+function getContractIdFromFunc(func) {
+    try {
+        if (func.switch() !== stellar_sdk_1.xdr.HostFunctionType.hostFunctionTypeInvokeContract()) {
+            return undefined;
+        }
+        const invokeContract = func.invokeContract();
+        return stellar_sdk_1.StrKey.encodeContract(invokeContract.contractAddress().contractId());
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extract contract ID from a Transaction (for XDR flow)
+ */
+function getContractIdFromTransaction(transaction) {
+    try {
+        if (transaction.operations.length !== 1)
+            return undefined;
+        const op = transaction.operations[0];
+        if (op.type !== 'invokeHostFunction')
+            return undefined;
+        const invokeOp = op;
+        return getContractIdFromFunc(invokeOp.func);
+    }
+    catch {
+        return undefined;
+    }
+}
+function getInclusionFee(contractId, limitedContracts) {
+    if (contractId && limitedContracts.has(contractId)) {
+        return exports.INCLUSION_FEE_LIMITED;
+    }
+    return exports.INCLUSION_FEE_DEFAULT;
+}
+function calculateMaxFee(transaction, limitedContracts = new Set()) {
     const envelope = transaction.toEnvelope();
     let resourceFee = 0n;
     if (envelope.switch() === stellar_sdk_1.xdr.EnvelopeType.envelopeTypeTx()) {
@@ -19,15 +63,9 @@ function calculateMaxFee(transaction) {
             resourceFee = sorobanData.resourceFee().toBigInt();
         }
     }
-    const baseInclusion = getRandomInt(constants_1.FEE.MIN_BASE_FEE, constants_1.FEE.MAX_BASE_FEE);
-    const fee = resourceFee > 0n
-        ? resourceFee + BigInt(baseInclusion)
-        : BigInt(constants_1.FEE.NON_SOROBAN_FEE + baseInclusion);
-    console.debug(`[channels] Calculated max_fee: ${Number(fee)} stroops (resourceFee: ${resourceFee}, baseInclusion: ${baseInclusion})`);
+    const contractId = getContractIdFromTransaction(transaction);
+    const inclusionFee = getInclusionFee(contractId, limitedContracts);
+    const fee = resourceFee > 0n ? resourceFee + BigInt(inclusionFee) : BigInt(constants_1.FEE.NON_SOROBAN_FEE + inclusionFee);
+    console.debug(`[channels] Calculated max_fee: ${Number(fee)} stroops (resourceFee: ${resourceFee}, inclusionFee: ${inclusionFee})`);
     return Number(fee);
 }
-function getRandomInt(min, max) {
-    const mn = Math.ceil(min);
-    const mx = Math.floor(max);
-    return Math.floor(Math.random() * (mx - mn + 1)) + mn;
-}

package/dist/plugin/handler.d.ts

@@ -4,7 +4,16 @@
  * Main handler for the channel accounts plugin.
  * Orchestrates the transaction processing pipeline using channel accounts with fee bumping.
  */
-import { PluginContext } from "@openzeppelin/relayer-sdk";
+import { PluginContext } from '@openzeppelin/relayer-sdk';
+import { Transaction, xdr } from '@stellar/stellar-sdk';
+/**
+ * Extracts func and auth from an unsigned Soroban transaction.
+ * Returns null if the transaction is not a single invokeHostFunction operation.
+ */
+export declare function extractFuncAuthFromUnsignedXdr(tx: Transaction): {
+    func: xdr.HostFunction;
+    auth: xdr.SorobanAuthorizationEntry[];
+} | null;
 /**
  * Main plugin handler exported for OpenZeppelin Relayer
  */

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/plugin/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAqNvE;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAGlE"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/plugin/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AASvE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAWxD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,WAAW,GACd;IAAE,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,yBAAyB,EAAE,CAAA;CAAE,GAAG,IAAI,CAkB1E;AAwND;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAElE"}

package/dist/plugin/handler.js

@@ -6,6 +6,7 @@
  * Orchestrates the transaction processing pipeline using channel accounts with fee bumping.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFuncAuthFromUnsignedXdr = extractFuncAuthFromUnsignedXdr;
 exports.handler = handler;
 const relayer_sdk_1 = require("@openzeppelin/relayer-sdk");
 const pool_1 = require("./pool");
@@ -23,41 +24,77 @@ function getApiKey(headers, headerName) {
     const values = headers[headerName];
     return values?.[0]?.trim() || undefined;
 }
-async function handleXdrSubmit(xdrStr, fundRelayer, network, networkPassphrase, api, tracker) {
+/**
+ * Extracts func and auth from an unsigned Soroban transaction.
+ * Returns null if the transaction is not a single invokeHostFunction operation.
+ */
+function extractFuncAuthFromUnsignedXdr(tx) {
+    const ops = tx.operations;
+    if (ops.length !== 1) {
+        return null;
+    }
+    const envelope = tx.toEnvelope();
+    const rawOp = envelope.v1().tx().operations()[0].body();
+    if (rawOp.switch() !== stellar_sdk_1.xdr.OperationType.invokeHostFunction()) {
+        return null;
+    }
+    const invokeHostFn = rawOp.invokeHostFunctionOp();
+    return {
+        func: invokeHostFn.hostFunction(),
+        auth: invokeHostFn.auth(),
+    };
+}
+async function handleXdrSubmit(xdrStr, fundRelayer, fundAddress, network, networkPassphrase, api, pool, acquireOptions, tracker) {
     const tx = new stellar_sdk_1.Transaction(xdrStr, networkPassphrase);
+    // Unsigned XDR: extract func+auth and route through channel path
+    if (tx.signatures.length === 0) {
+        const extracted = extractFuncAuthFromUnsignedXdr(tx);
+        if (!extracted) {
+            throw (0, relayer_sdk_1.pluginError)('Unsigned XDR must contain exactly one invokeHostFunction operation', {
+                code: 'INVALID_UNSIGNED_XDR',
+                status: constants_1.HTTP_STATUS.BAD_REQUEST,
+                details: {
+                    operationCount: tx.operations.length,
+                    operationType: tx.operations[0]?.type,
+                },
+            });
+        }
+        console.log(`[channels] Unsigned XDR detected, extracting func+auth and routing through channel path`);
+        // Update acquireOptions with contractId from extracted func
+        const contractId = (0, fee_1.getContractIdFromFunc)(extracted.func);
+        const updatedOptions = { ...acquireOptions, contractId };
+        return handleFuncAuthSubmit(extracted.func, extracted.auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, updatedOptions, tracker);
+    }
     const validated = (0, tx_1.validateExistingTransactionForSubmitOnly)(tx);
-    const maxFee = (0, fee_1.calculateMaxFee)(validated);
+    const maxFee = (0, fee_1.calculateMaxFee)(validated, acquireOptions.limitedContracts);
     await tracker?.checkBudget(maxFee);
     return (0, submit_1.submitWithFeeBumpAndWait)(fundRelayer, validated.toXDR(), network, maxFee, api, tracker);
 }
-async function handleFuncAuthSubmit(func, auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, tracker) {
+async function handleFuncAuthSubmit(func, auth, api, pool, fundRelayer, fundAddress, network, networkPassphrase, acquireOptions, tracker) {
     let poolLock;
     try {
-        poolLock = await pool.acquire();
+        poolLock = await pool.acquire(acquireOptions);
         const channelRelayer = api.useRelayer(poolLock.relayerId);
         const channelInfo = await channelRelayer.getRelayer();
         console.log(`[channels] Acquired channel: ${poolLock.relayerId}`);
         if (!channelInfo || !channelInfo.address) {
-            throw (0, relayer_sdk_1.pluginError)("Channel relayer not found", {
-                code: "RELAYER_UNAVAILABLE",
+            throw (0, relayer_sdk_1.pluginError)('Channel relayer not found', {
+                code: 'RELAYER_UNAVAILABLE',
                 status: constants_1.HTTP_STATUS.BAD_GATEWAY,
                 details: { relayerId: poolLock.relayerId },
             });
         }
         const channelStatus = await channelRelayer.getRelayerStatus();
-        if (channelStatus.network_type !== "stellar") {
-            throw (0, relayer_sdk_1.pluginError)("Channel relayer network type must be stellar", {
-                code: "UNSUPPORTED_NETWORK",
+        if (channelStatus.network_type !== 'stellar') {
+            throw (0, relayer_sdk_1.pluginError)('Channel relayer network type must be stellar', {
+                code: 'UNSUPPORTED_NETWORK',
                 status: constants_1.HTTP_STATUS.BAD_REQUEST,
-                details: {
-                    network_type: channelStatus.network_type,
-                    relayerId: poolLock.relayerId,
-                },
+                details: { network_type: channelStatus.network_type, relayerId: poolLock.relayerId },
             });
         }
         const built = await (0, simulation_1.simulateAndBuildWithChannel)(func, auth, { address: channelInfo.address, sequence: channelStatus.sequence_number }, fundAddress, fundRelayer, networkPassphrase);
         const signedTx = await (0, submit_1.signWithChannelAndFund)(built, channelRelayer, fundRelayer, channelInfo.address, fundAddress, networkPassphrase);
-        const maxFee = (0, fee_1.calculateMaxFee)(signedTx);
+        const maxFee = (0, fee_1.calculateMaxFee)(signedTx, acquireOptions.limitedContracts);
         await tracker?.checkBudget(maxFee);
         return await (0, submit_1.submitWithFeeBumpAndWait)(fundRelayer, signedTx.toXDR(), network, maxFee, api, tracker);
     }
@@ -82,8 +119,8 @@ async function channelAccounts(context) {
     const apiKey = getApiKey(headers, config.apiKeyHeader);
     // If default limit is set, require API key
     if (config.feeLimit !== undefined && !apiKey) {
-        throw (0, relayer_sdk_1.pluginError)("API key required", {
-            code: "API_KEY_REQUIRED",
+        throw (0, relayer_sdk_1.pluginError)('API key required', {
+            code: 'API_KEY_REQUIRED',
             status: constants_1.HTTP_STATUS.BAD_REQUEST,
         });
     }
@@ -97,47 +134,45 @@ async function channelAccounts(context) {
             resetPeriodMs: config.feeResetPeriodMs,
         });
     }
-    try {
-        // 1. Validate and parse request (xdr OR func+auth)
-        const request = (0, validation_1.validateAndParseRequest)(params);
-        console.debug(`[channels] Request type: ${request.type}, auth entries: ${request.type === "func-auth" ? request.auth.length : "N/A"}`);
-        // 2. Get fund relayer
-        const fundRelayer = api.useRelayer(config.fundRelayerId);
-        const fundInfo = await fundRelayer.getRelayer();
-        if (!fundInfo || !fundInfo.address) {
-            throw (0, relayer_sdk_1.pluginError)("Fund relayer not found", {
-                code: "RELAYER_UNAVAILABLE",
-                status: constants_1.HTTP_STATUS.BAD_GATEWAY,
-                details: { relayerId: config.fundRelayerId },
-            });
-        }
-        const fundStatus = await fundRelayer.getRelayerStatus();
-        if (fundStatus.network_type !== "stellar") {
-            throw (0, relayer_sdk_1.pluginError)("Fund relayer network type must be stellar", {
-                code: "UNSUPPORTED_NETWORK",
-                status: constants_1.HTTP_STATUS.BAD_REQUEST,
-                details: {
-                    network_type: fundStatus.network_type,
-                    relayerId: config.fundRelayerId,
-                },
-            });
-        }
-        // 3. Branch by request type
-        if (request.type === "xdr") {
-            console.log(`[channels] Flow: XDR submit-only`);
-            return await handleXdrSubmit(request.xdr, fundRelayer, config.network, networkPassphrase, api, tracker);
-        }
-        console.log(`[channels] Flow: func+auth with channel account`);
-        return await handleFuncAuthSubmit(request.func, request.auth, api, pool, fundRelayer, fundInfo.address, config.network, networkPassphrase, tracker);
+    // 1. Validate and parse request (xdr OR func+auth)
+    const request = (0, validation_1.validateAndParseRequest)(params);
+    console.debug(`[channels] Request type: ${request.type}, auth entries: ${request.type === 'func-auth' ? request.auth.length : 'N/A'}`);
+    // 2. Get fund relayer
+    const fundRelayer = api.useRelayer(config.fundRelayerId);
+    const fundInfo = await fundRelayer.getRelayer();
+    if (!fundInfo || !fundInfo.address) {
+        throw (0, relayer_sdk_1.pluginError)('Fund relayer not found', {
+            code: 'RELAYER_UNAVAILABLE',
+            status: constants_1.HTTP_STATUS.BAD_GATEWAY,
+            details: { relayerId: config.fundRelayerId },
+        });
     }
-    finally {
-        // Nothing to cleanup here; func-auth path releases locks internally
+    if (fundInfo.network_type !== 'stellar') {
+        throw (0, relayer_sdk_1.pluginError)('Fund relayer network type must be stellar', {
+            code: 'UNSUPPORTED_NETWORK',
+            status: constants_1.HTTP_STATUS.BAD_REQUEST,
+            details: { network_type: fundInfo.network_type, relayerId: config.fundRelayerId },
+        });
+    }
+    // 3. Build acquire options for contract capacity limits
+    const acquireOptions = {
+        limitedContracts: config.limitedContracts,
+        capacityRatio: config.contractCapacityRatio,
+    };
+    // 4. Branch by request type
+    if (request.type === 'xdr') {
+        console.log(`[channels] Flow: XDR submit-only`);
+        return await handleXdrSubmit(request.xdr, fundRelayer, fundInfo.address, config.network, networkPassphrase, api, pool, acquireOptions, tracker);
     }
+    // Extract contractId for func+auth flow
+    const contractId = (0, fee_1.getContractIdFromFunc)(request.func);
+    const funcAcquireOptions = { ...acquireOptions, contractId };
+    console.log(`[channels] Flow: func+auth with channel account`);
+    return await handleFuncAuthSubmit(request.func, request.auth, api, pool, fundRelayer, fundInfo.address, config.network, networkPassphrase, funcAcquireOptions, tracker);
 }
 /**
  * Main plugin handler exported for OpenZeppelin Relayer
  */
 async function handler(context) {
-    const result = await channelAccounts(context);
-    return result;
+    return channelAccounts(context);
 }

package/dist/plugin/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Exports the main handler function for the Channels plugin
  */
-export { handler } from "./handler";
+export { handler } from './handler';
 //# sourceMappingURL=index.d.ts.map

package/dist/plugin/management.d.ts

@@ -9,7 +9,7 @@
  * - setFeeLimit: sets custom limit for an API key
  * - deleteFeeLimit: removes custom limit for an API key
  */
-import type { PluginContext } from "@openzeppelin/relayer-sdk";
+import type { PluginContext } from '@openzeppelin/relayer-sdk';
 export declare function isManagementRequest(params: any): boolean;
 export declare function handleManagement(context: PluginContext): Promise<any>;
 //# sourceMappingURL=management.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/plugin/management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,2BAA2B,CAAC;AAM9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAOxD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CA8C3E"}
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/plugin/management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,2BAA2B,CAAC;AAM9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAIxD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAkC3E"}