@aifinpay/agent 2.3.2 → 2.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/PAYMENT_RECEIPTS.md +194 -19
  2. package/README.md +37 -17
  3. package/dist/agentHistory.d.ts +9 -0
  4. package/dist/agentHistory.d.ts.map +1 -1
  5. package/dist/agentHistory.js +110 -16
  6. package/dist/agentHistory.js.map +1 -1
  7. package/dist/aifp1.d.ts +124 -17
  8. package/dist/aifp1.d.ts.map +1 -1
  9. package/dist/aifp1.js +580 -82
  10. package/dist/aifp1.js.map +1 -1
  11. package/dist/deploymentErrors.d.ts +5 -0
  12. package/dist/deploymentErrors.d.ts.map +1 -0
  13. package/dist/deploymentErrors.js +8 -0
  14. package/dist/deploymentErrors.js.map +1 -0
  15. package/dist/deploymentResolver.d.ts +2 -3
  16. package/dist/deploymentResolver.d.ts.map +1 -1
  17. package/dist/deploymentResolver.js +2 -6
  18. package/dist/deploymentResolver.js.map +1 -1
  19. package/dist/generated/solanaV14Deployments.generated.d.ts +1 -0
  20. package/dist/generated/solanaV14Deployments.generated.d.ts.map +1 -1
  21. package/dist/generated/solanaV14Deployments.generated.js +4 -2
  22. package/dist/generated/solanaV14Deployments.generated.js.map +1 -1
  23. package/dist/generated/v14Deployments.generated.d.ts +1 -1
  24. package/dist/generated/v14Deployments.generated.js +1 -1
  25. package/dist/index.d.ts +8 -3
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +9 -3
  28. package/dist/index.js.map +1 -1
  29. package/dist/paymentChains.d.ts +95 -0
  30. package/dist/paymentChains.d.ts.map +1 -0
  31. package/dist/paymentChains.js +116 -0
  32. package/dist/paymentChains.js.map +1 -0
  33. package/dist/settlement.d.ts +5 -5
  34. package/dist/settlementSolanaV14.d.ts +135 -0
  35. package/dist/settlementSolanaV14.d.ts.map +1 -0
  36. package/dist/settlementSolanaV14.js +733 -0
  37. package/dist/settlementSolanaV14.js.map +1 -0
  38. package/dist/settlementV14.d.ts +9 -2
  39. package/dist/settlementV14.d.ts.map +1 -1
  40. package/dist/settlementV14.js +81 -14
  41. package/dist/settlementV14.js.map +1 -1
  42. package/dist/solanaDeploymentResolver.d.ts +2 -1
  43. package/dist/solanaDeploymentResolver.d.ts.map +1 -1
  44. package/dist/solanaDeploymentResolver.js +1 -32
  45. package/dist/solanaDeploymentResolver.js.map +1 -1
  46. package/dist/spendLedger.d.ts +74 -33
  47. package/dist/spendLedger.d.ts.map +1 -1
  48. package/dist/spendLedger.js +523 -130
  49. package/dist/spendLedger.js.map +1 -1
  50. package/dist/unifiedAgent.d.ts +17 -8
  51. package/dist/unifiedAgent.d.ts.map +1 -1
  52. package/dist/unifiedAgent.js +222 -37
  53. package/dist/unifiedAgent.js.map +1 -1
  54. package/package.json +4 -4
  55. package/dist/cli.d.ts +0 -3
  56. package/dist/cli.d.ts.map +0 -1
  57. package/dist/cli.js +0 -127
  58. package/dist/cli.js.map +0 -1
  59. package/dist/solanaV14Deployments.generated.d.ts +0 -35
  60. package/dist/solanaV14Deployments.generated.d.ts.map +0 -1
  61. package/dist/solanaV14Deployments.generated.js +0 -61
  62. package/dist/solanaV14Deployments.generated.js.map +0 -1
  63. package/dist/splitterRoutes.generated.d.ts +0 -22
  64. package/dist/splitterRoutes.generated.d.ts.map +0 -1
  65. package/dist/splitterRoutes.generated.js +0 -459
  66. package/dist/splitterRoutes.generated.js.map +0 -1
  67. package/dist/v14Deployments.generated.d.ts +0 -53
  68. package/dist/v14Deployments.generated.d.ts.map +0 -1
  69. package/dist/v14Deployments.generated.js +0 -89
  70. package/dist/v14Deployments.generated.js.map +0 -1
