mppx 0.6.17 → 0.6.18

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # mppx
 
+## 0.6.18
+
+### Patch Changes
+
+- d365b41: Added Tempo CLI auto-swap and payment source token options.
+- 9f660c2: Added Tempo CLI network shortcuts and challenge chain mismatch checks.
+- 538c7fb: Added CLI commands for browsing the MPP services registry.
+
 ## 0.6.17
 
 ### Patch Changes

package/dist/cli/cli.d.ts

@@ -10,6 +10,7 @@ declare const cli: Cli.Cli<{
             userAgent: string;
             verbose: number;
             account?: string | undefined;
+            autoSwap?: boolean | undefined;
             config?: string | undefined;
             data?: string | undefined;
             fail?: boolean | undefined;
@@ -20,7 +21,10 @@ declare const cli: Cli.Cli<{
             location?: boolean | undefined;
             method?: string | undefined;
             methodOpt?: string[] | undefined;
+            network?: "mainnet" | "testnet" | undefined;
+            payWith?: string | undefined;
             rpcUrl?: string | undefined;
+            slippage?: number | undefined;
         };
     };
 }, undefined, undefined>;

package/dist/cli/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAa,MAAM,OAAO,CAAA;AA6EtC,QAAA,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;wBAscP,CAAA;AA8uBF,eAAe,GAAG,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAa,MAAM,OAAO,CAAA;AAsLtC,QAAA,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAidP,CAAA;AA82BF,eAAe,GAAG,CAAA"}

package/dist/cli/cli.js

@@ -32,6 +32,21 @@ const discoveryIssueSchema = z.object({
     path: z.string(),
     severity: z.string(),
 });
+const serviceSummarySchema = z.object({
+    description: z.string().optional(),
+    id: z.string(),
+    name: z.string().optional(),
+    paidEndpoints: z.number(),
+    status: z.string().optional(),
+    url: z.string().optional(),
+});
+const serviceEndpointSchema = z.object({
+    description: z.string().optional(),
+    method: z.string(),
+    path: z.string(),
+    payment: z.unknown().optional(),
+});
+const servicesRegistryUrl = 'https://mpp.dev/api/services';
 function shouldReturnStructured(c) {
     return c.format === 'json' && c.formatExplicit;
 }
@@ -46,6 +61,77 @@ function canReadCommandStdin() {
         return false;
     return process.stdin.listenerCount('data') === 0 && process.stdin.listenerCount('readable') === 0;
 }
