aimeat 2.1.0 → 2.2.0

package/dist/src/commerce/evm-address.js

@@ -0,0 +1,94 @@
+/**
+ * @file src/commerce/evm-address.ts
+ * @description Guards for the ONE value a seller types by hand in the whole stablecoin flow: the
+ *   address their USDC settles to. Getting it wrong is not a validation nicety — an EIP-3009 transfer
+ *   to the wrong target is irreversible, and the two ways to get it wrong are both easy:
+ *
+ *     1. A TYPO. 40 hex characters carry no meaning a human can proof-read. EIP-55 encodes a checksum
+ *        in the CAPITALISATION of the hex, so a mixed-case address that fails the checksum is almost
+ *        certainly mistyped or truncated. (An all-lowercase or all-uppercase address carries no
+ *        checksum at all, so it is accepted and normalised rather than rejected.)
+ *     2. PASTING THE TOKEN CONTRACT instead of a wallet. The USDC/EURC contract addresses are the
+ *        values a seller most plausibly has on their clipboard while setting this up — they appear in
+ *        every x402 doc, and in our own network registry. Funds sent there are gone.
+ *
+ *   The optional on-chain probe answers the remaining question — is this a contract or an account the
+ *   seller can hold a key for — but only when the operator configured an RPC. It is best-effort by
+ *   design: a save must not depend on a third party being reachable, so an unreachable RPC lets the
+ *   save through while a definite "this is a contract" answer blocks it.
+ * @structure isEvmAddressShape · toChecksumAddress · checksumIsWrong · settlementAssetMatch ·
+ *   probeIsContract
+ * @usage
+ *   const bad = settlementAssetMatch(addr);            // → { network, currency } when it is a token
+ *   if (checksumIsWrong(addr)) return 400;
+ *   const stored = toChecksumAddress(addr);
+ * @version-history
+ *   v1.0.0 — 2026-07-25 — Initial guards after a real misconfiguration: the USDC Base-Sepolia contract
+ *     address was saved as a payout address, and the shape-only check accepted it silently.
+ */
+import { keccak_256 } from '@noble/hashes/sha3.js';
+import { X402_NETWORKS } from './x402-facilitator.js';
+import { safeFetch } from '../utils/url-validator.js';
+import { logger } from '../utils/logger.js';
+/** 0x + 40 hex characters. Shape only — says nothing about whether the address means anything. */
+export function isEvmAddressShape(value) {
+    return /^0x[a-fA-F0-9]{40}$/.test(value);
+}
+/** The EIP-55 mixed-case form: capitalisation derived from keccak-256 of the lowercase hex body. */
+export function toChecksumAddress(value) {
+    const body = value.slice(2).toLowerCase();
+    const hash = Buffer.from(keccak_256(new TextEncoder().encode(body))).toString('hex');
+    let out = '0x';
+    for (let i = 0; i < body.length; i++) {
+        out += parseInt(hash[i], 16) >= 8 ? body[i].toUpperCase() : body[i];
+    }
+    return out;
+}
+/**
+ * True when the input carries a checksum (it is mixed case) and that checksum does not match.
+ * All-lowercase / all-uppercase input carries no checksum, so it is not "wrong" — just unverifiable.
+ */
+export function checksumIsWrong(value) {
+    const body = value.slice(2);
+    const mixedCase = body !== body.toLowerCase() && body !== body.toUpperCase();
+    return mixedCase && toChecksumAddress(value) !== value;
+}
+/** The settlement token this address IS, when it is one of ours. A payout address must never be a token. */
+export function settlementAssetMatch(value) {
+    const needle = value.toLowerCase();
+    for (const [networkId, network] of Object.entries(X402_NETWORKS)) {
+        for (const [currency, asset] of Object.entries(network.assets)) {
+            if (asset && asset.address.toLowerCase() === needle)
+                return { network: networkId, currency };
+        }
+    }
+    return null;
+}
+/**
+ * Ask the chain whether the address holds contract code. `true` = definitely a contract (block the
+ * save), `false` = an externally-owned account, `null` = could not tell, which must never block:
+ * an RPC outage is not a reason to stop a seller configuring their own payouts.
+ */
+export async function probeIsContract(rpcUrl, address) {
+    if (!rpcUrl)
+        return null;
+    try {
+        const res = await safeFetch(rpcUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'eth_getCode', params: [address, 'latest'] }),
+            signal: AbortSignal.timeout(6000),
+        });
+        if (!res.ok)
+            return null;
+        const body = await res.json();
+        if (typeof body.result !== 'string')
+            return null;
+        return body.result !== '0x' && body.result !== '0x0';
+    }
+    catch (err) {
+        logger.warn('[payout] on-chain address probe unavailable; saving without it', { error: String(err) });
+        return null;
+    }
+}
+//# sourceMappingURL=evm-address.js.map

