@aifinpay/agent 1.8.4 → 2.0.0-rc.12

package/dist/settlementV14.d.ts

@@ -0,0 +1,136 @@
+/**
+ * B2BSplitter v1.4 settlement — the client half.
+ *
+ * v1.4 inverts who authorises a payment. Through v1.3 the agent built its own
+ * calldata and settled unilaterally; the backend verified afterwards. In v1.4
+ * both entrypoints go through `_verifyQuote`, which requires a 65-byte ECDSA
+ * signature from a SIGN_OPERATOR_ROLE holder. The agent cannot produce one, so
+ * the quote arrives already signed and the agent's job is to CHECK it and
+ * submit it — never to construct it.
+ *
+ * That makes this module mostly refusals, and deliberately so. Spec:
+ * evm-contract@feat/v14_migration docs/V14_QUOTE_FORMAT.md §8, "SDK / Frontend
+ * Responsibilities". Each check below cites the clause it implements, because
+ * a check nobody can trace back to a requirement is a check somebody deletes.
+ */
+import { type PublicClient, type WalletClient, type Address, type Hex } from "viem";
+/** The Quote struct, exactly as B2BSplitterV14 declares it. Field ORDER is part
+ *  of the EIP-712 hash — this mirrors _QUOTE_TYPEHASH and must not be reordered. */
+export interface V14Quote {
+    payer: Address;
+    merchant: Address;
+    token: Address;
+    grossAmount: string;
+    ipCreator: Address;
+    validUntil: string;
+    orderIdHash: Hex;
+    nonce: string;
+    routeId: Hex;
+}
+/** What `/v1/quote` returns under `settlement_call` when settlement_version is 1.4. */
+export interface V14SettlementCall {
+    chain: string;
+    contract: Address;
+    splitter_version: "1.4";
+    route: string;
+    asset: string;
+    function: string;
+    arg_encoding: "struct+signature";
+    field_order: string[];
+    value_wei: string;
+    args: {
+        quote: V14Quote;
+        signature: Hex;
+    };
+    bound_to_payer?: Address;
+    nonce_at_signing?: string;
+}
+export declare class V14SettlementError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Routes this SDK understands, by NAME.
+ *
+ * §8.7 requires an allow-list and says old SDKs must refuse routes added after
+ * they shipped rather than guess. Names rather than hashes because the contract
+ * derives one from the other — Profiles.routeId(name) == keccak256(bytes(name)),
+ * verified against the deployed Amoy Profiles on 2026-09-02 for both entries —
+ * so hardcoding the hashes would be storing a derived value and inviting the
+ * two to disagree.
+ */
+export declare const KNOWN_V14_ROUTES: readonly ["merchant-aifp1", "agent-x402"];
+export type KnownV14Route = (typeof KNOWN_V14_ROUTES)[number];
+export declare function routeIdOf(name: string): Hex;
+/** name → routeId, for every route this SDK will submit. */
+export declare function knownRouteIds(): Record<Hex, KnownV14Route>;
+export interface V14ValidateOptions {
+    /** The off-chain order id, when the caller knows it (§8.3). Omitted means the
+     *  orderIdHash cannot be checked, and this module says so rather than
+     *  pretending it verified something. */
+    orderId?: string;
+    /** The wallet that will send the transaction. §8.2 and the contract's own
+     *  `payer == msg.sender` make this the difference between a quote that
+     *  settles and one that reverts after gas. */
+    payer?: Address;
+    /** Seconds of headroom required before validUntil. A quote that expires while
+     *  the transaction is in the mempool reverts SignatureExpired and the agent
+     *  pays for the attempt. */
+    minSecondsRemaining?: number;
+    nowMs?: number;
+    /** Extra route names this deployment understands. Additive only. */
+    allowRoutes?: readonly string[];
+}
+/**
+ * Read-only structural checks. Success does not authenticate the signer,
+ * deployment, fees or treasury and does not authorize settlement.
+ *
+ * Throws on the first failure with a code, because these are not equivalent:
+ * an expired quote should be re-requested, a foreign payer is a caller bug, and
+ * an unknown route means this SDK is older than the deployment.
+ */
+export declare function validateV14SettlementCall(call: V14SettlementCall, opts?: V14ValidateOptions): {
+    route: string;
+    expiresInSeconds: number;
+    orderIdChecked: boolean;
+};
+/**
+ * §8.6 — never re-broadcast a settled quote.
+ *
+ * The contract keeps two things and they answer different questions:
+ *   consumedNonce[payer][nonce]  has THIS nonce already been spent
+ *   payerNonce[payer]            which nonce the contract will accept next
+ *
+ * A quote is submittable only if its nonce is unspent AND is the one the
+ * contract expects. Two outstanding quotes for one wallet cannot both settle:
+ * the second carries a stale nonce and reverts InvalidNonce. That is a property
+ * of the contract, so it is reported here rather than discovered on-chain.
+ */
+export declare function checkV14Submittable(publicClient: PublicClient, call: V14SettlementCall): Promise<{
+    submittable: true;
+} | {
+    submittable: false;
+    reason: string;
+    code: string;
+}>;
+/**
+ * v1.4 signing is quarantined. Its current signed Quote omits mutable profile
+ * fees and treasury. RPC preflight cannot bind those values at execution time.
+ * Keep the exported API for callers to handle the refusal, but provide no
+ * bypass: re-enabling requires a contract-bound economics commitment, reviewed
+ * deployment/signer/token pins, approval handling and mined-success recovery.
+ * Validation and nonce inspection above remain read-only diagnostics.
+ */
+export declare function executeV14Settlement(_call: V14SettlementCall, _ctx: {
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+    account: Address;
+    orderId?: string;
+    minSecondsRemaining?: number;
+    /** @deprecated Cannot bypass the v1.4 settlement quarantine. */
+    skipPreflight?: boolean;
+}): Promise<{
+    hash: Hex;
+    route: string;
+}>;
+//# sourceMappingURL=settlementV14.d.ts.map

