@abbababa/sdk 0.1.0

package/dist/wallet/smart-account.js

@@ -0,0 +1,126 @@
+import { createPublicClient, http, } from 'viem';
+import { polygonAmoy, polygon, baseSepolia, base } from 'viem/chains';
+import { ZERODEV_BUNDLER_URL, ZERODEV_PAYMASTER_URL, USDC_ADDRESSES, MIN_GAS_BALANCE, } from './constants.js';
+const CHAINS = {
+    polygon,
+    polygonAmoy,
+    baseSepolia,
+    base,
+};
+/**
+ * Resolve the gas strategy for a kernel client.
+ *
+ * - 'self-funded': No paymaster — account pays gas with native POL.
+ * - 'erc20': ERC-20 paymaster — account pays gas in USDC.
+ * - 'auto': Check POL balance — use self-funded if sufficient, otherwise erc20.
+ */
+async function resolveGasStrategy(strategy, publicClient, accountAddress) {
+    if (strategy === 'self-funded' || strategy === 'erc20') {
+        return strategy;
+    }
+    // 'auto' — check native balance
+    const balance = await publicClient.getBalance({
+        address: accountAddress,
+    });
+    return balance >= MIN_GAS_BALANCE ? 'self-funded' : 'erc20';
+}
+/**
+ * Build a kernel account client with the appropriate gas strategy.
+ *
+ * Shared by createSmartAccount() and session-keys.ts to avoid duplicating
+ * paymaster configuration logic.
+ */
+export async function buildKernelClient(opts) {
+    const sdk = await import('@zerodev/sdk');
+    const { createKernelAccountClient, createZeroDevPaymasterClient } = sdk;
+    if (opts.gasStrategy === 'erc20') {
+        const usdcAddress = USDC_ADDRESSES[opts.chain.id];
+        if (!usdcAddress) {
+            throw new Error(`No USDC address configured for chain ${opts.chain.id}. Cannot use ERC-20 gas strategy.`);
+        }
+        const paymasterClient = createZeroDevPaymasterClient({
+            chain: opts.chain,
+            transport: http(opts.paymasterUrl),
+        });
+        return createKernelAccountClient({
+            account: opts.account,
+            chain: opts.chain,
+            bundlerTransport: http(opts.bundlerUrl),
+            paymaster: {
+                getPaymasterData: (userOperation) => paymasterClient.sponsorUserOperation({
+                    userOperation,
+                    gasToken: usdcAddress,
+                }),
+            },
+        });
+    }
+    // self-funded — no paymaster
+    return createKernelAccountClient({
+        account: opts.account,
+        chain: opts.chain,
+        bundlerTransport: http(opts.bundlerUrl),
+    });
+}
+/**
+ * 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 async function createSmartAccount(config) {
+    // Dynamic imports — these are optional peer dependencies
+    const sdk = await import('@zerodev/sdk');
+    const { signerToEcdsaValidator } = await import('@zerodev/ecdsa-validator');
+    const { privateKeyToAccount } = await import('viem/accounts');
+    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 for chain reads
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    // 2. Create the EOA signer from private key
+    const signer = privateKeyToAccount(config.privateKey);
+    // 3. Create ECDSA validator module
+    const ecdsaValidator = await signerToEcdsaValidator(publicClient, {
+        signer,
+        entryPoint,
+        kernelVersion,
+    });
+    // 4. Create the Kernel smart account (ERC-7579 modular)
+    const kernelAccount = await createKernelAccount(publicClient, {
+        plugins: { sudo: ecdsaValidator },
+        entryPoint,
+        kernelVersion,
+    });
+    // 5. Resolve gas strategy
+    const gasStrategy = await resolveGasStrategy(config.gasStrategy ?? 'auto', publicClient, kernelAccount.address);
+    // 6. Create the account client with resolved strategy
+    const kernelClient = await buildKernelClient({
+        account: kernelAccount,
+        chain,
+        bundlerUrl,
+        paymasterUrl,
+        gasStrategy,
+    });
+    return {
+        address: kernelAccount.address,
+        kernelClient,
+        gasStrategy,
+    };
+}
+//# sourceMappingURL=smart-account.js.map

package/dist/wallet/smart-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-account.js","sourceRoot":"","sources":["../../src/wallet/smart-account.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,IAAI,GAGL,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAErE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,MAAM,GAA0B;IACpC,OAAO;IACP,WAAW;IACX,WAAW;IACX,IAAI;CACL,CAAA;AAED;;;;;;GAMG;AACH,KAAK,UAAU,kBAAkB,CAC/B,QAAqB,EACrB,YAAmD,EACnD,cAAsB;IAEtB,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACvD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,gCAAgC;IAChC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC;QAC5C,OAAO,EAAE,cAAyB;KACnC,CAAC,CAAA;IACF,OAAO,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAA;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAMvC;IACC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IACxC,MAAM,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,GAAG,GAAG,CAAA;IAEvE,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,KAAK,CAAC,EAAE,mCAAmC,CACzF,CAAA;QACH,CAAC;QAED,MAAM,eAAe,GAAG,4BAA4B,CAAC;YACnD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;SACnC,CAAC,CAAA;QAEF,OAAO,yBAAyB,CAAC;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAc;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YACvC,SAAS,EAAE;gBACT,gBAAgB,EAAE,CAAC,aAAkB,EAAE,EAAE,CACvC,eAAe,CAAC,oBAAoB,CAAC;oBACnC,aAAa;oBACb,QAAQ,EAAE,WAA4B;iBACvC,CAAC;aACL;SACF,CAAC,CAAA;IACJ,CAAC;IAED,6BAA6B;IAC7B,OAAO,yBAAyB,CAAC;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAc;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;KACxC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA0B;IAE1B,yDAAyD;IACzD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IACxC,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAA;IAC3E,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;IAE7D,MAAM,EACJ,mBAAmB,EACnB,SAAS,GACV,GAAG,GAAG,CAAA;IAEP,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,CAAA;IAE3C,MAAM,UAAU,GAAG,GAAG,mBAAmB,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAA;IACtE,MAAM,YAAY,GAAG,GAAG,qBAAqB,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAA;IAE1E,mCAAmC;IACnC,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,KAAK;QACL,SAAS,EAAE,IAAI,EAAE;KAClB,CAAC,CAAA;IAEF,4CAA4C;IAC5C,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAA2B,CAAC,CAAA;IAEtE,mCAAmC;IACnC,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,YAAY,EAAE;QAChE,MAAM;QACN,UAAU;QACV,aAAa;KACd,CAAC,CAAA;IAEF,wDAAwD;IACxD,MAAM,aAAa,GAAG,MAAM,mBAAmB,CAAC,YAAY,EAAE;QAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;QACjC,UAAU;QACV,aAAa;KACd,CAAC,CAAA;IAEF,0BAA0B;IAC1B,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAC1C,MAAM,CAAC,WAAW,IAAI,MAAM,EAC5B,YAAY,EACZ,aAAa,CAAC,OAAiB,CAChC,CAAA;IAED,sDAAsD;IACtD,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC;QAC3C,OAAO,EAAE,aAAa;QACtB,KAAK;QACL,UAAU;QACV,YAAY;QACZ,WAAW;KACZ,CAAC,CAAA;IAEF,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,OAAiB;QACxC,YAAY;QACZ,WAAW;KACZ,CAAA;AACH,CAAC"}

package/dist/webhook.d.ts

@@ -0,0 +1,15 @@
+import type { WebhookHandler } from './types.js';
+export declare class WebhookServer {
+    private server;
+    private handler;
+    private path;
+    constructor(handler: WebhookHandler, options?: {
+        path?: string;
+    });
+    start(port: number): Promise<{
+        url: string;
+        port: number;
+    }>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,YAAY,CAAA;AAE9D,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,IAAI,CAAQ;gBAER,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAK1D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA0C3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY5B"}

package/dist/webhook.js

@@ -0,0 +1,62 @@
+import * as http from 'node:http';
+export class WebhookServer {
+    server = null;
+    handler;
+    path;
+    constructor(handler, options) {
+        this.handler = handler;
+        this.path = options?.path ?? '/webhook';
+    }
+    async start(port) {
+        return new Promise((resolve, reject) => {
+            this.server = http.createServer(async (req, res) => {
+                if (req.method !== 'POST' || req.url !== this.path) {
+                    res.writeHead(404);
+                    res.end('Not found');
+                    return;
+                }
+                const chunks = [];
+                for await (const chunk of req) {
+                    chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+                }
+                const body = Buffer.concat(chunks).toString('utf-8');
+                let event;
+                try {
+                    event = JSON.parse(body);
+                }
+                catch {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Invalid JSON' }));
+                    return;
+                }
+                try {
+                    await this.handler(event);
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ received: true }));
+                }
+                catch (err) {
+                    console.error('[WebhookServer] Handler error:', err);
+                    res.writeHead(500, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Handler failed' }));
+                }
+            });
+            this.server.on('error', reject);
+            this.server.listen(port, () => {
+                resolve({ url: `http://localhost:${port}${this.path}`, port });
+            });
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(() => {
+                this.server = null;
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@abbababa/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Abbababa A2A Settlement Platform",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./wallet": {
+      "import": "./dist/wallet/index.js",
+      "types": "./dist/wallet/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "viem": "^2.45.0"
+  },
+  "peerDependencies": {
+    "@zerodev/ecdsa-validator": "^5.4.9",
+    "@zerodev/permissions": "^5.6.0",
+    "@zerodev/sdk": "^5.5.7",
+    "permissionless": "^0.3.4"
+  },
+  "peerDependenciesMeta": {
+    "@zerodev/sdk": {
+      "optional": true
+    },
+    "@zerodev/ecdsa-validator": {
+      "optional": true
+    },
+    "@zerodev/permissions": {
+      "optional": true
+    },
+    "permissionless": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abbababa/abbababa-platform",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://abbababa.com/docs/sdk",
+  "keywords": [
+    "a2a",
+    "agent",
+    "commerce",
+    "escrow",
+    "polygon",
+    "usdc",
+    "settlement",
+    "mcp"
+  ],
+  "devDependencies": {
+    "@zerodev/ecdsa-validator": "^5.4.9",
+    "@zerodev/permissions": "^5.6.0",
+    "@zerodev/sdk": "^5.5.7",
+    "permissionless": "^0.3.4"
+  }
+}