@aifinpay/agent 1.8.2 → 2.0.0-rc.12

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBtF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,uDAAuD;AACvD,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAUpB,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,4EAA4E;AAC5E,oEAAoE;AACpE,uEAAuE;AACvE,0EAA0E;AAC1E,OAAO,EACL,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,iBAAiB,CAAC;AAQzB,2EAA2E;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAQjC,+EAA+E;AAC/E,6EAA6E;AAC7E,8BAA8B;AAC9B,OAAO,EAEL,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EAChC,oBAAoB,EACpB,kCAAkC,EAClC,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,EACnB,iCAAiC,EACjC,iCAAiC,EACjC,kCAAkC,EAClC,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAa5B,4EAA4E;AAC5E,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kCAAkC,EAClC,yBAAyB,EACzB,iCAAiC,EACjC,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,cAAc,oBAAoB,CAAC;AAenC,6EAA6E;AAC7E,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhD,4EAA4E;AAC5E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AAOvC,4EAA4E;AAC5E,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,gCAAgC,EAChC,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAM7C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBtF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,4EAA4E;AAC5E,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAC;AAapB,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,OAAO,EACL,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,iBAAiB,CAAC;AAQzB,4EAA4E;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EAEL,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/localIdentity.d.ts

@@ -0,0 +1,17 @@
+type LocalWalletIdentity = {
+    source: "SEED_HASH" | "agents.json";
+    seedHash: string;
+    secretB58?: never;
+} | {
+    source: "AIFINPAY_AGENT_SECRET" | "legacy-keystore";
+    secretB58: string;
+    seedHash?: never;
+};
+/**
+ * Internal load-only adapter for the same identity files used by MCP.
+ * Keep source precedence and encryption format aligned with mcp/src/identity.ts.
+ * No file is created, changed or logged; returned key material stays local.
+ */
+export declare function loadLocalWalletIdentity(): LocalWalletIdentity;
+export {};
+//# sourceMappingURL=localIdentity.d.ts.map

package/dist/localIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localIdentity.d.ts","sourceRoot":"","sources":["../src/localIdentity.ts"],"names":[],"mappings":"AAMA,KAAK,mBAAmB,GACpB;IAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,GAC5E;IAAE,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAqBjG;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,mBAAmB,CAkD7D"}

package/dist/localIdentity.js

@@ -0,0 +1,81 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { createDecipheriv, scryptSync } from "node:crypto";
+import { AiFinPayError } from "./errors.js";
+function seed(value) {
+    if (typeof value !== "string" || !/^(0x)?[0-9a-fA-F]{64}$/.test(value)) {
+        throw new AiFinPayError("SEED_HASH must contain a 32-byte hex seed (64 hex characters); no mnemonic or double hashing");
+    }
+    return value.replace(/^0x/, "");
+}
+function object(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readJson(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (object(parsed))
+            return parsed;
+    }
+    catch { /* File contents and parse errors may contain private material. */ }
+    throw new AiFinPayError(`Cannot read wallet JSON at ${path}; refusing to generate a replacement wallet`);
+}
+/**
+ * Internal load-only adapter for the same identity files used by MCP.
+ * Keep source precedence and encryption format aligned with mcp/src/identity.ts.
+ * No file is created, changed or logged; returned key material stays local.
+ */
+export function loadLocalWalletIdentity() {
+    const env = process.env;
+    if (env.SEED_HASH !== undefined)
+        return { source: "SEED_HASH", seedHash: seed(env.SEED_HASH) };
+    const projectPath = resolve(env.AIFINPAY_AGENTS_FILE || "./aifinpay/agents.json");
+    if (existsSync(projectPath)) {
+        const document = readJson(projectPath);
+        const agents = document.agents;
+        if (!Array.isArray(agents) || agents.length === 0) {
+            throw new AiFinPayError("agents.json requires a non-empty agents array");
+        }
+        const matches = env.AIFINPAY_AGENT_ID
+            ? agents.filter((agent) => object(agent) && agent.id === env.AIFINPAY_AGENT_ID)
+            : agents;
+        if (matches.length !== 1) {
+            throw new AiFinPayError("Select exactly one agents.json record with AIFINPAY_AGENT_ID; refusing an ambiguous wallet");
+        }
+        return { source: "agents.json", seedHash: seed(object(matches[0]) ? matches[0].seed_hash : undefined) };
+    }
+    if (env.AIFINPAY_AGENTS_FILE)
+        throw new AiFinPayError("Configured AIFINPAY_AGENTS_FILE does not exist");
+    if (env.AIFINPAY_AGENT_SECRET) {
+        return { source: "AIFINPAY_AGENT_SECRET", secretB58: env.AIFINPAY_AGENT_SECRET };
+    }
+    const legacyPath = join(env.AIFINPAY_HOME || join(homedir(), ".aifinpay"), "agent.json");
+    if (!existsSync(legacyPath)) {
+        throw new AiFinPayError("No persistent wallet configured; configure SEED_HASH, aifinpay/agents.json, AIFINPAY_AGENT_SECRET or an existing MCP keystore before loading an agent");
+    }
+    const legacy = readJson(legacyPath);
+    if (legacy.enc) {
+        if (legacy.enc !== "scrypt-aes-256-gcm" || !env.AIFINPAY_WALLET_PASSPHRASE) {
+            throw new AiFinPayError("Encrypted keystore requires AIFINPAY_WALLET_PASSPHRASE and the supported encryption format");
+        }
+        try {
+            if (![legacy.salt, legacy.iv, legacy.tag, legacy.ct].every((value) => typeof value === "string")) {
+                throw new Error("Invalid encrypted fields");
+            }
+            const key = scryptSync(env.AIFINPAY_WALLET_PASSPHRASE, Buffer.from(legacy.salt, "base64"), 32, { N: 1 << 15, r: 8, p: 1, maxmem: 64 * 1024 * 1024 });
+            const decipher = createDecipheriv("aes-256-gcm", key, Buffer.from(legacy.iv, "base64"));
+            decipher.setAuthTag(Buffer.from(legacy.tag, "base64"));
+            return { source: "legacy-keystore", secretB58: Buffer.concat([
+                    decipher.update(Buffer.from(legacy.ct, "base64")), decipher.final(),
+                ]).toString("utf8") };
+        }
+        catch {
+            throw new AiFinPayError("Cannot decrypt keystore; refusing to generate a replacement wallet");
+        }
+    }
+    if (typeof legacy.secretB58 !== "string" || !legacy.secretB58)
+        throw new AiFinPayError("Invalid legacy keystore");
+    return { source: "legacy-keystore", secretB58: legacy.secretB58 };
+}
+//# sourceMappingURL=localIdentity.js.map

