@framers/agentos-ext-wallet 0.2.0

package/dist/cards/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @fileoverview Types for the virtual card subsystem (Lithic integration).
+ * @module wallet/cards/types
+ */
+import type { SpendCategory } from '../types.js';
+export type CardType = 'VIRTUAL' | 'PHYSICAL';
+export type CardState = 'OPEN' | 'PAUSED' | 'CLOSED' | 'PENDING_FULFILLMENT';
+export type CardNetwork = 'VISA' | 'MASTERCARD';
+export type CardTxStatus = 'PENDING' | 'SETTLED' | 'DECLINED' | 'VOIDED';
+export type SpendLimitDuration = 'TRANSACTION' | 'MONTHLY' | 'ANNUALLY' | 'FOREVER';
+export interface CardConfig {
+    enabled: boolean;
+    /** Card provider. Only 'lithic' is supported. */
+    provider: 'lithic';
+    /** Default per-card spending limit in USD. */
+    defaultSpendLimitUsd: number;
+    /** Whether physical card issuance is allowed. */
+    allowPhysical: boolean;
+}
+export declare const DEFAULT_CARD_CONFIG: CardConfig;
+export interface AgentCardRecord {
+    id: string;
+    agentId: string;
+    /** Lithic's card token identifier. */
+    lithicCardToken: string;
+    last4: string;
+    cardType: CardType;
+    state: CardState;
+    spendLimitUsd: number;
+    spendLimitDuration: SpendLimitDuration;
+    network: CardNetwork;
+    /** Agent-assigned label for the card. */
+    memo?: string;
+    createdAt: number;
+}
+export interface CardTransactionRecord {
+    id: string;
+    /** FK to AgentCardRecord.id */
+    cardId: string;
+    /** Lithic's transaction token. */
+    lithicTxToken: string;
+    merchantName?: string;
+    /** 4-digit Merchant Category Code. */
+    merchantMcc: string;
+    /** Resolved spend category. */
+    category: SpendCategory;
+    amountUsd: number;
+    status: CardTxStatus;
+    createdAt: number;
+}
+export interface ICardStore {
+    getCard(agentId: string): Promise<AgentCardRecord | null>;
+    saveCard(record: AgentCardRecord): Promise<void>;
+    updateCardState(agentId: string, state: CardState): Promise<void>;
+    insertTransaction(record: CardTransactionRecord): Promise<void>;
+    updateTransactionStatus(id: string, status: CardTxStatus): Promise<void>;
+    getTransactions(cardId: string, limit?: number): Promise<CardTransactionRecord[]>;
+    getTransactionsByPeriod(cardId: string, since: number): Promise<CardTransactionRecord[]>;
+}
+export interface CreateCardParams {
+    type: CardType;
+    memo?: string;
+    spend_limit: number;
+    spend_limit_duration: SpendLimitDuration;
+    state?: CardState;
+}
+export interface UpdateCardParams {
+    state?: CardState;
+    spend_limit?: number;
+    spend_limit_duration?: SpendLimitDuration;
+    memo?: string;
+}
+export interface LithicCardResponse {
+    token: string;
+    last_four: string;
+    type: CardType;
+    state: CardState;
+    spend_limit: number;
+    spend_limit_duration: SpendLimitDuration;
+    pan?: string;
+    cvv?: string;
+    exp_month?: string;
+    exp_year?: string;
+    funding: {
+        token: string;
+        type: string;
+    };
+}
+export interface LithicTransaction {
+    token: string;
+    card_token: string;
+    amount: number;
+    merchant: {
+        descriptor: string;
+        mcc: string;
+        city?: string;
+        state?: string;
+        country?: string;
+    };
+    status: 'PENDING' | 'SETTLED' | 'DECLINED' | 'VOIDED';
+    created: string;
+}
+export interface ListTxOpts {
+    begin?: string;
+    end?: string;
+    page_size?: number;
+}
+export interface AuthRuleParams {
+    allowed_mcc?: string[];
+    blocked_mcc?: string[];
+}
+export interface ICardAdapter {
+    createCard(params: CreateCardParams): Promise<LithicCardResponse>;
+    getCard(cardToken: string): Promise<LithicCardResponse>;
+    updateCard(cardToken: string, updates: UpdateCardParams): Promise<LithicCardResponse>;
+    pauseCard(cardToken: string): Promise<void>;
+    resumeCard(cardToken: string): Promise<void>;
+    closeCard(cardToken: string): Promise<void>;
+    listTransactions(cardToken: string, opts?: ListTxOpts): Promise<LithicTransaction[]>;
+    createAuthRule(cardToken: string, rule: AuthRuleParams): Promise<void>;
+}
+export interface SpendingSummary {
+    totalUsd: number;
+    period: 'day' | 'month';
+    byCategory: Array<{
+        category: SpendCategory;
+        amountUsd: number;
+    }>;
+    transactionCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cards/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cards/types.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,qBAAqB,CAAC;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AACzE,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAMpF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,QAAQ,CAAC;IACnB,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,mBAAmB,EAAE,UAKjC,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAClF,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;CAC1F;AAMD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,UAAU,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/cards/types.js

@@ -0,0 +1,12 @@
+// @ts-nocheck
+/**
+ * @fileoverview Types for the virtual card subsystem (Lithic integration).
+ * @module wallet/cards/types
+ */
+export const DEFAULT_CARD_CONFIG = {
+    enabled: false,
+    provider: 'lithic',
+    defaultSpendLimitUsd: 500,
+    allowPhysical: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/cards/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cards/types.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;GAGG;AA4BH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,QAAQ;IAClB,oBAAoB,EAAE,GAAG;IACzB,aAAa,EAAE,KAAK;CACrB,CAAC"}

package/dist/chains/EvmWalletAdapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview EVM chain adapter for the Agent Personal Wallet.
+ *
+ * Supports Ethereum, Base, and Polygon via ethers.js v6 (dynamic import).
+ *
+ * @module wunderland/wallet/chains/EvmWalletAdapter
+ */
+import type { ChainId, IChainWalletAdapter, WalletTxStatus } from '../types.js';
+/** Well-known ERC-20 addresses per chain. */
+export declare const KNOWN_TOKENS: Record<string, Record<string, string>>;
+export interface EvmWalletAdapterOptions {
+    chain: ChainId;
+    rpcUrl?: string;
+}
+export declare class EvmWalletAdapter implements IChainWalletAdapter {
+    readonly chain: ChainId;
+    private rpcUrl;
+    constructor(opts: EvmWalletAdapterOptions);
+    generateKeypair(): Promise<{
+        publicKey: string;
+        secretKey: Uint8Array;
+    }>;
+    getBalance(address: string): Promise<bigint>;
+    getTokenBalance(address: string, tokenAddress: string): Promise<bigint>;
+    signTransfer(secretKey: Uint8Array, to: string, amountRaw: bigint): Promise<Uint8Array>;
+    signTokenTransfer(secretKey: Uint8Array, to: string, tokenAddress: string, amountRaw: bigint): Promise<Uint8Array>;
+    broadcast(signedTx: Uint8Array): Promise<string>;
+    getTransactionStatus(txHash: string): Promise<WalletTxStatus>;
+}
+//# sourceMappingURL=EvmWalletAdapter.d.ts.map

package/dist/chains/EvmWalletAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmWalletAdapter.d.ts","sourceRoot":"","sources":["../../src/chains/EvmWalletAdapter.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA2BhF,6CAA6C;AAC7C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa/D,CAAC;AASF,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,uBAAuB;IAKnC,eAAe,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC;IAYxE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5C,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvE,YAAY,CAChB,SAAS,EAAE,UAAU,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC;IAchB,iBAAiB,CACrB,SAAS,EAAE,UAAU,EACrB,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC;IAYhB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhD,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CASpE"}

package/dist/chains/EvmWalletAdapter.js

@@ -0,0 +1,135 @@
+// @ts-nocheck
+/**
+ * @fileoverview EVM chain adapter for the Agent Personal Wallet.
+ *
+ * Supports Ethereum, Base, and Polygon via ethers.js v6 (dynamic import).
+ *
+ * @module wunderland/wallet/chains/EvmWalletAdapter
+ */
+// Lazily resolved ethers module (dynamic import — not a hard dependency)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _ethers = null;
+async function getEthers() {
+    if (!_ethers) {
+        try {
+            _ethers = await import('ethers');
+        }
+        catch {
+            throw new Error('Missing dependency: ethers is required for EVM wallet support. '
+                + 'Install it with: npm install ethers');
+        }
+    }
+    return _ethers;
+}
+/** Default RPC endpoints per chain. */
+const DEFAULT_RPC = {
+    ethereum: 'https://eth.llamarpc.com',
+    base: 'https://mainnet.base.org',
+    polygon: 'https://polygon-rpc.com',
+};
+/** Well-known ERC-20 addresses per chain. */
+export const KNOWN_TOKENS = {
+    ethereum: {
+        USDC: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        USDT: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
+    },
+    base: {
+        USDC: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        USDT: '0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2',
+    },
+    polygon: {
+        USDC: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+        USDT: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
+    },
+};
+/** Minimal ERC-20 ABI for balance + transfer. */
+const ERC20_ABI = [
+    'function balanceOf(address owner) view returns (uint256)',
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function decimals() view returns (uint8)',
+];
+export class EvmWalletAdapter {
+    chain;
+    rpcUrl;
+    constructor(opts) {
+        this.chain = opts.chain;
+        this.rpcUrl = opts.rpcUrl || DEFAULT_RPC[opts.chain] || DEFAULT_RPC.ethereum;
+    }
+    async generateKeypair() {
+        const { Wallet } = await getEthers();
+        const wallet = Wallet.createRandom();
+        // ethers v6 returns hex private key — convert to Uint8Array
+        const privKeyHex = wallet.privateKey.slice(2); // remove 0x
+        const secretKey = hexToBytes(privKeyHex);
+        return {
+            publicKey: wallet.address,
+            secretKey,
+        };
+    }
+    async getBalance(address) {
+        const { JsonRpcProvider } = await getEthers();
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        return await provider.getBalance(address);
+    }
+    async getTokenBalance(address, tokenAddress) {
+        const { JsonRpcProvider, Contract } = await getEthers();
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        const contract = new Contract(tokenAddress, ERC20_ABI, provider);
+        const balance = await contract.balanceOf(address);
+        return balance;
+    }
+    async signTransfer(secretKey, to, amountRaw) {
+        const { JsonRpcProvider, Wallet } = await getEthers();
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        const wallet = new Wallet(bytesToHex(secretKey), provider);
+        const tx = await wallet.populateTransaction({
+            to,
+            value: amountRaw,
+        });
+        const signed = await wallet.signTransaction(tx);
+        return hexToBytes(signed.slice(2));
+    }
+    async signTokenTransfer(secretKey, to, tokenAddress, amountRaw) {
+        const { JsonRpcProvider, Wallet, Contract } = await getEthers();
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        const wallet = new Wallet(bytesToHex(secretKey), provider);
+        const contract = new Contract(tokenAddress, ERC20_ABI, wallet);
+        const tx = await contract.transfer.populateTransaction(to, amountRaw);
+        const populated = await wallet.populateTransaction(tx);
+        const signed = await wallet.signTransaction(populated);
+        return hexToBytes(signed.slice(2));
+    }
+    async broadcast(signedTx) {
+        const { JsonRpcProvider } = await getEthers();
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        const txResponse = await provider.broadcastTransaction('0x' + bytesToHex(signedTx));
+        await txResponse.wait(1);
+        return txResponse.hash;
+    }
+    async getTransactionStatus(txHash) {
+        const { JsonRpcProvider } = await getEthers();
+        const provider = new JsonRpcProvider(this.rpcUrl);
+        const receipt = await provider.getTransactionReceipt(txHash);
+        if (!receipt)
+            return 'pending';
+        if (receipt.status === 1)
+            return 'confirmed';
+        return 'failed';
+    }
+}
+// ---------------------------------------------------------------------------
+// Hex <-> bytes helpers
+// ---------------------------------------------------------------------------
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.substring(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+//# sourceMappingURL=EvmWalletAdapter.js.map

package/dist/chains/EvmWalletAdapter.js.map

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

package/dist/chains/SolanaWalletAdapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Solana chain adapter for the Agent Personal Wallet.
+ *
+ * Uses dynamic imports for @solana/web3.js so it remains an optional dependency.
+ * Patterns derived from the existing SolanaProvider in anchor-providers.
+ *
+ * @module wunderland/wallet/chains/SolanaWalletAdapter
+ */
+import type { IChainWalletAdapter, WalletTxStatus } from '../types.js';
+export interface SolanaWalletAdapterOptions {
+    /** RPC endpoint URL. Defaults to mainnet-beta. */
+    rpcUrl?: string;
+    /** Commitment level for queries. */
+    commitment?: 'processed' | 'confirmed' | 'finalized';
+}
+export declare class SolanaWalletAdapter implements IChainWalletAdapter {
+    readonly chain: "solana";
+    private rpcUrl;
+    private commitment;
+    constructor(opts?: SolanaWalletAdapterOptions);
+    generateKeypair(): Promise<{
+        publicKey: string;
+        secretKey: Uint8Array;
+    }>;
+    getBalance(address: string): Promise<bigint>;
+    getTokenBalance(address: string, tokenMint: string): Promise<bigint>;
+    signTransfer(secretKey: Uint8Array, to: string, amountRaw: bigint): Promise<Uint8Array>;
+    signTokenTransfer(secretKey: Uint8Array, to: string, tokenMint: string, amountRaw: bigint): Promise<Uint8Array>;
+    broadcast(signedTx: Uint8Array): Promise<string>;
+    getTransactionStatus(txHash: string): Promise<WalletTxStatus>;
+}
+//# sourceMappingURL=SolanaWalletAdapter.d.ts.map

package/dist/chains/SolanaWalletAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolanaWalletAdapter.d.ts","sourceRoot":"","sources":["../../src/chains/SolanaWalletAdapter.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmBvE,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,UAAU,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;CACtD;AAED,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,QAAQ,CAAC,KAAK,EAAG,QAAQ,CAAU;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAA0C;gBAEhD,IAAI,GAAE,0BAA+B;IAK3C,eAAe,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC;IASxE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5C,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAepE,YAAY,CAChB,SAAS,EAAE,UAAU,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC;IAoBhB,iBAAiB,CACrB,SAAS,EAAE,UAAU,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC;IAqDhB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhD,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAYpE"}

package/dist/chains/SolanaWalletAdapter.js

@@ -0,0 +1,128 @@
+// @ts-nocheck
+/**
+ * @fileoverview Solana chain adapter for the Agent Personal Wallet.
+ *
+ * Uses dynamic imports for @solana/web3.js so it remains an optional dependency.
+ * Patterns derived from the existing SolanaProvider in anchor-providers.
+ *
+ * @module wunderland/wallet/chains/SolanaWalletAdapter
+ */
+// Lazily resolved modules
+let _web3 = null;
+async function getWeb3() {
+    if (!_web3) {
+        try {
+            _web3 = await import('@solana/web3.js');
+        }
+        catch {
+            throw new Error('Missing dependency: @solana/web3.js is required for Solana wallet support. '
+                + 'Install it with: npm install @solana/web3.js');
+        }
+    }
+    return _web3;
+}
+export class SolanaWalletAdapter {
+    chain = 'solana';
+    rpcUrl;
+    commitment;
+    constructor(opts = {}) {
+        this.rpcUrl = opts.rpcUrl || 'https://api.mainnet-beta.solana.com';
+        this.commitment = opts.commitment || 'confirmed';
+    }
+    async generateKeypair() {
+        const { Keypair } = await getWeb3();
+        const kp = Keypair.generate();
+        return {
+            publicKey: kp.publicKey.toBase58(),
+            secretKey: kp.secretKey,
+        };
+    }
+    async getBalance(address) {
+        const { Connection, PublicKey } = await getWeb3();
+        const conn = new Connection(this.rpcUrl, this.commitment);
+        const lamports = await conn.getBalance(new PublicKey(address));
+        return BigInt(lamports);
+    }
+    async getTokenBalance(address, tokenMint) {
+        const { Connection, PublicKey } = await getWeb3();
+        const conn = new Connection(this.rpcUrl, this.commitment);
+        const ownerPk = new PublicKey(address);
+        const mintPk = new PublicKey(tokenMint);
+        // Find the associated token account
+        const accounts = await conn.getTokenAccountsByOwner(ownerPk, { mint: mintPk });
+        if (accounts.value.length === 0)
+            return 0n;
+        // Parse account data to get amount
+        const info = await conn.getTokenAccountBalance(accounts.value[0].pubkey);
+        return BigInt(info.value.amount);
+    }
+    async signTransfer(secretKey, to, amountRaw) {
+        const { Keypair, PublicKey, SystemProgram, Transaction, Connection } = await getWeb3();
+        const conn = new Connection(this.rpcUrl, this.commitment);
+        const signer = Keypair.fromSecretKey(secretKey);
+        const tx = new Transaction().add(SystemProgram.transfer({
+            fromPubkey: signer.publicKey,
+            toPubkey: new PublicKey(to),
+            lamports: Number(amountRaw),
+        }));
+        tx.feePayer = signer.publicKey;
+        tx.recentBlockhash = (await conn.getLatestBlockhash()).blockhash;
+        tx.sign(signer);
+        return tx.serialize();
+    }
+    async signTokenTransfer(secretKey, to, tokenMint, amountRaw) {
+        // SPL token transfers require @solana/spl-token — use dynamic import
+        const { Keypair, PublicKey, Transaction, Connection } = await getWeb3();
+        let splToken;
+        try {
+            splToken = await import('@solana/spl-token');
+        }
+        catch {
+            throw new Error('Missing dependency: @solana/spl-token is required for SPL token transfers. '
+                + 'Install it with: npm install @solana/spl-token');
+        }
+        const conn = new Connection(this.rpcUrl, this.commitment);
+        const signer = Keypair.fromSecretKey(secretKey);
+        const mintPk = new PublicKey(tokenMint);
+        const destPk = new PublicKey(to);
+        // Get or create associated token accounts
+        const sourceAta = splToken.getAssociatedTokenAddressSync(mintPk, signer.publicKey);
+        const destAta = splToken.getAssociatedTokenAddressSync(mintPk, destPk);
+        const tx = new Transaction();
+        // Create destination ATA if it doesn't exist
+        const destAccount = await conn.getAccountInfo(destAta);
+        if (!destAccount) {
+            tx.add(splToken.createAssociatedTokenAccountInstruction(signer.publicKey, destAta, destPk, mintPk));
+        }
+        tx.add(splToken.createTransferInstruction(sourceAta, destAta, signer.publicKey, Number(amountRaw)));
+        tx.feePayer = signer.publicKey;
+        tx.recentBlockhash = (await conn.getLatestBlockhash()).blockhash;
+        tx.sign(signer);
+        return tx.serialize();
+    }
+    async broadcast(signedTx) {
+        const { Connection } = await getWeb3();
+        const conn = new Connection(this.rpcUrl, this.commitment);
+        const sig = await conn.sendRawTransaction(signedTx, {
+            skipPreflight: false,
+            preflightCommitment: this.commitment,
+        });
+        // Wait for confirmation
+        await conn.confirmTransaction(sig, this.commitment);
+        return sig;
+    }
+    async getTransactionStatus(txHash) {
+        const { Connection } = await getWeb3();
+        const conn = new Connection(this.rpcUrl, this.commitment);
+        const status = await conn.getSignatureStatus(txHash);
+        if (!status.value)
+            return 'pending';
+        if (status.value.err)
+            return 'failed';
+        if (status.value.confirmationStatus === 'finalized' || status.value.confirmationStatus === 'confirmed') {
+            return 'confirmed';
+        }
+        return 'pending';
+    }
+}
+//# sourceMappingURL=SolanaWalletAdapter.js.map

package/dist/chains/SolanaWalletAdapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Agent Personal Wallet Extension Pack.
+ *
+ * Provides autonomous crypto spending tools with configurable guardrails:
+ * - check_wallet_balance — query balances across Solana/EVM chains
+ * - send_crypto — send with spending policy enforcement
+ * - wallet_transaction_history — view recent transactions
+ *
+ * @module @framers/agentos-ext-wallet
+ */
+export interface ExtensionContext {
+    options?: Record<string, unknown>;
+    secrets?: Record<string, string>;
+    getSecret?: (key: string) => string | undefined;
+    logger?: {
+        info: (msg: string) => void;
+        warn?: (msg: string) => void;
+    };
+}
+export interface ExtensionPack {
+    name: string;
+    version: string;
+    descriptors: Array<{
+        id: string;
+        kind: string;
+        priority?: number;
+        payload: unknown;
+    }>;
+    onActivate?: () => Promise<void>;
+    onDeactivate?: () => Promise<void>;
+}
+export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
+export { AgentWalletManager, ApprovalRequiredError, SpendingPolicyViolation } from './AgentWalletManager.js';
+export type { AgentWalletManagerOptions, IWalletStore } from './AgentWalletManager.js';
+export { SpendingPolicyEnforcer } from './SpendingPolicyEnforcer.js';
+export type { ISpendingLedgerStore } from './SpendingPolicyEnforcer.js';
+export type { AgentWalletRecord, CategoryBudget, ChainId, IChainWalletAdapter, SpendCategory, SpendCheckResult, SpendingLedgerEntry, SpendingPolicyConfig, TokenInfo, TokenSymbol, WalletConfig, WalletDirection, WalletTransactionRecord, WalletTxStatus, } from './types.js';
+export { DEFAULT_SPENDING_POLICY, DEFAULT_WALLET_CONFIG } from './types.js';
+export { SolanaWalletAdapter } from './chains/SolanaWalletAdapter.js';
+export type { SolanaWalletAdapterOptions } from './chains/SolanaWalletAdapter.js';
+export { EvmWalletAdapter, KNOWN_TOKENS } from './chains/EvmWalletAdapter.js';
+export type { EvmWalletAdapterOptions } from './chains/EvmWalletAdapter.js';
+export { createCheckBalanceTool } from './tools/CheckBalanceTool.js';
+export { createSendCryptoTool } from './tools/SendCryptoTool.js';
+export { createWalletHistoryTool } from './tools/WalletHistoryTool.js';
+export { createIssueCardTool } from './tools/IssueCardTool.js';
+export { createCardStatusTool } from './tools/CardStatusTool.js';
+export { createFreezeCardTool } from './tools/FreezeCardTool.js';
+export { createUnfreezeCardTool } from './tools/UnfreezeCardTool.js';
+export { createCardSpendingSummaryTool } from './tools/CardSpendingSummaryTool.js';
+export { createPayWithCardTool } from './tools/PayWithCardTool.js';
+export { CardManager } from './cards/CardManager.js';
+export type { CardManagerOptions } from './cards/CardManager.js';
+export { CardSpendingBlockedError } from './cards/CardManager.js';
+export { LithicCardAdapter, LithicApiError } from './cards/LithicCardAdapter.js';
+export type { LithicCardAdapterOptions } from './cards/LithicCardAdapter.js';
+export { MccCategoryMap } from './cards/MccCategoryMap.js';
+export type { AgentCardRecord, CardConfig, CardTransactionRecord, CardTxStatus, CardState, CardType, CardNetwork, ICardAdapter, ICardStore, LithicCardResponse, LithicTransaction, SpendingSummary, SpendLimitDuration, } from './cards/types.js';
+export { DEFAULT_CARD_CONFIG } from './cards/types.js';
+export default createExtensionPack;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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