vana-cli 0.15.1 → 0.23.3

package/dist/cli/app/escrow.js

@@ -0,0 +1,275 @@
+/**
+ * `vana app escrow balance|fund` - what the app can spend, and funding it.
+ *
+ * Funding is deliberately one command for both halves: the on-chain
+ * `depositNative(account)` transaction and the gateway deposit
+ * registration. Either half alone produces a contract that looks funded
+ * while every read still answers 402.
+ */
+import { CONTRACTS, createGatewayClient, encodeDepositNativeData, encodeDepositTokenData, } from "@opendatalabs/vana-sdk";
+import { getChainConfig } from "@opendatalabs/vana-sdk/chains";
+import { createPublicClient, createWalletClient, erc20Abi, formatEther, http, } from "viem";
+import { NATIVE_ASSET, formatAssetAmount, parseAssetAmount, resolveAsset, } from "../../core/assets.js";
+import { privateKeyToAccount } from "viem/accounts";
+import { AppKeyMissingError, resolveAppKey, } from "../../core/app-key.js";
+import { UnknownNetworkError, resolveNetwork, } from "../../core/network.js";
+import { emitAppOutcome } from "./outcome.js";
+function resolveContext(options, deps) {
+    let network;
+    try {
+        network = resolveNetwork(options.network);
+    }
+    catch (error) {
+        if (error instanceof UnknownNetworkError) {
+            return {
+                ok: false,
+                exitCode: emitAppOutcome(options, {
+                    status: "failed",
+                    code: "bad_usage",
+                    message: error.message,
+                }),
+            };
+        }
+        throw error;
+    }
+    try {
+        const key = (deps.resolveKey ?? resolveAppKey)({});
+        return { ok: true, network, key };
+    }
+    catch (error) {
+        if (error instanceof AppKeyMissingError) {
+            return {
+                ok: false,
+                exitCode: emitAppOutcome(options, {
+                    status: "failed",
+                    code: "bad_usage",
+                    message: "No app key on this machine yet.",
+                    remedy: "vana app register",
+                    network: network.name,
+                }),
+            };
+        }
+        throw error;
+    }
+}
+export async function runAppEscrowBalance(options, deps = {}) {
+    const context = resolveContext(options, deps);
+    if (!context.ok) {
+        return context.exitCode;
+    }
+    const { network, key } = context;
+    const client = (deps.createClient ?? createGatewayClient)(network.gatewayUrl);
+    try {
+        const balance = await client.getEscrowBalance(key.address);
+        // Each entry carries its own asset, and they do not share decimals:
+        // native VANA has 18, USDC.e has 6.
+        const lines = await Promise.all(balance.balances.map(async (entry) => {
+            const info = await resolveAsset(entry.asset, network.rpcUrl);
+            return `${formatAssetAmount(entry.availableAmount ?? "0", info)} available`;
+        }));
+        return emitAppOutcome(options, {
+            status: "done",
+            code: "ok",
+            message: lines.length === 0 ? "Escrow is empty." : lines.join(", "),
+            network: network.name,
+            data: {
+                address: key.address,
+                balances: balance.balances,
+                deposits: {
+                    submitted: balance.deposits.submitted.length,
+                    finalized: balance.deposits.finalized.length,
+                    failed: balance.deposits.failed.length,
+                },
+            },
+        });
+    }
+    catch (error) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "gateway_unreachable",
+            message: `Escrow balance lookup failed: ${error instanceof Error ? error.message : String(error)}`,
+            network: network.name,
+        });
+    }
+}
+async function defaultSendDeposit(params) {
+    const chain = getChainConfig(params.network.chainId);
+    const account = privateKeyToAccount(params.key.privateKey);
+    const transport = http(params.network.rpcUrl);
+    const publicClient = createPublicClient({ chain, transport });
+    const walletClient = createWalletClient({ account, chain, transport });
+    const isToken = Boolean(params.asset && params.asset.toLowerCase() !== NATIVE_ASSET);
+    if (!isToken) {
+        const balance = await publicClient.getBalance({
+            address: params.key.address,
+        });
+        if (balance < params.amountWei) {
+            throw new InsufficientFundsError(balance, params.amountWei);
+        }
+        const txHash = await walletClient.sendTransaction({
+            to: params.escrowContract,
+            data: encodeDepositNativeData({ account: params.key.address }),
+            value: params.amountWei,
+        });
+        await publicClient.waitForTransactionReceipt({ hash: txHash });
+        return { txHash };
+    }
+    // ERC20 path: the escrow pulls the tokens, so it needs an allowance
+    // first. Two transactions, and the approve is skipped when the existing
+    // allowance already covers the deposit.
+    const token = params.asset;
+    const held = (await publicClient.readContract({
+        address: token,
+        abi: erc20Abi,
+        functionName: "balanceOf",
+        args: [params.key.address],
+    }));
+    if (held < params.amountWei) {
+        throw new InsufficientFundsError(held, params.amountWei, token);
+    }
+    const allowance = (await publicClient.readContract({
+        address: token,
+        abi: erc20Abi,
+        functionName: "allowance",
+        args: [params.key.address, params.escrowContract],
+    }));
+    if (allowance < params.amountWei) {
+        const approveHash = await walletClient.writeContract({
+            address: token,
+            abi: erc20Abi,
+            functionName: "approve",
+            args: [params.escrowContract, params.amountWei],
+        });
+        await publicClient.waitForTransactionReceipt({ hash: approveHash });
+    }
+    const txHash = await walletClient.sendTransaction({
+        to: params.escrowContract,
+        data: encodeDepositTokenData({
+            account: params.key.address,
+            token,
+            amount: params.amountWei,
+        }),
+    });
+    await publicClient.waitForTransactionReceipt({ hash: txHash });
+    return { txHash };
+}
+export class InsufficientFundsError extends Error {
+    balanceWei;
+    neededWei;
+    asset;
+    constructor(balanceWei, neededWei, asset) {
+        super(asset
+            ? `Wallet holds ${balanceWei} base units of ${asset}, needs ${neededWei}`
+            : `Wallet holds ${formatEther(balanceWei)} VANA, needs ${formatEther(neededWei)} plus gas`);
+        this.balanceWei = balanceWei;
+        this.neededWei = neededWei;
+        this.asset = asset;
+        this.name = "InsufficientFundsError";
+    }
+}
+export async function runAppEscrowFund(options, deps = {}) {
+    const context = resolveContext(options, deps);
+    if (!context.ok) {
+        return context.exitCode;
+    }
+    const { network, key } = context;
+    // The amount is denominated in the chosen asset, not always in VANA.
+    const asset = await resolveAsset(options.asset, network.rpcUrl);
+    if (options.asset && !asset) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "bad_usage",
+            message: `Cannot read decimals for asset ${options.asset} on ${network.name}.`,
+            network: network.name,
+        });
+    }
+    const parsedAmount = parseAssetAmount(options.amount ?? "", asset);
+    if (parsedAmount === null || parsedAmount <= 0n) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "bad_usage",
+            message: `A positive --amount in ${asset?.symbol ?? "VANA"} is required.`,
+            remedy: "vana app escrow fund --amount 0.5",
+            network: network.name,
+        });
+    }
+    const amountWei = parsedAmount;
+    if (network.name === "mainnet" && !options.yes) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "confirmation_required",
+            message: `This deposits ${options.amount} real ${asset?.symbol ?? "VANA"} on mainnet.`,
+            remedy: `re-run with --yes to confirm`,
+            network: network.name,
+        });
+    }
+    const escrowContract = CONTRACTS.DataPortabilityEscrow.addresses[network.chainId];
+    if (!escrowContract) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "internal",
+            message: `No escrow contract known for chain ${network.chainId}.`,
+            network: network.name,
+        });
+    }
+    let txHash;
+    try {
+        ({ txHash } = await (deps.sendDeposit ?? defaultSendDeposit)({
+            network,
+            key,
+            escrowContract,
+            amountWei,
+            asset: options.asset,
+        }));
+    }
+    catch (error) {
+        if (error instanceof InsufficientFundsError) {
+            return emitAppOutcome(options, {
+                status: "failed",
+                code: "payment_required",
+                message: error.message,
+                remedy: network.name === "moksha"
+                    ? "fund the app wallet from the Moksha faucet: https://faucet.vana.org"
+                    : `send VANA to ${key.address}`,
+                network: network.name,
+                data: { address: key.address },
+            });
+        }
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "internal",
+            message: `On-chain deposit failed: ${error instanceof Error ? error.message : String(error)}`,
+            network: network.name,
+        });
+    }
+    // Second half: tell the gateway about the deposit. Idempotent to re-run;
+    // a crash between halves is recoverable by re-running fund (the on-chain
+    // half will fail on balance, but submit can be redone via the txHash we
+    // print).
+    const client = (deps.createClient ?? createGatewayClient)(network.gatewayUrl);
+    try {
+        const state = await client.submitEscrowDeposit({ txHash });
+        return emitAppOutcome(options, {
+            status: "done",
+            code: "ok",
+            message: `Deposited ${options.amount} ${asset?.symbol ?? "VANA"} into escrow.`,
+            network: network.name,
+            data: {
+                txHash,
+                gatewayStatus: state.status,
+                explorer: `${network.explorerUrl}/tx/${txHash}`,
+            },
+        });
+    }
+    catch (error) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "gateway_unreachable",
+            message: `On-chain deposit ${txHash} confirmed, but the gateway registration failed: ${error instanceof Error ? error.message : String(error)}`,
+            remedy: `re-run: the deposit is on chain, only the gateway half is missing (tx ${txHash})`,
+            network: network.name,
+            data: { txHash },
+        });
+    }
+}
+//# sourceMappingURL=escrow.js.map