package/dist/src/commerce/evm-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-address.js","sourceRoot":"","sources":["../../../src/commerce/evm-address.ts"],"names":[],"mappings":"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"}

package/dist/src/commerce/money.d.ts

@@ -12,14 +12,16 @@
  *   ROUNDING POLICY for both ledgers (fee always ceils, cut always floors) — they operate on one
  *   integer amount of either unit at a time, which is policy sharing, not unit mixing.
  * @structure MONEY_SCALE · MONEY_UNIT · MONEY_CURRENCIES · isMoneyCurrency ·
- *   isSupportedMoneyCurrency · microsToStripeMinor · stripeMinorToMicros · microsToUsdcRaw ·
- *   usdcRawToMicros · integerMicros · percentFee · percentCut · roundToMoneyScale ·
- *   formatMoneyMajor
+ *   isSupportedMoneyCurrency · microsToStripeMinor · stripeMinorToMicros · microsToTokenRaw ·
+ *   microsToUsdcRaw · usdcRawToMicros · integerMicros · percentFee · percentCut ·
+ *   roundToMoneyScale · formatMoneyMajor
  * @usage
  *   import { isMoneyCurrency, microsToStripeMinor, percentFee } from './money.js';
  *   if (isMoneyCurrency(session.currency)) stripeAmount = microsToStripeMinor(micros); // → cents
  *   const fee = percentFee(gross, commerceFeePercent(config));
  * @version-history
+ *   v1.2.0 — 2026-07-25 — microsToTokenRaw: decimals-aware micros → token atomic units, so a second
+ *     settlement asset (EURC) crosses the chokepoint on its own precision (TARGET-042)
  *   v1.1.0 — 2026-07-14 — Chokepoint completion: currency allowlist, Stripe-minor + USDC-raw
  *     round-trips, percent fee/cut rounding policy, major-unit scale rounding (TARGET-033 phase 7c)
  *   v1.0.0 — 2026-07-14 — Initial 6-decimal micro-unit money representation (TARGET-033 phase 7b)
@@ -45,8 +47,19 @@ export declare function microsToStripeMinor(micros: number): number;
 /** Convert a Stripe minor-unit (cent) amount back to micro-units. Exact for integer cents. */
 export declare function stripeMinorToMicros(minor: number): number;
 /**
- * Convert micro-units to USDC raw units (the x402 stablecoin rail). USDC also carries 6 decimals,
- * so the conversion is the identity on integers — the function exists so the settlement rail still
+ * Convert micro-units to a settlement token's ATOMIC units, honouring that token's own decimals
+ * (the x402 stablecoin rail). Returns a decimal STRING because an 18-decimal token overflows the
+ * safe-integer range — x402 carries `maxAmountRequired` as a string for exactly this reason.
+ *
+ * Every asset AIMEAT settles today (USDC and EURC, on both Base networks) carries 6 decimals, so
+ * this is the identity in practice; the branches exist so a token with a different precision is
+ * CONVERTED rather than mispriced by orders of magnitude. Scaling DOWN (a sub-6-decimal token)
+ * rounds up, the only direction that never hands the seller less than the price.
+ */
+export declare function microsToTokenRaw(micros: number, decimals: number): string;
+/**
+ * Convert micro-units to USDC raw units (the 6-decimal special case of {@link microsToTokenRaw}).
+ * The conversion is the identity on integers — the function exists so the settlement rail still
  * crosses the chokepoint (and keeps working if MONEY_SCALE ever diverges from the rail's).
  */
 export declare function microsToUsdcRaw(micros: number): number;

