@4mica/sdk 1.2.10 → 1.2.11

package/dist/package.json

@@ -0,0 +1,80 @@
+{
+    "name": "@4mica/sdk",
+    "version": "1.2.11",
+    "description": "TypeScript SDK for interacting with the 4Mica payment network",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/4mica-Network/ts-sdk-4mica.git"
+    },
+    "homepage": "https://github.com/4mica-Network/ts-sdk-4mica#readme",
+    "bugs": {
+        "url": "https://github.com/4mica-Network/ts-sdk-4mica/issues"
+    },
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "sideEffects": false,
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "keywords": [
+        "4mica",
+        "payments",
+        "payment-network",
+        "blockchain",
+        "sdk",
+        "typescript",
+        "ethers"
+    ],
+    "scripts": {
+        "clean": "node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true })\"",
+        "build": "npm run clean && tsc -p tsconfig.build.json",
+        "test": "vitest run",
+        "test:e2e": "vitest run --config vitest.e2e.config.ts",
+        "example:base-sepolia:x402-v2": "node_modules/.bin/tsx examples/base-sepolia-x402-facilitator-e2e.ts",
+        "example:manual:agents": "node_modules/.bin/tsx examples/manual-agents/demo.ts",
+        "example:wachai:v2": "node_modules/.bin/tsx examples/wachai-v2-demo/demo.ts",
+        "example:deposit": "node_modules/.bin/tsx examples/deposit.ts",
+        "example:yield": "node_modules/.bin/tsx examples/yield.ts",
+        "lint": "eslint . --ext .ts",
+        "fmt": "prettier --check \"{src,tests}/**/*.{ts,js,json}\""
+    },
+    "dependencies": {
+        "@noble/curves": "^2.2.0",
+        "@quillai-network/wachai-validation-sdk": "^0.1.0",
+        "viem": "^2.45.1"
+    },
+    "optionalDependencies": {
+        "@coinbase/cdp-sdk": "^1.49.2"
+    },
+    "devDependencies": {
+        "@4mica/x402": "^1.2.5",
+        "@coinbase/cdp-sdk": "^1.49.2",
+        "@eslint/js": "^9.39.2",
+        "@types/node": "^25.2.0",
+        "@typescript-eslint/eslint-plugin": "^8.54.0",
+        "@typescript-eslint/parser": "^8.54.0",
+        "dotenv-cli": "^11.0.0",
+        "eslint": "^9.39.2",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-react": "^7.37.5",
+        "globals": "^17.3.0",
+        "prettier": "^3.8.1",
+        "tsx": "^4.21.0",
+        "typescript": "^5.3.3",
+        "typescript-eslint": "^8.54.0",
+        "vitest": "^4.0.17"
+    }
+}

package/dist/{index.d.ts → src/index.d.ts}

@@ -14,3 +14,4 @@ export * from './guarantee';
 export * from './bls';
 export * from './x402/index';
 export * from './client';
+export * from './wallet';

package/dist/{index.js → src/index.js}

@@ -30,3 +30,4 @@ __exportStar(require("./guarantee"), exports);
 __exportStar(require("./bls"), exports);
 __exportStar(require("./x402/index"), exports);
 __exportStar(require("./client"), exports);
+__exportStar(require("./wallet"), exports);

package/dist/{rpc.js → src/rpc.js}

@@ -5,6 +5,8 @@ const constants_1 = require("./constants");
 const models_1 = require("./models");
 const errors_1 = require("./errors");
 const http_1 = require("./http");
+const package_json_1 = require("../package.json");
+const SDK_CLIENT_HEADER_VALUE = `ts-sdk-4mica/${package_json_1.version}`;
 function serializeTabId(tabId) {
     return `0x${BigInt(tabId).toString(16)}`;
 }
