@elizaos/plugin-wallet 2.0.0-beta.1 → 2.0.3-beta.6

package/dist/lp/utils/solanaClient.d.ts

@@ -0,0 +1,26 @@
+import { type IAgentRuntime } from "@elizaos/core";
+import { Connection, Keypair, PublicKey } from "@solana/web3.js";
+/**
+ * Gets a Solana RPC connection configured from runtime settings
+ */
+export declare function getConnection(runtime: IAgentRuntime): Connection;
+export declare function getWalletPublicKey(runtime: IAgentRuntime): string | null;
+export declare function getWalletPrivateKey(runtime: IAgentRuntime): string | null;
+/**
+ * Wallet result containing either a signer or public address
+ */
+export interface WalletResult {
+    signer?: Keypair;
+    address: PublicKey;
+}
+/**
+ * Loads a Solana wallet from runtime settings
+ * @param runtime The agent runtime
+ * @param requirePrivateKey Whether to require a full keypair (true) or just public key (false)
+ * @returns WalletResult containing either keypair or public key
+ */
+export declare function loadWallet(runtime: IAgentRuntime, requirePrivateKey?: boolean): Promise<WalletResult>;
+/**
+ * Sends a transaction with proper error handling and confirmation
+ */
+export declare function sendTransaction(connection: Connection, instructions: import("@solana/web3.js").TransactionInstruction[], signer: Keypair): Promise<string>;

package/dist/plugin.d.ts

@@ -0,0 +1,7 @@
+import { type Plugin } from "@elizaos/core";
+/**
+ * Single plugin surface: EVM + Solana wallet backend.
+ * Consumers should depend only on `@elizaos/plugin-wallet`.
+ */
+export declare const walletPlugin: Plugin;
+export default walletPlugin;

package/dist/policy/policy.d.ts

@@ -0,0 +1,14 @@
+import type { ApprovalSummary, SignScope } from "../wallet/pending.js";
+export interface PolicyEvaluation {
+    readonly kind: "ok" | "requires_approval" | "blocked";
+    readonly reason?: string;
+    readonly rule?: string;
+    readonly cooldownUntil?: number;
+}
+/**
+ * Business rules for size limits, allowlists, and cooldowns. Actions never
+ * inline policy checks — they delegate here after zod parse + plugin checks.
+ */
+export interface PolicyModule {
+    evaluate(scope: SignScope, summary: ApprovalSummary): Promise<PolicyEvaluation>;
+}

package/dist/providers/canonical-provider.d.ts

@@ -0,0 +1,19 @@
+import type { IAgentRuntime, Memory, ProviderResult, State } from "@elizaos/core";
+export type HealthStatus = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Typed venue / data-source adapter. Canonical actions dispatch into concrete
+ * provider classes registered on the runtime provider registry.
+ *
+ * See docs/architecture/wallet-and-trading.md §B.3.
+ */
+export interface CanonicalProvider {
+    readonly name: string;
+    readonly contextBudgetTokens: number;
+    getContext(runtime: IAgentRuntime, message: Memory, state: State): Promise<ProviderResult>;
+    healthcheck(runtime: IAgentRuntime): Promise<HealthStatus>;
+}

package/dist/providers/wallet-provider.d.ts

@@ -0,0 +1,5 @@
+import type { Provider } from "@elizaos/core";
+/**
+ * Injects live addresses into planner context. Always-on (200-token budget in spec).
+ */
+export declare const walletProvider: Provider;

package/dist/register-routes.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/routes/plugin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Wallet route plugin — registers wallet HTTP route handlers with the
+ * elizaOS runtime plugin route system.
+ *
+ * All routes use `rawPath: true` to preserve the legacy `/api/wallet/*`
+ * paths without a plugin-name prefix. This module is node-only — the main
+ * runtime plugin (services, actions, providers) lives in `../plugin.ts`
+ * and is browser-safe; this `plugin.ts` is loaded only on the server via
+ * `../register-routes.ts`.
+ *
+ * Migrated from packages/app-core/src/api/wallet-market-overview-route.ts.
+ */
+import type { Plugin } from "@elizaos/core";
+export declare const walletRoutePlugin: Plugin;