package/dist/src/commerce/money.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../../src/commerce/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,0DAA0D;AAC1D,eAAO,MAAM,UAAU,UAAY,CAAC;AAEpC,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,yBAA0B,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAE5E;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIvD"}
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../../src/commerce/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,0DAA0D;AAC1D,eAAO,MAAM,UAAU,UAAY,CAAC;AAEpC,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,yBAA0B,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAE5E;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/src/commerce/money.js

@@ -12,14 +12,16 @@
  *   ROUNDING POLICY for both ledgers (fee always ceils, cut always floors) — they operate on one
  *   integer amount of either unit at a time, which is policy sharing, not unit mixing.
  * @structure MONEY_SCALE · MONEY_UNIT · MONEY_CURRENCIES · isMoneyCurrency ·
- *   isSupportedMoneyCurrency · microsToStripeMinor · stripeMinorToMicros · microsToUsdcRaw ·
- *   usdcRawToMicros · integerMicros · percentFee · percentCut · roundToMoneyScale ·
- *   formatMoneyMajor
+ *   isSupportedMoneyCurrency · microsToStripeMinor · stripeMinorToMicros · microsToTokenRaw ·
+ *   microsToUsdcRaw · usdcRawToMicros · integerMicros · percentFee · percentCut ·
+ *   roundToMoneyScale · formatMoneyMajor
  * @usage
  *   import { isMoneyCurrency, microsToStripeMinor, percentFee } from './money.js';
  *   if (isMoneyCurrency(session.currency)) stripeAmount = microsToStripeMinor(micros); // → cents
  *   const fee = percentFee(gross, commerceFeePercent(config));
  * @version-history
+ *   v1.2.0 — 2026-07-25 — microsToTokenRaw: decimals-aware micros → token atomic units, so a second
+ *     settlement asset (EURC) crosses the chokepoint on its own precision (TARGET-042)
  *   v1.1.0 — 2026-07-14 — Chokepoint completion: currency allowlist, Stripe-minor + USDC-raw
  *     round-trips, percent fee/cut rounding policy, major-unit scale rounding (TARGET-033 phase 7c)
  *   v1.0.0 — 2026-07-14 — Initial 6-decimal micro-unit money representation (TARGET-033 phase 7b)
