@abbababa/sdk 0.1.0

package/dist/wallet/escrow.js

@@ -0,0 +1,184 @@
+import { encodeFunctionData, keccak256, toBytes, createPublicClient, http, } from 'viem';
+import { polygonAmoy, polygon, baseSepolia, base } from 'viem/chains';
+import { SERVICE_ESCROW_V2_ABI, SERVICE_ESCROW_V3_ABI, ERC20_ABI } from './abi.js';
+import { ESCROW_ADDRESSES, ESCROW_V2_ADDRESSES, USDC_ADDRESSES, POLYGON_AMOY_CHAIN_ID, POLYGON_MAINNET_CHAIN_ID, BASE_SEPOLIA_CHAIN_ID, BASE_MAINNET_CHAIN_ID, } from './constants.js';
+const CHAINS = {
+    [POLYGON_AMOY_CHAIN_ID]: polygonAmoy,
+    [POLYGON_MAINNET_CHAIN_ID]: polygon,
+    [BASE_SEPOLIA_CHAIN_ID]: baseSepolia,
+    [BASE_MAINNET_CHAIN_ID]: base,
+};
+/**
+ * Client for interacting with the ServiceEscrow smart contracts.
+ * Supports V3 (multi-token) with automatic fallback to V2 (USDC only).
+ * Uses a ZeroDev Kernel account client for sending UserOperations.
+ */
+export class EscrowClient {
+    kernelClient;
+    chainId;
+    escrowAddress;
+    escrowVersion;
+    tokenAddress;
+    tokenDecimals;
+    constructor(kernelClient, token, chainId = BASE_SEPOLIA_CHAIN_ID) {
+        this.kernelClient = kernelClient;
+        this.chainId = chainId;
+        // Resolve token (default USDC for backward compat)
+        if (token) {
+            this.tokenAddress = token.address;
+            this.tokenDecimals = token.decimals;
+        }
+        else {
+            const usdc = USDC_ADDRESSES[chainId];
+            if (!usdc)
+                throw new Error(`No USDC address for chain ${chainId}`);
+            this.tokenAddress = usdc;
+            this.tokenDecimals = 6;
+        }
+        // Try V3 first, fall back to V2
+        const v3 = ESCROW_ADDRESSES[chainId];
+        const v2 = ESCROW_V2_ADDRESSES[chainId];
+        if (v3) {
+            this.escrowAddress = v3;
+            this.escrowVersion = 3;
+        }
+        else if (v2) {
+            this.escrowAddress = v2;
+            this.escrowVersion = 2;
+        }
+        else {
+            throw new Error(`No escrow contract for chain ${chainId}`);
+        }
+    }
+    /**
+     * Convert a platform transaction ID (CUID string) to a bytes32 escrow ID.
+     * Uses keccak256, matching the existing backend pattern in escrow.ts (ethers.id).
+     */
+    static toEscrowId(transactionId) {
+        return keccak256(toBytes(transactionId));
+    }
+    /**
+     * Approve the escrow contract to spend the settlement token on behalf of the smart account.
+     * Must be called before fundEscrow.
+     */
+    async approveToken(amount) {
+        // Buyer fee is 1% (100 bps). Approve the total: amount + 1% fee
+        const buyerFee = (amount * 100n) / 10000n;
+        const totalApproval = amount + buyerFee;
+        const data = encodeFunctionData({
+            abi: ERC20_ABI,
+            functionName: 'approve',
+            args: [this.escrowAddress, totalApproval],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.tokenAddress,
+            data,
+        });
+        return txHash;
+    }
+    /** @deprecated Use approveToken() instead. */
+    async approveUSDC(amount) {
+        return this.approveToken(amount);
+    }
+    /**
+     * Fund an escrow. Calls createEscrow on the escrow contract.
+     * V3: passes token address as 4th argument.
+     * V2 fallback: USDC only (3 arguments).
+     * The contract will safeTransferFrom the token (amount + 1% buyer fee) from the caller.
+     */
+    async fundEscrow(transactionId, sellerAddress, amount) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        let data;
+        if (this.escrowVersion === 3) {
+            data = encodeFunctionData({
+                abi: SERVICE_ESCROW_V3_ABI,
+                functionName: 'createEscrow',
+                args: [escrowId, sellerAddress, amount, this.tokenAddress],
+            });
+        }
+        else {
+            data = encodeFunctionData({
+                abi: SERVICE_ESCROW_V2_ABI,
+                functionName: 'createEscrow',
+                args: [escrowId, sellerAddress, amount],
+            });
+        }
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.escrowAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Release escrow funds to the seller.
+     * Callable by the buyer or an arbitrator.
+     */
+    async releaseEscrow(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const abi = this.escrowVersion === 3 ? SERVICE_ESCROW_V3_ABI : SERVICE_ESCROW_V2_ABI;
+        const data = encodeFunctionData({
+            abi,
+            functionName: 'release',
+            args: [escrowId],
+        });
+        const txHash = await this.kernelClient.sendTransaction({
+            to: this.escrowAddress,
+            data,
+        });
+        return txHash;
+    }
+    /**
+     * Read escrow details from the contract (view function, no gas needed).
+     */
+    async getEscrow(transactionId) {
+        const escrowId = EscrowClient.toEscrowId(transactionId);
+        const viemChain = CHAINS[this.chainId] ?? polygonAmoy;
+        const publicClient = createPublicClient({
+            chain: viemChain,
+            transport: http(),
+        });
+        if (this.escrowVersion === 3) {
+            const result = await publicClient.readContract({
+                address: this.escrowAddress,
+                abi: SERVICE_ESCROW_V3_ABI,
+                functionName: 'getEscrow',
+                args: [escrowId],
+            });
+            const [token, buyer, seller, amount, buyerFee, status, createdAt, expiresAt] = result;
+            if (buyer === '0x0000000000000000000000000000000000000000') {
+                return null;
+            }
+            return {
+                token,
+                buyer,
+                seller,
+                amount,
+                buyerFee,
+                status,
+                createdAt: Number(createdAt),
+                expiresAt: Number(expiresAt),
+            };
+        }
+        // V2 fallback
+        const result = await publicClient.readContract({
+            address: this.escrowAddress,
+            abi: SERVICE_ESCROW_V2_ABI,
+            functionName: 'getEscrow',
+            args: [escrowId],
+        });
+        const [buyer, seller, amount, buyerFee, status, createdAt, expiresAt] = result;
+        if (buyer === '0x0000000000000000000000000000000000000000') {
+            return null;
+        }
+        return {
+            buyer,
+            seller,
+            amount,
+            buyerFee,
+            status,
+            createdAt: Number(createdAt),
+            expiresAt: Number(expiresAt),
+        };
+    }
+}
+//# sourceMappingURL=escrow.js.map