package/dist/settlementV14.d.ts.map

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

package/dist/settlementV14.js

@@ -0,0 +1,170 @@
+/**
+ * B2BSplitter v1.4 settlement — the client half.
+ *
+ * v1.4 inverts who authorises a payment. Through v1.3 the agent built its own
+ * calldata and settled unilaterally; the backend verified afterwards. In v1.4
+ * both entrypoints go through `_verifyQuote`, which requires a 65-byte ECDSA
+ * signature from a SIGN_OPERATOR_ROLE holder. The agent cannot produce one, so
+ * the quote arrives already signed and the agent's job is to CHECK it and
+ * submit it — never to construct it.
+ *
+ * That makes this module mostly refusals, and deliberately so. Spec:
+ * evm-contract@feat/v14_migration docs/V14_QUOTE_FORMAT.md §8, "SDK / Frontend
+ * Responsibilities". Each check below cites the clause it implements, because
+ * a check nobody can trace back to a requirement is a check somebody deletes.
+ */
+import { keccak256, stringToHex, parseAbi, } from "viem";
+export class V14SettlementError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "V14SettlementError";
+        this.code = code;
+    }
+}
+/**
+ * Routes this SDK understands, by NAME.
+ *
+ * §8.7 requires an allow-list and says old SDKs must refuse routes added after
+ * they shipped rather than guess. Names rather than hashes because the contract
+ * derives one from the other — Profiles.routeId(name) == keccak256(bytes(name)),
+ * verified against the deployed Amoy Profiles on 2026-09-02 for both entries —
+ * so hardcoding the hashes would be storing a derived value and inviting the
+ * two to disagree.
+ */
+export const KNOWN_V14_ROUTES = ["merchant-aifp1", "agent-x402"];
+export function routeIdOf(name) {
+    return keccak256(stringToHex(name));
+}
+/** name → routeId, for every route this SDK will submit. */
+export function knownRouteIds() {
+    const out = {};
+    for (const n of KNOWN_V14_ROUTES)
+        out[routeIdOf(n).toLowerCase()] = n;
+    return out;
+}
+const ZERO = "0x0000000000000000000000000000000000000000";
+const lc = (s) => String(s || "").toLowerCase();
+/**
+ * Read-only structural checks. Success does not authenticate the signer,
+ * deployment, fees or treasury and does not authorize settlement.
+ *
+ * Throws on the first failure with a code, because these are not equivalent:
+ * an expired quote should be re-requested, a foreign payer is a caller bug, and
+ * an unknown route means this SDK is older than the deployment.
+ */
+export function validateV14SettlementCall(call, opts = {}) {
+    const fail = (code, msg) => { throw new V14SettlementError(code, msg); };
+    if (!call || typeof call !== "object")
+        fail("V14_MALFORMED", "no settlement call");
+    if (call.splitter_version !== "1.4") {
+        fail("V14_WRONG_VERSION", `expected a v1.4 settlement call, got ${String(call.splitter_version)} — v1.2 and v1.3 settle through a different path`);
+    }
+    const q = call.args && call.args.quote;
+    const sig = call.args && call.args.signature;
+    if (!q || !sig)
+        fail("V14_MALFORMED", "settlement call carries no quote or no signature");
+    // §8.1 — the signature is the whole point. The contract requires exactly 65
+    // bytes and reverts InvalidSignatureLength on anything else, after gas.
+    if (!/^0x[0-9a-fA-F]{130}$/.test(sig)) {
+        fail("V14_BAD_SIGNATURE", `signature must be 65 bytes, got ${(String(sig).length - 2) / 2}`);
+    }
+    // §8.7 — refuse routes this SDK does not understand rather than submit blind.
+    const allowed = { ...knownRouteIds() };
+    for (const extra of opts.allowRoutes || [])
+        allowed[routeIdOf(extra).toLowerCase()] = extra;
+    const route = allowed[lc(q.routeId)];
+    if (!route) {
+        fail("V14_UNKNOWN_ROUTE", `routeId ${q.routeId} is not one this SDK understands (${Object.values(allowed).join(", ")}). ` +
+            `A route added after this SDK shipped is expected — upgrade rather than force it.`);
+    }
+    // §8.2 — the contract enforces payer == msg.sender. Catching it here costs
+    // nothing; catching it on-chain costs the gas of a reverted transaction.
+    if (opts.payer && lc(opts.payer) !== lc(q.payer)) {
+        fail("V14_WRONG_PAYER", `this quote is signed for ${q.payer} and cannot be settled by ${opts.payer} — request one for your own address`);
+    }
+    if (call.bound_to_payer && lc(call.bound_to_payer) !== lc(q.payer)) {
+        fail("V14_MALFORMED", "bound_to_payer disagrees with the signed quote — do not submit this");
+    }
+    // §8.3 — hash the order id locally and compare. This is what stops a backend
+    // (or anything between it and here) from binding your payment to a different
+    // order than the one you asked about.
+    let orderIdChecked = false;
+    if (opts.orderId !== undefined) {
+        if (lc(keccak256(stringToHex(opts.orderId))) !== lc(q.orderIdHash)) {
+            fail("V14_ORDER_MISMATCH", `this quote settles a different order: orderIdHash does not match keccak256("${opts.orderId}")`);
+        }
+        orderIdChecked = true;
+    }
+    // §8.4 — expiry. Checked with headroom, because the relevant moment is when
+    // the transaction is MINED, not when it is signed.
+    const now = Math.floor((opts.nowMs ?? Date.now()) / 1000);
+    const expiresIn = Number(BigInt(q.validUntil) - BigInt(now));
+    const need = opts.minSecondsRemaining ?? 30;
+    if (expiresIn <= 0) {
+        fail("V14_EXPIRED", `quote expired ${-expiresIn}s ago — request a fresh one, do not submit this`);
+    }
+    if (expiresIn < need) {
+        fail("V14_EXPIRING", `quote expires in ${expiresIn}s, less than the ${need}s of headroom required — ` +
+            `it would likely revert SignatureExpired after you have paid gas`);
+    }
+    // §8.5 — msg.value must equal grossAmount exactly for native. The contract
+    // reverts IncorrectNativeValue on any difference, in either direction.
+    if (lc(q.token) === ZERO && String(call.value_wei) !== String(q.grossAmount)) {
+        fail("V14_VALUE_MISMATCH", `value_wei (${call.value_wei}) must equal the signed grossAmount (${q.grossAmount})`);
+    }
+    return { route: route, expiresInSeconds: expiresIn, orderIdChecked };
+}
+const NONCE_ABI = parseAbi([
+    "function consumedNonce(address,uint256) view returns (bool)",
+    "function payerNonce(address) view returns (uint256)",
+    "function paused() view returns (bool)",
+]);
+/**
+ * §8.6 — never re-broadcast a settled quote.
+ *
+ * The contract keeps two things and they answer different questions:
+ *   consumedNonce[payer][nonce]  has THIS nonce already been spent
+ *   payerNonce[payer]            which nonce the contract will accept next
+ *
+ * A quote is submittable only if its nonce is unspent AND is the one the
+ * contract expects. Two outstanding quotes for one wallet cannot both settle:
+ * the second carries a stale nonce and reverts InvalidNonce. That is a property
+ * of the contract, so it is reported here rather than discovered on-chain.
+ */
+export async function checkV14Submittable(publicClient, call) {
+    const q = call.args.quote;
+    const [spent, expected, paused] = await Promise.all([
+        publicClient.readContract({ address: call.contract, abi: NONCE_ABI, functionName: "consumedNonce", args: [q.payer, BigInt(q.nonce)] }),
+        publicClient.readContract({ address: call.contract, abi: NONCE_ABI, functionName: "payerNonce", args: [q.payer] }),
+        publicClient.readContract({ address: call.contract, abi: NONCE_ABI, functionName: "paused" }),
+    ]);
+    if (paused) {
+        return { submittable: false, code: "V14_PAUSED",
+            reason: "the splitter is paused — every settlement reverts until it is unpaused" };
+    }
+    if (spent) {
+        return { submittable: false, code: "V14_ALREADY_SETTLED",
+            reason: `nonce ${q.nonce} has already been spent by ${q.payer} — this quote is settled, do not pay twice` };
+    }
+    if (BigInt(expected) !== BigInt(q.nonce)) {
+        return { submittable: false, code: "V14_STALE_NONCE",
+            reason: `this quote was signed at nonce ${q.nonce} but the contract now expects ${expected} — ` +
+                `another payment from this wallet settled first; request a fresh quote` };
+    }
+    return { submittable: true };
+}
+/**
+ * v1.4 signing is quarantined. Its current signed Quote omits mutable profile
+ * fees and treasury. RPC preflight cannot bind those values at execution time.
+ * Keep the exported API for callers to handle the refusal, but provide no
+ * bypass: re-enabling requires a contract-bound economics commitment, reviewed
+ * deployment/signer/token pins, approval handling and mined-success recovery.
+ * Validation and nonce inspection above remain read-only diagnostics.
+ */
+export async function executeV14Settlement(_call, _ctx) {
+    throw new V14SettlementError("V14_SETTLEMENT_DISABLED", "v1.4 settlement is disabled: signed quotes do not bind mutable fees and treasury. " +
+        "Use a separately reviewed v1.3 route or wait for the contract and SDK upgrade; " +
+        "do not manually submit this quote or automatically fall back to another contract.");
+}
+//# sourceMappingURL=settlementV14.js.map