@@ -31,7 +33,7 @@ class RpcProxy {
         return this;
     }
     async headers() {
-        const headers = {};
+        const headers = { 'x-4mica-sdk': SDK_CLIENT_HEADER_VALUE };
         if (this.adminApiKey) {
             headers[constants_1.ADMIN_API_KEY_HEADER] = this.adminApiKey;
         }

package/dist/src/wallet/cdp.d.ts

@@ -0,0 +1,11 @@
+import { type Account } from 'viem';
+export interface CdpAccountConfig {
+    /** CDP API key ID from the Coinbase Developer Platform dashboard. */
+    apiKeyId: string;
+    /** CDP API key secret from the Coinbase Developer Platform dashboard. */
+    apiKeySecret: string;
+    /** Idempotency name — getOrCreateAccount always returns the same wallet for a given name. */
+    name: string;
+}
+/** Creates a viem Account backed by a Coinbase CDP MPC wallet (private key never leaves CDP). */
+export declare function createCdpAccount(config: CdpAccountConfig): Promise<Account>;

package/dist/src/wallet/cdp.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCdpAccount = createCdpAccount;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+/** Creates a viem Account backed by a Coinbase CDP MPC wallet (private key never leaves CDP). */
+async function createCdpAccount(config) {
+    const { CdpClient } = await Promise.resolve().then(() => __importStar(require('@coinbase/cdp-sdk')));
+    const cdp = new CdpClient({
+        apiKeyId: config.apiKeyId,
+        apiKeySecret: config.apiKeySecret,
+    });
+    const evmAccount = await cdp.evm.getOrCreateAccount({ name: config.name });
+    const address = evmAccount.address;
+    async function signMessage({ message }) {
+        if (typeof message === 'string') {
+            // CDP's signMessage applies the EIP-191 prefix internally.
+            const result = await cdp.evm.signMessage({ address, message });
+            return result.signature;
+        }
+        const hash = (0, viem_1.hashMessage)(message);
+        const result = await cdp.evm.signHash({ address, hash });
+        return result.signature;
+    }
+    async function signTypedData(parameters) {
+        const { domain, types, primaryType, message } = parameters;
+        if (domain && types && primaryType && message) {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const payload = { address, domain, types, primaryType, message };
+                const result = await cdp.evm.signTypedData(payload);
+                return result.signature;
+            }
+            catch {
+                // Fall back to hash-then-sign if CDP rejects the typed-data structure.
+            }
+        }
+        const hash = (0, viem_1.hashTypedData)(parameters);
+        const result = await cdp.evm.signHash({ address, hash });
+        return result.signature;
+    }
+    async function signTransaction(transaction, options) {
+        const serializer = options?.serializer ?? viem_1.serializeTransaction;
+        const hash = (0, viem_1.keccak256)(serializer(transaction));
+        const result = await cdp.evm.signHash({ address, hash });
+        const { r, s, yParity } = (0, viem_1.hexToSignature)(result.signature);
+        return serializer(transaction, { r, s, yParity });
+    }
+    // viem's signTypedData generic cannot be satisfied by a hand-rolled adapter without casting — same pattern as hdKeyToAccount.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return (0, accounts_1.toAccount)({ address, signMessage, signTypedData, signTransaction });
+}

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

@@ -0,0 +1,2 @@
+export { createCdpAccount } from './cdp';
+export type { CdpAccountConfig } from './cdp';

package/dist/src/wallet/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCdpAccount = void 0;
+var cdp_1 = require("./cdp");
+Object.defineProperty(exports, "createCdpAccount", { enumerable: true, get: function () { return cdp_1.createCdpAccount; } });

package/dist/{x402 → src/x402}/index.js

@@ -106,8 +106,9 @@ class X402Flow {
      */
     async signPaymentV2(paymentRequired, accepted, userAddress) {
         X402Flow.validateScheme(accepted.scheme);
-        const tab = await this.requestTab(2, accepted, userAddress, paymentRequired.resource);
-        const claims = hasValidationPolicy(accepted.extra)
+        const isV2Claims = hasValidationPolicy(accepted.extra);
+        const tab = await this.requestTab(isV2Claims ? 2 : 1, accepted, userAddress, paymentRequired.resource);
+        const claims = isV2Claims
             ? this.buildClaimsV2(accepted, tab, userAddress)
             : this.buildClaims(accepted, tab, userAddress);
         const signature = await this.signer.signPayment(claims, models_1.SigningScheme.EIP712);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mica/sdk",
-  "version": "1.2.10",
+  "version": "1.2.11",
   "description": "TypeScript SDK for interacting with the 4Mica payment network",
   "license": "MIT",
   "repository": {