package/dist/cli/app/escrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow.js","sourceRoot":"","sources":["../../../src/cli/app/escrow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,IAAI,GACL,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,kBAAkB,EAClB,aAAa,GAEd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,cAAc,GAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAA0B,MAAM,cAAc,CAAC;AAyBtE,SAAS,cAAc,CACrB,OAA0B,EAC1B,IAAgB;IAIhB,IAAI,OAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;YACzC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,QAAQ,EAAE,cAAc,CAAC,OAAO,EAAE;oBAChC,MAAM,EAAE,QAAQ;oBAChB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC;aACH,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;YACxC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,QAAQ,EAAE,cAAc,CAAC,OAAO,EAAE;oBAChC,MAAM,EAAE,QAAQ;oBAChB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,iCAAiC;oBAC1C,MAAM,EAAE,mBAAmB;oBAC3B,OAAO,EAAE,OAAO,CAAC,IAAI;iBACtB,CAAC;aACH,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA0B,EAC1B,OAAmB,EAAE;IAErB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,mBAAmB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,oEAAoE;QACpE,oCAAoC;QACpC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACnC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,eAAe,IAAI,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC;QAC9E,CAAC,CAAC,CACH,CAAC;QACF,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACnE,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,IAAI,EAAE;gBACJ,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE;oBACR,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM;oBAC5C,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM;oBAC5C,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM;iBACvC;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,iCACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE;YACF,OAAO,EAAE,OAAO,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAMjC;IACC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAqB,CAAC;IACzE,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAG,OAAO,CACrB,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAC5D,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;SAC5B,CAAC,CAAC;QACH,IAAI,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC;YAChD,EAAE,EAAE,MAAM,CAAC,cAAc;YACzB,IAAI,EAAE,uBAAuB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9D,KAAK,EAAE,MAAM,CAAC,SAAS;SACxB,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED,oEAAoE;IACpE,wEAAwE;IACxE,wCAAwC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAsB,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QAC5C,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;KAC3B,CAAC,CAAW,CAAC;IACd,IAAI,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC;QACjD,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,QAAQ;QACb,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC;KAClD,CAAC,CAAW,CAAC;IACd,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;YACnD,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC;SAChD,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC;QAChD,EAAE,EAAE,MAAM,CAAC,cAAc;QACzB,IAAI,EAAE,sBAAsB,CAAC;YAC3B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;YAC3B,KAAK;YACL,MAAM,EAAE,MAAM,CAAC,SAAS;SACzB,CAAC;KACH,CAAC,CAAC;IACH,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE7B;IACA;IACA;IAHlB,YACkB,UAAkB,EAClB,SAAiB,EACjB,KAAc;QAE9B,KAAK,CACH,KAAK;YACH,CAAC,CAAC,gBAAgB,UAAU,kBAAkB,KAAK,WAAW,SAAS,EAAE;YACzE,CAAC,CAAC,gBAAgB,WAAW,CAAC,UAAU,CAAC,gBAAgB,WAAW,CAAC,SAAS,CAAC,WAAW,CAC7F,CAAC;QARc,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAQ;QACjB,UAAK,GAAL,KAAK,CAAS;QAO9B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA0B,EAC1B,OAAmB,EAAE;IAErB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAEjC,qEAAqE;IACrE,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,kCAAkC,OAAO,CAAC,KAAK,OAAO,OAAO,CAAC,IAAI,GAAG;YAC9E,OAAO,EAAE,OAAO,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IACnE,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;QAChD,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0BAA0B,KAAK,EAAE,MAAM,IAAI,MAAM,eAAe;YACzE,MAAM,EAAE,mCAAmC;YAC3C,OAAO,EAAE,OAAO,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC;IAE/B,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/C,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,iBAAiB,OAAO,CAAC,MAAM,SAAS,KAAK,EAAE,MAAM,IAAI,MAAM,cAAc;YACtF,MAAM,EAAE,8BAA8B;YACtC,OAAO,EAAE,OAAO,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAClB,SAAS,CAAC,qBAAqB,CAAC,SACjC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,sCAAsC,OAAO,CAAC,OAAO,GAAG;YACjE,OAAO,EAAE,OAAO,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC,CAAC;YAC3D,OAAO;YACP,GAAG;YACH,cAAc;YACd,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC5C,OAAO,cAAc,CAAC,OAAO,EAAE;gBAC7B,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EACJ,OAAO,CAAC,IAAI,KAAK,QAAQ;oBACvB,CAAC,CAAC,qEAAqE;oBACvE,CAAC,CAAC,gBAAgB,GAAG,CAAC,OAAO,EAAE;gBACnC,OAAO,EAAE,OAAO,CAAC,IAAI;gBACrB,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,4BACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE;YACF,OAAO,EAAE,OAAO,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,wEAAwE;IACxE,UAAU;IACV,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,mBAAmB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,aAAa,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,eAAe;YAC9E,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,IAAI,EAAE;gBACJ,MAAM;gBACN,aAAa,EAAE,KAAK,CAAC,MAAM;gBAC3B,QAAQ,EAAE,GAAG,OAAO,CAAC,WAAW,OAAO,MAAM,EAAE;aAChD;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,OAAO,EAAE;YAC7B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,oBAAoB,MAAM,oDACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE;YACF,MAAM,EAAE,yEAAyE,MAAM,GAAG;YAC1F,OAAO,EAAE,OAAO,CAAC,IAAI;YACrB,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/cli/app/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Registration of the `vana app` builder command group.
+ *
+ * Only the commands that need no pending protocol decision are here:
+ * `register` and `whoami`. The consent flow (`request`, `requests`), the
+ * read loop, derivatives and write land as their milestones clear.
+ */
+import type { Command } from "commander";
+import type { AppCommandOptions } from "./outcome.js";
+export declare function registerAppCommands(program: Command, getOptions: () => AppCommandOptions): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,iBAAiB,GAClC,IAAI,CA2KN"}