package/dist/settlementV14.js.map

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

package/dist/solanaDeploymentResolver.d.ts

@@ -0,0 +1,90 @@
+/**
+ * AIFINP-224 — SDK Environment & Protocol Version resolver (Solana).
+ *
+ * The Solana sibling of deploymentResolver.ts (AIFINP-223). Same idea — one
+ * place that answers "which deployment does the SDK use?" given an environment,
+ * a network and a requested version — shaped for Solana, where a deployment is
+ * a base58 program id + IDL rather than an EVM address record.
+ *
+ * Two axes, mirroring the EVM resolver:
+ *   environment — "dev" | "prod". Development supports devnet only; production
+ *     uses mainnet-beta. Both read their v1.4 artifacts from solana-contract's
+ *     dev branch (bundled in solanaV14Deployments.generated.ts).
+ *   version     — "v1.4" | "auto" (and "v1.2" is accepted at the type level for
+ *     parity with EVM). An explicit "v1.4" never silently downgrades.
+ *
+ * FALLBACK DIFFERS FROM EVM — READ THIS. The EVM resolver falls back v1.4 -> v1.2.
+ * Solana has NO v1.2-equivalent splitter: the old program was closed and removed
+ * from mainnet, and the SDK never bundled it (it reads the Solana program id at
+ * runtime from the bridge's pay_solana challenge). So there is nothing to fall
+ * back to. Therefore:
+ *   - "auto" resolves v1.4 where deployed, and otherwise throws
+ *     NoSolanaDeploymentError (no invented downgrade).
+ *   - an explicit "v1.2" always throws SolanaV12UnavailableError, because no
+ *     Solana v1.2 deployment exists.
+ * This is an open product question for Paul: whether the EVM v1.2/v1.4 fallback
+ * model should map onto Solana at all. Until a real Solana fallback exists, this
+ * resolver refuses to pretend one does.
+ *
+ * Program ids live in solanaV14Deployments.generated.ts, never inline here —
+ * this module is selection logic only.
+ */
+import { DeploymentResolverError, type SdkEnvironment } from "./deploymentResolver.js";
+import { type SolanaV14Deployment } from "./solanaV14Deployments.generated.js";
+/** Selectable protocol versions on the request side. "v1.2" exists for parity
+ *  with the EVM selector but has no Solana deployment behind it. */
+export type SolanaProtocolVersion = "v1.2" | "v1.4";
+/** What a caller may ask for. "auto" (the default) resolves v1.4, or throws if
+ *  it is not deployed for the environment+network — Solana has no fallback. */
+export type SolanaRequestedVersion = SolanaProtocolVersion | "auto";
+export interface ResolveSolanaDeploymentOptions {
+    environment: SdkEnvironment;
+    /** Cluster name: "devnet", or "mainnet"/"mainnet-beta". Case-insensitive. */
+    network: string;
+    /** Defaults to "auto". */
+    version?: SolanaRequestedVersion;
+}
+/** The resolved Solana deployment. Only v1.4 is ever returned; the field is
+ *  kept for symmetry with the EVM resolver's discriminated union. */
+export interface ResolvedSolanaDeployment {
+    version: "v1.4";
+    environment: SdkEnvironment;
+    network: "devnet" | "mainnet";
+    programId: string;
+    deployment: SolanaV14Deployment;
+}
+/** The development environment was asked for a cluster other than devnet. */
+export declare class UnsupportedSolanaDevNetworkError extends DeploymentResolverError {
+    readonly network: string;
+    constructor(network: string);
+}
+/** Explicit "v1.4" requested but not deployed for this environment+network.
+ *  Thrown rather than downgrading. */
+export declare class SolanaVersionUnavailableError extends DeploymentResolverError {
+    readonly requested: SolanaProtocolVersion;
+    constructor(requested: SolanaProtocolVersion, environment: SdkEnvironment, network: string);
+}
+/** Explicit "v1.2" requested — no Solana v1.2 splitter exists at all. Distinct
+ *  from SolanaVersionUnavailableError so callers can tell "not on this network"
+ *  from "does not exist on Solana". */
+export declare class SolanaV12UnavailableError extends DeploymentResolverError {
+    constructor();
+}
+/** No Solana v1.4 deployment exists for this environment+network, and Solana
+ *  has no fallback version. */
+export declare class NoSolanaDeploymentError extends DeploymentResolverError {
+    constructor(environment: SdkEnvironment, network: string);
+}
+/** Is a Solana v1.4 deployment available for this environment+network? */
+export declare function isSolanaV14Available(environment: SdkEnvironment, network: string): boolean;
+/**
+ * Resolve the Solana deployment the SDK should use. The single source of truth
+ * for Solana environment + protocol-version selection.
+ *
+ * @throws UnsupportedSolanaDevNetworkError  dev asked for a non-devnet cluster
+ * @throws SolanaV12UnavailableError         explicit v1.2 (none exists on Solana)
+ * @throws SolanaVersionUnavailableError     explicit v1.4 not deployed here
+ * @throws NoSolanaDeploymentError           auto, but no v1.4 for this env+network
+ */
+export declare function resolveSolanaDeployment(options: ResolveSolanaDeploymentOptions): ResolvedSolanaDeployment;
+//# sourceMappingURL=solanaDeploymentResolver.d.ts.map