package/dist/localIdentity.js.map

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

package/dist/settlement.d.ts

@@ -0,0 +1,198 @@
+import { type Address, type Hex, type PublicClient, type WalletClient } from "viem";
+export type SettlementRouteClass = "AIFP-1" | "AIFP-2";
+export type SettlementEvmNetwork = "polygon" | "avalanche" | "arbitrum" | "bnb" | "base" | "unichain" | "optimism" | "botchain" | "xrplevm" | "amoy";
+export interface SettlementRoute {
+    route_class: SettlementRouteClass;
+    profile: {
+        route_class: SettlementRouteClass;
+        settlement_semantics: "gross-inclusive";
+        treasury_bps: number;
+        creator_bps: number;
+        fee_on_top: false;
+        required_splitter_version: "1.3";
+    };
+    network: SettlementEvmNetwork;
+    chain_id: number;
+    name: string;
+    native_asset: string;
+    stable_assets: Record<string, {
+        address: Address;
+        decimals: number;
+        issuer: string;
+    }>;
+    explorer: string;
+    live: boolean;
+    testnet?: boolean;
+    splitter?: Address;
+    splitter_version?: "1.3";
+    runtime_code_hash?: Hex;
+    disabled_reason?: string;
+}
+/**
+ * Independent release trust anchor. This value must come from a reviewed SDK
+ * release/config artifact, not from the same backend response as the invoice.
+ */
+export interface TrustedSettlementRoutePin {
+    route_class: SettlementRouteClass;
+    chain: SettlementEvmNetwork;
+    chain_id: number;
+    splitter_version: "1.3";
+    splitter: Address;
+    runtime_code_hash: Hex;
+    /** Must be explicitly true for Amoy signing; omitted means mainnet only. */
+    testnet?: boolean;
+    /** Independently reviewed asset identities; required for stable settlement. */
+    stable_assets?: Readonly<Record<string, {
+        address: Address;
+        decimals: number;
+    }>>;
+}
+export type TrustedSettlementRouteRegistry = Partial<Record<SettlementRouteClass, Partial<Record<SettlementEvmNetwork, TrustedSettlementRoutePin>>>>;
+export interface SettlementInvoiceInput {
+    route_class: SettlementRouteClass;
+    chain: SettlementEvmNetwork;
+    asset: string;
+    gross_amount: string | bigint;
+    merchant_wallet?: Address;
+    provider_wallet?: Address;
+    order_id: string;
+    valid_until?: number;
+}
+interface SettlementBreakdown {
+    gross_amount: string;
+    merchant_amount: string;
+    protocol_fee_amount: string;
+    creator_amount: string;
+    protocol_fee_bps: number;
+    creator_bps: number;
+}
+interface SettlementInvoiceBase {
+    route_class: SettlementRouteClass;
+    chain: SettlementEvmNetwork;
+    chain_id: number;
+    splitter_version: "1.3";
+    splitter: Address;
+    runtime_code_hash: Hex;
+    settlement_semantics: "gross-inclusive";
+    fee_on_top: false;
+    asset: string;
+    payment_id: Hex;
+    order_id: string;
+    valid_until: number;
+    merchant_wallet: Address;
+    breakdown: SettlementBreakdown;
+    authorization: string;
+}
+export interface NativeSettlementInvoice extends SettlementInvoiceBase {
+    transaction: {
+        kind: "evm_contract_call";
+        function: "payNative((bytes32,address,uint256,address,uint256,string))";
+        args: {
+            paymentId: Hex;
+            merchant: Address;
+            grossAmount: string;
+            ipCreator: Address;
+            validUntil: number;
+            orderId: string;
+        };
+        value: string;
+    };
+    token?: never;
+}
+export interface StableSettlementInvoice extends SettlementInvoiceBase {
+    token: {
+        address: Address;
+        decimals: number;
+        issuer: string;
+    };
+    transaction: {
+        kind: "evm_erc20_then_contract_call";
+        approve: {
+            token: Address;
+            function: "approve(address,uint256)";
+            spender: Address;
+            amount: string;
+        };
+        settle: {
+            function: "payStable((bytes32,address,uint256,address,address,uint256,string))";
+            args: {
+                paymentId: Hex;
+                token: Address;
+                grossAmount: string;
+                merchant: Address;
+                ipCreator: Address;
+                validUntil: number;
+                orderId: string;
+            };
+            value: "0";
+        };
+    };
+}
+export type SettlementInvoice = NativeSettlementInvoice | StableSettlementInvoice;
+export interface SettlementExecution {
+    route_class: SettlementRouteClass;
+    chain: SettlementEvmNetwork;
+    payment_id: Hex;
+    approval_txs: Hex[];
+    settlement_tx: Hex;
+    block_number: bigint;
+}
+export declare class SettlementProtocolError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/** Broadcast succeeded but confirmation is unknown. Keep this hash and check
+ * it before retrying; a timeout is not evidence that no money moved. */
+export declare class SettlementConfirmationPendingError extends SettlementProtocolError {
+    readonly txHash: Hex;
+    readonly stage: "approval" | "settlement";
+    constructor(txHash: Hex, stage: "approval" | "settlement");
+}
+/** Strictly validate an invoice before any wallet signs. */
+export declare function validateSettlementInvoice(invoice: SettlementInvoice): void;
+/** Verify that a backend invoice matches an independently trusted release pin. */
+export declare function validateTrustedSettlementRoutePin(invoice: SettlementInvoice, pin: TrustedSettlementRoutePin): void;
+export interface SettlementClientOptions {
+    baseUrl?: string;
+    /** Supply the caller's guarded transport, e.g. MCP's safe fetch. */
+    fetchImpl?: typeof fetch;
+    /** Covers the response body as well as the HTTP request. Default 15 seconds. */
+    timeoutMs?: number;
+}
+export declare class SettlementClient {
+    readonly baseUrl: string;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(options?: string | SettlementClientOptions);
+    private request;
+    routes(routeClass?: SettlementRouteClass): Promise<SettlementRoute[]>;
+    invoice(input: SettlementInvoiceInput): Promise<SettlementInvoice>;
+}
+/** Verify trusted deployment evidence against chain immediately before signing. */
+export declare function verifySettlementRouteOnChain(invoice: SettlementInvoice, publicClient: PublicClient, trustedPin: TrustedSettlementRoutePin): Promise<void>;
+/** Execute a v1.3 invoice only after matching an independent trusted route pin. */
+export declare function executeSettlementInvoice(invoice: SettlementInvoice, walletClient: WalletClient, publicClient: PublicClient, trustedPin: TrustedSettlementRoutePin): Promise<SettlementExecution>;
+export declare const SETTLEMENT_CHAIN_IDS: Readonly<{
+    polygon: number;
+    base: number;
+    arbitrum: number;
+    optimism: number;
+    avalanche: number;
+    unichain: number;
+    botchain: number;
+    xrplevm: number;
+    bnb: number;
+    amoy: number;
+}>;
+export declare const SETTLEMENT_EXPECTED_BPS: Readonly<{
+    "AIFP-1": {
+        treasury: number;
+        creator: number;
+    };
+    "AIFP-2": {
+        treasury: number;
+        creator: number;
+    };
+}>;
+export {};
+//# sourceMappingURL=settlement.d.ts.map

package/dist/settlement.d.ts.map

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