package/dist/routes/wallet-market-overview-route.d.ts

@@ -0,0 +1,7 @@
+import type http from "node:http";
+declare function fetchWithTimeoutGuard(input: string | URL, init: RequestInit, timeoutMs: number): Promise<Response>;
+type WalletMarketOverviewFetch = typeof fetchWithTimeoutGuard;
+export declare function handleWalletMarketOverviewRoute(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+export declare function __resetWalletMarketOverviewCacheForTests(): void;
+export declare function __setWalletMarketOverviewFetchForTests(fetcher: WalletMarketOverviewFetch): void;
+export {};

package/dist/sdk/abi.d.ts

@@ -0,0 +1,396 @@
+export declare const AgentAccountV2Abi: readonly [{
+    readonly name: "setSpendPolicy";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "perTxLimit";
+        readonly type: "uint256";
+    }, {
+        readonly name: "periodLimit";
+        readonly type: "uint256";
+    }, {
+        readonly name: "periodLength";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "setOperator";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "execute";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+}, {
+    readonly name: "approvePending";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "txId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "cancelPending";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "txId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "agentExecute";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+}, {
+    readonly name: "agentTransferToken";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "remainingBudget";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "perTx";
+        readonly type: "uint256";
+    }, {
+        readonly name: "inPeriod";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getPending";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "txId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "createdAt";
+        readonly type: "uint256";
+    }, {
+        readonly name: "executed";
+        readonly type: "bool";
+    }, {
+        readonly name: "cancelled";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "spendPolicies";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "perTxLimit";
+        readonly type: "uint256";
+    }, {
+        readonly name: "periodLimit";
+        readonly type: "uint256";
+    }, {
+        readonly name: "periodLength";
+        readonly type: "uint256";
+    }, {
+        readonly name: "periodSpent";
+        readonly type: "uint256";
+    }, {
+        readonly name: "periodStart";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "operators";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "pendingNonce";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "nonce";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "tokenContract";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "tokenId";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "operatorEpoch";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "isOperatorActive";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "TransactionExecuted";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "target";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }, {
+        readonly name: "executor";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "SpendPolicyUpdated";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "perTxLimit";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "periodLimit";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "periodLength";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "OperatorUpdated";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "TransactionQueued";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "txId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "TransactionApproved";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "txId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "TransactionCancelled";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "txId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+}];
+export declare const AgentAccountFactoryV2Abi: readonly [{
+    readonly name: "createAccount";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "tokenContract";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "wallet";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "getAddress";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenContract";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "wallets";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenContract";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "WalletCreated";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "wallet";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "tokenContract";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "deployer";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}];

package/dist/sdk/bridge/abis.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CCTP V2 TokenMessengerV2 ABI (source chain)
+ * Key function: depositForBurn — burns USDC and emits a MessageSent event
+ */
+export declare const TokenMessengerV2Abi: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}[];
+/**
+ * CCTP V2 MessageTransmitterV2 ABI (destination chain)
+ * Key function: receiveMessage — mints USDC using attested message
+ */
+export declare const MessageTransmitterV2Abi: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}[];
+/**
+ * Minimal ERC20 ABI — approve + allowance + balanceOf
+ */
+export declare const ERC20BridgeAbi: {
+    name: string;
+    type: string;
+    stateMutability: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}[];
+/**
+ * MessageTransmitter MessageSent event ABI — emitted during depositForBurn
+ * Used to extract the CCTP message bytes and hash for attestation polling.
+ */
+export declare const MessageSentEventAbi: {
+    name: string;
+    type: string;
+    inputs: {
+        name: string;
+        type: string;
+        indexed: boolean;
+    }[];
+}[];

package/dist/sdk/bridge/client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module bridge/client
+ * BridgeModule — CCTP V2 cross-chain USDC bridge for AgentWallet (EVM↔EVM).
+ *
+ * Implements a full EVM-to-EVM USDC bridge using Circle's CCTP V2 protocol.
+ * Non-custodial: all signing is done locally via the agent's viem WalletClient.
+ *
+ * For EVM↔Solana bridging, see bridge/solana.ts.
+ *
+ * Supported chains: Ethereum, Avalanche, Optimism, Arbitrum, Base, Polygon,
+ *                   Unichain, Linea, Sonic, Worldchain.
+ *
+ * Flow: approve USDC → depositForBurn → poll Circle IRIS → receiveMessage
+ */
+import { type Hash, type Hex, type WalletClient } from "viem";
+import type { BridgeChain, BridgeOptions, BridgeResult, BurnResult, EVMBridgeChain } from "./types.js";
+import { BRIDGE_CHAIN_IDS, CCTP_DOMAIN_IDS, FINALITY_THRESHOLD, MESSAGE_TRANSMITTER_V2, TOKEN_MESSENGER_V2, USDC_CONTRACT } from "./types.js";
+export declare class BridgeModule {
+    private readonly walletClient;
+    private readonly signerAccount;
+    private readonly publicClient;
+    private readonly fromChain;
+    constructor(walletClient: WalletClient, fromChain?: EVMBridgeChain, options?: {
+        rpcUrl?: string;
+    });
+    bridge(amount: bigint, toChain: EVMBridgeChain, options?: BridgeOptions): Promise<BridgeResult>;
+    burn(amount: bigint, toChain: EVMBridgeChain, options?: BridgeOptions): Promise<BurnResult>;
+    waitForAttestation(messageHash: Hex, apiUrl?: string): Promise<Hex>;
+    mint(messageBytes: Hex, attestation: Hex, toChain: EVMBridgeChain, destinationRpcUrl?: string): Promise<Hash>;
+    getUsdcBalance(): Promise<bigint>;
+    getUsdcAllowance(): Promise<bigint>;
+    private approveUsdc;
+    private depositForBurn;
+    private extractMessageSent;
+    private pollForAttestation;
+    private receiveMessage;
+    private validateBridgeParams;
+    private sleep;
+}
+export declare class BridgeError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function createBridge(walletClient: WalletClient, fromChain?: EVMBridgeChain, options?: {
+    rpcUrl?: string;
+}): BridgeModule;
+export type { BridgeChain, BridgeOptions, BridgeResult, BurnResult, EVMBridgeChain, };
+export { BRIDGE_CHAIN_IDS, CCTP_DOMAIN_IDS, FINALITY_THRESHOLD, MESSAGE_TRANSMITTER_V2, TOKEN_MESSENGER_V2, USDC_CONTRACT, };

package/dist/sdk/bridge/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @module bridge
+ * Re-exports for the bridge module: EVM↔EVM CCTP V2 bridge and EVM↔Solana bridge.
+ *
+ * Import from 'agentwallet-sdk/bridge' or 'agentwallet-sdk' (re-exported from root).
+ *
+ * EVM↔EVM: use BridgeModule or createBridge()
+ * EVM↔Solana: use bridgeEVMToSolana() and receiveFromSolanaOnEVM()
+ */
+export { ERC20BridgeAbi, MessageTransmitterV2Abi, TokenMessengerV2Abi, } from "./abis.js";
+export { BRIDGE_CHAIN_IDS, BridgeError, BridgeModule, CCTP_DOMAIN_IDS, createBridge, FINALITY_THRESHOLD, MESSAGE_TRANSMITTER_V2, TOKEN_MESSENGER_V2, USDC_CONTRACT, } from "./client.js";
+export type { EVMToSolanaOptions, EVMToSolanaResult, SolanaBridgeErrorCode, SolanaToEVMBurnParams, SolanaToEVMOptions, SolanaToEVMResult, } from "./solana.js";
+export { bridgeEVMToSolana, bytes32ToSolanaPubkey, receiveFromSolanaOnEVM, SOLANA_CCTP_DOMAIN, SOLANA_DEFAULT_RPC, SOLANA_MESSAGE_TRANSMITTER, SOLANA_TOKEN_MESSENGER, SOLANA_USDC_MINT, SolanaBridgeError, } from "./solana.js";
+export type { AttestationResponse, AttestationStatus, BridgeChain, BridgeOptions, BridgeResult, BurnResult, EVMBridgeChain, } from "./types.js";