package/dist/solanaDeploymentResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solanaDeploymentResolver.d.ts","sourceRoot":"","sources":["../src/solanaDeploymentResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAE7C;oEACoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD;+EAC+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,cAAc,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAED;qEACqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAID,6EAA6E;AAC7E,qBAAa,gCAAiC,SAAQ,uBAAuB;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM;CAS5B;AAED;sCACsC;AACtC,qBAAa,6BAA8B,SAAQ,uBAAuB;IACxE,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;gBAExC,SAAS,EAAE,qBAAqB,EAChC,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,MAAM;CAUlB;AAED;;uCAEuC;AACvC,qBAAa,yBAA0B,SAAQ,uBAAuB;;CASrE;AAED;+BAC+B;AAC/B,qBAAa,uBAAwB,SAAQ,uBAAuB;gBACtD,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM;CAOzD;AAsBD,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAET;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,wBAAwB,CAyC1B"}

package/dist/solanaDeploymentResolver.js

@@ -0,0 +1,143 @@
+/**
+ * AIFINP-224 — SDK Environment & Protocol Version resolver (Solana).
+ *
+ * The Solana sibling of deploymentResolver.ts (AIFINP-223). Same idea — one
+ * place that answers "which deployment does the SDK use?" given an environment,
+ * a network and a requested version — shaped for Solana, where a deployment is
+ * a base58 program id + IDL rather than an EVM address record.
+ *
+ * Two axes, mirroring the EVM resolver:
+ *   environment — "dev" | "prod". Development supports devnet only; production
+ *     uses mainnet-beta. Both read their v1.4 artifacts from solana-contract's
+ *     dev branch (bundled in solanaV14Deployments.generated.ts).
+ *   version     — "v1.4" | "auto" (and "v1.2" is accepted at the type level for
+ *     parity with EVM). An explicit "v1.4" never silently downgrades.
+ *
+ * FALLBACK DIFFERS FROM EVM — READ THIS. The EVM resolver falls back v1.4 -> v1.2.
+ * Solana has NO v1.2-equivalent splitter: the old program was closed and removed
+ * from mainnet, and the SDK never bundled it (it reads the Solana program id at
+ * runtime from the bridge's pay_solana challenge). So there is nothing to fall
+ * back to. Therefore:
+ *   - "auto" resolves v1.4 where deployed, and otherwise throws
+ *     NoSolanaDeploymentError (no invented downgrade).
+ *   - an explicit "v1.2" always throws SolanaV12UnavailableError, because no
+ *     Solana v1.2 deployment exists.
+ * This is an open product question for Paul: whether the EVM v1.2/v1.4 fallback
+ * model should map onto Solana at all. Until a real Solana fallback exists, this
+ * resolver refuses to pretend one does.
+ *
+ * Program ids live in solanaV14Deployments.generated.ts, never inline here —
+ * this module is selection logic only.
+ */
+import { DeploymentResolverError } from "./deploymentResolver.js";
+import { SOLANA_DEV_NETWORKS, SOLANA_V14_DEPLOYMENTS, } from "./solanaV14Deployments.generated.js";
+// ── Errors (parallel to the EVM resolver, Solana-worded) ─────────────────────
+/** The development environment was asked for a cluster other than devnet. */
+export class UnsupportedSolanaDevNetworkError extends DeploymentResolverError {
+    network;
+    constructor(network) {
+        super(`Development environment supports ${SOLANA_DEV_NETWORKS.join(", ")} only; ` +
+            `"${network}" is not a supported Solana development cluster. Use ` +
+            `environment "prod" for mainnet.`);
+        this.name = "UnsupportedSolanaDevNetworkError";
+        this.network = network;
+    }
+}
+/** Explicit "v1.4" requested but not deployed for this environment+network.
+ *  Thrown rather than downgrading. */
+export class SolanaVersionUnavailableError extends DeploymentResolverError {
+    requested;
+    constructor(requested, environment, network) {
+        super(`Solana ${requested} is not deployed for ${environment}/${network}. It ` +
+            `was requested explicitly, so the SDK will not substitute another ` +
+            `version.`);
+        this.name = "SolanaVersionUnavailableError";
+        this.requested = requested;
+    }
+}
+/** Explicit "v1.2" requested — no Solana v1.2 splitter exists at all. Distinct
+ *  from SolanaVersionUnavailableError so callers can tell "not on this network"
+ *  from "does not exist on Solana". */
+export class SolanaV12UnavailableError extends DeploymentResolverError {
+    constructor() {
+        super(`Solana has no v1.2 deployment. The previous Solana program was closed ` +
+            `and there is no v1.2-equivalent to fall back to; only v1.4 is available. ` +
+            `Use version "v1.4" or "auto".`);
+        this.name = "SolanaV12UnavailableError";
+    }
+}
+/** No Solana v1.4 deployment exists for this environment+network, and Solana
+ *  has no fallback version. */
+export class NoSolanaDeploymentError extends DeploymentResolverError {
+    constructor(environment, network) {
+        super(`No Solana v1.4 deployment is known for ${environment}/${network}, and ` +
+            `Solana has no fallback version.`);
+        this.name = "NoSolanaDeploymentError";
+    }
+}
+// ── Lookups ──────────────────────────────────────────────────────────────────
+/** Normalise a cluster name: lower-cased, and "mainnet-beta" -> "mainnet". */
+function normalizeNetwork(network) {
+    const n = network.trim().toLowerCase();
+    return n === "mainnet-beta" ? "mainnet" : n;
+}
+/** The v1.4 deployment for this environment+network, or undefined. A record is
+ *  only valid for the environment it was deployed under: devnet is dev-only and
+ *  must never resolve under "prod", and vice versa. */
+function findSolanaV14(environment, network) {
+    const entry = SOLANA_V14_DEPLOYMENTS[network];
+    if (!entry)
+        return undefined;
+    return entry.environment === environment ? entry : undefined;
+}
+/** Is a Solana v1.4 deployment available for this environment+network? */
+export function isSolanaV14Available(environment, network) {
+    return findSolanaV14(environment, normalizeNetwork(network)) !== undefined;
+}
+// ── The resolver ─────────────────────────────────────────────────────────────
+/**
+ * Resolve the Solana deployment the SDK should use. The single source of truth
+ * for Solana environment + protocol-version selection.
+ *
+ * @throws UnsupportedSolanaDevNetworkError  dev asked for a non-devnet cluster
+ * @throws SolanaV12UnavailableError         explicit v1.2 (none exists on Solana)
+ * @throws SolanaVersionUnavailableError     explicit v1.4 not deployed here
+ * @throws NoSolanaDeploymentError           auto, but no v1.4 for this env+network
+ */
+export function resolveSolanaDeployment(options) {
+    const { environment } = options;
+    if (environment !== "dev" && environment !== "prod") {
+        throw new DeploymentResolverError(`Unknown environment "${String(environment)}"; use "dev" or "prod".`);
+    }
+    const network = normalizeNetwork(options.network);
+    const requested = options.version ?? "auto";
+    // Development is restricted to devnet, whatever version is asked for. Reject
+    // any other development cluster rather than silently resolving mainnet.
+    if (environment === "dev" && !SOLANA_DEV_NETWORKS.includes(network)) {
+        throw new UnsupportedSolanaDevNetworkError(options.network);
+    }
+    const v14 = findSolanaV14(environment, network);
+    const asV14 = (d) => ({
+        version: "v1.4",
+        environment,
+        network: d.network,
+        programId: d.programId,
+        deployment: d,
+    });
+    switch (requested) {
+        case "v1.4":
+            if (v14)
+                return asV14(v14);
+            throw new SolanaVersionUnavailableError("v1.4", environment, options.network);
+        case "v1.2":
+            // No Solana v1.2 deployment exists — there is nothing to return.
+            throw new SolanaV12UnavailableError();
+        case "auto":
+            if (v14)
+                return asV14(v14);
+            throw new NoSolanaDeploymentError(environment, options.network);
+        default:
+            throw new DeploymentResolverError(`Unknown version "${String(requested)}"; use "v1.2", "v1.4" or "auto".`);
+    }
+}
+//# sourceMappingURL=solanaDeploymentResolver.js.map

