@virtuals-protocol/acp-node 0.3.0-beta.22 → 0.3.0-beta.23

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import * as viem from 'viem';
 import { Address, Chain, createPublicClient } from 'viem';
 import * as _aa_sdk_core from '@aa-sdk/core';
 import { Address as Address$1, SmartAccountSigner } from '@aa-sdk/core';
-import { baseSepolia, base } from '@account-kit/infra';
+import { baseSepolia, base, mainnet, sepolia, polygon, polygonAmoy, bsc, bscTestnet, arbitrum, arbitrumSepolia } from '@account-kit/infra';
 import * as util from 'util';
 import util__default from 'util';
 import * as viem__types_actions_siwe_verifySiweMessage from 'viem/_types/actions/siwe/verifySiweMessage';
@@ -98,9 +98,10 @@ declare const ACP_ABI: ({
 declare class Fare {
     contractAddress: Address;
     decimals: number;
-    constructor(contractAddress: Address, decimals: number);
+    chainId?: number | undefined;
+    constructor(contractAddress: Address, decimals: number, chainId?: number | undefined);
     formatAmount(amount: number): bigint;
-    static fromContractAddress(contractAddress: Address, config?: AcpContractConfig): Promise<Fare>;
+    static fromContractAddress(contractAddress: Address, config?: AcpContractConfig, chainId?: number): Promise<Fare>;
 }
 declare abstract class FareAmountBase {
     amount: bigint;
@@ -202,8 +203,9 @@ declare class AcpMemo {
     payableDetails?: PayableDetails | undefined;
     txHash?: `0x${string}` | undefined;
     signedTxHash?: `0x${string}` | undefined;
+    state?: AcpMemoState | undefined;
     structuredContent: GenericPayload | undefined;
-    constructor(contractClient: BaseAcpContractClient, id: number, type: MemoType, content: string, nextPhase: AcpJobPhases, status: AcpMemoStatus, senderAddress: Address, signedReason?: string | undefined, expiry?: Date | undefined, payableDetails?: PayableDetails | undefined, txHash?: `0x${string}` | undefined, signedTxHash?: `0x${string}` | undefined);
+    constructor(contractClient: BaseAcpContractClient, id: number, type: MemoType, content: string, nextPhase: AcpJobPhases, status: AcpMemoStatus, senderAddress: Address, signedReason?: string | undefined, expiry?: Date | undefined, payableDetails?: PayableDetails | undefined, txHash?: `0x${string}` | undefined, signedTxHash?: `0x${string}` | undefined, state?: AcpMemoState | undefined);
     get payloadType(): PayloadType | undefined;
     getStructuredContent<T>(): GenericPayload<T> | undefined;
     create(jobId: number, isSecured?: boolean): Promise<OperationPayload>;
@@ -275,7 +277,7 @@ declare class AcpJob {
         userOpHash: Address;
         txnHash: Address;
     }>;
-    createPayableRequirement(content: string, type: MemoType.PAYABLE_REQUEST | MemoType.PAYABLE_TRANSFER_ESCROW, amount: FareAmountBase, recipient: Address, expiredAt?: Date): Promise<{
+    createPayableRequirement(content: string, type: MemoType.PAYABLE_REQUEST | MemoType.PAYABLE_TRANSFER_ESCROW | MemoType.PAYABLE_TRANSFER, amount: FareAmountBase, recipient: Address, expiredAt?: Date): Promise<{
         userOpHash: Address;
         txnHash: Address;
     }>;
@@ -303,7 +305,7 @@ declare class AcpJob {
         userOpHash: Address;
         txnHash: Address;
     }>;
-    deliverPayable(deliverable: DeliverablePayload, amount: FareAmountBase, skipFee?: boolean, expiredAt?: Date): Promise<{
+    deliverPayable(deliverable: DeliverablePayload, amount: FareAmountBase, skipFee?: boolean, expiredAt?: Date): Promise<void | {
         userOpHash: Address;
         txnHash: Address;
     }>;
@@ -317,6 +319,7 @@ declare class AcpJob {
         txnHash: Address;
     }>;
     private performX402Payment;
+    deliverCrossChainPayable(recipient: Address, amount: FareAmountBase, isRequest?: boolean): Promise<void>;
     [util.inspect.custom](): {
         id: number;
         clientAddress: `0x${string}`;
@@ -342,11 +345,21 @@ declare enum AcpMemoStatus {
     APPROVED = "APPROVED",
     REJECTED = "REJECTED"
 }
+declare enum AcpMemoState {
+    NONE = 0,
+    PENDING = 1,
+    IN_PROGRESS = 2,
+    READY = 3,
+    COMPLETED = 4,
+    REJECTED = 5
+}
 interface PayableDetails {
     amount: bigint;
     token: Address;
     recipient: Address;
     feeAmount: bigint;
+    lzSrcEid?: number;
+    lzDstEid?: number;
 }
 declare enum AcpAgentSort {
     SUCCESSFUL_JOB_COUNT = "successfulJobCount",
@@ -551,6 +564,11 @@ type X402PaymentResponse = {
     data: X402PayableRequirements;
 };
 
+type SupportedChain = typeof mainnet | typeof sepolia | typeof polygon | typeof polygonAmoy | typeof bsc | typeof bscTestnet | typeof arbitrum | typeof arbitrumSepolia;
+type ChainConfig = {
+    chain: SupportedChain;
+    rpcUrl?: string;
+};
 declare class AcpContractConfig {
     chain: typeof baseSepolia | typeof base;
     contractAddress: Address$1;
@@ -566,14 +584,16 @@ declare class AcpContractConfig {
         multiplier: number;
         maxRetries: number;
     } | undefined;
+    chains: ChainConfig[];
     constructor(chain: typeof baseSepolia | typeof base, contractAddress: Address$1, baseFare: Fare, alchemyRpcUrl: string, acpUrl: string, abi: typeof ACP_ABI | typeof ACP_V2_ABI, maxRetries: number, rpcEndpoint?: string | undefined, x402Config?: X402Config | undefined, retryConfig?: {
         intervalMs: number;
         multiplier: number;
         maxRetries: number;
-    } | undefined);
+    } | undefined, chains?: ChainConfig[]);
 }
 declare const baseSepoliaAcpConfig: AcpContractConfig;
 declare const baseSepoliaAcpConfigV2: AcpContractConfig;
+declare const baseSepoliaAcpX402ConfigV2: AcpContractConfig;
 declare const baseAcpConfig: AcpContractConfig;
 declare const baseAcpX402Config: AcpContractConfig;
 declare const baseAcpConfigV2: AcpContractConfig;
@@ -620,9 +640,10 @@ declare abstract class BaseAcpContractClient {
     abi: typeof ACP_ABI | typeof ACP_V2_ABI;
     jobCreatedSignature: string;
     publicClient: ReturnType<typeof createPublicClient>;
+    publicClients: Record<number, ReturnType<typeof createPublicClient>>;
     constructor(agentWalletAddress: Address, config?: AcpContractConfig);
     protected validateSessionKeyOnChain(sessionSignerAddress: Address, sessionEntityKeyId: number): Promise<void>;
-    abstract handleOperation(operations: OperationPayload[]): Promise<{
+    abstract handleOperation(operations: OperationPayload[], chainId?: number): Promise<{
         userOpHash: Address;
         txnHash: Address;
     }>;
@@ -630,9 +651,11 @@ declare abstract class BaseAcpContractClient {
     get walletAddress(): `0x${string}`;
     createJobWithAccount(accountId: number, evaluatorAddress: Address, budgetBaseUnit: bigint, paymentTokenAddress: Address, expiredAt: Date, isX402Job?: boolean): OperationPayload;
     createJob(providerAddress: Address, evaluatorAddress: Address, expiredAt: Date, paymentTokenAddress: Address, budgetBaseUnit: bigint, metadata: string, isX402Job?: boolean): OperationPayload;
-    approveAllowance(amountBaseUnit: bigint, paymentTokenAddress?: Address): OperationPayload;
+    approveAllowance(amountBaseUnit: bigint, paymentTokenAddress?: Address, targetAddress?: Address): OperationPayload;
     createPayableMemo(jobId: number, content: string, amountBaseUnit: bigint, recipient: Address, feeAmountBaseUnit: bigint, feeType: FeeType, nextPhase: AcpJobPhases, type: MemoType.PAYABLE_REQUEST | MemoType.PAYABLE_TRANSFER_ESCROW | MemoType.PAYABLE_TRANSFER | MemoType.PAYABLE_NOTIFICATION, expiredAt: Date, token?: Address, secured?: boolean): OperationPayload;
+    createCrossChainPayableMemo(jobId: number, content: string, token: Address, amountBaseUnit: bigint, recipient: Address, feeAmountBaseUnit: bigint, feeType: FeeType, type: MemoType.PAYABLE_REQUEST | MemoType.PAYABLE_TRANSFER | MemoType.PAYABLE_NOTIFICATION, expiredAt: Date, nextPhase: AcpJobPhases, destinationEid: number, secured?: boolean): OperationPayload;
     createMemo(jobId: number, content: string, type: MemoType, isSecured: boolean, nextPhase: AcpJobPhases): OperationPayload;
+    createMemoWithMetadata(jobId: number, content: string, type: MemoType, isSecured: boolean, nextPhase: AcpJobPhases, metadata: string): OperationPayload;
     signMemo(memoId: number, isApproved: boolean, reason?: string): OperationPayload;
     setBudgetWithPaymentToken(jobId: number, budgetBaseUnit: bigint, paymentTokenAddress?: Address): OperationPayload | undefined;
     updateAccountMetadata(accountId: number, metadata: string): OperationPayload;
@@ -642,6 +665,10 @@ declare abstract class BaseAcpContractClient {
     abstract generateX402Payment(payableRequest: X402PayableRequest, requirements: X402PayableRequirements): Promise<X402Payment>;
     abstract performX402Request(url: string, version: string, budget?: string, signature?: string): Promise<X402PaymentResponse>;
     submitTransferWithAuthorization(from: Address, to: Address, value: bigint, validAfter: bigint, validBefore: bigint, nonce: string, signature: string): Promise<OperationPayload[]>;
+    getERC20Balance(chainId: number, tokenAddress: Address, walletAddress: Address): Promise<bigint>;
+    getERC20Allowance(chainId: number, tokenAddress: Address, walletAddress: Address, spenderAddress: Address): Promise<bigint>;
+    getERC20Symbol(chainId: number, tokenAddress: Address): Promise<string>;
+    abstract getAssetManager(): Promise<Address>;
     abstract getAcpVersion(): string;
 }
 
@@ -1000,6 +1027,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
             [x: `uint8[${string}]`]: undefined;
             [x: `bool[${string}]`]: undefined;
             [x: `bytes4[${string}]`]: undefined;
+            [x: `uint32[${string}]`]: undefined;
             [x: `bytes[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
             [x: `bytes10[${string}]`]: undefined;
@@ -1067,7 +1095,6 @@ declare class AcpContractClient extends BaseAcpContractClient {
             [x: `uint[${string}]`]: undefined;
             [x: `uint16[${string}]`]: undefined;
             [x: `uint24[${string}]`]: undefined;
-            [x: `uint32[${string}]`]: undefined;
             [x: `uint40[${string}]`]: undefined;
             [x: `uint48[${string}]`]: undefined;
             [x: `uint56[${string}]`]: undefined;
@@ -1102,6 +1129,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
             uint8?: undefined;
             bool?: undefined;
             bytes4?: undefined;
+            uint32?: undefined;
             bytes?: undefined;
             bytes6?: undefined;
             bytes10?: undefined;
@@ -1167,7 +1195,6 @@ declare class AcpContractClient extends BaseAcpContractClient {
             int256?: undefined;
             uint16?: undefined;
             uint24?: undefined;
-            uint32?: undefined;
             uint40?: undefined;
             uint48?: undefined;
             uint56?: undefined;
@@ -8317,6 +8344,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 [x: `uint8[${string}]`]: undefined;
                 [x: `bool[${string}]`]: undefined;
                 [x: `bytes4[${string}]`]: undefined;
+                [x: `uint32[${string}]`]: undefined;
                 [x: `bytes[${string}]`]: undefined;
                 [x: `bytes6[${string}]`]: undefined;
                 [x: `bytes10[${string}]`]: undefined;
@@ -8384,7 +8412,6 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 [x: `uint[${string}]`]: undefined;
                 [x: `uint16[${string}]`]: undefined;
                 [x: `uint24[${string}]`]: undefined;
-                [x: `uint32[${string}]`]: undefined;
                 [x: `uint40[${string}]`]: undefined;
                 [x: `uint48[${string}]`]: undefined;
                 [x: `uint56[${string}]`]: undefined;
@@ -8419,6 +8446,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 uint8?: undefined;
                 bool?: undefined;
                 bytes4?: undefined;
+                uint32?: undefined;
                 bytes?: undefined;
                 bytes6?: undefined;
                 bytes10?: undefined;
@@ -8484,7 +8512,6 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 int256?: undefined;
                 uint16?: undefined;
                 uint24?: undefined;
-                uint32?: undefined;
                 uint40?: undefined;
                 uint48?: undefined;
                 uint56?: undefined;
@@ -8772,6 +8799,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 [x: `uint8[${string}]`]: undefined;
                 [x: `bool[${string}]`]: undefined;
                 [x: `bytes4[${string}]`]: undefined;
+                [x: `uint32[${string}]`]: undefined;
                 [x: `bytes[${string}]`]: undefined;
                 [x: `bytes6[${string}]`]: undefined;
                 [x: `bytes10[${string}]`]: undefined;
@@ -8839,7 +8867,6 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 [x: `uint[${string}]`]: undefined;
                 [x: `uint16[${string}]`]: undefined;
                 [x: `uint24[${string}]`]: undefined;
-                [x: `uint32[${string}]`]: undefined;
                 [x: `uint40[${string}]`]: undefined;
                 [x: `uint48[${string}]`]: undefined;
                 [x: `uint56[${string}]`]: undefined;
@@ -8874,6 +8901,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 uint8?: undefined;
                 bool?: undefined;
                 bytes4?: undefined;
+                uint32?: undefined;
                 bytes?: undefined;
                 bytes6?: undefined;
                 bytes10?: undefined;
@@ -8939,7 +8967,6 @@ declare class AcpContractClient extends BaseAcpContractClient {
                 int256?: undefined;
                 uint16?: undefined;
                 uint24?: undefined;
-                uint32?: undefined;
                 uint40?: undefined;
                 uint48?: undefined;
                 uint56?: undefined;
@@ -8988,6 +9015,7 @@ declare class AcpContractClient extends BaseAcpContractClient {
     updateJobX402Nonce(jobId: number, nonce: string): Promise<OffChainJob>;
     generateX402Payment(payableRequest: X402PayableRequest, requirements: X402PayableRequirements): Promise<X402Payment>;
     performX402Request(url: string, version: string, budget?: string, signature?: string): Promise<X402PaymentResponse>;
+    getAssetManager(): Promise<Address$1>;
     getAcpVersion(): string;
 }
 
@@ -9007,6 +9035,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
     private GAS_FEE_MULTIPLIER;
     private RETRY_CONFIG;
     private _sessionKeyClient;
+    private _sessionKeyClients;
     private _acpX402;
     constructor(jobManagerAddress: Address$1, memoManagerAddress: Address$1, accountManagerAddress: Address$1, agentWalletAddress: Address$1, config?: AcpContractConfig);
     static build(walletPrivateKey: Address$1, sessionEntityKeyId: number, agentWalletAddress: Address$1, config?: AcpContractConfig): Promise<AcpContractClientV2>;
@@ -9286,6 +9315,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
             [x: `uint8[${string}]`]: undefined;
             [x: `bool[${string}]`]: undefined;
             [x: `bytes4[${string}]`]: undefined;
+            [x: `uint32[${string}]`]: undefined;
             [x: `bytes[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
             [x: `bytes10[${string}]`]: undefined;
@@ -9353,7 +9383,6 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
             [x: `uint[${string}]`]: undefined;
             [x: `uint16[${string}]`]: undefined;
             [x: `uint24[${string}]`]: undefined;
-            [x: `uint32[${string}]`]: undefined;
             [x: `uint40[${string}]`]: undefined;
             [x: `uint48[${string}]`]: undefined;
             [x: `uint56[${string}]`]: undefined;
@@ -9388,6 +9417,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
             uint8?: undefined;
             bool?: undefined;
             bytes4?: undefined;
+            uint32?: undefined;
             bytes?: undefined;
             bytes6?: undefined;
             bytes10?: undefined;
@@ -9453,7 +9483,6 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
             int256?: undefined;
             uint16?: undefined;
             uint24?: undefined;
-            uint32?: undefined;
             uint40?: undefined;
             uint48?: undefined;
             uint56?: undefined;
@@ -16603,6 +16632,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 [x: `uint8[${string}]`]: undefined;
                 [x: `bool[${string}]`]: undefined;
                 [x: `bytes4[${string}]`]: undefined;
+                [x: `uint32[${string}]`]: undefined;
                 [x: `bytes[${string}]`]: undefined;
                 [x: `bytes6[${string}]`]: undefined;
                 [x: `bytes10[${string}]`]: undefined;
@@ -16670,7 +16700,6 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 [x: `uint[${string}]`]: undefined;
                 [x: `uint16[${string}]`]: undefined;
                 [x: `uint24[${string}]`]: undefined;
-                [x: `uint32[${string}]`]: undefined;
                 [x: `uint40[${string}]`]: undefined;
                 [x: `uint48[${string}]`]: undefined;
                 [x: `uint56[${string}]`]: undefined;
@@ -16705,6 +16734,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 uint8?: undefined;
                 bool?: undefined;
                 bytes4?: undefined;
+                uint32?: undefined;
                 bytes?: undefined;
                 bytes6?: undefined;
                 bytes10?: undefined;
@@ -16770,7 +16800,6 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 int256?: undefined;
                 uint16?: undefined;
                 uint24?: undefined;
-                uint32?: undefined;
                 uint40?: undefined;
                 uint48?: undefined;
                 uint56?: undefined;
@@ -17058,6 +17087,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 [x: `uint8[${string}]`]: undefined;
                 [x: `bool[${string}]`]: undefined;
                 [x: `bytes4[${string}]`]: undefined;
+                [x: `uint32[${string}]`]: undefined;
                 [x: `bytes[${string}]`]: undefined;
                 [x: `bytes6[${string}]`]: undefined;
                 [x: `bytes10[${string}]`]: undefined;
@@ -17125,7 +17155,6 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 [x: `uint[${string}]`]: undefined;
                 [x: `uint16[${string}]`]: undefined;
                 [x: `uint24[${string}]`]: undefined;
-                [x: `uint32[${string}]`]: undefined;
                 [x: `uint40[${string}]`]: undefined;
                 [x: `uint48[${string}]`]: undefined;
                 [x: `uint56[${string}]`]: undefined;
@@ -17160,6 +17189,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 uint8?: undefined;
                 bool?: undefined;
                 bytes4?: undefined;
+                uint32?: undefined;
                 bytes?: undefined;
                 bytes6?: undefined;
                 bytes10?: undefined;
@@ -17225,7 +17255,6 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
                 int256?: undefined;
                 uint16?: undefined;
                 uint24?: undefined;
-                uint32?: undefined;
                 uint40?: undefined;
                 uint48?: undefined;
                 uint56?: undefined;
@@ -17261,7 +17290,7 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
     };
     get acpX402(): AcpX402;
     private calculateGasFees;
-    handleOperation(operations: OperationPayload[]): Promise<{
+    handleOperation(operations: OperationPayload[], chainId?: number): Promise<{
         userOpHash: Address$1;
         txnHash: Address$1;
     }>;
@@ -17270,7 +17299,8 @@ declare class AcpContractClientV2 extends BaseAcpContractClient {
     generateX402Payment(payableRequest: X402PayableRequest, requirements: X402PayableRequirements): Promise<X402Payment>;
     performX402Request(url: string, version: string, budget?: string, signature?: string): Promise<X402PaymentResponse>;
     getX402PaymentDetails(jobId: number): Promise<IAcpJobX402PaymentDetails>;
+    getAssetManager(): Promise<Address$1>;
     getAcpVersion(): string;
 }
 
-export { ACP_ABI, AcpAgentSort, AcpContractClient, AcpContractClientV2, AcpContractConfig, AcpError, AcpGraduationStatus, AcpJob, AcpJobPhases, AcpMemo, AcpMemoStatus, AcpOnlineStatus, BaseAcpContractClient, type ClosePositionPayload, type DeliverablePayload, Fare, FareAmount, FareBigInt, type FundResponsePayload, type IDeliverable, MemoType, type OpenPositionPayload, PayloadType, PositionDirection, type RequestClosePositionPayload, type ResponseSwapTokenPayload, type SwapTokenPayload, baseAcpConfig, baseAcpConfigV2, baseAcpX402Config, baseAcpX402ConfigV2, baseSepoliaAcpConfig, baseSepoliaAcpConfigV2, AcpClient as default, ethFare, preparePayload, wethFare };
+export { ACP_ABI, AcpAgentSort, AcpContractClient, AcpContractClientV2, AcpContractConfig, AcpError, AcpGraduationStatus, AcpJob, AcpJobPhases, AcpMemo, AcpMemoState, AcpMemoStatus, AcpOnlineStatus, BaseAcpContractClient, type ClosePositionPayload, type DeliverablePayload, Fare, FareAmount, FareBigInt, type FundResponsePayload, type IDeliverable, MemoType, type OpenPositionPayload, PayloadType, PositionDirection, type RequestClosePositionPayload, type ResponseSwapTokenPayload, type SwapTokenPayload, baseAcpConfig, baseAcpConfigV2, baseAcpX402Config, baseAcpX402ConfigV2, baseSepoliaAcpConfig, baseSepoliaAcpConfigV2, baseSepoliaAcpX402ConfigV2, AcpClient as default, ethFare, preparePayload, wethFare };