+function getString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function getEndpoints(service) {
+    return Array.isArray(service.endpoints)
+        ? service.endpoints.filter((endpoint) => typeof endpoint === 'object' && endpoint !== null)
+        : [];
+}
+function summarizeService(service) {
+    const endpoints = getEndpoints(service);
+    return {
+        ...(getString(service.description) ? { description: getString(service.description) } : {}),
+        id: getString(service.id) ?? getString(service.name) ?? 'unknown',
+        ...(getString(service.name) ? { name: getString(service.name) } : {}),
+        paidEndpoints: endpoints.filter((endpoint) => endpoint.payment).length,
+        ...(getString(service.status) ? { status: getString(service.status) } : {}),
+        ...(getString(service.serviceUrl) || getString(service.url)
+            ? { url: getString(service.serviceUrl) ?? getString(service.url) }
+            : {}),
+    };
+}
+function summarizeEndpoint(endpoint) {
+    return {
+        ...(getString(endpoint.description) ? { description: getString(endpoint.description) } : {}),
+        method: getString(endpoint.method) ?? 'GET',
+        path: getString(endpoint.path) ?? '/',
+        ...(endpoint.payment !== undefined ? { payment: endpoint.payment } : {}),
+    };
+}
+function formatPayment(payment) {
+    if (!payment)
+        return 'free';
+    if (typeof payment !== 'object')
+        return String(payment);
+    const p = payment;
+    const amount = getString(p.amount);
+    const currency = getString(p.currency);
+    const method = getString(p.method);
+    const intent = getString(p.intent);
+    return [amount, currency, method && intent ? `${method}/${intent}` : (method ?? intent)]
+        .filter(Boolean)
+        .join(' ');
+}
+async function fetchServicesRegistry() {
+    const url = process.env.MPPX_SERVICES_URL ?? servicesRegistryUrl;
+    const response = await globalThis.fetch(url);
+    if (!response.ok)
+        throw new Errors.IncurError({
+            code: 'SERVICES_FETCH_FAILED',
+            message: `Failed to fetch services registry: HTTP ${response.status}`,
+            exitCode: 1,
+        });
+    const json = (await response.json());
+    if (!json ||
+        typeof json !== 'object' ||
+        !Array.isArray(json.services))
+        throw new Errors.IncurError({
+            code: 'SERVICES_INVALID',
+            message: 'Services registry response did not contain a services array.',
+            exitCode: 1,
+        });
+    return json.services;
+}
+function findService(services, id) {
+    const needle = id.toLowerCase();
+    return services.find((service) => {
+        const serviceId = getString(service.id)?.toLowerCase();
+        const serviceName = getString(service.name)?.toLowerCase();
+        return serviceId === needle || serviceName === needle;
+    });
+}
 const cli = Cli.create('mppx', {
     version: packageJson.version,
     description: 'Make HTTP requests with automatic payment handling',
@@ -55,6 +141,7 @@ const cli = Cli.create('mppx', {
     }),
     options: z.object({
         account: z.string().optional().describe('Account name (env: MPPX_ACCOUNT)'),
+        autoSwap: z.boolean().optional().describe('Auto-swap source tokens into payment currency'),
         config: z.string().optional().describe('Path to config file'),
         confirm: z.boolean().optional().default(false).describe('Show confirmation prompts'),
         data: z.string().optional().describe('Send request body (implies POST unless -X is set)'),
@@ -75,11 +162,14 @@ const cli = Cli.create('mppx', {
             .array(z.string())
             .optional()
             .describe('Method-specific option (key=value, repeatable)'),
+        network: z.enum(['mainnet', 'testnet']).optional().describe('Tempo network'),
+        payWith: z.string().optional().describe('Source token for Tempo auto-swap'),
         rpcUrl: z
             .string()
             .optional()
             .describe('RPC endpoint, defaults to public RPC for chain (env: MPPX_RPC_URL)'),
         silent: z.boolean().default(false).describe('Silent mode (suppress progress and info)'),
+        slippage: z.number().optional().describe('Tempo auto-swap max slippage percentage'),
         userAgent: z
             .string()
             .optional()
@@ -232,7 +322,14 @@ const cli = Cli.create('mppx', {
             if (plugin) {
                 pluginResult = await plugin.setup({
                     challenge,
-                    options: { account: c.options.account, rpcUrl: c.options.rpcUrl },
+                    options: {
+                        account: c.options.account,
+                        autoSwap: c.options.autoSwap,
+                        network: c.options.network,
+                        payWith: c.options.payWith,
+                        rpcUrl: c.options.rpcUrl,
+                        slippage: c.options.slippage,
+                    },
                     methodOpts: parseMethodOpts(c.options.methodOpt),
                 });
                 tokenSymbol = pluginResult.tokenSymbol;
@@ -497,6 +594,7 @@ const account = Cli.create('account', {
     description: 'Create new account',
     options: z.object({
         account: z.string().optional().describe('Account name (env: MPPX_ACCOUNT)'),
+        network: z.enum(['mainnet', 'testnet']).optional().describe('Tempo network'),
         rpcUrl: z.string().optional().describe('RPC endpoint (env: MPPX_RPC_URL)'),
     }),
     output: z.object({ address: z.string(), name: z.string() }),
@@ -546,8 +644,8 @@ const account = Cli.create('account', {
         const addrDisplay = explorerUrl
             ? link(`${explorerUrl}/address/${acct.address}`, acct.address)
             : acct.address;
-        const rpcUrl = resolveRpcUrl(c.options.rpcUrl);
-        resolveChain({ rpcUrl })
+        const rpcUrl = resolveRpcUrl(c.options.rpcUrl, { network: c.options.network });
+        resolveChain({ network: c.options.network, rpcUrl })
             .then((chain) => createClient({ chain, transport: http(rpcUrl) }))
             .then((client) => import('viem/tempo').then(({ Actions }) => Actions.faucet.fund(client, { account: acct }).catch(() => { })));
         return outputResult(c, { address: acct.address, name: resolvedName }, () => {
@@ -659,6 +757,7 @@ const account = Cli.create('account', {
     description: 'Fund account with testnet tokens',
     options: z.object({
         account: z.string().optional().describe('Account name (env: MPPX_ACCOUNT)'),
+        network: z.enum(['mainnet', 'testnet']).optional().describe('Tempo network'),
         rpcUrl: z.string().optional().describe('RPC endpoint (env: MPPX_RPC_URL)'),
     }),
     output: z.object({ account: z.string(), chain: z.string(), transactions: z.array(z.string()) }),
@@ -679,8 +778,8 @@ const account = Cli.create('account', {
                 return c.error({ code: 'ACCOUNT_NOT_FOUND', message: 'No account found.', exitCode: 69 });
         }
         const acct = privateKeyToAccount(key);
-        const rpcUrl = resolveRpcUrl(c.options.rpcUrl);
-        const chain = await resolveChain({ rpcUrl });
+        const rpcUrl = resolveRpcUrl(c.options.rpcUrl, { network: c.options.network });
+        const chain = await resolveChain({ network: c.options.network, rpcUrl });
         const client = createClient({ chain, transport: http(rpcUrl) });
         if (!structured)
             console.log(`Funding "${accountName}" on ${chainName(chain)}`);
@@ -797,6 +896,7 @@ const account = Cli.create('account', {
     description: 'View account address',
     options: z.object({
         account: z.string().optional().describe('Account name (env: MPPX_ACCOUNT)'),
+        network: z.enum(['mainnet', 'testnet']).optional().describe('Tempo network'),
         rpcUrl: z.string().optional().describe('RPC endpoint (env: MPPX_RPC_URL)'),
     }),
     output: accountViewSchema,
@@ -813,8 +913,8 @@ const account = Cli.create('account', {
                 });
             }
             const address = tempoEntry.wallet_address;
-            const rpcUrl = resolveRpcUrl(c.options.rpcUrl);
-            const chain = await resolveChain({ rpcUrl });
+            const rpcUrl = resolveRpcUrl(c.options.rpcUrl, { network: c.options.network });
+            const chain = await resolveChain({ network: c.options.network, rpcUrl });
             const explorerUrl = chain.blockExplorers?.default?.url;
             const addrDisplay = explorerUrl
                 ? link(`${explorerUrl}/address/${address}`, address)
@@ -846,8 +946,8 @@ const account = Cli.create('account', {
                 return c.error({ code: 'ACCOUNT_NOT_FOUND', message: 'No account found.', exitCode: 69 });
         }
         const acct = privateKeyToAccount(key);
-        const rpcUrl = resolveRpcUrl(c.options.rpcUrl);
-        const chain = await resolveChain({ rpcUrl });
+        const rpcUrl = resolveRpcUrl(c.options.rpcUrl, { network: c.options.network });
+        const chain = await resolveChain({ network: c.options.network, rpcUrl });
         const explorerUrl = chain.blockExplorers?.default?.url;
         const addrDisplay = explorerUrl
             ? link(`${explorerUrl}/address/${acct.address}`, acct.address)
@@ -872,14 +972,18 @@ const sign = Cli.create('sign', {
         challenge: z.string().optional().describe('WWW-Authenticate challenge value'),
         config: z.string().optional().describe('Path to config file'),
         dryRun: z.boolean().optional().describe('Validate and parse the challenge without signing'),
+        autoSwap: z.boolean().optional().describe('Auto-swap source tokens into payment currency'),
         methodOpt: z
             .array(z.string())
             .optional()
             .describe('Method-specific option (key=value, repeatable)'),
+        network: z.enum(['mainnet', 'testnet']).optional().describe('Tempo network'),
+        payWith: z.string().optional().describe('Source token for Tempo auto-swap'),
         rpcUrl: z
             .string()
             .optional()
             .describe('RPC endpoint, defaults to public RPC for chain (env: MPPX_RPC_URL)'),
+        slippage: z.number().optional().describe('Tempo auto-swap max slippage percentage'),
     }),
     output: z.object({ authorization: z.string() }),
     alias: {
@@ -947,7 +1051,14 @@ const sign = Cli.create('sign', {
         if (plugin) {
             const result = await plugin.setup({
                 challenge,
-                options: { account: c.options.account, rpcUrl: c.options.rpcUrl },
+                options: {
+                    account: c.options.account,
+                    autoSwap: c.options.autoSwap,
+                    network: c.options.network,
+                    payWith: c.options.payWith,
+                    rpcUrl: c.options.rpcUrl,
+                    slippage: c.options.slippage,
+                },
                 methodOpts,
             });
             if (result.createCredential) {
@@ -1017,6 +1128,114 @@ export default defineConfig({
         });
     },
 });
+const services = Cli.create('services', {
+    description: 'Browse the MPP services registry',
+})
+    .command('list', {
+    description: 'List registered MPP services',
+    options: z.object({
+        query: z.string().optional().describe('Filter by id, name, category, tag, or description'),
+    }),
+    output: z.object({ services: z.array(serviceSummarySchema) }),
+    alias: { query: 'q' },
+    async run(c) {
+        const query = c.options.query?.toLowerCase();
+        const registry = await fetchServicesRegistry();
+        const filtered = query
+            ? registry.filter((service) => [
+                service.id,
+                service.name,
+                service.description,
+                ...(Array.isArray(service.categories) ? service.categories : []),
+                ...(Array.isArray(service.tags) ? service.tags : []),
+            ]
+                .filter((value) => typeof value === 'string')
+                .some((value) => value.toLowerCase().includes(query)))
+            : registry;
+        const summaries = filtered.map(summarizeService).sort((a, b) => a.id.localeCompare(b.id));
+        return outputResult(c, { services: summaries }, () => {
+            if (summaries.length === 0) {
+                console.log('No services found.');
+                return;
+            }
+            const idWidth = Math.max(...summaries.map((service) => service.id.length));
+            const paidWidth = Math.max(...summaries.map((service) => String(service.paidEndpoints).length));
+            for (const service of summaries) {
+                const name = service.name && service.name !== service.id ? `  ${service.name}` : '';
+                const url = service.url ? `  ${pc.dim(service.url)}` : '';
+                console.log(`${service.id.padEnd(idWidth)}  ${String(service.paidEndpoints).padStart(paidWidth)} paid${name}${url}`);
+            }
+        });
+    },
+})
+    .command('show', {
+    description: 'Show one registered MPP service',
+    args: z.object({
+        service: z.string().describe('Service id or name'),
+    }),
+    output: z.object({ service: z.record(z.string(), z.unknown()) }),
+    async run(c) {
+        const registry = await fetchServicesRegistry();
+        const service = findService(registry, c.args.service);
+        if (!service)
+            return c.error({
+                code: 'SERVICE_NOT_FOUND',
+                message: `Service not found: ${c.args.service}`,
+                exitCode: 1,
+            });
+        const summary = summarizeService(service);
+        const endpoints = getEndpoints(service);
+        return outputResult(c, { service }, () => {
+            console.log(`${summary.name ?? summary.id} ${pc.dim(`(${summary.id})`)}`);
+            if (summary.description)
+                console.log(summary.description);
+            if (summary.url)
+                console.log(`${pc.dim('URL')}       ${link(summary.url, summary.url)}`);
+            if (summary.status)
+                console.log(`${pc.dim('Status')}    ${summary.status}`);
+            console.log(`${pc.dim('Endpoints')} ${endpoints.length} (${summary.paidEndpoints} paid)`);
+            const docs = service.docs;
+            const homepage = docs && getString(docs.homepage);
+            if (homepage)
+                console.log(`${pc.dim('Docs')}      ${link(homepage, homepage)}`);
+        });
+    },
+})
+    .command('endpoints', {
+    description: 'List endpoints for a registered MPP service',
+    args: z.object({
+        service: z.string().describe('Service id or name'),
+    }),
+    output: z.object({
+        endpoints: z.array(serviceEndpointSchema),
+        service: serviceSummarySchema,
+    }),
+    async run(c) {
+        const registry = await fetchServicesRegistry();
+        const service = findService(registry, c.args.service);
+        if (!service)
+            return c.error({
+                code: 'SERVICE_NOT_FOUND',
+                message: `Service not found: ${c.args.service}`,
+                exitCode: 1,
+            });
+        const summary = summarizeService(service);
+        const endpoints = getEndpoints(service).map(summarizeEndpoint);
+        return outputResult(c, { endpoints, service: summary }, () => {
+            if (endpoints.length === 0) {
+                console.log(`No endpoints found for ${summary.id}.`);
+                return;
+            }
+            const methodWidth = Math.max(...endpoints.map((endpoint) => endpoint.method.length));
+            const pathWidth = Math.max(...endpoints.map((endpoint) => endpoint.path.length));
+            for (const endpoint of endpoints) {
+                const payment = formatPayment(endpoint.payment);
+                const description = endpoint.description ? `  ${pc.dim(endpoint.description)}` : '';
+                console.log(`${endpoint.method.padEnd(methodWidth)}  ${endpoint.path.padEnd(pathWidth)}  ${payment}${description}`);
+            }
+        });
+    },
+});
 const discover = Cli.create('discover', {
     description: 'Discovery tooling',
 })
@@ -1186,6 +1405,7 @@ const discover = Cli.create('discover', {
 cli.command(account);
 cli.command(discover);
 cli.command(init);
+cli.command(services);
 cli.command(sign);
 export default cli;
 //# sourceMappingURL=cli.js.map