@stellar-agent-services/provider-kit 0.0.0-stage → 0.1.0

package/dist/cli/target.js.map

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

package/dist/cli/trustline.d.ts

@@ -0,0 +1,3 @@
+import { type CliFlags, type OwnerIo } from "./shared.js";
+export declare function trustline(flags: CliFlags, io?: OwnerIo): Promise<number>;
+//# sourceMappingURL=trustline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trustline.d.ts","sourceRoot":"","sources":["../../src/cli/trustline.ts"],"names":[],"mappings":"AAaA,OAAO,EAA4C,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGpG,wBAAsB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAE,OAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgE9F"}

package/dist/cli/trustline.js

@@ -0,0 +1,114 @@
+// provider-kit trustline: lets the payout account (payTo) receive USDC [P2], approved in the wallet that
+// holds it, on a local approval page (cli/approval.ts). Clients pay in USDC, and a G... account can't
+// receive it without a trustline.
+//
+// With --config or --manifest it sets up that provider's payTo. On its own it sets up whichever account the
+// wallet connects, on --network (testnet by default), and prints it as PAY_TO. A new testnet account gets
+// test XLM from Friendbot first. Nothing is signed when the trustline is already there, and a contract
+// (C...) payTo needs none. With --source, a key in the Stellar CLI keychain signs instead, for scripts and CI.
+import { stellarAddressKind, USDC_ISSUER } from "@stellar-agent-services/protocol";
+import { ApprovalError, describeOutcome } from "./approval.js";
+import { explorerUrl, networkName, shortAddress } from "./owner-chain.js";
+import { accountSteps } from "./owner-steps.js";
+import { ownerIo, parseNetwork, quote, UsageError } from "./shared.js";
+import { loadTarget } from "./target.js";
+export async function trustline(flags, io = ownerIo(flags)) {
+    let network;
+    let payTo;
+    if (flags.config !== undefined || flags.manifest !== undefined) {
+        if (flags.network !== undefined)
+            throw new UsageError("--network comes from the provider's manifest: leave it out with --config or --manifest");
+        const target = await loadTarget(flags);
+        if ("problems" in target) {
+            console.error(`The provider would not pass Provider Standard v1 checks:\n${target.problems.map((problem) => `  ✗ ${problem}`).join("\n")}`);
+            return 1;
+        }
+        ({ network, payTo } = target.manifest.payment.accepts[0]);
+    }
+    else {
+        network = parseNetwork(flags.network ?? "testnet");
+    }
+    if (payTo !== undefined && stellarAddressKind(payTo) === "contract") {
+        console.log(`payTo ${payTo} is a contract: it holds USDC without a trustline. Nothing to sign.`);
+        return 0;
+    }
+    const chain = io.chain(network, flags.rpc);
+    if (payTo !== undefined && (await chain.account(payTo)).usdcTrustline) {
+        console.log(`✓ ${payTo} already has a USDC trustline on ${network}. Nothing to sign.`);
+        return 0;
+    }
+    if (flags.source !== undefined)
+        return withStellarCli(flags, io, chain, flags.source, payTo);
+    if (flags["dry-run"]) {
+        console.log(`Dry run. Without --dry-run, a page opens where your wallet adds a USDC trustline on ${network}. Nothing was signed.`);
+        return 0;
+    }
+    let account = payTo ?? "";
+    let added = false;
+    const plan = {
+        command: "provider-kit trustline",
+        title: "Get ready to receive USDC",
+        intro: "Clients pay your service in USDC. The account they pay needs a USDC trustline to receive it.",
+        network,
+        ...(payTo === undefined ? {} : { account: { address: payTo, label: "Payout account", reason: "The account the provider's manifest names as payTo: clients pay it." } }),
+        outline: [{ id: "trustline", title: "Add USDC" }],
+        async steps(address) {
+            if (payTo !== undefined && address !== payTo) {
+                throw new ApprovalError("Connect your payout account", `Your wallet connected ${shortAddress(address)}. Switch it to ${shortAddress(payTo)}, the manifest's payTo.`, "connect");
+            }
+            account = address;
+            const steps = await accountSteps(chain, address, { trustline: true });
+            added = steps.some((step) => step.id === "trustline");
+            return steps;
+        },
+        result: () => ({
+            title: "Ready to receive USDC",
+            message: added
+                ? `This account can now be paid in USDC on ${networkName(network)}.`
+                : `This account already had a USDC trustline on ${networkName(network)}, so nothing was signed.`,
+            details: [{ label: "Account", value: account, mono: true, href: explorerUrl(network, "account", account) }],
+        }),
+    };
+    const outcome = await io.approve(plan, chain);
+    if (outcome.status !== "done") {
+        console.log(describeOutcome(outcome));
+        return 1;
+    }
+    console.log(added ? `${account} can now receive USDC on ${network}.` : `${account} already had a USDC trustline on ${network}.`);
+    if (payTo === undefined)
+        console.log(`Use it as your payout address: PAY_TO=${account}`);
+    return 0;
+}
+/** --source: the Stellar CLI signs change_trust with a key from its keychain. */
+async function withStellarCli(flags, io, chain, source, payTo) {
+    const { network } = chain;
+    const cliNetwork = network === "stellar:pubnet" ? "mainnet" : "testnet";
+    const args = ["tx", "new", "change-trust", "--source-account", source, "--network", cliNetwork, "--line", `USDC:${USDC_ISSUER[network]}`];
+    const stellar = await io.stellar();
+    if (flags["dry-run"] || stellar === undefined) {
+        console.log(stellar === undefined ? "The Stellar CLI (`stellar`) is not installed: https://developers.stellar.org/docs/tools/cli. Run this once it is:" : "Dry run. This would run:");
+        console.log(`  stellar ${args.map(quote).join(" ")}`);
+        return stellar === undefined ? 1 : 0;
+    }
+    const address = (await stellar(["keys", "address", source])).trim();
+    if (payTo !== undefined && address !== payTo) {
+        console.error(`Key "${source}" is ${address}, not the manifest's payTo ${payTo}. Nothing was signed.`);
+        return 1;
+    }
+    const state = await chain.account(address);
+    if (state.usdcTrustline) {
+        console.log(`✓ ${address} already has a USDC trustline on ${network}. Nothing to sign.`);
+        return 0;
+    }
+    if (!state.exists) {
+        console.error(`${address} doesn't exist on ${network} yet: ${network === "stellar:testnet" ? `stellar keys fund ${source} --network testnet` : "send it some XLM"} first.`);
+        return 1;
+    }
+    console.log(`Signing with "${source}" (${address}) on ${cliNetwork}...`);
+    await stellar(args);
+    console.log(`${address} can now receive USDC on ${network}.`);
+    if (payTo === undefined)
+        console.log(`Use it as your payout address: PAY_TO=${address}`);
+    return 0;
+}
+//# sourceMappingURL=trustline.js.map