package/dist/solanaDeploymentResolver.js.map

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

package/dist/solanaV14Deployments.generated.d.ts

@@ -0,0 +1,35 @@
+import type { SdkEnvironment } from "./deploymentResolver.js";
+/** Solana clusters the resolver understands. `dev` maps to devnet, `prod` to
+ *  mainnet-beta. */
+export type SolanaNetwork = "devnet" | "mainnet";
+/** A Solana splitter v1.4 deployment, as recorded by the deploy scripts. */
+export interface SolanaV14Deployment {
+    network: SolanaNetwork;
+    /** Which SDK environment this deployment belongs to: devnet is the dev
+     *  target, mainnet is prod. */
+    environment: SdkEnvironment;
+    splitterVersion: "1.4";
+    /** Base58 on-chain program id, from the deploy log's "Canonical program ID
+     *  confirmed" line. Never hardcoded in resolver logic — read from here. */
+    programId: string;
+    /** IDL metadata (Anchor), for callers that load the IDL. */
+    idl: {
+        name: string;
+        version: string;
+        /** Path of the source IDL artifact in solana-contract, for provenance. */
+        artifact: string;
+    };
+}
+/** Where this table came from, so a build can be traced to a commit. */
+export declare const SOLANA_V14_DEPLOYMENTS_SOURCE: {
+    readonly repo: "AiFinPay/solana-contract";
+    readonly branch: "dev";
+    readonly commit: "8a13d10d6210cd37345f7ae6684068bf849e24b1";
+    readonly path: "deployments/splitter_v14/";
+};
+/** Solana v1.4 deployments, keyed by cluster. Devnet is dev-only; mainnet is
+ *  prod-only. Absence of a cluster here means no v1.4 deployment for it. */
+export declare const SOLANA_V14_DEPLOYMENTS: Record<string, SolanaV14Deployment>;
+/** The single development cluster Solana v1.4 supports today. */
+export declare const SOLANA_DEV_NETWORKS: readonly ["devnet"];
+//# sourceMappingURL=solanaV14Deployments.generated.d.ts.map

package/dist/solanaV14Deployments.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solanaV14Deployments.generated.d.ts","sourceRoot":"","sources":["../src/solanaV14Deployments.generated.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;oBACoB;AACpB,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjD,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB;mCAC+B;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,eAAe,EAAE,KAAK,CAAC;IACvB;+EAC2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,0EAA0E;QAC1E,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,wEAAwE;AACxE,eAAO,MAAM,6BAA6B;;;;;CAKhC,CAAC;AAEX;4EAC4E;AAC5E,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAyBtE,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,qBAAsB,CAAC"}