@aifinpay/agent 1.8.4 → 2.0.0-rc.12

package/dist/solanaV14Deployments.generated.js

@@ -0,0 +1,61 @@
+// DO NOT EDIT BY HAND. Bundled copy of the Solana splitter v1.4 deployment
+// artifacts from AiFinPay/solana-contract, so a shipped build resolves the
+// Solana program id without a runtime GitHub fetch — the same discipline as
+// v14Deployments.generated.ts (EVM) and splitterRoutes.generated.ts.
+//
+// Source: AiFinPay/solana-contract @ dev (commit
+// 8a13d10d6210cd37345f7ae6684068bf849e24b1), files:
+//   deployments/splitter_v14/splitter.mainnet.20260910-170049.json  (mainnet IDL)
+//   deployments/splitter_v14/splitter-mainnet-deploy-20260910-170049.log
+//   deployments/splitter_v14/splitter.devnet.20260910-143306.json   (devnet IDL)
+//   deployments/splitter_v14/splitter-deploy-20260910-143306.log
+//
+// To refresh: read the same files off solana-contract's dev branch, e.g.
+//   git show origin/dev:deployments/splitter_v14/splitter.mainnet.<ts>.json
+// and update the program ids below. Development deployments are, by design,
+// devnet; production is mainnet-beta. The program id in each entry is the
+// canonical program id confirmed in the deploy log for that cluster.
+//
+// NOTE ON FALLBACK: unlike EVM (which falls back v1.4 -> v1.2), Solana has NO
+// v1.2-equivalent splitter to fall back to. The previous Solana program
+// (5g9zWHF1Vv6GiGpA2ZbJQbSCDZd5hAk9AyvabRJvKFx2) was closed and removed from
+// mainnet, and the SDK never bundled it — it takes the program id at runtime
+// from the bridge's pay_solana challenge. So the Solana resolver offers v1.4
+// only; "auto" resolves v1.4 and raises a typed no-deployment error where v1.4
+// is absent rather than inventing a downgrade.
+/** Where this table came from, so a build can be traced to a commit. */
+export const SOLANA_V14_DEPLOYMENTS_SOURCE = {
+    repo: "AiFinPay/solana-contract",
+    branch: "dev",
+    commit: "8a13d10d6210cd37345f7ae6684068bf849e24b1",
+    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 const SOLANA_V14_DEPLOYMENTS = {
+    devnet: {
+        network: "devnet",
+        environment: "dev",
+        splitterVersion: "1.4",
+        programId: "Dg9v95m6ofTwaU9V69PNAyRaKeELwxrne4THUYuUTeon",
+        idl: {
+            name: "splitter",
+            version: "1.4.1",
+            artifact: "deployments/splitter_v14/splitter.devnet.20260910-143306.json",
+        },
+    },
+    mainnet: {
+        network: "mainnet",
+        environment: "prod",
+        splitterVersion: "1.4",
+        programId: "8dty5bD738Z9TzEkDu8vLSnhpJNWtEGMUEcYaKCUTY6y",
+        idl: {
+            name: "splitter",
+            version: "1.4.1",
+            artifact: "deployments/splitter_v14/splitter.mainnet.20260910-170049.json",
+        },
+    },
+};
+/** The single development cluster Solana v1.4 supports today. */
+export const SOLANA_DEV_NETWORKS = ["devnet"];
+//# sourceMappingURL=solanaV14Deployments.generated.js.map

package/dist/solanaV14Deployments.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solanaV14Deployments.generated.js","sourceRoot":"","sources":["../src/solanaV14Deployments.generated.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,qEAAqE;AACrE,EAAE;AACF,iDAAiD;AACjD,oDAAoD;AACpD,kFAAkF;AAClF,yEAAyE;AACzE,iFAAiF;AACjF,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,qEAAqE;AACrE,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,+CAA+C;AA2B/C,wEAAwE;AACxE,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,IAAI,EAAE,0BAA0B;IAChC,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,0CAA0C;IAClD,IAAI,EAAE,2BAA2B;CACzB,CAAC;AAEX;4EAC4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAwC;IACzE,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,8CAA8C;QACzD,GAAG,EAAE;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,OAAO;YAChB,QAAQ,EACN,+DAA+D;SAClE;KACF;IACD,OAAO,EAAE;QACP,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,MAAM;QACnB,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,8CAA8C;QACzD,GAAG,EAAE;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,OAAO;YAChB,QAAQ,EACN,gEAAgE;SACnE;KACF;CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAQ,CAAU,CAAC"}

package/dist/splitterRoutes.d.ts

@@ -0,0 +1,120 @@
+/**
+ * v1.3 splitter selection, keyed by chain AND protocol route.
+ *
+ * From v1.3 a chain carries one splitter per protocol route, because the fee
+ * split is immutable at construction and the two protocols need different
+ * economics:
+ *
+ *   merchant-aifp1 (100/0) — the agent pays the quoted gross amount, the
+ *     AiFinPay treasury receives 1%, the merchant receives 99%.
+ *   agent-x402 (0/0) — the provider receives 100% of the provider-defined
+ *     price and the AiFinPay fee is 0% for now. This route is NOT fee-on-top;
+ *     fee-on-top semantics arrive in a future contract version.
+ *
+ * Selection must use both chain and route, and must never fall back from one
+ * route to the other. That is not a style preference. The splitters were
+ * deployed with CREATE, so an address derives from deployer and nonce and the
+ * same address recurs on other chains for the other route:
+ *
+ *   0x1Fe2021336596655Fac72bC7bC40F7FFFA501d55
+ *     is OP's merchant-aifp1 AND Base's agent-x402
+ *   0xF03B3387415D557b6ab709D06E8aF0b4ABD6Eb74
+ *     is Unichain's merchant-aifp1, Avalanche's agent-x402, AND the legacy
+ *     v1.2 splitter on Optimism
+ *
+ * An address on its own therefore says nothing about which economics apply.
+ * Resolving by chain alone would settle at the wrong fee split, silently,
+ * and the amounts would still look plausible in every log.
+ *
+ * The table itself is NOT in this file. It is generated into
+ * splitterRoutes.generated.ts from registry/splitter-table.json, a byte-for-byte
+ * copy of the canonical artifact in AiFinPay/evm-contract, where every
+ * payment-critical field — splitter, owner, treasury, both bps values, the
+ * runtime code hash — was read from the chain by verify-registry.mjs. Two
+ * repositories hand-maintaining the same payout addresses is the failure this
+ * split prevents; `npm run registry:check` fails CI if they disagree.
+ *
+ * What stays here is the part worth reading: the types, the errors, and the two
+ * resolvers. Logic belongs in a reviewed file, not in a generated one.
+ */
+import type { Chain } from "viem/chains";
+export { SPLITTER_ROUTES, SPLITTER_GOVERNANCE, SPLITTER_REGISTRY_SOURCE, } from "./splitterRoutes.generated.js";
+/** Protocol routes. A route is a fee profile fixed at construction. */
+export type SplitterRoute = "merchant-aifp1" | "agent-x402";
+/** Chains carrying v1.3 route splitters. */
+export type SplitterRouteChain = "amoy" | "polygon" | "optimism" | "bnb" | "unichain" | "botchain" | "base" | "arbitrum" | "avalanche" | "xrplevm";
+/** Key into SPLITTER_ROUTES. Both halves are required. */
+export type SplitterRouteKey = `${SplitterRouteChain}:${SplitterRoute}`;
+export interface SplitterRouteDeployment {
+    chain: SplitterRouteChain;
+    route: SplitterRoute;
+    chainId: number;
+    viemChain: Chain;
+    splitter: `0x${string}`;
+    /**
+     * The governance Safe, read from the contract's own owner(). It controls
+     * pause/unpause, the treasury address and the stablecoin whitelist, so it is
+     * carried here rather than assumed: every other field is only as trustworthy
+     * as whoever can change it.
+     */
+    owner: `0x${string}`;
+    /** Owner and treasury are the same governance Safe on every chain. */
+    treasury: `0x${string}`;
+    /** Immutable, baked into runtime code. 100 = 1%. */
+    treasuryBps: number;
+    ipCreatorBps: number;
+    /** keccak-256 of the deployed runtime bytecode, read from chain. */
+    runtimeCodeHash: `0x${string}`;
+    /**
+     * Deployed and verified is not the same as payable. A route is enabled
+     * individually, and only after a successful mainnet paid end-to-end
+     * settlement on that exact route with verified balance deltas.
+     */
+    settlementEnabled: boolean;
+    /** Testnet entries require an explicit opt-in; they never activate mainnet. */
+    testnet: boolean;
+    /**
+     * How many independent RPC providers agreed on every field above when the
+     * registry was verified. A route verified from one provider can never be
+     * enabled — BOT Chain and XRPL EVM have exactly one public provider each.
+     */
+    rpcQuorum: number;
+    /**
+     * Stablecoins the splitter accepts, read live via whitelistedTokens() and
+     * owner-mutable, so pinned separately from the runtime hash. null = not
+     * accepted on this chain; a chain with both null settles native only.
+     */
+    stablecoins: {
+        USDC: `0x${string}` | null;
+        USDT: `0x${string}` | null;
+    };
+    /** Policy review window. Outside it, a route must not settle. */
+    validFrom: string;
+    validUntil: string;
+    defaultRpc: string;
+    explorer: string;
+    /** The date the fields above were last read from the chain. */
+    verifiedAt: string;
+}
+export declare class UnknownSplitterRouteError extends Error {
+    constructor(chain: string, route: string);
+}
+export declare class SplitterRouteNotSettlingError extends Error {
+    constructor(key: string, reason: string);
+}
+/**
+ * Resolve a splitter by chain AND route. Throws on an unknown pair rather
+ * than falling back, because the fallback is the bug: every route resolves to
+ * a real, deployed, working contract with the wrong economics.
+ */
+export declare function resolveSplitterRoute(chain: SplitterRouteChain | string, route: SplitterRoute | string): SplitterRouteDeployment;
+/**
+ * Resolve a route that is cleared to move money. Separate from
+ * resolveSplitterRoute on purpose: reading the registry and being allowed to
+ * settle are different questions, and conflating them is how a disabled route
+ * ends up paying.
+ */
+export declare function resolveSettlingSplitterRoute(chain: SplitterRouteChain | string, route: SplitterRoute | string, now?: Date, options?: {
+    allowTestnet?: boolean;
+}): SplitterRouteDeployment;
+//# sourceMappingURL=splitterRoutes.d.ts.map

package/dist/splitterRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitterRoutes.d.ts","sourceRoot":"","sources":["../src/splitterRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,uEAAuE;AACvE,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAE5D,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,SAAS,GACT,UAAU,GACV,KAAK,GACL,UAAU,GACV,UAAU,GACV,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,CAAC;AAEd,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,GAAG,kBAAkB,IAAI,aAAa,EAAE,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;IACjB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,sEAAsE;IACtE,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE;QAAE,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,KAAK,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IACxE,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAUzC;AAED,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIxC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAClC,KAAK,EAAE,aAAa,GAAG,MAAM,GAC5B,uBAAuB,CAMzB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAClC,KAAK,EAAE,aAAa,GAAG,MAAM,EAC7B,GAAG,GAAE,IAAiB,EACtB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,uBAAuB,CAoDzB"}

package/dist/splitterRoutes.generated.d.ts

@@ -0,0 +1,22 @@
+import type { SplitterRouteDeployment, SplitterRouteKey } from "./splitterRoutes.js";
+/** Where this table came from, so a deployed build can be traced to a commit. */
+export declare const SPLITTER_REGISTRY_SOURCE: {
+    readonly repo: "AiFinPay/evm-contract";
+    readonly path: "registry/generated/splitter-table.json";
+    readonly commit: "64e245fd613e97f95195239238d6ac75484a8a21";
+    readonly artifactSha256: "36ee672b1deccd7b851460b459af26984ca07802477bc8c1e78018f5d5154827";
+    readonly schemaVersion: 4;
+    readonly registryUpdatedAt: "2026-08-30";
+};
+/**
+ * The governance Safe that owns every splitter below, and the exact signer
+ * shape it was verified under. Read from the chain by verify-registry.mjs, which
+ * compares the signer set and threshold exactly rather than as a floor.
+ */
+export declare const SPLITTER_GOVERNANCE: {
+    readonly safe: "0xFd936f75D9221949f2FEaB54Cd342F7527154eD5";
+    readonly threshold: 3;
+    readonly owners: readonly ["0x2118c57dEBD53f614DDfE464Ff2941BE6646cA82", "0x3C31dd9daCeC5473cC9B660CD69247A20701cF19", "0x25A834b6fEC79e9ee6ED04Ef5b97440149C6Cc24", "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9", "0x849930eB20ED0a697c71BcE565f18702D202C0F8"];
+};
+export declare const SPLITTER_ROUTES: Record<SplitterRouteKey, SplitterRouteDeployment>;
+//# sourceMappingURL=splitterRoutes.generated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splitterRoutes.generated.d.ts","sourceRoot":"","sources":["../src/splitterRoutes.generated.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAErF,iFAAiF;AACjF,eAAO,MAAM,wBAAwB;;;;;;;CAO3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;CAUtB,CAAC;AAEX,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAqa7E,CAAC"}