@@ -54,12 +56,31 @@ export function stripeMinorToMicros(minor) {
     return minor * MICROS_PER_STRIPE_MINOR;
 }
 /**
- * Convert micro-units to USDC raw units (the x402 stablecoin rail). USDC also carries 6 decimals,
- * so the conversion is the identity on integers — the function exists so the settlement rail still
+ * Convert micro-units to a settlement token's ATOMIC units, honouring that token's own decimals
+ * (the x402 stablecoin rail). Returns a decimal STRING because an 18-decimal token overflows the
+ * safe-integer range — x402 carries `maxAmountRequired` as a string for exactly this reason.
+ *
+ * Every asset AIMEAT settles today (USDC and EURC, on both Base networks) carries 6 decimals, so
+ * this is the identity in practice; the branches exist so a token with a different precision is
+ * CONVERTED rather than mispriced by orders of magnitude. Scaling DOWN (a sub-6-decimal token)
+ * rounds up, the only direction that never hands the seller less than the price.
+ */
+export function microsToTokenRaw(micros, decimals) {
+    const amount = BigInt(Math.trunc(micros));
+    if (decimals === MONEY_SCALE)
+        return amount.toString();
+    if (decimals > MONEY_SCALE)
+        return (amount * 10n ** BigInt(decimals - MONEY_SCALE)).toString();
+    const divisor = 10n ** BigInt(MONEY_SCALE - decimals);
+    return ((amount + divisor - 1n) / divisor).toString(); // ceil — never under-charge the buyer
+}
+/**
+ * Convert micro-units to USDC raw units (the 6-decimal special case of {@link microsToTokenRaw}).
+ * The conversion is the identity on integers — the function exists so the settlement rail still
  * crosses the chokepoint (and keeps working if MONEY_SCALE ever diverges from the rail's).
  */
 export function microsToUsdcRaw(micros) {
-    return Math.trunc(micros);
+    return Number(microsToTokenRaw(micros, MONEY_SCALE));
 }
 /** Convert USDC raw units (6 decimals) back to micro-units. Identity on integers. */
 export function usdcRawToMicros(raw) {

package/dist/src/commerce/money.js.map

@@ -1 +1 @@
-{"version":3,"file":"money.js","sourceRoot":"","sources":["../../../src/commerce/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAEpC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAGxD,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,KAAK,QAAQ,CAAC;AAC/B,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,+FAA+F;AAC/F,MAAM,uBAAuB,GAAG,UAAU,GAAG,GAAG,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC,CAAC;AACtD,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,GAAG,uBAAuB,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,OAAe;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,OAAe;IACxD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,sDAAsD;IACtD,OAAO,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../../src/commerce/money.ts"],"names":[],"mappings":"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"}

package/dist/src/commerce/x402-facilitator.d.ts

@@ -1,27 +1,72 @@
-/** One network the x402 handler can settle on: the chain id x402 uses + the settlement asset. */
-export interface X402Network {
-    /** x402 `network` id echoed in the accepts[] exact scheme and the X-PAYMENT payload. */
-    id: string;
-    /** The settlement asset (USDC) contract address on this network. */
-    asset: string;
-    /** The asset's EIP-712 domain (name + version) the buyer signs against — the exact scheme `extra`. */
+import { type MoneyCurrency } from './money.js';
+/** One settlement token: the contract, its precision, and the EIP-712 domain the buyer signs against. */
+export interface X402Asset {
+    /** The token contract address on the owning network. */
+    address: string;
+    /** Ticker, for human-facing surfaces (payout settings, tracking codes) — never for identity. */
+    symbol: string;
+    /**
+     * Decimals the token carries onchain. Drives the micros → atomic-unit conversion, so a token that
+     * is NOT 6-decimal converts correctly instead of silently mispricing by orders of magnitude.
+     */
+    decimals: number;
+    /**
+     * The token's EIP-712 domain (name + version) — the exact scheme `extra`. The buyer signs
+     * TransferWithAuthorization against it, so a wrong value invalidates every signature. Each entry
+     * below is verified against the live contract (see the registry comment).
+     */
     extra: {
         name: string;
         version: string;
     };
 }
+/** One network the x402 handler can settle on: the chain id x402 uses + its settlement assets. */
+export interface X402Network {
+    /** x402 `network` id echoed in the accepts[] exact scheme and the X-PAYMENT payload. */
+    id: string;
+    /**
+     * One settlement asset per MONEY currency (model 2: the fiat price picks its stablecoin
+     * instrument). A (network, currency) pair with no asset is ABSENT from this map, never an empty
+     * entry — that absence is exactly what stops the currency being advertised as settleable.
+     */
+    assets: Partial<Record<MoneyCurrency, X402Asset>>;
+}
 /**
  * The network registry — the ONE place a chain/asset is defined. Adding Base mainnet, Solana, or
  * another network is a new entry here, never a change to the handler or the commerce core
- * (TARGET-042: network is a parameter, selected by config.x402Network).
+ * (TARGET-042: network is a parameter, selected by config.x402Network). A currency joins a network
+ * by gaining an entry in `assets` — that is the whole of "AIMEAT can settle EUR here".
+ *
+ * VERIFICATION (2026-07-25). Addresses from Circle's own documentation
+ * (https://developers.circle.com/stablecoins/usdc-contract-addresses and
+ * .../eurc-contract-addresses); `symbol`, `decimals` and the EIP-712 domain (`extra`) were then read
+ * from the live contracts and PROVEN by recomputing each contract's own DOMAIN_SEPARATOR from
+ * (name, version, chainId, address) — all four match. Note the domain `name` is the ERC-20 `name()`,
+ * which is NOT uniform: Base mainnet USDC is "USD Coin" while every other entry equals its ticker.
+ * The public x402.org facilitator was probed with a real EIP-3009 signature over each asset: EURC
+ * verifies identically to USDC (both reaching `invalid_exact_evm_insufficient_balance` on an unfunded
+ * signer), and a deliberately wrong domain name is rejected with `invalid_exact_evm_token_name_mismatch`
+ * — so a mistake here fails loudly rather than hiding behind a generic signature error.
  */
 export declare const X402_NETWORKS: Record<string, X402Network>;
 export declare function getX402Network(id: string): X402Network | undefined;
+/**
+ * The settlement asset for one (network, currency) pair, or undefined when the pair cannot settle.
+ * THE gate behind the advertising rule: every surface that names a currency resolves it through
+ * here first, so a currency is only ever offered when a real asset backs it.
+ */
+export declare function getX402Asset(network: X402Network | undefined, currency: string): X402Asset | undefined;
+/**
+ * The money currencies a network can actually settle — derived from the assets that exist, never a
+ * hardcoded list. An unknown network yields [], so a misconfigured node advertises nothing rather
+ * than promising a rail it has no asset for. Ordered by MONEY_CURRENCIES for a stable response.
+ */
+export declare function x402SettlementCurrencies(network: X402Network | undefined): MoneyCurrency[];
 /** One entry of a 402 response's `accepts[]`: what a payment must satisfy to unlock the resource. */
 export interface X402PaymentRequirements {
     scheme: 'exact';
     network: string;
-    /** Atomic units of the asset (USDC has 6 decimals, matching AIMEAT money micros) as a string. */
+    /** Atomic units of the asset (USDC and EURC both carry 6 decimals, matching money micros) as a string. */
     maxAmountRequired: string;
     resource: string;
     description: string;
@@ -92,19 +137,25 @@ export declare function testFacilitator(): X402Facilitator;
 /** Decode a base64 X-PAYMENT header into an exact-scheme payload; null on missing/malformed input. */
 export declare function decodeXPayment(header: string | undefined): X402PaymentPayload | null;
 /**
- * Build the exact-scheme PaymentRequirements for a MONEY amount. money micros → USDC atomic units is
- * the identity (both carry 6 decimals), so a 1.50 USD price (1_500_000 micros) is 1.50 USDC — this is
- * model 2 made concrete: the price is USD, the settlement instrument is USDC, one to one.
+ * Build the exact-scheme PaymentRequirements for a MONEY amount in ONE settlement asset. The caller
+ * resolves the asset via {@link getX402Asset} first, so a currency with no asset can never reach
+ * here. Model 2 made concrete: a 1.50 USD price (1_500_000 micros) asks for 1.50 USDC, and a 1.50 EUR
+ * price asks for 1.50 EURC — the price stays fiat, the token is only the instrument. The amount goes
+ * through the money chokepoint with the asset's own decimals, so a token that is not 6-decimal is
+ * converted rather than mispriced.
  */
 export declare function buildExactRequirements(args: {
     network: X402Network;
+    asset: X402Asset;
     payTo: string;
     amountMicros: number;
     resource: string;
     description: string;
 }): X402PaymentRequirements;
 /**
- * Pull the seller's USDC payout address (payTo) from their opaque `commerce.psp` record. Accepts a
+ * Pull the seller's stablecoin payout address (payTo) from their opaque `commerce.psp` record. ONE
+ * EVM address receives every settlement asset — USDC and EURC are both ERC-20s on the same chain —
+ * so adding a currency never asks the seller for another field. Accepts a
  * few shapes — `{ payTo }`, `{ address }`, `{ x402: { address } }` — and returns it only when it is a
  * well-formed EVM address, so a Stripe-only psp (no address) simply yields undefined and the handler
  * answers "seller has no x402 address" rather than settling to a bad target.

package/dist/src/commerce/x402-facilitator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x402-facilitator.d.ts","sourceRoot":"","sources":["../../../src/commerce/x402-facilitator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"x402-facilitator.d.ts","sourceRoot":"","sources":["../../../src/commerce/x402-facilitator.ts"],"names":[],"mappings":"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"}

package/dist/src/commerce/x402-facilitator.js

@@ -1,45 +1,92 @@
 /**
  * @file src/commerce/x402-facilitator.ts
  * @description The x402 network registry, wire types, and facilitator client for the non-custodial
- *   USDC settlement handler (TARGET-042). The heavy crypto (EIP-3009 signing by the buyer's wallet,
+ *   stablecoin settlement handler (TARGET-042). The heavy crypto (EIP-3009 signing by the buyer's wallet,
  *   signature + onchain verification, the settling transfer) lives in the buyer's wallet and in the
  *   Coinbase-style FACILITATOR — never here. AIMEAT only (1) serializes the x402 `exact`
  *   PaymentRequirements a 402 advertises, (2) decodes the buyer's base64 X-PAYMENT proof, and (3)
  *   forwards both to the facilitator's /verify + /settle over safeFetch (Rule 10). That is why this
  *   handler needs no @x402 / viem dependency: there is no EIP-3009 serialization to hand-write on the
  *   server side. The NETWORK REGISTRY is the one place a chain + asset is defined, so Base, Solana, or
- *   another network is a data entry, not a code change (TARGET-042: network is a parameter).
- * @structure X402Network · X402_NETWORKS · getX402Network · X402PaymentRequirements ·
- *   X402PaymentPayload · X402VerifyResult · X402SettleResult · X402Facilitator · httpFacilitator ·
- *   testFacilitator · decodeXPayment · buildExactRequirements · extractPayTo
+ *   another network is a data entry, not a code change (TARGET-042: network is a parameter). The
+ *   registry is CURRENCY-AWARE: each network carries one settlement asset per money currency (USD →
+ *   USDC, EUR → EURC), and a pair with no asset is absent, which is the gate that keeps a currency
+ *   from ever being advertised as settleable.
+ * @structure X402Asset · X402Network · X402_NETWORKS · getX402Network · getX402Asset ·
+ *   x402SettlementCurrencies · X402PaymentRequirements · X402PaymentPayload · X402VerifyResult ·
+ *   X402SettleResult · X402Facilitator · httpFacilitator · testFacilitator · decodeXPayment ·
+ *   buildExactRequirements · extractPayTo
  * @usage
  *   const fac = config.x402TestFacilitator ? testFacilitator() : httpFacilitator(config.x402FacilitatorUrl);
- *   const reqs = buildExactRequirements({ network, payTo, amountMicros, resource, description });
+ *   const asset = getX402Asset(network, session.currency);   // undefined → this currency cannot settle
+ *   const reqs = buildExactRequirements({ network, asset, payTo, amountMicros, resource, description });
  * @version-history
+ *   v1.1.0 — 2026-07-25 — Currency-aware asset registry: EURC joins USDC as a settlement asset on
+ *     both Base networks, decimals carried per asset (TARGET-042)
  *   v1.0.0 — 2026-07-18 — Initial x402 facilitator client + network registry + test double (TARGET-042)
  */
 import { safeFetch } from '../utils/url-validator.js';
-import { microsToUsdcRaw } from './money.js';
+import { microsToTokenRaw, isSupportedMoneyCurrency, MONEY_CURRENCIES } from './money.js';
 /**
  * The network registry — the ONE place a chain/asset is defined. Adding Base mainnet, Solana, or
  * another network is a new entry here, never a change to the handler or the commerce core
- * (TARGET-042: network is a parameter, selected by config.x402Network).
+ * (TARGET-042: network is a parameter, selected by config.x402Network). A currency joins a network
+ * by gaining an entry in `assets` — that is the whole of "AIMEAT can settle EUR here".
+ *
+ * VERIFICATION (2026-07-25). Addresses from Circle's own documentation
+ * (https://developers.circle.com/stablecoins/usdc-contract-addresses and
+ * .../eurc-contract-addresses); `symbol`, `decimals` and the EIP-712 domain (`extra`) were then read
+ * from the live contracts and PROVEN by recomputing each contract's own DOMAIN_SEPARATOR from
+ * (name, version, chainId, address) — all four match. Note the domain `name` is the ERC-20 `name()`,
+ * which is NOT uniform: Base mainnet USDC is "USD Coin" while every other entry equals its ticker.
+ * The public x402.org facilitator was probed with a real EIP-3009 signature over each asset: EURC
+ * verifies identically to USDC (both reaching `invalid_exact_evm_insufficient_balance` on an unfunded
+ * signer), and a deliberately wrong domain name is rejected with `invalid_exact_evm_token_name_mismatch`
+ * — so a mistake here fails loudly rather than hiding behind a generic signature error.
  */
 export const X402_NETWORKS = {
     'base-sepolia': {
         id: 'base-sepolia',
-        asset: '0x036CbD53842c5426634e7929541eC2318f3dCF7e', // USDC on Base Sepolia (testnet)
-        extra: { name: 'USDC', version: '2' },
+        assets: {
+            // USDC on Base Sepolia (testnet).
+            USD: { address: '0x036CbD53842c5426634e7929541eC2318f3dCF7e', symbol: 'USDC', decimals: 6, extra: { name: 'USDC', version: '2' } },
+            // EURC on Base Sepolia (testnet).
+            EUR: { address: '0x808456652fdb597867f38412077A9182bf77359F', symbol: 'EURC', decimals: 6, extra: { name: 'EURC', version: '2' } },
+        },
     },
     'base': {
         id: 'base',
-        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base mainnet
-        extra: { name: 'USD Coin', version: '2' },
+        assets: {
+            // USDC on Base mainnet — domain name is "USD Coin", not the ticker.
+            USD: { address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', symbol: 'USDC', decimals: 6, extra: { name: 'USD Coin', version: '2' } },
+            // EURC on Base mainnet.
+            EUR: { address: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42', symbol: 'EURC', decimals: 6, extra: { name: 'EURC', version: '2' } },
+        },
     },
 };
 export function getX402Network(id) {
     return X402_NETWORKS[id];
 }
+/**
+ * The settlement asset for one (network, currency) pair, or undefined when the pair cannot settle.
+ * THE gate behind the advertising rule: every surface that names a currency resolves it through
+ * here first, so a currency is only ever offered when a real asset backs it.
+ */
+export function getX402Asset(network, currency) {
+    if (!network || !isSupportedMoneyCurrency(currency))
+        return undefined;
+    return network.assets[currency];
+}
+/**
+ * The money currencies a network can actually settle — derived from the assets that exist, never a
+ * hardcoded list. An unknown network yields [], so a misconfigured node advertises nothing rather
+ * than promising a rail it has no asset for. Ordered by MONEY_CURRENCIES for a stable response.
+ */
+export function x402SettlementCurrencies(network) {
+    if (!network)
+        return [];
+    return MONEY_CURRENCIES.filter((c) => !!network.assets[c]);
+}
 /**
  * The real facilitator: POST { x402Version, paymentPayload, paymentRequirements } to {baseUrl}/verify
  * and /settle. Every call goes through safeFetch (Rule 10: all non-constant outbound HTTP is SSRF
@@ -109,26 +156,31 @@ export function decodeXPayment(header) {
     }
 }
 /**
- * Build the exact-scheme PaymentRequirements for a MONEY amount. money micros → USDC atomic units is
- * the identity (both carry 6 decimals), so a 1.50 USD price (1_500_000 micros) is 1.50 USDC — this is
- * model 2 made concrete: the price is USD, the settlement instrument is USDC, one to one.
+ * Build the exact-scheme PaymentRequirements for a MONEY amount in ONE settlement asset. The caller
+ * resolves the asset via {@link getX402Asset} first, so a currency with no asset can never reach
+ * here. Model 2 made concrete: a 1.50 USD price (1_500_000 micros) asks for 1.50 USDC, and a 1.50 EUR
+ * price asks for 1.50 EURC — the price stays fiat, the token is only the instrument. The amount goes
+ * through the money chokepoint with the asset's own decimals, so a token that is not 6-decimal is
+ * converted rather than mispriced.
  */
 export function buildExactRequirements(args) {
     return {
         scheme: 'exact',
         network: args.network.id,
-        maxAmountRequired: String(microsToUsdcRaw(args.amountMicros)),
+        maxAmountRequired: microsToTokenRaw(args.amountMicros, args.asset.decimals),
         resource: args.resource,
         description: args.description,
         mimeType: 'application/json',
         payTo: args.payTo,
         maxTimeoutSeconds: 120,
-        asset: args.network.asset,
-        extra: args.network.extra,
+        asset: args.asset.address,
+        extra: args.asset.extra,
     };
 }
 /**
- * Pull the seller's USDC payout address (payTo) from their opaque `commerce.psp` record. Accepts a
+ * Pull the seller's stablecoin payout address (payTo) from their opaque `commerce.psp` record. ONE
+ * EVM address receives every settlement asset — USDC and EURC are both ERC-20s on the same chain —
+ * so adding a currency never asks the seller for another field. Accepts a
  * few shapes — `{ payTo }`, `{ address }`, `{ x402: { address } }` — and returns it only when it is a
  * well-formed EVM address, so a Stripe-only psp (no address) simply yields undefined and the handler
  * answers "seller has no x402 address" rather than settling to a bad target.

package/dist/src/commerce/x402-facilitator.js.map

@@ -1 +1 @@
-{"version":3,"file":"x402-facilitator.js","sourceRoot":"","sources":["../../../src/commerce/x402-facilitator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"x402-facilitator.js","sourceRoot":"","sources":["../../../src/commerce/x402-facilitator.ts"],"names":[],"mappings":"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"}

package/dist/src/commerce/x402-handler.d.ts

@@ -1,11 +1,15 @@
 /**
  * @file src/commerce/x402-handler.ts
- * @description The x402 stablecoin PaymentHandler (TARGET-042): settles a MONEY (USD) checkout
- *   session with USDC via the x402 `exact` scheme, NON-CUSTODIAL. It registers in the same registry
- *   as io.aimeat.morsels and com.stripe.spt and implements the same collect/payout/refund contract,
- *   so the commerce core orchestrates it unchanged. USDC is a payment METHOD for a USD price
- *   (model 2): the handler settles `currency: 'USD'` sessions, the session currency never becomes
- *   USDC, and the currency list stays morsel/EUR/USD.
+ * @description The x402 stablecoin PaymentHandler (TARGET-042): settles a MONEY checkout session
+ *   with the stablecoin that matches its currency — USD with USDC, EUR with EURC — via the x402
+ *   `exact` scheme, NON-CUSTODIAL. It registers in the same registry as io.aimeat.morsels and
+ *   com.stripe.spt and implements the same collect/payout/refund contract, so the commerce core
+ *   orchestrates it unchanged. The stablecoin is a payment METHOD for a fiat price (model 2): the
+ *   session currency stays USD or EUR and never becomes USDC/EURC.
+ *
+ *   The advertised currency list is DERIVED from the configured network's assets, so this node only
+ *   ever offers a currency it can actually settle — see x402-facilitator.ts for the registry and
+ *   the verification behind each asset.
  *
  *   collect: the buyer's decoded X-PAYMENT proof arrives as the adapter `instrument`. With no proof
  *   yet, collect throws 402 PAYMENT_REQUIRED so the adapter answers with the exact-scheme accepts[].
@@ -14,11 +18,13 @@
  *   hash as the tracking code. AIMEAT never holds funds — replay is rejected by the facilitator's
  *   single-use EIP-3009 nonce (and, on the same session, by the completed-session gate). payout and
  *   refund are no-ops: the facilitator already moved money directly to the seller, and an onchain
- *   USDC transfer cannot be reversed (a post-settlement fulfillment failure is recorded, not clawed
+ *   onchain transfer cannot be reversed (a post-settlement fulfillment failure is recorded, not clawed
  *   back).
  * @structure X402_HANDLER_ID · x402PaymentHandler
  * @usage registerPaymentHandler(x402PaymentHandler(config, facilitator));
  * @version-history
+ *   v1.1.0 — 2026-07-25 — EUR settles in EURC alongside USD/USDC: currencies derived from the
+ *     network registry, asset selected by session currency, asset named in the tracking code (TARGET-042)
  *   v1.0.0 — 2026-07-18 — Initial non-custodial USDC handler (TARGET-042)
  */
 import type { AimeatConfig } from '../config.js';

package/dist/src/commerce/x402-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x402-handler.d.ts","sourceRoot":"","sources":["../../../src/commerce/x402-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAEjE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,GAAG,cAAc,CAgDrG"}
+{"version":3,"file":"x402-handler.d.ts","sourceRoot":"","sources":["../../../src/commerce/x402-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAEjE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,GAAG,cAAc,CA8DrG"}