@agent-score/commerce 2.0.1 → 2.1.0

package/dist/{x402_server-hgQzWQwB.d.mts → x402_server-Ciz2mls2.d.mts}

@@ -78,4 +78,4 @@ interface BuildX402AcceptsForOptions {
  */
 declare function buildX402AcceptsFor402(server: X402Server, opts: BuildX402AcceptsForOptions): Promise<unknown[]>;
 
-export { type BuildX402AcceptsForOptions as B, type CreateX402ServerOptions as C, type X402Server as X, type X402FacilitatorChoice as a, type X402SymbolicRail as b, buildX402AcceptsFor402 as c, createX402Server as d };
+export { type BuildX402AcceptsForOptions as B, type CreateX402ServerOptions as C, type X402FacilitatorChoice as X, type X402Server as a, type X402SymbolicRail as b, buildX402AcceptsFor402 as c, createX402Server as d };

package/dist/{x402_server-hgQzWQwB.d.ts → x402_server-Ciz2mls2.d.ts}

@@ -78,4 +78,4 @@ interface BuildX402AcceptsForOptions {
  */
 declare function buildX402AcceptsFor402(server: X402Server, opts: BuildX402AcceptsForOptions): Promise<unknown[]>;
 
-export { type BuildX402AcceptsForOptions as B, type CreateX402ServerOptions as C, type X402Server as X, type X402FacilitatorChoice as a, type X402SymbolicRail as b, buildX402AcceptsFor402 as c, createX402Server as d };
+export { type BuildX402AcceptsForOptions as B, type CreateX402ServerOptions as C, type X402FacilitatorChoice as X, type X402Server as a, type X402SymbolicRail as b, buildX402AcceptsFor402 as c, createX402Server as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-score/commerce",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Agent commerce SDK — identity middleware (Hono, Express, Fastify, Next.js, Web Fetch) + payment helpers + 402 builders + discovery + Stripe multichain. The full merchant-side toolkit for AgentScore-powered agent commerce.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -70,6 +70,31 @@
       "types": "./dist/api/index.d.ts",
       "import": "./dist/api/index.mjs",
       "require": "./dist/api/index.js"
+    },
+    "./middleware/hono": {
+      "types": "./dist/middleware/hono.d.ts",
+      "import": "./dist/middleware/hono.mjs",
+      "require": "./dist/middleware/hono.js"
+    },
+    "./middleware/express": {
+      "types": "./dist/middleware/express.d.ts",
+      "import": "./dist/middleware/express.mjs",
+      "require": "./dist/middleware/express.js"
+    },
+    "./middleware/fastify": {
+      "types": "./dist/middleware/fastify.d.ts",
+      "import": "./dist/middleware/fastify.mjs",
+      "require": "./dist/middleware/fastify.js"
+    },
+    "./middleware/nextjs": {
+      "types": "./dist/middleware/nextjs.d.ts",
+      "import": "./dist/middleware/nextjs.mjs",
+      "require": "./dist/middleware/nextjs.js"
+    },
+    "./middleware/web": {
+      "types": "./dist/middleware/web.d.ts",
+      "import": "./dist/middleware/web.mjs",
+      "require": "./dist/middleware/web.js"
     }
   },
   "files": [
@@ -126,7 +151,14 @@
   },
   "overrides": {
     "axios": "^1.15.0",
-    "fast-uri": "^3.1.1"
+    "fast-uri": "^3.1.1",
+    "minimatch@^3.0.0": {
+      "brace-expansion": "1.1.12"
+    },
+    "minimatch@^10.0.0": {
+      "brace-expansion": "5.0.6"
+    },
+    "ws": "^8.20.1"
   },
   "peerDependencies": {
     "@solana/kit": ">=6.5.0",
@@ -134,6 +166,7 @@
     "express": ">=4.0.0",
     "fastify": ">=4.0.0",
     "hono": ">=4.0.0",
+    "ioredis": ">=5.0.0",
     "jose": ">=6.0.0",
     "stripe": ">=17.0.0"
   },
@@ -153,6 +186,9 @@
     "hono": {
       "optional": true
     },
+    "ioredis": {
+      "optional": true
+    },
     "jose": {
       "optional": true
     },
@@ -161,6 +197,7 @@
     }
   },
   "devDependencies": {
+    "@a2a-js/sdk": "^0.3.13",
     "@coinbase/x402": "^2.1.0",
     "@eslint/js": "^9.39.4",
     "@solana/kit": "^6.9.0",
@@ -177,11 +214,12 @@
     "eslint-plugin-unused-imports": "^4.4.1",
     "express": "^5.2.1",
     "fastify": "^5.8.5",
-    "hono": "^4.12.18",
+    "hono": "^4.12.19",
+    "ioredis": "^5.10.1",
     "jose": "^6.2.3",
-    "knip": "^6.13.1",
+    "knip": "^6.14.1",
     "lefthook": "^2.1.6",
-    "mppx": "^0.6.20",
+    "mppx": "^0.6.25",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.59.3",

package/dist/_response-BFYN3b6i.d.mts

@@ -1,142 +0,0 @@
-import { VerifyWalletSignerResult, DenialReason } from './core.mjs';
-
-/**
- * Universal denial helpers shared across every adapter.
- *
- * What lives here:
- *   - `FIXABLE_DENIAL_REASONS` / `isFixableDenial` — classifier for compliance reasons that can
- *     be resolved by re-completing KYC (vs sanctions / age failures which are permanent).
- *   - `denialReasonStatus` — picks the right HTTP status code per denial code (401 for credential
- *     problems, 503 for transient API errors, 403 for everything else).
- *   - `buildSignerMismatchBody` — produces the standard 403 body for a non-pass signer_match
- *     verdict (read via `getSignerVerdict`).
- *   - `buildContactSupportNextSteps` — standard `next_steps.action: "contact_support"` shape for
- *     unfixable compliance denials.
- *   - `verificationAgentInstructions` — the canned `agent_instructions` block for
- *     identity-verification 403s. Vendors can override individual fields.
- *
- * Adapters use `denialReasonStatus` inside their default `onDenied` so vendors get the right
- * status code for free. The body builders are exported from each adapter so vendors who write
- * a custom `onDenied` can compose them without copy-paste.
- */
-
-/**
- * Compliance denial reasons that can be resolved by re-completing KYC. The API emits these
- * when KYC is missing/pending/failed; the user can re-verify and retry.
- *
- * `jurisdiction_restricted` is NOT in this set — the API only emits it AFTER KYC is verified,
- * meaning the user's KYC'd country is in the merchant's blocked list (or absent from the
- * allowed list). Re-doing KYC won't change the country, so it's permanent. Same shape as
- * `sanctions_flagged` and `age_insufficient` — surface contact_support, don't waste a
- * /v1/sessions mint.
- */
-declare const FIXABLE_DENIAL_REASONS: ReadonlySet<string>;
-/**
- * Returns true when a `wallet_not_trusted` denial's reasons are all fixable via KYC
- * re-verification. False when any reason is permanent (sanctions, age, jurisdiction_restricted).
- *
- * Empty reasons returns false — without a known reason we can't promise a fix, so default to
- * the bare denial path (vendors can override via custom onDenied if they want different
- * behavior on empty reasons).
- */
-declare function isFixableDenial(reasons: readonly string[] | undefined): boolean;
-/**
- * The right HTTP status code for a denial. `defaultOnDenied` in every adapter uses this so
- * vendors get correct status codes without writing per-code branches.
- *
- *   - 401 for credential problems the agent can recover from (`token_expired`, `invalid_credential`)
- *   - 503 for transient `api_error`
- *   - 403 for everything else (identity required, compliance fail, signer mismatch, etc.)
- */
-declare function denialReasonStatus(reason: DenialReason): 401 | 403 | 503;
-/**
- * Standard 403 body for a non-pass signer-match verdict. Returns null for `pass` so vendors
- * can call it unconditionally:
- *
- *   const verdict = getSignerVerdict(c);
- *   if (verdict?.signer_match) {
- *     const mismatchBody = buildSignerMismatchBody({ result: verdict.signer_match });
- *     if (mismatchBody) return c.json(mismatchBody, 403);
- *   }
- *
- * Body shape mirrors the gate's denial bodies: top-level error.code, all signer-match fields
- * (`claimed_operator`, `actual_signer_operator`, `expected_signer`, `actual_signer`,
- * `linked_wallets`), plus a `next_steps` action describing the recovery path.
- */
-declare function buildSignerMismatchBody({ result, userMessage, learnMoreUrl, }: {
-    /** Projected signer_match verdict (from `getSignerVerdict(ctx).signer_match`). Only non-pass
-     *  kinds produce a body. */
-    result: VerifyWalletSignerResult;
-    /** Optional override for the human-facing `next_steps.user_message`. */
-    userMessage?: string;
-    /** Optional override for `next_steps.learn_more_url`. Default: AgentScore agent-identity guide. */
-    learnMoreUrl?: string;
-}): Record<string, unknown> | null;
-/**
- * Standard `next_steps` block for unfixable compliance denials (sanctions, age, etc.). Vendors
- * spread this into a 403 body alongside the usual `error`/`reasons` fields.
- *
- *   return c.json({
- *     error: { code: 'compliance_denied', message: '...' },
- *     reasons,
- *     next_steps: buildContactSupportNextSteps('support@example.com'),
- *   }, 403);
- */
-declare function buildContactSupportNextSteps(supportEmail: string, message?: string): {
-    action: 'contact_support';
-    support_email: string;
-    user_message: string;
-};
-/**
- * The canonical `agent_instructions` block for identity-verification 403s. Tells the agent how to
- * present the verify_url, poll for the operator_token, and retry the original request. Universal
- * across every AgentScore-gated merchant — overrides let vendors add merchant-specific steps
- * (e.g. "include order_id when retrying").
- */
-declare function verificationAgentInstructions({ userAction, retryStep, extraSteps, pollIntervalSeconds, timeoutSeconds, orderTtl, extra, }?: {
-    /** Override the user-facing message. */
-    userAction?: string;
-    /** Replace the generic "Retry the original merchant request..." step with a merchant-specific
-     *  one (e.g. "Retry POST /purchase with X-Operator-Token AND include order_id..."). When set,
-     *  this REPLACES baseSteps[4] rather than appending — use it instead of `extraSteps[0]` when
-     *  your retry instruction is a refinement of the canonical retry, not an additional step. */
-    retryStep?: string;
-    /** Append additional steps after the retry step. Use this for genuinely additional steps
-     *  (e.g. "After payment the same call returns 200 with the order"), not for re-stating the
-     *  retry — use `retryStep` for that. */
-    extraSteps?: string[];
-    /** Override the poll cadence. Default 5 seconds. */
-    pollIntervalSeconds?: number;
-    /** Override how long the agent should keep polling. Default 3600 seconds (1 hour). */
-    timeoutSeconds?: number;
-    /** Optional `order_ttl` note describing how long pending orders survive. */
-    orderTtl?: string;
-    /** Arbitrary additional fields merged into the instructions object. */
-    extra?: Record<string, unknown>;
-}): {
-    action: 'poll_for_credential';
-    user_action: string;
-    steps: string[];
-    poll_interval_seconds: number;
-    poll_secret_header: 'X-Poll-Secret';
-    retry_token_header: 'X-Operator-Token';
-    timeout_seconds: number;
-    order_ttl?: string;
-    [key: string]: unknown;
-};
-
-/**
- * Shared DenialReason → response body serialization for all adapters.
- *
- * Keeps Hono / Express / Fastify / Web / Next.js defaults aligned — a field added
- * here shows up in every adapter's 403 body automatically, and there's one place
- * to test the marshaling.
- *
- * Body shape: `{ error: { code, message }, ... }` — matches the canonical AgentScore
- * error envelope so downstream agents see one consistent `error.code` +
- * `error.message` pair regardless of which layer produced the denial.
- */
-
-declare function denialReasonToBody(reason: DenialReason): Record<string, unknown>;
-
-export { FIXABLE_DENIAL_REASONS as F, buildSignerMismatchBody as a, buildContactSupportNextSteps as b, denialReasonToBody as c, denialReasonStatus as d, isFixableDenial as i, verificationAgentInstructions as v };

package/dist/_response-_iPD5AIj.d.ts

@@ -1,142 +0,0 @@
-import { VerifyWalletSignerResult, DenialReason } from './core.js';
-
-/**
- * Universal denial helpers shared across every adapter.
- *
- * What lives here:
- *   - `FIXABLE_DENIAL_REASONS` / `isFixableDenial` — classifier for compliance reasons that can
- *     be resolved by re-completing KYC (vs sanctions / age failures which are permanent).
- *   - `denialReasonStatus` — picks the right HTTP status code per denial code (401 for credential
- *     problems, 503 for transient API errors, 403 for everything else).
- *   - `buildSignerMismatchBody` — produces the standard 403 body for a non-pass signer_match
- *     verdict (read via `getSignerVerdict`).
- *   - `buildContactSupportNextSteps` — standard `next_steps.action: "contact_support"` shape for
- *     unfixable compliance denials.
- *   - `verificationAgentInstructions` — the canned `agent_instructions` block for
- *     identity-verification 403s. Vendors can override individual fields.
- *
- * Adapters use `denialReasonStatus` inside their default `onDenied` so vendors get the right
- * status code for free. The body builders are exported from each adapter so vendors who write
- * a custom `onDenied` can compose them without copy-paste.
- */
-
-/**
- * Compliance denial reasons that can be resolved by re-completing KYC. The API emits these
- * when KYC is missing/pending/failed; the user can re-verify and retry.
- *
- * `jurisdiction_restricted` is NOT in this set — the API only emits it AFTER KYC is verified,
- * meaning the user's KYC'd country is in the merchant's blocked list (or absent from the
- * allowed list). Re-doing KYC won't change the country, so it's permanent. Same shape as
- * `sanctions_flagged` and `age_insufficient` — surface contact_support, don't waste a
- * /v1/sessions mint.
- */
-declare const FIXABLE_DENIAL_REASONS: ReadonlySet<string>;
-/**
- * Returns true when a `wallet_not_trusted` denial's reasons are all fixable via KYC
- * re-verification. False when any reason is permanent (sanctions, age, jurisdiction_restricted).
- *
- * Empty reasons returns false — without a known reason we can't promise a fix, so default to
- * the bare denial path (vendors can override via custom onDenied if they want different
- * behavior on empty reasons).
- */
-declare function isFixableDenial(reasons: readonly string[] | undefined): boolean;
-/**
- * The right HTTP status code for a denial. `defaultOnDenied` in every adapter uses this so
- * vendors get correct status codes without writing per-code branches.
- *
- *   - 401 for credential problems the agent can recover from (`token_expired`, `invalid_credential`)
- *   - 503 for transient `api_error`
- *   - 403 for everything else (identity required, compliance fail, signer mismatch, etc.)
- */
-declare function denialReasonStatus(reason: DenialReason): 401 | 403 | 503;
-/**
- * Standard 403 body for a non-pass signer-match verdict. Returns null for `pass` so vendors
- * can call it unconditionally:
- *
- *   const verdict = getSignerVerdict(c);
- *   if (verdict?.signer_match) {
- *     const mismatchBody = buildSignerMismatchBody({ result: verdict.signer_match });
- *     if (mismatchBody) return c.json(mismatchBody, 403);
- *   }
- *
- * Body shape mirrors the gate's denial bodies: top-level error.code, all signer-match fields
- * (`claimed_operator`, `actual_signer_operator`, `expected_signer`, `actual_signer`,
- * `linked_wallets`), plus a `next_steps` action describing the recovery path.
- */
-declare function buildSignerMismatchBody({ result, userMessage, learnMoreUrl, }: {
-    /** Projected signer_match verdict (from `getSignerVerdict(ctx).signer_match`). Only non-pass
-     *  kinds produce a body. */
-    result: VerifyWalletSignerResult;
-    /** Optional override for the human-facing `next_steps.user_message`. */
-    userMessage?: string;
-    /** Optional override for `next_steps.learn_more_url`. Default: AgentScore agent-identity guide. */
-    learnMoreUrl?: string;
-}): Record<string, unknown> | null;
-/**
- * Standard `next_steps` block for unfixable compliance denials (sanctions, age, etc.). Vendors
- * spread this into a 403 body alongside the usual `error`/`reasons` fields.
- *
- *   return c.json({
- *     error: { code: 'compliance_denied', message: '...' },
- *     reasons,
- *     next_steps: buildContactSupportNextSteps('support@example.com'),
- *   }, 403);
- */
-declare function buildContactSupportNextSteps(supportEmail: string, message?: string): {
-    action: 'contact_support';
-    support_email: string;
-    user_message: string;
-};
-/**
- * The canonical `agent_instructions` block for identity-verification 403s. Tells the agent how to
- * present the verify_url, poll for the operator_token, and retry the original request. Universal
- * across every AgentScore-gated merchant — overrides let vendors add merchant-specific steps
- * (e.g. "include order_id when retrying").
- */
-declare function verificationAgentInstructions({ userAction, retryStep, extraSteps, pollIntervalSeconds, timeoutSeconds, orderTtl, extra, }?: {
-    /** Override the user-facing message. */
-    userAction?: string;
-    /** Replace the generic "Retry the original merchant request..." step with a merchant-specific
-     *  one (e.g. "Retry POST /purchase with X-Operator-Token AND include order_id..."). When set,
-     *  this REPLACES baseSteps[4] rather than appending — use it instead of `extraSteps[0]` when
-     *  your retry instruction is a refinement of the canonical retry, not an additional step. */
-    retryStep?: string;
-    /** Append additional steps after the retry step. Use this for genuinely additional steps
-     *  (e.g. "After payment the same call returns 200 with the order"), not for re-stating the
-     *  retry — use `retryStep` for that. */
-    extraSteps?: string[];
-    /** Override the poll cadence. Default 5 seconds. */
-    pollIntervalSeconds?: number;
-    /** Override how long the agent should keep polling. Default 3600 seconds (1 hour). */
-    timeoutSeconds?: number;
-    /** Optional `order_ttl` note describing how long pending orders survive. */
-    orderTtl?: string;
-    /** Arbitrary additional fields merged into the instructions object. */
-    extra?: Record<string, unknown>;
-}): {
-    action: 'poll_for_credential';
-    user_action: string;
-    steps: string[];
-    poll_interval_seconds: number;
-    poll_secret_header: 'X-Poll-Secret';
-    retry_token_header: 'X-Operator-Token';
-    timeout_seconds: number;
-    order_ttl?: string;
-    [key: string]: unknown;
-};
-
-/**
- * Shared DenialReason → response body serialization for all adapters.
- *
- * Keeps Hono / Express / Fastify / Web / Next.js defaults aligned — a field added
- * here shows up in every adapter's 403 body automatically, and there's one place
- * to test the marshaling.
- *
- * Body shape: `{ error: { code, message }, ... }` — matches the canonical AgentScore
- * error envelope so downstream agents see one consistent `error.code` +
- * `error.message` pair regardless of which layer produced the denial.
- */
-
-declare function denialReasonToBody(reason: DenialReason): Record<string, unknown>;
-
-export { FIXABLE_DENIAL_REASONS as F, buildSignerMismatchBody as a, buildContactSupportNextSteps as b, denialReasonToBody as c, denialReasonStatus as d, isFixableDenial as i, verificationAgentInstructions as v };

package/dist/solana-Cds87OTu.d.mts

@@ -1,67 +0,0 @@
-/**
- * USD ↔ atomic-unit conversion for token amounts.
- *
- * `usdToAtomic(usd, { decimals: 6 })` returns the bigint atomic value of a USD
- * amount for a token with `decimals` places of precision (USDC is 6). String
- * parsing + bigint arithmetic so the result is exact; ROUND_HALF_UP at the
- * rounding boundary matches the cross-language Python sibling.
- *
- * Rejects negative, NaN, infinite, and unparseable inputs. Fixed-notation only;
- * scientific notation (e.g. `"1e6"`) is not parsed (mirrors the locked cross-
- * language fixture corpus, which uses fixed notation exclusively).
- */
-/**
- * Convert a USD amount to atomic units for a token with `decimals` places.
- *
- * @param usd USD amount. Strings (`"1.23"`) and `number`s (`1.23`) are accepted.
- *   `number` is converted via `String(usd)` before parsing, so JS float precision
- *   limits apply when the float can't represent the value exactly.
- * @param opts.decimals Number of decimal places in the atomic unit (6 for USDC,
- *   18 for ETH, etc.). Must be a non-negative integer.
- *
- * @returns Integer atomic units as a `bigint`. `"1.23"` with `decimals: 6`
- *   returns `1_230_000n`.
- *
- * @throws RangeError when `usd` is negative, NaN, infinite, or `decimals` is
- *   not a non-negative integer.
- * @throws SyntaxError when `usd` cannot be parsed as a fixed-notation decimal.
- */
-declare function usdToAtomic(usd: string | number, opts: {
-    decimals: number;
-}): bigint;
-/**
- * Format an integer cent amount as a fixed-2-decimal USD string.
- *
- * `formatUsdCents(500)` returns `"5.00"`. Negative values are formatted with a
- * leading minus. Use everywhere a merchant emits `(cents / 100).toFixed(2)`;
- * consistent formatting across catalog rows, order responses, and 402 bodies
- * prevents agent-side string-comparison flakiness.
- */
-declare function formatUsdCents(cents: number): string;
-
-/**
- * Solana MPP fee-payer signer loader.
- *
- * Buyers paying via Solana MPP USDC don't typically carry SOL for transaction
- * fees, so merchants commonly co-sign the buyer's `solana/charge` tx as the
- * fee payer (~5000 lamports per tx; negligible vs the USDC value moved).
- *
- * `loadSolanaFeePayer({ privateKey })` accepts a Solana keypair in any of the
- * three forms agents commonly export it as:
- *
- *   - **base58** (Phantom export format) — 64-byte secret+public, or 32-byte
- *     secret-only
- *   - **hex** — 128-char string (64 bytes hex: 32-byte secret + 32-byte public)
- *
- * Returns a `KeyPairSigner` from `@solana/kit` ready to pass as the `signer`
- * field on a `SolanaMppRailSpec`. Returns `undefined` when `privateKey` is
- * empty / absent (so consumers can use `process.env.X` directly without
- * null-checks).
- *
- * Requires the `@solana/kit` peer dependency.
- */
-declare function loadSolanaFeePayer(opts: {
-    privateKey: string | undefined;
-}): Promise<unknown | undefined>;
-
-export { formatUsdCents as f, loadSolanaFeePayer as l, usdToAtomic as u };

package/dist/solana-Cds87OTu.d.ts

@@ -1,67 +0,0 @@
-/**
- * USD ↔ atomic-unit conversion for token amounts.
- *
- * `usdToAtomic(usd, { decimals: 6 })` returns the bigint atomic value of a USD
- * amount for a token with `decimals` places of precision (USDC is 6). String
- * parsing + bigint arithmetic so the result is exact; ROUND_HALF_UP at the
- * rounding boundary matches the cross-language Python sibling.
- *
- * Rejects negative, NaN, infinite, and unparseable inputs. Fixed-notation only;
- * scientific notation (e.g. `"1e6"`) is not parsed (mirrors the locked cross-
- * language fixture corpus, which uses fixed notation exclusively).
- */
-/**
- * Convert a USD amount to atomic units for a token with `decimals` places.
- *
- * @param usd USD amount. Strings (`"1.23"`) and `number`s (`1.23`) are accepted.
- *   `number` is converted via `String(usd)` before parsing, so JS float precision
- *   limits apply when the float can't represent the value exactly.
- * @param opts.decimals Number of decimal places in the atomic unit (6 for USDC,
- *   18 for ETH, etc.). Must be a non-negative integer.
- *
- * @returns Integer atomic units as a `bigint`. `"1.23"` with `decimals: 6`
- *   returns `1_230_000n`.
- *
- * @throws RangeError when `usd` is negative, NaN, infinite, or `decimals` is
- *   not a non-negative integer.
- * @throws SyntaxError when `usd` cannot be parsed as a fixed-notation decimal.
- */
-declare function usdToAtomic(usd: string | number, opts: {
-    decimals: number;
-}): bigint;
-/**
- * Format an integer cent amount as a fixed-2-decimal USD string.
- *
- * `formatUsdCents(500)` returns `"5.00"`. Negative values are formatted with a
- * leading minus. Use everywhere a merchant emits `(cents / 100).toFixed(2)`;
- * consistent formatting across catalog rows, order responses, and 402 bodies
- * prevents agent-side string-comparison flakiness.
- */
-declare function formatUsdCents(cents: number): string;
-
-/**
- * Solana MPP fee-payer signer loader.
- *
- * Buyers paying via Solana MPP USDC don't typically carry SOL for transaction
- * fees, so merchants commonly co-sign the buyer's `solana/charge` tx as the
- * fee payer (~5000 lamports per tx; negligible vs the USDC value moved).
- *
- * `loadSolanaFeePayer({ privateKey })` accepts a Solana keypair in any of the
- * three forms agents commonly export it as:
- *
- *   - **base58** (Phantom export format) — 64-byte secret+public, or 32-byte
- *     secret-only
- *   - **hex** — 128-char string (64 bytes hex: 32-byte secret + 32-byte public)
- *
- * Returns a `KeyPairSigner` from `@solana/kit` ready to pass as the `signer`
- * field on a `SolanaMppRailSpec`. Returns `undefined` when `privateKey` is
- * empty / absent (so consumers can use `process.env.X` directly without
- * null-checks).
- *
- * Requires the `@solana/kit` peer dependency.
- */
-declare function loadSolanaFeePayer(opts: {
-    privateKey: string | undefined;
-}): Promise<unknown | undefined>;
-
-export { formatUsdCents as f, loadSolanaFeePayer as l, usdToAtomic as u };