package/dist/wallet/escrow.js.map

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

package/dist/wallet/index.d.ts

@@ -0,0 +1,6 @@
+export { createSmartAccount, buildKernelClient } from './smart-account.js';
+export { EscrowClient } from './escrow.js';
+export { generateSessionKey, useSessionKey, revokeSessionKey, buildEscrowPolicies, } from './session-keys.js';
+export { ESCROW_ADDRESSES, ESCROW_V2_ADDRESSES, TOKEN_REGISTRY, getToken, getTokensByTier, isTokenSupported, USDC_ADDRESSES, USDC_DECIMALS, POLYGON_AMOY_CHAIN_ID, POLYGON_MAINNET_CHAIN_ID, MIN_GAS_BALANCE, } from './constants.js';
+export type { TokenInfo } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,gBAAgB,EAEhB,mBAAmB,EAEnB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,gBAAgB,EAEhB,cAAc,EACd,aAAa,EAEb,qBAAqB,EACrB,wBAAwB,EAExB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/wallet/index.js

@@ -0,0 +1,17 @@
+export { createSmartAccount, buildKernelClient } from './smart-account.js';
+export { EscrowClient } from './escrow.js';
+export { generateSessionKey, useSessionKey, revokeSessionKey, buildEscrowPolicies, } from './session-keys.js';
+export { 
+// V3 multi-token escrow
+ESCROW_ADDRESSES, 
+// V2 legacy (single-token USDC)
+ESCROW_V2_ADDRESSES, 
+// Token registry
+TOKEN_REGISTRY, getToken, getTokensByTier, isTokenSupported, 
+// Legacy compat (deprecated)
+USDC_ADDRESSES, USDC_DECIMALS, 
+// Chain IDs
+POLYGON_AMOY_CHAIN_ID, POLYGON_MAINNET_CHAIN_ID, 
+// Gas
+MIN_GAS_BALANCE, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/wallet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wallet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO;AACL,wBAAwB;AACxB,gBAAgB;AAChB,gCAAgC;AAChC,mBAAmB;AACnB,iBAAiB;AACjB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,gBAAgB;AAChB,6BAA6B;AAC7B,cAAc,EACd,aAAa;AACb,YAAY;AACZ,qBAAqB,EACrB,wBAAwB;AACxB,MAAM;AACN,eAAe,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/wallet/session-keys.d.ts

@@ -0,0 +1,58 @@
+import type { SessionKeyConfig, SessionKeyResult, UseSessionKeyConfig, RevokeSessionKeyConfig, SmartAccountResult } from '../types.js';
+/**
+ * Build escrow-scoped policies for a session key.
+ *
+ * Creates a CallPolicy restricted to escrow operations:
+ * 1. ERC20.approve for each allowed token (spender must equal escrow contract)
+ * 2. Escrow.createEscrow (V3 with token param, or V2 fallback)
+ * 3. Escrow.release
+ *
+ * Plus a TimestampPolicy for time-bound expiration.
+ *
+ * @param config.tokens - Token symbols to allow (default: all tokens in registry for chain)
+ *
+ * Requires @zerodev/permissions as a peer dependency.
+ */
+export declare function buildEscrowPolicies(config: {
+    chainId?: number;
+    validitySeconds?: number;
+    tokens?: string[];
+}): Promise<unknown[]>;
+/**
+ * Generate a scoped session key for an agent (owner operation).
+ *
+ * The owner calls this with their private key. A random session key is generated,
+ * scoped to escrow operations via CallPolicy + TimestampPolicy, and serialized
+ * into a single string that can be passed to the agent.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/ecdsa-validator
+ * - @zerodev/permissions
+ */
+export declare function generateSessionKey(config: SessionKeyConfig): Promise<SessionKeyResult>;
+/**
+ * Use a serialized session key to get a working kernel client (agent operation).
+ *
+ * The agent calls this with the serialized string received from the owner.
+ * No owner private key is needed — the session key was embedded during serialization.
+ * The resulting kernel client can only perform actions allowed by the session's policies.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/permissions
+ */
+export declare function useSessionKey(config: UseSessionKeyConfig): Promise<SmartAccountResult>;
+/**
+ * Revoke a session key on-chain (owner operation).
+ *
+ * The owner calls this with their private key and the serialized session key
+ * to reconstruct and uninstall the permission plugin from the Kernel account.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/ecdsa-validator
+ * - @zerodev/permissions
+ */
+export declare function revokeSessionKey(config: RevokeSessionKeyConfig): Promise<string>;
+//# sourceMappingURL=session-keys.d.ts.map

package/dist/wallet/session-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-keys.d.ts","sourceRoot":"","sources":["../../src/wallet/session-keys.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAEnB,MAAM,aAAa,CAAA;AASpB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA6FrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA2F3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA0D7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/dist/wallet/session-keys.js

@@ -0,0 +1,313 @@
+import { createPublicClient, http, } from 'viem';
+import { polygonAmoy, polygon } from 'viem/chains';
+import { SERVICE_ESCROW_V2_ABI, SERVICE_ESCROW_V3_ABI, ERC20_ABI } from './abi.js';
+import { ESCROW_ADDRESSES, ESCROW_V2_ADDRESSES, USDC_ADDRESSES, POLYGON_AMOY_CHAIN_ID, ZERODEV_BUNDLER_URL, ZERODEV_PAYMASTER_URL, MIN_GAS_BALANCE, TOKEN_REGISTRY, } from './constants.js';
+import { buildKernelClient } from './smart-account.js';
+const CHAINS = {
+    polygon,
+    polygonAmoy,
+};
+const DEFAULT_VALIDITY_SECONDS = 86400; // 24 hours
+/**
+ * Build escrow-scoped policies for a session key.
+ *
+ * Creates a CallPolicy restricted to escrow operations:
+ * 1. ERC20.approve for each allowed token (spender must equal escrow contract)
+ * 2. Escrow.createEscrow (V3 with token param, or V2 fallback)
+ * 3. Escrow.release
+ *
+ * Plus a TimestampPolicy for time-bound expiration.
+ *
+ * @param config.tokens - Token symbols to allow (default: all tokens in registry for chain)
+ *
+ * Requires @zerodev/permissions as a peer dependency.
+ */
+export async function buildEscrowPolicies(config) {
+    const chainId = config.chainId ?? POLYGON_AMOY_CHAIN_ID;
+    const validitySeconds = config.validitySeconds ?? DEFAULT_VALIDITY_SECONDS;
+    const { toCallPolicy, CallPolicyVersion, ParamCondition } = await import('@zerodev/permissions/policies');
+    const { toTimestampPolicy } = await import('@zerodev/permissions/policies');
+    // Resolve escrow contract (V3 preferred, V2 fallback)
+    const v3Address = ESCROW_ADDRESSES[chainId];
+    const v2Address = ESCROW_V2_ADDRESSES[chainId];
+    const escrowAddress = v3Address ?? v2Address;
+    if (!escrowAddress)
+        throw new Error(`No escrow contract for chain ${chainId}`);
+    const isV3 = !!v3Address;
+    // Resolve tokens to allow
+    const registry = TOKEN_REGISTRY[chainId] ?? {};
+    const tokenSymbols = config.tokens ?? Object.keys(registry);
+    const tokenAddresses = [];
+    for (const symbol of tokenSymbols) {
+        const info = registry[symbol];
+        if (info)
+            tokenAddresses.push(info.address);
+    }
+    // Fallback: if no tokens resolved, use USDC
+    if (tokenAddresses.length === 0) {
+        const usdc = USDC_ADDRESSES[chainId];
+        if (usdc)
+            tokenAddresses.push(usdc);
+    }
+    if (tokenAddresses.length === 0) {
+        throw new Error(`No token addresses for chain ${chainId}`);
+    }
+    // Build permissions: one approve entry per token + escrow operations
+    const permissions = [];
+    for (const tokenAddr of tokenAddresses) {
+        permissions.push({
+            target: tokenAddr,
+            abi: ERC20_ABI,
+            functionName: 'approve',
+            args: [
+                {
+                    condition: ParamCondition.EQUAL,
+                    value: escrowAddress,
+                },
+                null, // amount — no restriction
+            ],
+        });
+    }
+    if (isV3) {
+        permissions.push({
+            target: escrowAddress,
+            abi: SERVICE_ESCROW_V3_ABI,
+            functionName: 'createEscrow',
+            args: [null, null, null, null], // escrowId, seller, amount, token
+        });
+        permissions.push({
+            target: escrowAddress,
+            abi: SERVICE_ESCROW_V3_ABI,
+            functionName: 'release',
+            args: [null],
+        });
+    }
+    else {
+        permissions.push({
+            target: escrowAddress,
+            abi: SERVICE_ESCROW_V2_ABI,
+            functionName: 'createEscrow',
+            args: [null, null, null], // escrowId, seller, amount
+        });
+        permissions.push({
+            target: escrowAddress,
+            abi: SERVICE_ESCROW_V2_ABI,
+            functionName: 'release',
+            args: [null],
+        });
+    }
+    const callPolicy = toCallPolicy({
+        policyVersion: CallPolicyVersion.V0_0_4,
+        permissions,
+    });
+    const validUntil = Math.floor(Date.now() / 1000) + validitySeconds;
+    const timestampPolicy = toTimestampPolicy({
+        validUntil,
+    });
+    return [callPolicy, timestampPolicy];
+}
+/**
+ * Generate a scoped session key for an agent (owner operation).
+ *
+ * The owner calls this with their private key. A random session key is generated,
+ * scoped to escrow operations via CallPolicy + TimestampPolicy, and serialized
+ * into a single string that can be passed to the agent.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/ecdsa-validator
+ * - @zerodev/permissions
+ */
+export async function generateSessionKey(config) {
+    // Dynamic imports — optional peer dependencies
+    const sdk = await import('@zerodev/sdk');
+    const { signerToEcdsaValidator } = await import('@zerodev/ecdsa-validator');
+    const { generatePrivateKey, privateKeyToAccount } = await import('viem/accounts');
+    const { toPermissionValidator, serializePermissionAccount } = await import('@zerodev/permissions');
+    const { toEmptyECDSASigner } = await import('@zerodev/permissions/signers');
+    const { createKernelAccount, createZeroDevPaymasterClient, constants, } = sdk;
+    const chain = CHAINS[config.chain ?? 'polygonAmoy'];
+    if (!chain)
+        throw new Error(`Unsupported chain: ${config.chain}`);
+    const entryPoint = constants.getEntryPoint('0.7');
+    const kernelVersion = constants.KERNEL_V3_1;
+    const bundlerUrl = `${ZERODEV_BUNDLER_URL}/${config.zeroDevProjectId}`;
+    const paymasterUrl = `${ZERODEV_PAYMASTER_URL}/${config.zeroDevProjectId}`;
+    // 1. Public client for chain reads
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    // 2. Create the owner's EOA signer
+    const ownerSigner = privateKeyToAccount(config.ownerPrivateKey);
+    // 3. Create owner's ECDSA validator (sudo)
+    const ecdsaValidator = await signerToEcdsaValidator(publicClient, {
+        signer: ownerSigner,
+        entryPoint,
+        kernelVersion,
+    });
+    // 4. Generate a random session key
+    const sessionPrivateKey = generatePrivateKey();
+    const sessionKeyAccount = privateKeyToAccount(sessionPrivateKey);
+    // 5. Create an empty ECDSA signer from the session key's address
+    //    (the owner doesn't need the session private key to authorize it)
+    const emptySessionSigner = toEmptyECDSASigner(sessionKeyAccount.address);
+    // 6. Build policies (escrow-scoped by default, or custom)
+    const chainId = chain.id;
+    const policies = config.customPolicies
+        ? config.customPolicies
+        : await buildEscrowPolicies({
+            chainId,
+            validitySeconds: config.validitySeconds ?? DEFAULT_VALIDITY_SECONDS,
+        });
+    // 7. Create permission validator (regular plugin)
+    const permissionPlugin = await toPermissionValidator(publicClient, {
+        signer: emptySessionSigner,
+        policies: policies,
+        entryPoint,
+        kernelVersion,
+    });
+    // 8. Create kernel account with sudo (owner) + regular (session key)
+    const kernelAccount = await createKernelAccount(publicClient, {
+        plugins: {
+            sudo: ecdsaValidator,
+            regular: permissionPlugin,
+        },
+        entryPoint,
+        kernelVersion,
+    });
+    // 9. Serialize the account with the session private key embedded
+    const serialized = await serializePermissionAccount(kernelAccount, sessionPrivateKey);
+    return {
+        serializedSessionKey: serialized,
+        sessionKeyAddress: sessionKeyAccount.address,
+        smartAccountAddress: kernelAccount.address,
+    };
+}
+/**
+ * Use a serialized session key to get a working kernel client (agent operation).
+ *
+ * The agent calls this with the serialized string received from the owner.
+ * No owner private key is needed — the session key was embedded during serialization.
+ * The resulting kernel client can only perform actions allowed by the session's policies.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/permissions
+ */
+export async function useSessionKey(config) {
+    const sdk = await import('@zerodev/sdk');
+    const { deserializePermissionAccount } = await import('@zerodev/permissions');
+    const { constants } = sdk;
+    const chain = CHAINS[config.chain ?? 'polygonAmoy'];
+    if (!chain)
+        throw new Error(`Unsupported chain: ${config.chain}`);
+    const entryPoint = constants.getEntryPoint('0.7');
+    const kernelVersion = constants.KERNEL_V3_1;
+    const bundlerUrl = `${ZERODEV_BUNDLER_URL}/${config.zeroDevProjectId}`;
+    const paymasterUrl = `${ZERODEV_PAYMASTER_URL}/${config.zeroDevProjectId}`;
+    // 1. Public client
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    // 2. Deserialize the session key account
+    //    The session private key + policies are embedded in the serialized string
+    const sessionKeyAccount = await deserializePermissionAccount(publicClient, entryPoint, kernelVersion, config.serializedSessionKey);
+    // 3. Resolve gas strategy
+    const strategy = config.gasStrategy ?? 'auto';
+    let resolvedStrategy;
+    if (strategy === 'auto') {
+        const balance = await publicClient.getBalance({
+            address: sessionKeyAccount.address,
+        });
+        resolvedStrategy = balance >= MIN_GAS_BALANCE ? 'self-funded' : 'erc20';
+    }
+    else {
+        resolvedStrategy = strategy;
+    }
+    // 4. Create kernel client with resolved gas strategy
+    const kernelClient = await buildKernelClient({
+        account: sessionKeyAccount,
+        chain,
+        bundlerUrl,
+        paymasterUrl,
+        gasStrategy: resolvedStrategy,
+    });
+    return {
+        address: sessionKeyAccount.address,
+        kernelClient,
+        gasStrategy: resolvedStrategy,
+    };
+}
+/**
+ * Revoke a session key on-chain (owner operation).
+ *
+ * The owner calls this with their private key and the serialized session key
+ * to reconstruct and uninstall the permission plugin from the Kernel account.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/ecdsa-validator
+ * - @zerodev/permissions
+ */
+export async function revokeSessionKey(config) {
+    const sdk = await import('@zerodev/sdk');
+    const { signerToEcdsaValidator } = await import('@zerodev/ecdsa-validator');
+    const { privateKeyToAccount } = await import('viem/accounts');
+    const { deserializePermissionAccount } = await import('@zerodev/permissions');
+    const { createKernelAccount, constants, } = sdk;
+    const chain = CHAINS[config.chain ?? 'polygonAmoy'];
+    if (!chain)
+        throw new Error(`Unsupported chain: ${config.chain}`);
+    const entryPoint = constants.getEntryPoint('0.7');
+    const kernelVersion = constants.KERNEL_V3_1;
+    const bundlerUrl = `${ZERODEV_BUNDLER_URL}/${config.zeroDevProjectId}`;
+    const paymasterUrl = `${ZERODEV_PAYMASTER_URL}/${config.zeroDevProjectId}`;
+    // 1. Public client
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    // 2. Reconstruct the owner's sudo validator
+    const ownerSigner = privateKeyToAccount(config.ownerPrivateKey);
+    const ecdsaValidator = await signerToEcdsaValidator(publicClient, {
+        signer: ownerSigner,
+        entryPoint,
+        kernelVersion,
+    });
+    // 3. Deserialize the session key to get the permission plugin
+    const sessionKeyAccount = await deserializePermissionAccount(publicClient, entryPoint, kernelVersion, config.serializedSessionKey);
+    // 4. Create the sudo kernel account (owner has full control)
+    const sudoAccount = await createKernelAccount(publicClient, {
+        plugins: { sudo: ecdsaValidator },
+        entryPoint,
+        kernelVersion,
+    });
+    // 5. Resolve gas strategy
+    const strategy = config.gasStrategy ?? 'auto';
+    let resolvedStrategy;
+    if (strategy === 'auto') {
+        const balance = await publicClient.getBalance({
+            address: sudoAccount.address,
+        });
+        resolvedStrategy = balance >= MIN_GAS_BALANCE ? 'self-funded' : 'erc20';
+    }
+    else {
+        resolvedStrategy = strategy;
+    }
+    // 6. Create sudo kernel client with resolved gas strategy
+    const sudoClient = await buildKernelClient({
+        account: sudoAccount,
+        chain,
+        bundlerUrl,
+        paymasterUrl,
+        gasStrategy: resolvedStrategy,
+    });
+    // 7. Uninstall the permission plugin
+    const userOpHash = await sudoClient.uninstallPlugin({
+        plugin: sessionKeyAccount,
+    });
+    return userOpHash;
+}
+//# sourceMappingURL=session-keys.js.map

package/dist/wallet/session-keys.js.map

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

package/dist/wallet/smart-account.d.ts

@@ -0,0 +1,30 @@
+import { type Chain } from 'viem';
+import type { SmartAccountConfig, SmartAccountResult } from '../types.js';
+/**
+ * Build a kernel account client with the appropriate gas strategy.
+ *
+ * Shared by createSmartAccount() and session-keys.ts to avoid duplicating
+ * paymaster configuration logic.
+ */
+export declare function buildKernelClient(opts: {
+    account: unknown;
+    chain: Chain;
+    bundlerUrl: string;
+    paymasterUrl: string;
+    gasStrategy: 'self-funded' | 'erc20';
+}): Promise<unknown>;
+/**
+ * Create a ZeroDev Kernel smart account (ERC-7579).
+ *
+ * Gas strategy:
+ * - 'self-funded': Agent pays gas with native POL.
+ * - 'erc20': Agent pays gas in USDC via ZeroDev's ERC-20 paymaster.
+ * - 'auto' (default): Checks POL balance — uses self-funded if >= 0.01 POL,
+ *   otherwise falls back to ERC-20 paymaster.
+ *
+ * Requires peer dependencies:
+ * - @zerodev/sdk
+ * - @zerodev/ecdsa-validator
+ */
+export declare function createSmartAccount(config: SmartAccountConfig): Promise<SmartAccountResult>;
+//# sourceMappingURL=smart-account.d.ts.map

package/dist/wallet/smart-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-account.d.ts","sourceRoot":"","sources":["../../src/wallet/smart-account.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,KAAK,EACX,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAA;AAsCtF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,aAAa,GAAG,OAAO,CAAA;CACrC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAkE7B"}