@lucid-agents/opencode-x402-plugin 0.1.0

package/dist/utils.js

@@ -0,0 +1,227 @@
+/**
+ * Utility functions for x402 auth plugin
+ * Exported separately for testing
+ */
+import { createWalletClient, http, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base, baseSepolia, mainnet } from "viem/chains";
+// ============================================================================
+// Constants
+// ============================================================================
+/** USDC contract addresses by network */
+export const USDC_ADDRESSES = {
+    "eip155:8453": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base Mainnet
+    "eip155:84532": "0x036CbD53842c5426634e7929541eC2318f3dCF7e", // Base Sepolia
+    "eip155:1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // Ethereum Mainnet
+};
+/** Chain configs by CAIP-2 identifier */
+export const CHAINS = {
+    "eip155:8453": base,
+    "eip155:84532": baseSepolia,
+    "eip155:1": mainnet,
+};
+/** Default permit cap in token units ($0.10 USDC = 100,000 with 6 decimals) */
+export const DEFAULT_PERMIT_CAP = "100000";
+/** Default permit validity (1 hour) */
+export const DEFAULT_VALIDITY_SECONDS = 3600;
+// ============================================================================
+// EIP-712 Signing
+// ============================================================================
+/**
+ * EIP-712 domain for ERC-2612 Permit
+ */
+export function getPermitDomain(tokenName, tokenVersion, chainId, verifyingContract) {
+    return {
+        name: tokenName,
+        version: tokenVersion,
+        chainId,
+        verifyingContract,
+    };
+}
+/**
+ * EIP-712 types for ERC-2612 Permit
+ */
+export const PERMIT_TYPES = {
+    Permit: [
+        { name: "owner", type: "address" },
+        { name: "spender", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" },
+    ],
+};
+/**
+ * Generate a random nonce for the permit
+ */
+export function generateNonce() {
+    const randomBytes = new Uint8Array(32);
+    crypto.getRandomValues(randomBytes);
+    // Use first 8 bytes as a numeric nonce (sufficient uniqueness)
+    const view = new DataView(randomBytes.buffer);
+    return view.getBigUint64(0, false).toString();
+}
+/**
+ * Sign an ERC-2612 permit using the wallet
+ */
+export async function signPermit(wallet, account, config, permitCap) {
+    const chainId = parseInt(config.network.split(":")[1]);
+    const deadline = Math.floor(Date.now() / 1000) + DEFAULT_VALIDITY_SECONDS;
+    const nonce = generateNonce();
+    const domain = getPermitDomain(config.tokenName, config.tokenVersion, chainId, config.asset);
+    const message = {
+        owner: account.address,
+        spender: config.facilitatorSigner,
+        value: BigInt(permitCap),
+        nonce: BigInt(nonce),
+        deadline: BigInt(deadline),
+    };
+    const signature = await wallet.signTypedData({
+        account,
+        domain,
+        types: PERMIT_TYPES,
+        primaryType: "Permit",
+        message,
+    });
+    return {
+        signature,
+        nonce,
+        deadline: deadline.toString(),
+    };
+}
+/**
+ * Create a complete x402 payment payload
+ */
+export async function createPaymentPayload(wallet, account, config, permitCap) {
+    const { signature, nonce, deadline } = await signPermit(wallet, account, config, permitCap);
+    const payload = {
+        x402Version: 2,
+        accepted: {
+            scheme: "upto",
+            network: config.network,
+            asset: config.asset,
+            payTo: config.payTo,
+            extra: {
+                name: config.tokenName,
+                version: config.tokenVersion,
+            },
+        },
+        payload: {
+            authorization: {
+                from: account.address,
+                to: config.facilitatorSigner,
+                value: permitCap,
+                validBefore: deadline,
+                nonce,
+            },
+            signature,
+        },
+    };
+    // Base64 encode for the header
+    return btoa(JSON.stringify(payload));
+}
+/**
+ * Decode a payment payload from base64
+ */
+export function decodePaymentPayload(encoded) {
+    return JSON.parse(atob(encoded));
+}
+// ============================================================================
+// Router Configuration
+// ============================================================================
+/** Cached router config */
+let cachedRouterConfig = null;
+let cachedRouterUrl = null;
+/**
+ * Clear the router config cache (for testing)
+ */
+export function clearRouterConfigCache() {
+    cachedRouterConfig = null;
+    cachedRouterUrl = null;
+}
+/**
+ * Parse router config response into RouterConfig
+ */
+export function parseRouterConfigResponse(data) {
+    const network = data.networks?.[0];
+    const eip712 = data.eip712_config;
+    return {
+        network: network?.network_id || "eip155:8453",
+        asset: network?.asset?.address || USDC_ADDRESSES["eip155:8453"],
+        payTo: network?.pay_to || "",
+        facilitatorSigner: network?.pay_to || "",
+        tokenName: eip712?.domain_name || "USD Coin",
+        tokenVersion: eip712?.domain_version || "2",
+    };
+}
+/**
+ * Fetch router configuration from /v1/config endpoint
+ */
+export async function fetchRouterConfig(routerUrl) {
+    // Return cached config if URL hasn't changed
+    if (cachedRouterConfig && cachedRouterUrl === routerUrl) {
+        return cachedRouterConfig;
+    }
+    const response = await fetch(`${routerUrl}/v1/config`);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch router config: ${response.status}`);
+    }
+    const data = (await response.json());
+    const config = parseRouterConfigResponse(data);
+    cachedRouterConfig = config;
+    cachedRouterUrl = routerUrl;
+    return config;
+}
+/**
+ * Get default router config for a network (fallback)
+ */
+export function getDefaultConfig(network) {
+    return {
+        network,
+        asset: USDC_ADDRESSES[network] || USDC_ADDRESSES["eip155:8453"],
+        payTo: "",
+        facilitatorSigner: "",
+        tokenName: "USD Coin",
+        tokenVersion: "2",
+    };
+}
+// ============================================================================
+// Wallet Utilities
+// ============================================================================
+/**
+ * Validate a private key format
+ */
+export function isValidPrivateKey(privateKey) {
+    if (!privateKey.startsWith("0x"))
+        return false;
+    if (privateKey.length !== 66)
+        return false;
+    // Check if it's valid hex
+    const hexPart = privateKey.slice(2);
+    return /^[0-9a-fA-F]+$/.test(hexPart);
+}
+/**
+ * Create a wallet client from a private key
+ */
+export function createWalletFromPrivateKey(privateKey, network = "eip155:8453") {
+    const account = privateKeyToAccount(privateKey);
+    const chain = CHAINS[network] || base;
+    const wallet = createWalletClient({
+        account,
+        chain,
+        transport: http(),
+    });
+    return { wallet, account };
+}
+/**
+ * Convert USDC amount to token units (6 decimals)
+ */
+export function usdcToUnits(amount) {
+    return Math.floor(amount * 1_000_000).toString();
+}
+/**
+ * Convert token units to USDC amount
+ */
+export function unitsToUsdc(units) {
+    return parseInt(units) / 1_000_000;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@lucid-agents/opencode-x402-plugin",
+  "version": "0.1.0",
+  "description": "OpenCode auth plugin for x402 payment protocol - sign permits with your wallet",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "x402",
+    "auth",
+    "plugin",
+    "wallet",
+    "crypto",
+    "permit",
+    "eip-712",
+    "erc-2612"
+  ],
+  "author": "Daydreams AI",
+  "license": "MIT",
+  "dependencies": {
+    "viem": "^2.44.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "msw": "2",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "*"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/daydreamsai/router.git",
+    "directory": "packages/opencode-x402-auth"
+  },
+  "bugs": {
+    "url": "https://github.com/daydreamsai/router/issues"
+  },
+  "homepage": "https://github.com/daydreamsai/router/tree/master/packages/opencode-x402-auth",
+  "publishConfig": {
+    "access": "public"
+  }
+}