package/dist/cli/app/index.js

@@ -0,0 +1,151 @@
+/**
+ * Registration of the `vana app` builder command group.
+ *
+ * Only the commands that need no pending protocol decision are here:
+ * `register` and `whoami`. The consent flow (`request`, `requests`), the
+ * read loop, derivatives and write land as their milestones clear.
+ */
+import { runAppEscrowBalance, runAppEscrowFund } from "./escrow.js";
+import { runAppOnchain } from "./onchain.js";
+import { runAppRead } from "./read.js";
+import { runAppAsk } from "./ask.js";
+import { runAppLineage, runAppStatus } from "./derivatives.js";
+import { runAppRegister } from "./register.js";
+import { runAppRequest } from "./request.js";
+import { runAppRequestsList, runAppRequestsShow } from "./requests.js";
+import { runAppWhoami } from "./whoami.js";
+export function registerAppCommands(program, getOptions) {
+    const app = program
+        .command("app")
+        .description("Builder-side protocol operations");
+    app
+        .command("register")
+        .description("Register this app as a builder at the gateway (idempotent)")
+        .option("--app-url <url>", "Public URL stored on the builder record")
+        .action(async (commandOptions) => {
+        process.exitCode = await runAppRegister({
+            ...getOptions(),
+            appUrl: commandOptions.appUrl,
+        });
+    });
+    app
+        .command("request")
+        .description("Ask a person for access and wait for the grant")
+        .option("--scopes <list>", "Comma-separated scopes to request")
+        .option("--question <text>", "Derivative question to carry on the request")
+        .option("--derived <scope>", "Scope the answer is written to")
+        .option("--sources <list>", "Comma-separated scopes the answer is computed from")
+        .option("--return-url <url>", "Where approval returns the person")
+        .option("--timeout <seconds>", "How long to wait for approval (default 600)")
+        .option("--app-id <id>", "App id shown during approval")
+        .option("--app-name <name>", "App name shown during approval")
+        .option("--app-url <url>", "App homepage shown during approval")
+        .action(async (commandOptions) => {
+        process.exitCode = await runAppRequest({
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    const requests = app
+        .command("requests")
+        .description("Access requests created from this machine");
+    requests
+        .command("list")
+        .description("List access requests this machine created")
+        .action(async () => {
+        process.exitCode = await runAppRequestsList(getOptions());
+    });
+    requests
+        .command("show <requestId>")
+        .description("Show one access request, refreshed from the service")
+        .action(async (requestId) => {
+        process.exitCode = await runAppRequestsShow(requestId, getOptions());
+    });
+    app
+        .command("read <scope>")
+        .description("Read granted data from the owner's Personal Server")
+        .option("--grant <id>", "Grant id covering the scope")
+        .option("--pay", "Settle a 402 payment from escrow")
+        .option("--max-fee <vana>", "Refuse fees above this amount, in VANA")
+        .option("--server <url>", "Explicit Personal Server URL")
+        .action(async (scope, commandOptions) => {
+        process.exitCode = await runAppRead(scope, {
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    const escrow = app
+        .command("escrow")
+        .description("Escrow balance and funding for paid reads");
+    escrow
+        .command("balance")
+        .description("What the app can spend from escrow")
+        .action(async () => {
+        process.exitCode = await runAppEscrowBalance(getOptions());
+    });
+    escrow
+        .command("fund")
+        .description("Deposit VANA into escrow (on-chain tx + gateway registration)")
+        .option("--amount <amount>", "Amount to deposit, in the asset's units")
+        .option("--asset <address>", "ERC20 to deposit instead of native VANA")
+        .action(async (commandOptions) => {
+        process.exitCode = await runAppEscrowFund({
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    app
+        .command("onchain <scope>")
+        .description("On-chain trace of a data point (version, hashes, deletion)")
+        .option("--owner <address>", "Data owner address")
+        .action(async (scope, commandOptions) => {
+        process.exitCode = await runAppOnchain(scope, {
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    app
+        .command("ask <question>")
+        .description("Ask a question about a person's data, through consent")
+        .option("--sources <list>", "Comma-separated scopes the answer is computed from")
+        .option("--derived <scope>", "Scope the answer is written to")
+        .option("--pay", "Settle the derived-scope read from escrow")
+        .option("--max-fee <amount>", "Refuse fees above this, in the fee's asset")
+        .option("--timeout <seconds>", "How long to wait for approval")
+        .option("--registered", "Use the builder-registered path instead of consent")
+        .action(async (question, commandOptions) => {
+        process.exitCode = await runAppAsk(question, {
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    app
+        .command("status <derivedScope>")
+        .description("Is the answer coming, and when")
+        .option("--grant <id>", "Grant covering the derived scope")
+        .option("--server <url>", "Personal Server URL")
+        .action(async (derivedScope, commandOptions) => {
+        process.exitCode = await runAppStatus(derivedScope, {
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    app
+        .command("lineage <scope>")
+        .description("Where an answer came from, redacted where it must be")
+        .option("--grant <id>", "Grant covering the scope")
+        .option("--server <url>", "Personal Server URL")
+        .action(async (scope, commandOptions) => {
+        process.exitCode = await runAppLineage(scope, {
+            ...getOptions(),
+            ...commandOptions,
+        });
+    });
+    app
+        .command("whoami")
+        .description("Show the app identity, key source and registration state")
+        .action(async () => {
+        process.exitCode = await runAppWhoami(getOptions());
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,UAAmC;IAEnC,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,kCAAkC,CAAC,CAAC;IAEnD,GAAG;SACA,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,CAAC;SACpE,MAAM,CAAC,KAAK,EAAE,cAAmC,EAAE,EAAE;QACpD,OAAO,CAAC,QAAQ,GAAG,MAAM,cAAc,CAAC;YACtC,GAAG,UAAU,EAAE;YACf,MAAM,EAAE,cAAc,CAAC,MAAM;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,CAAC;SAC9D,MAAM,CAAC,mBAAmB,EAAE,6CAA6C,CAAC;SAC1E,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CACL,kBAAkB,EAClB,oDAAoD,CACrD;SACA,MAAM,CAAC,oBAAoB,EAAE,mCAAmC,CAAC;SACjE,MAAM,CACL,qBAAqB,EACrB,6CAA6C,CAC9C;SACA,MAAM,CAAC,eAAe,EAAE,8BAA8B,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;SAC/D,MAAM,CAAC,KAAK,EAAE,cAAkD,EAAE,EAAE;QACnE,OAAO,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC;YACrC,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,GAAG;SACjB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,2CAA2C,CAAC,CAAC;IAC5D,QAAQ;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,CAAC,QAAQ,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACL,QAAQ;SACL,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,EAAE;QAClC,OAAO,CAAC,QAAQ,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,cAAc,EAAE,6BAA6B,CAAC;SACrD,MAAM,CAAC,OAAO,EAAE,kCAAkC,CAAC;SACnD,MAAM,CAAC,kBAAkB,EAAE,wCAAwC,CAAC;SACpE,MAAM,CAAC,gBAAgB,EAAE,8BAA8B,CAAC;SACxD,MAAM,CACL,KAAK,EACH,KAAa,EACb,cAKC,EACD,EAAE;QACF,OAAO,CAAC,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE;YACzC,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEJ,MAAM,MAAM,GAAG,GAAG;SACf,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2CAA2C,CAAC,CAAC;IAC5D,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,CAAC,QAAQ,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IACL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,+DAA+D,CAChE;SACA,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;SACtE,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;SACtE,MAAM,CAAC,KAAK,EAAE,cAAmD,EAAE,EAAE;QACpE,OAAO,CAAC,QAAQ,GAAG,MAAM,gBAAgB,CAAC;YACxC,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,cAAkC,EAAE,EAAE;QAClE,OAAO,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE;YAC5C,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CACL,kBAAkB,EAClB,oDAAoD,CACrD;SACA,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,OAAO,EAAE,2CAA2C,CAAC;SAC5D,MAAM,CAAC,oBAAoB,EAAE,4CAA4C,CAAC;SAC1E,MAAM,CAAC,qBAAqB,EAAE,+BAA+B,CAAC;SAC9D,MAAM,CACL,cAAc,EACd,oDAAoD,CACrD;SACA,MAAM,CACL,KAAK,EAAE,QAAgB,EAAE,cAAuC,EAAE,EAAE;QAClE,OAAO,CAAC,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;YAC3C,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC;SAC1D,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CACL,KAAK,EAAE,YAAoB,EAAE,cAAuC,EAAE,EAAE;QACtE,OAAO,CAAC,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE;YAClD,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,cAAc,EAAE,0BAA0B,CAAC;SAClD,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,cAAuC,EAAE,EAAE;QACvE,OAAO,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE;YAC5C,GAAG,UAAU,EAAE;YACf,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,CAAC,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/app/onchain.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `vana app onchain <scope> --owner <address>` - the on-chain trace of a
+ * data point: id, version, hashes, when it landed, whether it was deleted.
+ */
+import { type GatewayClient } from "@opendatalabs/vana-sdk";
+import { type AppCommandOptions } from "./outcome.js";
+export interface OnchainCommandOptions extends AppCommandOptions {
+    owner?: string;
+}
+export interface OnchainDeps {
+    createClient?: (gatewayUrl: string) => GatewayClient;
+}
+export declare function runAppOnchain(scope: string, options: OnchainCommandOptions, deps?: OnchainDeps): Promise<number>;
+//# sourceMappingURL=onchain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onchain.d.ts","sourceRoot":"","sources":["../../../src/cli/app/onchain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,CAAC;CACtD;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,qBAAqB,EAC9B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CA8EjB"}

package/dist/cli/app/onchain.js

@@ -0,0 +1,84 @@
+/**
+ * `vana app onchain <scope> --owner <address>` - the on-chain trace of a
+ * data point: id, version, hashes, when it landed, whether it was deleted.
+ */
+import { DataPointDeletedError, createGatewayClient, deriveDataPointId, } from "@opendatalabs/vana-sdk";
+import { isAddress } from "viem";
+import { UnknownNetworkError, resolveNetwork, } from "../../core/network.js";
+import { emitAppOutcome } from "./outcome.js";
+export async function runAppOnchain(scope, options, deps = {}) {
+    let network;
+    try {
+        network = resolveNetwork(options.network);
+    }
+    catch (error) {
+        if (error instanceof UnknownNetworkError) {
+            return emitAppOutcome(options, {
+                status: "failed",
+                code: "bad_usage",
+                message: error.message,
+            });
+        }
+        throw error;
+    }
+    if (!options.owner || !isAddress(options.owner)) {
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "bad_usage",
+            message: "An --owner address is required (the data point id derives from owner + scope).",
+            remedy: `vana app onchain ${scope} --owner 0x...`,
+            network: network.name,
+        });
+    }
+    const dataPointId = deriveDataPointId(options.owner, scope);
+    const client = (deps.createClient ?? createGatewayClient)(network.gatewayUrl);
+    try {
+        const record = await client.getDataPoint(dataPointId, {
+            includeDeleted: true,
+        });
+        if (!record) {
+            return emitAppOutcome(options, {
+                status: "failed",
+                code: "scope_not_found",
+                message: `No data point for ${scope} under ${options.owner} on ${network.name}.`,
+                network: network.name,
+                data: { dataPointId },
+            });
+        }
+        return emitAppOutcome(options, {
+            status: "done",
+            code: "ok",
+            message: record.deletedAt
+                ? `Data point exists but was deleted at ${record.deletedAt}.`
+                : `Version ${record.expectedVersion}, registered ${record.addedAt}.`,
+            network: network.name,
+            data: {
+                dataPointId,
+                owner: record.ownerAddress,
+                scope: record.scope,
+                version: record.expectedVersion,
+                dataHash: record.dataHash,
+                addedAt: record.addedAt,
+                deletedAt: record.deletedAt ?? null,
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof DataPointDeletedError) {
+            return emitAppOutcome(options, {
+                status: "done",
+                code: "ok",
+                message: "Data point exists but was deleted (tombstoned).",
+                network: network.name,
+                data: { dataPointId, deleted: true },
+            });
+        }
+        return emitAppOutcome(options, {
+            status: "failed",
+            code: "gateway_unreachable",
+            message: `Data point lookup failed: ${error instanceof Error ? error.message : String(error)}`,
+            network: network.name,
+        });
+    }
+}
+//# sourceMappingURL=onchain.js.map

package/dist/cli/app/onchain.js.map

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

package/dist/cli/app/outcome.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Outcome contract for the builder (`vana app`) command group.
+ *
+ * Every app command ends by emitting exactly one outcome through
+ * {@link emitAppOutcome}: a single JSON line in `--json` mode, readable
+ * lines otherwise. The exit code always comes from the protocol `code`
+ * through the binary-wide table in `src/core/exit-codes.ts`.
+ */
+import { z } from "zod";
+import { type CliExitCode } from "../../core/exit-codes.js";
+import type { VanaNetworkName } from "../../core/network.js";
+export declare const APP_OUTCOME_STATUSES: readonly ["done", "failed"];
+export type AppOutcomeStatus = (typeof APP_OUTCOME_STATUSES)[number];
+export interface AppOutcomeInput {
+    status: AppOutcomeStatus;
+    /** Stable protocol code; drives the exit code. `ok` for success. */
+    code: string;
+    message: string;
+    remedy?: string;
+    network?: VanaNetworkName;
+    data?: Record<string, unknown>;
+}
+export declare const appOutcomeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"outcome">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        done: "done";
+    }>;
+    code: z.ZodString;
+    exitCode: z.ZodNumber;
+    message: z.ZodString;
+    remedy: z.ZodOptional<z.ZodString>;
+    network: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export interface AppCommandOptions {
+    json?: boolean;
+    noInput?: boolean;
+    quiet?: boolean;
+    yes?: boolean;
+    network?: VanaNetworkName;
+}
+/** Emit the terminal outcome and return the exit code for the command. */
+export declare function emitAppOutcome(options: AppCommandOptions, outcome: AppOutcomeInput): CliExitCode;
+//# sourceMappingURL=outcome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../../src/cli/app/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,eAAO,MAAM,oBAAoB,6BAA8B,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;kCAWL,CAAC;AAEzB,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,eAAe,GACvB,WAAW,CA8Bb"}