agentwallet-sdk 5.0.0 → 5.0.1

package/dist/escrow/MutualStakeEscrow.js

@@ -0,0 +1,339 @@
+import { resolveVerifierAddress, encodeOptimisticVerifierData } from './verifiers.js';
+// ─── ABIs ────────────────────────────────────────────────────────────────────
+const StakeVaultFactoryAbi = [
+    {
+        name: 'createEscrow',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: '_buyer', type: 'address' },
+            { name: '_seller', type: 'address' },
+            { name: '_token', type: 'address' },
+            { name: '_paymentAmount', type: 'uint256' },
+            { name: '_buyerStake', type: 'uint256' },
+            { name: '_sellerStake', type: 'uint256' },
+            { name: '_verifier', type: 'address' },
+            { name: '_verifierData', type: 'bytes' },
+            { name: '_deadline', type: 'uint256' },
+            { name: '_challengeWindow', type: 'uint256' },
+        ],
+        outputs: [{ name: 'vault', type: 'address' }],
+    },
+    {
+        name: 'VaultCreated',
+        type: 'event',
+        inputs: [
+            { name: 'vault', type: 'address', indexed: true },
+            { name: 'buyer', type: 'address', indexed: true },
+            { name: 'seller', type: 'address', indexed: true },
+            { name: 'token', type: 'address', indexed: false },
+            { name: 'paymentAmount', type: 'uint256', indexed: false },
+            { name: 'buyerStake', type: 'uint256', indexed: false },
+            { name: 'sellerStake', type: 'uint256', indexed: false },
+            { name: 'verifier', type: 'address', indexed: false },
+            { name: 'deadline', type: 'uint256', indexed: false },
+        ],
+    },
+];
+const StakeVaultAbi = [
+    { name: 'fund', type: 'function', stateMutability: 'nonpayable', inputs: [], outputs: [] },
+    { name: 'accept', type: 'function', stateMutability: 'nonpayable', inputs: [], outputs: [] },
+    { name: 'fulfill', type: 'function', stateMutability: 'nonpayable', inputs: [{ name: 'proof', type: 'bytes' }], outputs: [] },
+    { name: 'verify', type: 'function', stateMutability: 'nonpayable', inputs: [], outputs: [] },
+    { name: 'challenge', type: 'function', stateMutability: 'nonpayable', inputs: [{ name: 'evidence', type: 'bytes' }], outputs: [] },
+    { name: 'resolve', type: 'function', stateMutability: 'nonpayable', inputs: [{ name: 'sellerWins', type: 'bool' }], outputs: [] },
+    { name: 'cancel', type: 'function', stateMutability: 'nonpayable', inputs: [], outputs: [] },
+    { name: 'reclaimExpired', type: 'function', stateMutability: 'nonpayable', inputs: [], outputs: [] },
+    {
+        name: 'getEscrowDetails',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [
+            { name: '_buyer', type: 'address' },
+            { name: '_seller', type: 'address' },
+            { name: '_token', type: 'address' },
+            { name: '_paymentAmount', type: 'uint256' },
+            { name: '_buyerStake', type: 'uint256' },
+            { name: '_sellerStake', type: 'uint256' },
+            { name: '_verifier', type: 'address' },
+            { name: '_deadline', type: 'uint256' },
+            { name: '_challengeWindow', type: 'uint256' },
+            { name: '_status', type: 'uint8' },
+            { name: '_fulfilledAt', type: 'uint256' },
+        ],
+    },
+    { name: 'status', type: 'function', stateMutability: 'view', inputs: [], outputs: [{ name: '', type: 'uint8' }] },
+];
+const ERC20ApproveAbi = [
+    {
+        name: 'approve',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+];
+/** Base USDC address */
+const BASE_USDC = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+/**
+ * MutualStakeEscrow — SDK class for creating and managing mutual-stake escrow vaults
+ *
+ * Wraps the StakeVault and StakeVaultFactory contracts with a clean TypeScript API.
+ * Both buyer and seller deposit collateral, ensuring aligned incentives.
+ */
+export class MutualStakeEscrow {
+    constructor(params) {
+        this.publicClient = params.publicClient;
+        this.walletClient = params.walletClient;
+        this.factoryAddress = params.factoryAddress;
+        this.chainId = params.chainId;
+    }
+    /**
+     * Create a new escrow vault via the factory
+     * @param params - Escrow creation parameters
+     * @returns The deployed vault address and transaction hash
+     */
+    async create(params) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const token = params.token ?? BASE_USDC;
+        const verifierAddress = resolveVerifierAddress(params.verifier, this.chainId);
+        const verifierData = params.verifierData ?? encodeOptimisticVerifierData();
+        const txHash = await this.walletClient.writeContract({
+            address: this.factoryAddress,
+            abi: StakeVaultFactoryAbi,
+            functionName: 'createEscrow',
+            args: [
+                account.address,
+                params.seller,
+                token,
+                params.paymentAmount,
+                params.buyerStake,
+                params.sellerStake,
+                verifierAddress,
+                verifierData,
+                BigInt(params.deadline),
+                BigInt(params.challengeWindow),
+            ],
+            account,
+            chain: this.walletClient.chain,
+        });
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash: txHash });
+        // Extract vault address from VaultCreated event
+        const vaultCreatedLog = receipt.logs.find((log) => log.topics[0] === '0x' // Match VaultCreated event signature
+        );
+        // Fallback: read vault address from return data via simulation
+        const vaultAddress = await this.publicClient.readContract({
+            address: this.factoryAddress,
+            abi: StakeVaultFactoryAbi,
+            functionName: 'createEscrow',
+            args: [
+                account.address,
+                params.seller,
+                token,
+                params.paymentAmount,
+                params.buyerStake,
+                params.sellerStake,
+                verifierAddress,
+                verifierData,
+                BigInt(params.deadline),
+                BigInt(params.challengeWindow),
+            ],
+        });
+        return { address: vaultAddress, txHash };
+    }
+    /**
+     * Fund an escrow as buyer (deposits payment + buyerStake)
+     * @param vaultAddress - Address of the StakeVault
+     * @param approveAmount - Total amount to approve (payment + buyerStake)
+     */
+    async fund(vaultAddress, approveAmount) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const details = await this.getDetails(vaultAddress);
+        // Approve token transfer
+        await this.walletClient.writeContract({
+            address: details.token,
+            abi: ERC20ApproveAbi,
+            functionName: 'approve',
+            args: [vaultAddress, approveAmount],
+            account,
+            chain: this.walletClient.chain,
+        });
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'fund',
+            args: [],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Accept an escrow as seller (deposits sellerStake)
+     * @param vaultAddress - Address of the StakeVault
+     */
+    async accept(vaultAddress) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const details = await this.getDetails(vaultAddress);
+        // Approve seller stake transfer
+        await this.walletClient.writeContract({
+            address: details.token,
+            abi: ERC20ApproveAbi,
+            functionName: 'approve',
+            args: [vaultAddress, details.sellerStake],
+            account,
+            chain: this.walletClient.chain,
+        });
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'accept',
+            args: [],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Submit fulfillment proof as seller
+     * @param vaultAddress - Address of the StakeVault
+     * @param proof - Completion proof bytes
+     */
+    async fulfill(vaultAddress, proof) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'fulfill',
+            args: [proof],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Verify completion after challenge window (anyone can call)
+     * @param vaultAddress - Address of the StakeVault
+     */
+    async verify(vaultAddress) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'verify',
+            args: [],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Challenge a fulfillment as buyer
+     * @param vaultAddress - Address of the StakeVault
+     * @param evidence - Challenge evidence bytes
+     */
+    async challenge(vaultAddress, evidence) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'challenge',
+            args: [evidence],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Cancel escrow before seller accepts (buyer only)
+     * @param vaultAddress - Address of the StakeVault
+     */
+    async cancel(vaultAddress) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'cancel',
+            args: [],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Reclaim funds after deadline expiry
+     * @param vaultAddress - Address of the StakeVault
+     */
+    async reclaimExpired(vaultAddress) {
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('Wallet client must have an account');
+        const txHash = await this.walletClient.writeContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'reclaimExpired',
+            args: [],
+            account,
+            chain: this.walletClient.chain,
+        });
+        return { txHash };
+    }
+    /**
+     * Get full escrow details from on-chain
+     * @param vaultAddress - Address of the StakeVault
+     */
+    async getDetails(vaultAddress) {
+        const result = await this.publicClient.readContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'getEscrowDetails',
+            args: [],
+        });
+        const [buyer, seller, token, paymentAmount, buyerStake, sellerStake, verifier, deadline, challengeWindow, statusNum, fulfilledAt] = result;
+        return {
+            buyer,
+            seller,
+            token,
+            paymentAmount,
+            buyerStake,
+            sellerStake,
+            verifier,
+            deadline,
+            challengeWindow,
+            status: statusNum,
+            fulfilledAt,
+        };
+    }
+    /**
+     * Get the current status of an escrow
+     * @param vaultAddress - Address of the StakeVault
+     */
+    async getStatus(vaultAddress) {
+        const result = await this.publicClient.readContract({
+            address: vaultAddress,
+            abi: StakeVaultAbi,
+            functionName: 'status',
+            args: [],
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=MutualStakeEscrow.js.map

package/dist/escrow/MutualStakeEscrow.js.map

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

package/dist/escrow/types.d.ts

@@ -0,0 +1,59 @@
+import type { Address, Hash, Hex } from 'viem';
+/** Mirrors the on-chain TaskStatus enum */
+export declare enum TaskStatus {
+    Created = 0,
+    Funded = 1,
+    Fulfilled = 2,
+    Challenged = 3,
+    Resolved = 4,
+    Cancelled = 5
+}
+/** Supported built-in verifier types */
+export type VerifierType = 'optimistic' | 'hash';
+/** Parameters for creating a new mutual-stake escrow */
+export interface CreateEscrowParams {
+    /** Seller/service-provider address */
+    seller: Address;
+    /** Payment amount in token's smallest unit (e.g., 6 decimals for USDC) */
+    paymentAmount: bigint;
+    /** Buyer's anti-grief collateral */
+    buyerStake: bigint;
+    /** Seller's anti-fraud collateral */
+    sellerStake: bigint;
+    /** Verifier type or custom verifier contract address */
+    verifier: VerifierType | Address;
+    /** Verifier-specific configuration data (auto-generated for built-in verifiers) */
+    verifierData?: Hex;
+    /** Challenge window in seconds after fulfillment */
+    challengeWindow: number;
+    /** Unix timestamp deadline for the task */
+    deadline: number;
+    /** ERC-20 token address (defaults to USDC on Base) */
+    token?: Address;
+}
+/** Result from creating an escrow */
+export interface EscrowCreated {
+    /** Address of the deployed StakeVault contract */
+    address: Address;
+    /** Transaction hash of the factory call */
+    txHash: Hash;
+}
+/** Full escrow details from on-chain */
+export interface EscrowDetails {
+    buyer: Address;
+    seller: Address;
+    token: Address;
+    paymentAmount: bigint;
+    buyerStake: bigint;
+    sellerStake: bigint;
+    verifier: Address;
+    deadline: bigint;
+    challengeWindow: bigint;
+    status: TaskStatus;
+    fulfilledAt: bigint;
+}
+/** Transaction result */
+export interface TxResult {
+    txHash: Hash;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/escrow/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE/C,2CAA2C;AAC3C,oBAAY,UAAU;IACpB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,SAAS,IAAI;IACb,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,SAAS,IAAI;CACd;AAED,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjD,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;IACjC,mFAAmF;IACnF,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,IAAI,CAAC;CACd;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,IAAI,CAAC;CACd"}

package/dist/escrow/types.js

@@ -0,0 +1,11 @@
+/** Mirrors the on-chain TaskStatus enum */
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus[TaskStatus["Created"] = 0] = "Created";
+    TaskStatus[TaskStatus["Funded"] = 1] = "Funded";
+    TaskStatus[TaskStatus["Fulfilled"] = 2] = "Fulfilled";
+    TaskStatus[TaskStatus["Challenged"] = 3] = "Challenged";
+    TaskStatus[TaskStatus["Resolved"] = 4] = "Resolved";
+    TaskStatus[TaskStatus["Cancelled"] = 5] = "Cancelled";
+})(TaskStatus || (TaskStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/escrow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/escrow/types.ts"],"names":[],"mappings":"AAEA,2CAA2C;AAC3C,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,iDAAW,CAAA;IACX,+CAAU,CAAA;IACV,qDAAa,CAAA;IACb,uDAAc,CAAA;IACd,mDAAY,CAAA;IACZ,qDAAa,CAAA;AACf,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB"}

package/dist/escrow/verifiers.d.ts

@@ -0,0 +1,26 @@
+import { type Address, type Hex } from 'viem';
+import type { VerifierType } from './types.js';
+/**
+ * Known verifier contract addresses on Base mainnet.
+ * These are deployed once and shared by all StakeVault instances.
+ */
+export declare const VERIFIER_ADDRESSES: Record<string, Record<VerifierType, Address>>;
+/**
+ * Resolve a verifier type to its deployed contract address for a given chain
+ * @param verifier - Built-in verifier type or custom contract address
+ * @param chainId - Chain ID to look up
+ * @returns The verifier contract address
+ */
+export declare function resolveVerifierAddress(verifier: VerifierType | Address, chainId: number): Address;
+/**
+ * Encode verifier configuration data for the HashVerifier
+ * @param expectedHash - SHA256 hash of the expected output
+ * @returns ABI-encoded bytes for the verifierData field
+ */
+export declare function encodeHashVerifierData(expectedHash: Hex): Hex;
+/**
+ * Encode verifier configuration data for the OptimisticVerifier
+ * @returns Empty bytes (optimistic verifier has no config)
+ */
+export declare function encodeOptimisticVerifierData(): Hex;
+//# sourceMappingURL=verifiers.d.ts.map

package/dist/escrow/verifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifiers.d.ts","sourceRoot":"","sources":["../../src/escrow/verifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAA2C,MAAM,MAAM,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAW5E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAgBjG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,GAAG,GAAG,GAAG,CAE7D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,GAAG,CAElD"}

package/dist/escrow/verifiers.js

@@ -0,0 +1,53 @@
+import { encodeAbiParameters, parseAbiParameters } from 'viem';
+/**
+ * Known verifier contract addresses on Base mainnet.
+ * These are deployed once and shared by all StakeVault instances.
+ */
+export const VERIFIER_ADDRESSES = {
+    // Base mainnet (chain ID 8453)
+    '8453': {
+        optimistic: '0x0000000000000000000000000000000000000000', // Pre-deployment: set after deploying StakeVault verifier contracts to Base
+        hash: '0x0000000000000000000000000000000000000000', // Pre-deployment: set after deploying StakeVault verifier contracts to Base
+    },
+    // Base Sepolia testnet (chain ID 84532)
+    '84532': {
+        optimistic: '0x0000000000000000000000000000000000000000', // Pre-deployment: set after deploying StakeVault verifier contracts to Base
+        hash: '0x0000000000000000000000000000000000000000', // Pre-deployment: set after deploying StakeVault verifier contracts to Base
+    },
+};
+/**
+ * Resolve a verifier type to its deployed contract address for a given chain
+ * @param verifier - Built-in verifier type or custom contract address
+ * @param chainId - Chain ID to look up
+ * @returns The verifier contract address
+ */
+export function resolveVerifierAddress(verifier, chainId) {
+    if (verifier.startsWith('0x') && verifier.length === 42) {
+        return verifier;
+    }
+    const chainAddresses = VERIFIER_ADDRESSES[chainId.toString()];
+    if (!chainAddresses) {
+        throw new Error(`No verifier addresses configured for chain ${chainId}`);
+    }
+    const address = chainAddresses[verifier];
+    if (!address || address === '0x0000000000000000000000000000000000000000') {
+        throw new Error(`Verifier "${verifier}" not deployed on chain ${chainId}. Deploy it first or pass a custom address.`);
+    }
+    return address;
+}
+/**
+ * Encode verifier configuration data for the HashVerifier
+ * @param expectedHash - SHA256 hash of the expected output
+ * @returns ABI-encoded bytes for the verifierData field
+ */
+export function encodeHashVerifierData(expectedHash) {
+    return encodeAbiParameters(parseAbiParameters('bytes32'), [expectedHash]);
+}
+/**
+ * Encode verifier configuration data for the OptimisticVerifier
+ * @returns Empty bytes (optimistic verifier has no config)
+ */
+export function encodeOptimisticVerifierData() {
+    return '0x';
+}
+//# sourceMappingURL=verifiers.js.map

package/dist/escrow/verifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifiers.js","sourceRoot":"","sources":["../../src/escrow/verifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAGvF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkD;IAC/E,+BAA+B;IAC/B,MAAM,EAAE;QACN,UAAU,EAAE,4CAA4C,EAAE,0BAA0B;QACpF,IAAI,EAAE,4CAA4C,EAAE,0BAA0B;KAC/E;IACD,wCAAwC;IACxC,OAAO,EAAE;QACP,UAAU,EAAE,4CAA4C,EAAE,0BAA0B;QACpF,IAAI,EAAE,4CAA4C,EAAE,0BAA0B;KAC/E;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgC,EAAE,OAAe;IACtF,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxD,OAAO,QAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,8CAA8C,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,QAAwB,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,4CAA4C,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,2BAA2B,OAAO,6CAA6C,CAAC,CAAC;IACxH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAiB;IACtD,OAAO,mBAAmB,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/fiat/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fiat Onramp module — optional fiat-to-crypto for agentwallet-sdk.
+ *
+ * This module is OPT-IN ONLY. Import and use FiatOnramp only if you want
+ * fiat onramp capability. The core SDK is fully anonymous and non-custodial.
+ */
+export { FiatOnramp } from './onramp.js';
+export type { FiatOnrampConfig, FiatQuote, OnrampParams, FiatProvider } from './types.js';
+export { MoonPayProvider, StripeProvider, TransakProvider } from './providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fiat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fiat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/fiat/index.js

@@ -0,0 +1,9 @@
+/**
+ * Fiat Onramp module — optional fiat-to-crypto for agentwallet-sdk.
+ *
+ * This module is OPT-IN ONLY. Import and use FiatOnramp only if you want
+ * fiat onramp capability. The core SDK is fully anonymous and non-custodial.
+ */
+export { FiatOnramp } from './onramp.js';
+export { MoonPayProvider, StripeProvider, TransakProvider } from './providers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/fiat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fiat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/fiat/onramp.d.ts

@@ -0,0 +1,101 @@
+/**
+ * FiatOnramp — optional fiat-to-crypto onramp module for agentwallet-sdk.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║  KYC NOTICE — IMPORTANT                                             ║
+ * ║                                                                      ║
+ * ║  This module is entirely OPT-IN. Users who fund their agent wallet  ║
+ * ║  via direct crypto transfer, bridge, or any other method NEVER      ║
+ * ║  encounter KYC and remain fully anonymous.                           ║
+ * ║                                                                      ║
+ * ║  KYC only occurs when a user explicitly chooses to use this fiat    ║
+ * ║  onramp feature. KYC is handled entirely by the third-party         ║
+ * ║  provider (MoonPay, Stripe, Transak) on their hosted page.          ║
+ * ║  The SDK never collects, stores, or transmits any KYC data.         ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import type { FiatOnrampConfig, FiatQuote, OnrampParams } from './types.js';
+/**
+ * FiatOnramp — aggregates multiple fiat onramp providers into a single interface.
+ *
+ * @example
+ * ```typescript
+ * import { FiatOnramp } from 'agentwallet-sdk';
+ *
+ * // Only configure providers you have API keys for
+ * const onramp = new FiatOnramp({
+ *   moonpayApiKey: process.env.MOONPAY_API_KEY,
+ *   transakApiKey: process.env.TRANSAK_API_KEY,
+ * });
+ *
+ * // Get quotes from all configured providers
+ * const quotes = await onramp.getQuotes({
+ *   amount: 100,
+ *   currency: 'USD',
+ *   token: 'USDC',
+ *   chain: 'base',
+ *   walletAddress: '0xYourWalletAddress',
+ * });
+ *
+ * // Open the purchaseUrl in a browser to complete KYC + payment on the provider's page
+ * console.log(quotes[0].purchaseUrl);
+ * ```
+ */
+export declare class FiatOnramp {
+    private providers;
+    private config;
+    /**
+     * Create a FiatOnramp instance.
+     *
+     * @param config - Provider API keys and defaults. All fields are optional.
+     *                 Passing no config (or an empty object) is valid — it returns
+     *                 an empty provider list, causing zero friction for users who
+     *                 don't want fiat onramp.
+     */
+    constructor(config?: FiatOnrampConfig);
+    /**
+     * Get quotes from all configured providers that support the given chain/token.
+     * Failed providers are silently skipped (logged to console.warn).
+     *
+     * @returns Array of FiatQuote — may be empty if no providers are configured
+     *          or if none support the requested chain/token combination.
+     */
+    getQuotes(params: OnrampParams): Promise<FiatQuote[]>;
+    /**
+     * Create a purchase session with a specific provider.
+     * Returns a FiatQuote containing a purchaseUrl — open this in a browser
+     * to complete KYC + payment on the provider's hosted page.
+     *
+     * @throws Error if the provider is not configured or doesn't support the chain/token.
+     */
+    createSession(params: OnrampParams & {
+        provider: string;
+    }): Promise<FiatQuote>;
+    /**
+     * Check if a provider supports a given chain/token combination.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     * @param chain - Blockchain name: 'ethereum', 'base', 'solana', etc.
+     * @param token - Token symbol: 'USDC', 'ETH', 'SOL', etc.
+     */
+    isSupported(provider: string, chain: string, token: string): boolean;
+    /**
+     * Get the names of all configured providers.
+     * Returns an empty array if no API keys were provided.
+     */
+    getProviders(): string[];
+    /**
+     * Get the chains supported by a given provider.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     */
+    getSupportedChains(provider: string): string[];
+    /**
+     * Get the tokens supported by a given provider on a given chain.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     * @param chain - Blockchain name: 'ethereum', 'base', 'solana', etc.
+     */
+    getSupportedTokens(provider: string, chain: string): string[];
+}
+//# sourceMappingURL=onramp.d.ts.map

package/dist/fiat/onramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onramp.d.ts","sourceRoot":"","sources":["../../src/fiat/onramp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAgB,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAmB;IAEjC;;;;;;;OAOG;gBACS,MAAM,GAAE,gBAAqB;IAKzC;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA2B3D;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IA8BpF;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpE;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAM9C;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAK9D"}