@@ -0,0 +1,116 @@
1
+ import { V14_DEPLOYMENTS } from "./generated/v14Deployments.generated.js";
2
+ /** Owner-selectable EVM execution environments. Listing is not production activation. */
3
+ export const PAYMENT_CHAINS = Object.freeze({
4
+ polygon: {
5
+ chainId: 137,
6
+ label: "Polygon",
7
+ native: "POL",
8
+ gasModel: "evm",
9
+ defaultRpc: "https://polygon.drpc.org",
10
+ coingeckoId: "polygon-ecosystem-token",
11
+ maxSaneUsd: 1000,
12
+ },
13
+ base: {
14
+ chainId: 8453,
15
+ label: "Base",
16
+ native: "ETH",
17
+ gasModel: "op",
18
+ defaultRpc: "https://mainnet.base.org",
19
+ coingeckoId: "ethereum",
20
+ maxSaneUsd: 100000,
21
+ },
22
+ optimism: {
23
+ chainId: 10,
24
+ label: "Optimism",
25
+ native: "ETH",
26
+ gasModel: "op",
27
+ defaultRpc: "https://mainnet.optimism.io",
28
+ coingeckoId: "ethereum",
29
+ maxSaneUsd: 100000,
30
+ },
31
+ arbitrum: {
32
+ chainId: 42161,
33
+ label: "Arbitrum",
34
+ native: "ETH",
35
+ gasModel: "nitro",
36
+ defaultRpc: "https://arb1.arbitrum.io/rpc",
37
+ coingeckoId: "ethereum",
38
+ maxSaneUsd: 100000,
39
+ },
40
+ avalanche: {
41
+ chainId: 43114,
42
+ label: "Avalanche",
43
+ native: "AVAX",
44
+ gasModel: "evm",
45
+ defaultRpc: "https://api.avax.network/ext/bc/C/rpc",
46
+ coingeckoId: "avalanche-2",
47
+ maxSaneUsd: 100000,
48
+ },
49
+ bnb: {
50
+ chainId: 56,
51
+ label: "BNB Chain",
52
+ native: "BNB",
53
+ gasModel: "evm",
54
+ defaultRpc: "https://bsc-dataseed1.bnbchain.org",
55
+ coingeckoId: "binancecoin",
56
+ maxSaneUsd: 100000,
57
+ },
58
+ unichain: {
59
+ chainId: 130,
60
+ label: "Unichain",
61
+ native: "ETH",
62
+ gasModel: "op",
63
+ defaultRpc: "https://mainnet.unichain.org",
64
+ coingeckoId: "ethereum",
65
+ maxSaneUsd: 100000,
66
+ },
67
+ xrplevm: {
68
+ chainId: 1440000,
69
+ label: "XRPL EVM",
70
+ native: "XRP",
71
+ gasModel: "evm",
72
+ defaultRpc: "https://rpc.xrplevm.org",
73
+ coingeckoId: "ripple",
74
+ maxSaneUsd: 1000,
75
+ },
76
+ robinhood: {
77
+ chainId: 4663,
78
+ label: "Robinhood",
79
+ native: "ETH",
80
+ gasModel: "nitro",
81
+ defaultRpc: "https://rpc.mainnet.chain.robinhood.com",
82
+ coingeckoId: "ethereum",
83
+ maxSaneUsd: 100000,
84
+ },
85
+ });
86
+ for (const descriptor of Object.values(PAYMENT_CHAINS))
87
+ Object.freeze(descriptor);
88
+ /** Unknown names never fall through to a default or to the deprecated BOT network. */
89
+ export function paymentChain(name) {
90
+ return Object.hasOwn(PAYMENT_CHAINS, name) ? PAYMENT_CHAINS[name] : undefined;
91
+ }
92
+ // Independent decimal pins, keyed by network AND token address. The registry
93
+ // still selects the allowed address; a new symbol/address cannot inherit 6.
94
+ // BNB and Robinhood18dp were read on2026-10-04 (release evidence). Other
95
+ // addresses retain the shipped6dp pins. XRPL EVM has no pinned stablecoin.
96
+ const TOKEN_DECIMALS = {
97
+ polygon: { "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359": 6, "0x2791bca1f2de4661ed88a30c99a7a9449aa84174": 6 },
98
+ base: { "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913": 6 },
99
+ optimism: { "0x0b2c639c533813f4aa9d7837caf62653d097ff85": 6 },
100
+ arbitrum: { "0xaf88d065e77c8cc2239327c5edb3a432268e5831": 6 },
101
+ avalanche: { "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e": 6, "0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7": 6 },
102
+ bnb: { "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d": 18, "0x55d398326f99059ff775485246999027b3197955": 18 },
103
+ unichain: { "0x078d782b760474a361dda0af3839290b0ef57ad6": 6 },
104
+ robinhood: { "0x5d3a1ff2b6bab83b63cd9ad0787074081a52ef34": 18, "0x5fc5360d0400a0fd4f2af552add042d716f1d168": 6 },
105
+ amoy: { "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582": 6 },
106
+ };
107
+ export function pinnedTokenDecimals(chain, token) {
108
+ return Object.hasOwn(TOKEN_DECIMALS, chain) ? TOKEN_DECIMALS[chain][token.toLowerCase()] : undefined;
109
+ }
110
+ /** Descriptor exists only when BOTH the deployed address and its decimals are pinned. */
111
+ export function paymentStableAsset(chain, asset) {
112
+ const pin = V14_DEPLOYMENTS[chain]?.splitter.assets.find((a) => a.symbol === asset);
113
+ const decimals = pin && pinnedTokenDecimals(chain, pin.address);
114
+ return pin && decimals ? { ...pin, decimals } : undefined;
115
+ }
116
+ //# sourceMappingURL=paymentChains.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paymentChains.js","sourceRoot":"","sources":["../src/paymentChains.ts"],"names":[],"mappings":"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"}
@@ -178,16 +178,16 @@ export declare function verifySettlementRouteOnChain(invoice: SettlementInvoice,
178
178
  export declare function executeSettlementInvoice(invoice: SettlementInvoice, walletClient: WalletClient, publicClient: PublicClient, trustedPin: TrustedSettlementRoutePin): Promise<SettlementExecution>;
179
179
  export declare const SETTLEMENT_CHAIN_IDS: Readonly<{
180
180
  polygon: number;
181
- amoy: number;
182
- optimism: number;
183
- bnb: number;
184
- unichain: number;
185
- botchain: number;
186
181
  base: number;
182
+ optimism: number;
187
183
  arbitrum: number;
188
184
  avalanche: number;
185
+ bnb: number;
186
+ unichain: number;
189
187
  xrplevm: number;
190
188
  robinhood: number;
189
+ amoy: number;
190
+ botchain: number;
191
191
  }>;
192
192
  export declare const SETTLEMENT_EXPECTED_BPS: Readonly<{
193
193
  "AIFP-1": {
@@ -0,0 +1,135 @@
1
+ import { PublicKey, Transaction, TransactionInstruction, Keypair } from "@solana/web3.js";
2
+ import { type SolanaV14Deployment, type SolanaNetwork } from "./generated/solanaV14Deployments.generated.js";
3
+ import type { SdkEnvironment } from "./deploymentResolver.js";
4
+ export declare const SOLANA_TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
5
+ export declare const SOLANA_GENESIS: Readonly<{
6
+ mainnet: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
7
+ devnet: "EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG";
8
+ }>;
9
+ export declare const SOLANA_STABLE_ASSETS: Readonly<{
10
+ mainnet: Readonly<{
11
+ USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
12
+ USDT: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
13
+ }>;
14
+ devnet: Readonly<{
15
+ USDC: "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
16
+ }>;
17
+ }>;
18
+ export declare const SOLANA_QUOTE_FIELDS: readonly ["payer", "merchant", "token", "grossAmount", "ipCreator", "validUntil", "orderIdHash", "nonce", "routeId"];
19
+ export interface SolanaV14Quote {
20
+ payer: string;
21
+ merchant: string;
22
+ token: string;
23
+ grossAmount: string;
24
+ ipCreator: string;
25
+ validUntil: string;
26
+ orderIdHash: string;
27
+ nonce: string;
28
+ routeId: string;
29
+ }
30
+ export interface SolanaV14SettlementCall {
31
+ chain: "solana";
32
+ network: SolanaNetwork;
33
+ contract: string;
34
+ splitter_version: "1.4";
35
+ idl_sha256: string;
36
+ route: "merchant-aifp1";
37
+ asset: string;
38
+ function: "settle_native" | "settle_stable";
39
+ arg_encoding: "borsh-quote+signature";
40
+ field_order: readonly string[];
41
+ bound_to_payer: true;
42
+ value_lamports?: string;
43
+ treasury_owner: string;
44
+ accounts: Record<string, string>;
45
+ remaining_accounts?: readonly string[];
46
+ args: {
47
+ quote: SolanaV14Quote;
48
+ signature: `0x${string}`;
49
+ };
50
+ }
51
+ export interface SolanaV14Prepared {
52
+ family: "solana";
53
+ hash: string;
54
+ serializedTransactionBase64: string;
55
+ network: SolanaNetwork;
56
+ programId: string;
57
+ idlSha256: string;
58
+ recentBlockhash: string;
59
+ lastValidBlockHeight: number;
60
+ settlementNonce: string;
61
+ }
62
+ export declare class SolanaV14Error extends Error {
63
+ readonly code: string;
64
+ readonly prepared?: SolanaV14Prepared | undefined;
65
+ readonly actualFeeLamports?: bigint | undefined;
66
+ constructor(code: string, message: string, prepared?: SolanaV14Prepared | undefined, actualFeeLamports?: bigint | undefined);
67
+ }
68
+ /** Exact admission-rate accounting; round fees upwards to whole USD micros. */
69
+ export declare function solanaLamportCostUsd(lamports: bigint, rate: string): number;
70
+ export declare function encodeSolanaV14Quote(q: SolanaV14Quote): Buffer;
71
+ export declare function solanaV14Digest(programId: string, q: SolanaV14Quote): Buffer;
72
+ export declare function solanaV14PaymentId(q: SolanaV14Quote): string;
73
+ /** Zero-fee creator slot is an unused writable account, not SystemProgram.
74
+ * The signed creator remains zero. No lamports are sent to this placeholder. */
75
+ export declare function solanaCreatorPlaceholder(programId: string, payer: string): string;
76
+ export declare function solanaStableMint(network: SolanaNetwork, asset: string): string;
77
+ /** Immutable inventory is useful for encoding/recovery, never activates a rail. */
78
+ export declare function solanaV14Inventory(environment: SdkEnvironment, network: SolanaNetwork): SolanaV14Deployment;
79
+ /** Production high-level authorizer; preserves the canonical disabled gate. */
80
+ export declare function authorizedSolanaV14Inventory(environment: SdkEnvironment, network: SolanaNetwork): SolanaV14Deployment;
81
+ export declare function solanaV14Pdas(programId: string, payer: string, nonce: string): Record<string, PublicKey>;
82
+ export declare function validateSolanaV14Call(call: SolanaV14SettlementCall, d: SolanaV14Deployment, payer: string, orderId: string, historical?: boolean): void;
83
+ export declare function solanaV14Instruction(call: SolanaV14SettlementCall, treasury: string): TransactionInstruction;
84
+ export declare function associatedToken(owner: string, mint: string): PublicKey;
85
+ export interface SolanaV14Rpc {
86
+ request(method: string, params: unknown[]): Promise<unknown>;
87
+ }
88
+ export declare function solanaV14Rpc(url: string, fetchImpl?: typeof fetch): SolanaV14Rpc;
89
+ export interface SolanaV14Plan {
90
+ call: SolanaV14SettlementCall;
91
+ deployment: SolanaV14Deployment;
92
+ payer: string;
93
+ transaction: Transaction;
94
+ feeRentLamports: bigint;
95
+ maxFeeLamports: bigint;
96
+ transactionFeeLamports: bigint;
97
+ lastValidBlockHeight: number;
98
+ createdAtMs: number;
99
+ orderId: string;
100
+ }
101
+ /** Read-only verification for a locally unsent expired admission; not a payment proof. */
102
+ export declare function verifyHistoricalSolanaV14Quote(call: SolanaV14SettlementCall, ctx: {
103
+ rpc: SolanaV14Rpc;
104
+ deployment: SolanaV14Deployment;
105
+ payer: string;
106
+ orderId: string;
107
+ }): Promise<void>;
108
+ /** Preflight performs no payer signature and no write. Reserve USD after this
109
+ * succeeds; sign/persist/broadcast the exact prepared message afterwards. */
110
+ export declare function prepareSolanaV14Settlement(call: SolanaV14SettlementCall, ctx: {
111
+ rpc: SolanaV14Rpc;
112
+ deployment: SolanaV14Deployment;
113
+ payer: string;
114
+ orderId: string;
115
+ maxFeeLamports: bigint;
116
+ }): Promise<SolanaV14Plan>;
117
+ /** Signed bytes and sole signature are persisted before the single send. */
118
+ export declare function executeSolanaV14Settlement(plan: SolanaV14Plan, ctx: {
119
+ rpc: SolanaV14Rpc;
120
+ keypair: Keypair;
121
+ onPrepared: (p: SolanaV14Prepared) => Promise<void>;
122
+ }): Promise<SolanaV14Prepared>;
123
+ /** Read-only reconciliation of the exact saved signature, never replacement. */
124
+ export declare function readSolanaV14FinalizedFailure(call: SolanaV14SettlementCall, p: SolanaV14Prepared, ctx: {
125
+ rpc: SolanaV14Rpc;
126
+ deployment: SolanaV14Deployment;
127
+ payer: string;
128
+ orderId: string;
129
+ transactionFeeLamports: bigint;
130
+ maxFeeLamports: bigint;
131
+ }): Promise<bigint | null>;
132
+ /** Historical verification is local: no new signature, send, expiry or profile
133
+ * lookup. Issuance still requires the backend's finalized execution proof. */
134
+ export declare function assertPreparedSolanaV14Recovery(call: SolanaV14SettlementCall, p: SolanaV14Prepared, d: SolanaV14Deployment, payer: string, orderId: string): void;
135
+ //# sourceMappingURL=settlementSolanaV14.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"settlementSolanaV14.d.ts","sourceRoot":"","sources":["../src/settlementSolanaV14.ts"],"names":[],"mappings":"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"}