package/dist/cli/trustline.js.map

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

package/dist/cli/try.d.ts

@@ -0,0 +1,54 @@
+import { type PaymentClientOptions } from "@stellar-agent-services/payment-client";
+import { type JsonObject, type StellarNetwork } from "@stellar-agent-services/protocol";
+import { Keypair } from "@stellar/stellar-sdk";
+import { type OwnerChain } from "./owner-chain.js";
+import { type CliFlags } from "./shared.js";
+/** Where `try` reaches the outside world. Tests replace it. */
+export interface TryIo {
+    /** Prints a line. */
+    log(line: string): void;
+    /** Shows the step under way until the next line replaces it. Terminals only. "" clears it. */
+    status(text: string): void;
+    /** Whether someone is there to answer a question. */
+    interactive: boolean;
+    /** Asks yes or no. Enter means yes. */
+    confirm(question: string): Promise<boolean>;
+    chain(network: StellarNetwork, rpcUrl?: string): OwnerChain;
+    /** The throwaway payer's key: a new one each time. */
+    payer(): Keypair;
+    /** How the payment client reaches providers and pays: fetch and x402 `exact` unless a test says otherwise. */
+    client: Pick<PaymentClientOptions, "fetch" | "methods" | "pollMs">;
+    /**
+     * Starts the provider for this call when nothing answers at `manifestUrl`: a gateway config in this process, or a
+     * command. Without it, try only says to start the provider.
+     */
+    startProvider?(how: {
+        config: string;
+    } | {
+        command: string;
+    }, manifestUrl: string): Promise<{
+        stop(): Promise<void>;
+    }>;
+}
+/** What `try --json` prints: how the call went. */
+export interface TrySummary {
+    ok: boolean;
+    manifest: string;
+    service?: string;
+    jobId?: string;
+    status?: string;
+    charged?: boolean;
+    payment?: {
+        amount: string;
+        payTo: string;
+        transaction: string;
+        url: string;
+        confirmed: boolean;
+    };
+    output?: JsonObject;
+    error?: string;
+}
+export declare function tryIo(): TryIo;
+/** provider-kit try [<service>] ['<input JSON>' | @<file>] */
+export declare function tryCall(flags: CliFlags, args: string[], io?: TryIo): Promise<number>;
+//# sourceMappingURL=try.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"try.d.ts","sourceRoot":"","sources":["../../src/cli/try.ts"],"names":[],"mappings":"AAsBA,OAAO,EAaL,KAAK,oBAAoB,EAG1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAyB,KAAK,UAAU,EAAiD,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC9J,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAI/C,OAAO,EAAoF,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGrI,OAAO,EAA0D,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIpG,+DAA+D;AAC/D,MAAM,WAAW,KAAK;IACpB,qBAAqB;IACrB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8FAA8F;IAC9F,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5D,sDAAsD;IACtD,KAAK,IAAI,OAAO,CAAC;IACjB,8GAA8G;IAC9G,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IACnE;;;OAGG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CACxH;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAClG,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,KAAK,IAAI,KAAK,CAwC7B;AAsBD,8DAA8D;AAC9D,wBAAsB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBnG"}

package/dist/cli/try.js

@@ -0,0 +1,448 @@
+// provider-kit try: one paid call to a service on testnet, made the way any client makes it, from a throwaway payer
+// (docs/provider-setup-guide.md §6). It shows the whole flow working before anyone else pays.
+//
+//   1. The provider: --manifest, or the baseUrl of --config. Without either, ./provider.config.json when it exists,
+//      else a provider on this computer's default port (http://localhost:8787).
+//   2. The quote: an unpaid create-job and its 402 challenge, checked against the manifest [P7]. Nothing is signed.
+//   3. Approval: the exact price, payee, asset and network, shown before anything is paid. --yes skips the question,
+//      as in scripts.
+//   4. The payer: a new key, held in memory only, funded with test XLM by Friendbot and with the job's price in test
+//      USDC, bought on the testnet DEX. It is never written anywhere and is gone when the command ends.
+//   5. The payment client pays once, follows the job and confirms the transfer on chain [J16]. Its spending policy
+//      allows this one payment only: the manifest's price, to the manifest's payTo.
+//
+// Testnet only: a provider on Mainnet is refused before anything is signed.
+//
+// When nothing answers, try starts the provider for this one call: a gateway config in this process (with a throwaway
+// payTo when PAY_TO is empty, as `provider-kit dev` makes one), or --start's command, such as 'npm run dev'. --json
+// prints the outcome as JSON on standard output, and the steps on standard error.
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { createInterface } from "node:readline/promises";
+import { defaultPolicy, Journal, loadManifest, localKeySigner, ManifestError, memoryJournalStorage, memorySecretStore, PaymentClient, PaymentRefusedError, PaymentUncertainError, ProviderBusyError, ProviderError, } from "@stellar-agent-services/payment-client";
+import { DEFAULT_MANIFEST_PATH } from "@stellar-agent-services/protocol";
+import { Keypair } from "@stellar/stellar-sdk";
+import { DEFAULT_PORT, gatewayManifestUrl } from "../gateway/config.js";
+import { devPayTo } from "./dev-account.js";
+import { ENV_FILE, loadEnvFile } from "./env-file.js";
+import { ApprovalError, explorerUrl, formatUsdc, networkName, rpcOwnerChain, shortAddress } from "./owner-chain.js";
+import { startCommand, waitForManifest } from "./processes.js";
+import { serveGateway } from "./serve.js";
+import { DEFAULT_CONFIG, plain, quote as shellQuote, UsageError } from "./shared.js";
+/** The most of a job's output printed, in characters. */
+const OUTPUT_LIMIT = 10_000;
+export function tryIo() {
+    const live = process.stdout.isTTY === true;
+    let showing = false;
+    const clear = () => {
+        if (showing)
+            process.stdout.write("\r\x1b[K");
+        showing = false;
+    };
+    return {
+        log(line) {
+            clear();
+            console.log(line);
+        },
+        status(text) {
+            if (!live)
+                return;
+            clear();
+            if (text === "")
+                return;
+            process.stdout.write(text);
+            showing = true;
+        },
+        interactive: process.stdin.isTTY === true,
+        async confirm(question) {
+            clear();
+            const readline = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                // Ctrl+C and Ctrl+D answer no.
+                const answer = await new Promise((resolve) => {
+                    readline.once("SIGINT", () => resolve(undefined));
+                    readline.question(question).then(resolve, () => resolve(undefined));
+                });
+                if (answer === undefined)
+                    process.stdout.write("\n");
+                return answer !== undefined && /^(y|yes)?$/i.test(answer.trim());
+            }
+            finally {
+                readline.close();
+            }
+        },
+        chain: rpcOwnerChain,
+        payer: () => Keypair.random(),
+        client: {},
+        startProvider: startForTry,
+    };
+}
+/** The provider, started for one call: a gateway in this process, or a command in the background until its manifest answers. */
+async function startForTry(how, manifestUrl) {
+    if ("command" in how) {
+        const started = startCommand(how.command);
+        try {
+            await waitForManifest(manifestUrl, { exited: started.exited, timeoutMs: 120_000 });
+        }
+        catch (error) {
+            await started.stop();
+            const output = started.output().trim().split("\n").slice(-12).join("\n");
+            throw new Error(`${how.command} didn't start the provider: ${error.message}${output === "" ? "" : `\nIts output:\n${output}`}`);
+        }
+        return started;
+    }
+    await loadEnvFile(ENV_FILE);
+    const network = JSON.parse(await readFile(how.config, "utf8")).network ?? "stellar:testnet";
+    await devPayTo({ env: process.env, network, chain: () => rpcOwnerChain(network), envFile: ENV_FILE });
+    const { server } = await serveGateway(how.config, { dev: true, log: () => { } });
+    return { stop: () => server.close() };
+}
+/** provider-kit try [<service>] ['<input JSON>' | @<file>] */
+export async function tryCall(flags, args, io = tryIo()) {
+    if (args.length > 2)
+        throw new UsageError("try takes a service and its input: provider-kit try <service> ['<input JSON>' | @<file>]");
+    if (!flags.yes && !io.interactive)
+        throw new UsageError("try asks before it pays, and nobody can answer here: add --yes to pay without asking");
+    if (flags.start !== undefined && flags.manifest !== undefined)
+        throw new UsageError("--start runs a provider on this computer: leave out --manifest, or start it yourself");
+    const summary = { ok: false, manifest: "" };
+    // With --json, standard output holds only the JSON: the steps go to standard error.
+    const steps = flags.json ? { ...io, log: (line) => void process.stderr.write(`${line}\n`), status: () => { } } : io;
+    let code;
+    try {
+        code = await payOnce(flags, args, steps, summary);
+    }
+    catch (error) {
+        if (!flags.json)
+            throw error;
+        summary.error = plain(error instanceof Error ? error.message : String(error), 400);
+        code = error instanceof UsageError ? 2 : 1;
+    }
+    finally {
+        io.status("");
+    }
+    if (flags.json)
+        console.log(JSON.stringify({ ...summary, ok: code === 0 }, null, 2));
+    return code;
+}
+async function payOnce(flags, args, io, summary) {
+    const manifestUrl = await providerManifestUrl(flags);
+    summary.manifest = manifestUrl;
+    const fetcher = io.client.fetch ?? fetch;
+    let started;
+    let manifest;
+    try {
+        manifest = await readManifest(manifestUrl, fetcher);
+    }
+    catch (error) {
+        const config = flags.manifest === undefined ? (flags.config ?? (existsSync(DEFAULT_CONFIG) ? DEFAULT_CONFIG : undefined)) : undefined;
+        const how = flags.start !== undefined ? { command: flags.start } : config !== undefined ? { config } : undefined;
+        if (!(error instanceof NothingAnswers) || how === undefined || io.startProvider === undefined)
+            throw error;
+        started = await step(io, "command" in how ? `Started ${how.command} for this call` : `Started the gateway from ${how.config} for this call`, () => io.startProvider(how, manifestUrl));
+        manifest = await readManifest(manifestUrl, fetcher);
+    }
+    try {
+        return await payStarted(flags, args, io, summary, manifestUrl, manifest);
+    }
+    finally {
+        await started?.stop();
+    }
+}
+async function payStarted(flags, args, io, summary, manifestUrl, manifest) {
+    const network = manifest.payment.accepts[0].network;
+    if (network !== "stellar:testnet") {
+        throw new Error(`${plain(manifest.provider.name)} is on ${networkName(network)}. try pays from a throwaway testnet account, so it runs on testnet only. Nothing was signed.`);
+    }
+    const service = pickService(manifest, args[0], flags, io);
+    if (service === undefined) {
+        summary.error = `name a service: ${manifest.services.map((each) => each.name).join(", ")}`;
+        return 2;
+    }
+    summary.service = service.name;
+    const { input, example } = await readInput(service, args[1]);
+    const payer = io.payer();
+    const price = service.price.amount;
+    const journal = await Journal.open(memoryJournalStorage());
+    const client = new PaymentClient({
+        signer: localKeySigner(payer.secret(), network),
+        // This one payment and no other: the manifest's price, to the manifest's payTo.
+        policy: {
+            ...defaultPolicy(payer.publicKey(), network),
+            maxValuePerTx: price,
+            maxValuePerDay: price,
+            stellar: { network, payees: { allow: [manifest.payment.accepts[0].payTo], block: [] }, autoApproveUpTo: "0" },
+        },
+        journal,
+        secrets: memorySecretStore(),
+        // A development tool on testnet: an http://localhost provider is fine [M6].
+        allowLocalhost: true,
+        followSeconds: Math.max(120, (service.expectedDurationSeconds ?? 0) * 2 + 30),
+        ...(flags.rpc === undefined ? {} : { rpcUrl: flags.rpc }),
+        ...io.client,
+    });
+    io.status(`  … Asking ${service.name} for its price`);
+    let offer;
+    try {
+        offer = await client.quote(manifestUrl, service.name, input);
+    }
+    catch (error) {
+        throw new Error(`${service.name} didn't quote a price: ${problem(error)}. Nothing was signed.`);
+    }
+    showTerms(io, offer, network, payer.publicKey(), example);
+    summary.jobId = offer.jobId;
+    if (!client.payable(offer)) {
+        io.log("Nothing was signed or paid.");
+        summary.error = "the challenge or the spending policy refused this payment; nothing was signed";
+        return 1;
+    }
+    if (!flags.yes) {
+        if (!(await io.confirm(`Pay ${formatUsdc(offer.requirements.amount)} in test money? [Y/n] `))) {
+            await client.decline(offer);
+            io.log("Not paid. Nothing was signed.");
+            summary.error = "declined; nothing was signed";
+            return 1;
+        }
+        io.log("");
+    }
+    try {
+        await fundPayer(io, io.chain(network, flags.rpc), payer, offer.requirements.amount);
+    }
+    catch (error) {
+        throw new Error(`${problem(error)}. Nothing was paid to ${service.name}.`);
+    }
+    io.status(`  … Paying ${service.name} and waiting for its result`);
+    const started = Date.now();
+    let result;
+    try {
+        result = await client.pay(offer, { approved: true });
+    }
+    catch (error) {
+        summary.error = problem(error);
+        return notPaid(io, error, offer, journal);
+    }
+    const { job, confirmed } = result;
+    Object.assign(summary, {
+        status: job.status,
+        ...(job.charged === undefined ? {} : { charged: job.charged }),
+        ...(job.payment === undefined
+            ? {}
+            : {
+                payment: {
+                    amount: formatUsdc(job.payment.amount),
+                    payTo: offer.requirements.payTo,
+                    transaction: job.payment.transaction,
+                    url: explorerUrl(job.payment.network, "tx", job.payment.transaction),
+                    confirmed,
+                },
+            }),
+        ...(job.output === undefined ? {} : { output: job.output }),
+        ...(job.error === undefined ? {} : { error: plain(`${job.error.code}${job.error.detail === undefined ? "" : `: ${job.error.detail}`}`, 400) }),
+    });
+    return report(io, offer, result, (Date.now() - started) / 1000);
+}
+/** The manifest URL of the provider to try: --manifest, the baseUrl of --config or ./provider.config.json, or this computer's default port. */
+async function providerManifestUrl(flags) {
+    if (flags.config !== undefined && flags.manifest !== undefined)
+        throw new UsageError("pass --config <file> or --manifest <url>, not both");
+    if (flags.manifest !== undefined)
+        return flags.manifest;
+    const config = flags.config ?? (existsSync(DEFAULT_CONFIG) ? DEFAULT_CONFIG : undefined);
+    if (config === undefined)
+        return new URL(DEFAULT_MANIFEST_PATH, `http://localhost:${DEFAULT_PORT}`).toString();
+    try {
+        return await gatewayManifestUrl(config);
+    }
+    catch (error) {
+        throw new Error(`${config}: ${error.message}. Set it as the provider has it, or pass --manifest <url>.`);
+    }
+}
+/** The manifest, read as a client reads it: from the running provider, and checked against the standard. */
+async function readManifest(url, fetcher) {
+    try {
+        return await loadManifest(url, { fetch: fetcher, allowLocalhost: true });
+    }
+    catch (error) {
+        if (error instanceof ManifestError)
+            throw new Error(`the manifest at ${url} isn't valid: ${error.message}. provider-kit check lists every problem.`);
+        if (unreachable(error))
+            throw new NothingAnswers(`nothing answers at ${url}. Start the provider first, such as with provider-kit dev, or pass --start '<command>'.`);
+        throw error;
+    }
+}
+/** No provider listens at the manifest's address. */
+class NothingAnswers extends Error {
+    name = "NothingAnswers";
+}
+/** The service named on the command line, or the only one there is. Lists them when there are several to pick from. */
+function pickService(manifest, name, flags, io) {
+    const names = manifest.services.map((service) => service.name);
+    if (name !== undefined) {
+        const service = manifest.services.find((candidate) => candidate.name === name);
+        if (service === undefined)
+            throw new Error(`${plain(manifest.provider.name)} has no service "${name}". It has ${names.join(", ")}.`);
+        return service;
+    }
+    if (manifest.services.length === 1)
+        return manifest.services[0];
+    const target = flags.manifest !== undefined ? ` --manifest ${shellQuote(flags.manifest)}` : flags.config !== undefined ? ` --config ${shellQuote(flags.config)}` : "";
+    const width = Math.max(...names.map((candidate) => candidate.length));
+    io.log(`${plain(manifest.provider.name)} has ${names.length} services. Name the one to try:`);
+    for (const service of manifest.services) {
+        io.log(`  provider-kit try ${service.name.padEnd(width)}${target}   ${formatUsdc(service.price.amount)}`);
+    }
+    return undefined;
+}
+/** The job's input: the argument as JSON, the JSON file it names with @, or the service's first example. */
+async function readInput(service, arg) {
+    if (arg === undefined) {
+        const example = service.examples?.[0]?.input;
+        if (example === undefined)
+            throw new UsageError(`${service.name} has no example input, so pass one: provider-kit try ${service.name} '<input JSON>'`);
+        return { input: example, example: true };
+    }
+    const file = arg.startsWith("@") ? arg.slice(1) : undefined;
+    let text = arg;
+    if (file !== undefined) {
+        try {
+            text = await readFile(file, "utf8");
+        }
+        catch (error) {
+            throw new UsageError(`the input file can't be read: ${error.message}`);
+        }
+    }
+    let input;
+    try {
+        input = JSON.parse(text);
+    }
+    catch {
+        input = undefined;
+    }
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw new UsageError(`the input must be a JSON object, such as '{"text":"Hello"}'${file === undefined ? "" : `, and ${file} doesn't hold one`}`);
+    }
+    return { input: input, example: false };
+}
+/** The terms of the payment, as the challenge states them: what the developer approves. */
+function showTerms(io, offer, network, payer, example) {
+    const { manifest, service, requirements } = offer;
+    const charge = service.charge === "on-success" ? "charged only if the work succeeds" : "charged up front, before the work starts";
+    io.log(`Pay for one job at ${plain(manifest.provider.name)} (${new URL(manifest.baseUrl).host})`);
+    io.log("");
+    const rows = [
+        ["Service", `${service.name}: ${plain(service.description, 70)}`],
+        ["Input", `${plain(JSON.stringify(offer.input), 70)}${example ? "  (its example)" : ""}`],
+        ["Price", `${formatUsdc(requirements.amount)}, ${charge}`],
+        ["Pay to", requirements.payTo],
+        ["From", `${payer}, a throwaway test account`],
+        ["Network", `${networkName(network)}: test money only`],
+    ];
+    for (const [label, value] of rows)
+        io.log(`  ${label.padEnd(8)} ${value}`);
+    for (const violation of offer.challengeViolations)
+        io.log(`  ✗ ${violation}`);
+    for (const violation of offer.policyViolations)
+        io.log(`  ✗ ${violation.field}: ${violation.message}`);
+    io.log("");
+}
+/** Funds the throwaway payer: test XLM from Friendbot, then the job's price in test USDC from the testnet DEX. */
+async function fundPayer(io, chain, payer, amount) {
+    const address = payer.publicKey();
+    await step(io, "Test XLM from Friendbot", () => chain.fund(address));
+    await step(io, `Test USDC from the testnet DEX: ${formatUsdc(amount)}`, async () => {
+        const purchase = await chain.buyTestUsdc(address, amount);
+        purchase.sign(payer);
+        const sent = await chain.send(purchase);
+        if (sent.status === "failed") {
+            throw new Error(`Buying test USDC failed: ${sent.reason} Try again in a minute, or pay with stellar-pay from a test wallet of your own, funded at https://faucet.circle.com (docs/provider-setup-guide.md §6).`);
+        }
+        if (sent.status === "unknown")
+            throw new Error(`Buying test USDC may not have gone through: ${sent.reason}.`);
+    });
+}
+/** Runs one step: "  … label" while it runs, on a terminal, then "  ✓ label" or "  ✗ label". */
+async function step(io, label, run) {
+    io.status(`  … ${label}`);
+    try {
+        const value = await run();
+        io.log(`  ✓ ${label}`);
+        return value;
+    }
+    catch (error) {
+        io.log(`  ✗ ${label}`);
+        throw error;
+    }
+}
+/**
+ * pay() threw. Before the paid request went out, a refusal or a busy answer to it charged nothing. Anything else
+ * after it went out may have been paid.
+ */
+function notPaid(io, error, offer, journal) {
+    const sent = journal.forJob(offer.jobId).some((entry) => entry.event === "sending");
+    if (!sent || error instanceof PaymentRefusedError || error instanceof ProviderBusyError) {
+        io.log(`  ✗ Not paid: ${problem(error)}. Nothing was charged.`);
+        return 1;
+    }
+    const reason = error instanceof PaymentUncertainError ? error.reason : problem(error);
+    io.log(`  ! The payment may have gone through, but the answer was lost: ${reason}.`);
+    io.log(`    Don't pay again. The provider decides job ${offer.jobId} from the chain [J13]; provider-kit reconcile --dry-run shows where it stands.`);
+    return 1;
+}
+/** What became of the job and its payment. 0 only when the job succeeded and its payment is confirmed on chain [J16]. */
+function report(io, offer, { job, confirmed, unconfirmedReason }, seconds) {
+    const name = offer.service.name;
+    const took = `${seconds.toFixed(1)} s`;
+    if (job.status === "succeeded")
+        io.log(`  ✓ ${name} succeeded: ${took} from payment to result`);
+    else if (job.status === "failed")
+        io.log(`  ✗ ${name} failed: ${job.error === undefined ? "no reason given" : plain(`${job.error.code}${job.error.detail === undefined ? "" : `: ${job.error.detail}`}`, 200)}`);
+    else if (job.status === "payment_uncertain")
+        io.log(`  ! ${name} can't tell yet whether it was paid. The provider decides job ${job.jobId} from the chain [J13]; don't pay again.`);
+    else
+        io.log(`  ! ${name} is still ${job.status} after ${took}. Its job is ${job.jobId}.`);
+    if (job.payment !== undefined) {
+        const link = explorerUrl(job.payment.network, "tx", job.payment.transaction);
+        if (confirmed)
+            io.log(`  ✓ Paid ${formatUsdc(job.payment.amount)}, confirmed on chain: ${link}`);
+        else
+            io.log(`  ! The provider says it was paid, but that isn't confirmed on chain: ${unconfirmedReason ?? "no reason given"}. ${link}`);
+    }
+    else if (job.charged === false) {
+        io.log("  ✓ Not charged");
+    }
+    if (job.output !== undefined)
+        io.log(`\n${printable(job.output)}`);
+    const ok = job.status === "succeeded" && confirmed;
+    if (ok)
+        io.log(`\n${shortAddress(offer.requirements.payTo)} (payTo) received ${formatUsdc(offer.requirements.amount)}.`);
+    return ok ? 0 : 1;
+}
+/**
+ * An error in words, to go before ". ": an approval error's title and message, or the error's own message, which
+ * may carry the provider's text.
+ */
+function problem(error) {
+    let text;
+    if (error instanceof ApprovalError)
+        text = `${error.title}: ${error.message}`;
+    else if (unreachable(error))
+        text = "nothing answers at the provider's address";
+    else
+        text = error instanceof Error ? error.message : String(error);
+    // Which part of the input the service refused, and why.
+    const errors = error instanceof ProviderError ? (error.problem?.errors ?? []) : [];
+    if (errors.length > 0)
+        text += `: ${errors.map((entry) => `${entry.pointer || "/"} ${entry.message}`).join("; ")}`;
+    return plain(text, 400).replace(/\.$/, "");
+}
+/** fetch() found nothing listening, or no such host. */
+function unreachable(error) {
+    return error instanceof TypeError && error.message === "fetch failed";
+}
+/** A job's output for the terminal: indented JSON, clipped when it is long. */
+function printable(output) {
+    // JSON escapes the C0 controls in strings, but not C1 (U+0080–U+009F), which some terminals take as commands.
+    const text = JSON.stringify(output, null, 2).replace(/[\u007f-\u009f]/g, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`);
+    return text.length > OUTPUT_LIMIT ? `${text.slice(0, OUTPUT_LIMIT)}\n… and ${text.length - OUTPUT_LIMIT} more characters` : text;
+}
+//# sourceMappingURL=try.js.map